KingFlow AI Aider 接入教程

接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID。Aider 启动时需要在模型 ID 前加 openai/。
• 准备 Python 3.8 至 3.13，或使用官方一键安装脚本让安装器准备独立的 Python 环境。
• 选择一个可回滚的 Git 仓库，先提交或妥善保存现有修改。

安装 Aider

# 已有 Python 3.8 至 3.13
python -m pip install aider-install
aider-install

# 验证
aider --version

powershell -ExecutionPolicy *yPass -c "irm https://aider.chat/install.ps1 | iex"

curl -LsSf https://aider.chat/install.sh | sh

验证 KingFlow 基础接口

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<KingFlow控制台中的完整模型ID>",
    "messages": [{"role": "user", "content": "只回复：连接成功"}],
    "stream": false
  }' 

使用一次性环境变量启动

$env:OPENAI_API_KEY="sk-你的密钥"
$env:OPENAI_API_*ASE="https://api.**nju**shen.com/v1"
aider --model openai/<完整模型ID>

export OPENAI_API_KEY="sk-你的密钥"
export OPENAI_API_*ASE="https://api.**nju**shen.com/v1"
aider --model openai/<完整模型ID>

建立长期配置

OPENAI_API_KEY=sk-你的密钥
OPENAI_API_*ASE=https://api.**nju**shen.com/v1
AIDER_MODEL=openai/<完整模型ID>

model: openai/<完整模型ID>
openai-api-*ase: https://api.**nju**shen.com/v1
timeout: 120
auto-commits: true
dirty-commits: true
show-diffs: true
gitignore: true

启动首次会话

1. 进入仓库根目录并运行 git status，确认当前状态已知。
2. 创建独立分支，例如 git switch -c aider-first-test。
3. 保存 .env 和 .aider.conf.yml，并确认 .env 已被 .gitignore 排除。
4. 运行 aider。启动信息应显示 openai/<完整模型ID> 和 KingFlow API *ase。
5. 先执行 /ask，进行只读分析；确认回答正确后再使用 /code。
6. 只用 /add 加入本次需要修改的文件，避免一次加载整个仓库。

常用会话命令

运行首次只读分析

/ask
请只读分析当前仓库，不要修改文件。

请说明：
1. 主要语言和框架
2. 项目入口文件
3. 测试命令所在位置
4. 完成一个小型缺陷修复前最值得阅读的三个文件

执行小范围修改

/add src/example.py tests/test_example.py
/code
只修改已经加入会话的两个文件：
- 为异常输入补充校验
- 保持公开接口不变
- 增加对应测试
- 修改后先显示差异，不要运行其他命令

完成联调验证

• Aider 启动时显示 openai/<完整模型ID>，并能通过 KingFlow 返回回答。
• KingFlow 控制台出现对应模型的调用记录，密钥和分组状态正常。
• /ask 能解释仓库结构且不会修改工作区。
• /diff 只包含明确加入会话的目标文件。
• 测试通过后，Git 历史中存在清晰的 Aider 提交，可用 /undo 回滚。

保护密钥和代码

• 不要把真实密钥写入 .aider.conf.yml、命令历史、截图或共享文档。优先放入已忽略的 .env。
• Aider 默认会自动提交修改，也可能先提交脏文件。首次使用前必须理解 auto-commits 和 dirty-commits。
• 不要使用 --yes 跳过全部确认。运行 /run、删除文件或改动依赖时逐项检查。
• 使用 .aiderignore 排除密钥、构建产物、大型数据、供应商目录和不允许发送的文件。
• 每个任务使用独立分支，修改后检查 /diff、运行测试，再决定是否合并。

完成检查清单

• Aider 已安装且 aider --version 能正常执行。
• KingFlow 基础接口已使用 https://api.**nju**shen.com/v1 验证。
• 模型名使用 openai/<完整模型ID>。
• 真实密钥保存在 .env，且 .env 已加入 .gitignore。
• 首次任务运行在独立 Git 分支。
• 先使用 /ask 验证只读能力，再进入 /code。
• 只添加任务相关文件，并在修改后检查 /diff 和测试。

常见故障排查