ds-code

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

功能

• Ink 终端 UI — React 驱动的交互界面，流式输出，实时工具状态显示
• Agent 循环 — 自动调用工具链完成复杂任务，支持中断 (Ctrl+C)
• 文件操作 — 读取、写入、精确编辑、Glob 匹配、正则搜索
• Shell 执行 — 授权后执行命令，超时控制，进程中断
• 权限系统 — 只读自动放行，写入需确认，危险命令拒绝
• 上下文压缩 — 长对话自动/手动压缩，保持 token 可控
• 会话持久化 — 自动保存，支持恢复上次对话
• 多模型切换 — deepseek-v4-pro / deepseek-v4-flash / deepseek-reasoner
• 斜杠命令 — 12 个内置命令，输入 / 自动补全

环境要求

• Node.js >= 20
• DeepSeek API Key（platform.deepseek.com）

快速开始

git clone <repo-url>
cd ds
pnpm install

export DEEPSEEK_API_KEY=sk-xxx

pnpm dev                          # 开发模式
pnpm dev -- "fix the bug"        # 带初始 prompt
pnpm dev -- --model reasoner     # 指定模型
pnpm dev -- --resume             # 恢复上次会话

构建后运行：

pnpm build
node dist/bin/ds-code.js

命令

在交互界面中输入 / 触发自动补全：

快捷键：

工具

架构

用户输入 → Agent → DeepSeek API (stream)
                        │
                  [文本] → 流式渲染到终端
                  [工具] → 执行 → 结果回传 → 继续循环

核心模块：

src/
├── api/          DeepSeek 客户端、SSE 流解析、重试
├── cli/          Ink 组件（App、MessageList、Autocomplete、ToolCall...）
├── core/         Agent 循环、上下文压缩、会话存储、消息构建
├── tools/        工具实现 + Registry
├── permissions/  权限规则 + Manager
└── utils/        Token 计数、Git、路径工具

开发

pnpm install        # 安装依赖
pnpm dev            # 开发运行（tsx）
pnpm build          # 构建（tsup）
pnpm test           # 测试（vitest）
pnpm lint           # ESLint
pnpm typecheck      # tsc --noEmit

技术栈

License

MIT