xrkh-better-sidebar 0.18.2 → 0.18.3

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
 

package/lib/client-registry.js

@@ -22951,7 +22951,8 @@ window.__ModuleLoader__.load({
 			"sessions",
 			"workspaces",
 			"locale",
-			"modules"
+			"modules",
+			"layout"
 		];
 		/**
 		* Error boundary over the sidebar tree (root scope): a render error in the

package/lib/client.js

@@ -22951,7 +22951,8 @@ window.__ModuleLoader__.load({
 			"sessions",
 			"workspaces",
 			"locale",
-			"modules"
+			"modules",
+			"layout"
 		];
 		/**
 		* Error boundary over the sidebar tree (root scope): a render error in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xrkh-better-sidebar",
-  "version": "0.18.2",
+  "version": "0.18.3",
   "description": "XRK-Harness (xrkh) standard sidebar plugin: explorer, editor, terminal, git, browser.",
   "type": "module",
   "repository": {
@@ -70,6 +70,7 @@
     "@xrkseek/cordis": "*",
     "@xrkseek/client-locale": "*",
     "@xrkseek/client-ui-conversation": "*",
+    "@xrkseek/client-ui-layout": "*",
     "@xrkseek/client-ui-primitives": "*",
     "@xrkseek/client-ui-settings": "*",
     "@xrkseek/client-ui-slots": "*",
@@ -142,6 +143,7 @@
         "@xrkseek/client-runtime",
         "@xrkseek/client-locale",
         "@xrkseek/client-ui-slots",
+        "@xrkseek/client-ui-layout",
         "@xrkseek/client-ui-conversation",
         "@xrkseek/client-modules"
       ],

package/src/client/index.tsx

@@ -11,6 +11,8 @@
 import { createElement } from 'react'
 import { createRoot, type Root } from 'react-dom/client'
 import type { Context } from '../context-types.ts'
+// Type-only: `layout` inject waits until ui-layout declares center slots.
+import type {} from '@xrkseek/client-ui-layout/client'
 import { allLeaves, createSidebarStore, isAgentTabId } from './state.ts'
 import { createBetterSidebarService, matchUrlTarget } from './service.ts'
 import { revalidateChunksOnReactivate, setChunkModuleSystem } from './chunk-loader.ts'
@@ -34,7 +36,7 @@ import './layout.css'
 /** Services required before mounting (provided by the client runtime; the
  *  locale service backs the sidebar's copy — see locales.ts). `modules`
  *  resolves chunk-loader externals. */
-export const inject = ['slots', 'sessions', 'workspaces', 'locale', 'modules']
+export const inject = ['slots', 'sessions', 'workspaces', 'locale', 'modules', 'layout']
 
 /**
  * Error boundary over the sidebar tree (root scope): a render error in the

package/src/index.ts

@@ -11,7 +11,8 @@
  *
  * On XRK-Harness the product Host already owns `/sidebar/*`; this apply path
  * remains for Cordis profile mounts that still load the package as a host
- * plugin. Prefer client-only inject (`xrk.client`) on XRKH.
+ * plugin. Prefer client-only inject (`xrk.client`) on XRKH — do not enable
+ * this host half beside `createSidebarPublicHandler` (duplicate routes).
  *
  * All operations are conversation-scoped: requests carry a sessionId, the
  * session's authoritative cwd comes from the session store, and terminal