前言¶
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 的編輯器內時生效；不處理修飾鍵；若事件已被其他處理程序消費，則交由後續處理程序；若
planprojection 不存在則無效。 - 事實來源：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）。
- 當
planprojection 缺失時（如 drafts、沒有 plan mode 的 presets）插件不工作。 - 重啓 DSH 後生效。
參考資料¶
- GitHub 倉庫：https://github.com/jdqingm/dsh-plan-build-toggle
- 社區目錄：https://www.skillhub.cn/plugins/jdqingm/dsh-plan-build-toggle
