前言¶
DeepSeek Harness（dsh）從 0.2.0-rc.2 起已內置 Plan 模式（@deepseek-ai/dsh-plan-mode），Composer 裏也有官方 PlanChip。但該 chip 是「僅退出」設計：會話不在 Plan 模式時組件直接不渲染，進入 Plan 只能靠手打 /plan，入口不顯眼。若你經常在「先規劃再實現」和「直接改代碼」之間切換，或希望新建會話默認落在某一模式，官方 UI 覆蓋不全。社區插件 dsh-plan-build-mode（維護者 yzhclcl，分類：客戶端）在權限控件旁提供常駐下拉，並在設置裏增加「默認模式」，形態類似 opencode 的 Build/Plan 選擇器。
這是什麼¶
dsh-plan-build-mode 是面向 DeepSeek Harness 的 Plan / Build 模式切換器：在 Composer 輸入欄權限控件（「完全權限」/ Full access）右側增加始終可見的下拉，切換當前會話模式；在 Settings → General 權限行下方增加 Default mode，決定新建會話的起始模式。底層仍映射官方 /plan 與 /plan off，不替換 plan-mode 機制本身。
- 目錄頁：https://www.skillhub.cn/plugins/yzhclcl/dsh-plan-build-mode
- 源碼：https://github.com/yzhclcl/dsh-plan-build-mode
- 許可證：MIT
- 當前包版本（資料）：1.1.0
核心功能¶
Composer 下拉¶
- 常駐顯示當前模式（
Build或Plan）與 chevron。 - 菜單兩項帶勾選：Build（直接實現，對應
/plan off）、Plan（只規劃不執行改動，對應/plan）。 - Plan 模式下使用官方
--dsw-alias-state-business-*令牌做藍色高亮。 - 切換進行中（
pending）時按鈕樂觀顯示目標模式；中途切換會在下一 turn 邊界生效，按鈕即時反映目標。
默認模式（設置）¶
在 Settings → General 中，權限行正下方的 Default mode 可選 Build / Plan，隻影響之後新建的會話，當前會話仍用 Composer 下拉。首次保存後，會在 ~/.dsh/profiles/<profile>/cordis.patch.yml 末尾寫入插件配置（例如 defaultMode: plan），屬正常的 config-editor 路徑；刪除條目或改回 build 即恢復默認行爲。
與官方 PlanChip 的關係¶
插件佔用同一插槽 conversation.input.plan，以 register({ priority: -1 }) 在最低優先級渲染，從而用雙向下拉替代僅退出用的官方 chip。卸載後官方 PlanChip 行爲立即恢復，不修改任何官方文件。
Plan 模式實際含義（使用注意）¶
Plan 模式是提示層引導（注入 plan:policy），不是沙箱：兩種模式下工具仍可用。若需要硬只讀，應改權限預設（如 Read Only），與 Plan 狀態無關。
安裝與啓用¶
Web profile 建議釘版本，避免 pnpm 發佈冷卻拉到舊構建：
dsh plugin --profile web add dsh-plan-build-mode@1.1.0
也可直接從 GitHub 安裝（無需 npm 發佈）：
dsh plugin --profile web add github:yzhclcl/dsh-plan-build-mode
桌面端：在應用內 Plugins 頁安裝；CLI 不能修改 profiles/desktop。
安裝後須完全退出並重啓服務該 profile 的進程。客戶端 bundle 版本來自文件元數據（mtime/ctime/size），僅刷新頁面不夠；版本 stale 時可能出現 client-modules: bundle script ... failed to load。
卸載：
dsh plugin --profile web remove dsh-plan-build-mode
卸載後同樣需要重啓。
典型用法¶
- 切換當前會話：點擊 Composer 權限控件右側下拉，選
Build或Plan。 - 設定新會話默認：打開 Settings → General → Default mode，選
Build或Plan並保存。
與手打 /plan、/plan off 等價，無需記命令。
適用場景與兼容性¶
適合：已在 DSH 0.2.x 上使用 Plan 模式、希望 UI 可發現地進出 Plan，或希望新會話默認 Plan/Build 的開發者。
環境要求（資料聲明）：dsh >=0.2.0-0 <0.3.0-0；在 0.2.0-rc.2、Windows、web profile 上已驗證下拉、設置行、持久化與新會話 pinning。0.1.x 宿主不在範圍內。
插件以當前 dsh 進程權限運行，安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-plan-build-mode 補的是官方 Plan 入口「只能退出、難以進入」的空缺：Composer 雙向切換 + 新會話默認模式，仍走內置 /plan 命令鏈。需要時可從目錄頁或 GitHub 安裝，記得釘版本並重啓 profile。
- 目錄：https://www.skillhub.cn/plugins/yzhclcl/dsh-plan-build-mode
- GitHub：https://github.com/yzhclcl/dsh-plan-build-mode
