前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的理念，通過插件擴展智能體的能力。在 Windows 環境下，智能體常需要與系統交互，例如讀寫剪貼板、查看 hosts 文件或進行網絡診斷。dsh-win-toolkit 插件通過安全的 PowerShell 腳本，爲 DSH 代理提供了這些原生能力。
插件簡介¶
這是由 Edge-Echo 維護的 Windows 原生能力包。它爲 DeepSeek Harness (dsh) 提供剪貼板讀寫、系統通知、hosts 文件檢查及網絡診斷功能。所有工具均由 PowerShell 後臺支持，當前工具集不需要管理員權限（剪貼板寫入和通知除外），且通過 Base64 傳輸輸入以防止注入攻擊。
核心功能¶
該插件提供以下工具：
- win_clipboard_read：讀取當前剪貼板中的文本。
- win_clipboard_write：將文本寫入剪貼板。
- win_notify：彈出系統通知提示（自動關閉）。
- win_hosts_list：讀取 Windows 的 hosts 文件內容。
- win_netdiag：對指定主機進行 DNS 解析及 TCP 端口連通性測試。
安裝與啓用¶
通過命令行安裝插件：
dsh plugin --profile web add dsh-win-toolkit
安裝完成後，重啓 dsh web 服務使插件生效。
典型用法¶
啓用插件後，可以在對話中直接調用上述工具。例如：
- 網絡診斷：詢問“check if github.com:443 is reachable”，系統將執行
win_netdiag。 - 剪貼板操作：請求“put this text on my clipboard”，系統將執行
win_clipboard_write。 - 狀態通知：指令“notify me when you’re done”，系統將執行
win_notify。
環境要求與限制¶
使用該插件需要滿足以下條件：
- 操作系統：僅支持 Windows 10 或 11。
- PowerShell：需要 PowerShell 5.1+ 或 PowerShell 7。
- Node.js：插件宿主需要 Node.js 22+ 版本。
- 權限：當前工具集不需要管理員權限（除剪貼板寫入和通知彈窗外，其餘爲只讀操作）。
- 安全性：所有用戶輸入均以 Base64 跨越腳本邊界，結構上防止了參數注入。
- 平臺限制：在非 Windows 平臺上，工具會報錯退出。
注意事項¶
由於插件依賴 PowerShell，執行策略可能會影響運行。儘管插件運行時使用了 -NoProfile -NonInteractive 參數，但系統級別的執行策略限制可能仍需手動檢查。
結尾¶
該插件是 Windows 環境下擴展 DSH 智能體系統操作能力的實用工具。更多細節與源碼，請訪問 GitHub。
