xrkh-better-sidebar 0.17.7 → 0.18.0

package/README.md

@@ -10,7 +10,7 @@ Host 侧 `/sidebar/*` 由产品内置兼容器接线；本包提供 **client 半
 前置：`xrkh web` 或 `npx @xrkseek/harness-cli web`，Node ≥ 26。
 
 ```bash
-xrkh plugin add xrkh-better-sidebar@latest
+xrkh plugin add xrkh-better-sidebar@0.18.0
 xrkh restart
 ```
 
@@ -22,17 +22,34 @@ xrkh plugin add ./xrkh-better-sidebar
 xrkh restart
 ```
 
+本机与 XRK-Harness 源码仓联调时，可将本仓放在 Harness 的 `extensions/xrkh-better-sidebar/`（主仓 gitignore，不进提交），然后：
+
+```powershell
+$env:XRK_PLUGINS_DIR = "./extensions"
+pnpm xrk web --workspace .
+```
+
 装完硬刷新浏览器（Ctrl+Shift+R）。
 
+## 0.18.0
+
+- XRKH 原生：去掉 DSH 双轨（`dsh` manifest · better-locale · DSH 安装脚本 · 市场目录）
+- peer 仅 `@xrkseek/*` + React；工具类型走 `@xrkseek/xrk-tools` / `xrk-settings`
+- 无 Side Chat；子代理走 Host Face + `subagents.live` / `jobs.*`
+- 空 curated 插件目录（社区扩展不随包捆绑）
+
 ## 契约
 
 | 项 | 说明 |
 |----|------|
 | npm | `xrkh-better-sidebar` |
 | 仓库 | `xrkseek/xrkh-better-sidebar` |
-| 清单 | `package.json` → `xrk.client`（client 半包） |
+| 形态 | **仅 client 半包**（`package.json` → `xrk.client` → `lib/client.js`） |
 | 注入 | `@xrkseek/client-runtime` · `client-locale` · `client-ui-slots` · `client-ui-conversation` · `client-modules` |
-| Host | 产品 `dsh-compat` 提供 `/sidebar/api` · `/sidebar/bundle` · PTY 等 |
+| Host | **产品 Host 拥有** `/sidebar/api` · `/sidebar/file|upload|html|bundle` · `/sidebar/ws/terminal` 等；本包不在 XRK 上挂 Cordis host 半包抢同一前缀 |
+| 子代理 / 任务 | 走 Host Face + `/sidebar/api` 的 `subagents.live` · `jobs.*`（勿再实现 Side Chat） |
+
+契约细则见 Harness 教科书 [community-plugins.md](https://github.com/xrkseek/XRK-harness/blob/main/docs/community-plugins.md)「侧栏插件契约」。
 
 ## 开发
 

package/README_EN.md

@@ -10,7 +10,7 @@ Host serves `/sidebar/*` via the product adapter; this package ships the **clien
 Requires `xrkh web` or `npx @xrkseek/harness-cli web`, Node ≥ 26.
 
 ```bash
-xrkh plugin add xrkh-better-sidebar@latest
+xrkh plugin add xrkh-better-sidebar@0.18.0
 xrkh restart
 ```
 
@@ -22,8 +22,22 @@ xrkh plugin add ./xrkh-better-sidebar
 xrkh restart
 ```
 
+For local monorepo smoke tests, place this tree under Harness `extensions/xrkh-better-sidebar/` (gitignored by the main repo), then:
+
+```powershell
+$env:XRK_PLUGINS_DIR = "./extensions"
+pnpm xrk web --workspace .
+```
+
 Hard-refresh the browser after install (Ctrl+Shift+R).
 
+## 0.18.0
+
+- XRKH-native: drop DSH dual-track (`dsh` manifest · better-locale · DSH 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)
+
 ## Contract
 
 | Item | Notes |

package/cordis.patch.yml

@@ -1,49 +1,8 @@
-# dsh-better-sidebar bundle patch
+# xrkh-better-sidebar bundle patch (Host profile / plugin add)
 #
-# This file is the `dsh.bundle.patch` layer of the published npm package: when
-# the plugin is installed through the official CLI —
-#
-#   dsh plugin --profile <name> add dsh-better-sidebar@<version>
-#
-# — the command reconciles `dsh.profile.bundles` against installed packages
-# and, seeing this declaration, appends `dsh-better-sidebar` to the bundle
-# stack. The profile boot then merges THIS patch (a single `insert` of the
-# plugin row) exactly like the manual cordis.patch.yml mount line used
-# before. No profile file edits needed — one command installs and mounts.
-#
-# If the profile still carries the old manual mount line in its own
-# cordis.patch.yml, remove it before switching to the bundle channel to
-# avoid double-mounting (two Node halves, two sidebars).
-#
-# To choose the terminal shell, add `config.shell` to the inserted plugin
-# row (or to the profile's manual cordis.patch.yml mount line). When omitted,
-# the host keeps resolving $SHELL / the login shell / powershell.exe.
-# `config.shellArgs` optionally supplies explicit startup arguments; when
-# non-empty they replace the automatic POSIX `-l` login flag:
-#
-#   - insert:
-#       - id: better-sidebar
-#         name: 'dsh-better-sidebar'
-#         config:
-#           shell: /bin/zsh
-#           shellArgs:
-#             - --noprofile
-#             - --no-rc
-#
-# Aggregate double-mount guard: aggregate bundles (e.g. @linxin666/dsh-web-ui-all)
-# may already mount this package under their own entry id (e.g.
-# `web-ui-better-sidebar`). Two mounts register /sidebar/api twice and fail the
-# whole plugin tree at boot ("duplicate prefix route"). The `!!js` disabled
-# expression backs THIS row off when another *enabled* entry already mounts
-# `dsh-better-sidebar`; the aggregate instance then owns the sidebar. The
-# loader evaluates it when this row is processed (entry-list order, only rows
-# before this one are visible), so the aggregate bundle must precede this one
-# in `dsh.profile.bundles` — the standard install order, since `dsh plugin add`
-# appends new bundles last. The reverse order (this bundle before the
-# aggregate) is a known limitation: the guard cannot see rows that come after
-# it, and no runtime singleton guard is added. Same-id manual duplicates still
-# fail loudly at the loader as before.
+# When installed via `xrkh plugin add xrkh-better-sidebar`, the Host reconciles
+# profile bundles against this file and inserts the plugin row.
 - insert:
     - id: better-sidebar
-      name: 'dsh-better-sidebar'
-      disabled: !!js "[...ctx.loader.entries()].some((e) => e.options.name === 'dsh-better-sidebar' && e.options.id !== 'better-sidebar' && !e.disabled)"
+      name: 'xrkh-better-sidebar'
+      disabled: !!js "[...ctx.loader.entries()].some((e) => e.options.name === 'xrkh-better-sidebar' && e.options.id !== 'better-sidebar' && !e.disabled)"