dsh-instance-manager

Instance Manager

DSH 实例管理面板：通过 Mini Utility Dock 列出本机 3080–3129 端口的全部 dsh web 实例（端口 / PID / 运行时长 / 会话数），支持优雅停止、两步确认停止当前实例、一键全部结束与新实例启动。Mini Utility Dock panel for DeepSeek Harness: list every local dsh web instance on ports 3080-3129 (port/PID/uptime/sessions) with gracef

Target profile

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

npx -y @deepseek-ai/dsh plugin --profile web add dsh-instance-manager@0.9.12

Compatibility and provenance

Instance Manager is published as dsh-instance-manager and currently resolves to version 0.9.12. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: npm
Registry updated: 9/20/2026

Versions

0.9.12stable

9/17/2026

0.9.10stable

9/17/2026

0.9.9stable

9/17/2026

Show 16 more versionsCollapse versions

0.9.8stable

9/16/2026

0.9.7stable

9/15/2026

0.9.6stable

9/14/2026

0.9.5stable

9/4/2026

0.9.4stable

9/2/2026

0.9.3stable

9/1/2026

0.9.2stable

8/31/2026

0.9.1stable

8/31/2026

0.9.0stable

8/28/2026

0.8.0stable

8/27/2026

0.7.1stable

8/25/2026

0.7.0stable

8/25/2026

0.6.2stable

8/25/2026

0.6.1stable

8/25/2026

0.6.0stable

8/24/2026

0.5.0stable

8/24/2026

README

dsh-instance-manager

中文 | English

从 DSH Web 中查看、启动和停止本机实例，也可连接受信任的远程实例。入口位于页面左下角的 Mini Utility Dock。

功能

列出实例的端口、PID、运行时长、会话数、内存和版本状态。
查看 stdout/stderr 日志、内存趋势和活跃会话概要。
启动新实例；优雅停止单个、当前或全部本地实例。启动时可留空端口由宿主在托管端口段内取第一个空闲端口，也可指定端口——指定的端口若已被占用会明确报错，不会改到别的端口启动。
在 DSH 0.1.2-rc.1+ 中，网页启动会打开一次性 token URL，让新实例安全换取浏览器 cookie；Agent 工具启动保持后台无窗口。
点击某行的 :端口 打开该实例的界面。新版 DSH 要求实例根 URL 携带每进程的启动 token，因此该链接指向一个重定向端点，由宿主读出该实例当前 token 后 303 跳转；token 不进入面板状态或链接本身。实例非本机 launcher 启动时读不到 token，此时明确返回 launch_token_unavailable，并提示改用 dsh web 打印的 URL，而不是跳到必然 401 的裸根地址。
通过受认证的 peer 链路查看远程实例、日志和会话。远程行的端口链接由该 peer 自身的面板完成同样的 token 换取。
提供 instance_list、instance_start、instance_stop、instance_logs 和 instance_sessions Agent 工具。

安装

# 从 npm 安装并注册到 web profile（推荐）
dsh plugin --profile web add dsh-instance-manager

# 仅安装 npm package
npm install dsh-instance-manager

# 或从 GitHub 安装
dsh plugin --profile web add github:xswt442-cmd/dsh-instance-manager

npm install 只安装 package；在 DSH 中启用仍需将 bundle 加入 profile。使用 dsh plugin add 可一次完成。重启 DSH Web 后生效。

配置

可在 DSH settings 中配置 Dock 位置、刷新间隔、Fleet token、peers 和启动端口段。对应的环境变量可作为默认值：

界面语言跟随 DSH Settings → General 的全局语言，不再维护插件自己的语言偏好。

$env:DSHIM_DOCK_PLACEMENT = 'main-bottom-left'
$env:DSHIM_REFRESH_INTERVAL_MS = '4000'
$env:DSHIM_PORT_RANGE = '3080-3129'
$env:DSHIM_FLEET_TOKEN = '<long-random-secret>'
$env:DSHIM_PEERS = 'office@http://192.168.1.20:3080'

Peer 配置是单向的；需要双向可见时，两端分别配置对方。远程行只读，不参与本地 stop-all。

安全

本地 API 拒绝跨站 Origin、非 loopback Host 和不安全的 Fetch Metadata。
写操作仅接受 POST；端口必须是 1–65535 的十进制整数。
是否需要 Fleet Bearer 由真实 TCP 对端地址（socket）判定，而非仅看 Host 头：对端非回环或 Host 非回环，二者满足其一即要求 bearer。伪造 Host: 127.0.0.1 无法隐藏非回环对端；对端地址缺失时直接拒绝。缺少或无法解析 token 时拒绝。
Fleet token 没有操作级权限划分。持有者可启动或停止本机实例并读取会话信息，应仅授予可信设备。
浏览器 API 与事件流在 DSH 0.1.2-rc.1+ 中复用 Connection 的签名 cookie；内部实例确认与转发只走严格 loopback 探测动作。
SSE 仅向本机开放。

开发

不要把工作树以符号链接挂入运行中的 DSH profile。使用快照部署：

powershell -File scripts\deploy-profile.ps1

提交前运行：

npm test
npm run docs:check
npm pack --dry-run

License

MIT

Versions

0.9.12stable

9/17/2026

0.9.10stable

9/17/2026

0.9.9stable

9/17/2026

Show 16 more versionsCollapse versions

0.9.8stable

9/16/2026

0.9.7stable

9/15/2026

0.9.6stable

9/14/2026

0.9.5stable

9/4/2026

0.9.4stable

9/2/2026

0.9.3stable

9/1/2026

0.9.2stable

8/31/2026

0.9.1stable

8/31/2026

0.9.0stable

8/28/2026

0.8.0stable

8/27/2026

0.7.1stable

8/25/2026

0.7.0stable

8/25/2026

0.6.2stable

8/25/2026

0.6.1stable

8/25/2026

0.6.0stable

8/24/2026

0.5.0stable

8/24/2026

README

dsh-instance-manager

中文 | English

从 DSH Web 中查看、启动和停止本机实例，也可连接受信任的远程实例。入口位于页面左下角的 Mini Utility Dock。

功能

列出实例的端口、PID、运行时长、会话数、内存和版本状态。
查看 stdout/stderr 日志、内存趋势和活跃会话概要。
启动新实例；优雅停止单个、当前或全部本地实例。启动时可留空端口由宿主在托管端口段内取第一个空闲端口，也可指定端口——指定的端口若已被占用会明确报错，不会改到别的端口启动。
在 DSH 0.1.2-rc.1+ 中，网页启动会打开一次性 token URL，让新实例安全换取浏览器 cookie；Agent 工具启动保持后台无窗口。
点击某行的 :端口 打开该实例的界面。新版 DSH 要求实例根 URL 携带每进程的启动 token，因此该链接指向一个重定向端点，由宿主读出该实例当前 token 后 303 跳转；token 不进入面板状态或链接本身。实例非本机 launcher 启动时读不到 token，此时明确返回 launch_token_unavailable，并提示改用 dsh web 打印的 URL，而不是跳到必然 401 的裸根地址。
通过受认证的 peer 链路查看远程实例、日志和会话。远程行的端口链接由该 peer 自身的面板完成同样的 token 换取。
提供 instance_list、instance_start、instance_stop、instance_logs 和 instance_sessions Agent 工具。

安装

# 从 npm 安装并注册到 web profile（推荐）
dsh plugin --profile web add dsh-instance-manager

# 仅安装 npm package
npm install dsh-instance-manager

# 或从 GitHub 安装
dsh plugin --profile web add github:xswt442-cmd/dsh-instance-manager

npm install 只安装 package；在 DSH 中启用仍需将 bundle 加入 profile。使用 dsh plugin add 可一次完成。重启 DSH Web 后生效。

配置

可在 DSH settings 中配置 Dock 位置、刷新间隔、Fleet token、peers 和启动端口段。对应的环境变量可作为默认值：

界面语言跟随 DSH Settings → General 的全局语言，不再维护插件自己的语言偏好。

$env:DSHIM_DOCK_PLACEMENT = 'main-bottom-left'
$env:DSHIM_REFRESH_INTERVAL_MS = '4000'
$env:DSHIM_PORT_RANGE = '3080-3129'
$env:DSHIM_FLEET_TOKEN = '<long-random-secret>'
$env:DSHIM_PEERS = 'office@http://192.168.1.20:3080'

Peer 配置是单向的；需要双向可见时，两端分别配置对方。远程行只读，不参与本地 stop-all。

安全

本地 API 拒绝跨站 Origin、非 loopback Host 和不安全的 Fetch Metadata。
写操作仅接受 POST；端口必须是 1–65535 的十进制整数。
是否需要 Fleet Bearer 由真实 TCP 对端地址（socket）判定，而非仅看 Host 头：对端非回环或 Host 非回环，二者满足其一即要求 bearer。伪造 Host: 127.0.0.1 无法隐藏非回环对端；对端地址缺失时直接拒绝。缺少或无法解析 token 时拒绝。
Fleet token 没有操作级权限划分。持有者可启动或停止本机实例并读取会话信息，应仅授予可信设备。
浏览器 API 与事件流在 DSH 0.1.2-rc.1+ 中复用 Connection 的签名 cookie；内部实例确认与转发只走严格 loopback 探测动作。
SSE 仅向本机开放。

开发

不要把工作树以符号链接挂入运行中的 DSH profile。使用快照部署：

powershell -File scripts\deploy-profile.ps1

提交前运行：

npm test
npm run docs:check
npm pack --dry-run

License

MIT

Instance Manager

Compatibility and provenance

Versions

Related plugins

Instance Manager

README

dsh-instance-manager

功能

安装

配置

安全

开发

License

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

dsh-instance-manager

功能

安装

配置

安全

开发

License