dsh-port-inspector 今日发布

dsh-port-inspector 是专为 DeepSeek Harness（DSH）Web 版打造的 Windows 平台端口来源追踪插件，由独立开发者 IanHo 开发，托管于 GitHub（ianho7/dsh-port-inspector），同步发布于 npm。在使用 AI 编程助手开发项目时，经常遇到任务启动多个本地服务后，分不清某个端口属于哪个项目、哪个会话、哪个任务的问题。dsh-port-inspector 通过将本地 TCP 监听回溯至对应进程、会话与工具调用，帮助开发者在编程助手环境中安全处理端口冲突。

核心能力

dsh-port-inspector 提供八大核心能力：端口进程溯源展示所有 TCP 监听端口的应用程序、PID 和项目目录；DSH 生命周期关联识别哪些端口由 DeepSeek Harness 启动；Session / Turn / Tool Call 追踪将端口与具体调用链路关联；安全操作策略在来源不确定时绝不假装确定；重新扫描确认停止服务后自动核验端口释放；只读模型工具在架构上防止 AI 误操作；跨项目服务识别区分同一项目下各服务的所属任务；Windows 原生支持针对本地 TCP 监听优化。

安装配置

安装 dsh-port-inspector 插件需要三个步骤。首先确保已安装 DeepSeek Harness Web 版（dsh web）。然后先完全退出 DSH Web，执行安装命令：dsh plugin --profile web add dsh-port-inspector@latest。最后重新运行 dsh web，创建新任务，从侧边栏打开 Port Inspector 即可使用。

使用步骤

第一步打开 DSH Web，运行 dsh web 进入 DeepSeek Harness Web 界面。第二步创建新任务，新建一个 Job 或打开 Terminal。第三步启动服务，让 AI 编程助手启动多个本地服务（开发服务器、数据库、API 等）。第四步打开 Port Inspector，从 DSH Web 侧边栏找到并打开 Port Inspector 面板。第五步查看端口列表，浏览所有 TCP 监听端口，查看应用名、PID、项目路径、是否由 DSH 启动、以及对应的 Session/Turn/Tool Call 信息。第六步判断操作建议，根据插件提供的建议决定是停止 DSH Job/Terminal、结束单个外部进程，还是仅查看。第七步执行停止操作，对于外部进程在界面上明确选择目标 PID，经插件重新核对后执行停止。第八步确认端口释放，停止后插件自动重新扫描，确认目标端口已成功释放。

适用场景

AI 编程助手多服务调试场景适用：使用 DeepSeek Harness 开发时，让 AI 启动多个本地服务，需要追踪端口来源。端口冲突排查场景适用：多个项目同时开发，部分端口被占用无法启动新服务，需要定位占用进程。开发服务生命周期管理场景适用：不确定某个服务是否由 AI 助手启动，害怕误结束重要进程。团队协作环境场景适用：多人共用开发机，需要明确区分各自启动的服务端口。

工作原理

dsh-port-inspector 在 DSH Web 界面中嵌入侧边栏面板，通过调用 Windows 系统 API 枚举本机所有 TCP 监听端口，获取每个端口的进程 ID（PID）和进程可执行文件路径。插件维护 DSH 运行周期的会话记录，将每个 Tool Call 启动的服务端口与对应 Session / Turn 关联。用户触发端口操作时，插件优先引导通过 DSH 原生的 Job/Terminal 机制停止服务；对于外部进程提供明确的 PID 确认流程防止误操作。模型侧仅暴露只读的 port_list 工具，不具备进程终止权限，从架构层面杜绝 AI 自主结束进程的风险。停止外部进程前，插件会重新扫描端口确认目标仍在监听，确保操作准确性。

适用人群

DeepSeek Harness 重度用户日常使用 DSH 进行 AI 编程，经常需要启动多个本地服务时适用。独立开发者单人多项目并行开发，端口资源紧张，需要清晰管理时适用。技术团队负责人管理使用 AI 编程助手的团队，需要规范服务生命周期时适用。Windows 平台开发者在 Windows 环境下使用 AI 编程工具，对端口管理有强需求时适用。

官方链接

GitHub：https://github.com/ianho7/dsh-port-inspector npm：https://www.npmjs.com/package/dsh-port-inspector