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
2 panes · automatic columns	2 panes · dragged into rows	4 panes · automatic 2×2 田字

Drag a pane by its header to re-arrange it — the dashed hole previews where it will land:

限制

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

MIT。见 THIRD-PARTY-NOTICES.md。

---

English

Split screen for DeepSeek Harness (DSH) Desktop — open as many conversations as you need, side by side, stacked, or in a 2×2 / automatic grid.

dsh-split-workspace turns the DeepSeek Harness conversation area into a native multi-pane workspace, including in the Desktop app (dsh-app:// shell). Each pane is a real session with its own composer, streaming, Stop, queue, todos, attachments, / commands, ask_user_question, approvals and view tabs.

中文简介：把 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, 分屏, 分屏插件, 多窗格, 多窗口, 多会话, 左右分屏, 上下分屏, 并排, 田字布局.

The pane engine is derived from dsh-split-screen 1.7.0 (MIT). This package adapts it for the Desktop shell and adds the automatic layout, the unlimited pane count, rename/copy/maximize and the compact toolbar.

Features

• Unlimited native panes — no four-pane cap; add as many conversations as the window can show.
• Automatic layout — 2 panes as columns, 3 as an L, 4 as a 2×2 田字, and 5+ as a balanced row-major grid.
• Any arrangement by drag — drag a pane header left, right, above or below another pane; stack a pair or build columns by hand.
• Native sessions, not iframes — each pane re-hosts the stock conversation primitives, so composer, streaming, Stop, queue, todos, approvals and view tabs all work.
• Desktop-ready — built for the DSH Desktop shell (dsh-app://), where the preload only runs in the top frame.
• Shared sidebar — the stock sidebar follows the focused pane; drag a conversation onto the split to add or replace a pane.
• Right sidebar control — open and close with distinct icon states; the split toolbar owns the toggle.
• Minimize / restore — hide the split without losing the pane tree.
• Persistent tree — the layout you left comes back after a restart.

Start

• Click the split icon in the sidebar footer (beside Settings) — it starts a split with the current conversation and the next listed one.
• Or drag a conversation from the sidebar onto the conversation column: the dropped conversation becomes the second pane.
• Once split, drag another conversation onto a pane to replace it, or use a pane header's split buttons to choose the session for a new pane.
• While a sidebar conversation is dragged over a pane edge, the panes lay themselves out as they will after the drop and a dashed placeholder names the incoming conversation — release to commit exactly that layout.

Layout

• The automatic policy: 2 panes side by side, 3 as an L, 4 as a 2×2 grid, and 5+ as a balanced row-major grid that grows by about sqrt(n) columns. There is no mode menu — adding or closing a pane simply re-fits the grid. For a stacked pair, drag the second pane's header over the first, then move down to the bottom edge; a deliberate drag is kept, and the automatic grid is only the starting point.
• Drag the dividers to resize.
• Drag a pane by its header to move it: the pane's slot closes immediately (the other panes fill the space) and a dashed hole opens where it will land — left, right, above or below the pane under the cursor, following the direction of the gesture. Release to drop; release over the pane's own slot, or press Esc, to cancel. The preview is geometry-only, so the live conversations are not remounted while you drag.
• Double-click a pane header (or use the ⤢ button) to maximize / restore.
• No fixed pane cap: add as many conversations as the window can show (the per-pane header compacts itself as panes get narrower).
• While a split exists the shared stock sidebar follows the focused pane; click a conversation to load it into that pane, or drag a conversation onto the split area to add/replace a pane.
• The pane tree persists across reloads and reopens with the layout you left (including a hand-made stacked or L-shaped arrangement). Adding or closing a pane re-fits the automatic grid; restarting does not.
• Minimize (toolbar) hides the split and shows the stock single-session view while keeping the pane tree. A "restore split" chip brings it back. Clicking New Session or a plugin/skills/settings panel minimizes the split automatically (so the new view is never covered); restoring returns to the focused pane's conversation.
• One title per pane: the pane header owns the title; the stock header keeps its view tabs and actions without repeating the breadcrumb. The close control is a drawn ✕ in a red-tinted button, not a low-contrast dot.
• If dsh-prompt-history is installed, its draggable 会话目录 (☰) grip is shown once per live pane, on the pane's left edge and vertically centered. Every split adjustment (add, close, re-arrange, divider drag, maximize or a right-sidebar push) re-homes the affected grips to the left edge and the vertical center of their pane; a pane whose box did not change keeps a deliberate vertical drag. The copies mounted by the hidden stock conversation and by non-pane views are hidden, so the grips no longer stack on top of each other.
• The split toolbar's right-sidebar control has two states: a right chevron while the panel is closed (opens it) and an accent, left-chevron state while it is open (collapses it). A repair watcher catches the stock open/collapse buttons after a split is torn down, so a stale sidebar-right store can no longer swallow the click or hide the way back into the panel.
• Pane headers deliberately do not mount the stock per-pane rightbar seat (the split toolbar owns the toggle). That seat is session-scoped and carries its own store handle; mounting it inside every pane created a second sidebar-right store for the same session, which made the shared panel's tab icons look dead. The stock header keeps the single store.

Why not one iframe per pane?

The Desktop app serves the client from dsh-app://app/ and injects the boot graph (__DSH_BOOT__, __DSH_TRANSPORT__, …) through the Electron preload. That preload runs only in the top frame, so a same-origin iframe stays at “Loading plugins…” forever. The pane engine therefore runs in the top client, re-hosting the stock conversation primitives per session — the same architecture the upstream plugin uses.

Desktop use

The package targets the desktop profile (dsh.client.platform: "web" is the platform the Desktop client loads). Install it into the desktop profile and restart the app so the new client bundle is scanned.

Commands

• window.__dshSplitWorkspace.health() — version, host, panes, geometry, persisted tree, crash guard.
• window.__dshSplitWorkspace.split(sessionId) — add a session as a pane.
• window.__dshSplitWorkspace.arrange("auto") — re-fit the automatic layout (legacy mode names are accepted and ignored).
• window.__dshSplitWorkspace.focusChat(), closeFocused().
• window.__dshSplitWorkspace.reflow() — live pane-drag preview state (diagnostics for the hole/collapse behaviour).
• window.__dshSplitWorkspace.setEnabled(false) — kill switch.
• window.__dshSplitWorkspace.reset() — clear the saved layout.

Keyboard

• Alt+T — toggle the compact TUI composer in the focused pane.
• Alt+Shift+←/→/↑/↓ — move focus between panes.

Limits

• No pane-count cap; the persisted tree is validated (unique sessions, depth) and a corrupt tree is discarded instead of reactivating a broken workspace.
• The persisted recursion depth is capped at 32 levels as a stack-safety guard for hand-edited payloads, not as a pane limit.
• The hidden stock conversation still streams under the overlay; panes re-host the native composer, so a pane's own composer owns its session's editor.
• Pane rename refuses blank sessions (the stock rename dialog does the same).

MIT. See 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}