Edge-Echo/dsh-win-toolkit

让 agent 直接用上 Windows：读剪贴板、弹系统通知、看 hosts、测端口通不通。

什么时候需要它

• 你刚复制了一段内容，想让 agent 直接读，而不是粘贴到对话里
• 长任务跑完了，你在别的窗口，想收到一个系统通知
• GitHub 连不上，想让 agent 自己查清楚，而不是靠猜

每个值都以 Base64 穿过 PowerShell 边界，剪贴板内容和主机名无法构造出命令注入。doctor 会先自检环境，不用等用到时才发现缺东西。

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

English docs: README.md.

反馈

下载量能看出装了多少次，看不出有没有用。如果你在用，一句话说明你拿它做什么，比点个 star 有用得多——尤其是没跑通的情况，那是最不会有人主动说的：

• 你想做什么
• 它做到了吗
• 缺什么、哪里不对

开个 issue 说一句 —— 如果是明确的 bug，直接开普通 issue 就行。

环境要求

系统	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 端口测试
win_window_list	列出可见窗口：标题、进程、PID
win_window_focus	按标题子串把窗口切到前台
win_screenshot	截屏保存为 PNG，返回路径与尺寸
win_process_list	按内存排序的进程列表，可按名称过滤
win_open	用默认程序打开文件、文件夹或 URL

安装

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

相关

属于 dsh-toolkit 家族 —— 一组各自独立可用的小工具，面向 DeepSeek Harness：

• dsh-mcp-bridge —— 一条命令装好 6 个精选 MCP server，CI 逐个验证
• dsh-win-toolkit —— Windows 剪贴板、通知、hosts、端口检测
• dsh-netassist —— 网络与代理诊断，直接告诉你下一步
• dsh-driftwatch —— 两次会话日志的行为漂移报告
• dsh-ledger —— agent 到底动了哪些文件，且记录不可篡改
• dsh-release-evidence —— 每次发布一个可验证的证据包
• mcp-netassist —— 同一套网络检查，做成任意 MCP 客户端可用的服务器