dsh-easy-port-manager

Easy Port Manager

DSH 缁狅紕鎮? sidebar button + floating panel listing every dsh web instance on ports 3080-3129 (port, PID, live status) with graceful one-click stop, including Task-Manager-style stop of the current instance.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:xswt442-cmd/dsh-easy-port-manager#3add7329082bddfc1ca1a7a46951827581e91f70

Compatibility and provenance

Easy Port Manager is published as dsh-easy-port-manager and currently resolves to version 0.4.1. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 8/24/2026

Versions

README

dsh-easy-port-manager

中文 | English

在 DSH Web 的侧边栏底部添加「dsh 管理」入口。点击后打开浮动面板，列出本机 3080–3129 端口上的全部 dsh web 实例（端口 / PID / 状态），并可停止选定实例。

实例发现通过 HTTP 在本机实例之间完成；停止操作向目标实例发送请求，由其调用 harness 的 appExit 正常退出，会话照常写入磁盘。整个流程不启动任何子进程。

功能

实例列表：端口（链接直达）、PID、运行时长、活跃会话数、状态（当前会话 / 运行中 / 非 dsh 服务）；每 4 秒刷新一次，也可手动刷新。
启动新实例：在第一个空闲端口拉起一个新的 dsh web 实例（隐藏后台进程，日志写入 ~\.dsh\launcher\logs\）。
停止实例：向目标实例发送退出请求；未挂载本面板的旧实例会禁用该项并说明原因。
全部结束：两步确认后结束所有托管实例（含当前窗口所在实例）。
停止当前实例：需两步确认；结束后当前界面断开，会话保持持久化，重启 DSH 后可继续原会话。
样式：颜色使用主题 token，随深浅色切换；除启动新实例外全程不启动子进程。

安装

# 方式一：Git 依赖直装（推荐，无需本地 clone，重启 DSH 生效）
dsh plugin --profile web add "github:xswt442-cmd/dsh-easy-port-manager"

# 方式二：本地 link（开发调试）
dsh plugin --profile web add "E:\path\to\dsh-easy-port-manager"

装完重启 DSH Web 后生效。

卸载

dsh plugin --profile web remove dsh-easy-port-manager

工作原理

主机端在 webserver 上注册一个 JSON 路由 /dsh-easy-port-manager/api：

动作	说明
`action=list`	并发探测 3080–3129：先问 `action=self`（挂载了本面板的实例会自报 pid / 启动时间 / 活跃会话数），再回退页面标记探测
`action=self`	实例自报 `{ pid, port, startedAt, sessions }`
`action=start`	在第一个空闲端口启动新的 dsh web 实例（detached + windowsHide）
`action=stop&port=`	目标是自己 → 延迟 300ms 走 `appExit` 优雅退出；否则转发 `stop-self` 给目标
`action=stop-all`	结束所有托管实例（远程转发 + 自身优雅退出）
`action=stop-self`	自身优雅退出

全程不启动 netstat/tasklist/powershell 等任何子进程，与挂载的 shell 执行器无关。

结构

package.json       npm 元数据 + dsh.bundle.patch + dsh.client（浏览器半注册）
cordis.patch.yml   向 profile 插入本插件行
lib/index.js       host（/dsh-easy-port-manager/api JSON 路由）
lib/client.js      client（ModuleLoader 经典脚本 bundle，侧边栏按钮 + 浮动面板）

License

MIT

README

dsh-easy-port-manager

中文 | English

功能

实例列表：端口（链接直达）、PID、运行时长、活跃会话数、状态（当前会话 / 运行中 / 非 dsh 服务）；每 4 秒刷新一次，也可手动刷新。
启动新实例：在第一个空闲端口拉起一个新的 dsh web 实例（隐藏后台进程，日志写入 ~\.dsh\launcher\logs\）。
停止实例：向目标实例发送退出请求；未挂载本面板的旧实例会禁用该项并说明原因。
全部结束：两步确认后结束所有托管实例（含当前窗口所在实例）。
停止当前实例：需两步确认；结束后当前界面断开，会话保持持久化，重启 DSH 后可继续原会话。
样式：颜色使用主题 token，随深浅色切换；除启动新实例外全程不启动子进程。

安装

# 方式一：Git 依赖直装（推荐，无需本地 clone，重启 DSH 生效）
dsh plugin --profile web add "github:xswt442-cmd/dsh-easy-port-manager"

# 方式二：本地 link（开发调试）
dsh plugin --profile web add "E:\path\to\dsh-easy-port-manager"

装完重启 DSH Web 后生效。

卸载

dsh plugin --profile web remove dsh-easy-port-manager

工作原理

主机端在 webserver 上注册一个 JSON 路由 /dsh-easy-port-manager/api：

动作	说明
`action=list`	并发探测 3080–3129：先问 `action=self`（挂载了本面板的实例会自报 pid / 启动时间 / 活跃会话数），再回退页面标记探测
`action=self`	实例自报 `{ pid, port, startedAt, sessions }`
`action=start`	在第一个空闲端口启动新的 dsh web 实例（detached + windowsHide）
`action=stop&port=`	目标是自己 → 延迟 300ms 走 `appExit` 优雅退出；否则转发 `stop-self` 给目标
`action=stop-all`	结束所有托管实例（远程转发 + 自身优雅退出）
`action=stop-self`	自身优雅退出

全程不启动 netstat/tasklist/powershell 等任何子进程，与挂载的 shell 执行器无关。

结构

package.json       npm 元数据 + dsh.bundle.patch + dsh.client（浏览器半注册）
cordis.patch.yml   向 profile 插入本插件行
lib/index.js       host（/dsh-easy-port-manager/api JSON 路由）
lib/client.js      client（ModuleLoader 经典脚本 bundle，侧边栏按钮 + 浮动面板）

License

MIT

Easy Port Manager

Compatibility and provenance

Versions

Easy Port Manager

README

dsh-easy-port-manager

功能

安装

卸载

工作原理

结构

License

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

dsh-easy-port-manager

功能

安装

卸载

工作原理

结构

License