前言¶
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。
