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 +107 -0
- package/README.md +182 -84
- package/docs/screenshots/help-footer-menu.png +0 -0
- package/docs/screenshots/help-session-menu.png +0 -0
- package/docs/screenshots/help-settings.png +0 -0
- package/docs/screenshots/system-window.png +0 -0
- package/lib/client.js +1048 -146
- package/lib/index.js +359 -94
- package/native/system-window.jxa +91 -0
- package/package.json +4 -2
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.
|
|
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. 在 **设置 → 插件**
|
|
62
|
+
3. 在 **设置 → 插件** 启用;通常会被 HMR 立即加载。若侧边栏底部没有出现分屏图标,完全退出并重开 DSH Desktop,或使用插件菜单里的「重启 DSH」。
|
|
63
63
|
4. 离线机器不需要网络;插件运行时不联网。
|
|
64
64
|
|
|
65
65
|
### 启用与验证
|
|
66
66
|
|
|
67
|
-
- 打开 **设置 → 插件**,确认 `dsh-split-workspace`
|
|
67
|
+
- 打开 **设置 → 插件**,确认 `dsh-split-workspace` 已启用。DSH 0.2.x 会通过 HMR 热加载新安装的插件;如果没有出现界面,见下方「更新、重载与重启」。
|
|
68
68
|
- 分屏入口:点击侧边栏底部(设置旁)的分屏图标,或把侧边栏里的会话拖到对话区。
|
|
69
69
|
- 打开浏览器/桌面端控制台执行 `window.__dshSplitWorkspace.health()`,可看到版本、窗格数和几何状态。
|
|
70
|
-
-
|
|
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-footer-menu.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
|
+

|
|
132
|
+
|
|
133
|
+
## 系统设置入口
|
|
134
|
+
|
|
135
|
+
除了侧边栏底部的分屏按钮,插件还在 **设置 → 分屏工作区** 注册了一个设置页(`settings.section`),方便在菜单不可见时进入。页面包括:
|
|
106
136
|
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
|
|
111
|
-
|
|
137
|
+
- **状态**:插件版本、窗格数、待分屏数、浮窗数、当前独立窗口。
|
|
138
|
+
- **性能模式**:开关(默认开启),影响动画、后台观察器和拖动缩略图。
|
|
139
|
+
- **操作**:添加分屏、退出分屏、最小化分屏、重置分屏、刷新界面、重启 DSH(桌面版)、帮助。
|
|
140
|
+
|
|
141
|
+
设置页里的“添加分屏”会先关闭设置面板再打开多选弹框,避免弹框被设置面板遮挡;其余操作就地执行并实时刷新状态。
|
|
112
142
|
|
|
113
143
|
## 性能模式与卡顿排查
|
|
114
144
|
|
|
115
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
130
|
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
|
|
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
|
-
-
|
|
144
|
-
-
|
|
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)
|
|
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()
|
|
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
|
-
-
|
|
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**,
|
|
264
|
-
two modes
|
|
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.
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
###
|
|
466
|
+
### Independent window (in-app, no browser)
|
|
405
467
|
|
|
406
|
-
- Right-click a conversation → **Open in
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
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
|
|
413
|
-
|
|
414
|
-
-
|
|
415
|
-
|
|
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.
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
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
|
-
|
|
429
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
-
|
|
462
|
-
|
|
463
|
-
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
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
|
-
- **
|
|
481
|
-
- **
|
|
482
|
-
- **
|
|
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
|
|
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
|
|
583
|
-
|
|
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 **
|
|
648
|
-
Desktop refuses plugin-created native
|
|
649
|
-
has no Electron
|
|
650
|
-
|
|
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
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|