deepseekcode
deepseekcode 是面向 DeepSeek 模型和 OpenAI-compatible chat-completions
端点的终端编码 Agent。它以单个 Go 二进制 dsc 分发，包含交互式 TUI、
一次性 CLI 模式、仓库工具、SQLite 会话，以及保守的权限模型。
为什么选择 dsc（DeepSeek 深度特化）
- 可证明的前缀缓存稳定性 – 单一 canonical 序列化器同时喂给 wire
字节和缓存指纹，二者构造级一致不可能发散；
dsc trace inspect的prefixes==1可证明整次会话缓存稳定 （docs/prefix-cache.md）。 - 真实的多模型路由 – Duet pro 校验器在破坏性工具调用时触发，
<<<NEEDS_PRO>>>/ 错误升级已实装到 agent 循环中，而非仅停留在文档 （docs/duet.md）。 - 真实的 OS 沙箱 – sandbox-exec (macOS) / Landlock (Linux) 真隔离 + 真 PTY，不只是路径围栏 （docs/SANDBOX.md）。
- 自动推理强度 – 逐回合按多语言关键词自动开关 thinking，加
low/medium/high/max推理档位，简单任务自动降档。
DeepSeek V4 Agent 故事
DeepSeekCode 专为 DeepSeek V4 模型构建，相比通用编码 Agent 具有可验证的优势：
- 可证明的前缀缓存稳定性 — 单一 canonical 序列化器保证 wire 字节
与缓存指纹构造级一致；
dsc trace inspect可验证 （docs/prefix-cache.md）。 - 选择性 Pro 校验 — 破坏性工具调用获得第二次
deepseek-v4-pro判断，而非每回合都调用；低成本加安全保障 （docs/duet.md）。 - 1M 上下文工作流 — 大仓库阅读和长历史会话无需激进压缩；1M 上下文 是使能器，不是工具和检索的替代。
- 工具调用修复管道 — 自动修复截断 JSON、从推理文本中回收调用、 风暴守卫抑制重复失败调用。
完整故事及本地验证命令： docs/deepseek-v4-agent-story.md
基准证据： bench/README.md
功能
- 交互式 Bubble Tea TUI，以及可脚本化的
dsc -p "prompt"模式。 - DeepSeek-first runtime，支持 thinking、
reasoning_effort控制、长上下文、 前缀缓存指标，以及deepseek-v4-flash/deepseek-v4-pro。 - 可配置 OpenAI-compatible provider，用于接入其他 chat-completions 端点。
- 仓库工具覆盖文件读写、patch、shell 命令、git、grep、LSP 查询、网页抓取/搜索和用户提问。
- 持久化项目会话，支持恢复、分支、导出 scrollback，以及用
/undo撤销最近编辑 step。 - 可通过自定义 slash 命令、
SKILL.md发现、MCP 工具、子 Agent 和隔离 git worktree 扩展。 - 安全控制包括只读模式、工具前确认模式、自动批准模式、敏感路径检查、bash allowlist、可选沙箱，以及破坏性操作的 Pro 校验。
安装
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/amemiya02/deepseekcode/main/install.sh | sh
Homebrew：
brew install amemiya02/deepseekcode/deepseekcode
Scoop：
scoop bucket add deepseekcode https://github.com/amemiya02/deepseekcode-scoop
scoop install deepseekcode
Go：
go install github.com/amemiya02/deepseekcode/cmd/dsc@latest
从源码构建：
git clone https://github.com/amemiya02/deepseekcode
cd deepseekcode
make build
./bin/dsc -version
要求：
- 从源码构建时，需要与
go.mod匹配或更新的 Go 版本。 DEEPSEEK_API_KEY，或在.deepseek/config.toml中配置其他 provider key。- Git 和 language server 是可选依赖，但能提供更完整的仓库上下文。
快速开始
export DEEPSEEK_API_KEY=sk-...
dsc # 打开 TUI
dsc -p "summarize this repo" # 运行一次 prompt 后退出
dsc --read-only # 只检查，不允许 write/edit/bash 工具
dsc init # 创建项目初始配置
dsc doctor # 检查本地环境
会话快捷参数：
dsc -c # 继续当前项目最近一次会话
dsc -r <session-id> # 恢复指定会话
dsc -new # 强制创建新会话
配置
配置按内置默认值、用户配置、项目配置、CLI flags 的顺序叠加。项目配置位于
./.deepseek/config.toml；用户配置位于 ~/.deepseek/config.toml。
最小 DeepSeek 配置：
[active]
provider = "deepseek"
[providers.deepseek]
type = "deepseek"
base_url = "https://api.deepseek.com"
env_var = "DEEPSEEK_API_KEY"
first_token_timeout_ms = 45000
chunk_stall_timeout_ms = 20000
[defaults]
model = "deepseek-v4-flash"
thinking = true
OpenAI-compatible 端点：
[active]
provider = "openai"
[providers.openai]
type = "openai-compat"
base_url = "https://api.openai.com"
env_var = "OPENAI_API_KEY"
default_model = "gpt-4o"
完整说明见 docs/config.md 和 docs/PROVIDERS.md。
文档
开发
make build # 构建 ./bin/dsc
make test # go test ./...
make test-race # go test -race ./...
make lint # go vet ./...
make fmt # gofmt -s -w .
make run # 构建并启动 TUI
提交 pull request 前：
make fmt
make lint
make test
参与贡献
欢迎提交 issue 和 pull request。修改 README 时，请同步更新 README.md 和
README.zh-CN.md，并保持匹配的 ## 结构。只记录本仓库中已经实现且可测试的功能。
许可证
MIT