dsh-gear-mode

dsh-gear-mode

挂挡真的很爽啊 ！！

给 DeepSeek Harness 装一列行动档位：对话区左侧滑轨一点即换挡，从「只读规划」到「全自动」，模型想升档得先问你，另有一个随时可拉的手刹。

它解决什么

同一个模型、同一句话，"该不该动手"往往取决于当下的意图。dsh-gear-mode 把这件事从口头约定变成一个可点击、可看见、可强制的状态：

• 换挡即向模型注入该档的行为提示词（与 sandbox:policy / approval:policy 同一注入机制，每条请求重读）。
• 模型侧只有一个 set_gear 工具：降档直接生效，升档会弹卡片问你，你点了才生效。
• 只在对话界面显示：打开插件 / 自动化任务 / 更多这些主面板时滑轨立刻隐藏，切回对话立刻出现。
• 手刹 H 落下后，工具调用被硬拦截（ctx.tools.guard），模型只能汇报现状，不能推进任务。
• 子会话（子智能体）自动进 D 档，档位槽只读：模型可自行降档，但拉手刹与升档都会被拒绝——子会话没有能批准或解除它们的用户。
• 状态是会话投影，resume / fork 后自动还原。

P   只读规划     R   只读复盘
N   交流组 ── NT 聊天 / NC 教练 / NE 解释
M   手动组 ── M- 逐步 / M+ 连续
D   委托         A   自治
H   驻停（手刹，覆盖所有档位）

安装

# npm
dsh plugin --profile web add dsh-gear-mode

# 或直接从仓库装
dsh plugin --profile web add github:Janrilw/dsh-gear-mode

把 web 换成你实际用的 profile 名（桌面版是 desktop），然后重启该 profile 即生效。

卸载：dsh plugin --profile web remove dsh-gear-mode。

这是 bundle 型插件：package.json 里的 dsh.bundle.patch 指向 cordis.patch.yml，装好即挂载；缺了它会被当普通依赖装进去但什么都不发生。

使用

档位

档位	名称	行为要点
P	只读规划	只读，构建计划；引导式提问补全细节，多步推进
R	只读复盘	只读，先给结论再看改动
NT	聊天	纯聊天，梳理思路与情绪支持，不主动代办
NC	教练	教练式引导：提问、复述、纠偏
NE	解释	直接解释原理、读代码、分析报错
M-	较大介入	每步先说明→等确认→执行最小步
M+	较小介入	小步连续推进，遇阻或需决策先停
D	委托	scope 内静默做完再汇报
A	自治	按约定目标/边界/预算全自动执行至验收
H	驻停	手刹，覆盖以上全部：不推进、不调工具，立即汇报现状

N 与 M 是组入口，不是独立执行档；点它们会落到默认子档（NT / M-）。

子会话（子智能体）不继承父会话档位，固定从 D 起步；A 需要 contract，只留给主会话。

交互

• 悬停看档位说明，点字母切档。
• 悬停组入口时，子档列贴着滑轨右缘展开，没有空隙。
• 沿滑轨上下拖拽可扫过档位，向右越过边界进入当前组的子档列。
• 静默淡出：切档完成或鼠标离开 5 秒后，只剩当前档位的字母、中文与滑块；碰回当前档位才淡入全部内容。
• 手刹：点一下 H 进入待落（环在 2.4 秒内填充），再点一下才落下；Ctrl+Shift+H（Windows）/ ⌘⇧H（macOS）走同一条二次确认。落下后按住 H 750ms 放下（回到 P）。手刹落下时点任意档位 = 由你解除并切到该档。

组入口展开子档列	悬停看该档的行为要求
手刹落下：整列变淡，H 变红	静默 5 秒：只剩当前档

命令

/gear              报告当前档位
/gear D            切到 D（同时解除手刹）
/gear H            拉手刹
/gear resume       仅解除手刹，档位不变
/gear P|R|NT|NC|NE|M-|M+|D|A

模型侧

• set_gear({ gear, reason? })：降档或拉手刹直接生效；升档会弹一张卡片请你批准（ctx.userQuestions，与自带 exit_plan_mode 同一套机制），你点了「允许」才切档，拒绝就保持原档位，模型不会重试。
• 注入的上下文同时给出 mode、handbrake、scope（沙箱模式 + 工作区根目录）与当前档位的完整行为要求。

子会话（子智能体）

在子智能体会话里打开这一列，看到的是只读档位槽：

• 起始档位固定 D，不随父会话变——父会话在 P，子智能体也要能干活；A 需要 contract，不适用于子会话。
• 滑轨只读：点击、拖拽、手刹、Ctrl+Shift+H 都不发命令，只提示「子会话档位只读（起始 D 档）」。
• 模型可自行降档（D → M- 等），档位显示会跟着变，但滑轨仍然只读。
• set_gear H 与 /gear H 会被拒绝；升档没有用户可批准，也会被拒绝（不会弹卡片到主会话）。
• 折叠会话日志时跳过从父会话继承的前缀事件，父会话的手刹不会压到子会话头上。

为什么不做成「子会话也能切」：宿主对子会话关掉了 slash 命令（CommandDirectory 返回空、remote.commands.execute 以 session/agent-busy 拒绝），前端根本没有可用的写通道。只读是宿主能力边界，不是省事。

提示词可外置

注入正文不硬编码：prompts.md 会被每次请求读一遍，按 ## 键 分节；保存后下一条消息即生效，不用重启。

• 键：P R NT NC NE M- M+ D A、BRAKE、ORDER。
• 逐节回退：某节缺失或为空 → 用内置那句；整份文件不存在 → 全用内置。
• 优先级：DSH_GEAR_PROMPTS > prompts.local.md > prompts.md > 内置。想留个人版本又不污染仓库，写 prompts.local.md。
• 用 npm 装时 prompts.md 在 node_modules 里，升级会被覆盖——长期改建议用副本 + DSH_GEAR_PROMPTS（环境变量由进程启动时继承，改完要重启一次）。

兼容性

• 实测：dsh 0.2.1-rc.3。
• engines.dsh：>=0.2.1-rc.2 <0.3.0。不满足时宿主不会激活它。

权限与风险

• 写入范围：只往会话里发一条 /gear <档位>，其他不动；子会话档位槽只读，连这条也不发。
• 网络：不请求任何外部服务，不含遥测，不收集任何数据。
• 提示词：会向每条请求注入一段运行时上下文（约 1–2 KB），内容全部来自本仓库的 prompts.md。
• 工具：set_gear 会出现在模型可用工具列表里；ctx.tools.guard 在手刹落下时拦截全部工具调用。
• 键盘：只注册 Ctrl+Shift+H / ⌘⇧H，其余按键不抢。

已知限制

• 模型升档要经过你批准（弹卡片）；子会话没有可批准的用户，升档直接拒绝，降档后也升不回去。
• 手刹不中断正在跑的回合（模型需要能把现状汇报出来），它约束的是"不再推进、不再调工具"；子会话永远不落手刹。
• 滑轨位置靠测量外壳标记（[data-shell-overlay]、[data-slot="main"]）得出；若外壳改结构，位置会失准。

License

MIT © 2026 JanrilW