dsh-visual-plan

简体中文 · English

为 DeepSeek Harness（dsh）提供可视化计划模式： Agent 在 Plan Mode 中生成的计划会自动变成一张可编辑的节点图。你可以拖动节点、修改依赖、添加批注， 确认后系统生成 Plan Diff、创建新版本，并把用户批准的修订计划可靠地交还给 DSH 继续执行。

核心流程

用户需求 → DSH Plan Mode → 结构化 VisualPlan JSON → 节点图画布
        → 查看 / 编辑 / 批注 → Apply Changes → Plan Diff → 用户确认
        → 生成新版本（v1 → v2 → …）→ 修订计划回写 DSH → 按批准的计划执行

特性

• 计划自动可视化：Plan Mode 的 exit_plan_mode 输出自动转为 VisualPlan JSON，并用 DAG 自动布局渲染为节点图（节点不重叠、依赖清晰）。
• 完整编辑能力：新增 / 删除 / 编辑任务，拖拽修改依赖关系，任务类型与状态一目了然。
• 批注系统：给任意任务添加评论，随版本一起保存、可追溯。
• Plan Diff：提交前展示新增 / 删除 / 修改 / 依赖变更，用户确认后才写入。
• 版本化存储：每次 Apply 生成不可变新版本（.plan/revisions/vN.json），绝不覆盖用户已批准的计划。
• 可靠回写：以明确的修订消息把**批准版本（Plan vN）**交还 Agent，Agent 按该版本继续执行； 执行中遇到变化不得静默修改已批准的计划，必须先提出新计划由用户批准。
• 数据双轨：plan.json（机器接口）+ plan.md（人类 / Agent 阅读、Git 保存、调试）。
• Plan ↔ Agent 状态边界：plan.status / version / approvedVersion / executionVersion， 执行绑定到批准版本，为后续动态重新规划打好基础。
• 健壮性：JSON 校验、依赖不存在检测、循环依赖检测；解析失败时回退 Markdown 计划。
• 界面能力：主题跟随 / 白天 / 黑夜、地图开关、全屏、交互开关、左下角高对比度控件。
• 国际化：中文 / English，跟随 DSH 自带 Language 设置（默认中文）。
• 与 DSH 解耦：UI 与 Agent Core 隔离；关闭插件后 DSH 原有 Plan Mode 完全不受影响。

安装

需要 DSH >= 0.1.0-rc.6（当前验证于 0.1.0-rc.6）。

本地目录（开发中）

dsh plugin --profile web add /path/to/dsh-visual-plan

GitHub（发布后）

dsh plugin --profile web add github:/dsh-visual-plan

pnpm ≥ 10 首次安装 Git 依赖会拒绝执行 prepare 构建脚本，按提示把 dsh-visual-plan 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试即可。

安装后验证配置层并重启：

dsh --profile web --dump-config   # 应看到 "dsh-visual-plan" 层
dsh --profile web