前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在使用過程中，開發者可能會積累多個零散的工具想法或功能需求。dsh-tools 插件通過在設置頁面提供頁籤式導航，將這些功能收納到一個統一的工具箱中，方便集中管理和即時調用。
插件概覽¶
dsh-tools 是一個面向 DSH Web Profile 的個人通用工具箱插件。作者爲 LoKiGGo，採用 MIT 許可證。它不是一個單一的強功能工具，而是一個集成平臺，允許用戶通過開關控制多個獨立功能的啓用與停用。
安裝與啓用¶
安裝過程通過 DSH 官方 CLI 完成，支持一鍵激活。
dsh plugin --profile web add dsh-tools
執行上述命令後，插件會自動完成依賴安裝並寫入激活層。安裝完成後需要重啓 dsh web 服務，進入“設置”菜單，點擊“dsh 工具箱”即可看到管理界面。
核心功能¶
該插件收納了系統維護、會話管理、插件生態及應用監控等多類功能。
1. 功能開關與系統工具¶
設置頁頂部爲常駐功能，包括：
* DeepSeek Harness 版本檢查：檢查宿主版本與 GitHub 最新 Release，僅檢查不自動升級。
* 一鍵重啓 dsh web：重啓服務並自動打開新窗口，關閉舊頁面，用於開發測試循環。
* 任務完成提示：當網頁未聚焦且對話任務完成時，在桌面右下角彈出系統提示框，點擊可跳轉回會話。
下方爲可選功能開關列表，開關狀態即時生效並持久化保存。
2. 會話管理¶
在“會話管理”頁籤中，可以執行以下操作：
* 歸檔與刪除：支持單條刪除與批量刪除會話，並提供歸檔功能。
* 磁盤佔用：查看每個會話及工作區佔用的磁盤空間。
* 文件操作：點擊會話路徑可直接打開對應文件夾。
* 加載優化：先快速返回列表，後臺補齊大小與磁盤緩存，提升打開速度。
3. 插件生態¶
- 插件開關：控制已安裝插件的啓用與停用，點擊插件名可跳轉至其 GitHub 頁面查看詳情。
- 更新檢查：檢查並更新已安裝的插件，支持 npm 註冊表與 GitHub 安裝源。
- 插件分類視圖：在“設置 -> 插件”中新增“插件分類”頁籤，可篩選瀏覽官方、已安裝（市場/GitHub/npm）及本地插件。
4. 應用用量¶
在“應用用量”頁籤中，可以按時間跨度（今年/本月/近7天等）聚合查看：
* Token 使用量
* 緩存命中率
* 會話時長與步數
* 估算費用（支持峯/谷價格切換）
5. 微信接入¶
通過“微信接入”頁籤，可以使用騰訊 openclaw-weixin / iLink 協議將個人微信接入 DSH Agent。
基礎配置：
* 掃碼綁定微信賬號。
* 白名單模式：爲空時僅記錄模式，配置後放行。
* 會話模式：支持 room（共享會話）或 per-user（獨立會話）。
* 媒體收發：圖片、視頻、文件自動下載到指定目錄，Agent 回覆中通過語法（如 [image:路徑]）發送回微信。
* AI 能力：支持配置 ASR（語音轉文字）、Vision（圖像理解）、Image（文生圖）的 Base URL、Key 和 Model。
注意： 同一微信賬號同時只能有一個輪詢網關。
配置文件¶
插件的配置存儲在本地 JSON 文件中，路徑通常爲：
<DSH_HOME>/profiles/web/plugins-data/dsh-tools.json
首次修改時自動生成，修改前系統會自動備份原文件。配置結構包含 features（功能開關狀態）和 featureConfig（各功能的擴展配置）。
注意事項¶
- 維護狀態：本插件由純 AI 製作，無人工維護，可能存在後續停止更新的情況，請謹慎使用。
- 依賴更新：更新宿主依賴（如 peerDependencies）時，必須刪除
package-lock.json和node_modules後重裝，否則可能因版本範圍不匹配導致安裝失敗。 - 微信憑據：微信登錄憑據保存在
~/.openclaw/openclaw-weixin/accounts/，請勿泄露。 - 權限要求：插件運行時需具備讀取宿主會話日誌及操作本地文件系統的權限。
