xrkh-better-sidebar 0.18.2 → 0.18.4

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2026 xrkseek
-Copyright (c) 2026 dsh-external
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 xrkseek
+Copyright (c) 2026 dsh-external
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -3,14 +3,14 @@
 > **读者**：XRK-Harness 终端用户 · 集成者
 
 XRK-Harness（`xrkh`）标准侧边栏插件：资源管理器 · 编辑器 · 终端 · Git · 浏览器等工作台，按会话隔离。  
-Host 侧 `/sidebar/*` 由产品 Host 原生挂载（`createSidebarPublicHandler`）；本包提供 **client 半包**。
+Host 侧 `/sidebar/*` 由产品 Host 原生挂载（`createSidebarPublicHandler`）；本包提供 **client 半包**。`src/index.ts` 的 Cordis host 半包仅供非 XRKH 的 Cordis profile；**不要**在 XRKH 上再挂 host 抢同一前缀。
 
 ## 安装
 
-前置：`xrkh web` 或 `npx @xrkseek/harness-cli web`，Node ≥ 26。建议 Host **≥ 0.2.3**。推荐从 **npmjs** 安装：
+前置：`xrkh web` 或 `npx @xrkseek/harness-cli web`，Node ≥ 26。建议 Host **≥ 0.3.4**。推荐从 **npmjs** 安装：
 
 ```bash
-xrkh plugin add xrkh-better-sidebar@0.18.1
+xrkh plugin add xrkh-better-sidebar@0.18.3
 xrkh restart
 ```
 
@@ -18,14 +18,23 @@ xrkh restart
 
 源码路径仍可用（非推荐）：`git clone git@github.com:xrkseek/xrkh-better-sidebar.git` 后 `xrkh plugin add ./xrkh-better-sidebar`。
 
+## 0.18.3
+
+- Client fiber 注入 `layout`（与 `ui-sidebar` 同序）：等 `ui-layout` 声明中心栏后再挂侧栏拦截，避免 Host ≥0.3.4 上 `conversation` slot 竞态
+- `xrk.client.inject` 补 `@xrkseek/client-ui-layout`；文档 Host 基线改为 **≥ 0.3.4**
+
+## 0.18.2
+
+- Files 主页签随 locale；轻量媒体预览；默认打开侧栏
+
 ## 0.18.1
 
 - `subagents.live`：兼容嵌套 `tool` 与旧版扁平 `tool` wire，避免子代理活动预览崩溃
-- 与 Host **0.2.3** 原生 `/sidebar/*`（嵌套 live 形状）对齐
+- 与 Host 原生 `/sidebar/*`（嵌套 live 形状）对齐
 
 ## 0.18.0
 
-- XRKH 原生：去掉 DSH 双轨（`dsh` manifest · better-locale · DSH 安装脚本 · 市场目录）
+- XRKH 原生：去掉第三方双轨（旧 manifest · better-locale · 旧安装脚本 · 市场目录）
 - peer 仅 `@xrkseek/*` + React；工具类型走 `@xrkseek/xrk-tools` / `xrk-settings`
 - 无 Side Chat；子代理走 Host Face + `subagents.live` / `jobs.*`
 - 空 curated 插件目录（社区扩展不随包捆绑）
@@ -37,7 +46,7 @@ xrkh restart
 | npm | `xrkh-better-sidebar` |
 | 仓库 | `xrkseek/xrkh-better-sidebar` |
 | 形态 | **仅 client 半包**（`package.json` → `xrk.client` → `lib/client.js`） |
-| 注入 | `@xrkseek/client-runtime` · `client-locale` · `client-ui-slots` · `client-ui-conversation` · `client-modules` |
+| 注入 | `client-runtime` · `client-locale` · `client-ui-slots` · `client-ui-layout` · `client-ui-conversation` · `client-modules` |
 | Host | **产品 Host 拥有** `/sidebar/api` · `/sidebar/file|upload|html|bundle` · `/sidebar/ws/terminal` 等；本包不在 XRK 上挂 Cordis host 半包抢同一前缀 |
 | 子代理 / 任务 | 走 Host Face + `/sidebar/api` 的 `subagents.live` · `jobs.*`（勿再实现 Side Chat） |
 

package/README_EN.md

@@ -3,14 +3,14 @@
 > **Audience**: XRK-Harness end users · integrators
 
 Standard sidebar plugin for XRK-Harness (`xrkh`): explorer · editor · terminal · git · browser, isolated per session.  
-Host mounts `/sidebar/*` natively (`createSidebarPublicHandler`); this package ships the **client** half.
+Host mounts `/sidebar/*` natively (`createSidebarPublicHandler`); this package ships the **client** half. The Cordis host half in `src/index.ts` is only for non-XRKH Cordis profiles — **do not** mount it on XRKH against the same `/sidebar/*` prefix.
 
 ## Install
 
-Requires `xrkh web` or `npx @xrkseek/harness-cli web`, Node ≥ 26. Prefer Host **≥ 0.2.3**. Install from **npmjs**:
+Requires `xrkh web` or `npx @xrkseek/harness-cli web`, Node ≥ 26. Prefer Host **≥ 0.3.4**. Install from **npmjs**:
 
 ```bash
-xrkh plugin add xrkh-better-sidebar@0.18.1
+xrkh plugin add xrkh-better-sidebar@0.18.3
 xrkh restart
 ```
 
@@ -18,14 +18,23 @@ Hard-refresh the browser after install (Ctrl+Shift+R).
 
 Source path still works (not preferred): `git clone git@github.com:xrkseek/xrkh-better-sidebar.git` then `xrkh plugin add ./xrkh-better-sidebar`.
 
+## 0.18.3
+
+- Client fiber injects `layout` (same order as `ui-sidebar`): wait until `ui-layout` declares the center column before sidebar interception — avoids a `conversation` slot race on Host ≥ 0.3.4
+- `xrk.client.inject` adds `@xrkseek/client-ui-layout`; docs Host baseline **≥ 0.3.4**
+
+## 0.18.2
+
+- Files home tab follows locale; light media viewers; open by default
+
 ## 0.18.1
 
 - `subagents.live`: accept nested `tool` and legacy flat `tool` wire so subagent activity previews do not crash
-- Align with Host **0.2.3** native `/sidebar/*` (nested live shape)
+- Align with Host native `/sidebar/*` (nested live shape)
 
 ## 0.18.0
 
-- XRKH-native: drop DSH dual-track (`dsh` manifest · better-locale · DSH install scripts · marketplace catalogs)
+- XRKH-native: drop third-party dual-track (legacy manifest · better-locale · legacy install scripts · marketplace catalogs)
 - Peers are `@xrkseek/*` + React only; tools/settings types via `@xrkseek/xrk-tools` / `xrk-settings`
 - No Side Chat; subagents use Host Face + `subagents.live` / `jobs.*`
 - Empty curated plugin catalogs (community entries are not bundled)
@@ -37,8 +46,8 @@ Source path still works (not preferred): `git clone git@github.com:xrkseek/xrkh-
 | npm | `xrkh-better-sidebar` |
 | Repo | `xrkseek/xrkh-better-sidebar` |
 | Manifest | `package.json` → `xrk.client` (client half) |
-| Inject | `@xrkseek/client-*` (runtime, locale, slots, conversation, modules) |
-| Host | Native Host: `/sidebar/api` · `/sidebar/bundle` · PTY |
+| Inject | `client-runtime` · `locale` · `ui-slots` · `ui-layout` · `ui-conversation` · `modules` |
+| Host | Native Host owns `/sidebar/api` · `/sidebar/bundle` · PTY — do not remount Cordis host half on XRKH |
 
 ## Develop