DeepSeek Harness / DSH Web 的 Windows 端口检查插件

每一个开发端口,
都能找到来源。

在 DeepSeek Harness 的 DSH Web 中看见谁正在监听、哪个 Session 启动了它,以及处理后端口是否真的释放。

Windows / DSH Web / TCP listeners

Port Inspector 展示本地开发服务的端口、项目和来源信息
真实 DSH Web 运行记录,端口、项目、启动方和处理方式分开表达。

为什么需要它

端口冲突只是表象,真正难的是没有上下文。

任务管理器能告诉你 PID,DSH 能管理 Job 和 Terminal,但两者之间缺了一条能核对的链路。

  • 这个端口属于哪个项目?
  • 它是哪个 Session、哪次 Tool Call 启动的?
  • 停止之后,端口真的释放了吗?

Port Inspector 把 Windows 的监听快照和 DSH 的启动证据放到同一个视图。

核心能力

从发现到收尾,证据始终在场。

它不是通用任务管理器,而是面向 Coding Agent 的 DeepSeek Harness 运行时检查和本地端口来源追踪工具。

端口 / PID / 应用 / 项目

看见监听

按端口、应用、PID、项目和 Session 搜索 Windows TCP 监听。

Session / Turn / Tool Call

追踪来源

沿 Windows 父进程链匹配 DSH 根进程,证据完整时才显示“由 DSH 启动”。

Managed / External / Read-only

安全处理

受管 Job 和 Terminal 走 DSH 生命周期,外部进程只允许对身份复核通过的单个 PID 操作。

Fresh scan / portReleased

确认释放

每次处理后重新扫描,用 fresh scan 明确反馈目标端口是否真的释放。

工作方式

它把两个世界接起来。

从 Windows 监听到 DSH Tool Call,每一步都保留在用户能理解的证据链上。

  1. 监听快照

    读取当前 TCP listeners,记录地址、端口、PID、应用和创建时间。

  2. 根进程身份

    观察 DSH 创建的根进程,并同时保留 PID 与创建时间,避免 PID 复用混淆。

  3. 来源核对

    沿父进程链把监听进程连接回 DSH 的 Session、Turn、Step 和 Tool Call。

  4. 人工确认

    用户先看清项目、来源和处理方式,再选择停止受管资源或结束单个外部进程。

  5. 重新扫描

    处理完成后获取 fresh scan,确认目标端口释放,同时保留其他服务。

产品证据

不是猜测,是一条能复核的链路。

真实界面显示端口、项目、启动方和处理方式。状态彼此独立,不把“属于哪个项目”误写成“由谁启动”。

Port Inspector 展示 Vite、PostgreSQL、Redis 和 Go 服务的监听结果
一个全栈演示项目中的真实监听结果。Docker 服务可以属于当前项目,但启动方仍保持未确认。

来源与处理分开

“由 DSH 启动”只描述来源证据,“可停止”描述当前可用的生命周期处理方式。

当前项目优先

界面默认优先展示当前项目和明确的开发工具链,其他监听仍可搜索和展开。

信息不足时收敛

无法读取完整来源或权限不足时,记录仍然可见,但能力保持只读。

DeepSeek Harness DSH Web 中的 runtime-story 工作区与 Port Inspector 插件入口
从 DeepSeek Harness 的 DSH Web 侧边栏进入 Port Inspector,保持在原有 Session 工作上下文中。

安全边界

允许做的事,和不应该自动做的事,清楚写出来。

安全处理不是一个隐藏的快捷键,而是由证据、权限和用户确认共同决定的边界。

只读默认

端口列表只用于诊断。模型可以读取有界、脱敏的信息,不能通过 Tool 直接终止进程。

身份复核

终止前同时校验 PID、创建时间和可执行文件,目标变化时立即拒绝操作。

局部影响

一次只处理用户明确选中的单个目标,不结束外部进程树,也不自动提权。

能力降级

系统进程、其他用户进程、受保护进程或证据不足的目标保持仅可查看。

它不是通用任务管理器,也不会自动把仍可能有用的后台服务判定为泄漏。

支持范围

为 Windows 本地 DeepSeek Harness Coding Agent 开发而做。

第一版聚焦一个真实而高频的场景:DSH Web 在 Windows 上运行多个本地开发服务。

Windows local

首版支持 Windows 本地执行环境和 TCP listeners。

DSH Web

通过标准 Bundle 安装,从 Web 侧边栏打开 Port Inspector。

开发工具链

适合 Vite、Node.js、Go、Python、Docker Compose 等本地服务场景。

立即开始

把下一次端口冲突,变成一个可回答的问题。

安装这个 DSH Web 插件,重启目标 DeepSeek Harness Web Profile,然后从侧边栏打开 Port Inspector。

安装或更新 Bundle 后需要重启目标 Profile;来源记录从新的 DSH 运行周期开始。

通过 npm 安装 PowerShell
dsh plugin --profile web add dsh-port-inspector@latest

前置条件Windows / Node.js >= 22.19.0 / DSH Web Profile

常见问题

在安装之前,先把边界讲清楚。

它是 DeepSeek Harness 的什么插件?

Port Inspector 是一个面向 DSH Web 的 Windows 本地开发端口检查插件。它把 TCP 监听、进程、项目、Session 和 Tool Call 放进同一条可核对的来源链路。

它会自动关闭所有后台服务吗?

不会。Port Inspector 默认只读。只有用户明确选择目标并通过身份复核后,才会进入受管关闭或外部单 PID 处理。

支持 macOS 或 Linux 吗?

Windows MVP 暂不支持 macOS、Linux、UDP、远程主机、跨重启历史、批量终止或自动治理。

来源信息不完整会怎样?

端口记录仍然可以显示。来源会收敛为启动方未确认,权限或身份不足时处理方式保持仅可查看。

需要启动另一个本地服务器吗?

不需要。它作为标准 DSH Bundle 的 Host 和 Browser 双半工作,不启动第二个伴随 Web 服务。