dsh-planchart: DeepSeek Harness 项目计划与架构可视化

前言¶

在 DeepSeek Harness (DSH) 中开发智能体时，向用户展示项目进度和系统架构通常依赖于纯文本。这种方式缺乏直观性，难以快速把握全局。dsh-planchart 插件解决了这一问题，它为智能体提供了一个可视化的展示面，将项目计划以步骤列表和架构图的形式呈现。

插件简介¶

这是一个 DeepSeek Harness 插件，允许智能体将项目计划作为右侧面板中的步骤发布，并在中心视图的 ‘PlanChart’ 标签页中显示框架图，支持导出为 SVG 或 PNG。

维护者：SmileBuild
分类：客户端
许可证：MIT

核心功能¶

项目规划展示面：提供专门的项目规划展示区域。
步骤面板：在右侧面板渲染项目步骤，显示阶段、状态标记和步骤详情。
框架图：在 ‘PlanChart’ 标签页显示自动布局的架构图。
图片导出：支持将图表下载为 SVG 或 PNG 格式。
自动布局：自动生成架构图的布局。

安装与启用¶

使用官方安装命令将插件添加到当前配置中：

dsh plugin --profile web add ./dsh-PlanChart

安装完成后，必须对浏览器进行硬刷新（Hard Reload），否则新的插件包无法加载。

典型用法¶

智能体可以通过调用工具和命令来发布和更新图表：

发布图表：使用 planchart_set 工具发布完整的图表，包含标题、摘要、步骤和框架。
查看图表：使用 /planchart 斜杠命令打印当前图表。
读取图表：使用 planchart_get 工具读取当前显示的图表内容。
更新图表：再次调用 planchart_set 工具即可更新整个图表。

数据结构¶

步骤数据¶

步骤包含状态、标题和可选的阶段信息。

{
  "id": "...",
  "title": "Build recipe CRUD",
  "status": "pending",  // pending | active | done | blocked
  "detail": "create, edit, publish",
  "phase": "Build"
}

框架图数据¶

框架图定义了节点、边和分组。

{
  "direction": "TB",                       // TB 或 LR
  "groups": [{ "id": "...", "label": "Client" }],
  "nodes":  [{
    "id": "...",
    "label": "Web app",
    "kind": "entry",                       // core | entry | output | store | external | default
    "note": "React + Vite",
    "group": "client"
  }],
  "edges":  [{
    "from": "web-app",
    "to": "api-gateway",
    "label": "HTTPS",
    "dashed": false
  }]
}

注意事项¶

硬刷新要求：安装后务必对浏览器进行硬刷新，否则插件无法生效。
会话持久化：图表属于当前会话，会在重启、恢复和分叉（fork）后继续存在。
子代理限制：从子代理内部发布的图表不会出现在面板中。
非自动清除：与待办列表不同，发布的图表不会被下一轮对话自动清除，除非再次调用 planchart_set。
渲染方式：图表使用纯色属性绘制，下载的 SVG 可独立渲染，不依赖 CSS 类。

适用场景¶

该插件适合需要在 DSH 界面中直观展示项目进度条、架构图或开发路线图的场景。由于图表以当前 DSH 进程权限运行，安装前请检查源码与许可证。

总结¶

dsh-planchart 为 DSH 智能体增加了一个可视化的项目规划能力，通过右侧面板和中心标签页同时展示步骤与架构图，并支持导出图片，有助于提升项目管理的透明度。