前言¶
在使用 DeepSeek Harness (DSH) 構建複雜工作流時，插件拓撲結構往往變得難以直觀把控。dsh-schematic 提供了一個統一控制平面，旨在解決可視化實時佈線、追蹤活動以及安全自動化插件藍圖的問題。
這是什麼¶
dsh-schematic 是 DeepSeek Harness 的一個插件，定位爲“人類和代理人的控制平面”。它由 Mason-1011 維護。其核心價值在於讓人類操作員和 Agent 操作員共享同一套控制機制：人類通過全屏可視化工作臺進行操作，Agent 通過 schematic_* 原生工具進行持久化操作，兩者基於同一套實時狀態、驗證規則和受保護的寫入管道工作。
核心功能¶
該插件提供以下核心能力：
- 可視化實時佈線與拓撲結構：界面即圖，支持探索實時拓撲或庫存、檢查依賴關係、配置插件、切換條目並替換提供商。
- 活動追蹤與調試：跟蹤會話事件和請求旅程、安排信號、過濾噪音，並檢查故障或延遲。活動遵循所有權，便於定位問題來源。
- 安全自動化插件藍圖：藍圖描述能力而非脆弱的快照。支持按能力組合、保存本地草稿、導入導出 YAML、檢查漂移並安全切換整個插件組合。每個有風險的更改都會獲得預覽。
- 人類與 Agent 對稱操作：支持英語和中文。界面與工具共享同一套計劃、驗證、確認門控和備份機制。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add dsh-schematic
安裝完成後，啓動 Web 服務並訪問可視化界面：
dsh web
# 然後在瀏覽器中打開
open http://127.0.0.1:3080/schematic
典型用法¶
除了通過界面操作，Agent 也可以通過對話使用以下工具進行管理：
- 查看拓撲與能力：
schematic_plugins
- 管理藍圖：
schematic_blueprint_list
schematic_blueprint_save
schematic_blueprint_switch
schematic_blueprint_manage
- 系統組合與活動佈局：
schematic_system_compose
schematic_activity_layout
適用場景與注意¶
該插件適合需要將插件拓撲結構可視化管理、通過 Agent 安全調整配置或需要統一觀察運行時活動的場景。
需要注意以下幾點：
1. 編輯權限：編輯功能默認關閉，可通過 config.edit.enabled=false 完全禁用。在移動端（寬度小於 768px）寫入功能會自動禁用。
2. 文件寫入機制：Schematic 僅在活動配置文件的 cordis.patch.yml 中寫入一個明確標記的託管塊，不會覆蓋源文件。如果源文件在待編輯下方發生變化，寫入將停止。
3. 藍圖存儲：藍圖作爲可讀的 schema-2 YAML 存在於 ~/.dsh/schematic/blueprints/ 下。現有的 schema-1 預設會進行冪等遷移並保持爲只讀備份。
4. 環境要求：需要 Node.js 版本 >= 22.19。
短結尾¶
dsh-schematic 通過將“圖”作爲界面，爲 DSH 插件系統提供了一個直觀、安全且人類與 Agent 共享的控制平面。它解決了配置複雜度高、缺乏可視化反饋和操作風險大的問題。更多詳情可查閱插件目錄：https://www.skillhub.cn/plugins/Mason-1011/dsh-schematic 或源碼倉庫：https://github.com/Mason-1011/dsh-schematic。
