前言¶
DeepSeek Harness (DSH) 的官方 Plan 功能通常通過提示詞和按鈕實現,對文件編輯的控制較爲寬鬆。如果你需要引入類似 Grok Build 的嚴格流程控制——包括 plan.md 的編輯硬閘和審批機制——dsh-grok-plan-mode 提供了對應的實現方案。
插件定位¶
這是一個將 Grok Build Plan Mode 移植到 DSH 的插件。它替換了官方 DSH Plan,使用 Grok 的狀態機管理流程,並強制要求對 plan.md 進行審批才能進入執行階段。
核心功能¶
- 替換官方 Plan:通過 Cordis 生命週期和 profile bundle 禁用官方的
ui-plan/plan-mode,接管/plan命令。 - 編輯硬閘:在 Plan Mode 激活時,模型只能修改當前 session 的
plan.md,其他編輯工具被攔截。 - 審批流程:退出 Plan Mode 時觸發審批卡(批准或拒絕),跳過
auto/always-approve設置。 - 狀態接管:接管會話狀態和輸入框控件,確保各預設中的官方 Plan 不會重新激活。
安裝與啓用¶
該插件僅支持 DSH 0.1.5-rc.2 版本的 web profile。
- 確保 PATH 上有
pnpm以及dsh(或npx @deepseek-ai/dsh)。 - 執行安裝命令:
dsh plugin --profile web add github:aa2246740/dsh-grok-plan-mode
- 安裝完成後必須重啓 Host 並刷新頁面,
dsh plugin add不會熱掛正在運行的進程。
常用命令¶
進入計劃模式後,使用以下命令或工具進行交互:
| 命令/工具 | 作用 |
|---|---|
/plan |
進入計劃模式 |
/plan <text> |
進入計劃模式並開啓當前輪次 |
/plan off |
退出計劃模式 |
/view-plan / /show-plan / /plan-view |
查看已保存的 plan.md |
/grok-plan-leave |
退出計劃模式(別名) |
enter_plan_mode |
模型主動調用進入 |
exit_plan_mode |
模型調用退出,觸發審批 |
適用場景與注意¶
- 維護狀態:項目於 2026-09-15 暫停維護,不再推薦安裝。建議使用 DSH 官方自帶的
/plan。 - 版本限制:僅支持官方 DSH 0.1.5-rc.2。
- 兼容性:卸載時需通過外部 Agent 執行
plugin remove命令,並確認官方 Plan 恢復,否則可能殘留接管邏輯。
結語¶
該插件通過引入 Grok 的狀態機和審批機制,爲 DSH 提供了更嚴格的計劃控制手段。雖然目前已暫停維護,但代碼結構展示瞭如何通過 Cordis 生命週期攔截和接管官方功能。