在 DeepSeek Harness (DSH) 環境中開發智能體時，需要實時查看當前任務進度、PRD 檢查清單以及規範使用情況。dsh-trellis-dashboard 插件爲此提供了一個集中式視圖。
插件定位¶
這是一個 DeepSeek Harness 插件，在 DSH Web UI 的對話視圖環中添加一個 Trellis 標籤頁，展示當前工作區的 .trellis/ 狀態。插件由 QianziTech 維護，採用 MIT 許可證。
安裝與啓用¶
先決條件是安裝了 DeepSeek Harness (dsh CLI) 並帶有 web profile，以及目標工作區已使用 Trellis 初始化。
安裝命令如下：
dsh plugin --profile web add dsh-trellis-dashboard
安裝完成後，重啓 Web 應用即可。可以通過 dsh --profile web --dump-config 驗證配置層是否已插入。
使用方法¶
- 安裝後，打開任意對話。
- 在對話視圖環中點擊“Trellis”標籤。
- 插件會解析當前工作區，並每 5 秒輪詢一次主機 JSON API。
- 點擊“Set as current task”按鈕以寫入會話指針。
核心功能¶
插件提供以下信息展示與操作：
- 任務與進度：顯示任務列表和當前任務的解析結果。如果當前會話未綁定任務，會顯示“No trellis task”而非隨機任務。
- PRD 檢查清單：在任務卡片中展示
prd.md的接受檢查清單。 - 規範與技能使用：實時讀取規範文件（通過
fs/observed訪問.trellis/spec/**、.agents/skills/**、.dsh/skills/**）以及技能工具加載情況（tools/result）。所有讀取均基於exec.agent.id範圍化，確保不同會話的活動不會泄漏。 - 會話摘要：展示工作區的開發者日誌索引和最新的
journal-N.md條目。 - 設置當前任務：通過“Set as current task”按鈕寫入會話指針，這是插件唯一執行的寫入操作。
技術架構¶
- 通信方式：僅通過 HTTP。客戶端通過輪詢
webServer路由獲取狀態，因爲不存在主機到客戶端的推送通道。 - 文件系統：主機端（
lib/index.js）通過ctx.fs讀取.trellis/目錄，不執行 Python 任務腳本。目錄保持只讀，僅對set-current-task接口進行寫入。 - 渲染：內置 Markdown 渲染器，在標籤內渲染標題、列表、表格、代碼等，無需外部運行時依賴。
- 依賴：插件依賴-free plain JavaScript，無構建步驟。
注意事項¶
- 必須使用帶有
webprofile 的 DSH CLI。 - 目標工作區必須使用 Trellis 初始化。
- 插件不依賴外部運行時，Markdown 渲染在瀏覽器端完成。
插件源碼託管在 GitHub。
