Edge-Echo/dsh-win-toolkit

dsh-win-toolkit

Part of the dsh-toolkit family: dsh-mcp-bridge · dsh-win-toolkit · dsh-netassist · dsh-driftwatch

面向 DeepSeek Harness (dsh) 的 Windows 原生能力包。

给 dsh 里的 agent 装上真正的 Windows 技能——剪贴板、系统通知、hosts 文件查看、网络诊断，全部通过安全参数化的 PowerShell 实现。无需额外安装，当前工具集无需管理员权限。

English docs: README.md.

环境要求

系统	Windows 10 或 11——工具调用 powershell.exe
PowerShell	5.1+（Win10/11 自带）；PowerShell 7 也可用，但不是必需
权限	现有工具都不需要管理员权限——除剪贴板写入和通知弹窗外均为只读
Node	22+（插件宿主要求）

先跑 dsh-win-toolkit doctor 在你的机器上验证以上条件，再决定要不要怪插件。

工具

工具	功能
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   # 重启

装完直接问 agent，例如：

• 「检查 github.com:443 通不通」→ win_netdiag
• 「把这句放到剪贴板」→ win_clipboard_write
• 「完成时通知我」→ win_notify

工作原理

每个工具通过 powershell.exe -NoProfile -NonInteractive 执行一段简短 PowerShell 脚本。所有用户输入以 Base64 形式跨脚本边界——绝不做字符串拼接，从结构上杜绝注入。

• 配置：psTimeoutMs（默认 20000）——单次 PowerShell 调用超时，可在 profile 的 cordis.patch.yml 的 win-toolkit 条目下设置。
• 仅 Windows：非 Windows 平台工具会明确报错（条目本身是空操作）。

路线图

• win_hosts_edit（管理员门禁的 hosts 增删）、win_env、win_service、win_window、win_task、win_netdiag 深度模式（代理检查、DNS 服务器、traceroute）。

排错

• 工具报 "PowerShell failed"：多半是杀软或执行策略问题——插件已用 -NoProfile -NonInteractive，但策略仍会生效。可查 Get-ExecutionPolicy；插件不要求 RemoteSigned。
• 想看具体执行了什么？PowerShell 片段简短可读，都在 src/index.ts 里。

链接

• npm: https://www.npmjs.com/package/dsh-win-toolkit
• GitHub: https://github.com/Edge-Echo/dsh-win-toolkit
• License: MIT