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 智能體增加了一個可視化的項目規劃能力，通過右側面板和中心標籤頁同時展示步驟與架構圖，並支持導出圖片，有助於提升項目管理的透明度。