# qiuming-code

**Repository Path**: qiuming112/qiuming-code

## Basic Information

- **Project Name**: qiuming-code
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-22
- **Last Updated**: 2025-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI代码助手 (QiuMing Code)


**AI驱动的开发者命令行工作流工具**

[安装](#安装) • [快速开始](#快速开始) • [核心功能](#核心功能) • [文档](./docs/) • [贡献指南](./CONTRIBUTING.md)


秋明代码助手是一个强大的AI驱动命令行工具。它通过先进的代码理解、自动化任务和智能辅助，显著提升您的开发工作流效率。


## 核心功能

- **🔍 代码理解与编辑** - 查询和编辑超出传统上下文窗口限制的大型代码库
- **⚙️ 工作流自动化** - 自动化操作任务，如处理Pull Request和复杂的代码重构
- **🚀 增强解析器** - 专门为模型优化的解析器
- **📋 任务管理** - 内置TODO管理系统，跟踪开发进度
- **🔧 子代理系统** - 专业化AI助手，处理特定领域任务
- **💾 智能记忆** - 项目级和全局级记忆管理
- **🔌 扩展工具** - 丰富的内置工具集，支持文件操作、Git集成、Web搜索等

## 安装
步骤一：确认 Node.js 版本
QiuMing Code 要求 Node.js 版本 >= 20，先确认你的版本：


```
bash
node -v
```


如果低于 20，比如显示 v18.15.0，请执行以下步骤升级。


步骤二：安装或升级 Node.js（推荐使用 nvm）
使用 nvm 管理 Node.js 更加灵活：

```
bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 加载 nvm（当前终端）
export NVM_DIR="$HOME/.nvm"
source "$NVM_DIR/nvm.sh"

# 安装 Node.js 20 并设为默认
nvm install 20
nvm use 20
nvm alias default 20
```


验证是否安装成功：


```
bash
node -v
npm -v
```

注意： 每次打开新的终端，可能会发现 node -v 显示的还是旧版本，这里有两个解决办法：

每次启动 qiuming code 先执行：

```
bash
nvm use default
# 或者 
nvm use 20
```

想让每次打开终端自动使用 v20 可以执行：

```
bash
echo 'nvm use default &> /dev/null' >> ~/.bashrc
source ~/.bashrc
```



步骤三：源码安装

```
git clone https://gitee.com/qiuming112/qiuming-code.git
cd qiuming-code
npm install
npm install -g .
```



步骤四：运行 QiuMing CLI
启动交互式 qiuming 命令行：

```
bash

qiuming
```


![输入图片说明](screen_shot_1758547484164.png)



步骤五：配置模型(如阿里云百炼模型)

临时配置：
```
API KEY：sk-xxxxxxxxxxxxxxxxxxxx
BASE URL：https://dashscope.aliyuncs.com/compatible-mode/v1
Model：qwen3-coder-plus
```

项目级配置：在项目根目录下创建.env文件

```
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
```


![输入图片说明](screen_shot_1758588200851.png)