多会话分屏 · DSH session panes
一个 DeepSeek Harness Web UI 插件：在右侧边栏并排打开多个会话。点击会话行上的按钮，或把会话拖到窗口右侧，该会话就会作为独立窗格出现在右侧，主栏当前会话不受影响。
示意：主栏继续当前会话，另一个会话在右侧窗格中同步显示；截图里会话行悬停按钮的提示是「在右侧打开（可拖到右侧）」。
- 仓库：
- 许可证：MIT
> 本仓库根目录就是插件包本身（package.json 在根上），不是 monorepo，也没有子包。安装时 target 直接指向仓库根目录。
功能特性
- 两种打开方式：会话行悬停按钮一点即开；也可以按住按钮拖到窗口右侧（右侧 45% 为投放区）后松手。
- 原生拖拽兼容：会话行本身用于排序的原生拖拽仍然可用，插件只拦截"开始于自身按钮"的按压，且只处理从左栏发往右侧的拖拽，右侧窗格内的拖拽不受影响。
- 多窗格并存：每个会话对应一个独立的右侧标签页（
preferNewPane），可以同时查看多个会话的实时输出。 - 拖拽反馈：拖动时显示跟随指针的标题浮层，右侧投放区高亮并提示"拖到此处"。
- 中文 / English 双语：界面与插件元数据均提供简体中文与英文文案，跟随 Harness 语言设置。
- 明暗主题自适应：样式全部使用
--dsw-alias-*主题变量，不写死颜色。 - 无构建步骤：纯 ESM + 运行时
React.createElement，安装即生效；没有依赖、没有安装脚本。
环境要求
- 已安装 DeepSeek Harness，并使用 Web UI（桌面端或
dsh web均可）。 - Harness 版本需提供右侧边栏相关服务与插槽（见「兼容性」）。已在
0.1.5-rc.1上验证。 - 安装插件不需要 Node.js 或任何构建工具，这些由 Harness 自身完成。
安装
一句话安装（推荐）
在 DSH 任意会话里对 agent 说：
下载并安装成插件，下载地址为：git clone https://github.com/Bob-Cheung/dsh-plugin-session-panes.git
agent 会自己克隆仓库，再把克隆目录安装为插件。返回 application: applied 后刷新一次页面即可（需要本机有 Git）。
手动安装
- 克隆仓库（没有 Git，就在仓库页 Code → Download ZIP 解压）：
git clone https://github.com/Bob-Cheung/dsh-plugin-session-panes.git
- 让 agent 安装这个目录，或者直接调用插件管理器（
target是含package.json的绝对路径，即仓库根）：
plugin_manager(action: "install_bundle", target: "D:\\tools\\dsh-plugin-session-panes")
首次安装可能弹出权限确认，允许即可。ZIP 解压后通常多一层同名目录，target 要指向真正含 package.json 的那一层。
安装成功后，在「插件管理 / Plugins」里能看到 Session panes / 多会话分屏，带图标与中英文描述。
使用
- 在左侧会话列表中找到目标会话。
- 悬停该行，点击右侧出现的「在右侧打开」按钮；或者按住该按钮拖到窗口右侧高亮区域后松手。
- 会话会以新标签的形式出现在右侧边栏，可继续输入、查看流式输出。
- 关闭标签页即释放该窗格（插件会释放对会话的 retain）。
> 若右侧边栏尚未挂载，插件会先在主栏打开该会话以激活侧栏，随后自动在右侧打开对应窗格。
更新
安装是链接到 checkout，不是拷贝，所以只需：
git pull
然后重启 Harness（替换已安装的 JavaScript 模块需要重启才能加载新版本，只刷新页面不一定够）。
卸载
plugin_manager(action: "remove_bundle", target: "@bob-cheung/dsh-session-panes")
卸载后刷新页面。
工作原理
| 组成 | 说明 |
|---|---|
| 资源协议 | 注册 sessionchat 协议，地址形如 dsh-resource://sessionchat/session/?title=<标题>，打开时 ctx.sessions.retain() 持有会话，标签页关闭即 release()。 |
| 侧栏标签类型 | 通过 sidebarRightTabs.register() 注册 sessionchat 类型，priority: 'extension'，标题优先取地址中的 title。 |
| 标签页内容 | 在 sidebar.right.pane.tab 插槽中注册 SessionChatTab，用 SessionProvider 包裹共享的 Conversation 插槽，复用主界面聊天视图（view: 'chat'）。 |
| 行操作按钮 | 在 sidebar.workspaces.session.row.action 插槽注册 SessionRowAction，负责点击打开与指针拖拽。 |
| 拖拽浮层 | 在 shell.overlay 注册 DropOverlay，绘制固定定位的投放区与跟随指针的幽灵标签。 |
| 样式 | 运行时注入 ``，卸载时移除。 |
依赖的客户端服务（inject）：sessions、uiWorkspace、slots、locale、sidebarRight；插槽注入后额外使用 resources、sidebarRightTabs。
Host 半（index.js）只导出一个空的 apply()，不注册任何行为。
目录结构
dsh-plugin-session-panes/
├── package.json # 包清单：exports 与 dsh.bundle / dsh.client 声明
├── cordis.patch.yml # Loader patch：插入 session-panes 行
├── index.js # Host 半：空实现
├── client.js # Client 半：协议、标签页、行按钮、拖拽浮层、样式
├── icon.svg # 插件图标
├── demo.png # 演示截图（README 配图，不参与运行时）
├── LICENSE # MIT
├── README.md # 本文件
├── .gitignore
└── locale/
├── zh.json # 插件标题与描述（中文）
└── en.json # 插件标题与描述（英文）
配置与可调参数
插件没有面向用户的配置项，安装后即按默认行为工作。需要微调时改 client.js 顶部的常量：
| 常量 | 默认值 | 作用 |
|---|---|---|
DROP_RATIO |
0.55 |
投放区从视口宽度的 55% 处开始，即右侧 45% |
| 拖拽阈值 | 6（px） |
指针移动超过该距离才判定为拖拽，避免误触 |
KIND / RESOURCE_PROTOCOL |
sessionchat |
资源协议与标签类型标识，改动需同步 cordis.patch.yml 之外的所有引用 |
兼容性
- 需要 Harness Web UI 提供右侧边栏（
sidebarRight）与sidebar.right.pane.tab、sidebar.workspaces.session.row.action、shell.overlay插槽。 - 仅作用于 Web 客户端；Host 侧无行为，不影响终端或 API 调用。
- 已在 DeepSeek Harness
0.1.5-rc.1（desktop profile）上验证安装与使用。 - 会话 ID 按
session-形式识别；若会话行未暴露data-session-id等属性，会退化到从拖拽数据中解析 UUID。
开发与校验
- 无构建：纯 ESM，改完文件重装或重启 Harness 即可看到效果。
- 语法检查：
node --check client.js
node --check index.js
- 清单校验：
package.json、locale/*.json是 JSON，cordis.patch.yml是 YAML；改完立即检查。
常见问题
会话行没有出现「在右侧打开」按钮？
确认插件已安装且已启用（application: applied），然后刷新页面；仍不行则重启 Harness。若近期移动过插件目录或重装过插件，Host 可能仍持有旧的绝对路径，必须重启。
拖到右侧没有反应？
投放区只在视口右侧 45% 内生效，且需要从会话行按钮上开始拖拽；松手位置要落在高亮区域内。
右侧打开了空白窗格？
说明该会话的资源创建失败，通常伴随控制台错误；关闭标签页后重试，并确认 Harness 版本提供 sidebarRight 服务。
License
MIT © 2026 Bob Cheung
English
@bob-cheung/dsh-session-panes — open multiple sessions side by side in the DeepSeek Harness Web UI right sidebar. Hover a session row and click Open in the right sidebar, or drag the row's button onto the right 45% of the viewport; the session opens as its own pane while the main column keeps its current session.
- This repository root is the plugin package (no monorepo, no subpackages); install
targetpoints at the clone root. - Registers a
sessionchatresource protocol (dsh-resource://sessionchat/session/) that retains the session for the tab's lifetime, asidebarRightTabstab type, and the shared chat Conversation slot. - Local installs are links:
git pulland restart Harness to update. - Localized in Simplified Chinese and English; styles use
--dsw-alias-*theme tokens; no dependencies and no build step.
Install from a checkout:
plugin_manager(action: "install_bundle", target: "")
Uninstall with plugin_manager(action: "remove_bundle", target: "@bob-cheung/dsh-session-panes"). Licensed MIT.
