@chatcode/cco-better-sidebar 0.18.0-alpha.4 → 0.18.0-rc.3

package/README.md

@@ -50,7 +50,7 @@
 - **📌 固定终端**：右键终端 Tab 可「固定到工作区 / 固定到全局」——固定后切换会话不消失，在 TabBar 内联呈现（跨会话虚拟 Tab，点击就地激活，PTY 按 home 会话 id+tab 直连宿主 PTY，无需切回宿主会话）；Agent 终端被 reconcile 移除时豁免保留
 - **🔁 会话隔离**：布局 / Tab / 面板按会话持久化，陈旧状态自动净化
 - **⚙️ 声明式设置**：设置页「侧边卡片」逐项独立开关，二级设置经齿轮弹窗
-- **🎛️ 界面调整（已合并 dsh-ui-tweaks）**：消息/代码字号与行距、Claude 风格表格、GitBar、归档与 MCP 管理、`/init`、鲸鱼工作指示、任务通知和精确缓存命中率均由本插件直接提供；继续使用原 `ui-tweaks` 设置命名空间，无需迁移配置
+- **🎛️ 界面调整（已合并 dsh-ui-tweaks）**：消息/代码字号与行距、Claude 风格表格、GitBar、归档与 MCP 管理、`/init`、鲸鱼工作指示、任务通知和精确缓存命中率均由本插件直接提供；在 DSH 0.1.7 中与侧边卡片设置一起由 `better-sidebar` 配置表单实时管理
 - **⚡ 按需加载**：启动只拉 ~325KB 核心，终端 / 编辑器 / Mermaid 图表等重依赖用到才按需拉取（[设计文档](docs/plans/2026-08-12-lazy-chunks-design.md)）
 - **🌏 多语言**：界面文案跟随 ChatCode CLI 语言（zh / en）实时切换；安装 `@huanlin/dsh-plugin-better-locale` 后支持日语（ja）等第三语言覆盖（见下方「🌏 第三语言覆盖」）
 - **🆕 版本更新日志**：升级后首次打开 Web 端时展示后台配置的当前版本 Markdown 更新内容；跨多个版本升级也只展示当前版本的一条日志
@@ -74,7 +74,7 @@ chatcode-cli plugin --profile web add @chatcode/cco-better-sidebar@latest   #
 
 装完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可看到侧边栏（ChatCode CLI 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。
 
-> 从独立 `dsh-ui-tweaks` 迁移时，请先从 profile 的 bundle/patch 中移除旧插件挂载，只保留 `dsh-better-sidebar`。两者同时挂载会重复注册 `ui-tweaks` 命名空间和 `/_dsh/ui-tweaks/*` 路由；原有 `settings.yaml` 配置会由合并后的插件原样继续读取。
+> 从独立 `dsh-ui-tweaks` 迁移时，请先从 profile 的 bundle/patch 中移除旧插件挂载，只保留 `dsh-better-sidebar`。两者同时挂载会重复注册 `/_dsh/ui-tweaks/*` 路由；DSH 0.1.7 的旧设置导入器会把原 `dsh-better-sidebar` 与 `ui-tweaks` 分区合并进 `better-sidebar` 配置条目。
 
 **方式二：让 ChatCode CLI 自己装**——把下面这段提示词发给任意一个 ChatCode CLI 会话：
 
@@ -107,9 +107,10 @@ chatcode-cli plugin --profile web add @chatcode/cco-better-sidebar@latest
 | 报 `minimum release age` / 版本不足 24h | 装的版本发布不足 24 小时。等 24h 或重跑一次（pnpm 会自动补 `minimumReleaseAgeExclude`）。 |
 | 报「找不到 profile 目录」 | 先跑一次 `chatcode-cli web`，让它初始化 `~/.chatcode-cli/profiles/web`。 |
 | 页面出现**两个侧边栏** | 双挂载。旧的手动挂载行：`~/.chatcode-cli/profiles/web/cordis.patch.yml` 还留着 `- insert: ... better-sidebar ...`，删掉那段（同 id 重复挂载 loader 会直接报 `duplicate loader entry id`）。聚合包（如 `@linxin666/dsh-web-ui-all`）以**不同 id** 挂载本包时，0.13.x 起插件自身 bundle patch 会自动退让（检测到已有启用中的同包名挂载就不挂自己），无需手动处理；若仍双挂载，先确认聚合包的 bundle 顺序在 `dsh-better-sidebar` 之前。 |
-| 启动时报 `ui-tweaks` 设置或 `/_dsh/ui-tweaks` 路由重复 | profile 中仍挂载着独立的 `dsh-ui-tweaks`。移除该旧插件行/旧 bundle，只保留 `dsh-better-sidebar`；不要删除 `settings.yaml` 中的 `ui-tweaks:` 配置。 |
+| 启动时报 `/_dsh/ui-tweaks` 路由重复 | profile 中仍挂载着独立的 `dsh-ui-tweaks`。移除该旧插件行/旧 bundle，只保留 `dsh-better-sidebar`；升级 DSH 0.1.7 时旧设置会导入 `better-sidebar` 配置条目。 |
+| macOS 报 `posix_spawnp failed` / Windows 打开终端卡住 | `0.18.0-rc.3` 起与主程序固定使用 `node-pty@1.2.0-beta.15`：Mac 安装包携带可执行的 `spawn-helper`，普通用户无需修改 root 安装文件；Windows 在 ConPTY 输出线程就绪后再连接。更新侧边栏依赖并重启 Web 服务。 |
 | Windows 下终端无法使用 | `node-pty` 依赖预编译二进制；若当前 Node 版本没有对应产物，需装编译工具链（VS Build Tools）。主流 Node 版本一般已有预编译。 |
-| 终端提示「node-pty 加载失败」 | `node-pty` 安装缺失/损坏（如 pnpm 拦截了构建脚本）。终端横幅会给出修复命令：复制到 ChatCode CLI 所在环境的终端/cmd 执行（在 `~/.chatcode-cli/profiles/web` 下 `pnpm approve-builds --all && pnpm rebuild node-pty`），完成后重启 ChatCode CLI 并点重试。插件与 ChatCode CLI 核心使用同一 `node-pty@^1.1.0`，修复后两者同步恢复。 |
+| 终端提示「node-pty 加载失败」 | `node-pty` 安装缺失/损坏（如 pnpm 拦截了构建脚本）。终端横幅会给出修复命令：复制到 ChatCode CLI 所在环境的终端/cmd 执行（在 `~/.chatcode-cli/profiles/web` 下 `pnpm approve-builds --all && pnpm rebuild node-pty`），完成后重启 ChatCode CLI 并点重试。插件与 ChatCode CLI 核心使用同一 `node-pty@1.2.0-beta.15`，修复后两者同步恢复。 |
 | 提示 `chatcode-cli: command not found` | 先安装 ChatCode CLI；或直接用 `npx -y --package @chatcode/chatcode-cli chatcode-cli plugin --profile web add @chatcode/cco-better-sidebar@latest`。旧 `dsh` 命令仅作为隐藏兼容别名。 |
 
 </details>

package/README_EN.md

@@ -50,7 +50,7 @@
 - **📌 Pinned Terminals**: right-click a terminal tab to "Pin to Workspace / Pin Globally" — pinned terminals survive session switches and surface inline in the TabBar as virtual tabs (click activates in-place, PTY connects directly to the home session's PTY via WS, no session jump needed); agent terminals exempted from reconcile removal
 - **🔁 Session Isolation**: layout / tabs / panels persisted per session, stale state auto-purged
 - **⚙️ Declarative Settings**: per-item toggles in the "Side Cards" settings section, secondary settings via the gear dialog
-- **🎛️ UI Tweaks (dsh-ui-tweaks merged)**: message/code sizing and spacing, Claude-style tables, GitBar, archive and MCP managers, `/init`, whale activity indicator, task notifications, and precise cache-hit percentages now ship in this plugin; the existing `ui-tweaks` settings namespace is retained without migration
+- **🎛️ UI Tweaks (dsh-ui-tweaks merged)**: message/code sizing and spacing, Claude-style tables, GitBar, archive and MCP managers, `/init`, whale activity indicator, task notifications, and precise cache-hit percentages now ship in this plugin; on DSH 0.1.7 they are live fields in the shared `better-sidebar` entry form
 - **⚡ On-demand Loading**: only ~325KB core at startup; heavy deps (terminal / editor / mermaid diagrams) load on demand ([design](docs/plans/2026-08-12-lazy-chunks-design.md))
 - **🌏 i18n**: UI text follows ChatCode CLI's language (zh / en) with live switching; with the optional `@huanlin/dsh-plugin-better-locale` peer, 19 third-language overlays (ja / de / fr / …) are available
 - **🆕 Release notes**: on the first Web launch after an upgrade, shows the backend-configured Markdown note for the current version only; skipped versions are never merged
@@ -74,7 +74,7 @@ chatcode-cli plugin --profile web add @chatcode/cco-better-sidebar@latest   # re
 
 Then **hard-refresh the browser** (Cmd/Ctrl+Shift+R) to see the sidebar (ChatCode CLI hot-reloads client changes; only host-half updates need a restart).
 
-> When migrating from the standalone `dsh-ui-tweaks`, remove its old bundle/patch mount and keep only `dsh-better-sidebar`. Mounting both duplicates the `ui-tweaks` namespace and `/_dsh/ui-tweaks/*` routes. Existing `settings.yaml` values continue to be read unchanged by the merged plugin.
+> When migrating from the standalone `dsh-ui-tweaks`, remove its old bundle/patch mount and keep only `dsh-better-sidebar`. Mounting both duplicates the `/_dsh/ui-tweaks/*` routes. DSH 0.1.7's legacy-settings importer merges the old `dsh-better-sidebar` and `ui-tweaks` sections into the `better-sidebar` entry.
 
 **Or let ChatCode CLI install it for you** — paste this prompt into any ChatCode CLI session:
 
@@ -107,9 +107,10 @@ or bump the version in `~/.chatcode-cli/profiles/web/package.json` (e.g. `"^0.16
 | `minimum release age` / version `< 24h` | The release is younger than 24 hours. Wait, or re-run once (pnpm auto-adds `minimumReleaseAgeExclude`). |
 | "profile directory not found" | Run `chatcode-cli web` once so it initializes `~/.chatcode-cli/profiles/web`. |
 | Two sidebars on the page | Double-mount. Old hand-written line: `~/.chatcode-cli/profiles/web/cordis.patch.yml` still has `- insert: ... better-sidebar ...` — delete it (a same-id duplicate mount makes the loader fail loudly with `duplicate loader entry id`). When an aggregate bundle (e.g. `@linxin666/dsh-web-ui-all`) mounts this package under a **different** id, the plugin's own bundle patch backs off automatically since 0.13.x (it detects an already-enabled mount of the same package name and does not mount itself) — no manual fix needed; if it still double-mounts, make sure the aggregate bundle precedes `dsh-better-sidebar` in `dsh.profile.bundles`. |
-| Duplicate `ui-tweaks` settings or `/_dsh/ui-tweaks` route at startup | The profile still mounts the standalone `dsh-ui-tweaks`. Remove that old plugin row/bundle and keep `dsh-better-sidebar`; retain the `ui-tweaks:` section in `settings.yaml`. |
+| Duplicate `/_dsh/ui-tweaks` route at startup | The profile still mounts the standalone `dsh-ui-tweaks`. Remove that old plugin row/bundle and keep `dsh-better-sidebar`; on a DSH 0.1.7 upgrade the legacy settings are imported into the `better-sidebar` entry. |
+| macOS reports `posix_spawnp failed` / Windows terminal hangs on opening | From `0.18.0-rc.3`, the sidebar pins the core's `node-pty@1.2.0-beta.15`: the Mac package ships an executable `spawn-helper`, so normal users need not modify root-owned installation files; Windows waits for the ConPTY output worker before connecting. Update the sidebar dependency and restart the Web server. |
 | Terminal fails on Windows | `node-pty` relies on prebuilt binaries; if none match your Node version, install a build toolchain (VS Build Tools). Mainstream Node versions are usually covered. |
-| Terminal shows "node-pty failed to load" | The `node-pty` install is missing or broken (e.g. pnpm skipped its build script). The terminal banner shows a repair command — copy it into a terminal/cmd on the ChatCode CLI machine and run it (in `~/.chatcode-cli/profiles/web`: `pnpm approve-builds --all && pnpm rebuild node-pty`), then restart ChatCode CLI and click Retry. The plugin and ChatCode CLI core share the same `node-pty@^1.1.0`, so the repair restores both. |
+| Terminal shows "node-pty failed to load" | The `node-pty` install is missing or broken (e.g. pnpm skipped its build script). The terminal banner shows a repair command — copy it into a terminal/cmd on the ChatCode CLI machine and run it (in `~/.chatcode-cli/profiles/web`: `pnpm approve-builds --all && pnpm rebuild node-pty`), then restart ChatCode CLI and click Retry. The plugin and ChatCode CLI core share the same `node-pty@1.2.0-beta.15`, so the repair restores both. |
 | `chatcode-cli: command not found` | Install ChatCode CLI first, or run `npx -y --package @chatcode/chatcode-cli chatcode-cli plugin --profile web add @chatcode/cco-better-sidebar@latest`. The old `dsh` command remains a hidden compatibility alias. |
 
 </details>

package/cordis.patch.yml

@@ -11,11 +11,12 @@
 # plugin row) exactly like the manual cordis.patch.yml mount line used
 # before. No profile file edits needed — one command installs and mounts.
 #
-# This package now embeds dsh-ui-tweaks while deliberately retaining its
-# `ui-tweaks` settings namespace and `/_dsh/ui-tweaks/*` routes. Remove any
-# standalone `dsh-ui-tweaks` row/bundle before mounting this package; keeping
-# both would register the same settings namespace and routes twice. Existing
-# settings.yaml values do not need migration.
+# This package now embeds dsh-ui-tweaks. On DSH 0.1.7 its live fields belong to
+# the `better-sidebar` Loader entry form, while the established
+# `/_dsh/ui-tweaks/*` routes remain unchanged. Remove any standalone
+# `dsh-ui-tweaks` row/bundle before mounting this package; keeping both would
+# still register the same routes twice. The DSH legacy-settings importer maps
+# the old `dsh-better-sidebar` and `ui-tweaks` sections into this entry.
 #
 # 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