@seemseam/ccb 7.5.3 → 7.6.1

package/README.md

@@ -6,7 +6,7 @@
 **Visible, controllable multi-agent cooperative TUI workspace**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.5.3-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-7.6.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-14%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -83,6 +83,12 @@ After CCB is installed, use CCB's updater:
 ccb update
 ```
 
+Install or refresh the optional rich media workbench; it bundles verified binaries where possible and installs only the required terminal/media/font dependencies through the platform package manager:
+
+```bash
+ccb update rich
+```
+
 <details>
 <summary><b>GitHub release package and source install fallbacks</b></summary>
 
@@ -170,6 +176,16 @@ Agents can also call `/ask` from workflow orchestration to delegate and hand off
 | Workspace | Every pane is a real CLI. Switch by mouse or tmux shortcuts. |
 | Useful shortcuts | `Ctrl-b h/j/k/l` switches adjacent panes; `Ctrl-b z` zooms or restores the current CLI pane. |
 
+<a id="rich-mode-new"></a>
+
+### Rich Mode (NEW!)
+
+Run `ccb update rich` to install the optional rich workbench; it bundles Yazi where possible, uses WezTerm for the rich terminal surface, and opens WezTerm + Yazi + LazyVim with Markdown rendering and image/PDF/video previews via `ccb rich`.
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich workbench with Yazi PDF preview in WezTerm" width="860">
+</p>
+
 ### Contact
 
 - Email: `bfly123@126.com`
@@ -312,7 +328,7 @@ CCB resolves config in three layers, from lowest to highest priority:
 3. Project config at `.ccb/ccb.config`.
 
 Higher layers replace lower layers as a whole; they are not merged. The project authority file is `.ccb/ccb.config`. The old `.ccb_config/ccb.config` path is legacy migration evidence only.
-The built-in default is a v2 `[windows]` config with `agent1`, `agent2`, `agent3`, `ccb_self`, and a managed `neovim` tool window using `ccb-nvim`. The default `ccb_self` agent uses `codex` and is bound to `agentroles.ccb_self`.
+The built-in default is a v2 `[windows]` config with `agent1`, `agent2`, `agent3`, and `ccb_self`. The default `ccb_self` agent uses `codex` and is bound to `agentroles.ccb_self`.
 
 `.ccb/ccb.config` mainly controls:
 
@@ -440,10 +456,12 @@ command = "ccb-nvim"
 label = "neovim"
 ```
 
-`ccb tools install neovim` prepares an isolated `ccb-nvim` wrapper and LazyVim profile under CCB-owned XDG paths. `install.sh install` and `ccb update` automatically attempt this provisioning by default and keep failures non-blocking. Set `CCB_INSTALL_NEOVIM=1` to make install provisioning required or `CCB_INSTALL_NEOVIM=0` to skip it.
-If `nvim` is not already on `PATH`, provisioning attempts to download the official Neovim release tarball for Linux/macOS and verifies the release sha256 before activating it. It does not write `~/.config/nvim`.
-The managed profile defaults to ASCII icons so terminals without Nerd Font support do not show unreadable boxes. To opt back into LazyVim glyph icons, launch with `CCB_LAZYVIM_ICON_STYLE=glyph ccb-nvim`.
-Use `ccb tools doctor neovim` to verify the managed profile. A working LazyVim setup reports `neovim_status: ok` and `lazyvim_health_status: ok`; damaged or partially downloaded plugin trees report `degraded` and can be repaired by rerunning `ccb tools install neovim`.
+`ccb update rich` prepares the optional workbench bundle under CCB-owned XDG paths, downloads and validates bundled binaries where available, and uses the platform package manager only for required rich dependencies such as WezTerm, Markdown/PDF/image/video helpers, and recommended fonts. Under WSL, CCB can launch Windows-native `wezterm.exe` while running the rich tools inside the current Linux distro. Normal `ccb update` keeps this bundle untouched; rerun `ccb update rich` to install, repair, or refresh it, then use `ccb rich` or mount the tool window above. Set `CCB_RICH_DOWNLOAD_BINARIES=0` to skip bundled binary downloads, or `CCB_RICH_INSTALL_DEPS=0` to skip system package installation.
+
+Rich workbench tools, including the managed Neovim profile, are installed and updated explicitly with `ccb update rich`. Ordinary `install.sh install`, `ccb update`, and `ccb tools ... neovim` do not provision standalone Neovim; the public Neovim tool route now directs users to `ccb update rich`.
+If `nvim` is not already on `PATH`, rich provisioning may download the official Neovim release tarball for Linux/macOS and verifies the release sha256 before activating it. It does not write `~/.config/nvim`.
+The managed profile defaults to ASCII icons so terminals without Nerd Font support do not show unreadable boxes. To opt back into LazyVim glyph icons, launch the rich workbench with `CCB_LAZYVIM_ICON_STYLE=glyph ccb rich`.
+Use `ccb tools doctor workbench --profile rich` to verify the installed rich bundle. `ccb rich` launches only an already installed and enabled rich bundle; run `ccb update rich` first if the bundle is missing or disabled.
 
 #### Per-agent model, API key, or base URL
 
@@ -533,14 +551,6 @@ If agent A is handling a user-originated CCB task and needs agent B's result to
 
 </details>
 
-### Editor Workflow
-
-<p align="center">
-  <img src="assets/nvim.png" alt="Neovim integration with multi-model code review" width="860">
-</p>
-
-CCB does not require leaving your editor. A common setup is: editor for code, CCB terminal for multi-agent planning, implementation, review, testing, and handoff.
-
 ### Install And Update
 
 #### Requirements
@@ -631,6 +641,35 @@ v7 highlights:
 - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
 
 <details open>
+<summary><b>v7.6.1</b> - Rich Workbench Binary Packaging</summary>
+
+- `ccb update rich` now bundles verified Yazi/ya binaries where possible before
+  falling back to package managers.
+- Linux rich installs prefer official Yazi musl builds before GNU builds to
+  avoid newer glibc requirements on older stable distributions.
+- Downloaded Yazi binaries must pass `--version` validation before activation,
+  and invalid managed binaries are removed so fallback paths remain available.
+- Under WSL, rich launchers can use Windows-native `wezterm.exe` while keeping
+  CCB, Yazi, and preview helpers inside the current Linux distro.
+
+</details>
+
+<details>
+<summary><b>v7.6.0</b> - Rich Workbench Lifecycle</summary>
+
+- Makes rich workbench an explicit optional bundle installed with
+  `ccb update rich`.
+- Keeps ordinary `install.sh install` and `ccb update` focused on CCB itself;
+  they no longer auto-provision standalone Neovim.
+- Public `ccb tools ... neovim` routes now refuse standalone provisioning and
+  point users to `ccb update rich`; `ccb rich` launches only an installed and
+  enabled rich bundle.
+- Restores the CCB tmux status bar to one line by removing the old second-line
+  copy hint.
+
+</details>
+
+<details>
 <summary><b>v7.5.3</b> - Kimi Runtime Reliability And Hindsight Compatibility</summary>
 
 - Adds Kimi runtime hardening without changing other provider execution paths:

package/README_zh.md

@@ -6,7 +6,7 @@
 **可见、可控的多 Agent 合作TUI工作台**
 
 <p>
-  <img src="https://img.shields.io/badge/version-7.5.3-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-7.6.1-orange.svg" alt="version">
   <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
   <img src="https://img.shields.io/badge/providers-14%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -83,6 +83,12 @@ npm install -g @seemseam/ccb
 ccb update
 ```
 
+可选富媒体工作台用 `ccb update rich` 安装或刷新；它会优先下载并验证可封装的二进制，只把必要的终端、媒体和字体依赖交给平台包管理器安装：
+
+```bash
+ccb update rich
+```
+
 <details>
 <summary><b>GitHub release 包和源码安装兜底</b></summary>
 
@@ -171,6 +177,16 @@ ccb
 | 工作区 | 每个 pane 都是真实 CLI；可以鼠标点击切换，也可以用 tmux 快捷键切换。 |
 | 常用技巧 | `Ctrl-b h/j/k/l` 切换相邻 pane，`Ctrl-b z` 放大或还原当前 CLI pane。 |
 
+<a id="rich-mode-new"></a>
+
+### Rich 模式（NEW!）
+
+运行 `ccb update rich` 安装可选富媒体工作台；它会尽量封装 Yazi 等二进制，并用 WezTerm 承载富媒体终端界面，再通过 `ccb rich` 打开 WezTerm + Yazi + LazyVim，支持 Markdown 渲染和图片/PDF/视频预览。
+
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览 PDF" width="860">
+</p>
+
 ### 联系方式
 
 - Email: `bfly123@126.com`
@@ -308,7 +324,7 @@ CCB 配置有三层，优先级从低到高：
 3. 项目配置 `.ccb/ccb.config`。
 
 更高层会整体替换低层，不做局部合并。当前项目的权威配置文件是 `.ccb/ccb.config`；旧路径 `.ccb_config/ccb.config` 只应作为迁移参考。
-内置默认配置是 v2 `[windows]` 拓扑，包含 `agent1`、`agent2`、`agent3`、`ccb_self`，以及一个使用 `ccb-nvim` 的托管 `neovim` 工具 window。默认 `ccb_self` 使用 `codex` 并绑定 `agentroles.ccb_self`。
+内置默认配置是 v2 `[windows]` 拓扑，包含 `agent1`、`agent2`、`agent3` 和 `ccb_self`。默认 `ccb_self` 使用 `codex` 并绑定 `agentroles.ccb_self`。
 
 `.ccb/ccb.config` 主要配置这些内容：
 
@@ -431,10 +447,12 @@ command = "ccb-nvim"
 label = "neovim"
 ```
 
-`ccb tools install neovim` 会准备隔离的 `ccb-nvim` wrapper 和 LazyVim profile，路径在 CCB 自己的 XDG 目录下。`install.sh install` 和 `ccb update` 默认都会尝试安装或刷新该工具，并把默认 provisioning 失败保留为 warning。设置 `CCB_INSTALL_NEOVIM=1` 可强制 provisioning，设置 `CCB_INSTALL_NEOVIM=0` 可跳过。
-如果 `PATH` 里没有 `nvim`，provisioning 会尝试下载 Linux/macOS 官方 Neovim release tarball，并校验 release sha256 后再启用；不会写入 `~/.config/nvim`。
-托管 profile 默认使用 ASCII 图标，避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时，可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb-nvim` 恢复 LazyVim 图标。
-用 `ccb tools doctor neovim` 验证托管 profile。LazyVim 真正可用时会显示 `neovim_status: ok` 和 `lazyvim_health_status: ok`；插件目录损坏或半下载会显示 `degraded`，重新运行 `ccb tools install neovim` 会尝试修复。
+`ccb update rich` 会在 CCB 自己的 XDG 目录下准备可选工作台包，优先下载并验证可封装的二进制，只把 WezTerm、Markdown/PDF/图片/视频辅助工具和推荐字体等必要依赖交给平台包管理器。WSL 下可以调用 Windows 原生 `wezterm.exe`，同时让 rich 工具继续运行在当前 Linux 发行版内。普通 `ccb update` 不会主动安装或刷新该包；需要安装、修复或更新时重新运行 `ccb update rich`，然后使用 `ccb rich` 或上面的工具 window 挂载方式启动。设置 `CCB_RICH_DOWNLOAD_BINARIES=0` 可跳过二进制下载，设置 `CCB_RICH_INSTALL_DEPS=0` 可跳过系统包安装。
+
+Rich workbench 工具（包括托管 Neovim profile）现在通过 `ccb update rich` 显式安装和更新。普通 `install.sh install`、`ccb update` 和 `ccb tools ... neovim` 不再 provision standalone Neovim；公开 Neovim 工具路由会提示使用 `ccb update rich`。
+如果 `PATH` 里没有 `nvim`，rich provisioning 可能下载 Linux/macOS 官方 Neovim release tarball，并校验 release sha256 后再启用；不会写入 `~/.config/nvim`。
+托管 profile 默认使用 ASCII 图标，避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时，可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb rich` 恢复 LazyVim 图标。
+用 `ccb tools doctor workbench --profile rich` 验证已安装的 rich bundle。`ccb rich` 只启动已经安装并启用的 rich bundle；如果 bundle 缺失或禁用，请先运行 `ccb update rich`。
 
 #### 给 agent 单独配置模型、API key 或 base URL
 
@@ -522,14 +540,6 @@ spill 只是兜底，所以只要精确输入或完整输出重要，就应该
 
 </details>
 
-### 编辑器工作流
-
-<p align="center">
-  <img src="assets/nvim.png" alt="Neovim 集成多模型代码审查" width="860">
-</p>
-
-CCB 不要求你离开编辑器。常见方式是：编辑器负责写代码，CCB 终端负责多 agent 规划、实现、审查、测试和交接。
-
 ### 安装和更新
 
 #### 环境要求
@@ -620,6 +630,31 @@ v7 线重点：
 - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
 
 <details open>
+<summary><b>v7.6.1</b> - Rich Workbench 二进制封装</summary>
+
+- `ccb update rich` 会优先封装并验证 Yazi/ya 二进制，再让包管理器兜底。
+- Linux rich 安装优先使用官方 Yazi musl 构建，再回退 GNU 构建，避免旧稳定
+  发行版遇到较新的 glibc 要求。
+- 下载的 Yazi 二进制必须通过 `--version` 验证才会启用；无效的 managed
+  二进制会被移除，保证后续 fallback 仍可工作。
+- WSL 下 rich launcher 可使用 Windows 原生 `wezterm.exe`，同时让 CCB、Yazi
+  和 preview helpers 继续运行在当前 Linux 发行版内。
+
+</details>
+
+<details>
+<summary><b>v7.6.0</b> - Rich Workbench 生命周期</summary>
+
+- Rich workbench 变为显式可选 bundle，统一通过 `ccb update rich` 安装和更新。
+- 普通 `install.sh install` 和 `ccb update` 只处理 CCB 本体，不再自动
+  provision standalone Neovim。
+- 公开 `ccb tools ... neovim` 路由会拒绝 standalone provisioning 并提示
+  `ccb update rich`；`ccb rich` 只启动已经安装并启用的 rich bundle。
+- CCB tmux 状态栏恢复为单行，移除旧的第二行复制提示。
+
+</details>
+
+<details>
 <summary><b>v7.5.3</b> - Kimi 运行可靠性与 Hindsight 兼容性</summary>
 
 - 增强 Kimi 运行路径，但不改变其他 provider 的执行路径：当 native turn

package/VERSION

@@ -1 +1 @@
-7.5.3
+7.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "7.5.3",
+  "version": "7.6.1",
   "description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, Kimi, MiMo, Qwen, Cursor, Copilot, Crush, Kiro, Pi, OpenCode, Antigravity, and Droid.",
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",