ds-code

基于 DeepSeek、OpenAI 或 OpenAI-compatible API 的 AI 编程助手 CLI。在终端中与 AI 对话，完成代码读写、搜索、命令执行等任务。

安装

npm install -g @mrdistore/ds-code

配置

配置优先级为：CLI 参数 > 项目配置 > 全局配置 > 环境变量/默认值。

配置文件位置：

• 全局配置：~/.ds-code/config.json
• 项目配置：当前项目下的 .ds-code/settings.json

设置 API Key：

# DeepSeek
export DEEPSEEK_API_KEY=sk-xxx

# OpenAI
export OPENAI_API_KEY=sk-xxx

Windows PowerShell：

$env:DEEPSEEK_API_KEY="sk-xxx"
$env:OPENAI_API_KEY="sk-xxx"

OpenAI-compatible 中转站可通过配置文件或 CLI 指定：

{
  "provider": "custom",
  "baseUrl": "https://relay.example.com",
  "apiKey": "sk-xxx",
  "model": "openai/gpt-4o"
}

完整配置示例：

{
  "provider": "deepseek",
  "apiKey": "sk-xxx",
  "baseUrl": "https://api.deepseek.com",
  "model": "deepseek-v4-pro",
  "maxTokens": 4096,
  "temperature": 0.2,
  "timeout": 120000,
  "permissions": {
    "allowedCommands": [
      "git status",
      "pnpm test"
    ],
    "allowAllCommands": false
  },
  "skills": {
    "enabled": true,
    "autoMatch": true,
    "autoMatchModel": true
  }
}

常用字段：

字段	说明
provider	API 提供方：deepseek、openai 或 custom
apiKey	API Key；也可通过环境变量 DEEPSEEK_API_KEY / OPENAI_API_KEY 设置
baseUrl	API 基础地址，使用中转站时设置
model	模型名称，如 deepseek-v4-pro、deepseek-reasoner、gpt-4o
maxTokens	单次响应最大 token 数
temperature	采样温度
timeout	请求超时时间，单位毫秒
permissions.allowedCommands	预允许执行的 Bash 命令，支持以 * 结尾的前缀匹配
permissions.allowAllCommands	允许所有非危险 Bash 命令；危险命令仍会被拒绝
skills.enabled	是否启用 skills 功能
skills.autoMatch	是否对普通输入进行 skill 自动匹配（命中后会弹出确认）
skills.autoMatchModel	本地规则未命中时，是否允许调用模型进行 skill 匹配（更准但会多一次请求）

AGENTS.md 可放在项目目录或父目录中，用于提供项目级 AI 指令；启动时会读取离当前目录最近的一个。

Skills（技能）

Skills 用于把常见任务封装成“可复用指令”。当启用自动匹配时，你直接用自然语言描述需求，ds-code 会尝试匹配到某个 skill，并在执行前请求确认。

• 触发方式
  • 手动：输入 /<skill> ...（会自动补全）
  • 自动：直接输入自然语言（由 skills.autoMatch / skills.autoMatchModel 控制）

Skills 配置

配置在 skills 字段下：

{
  "skills": {
    "enabled": true,
    "autoMatch": true,
    "autoMatchModel": true
  }
}

建议：

• 不想被频繁打断：将 skills.autoMatch 设为 false（仍可手动用 /<skill> 调用）
• 想更少误触发且不增加额外请求：autoMatch=true、autoMatchModel=false

使用示例

• 手动调用（推荐用于可重复流程）：

/review 看下当前git改动

• 自动匹配调用：

看下当前git改动

如果匹配到 skill，会弹出是否激活；确认后会以 /<skill> ... 的形式展示在聊天记录中。

使用

# 启动交互式对话
ds-code

# 带初始 prompt 启动
ds-code "帮我看看这个项目的结构"

# 指定模型
 ds-code --model reasoner

# 使用 OpenAI
 ds-code --provider openai --model gpt-4o

# 使用 OpenAI-compatible 中转站
 ds-code --provider custom --base-url https://relay.example.com --model openai/gpt-4o

# 恢复上次会话
ds-code --resume

功能

• 交互式终端 UI — 流式输出，实时工具调用状态显示
• Agent 工具链 — 自动读写文件、搜索代码、执行命令，完成复杂任务
• 权限控制 — 只读操作自动放行，写入和命令执行需确认
• 多模型切换 — DeepSeek 模型、OpenAI GPT 模型、OpenAI-compatible 中转站模型
• 上下文管理 — 长对话自动压缩，会话持久化保存与恢复
• 斜杠命令 — 输入 / 自动补全，12 个内置命令

命令

在对话中输入 / 触发自动补全：

命令	说明
/help	查看帮助
/clear	清空对话
/exit	退出
/model	交互式切换模型
/model <name>	直接切换（如 reasoner / gpt-4o / 中转站模型别名）
/status	查看状态信息
/tools	列出可用工具
/cost	token 用量估算
/compact	手动压缩上下文
/resume	恢复上次会话
/doctor	检查运行环境
/version	版本号

快捷键

按键	作用
Ctrl+C	中断当前请求
Ctrl+D	退出
"""	进入/退出多行输入
↑↓	补全列表导航
Enter/Tab	选中补全项
Esc	关闭补全

内置工具

工具	说明	权限
read_file	读取文件，支持行范围	自动
write_file	创建或覆写文件	需确认
edit_file	精确字符串替换	需确认
glob	文件名模式匹配	自动
grep	正则内容搜索	自动
list_dir	列出目录	自动
bash	执行 Shell 命令	需确认

环境要求

• Node.js >= 20
• DeepSeek API Key、OpenAI API Key 或 OpenAI-compatible 中转站 Key

开发

git clone https://github.com/qddidi/ds-code.git
cd ds-code
pnpm install

pnpm dev            # 开发运行
pnpm build          # 构建
pnpm test           # 测试
pnpm lint           # 代码检查
pnpm typecheck      # 类型检查

License

MIT