DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

wungjyan /

wungjyan/dsh-port-kill

Verified

DeepSeek Harness(DSH)的端口管理插件:列出本机 TCP 监听端口与占用进程,结束前复核身份,避免误杀被复用的 PID。支持 macOS / Linux / Windows。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@59dd774d

Port Kill

中文 | English

查看本机监听的 TCP 端口与占用它的进程,复核身份之后再结束它。

一个 DeepSeek Harness(DSH)插件。左栏一个入口,中间一整页列出本机所有 TCP 监听端口;每一行说清楚是哪个进程、哪个目录、什么时候启动的。点「结束」之前,它会重新扫一遍端口,确认还是你看到的那个进程。

端口列表与结束确认:列表逐行给出进程、工作目录、PID 与启动时间;弹窗在结束前列出会被一起释放的全部端口

和原版的关系

原版是 wungjyan/port-kill——一个 macOS 桌面应用,基于 Tauri 2、Vue 3 与 Rust,独立运行,不依赖 DSH。

只想要一个能扫端口、能结束进程的 Mac 小工具,直接去 Releases 下载客户端就行,不用装 DSH。

这个仓库是它的 DSH 插件版:界面搬进了 DSH 的 Web UI,和编辑器、终端、agent 在同一个窗口里;复核逻辑与排序行为保持原样。桌面版是 macOS 专用的,平台适配层只做在插件这边。

功能

列表

端口、进程名、PID、监听地址、启动时间。进程名下第二行是工作目录——家目录缩成 ~,家目录内保留完整相对路径,家目录外只留最后两段。两个都叫 node 的进程,靠这一行就能分清是哪个项目。

点任意一行展开详情:完整命令行、工作目录、全部监听地址、所属用户、协议与状态、启动时间。

搜索与排序

搜索框匹配端口、进程名、PID、命令行、工作目录与监听地址。端口、进程、启动时间三列可点击排序,再点一次反向。

只标注真正需要注意的事

端口对局域网开放时才有橙色「局域网可访问」标签,悬停说明监听地址以及怎么改回仅本机。仅本机是常态,不逐行标注。

自动刷新

工具栏上选 3 / 5 / 10 / 15 / 30 / 60 秒或关闭,默认 10 秒。也可以随时点「刷新」。

跟随主题

明暗模式跟随 DSH,不额外提供开关。

结束进程之前会发生什么

点「结束」弹出确认框,列出端口、进程名、PID 与命令行。确认后,Host 端会:

检查 拒绝时的原因
这个 PID 是不是 DSH 自己或它的祖先 结束了当前界面也会一起退出
PID 是否 ≤ 1 系统进程
端口是否仍由这个 PID 监听 列表已过期,让你刷新后重试
所属用户是否仍是当前用户 不能结束别人的进程
进程名是否仍一致 列表已过期
启动时间是否仍一致 PID 被复用了

启动时间是唯一能区分「同一个 PID 号」和「同一个进程」的字段,所以它缺失或读不出来时直接拒绝,而不是跳过——跳过等于放弃这项检查。

Windows 上「所属用户」和「进程名」这两项不比对:netstat 既不报告套接字属于谁,也不报告进程名,拿空值去比只会拒绝每一次操作。那边以 PID 与启动时间为准。另外,Windows 读不到进程父子关系时直接拒绝(503 self-check-unavailable),而不是当作「这个进程没有祖先」放行——那等于把自我保护关掉。

普通结束发 TERM,让进程有机会先保存数据;「强制结束」发 KILL。两个按钮的后果在弹窗里用一段大白话说明,「结束」是填充按钮并默认获得焦点,「强制结束」只描边。

一个进程占多个端口时会先告诉你。 信号是按进程投递的,结束一个进程会把它监听的所有端口一起释放。微信 8 个、IDE 4 个都很常见,所以弹窗会列出全部受影响的端口并高亮你点的那一个。

结束之后会检查端口有没有被重新占用。 watcher、nodemon、系统服务都会把刚空出来的端口抢回去。这不是错误,但你需要知道现在是谁占着。

Docker

Docker 发布的端口在宿主机上由 com.docker.backend 转发,所以那行的进程名是转发进程,不是容器。行内加 Docker · 容器名 徽章,详情里给出镜像与 compose 项目。

这类行的「结束」按钮不会真的发信号——结束转发进程不会停止容器,只会中断转发,并且影响这个容器已发布的其它端口。点它弹出说明窗口,告诉你容器叫什么、镜像是什么、该去哪停。

Windows 上转发进程是 com.docker.backend.exe,而容器的回环半边([::1]:3306)由 WSL 的 wslrelay.exe 转进来,所以一个已发布端口会出现两行:0.0.0.0 一行、[::1] 一行。两行都不发信号;wslrelay.exe 那一行给的是 WSL 的说明,而不是 Docker 的——结束它只会中断 WSL 的端口转发。

安装

在 DSH 插件市场搜索 Port Kill,或者用命令行:

dsh plugin --profile web add @wungjyan/dsh-port-kill

装完重启一次 DSH——新增的 bundle 层需要重启才加载。

也可以从本地目录装:插件 → 添加插件 → 选中仓库目录。这种方式是链接不是复制, 目录以后不能挪动或删除。

装好后左栏会出现「端口管理」(英文界面下是「Port Kill」)。

设置

插件页 → 端口管理 → 设置,保存在 ~/.dsh/port-kill/settings.json,重启后仍然生效。

  • 侧边栏名称:跟随界面语言 / 固定中文(端口管理)/ 固定英文(Port Kill)。改完立即生效
  • 自动刷新间隔:3 / 5 / 10 / 15 / 30 / 60 秒与关闭

用文件而不是浏览器存储,是因为 DSH 每次启动的端口都不同,而浏览器存储按来源隔离,换个端口就丢。

给 agent 的两个工具

插件注册了两个 DSH 工具,和界面走同一份实现:

工具 作用
port_list 列出端口,可按端口、进程名、命令等过滤
port_kill 结束进程,需要 confirm: true,返回受影响的所有端口

port_kill 同样经过上面那套复核。agent 拿到的列表和用户看到的列表来自同一次扫描,所以「界面过期」和「模型记错」是同一类问题,用同一道检查拦住。

平台支持

平台 状态 端口来源 进程信息来源
macOS 实测 lsof ps
Linux 实测 lsof ps
Windows 实测(Windows 11,见下) netstat -ano PowerShell Get-CimInstance

Windows 上有几项做不到,插件不会假装能做到:

  • 读不到端口属于哪个账号。 netstat 能看到其它账号与系统服务的监听,但不报告它属于谁,不提权也没有别的办法。这一栏留空,而不是把每个端口都算到当前账号名下——那会在系统服务那几行说谎
  • 读不到工作目录。 读其它进程的 cwd 需要调试权限
  • 没有可捕获的 SIGTERM。 「结束」和「强制结束」都会直接终止进程,弹窗会如实说明
  • 身份复核以 PID 与启动时间为准。 用户与进程名在 Windows 上读不到,跳过而不是比对空值

不支持的平台(sunos、aix 等)返回明确的「当前平台没有端口扫描实现」,而不是一个空列表。空列表是在断言「这台机器没有监听端口」,而实际上根本没读。

已知限制

  • 只能看到当前用户可见的监听(macOS / Linux)。 lsof 非 root 看不到其它 uid 的套接字,实测本机少两个端口。Windows 走 netstat,所有账号的监听都看得到,只是读不到归属。原版同样如此,提升权限需要 sudoers 或特权 helper,插件装不了这类东西
  • 杀不了 root 进程。 返回 EPERM,界面转成「没有权限」提示,不会崩
  • macOS 的 ps -o lstart 输出受语言环境影响,会把月份翻成「5月」。原版因此无法复核启动时间,插件给 ps 显式指定 LC_ALL=C 修掉了

开发

零运行时依赖,纯手写 JavaScript,没有构建步骤。

npm test        # node --test
npm run check   # node --check
host.js              Host 侧:HTTP 路由、身份复核、agent 工具
client.js            Client 侧:面板、侧边栏入口、设置页
settings.js          设置的读写与校验
platforms/
  exec.js            execFile 封装(超时、buffer、空结果退出码)
  parse.js           与平台无关的纯解析函数
  posix.js           macOS / Linux
  win32.js           Windows
  docker.js          Docker 归因
  index.js           后端选择与能力标志
cordis.patch.yml     把 Host 侧挂成 profile 的一个 loader 行

变化记录见 CHANGELOG.md。

许可

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit 59dd774d4949

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout