端口扳手的 DSH 面板:在 DSH 内查看监听端口、识别占用进程、关闭进程树;仅 Windows,需先安装并运行 PortWrench 本体。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:OldQin-Family/PortWrench#path:/packages/dsh-portwrench
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
PortWrench(端口扳手)的 DSH 插件壳:在 DSH 设置 → 插件 里加一个「端口扳手」面板, 内嵌本机 PortWrench 完整 UI——查看监听端口、识别归属、关闭进程树。
它是什么、不是什么
- 这只是壳:它把 DSH 和本机 PortWrench 服务连起来。
- PortWrench 本体(
port_console.py,Python)不随本插件安装——需要你自己在 本机下载并运行(见下方三步)。 - 所有安全闸(杀前身份复核、保护线、审计、频率闸)都在 PortWrench 本体服务端, 本壳不引入任何新权限。
使用三步
- 从 PortWrench Releases 下载 zip,解压到任意目录;
- 双击
启动端口控制台.bat(Windows、Python 3.10+;默认http://127.0.0.1:3999/,被占自动顺延); - 回到 DSH 设置 → 插件 →「端口扳手」,面板会自动检测并嵌入 UI。
PortWrench 未运行时,面板显示引导页(不会白屏)。
端口发现(3999–4098 自动探测)
- 本体从
3999起绑定,被占则顺延(最多 100 个端口,末位4098)。 - 壳页打开时并发探测整个 3999–4098 区间的
/api/v1/health,自动选最低响应端口嵌入—— 本体顺延到 4000、4001 时面板不再误报「未运行」,无需手工改地址。 - 探测只打回环 health(无敏感面),单口 800ms 超时;区间内无实例才显示引导页。
- 不读取本地文件、不做 4099 以上端口扫描(与本体顺延范围严格一致)。
卸载
DSH 插件:设置 → 插件 →「端口扳手」→ 卸载;或命令行 dsh plugin remove dsh-portwrench。
PortWrench 本体:直接删掉解压出来的目录即可——它不写注册表、不做开机自启、不留后台服务,删目录就干净了。
平台
- PortWrench 本体目前仅支持 Windows(依赖
taskkill/Win32_Process/Get-NetTCPConnection)。非 Windows 平台面板会提示暂不支持。
出问题怎么办
| 现象 | 先查什么 |
|---|---|
| 面板一直显示「PortWrench 未运行」 | 壳已自动探测 3999–4098;仍失败说明区间内确无实例:①看本体启动窗口是否开着②看启动窗口打印的实际地址,用浏览器直接开一次验证(被占会顺延,地址可能不是 3999) |
| 面板白屏 | 打开 DSH 的开发者工具看 Console——多半是壳没注册上(模块 id 与包名不一致会报 loaded without registering) |
| 设置页找不到「端口扳手」 | 插件没启用,或 DSH 版本低于插件要求 |
| 点了关闭没反应 | 那是本体的护栏在拦(目标受保护 / 端口易主 / 触发频率闸),看返回里的 reason 字段 |
面板里能看到端口列表 = 链路通了。 面板里能点、能关,说明 iframe 嵌的确实是本机那个本体。
隐私与安全
- 只监听
127.0.0.1,绝不开放外网;不做开机自启、不写注册表、不改防火墙。 - 关闭动作全部落审计日志;
api_token.txt是程序化通道凭据,不随壳分发;多占用仍需本机授权和一次性user_grant_id。
来源
- 本体与设计:PortWrench(MIT)
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37918
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8650
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5964
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2216
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 2002
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。