Skip to content

dsh-multiview

Verified

dsh-multiview · v0.1.99 · MIT · Web UI

2-4 real Chats you rearrange entirely from the keyboard, save as named layouts, and jump through by which pane needs you.

Install

dsh plugin add dsh-multiview

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-multiview — 多会话分屏

2–4 个真实对话:全键盘排布、存成命名布局、按「哪一格需要你」跳转。

一个窗口并排打开 2–4 个真实对话。每一格就是原生 Chat:composer、流式输出、工具卡、审批卡、ask_user_question、附件、斜杠命令、停止/排队,全部照旧。

目标不是"能跑的分屏",而是看起来像 DSH 自带的功能:不覆盖标题栏、不抢布局、不 monkey-patch 任何非公开扩展点。

English | 中文

四个对话并排

安装

已发布到 npm:dsh plugin add dsh-multiview,或在 DSH Desktop 的 插件 → 添加 里搜索安装(维护者也可用 plugin_manager install_bundle),然后完全退出并重新打开 DeepSeek Harness,让客户端 bundle 重新加载。

装好后左侧面板列表多一个「分屏」图标;点它把中央列切换为分屏舞台,再点一次回到原生会话。

  • 要求:DSH >=0.2.1-rc.5 <0.2.2-0 || >=0.2.2-rc.1 <0.2.3-0 || >=0.2.3-rc.1 <0.3.0-0(engines.dsh)。每一条预发布线都显式列出——node-semver 不会让预发布版本匹配一个未点名该版本的区间。
  • 卸载:插件页停用/移除 → 重启即可。会留下两个 localStorage 键:dsh.multiview.v1(保存的布局与分屏) 与 dsh.multiview.update.v1(上次更新检查结果,避免每次重新加载都再查一遍)。面板里的「还原」只清布局键; 想要完全干净,把两个都删掉。

用法

动作 操作
打开/收起 左侧面板列表「分屏」图标
切换 2 / 3 / 4 格 舞台顶栏的 2 3 4
调整比例 拖动格与格之间的分割线
交换两格 拖动一格的标题到另一格上,或 Mod+Alt+S 与下一格交换
最大化 / 还原 双击格头不生效,用格头右侧的 ⤢ 图标;舞台顶栏出现「还原」
给空格选会话 空格里直接搜索并点选——可按标题,也可按对话里说过的内容:输入两个字起,该格会向宿主检索消息内容,命中列表附带片段
把任意会话放进分屏 侧栏会话行悬停时出现的分屏按钮,或该行的 … 菜单 →「在分屏中打开」。不用离开分屏:有空格就填空格,未满 4 格就新增一格,四格已满才替换当前聚焦格
不打开分屏也能知道 只要有一格在等你回答或完成未读,侧栏「分屏」图标就带一个圆点——不用盯着分屏也知道有事
跳到需要你处理的格 格头的状态点本身就是按钮(等待回答 / 完成未读时出现);Mod+Alt+J 跳到下一个这样的格;如果没有任何格需要你,就跳到下一格(这个键不会什么都不做)
换掉某一格的对话 格头的 ⇄ 图标:在该格原地重开选择器并替换对话。两格分屏里删格是不可能的,这是唯一能换对话的路径
在原生视图打开 格头右侧 ↗ 图标:把该会话交回原生对话(右栏文件预览/改动评审要在原生视图里才可用)
移除一格 格头右侧 ✕;已绑定的一格会回到会话列表(分屏形状不变),空格再点 ✕ 才真正移除
视图 顶栏「视图」:绑定 2 格以上会自动记住,点击恢复;✎ 重命名(手写的名字在之后改布局时不会被自动名覆盖);✕ 删除。停在某套已保存的布局上继续移动、交换、增减格,改动会落在这一条上,而不是堆出一堆近似重复项
检查更新 顶栏右侧刷新图标:每 24h 自动检查,有更新带红点,确认后自动更新

快捷键(模块默认值,可在 设置 → 快捷键 改):

命令 默认键(桌面端)
聚焦上一格 / 下一格 Mod+Alt+[ / Mod+Alt+]
跳到下一个需要你处理的格 Mod+Alt+J
与下一格交换位置 Mod+Alt+S
最大化或还原当前格 Mod+Alt+M
从分屏移除当前格 Mod+Alt+W

分割线本身是可聚焦的分隔条:←/→(上下分屏用 ↑/↓)每次移动 2 %,按住 Shift 为 5 %,Home / Enter / Space 恢复均分。

浏览器(Web)端默认不绑定这些键:DSH 的快捷键层对 Web/Linux 允许的组合极窄,硬绑会在启动时报"reserved"。桌面端默认值可用,Web 端请按需自绑。

几个边界行为

  • 两格是下限。 两格分屏里的空格不能删除(✕ 不显示)——预置形状、2 3 4 按钮与保存布局的键都假定至少两格。
  • 归档即离屏。 在任意位置归档一个对话,它所在的格会立刻清空,格的位置不变。
  • 缩格保住你正在看的。 从四格缩到两格会丢掉两个对话,但被聚焦的那一个一定留下,并占据第一格。
  • 最大化要有对话。 空窗格不提供 ⤢:把选择器放大到全屏会把其他对话全藏起来。
  • 旧布局会自愈。 应用一套会话已被删除或归档的保存布局时,形状照旧恢复、只清空那些格;保存条目不会被静默删除,而是改写为实际能恢复的样子。

真机逐条确认清单见 docs/VERIFY-BY-HAND.md。

项目现状(0.1.28 以来的变化、已验证与未验证的部分):docs/STATE-OF-PLAY.md。

目标用户与需求证据的诚实评审:docs/POSITIONING.md。

明确不支持(v1)

这些是刻意不做的,不是遗漏:

  1. 格内文件预览 / 改动评审:DSH 在任何一个全局面板激活时都会卸下右栏的会话面板(no session surface is mounted,自带的面板也一样)。要用右栏,请用格头的 ↗ 切到原生视图。
  2. 格内新建会话:Hero 的工作区选择器属于应用级导航,会把整个界面带走;新建会话请在原生视图里做。
  3. 格内 Trajectory / 插件视图切换:每格固定 Chat,不另造 tab。
  4. 点侧栏会话直接送进聚焦格:拦截整行点击等于劫持非公开的导航路径,所以普通点击保持原生行为(会离开分屏)。想送进分屏,请用该行的悬停分屏按钮或 … 菜单——由你主动按下去,而不是被改掉的点击行为。
  5. 自动休眠:只在手动移除/切格时释放资源;不伪造"非聚焦格暂停渲染"。
  6. 最多 4 格。

看不到分屏入口时

按顺序排掉这几种情况,绝大多数问题在第一步:

  1. 完整退出再打开。插件是客户端 bundle,启动时读取一次;关掉窗口但进程仍在运行时,装好的新版本不会生效。
  2. 确认插件已启用:设置 → 插件,dsh-multiview 应处于启用状态。
  3. 对照版本号:把鼠标停在分屏面板标题上,提示里写着正在运行的插件版本。如果它比你刚装的新版本旧,就是没重启成功。
  4. 确认宿主版本满足 engines.dsh(见上);宿主版本过高时插件仍会加载,并在同一处提示"宿主未经校验"。
  5. 侧栏面板列表里只有三项(插件 / 自动化任务 / 分屏);分屏固定排在最后。

性能

在 desktop-kfscv8c-1(1530×851 窗口)用 CDP rAF 采样实测:

场景 p50 p95 最长帧 >50ms 长任务 JS 堆
原生会话(基线) 16.7ms 16.7ms 16.8ms 0 43MB
4 格挂载、空闲 16.7ms 16.8ms 16.8ms 0 75MB
4 格挂载、2 路同时流式 16.7ms 16.7ms 16.8ms 0 85MB
4 格、4 路同时长流式 16.7ms 50ms 150ms 2 53MB

四路长文同时输出是最重场景:平均仍近 60fps,但 p95 升到 50ms、偶发一次 150ms 长帧(四份 transcript 各自按 chunk 重排)。v1 不降频——"每格都是真实 Chat"优先于帧率数字。

长帧不是本插件造成的:3 分钟两格同时流式的实测记录了 205 个长任务,于是趁流式期间采样 CPU 归因(0.5ms 采样,3609 个样本):

归属 采样时间占比
dsh-multiview 0.0%
宿主 / DSH 各 UI 包 7.1%
空闲、(program)、GC、原生 92.9%

同一段 3 分钟里:0 个未捕获错误,JS 堆 53MB → 峰值 85MB → 42MB(已回落,无无界增长),两格都跑到完成。

对话历史按 turn 虚拟化(DSH 自带),因此每格成本 ≈ 一个活跃 turn 的增量渲染 + 一个编辑器实例。窗口窄于 900px 或矮于 520px 时自动降级成「单格 + 顶栏格切换器」(切换器会显示每格状态:运行中 / 等待回答 / 完成未读),布局树保留。

开发

零第三方依赖,只用本机 Node ≥ 22.18(本仓库用 24.13):

npm run build     # src/client/*.ts → client.js(单文件 bundle);src/host/index.ts → index.js
npm test          # 布局代数单测(node --test)
npm run check     # 发布自检:manifest / 产物 / 文案 / 体积

隔离验证(不写任何 profile):

dsh --profile web --patch <repo>\.dev\dev.patch.yml --port 40602 --no-open

dev.patch.yml 里的 row 名用绝对 file:/// 指向本仓库的 index.js(Loader 的相对名锚定在 profile 根,不是 patch 文件旁)。

渲染只走公开插槽面:main keyed 面板 + 会话作用域子槽 + SessionProvider + conversation.content factory(variant:'embedded')+ sessions.retain + shortcuts + locale。

有两处不在这条线上,安装前值得知道:从格内打开文件预览时,它会按类名找到宿主自己的文件胶囊并 代为点击(全局面板激活时右栏没有会话面);另外它读取一个私有 store 字段(retainedBy.mainView) 来判断谁当前占着原生视图。两者都是有据可查的兜底路径,不是主路径。详见 docs/DESIGN.md。

状态与支持

预 1.0:接口稳定到可以日常使用,但小版本里仍可能出现小范围破坏性变更,每一处都记在 CHANGELOG.md。发布由 CI 从 tag 触发并带 npm provenance,所以 npm 上的包就是本仓库构建出的那一个。

客户端只会发两类网络请求:插件市场的同源 API,以及仅用于版本发现的 registry.npmjs.org/dsh-multiview/latest 公共读取(不带凭据、不带 referrer)。安装仍然走市场。scripts/check.mjs 会守住这份清单。

engines.dsh 接受从 0.2.1-rc.5 起的 0.2 线;0.2.0 与 rc.5 之前的 0.2.1 预发布不在范围内。 构建在 0.2.1-rc.5 与 0.2.2-rc.1 上验证过,这两条线(含其补丁版本)不会触发顶栏提示; 其他小版本会在 tooltip 里追加「DSH x.y.z 尚未验证」,而不是假装验证过。

  • Bug 与需求:issues(模板会问最要紧的两件事:插件版本、宿主版本)。
  • 多格渲染成本:已在上游立项 discussion #12559。
  • 限制浮层层级对比的主题令牌缺口(浅色无色阶、缺 state-business-secondary):discussion #12770。
  • 非分屏专属的问题(会话、权限、模型供应商)属于 harness 项目本身。

许可

MIT。