npm - @seemseam/ccb - Versions diffs - 8.0.6 → 8.0.8 - Mend

@seemseam/ccb 8.0.6 → 8.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -1,12 +1,12 @@
 <div align="center">
-# CCB
+# CCB - Mobile Has Arrived!
 **Designed around agent parity**
 **Visible, controllable multi-agent cooperative TUI workspace**
 <p>
-  <img src="https://img.shields.io/badge/version-8.0.6-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.0.8-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-15%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -29,12 +29,12 @@
   <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
 </p>
-**English** | [中文](README_zh.md)
+[中文](README_zh.md) | **English**
-[Quick Start](#quick-start) · [v7 UI](#v7-ui-tour) · [Rich Mode](#rich-mode-new) · [Mobile App](#mobile-app) · [Configure Agents](#configure-your-agent-team) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
+[Quick Start](#quick-start) · [Mobile App](#mobile-app) · [Rich Mode](#rich-mode-new) · [Configure Agents](#create-project-config) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
 <p align="center">
-  <img src="assets/readme_v7/ccb-hero-en.png" alt="CCB v7 visible multi-agent CLI workspace" width="960">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="CCB v7 visible multi-agent CLI workspace" width="960">
 </p>
 </div>
@@ -105,14 +105,6 @@ 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
-```
-After rich is enabled, plain `ccb` opens the rich WezTerm launcher unless it is already running inside a CCB-managed rich WezTerm; use `ccb uninstall rich` to return to the normal terminal startup.
 Install or refresh the optional mobile controller setup:
 ```bash
@@ -123,10 +115,18 @@ This command checks the local mobile gateway prerequisites, guides Tailscale
 login/Serve setup when needed, keeps the gateway loopback-only, and prints the
 current Android APK download link plus pairing steps.
+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
+```
+After rich is enabled, plain `ccb` opens the rich WezTerm launcher unless it is already running inside a CCB-managed rich WezTerm; use `ccb uninstall rich` to return to the normal terminal startup.
 <details>
 <summary><b>GitHub release package and source install fallbacks</b></summary>
-If npm is not available in your environment, download the matching package from [Releases](https://github.com/bfly123/claude_code_bridge/releases):
+If npm is not available in your environment, download the matching package from [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases):
 ```bash
 tar -xzf ccb-*.tar.gz
@@ -137,8 +137,8 @@ cd ccb-*
 Source install is for development or temporary fallback use:
 ```bash
-git clone https://github.com/bfly123/claude_code_bridge.git
-cd claude_code_bridge
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
 ./install.sh install
 ```
@@ -152,6 +152,8 @@ Out of the box, run `ccb` from your project directory. If startup reports that `
 mkdir -p .ccb
 ```
+<a id="create-project-config"></a>
 ### 2. Create project config
 Create `.ccb/ccb.config` in your project root. For v7, it is better to understand config from multi-window topology first: `[windows]` defines tmux windows and agent groups, `agent:provider` defines which CLI each agent uses, and `(worktree)` gives an agent its own git worktree.
@@ -199,33 +201,36 @@ Type directly in an agent pane, or route work between agents:
 Agents can also call `/ask` from workflow orchestration to delegate and hand off work automatically.
-### v7 UI Tour
+<a id="mobile-app"></a>
-| Region | Purpose |
-| :--- | :--- |
-| Sidebar | Shows refresh/close CCB controls, windows and agents, internal communication state, and tips that can be edited in config and hot-reloaded. |
-| Mouse control | Click to switch windows, agents, and panes; refresh, kill, or delete communication entries from the communication area. |
-| 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. |
+### CCB Mobile Has Arrived! (Android Alpha)
-<a id="rich-mode-new"></a>
+Use your phone as a remote CCB controller: switch projects and agents, speak input, open terminal views, and transfer files.
-### Rich Mode (NEW!)
+```bash
+ccb update mobile
+```
-Run `ccb update rich` to install the optional rich workbench; it bundles Yazi where possible, uses WezTerm for the rich terminal surface, and gives Markdown rendering plus image/PDF/video previews. After installation, plain `ccb` automatically opens this rich launcher unless it is already running inside a CCB-managed rich WezTerm; `ccb rich` remains available as an explicit launcher.
+The command walks through local setup and pairing.
 <p align="center">
-  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich workbench with Yazi preview in WezTerm" width="860">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="CCB Mobile agent conversation" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="CCB Mobile terminal control" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="CCB Mobile file transfer" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="CCB Mobile pairing and connection" width="180">
 </p>
-<a id="mobile-app"></a>
+<p align="center">
+  <sub>Mobile can switch projects and agents, inspect conversations, open terminals, transfer files, and connect through scoped pairing.</sub>
+</p>
-### Mobile App (Android Alpha)
+<details>
+<summary><b>Mobile App details, security boundaries, and source</b></summary>
-CCB 8.0.6 includes the Flutter CCB Mobile source under [`mobile/`](mobile/)
+CCB 8.0.8 includes the Flutter CCB Mobile source under [`mobile/`](mobile/)
 and publishes an Android APK as a GitHub Release asset:
-- [Download CCB Mobile v8.0.6 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.6/ccb-mobile-v8.0.6.apk)
+- [Download CCB Mobile v8.0.8 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.8/ccb-mobile-v8.0.8.apk)
 - App source: [`mobile/app`](mobile/app)
 - Server/gateway source: [`lib/mobile_gateway`](lib/mobile_gateway)
@@ -244,9 +249,10 @@ ccb update mobile
 Then follow the printed steps:
 1. Install and sign in to Tailscale on the desktop/server and the phone.
-2. Install the APK on Android.
-3. Run `ccb update mobile` on the desktop/server.
-4. Open CCB Mobile and scan the QR printed by the terminal.
+2. Start the loopback-only CCB Mobile gateway and Tailscale Serve command shown
+   by CCB.
+3. Install the APK on Android.
+4. Open CCB Mobile and scan the pairing QR.
 Security boundaries:
@@ -257,6 +263,31 @@ Security boundaries:
 - The phone only receives the scopes granted by the pairing profile, such as
   view, content, terminal, file upload, and file download.
+</details>
+<a id="rich-mode-new"></a>
+### Rich Mode (NEW!)
+Browse files, open documents, edit text, and preview media from a richer terminal workspace.
+<p align="center">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich workbench with Yazi preview in WezTerm" width="860">
+</p>
+```bash
+ccb update rich
+```
+After rich is enabled, plain `ccb` opens the rich WezTerm launcher unless it is already running inside a CCB-managed rich WezTerm; use `ccb uninstall rich` to return to the normal terminal startup.
+<details>
+<summary><b>Rich Mode details</b></summary>
+Run `ccb update rich` to install the optional rich workbench; it bundles Yazi where possible, uses WezTerm for the rich terminal surface, and gives Markdown rendering plus image/PDF/video previews. After installation, plain `ccb` automatically opens this rich launcher unless it is already running inside a CCB-managed rich WezTerm; `ccb rich` remains available as an explicit launcher.
+</details>
 ### Agent Roles Spec And Role Catalog
 CCB supports the [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), a host-neutral way to package specialist agents as portable Role Packs. The same repository also acts as the public role catalog.
@@ -705,7 +736,7 @@ For later updates:
 ccb update
 ```
-[GitHub Releases](https://github.com/bfly123/claude_code_bridge/releases) remain available for environments where npm is unavailable. Source checkout install is for development, fix validation, or temporary fallback.
+[GitHub Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) remain available for environments where npm is unavailable. Source checkout install is for development, fix validation, or temporary fallback.
 #### Uninstall
@@ -770,68 +801,6 @@ v7 highlights:
 - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
 <details open>
-<summary><b>v8.0.6</b> - CCB Mobile Real Project Chat Stabilization</summary>
-- Improves Android CCB Mobile real-project pane-native chat, status recovery,
-  terminal stream handling, QR/manual pairing, input ergonomics, localization,
-  and noisy timeline filtering.
-- Includes the latest server-wide project listing, native provider transcript,
-  provider runtime status, and mobile terminal pane input fixes from the CCB
-  source line.
-- Uses a compact terminal pairing QR in `ccb update mobile`, keeps the original
-  CCB Mobile bridge icon identity, and makes camera-unavailable scanner fallback
-  actionable instead of showing native plugin errors.
-- Synchronizes VERSION, package metadata, mobile app version metadata, README
-  links, workflow defaults, and APK download URLs for 8.0.6.
-</details>
-<details>
-<summary><b>v8.0.4</b> - CCB Mobile Project List Stability</summary>
-- Accelerates `/v1/projects` for server-wide mobile gateways by checking
-  mounted project health concurrently while preserving registry order.
-- Reduces noisy BrokenPipe/connection-reset tracebacks when a phone disconnects
-  or times out while a response is being written.
-</details>
-<details>
-<summary><b>v8.0.3</b> - npm Release Metadata Fix</summary>
-- Fixes npm provenance metadata so `@seemseam/ccb` publishes from the canonical
-  GitHub repository used by GitHub Actions.
-- Synchronizes VERSION, package metadata, mobile app version metadata, README
-  links, workflow defaults, and APK download URLs for 8.0.3.
-</details>
-<details>
-<summary><b>v8.0.2</b> - Mobile Tailnet Onboarding Fixes</summary>
-- Handles the Tailscale Serve one-time approval flow without exposing raw
-  timeout errors.
-- Reuses an existing correct Tailscale Serve proxy for `:8787`, so users who
-  already approved or started Serve can immediately get the pairing QR.
-- Fixes source worktree installs so installed `ccb` is not mistaken for a source
-  checkout.
-</details>
-<details>
-<summary><b>v8.0.1</b> - Simplified CCB Mobile Pairing</summary>
-- Makes `ccb update mobile` the single user-facing setup command: it checks
-  Tailscale, guides login/install, starts the server-wide loopback gateway plus
-  Tailscale Serve, and prints a pairing QR directly in the terminal.
-- Updates CCB Mobile first launch to show pairing instructions, Tailscale
-  download guidance, and a scan button instead of opening the fake/demo project.
-- Automatically opens the server-wide mounted project list after a stored
-  pairing profile is found, reducing setup friction for normal phone use.
-</details>
-<details>
 <summary><b>v8.0.0</b> - CCB Mobile Monorepo Release</summary>
 - Ships the Flutter CCB Mobile source inside this repository and publishes the

package/README_zh.md CHANGED Viewed

@@ -1,12 +1,12 @@
 <div align="center">
-# CCB
+# CCB 手机 App 来了！
-**基于agent平权思想设计**
-**可见、可控的多 Agent 合作TUI工作台**
+**基于去中心化多 Agent 设计**
+**可见、可控的多 Agent 交互 TUI 工作台**
 <p>
-  <img src="https://img.shields.io/badge/version-8.0.6-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.0.8-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-15%20CLI%20families-0B7285.svg" alt="providers">
 </p>
@@ -31,89 +31,37 @@
 **中文** | [English](README.md)
-[快速开始](#快速开始) · [v7 界面](#v7-界面速览) · [Rich 模式](#rich-mode-new) · [Mobile App](#mobile-app) · [配置团队](#配置-agent-团队) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
+[快速开始](#快速开始) · [Mobile App](#mobile-app) · [Rich 模式](#rich-mode-new) · [配置团队](#创建项目配置) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
 <p align="center">
-  <img src="assets/readme_v7/ccb-hero-zh.png" alt="CCB v7 可见多 Agent CLI 工作台" width="960">
+  <img src="assets/readme_v7/ccb-hero-zh-light.png" alt="CCB v7 可见多 Agent CLI 工作台" width="960">
 </p>
 </div>
----
+## 为什么用 CCB？
-## 支持的 CLI
-可在 `.ccb/ccb.config` 中按 agent 混用不同 CLI；实际可用性取决于本机 CLI 安装和账号权限。
-<table>
-  <tr>
-    <td>Codex<br><code>codex</code></td>
-    <td>Claude<br><code>claude</code></td>
-    <td>Gemini<br><code>gemini</code></td>
-    <td>Kimi<br><code>kimi</code></td>
-    <td>MiMo<br><code>mimo</code></td>
-  </tr>
-  <tr>
-    <td>Qwen<br><code>qwen</code></td>
-    <td>Cursor<br><code>cursor</code></td>
-    <td>GitHub Copilot CLI<br><code>copilot</code></td>
-    <td>Crush<br><code>crush</code></td>
-    <td>Kiro CLI<br><code>kiro</code></td>
-  </tr>
-  <tr>
-    <td>Pi<br><code>pi</code></td>
-    <td>Z.ai CLI<br><code>zai</code></td>
-    <td>OpenCode<br><code>opencode</code></td>
-    <td>Antigravity<br><code>agy</code></td>
-    <td>Droid<br><code>droid</code></td>
-  </tr>
-</table>
+* 强稳定的 agent 间通信能力，支持 `A -> B -> C`、`A,B -> C`、`A -> B,C` 等复杂协作关系。
+* 每个 agent 都是完整原生终端，支持可见的界面排布和直接接管。
+* 后台 daemon 持续运行，可以脱离前台界面保持项目状态。
+* Hub 能力：一个命令同时并发运行多家 CLI provider。
+* 手机远程控制器：跨 provider 语音操控、文件传输和远程终端访问。
 **全新角色规范**：可把 skills、记忆和工具依赖封装进自封闭 Role Pack，快速生成可热加载、可卸载的专业 agent。
-## 为什么用 CCB？
-| 看得见 | 混合 provider | 项目级控制 |
-| :--- | :--- | :--- |
-| 每个 agent 都是真实终端，支持界面排布设计。 | 一个命令同时并发运行多 CLI。 | 稳定后台通信，支持多线并发任务编排。 |
 ## 快速开始
-### 1. 安装或更新
+### 1. 基本功能和操作
-新安装推荐使用 npm 包：
+#### 1.1 安装
 ```bash
 npm install -g @seemseam/ccb
 ```
-安装完成后，后续更新直接使用 CCB 自带 updater：
-```bash
-ccb update
-```
-可选富媒体工作台用 `ccb update rich` 安装或刷新；它会优先下载并验证可封装的二进制，只把必要的终端、媒体和字体依赖交给平台包管理器安装：
-```bash
-ccb update rich
-```
-rich 启用后，普通 `ccb` 会自动打开 rich WezTerm launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；运行 `ccb uninstall rich` 可退回普通终端启动。
-可选手机控制端用下面的入口安装或刷新本机侧配置：
-```bash
-ccb update mobile
-```
-该命令会检查 mobile gateway 依赖，按需引导 Tailscale 登录/Serve 配置，
-保持 gateway 仅监听 loopback，并打印当前 Android APK 下载链接和扫码配对步骤。
 <details>
 <summary><b>GitHub release 包和源码安装兜底</b></summary>
-如果当前环境不方便使用 npm，可以到 [Releases](https://github.com/bfly123/claude_code_bridge/releases) 下载与你的平台匹配的包，解压后安装：
+如果当前环境不方便使用 npm，可以到 [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) 下载与你的平台匹配的包，解压后安装：
 ```bash
 tar -xzf ccb-*.tar.gz
@@ -124,8 +72,8 @@ cd ccb-*
 源码安装只建议开发或临时兜底使用：
 ```bash
-git clone https://github.com/bfly123/claude_code_bridge.git
-cd claude_code_bridge
+git clone https://github.com/SeemSeam/claude_codex_bridge.git
+cd claude_codex_bridge
 ./install.sh install
 ```
@@ -133,87 +81,49 @@ cd claude_code_bridge
 </details>
-开箱即用：在项目目录执行 `ccb` 即可使用。
-如果启动时提示无法自动创建 `.ccb` 或找不到项目锚点，需要手动创建 `.ccb` 作为项目锚点：
-```bash
-mkdir -p .ccb
-```
-### 2. 创建项目配置
-在项目根目录创建 `.ccb/ccb.config`。v7 推荐直接从多 window 拓扑理解配置：`[windows]` 定义窗口和 agent 分组，`agent:provider` 定义每个 agent 使用哪家 CLI，`(worktree)` 表示该 agent 使用独立 git worktree。
-```toml
-version = 2
-entry_window = "main"
-[windows]
-main = "main:codex"
-work = "worker1:codex(worktree), worker2:claude(worktree)"
-review = "reviewer:claude, qa:gemini"
-[ui.sidebar]
-mode = "every_window"
-width = "15%"
-bottom_height = 20
-agents_height = "50%"
-comms_height = "15%"
-tips_height = "35%"
-comms_limit = 3
-```
-如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API，可以直接问当前工作台里的 `ccb_self`。它是 CCB 内置的 self-agent，理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径，并能用私有 `ccb-config` skill 和你讨论后生成配置方案。空白项目默认包含 `ccb_self`。
-验证配置：
-```bash
-ccb config validate
-```
+#### 1.2 启动
-启动工作台：
+在工作目录执行：
 ```bash
 ccb
 ```
+如果启动时提示无法自动创建 `.ccb` 或找不到项目锚点，需要手动创建 `.ccb` 作为项目锚点：
-### 3. 开始协作
-你可以直接在某个 agent pane 里输入，也可以让 agent 之间协作：
-```text
-/ask reviewer review the latest parser changes and list blocking issues.
+```bash
+mkdir -p .ccb
 ```
-也可以在工作编排中让 agent 自动调用 `/ask` 完成委派和交接。
+<a id="mobile-app"></a>
-### v7 界面速览
+#### 1.3 手机远程控制（Android）
-| 区域 | 说明 |
-| :--- | :--- |
-| Sidebar | 显示刷新/关闭 CCB 控件、window 和 agent 列表、内部通信状态，以及可在配置文件中修改并热加载的 tips。 |
-| 鼠标操作 | 支持点击切换 window、agent 和 pane，也可在通信区刷新、kill 或删除条目。 |
-| 工作区 | 每个 pane 都是真实 CLI；可以鼠标点击切换，也可以用 tmux 快捷键切换。 |
-| 常用技巧 | `Ctrl-b h/j/k/l` 切换相邻 pane，`Ctrl-b z` 放大或还原当前 CLI pane。 |
+推荐使用手机控制 CCB：可以接入所有 CCB 项目，控制每个 agent，语音输入，并传递文件。
-<a id="rich-mode-new"></a>
-### Rich 模式（NEW!）
+```bash
+ccb update mobile
+```
-运行 `ccb update rich` 安装可选富媒体工作台；它会尽量封装 Yazi 等二进制，并用 WezTerm 承载富媒体终端界面，提供 Markdown 渲染和图片/PDF/视频预览。安装后，普通 `ccb` 会自动打开 rich launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；`ccb rich` 仍可作为显式启动入口。
+该命令会指导您完成安装和配置。
 <p align="center">
-  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="CCB Mobile agent 对话" width="180">
+  <img src="assets/readme_v7/mobile-control-terminal.jpg" alt="CCB Mobile 终端控制" width="180">
+  <img src="assets/readme_v7/mobile-control-files.jpg" alt="CCB Mobile 文件传输" width="180">
+  <img src="assets/readme_v7/mobile-control-pairing.jpg" alt="CCB Mobile 配对和连接" width="180">
 </p>
-<a id="mobile-app"></a>
+<p align="center">
+  <sub>手机端可切换项目和 agent、查看对话、打开终端、传递文件，并通过配对流程安全接入。</sub>
+</p>
-### Mobile App（Android Alpha）
+<details>
+<summary><b>Mobile App 详情、安全边界和源码</b></summary>
-CCB 8.0.6 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，
+CCB 8.0.8 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，
 并在 GitHub Release 中发布 Android APK：
-- [下载 CCB Mobile v8.0.6 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.6/ccb-mobile-v8.0.6.apk)
+- [下载 CCB Mobile v8.0.8 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.8/ccb-mobile-v8.0.8.apk)
 - App 源码：[`mobile/app`](mobile/app)
 - 服务端 gateway 源码：[`lib/mobile_gateway`](lib/mobile_gateway)
@@ -231,9 +141,9 @@ ccb update mobile
 然后按终端提示：
 1. 在桌面/服务器和手机上安装并登录同一个 Tailscale tailnet。
-2. 在 Android 手机上安装 APK。
-3. 在桌面/服务器运行 `ccb update mobile`。
-4. 打开 CCB Mobile，扫描终端打印的配对二维码。
+2. 启动 CCB 打印的 loopback-only Mobile gateway 和 Tailscale Serve 命令。
+3. 在 Android 手机上安装 APK。
+4. 打开 CCB Mobile，扫描配对二维码。
 安全边界：
@@ -244,286 +154,47 @@ ccb update mobile
 - 手机只获得 pairing profile 授权的 scope，例如 view、content、terminal、
   file upload 和 file download。
-### Agent Roles Spec 规范和角色库
-CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把专业角色打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
-<details>
-<summary><b>当前角色库</b></summary>
-| Role | 基本功能 |
-| :--- | :--- |
-| `agentroles.ccb_self` | CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。 |
-| `agentroles.archi` | 架构审查、边界检查、耦合分析、可维护性风险和后续 gate 建议。 |
-| `agentroles.frontend_engineer` | 前端设计与实现、设计系统、可访问性、浏览器 QA 和受审查的 AGY 委派。 |
-| `agentroles.mobile_app_engineer` | iOS、Android、React Native、Expo、Flutter、SwiftUI、Jetpack Compose 等移动端设计与实现。 |
-| `agentroles.mother` | Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。 |
-| `agentroles.su_ccb` | SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。 |
 </details>
-### 联系方式
+<a id="rich-mode-new"></a>
-- Email: `bfly123@126.com`
-- **[Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)**
-- 微信: `seemseam-com`
+#### 1.4 Rich 富媒体终端
+在终端查看文件结构、打开文件、编辑文档和预览媒体内容。
 <p align="center">
-  <img src="assets/weixin.jpg" alt="微信群" width="240">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
 </p>
----
-## 更多阅读
-初次使用先看“快速开始”即可。下面按用途折叠，需要哪块再展开。
-| 主题 | 什么时候看 |
-| :--- | :--- |
-| 概念和定位 | 了解 CCB 是什么、多 agent 为什么有用，以及与其他方案的区别。 |
-| 日常操作 | 查常用命令、tmux 基础操作和复制粘贴。 |
-| 配置和角色 | 配 `.ccb/ccb.config`、Role Packs、`ccb_self` 配置助手。 |
-| 协作与维护 | ask 路由、安装更新、FAQ 和致谢。 |
-| 版本记录 | 查看当前 v7 重点和历史版本条目。 |
-<details open>
-<summary><b>概念和定位</b></summary>
-### CCB 是什么
-CCB 是一个项目级 agent CLI 工作台。它用 tmux 管理多个真实 CLI agent，把启动、恢复、通信、配置、窗口和运行态聚合在一个项目里。
-- **真实 CLI，不是模拟面板**：每个 agent pane 都运行对应 provider 的真实 CLI。
-- **可见协作**：sidebar 展示窗口、agent 状态和通信区；用户可以用鼠标直接切 pane。
-- **混合 provider**：一个项目里可以同时跑 Codex、Claude、Gemini、Kimi（`kimi`）、MiMo（`mimo`）、Qwen（`qwen`）、Cursor（`cursor`）、Copilot（`copilot`）、Crush（`crush`）、Kiro（`kiro`）、Pi（`pi`）、Z.ai CLI（`zai`）、OpenCode、Droid 和 Antigravity（`agy`）。
-- **项目级配置**：`.ccb/ccb.config` 决定团队、布局、窗口、worktree、model、key、url。
-- **内置 CCB 专家**：空白项目默认包含 `ccb_self`，它是具备 CCB 自理解能力的自维护 agent，可帮助使用 CCB、设计配置、诊断运行态、恢复工作流。
-- **Roles**：全新的角色封装概念；它让携带“重武器”（独立 skills、记忆和
-  工具依赖等）的专业角色瞬间“降临”到目标项目中，成为一个可以快速热加载和
-  卸载的独立 agent，同时保持主环境、用户全局配置和项目运行状态不发生改变。
-- **可恢复运行态**：CCB 后台守护 agent pane，支持 attach、恢复和项目级清理。
-- **显式协作通道**：agent 可以通过 `/ask`、`$ask`、callback 和 silence 进行委派与交接。
-### 为什么需要多 agents
-小任务用单 agent 就够了；一旦任务需要规划、并行实现、审查、测试和交接，多 agents 的价值就变成：把角色、上下文、模型和执行过程拆开管理。CCB 的重点是把多个真实 CLI agent 放进同一个可见终端工作台。
-| 价值 | 直观理解 |
-| :--- | :--- |
-| 角色分离 | `main` 负责任务拆分，`worker` 负责实现，`reviewer` 负责审查。 |
-| 并行推进 | 一个 agent 写代码时，另一个 agent 可以读文档、跑验证或审查风险。 |
-| 模型和上下文分层 | 不同 agent 可以用不同 provider、model、API、worktree 和记忆。 |
-<details>
-<summary><b>展开：单 agent 为什么会吃力？</b></summary>
-- 角色混杂会影响上下文集中度：同一个会话既要做架构，又要写代码，还要自我审查，容易在长任务里丢掉重点。
-- 可执行复杂度有上限：任务越长，越需要拆分、交接、核对和回滚点。
-- 成本压力更高：如果所有步骤都依赖一个最强模型，简单任务也会变贵。
-- 工具和 skill 集中会变难管理：什么都给一个 agent，等于把权限、说明和工具复杂度全部堆在一起。
-- 串行等待效率低：一个 agent 在跑测试、读日志或长时间思考时，其他可并行工作无法自然展开。
-</details>
-### 多 agents 方案怎么选
-多 agents 不是一种固定形态。先用下面这张表判断大方向，细节可以展开看。
-| 方案 | 一句话 | 更适合你如果 |
-| :--- | :--- | :--- |
-| [Claude Code 原生 subagents](https://code.claude.com/docs/en/sub-agents) / [agent teams](https://code.claude.com/docs/en/agent-teams) | Claude Code 内部的原生分工。 | 你主要留在 Claude Code，并接受更多协调由 Claude lead 处理。 |
-| [Hive / OpenHive](https://github.com/aden-hive/hive) | 面向生产工作流的多 agent harness。 | 你要状态、恢复、观测、成本控制和图式工作流。 |
-| CCB | 可见、可控、混合 provider 的本地 CLI agent 工作台。 | 你要把 Codex、Claude、Gemini、Kimi、MiMo、Qwen、Cursor、Copilot、Crush、Kiro、Z.ai CLI、OpenCode、Antigravity 等真实 CLI 放到一个项目终端里操作。 |
-<details>
-<summary><b>展开：模型、可控性、上下文和复杂工作流怎么区别？</b></summary>
-| 关键问题 | Claude Code 原生 | Hive / OpenHive | CCB |
-| :--- | :--- | :--- | :--- |
-| 能否使用不同家的模型 | 可给 teammate / subagent 指定 Claude 模型；整体仍在 Claude Code 体系内。 | 通过 LiteLLM 路线支持大量 hosted / local provider。 | 按 agent 选择 Codex、Claude、Gemini、Kimi、MiMo、Qwen、Cursor、Copilot、Crush、Kiro、Z.ai CLI、OpenCode、Droid、Antigravity 等，并可设置独立 model / key / url。 |
-| 过程是否可见 | in-process 或 split panes，取决于模式和终端。 | 强调 runtime observability 和控制台视角。 | 默认就是 tmux 可见 pane，用户能直接点击、输入、复制、观察每个 CLI。 |
-| 拓扑是否可控 | 可自然语言指定队友，但运行时协调较多交给 lead。 | 由目标生成图式拓扑，偏 harness。 | 配置文件显式定义 agent、窗口、pane、worktree 和 sidebar。 |
-| 上下文是否可管理 | subagent / teammate 有独立上下文；team 有任务和消息状态。 | 角色记忆、状态持久化、恢复能力是核心卖点。 | 每个 CLI 保留自己的 provider 会话；项目共享记忆和 per-agent 记忆可选。 |
-| 最适合的落点 | Claude Code 内部的快速委派和团队模式。 | 业务流程自动化、长期运行和生产可靠性。 | 本地开发、代码协作、跨 provider CLI agent 可视化工作台。 |
-CCB 也支持复杂工作流，但它不是自动生成 DAG 的 harness；复杂度主要通过 `.ccb/ccb.config`、多 window、角色记忆、worktree、model/API 配置和 ask/callback 路由显式设计。
-</details>
-</details>
-<details>
-<summary><b>日常操作</b></summary>
-### 日常操作
+```bash
+ccb update rich
+```
-| 目标 | 命令 |
-| :--- | :--- |
-| 启动或重新 attach 当前项目工作台 | `ccb` |
-| 安全启动，保留各 agent 配置的权限策略 | `ccb -s` |
-| 重建运行态，保留配置和同名 managed agent 历史 | `ccb -n` |
-| 停止当前项目后台 | `ccb kill` |
-| 强制清理当前项目残留后再重建 | `ccb kill -f` 后接 `ccb -n` |
-| 更新到最新稳定 release | `ccb update` |
-| 安装或刷新可选 rich 富媒体工作台 | `ccb update rich` |
-| 移除 rich 模式并退回普通启动 | `ccb uninstall rich` |
-| 打开 rich 富媒体工作台 | `ccb rich` |
-| 查看当前使用的配置层 | `ccb config validate` |
-| 预览配置热加载计划，不修改 tmux | `ccb reload --dry-run` |
-| 应用支持的配置变更，不重启其他 agent | `ccb reload` |
-### tmux 常规操作
-CCB 虽然基本全部可以使用鼠标操作，但是学会 tmux 命令可以显著增加便利性。下面列举了部分常用的键盘操作快捷键。
-本节只讲 tmux。下面的 `<prefix>` 默认为 `Ctrl-b`：**先按 `Ctrl-b`，松开，再按后面的功能键**。功能键建议在英文输入法下按，避免中文输入法拦截符号键。
-| 目标 | 功能键 | 说明 |
-| :--- | :--- | :--- |
-| 切换到相邻 pane | `方向键` | 选择上、下、左、右相邻 agent pane。 |
-| 切到下一个 pane | `o` | 不关心方向时快速轮转。 |
-| 放大 / 还原当前 pane | `z` | 看长输出、diff、日志时非常有用。 |
-| 打开 window / pane 列表 | `w` | 在多 window、多 pane 时选择目标。 |
-| 下一个 window | `n` | 切到下一个 tmux window。 |
-| 上一个 window | `p` | 切到上一个 tmux window。 |
-| 切到编号 window | `0` 到 `9` | 直接跳到对应编号的 window。 |
-| 进入复制/滚动模式 | `[` | 查看历史输出、滚动、选择文本。 |
-| 退出复制/滚动模式 | `q` 或 `Esc` | 回到正常输入。 |
-| 粘贴 tmux buffer | `]` | 粘贴 tmux 自己复制的内容。 |
-| 暂时 detach 会话 | `d` | 退出显示但不停止 CCB 后台，会话仍可重新 attach。 |
-复制粘贴建议：
-- **鼠标复制**：大多数终端里可以直接左键拖选复制；如果拖选被 tmux 接管，先进入复制/滚动模式再选择。
-- **绕过 tmux 拖选**：很多终端支持 `Shift + 鼠标拖选` 使用终端原生复制。
-- **系统粘贴**：Linux/Windows 终端通常是 `Ctrl+Shift+V`，macOS 终端通常是 `Cmd+V`。
-- **tmux 粘贴**：如果内容已经在 tmux buffer 里，用功能键 `]`。
+rich 启用后，普通 `ccb` 会自动打开 rich WezTerm launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；运行 `ccb uninstall rich` 可退回普通终端启动。
 <details>
-<summary><b>更多常用 tmux 操作</b></summary>
-| 目标 | 功能键 | 说明 |
-| :--- | :--- | :--- |
-| 在复制/滚动模式中滚动 | `PageUp` / `PageDown` / `方向键` | 不同终端支持略有差异。 |
-| 在复制/滚动模式中搜索 | `Ctrl-s` / `Ctrl-r` | 分别常用于向前/向后搜索。 |
-| 新建 window | `c` | 只在你明确需要额外 shell 时使用。 |
-| 重命名 window | `,` | 多 window 工作流中更容易识别。 |
-| 显示快捷键帮助 | `?` | 忘记快捷键时查看 tmux 帮助。 |
+<summary><b>Rich 模式详情</b></summary>
-不建议新用户一开始就使用关闭 pane/window 的 tmux 快捷键。停止 CCB 项目请优先使用 CCB 的项目级退出命令，避免只杀掉某个可恢复 pane 造成误判。
-</details>
+运行 `ccb update rich` 安装可选富媒体工作台；它会尽量封装 Yazi 等二进制，并用 WezTerm 承载富媒体终端界面，提供 Markdown 渲染和图片/PDF/视频预览。安装后，普通 `ccb` 会自动打开 rich launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；`ccb rich` 仍可作为显式启动入口。
 </details>
-<details>
-<summary><b>配置和角色</b></summary>
-### 配置 agent 团队
-CCB 配置有三层，优先级从低到高：
-1. 内置默认配置。
-2. 用户配置 `~/.ccb/ccb.config`。
-3. 项目配置 `.ccb/ccb.config`。
-更高层会整体替换低层，不做局部合并。当前项目的权威配置文件是 `.ccb/ccb.config`；旧路径 `.ccb_config/ccb.config` 只应作为迁移参考。
-内置默认配置是 v2 `[windows]` 拓扑，包含 `agent1`、`agent2`、`agent3` 和 `ccb_self`。可选 rich 富媒体工作台通过 `ccb update rich` 安装；启用后普通 `ccb` 会走 rich launcher，运行 `ccb uninstall rich` 后退回普通终端启动。默认 `ccb_self` 使用 `codex` 并绑定 `agentroles.ccb_self`。
-`.ccb/ccb.config` 主要配置这些内容：
-| 配置内容 | 写法或位置 | 说明 |
-| :--- | :--- | :--- |
-| window 分组 | `[windows]` | 把 agent 分到 `main`、`work`、`review`、`research` 等 tmux window。 |
-| agent 名称和 provider | `main:codex`、`reviewer:claude` | 名称用于界面、ask 路由和记忆文件；provider 决定启动哪家 CLI。 |
-| 工作区隔离 | `worker1:codex(worktree)` | 给实现类 agent 独立 git worktree，降低互相覆盖的风险。 |
-| sidebar 行为 | `[ui.sidebar]` | 控制 sidebar 是否每个 window 都显示、左右位置、宽度和 Comms 高度。 |
-| 工具 window | `[tool_windows.<name>]` | 添加 rich 富媒体工作台这类非 agent 托管 window；sidebar 只显示一行，不是 `ask` 目标。 |
-| 单 agent 模型/API | `[agents.<name>]` | 可为不同 agent 配 `model`、`key`、`url` 等。 |
-| Role Pack 绑定 | `agentroles.archi:codex` | 通过 window leaf 绑定可复用角色包；role 资产统一安装，再投影到解析出的 agent。 |
-| 角色说明 | `[agents.<name>] description = "..."` | 给 agent 一个简短职责说明；更长的工作流规则建议写到 memory。 |
-在已启动的项目里修改 `.ccb/ccb.config` 后，先运行 `ccb reload --dry-run` 预览计划，再运行 `ccb reload` 应用。显式 reload 可以动态新增 agent、新增 window、新增/删除托管工具 window、卸载 idle agent、删除 idle window，同时保持无关 agent 和 pane 继续运行。它不是后台文件监听；busy agent 卸载、provider 替换、agent 移动、工具命令替换和任意布局重排会被拒绝，不会 kill 现有 pane。
-如果你想先讨论配置而不是手写，可以直接让 `ccb_self` 描述目标团队。空白项目默认已经有这个路由；使用用户配置或项目配置覆盖内置默认的项目，如果还没有 `ccb_self`，需要先添加 `agentroles.ccb_self`。它的内置 `ccb-config` skill 会先提出完整方案，确认后再修改 `.ccb/ccb.config`。
-#### Role Packs
-Role Pack 通过 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)
-定义可复用的 agent 角色。这个规范是 host-neutral 的专业 agent 包格式：一个
-Role 可以把稳定身份、职责、非目标、记忆、skills、prompts、references、tools、
-plugin 内容、验证说明和 host adapter metadata 放进一个可审查的独立单元。
-它的意义是把边界分清楚：Role source 保持可移植、可版本化；项目绑定决定这个
-Role 挂载到哪里；provider 运行态、凭据、任务进度和生成的投影文件都留在 Role
-外部。这样专门 agent 更容易安装、更新、审计、迁移和卸载，不需要在每个项目里复制
-大段 prompt，也不会污染用户全局配置。
-推荐默认 catalog roles 包括 `agentroles.ccb_self` 和
-`agentroles.archi`：前者是 CCB 自维护角色，后者用于架构审查，来自
-`agent-roles-spec`，并由 Architec 支撑。`install.sh install` 默认会尝试安装
-或刷新这些推荐角色；`ccb update` 会在用户环境里刷新已安装 role，并安装缺失的
-推荐角色。也可以手动刷新：
-```bash
-ccb roles list
-ccb roles show agentroles.archi
-ccb roles install agentroles.archi
-ccb roles update agentroles.ccb_self
-ccb roles update agentroles.archi
-```
-项目内的 role 绑定仍由 `.ccb/role-lock.json` 固定。`ccb update` 不会改写项目
-锁。在项目内运行 `ccb` 时，CCB 会比较已绑定 role lock 和用户环境里当前安装的
-role；如果锁已经落后，交互式启动会询问是否就地刷新项目锁，非交互启动只打印
-提醒。
-强烈建议 CCB 项目保留 `ccb_self`，因为它是 CCB 内置专家 agent，携带 CCB
-项目配置、命令使用、role 绑定、reload 边界、运行诊断、受保护恢复、工作链修复和
-单 agent 重启辅助等专用知识，同时不接管业务任务。空白项目的内置默认配置已经
-包含它；已有项目，或使用用户配置/项目配置替换内置默认的项目，需要该维护 agent
-时应显式把它作为 window leaf 加进去：
-```bash
-ccb roles add agentroles.ccb_self:codex
-ccb reload
-```
-在项目里使用 `agentroles.archi` 时，把它作为 window leaf 加进去：
+#### 1.5 更新
+安装完成后，后续更新直接使用 CCB 自带 updater：
 ```bash
-ccb roles add agentroles.archi:codex
-ccb reload
-```
-这会写入紧凑形式 `agentroles.archi:codex`。运行时 CCB 会把它解析成项目本地
-agent `archi`，并把 role memory 和 skills 投影到该 agent 的 managed
-provider home。
-<details>
-<summary><b>配置格式示例：单窗口、多 window、per-agent 模型/API</b></summary>
-#### 单窗口紧凑配置
-```text
-cmd; main:codex, worker1:codex(worktree); reviewer:claude
+ccb update
 ```
-含义：
-- `cmd` 是 shell pane，不是 agent。
-- `main`、`worker1`、`reviewer` 是 agent 名称。
-- `codex`、`claude` 是 provider。
-- `;` 表示左右分栏，`,` 表示上下堆叠。
-- `(worktree)` 表示该 agent 使用独立 git worktree。
+<a id="创建项目配置"></a>
-#### 多 window 拓扑
+### 2. 创建项目配置
-当你想把规划、实现、审查、研究分到不同 tmux window 时，使用 `version = 2` 和 `[windows]`：
+在项目根目录创建 `.ccb/ccb.config`。推荐使用 v2 `[windows]` 拓扑：
+window 内的 agent 排布由 `,` 和 `;` 控制上下堆叠和左右分栏，例如 `A,B;C,D` 接近四宫格布局。
 ```toml
 version = 2
-entry_window = "main"
 [windows]
 main = "main:codex"
@@ -540,197 +211,72 @@ tips_height = "35%"
 comms_limit = 3
 ```
-注意：`cmd` 只属于紧凑/混合单窗口布局；`[windows]` 拓扑里不要写 `cmd`。
-#### Rich 富媒体工作台工具 window
-工具 window 是 CCB 管理的 tmux window，但不是 agent。它不会出现在 `ccb ask` 目标中，也不会创建 provider runtime 记录。
-```toml
-version = 2
-entry_window = "main"
-[windows]
-main = "main:codex"
-[tool_windows.rich]
-command = "CCB_WORKBENCH_PROFILE=rich CCB_WORKBENCH_FORCE_RICH=1 ccb-workbench files"
-label = "rich"
-```
-`ccb update rich` 会在 CCB 自己的 XDG 目录下准备可选工作台包，优先下载并验证可封装的二进制，只把 WezTerm、Markdown/PDF/图片/视频辅助工具和推荐字体等必要依赖交给平台包管理器。WSL 下可以调用 Windows 原生 `wezterm.exe`，同时让 rich 工具继续运行在当前 Linux 发行版内。普通 `ccb update` 不会主动安装或刷新该包；需要安装、修复或更新时重新运行 `ccb update rich`。运行 `ccb uninstall rich` 会移除该包，并让普通 `ccb` 回到常规终端启动。设置 `CCB_RICH_DOWNLOAD_BINARIES=0` 可跳过二进制下载，设置 `CCB_RICH_INSTALL_DEPS=0` 可跳过系统包安装。
-#### 给 agent 单独配置模型、API key 或 base URL
-如果只需要布局，用紧凑格式即可；如果某些 agent 需要单独模型或 API 路由，在紧凑头后追加 TOML overlay：
-```toml
-cmd; fast:codex, deep:codex; reviewer:claude
-[agents.fast]
-model = "gpt-5-mini"
-[agents.deep]
-key = "sk-..."
-url = "https://api.example.com/v1"
-model = "gpt-5"
-[agents.reviewer]
-model = "sonnet"
-```
-不要把真实 API key 提交到公开仓库。`key` / `url` 是 agent 级快捷字段；更复杂的 provider 环境变量应放到 provider profile 或 agent env 中。
-</details>
-### 使用 ccb_self 配置 CCB
-完整的 `ccb-config` skill 属于 `agentroles.ccb_self` 角色，不再作为所有 agent 都继承的公共 skill。CCB 默认会安装或刷新这个 Role Pack，空白项目的内置默认配置也会包含 `ccb_self`。已有项目，或使用用户配置/项目配置替换内置默认的项目，需要维护助手时应显式绑定它。
-`ccb_self` 不只是配置助手，它被设计成 CCB 的自理解 agent。使用 CCB 时遇到布局解释、团队拓扑选择、`.ccb/ccb.config` 迁移、运行态诊断、恢复路径或工作流修复问题，都可以先问它。
-如果你不想手写 `.ccb/ccb.config`，可以直接询问 `ccb_self`，再用自然语言描述项目目标、并行程度、窗口分组、worktree 隔离、provider/model/API 偏好。`ccb_self` 会使用它内置的 `ccb-config` 和你讨论后提出完整配置方案。
-示例：
-```bash
-ccb ask ccb_self "为一个 Python library 设计团队：main 负责任务拆分，三个 worker 使用 worktree 并行实现，一个 reviewer 做回归和风险审查。保留单窗口还是拆成 main/work/review 三个 window 由你建议。"
-```
-如果是尚未配置 `ccb_self` 的已有项目，先运行
-`ccb roles add agentroles.ccb_self:codex` 和 `ccb reload`。
-<details>
-<summary><b>ccb-config 的写入流程和边界</b></summary>
-1. 你用自然语言描述项目和团队目标。
-2. `ccb_self` 内置的 `ccb-config` 读取当前配置权威层，判断是新建、修改还是迁移。
-3. 它先提出完整配置方案，不应直接改文件。
-4. 你确认后，它只修改 `.ccb/ccb.config`。
-5. 它运行配置校验，并在可动态应用时提醒你使用 `ccb reload --dry-run` / `ccb reload` 生效。
-默认情况下，`ccb-config` 不会修改 `.ccb/ccb_memory.md` 或 `.ccb/agents/<agent>/memory.md`。只有当你明确要求 `ccb_self` “设计工作流记忆”或“写入角色记忆”时，才应该修改这些 memory 文件。
-</details>
-</details>
-<details>
-<summary><b>协作与维护</b></summary>
-### Agent 之间如何协作
-普通 `ask` 是提交即返回：把任务交给目标 agent 后，当前 agent 不应该轮询等待。
-| 场景 | 推荐方式 |
-| :--- | :--- |
-| 人直接指定目标 agent | `/ask reviewer ...` 或 `$ask reviewer ...` |
-| 当前 agent 在 active CCB task 内，必须等子任务结果才能回复 | `ask --callback reviewer` |
-| 当前 agent 派发独立任务，成功结果不需要回来 | `ask --silence worker1` |
-| 调试队列、诊断状态 | `pend`、`watch`、`ping` 等只作为诊断工具使用 |
-agent 提交子任务时，先按结果意图选参数，再按依赖关系和内容保真补充参数：
-| 需求 | 推荐参数 |
-| :--- | :--- |
-| 发布或执行任务，成功结果不需要回来 | `--silence` |
-| 需要简短结果：状态、发现、风险、阻塞、下一步 | `--compact` |
-| 需要完整咨询、分析、报告、生成文档或结构化结论 | `--artifact-reply` |
-| 当前 active 父任务必须等子任务结果才能继续 | 追加 `--callback` |
-| 需要保留精确粘贴的日志、diff、JSON/YAML、表格或复制文本 | 追加 `--artifact-request` |
-| 输入和输出都需要保真 | `--artifact-io` |
-| 只是短问题或短交接，行内文本足够 | 普通 `ask` |
-`--callback` 和 `--silence` 管任务关系；artifact 参数管内容保真。自动长消息
-spill 只是兜底，所以只要精确输入或完整输出重要，就应该主动使用 artifact 参数。
-<details>
-<summary><b>Callback 为什么重要</b></summary>
-如果 agent A 正在处理一个来自用户的 CCB task，又需要 agent B 的结果才能完成，就应该用 callback。CCB 会记录 parent/child 关系，让 A 当前 turn 结束；等 B 完成后，CCB 再把结果作为 continuation 交回 A。这样不会阻塞队列，也不会让 agent 靠轮询浪费上下文。
-</details>
-### 安装和更新
-#### 环境要求
-- 推荐 npm 安装路径需要 Node.js 和 npm
-- Python 3.10+
-- `tmux`
-- 至少一个你要使用的 agent CLI，例如 Codex、Claude、Gemini、Kimi、MiMo、Qwen、Cursor、Copilot、Crush、Kiro、Z.ai CLI、OpenCode、Droid 或 Antigravity
-- Linux、macOS 或 WSL
-当前 v7 / 新版本不声明原生 Windows 支持。原生 Windows 只支持到 v5 线；如果你在 Windows 上使用新版本，推荐使用 WSL，并让 `ccb` 与 agent CLI 都运行在 WSL 内。
-#### npm 优先
+如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API，可以直接问当前工作台里的 `ccb_self`。它是 CCB 内置的 self-agent，理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径，并能用私有 `ccb-config` skill 和你讨论后生成配置方案。空白项目默认包含 `ccb_self`。
-首次安装推荐使用 npm：
+验证配置：
 ```bash
-npm install -g @seemseam/ccb
+ccb config validate
 ```
-后续更新直接使用：
+启动工作台：
 ```bash
-ccb update
+ccb
 ```
-[GitHub Releases](https://github.com/bfly123/claude_code_bridge/releases) 仍作为不方便使用 npm 时的备选路径。源码 checkout 安装只适合开发、验证修复或临时兜底。
-#### 卸载
+### 3. 开始协作
-```bash
-ccb uninstall
-ccb reinstall
+你可以直接在某个 agent pane 里输入，也可以让 agent 之间协作：
-# 备用方式：在安装包或源码目录内
-./install.sh uninstall
+```text
+/ask reviewer review the latest parser changes and list blocking issues.
 ```
-### 常见问题
+也可以在工作编排中让 agent 自动调用 `/ask` 完成委派和交接。建议通过修改 agent 记忆或项目共享记忆 `.ccb/ccb_memory.md` 进行编排。
-<details>
-<summary><b>启动后没有看到预期 agent</b></summary>
+**后续超强编排正在开发中**
-先运行 `ccb config validate`，确认 `config_source_kind` 是你预期的层级。项目配置 `.ccb/ccb.config` 优先级最高；如果它不存在，CCB 才会使用 `~/.ccb/ccb.config` 或内置默认配置。
+### 4. Agent Roles Spec 规范和角色库
-</details>
+CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把专业角色打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
 <details>
-<summary><b>复制粘贴不好用</b></summary>
+<summary><b>当前角色库</b></summary>
-优先试鼠标拖选复制和 `Ctrl+Shift+V` / `Cmd+V` 粘贴。如果鼠标选择被 tmux 接管，使用 `<prefix>` 后的功能键 `[` 进入复制/滚动模式；如果只是想绕过 tmux，很多终端支持 `Shift + 鼠标拖选`。
+| Role | 基本功能 |
+| :--- | :--- |
+| `agentroles.ccb_self` | CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。 |
+| `agentroles.archi` | 架构审查、边界检查、耦合分析、可维护性风险和后续 gate 建议。 |
+| `agentroles.frontend_engineer` | 前端设计与实现、设计系统、可访问性、浏览器 QA 和受审查的 AGY 委派。 |
+| `agentroles.mobile_app_engineer` | iOS、Android、React Native、Expo、Flutter、SwiftUI、Jetpack Compose 等移动端设计与实现。 |
+| `agentroles.mother` | Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。 |
+| `agentroles.su_ccb` | SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。 |
 </details>
-<details>
-<summary><b>想把旧 compact 配置迁移到多 window</b></summary>
-让 `ccb_self` 使用它内置的 `ccb-config`，描述你想要的窗口分组，例如 main/work/review。迁移时应保留旧 agent 名称、provider、worktree 标记、model/key/url 等字段，确认后再写入 `[windows]`。
+### 5. 联系方式
-</details>
-<details>
-<summary><b>sidebar helper 不可用</b></summary>
+- Email: `bfly123@126.com`
+- **[Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)**
+- 微信: `seemseam-com`
-优先使用 release 包，因为 release 包会携带或处理 sidebar helper。源码安装时如果缺少可用的预编译 helper，可能需要本机 Rust 工具链来构建。
+<p align="center">
+  <img src="assets/weixin.jpg" alt="微信群" width="240">
+</p>
-</details>
+---
-### 社区和致谢
+### 6. 社区和致谢
 感谢 [Linux.do 社区](https://linux.do) 在测试、反馈和讨论中的支持。
 感谢 [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) 提供的 sidebar 思路和启发。
-</details>
 <details>
 <summary><b>版本记录</b></summary>
-### 新版本记录
+### 7. 新版本记录
 v7 线重点：
@@ -742,64 +288,6 @@ v7 线重点：
 - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
 <details open>
-<summary><b>v8.0.6</b> - CCB Mobile 真实项目对话稳定性</summary>
-- 改进 Android CCB Mobile 真实项目 pane-native 对话、状态恢复、
-  terminal stream、扫码/手动配对、输入体验、多语言和时间线噪音过滤。
-- 合入 CCB source 线上的 server-wide 项目列表、原生 provider transcript、
-  provider runtime status 和 mobile terminal pane input 修复。
-- `ccb update mobile` 改用紧凑终端配对二维码，保持原始 CCB Mobile 桥形图标，
-  并把相机不可用时的扫码失败改成可操作 fallback，避免展示 native 插件错误。
-- 同步 VERSION、package metadata、mobile app version metadata、README 链接、
-  workflow 默认值和 APK 下载链接到 8.0.6。
-</details>
-<details>
-<summary><b>v8.0.4</b> - CCB Mobile 项目列表稳定性</summary>
-- server-wide mobile gateway 的 `/v1/projects` 现在会并发检查已挂载项目健康状态，
-  同时保持 registry 顺序，避免项目较多时手机端加载超时或连接中断。
-- 手机断开或超时时，mobile gateway 不再为普通 BrokenPipe/connection reset
-  写出刷 traceback。
-</details>
-<details>
-<summary><b>v8.0.3</b> - npm Release Metadata 修复</summary>
-- 修复 npm provenance metadata，使 `@seemseam/ccb` 的发布仓库与 GitHub
-  Actions 使用的 canonical 仓库一致。
-- 同步 VERSION、package metadata、mobile app version metadata、README 链接、
-  workflow 默认值和 APK 下载链接到 8.0.3。
-</details>
-<details>
-<summary><b>v8.0.2</b> - Mobile Tailnet Onboarding 修复</summary>
-- 正确识别 Tailscale Serve 一次性授权链接，不再把原始 timeout 暴露给用户。
-- 如果 `:8787` 的 Tailscale Serve 代理已经正确指向 loopback mobile gateway，
-  `ccb update mobile` 会直接复用并进入配对二维码流程。
-- 修复 source worktree 安装时误复制 `.git` worktree 标记的问题，避免安装版
-  `ccb` 被误判为源码 checkout。
-</details>
-<details>
-<summary><b>v8.0.1</b> - CCB Mobile 极简配对</summary>
-- 将 `ccb update mobile` 收敛为唯一面向普通用户的设置入口：检测
-  Tailscale、引导登录/安装、启动 server-wide loopback gateway 和 Tailscale
-  Serve，并直接在终端打印配对二维码。
-- 手机端首次启动不再进入 fake/demo 项目，而是显示配对说明、Tailscale 下载提示
-  和扫码按钮。
-- 检测到已保存 pairing profile 后，手机端会自动进入 server-wide 已挂载项目列表，
-  降低普通手机使用的配置压力。
-</details>
-<details>
 <summary><b>v8.0.0</b> - CCB Mobile Monorepo 发布</summary>
 - Flutter 版 CCB Mobile 源码正式进入本仓库，并在 GitHub Release 中发布

package/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 8.0.6
1	+ 8.0.8

package/package.json CHANGED Viewed

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