[!WARNING] Alpha（0.1.0-alpha.1）：核心链路已实机验证（网关路由 / 官方 UI 桥接 / 实时帧注入 / 审批应答 / 跨机对话）， 但仅在单一环境（Windows 本机 + 腾讯云 Linux，SSH 隧道）验证过，配置格式与安全边界仍可能变化。

这是什么

你有好几台跑着 dsh web 的机器 —— 家里的、公司的、云上的。想看某台上的会话，就得开一个新标签页、连一次隧道、再从头找。

这个插件让它们出现在同一棵树里：

工作区
├── my-project        ← 本机工作区（官方原样）
├── another-repo      ← 本机工作区
├── tencent           ← 远端服务器，点开就是那台机器的会话
│   ├── 部署脚本调试
│   └── 日志分析
└── codex             ← 导入的 Codex CLI 历史对话
    └── 重构方案讨论

点开任意一个会话 —— 包括远端的 —— 官方对话区照常渲染：历史、逐 token 流式输出、审批卡片、提问问卷，全是官方组件。插件只搬数据，不画界面。

核心能力

• 🌲 远端会话进官方树 每台服务器成为工作区树里的一个分组。树内操作全是原生语义：+ 新建会话 在那台机器上创建、归档/删除 路由到会话所在机器、重命名分组 = 重命名服务器、删除分组 = 断开该连接。

• 💬 官方对话区零替换 远端会话的历史、实时流、审批与提问卡片全部由官方组件渲染。没有自绘聊天窗，没有 shadow slot。

• 📥 导入其他工具的会话 把本机 Codex CLI / Claude Code / opencode 的历史对话读进树里，按项目目录自动归入对应工作区。按软件逐个手动开启，未点「导入」的软件日志不会被读取。导入的会话只读；直接向它发消息会自动转成真实 DSH 会话。

• 🔑 模型配置增量同步 服务器连上后，把本机有而远端缺的模型提供方、默认模型与 API Key 补过去。只补缺、不覆盖远端已有配置。

• 🔌 纯 /api 协议实现 不依赖 SSH 执行命令、不做屏幕抓取、不改远端任何配置、不在远端装任何插件。远端就是一个未经修改的 dsh web。

适合谁：有多台 DSH 机器想统一管理的人；不想为此再开一个桌面壳或手机端的人；本机堆了一堆 Codex/Claude Code 历史对话想翻出来接着聊的人。

不适合谁：只有一台机器且不用外部工具的人 —— 这插件对你没有价值。

安装

dsh plugin --profile web add dsh-session-hub@alpha

装完重启 dsh web（kill -TERM <pid> 并等待退出，别用 kill -9 —— 会在写入中途撕裂会话 zstd 日志），刷新页面。 设置 → 插件 里出现 会话枢纽 标签页即成功。

dsh plugin 把参数原样转发给 profile 目录里的 pnpm（本机需要 pnpm）。当前只有 alpha 版，@alpha 与不带标签装到的是同一个版本。

dsh plugin --profile web add https://github.com/Asaiuta/dsh-session-hub/archive/refs/tags/v0.1.0-alpha.1.tar.gz

git clone https://github.com/Asaiuta/dsh-session-hub && cd dsh-session-hub
npm install && npm run build
dsh plugin --profile web add file:$(pwd)

dsh plugin --profile web add dsh-session-hub@alpha

环境要求

最后验证 2026-08-14：本机 Windows + Node v24.9.0 ↔ 远端 OpenCloudOS 9.4 + Node v24.9.0， 经 SSH 隧道跑通跨机对话、审批应答与实时流全链路。

Alpha 期间：配置格式、路由表、/hub/events 帧协议在 1.0 前可能破坏性变更。

快速开始

最小可复现示例：一台远端 + 本机 hub + SSH 隧道。

① 远端（假设 10.0.0.5）—— 什么都不用装，保持默认即可：

dsh web --port 3080          # 默认只监听环回，配合隧道最安全

② 本机 —— 装插件、建隧道：

dsh plugin --profile web add https://github.com/Asaiuta/dsh-session-hub/archive/refs/tags/v0.1.0-alpha.1.tar.gz
# 重启 dsh web，然后：
ssh -N -L 127.0.0.1:3333:127.0.0.1:3080 user@10.0.0.5

③ 浏览器 http://127.0.0.1:3080：

1. 设置 → 插件 → 会话枢纽 → 添加服务器，填名称 tencent、地址 http://127.0.0.1:3333，点测试（返回远端 DSH 版本即通）→ 添加；
2. 官方工作区树里出现名为 tencent 的分组，远端会话就在组内；
3. 点开任一会话 —— 官方对话区照常工作：历史、实时流、审批卡片、发送 / 取消 / 重命名。

不用隧道也行：远端 dsh web --host 0.0.0.0（CLI 会自动把本机 LAN IP 加进白名单），本地填 http://10.0.0.5:3080。 但不要把 3080 暴露到公网 —— DSH 的信任围栏是防 DNS 重绑定的，不是认证。

导入本机其他工具的会话（可选）

设置 → 插件 → 会话枢纽 → 外部会话，按软件点「导入」：

• 未点「导入」的软件，日志一个字节都不会被读；
• 勾选自动：每 60 秒增量跟进该软件新产生的会话；不勾选就只在你点刷新时更新；
• 移除：把该软件的会话撤出树，不影响其他软件，也不动原始日志；
• 导入的会话在树里只读；直接向它发消息会自动转成真实 DSH 会话（保留用户/助手对话，原只读副本隐藏）。

配置

在 profile 的 cordis.yml / cordis.patch.yml 中配置：

- id: dsh-session-hub
  config:
    dataFile: /srv/dsh-hub-servers.json
    trustedHosts: ['192.168.1.10:3080']

唯一相关的环境变量是 DSH_HOME（影响注册表默认路径，默认 ~/.dsh）—— 插件不需要任何 API key 或令牌环境变量。 运行期 /hub/events 用的随机 token 每进程生成一次，只经快照下发给浏览器，不落盘。

它访问什么

一句话：读你本机的会话日志（需你逐个授权）、和你配置的服务器通信、不碰你的项目文件。

常见问题

日志位置：dsh web 进程 stdout/stderr——systemd 部署 journalctl -u dsh-web，nohup 部署看输出文件；本地终端部署看控制台。

回滚：dsh plugin --profile web add dsh-session-hub@<上一版本> 并重启即可。注册表文件向后兼容（未知字段忽略），降级不会丢配置。

开发

git clone https://github.com/Asaiuta/dsh-session-hub && cd dsh-session-hub
npm install          # devDeps：esbuild / typescript / zod / react
npm run typecheck    # tsc -p tsconfig.json --noEmit
npm run build        # esbuild → lib/index.js + lib/client.js + lib/types/

• 类型检查走仓库自带 stubs/（按 harness 源码抄写的最小声明面，经 tsconfig paths 映射）；对真实 DSH checkout 构建可删 paths/stubs、把 @deepseek-ai/* 引回 link: devDeps（参考 dsh-interconnect）。
• @deepseek-ai/dsh-* 未发布到 npm，运行时由 profile 提供（peerDeps 因此全部 optional）。
• 测试：当前无自动化套件；冒烟路径（网关合并去重、SSE 三重鉴权、跨机实时对话、审批应答、self-loop 拒绝）为实机手动验证。欢迎贡献测试与 PR。

许可证与安全

• License：MIT。
• 安全边界见上方「它访问什么」；设计不变量——不中继特权域、审批一律人工应答（插件不做自动放行）、自环/未授权源一律拒绝。
• 私密报告：请通过 GitHub Issues 提交（标注 [security]），或直接联系维护者 @Asaiuta；修复前不会公开细节。

架构

┌──────────────────────── 本地 DSH 进程 ────────────────────────┐
│  host 插件 (src/index.ts → hub/)                              │
│                                                               │
│  ServerRegistry ──持久化── $DSH_HOME/plugins/dsh-session-hub.json│
│   │ 每个 ServerLink ── RemoteApiClient(AbstractApiClient)     │
│   │  · HTTP unary → 远端 /api/session.*                        │
│   │  · WS mux/host 双流 + 指数退避重连                         │
│   │  · 会话列表缓存 / pending 交互表 (rpcId→服务器索引)         │
│   ├── HubGateway（exact 路由优先于官方 /api prefix）           │
│   │    接管 session.list/history/prompt/cancel/rename/fork/    │
│   │    models/selectModel/updateQueue/attachment/search/respond│
│   │    按会话归属路由：远端 → ServerLink，本地 → 官方 ApiProxy  │
│   │    session.list 合并去重（官方 items + 远端 rows）          │
│   └── SessionHubRuntime (TypertRemoteService @Remote)          │
│        暴露 wire 命名空间 sessionHub（服务器管理/远端建会话）   │
│  SSE /hub/events（随机 token + 环回 + same-origin 三重围栏）    │
└──────────────┬────────────────────────────────────────────────┘
               │ 官方 /api unary（浏览器→网关→路由）
               │ SSE 远端 mux 帧（原样转发）
┌──────────────▼────────────────────────────────────────────────┐
│  browser：官方 UI（零替换 / 零 shadow）                         │
│  · 官方工作区树：/api/session.list 由网关合并 → 远端会话直接     │
│    出现在官方树；点击打开                                      │
│  · 官方对话区：远端会话 open() 走 /api/session.history 网关路由，│
│    实时 mux 帧由 client 桥 (startOfficialBridge) 注入官方       │
│    sessions.handleMuxEnvelope → 官方逐 token 流式渲染/审批卡   │
│  · 设置 → 插件 → Session Hub：服务器增删/状态/探活、远端新建    │
└────────────────────────────────────────────────────────────────┘

实时通道：每条远端链路的 mux/host WS 帧经 HubEventBus fan-out 到本地 SSE /hub/events；浏览器按 event.seq 与历史基线去重（打开会话先拉尾部历史，live 事件缓冲后按 seq > tailSeq 应用），assistant/chunk 增量折叠逐 token 气泡，审批/提问帧到达即上卡；SSE 断线自动重连。