dsh-split-workspace 0.8.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,107 @@
1
+ # Changelog
2
+
3
+ 本文件记录 `dsh-split-workspace` 的公开版本变更,格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),版本号遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
4
+
5
+ This file records public releases of `dsh-split-workspace`; each version ends with a one-line English summary.
6
+
7
+ ## [0.11.0] - 2026-11-18
8
+
9
+ ### Added
10
+
11
+ - **系统窗口(macOS 原生独立窗口)**:会话右键菜单新增 **分屏插件** 一级菜单,把 **加入分屏 / 退出分屏**、**进入浮窗 / 退出浮窗**、**进入独立窗口 / 退出独立窗口**、**进入系统窗口 / 退出系统窗口** 都收进它的二级菜单。其中「加入分屏 / 退出分屏」合并为同一个按状态显示的开关(在分屏/待分屏中显示「退出分屏」,否则显示「加入分屏」)。系统窗口打开一个真正的操作系统窗口(AppKit `NSWindow` + `WKWebView`,由 Host 通过 `osascript` 启动 `native/system-window.jxa`),可以拖到 DSH 主窗口之外、独立缩放和关闭;**不打开浏览器**,窗口内**不显示左侧栏**,右侧栏等其他区域照常保留。
12
+ - **窗口菜单状态跟随窗口开关**:浮窗、独立窗口、系统窗口都在打开后把菜单项变成 **退出浮窗 / 退出独立窗口 / 退出系统窗口**;关闭窗口(包括点窗口自身的关闭按钮,或关闭系统窗口 Helper)后菜单自动回到“进入”状态。独立窗口跟随时运行时 store,系统窗口状态由 Host 维护并通过 `/dsv/system-window` 查询(菜单打开期间轮询),退出/关闭立即更新。
13
+ - 新增 Host 侧 `nativeWindowSessions()` 与关闭动作:`POST /dsv/system-window` 支持 `{ sessionId, action: "open" | "close" }`,`GET` 返回当前系统窗口的会话列表;同一会话只保留一个系统窗口。
14
+ - 窗口加载 Host 本机认证的 Web 客户端:认证 URL 由 Host 在进程内生成并只交给本机 Helper,**不会返回给渲染层**;URL 哈希标记让同一份客户端代码在窗口内进入「系统窗口模式」——隐藏左侧栏与其网格轨道、隐藏插件自己的入口,并激活目标会话。
15
+ - **左下角分屏菜单新增「分屏帮助」入口**:底部分屏按钮菜单里可以直接打开带截图的帮助卡片。
16
+ - **分屏帮助新增界面指引截图**:帮助卡片(「分屏帮助」/窗格 `?` / 设置页「分屏帮助」)里新增三张截图缩略图——会话右键「分屏插件」菜单、左下角分屏按钮菜单、设置 → 分屏工作区;点击缩略图打开大图(Esc 或点击遮罩关闭)。Host 新增同源静态路由 `/dsv/help/...`,从 `docs/screenshots/` 读取,桌面端与 Web 客户端均可显示。
17
+ - 新增 API `window.__dshSplitWorkspace.openNativeWindow(sessionId)`、`closeNativeWindow(sessionId)` 与 `nativeWindows()`。
18
+ - Windows / Linux 点击时提示改用「在独立窗口打开」,不会退回浏览器;关闭窗口会结束后台 Helper 进程,退出 DSH 时也会关闭这些窗口。
19
+
20
+ ### Changed
21
+
22
+ - Host 新增 `/dsv/system-window` 路由(POST + 确认头 + 同源校验 + 会话 id 白名单),平台不支持时返回 `unsupported-platform`;新增 `native/system-window.jxa` 并加入 npm 发布文件清单。
23
+ - README 增加系统窗口章节、限制说明与平台注意事项;测试补充系统窗口、Helper 与客户端入口断言。
24
+
25
+ **English summary:** Session context menu gains **Open in system window**: on macOS the Host opens a real OS window (AppKit NSWindow + WKWebView, no browser) showing one conversation with no left sidebar and the stock right sidebar intact. Adds the `/dsv/system-window` Host route, `openNativeWindow()`, and a packaged `native/system-window.jxa` helper.
26
+
27
+ ## [0.10.0] - 2026-11-18
28
+
29
+ ### Changed
30
+
31
+ - **「在系统窗口打开」改为应用内独立窗口,不再打开浏览器。** 右键会话 → **在独立窗口打开** 会在 DSH 应用内部显示该会话,提供关闭 / 最小化 / 最大化-还原 / 全屏;双击标题栏切换最大化,最小化后收成左下角的恢复胶囊。会话仍从分屏 / 浮窗 / 待分屏中移出,关闭窗口后仍在侧栏里。
32
+ - 说明:DSH Desktop 的 Electron 主进程拒绝 `window.open` 创建原生窗口,Host 进程也没有 `BrowserWindow` API,当前 DSH 没有插件可用的原生多窗口接口。因此独立窗口是**应用内窗口**(无地址栏、不依赖浏览器),但仍在 DSH 主窗口内部;未来 DSH 开放原生窗口能力时可直接替换这一层。
33
+ - **新增系统设置入口**:除侧边栏底部菜单外,插件现在注册 **设置 → 分屏工作区** 页面(`settings.section`)。页面提供版本 / 窗格 / 待分屏 / 浮窗 / 独立窗口状态,性能模式开关,以及添加、退出、最小化、重置分屏、刷新界面、重启 DSH、帮助等操作。
34
+ - 删除浏览器独立页与 Host 的 `/dsv/system-window` 路由、`#dsvWindow` 标记;`/dsv/version` 与 `/dsv/restart` 保留。
35
+ - 新增 `window.__dshSplitWorkspace.openIndependentWindow(sessionId)`(`openSystemWindow` 的别名)与 `appWindow()` 状态查询。
36
+ - 帮助卡片补充独立窗口说明;README、测试与发布文件清单同步更新。
37
+
38
+ ### Added
39
+
40
+ - `CHANGELOG.md`。
41
+
42
+ **English summary:** The session context menu's “system window” is now an in-app independent window (close / minimize / maximize / fullscreen, no browser); a new Settings → Split workspace page mirrors the split menu; the old browser standalone page and Host route were removed.
43
+
44
+ ## [0.9.0] - 2026-11-18
45
+
46
+ ### Added
47
+
48
+ - **重启入口**:桌面版分屏菜单、更新提示和 `restartApp()` API 都可以关闭并重新打开 DSH。Host 半边执行系统级重启——macOS 通过 AppleScript 正常退出,Windows 关闭窗口后终止进程并重新启动。生产版 DSH 没有内置重启菜单,这个入口用来应用需要完整重启的插件变更。
49
+ - **兜底分屏入口**:侧边栏 footer 没有渲染或被隐藏时,对话区左下角显示「分屏视图」按钮,菜单仍可打开。
50
+ - 更新提示在桌面版直接提供「重启 DSH」按钮;Web 版提供「刷新页面」。
51
+
52
+ ### Changed
53
+
54
+ - **性能模式默认开启**:只有显式关过一次(存储值 `"0"`)才保持关闭。
55
+ - **性能模式下完全不渲染拖动缩略图**:不再克隆对话 DOM、不再逐帧移动预览窗口;拖入目标、布局预览和放置反馈保留。
56
+ - 更新 README:DSH 0.2.x 通过 HMR 热加载新安装的插件和重建的客户端 bundle,大多数安装/更新不需要重启;补充开发者工具刷新页面、重启入口和 HMR 的说明。
57
+
58
+ **English summary:** Added restart actions (menu, update chip, API) with OS-level quit/relaunch, a fallback split launcher, performance mode on by default, and no drag-preview thumbnail in performance mode.
59
+
60
+ ## [0.8.0] - 2026-11-17
61
+
62
+ ### Added
63
+
64
+ - **系统窗口(浏览器承载)**:右键会话 → 在系统窗口打开,由 Host 生成带 token 的 DSH Web 地址,在系统默认浏览器里打开只显示该会话的窗口。
65
+ - **性能模式**:关闭动画、阴影、跑马灯和多个后台观察器/轮询,适合低配机器与 Windows 多窗格场景。
66
+ - **更新提示**:运行中的页面读取磁盘上的 `package.json`,检测到新版本时显示更新提示。
67
+ - **`client.js` 工程化拆分**:拆成 `src/client/` 下的 18 个有序片段,由 `scripts/build-client.mjs` 拼回单文件;`npm test` 会检查产物是否过期。
68
+ - 修复分屏窗格标题栏拖动吞掉关闭按钮点击的问题(标题栏按落点动态启用拖动)。
69
+
70
+ **English summary:** Added system windows (browser-hosted), performance mode, update notice, modular client sources/build script, and the pane close-button click fix.
71
+
72
+ ## [0.5.0] - 2026-11-17
73
+
74
+ ### Added
75
+
76
+ - 侧边栏底部分屏菜单:添加分屏 / 退出分屏 / 最小化分屏 / 重置分屏。
77
+ - 「添加分屏」多选弹框:可搜索、预选当前窗格、取消或追加会话。
78
+ - 会话右键菜单集成:加入分屏 / 退出分屏;未分屏时先进入待分屏,满两个会话才分屏。
79
+
80
+ **English summary:** Added the sidebar-footer split menu, multi-select add dialog, and session context-menu split actions with a pending split.
81
+
82
+ ## [0.4.3] - 2026-10-21
83
+
84
+ ### Fixed
85
+
86
+ - 把页面级单例的 composer 插件作用域限定到当前活动窗格。
87
+ - 键盘焦点窗格内的浮层保持可见并重新锚定。
88
+ - 提示浮层锚定到聚焦窗格,拖动分屏更平滑。
89
+
90
+ ### Added
91
+
92
+ - 中英双语文档与快速开始。
93
+ - GitHub Actions:测试通过且 npm 版本可解析后才创建 GitHub Release。
94
+
95
+ **English summary:** Fixed composer-plugin scoping and pane-overlay anchoring, added bilingual docs and safer CI release gating.
96
+
97
+ ## [0.4.0] - 2026-10-21
98
+
99
+ ### Added
100
+
101
+ - 分屏工作区首个公开发布:原生 `ChatPane` 多窗格、自动左右 / L 形 / 田字 / 网格布局、拖动重排、持久化布局、Alt+T 紧凑输入行、Alt+Shift+方向键切换窗格。
102
+
103
+ **English summary:** First public release of the native multi-pane split workspace with automatic layouts, drag reordering and persisted layouts.
104
+
105
+ ## Earlier versions
106
+
107
+ `0.1.x`–`0.3.x` were pre-public iterations of the split workspace and were not published as separate tagged releases.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **中文(默认)** · [English](#english)
4
4
 
5
- 把 DeepSeek Harness 的对话区拆成原生多窗格工作区——左右分屏、上下分屏、田字 2×2 或自动网格,窗口放得下多少会话就开多少。每个窗格都是真实会话,拥有自己的输入框、流式输出、停止、队列、待办、附件、`/` 命令、`ask_user_question`、审批与视图页,桌面端(`dsh-app://`)同样可用。还可以把任意会话变成可拖动、可缩放的**浮窗**,在分屏与浮窗两种模式之间来回切换。
5
+ 把 DeepSeek Harness 的对话区拆成原生多窗格工作区——左右分屏、上下分屏、田字 2×2 或自动网格,窗口放得下多少会话就开多少。每个窗格都是真实会话,拥有自己的输入框、流式输出、停止、队列、待办、附件、`/` 命令、`ask_user_question`、审批与视图页,桌面端(`dsh-app://`)同样可用。还可以把任意会话变成可拖动、可缩放的**浮窗**,在分屏与浮窗两种模式之间来回切换;或把它放进**应用内独立窗口**(关闭 / 最小化 / 最大化 / 全屏),macOS 桌面版还可以把它放进**真正的系统窗口**(系统 WebView,独立于 DSH 主窗口,不经过浏览器);并支持从侧边栏菜单和**系统设置**两个入口操作。版本历史见 [CHANGELOG.md](CHANGELOG.md)。
6
6
 
7
7
  ## 快速开始
8
8
 
@@ -49,7 +49,7 @@ dsh --profile web
49
49
 
50
50
  1. 打开 DSH Desktop,侧边栏 **插件市场**,搜索 `dsh-split-workspace` 并安装;或进入 **插件 → 添加插件 → 安装第三方插件**,填入包名。
51
51
  2. 打开 **设置 → 插件**,启用 `dsh-split-workspace`。
52
- 3. **完全退出并重开 DSH Desktop**,让新的客户端 bundle 生效。
52
+ 3. 安装完成后插件通常会被 DSH 的 HMR 立即加载,无需重启;如果几秒后侧边栏底部仍没有分屏图标,再完全退出并重开 DSH Desktop(插件加载后,菜单/更新提示也提供「重启 DSH」入口)。
53
53
 
54
54
  > 桌面端的 `desktop` profile 由 Electron 应用独占管理。不要在终端执行 `dsh plugin --profile desktop add ...`,该命令会拒绝执行;桌面端请用上面的插件市场 / 添加插件界面。
55
55
 
@@ -59,15 +59,15 @@ dsh --profile web
59
59
  2. DSH Desktop → **插件 → 添加插件 → 安装第三方插件**:
60
60
  - 优先填 `.tgz` 的**绝对路径**(安装器会识别为「压缩包」);
61
61
  - 如果当前版本只接受目录,先把 `.tgz` 解压,再填解压后的目录路径(目录根下要有 `package.json`)。
62
- 3. 在 **设置 → 插件** 启用,完全退出并重开 DSH Desktop。
62
+ 3. 在 **设置 → 插件** 启用;通常会被 HMR 立即加载。若侧边栏底部没有出现分屏图标,完全退出并重开 DSH Desktop,或使用插件菜单里的「重启 DSH」。
63
63
  4. 离线机器不需要网络;插件运行时不联网。
64
64
 
65
65
  ### 启用与验证
66
66
 
67
- - 打开 **设置 → 插件**,确认 `dsh-split-workspace` 已启用;桌面端需完整重启,Web 端需重启 `dsh web` 并刷新。
67
+ - 打开 **设置 → 插件**,确认 `dsh-split-workspace` 已启用。DSH 0.2.x 会通过 HMR 热加载新安装的插件;如果没有出现界面,见下方「更新、重载与重启」。
68
68
  - 分屏入口:点击侧边栏底部(设置旁)的分屏图标,或把侧边栏里的会话拖到对话区。
69
69
  - 打开浏览器/桌面端控制台执行 `window.__dshSplitWorkspace.health()`,可看到版本、窗格数和几何状态。
70
- - 如果看不到分屏入口:确认至少有 2 个会话、插件未处于安全模式,并检查 DSH 版本是否匹配。
70
+ - 如果看不到分屏入口:确认插件已启用且没有报错;如果侧边栏底部的 footer 没有渲染,插件会在对话区左下角显示兜底的分屏按钮。
71
71
 
72
72
  ### 开始分屏
73
73
 
@@ -79,9 +79,19 @@ dsh --profile web
79
79
  - 拖动侧边栏会话经过窗格边缘时,窗格会预览放下后的布局,并用虚线占位标出即将加入的会话;松开即应用该布局。
80
80
  - **重置分屏** 会清空本插件在 localStorage / sessionStorage 里的分屏相关键、已保存布局、崩溃保护、最小化标记和窗格临时缓存(性能模式偏好会保留);当分屏因为缓存或异常状态怎么都起不来时,点它即可恢复到干净状态。
81
81
  - 右键任意会话(或点行尾的「⋯」)→ **进入浮窗**,即可把该会话变成一个可自由摆放的浮窗;浮窗标题栏可以拖动、边缘可以缩放,点 **⇲ 回到分屏** 放回分屏,点 **✕** 直接关闭浮窗。同一会话不会同时出现在分屏和浮窗里:进入浮窗时会自动从分屏/待分屏中移出。
82
- - 右键会话 → **在系统窗口打开**:在系统默认浏览器里打开一个只显示该会话的独立窗口,关闭 / 最小化 / 双击标题栏放大 / 全屏都由系统窗口原生提供。
82
+ - 右键会话 → **分屏插件**:一级菜单集中了会话的分屏与窗口操作,二级菜单包括 **加入分屏 / 退出分屏**(同一个开关,按当前状态显示)、**进入浮窗 / 退出浮窗**、**进入独立窗口 / 退出独立窗口**、**进入系统窗口 / 退出系统窗口**。每个条目都按当前状态显示“进入”或“退出”;窗口关闭(包括点窗口自身的关闭按钮)后,菜单会自动回到“进入”状态。
83
83
  - **关闭窗格(标题栏 ✕)或退出分屏时,只要剩余会话少于两个就整体退出分屏**:窗格树和所有会话的分屏状态会一起清空,不会留下「菜单里显示分屏中、却没有被选中」的残留状态。只剩一个窗格的分屏不成立,所以不保留隐藏的单窗格树。
84
84
 
85
+ ## 使用帮助(界面指引)
86
+
87
+ 插件内的 **分屏帮助**(菜单里的「分屏帮助」、窗格标题栏的 `?`,或设置页的「分屏帮助」)现在已经带三张界面指引截图,点击缩略图可以查看大图:
88
+
89
+ | 会话右键菜单(分屏插件) | 左下角分屏按钮菜单 | 设置 → 分屏工作区 |
90
+ | --- | --- | --- |
91
+ | [![右键会话 → 分屏插件二级菜单](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-session-menu.png)](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-session-menu.png) | [![左下角分屏按钮菜单](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-footer-menu.png)](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-footer-menu.png) | [![设置 → 分屏工作区](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-settings.png)](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/help-settings.png) |
92
+
93
+ 截图由插件 Host 从 `docs/screenshots/` 以同源路径 `/dsv/help/...` 提供,因此桌面端(`dsh-app://`)和 Web 客户端都能直接显示,无需外网。
94
+
85
95
  ## 浮窗模式(独立窗口)
86
96
 
87
97
  分屏和浮窗是同一个工作区的两种形态,可以随时互相切换:
@@ -102,23 +112,43 @@ dsh --profile web
102
112
 
103
113
  如果 DSH 未来开放原生多窗口能力,浮窗层可以直接换成原生窗口,而“分屏 ⇄ 浮窗”的会话切换逻辑不需要改。
104
114
 
105
- ## 系统窗口(独立窗口)
115
+ ## 独立窗口(应用内,不依赖浏览器)
116
+
117
+ - **进入独立窗口**(0.11.0 起收在「分屏插件」二级菜单;早期版本为「在独立窗口打开」):在 DSH 应用内部打开一个只显示该会话的窗口,提供 **关闭 / 最小化 / 最大化-还原 / 全屏**;双击标题栏切换最大化,最小化后收成左下角的恢复胶囊。该会话已经在这个窗口里时,菜单显示 **退出独立窗口**;关闭窗口后菜单回到「进入独立窗口」。
118
+ - 打开时该会话会从分屏 / 浮窗 / 待分屏中移出,避免同一会话同时被两个输入框编辑;关闭独立窗口不会删除会话,它仍在侧栏里,可随时重新加入分屏。
119
+ - **为什么不是 Electron 原生窗口?** DSH Desktop 的 Electron 主进程只保留一个应用窗口,主窗口的 `setWindowOpenHandler` 拒绝用 `window.open` 创建第二个原生窗口(http/https 只交给系统浏览器);插件的 Host 进程是 Node 子进程,没有 Electron `BrowserWindow` API。所以 0.10.0 把这一层做成**应用内独立窗口**(不再打开浏览器、没有地址栏,窗口控制由插件自己绘制);macOS 上另见下一节的「系统窗口」,用系统 WebView 实现真正的独立窗口。
120
+ - 限制:它仍在 DSH 主窗口内部(不是操作系统级第二窗口),不能拖到 DSH 窗口之外。
121
+
122
+ ## 系统窗口(macOS 原生独立窗口,0.11.0)
123
+
124
+ - 右键会话 → **分屏插件** → **进入系统窗口**:在 macOS 上打开一个**真正的操作系统窗口**。它不是 DSH 主窗口里的一层浮层,可以拖到主窗口之外、单独缩放和关闭,不会打开浏览器,也没有地址栏。该会话的系统窗口已经打开时,菜单显示 **退出系统窗口**;在窗口里点关闭(或从菜单退出)后,菜单会自动回到「进入系统窗口」。
125
+ - 窗口内容仍然是这个会话的真实客户端:**左侧栏不显示**(会话占满窗口),**右侧栏、对话头部、输入框、视图页等都照常保留**,右上角的「打开右侧边栏」依然可用。
126
+ - **实现方式**:DSH 没有向插件开放 Electron `BrowserWindow`,所以插件 Host 用系统自带的 AppKit `NSWindow` + `WKWebView`(`osascript` 运行 `native/system-window.jxa`)打开窗口,并让这个 WebView 加载 Host 的**本机认证 Web 客户端**。认证 URL 由 Host 在进程内生成,只传给本机 Helper,**不会返回给渲染层**;哈希标记让同一份客户端代码在窗口内切换成「系统窗口模式」。
127
+ - **平台**:目前仅 macOS。Windows / Linux 上点击会提示改用「在独立窗口打开」,不会退回浏览器。窗口标题跟随会话标题;关闭窗口即结束 Helper 进程,退出 DSH 时也会一并关闭这些窗口。
128
+ - 窗口是辅助型进程,不占 Dock 图标,因此**没有最小化按钮**(避免最小化后无法从 Dock 恢复);提供关闭、缩放和标题栏拖动,可用「调度中心」或窗口本身切换。
129
+ - **注意**:系统窗口是独立的 Web 客户端,所以桌面端专属能力(如原生文件拖拽、系统目录选择器)在窗口内的行为以 Web 客户端为准;会话数据与主窗口共享同一个 Host,输入、流式输出和右侧栏功能正常。
130
+
131
+ ![系统窗口:不再显示左侧栏,右侧栏与对话区照常保留](https://raw.githubusercontent.com/mhlywxl/dsh-split-workspace/main/docs/screenshots/system-window.png)
132
+
133
+ ## 系统设置入口
134
+
135
+ 除了侧边栏底部的分屏按钮,插件还在 **设置 → 分屏工作区** 注册了一个设置页(`settings.section`),方便在菜单不可见时进入。页面包括:
106
136
 
107
- - 右键会话 → **在系统窗口打开**:插件通过宿主生成已认证的 DSH Web 地址,并在**系统默认浏览器**中打开一个新窗口;窗口里只渲染这个会话(DSH 侧栏等界面被隐藏),关闭、最小化、双击标题栏放大、全屏都由系统窗口原生提供。
108
- - 打开时该会话会从分屏 / 浮窗 / 待分屏中移出,避免同一会话同时被两个输入框编辑;关闭系统窗口不会删除会话,它仍在侧栏里,可随时重新加入分屏。
109
- - 窗口页头双击可进入 / 退出页面全屏(页头的 ⛶ 按钮相同);窗口标题会同步会话标题。
110
- - **为什么是浏览器窗口?** DSH Desktop 的 Electron 主进程只保留一个应用窗口,主窗口的 `setWindowOpenHandler` 拒绝用 `window.open` 创建第二个原生窗口(http/https 只交给系统浏览器);插件的 Host 进程是 Node 子进程,没有 Electron `BrowserWindow` API。因此当前 DSH 版本下,能真正位于 DSH 工作区之外、并具备系统窗口控制的方案就是由操作系统打开一个浏览器窗口。Web 版由 `window.open` 直接打开同样的独立窗口。
111
- - 限制:窗口带浏览器地址栏 / 标签页 UI,不是 DSH 原生第二窗口;如果未来 DSH 开放原生多窗口,这一层可以替换。
137
+ - **状态**:插件版本、窗格数、待分屏数、浮窗数、当前独立窗口。
138
+ - **性能模式**:开关(默认开启),影响动画、后台观察器和拖动缩略图。
139
+ - **操作**:添加分屏、退出分屏、最小化分屏、重置分屏、刷新界面、重启 DSH(桌面版)、帮助。
140
+
141
+ 设置页里的“添加分屏”会先关闭设置面板再打开多选弹框,避免弹框被设置面板遮挡;其余操作就地执行并实时刷新状态。
112
142
 
113
143
  ## 性能模式与卡顿排查
114
144
 
115
- 在侧边栏底部分屏按钮的菜单里点 **性能模式**(也可用 `window.__dshSplitWorkspace.setPerformanceMode(true)`,设置会持久化)。开启后:
145
+ **性能模式默认开启**(从 0.9.0 起;显式关过一次的保留关闭状态)。在侧边栏底部分屏按钮的菜单里点 **性能模式** 可切换(也可用 `window.__dshSplitWorkspace.setPerformanceMode(true/false)`,设置会持久化)。开启后:
116
146
 
117
147
  - 关闭所有窗格 / 浮窗 / 菜单 / 提示的动画、过渡、卡片阴影和焦点光晕,并停掉工具行跑马灯动画。
118
148
  - 关闭**每个窗格的 composer 几何测量 MutationObserver**。这是最可疑的开销之一:流式输出每个 token 都会改动窗格 DOM,旧逻辑会在每次改动时排队测量(`getBoundingClientRect` + 样式读取),窗格越多越明显;性能模式改为 ResizeObserver + 1.5s 轮询。
119
149
  - 暂停 TOC 握把同步(`dsh-prompt-history` 的 ☰ 定位)、压缩结果监听、浮窗位置巡检、右侧栏 800ms 轮询(保留 resize 监听),几何测量从 1s 降到 3.5s,侧栏会话扫描从 200ms 降到 1s。
120
- - 拖动窗格时不再克隆整段对话 DOM,只显示标题卡预览。
121
- - 真实会话、输入、停止、审批、分屏 / 浮窗 / 系统窗口功能全部保留。
150
+ - 拖动会话/窗格时**完全不渲染缩略图预览**(不克隆对话 DOM,也没有逐帧移动的预览窗口);拖入目标、布局预览和放置反馈仍然保留。
151
+ - 真实会话、输入、停止、审批、分屏 / 浮窗 / 独立窗口功能全部保留。
122
152
 
123
153
  **仍然可能卡的原因**:每个窗格都是一个完整的原生对话视图,N 个会话同时流式输出就是 N 份 React/DOM 渲染与滚动更新,这是 DSH 客户端本身的主要成本,插件无法消除(除非上游支持离屏暂停/虚拟化)。在 Windows + 低单核性能的机器上,建议同时保持 2–3 个活动窗格、少开浮窗、把不用的分屏最小化;输入框可切到紧凑 TUI 模式;如果装了 `dsh-prompt-history`,它的 TOC 同步在性能模式下会被暂停。
124
154
 
@@ -126,22 +156,32 @@ dsh --profile web
126
156
 
127
157
  ## 更新、重载与重启
128
158
 
129
- - DSH 桌面版的 profile **只在启动时应用插件/客户端变更**(插件管理器安装完会提示“请重启 DSH 使更改生效”)。刷新页面 / 重载界面**不能**加载新的插件 bundle:运行中更新会让该插件停在“等待重启”状态。
130
- - 更新后的正确操作:**退出 DSH 并重新打开**(Windows 从托盘 / 开始菜单彻底退出;macOS 用 ⌘Q)。
131
- - 本插件会尽量提醒:从 0.8.0 起,运行中的宿主会读取磁盘上的 `package.json`;一旦发现版本比当前页面新,右下角出现 **“已安装 vX,请重启 DSH 后生效”**,点 **知道了** 可关闭该版本的提醒。首次安装时插件客户端尚未加载,只能按 DSH 插件管理器的提示重启。
132
- - 底部菜单的 **刷新界面** 只重新加载页面(适合浮层卡住、布局异常),不会应用插件更新;Web 版可以用它加载新的客户端 bundle。
133
- - Host 半边(新增 HTTP 路由等)同样需要完整重启 DSH。
159
+ DSH 0.2.x(含 Desktop 0.2.2-rc.3)带 HMR:新安装的插件会被热加载,重建后的客户端 bundle 也会自动替换,**大多数安装/更新不需要重启 DSH**。以下情况才需要重启:
160
+
161
+ - 插件管理器明确提示 `restart-required`(Host 半边、被链接包的宿主模块发生变化,或包目录被移动);
162
+ - 安装后侧边栏底部几秒内没有出现分屏图标(少数没有 HMR 的旧版 DSH)。
163
+
164
+ DSH **生产版没有内置的“重启”菜单项**(开发版才有 `Restart App and Host`)。从本插件的 0.9.0 起:
165
+
166
+ - 侧边栏底部 **分屏菜单 → 重启 DSH**:先确认(运行中的任务会中断),再由 Host 半调用系统级“退出并重新打开”(macOS 通过 AppleScript 正常退出,Windows 关闭窗口后终止进程并重启)。
167
+ - 检测到磁盘版本比页面新时,右下角的更新提示直接提供 **重启 DSH** 按钮;Web 版提供 **刷新页面**。
168
+ - 也可以用 `window.__dshSplitWorkspace.restartApp()`,或按老办法手动退出后重新打开:Windows 从托盘/开始菜单彻底退出,macOS 用 ⌘Q。
169
+ - 底部菜单的 **刷新界面** 只重新加载页面(适合浮层卡住、布局异常),不会应用需要重启的 Host 变化。
170
+ - 首次安装时插件客户端可能尚未加载,因此插件自身无法显示重启按钮;插件管理器会在安装结果里提示重启,按提示或手动退出重开即可。
171
+ - **安装后看不到分屏入口时,先尝试刷新页面而不是重启**:DSH Desktop 生产版没有页面刷新菜单,但自带 **开发者工具**(macOS `⌘⌥I`,Windows `Ctrl+Shift+I`,或菜单 View → Toggle Developer Tools);在开发者工具里点刷新按钮、按 `⌘R` / `F5`,或在 Console 执行 `location.reload()`,都会重新加载页面并取回最新的插件图,通常无需重启 DSH。仍不生效再完全退出重开。
134
172
 
135
173
  ## 功能
136
174
 
137
- - **侧边栏分屏菜单**:底部分屏按钮弹出「添加分屏 / 退出分屏 / 最小化分屏 / 重置分屏」,其中退出和最小化与顶部工具栏完全一致。
175
+ - **侧边栏分屏菜单**:底部分屏按钮弹出「添加分屏 / 退出分屏 / 最小化分屏 / 性能模式 / 刷新界面 / 重启 DSH / 分屏帮助 / 重置分屏」,其中退出和最小化与顶部工具栏完全一致,「分屏帮助」直接打开带截图的帮助卡片。
138
176
  - **多选添加分屏**:弹框可搜索、可多选;已分屏时默认勾选当前窗格,可取消或追加,按最终勾选结果分屏。
139
- - **会话右键集成**:原生右键菜单新增「加入分屏 / 退出分屏」,未分屏时先进入待分屏,满两个才分屏;退出到只剩一个自动退出分屏。
177
+ - **会话右键集成**:原生右键菜单新增「分屏插件」二级菜单,其中「加入分屏 / 退出分屏」按状态显示为同一个开关;未分屏时先进入待分屏,满两个才分屏,退出到只剩一个自动退出分屏。
140
178
  - **浮窗模式**:右键会话 → 「进入浮窗」,把会话变成可拖动、可缩放的独立窗口;标题栏 ⇲ 放回分屏、✕ 关闭,浮窗位置/大小/层叠顺序持久化。
141
179
  - **分屏 ⇄ 浮窗双向切换**:同一会话互斥存在于一种形态;进入浮窗自动移出分屏,回到分屏自动关闭浮窗。
142
- - **系统窗口**:右键会话 → 「在系统窗口打开」,在系统默认浏览器中打开只含该会话的独立窗口;原生关闭 / 最小化 / 最大化 / 全屏,打开时自动从分屏和浮窗移出。
143
- - **性能模式**:一键关闭动画、阴影、跑马灯和多个后台轮询/观察器,适合低配或 Windows 上多窗格卡顿的场景;设置持久化。
144
- - **更新提示 / 刷新界面**:检测到磁盘上的新版本时右下角提示「请重启 DSH 后生效」,分屏菜单提供「刷新界面」快捷入口(只刷新 UI,不应用插件更新)。
180
+ - **独立窗口(应用内)**:右键会话 → 「在独立窗口打开」,在应用内单独显示该会话,提供关闭 / 最小化 / 最大化 / 全屏;不打开浏览器,打开时自动从分屏和浮窗移出。
181
+ - **系统设置入口**:除了侧边栏底部分屏菜单,**设置 → 分屏工作区** 也提供同一组操作(添加 / 退出 / 最小化 / 重置分屏、性能模式、刷新、重启 DSH、帮助和状态)。
182
+ - **性能模式(默认开启)**:一键关闭动画、阴影、跑马灯和多个后台轮询/观察器,适合低配或 Windows 上多窗格卡顿的场景;设置持久化。性能模式下**不再渲染拖动会话时的缩略图预览**(拖入目标与放置反馈保留),可以再明显减少拖动时的 DOM/合成开销。
183
+ - **更新提示 / 重启 DSH / 刷新界面**:检测到磁盘上的新版本时右下角提示,并提供「重启 DSH」(桌面版)或「刷新页面」(Web 版);分屏菜单同时提供「刷新界面」与「重启 DSH」。
184
+ - **兜底分屏入口**:如果所在 DSH 布局没有渲染侧边栏 footer(或 footer 被隐藏),插件会在对话区左下角显示一个分屏按钮,保证菜单仍可打开。
145
185
  - **一键重置**:清空插件相关的 localStorage / sessionStorage、布局、崩溃保护和临时缓存,避免异常状态卡住分屏。
146
186
  - **不限数量的原生窗格**:没有四窗格上限,窗口放得下多少会话就能开多少。
147
187
  - **自动布局**:2 个窗格左右分栏,3 个呈 L 形,4 个田字 2×2,5 个以上按行优先的均衡网格排列。
@@ -181,10 +221,15 @@ dsh --profile web
181
221
  - `window.__dshSplitWorkspace.dockFloat(sessionId)`:把浮窗放回分屏(没有分屏时进入待分屏)。
182
222
  - `window.__dshSplitWorkspace.closeFloat(sessionId)`:关闭浮窗(不放回分屏)。
183
223
  - `window.__dshSplitWorkspace.floats()`:当前浮窗的会话 id 列表(按创建顺序)。
184
- - `window.__dshSplitWorkspace.openSystemWindow(sessionId)`:在系统窗口打开该会话(宿主生成已认证 URL)。
224
+ - `window.__dshSplitWorkspace.openSystemWindow(sessionId)`:在应用内独立窗口打开该会话(`openIndependentWindow` 是同一功能的别名)。
225
+ - `window.__dshSplitWorkspace.openNativeWindow(sessionId)`:在 macOS 系统窗口(原生独立窗口)打开该会话;其他平台会提示不支持。
226
+ - `window.__dshSplitWorkspace.closeNativeWindow(sessionId)`:关闭该会话的系统窗口。
227
+ - `window.__dshSplitWorkspace.nativeWindows()`:当前已打开系统窗口的会话 id 列表。
228
+ - `window.__dshSplitWorkspace.appWindow()`:当前独立窗口状态(`{ id, minimized, maximized }` 或 `null`)。
185
229
  - `window.__dshSplitWorkspace.setPerformanceMode(true/false)`:开关性能模式(持久化)。
186
230
  - `window.__dshSplitWorkspace.performanceMode()`:当前是否处于性能模式。
187
- - `window.__dshSplitWorkspace.reloadClient()`:刷新页面(桌面版不会加载新的插件 bundle,更新需重启 DSH)。
231
+ - `window.__dshSplitWorkspace.reloadClient()`:刷新页面。
232
+ - `window.__dshSplitWorkspace.restartApp()`:退出并重新打开 DSH 桌面版(需要完整重启时使用)。
188
233
  - `window.__dshSplitWorkspace.pending()`:当前待分屏的会话 id。
189
234
  - `window.__dshSplitWorkspace.openAddSplitDialog()`:打开多选添加分屏弹框。
190
235
  - `window.__dshSplitWorkspace.arrange("auto")`:重新适配自动布局(旧模式名会被接受并忽略)。
@@ -215,8 +260,9 @@ dsh --profile web
215
260
  | `13-drag-bridge` | 未激活时的拖入分屏桥 |
216
261
  | `14-launcher` | 底部菜单、多选添加分屏弹框、会话菜单集成 |
217
262
  | `15-float-window` | 浮窗组件与图层 |
218
- | `16-standalone` | 系统窗口独立页 |
263
+ | `16-standalone` | 应用内独立窗口组件、窗口层与恢复胶囊,以及系统窗口的模式切换与请求 |
219
264
  | `17-api-apply` | `window.__dshSplitWorkspace` API、`apply()` 与导出 |
265
+ | `native/system-window.jxa` | macOS 系统窗口 Helper(AppKit `NSWindow` + `WKWebView`,由 Host 通过 `osascript` 启动) |
220
266
 
221
267
  - `npm run build`:重新生成 `lib/client.js`;`npm test` 会先跑 `build:check`,源码/产物不一致会失败。
222
268
  - 为什么不用打包器:DSH 客户端只加载一个 `<plugin>/client.js`,片段共享同一个 module-loader 闭包,按顺序拼接即可;这样发布包保持零依赖、无构建依赖。
@@ -244,7 +290,7 @@ will land:
244
290
  - 没有窗格数量上限;持久化树会校验(会话唯一、深度),损坏的树会被丢弃,而不是恢复一个坏掉的工作区。
245
291
  - 「浮窗」是应用内窗口,不是 Electron 原生第二窗口:DSH Desktop 主窗口禁用了 `window.open`,Web 客户端也没有会话深链;浮窗复用真实会话组件、可拖动缩放,但仍在 DSH 主窗口内渲染(详见上面的「为什么浮窗不是系统级独立窗口?」)。
246
292
  - 浮窗和分屏窗格互斥;同一会话不会同时以两种形态渲染,避免共享编辑器冲突。
247
- - 「系统窗口」当前由系统默认浏览器承载(DSH Desktop 拒绝插件创建第二个原生窗口,Host 进程也没有 Electron 窗口 API),因此带浏览器地址栏;系统窗口内的会话同样互斥于分屏和浮窗。
293
+ - 「独立窗口」是应用内窗口:它不打开浏览器、没有地址栏,但不能移出 DSH 主窗口。macOS 桌面版另提供「系统窗口打开」(系统 WebView,独立窗口);DSH 本身仍未向插件开放 Electron `BrowserWindow`。独立窗口内的会话同样互斥于分屏和浮窗。
248
294
  - 持久化递归深度上限为 32 层,是为了手改数据时的栈安全,不是窗格上限。
249
295
  - 隐藏的原生会话仍在遮罩下流式运行;窗格重新挂载原生输入框,所以每个窗格自己的输入框拥有该会话的编辑器。
250
296
  - 窗格重命名拒绝空会话(原生重命名对话框同样如此)。
@@ -260,8 +306,15 @@ MIT。见 `THIRD-PARTY-NOTICES.md`。
260
306
 
261
307
  **Split screen for DeepSeek Harness (DSH) Desktop — open as many conversations
262
308
  as you need, side by side, stacked, or in a 2×2 / automatic grid.** Any
263
- conversation can also become a movable, resizable **floating window**, and the
264
- two modes switch back and forth at any time.
309
+ conversation can also become a movable, resizable **floating window**, switch
310
+ between the two modes at any time, move into an **in-app independent window**
311
+ (close / minimize / maximize / fullscreen), or — on macOS Desktop — open a real
312
+ **native OS window** (system WebView, no browser, no left sidebar) for one
313
+ conversation. The session menu's **Split plugin** submenu holds the
314
+ `Join split / Leave split` toggle together with all three window surfaces,
315
+ each showing **Exit …** while that surface is open.
316
+ Both the sidebar menu and the system **Settings** page expose the controls.
317
+ Version history: [CHANGELOG.md](CHANGELOG.md).
265
318
 
266
319
  `dsh-split-workspace` turns the DeepSeek Harness conversation area into a native
267
320
  multi-pane workspace, including in the **Desktop app** (`dsh-app://` shell). Each
@@ -270,11 +323,13 @@ attachments, `/` commands, `ask_user_question`, approvals and view tabs.
270
323
 
271
324
  **中文简介**:把 DeepSeek Harness 的对话区拆成任意数量的原生窗格,支持左右分屏、
272
325
  上下分屏、田字 2×2 和自动网格;每个窗格都是真实会话,拥有自己的输入框、流式输出、
273
- 停止、队列、待办、附件、斜杠命令、审批和视图页。适用于 DSH 桌面端。
326
+ 停止、队列、待办、附件、斜杠命令、审批和视图页。适用于 DSH 桌面端;侧边栏菜单与
327
+ 系统设置均可操作,版本历史见 CHANGELOG。
274
328
 
275
329
  **Search terms / 搜索关键词**:split screen, split view, split pane, multi-pane,
276
330
  multi-session, multi-window, tiled workspace, unlimited panes, DSH Desktop,
277
- 分屏, 分屏插件, 多窗格, 多窗口, 多会话, 左右分屏, 上下分屏, 并排, 田字布局.
331
+ 分屏, 分屏插件, 多窗格, 多窗口, 多会话, 左右分屏, 上下分屏, 并排, 田字布局,
332
+ 系统窗口, 原生窗口, macOS system window, native window.
278
333
 
279
334
  The pane engine is derived from
280
335
  [dsh-split-screen](https://github.com/YEYEYEYESHIFU/dsh-split-screen) 1.7.0
@@ -323,7 +378,7 @@ dsh --profile web
323
378
 
324
379
  1. Open DSH Desktop → **Plugin market** in the sidebar, search for `dsh-split-workspace`, and install it. Or use **Plugins → Add plugin → Install a third-party plugin** and enter the package name.
325
380
  2. Open **Settings → Plugins** and enable `dsh-split-workspace`.
326
- 3. **Quit and reopen DSH Desktop completely** so the new client bundle is loaded.
381
+ 3. DSH's HMR normally loads a newly installed plugin immediately, so no restart is needed. If the split icon still does not appear in the sidebar footer after a few seconds, quit and reopen DSH Desktop completely (the plugin menu and update chip also offer **Restart DSH**).
327
382
 
328
383
  > The `desktop` profile is owned by the Electron app. Do **not** run `dsh plugin --profile desktop add ...` in a terminal; it is rejected. Use the in-app plugin market / Add plugin UI instead.
329
384
 
@@ -333,15 +388,15 @@ dsh --profile web
333
388
  2. DSH Desktop → **Plugins → Add plugin → Install a third-party plugin**:
334
389
  - prefer the **absolute path to the `.tgz`** (the installer recognises it as a tarball);
335
390
  - if that build only accepts directories, extract the `.tgz` and enter the extracted directory (its root must contain `package.json`).
336
- 3. Enable it in **Settings → Plugins**, then quit and reopen DSH Desktop.
391
+ 3. Enable it in **Settings → Plugins**; HMR usually loads it immediately. If the footer split icon does not appear, quit and reopen DSH Desktop, or use **Restart DSH** in the plugin menu.
337
392
  4. The offline machine needs no network access; the plugin makes no runtime requests.
338
393
 
339
394
  **Enable and verify**
340
395
 
341
- - **Settings → Plugins** must show `dsh-split-workspace` enabled. Restart Desktop completely, or restart `dsh web` and refresh the page for Web.
396
+ - **Settings → Plugins** must show `dsh-split-workspace` enabled. DSH 0.2.x hot-loads newly installed plugins through HMR; if the UI still does not appear, see “Updates, reload and restart”.
342
397
  - Entry points: the split icon in the sidebar footer (beside Settings), or drag a conversation from the sidebar onto the conversation column.
343
398
  - Run `window.__dshSplitWorkspace.health()` in the browser/desktop console to see the version, pane count and geometry.
344
- - If the split entry is missing: make sure at least two sessions exist, the plugin is not in safe mode, and re-check the enable/restart steps.
399
+ - If the split entry is missing: make sure the plugin is enabled and has no error. When the stock sidebar footer does not render this plugin's action, the plugin shows a fallback split button at the conversation area's bottom-left corner.
345
400
 
346
401
  **Start splitting**
347
402
 
@@ -354,7 +409,14 @@ dsh --profile web
354
409
  - **Reset split** clears the plugin's split-related localStorage / sessionStorage keys, the saved layout, the crash guard, the minimized flag and pane caches, so a split stuck by stale state can always start again (the performance-mode preference is kept).
355
410
  - Closing a pane (header **✕**) or leaving the split via the context menu exits the split as soon as fewer than two conversations remain: the whole pane tree and every conversation's split membership are cleared, so nothing is left tagged “in split” while unselected.
356
411
  - Right-click any conversation (or its row `⋯` button) → **Enter floating window** to detach it into a movable window. Drag its title bar to move it, drag any edge to resize, use **⇲ Dock to split** to put it back into a split, or **✕** to close the float. A conversation is never hosted in both modes: entering a float removes it from the split / pending split first.
357
- - Right-click a conversation → **Open in system window** to open it alone in a separate system window (the default browser on Desktop), with the window's native close / minimize / maximize / fullscreen controls.
412
+ - Right-click a conversation → **Open in independent window** to open it alone in an in-app window with close / minimize / maximize-restore / fullscreen controls — no browser is opened.
413
+
414
+ ### Usage help (screenshots)
415
+
416
+ The in-app **Split help** card now carries three annotated screenshots — the
417
+ session right-click menu, the bottom-left split button menu, and Settings →
418
+ Split workspace — with click-to-enlarge thumbnails. The Host serves them
419
+ same-origin from `docs/screenshots/` under `/dsv/help/...`.
358
420
 
359
421
  ### Floating windows
360
422
 
@@ -401,32 +463,43 @@ inside the same DSH page. If DSH later exposes native multi-window support, the
401
463
  float layer can be swapped for real windows while the split⇄float switching
402
464
  logic stays unchanged.
403
465
 
404
- ### System window
466
+ ### Independent window (in-app, no browser)
405
467
 
406
- - Right-click a conversation → **Open in system window**: the Host plugin mints
407
- an authenticated DSH Web URL and opens it in a **separate system window**
408
- (the OS default browser on Desktop). The page renders that one conversation
409
- only; close / minimize / double-click-title-bar maximize / fullscreen are the
410
- native window's own controls.
468
+ - Right-click a conversation → **Open in independent window**: it opens inside
469
+ the DSH application as a window that shows only that conversation, with
470
+ **close / minimize / maximize-restore / fullscreen**. Double-click the title
471
+ bar toggles maximize; minimizing leaves a restore chip at the bottom-left.
411
472
  - Opening it detaches the conversation from the split / float / pending pick, so
412
- one conversation is never edited through two composers. Closing the system
413
- window keeps the conversation — it stays in the sidebar and can rejoin a split.
414
- - Double-click the page header (or use its ⛶ button) to toggle page fullscreen;
415
- the window title follows the conversation title.
416
- - **Why a browser window?** The DSH Desktop Electron main process keeps a single
417
- application window and its `setWindowOpenHandler` refuses `window.open`
473
+ one conversation is never edited through two composers. Closing the window
474
+ keeps the conversation — it stays in the sidebar and can rejoin a split.
475
+ - **Why not a native OS window?** The DSH Desktop Electron main process keeps a
476
+ single application window and its `setWindowOpenHandler` refuses `window.open`
418
477
  (http/https is handed to the system browser); the plugin Host runs in a Node
419
- child process with no Electron `BrowserWindow` API. A browser window is
420
- therefore the only real OS window with native window controls that a plugin
421
- can open today. In Web mode `window.open` opens the same standalone window.
422
- - Limitation: the window carries browser chrome (address bar / tabs); it is not
423
- a second DSH-native window. If DSH later exposes native multi-window support,
424
- this layer can be replaced.
478
+ child process with no Electron `BrowserWindow` API. Current DSH exposes no
479
+ plugin-facing native multi-window API, so the 0.8.0 “system window” had to use
480
+ the browser. 0.10.0 replaces it with an **in-app independent window**: no
481
+ browser, no address bar, all window controls drawn by the plugin.
482
+ - Limitation: it stays inside the DSH main window (not an OS-level second
483
+ window) and cannot be dragged outside it. If DSH later exposes native
484
+ multi-window support, this layer can become a real system window without
485
+ changing the conversation-switching logic.
486
+
487
+ ### Settings entry
488
+
489
+ Besides the sidebar-footer split button, the plugin registers a **Settings → Split workspace** page (`settings.section`) so the controls remain reachable when the footer entry is hidden. The page shows:
490
+
491
+ - **Status**: plugin version, pane count, pending split, floating windows, and the current independent window.
492
+ - **Performance mode**: the persisted switch (on by default) for animations, background observers and the drag preview.
493
+ - **Actions**: add split, exit split, minimize split, reset split, refresh interface, restart DSH (Desktop), help.
494
+
495
+ “Add split” closes the Settings panel before opening the multi-select dialog so the dialog is never hidden behind it; the other actions run in place and refresh the status live.
425
496
 
426
497
  ### Performance mode and lag analysis
427
498
 
428
- Open the sidebar-footer split menu and pick **Performance mode** (or run
429
- `window.__dshSplitWorkspace.setPerformanceMode(true)`; it persists). It turns off:
499
+ **Performance mode is ON by default** since 0.9.0 (an explicit off choice is
500
+ kept). Open the sidebar-footer split menu and pick **Performance mode**, or run
501
+ `window.__dshSplitWorkspace.setPerformanceMode(true/false)`; it persists. It
502
+ turns off:
430
503
 
431
504
  - every pane / float / menu / chip animation, transition, card shadow, focus
432
505
  glow and running-row shimmer;
@@ -438,7 +511,9 @@ Open the sidebar-footer split menu and pick **Performance mode** (or run
438
511
  position polling and the 800 ms right-sidebar poll (resize listeners stay);
439
512
  geometry polling drops from 1 s to 3.5 s and sidebar session scraping from
440
513
  200 ms to 1 s;
441
- - pane-drag previews no longer clone the conversation DOM — only the title card.
514
+ - the floating drag-preview thumbnail for sessions and panes is not rendered at
515
+ all — no DOM clone, no per-frame thumbnail positioning; drop targets and the
516
+ layout reflow hole still work.
442
517
 
443
518
  Real conversations, composers, approval flows, split/float/system-window
444
519
  features all stay available.
@@ -454,21 +529,37 @@ compare DevTools Performance long tasks with the mode on/off.
454
529
 
455
530
  ### Updates, reload and restart
456
531
 
457
- - A DSH Desktop profile **applies plugin/client changes only at startup** (the
458
- plugin manager says “restart DSH to apply”). Refreshing the page / reloading
459
- the interface **cannot** load a new plugin bundle: updating while running
460
- parks the plugin in a restart-required state.
461
- - The correct update step is to **quit DSH completely and reopen it** (Windows:
462
- exit from the tray/Start menu; macOS: ⌘Q).
463
- - The plugin reminds you when it can: from 0.8.0 the running Host reads the
464
- on-disk `package.json`, and when it sees a version newer than the page it
465
- shows “Version vX is installed — restart DSH to apply” with **Got it** to
466
- dismiss that version. A fresh install cannot show this because the plugin
467
- client is not loaded yet — follow the built-in manager notice and restart.
468
- - The launcher's **Refresh interface** only reloads the page (useful for a stuck
469
- overlay or layout glitch); it does not apply plugin updates. In the Web
470
- profile it does load a new client bundle.
471
- - Host-half changes (new HTTP routes, etc.) also require a full DSH restart.
532
+ DSH 0.2.x (including Desktop 0.2.2-rc.3) ships HMR: a newly installed plugin is
533
+ hot-loaded, and a rebuilt client bundle is swapped into the open page. Most
534
+ installs/updates therefore need **no restart**. A restart is only needed when:
535
+
536
+ - the plugin manager reports `restart-required` (Host-half or linked-package
537
+ host modules changed, or the package directory moved);
538
+ - the footer split icon still has not appeared a few seconds after install (some
539
+ older DSH builds without HMR).
540
+
541
+ Production DSH has **no built-in Restart menu item** (development builds do).
542
+ Since dsh-split-workspace 0.9.0:
543
+
544
+ - **Split menu → Restart DSH** confirms first (running tasks are interrupted),
545
+ then the Host half closes and reopens the desktop app at the OS level (a
546
+ normal AppleScript quit on macOS; close-then-terminate and relaunch on
547
+ Windows).
548
+ - The update chip offers **Restart DSH** on Desktop and **Reload page** in the
549
+ Web GUI.
550
+ - `window.__dshSplitWorkspace.restartApp()` does the same. Manually: Windows —
551
+ quit from the tray/Start menu; macOS — ⌘Q; then open DSH again.
552
+ - **Refresh interface** only reloads the page (useful for a stuck overlay or a
553
+ layout glitch); it does not apply changes that need a full restart.
554
+ - On a first install the plugin client is not running yet, so it cannot show
555
+ its own restart button; follow the plugin manager's restart notice or quit
556
+ and reopen DSH manually.
557
+ - **If the split entry is missing after a hot install, try a page reload before a
558
+ restart**: production DSH has no Reload menu item, but it ships Developer
559
+ Tools (macOS `⌘⌥I`, Windows `Ctrl+Shift+I`, or View → Toggle Developer Tools).
560
+ Use the reload button in Developer Tools, press `⌘R` / `F5`, or run
561
+ `location.reload()` in its Console to reload the page and fetch the current
562
+ plugin graph — usually no DSH restart is needed. Quit and reopen only if that still fails.
472
563
 
473
564
  ### Features
474
565
 
@@ -477,9 +568,11 @@ compare DevTools Performance long tasks with the mode on/off.
477
568
  - **Session-menu integration** — the stock right-click menu gains Add to split / Leave split. Outside split mode the first pick waits in a pending split until a second conversation is added; removing down to one pane exits the split.
478
569
  - **Floating windows** — right-click a conversation → Enter floating window turns it into a movable, resizable window; Dock to split / ✕ in its header switch it back or close it, and geometry persists.
479
570
  - **Split ⇄ float switching** — one conversation lives in exactly one mode; entering a float detaches it from the split, docking it back closes the float.
480
- - **System window** — right-click → Open in system window opens the conversation alone in a separate OS window (the default browser on Desktop) with native close / minimize / maximize / fullscreen; it is detached from split and float first.
481
- - **Performance mode** — one switch drops animations, shadows, shimmer and several background observers/polls for low-power or laggy Windows machines; the setting persists.
482
- - **Update chip / refresh interface** — a newer on-disk version shows a corner chip asking for a DSH restart, and the split menu offers Refresh interface (UI reload only, not a plugin update).
571
+ - **Independent window (in-app)** — right-click → Open in independent window shows the conversation alone in an in-app window with close / minimize / maximize / fullscreen; no browser, and it is detached from split and float first.
572
+ - **Settings entry** — besides the sidebar-footer split menu, **Settings → Split workspace** offers the same actions (add / exit / minimize / reset split, performance mode, refresh, restart DSH, help and status).
573
+ - **Performance mode (on by default)** — one switch drops animations, shadows, shimmer and several background observers/polls for low-power or laggy Windows machines; the setting persists. In this mode the floating drag-preview thumbnail is not rendered at all (drop targets and placement feedback stay).
574
+ - **Update chip / Restart DSH / Refresh interface** — a newer on-disk version shows a corner chip with **Restart DSH** on Desktop or **Reload page** in the Web GUI; the split menu also offers Restart DSH and Refresh interface.
575
+ - **Fallback split entry** — when the host layout does not render the sidebar footer action (or hides it), the plugin shows a split button at the conversation area's bottom-left corner so the menu stays reachable.
483
576
  - **One-click reset** — wipes plugin localStorage/sessionStorage, layout, crash guard and temporary caches.
484
577
  - **Unlimited native panes** — no four-pane cap; add as many conversations as
485
578
  the window can show.
@@ -576,11 +669,15 @@ architecture the upstream plugin uses.
576
669
  - `window.__dshSplitWorkspace.floats()` — current floating-window session ids,
577
670
  in creation order.
578
671
  - `window.__dshSplitWorkspace.openSystemWindow(sessionId)` — open the
579
- conversation in a separate system window (Host-minted authenticated URL).
672
+ conversation in the app-internal independent window (`openIndependentWindow`
673
+ is an alias).
674
+ - `window.__dshSplitWorkspace.appWindow()` — current independent-window state
675
+ (`{ id, minimized, maximized }` or `null`).
580
676
  - `window.__dshSplitWorkspace.setPerformanceMode(true/false)` /
581
677
  `performanceMode()` — toggle/inspect the persisted performance mode.
582
- - `window.__dshSplitWorkspace.reloadClient()` — reload the page (on Desktop this
583
- does not load a new plugin bundle; restart DSH to update).
678
+ - `window.__dshSplitWorkspace.reloadClient()` — reload the page.
679
+ - `window.__dshSplitWorkspace.restartApp()` — close and reopen DSH Desktop
680
+ (for the rare changes that need a full restart).
584
681
  - `window.__dshSplitWorkspace.pending()` — conversations waiting for a second
585
682
  pick before the split starts.
586
683
  - `window.__dshSplitWorkspace.openAddSplitDialog()` — open the multi-select add
@@ -644,10 +741,11 @@ architecture the upstream plugin uses.
644
741
  same DSH page (see “Why not a real OS-level window?” above).
645
742
  - A conversation is either a split pane or a floating window — never both — so
646
743
  two composers can never share one session's editor.
647
- - The **system window** is currently hosted by the OS default browser (DSH
648
- Desktop refuses plugin-created native secondary windows and the Host process
649
- has no Electron window API), so it carries browser chrome; a conversation in
650
- a system window is likewise detached from split and float.
744
+ - The **independent window** is an in-app surface, not an OS-level second
745
+ window: DSH Desktop refuses plugin-created native windows and the Host process
746
+ has no Electron `BrowserWindow` API. It opens no browser and has no address
747
+ bar, but it cannot leave the DSH main window; a conversation in it is likewise
748
+ detached from split and float.
651
749
  - The persisted recursion depth is capped at 32 levels as a stack-safety guard
652
750
  for hand-edited payloads, not as a pane limit.
653
751
  - The hidden stock conversation still streams under the overlay; panes re-host