DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-terminal-hub

d

dsh-terminal-hub

Manifest valid

DeepSeek 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

UI (client)hasBundlePatch

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)在当前运行环境里实际注册的启动器候选,所以永远与系统一致,不存在需要维护的第二份清单。

数据来源

按顺序尝试,第一条成功就用:

  1. ctx.webTerminals.launchShells(sessionId, signal) —— 官方终端 UI 自己走的路径
  2. 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…