分屏工作区 mhlywxl/dsh-split-workspace

dsh-split-workspace

中文（默认） · English

把 DeepSeek Harness 的对话区拆成原生多窗格工作区——左右分屏、上下分屏、田字 2×2 或自动网格，窗口放得下多少会话就开多少。每个窗格都是真实会话，拥有自己的输入框、流式输出、停止、队列、待办、附件、/ 命令、ask_user_question、审批与视图页，桌面端（dsh-app://）同样可用。

功能

- 不限数量的原生窗格：没有四窗格上限，窗口放得下多少会话就能开多少。
- 自动布局：2 个窗格左右分栏，3 个呈 L 形，4 个田字 2×2，5 个以上按行优先的均衡网格排列。
- 拖拽自由排布：拖动窗格标题栏到另一个窗格的左/右/上/下，可手动堆叠或分栏。
- 原生会话，不是 iframe：每个窗格复用原生会话组件，输入框、流式输出、停止、队列、待办、审批和视图页都能正常工作。
- 桌面端就绪：为 DSH Desktop（dsh-app://）构建，preload 只在顶层框架运行。
- 共享侧边栏：原生侧边栏跟随当前聚焦的窗格；把会话拖到分屏区域即可新增或替换窗格。
- 右侧栏控制：打开/关闭有不同图标状态，由分屏工具栏统一控制。
- 最小化 / 恢复：隐藏分屏但保留窗格树。
- 持久化布局：重启后恢复上次的布局。

开始使用

- 点击侧边栏底部（设置旁）的分屏图标：用当前会话和列表中的下一个会话开始分屏。
- 或者把侧边栏里的会话拖到对话区：放下的会话成为第二个窗格。
- 分屏后，把另一个会话拖到某个窗格即可替换；也可以用窗格标题栏的分屏按钮为新窗格选择会话。
- 拖动侧边栏会话经过窗格边缘时，窗格会预览放下后的布局，并用虚线占位标出即将加入的会话；松开即应用该布局。

布局

- 自动策略：2 个并排，3 个 L 形，4 个 2×2，5 个以上按约 sqrt(n) 列的均衡行优先网格。没有模式菜单——增删窗格都会重新适配网格。想要上下堆叠，把第二个窗格的标题拖到第一个上，再移到底部边缘；手动拖拽的结果会被保留，自动网格只是起点。
- 拖动分隔条调整大小。
- 拖动标题栏移动窗格：原位置立即闭合（其他窗格填充空间），并在将落下的位置出现虚线占位——左、右、上、下，跟随手势方向。松开即放下；松开在原来的位置或按 Esc 取消。预览只计算几何，不重新挂载正在运行的会话。
- 双击标题栏（或 ⤢ 按钮）最大化/还原。
- 没有固定窗格上限：窗口能显示多少会话就能加多少（窗格变窄时标题栏会自动紧凑）。
- 存在分屏时，共享的原生侧边栏跟随聚焦窗格；点击会话即载入该窗格，或把会话拖到分屏区域新增/替换窗格。
- 窗格树在刷新和重启后保留（包括手工拖出的堆叠或 L 形布局）；增删窗格会重新适配自动网格，重启不会。
- 最小化（工具栏）会隐藏分屏、显示原生单会话视图，同时保留窗格树；「恢复分屏」按钮可以恢复。点击新建会话或插件/技能/设置面板会自动最小化分屏（新视图不会被遮挡）；恢复后回到聚焦窗格的会话。
- 每个窗格只有一个标题：标题由窗格标题栏负责；原生标题栏保留视图页和操作，不重复面包屑。关闭按钮是红底描边的 ✕，不是低对比度圆点。
- 如果安装了 dsh-prompt-history，它的可拖动 会话目录 (☰) 握把会在每个活动窗格的左边缘垂直居中显示一次。每次分屏调整（新增、关闭、重排、拖动分隔条、最大化或右侧栏推挤）都会把受影响的握把重新放回窗格左边缘与垂直中心；没有变化的窗格保留手动拖动的位置。隐藏的原生会话和非窗格视图里的副本会被隐藏，握把不再堆叠。
- 分屏工具栏的右侧栏按钮有两种状态：面板关闭时是右箭头（点击打开），打开时是高亮的左箭头（点击收起）。修复监听器会在分屏拆除后接管原生的打开/收起按钮，避免过期的 sidebar-right store 吞掉点击或隐藏入口。
- 窗格标题栏刻意不挂载原生的每窗格 rightbar 座位（右侧栏由分屏工具栏统一控制）。该座位是会话级的，自带 store 句柄；在每个窗格里挂载会为同一会话创建第二个 sidebar-right store，导致共享面板的标签图标看起来失效。原生标题栏保留唯一的 store。

为什么不是每个窗格一个 iframe？

桌面端从 dsh-app://app/ 提供客户端，并通过 Electron preload 注入启动图（__DSH_BOOT__、__DSH_TRANSPORT__ 等）。preload 只在顶层框架运行，所以同源 iframe 会永远停在 “Loading plugins…”。因此窗格引擎在顶层客户端运行，按会话重新挂载原生对话组件——与上游插件相同的架构。

桌面端安装

包面向 desktop profile（dsh.client.platform: "web" 是 Desktop 客户端加载的平台）。装进 desktop profile 后重启应用，新的客户端 bundle 会被扫描。

命令

- window.__dshSplitWorkspace.health()：版本、宿主、窗格、几何、持久化树、崩溃保护。
- window.__dshSplitWorkspace.split(sessionId)：把会话加为窗格。
- window.__dshSplitWorkspace.arrange("auto")：重新适配自动布局（旧模式名会被接受并忽略）。
- window.__dshSplitWorkspace.focusChat()、closeFocused()。
- window.__dshSplitWorkspace.reflow()：拖动预览状态（排查占位/闭合行为用）。
- window.__dshSplitWorkspace.setEnabled(false)：总开关。
- window.__dshSplitWorkspace.reset()：清除已保存布局。

快捷键

- Alt+T：切换聚焦窗格里的紧凑 TUI 输入框。
- Alt+Shift+←/→/↑/↓：在窗格间移动焦点。

界面截图

| 左右两列 · Side by side | 上下两列 · Stacked | 田字 · 2×2 grid |
| DeepSeek Harness 分屏，两个会话并排 | DeepSeek Harness 分屏，两个会话上下堆叠 | DeepSeek Harness 2×2 网格，四个会话 |
| 2 个窗格 · 自动分列 | 2 个窗格 · 拖成上下行 | 4 个窗格 · 自动 2×2 田字 |

拖动窗格标题栏即可重新排列——虚线空洞会预览落点：

拖动 DeepSeek Harness 分屏窗格的标题栏，创建上下分屏

限制

- 窗格数量没有上限；持久化树会做校验（会话唯一、深度），损坏的树会被丢弃，而不是恢复一个坏掉的工作区。
- 持久化递归深度上限为 32 层，是为了手改数据时的栈安全，不是窗格上限。
- 隐藏的原生会话仍在遮罩下流式运行；窗格重新挂载原生输入框，所以每个窗格自己的输入框拥有该会话的编辑器。
- 窗格重命名拒绝空会话（原生重命名对话框同样如此）。

MIT。见 THIRD-PARTY-NOTICES.md。

DeepSeek Harness（DSH）桌面端分屏——想开多少会话就开多少，并排、上下堆叠，或 2×2 / 自动网格。

dsh-split-workspace 把 DeepSeek Harness 的对话区变成原生多窗格工作区，桌面端（dsh-app:// shell）同样适用。每个窗格都是真实会话，拥有自己的输入框、流式输出、停止、队列、待办、附件、/ 命令、ask_user_question、审批和视图页。

中文简介：把 DeepSeek Harness 的对话区拆成任意数量的原生窗格，支持左右分屏、上下分屏、田字 2×2 和自动网格；每个窗格都是真实会话，拥有自己的输入框、流式输出、停止、队列、待办、附件、斜杠命令、审批和视图页。适用于 DSH 桌面端。

搜索关键词 / Search terms：split screen, split view, split pane, multi-pane, multi-session, multi-window, tiled workspace, unlimited panes, DSH Desktop, 分屏, 分屏插件, 多窗格, 多窗口, 多会话, 左右分屏, 上下分屏, 并排, 田字布局.

窗格引擎源自 dsh-split-screen 1.7.0 （MIT）。本包针对桌面端 shell 做了适配，并新增自动布局、无上限窗格数量、重命名/复制/最大化以及紧凑工具栏。

功能

- 原生窗格无上限——没有四窗格上限；窗口能显示多少会话，就能加多少。
- 自动布局——2 个窗格分列，3 个排成 L 形，4 个排成 2×2 田字，5 个及以上排成均衡的行优先网格。
- 拖动任意排列——把窗格标题栏拖到另一个窗格的左、右、上、下；可以两两堆叠，也可以手动搭出分列。
- 原生会话，不是 iframe——每个窗格重新承载原生对话原语，所以 composer、streaming、Stop、queue、todos、approvals 和 view 标签页都能正常工作。
- 桌面端就绪 — 为 DSH Desktop shell（dsh-app://）构建，其中 preload 只在顶层 frame 运行。
- 共享侧边栏 — 内置侧边栏跟随聚焦窗格；把会话拖到分屏上即可添加或替换窗格。
- 右侧边栏控制 — 用不同的图标状态打开和关闭；分屏工具栏负责切换。
- 最小化 / 恢复 — 隐藏分屏而不丢失窗格树。
- 持久化窗格树 — 重启后回到你离开时的布局。

开始

- 点击侧边栏页脚的分屏图标（Settings 旁边）—— 它会用当前会话和列表中下一个会话启动分屏。
- 或者从侧边栏把会话拖到会话列上：放下的会话成为第二个窗格。
- 分屏后，把另一个会话拖到某个窗格上即可替换它，或用窗格标题栏的分屏按钮为新窗格选择会话。
- 拖动侧边栏会话悬停在窗格边缘时，窗格会按放下后的布局预先排好，并用虚线占位符标出即将加入的会话 —— 松开即提交该布局。

布局

- 自动策略：2 个窗格并排，3 个呈 L 形，4 个呈 2×2 网格，5 个及以上呈平衡的行优先网格，列数约按 sqrt(n) 增长。没有模式菜单 —— 添加或关闭窗格只会重新适配网格。要堆叠两个窗格，把第二个窗格的标题栏拖到第一个上，再向下移到下边缘；有意的拖动会被保留，自动网格只是起点。
- 拖动分隔条调整大小。
- 拖动窗格标题栏移动窗格：窗格的槽位立即关闭（其他窗格填补空间），并在它将落下的位置打开一个虚线空洞 —— 位于光标下窗格的左、右、上或下，跟随手势方向。松开即放下；在窗格自己的槽位上松开，或按 Esc，取消。预览只涉及几何，所以拖动时实时会话不会重新挂载。
- 双击窗格标题栏（或使用 ⤢ 按钮）最大化 / 恢复。
- 没有固定窗格上限：窗口能显示多少会话就加多少（窗格变窄时，每个窗格的标题栏会自行压缩）。
- 存在分屏时，共享的内置侧边栏跟随聚焦窗格；点击会话将其加载到该窗格，或把会话拖到分屏区域添加/替换窗格。
- 窗格树在重新加载后保持，并以你离开时的布局重新打开（包括手工堆叠或 L 形排列）。添加或关闭窗格会重新适配自动网格；重启不会。
- 最小化（工具栏）隐藏分屏并显示内置的单会话视图，同时保留窗格树。一个「恢复分屏」chip 可将其带回。点击 New Session 或插件/技能/设置面板会最小化自动拆分（新视图不会被遮挡）；还原后回到聚焦窗格的会话。
- 每个窗格只有一个标题：标题归窗格头部所有；原生头部保留自己的视图标签和操作，不再重复面包屑。关闭控件是画出来的 ✕，放在红色底按钮里，而不是低对比度的小圆点。
- 如果安装了 dsh-prompt-history，它可拖拽的 会话目录 (☰) 抓手每个活动窗格只显示一次，位于窗格左边缘、垂直居中。每次拆分调整（新增、关闭、重排、拖动分隔条、最大化或右侧栏推挤）都会把受影响的抓手重新放回窗格左边缘和垂直中心；盒子没变的窗格保留你手动拖出的垂直位置。隐藏的原生会话和非窗格视图挂载的副本会隐藏，抓手不再互相叠在一起。
- 拆分工具栏的右侧栏控件有两种状态：面板关闭时显示右向 chevron（点击打开），打开时显示强调色的左向 chevron（点击收起）。拆分被拆除后，修复监视器会接管原生展开/收起按钮，过期的 sidebar-right store 再也吞不掉点击，也藏不住回到面板的入口。
- 窗格头部刻意不挂载原生每窗格 rightbar 座位（开关归拆分工具栏管）。那个座位是会话级的，自带 store 句柄；在每个窗格里挂载它，会为同一会话创建第二个 sidebar-right store，导致共享面板的标签图标看起来失灵。原生头部保留唯一的 store。

为什么不是每个窗格一个 iframe？

Desktop 应用从 dsh-app://app/ 提供客户端，并通过 Electron preload 注入启动图（__DSH_BOOT__、__DSH_TRANSPORT__、…）。preload 只在顶层 frame 运行，所以同源 iframe 会永远停在「Loading plugins…」。因此窗格引擎跑在顶层客户端里，按会话重新托管原生会话原语——和上游插件用的是同一套架构。

Desktop 用法

这个包面向 desktop 配置档（dsh.client.platform: "web" 就是 Desktop 客户端加载的平台）。把它装进 desktop 配置档，重启应用，让新的客户端 bundle 被扫描到。

命令

- window.__dshSplitWorkspace.health() — 版本、宿主、窗格、几何、持久化树、崩溃防护。
- window.__dshSplitWorkspace.split(sessionId) — 把一个会话加为窗格。
- window.__dshSplitWorkspace.arrange("auto") — 重新适配自动布局（旧模式名会被接受并忽略）。
- window.__dshSplitWorkspace.focusChat()、closeFocused()。
- window.__dshSplitWorkspace.reflow() — 实时窗格拖动预览状态（用于诊断空洞/塌陷行为）。
- window.__dshSplitWorkspace.setEnabled(false) — 紧急关闭开关。
- window.__dshSplitWorkspace.reset() — 清空已保存的布局。

键盘

- Alt+T — 在聚焦窗格中切换紧凑 TUI 输入区。
- Alt+Shift+←/→/↑/↓ — 在窗格之间移动焦点。

限制

- 窗格数量不设上限；持久化的树会做校验（会话唯一、深度），树损坏时直接丢弃，不会重新激活一个坏掉的工作区。
- 持久化的递归深度上限为 32 层，这是为手改过的数据加的栈安全保护，不是窗格数量限制。
- 隐藏的内置会话仍在浮层下持续流式输出；窗格重新托管原生输入区，所以每个窗格自己的输入区管理它所属会话的编辑器。
- 窗格重命名拒绝空会话（内置重命名对话框也是同样行为）。

MIT。见 THIRD-PARTY-NOTICES.md。

同作者的其他插件 · More plugins by the same author

- DSH 声音与提醒（dsh-coding-sound）— 用声音盯住 Agent：按输出文字演奏生成式背景音乐，完成、等待审批与工具执行各有可配置的提示音。
DSH coding sound (dsh-coding-sound) — Generative background music and notification chimes for DeepSeek Harness: hear whether the agent is thinking, still working, or waiting for you.

支持作者 · Support the author

如果这个项目帮你省下了盯屏幕的时间，欢迎请作者喝杯咖啡 ☕，或者给作者「充充电」⚡。金额随意，心意最重要。

If this project saved you some screen time, you can buy the author a coffee ☕ or top up the author's battery ⚡. Any amount is welcome — the thought counts.

支付宝 · 微信支付 / Alipay · WeChat Pay