@seemseam/ccb 8.0.7 → 8.0.8

package/README.md

@@ -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.7-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.7 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.7 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.7/ccb-mobile-v8.0.7.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,78 +801,6 @@ v7 highlights:
 - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
 
 <details open>
-<summary><b>v8.0.7</b> - CCB Mobile Notifications And Theme Stabilization</summary>
-
-- Adds server-wide task-completion notification SSE plus Android local notifications with low-sensitive payloads and verified tap routing back to the target project/agent.
-- Carries provider runtime status detection for mobile activity indicators and sidebar state.
-- Updates the mobile app with steel-blue/slate theming, improved readable content styles, height-limited expanded bubbles, and notification group tap handling.
-- Synchronizes VERSION, package metadata, mobile app version metadata, README links, workflow defaults, and APK download URLs for 8.0.7.
-
-</details>
-
-<details>
-<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

@@ -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.7-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` 作为项目锚点：
+#### 1.2 启动
 
-```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
-```
-
-启动工作台：
+在工作目录执行：
 
 ```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。 |
-
-<a id="rich-mode-new"></a>
+推荐使用手机控制 CCB：可以接入所有 CCB 项目，控制每个 agent，语音输入，并传递文件。
 
-### 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.7 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，
+CCB 8.0.8 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，
 并在 GitHub Release 中发布 Android APK：
 
-- [下载 CCB Mobile v8.0.7 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.7/ccb-mobile-v8.0.7.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
 ```
 
-含义：
+<a id="创建项目配置"></a>
 
-- `cmd` 是 shell pane，不是 agent。
-- `main`、`worker1`、`reviewer` 是 agent 名称。
-- `codex`、`claude` 是 provider。
-- `;` 表示左右分栏，`,` 表示上下堆叠。
-- `(worktree)` 表示该 agent 使用独立 git worktree。
-
-#### 多 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>
+### 5. 联系方式
 
-让 `ccb_self` 使用它内置的 `ccb-config`，描述你想要的窗口分组，例如 main/work/review。迁移时应保留旧 agent 名称、provider、worktree 标记、model/key/url 等字段，确认后再写入 `[windows]`。
-
-</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,74 +288,6 @@ v7 线重点：
 - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
 
 <details open>
-<summary><b>v8.0.7</b> - CCB Mobile 通知与主题稳定化</summary>
-
-- 新增 server-wide 任务完成通知 SSE 和 Android 本地通知，payload 保持低敏，并已真实验证点击回到目标 project/agent。
-- 合入 provider runtime 状态判断，供手机 activity indicator 和 sidebar 状态使用。
-- 更新手机 App 的 steel-blue/slate 主题、正文样式、展开气泡高度限制和通知分组点击处理。
-- 同步 VERSION、package metadata、mobile app 版本、README 链接、workflow 默认值和 APK 下载链接到 8.0.7。
-
-</details>
-
-<details>
-<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

@@ -1 +1 @@
-8.0.7
+8.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seemseam/ccb",
-  "version": "8.0.7",
+  "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",