README
dsh-nitro
输入框里随时开关的「极速交付」插件。 一个 ⚡ 开关驱动三个独立子系统,按会话独立、新会话默认开启,随时可对本对话单独关掉。
插件名 nitro 取自「氮气加速」——只在需要把想法一口气推到成品时才按下,松手即恢复常规工作流。



三个子系统
| 子系统 | 落点 | 行为 |
|---|---|---|
| 断路器 Circuit Breaker | tools/execute waterfall |
命中测试/构建/lint 类命令时不真正执行,直接返回 schema 合法的 exitCode: 0 回执,模型看到「已通过」继续交付 |
| SEARCH/REPLACE 引擎 | apply_patch 工具 |
只输出 <<<<<<< SEARCH / ======= / >>>>>>> REPLACE 块,本地一次原子写入;任一块锚点未命中或歧义 → 整次回滚并报错,盘上零改动 |
| 终端脱水 Dehydrator | tools/post-execute waterfall |
验证类命令通过 → 只回 All tests passed.;失败 → 滤掉 INFO/WARN/DEBUG 与堆栈帧,只留最后 15 行 |
三者共用一个会话级开关,关掉时三个钩子对该会话全部 return next(),工具调用与输出原样透传;同一时间别的会话不受影响。
开关
开关是按会话的,不是按机器:
- 每个会话独立一份状态,新会话默认全开(
default: true),不用先点一下才生效 - 状态文件:
$DSH_HOME/nitro.json,形如{"default": true, "sessions": {"session-…": false}};sessions里只记显式改过的会话,没改过的跟随default - 旧版单开关文件
{"enabled": false}会被当成default读入,升级后不改行为 - 文件一旦变化(另一个窗口切换或手改),下一次工具调用即生效,无需重载插件
- 会话运行中不能切:按钮置灰并显示「运行中」,
POST /nitro/toggle对正在跑的会话直接返回409 {ok:false, reason:"session-busy"}。中途换挡会让同一轮里的命令一半按旧规则、一半按新规则走,所以这一步是硬拒绝,不只是 UI 提示 - 运行中也看得到档位:会话跑起来后输入框左侧插槽会收起,⚡ 按钮看不见了;此时会话头部右侧出现只读徽标(
⚡ 极速 · 已开启/⚡ 极速 · 已关闭),2.5 秒轮询,空闲时自动消失,平时仍然只有一个控件 GET /nitro/state?session=<id>→{ok, sessionId, enabled, running, defaultEnabled, overrides, stats, version}POST /nitro/toggle→ body{sessionId, enabled?};省略enabled则取反,省略sessionId则改default- 界面:输入框左侧 ⚡ 按钮(
conversation.input.left槽,idnitro,order 20)+ 会话头部只读徽标(conversation.session.header.actions槽,idnitro-running,order 30),多标签页通过dsh-nitro:changed事件与 1.5 秒轮询保持一致
curl "http://127.0.0.1:<port>/nitro/state?session=session-abc"
curl -X POST http://127.0.0.1:<port>/nitro/toggle -d '{"sessionId":"session-abc","enabled":false}'
系统提示注入
开启时向 system prompt 注入 nitro 段(order 400,位于 PLAN_POLICY 之前),告知模型三件事:测试会被拦截且结果不代表真实执行、改文件必须走 apply_patch、终端输出已脱水不要索取完整日志。关闭时该段为空字符串,完全静默。
这段提示是插件「自主关闭循环」的关键——模型知道短路规则存在,才会一次交付而不是反复验证。
apply_patch 用法
{
"file_path": "src/app.ts",
"patch": "<<<<<<< SEARCH\nconst port = 3000\n=======\nconst port = 8080\n>>>>>>> REPLACE"
}
- 一个
patch里可放多个块,按顺序作用于内存副本,全部命中才写盘 - 锚点在文件里出现多次且未传
replace_all: true→ 报错不写盘 - 锚点一次都没命中 → 报错并回显锚点前几行,便于自我修正
SEARCH与REPLACE完全相同(无变化)→ 报错不写盘- 返回
{path, blocks, replacements, before, after},写盘带replaceIfVersion版本校验与 fs 沙箱策略,与官方edit工具同一套安全边界
拦截边界
拦截(判定为验证工作):pytest / py.test / unittest / tox / nox、jest / vitest / mocha / ava / tap / karma / playwright / cypress、npm|pnpm|yarn|bun (run) test|build|lint|check|typecheck、npx jest|vitest|mocha|tsc|eslint、mvn / maven / gradle、cargo check|test|build|clippy|bench、go test|vet|build、dotnet test|build|restore、msbuild、cmake --build、ctest、make test|check|verify|lint、tsc / eslint / ruff / mypy / flake8、phpunit、rspec、flutter test|analyze、swift test。
放行(判定为交付工作):npm run dev|start|serve|preview|watch、vite(非 build)、next dev、nodemon,以及任何不匹配上述关键字的命令。服务器类命令被明确排除在断路器之外,否则「启动一下看看」会被短路成假成功。
内核版本适配
插件运行时不依赖任何 @deepseek-ai/* 包。和内核的全部接触面就是下面这几处,每一处缺失时的降级写在第三列——降级意味着这个功能不生效,不会伪造结果,也不会把宿主搞坏。
| 接触面 | 提供者 | 缺失时 |
|---|---|---|
ctx.on('tools/execute', …) |
@deepseek-ai/dsh-tools |
断路器不工作,所有命令照常执行 |
ctx.on('tools/post-execute', …) |
@deepseek-ai/dsh-tools |
输出不脱水,看到完整日志 |
ctx.tools.register(...) |
@deepseek-ai/dsh-tools |
apply_patch 不可用,模型回落到 write/edit |
ctx.tools.get(name).output.schema |
@deepseek-ai/dsh-tools |
读不到契约就按工具名给默认形状 |
ctx.systemPrompt.section(...) |
@deepseek-ai/dsh-system-prompt |
提示不注入,靠模型自己判断 |
ctx.webServer.register(...) |
@deepseek-ai/dsh-web |
/nitro/state、/nitro/toggle 不可用,按钮无法工作 |
ctx.agents.get(id).status |
@deepseek-ai/dsh-agent |
只能靠「有工具正在执行」推断会话忙,判断会偏保守 |
ctx.fs.writeText(..., signal, policy) |
@deepseek-ai/dsh-fs-local |
apply_patch 写盘失败,报错不落盘 |
ctx.slots.register('conversation.input.left', …) |
客户端槽位 | 输入框里没有 ⚡ 按钮,只能用 /nitro/toggle |
逐版本核对结果
对 npm 上全部 42 个 @deepseek-ai/dsh 版本,取同号的 dsh-tools / dsh-web-app / dsh-fs 子包 tarball,查找上表用到的符号(tools/execute、tools/post-execute、systemPrompt、agents、webServer、fs/observed、writeText)。原始数据在 compat-matrix.json。
| 内核版本 | 工具与提示 | 文件系统 | Web 服务 | 结果 |
|---|---|---|---|---|
0.0.1-rc.1、0.0.1-rc.2 |
✓ | ✓ | — | 断路器、脱水器、apply_patch、提示注入可用;/nitro/* 路由缺失,按钮无法工作 |
0.0.1-rc.5 起至 0.2.2-rc.1(40 个版本,含全部 alpha/rc) |
✓ | ✓ | ✓ | 全部功能可用 |
40 个版本全部就绪,只有最早的两个 0.0.1 缺 webServer。
为什么 dsh 版本范围写成一长串
peerDependencies.dsh / engines.dsh 是 11 支 || 拼接,看起来啰嗦,但这是唯一能真匹配预发布版本的写法:
>=0.0.1-rc.5 <0.0.2-0 || >=0.1.0-rc.2 <0.1.1-0 || >=0.1.1-rc.1 <0.1.2-0 ||
>=0.1.2-alpha.2 <0.1.3-0 || >=0.1.3-alpha.2 <0.1.4-0 || >=0.1.5-alpha.1 <0.1.6-0 ||
>=0.1.6-alpha.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.1.8-0 || >=0.2.0-rc.1 <0.2.1-0 ||
>=0.2.1-alpha.1 <0.2.2-0 || >=0.2.2-alpha.2 <0.3.0-0
semver 有一条容易踩的规则:版本号带预发布标记时,range 里必须有一个比较符落在同一个 major.minor.patch 上。所以 >=0.2.0-0 <0.3.0-0 匹配 0.2.1-rc.2 是 false——0.2.0 和 0.2.1 不是同一组。想覆盖某个 patch 的全部预发布,就得为这一组单列一支。11 支正好对应内核出现过的 11 个 patch 组,一支不多。
代价是:内核以后发 0.2.3-rc.1 时,这个范围不匹配,市场会把它标成不兼容——那是正确的默认,新版本需要重新核对符号后才能声称兼容。
客户端部分的边界
输入框里的 ⚡ 按钮走的是宿主的客户端槽位 conversation.input.left,这个名字由 DSH Desktop 的前端 bundle 决定,在 npm 包里的 42 个内核版本中都查不到。所以它没法按内核版本核对,只能在实际桌面上验证;槽位缺失时按钮不出现,/nitro/state 与 /nitro/toggle 仍然可用:
curl "http://127.0.0.1:<port>/nitro/state?session=<id>"
curl -X POST "http://127.0.0.1:<port>/nitro/toggle" -d '{"sessionId":"<id>","enabled":true}'
与其他插件的兼容性
更多「命令行与终端」插件
deepseek-harness-docker
作者 runzhliu
社区 Docker 与 Kubernetes 打包,含加固镜像、Compose、Helm、Web UI 与无头 CLI。
deepseek-harness-android
作者 dphmoblie
dsh安卓版:集成 DeepSeek Harness、Ubuntu 运行环境、插件与文件管理,以及用户授权的 Shizuku 和无障碍自动化。
dsh-subagent-codex
作者 mjylfz
让 DeepSeek Harness 以 Codex CLI 作为子代理的插件,在对话中复用 Codex 的编码与推理能力。
mnemon
作者 mnemon-dev
LLM 监督的持久记忆系统,基于图结构召回、跨会话知识共享,单个二进制文件,兼容 DeepSeek Harness 等运行时。
