dsh-synced-tabs
Manifest validCross-device session tabs for the DeepSeek Harness (DSH) Web GUI: one shared set of open sessions across every device, with workspace grouping, status dots and a phone-first bottom bar.
dsh-synced-tabs
DeepSeek Harness(DSH)Web GUI 的会话标签栏:把「打开过的会话」变成一条显式的活跃集合,并且在同一宿主的多个设备之间共享。
English · MIT · 需要 DSH >= 0.2.0-rc.2(peer 下限;逐版本实测见 COMPATIBILITY.md)
它解决什么
- 会话太多:DSH 的会话从左侧栏打开,切走之后就没有「现在开着哪几个」的显式视图。这里给你一条标签栏。
- 多设备:在电脑上关掉的标签,手机上不该还在;手机上新开的会话,电脑上应当几秒内出现。标签是共享集合,不是本地视图。
- 手机:触屏没有悬停,标签栏挤在顶部一条里既看不清点不准。窄屏降到「当前会话 + 抽屉」,横条贴底。
- 状态:哪条会话在跑、哪条在等你回答、哪条完成未读——标签上有点,抽屉入口上还有聚合状态。
与「再写一个标签栏」不同的地方
- 跨设备共享是核心设计,不是附加项:宿主侧提供一个精确的
GET/POST /api/dsh-tabs/state路由, 状态落$DSH_HOME/dsh-tabs/state.json;客户端乐观更新 + 补发队列 + 3 秒轮询,断网退回本地模式并在恢复后自动补发。 - 手机是一等公民:窄屏横条贴底、左下手势区开抽屉、抽屉不盖横条、开软键盘把布局视口压下去(
interactive-widget=resizes-content)——每条都有真机读数支撑,见 COMPATIBILITY.md。 - 零侵入:只挂官方
shell.overlay槽位,只用自己的 data 属性、一个 CSS 变量和一条精确路由;不改宿主任意文件,卸载清理干净。单文件客户端、无构建、无运行时依赖(peer 只有 DSH 官方包与react)。 - 可验证:离线测试直接执行真实
client.js字节(不需要浏览器、不需要 DSH 实例),覆盖交互与降级;每个 DSH 版本的实测读数记录在兼容性表里。
安装
dsh plugin --profile web add dsh-synced-tabs
装完重启(或让宿主重载插件)即可在 Web GUI 顶部看到标签栏。卸载:
dsh plugin --profile web remove dsh-synced-tabs
卸载不会删共享集合:$DSH_HOME/dsh-tabs/state.json 留着,重新装上即原样恢复;想彻底清空就删掉它。
用法
| 操作 | 桌面 | 手机 |
|---|---|---|
| 切换会话 | 点标签 / 方向键(← → 在标签间移动,Alt+Shift+←/→ 调序) | 点标签;或点横条左下的 ≡ N 打开抽屉 |
| 关闭标签 | 标签上的 ×;或中键点标签;或聚焦后 Delete/Backspace | 抽屉行右侧的 × |
| 看状态 | 标签上的状态点(运行中 / 等待回答 / 完成未读),悬停有文字说明 | 抽屉每行第二行直接写状态 + workspace 名 |
| 辨认归属 | 标签左内侧的 workspace 色条 + 徽章,同组标签连缝 | 抽屉行左侧色条 + 第二行的 workspace 名 |
关标签不会删除、归档或停止会话——它只是从共享集合里移除。
跨设备同步:边界与降级
- 范围是同一个 DSH 宿主实例下的多个浏览器/设备(同一
$DSH_HOME)。不是跨实例同步。 - 客户端与宿主之间是「精确路由 + 轮询」而不是 WebSocket/事件流:标签变更是低频事件,3 秒轮询足够, 且能在宿主重启、网络闪断后自愈。
- 宿主端点不可用(旧宿主 / 未加载 Host 半边)时,客户端退回本设备本地模式,恢复后按队列补发。
- 冲突规则、
seq语义、状态文件格式见 docs/ARCHITECTURE.md §3。
兼容性
DSH 的客户端 API 仍在快速演进,每个版本都要重新验收。逐版本的实测结论(横条高度、抽屉矩形、真机读数、 测试通过数)见 COMPATIBILITY.md;没测过的版本写「未验证」,不做推测。
开发
npm test # 离线测试:在 node:vm 里执行真实 client.js,配最小 React 替身与假 DOM
仓库结构:
client.js 客户端半边(单文件,无构建)
index.js 宿主半边的入口
lib/host.js 宿主半边:状态文件 + /api/dsh-tabs/state 精确路由
lib/client.d.ts 宿主契约类型(依赖哪些 API、哪个版本提供)
cordis.patch.yml 只插入一行插件挂载
docs/ARCHITECTURE.md 架构、宿主契约与同步协议
docs/DEVELOPMENT.md 测试、发版与 DSH 升级检查单
COMPATIBILITY.md 逐 DSH 版本的实测表
test/ 离线测试(harness 执行真实源码)
内部标识为什么还带 dsh-tabs 前缀:这条插件早于改名就已部署,data-dsh-tabs / --dsh-tabs-h /
/api/dsh-tabs/state 与 $DSH_HOME/dsh-tabs/state.json 是已有实例的数据与挂载契约,改名会丢共享集合。
对外只有包名、插件 id、客户端注册 id 与文档使用 dsh-synced-tabs——客户端注册 id
(__ModuleLoader__.load({id}))必须等于包名,它是 boot graph 的行键(见 docs/ARCHITECTURE.md §7)。
范围(明确不做)
- 不新建会话(用宿主自带的入口)。
- 不 hook 会话生命周期;关标签不动会话。
- 不做拖拽排序 / pin / 归档 / 分屏——当前版本的取舍是「一条能跨设备对齐的标签栏」。
- 不做跨宿主实例(两台机器各跑一个 DSH)的同步。
许可
MIT,见 LICENSE。
Comments
Loading…
Similar plugins
by seekerwxy
Browser-style session tab bar for DeepSeek Harness (DSH): one tab per opened session at the very top of the web app — click to switch, close, and start new sessions. 浏览器式会话标签页导航栏.
★ 0
MIT
JavaScript
Aug 15, 2026
dsh plugin --profile web add dsh-session-tabsby 439436269-ctrl
DSH 插件:侧栏内联的「置顶」会话分组(原生度量 + 就地搜索)。A pinned-session group in the DeepSeek Harness sidebar.
★ 1
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add @vfvrpq/dsh-pinned-sessionsby thezavtrak-a11y
DeepSeek Harness Web UI plugin: browser-style tabs for open Sessions - switch, close, reorder by drag, and tear a tab off into a separate window.
★ 0
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add dsh-session-tabsby OuQiL
A dedicated Pinned area for DeepSeek Harness: a pinned group atop the sidebar session list plus a full Pinned page, opening every conversation in its original workspace.
★ 15
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-pinned-panelby kyrsieger
Adds cross-workspace pinned and recent session sections to the DSH sidebar, with status indicators and display settings.
★ 1
MIT
JavaScript
Nov 7, 2026
dsh plugin --profile web add dsh-up-sessionby huangxp12
Recent sessions across every workspace in one panel for DeepSeek Harness (DSH) - plus deferred notes that come back when you reopen the conversation.
★ 2
MIT
JavaScript
Oct 10, 2026
dsh plugin --profile web add dsh-recent-sessions