xrkh-better-sidebar 0.18.1 → 0.18.3

package/README.md

@@ -3,42 +3,38 @@
 > **读者**：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**。
+前置：`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
 ```
 
-从源码（SSH）：
+装完硬刷新浏览器（Ctrl+Shift+R）。
 
-```bash
-git clone git@github.com:xrkseek/xrkh-better-sidebar.git
-xrkh plugin add ./xrkh-better-sidebar
-xrkh restart
-```
+源码路径仍可用（非推荐）：`git clone git@github.com:xrkseek/xrkh-better-sidebar.git` 后 `xrkh plugin add ./xrkh-better-sidebar`。
 
-本机与 XRK-Harness 源码仓联调时，可将本仓放在 Harness 的 `extensions/xrkh-better-sidebar/`（主仓 gitignore，不进提交），然后：
+## 0.18.3
 
-```powershell
-$env:XRK_PLUGINS_DIR = "./extensions"
-pnpm xrk web --workspace .
-```
+- Client fiber 注入 `layout`（与 `ui-sidebar` 同序）：等 `ui-layout` 声明中心栏后再挂侧栏拦截，避免 Host ≥0.3.4 上 `conversation` slot 竞态
+- `xrk.client.inject` 补 `@xrkseek/client-ui-layout`；文档 Host 基线改为 **≥ 0.3.4**
 
-装完硬刷新浏览器（Ctrl+Shift+R）。
+## 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 插件目录（社区扩展不随包捆绑）
@@ -50,7 +46,7 @@ pnpm xrk web --workspace .
 | 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,42 +3,38 @@
 > **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**.
+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
 ```
 
-From source (SSH):
+Hard-refresh the browser after install (Ctrl+Shift+R).
 
-```bash
-git clone git@github.com:xrkseek/xrkh-better-sidebar.git
-xrkh plugin add ./xrkh-better-sidebar
-xrkh restart
-```
+Source path still works (not preferred): `git clone git@github.com:xrkseek/xrkh-better-sidebar.git` then `xrkh plugin add ./xrkh-better-sidebar`.
 
-For local monorepo smoke tests, place this tree under Harness `extensions/xrkh-better-sidebar/` (gitignored by the main repo), then:
+## 0.18.3
 
-```powershell
-$env:XRK_PLUGINS_DIR = "./extensions"
-pnpm xrk web --workspace .
-```
+- 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**
 
-Hard-refresh the browser after install (Ctrl+Shift+R).
+## 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)
@@ -50,8 +46,8 @@ Hard-refresh the browser after install (Ctrl+Shift+R).
 | 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