前言¶
在 DeepSeek Harness 的開發流程中，智能體的探索往往伴隨信息的發散，而執行階段則常因缺乏結構化路徑而中斷。Ariadne 旨在彌合這一斷層，將抽象的對話轉化爲可視化的決策與執行地圖。
插件定位¶
引線 / Ariadne 是一個爲 DeepSeek Harness 設計的可視化決策工作臺。它由 Zayzz-pixel 維護，採用 MIT 開源許可證。插件的核心價值在於幫助用戶探索想法、聚焦分支，並將最終的選擇轉化爲可執行的流程圖。
安裝與啓用¶
在 Web profile 下安裝固定版本：
dsh plugin --profile web add github:Zayzz-pixel/dsh-ariadne#v0.3.0
dsh web
安裝完成後，新會話頂部會出現“對話 · 軌跡 · 引線”標籤頁。進入“引線”並打開工具欄開關，當前 Session 的 Agent 纔會獲得 Ariadne 的工具權限。
核心功能¶
插件主要解決結構維護、決策定案與執行推進三個環節的問題。
地圖與項目管理¶
- 增量維護地圖：對對話中的方向進行持續的結構化記錄。
- 外化結構：將 Topic、一級方向與縱深關係轉化爲可操作的結構。
- 項目總圖：從持久 Session Map 刷新項目總圖，聚合同一工作區的會話。
決策與執行圖¶
- 定案池：將“值得做”從“已經聊過”中分離，提供搜索與篩選功能。
- 執行圖生成：根據定案池生成 Final Plan v2 執行圖，用顯式依賴表達執行順序。
- 節點類型：支持 Task（任務）、Decision（判斷）、Checkpoint（檢查點）三種節點類型，以及成功邊、失敗邊與路線邊。
工作流控制¶
- 固定目標：固定本輪目標與組織口徑。
- 結構導航：圍繞當前節點保留結構導航，支持拖拽、縮放、摺疊、聚焦、編輯與導出。
- 逐節點執行：執行由用戶逐節點觸發，Agent 只處理當前節點，結果和證據寫回同一個 Run。
執行狀態與恢復¶
執行圖支持無環控制流，建議 5-20 個節點，上限爲 30 個。
節點推進邏輯¶
- Task：獨立驗收的工作包，成功沿
success邊進入下一節點。 - Decision：返回允許列表中的精確
routeKey，決定後續路線。 - Checkpoint：需用戶審閱或批准，批准後推進。
狀態與恢復¶
- 狀態流轉：支持 Ready、Running、Waiting（用戶批准）、Blocked（失敗/阻塞）等狀態。
- 歷史恢復：舊會話地圖、項目、Final Plan 與 Execution Run 可以直接恢復。
- 版本兼容：舊 Final Plan v1 在讀取時會自動轉換爲線性 Task 圖。
導出與數據¶
插件提供標準的導出格式，便於外部工具使用。
- 導出地圖：
brainstorm-map.md（Markdown）與brainstorm-map.canvas（JSON Canvas 1.0）。 - 導出執行圖：
brainstorm-execution.json與brainstorm-execution.md（附帶 Mermaid 流程圖）。
地圖導出包含個人筆記；執行圖僅包含共享記錄。
注意事項¶
- 環境要求：兼容 DeepSeek Harness
0.1.1-rc.2與 Web profile，需 Node.js 18 及以上。 - 權限與維護：DH 升級後，需要重新檢查工具、隊列、持久化和客戶端加載接口。
- 資源清理：關閉當前 Session 的引線後，相關工具會從該 Session 的模型工具目錄移除。
- 運行鎖定：活動 Run 處於特定狀態時，引線開關保持鎖定。
