前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在開發和管理智能體工作流時，開發者通常需要頻繁查看知識圖譜狀態、管理集羣資源以及監控運行指標。dsh-plugin-sirchmunk 是一個 DSH 原生 Web 插件，它直接向 DSH 的設置界面注入了一個名爲 Sirchmunk 的區域。這個區域集中提供了知識圖譜查看、集羣管理、運行監控和隱私設置等功能，避免了在多個獨立工具間切換的繁瑣。
核心功能¶
該插件通過 DSH 的 settings.section 插槽註冊，ID 爲 sirchmunk，排序爲 35。主要包含以下能力：
- 知識圖譜展示與導出：在界面中可視化展示圖譜節點，並支持將當前圖譜導出爲 JSON。
- 集羣管理：列出集羣列表。對刪除等破壞性操作，插件增加了全局寫權限開關和二次確認步驟，防止誤操作。
- 運行時監控：通過適配層讀取 Sirchmunk API 數據，實時顯示 CPU、內存佔用及服務運行時長。
- 共享歷史：展示帶時間戳的審計日誌和活動記錄，便於追蹤系統狀態變更。
- 隱私與脫敏：提供敏感數據脫敏開關、可配置的掩碼關鍵詞以及全局寫操作權限控制。
- 內置 Agent Skill：提供名爲
sirchmunk-search的標準技能。該技能允許 Agent 或用戶通過 MCP 工具mcp__sirchmunk__sirchmunk_search檢索本地文檔庫。支持對 PDF、Word、Excel、Markdown、代碼等 100+ 種格式進行查詢，並提供 FAST（快速匹配）、DEEP（深度分析）和 FILENAME_ONLY（僅文件名）三種模式。
安裝與啓用¶
在 DSH Host 使用的 Node.js 包環境中安裝該插件：
npm install dsh-plugin-sirchmunk
安裝完成後，必須重啓 DSH Host。重啓後，DSH 會應用 bundle patch 並加載瀏覽器模塊，設置界面中會出現 Sirchmunk 區域。
實現細節¶
該插件遵循 DSH 的 Host/Client 分離架構：
- Host 入口：位於
lib/index.js，導出名稱和apply(ctx)方法。 - Browser 入口：位於
lib/client.js，通過window.__ModuleLoader__.load注入。
React 和 ReactDOM 被聲明爲 peer dependency，由 DSH 運行時提供。瀏覽器構建中這兩個包被標記爲外部依賴，不會被打包進發布的客戶端包中。
注意事項¶
- 依賴本地服務：當前 UI 界面通過本地 Sirchmunk 服務的健康檢查端點
http://localhost:8584/api/v1/health獲取狀態。圖譜、歷史和監控數據通過src/services/api.ts中的適配層讀取，後續可替換爲生產後端而無需修改插件入口。 - Agent Skill 使用：內置的
sirchmunk-search技能依賴本地 Sirchmunk 服務運行，用於進行跨格式的本地知識檢索。
