返回目录

dsh-nitro

精选清单收录维护状态: 活跃

clockclock1/dsh-nitro

极速交付模式:一个输入框开关驱动三个子系统——测试调用断路器、SEARCH/REPLACE 局部替换引擎、终端输出脱水。

前往 GitHub项目主页
$ dsh plugin add dsh-nitro

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置,然后重启即可。

了解安装方式

0

星标

0

Fork

JavaScript

语言

2026-11-05

创建于

2026-11-07

最近推送

README

dsh-nitro

输入框里随时开关的「极速交付」插件。 一个 ⚡ 开关驱动三个独立子系统,按会话独立、新会话默认开启,随时可对本对话单独关掉。

插件名 nitro 取自「氮气加速」——只在需要把想法一口气推到成品时才按下,松手即恢复常规工作流。

输入框开关(开启)

输入框开关(关闭)

插件列表里的 dsh-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 槽,id nitro,order 20)+ 会话头部只读徽标(conversation.session.header.actions 槽,id nitro-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}'

与其他插件的兼容性

在 GitHub 阅读完整 README →

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。