DSH Web UI 的多会话平铺工作区:1–4 个格子,拖分隔条同时改变相邻格子的大小;浏览器式标签页可并存多套布局;拖标题栏交换会话;每格独立选会话;格内新建会话时先选工作区,全程不跳出面板。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:vegetable86/dsh-multi-session
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
在 DeepSeek Harness 里把多个会话并排看:一个独立的「多会话」主面板,格子数量不设上限,每格绑定一个已有会话,每格都是完整的原生对话(消息流 + 输入框)。所有格子不重叠地平铺,拖动分隔条就能像 tmux 那样调整相邻格子的长宽。
npm 包:@vegataa/dsh-multi-session
用法
左侧边栏点「多会话」图标进入面板。 1.1 面板最上方是类似浏览器的标签栏:每个标签都是一整套独立的多会话布局(自己的格子、分隔条权重、最大化 / 最小化状态)。点标签切换,
+新建一个标签(默认填入最近两个会话),×关闭标签(至少保留一个),双击标签可以改名,按住标签拖动可以调整它们的前后顺序;标签标题默认跟着它的第一个会话走,会话正在跑时标签上有个小绿点。首次打开自动填入最近两个会话;每格标题栏点会话名可以换一个会话(支持搜索)。
标签栏右侧的「+ 添加会话格」想加多少加多少。格子不重叠地平铺:两格并排,三格是上面一整格、下面两格,四格是 2×2,更多格子按两列往下排。拖行与行之间的横分隔条,上下两行一起变高变矮;拖同一行里两格之间的竖分隔条,一边变宽另一边就变窄,和 tmux 的分屏手感一样。任何时候格子都会铺满面板、不会互相遮挡。单格可最大化 / 还原,也可关闭(至少保留一格)。标签栏右侧的「均分」把所有分隔条恢复成平均分配。 3.1 每格标题栏的「最小化」把它收成面板上方的一条标题(带运行状态点);收起的格子不占网格空间,剩下的格子自动铺满,点标题即可展开回原来的位置。所有格子都可以收起。 3.2 每格标题栏的「在主面板打开」(箭头图标)把该格的会话交给普通对话页显示,多会话面板随之退到侧边栏;适合临时想仔细看某一段对话时用。标题栏还可以按住拖到另一个格子上:松手后两格交换各自显示的会话,格子的位置和大小不变。
空格的「新建会话」按钮、以及每格选择器底部的「新建会话」,会先弹出一个工作区选择框:选好工作区后再在这一格里创建会话,整个过程都留在多会话页面,不会跳到新会话。没有工作区时才退回 Host 的默认目录。
标签栏右侧的「沉浸全屏」(四个角的图标)把整个面板铺满窗口,盖住左右两栏,能多出侧栏那一整条宽度;再点一次或按
Esc退出,布局原样保留。标签栏右侧的密度按钮在「紧凑 / 舒适」之间切换:紧凑是默认值,同样的窗口能多显示几行对话;舒适会把间距、按钮、标签和分隔条整体放大一档。选择随布局一起记住。
第一次打开面板时,标签栏下方有一条操作提示(拖分隔条调大小、拖标题栏交换会话、标题栏箭头在主面板打开),点「知道了」收起;标签栏右侧的
?随时能再叫出来。图标按钮悬停会立即显示名称,标题栏左侧的六点手柄表示这一格可以拖动。布局、每格绑定的会话、最大化 / 最小化 / 全屏 / 密度状态都会自动记住,刷新或重启后恢复;会话不存在时那一格显示「不可用」,可以重新选择。
选择器默认不列子代理会话,也不列空白会话(当前格自己绑定的空白会话除外)。
界面更安静:标签和所有操作并在标签栏一行里,格子标题栏的按钮只在悬停或该格为活动格时出现;增删格子、最大化、最小化、切标签、弹出对话框都带 140–320ms 的过渡。系统开启「减少动态效果」时,这些动画会自动关掉。
后台标签只保留布局轮廓,不再保留活的对话:切回来会重新连接会话(滚动位置不保留)。这是为了保证同一个会话在任一时刻只有一个输入框在跑——两个输入框同时挂在一个会话上会互相抢草稿,导致按回车发不出去。
同一个会话被放进两个格子时,第二个格子会提示「已在另一格显示」,不会出现两套输入框。
标签栏右侧的小字 X.Y.Z 是当前加载的构建版本,反馈问题时报这个版本号最省事。
格子里的对话也换上了 Claude 风格的暖色主题:面板在自己的根节点上重设 DSH 的主题变量(
--dsw-alias-*与--dsw-font-markdown-*),对话区、代码块、滚动条、边框会跟着一起变,正文改用偏暖的衬线字体;这套配色只作用于多会话面板,其他页面不受影响。标签栏右侧的调色板按钮可以换风格:跟随平台(默认)、Claude 浅色、Claude 深色、ChatGPT、Terminal 绿、Terminal 琥珀。选择会存进布局,刷新后保留,所有标签共用一套皮肤。
实现要点
- 只注册一个
main面板(keymultisession)和一个sidebar.panellist图标,普通对话页完全不受影响。 - 每格通过
<SessionProvider session={reference}>显式绑定会话,引用由sessions.retain(...)获取、卸载时release()。 - 格子内部用官方
conversation.content工厂槽(variant: 'embedded')渲染,得到的是原生对话组件,不是自绘的聊天界面。 - 每格包两层错误边界:格子内的渲染异常会在 0.6s / 1.2s 后自动重建两次,仍失败才显示错误卡片(可手动「重试」);整个面板崩了还有一层兜底,可以一键清掉布局重置。
conversation.content是 Harness 的内部工厂槽,签名变了会抛错:每格对这次调用做了捕获,失败时只显示「此视图暂不可用」+ 重试,不会把整个面板打空。- 「新建会话」自己问工作区,然后直接
sessions.create({ workspaceId });不走uiWorkspace.openWorkspace——后者在 hero 工作区选择器里会layout.selectPanel(null),把主面板切回单个会话,这正是新建后跳走的原因。 - 格子的外壳用
React.memo包起来:拖动分隔条时只有父级容器重算样式,各格的对话组件不会跟着重渲染。 - 最大化改为 CSS 覆盖层(其余格子
visibility: hidden但保持挂载),切换最大化不会重挂载对话,滚动位置和正在流式的回复都保留。 - 沉浸全屏不是新窗口,也不是新面板:根节点切到
position: fixed; inset: 0,一层z-index盖住三栏框架,面板里的会话组件完全不用重挂载;Esc先退最大化、再退全屏。顶部留出 Windows 标题栏的高度,避免盖住窗口拖动区。 - 「在主面板打开」调用平台的
uiWorkspace.openSession(sessionId);它会把该会话交给当前主面板并切换到单个对话,属于宿主既有的导航入口,插件不自己造一套。 - 风格是一张注册表(
THEMES):每套皮肤只声明一份 CSS 变量映射(面板自己的--ms-*加上对话区读取的--dsw-alias-*与字体 token),切换时把变量写在面板根节点上。因为变量沿子树继承,原生对话会跟着换色,但不会影响面板之外的页面;「跟随平台」这套故意什么也不覆盖。 - 交换会话走 HTML5 拖放,MIME 用自定义的
text/x-multisession-pane,只在面板内部认;拖拽过程中不改 DOM 结构,松手时只交换两个格子的sessionId,所以对话视图和滚动位置都还在原来的格子实例里。 - 格子按「行 → 列」两级权重存储:每行的
rowWeights决定高度,每行内两格的colWeights决定宽度;拖动分隔条只改这两级权重,所以相邻格子永远互补、整块面板始终铺满。最小化是每个格子的minimized标志:收起后该格不再参与网格计算(行里只剩一格就独占整行),但它在rows里的位置保留着,展开即回原位。 - 标签栏是「多套布局」而不是「多套面板」:v8 的存储是一份
{ tabs, activeTabId, immersive, density, theme },每个 tab 里放的正是原来那套panes / rows / rowWeights / colWeights / maximizedId。切标签只是换activeTabId,面板本身不重建;旧版本(v1–v7)的布局会原样升级,不会丢。 - 最近访问的 3 个标签会保持挂载(
MAX_MOUNTED_TABS):切回来时滚动位置、输入框草稿和正在流式输出的内容都还在;超出的标签整块卸载,但会话本身在后台继续跑。 - 密度不是两套样式表:
METRICS里放紧凑 / 舒适两档的尺寸,组件通过DensityContext取当前这档,拖动计算(beginSplitDrag的可用像素、最小格宽高)也跟着同一份数字走,避免尺寸和命中区各算各的。 - 分隔条只在视觉上是 6px / 10px 的细线:外层是命中区,内层
span才是那条线,悬停只改内层颜色和透明度,不改布局,所以拖起来不会抖。 - 动画只用 Web Animations API(animateIn 统一曲线)和 CSS 过渡,不注入额外样式表;每次调用都先看 prefers-reduced-motion。
- 主题不是改平台:多会话面板在根节点注入一组
--dsw-alias-*变量(themeVars),ui-conversation / ui-chat 的 28 个样式模块都用这些 token,变量沿子树继承,所以格子里的原生对话会被一起重新着色;插件自己的标签栏、卡片、强调条则用--ms-*变量,两者共用同一份THEME色板。 - 标签拖动排序走 HTML5 拖放(自定义类型
text/x-multisession-tab),松手时只重排board.tabs数组,activeTabId不变、布局不重建;拖到标签条空白处则移到最末。落点只按左右半区判断插到目标前还是后,不额外算几何。
开发
纯手写客户端 bundle,无需构建步骤。client.js 直接就是 window.__ModuleLoader__.load(...) 包。
npm test # 注册形态冒烟 + jsdom 渲染冒烟
目录
index.js # Host 侧空实现(本插件纯客户端)
client.js # 客户端 bundle:面板、格子、选择器、持久化、i18n
cordis.patch.yml
locale/*.json # 面板名称与描述
icon.svg
scripts/ # 冒烟测试、发布打包、市场索引生成
market/ # 插件市场索引与目录提交模板
docs/superpowers/{specs,plans}/
LICENSE
许可证
MIT,见 LICENSE。
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。