终端里的 AI 编码助手，由 DeepSeek 驱动。在项目目录中对话式阅读、修改代码，或进入只读 Plan 模式做架构分析。
- 读代码：搜索、浏览、解释项目结构与实现
- 改代码：按你的描述编辑文件、运行命令（改前会询问确认）
- Plan 模式：只读分析，输出实施方案，不改动文件
- 续聊：会话自动保存，可恢复之前的对话
- 懂项目：读取
AGENTS.md、项目 Rules 与 Skills
需要 DeepSeek API Key：
export DS_CODE_DEEPSEEK_API_KEY=sk-...
# 或
export DEEPSEEK_API_KEY=sk-...从 GitHub Releases 下载对应平台的压缩包，解压后将 ds-code 放到 PATH 中。
下方 curl 示例使用 releases/latest/download/，会自动获取最新正式版（非 draft）；若需指定版本，请在 Releases 页选择对应 tag。安装后可运行 ds-code version 确认实际版本。
| 你的环境 | 下载文件 |
|---|---|
| macOS Apple Silicon | ds-code-darwin-arm64.tar.gz |
| macOS Intel | ds-code-darwin-x86_64.tar.gz |
| Linux x86_64 | ds-code-linux-amd64.tar.gz |
| Linux ARM64 | ds-code-linux-arm64.tar.gz |
| Alpine / musl Linux x86_64 | ds-code-linux-musl-amd64.tar.gz |
| Alpine / musl Linux ARM64 | ds-code-linux-musl-arm64.tar.gz |
Windows 用户：当前 Release 不提供原生 Windows 二进制。建议在 WSL2（Ubuntu 等 Linux 发行版）中安装，使用上表中的 ds-code-linux-amd64（x86_64 PC）或 ds-code-linux-arm64（ARM PC）。在 WSL 终端里解压、加入 PATH 后，用法与 Linux 相同。
# WSL2 内示例（x86_64）
curl -LO https://github.com/wzhejunqiu/ds-code/releases/latest/download/ds-code-linux-amd64.tar.gz
tar xzf ds-code-linux-amd64.tar.gz
chmod +x ds-code
mkdir -p ~/.local/bin && mv ds-code ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"示例（macOS Apple Silicon）：
curl -LO https://github.com/wzhejunqiu/ds-code/releases/latest/download/ds-code-darwin-arm64.tar.gz
tar xzf ds-code-darwin-arm64.tar.gz
chmod +x ds-code
sudo mv ds-code /usr/local/bin/ # 或放入任意 PATH 目录export DS_CODE_DEEPSEEK_API_KEY=sk-...
# 交互界面（在项目目录下运行）
ds-code
# 单次任务（适合脚本）
ds-code -p "解释 main 函数的作用"
# 只读分析，不改文件
ds-code --plan -p "梳理 internal/agent 的结构并给出重构建议"引用文件/目录：@path/to/file.go 预加载单文件全文；@src/ 注入目录文件列表（不含正文，Agent 按需 read_file/glob）。用户原文中的 @path 会保留在 prompt 中。
恢复会话：
ds-code sessions # 列出历史会话
ds-code resume <会话ID>权限：默认在修改文件或运行 shell 前询问（y/N）。脚本中可使用 --permission-mode readonly（只读）或 --dangerously-auto（自动批准，请谨慎）。
JSON 输出（便于 CI）：ds-code --json -p "..."
| 按键 | 作用 |
|---|---|
Ctrl+C |
取消当前轮次 |
Ctrl+T |
工具调用日志 |
Ctrl+R |
显示/隐藏推理过程 |
Ctrl+L |
上下文用量（/context） |
常用命令：输入 /help 查看全部；/compact 压缩上下文；/clear 开始新会话。
可选。用户级：~/.ds-code/config/config.yaml；项目级：<git-root>/.ds-code/config.yaml。示例见 configs/example.yaml。
详细选项见 CONFIG.md。
- CONFIG.md — 配置说明
- SECURITY.md — 安全说明
- CONTRIBUTING.md — 从源码构建与参与开发