xrkh-better-sidebar 0.20.0 → 0.20.1
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/README.md +238 -240
- package/README_EN.md +230 -233
- package/lib/client-editor.js +216 -300
- package/lib/client-mermaid.js +216 -300
- package/lib/client-registry.js +2694 -4166
- package/lib/client-terminal.js +219 -303
- package/lib/client.js +2695 -4167
- package/lib/types/client/chunk-loader.d.ts +3 -3
- package/lib/types/client/intercept.d.ts +17 -43
- package/lib/types/client/locales.d.ts +0 -4
- package/lib/types/client/openpath-intercept.d.ts +9 -8
- package/lib/types/client/plugins-viewers.d.ts +0 -1
- package/lib/types/client/produced-files.d.ts +0 -75
- package/package.json +1 -1
- package/src/client/FileTree.tsx +822 -807
- package/src/client/builtins/viewers.tsx +154 -162
- package/src/client/chunk-loader.ts +350 -350
- package/src/client/index.tsx +379 -390
- package/src/client/intercept.tsx +79 -239
- package/src/client/locales-ar.ts +0 -4
- package/src/client/locales-de.ts +0 -4
- package/src/client/locales-fr.ts +0 -4
- package/src/client/locales-hi.ts +0 -4
- package/src/client/locales-id.ts +0 -4
- package/src/client/locales-it.ts +0 -4
- package/src/client/locales-ja.ts +0 -4
- package/src/client/locales-ko.ts +0 -4
- package/src/client/locales-nl.ts +0 -4
- package/src/client/locales-pl.ts +0 -4
- package/src/client/locales-pt.ts +0 -4
- package/src/client/locales-ru.ts +0 -4
- package/src/client/locales-sv.ts +0 -4
- package/src/client/locales-th.ts +0 -4
- package/src/client/locales-tr.ts +0 -4
- package/src/client/locales-vi.ts +0 -4
- package/src/client/locales-zh-HK.ts +0 -4
- package/src/client/locales-zh-MO.ts +0 -4
- package/src/client/locales-zh-TW.ts +0 -4
- package/src/client/locales.ts +0 -8
- package/src/client/openpath-intercept.ts +84 -79
- package/src/client/plugins-viewers.ts +15 -7
- package/src/client/produced-files.ts +21 -285
- package/lib/types/client/OfficePreview.d.ts +0 -27
- package/lib/types/client/office/docx.d.ts +0 -16
- package/lib/types/client/office/pptx.d.ts +0 -26
- package/lib/types/client/office/shared.d.ts +0 -32
- package/lib/types/client/office/xlsx.d.ts +0 -20
- package/lib/types/client/office/xml.d.ts +0 -72
- package/lib/types/client/office/zip.d.ts +0 -34
- package/src/client/OfficePreview.tsx +0 -276
- package/src/client/office/docx.ts +0 -92
- package/src/client/office/pptx.ts +0 -131
- package/src/client/office/shared.ts +0 -72
- package/src/client/office/xlsx.ts +0 -147
- package/src/client/office/xml.ts +0 -225
- package/src/client/office/zip.ts +0 -321
package/README.md
CHANGED
|
@@ -1,240 +1,238 @@
|
|
|
1
|
-
# xrkh-better-sidebar
|
|
2
|
-
|
|
3
|
-
> **读者**:XRK-Harness 终端用户 · 集成者
|
|
4
|
-
|
|
5
|
-
XRK-Harness(`xrkh`)标准侧边栏插件:资源管理器 · 编辑器 · 终端 · Git · 浏览器等工作台,按会话隔离。
|
|
6
|
-
Host 侧 `/sidebar/*` 由产品 Host 原生挂载(`createSidebarPublicHandler`);本包提供 **client 半包**。`src/index.ts` 的 Cordis host 半包仅供非 XRKH 的 Cordis profile;**不要**在 XRKH 上再挂 host 抢同一前缀。
|
|
7
|
-
|
|
8
|
-
## 安装
|
|
9
|
-
|
|
10
|
-
前置:`xrkh web` 或 `npx @xrkseek/harness-cli web`,Node ≥ 26。建议 Host **≥ 0.3.4**。推荐从 **npmjs** 安装:
|
|
11
|
-
|
|
12
|
-
```bash
|
|
13
|
-
xrkh plugin add xrkh-better-sidebar@0.20.
|
|
14
|
-
xrkh restart
|
|
15
|
-
```
|
|
16
|
-
|
|
17
|
-
装完硬刷新浏览器(Ctrl+Shift+R)。
|
|
18
|
-
|
|
19
|
-
源码路径仍可用(非推荐):`git clone git@github.com:xrkseek/xrkh-better-sidebar.git` 后 `xrkh plugin add ./xrkh-better-sidebar`。
|
|
20
|
-
|
|
21
|
-
## 0.20.
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
-
|
|
69
|
-
|
|
70
|
-
-
|
|
71
|
-
|
|
72
|
-
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
128
|
-
-
|
|
129
|
-
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
-
|
|
156
|
-
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
-
|
|
182
|
-
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
-
|
|
218
|
-
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
|
225
|
-
|
|
226
|
-
|
|
|
227
|
-
|
|
|
228
|
-
|
|
|
229
|
-
|
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
pnpm bundle
|
|
240
|
-
```
|
|
1
|
+
# xrkh-better-sidebar
|
|
2
|
+
|
|
3
|
+
> **读者**:XRK-Harness 终端用户 · 集成者
|
|
4
|
+
|
|
5
|
+
XRK-Harness(`xrkh`)标准侧边栏插件:资源管理器 · 编辑器 · 终端 · Git · 浏览器等工作台,按会话隔离。
|
|
6
|
+
Host 侧 `/sidebar/*` 由产品 Host 原生挂载(`createSidebarPublicHandler`);本包提供 **client 半包**。`src/index.ts` 的 Cordis host 半包仅供非 XRKH 的 Cordis profile;**不要**在 XRKH 上再挂 host 抢同一前缀。
|
|
7
|
+
|
|
8
|
+
## 安装
|
|
9
|
+
|
|
10
|
+
前置:`xrkh web` 或 `npx @xrkseek/harness-cli web`,Node ≥ 26。建议 Host **≥ 0.3.4**。推荐从 **npmjs** 安装:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
xrkh plugin add xrkh-better-sidebar@0.20.1
|
|
14
|
+
xrkh restart
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
装完硬刷新浏览器(Ctrl+Shift+R)。
|
|
18
|
+
|
|
19
|
+
源码路径仍可用(非推荐):`git clone git@github.com:xrkseek/xrkh-better-sidebar.git` 后 `xrkh plugin add ./xrkh-better-sidebar`。
|
|
20
|
+
|
|
21
|
+
## 0.20.1
|
|
22
|
+
|
|
23
|
+
- OOXML 高保真预览外置为独立包 `xrkh-better-sidebar-plugin-office`(AGPL);本包仅保留 `office-legacy` 下载兜底。
|
|
24
|
+
- Side card →「添加预览插件」推荐目录收录 office 安装命令。
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
xrkh plugin add xrkh-better-sidebar-plugin-office@0.1.0
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 0.20.0
|
|
31
|
+
|
|
32
|
+
### Office 文档预览(独立插件)
|
|
33
|
+
|
|
34
|
+
高保真 `.docx` / `.xlsx` / `.pptx` 预览由独立包
|
|
35
|
+
`xrkh-better-sidebar-plugin-office` 提供(docx-preview / Univer /
|
|
36
|
+
`@aiden0z/pptx-renderer`),通过 `ctx.betterSidebar.registerFileViewer`
|
|
37
|
+
注册,不进本包 client bundle。安装:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
xrkh plugin add xrkh-better-sidebar-plugin-office@0.1.0
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
或源码:`xrkh plugin add ./extensions/xrkh-better-sidebar-plugin-office`。
|
|
44
|
+
|
|
45
|
+
未安装时,OOXML 与旧格式(`.doc/.xls/.ppt` / ODF / RTF)一律走本包
|
|
46
|
+
`office-legacy` 下载兜底。Side card →「添加预览插件」也可一键复制安装命令。
|
|
47
|
+
|
|
48
|
+
### 图片预览缩放
|
|
49
|
+
|
|
50
|
+
- 图片预览支持 **Ctrl/⌘ + 滚轮** 以光标为中心缩放,拖拽平移,双击在「适应」
|
|
51
|
+
和 2x 之间切换,工具栏有「适应 / 100% / 下载」与实时百分比;`+` `-` `0` 快捷键。
|
|
52
|
+
- 修复:React 17+ 把 `wheel` 注册为 passive listener,合成 `onWheel` 的
|
|
53
|
+
`preventDefault()` 无效——Ctrl+滚轮会连带把整个应用页面一起缩放。改用原生
|
|
54
|
+
`{ passive: false }` 监听抑制页面级缩放。
|
|
55
|
+
- 缩放走 CSS `transform`(不触发布局),平移有 3px 阈值判定,避免误点击把图拖走。
|
|
56
|
+
|
|
57
|
+
### 文件树「在文件夹中显示」可见反馈
|
|
58
|
+
|
|
59
|
+
- 修复「点了没反应」:右键菜单能正常弹出(实测过),但 reveal/open 的失败
|
|
60
|
+
被 catch 成 `console.error`,界面上零反馈。Host 侧 Windows 走
|
|
61
|
+
`explorer.exe /select` 时也可能静默失败。现在失败会以可点击关闭的 notice
|
|
62
|
+
显示在树上,不再静默吞掉。
|
|
63
|
+
|
|
64
|
+
### 文件树文件操作(新建 / 重命名 / 删除)
|
|
65
|
+
|
|
66
|
+
- Host 早已提供 `fs.mkdir` / `fs.delete`,但客户端此前完全没接——右键菜单里
|
|
67
|
+
根本没有这些项,只能看不能管。本轮接上并补齐 UI:
|
|
68
|
+
- 目录右键:新建文件 / 新建文件夹;文件右键:重命名 / 删除(删除为危险项,
|
|
69
|
+
带名称确认)。
|
|
70
|
+
- 取消 prompt 或留空名是 no-op,不会误创建 `dir/`;重命名同名也是 no-op。
|
|
71
|
+
- 所有失败(权限 / 越界 / 占用)走同一条可见 notice,不静默。
|
|
72
|
+
- `fs.rename` 用「读字节 → 写入新路径 → 删源」实现,复用已有路由承载的
|
|
73
|
+
workspace fence,不为这一个功能给 Host 加新动词。
|
|
74
|
+
|
|
75
|
+
### 其它
|
|
76
|
+
|
|
77
|
+
- 新增 `IconOfficeOutline16` 文件预览图标;OOXML 高保真预览外置为
|
|
78
|
+
`xrkh-better-sidebar-plugin-office`,本包保留 `office-legacy` 下载兜底。
|
|
79
|
+
- i18n:20 个语言字典补齐本轮全部新键(image* / office* / openExternalFailed /
|
|
80
|
+
newFolder / rename / delete 等)。
|
|
81
|
+
- 新增/更新测试:图片缩放 10 例、Office 组件 8 例、文件操作 10 例、OOXML 解析
|
|
82
|
+
34 例(含真实 LibreOffice/pptx 文件验证,缺 fixture 时自动跳过)。全量测试
|
|
83
|
+
未引入任何回归(基线红/绿保持一致)。
|
|
84
|
+
|
|
85
|
+
## 0.19.5
|
|
86
|
+
|
|
87
|
+
- 修复底栏偶发空白(拖侧栏才出现):未测到中心列时 `left+right` 回退成零宽;改走 `--xrkh-center-*`,未测到前右侧回退为 workbench + Overview inset
|
|
88
|
+
|
|
89
|
+
## 0.19.4
|
|
90
|
+
|
|
91
|
+
- 重新发布:npm 上 0.19.3 卡在 staged 未公开(E409),内容与 0.19.3 相同
|
|
92
|
+
|
|
93
|
+
## 0.19.3
|
|
94
|
+
|
|
95
|
+
- 修复拖动 Host **概况** 时工作台 toggle 集群不跟手:跟 `details inset + workbench width` 停在主列右缘;拖拽中关闭 `right` 缓动
|
|
96
|
+
- 删除已无消费者的 `data-*-sidebar-collapsed` body 标记与钉死视口右上角的冗余路径
|
|
97
|
+
|
|
98
|
+
## 0.19.2
|
|
99
|
+
|
|
100
|
+
- 重新发布:npm 上 0.19.1 卡在 staged 未公开(E409),内容与 0.19.1 相同
|
|
101
|
+
|
|
102
|
+
## 0.19.1
|
|
103
|
+
|
|
104
|
+
- 修复内部 SIDEBAR_SERVICE_VERSION 仍报 0.18.32 的疏漏(功能与 0.19.0 相同;npm 0.19.0 包内版本串未对齐)
|
|
105
|
+
|
|
106
|
+
## 0.19.0
|
|
107
|
+
|
|
108
|
+
- 完善右侧工作台与 Host **概况(Overview)** 共存:toggle 集群始终按 `details inset + workbench width` 停在**主对话列右缘**,不再叠在概况顶栏
|
|
109
|
+
- 完善展开/收起过渡:与 Host shell 共用 motion 时长与缓动;会话顶栏为 toggle 预留的 padding 跟随概况开合
|
|
110
|
+
- 建议搭配 **XRK-Harness ≥ 0.5.9**(LayoutInsets / 概况 inset 契约)
|
|
111
|
+
|
|
112
|
+
## 0.18.30
|
|
113
|
+
|
|
114
|
+
(相对未落地的 0.18.29:同批修复。npm 上 0.18.29 卡在 staged 未公开,以本号为准。)
|
|
115
|
+
|
|
116
|
+
- 修复对话尾部文件行整个 slot 渲染崩溃(`Cannot read properties of undefined (reading 'modified')`)。**0.18.27 回归**:三条 lane 改造时把组件 prop 从宿主契约名 `matched` 改成了 `lanes`;ui-slots chain 始终把 selector 返回值注入为 `matched`(`ChainEntryProps`),同槽的 `@xrkseek/client-ui-deliverables` 也按 `matched` 读。改名后组件拿到 `undefined`
|
|
117
|
+
- 组件侧:只认 `matched`;用 `isFileLanes` 校验形状;缺失/坏形状时从宿主一并展开的 owner 字段重算 lanes,不再直接读 `.modified`
|
|
118
|
+
- 与宿主 Diff 卡共存:本轮已有 `workspace/changes` 卡时(按 closing `seq`,对齐宿主 `changesForClosing`)主动放弃 takeover,避免盖住 ChangedFiles;文件打开仍走 `workspaces.openPath` 拦截
|
|
119
|
+
- 测例钉住「select 输出 → 宿主 prop 名 `matched` → 组件消费」整条边界(此前只断言注册元数据,改错名字也会绿灯)
|
|
120
|
+
- 文件树:活动页心跳 1.2s→4s、隐藏 6s→12s;保存后 `nudgeTreeWatch` 立即拉一轮,少无感狂刷
|
|
121
|
+
|
|
122
|
+
## 0.18.28
|
|
123
|
+
|
|
124
|
+
- 文件树增量自动刷新:AI 建/改/删文件后,已展开的树无感更新。Host 侧新增按 `sessionId` + 目录管理的非递归 `fs.watch` registry(per-subscriber 引用计数、单调 sequence + 有界 replay、watcher 失效自动重开),配 `fs.watch.sync`(只回「哪几层变了」+ 游标)与 `fs.tree.batch`(批量 listing + 可选 `statPaths`)
|
|
125
|
+
- 客户端共享 watch broker:同一会话/cwd 的文件树与多个编辑器合并成一份订阅与一轮请求;活动页 ~1.2s、隐藏页 ~6s、失败退避 4s;健康时每 20 轮全量 sweep,有不可监听目录时 5 轮
|
|
126
|
+
- 刷新语义:只替换真正变化的已加载层(`levelSignature` 比对,相同则跳过 setState),不显示 loading、不调 `refreshTick`、不物化未展开目录、不动展开/搜索/滚动/拖拽状态
|
|
127
|
+
- 打开中文件的外部修改:`mtimeMs` 贯穿 `fs.read` → 渲染 → baseline;内容 clean 时静默重载,dirty 时绝不覆盖草稿,显示「文件已被外部修改,草稿未覆盖」提示条与刷新按钮;无 baseline 的 viewer 不循环重载
|
|
128
|
+
- 修复:`fs.tree.batch` 的 listing/stat 回显改为调用方传入的原始路径(此前回显 Host 解析后的 realpath——symlink workspace root、Windows 大小写或分隔符规范化下,客户端的层级 key 与 stat 行会永久匹配不上,树看起来「不再刷新」)
|
|
129
|
+
- 点击卡顿(静态定位):`TreePanel` 加 memo 渲染边界、树回调 `useCallback` 稳定化、`FileTree` 单次 `setData` 批量提交(原为逐层提交)、CodeMirror 语言包按语言 key 缓存
|
|
130
|
+
- 测试环境:`vitest.config.ts` 加 `resolve.dedupe: ['react', 'react-dom']`(插件与宿主根各装一份 React,经 `client-ui-primitives` 跨界渲染时全部 UI 测试死于 `Invalid hook call`)
|
|
131
|
+
- i18n:19 个语言字典补齐 7 个漏键(`fileChangedOnDisk` / `laneModified` / `laneDeleted` / 四个 `viewer*`)
|
|
132
|
+
- 冗余清理:删除无消费者的 `onDegraded` 钩子、`mergeLevel` 导出与重复的 `messageOf`;`locales.spec.ts` 里测 0.18.0 已删除的 `attachBetterLocale` 覆盖层协议的残留一并清掉
|
|
133
|
+
|
|
134
|
+
## 0.18.27
|
|
135
|
+
|
|
136
|
+
- 对话尾部文件行:按「本次改动 / 本次删除 / 本次产出」三条 lane 渲染(此前只有一条「本次产出」,改动与删除被丢弃)
|
|
137
|
+
- 修复根因:接管 `conversation.chat.turnTail` 时只挑 `path`、丢掉 Turn 数据里的 `op`,等于把内核已有的 lane 压平;删除的 chip 置灰划线、不可点(文件已不存在)
|
|
138
|
+
- 无 `op` 的旧会话回落:`workspace/changes` 行数启发式(0 增有删 → 删除,0 删有增 → 产出,其余 → 改动)
|
|
139
|
+
|
|
140
|
+
## 0.18.26
|
|
141
|
+
|
|
142
|
+
- 终端:挂起唤醒后画布空白时 fit/refresh;网格仍死则 remount 并重挂 PTY;关闭 `allowTransparency` 减轻 GPU 挂起后整页空白
|
|
143
|
+
- Desktop:忽略塌缩的 `visualViewport` 当键盘 inset(避免布局推挤空白条与 `overflow: clip` 裁切面板)
|
|
144
|
+
- 偏好默认与 Host 对齐:`openByDefault` / `bottomPanelAutoTerminal` 默认关
|
|
145
|
+
- 布局:双写 `data-xrkh-sidebar-*` 与 `--xrkh-workbench-*`;存储键 `xrkh-sidebar:v1`(迁移旧 `dsh-sidebar:v1`)
|
|
146
|
+
|
|
147
|
+
## 0.18.21
|
|
148
|
+
|
|
149
|
+
- `openTab({ type: 'editor' })` 固定落到侧栏分栏(`splits`),不因 `activePane` 在底栏而撑开底部面板(避免聊天开文件先出空白底栏 / 自动终端)
|
|
150
|
+
|
|
151
|
+
## 0.18.20
|
|
152
|
+
|
|
153
|
+
- 拖拽分栏时合并 resize(一帧一次、跳过无变化),避免 Windows ConPTY 反复重打「版本」MOTD
|
|
154
|
+
- Host 短暂不可用(5xx / 空 1006)时软重连更久,不把已绘出的 MOTD 盖上致命横幅
|
|
155
|
+
- SSE 与 input/resize POST 不再共用 AbortController,关流时不误取消在途控制请求
|
|
156
|
+
- 载波仍同 0.18.19:页面同源 `xrk-app://app`(池隔离归 Desktop/Face,不在本插件翻)
|
|
157
|
+
|
|
158
|
+
## 0.18.19
|
|
159
|
+
|
|
160
|
+
- Desktop 终端:SSE/POST 回到页面同源 `xrk-app://app`(去掉会 `Failed to fetch` 的 `xrk-app://stream` 分裂与回退冗余)
|
|
161
|
+
|
|
162
|
+
## 0.18.18
|
|
163
|
+
|
|
164
|
+
- 轨图标:面板展开时贴齐 34px 页签条(`+3`),收起时仍对齐会话标题行(`+14`),不再下偏
|
|
165
|
+
- Desktop 终端:SSE 不再带 `Accept`;`stream` 主机打不开时曾回退 `app`(已由 0.18.19 去掉回退)
|
|
166
|
+
|
|
167
|
+
## 0.18.17
|
|
168
|
+
|
|
169
|
+
- 右侧面板顶距改为单一 `top`(`--dsh-title-bar-strip` → `--xrk-desktop-chrome-height`),去掉 `padding-top` 叠 chrome,修复 Desktop 页签上方空带
|
|
170
|
+
|
|
171
|
+
## 0.18.14
|
|
172
|
+
|
|
173
|
+
- `title-bar-compat`:`--dsh-title-bar-strip` 已含 Desktop chrome,不再叠加 `--xrk-desktop-chrome-height`(侧栏轨图标不再比标题栏矮一截)
|
|
174
|
+
- toggle cluster:与会话标题行垂直对齐(`+14px` · `align-items: center`)
|
|
175
|
+
- 启动期 panel/FAB 隐藏:去掉插件侧重复 CSS,统一由内核 `data-xrk-booting` 负责
|
|
176
|
+
|
|
177
|
+
## 0.18.12
|
|
178
|
+
|
|
179
|
+
- 启动 splash(`data-xrk-booting`):隐藏 panel-host / FAB,避免与 HARNESS 启动页叠层
|
|
180
|
+
- 会话头「Session log」:有 toggle cluster 时始终右缩,展开动画中不再被按钮挡住
|
|
181
|
+
- 动效:主题 token 冷启动回退 380ms / cubic-bezier,展开收起不再僵硬跳切
|
|
182
|
+
- Desktop chrome:右侧面板与 FAB 避开 `--xrk-desktop-chrome-height`
|
|
183
|
+
|
|
184
|
+
## 0.18.11
|
|
185
|
+
|
|
186
|
+
- 文件页:`openTab({ type: 'editor' })` 聚焦已种子的 files-home,不再并排冒出第二个「文件」标签
|
|
187
|
+
- `applyDedupe`:`dedupeKey` 返回 `undefined` 时仍按同 cohort 去重(与 pathless 编辑器一致)
|
|
188
|
+
- 底栏首次展开:若已有 UI 终端则跳过自动再开一个
|
|
189
|
+
|
|
190
|
+
## 0.18.10
|
|
191
|
+
|
|
192
|
+
- Desktop(`xrk-app://`):终端改走 Host HTTP SSE + POST(`/sidebar/api/pty/*`),不再对无 listen 的私有 Host 死循环 WebSocket 重连
|
|
193
|
+
- 无边框窗口:右侧面板留 2px 边缘,便于 Electron 命中缩放
|
|
194
|
+
|
|
195
|
+
## 0.18.9
|
|
196
|
+
|
|
197
|
+
- `openTab`:当前会话下任意打开(含仅 `type` 的 Files / +菜单)都会展开已折叠侧栏,调用方无需再自行 `togglePanel`
|
|
198
|
+
|
|
199
|
+
## 0.18.3
|
|
200
|
+
|
|
201
|
+
- Client fiber 注入 `layout`(与 `ui-sidebar` 同序):等 `ui-layout` 声明中心栏后再挂侧栏拦截,避免 Host ≥0.3.4 上 `conversation` slot 竞态
|
|
202
|
+
- `xrk.client.inject` 补 `@xrkseek/client-ui-layout`;文档 Host 基线改为 **≥ 0.3.4**
|
|
203
|
+
|
|
204
|
+
## 0.18.2
|
|
205
|
+
|
|
206
|
+
- Files 主页签随 locale;轻量媒体预览;默认打开侧栏
|
|
207
|
+
|
|
208
|
+
## 0.18.1
|
|
209
|
+
|
|
210
|
+
- `subagents.live`:兼容嵌套 `tool` 与旧版扁平 `tool` wire,避免子代理活动预览崩溃
|
|
211
|
+
- 与 Host 原生 `/sidebar/*`(嵌套 live 形状)对齐
|
|
212
|
+
|
|
213
|
+
## 0.18.0
|
|
214
|
+
|
|
215
|
+
- XRKH 原生:去掉第三方双轨(旧 manifest · better-locale · 旧安装脚本 · 市场目录)
|
|
216
|
+
- peer 仅 `@xrkseek/*` + React;工具类型走 `@xrkseek/xrk-tools` / `xrk-settings`
|
|
217
|
+
- 无 Side Chat;子代理走 Host Face + `subagents.live` / `jobs.*`
|
|
218
|
+
- 空 curated 插件目录(社区扩展不随包捆绑)
|
|
219
|
+
|
|
220
|
+
## 契约
|
|
221
|
+
|
|
222
|
+
| 项 | 说明 |
|
|
223
|
+
|----|------|
|
|
224
|
+
| npm | `xrkh-better-sidebar` |
|
|
225
|
+
| 仓库 | `xrkseek/xrkh-better-sidebar` |
|
|
226
|
+
| 形态 | **仅 client 半包**(`package.json` → `xrk.client` → `lib/client.js`) |
|
|
227
|
+
| 注入 | `client-runtime` · `client-locale` · `client-ui-slots` · `client-ui-layout` · `client-ui-conversation` · `client-modules` |
|
|
228
|
+
| Host | **产品 Host 拥有** `/sidebar/api` · `/sidebar/file|upload|html|bundle` · `/sidebar/ws/terminal` 等;本包不在 XRK 上挂 Cordis host 半包抢同一前缀 |
|
|
229
|
+
| 子代理 / 任务 | 走 Host Face + `/sidebar/api` 的 `subagents.live` · `jobs.*`(勿再实现 Side Chat) |
|
|
230
|
+
|
|
231
|
+
契约细则见 Harness 教科书 [community-plugins.md](https://github.com/xrkseek/XRK-harness/blob/main/docs/community-plugins.md)「侧栏插件契约」。
|
|
232
|
+
|
|
233
|
+
## 开发
|
|
234
|
+
|
|
235
|
+
```bash
|
|
236
|
+
pnpm install
|
|
237
|
+
pnpm bundle
|
|
238
|
+
```
|