dsh-terminal-hub
Manifest validDeepSeek Harness Plugin: A sidebar panel that lists the terminals of all sessions, displays their status, allows jumping to the corresponding session, and read-only displays the launcher candidates registered by the terminal controller
dsh-terminal-hub
DeepSeek Harness 的终端总览插件:一个侧栏面板,列出所有会话的终端,显示状态,一键跳回它所属的会话;另带一个只读的启动器候选清单 Tab(主机 Tab)。
DSH 的终端是会话所有的——右侧栏每个会话一块,切到别的会话就看不到之前开的终端。这个插件把"所有终端"聚到一处,解决"我得先想起终端开在哪个会话"的问题。
功能
- 跨会话总览:一次列出所有会话的终端(含当前未打开的会话),按会话分组
- 点击跳转:点任意一行,直接切到该终端所属会话
- 双名显示:主标题是显示名(没有显示名就用真实标题,再没有就用
shell + 短 id),真实标题始终作为灰色副标题可见 - 状态点:绿=运行中、灰=已退出、红=已失败,附带来源(用户 / Agent 启动)
- 副标题:
真实标题 · shell名 · 启动目录,完整路径在悬停提示里 - 自动编号:同会话 + 同目录 + 同 shell 的终端自动带
#1 #2 - 显示名:双击标题原地改名,名字只在本面板生效,不改变 DSH 终端顶部的标题
- 关闭:二次确认后真正杀掉终端进程(只对当前会话的终端生效)
- 标签与配色:给终端加短标签并从 5 色板选色,只在面板内生效
- 搜索:一个搜索框同时过滤两个 Tab(显示名 / 真实标题 / 标签 / 目录 / 会话名 / 启动器名与路径)
- 两个 Tab:
终端 (N)/主机 (M),数字是当前搜索结果的数量 - 主机 Tab(只读、无配置):直接列出终端控制器实际注册的启动器候选(
name去掉.cmd+ 完整路径),不做过滤,不提供任何操作按钮 - 折叠已退出:已退出与失败的终端默认收起,可展开
- 元数据存在浏览器
localStorage,终端消失后自动清理过期条目
安装
从 npm:
dsh plugin --profile web add dsh-terminal-hub
从 GitHub(跟最新代码):
dsh plugin --profile web add github:<owner>/dsh-terminal-hub
本地开发:
git clone <repo-url> dsh-terminal-hub
dsh plugin --profile web add link:$PWD/dsh-terminal-hub
装完重启 dsh web(客户端插件在启动时加载进 window.__DSH_BOOT__)。之后修改 client.js 一般会被 dsh-client-hmr 热更新,最多按一次 F5。
工作原理
- 会话清单来自客户端
ctx.sessions.list(SnapshotStore) - 每个会话的终端来自 Host 的
remote.terminal.list(sessionId)——该方法接受任意会话 id(含离线会话),这是跨会话总览成立的前提 - 有终端的会话会额外订阅
ctx.webTerminals.watch(sessionId, listener),拿到实时 roster - 跳转走
ctx.uiWorkspace.openSession(sessionId) - 关闭直接调
remote.terminal.close(sessionId, id)。网关用调用方连接自身的 agent 校验 wire 上的agentId,因此只能操作当前会话的终端;跨会话会被边界校验拒绝,面板会给出可读提示 - 显示名只存在浏览器
localStorage,不写 Host,也不影响 DSH 的终端顶部标题 - 主机 Tab 的数据来自
ctx.webTerminals.launchShells(sessionId, signal)(官方终端 UI 的路径),失败时退回remote.terminal.shells(...)(内部还会试三种 wire 形状);它不读任何插件配置,也没有内置副本
主机 Tab(只读)
这个 Tab 只读、无配置:它显示的是终端控制器(terminal-controller)在当前运行环境里实际注册的启动器候选,所以永远与系统一致,不存在需要维护的第二份清单。
数据来源
按顺序尝试,第一条成功就用:
ctx.webTerminals.launchShells(sessionId, signal)—— 官方终端 UI 自己走的路径remote.terminal.shells(sessionId, signal)—— 底层 Remote 兜底
第 2 条内部仍会依次尝试三种 wire 形状({id} / 裸字符串 / {agentId}),并把成功的那一种记下来。
Tab 顶部会显示:
来源:终端候选清单
18 个候选启动器
shells() 形状:webTerminals.launchShells · 探测会话:<会话 id>
只读视图:这里不提供任何操作按钮。
会话 id 怎么选
shells() 的 agent 参数由网关查表(agentId lookup)并按调用方连接授权,因此插件按 ctx.sessions.list 快照逐个试(最多前 16 个),第一个成功返回的就用,并把它的 id 显示在来源行。
全部失败时:
- 顶部黄条:
读取启动器候选失败:<code>: <message>(最后一次失败的原始 code/message) - 列表区:
候选清单不可用,所以这里没有可列出的启动器。以及已尝试的会话数
不会把"读不到"显示成"没有启动器",也不会显示一个不作解释的空列表。
行内容
| 位置 | 内容 |
|---|---|
| 主标题 | 候选的 name,去掉 .cmd 后缀(如 web-01) |
| 副行(灰色) | 候选的完整 path(悬停也显示完整路径) |
| 排序 | 按主标题(即 name)升序 |
| 搜索 | 匹配 name 与 path(共用顶部搜索框) |
候选不做任何过滤:即使某个启动器不在 ~/.dsh/ssh-hosts 下,也照样列出——这个 Tab 的意义就是"看这台机器上有什么"。
已知限制
- 不是跨会话接管:面板负责"看见 + 导航",不能把别的会话的终端搬到当前会话里操作
- 启动目录不会跟随
cd:cwd是终端的启动目录,不是实时目录 - 显示名与颜色只在本面板可见:DSH 的终端顶部标题由终端 UI 自己持有,本插件不修改它
- 关闭跨会话不可用:网关边界校验只放行调用方自己会话的终端
- 主机 Tab 依赖网关授权:
shells()的 agent 参数按调用方连接校验;如果所有候选会话都被拒,Tab 只会给出错误 code/message,不会伪造列表 - 离线会话的终端:Host 只在进程生命周期内保留终端,DSH 重启后旧终端自然消失
- 一次最多扫描 400 个会话,超出会在面板里提示
兼容性
- 需要
dsh >= 0.2.0 - 依赖 DSH 内置客户端的
sessions/webTerminals/uiWorkspace/slots/locale服务与terminal-controller的 Remote 方法 - 这些是 DSH 内部 API,升级 DSH 后可能需要适配
开发
git clone <repo>
dsh plugin --profile web add link:$PWD
client.js 是手写的浏览器 bundle,格式为:
window.__ModuleLoader__.load({ id: '<包名>', factory(require) { ... return { inject, apply } } })
无构建步骤,node --check client.js 可做语法校验。
许可
MIT
Comments
Loading…