dscode

让 DeepSeek 在终端里持续写码、跑命令、开浏览器干活

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 6 🐛 待处理 4

GitHub ↗

GitHub 星标 ★ 998

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费，npm包可安装使用

项目预览

项目数据

分类编程开发

开发团队qiz029

GitHubhttps://github.com/qiz029/dscode

定价模式🏷️完全免费

价格说明开源免费，npm包可安装使用

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型agentic,ai-agent,cli,code-review,coding-agent,deepseek,deepseek-harness,developer-tools,jev,llm,macos,mcp,nodejs,terminal,tui

GitHub 星标★ 998

上线时间2026-09-11 00:00:00

代码更新2026-10-28

仓库体积11.5 MB

本站数据更新2026-11-10

维护状态较活跃

收录时间2026-09-25

浏览次数2

项目介绍

dscode 是一个面向 DeepSeek 模型的编码智能体运行框架（harness），把大模型包装成能在真实开发环境里干活的命令行助手。它解决的核心问题是：普通聊天式 AI 只能给代码片段，无法持续操作项目。dscode 提供持久化 shell 会话，让智能体在多次命令之间保持工作目录和环境状态；内置 Ultra 子智能体机制，可把复杂任务拆给多个子代理并行处理；支持自动批准（auto approval），减少每一步都手动确认的打断；集成 Chrome MCP，让智能体可以驱动浏览器做网页调试与信息获取；还带会话遥测（session telemetry），记录 token 消耗、工具调用等运行数据，方便复盘和调优。整体用 JavaScript/Node.js 编写，主要面向 macOS 终端用户，适合想把 DeepSeek 接入日常编码、代码审查和自动化脚本流程的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-25 · 当前星标 ★ 998

技术标签

agentic ai-agent cli code-review coding-agent

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS 14 或更高版本（README 明确仅支持 macOS）
Node 22.19+（22.x）或 24+ 以及 npm
Git
Google Chrome（浏览器相关能力需要）

安装与启动步骤

1检查环境要求

确认系统为 macOS 14+，并已安装 Node 22.19+（22.x）或 24+、npm、Git 与 Google Chrome，缺一不可。
```
node -v
npm -v
git --version
```
2全局安装 dscode

用 npm 全局安装官方包，首次启动时启动器会自动从 DSH Plugin Hub 安装固定的完整预设。
```
npm install -g @toddzheng024/dscode
```
3进入项目目录

切换到你要让智能体操作的项目目录，替换成自己的真实路径。
```
cd /path/to/project
```
4首次启动

运行 dscode 进入终端界面；首次启动会安装固定预设，无需手动拼装插件，也不需要全局 pnpm。
```
dscode
```
5登录并填密钥

在界面里输入 /login，把 DeepSeek API Key 粘贴进隐藏输入框；密钥只存本地，不会发给智能体。
6选择模型语言

用 /model 选模型或切换供应商，/provider openrouter 改用 OpenRouter，/effort 调推理强度，/language 换界面语言。
7续接会话与自检

需要继续上次工作时用 --continue 或 --resume；--cwd 可换目录；doctor 分析日志，--version 打印版本。
```
dscode --continue
dscode --resume SESSION_ID
dscode --cwd /another/project
dscode doctor
dscode --version
```

关键配置

配置项	必填	说明	示例
`DEEPSEEK_API_KEY`	否	环境变量形式的 DeepSeek 密钥，优先级高于本地凭据文件。	`sk-xxxxxxxx`
`OPENROUTER_API_KEY`	否	使用 /provider openrouter 时读取的 OpenRouter 密钥。	`sk-or-xxxxxxxx`
`DSCODE_HOME`	否	npm/Hub 安装方式的数据目录，默认 ~/.local/share/dscode-hub。	`/your/path/dscode-hub`
`DSCODE_LANGUAGE`	否	单次运行覆盖界面语言设置，可选 es 等语言代码。	`es`
`DSCODE_INSTALL_SOURCE`	否	安装时设为 1，强制使用源码 tarball 而非预构建包。	`1`
`DSCODE_PROJECT_HOOKS`	否	设为 0 时只加载安装目录的 hooks 文件，忽略项目级 hooks。	`0`

如何确认成功

执行 dscode --version 能打印版本号，且进入 TUI 后 /login 成功、可正常对话即算可用。

常见问题

Q：可以在 Windows 或 Linux 上运行吗？

A：README 明确说明这是面向 macOS 的终端编码智能体，并要求 macOS 14+ 与 Google Chrome，未给出其他平台的安装方式。

Q：公司内网或 npm 代理环境下装不上怎么办？

A：改用 GitHub Release 的预构建 tarball（dscode-<version>-darwin-arm64.tar.gz 或 -darwin-x64），它自带锁定的 node_modules，不需要 npm 也不需要访问 npm registry。

Q：API Key 保存在哪里？安全吗？

A：保存在本机 ~/.dscode/credentials.yaml，权限为 0600，跨项目与已安装版本共享，且不会发送给智能体。

Q：不想用 DeepSeek 官方模型怎么办？

A：输入 /provider openrouter 并填 OpenRouter 密钥即可切换；已订阅 OpenCode Go 的话用 /opencode login 后执行 /provider opencode-go。

Q：Homebrew 安装报错说 tap 不受信任？

A：Homebrew 7 会拒绝第三方 tap，需要先执行 brew trust qiz029/tap，再执行 brew install dscode。

注意事项

除 npm 外还支持 Homebrew、一行安装脚本（curl -fsSL https://raw.githubusercontent.com/qiz029/dscode/main/install.sh | sh）以及源码安装（git clone 后 npm ci --ignore-scripts
默认没有挂载任何 MCP server，需要浏览器调试等能力时自行在 config/mcp.local.yml 里添加，例如 Chrome DevTools MCP。
默认权限为 workspace-write 沙箱加 Auto 审查，审批请求会交给独立模型；用 /permission ask 可改回人工确认。
本地配置、密钥和会话不会进入发布包；源码安装的会话与配置在仓库 .runtime/ 与 .env、config/ 中。

核心亮点

持久化 shell 会话，命令间保留 cwd 与环境变量，不用反复重建上下文
Ultra 子智能体支持任务拆分与并行，复杂重构比单线程 agent 更省时
自动批准 + Chrome MCP + 会话遥测三件套，兼顾效率、浏览器操作与运行数据复盘

不足之处

主要面向 macOS 终端，跨平台支持有限
项目早期、星标约 425，生态与文档成熟度待观察

适用场景

在本地仓库里让智能体连续执行多步重构并自动跑测试
用 Chrome MCP 驱动浏览器抓取页面信息或调试前端问题
通过会话遥测分析 token 与工具调用开销，优化 agent 使用成本

替代项目

aider、OpenHands、Cline

上一篇：pi-agent-desktop

下一篇：llm-vscode