双档加速器 burning-frappuccino/dsh-turbo

DSH OVERDRIVE

少走弯路，火力全开。 技术包名保持为 dsh-turbo，以兼容现有安装和社区链接。

中文说明

DSH OVERDRIVE 是面向 DeepSeek Harness 的原生双档执行引擎。它在输入区提供按会话生效的 Turbo 开关与两档滑块，并在 Host 运行阶段应用可撤销的执行策略，用来减少不必要的步骤和等待时间。

- 已在 Windows 桌面版 DSH 0.2.0-rc.2（build 04f392c9）实测。
- 每个会话独立保存开关状态；新会话默认关闭 Turbo。
- 关闭后不注入 Turbo 提示词，也不会改变上游请求。
- 不替换 Agent 循环，不修改权限、审批、沙箱或模型内部实现。
- Host 仍保留耗时、步骤、工具调用和验证记录；普通用户的 ? 弹窗只展示易懂的效果说明。

主要功能

| 功能 | 作用 |
| 原生 Web UI 开关与滑块 | Turbo 可关闭；开启后可拖动选择 极速 或 极限，只影响当前会话。 |
| Host 权威状态 | 状态保存在 Host，多个标签页发生冲突时以 Host 记录为准。 |
| 运行期策略 | 通过 DSH 支持的提示词与请求生命周期接口影响下一次执行。 |
| 推理强度控制 | 可在 Turbo 开启时使用更低的 reasoningEffort；模型路由拒绝时会安全撤销并重试。 |
| 极限并行策略 | 愿意多花 Token/工具预算时，一次发出互不依赖的读取、搜索、工具和可用子任务，压缩等待时间。写操作不会重复并发。 |
| 可观测数据 | 记录轮次耗时、模型步骤、工具调用及是否运行过验证命令。 |
| 完整回退 | 关闭或卸载插件后恢复默认执行路径，不修改 DSH 上游源代码。 |

用户同题实测

DSH Turbo 用户同题对照

一次相同提示词的单文件 HTML 任务对照结果：

| 指标 | Turbo ON | 默认模式 | 相对变化 |
| 完成耗时 | 6 分 55 秒 | 9 分 46 秒 | 减少 29%，完成速度约 1.41× |
| 界面显示 Token | 3.7M | 7.5M | 减少 51% |
| 模型步骤 | 42 | 72 | 减少 42% |
| 工具调用 | 41 | 71 | 减少 42% |

这是一次用户场景的配对试验，不是对所有任务的性能保证。界面显示的 Token 包含缓存读取，不能直接等同于新增 Token 或账单用量；任务、模型、缓存、网络和服务状态都会影响结果。完整方法和更大范围的基准测试请查看 PERFORMANCE.md，机器可读数据位于 benchmark/paired-ui-sample.json。

安装

插件市场上架后，推荐直接使用市场条目，或通过同一 GitHub 源安装：

dsh plugin --profile desktop add github:burning-frappuccino/dsh-turbo

不要运行 dsh plugin add dsh-turbo：npm 上的同名包属于另一个项目。本项目的市场条目和安装命令均以 github:burning-frappuccino/dsh-turbo 为准。

从源码安装：

git clone https://github.com/burning-frappuccino/dsh-turbo.git
cd dsh-turbo
pnpm install --frozen-lockfile
pnpm run build
pnpm test
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1 -Profile desktop

安装后刷新 DeepSeek Harness 页面；如果此前运行过旧版本，请完整重启 DeepSeek Harness，让 Node/Cordis 重新载入模块。

也可以从 GitHub Release 下载预构建的 dsh-turbo.tgz。

使用方法

1. 打开任意会话，在输入框旁点击 Turbo。
2. 开启后拖动两档滑块：极速 控制 Token 成本，极限 允许更多并行开销来换取更短等待。
3. 点击旁边的 ? 可以看到效果说明和同题测试建议。
4. 再次点击 Turbo 即可恢复默认模式；正在执行的请求不会被中途改写，新模式从下一次组装请求开始生效。

极限 只会加速能并行拆分的任务，不保证所有任务都更快；串行依赖、网络瓶颈和模型排队仍可能成为限制。

健康检查：

Invoke-RestMethod http://127.0.0.1:19387/api/dsh-turbo/health | ConvertTo-Json -Depth 5

卸载：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/uninstall.ps1 -Profile desktop

测试与资料

- 自动测试：46 项全部通过。
- PERFORMANCE.md：性能测试、用户同题对照与局限说明。
- compatibility-report.md：DSH API、Hook 和兼容性核查。
- STATUS.md：开发状态与文件清单。
- CHANGELOG.md：版本更新记录。

请作者喝杯咖啡

如果 DSH Turbo 帮你节省了时间，可以通过 TRON（TRC20）支持作者：

TX7iacb1LVD3sYMTeqrWwjYnSje2Yyi4qv

请确认使用 TRON（TRC20）网络并核对地址；链上转账无法撤销。

English documentation

DSH OVERDRIVE — 为 DeepSeek Harness 打造的双档执行引擎。

面向 DeepSeek Harness 的会话级低延迟执行模式，以原生插件形式提供：输入区带 Fast/Max 档位的 Web UI 开关、由 Host 权威管理的按会话状态，以及在 harness 自身生命周期边界上生效的真实运行时策略。

- 已在 Windows 上针对 DSH 0.2.0-rc.2（桌面构建 04f392c9）测试通过。
- 运行时完全不依赖任何 @deepseek-ai/ 包——Host 侧是普通 Cordis 插件，客户端 bundle 只 require 平台基线（react、react/jsx-runtime）。
- Turbo 关闭不是另一条代码路径：插件的提示词段落渲染为空字符串，因此行为与未安装插件逐字节一致。

构建所依据的已验证 host 事实（以及 Turbo 刻意无法控制的部分），见 compatibility-report.md。

实测用户结果

DSH Turbo 配对 UI 测试

同一提示词的配对 UI 任务，开启 Turbo 用时 6:55，默认模式用时 9:46：耗时减少 29%（吞吐 1.41×），界面显示的 token 用量降低 51%，模型步数减少 42%，工具调用减少 42%。这只是单个试点样本，不构成普遍保证。UI 的 token 计数器包含缓存 token，任务、模型与网络状况都可能改变结果。完整方法、机器可读样本与更大范围的基准测试见 PERFORMANCE.md 和 benchmark/paired-ui-sample.json。

它实际做什么

| 机制 | 位置 | 效果 |
| 提示词策略 | ctx.systemPrompt.section({ name: 'turbo:execution-policy', order: 700, text }) | 仅为处于 Turbo 的会话渲染选定的 Fast 或 Max 策略；其余情况渲染 ''。 |
| 按步策略标记 | agent/pre-step waterfall | 记录每一步实际生效的模式与档位，并写一行证据；从不阻断步骤。 |
| 轮次/工具指标 | session/event（turn/start、turn/end、tool/call） | 轮次实际耗时、步数、工具调用数、验证命令是否真的执行过。 |
| 推理强度 | agent 作用域的 agent/request waterfall，以 prepend 注册 | 每个档位可各自选择 reasoningEffort；Turbo 关闭时原样返回上游请求。id 被拒绝则禁用该调节项并重试该轮。 |
| Max 并行策略 | 提示词策略 | 在同一轮里把额外的 token/工具预算花在独立的读取、搜索、工具和可用子代理上。变更类操作绝不重复执行。 |
| 交付纪律 | 提示词策略 | 要求回复说明结果是否经过验证，并禁止在未运行测试时声称测试通过。 |

它不会：按名称/参数拦截工具、替换智能体循环、触碰权限/审批/沙箱，或修改模型内部。某项控制不存在时，UI 显示 unavailable，而不是假装有。

开关

- 关闭 → Turbo
- ON / Fast → ⚡ 极速
- ON / Max → 🔥 极限
- 拖动两档滑块切换档位
- 切换中 → Switching…
- 桥接不可达 → Turbo unavailable

它位于官方 conversation.input.right 槽位（提交按钮左侧的紧凑控件区）。任务书的首选方案 conversation.input.activity 是单占位槽，本身就要渲染提交按钮，没法再放一个额外控件——见报告 §2.2。点 ? 会打开面向用户的结果摘要，里面有取整后的收益数据和同任务 ON/OFF 测试的邀请。技术诊断信息仍可通过 Host API 获取，不向普通用户展示。

安装

1. 从市场或 GitHub 安装

市场条目发布后，直接在市场安装，或直接用同一个 GitHub 源：

dsh plugin --profile desktop add github:burning-frappuccino/dsh-turbo

不要运行 dsh plugin add dsh-turbo：npm 上叫这个名字的包是另一个无关项目。本插件的标准安装源是 github:burning-frappuccino/dsh-turbo。

2. 从源码构建（可选）

git clone https://github.com/burning-frappuccino/dsh-turbo.git
cd C:\path\to\dsh-turbo
pnpm install --frozen-lockfile
pnpm run build # writes lib/index.js + lib/client.js
pnpm test # 46 tests: state, gears, policy, toggle, compatibility

lib/ 是生成产物；包里已经带上它，使用者不需要工具链。

3. 把本地构建加到真正在运行的配置档

这台机器跑的是 desktop 配置档。两种等价做法：

(a) scripted, uses the CLI bundled with the desktop app
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1 -Profile desktop

(b) the harness' own plugin manager (Web: Plugins → install → local path,
or the plugin_manager tool with target = the plugin directory)
dsh plugin --profile desktop add link:C:\path\to\dsh-turbo

两者做的事一样：把包装进配置档，并在 dsh.profile.bundles 里选中它（随后 bundle 补丁会插入这一行）：

- id: dsh-turbo
name: dsh-turbo
config:
sectionOrder: 700
reasoningEffort: inherit
maxReasoningEffort: high
evidenceLog: true
storageDir: dsh-turbo
defaultMode: default
defaultGear: fast

配置档配置会实时重载，所以 Host 那一半立即挂载；客户端 bundle 会出现在启动图里，需要刷新一次页面（F5）才能在已启动的 shell 中生效。完整重启 dsh 也可以。

4. 更新到新版本（常见情况）

版本更新就是安装 + 重启，按这个顺序，别的都不用做：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install.ps1 -Profile desktop
then restart DeepSeek Harness

为什么重启不能省：运行中的进程持有它已导入的模块进程会按解析后的路径缓存已导入的模块（Cordis/Node 缓存），所以 lib/ 里的新行为无法就地生效。0.2.1 及更早的版本还有一个问题：新补丁引入未知配置键时，插件可能直接停用；当前源码遇到未来新增的键会告警并忽略，但已经在跑旧模块的进程仍需重启一次。install.ps1 会报告该行未激活，并提示你重启。

实操规则：

- 同时提升 package.json 和 src/version.ts 里的 version（node scripts/build.mjs --check 会强制校验）；
- 安装前先跑 node scripts/build.mjs，让 lib/ 与 src/ 保持一致；
- 重启后，Invoke-RestMethod http://127.0.0.1:19387/api/dsh-turbo/health 必须报告新的 version。

5. Windows PowerShell 注意事项

scripts/.ps1 在 Windows PowerShell 5.1 和 PowerShell 7 上都能跑：

- 加 -NoProfile：配置档里坏掉的 conda/python 初始化会在脚本启动前打印自己的 traceback（那段 traceback 不是本插件的问题）；
- 默认值在参数绑定之后才解析（$PSScriptRoot），因为在 -File 下 param() 里的 $MyInvocation.MyCommand.Path 是空的；
- resources\app.asar 是文件，所以内置命令行要通过 Electron 访问，绝不能用 Test-Path 去测归档「内部」的路径；
- harness 是 GUI 应用：脚本优先用 pnpm，并从配置档清单核对结果，而不是相信 GUI 进程的 $LASTEXITCODE。
重新构建了插件？ 运行中的进程会保留已导入的模块（Cordis/Node 按解析路径缓存），所以 lib/ 的改动需要重启进程——只把该行禁用再启用不够。这是 harness 的机制，不是插件 bug；见 compatibility-report.md §9。

6. 验证

Host half alive + capabilities
Invoke-RestMethod http://127.0.0.1:19387/api/dsh-turbo/health | ConvertTo-Json -Depth 5

Per-session state (use the id of an open session)
Invoke-RestMethod "http://127.0.0.1:19387/api/dsh-turbo/state?sessionId=<sessionId>" | ConvertTo-Json -Depth 5

在 GUI 里：打开一个会话，点输入框上的 Turbo，再点 ?——面板会说明实测的用户收益，并邀请你做同任务 ON/OFF 对比测试。技术能力状态仍可通过 Host 的 health/state API 查看，Host 日志必须出现 dsh-turbo: session … mode=turbo。

7. 卸载（完全可逆）

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/uninstall.ps1 -Profile desktop
or, with the harness' own manager:
dsh plugin --profile desktop remove dsh-turbo

管理器会取消勾选 bundle、卸载相关行并执行 pnpm remove；插入的行随 bundle 层一起消失，所以不会留下任何配置档补丁改动。加 -Purge 还会删除 $DSH_HOME/storages/dsh-turbo（保存的模式、指标和证据）以及基准配置档。

手动等价操作：

1. 从 $DSH_HOME/profiles/desktop/package.json 的 dsh.profile.bundles 里删掉 "dsh-turbo"；
2. 在该目录下执行 pnpm remove dsh-turbo；
3. 重启 dsh（或者等热重载完成）。

不卸载也能回滚：在配置档的 cordis.patch.yml 里把对应行改成 disabled: true，Host 那一半就不再应用任何策略，开关也会消失。

使用方式

- 新会话 → Turbo 关闭。
- 重新打开的会话 → 恢复上次确认的模式（已持久化）。
- 两个标签页 → Host 的版本校验优先；过期的标签页会显示 Host 的值和一条简短提示，不会把模式改回去。
- 回合中途切换 → 从下一次组装提示词起生效；正在进行的请求不会被改写。
- 插件已启用、会话已打开 → 通过 Host 注册表发现已有的 Agent；重复的生命周期事件不会叠加请求钩子。

切换的代价（如实说明）

- Turbo 开启后，该会话的每一次请求都会多出一个有序的提示词段落（约 200 token）。只要策略能省掉哪怕一步，净 token 就是减少的；一步都省不掉，就是小幅净增——用 token 换延迟，本来就是它的目的。
- 切换会改动系统提示词，所以 DSH 循环会在下一步做协调：in-history 路由会追加新提示词（前缀缓存保留），不支持的路由会做合并（从第一个变化的 token 起有一次缓存未命中）。这和 plan 模式已有的取舍一样。
- Turbo 关闭后不再有任何贡献：该段落渲染为空，组装时直接丢弃。

这里的「已验证」指什么

Host 的验证指标是对会话日志的观察：上一回合里有没有哪个 shell 工具调用看起来像 npm test、pnpm build、pytest、cargo test、tsc……？它仍可通过 Host API 获取，但不在公开的 ? 面板里显示。它不代表代码能跑通，Turbo 也从不拦截这类命令。提示词要求模型用文字说明是否做了验证，因为检查器读不出意图。

配置

| 键 | 默认值 | 含义 |
| sectionOrder | 700 | 提示词段落的插入位置（plan/team 策略与工具指引之间的无主空隙）。 |
| reasoningEffort | inherit | Turbo 开启时的请求级推理强度：off/minimal/low/medium/high/max，或 inherit 表示不动路由。由路由决定哪些值可用——随附的 DeepSeek Messages 适配器只接受 off/low/high/max，所以 minimal 会被拒绝。被拒绝时，该 Agent 的这个开关会停用并重试该回合，而不是让回合失败，能力行里也会注明。 |
| maxReasoningEffort | high | Max 档位的请求级强度。这是质量优先的设置：可能比 Fast 花更多时间和 token。 |
| evidenceLog | true | 每应用一步，就往 evidence.jsonl 追加一行 JSON。 |
| storageDir | dsh-turbo | $DSH_HOME/storages 下的子目录。删掉 evidenceLog 即可不记日志。 |
| defaultMode | default | 从未切换过的会话读到的模式。turbo 让 Turbo 成为部署默认值；基准测试框架用它来选定一个实验组。 |
| defaultGear | fast | 从未切换过的 Turbo 会话使用的档位。三组无头基准测试把它设为 fast 或 max。 |

已知键的非法值会被拒绝。未知键会给出警告并忽略，这样配置优先的滚动更新就不会让已加载的旧插件失效。

策略的适用范围：Host 那一半没有硬性服务依赖，所以同一个 bundle 在 Web/Desktop、无头一次性运行器（dsh --profile headless "…"）以及 SDK/ACP 配置档里都能用。只有 HTTP 桥和输入框切换按钮需要 Web 界面；其他地方策略、指标和证据照常运行，能力列表里会写 http-bridge: unavailable。

故障排查

| 现象 | 原因 / 修复 |
| 输入框里显示 Turbo unavailable | Host 桥没有挂载。检查 /api/dsh-turbo/health；如果返回 404，说明这一行没启用（dsh.profile.bundles 里缺 dsh-turbo，或者 disabled: true）。 |
| 切换按钮一直不出现，也没有报错 | 客户端 bundle 不在启动图里：安装后刷新页面（F5）；确认 dsh.client.platform: "web" 和 exports["./client"] 仍能解析。 |
| 加载时报 single slot ... already has a registration | 另一个插件占用了本插件要用的 slot；看浏览器控制台——插件会记一条警告并跳过注册，而不是弄坏输入框。 |
| Switching… 一直不结束 | 桥超时了（4 秒）。查 Host 日志里的 dsh-turbo: 行；模式没有改变。 |
| 点完之后模式马上回退 | 版本冲突——另一个标签页改了会话。按设计以 Host 的值为准。 |
| 详情里显示 prompt-policy unavailable | 配置档里没有 @deepseek-ai/dsh-system-prompt 这一行；Turbo 加不了提示词文本，会如实说明。 |
| evidence.jsonl 里什么都没有 | evidenceLog: false，或者目录不可写（每次失败会记一条警告）。 |

开发

pnpm exec tsc --noEmit # strict typecheck
pnpm run build # lib/index.js + lib/client.js (+ maps)
node scripts/build.mjs --check # CI gate: lib/ matches src/
pnpm test # node --test tests/.test.mjs
pnpm run check:issues # validate audit/issues.json + render audit/ISSUES.md
pnpm run check:issues:strict # exit 2 while an open high issue remains
node scripts/benchmark.mjs --help

基准测试 ON 与 OFF

scripts/benchmark.mjs 跑的是 GUI 用的同一个 0.2.0 运行时，走无头一次性运行器，任务集由机器校验（benchmark/tasks.json）：

- 每次运行一个全新工作区，用任务的 seed 字节初始化；
- 三组是 Default、Fast（low）和 Max（high），通过插件自己的模式/档位配置选定——配置档、模型、工具和安全设置都相同；
- 各组按轮换的拉丁方顺序执行，这样缓存预热和漂移不会
- 始终只采用一个分支；
- 指标来自运行器的事件流（实际耗时、首个 token、步数、工具调用、token 数、是否执行了验证），外加每个任务一条 Node 断言；
- 失败和超时的运行不会进入延迟与 token 的聚合统计，任务差值要求每个请求的分支在同一轮中完整通过。

专用配置档让 GUI 保持原样：

one-time: profiles/turbo-bench = dsh-base + dsh-headless + dsh-turbo
node scripts/benchmark.mjs --profile turbo-bench --limit 4 # pilot
node scripts/benchmark.mjs --profile turbo-bench --out PERFORMANCE-bench.md

实测数据见 PERFORMANCE.md。

目录结构：

src/host/ plugin row, session store, metrics, evidence, runtime adapter
src/client/ slot registration, toggle component, bridge controller
src/shared/ wire types + ExecutionPolicy vocabulary
src/prompts/ the single prompt section
tests/ state, runtime policy, toggle, compatibility contract
scripts/ build + benchmark harness

Turbo 开启与关闭的实测数据见 PERFORMANCE.md。

交付物对照表（brief §11）

| 要求 | 所在位置 | 验证方式 |
| 可安装的插件 | package.json（dsh.bundle.patch、dsh.client）、cordis.patch.yml、lib/ | plugin_manager.install_bundle → application: applied |
| 完整的 TypeScript 源码 | src/* | pnpm exec tsc --noEmit（strict） |
| 原生 Web UI 开关 | src/client/turbo-toggle.tsx | 检查插槽可见 dsh-turbo 在 conversation.input.right 中处于激活状态 |
| 可持久化的会话状态 | src/host/session-store.ts | 磁盘上的 state.json + 重新打开后恢复；版本冲突测试 |
| 运行时执行策略生效 | src/host/runtime-adapter.ts | evidence.jsonl 显示策略在 agent/pre-step 处切换 |
| 可恢复的默认模式 | 关闭时提示词段落渲染为 '' | 测试「turning Turbo off restores the untouched prompt」 |
| 支持的钩子与限制 | compatibility-report.md §3、§5 | 每行都标注了对应的 DSH 源码行 |
| 构建与安装说明 | 本文件、scripts/install.ps1 | 已在真实桌面配置档上跑通 |
| 卸载与回滚 | 本文件、scripts/uninstall.ps1 | 记录了 bundle、链接、插件行的移除路径 |
| 最小自动化测试 | tests/.test.mjs（40 个） | pnpm test |
| Turbo 开启与关闭的性能报告 | PERFORMANCE.md + benchmark/ | 在同一 0.2.0 运行时上运行 scripts/benchmark.mjs |

许可证

MIT — 见 LICENSE。

支持作者

如果 DSH Turbo 帮你省下了时间，可以用 TRON（TRC20） 请作者喝杯咖啡：

TX7iacb1LVD3sYMTeqrWwjYnSje2Yyi4qv

只发送 TRON（TRC20）网络支持的资产。区块链转账无法撤销，发送前请核对地址和网络。