dsh-plan-build-toggle：DeepSeek Harness 持久化 Plan｜Build 切换器

前言¶

DeepSeek Harness (DSH) 原生支持 plan mode（@deepseek-ai/dsh-plan-mode），包含 /plan、/plan off 命令以及 per-session 的 projection。但默认的 composer 控件（dsh-client-ui-plan）仅在 plan mode 激活后才会显示一个 “Plan ×” 芯片，在默认的 Build 状态下没有可见的模式控制。OpenChamber 提供了一个常驻的模式控制栏，通过 Tab 键切换。本插件在 DSH 上复刻了这一设计，使用相同的命令通道，不引入额外的模式词汇。

插件简介¶

dsh-plan-build-toggle 是一个 DeepSeek Harness 客户端插件。作者为 jdqingm，许可证为 MIT。它为 composer 提供了一个持久的 OpenChamber 风格 Plan｜Build 切换器，通过 host plan projection 驱动 DSH 原生的 /plan 命令通道。

核心功能¶

常驻分段药丸：在 composer 的 mode-control 区域（conversation.input.plan）显示 Plan｜Build 药丸。高亮显示：Plan 为警告色，Build 为中性色。
双向切换：点击 Plan 运行 /plan，点击 Build 运行 /plan off，与手动输入命令一致。
Tab 键切换：在 session 的 composer editor 中使用 Tab / Shift+Tab 切换（OpenChamber/opencode 规范）。仅当光标在该 session 的编辑器内时生效；不处理修饰键；若事件已被其他处理程序消费，则交由后续处理程序；若 plan projection 不存在则无效。
事实来源：Host projection 为状态真值。切换操作在 agent 运行时会排队为 pending，并随 projection 帧自动修正。
内联错误：命令通道拒绝切换时显示内联错误状态。
替换内置芯片：Bundle patch 禁用了内置的 ui-plan 行，避免 seat 冲突。

安装与启用¶

使用官方 CLI 安装：

dsh plugin --profile desktop add dsh-plan-build-toggle@0.1.0

或者从源码安装（无需 npm publish）：

git clone https://github.com/jdqingm/dsh-plan-build-toggle.git
cd dsh-plan-build-toggle
bash scripts/install.sh desktop

安装后必须重启 DSH 应用。

典型用法¶

点击 Plan 运行 /plan。
点击 Build 运行 /plan off。
在 session 的 composer editor 中按 Tab / Shift+Tab 切换。

适用场景与注意¶

Plan mode 是软引导（policy prompt section），不是强制沙箱。
不控制 draft sessions（plan state 是 per-session）。
当 plan projection 缺失时（如 drafts、没有 plan mode 的 presets）插件不工作。
重启 DSH 后生效。

参考资料¶

GitHub 仓库：https://github.com/jdqingm/dsh-plan-build-toggle
社区目录：https://www.skillhub.cn/plugins/jdqingm/dsh-plan-build-toggle