[开源] 给 DeepSeek Harness 做了一个端口来源追踪插件

[IanHo]

用 DeepSeek Harness 开发时，我经常遇到一个问题：任务启动了几个本地服务，过一阵再看，已经分不清某个端口属于哪个项目、哪个会话、哪个任务，也不敢对着一排 node.exe 随便结束进程。

之前开发 maptoposter-online 时，我还踩过一次坑。Agent 完成任务后没有关闭开发服务，也没有任何提示。后来再次启动项目时端口报错，加上地图数据会缓存在 IndexedDB 中，更换端口启动很麻烦，检查了一圈原来是服务已经被默默运行，搞了乌龙白白浪费了时间。

所以我做了做了这个插件。

一句话定位：DeepSeek Harness 的 Windows Web 插件，可将本地 TCP 监听回溯至进程、会话与工具调用，保障编程助手安全处理端口冲突

GitHub： https://github.com/ianho7/dsh-port-inspector （求 Star ⭐）

它会在 DSH Web 里展示本机正在监听的 TCP 端口，并尽可能告诉你：

• 端口对应哪个应用、PID 和项目；
• 是否由 DSH 启动；
• 来自哪个 Session 、Turn 和 Tool Call ；
• 应该停止 DSH Job/Terminal 、结束单个外部进程，还是仅查看。

比如同一个项目里同时运行 Vite 、Go API 、PostgreSQL 和 Redis ，它可以识别哪些服务属于当前 DSH 任务、哪些只是关联到当前 Compose 项目。停止 Vite 后还会重新扫描，确认端口已经释放，同时确保其他端口没有受到影响。

这里比较在意的一点是：来源不确定时，不会假装确定。

DSH 管理的服务优先通过原来的 Job/Terminal 生命周期停止；外部进程只允许处理用户明确选择、并且经过重新核对的单个 PID 。模型侧也只有只读的 port_list 工具，不能自己结束进程。

目前只支持 Windows 、本地 TCP 监听和当前这次 DSH 运行周期。

安装前先完全退出 DSH Web ，然后执行：

dsh plugin --profile web add dsh-port-inspector@latest

重新运行 dsh web，创建一个新任务，就能从侧边栏打开 Port Inspector 。

项目 MIT 开源：

• GitHub： https://github.com/ianho7/dsh-port-inspector （求 Star ⭐）
• npm： https://www.npmjs.com/package/dsh-port-inspector

如果你也经常让 Agent 启动多个本地服务，欢迎试试看。遇到安装、兼容性或者来源识别问题，可以直接提 Issue 。