前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。當開發者或用戶需要管理多個工具、監控資源使用情況或接入外部服務（如微信）時，這些功能如果分散在各自的配置或獨立插件中，會增加管理的複雜度。dsh-tools 是一個常駐 web 插件，旨在將會話管理、插件開關、用量統計及微信接入等功能整合到一個統一的個人工具箱中。通過設置頁面的“dsh 工具箱”入口，用戶可以集中管理這些功能。
會話與插件管理¶
插件提供了完整的會話管理能力，支持歸檔查看、單條或批量刪除會話。列表會顯示每個會話與工作區佔用的磁盤空間。爲提升加載速度，會話列表採用先快速返回視圖再後臺補齊數據的方式，並對目錄大小做了磁盤緩存。刪除會話頁點擊工作區路徑可直接打開對應文件夾。
插件還包含插件市場功能。用戶可以查看、啓用/停用已安裝的插件，並檢查/更新/卸載這些插件。更新檢查支持 npm 註冊表與 GitHub（通過 Releases/tags API），點擊插件名可跳轉至其 GitHub 頁面。此外，插件提供了“插件分類視圖”，在 設置 → 插件 頁簽下新增分類篩選，支持查看官方、已安裝、本地三種分類。
系統與實用工具¶
系統級工具位於功能開關頁籤頂部，包含三項強制開啓的功能。任務完成提示會在當前對話任務完成且網頁未聚焦時，在 Windows 桌面右下角彈出系統通知框（置頂），點擊即可跳回會話。DeepSeek Harness 版本檢查功能會對比當前版本與 GitHub 最新 Release，每次 dsh web 啓動後僅首次打開時自動檢查。一鍵重啓 dsh web 功能用於開發測試，重啓後會自動打開新窗口並關閉舊頁面。
應用用量統計¶
應用用量功能提供多維度的數據分析。用戶可按時間跨度（今年、本月、近 7 天、近 3 天或自定義）和模型過濾，聚合各會話的 Token 使用量、緩存命中、時長與會話步數。趨勢圖基於真實會話日誌按自然日統計（含磁盤緩存與增量掃描），懸停圖表可查看具體數據。會話用量列表展示 Token、命中率與估算費用，支持配置價格。費用卡片默認按谷價計算，並提供一鍵切換峯/谷價格的功能。
微信接入¶
微信接入功能默認關閉，啓用後會在“dsh 工具箱”出現“微信接入”頁籤。該功能基於騰訊的 openclaw-weixin / iLink 協議，支持掃碼綁定個人微信，並通過 DSH Agent 進行文字聊天。支持白名單過濾與 room（所有用戶共享會話）或 per-user（每個用戶獨立會話）模式。同一微信賬號在同一時間只能有一個輪詢網關運行。
媒體處理方面，微信圖片、視頻、文件會自動下載到 ~/.openclaw/weixin-dsh/media/ 目錄，Agent 回覆中使用路徑標記即可發送。語音轉文字（ASR）和圖像理解（Vision）需要配置 OpenAI 兼容接口，文生圖（Image）需要配置圖像生成接口。所有 AI 憑據統一從環境變量或 ~/.openclaw/weixin-dsh/.env 文件讀取，權限設爲 0600。
安裝與啓用¶
安裝該插件需執行以下命令。該命令會自動完成依賴安裝並寫入激活層。
dsh plugin --profile web add dsh-tools
安裝完成後必須重啓 dsh web。重啓後，在 設置 →「dsh 工具箱」中即可看到各功能入口。對於微信接入功能，啓用前需在頁籤內配置環境變量或創建 .env 文件。
注意事項¶
- 維護狀態：本插件爲純 AI 製作，無人工維護，可能不會持續更新，請謹慎使用。
- 默認設置：微信接入默認關閉，需手動開啓並配置環境變量。
- 權限與安全：插件以當前 dsh 進程權限運行，建議安裝前檢查源碼與許可證（MIT）。微信憑據與 AI 接口密鑰存儲在本地文件，日誌中會對敏感信息做脫敏處理。
