前言¶
在 DeepSeek Harness（DSH）裏跑 workflow 時，階段推進、子代理派生與完成往往分散在會話與引擎事件裏。會話頂層卡片能反映一部分運行，但嵌套 workflow（例如在 PTC 或工具鏈深處發起的）不一定出現在卡片上。若需要一條可回看、可點擊子代理的視圖，就要額外借助專門的面板插件。
下面介紹社區插件 dsh-workflow-timeline（維護者 ruaruaTon，分類：工作流）：以 ZCode 形態把工作流階段推進與子代理狀態聚合爲時間線，並支持歷史持久化。
這是什麼¶
dsh-workflow-timeline 是面向 DSH 的純 JS 雙文件插件（index.js / client.js），零依賴、無構建步驟。它在宿主側半訂閱 workflow/* 引擎事件，在客戶端從 API 快照渲染時間線，把 workflow 的階段站點、子代理藥丸與運行表情集中展示。
許可證爲 MIT，當前包版本爲 1.0.0（以倉庫 package.json 爲準）。
核心功能¶
階段站點時間線¶
寬屏下爲橫向站點推進，窄屏（寬度小於 640px）切換爲縱向列表。站點間連接線隨進度由虛變實，並帶有 march 行進動畫。
表情狀態機小臉¶
界面使用 ZCode 風格小臉：間歇眨眼、掃視、跳動，並按運行狀態切換表情。
藥丸與子代理會話¶
子代理以藥丸形式展示；點擊可直達其會話（右欄 subagentchat，主會話作兜底）。完成態默認摺疊，可點擊展開。
入口與階段配置¶
可通過側邊欄圖標、中心面板、右欄頁籤（guide 菜單條目）進入。每個階段旁有 ⚙，可配置該階段使用的模型與併發（繼承宿主模型目錄）。
歷史持久化與嵌套 workflow¶
運行記錄寫入磁盤，重啓 DSH 後仍可回看，包含嵌套 workflow 的運行——這類記錄在會話卡片層面往往不可見，但引擎事件會到達本面板，這是與官方會話卡片的一處關鍵差異。
工作原理（簡述）¶
host 半訂閱 workflow/start、workflow/phase、workflow/agent-start、workflow/agent-end、workflow/end 等事件，在內存中聚合運行狀態並防抖持久化到 ~/.dsh/workflow-timeline-runs.json。client 半從 /api/workflow-timeline/runs 讀取快照並渲染時間線。
安裝與啓用¶
環境要求：DeepSeek Harness >= 0.2.1-rc.2（README 記載在 0.2.1-rc.5 與 0.2.2-rc.1、Windows Desktop 上實測過）。
通過插件市場或 npm 安裝時，使用倉庫 README 中的命令（請將 <你的profile> 換成實際 profile 名）：
dsh plugin --profile <你的profile> add dsh-workflow-timeline
也可在 DSH 界面選擇「插件 → 添加插件」，搜索 dsh-workflow-timeline 安裝。安裝後重啓一次 DSH；側邊欄出現時間線圖標即表示加載成功。
典型用法¶
- 按上文完成安裝並重啓 DSH。
- 從側邊欄時間線圖標、中心面板或右欄 guide 頁籤打開面板。
- 在 DSH 中正常運行 workflow；面板隨引擎事件更新階段與子代理狀態。
- 需要調整某階段模型或併發時，在該階段點擊 ⚙ 進行配置。
- 點擊子代理藥丸跳轉到對應會話；完成後可在時間線中展開已摺疊的藥丸回看。
若時間線空白，先確認是否已有 workflow 運行記錄——可先跑一個 workflow 再查看面板。
適用場景與注意¶
適合誰：經常編排多階段 workflow、需要觀察子代理派生/完成關係，或要回看包含嵌套 workflow 歷史的 DSH 用戶。
運行權限：插件在當前 DSH 進程權限下運行，會讀寫用戶目錄下的持久化文件（如 ~/.dsh/workflow-timeline-runs.json）。安裝前建議在社區目錄頁或 GitHub 查看源碼與 MIT 許可證，自行判斷是否符合環境策略。
故障排除（來自 README）
- 啓動失敗彈窗：僅點「Exit」，將 Windows 下
%APPDATA%\@deepseek-ai\dsh-desktop\logs\crash-*.log提交到倉庫 issue。 - 修改過
client.js後界面無變化：需再重啓一次 DSH（之後可刷新客戶端）。 - 時間線仍爲空：確認已產生 workflow 運行記錄。
社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；生態上 DSH 強調「一切皆插件」，本插件屬於其中的工作流可視化類擴展。
鏈接¶
- 社區目錄頁：https://www.skillhub.cn/plugins/ruaruaTon/dsh-workflow-timeline
- GitHub：https://github.com/ruaruaTon/dsh-workflow-timeline
經過上面的步驟，你可以在 DSH 裏用一條時間線對齊 workflow 階段與子代理狀態，並在重啓後繼續使用歷史記錄，彌補會話卡片對嵌套 workflow 可見性不足的問題。
