前言¶
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 生命周期拦截和接管官方功能。