❄ DSCODE

在终端里写代码，让脚本接入当前会话，让 agent 之间交接任务。

English · 简体中文

核心能力 · 最新变化 · 快速开始 · 常用命令 · 更新日志 · 文档

DSCODE 是基于 DeepSeek Harness 的 macOS 与 Linux 终端编码 agent。专用文件工具通过文件版本检查来读取和编辑代码，持久 Shell 负责搜索、构建和测试。TUI、CLI 与脚本共用同一个会话运行时，而不是各自启动一套。它以固定版本的可复现 harness 安装——DSH 依赖、TUI 与插件一起打包、一起校验。

多数编码 agent 是单打独斗。DSCODE 建在相反的假设上：同一台机器上的会话彼此可见——一个可以把任务交出去，另一个可以审阅 diff，而放行与否由一个独立审核模型按你的指令判断，而不是查规则表。

60 秒看懂——三件多数编码 agent 做不到的事，以及在哪里看：

演示指南 总结 DSCODE 的功能，提供五分钟 Desktop 演示草稿，并保留 90 秒终端演示的分镜与录制命令。

🧭 核心能力

🆕 最新变化

0.7.54 — 修复配置了消息提交 hook 的项目无法发送消息的问题，以及 IPv6 就绪检查失败导致正常运行的 Host 在 90 秒后被终止的问题。详见发布说明。

0.7.51 — 终端升级至 Harness 0.2.1-rc.3，新增批量编辑、有界缓存读取和大段 Bash 输出落盘。server --yolo 支持无人值守运行；Linux 新增局部桌面观察、动作结果检查、控制租约和 server 专用桌面。Wayland 串流控制仍为实验性功能。详见发布说明。

0.7.50 — 远端 server 支持作为 macOS 或 Linux 用户服务运行，启动时验证鉴权就绪，更新时安全暂停并恢复服务。新增远端状态、诊断与持续可见的连接身份。server 重启后会话写入可自动恢复，投递请求 ID 防止重试重复，打断可锁定观察到的轮次，删除操作检查存储写入归属。两端需要使用相同的协议修订版和固定 Harness 版本。详见发布说明。

0.7.49 — 终端升级到 Harness 0.2.1-rc.2，这是 DeepSeek 为 DeepSeek-V4.1-Flash-1017 推荐的版本；Desktop 组合包仍为 0.2.0-rc.2。子 agent 现在一律在后台启动，结束后再向父 agent 汇报。在 OpenRouter 和 OpenCode Go 上，deepseek-flash 会切到 V4.1 Flash，而不是已退役的 V4 Flash。后台记忆不再因自身的输出上限而失败。详见发布说明。

0.7.48 — 远程 Runtime：dscode server --port PORT 通过 TCP 并以 token 认证对外提供本机运行时，另一台机器上用 dscode config --runtime / dscode runtime <别名> 连接终端。粘贴的文件会上传，/diff、/review 和 /export 在服务器上的目录中执行，连接断开后终端会自动重连。连接不加密。/reload 无需重启运行时即可应用 MCP 与配置修改、祖先 skill 和指令。详见发布说明。

0.7.47 — 终端与 agent 运行时现在分为两个进程：dscode 会启动本地后台 Host 来持有会话，终端通过仅限本人访问的 socket 接入。关闭或崩溃的终端不会中断 Host 上正在运行的工作，多个终端可以接入同一会话，每个会话沿用自己目录的指令。--in-process 可恢复单进程模式。详见发布说明。

0.7.46 — 新增 64 位 glibc Linux（x64 与 arm64）自包含安装包。同一条 curl 安装命令、dscode update 和直接下载现已支持 Linux；请安装 bubblewrap 以启用命令沙箱。详见发布说明。

0.7.45 — Antigravity 接入可识别 Gemini 4 Argon，并改用模型的 thinkingLevel 选择 low/medium/high 推理档位，不再发送 Argon 会拒绝的思考预算。访问资格由 Google 按账户决定，Argon 线上生成尚未验证。详见发布说明。

0.7.44 — 新增原生 OpenAI/ChatGPT 与社区 Antigravity Gemini 接入、带文件版本检查的 read/edit/write 工具，更清晰的全高度终端布局，以及可靠的非交互持久 Bash 命令。OpenAI 速度选择会报告服务器实际档位；Antigravity 账户访问仍需线上验证。详见发布说明。

0.7.42 — 修复完整安装包升级时的文件列表缓冲区限制。已装 0.7.41 的用户请重新运行下方 curl 安装命令一次，之后可正常使用 dscode update。详见发布说明。

0.7.41 — 终端改为一个自包含包，自带运行环境和原生依赖。安装与升级不再依赖 npm 或 Hub；用户数据独立保存，与已有 DSH 安装互不依赖。详见发布说明。

0.7.40 — 凭据变更或删除后清除余额缓存，保留币种并区分账户余额与 key 限额；TUI 和 ACP 新增实时查询的 /status。ACP 同时按已配置凭据筛选模型，并在失败时提供重试提示。详见发布说明。

0.7.39 — 修复发布包中的 DeepSeek provider 启动问题。终端升级到 Harness 0.2.0-rc.2 和 Computer Use 0.3.3，适配原生提醒投递与 /schedule 列表，并提供可选的 Atomic Mail MCP 配置。未配置或禁用时，不向模型上下文加入 Atomic Mail 工具和服务器指令。详见发布说明。

0.7.36 — dscode acp 让 ACP 客户端使用 DSCODE agent preset、已配置的模型服务和客户端工具审批。安装 npm latest 启动器后，将客户端命令配置为 dscode，参数为 ["acp"]。协议支持范围见 ACP 指南，详见发布说明。

0.7.35 — 移除 Hub 捆绑，将桌面浏览器工具限定于 DSCODE 会话，并统一设置页与启用指引的 Harness 风格。已有桌面模型和账户可继续使用，TUI Browser Use 保留。详见发布说明。

0.7.32 — OpenCode Go 改为只用 OpenCode 账号登录：/opencode login 显示验证码、打开控制台，并在后台完成登录。登录会自动续期，请求发往控制台为你的组织指定的推理地址。0.7.31 用的控制台 API key 不再读取，请运行一次 /opencode login。状态栏显示订阅在 5 小时、每周、每月三档额度中的用量，某档用尽时显示何时恢复。授权页显示的是 OpenCode CLI，因为 DSCODE 借用了它的登录客户端。

0.7.31 — OpenCode Go 加入 /provider：/provider opencode-go 保存 OpenCode 控制台发放的 key，提供 Go 的 chat-completions 模型——DeepSeek、GLM、Kimi、MiMo、LongCat、Hy 和 Space Bunny——每个模型的推理强度都按线上网关实测结果提供，请求带上 Go 要求的会话 ID，工具调用之间会回传思考内容。Go 会话的联网搜索和 OpenCode 一样走 Exa，不需要额外的 key。Qwen、MiniMax 以及 Go 上的 Grok、GPT 模型走其他协议，暂未提供。

0.7.30 — /delegate <任务> 让主 agent 成为协调者：先在看板上按优先级和依赖规划任务，把就绪的部分派给隔离 Git worktree 中的子 agent，逐个验证结果，再按依赖顺序把通过的改动合并并暂存（不提交）。/delegate-dashboard 用彩色看板展示待分配、进行中、验证中、已完成四列。子 agent 并发上限改为非 Ultra 5 个、Ultra 20 个；欢迎界面的雪花重新绘制。

0.7.29 — /account 用系统浏览器以 DeepSeek 账号给 DeepSeek 路由授权：凭据存在本机，已登录的机器不再需要 DEEPSEEK_API_KEY；该命令同时可查看账号身份、充值余额与赠额，并支持退出登录。profile 为此组合了一个回环回调服务，且只在登录进行期间存在路由，DSCODE_ACCOUNT_LOGIN=0 可移除它。随之修复两处组合：上游改名让禁用补丁静默失效后，host 层的 workflow 引擎重新被关闭；base 已自带 PTC 运行时，冗余的那行也删掉了。

0.7.28 — DSH 运行时从 0.1.5-rc.2 升到 0.1.7-alpha.2，带来重试 shell 上带理由的沙箱提权、持久化图片 offload、MCP 资源工具、子代理权限继承与压缩重试恢复。复核权限预设由 auto 改名为 auto-review，因为 DSH 已把 auto 保留给自己的集成：请使用 /permission auto-review、dscode exec --permission auto-review 与 permission: auto-review。Computer Use 的现场激活与原生 helper 不受影响，但恢复会话后需重新加载 computer-use skill 才会恢复其执行工具。

0.7.27 — 修复首次 Hub 安装因 Harness 生成空 cordis.yml 而失败的问题。Launcher 携带针对性修复的 Hub CLI；发布验证新增原生锁文件安装、launcher 首次启动及 Hub doctor 检查。

0.7.26 — Trigger 支持每次新建或复用 session、持久化 cron 和 delay job，以及受监管的脚本事件源；可通过 /trigger、CLI 或 agent 工具管理，共用工作区和审批边界。TUI 固定为 DSCODE 模式，切换模型时不支持的 effort 会回到目标默认值。TPS 使用接口返回的 token 数，按 request 次数做指数平滑；运行指标和 skills 在左侧，费用、DeepSeek 余额、峰谷和缓存率靠右，窄屏时整组移到第三行。OpenRouter 内容策略拒绝也会明确说明回合停止的原因。

0.7.25 — 再次运行安装器不再一律拒绝，而是让 tar 安装保持最新：旧版本交给它自己的 dscode update（迁移状态，旧目录保留为 .dscode-backup-<版本>），相同或更新则只报告、不做改动，不是安装器创建的路径仍然带着它找到的路径拒绝。安装方式新增 Homebrew——brew tap qiz029/tap && brew trust qiz029/tap && brew install dscode 装的是同一个 launcher，且该方式下 dscode update 只更新 Hub profile，launcher 由 brew upgrade dscode 负责。

0.7.24 — 事件现在可以无人值守地启动 session：触发器定义放在 <state>/triggers/ 和 <workspace>/.dsh/triggers/，事件只携带数据且必须带 eventId，用 dscode trigger / /triggers 运行和查看，trigger install 会写入 launchd LaunchAgent——运行失败目前还没有任何通知。/goal[20] 可在命令面板设置或重设目标的轮次上限。OpenRouter 侧，MiMo V2.6（pro、flash、ultraspeed）加入回传思考的模型行列，/model 改为精选 28 个模型——五个已调优家族加 Anthropic、OpenAI、Google、xAI 的旗舰线——而不是全部 373 个可调用模型；已在清单外模型上的会话仍可继续运行。

每次发布的完整记录见 更新日志，更详细的说明见 0.7.29 更新说明。

🚀 快速开始

需要 macOS 14+ 或 使用 glibc 的 64 位 Linux（x64 或 arm64；不支持 Alpine 等 musl 发行版）。在 Linux 上请安装 bubblewrap（apt install bubblewrap、dnf install bubblewrap），让命令在沙箱中运行；未安装时 DSCODE 退而使用 Landlock，两者都不可用时拒绝执行需要沙箱的命令。浏览器任务另需 Google Chrome，Git 用于代码仓库及补丁操作。无需安装 Node、npm、pnpm 或 DSH。

一条命令安装：

curl -fsSL https://raw.githubusercontent.com/qiz029/dscode/main/install.sh | sh

安装器自动识别 macOS 或 Linux 及处理器架构，下载最新的自包含发布包并验证 SHA-256 校验和。完整程序安装到 ~/.local/share/dscode-app，命令链接位于 ~/.local/bin/dscode。安装后，在项目目录运行 dscode 即可。如果 ~/.local/bin 不在 PATH 中，请将下面这行加入 shell 配置，并在当前终端执行一次：

export PATH="$HOME/.local/bin:$PATH"

包内自带固定版本的 Node、Harness、TUI、插件及原生依赖，首次启动不会通过 npm 或 Hub 安装运行环境。已有的 dsh 命令和 ~/.dsh 保持不变；DSCODE 的数据独立保存在 ~/.local/share/dscode-state。

直接升级：

dscode update             # 升级到最新的自包含发布版
dscode update 0.7.47      # 安装指定的自包含发布版

先退出正在运行的 DSCODE 会话和调度器。升级器校验后整体替换程序，保留设置、凭据和会话；替换失败会恢复旧程序。在 TUI 中输入 /update，会安排在退出后执行同一个升级器。再次运行安装命令，也会升级由该安装器管理的安装。

从旧安装迁移？ 旧 npm/Hub 版本需要迁移一次，旧版 dscode update 不会自动切换到新分发方式。安装器不会覆盖其他安装所拥有的 dscode 命令。Homebrew 管理的包使用 brew upgrade dscode；维护中的 tap 已使用同一份自包含发布包。迁移步骤见分发说明。上述命令需要已发布的自包含包，不会回退到旧版安装包。

也可以直接下载： 从 Releases 选择一个包：Apple 芯片选择 darwin-arm64，Intel Mac 选择 darwin-x64，Linux 选择 linux-x64 或 linux-arm64。例如：

mkdir dscode-app
tar -xzf dscode-0.7.47-darwin-arm64-standalone.tar.gz -C dscode-app
./dscode-app/dscode

解压后请保留整个目录：dscode 会使用同目录内的私有运行时和依赖。

运行 /login，在隐藏输入框中粘贴 DeepSeek API key：密钥以 0600 权限保存在本机 ~/.local/share/dscode-state/credentials.yaml，不同项目和安装版本共用，不会发送给 agent。已设置的 DEEPSEEK_API_KEY 环境变量优先。想使用 OpenRouter，输入 /provider openrouter：DSCODE 会提示输入 OpenRouter key（同样保存在本机，或读取 OPENROUTER_API_KEY），并把当前会话切到对应的 DeepSeek 模型；/model 随后只列出精选清单，而不是整个目录——DeepSeek、GLM、Kimi、Qwen、MiMo 的当前主力型号，加上 Anthropic、OpenAI、Google、xAI 的旗舰线——直接输入即可搜索。前五家经过适配和测试，后四家的旗舰尽力可用。清单外的模型在已有会话里仍可继续运行。/provider deepseek 切回，/login openrouter 可更换 key。OpenCode Go 订阅用法相同：/opencode login 用 OpenCode 账号登录，之后 /provider opencode-go 即可使用 Go 的 DeepSeek、GLM、Kimi、MiMo、LongCat、Hy 和 Space Bunny 模型。用 /model 选择模型或配置其他提供方，用 /effort 调整推理强度；默认路由是 deepseek-official/deepseek-flash。 TUI 启动时会检查 GitHub 上的新版本，/update 可在退出后自动完成整个安装的升级。

使用 Antigravity 时，先运行 /antigravity login，再运行 /provider antigravity，即可通过 Google 账号调用 Gemini，同时保留 DSCODE 的工具和权限流程。这是直接连接模型后端的社区接入方式；模型访问和额度由 Google 决定。

使用 OpenAI / ChatGPT 时，运行 /openai login 和 /provider openai；也可用 /openai api-key 选择 API Key 计费。通过 /effort 选择推理强度，通过 /speed standard|fast|ultrafast 选择速度。OpenAI 会话在估算输入达到 272,000 tokens 时压缩，小上下文模型会更早触发。

使用 Anthropic 时，先运行 /login anthropic（或设置 ANTHROPIC_API_KEY），再运行 /provider anthropic。通过 /model 选择 Claude Opus 5.5、Sonnet 5.5 或 Fable 5.1，通过 /effort 设置推理强度。这条路由直接调用 Anthropic API，使用 API 计费。 默认在可用输入窗口达到 50% 时自动压缩（预留输出预算后为 436,000 tokens）。

使用 /provider custom 添加自托管或私有 API，支持 Chat Completions、Responses 和 Anthropic Messages。配置地址及可选密钥，发现或手动添加模型，设置上下文窗口，并测试流式工具调用。支持视觉的模型可开启 Input → Text and images 来接收截图和图片附件；默认仅接收文本。已保存的服务会按名称显示在 /provider 中，按 Enter 即可切换到其模型。详见自定义模型服务。

默认英文，界面支持 6 种语言。 /language 打开选择器，/language ja 可直接切换；也可以直接写「中文」「日本語」「한국어」。支持 English、简体中文、繁體中文、日本語、한국어、Español。选择按机器保存在 $DSCODE_HOME/tui/language.json（默认位于 ~/.local/share/dscode-state），DSCODE_LANGUAGE=es 可覆盖单次运行。

dscode --continue                 # 继续上次会话
dscode --resume SESSION_ID        # 恢复指定会话（仍在该会话创建时的目录中运行）
dscode --cwd /another/project     # 在指定目录工作
dscode trigger list               # 本项目定义的事件触发运行（run|fire|install|log）
dscode doctor                     # 分析近期运行日志和 session trace
dscode --version                  # 输出 DSCODE 版本

自包含包使用自身固定的运行时，不复用或修改用户安装的 DSH。浏览器工具按需加载：请 agent 使用浏览器，或运行 /browser start。CSS 规则检查使用快照中的元素 ID，并要求全局及对应站点的 Developer 授权。专用持久 profile、连接已有 Chrome、通过实验性扩展共享选定标签页、标签页保留，以及实验性的 Desktop 侧栏预览、点选批注和站点权限控件见浏览器操作。侧栏可见且空闲时会同步其他地方的权限变更，清除受影响的预览并保留批注草稿。预览已通过隔离的本地测试，在共享 Web 客户端和官方 macOS Electron 应用中验证。桌面工具通过 skill 渐进加载，截图理解需要支持图片的模型；MCP bridge 支持 tools 和 resources。Linux Computer Use 支持 AT-SPI 局部观察、动作结果检查、共享桌面控制租约、X11/Wayland 输入和 server 专用桌面；/computer status 可查看实际能力。系统权限和 Wayland Portal 授权仍需单独提供，支持范围见 Computer Use。其他 MCP server 可在 config/mcp.local.yml 中添加。

实验性 Desktop 组合包可向官方应用添加 DSCODE 预设、自定义模型与账户设置、浏览器预览、持久化会话通信、跨会话记忆及按需启用的任务调度。Settings → DSCODE → Schedules 可管理任务，并在 Desktop 保持运行时投递。构建及本地安装步骤见浏览器操作。启用调度后的原生安装、升级、移除和重新安装，以及账户和调度界面的实际交互，已在 macOS Desktop 0.2.0-rc.2 上验证；验证边界见触发器。该包还包含实验性的原生 Computer Use 接入；窗口观察和输入操作仍待获得 macOS 辅助功能权限后验证。持久化的时间上下文会向 DSCODE agent 提供消息到达时间、转发等待时长和上一轮结束时间，普通聊天正文保持简洁。带独立命令前缀的 Desktop 诊断可检查所选会话、技能与 Host MCP 条目，匹配版本的使用指南随包提供。Desktop 邮件收件箱可预览共享本地邮件、连接 IMAP 或 Gmail OAuth，并将所选邮件加入 DSCODE 会话。背景同步需手动启用；发信沿用现有审批与回执规则。Session usage 侧栏展示 DSCODE 的费用、上下文、缓存、请求速度及逐回合估算。Delegation board 侧栏展示所选主会话的任务、依赖、worktree 和验证依据。Desktop 插件与终端包分别分发；终端弹窗及终端专属命令继续使用现有界面。

Desktop 插件使用 @toddzheng024/dscode-desktop 包名。0.7.35 移除捆绑的 Plugin Hub 界面、发现工具和运行依赖，DSCODE 仍在 Hub 目录中展示。适用于 Harness runtime 0.2.0-rc.2。在官方 Plugins → Add plugin 中输入 @toddzheng024/[email protected]，安装后选择 Enable now。更新后需完全退出并重新打开 Desktop。preview 和默认 latest 分发入口均更新到这个经过验证的预览版。

Settings → DSCODE 中的使用说明、Models、Accounts、Schedules 保持同级；Plugins → DSCODE · Community 打开相同页面。DSCODE 浏览器工具仅用于 DSCODE 会话。已有桌面模型和账户可直接在正常模型选择器中使用，额外提供方配置使用原生凭据存储。启用 Show coding view 和 Agent presets，完全重启后在新会话选择 DSCODE。

git clone https://github.com/qiz029/dscode.git
cd dscode
npm ci --ignore-scripts
npm run setup
npm start

⌨️ 常用命令

Shift+Enter 换行，!命令 运行本地 Shell 命令，Ctrl+L 只清屏，Esc 中断当前操作。完整命令以 TUI /help 为准，命令与 hooks 说明 覆盖其余部分。

🔧 权限与配置

默认使用 workspace-write sandbox 和 Auto 权限审核，适用的审批请求交给独立模型；/permission ask 切回人工审批。Ultra 不增加权限。Auto 的范围、成本与限制 →

支持 config/hooks.local.json、config/mcp.local.yml 和 config/harness.local.yml；这些本地配置、密钥与会话不会打入发布包。Skills 会发现目标项目的 .agents/skills、.dsh/skills，以及隔离的用户 skill 目录；用 /skills conflicts 排查同名覆盖。默认会把项目的 .codex/hooks.json、.dsh/hooks.json、.claude/settings.json 叠加到 config/hooks.local.json 之上；设置 DSCODE_PROJECT_HOOKS=0 可只加载安装级配置。Skills 来自项目的 .dsh/skills、.agents/skills 与用户根；默认还会发现当前目录到 home 之间每一层的 .dsh/skills、.agents/skills、.claude/skills，同名以更近的目录为准；设置 DSCODE_SKILL_ANCESTORS=0 可只保留项目与用户根。这些祖先目录里的 AGENTS.md/CLAUDE.md 会并入工作区指令。项目与用户根里新增的 skill 在会话运行中即可生效；修改 config/mcp.local.yml、config/harness.local.yml，新增祖先 skill 目录或改动祖先 AGENTS.md 之后，运行 /reload。

🧩 开发与发布

npm test                    # 单元与契约测试（隔离上游依赖）
npm run check               # 覆盖率、集成、TUI 与打包检查
npm run doctor              # 本地确定性 agent 集成检查
npm run dist                # 构建含私有 Node 的自包含发布包
node scripts/verify-standalone.mjs # 验证本机平台的完整发布包

make release 运行版本校验、完整检查、单包构建、本机安装验证及候选包归档。CI 另外在 Intel runner 上验证 x64 包。make publish 将终端包上传至 GitHub Release；Desktop 继续独立构建、验证和发布。node scripts/homebrew-formula.mjs 根据同一批包及其 SHA-256 生成配方；配方仍需同步到 tap。

DSH 固定为 0.2.1-rc.3（Desktop 组合包仍为 0.2.0-rc.2，即官方 Desktop 应用的运行时），内置 Node 固定为 24.21.0，TUI 基于 [email protected]，Computer Use 为 0.3.6。运行时补丁在构建阶段应用。当前流程见分发说明；旧 npm/Hub 构建流程保留在旧分发指南。上下文压缩评测位于 eval/。

📚 文档

设计记录不重复上面这些指南：

🤝 参与

欢迎提 issue 和 pull request。改动请先跑 npm run check，保持自包含包与旧 npm/Hub 工具的验证范围清晰。

📄 许可

MIT © 2026 Todd Zheng

基于 DeepSeek Harness、DSH-Code 与 DSH Plugin Hub。独立社区项目，非 DeepSeek 官方产品。