@seemseam/ccb 8.0.19 → 8.1.1

package/README.md

@@ -1,20 +1,21 @@
 <div align="center">
 
-# CCB 手机 App 来了！
+# CCB - Mobile Has Arrived!
 
-**基于去中心化多 Agent 设计**
-**可见、可控的多 Agent 交互 TUI 工作台**
+**A lightweight multi-agent TUI with a stable cross-provider collaboration layer**<br>
+**Coordinate Codex, Claude, Gemini, and other CLI agents in visible, controllable workflows you can take over**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.0.19-orange.svg" alt="version">
+  <img src="https://img.shields.io/badge/version-8.1.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-15%20CLI%20families-0B7285.svg" alt="providers">
+  <img src="https://img.shields.io/badge/providers-17%20CLI%20families-0B7285.svg" alt="providers">
 </p>
 
 <p>
   <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
   <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
   <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Grok-000000?style=flat-square&logo=x&logoColor=white" alt="Grok CLI">
   <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
   <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
   <img src="https://img.shields.io/badge/Qwen-6A5CFF?style=flat-square" alt="Qwen">
@@ -29,46 +30,46 @@
   <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
 </p>
 
-**中文** | [English](readme_en.md) | [日本語](readme_ja.md) | [Français](readme_fr.md) | [Deutsch](readme_de.md) | [العربية](readme_ar.md) | [Español](readme_es.md) | [Português](readme_pt.md) | [한국어](readme_ko.md) | [Русский](readme_ru.md)
+[中文](README/zh.md) | **English** | [日本語](README/ja.md) | [Français](README/fr.md) | [Deutsch](README/de.md) | [العربية](README/ar.md) | [Español](README/es.md) | [Português](README/pt.md) | [한국어](README/ko.md) | [Русский](README/ru.md)
 
-[快速开始](#quick-start) · [Mobile App](#mobile-app) · [Rich 模式](#rich-mode) · [配置团队](#configure-agents) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
+[Quick Start](#quick-start) · [Mobile App](#mobile-app) · [Rich Mode](#rich-mode) · [Configure Agents](#configure-agents) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
 
 <p align="center">
-  <img src="assets/readme_v7/ccb-hero-zh-light.png" alt="CCB 可见多 Agent CLI 工作台" width="960">
+  <img src="assets/readme_v7/ccb-hero-en-light.png" alt="CCB visible multi-agent CLI workspace" width="960">
 </p>
 
 </div>
 
 <a id="why-ccb"></a>
 
-## 为什么用 CCB？
+## Why CCB?
 
-- 强稳定的 agent 间通信能力，支持 `A -> B -> C`、`A,B -> C`、`A -> B,C` 等复杂协作关系。
-- 每个 agent 都是完整原生终端，支持可见的界面排布和直接接管。
-- 后台 daemon 持续运行，可以脱离前台界面保持项目状态。
-- Hub 能力：一个命令同时并发运行多家 CLI provider。
-- 手机远程控制器：跨 provider 语音操控、文件传输和远程终端访问。
+- Stable inter-agent communication for complex collaboration graphs such as `A -> B -> C`, `A,B -> C`, and `A -> B,C`.
+- Every agent is a full native terminal with visible layout control and direct takeover.
+- The background daemon keeps project state alive even when the foreground UI is closed.
+- Hub capability: run multiple CLI providers concurrently from one command.
+- Mobile remote controller: cross-provider voice control, file transfer, and remote terminal access.
 
 <a id="how-to-install"></a>
 
-## 如何安装
+## How to Install
 
-推荐使用 npm 安装或更新：
+Install or update with npm:
 
 ```bash
 npm install -g @seemseam/ccb
 ```
 
-安装完成后，后续更新直接使用 CCB 自带 updater：
+After CCB is installed, use CCB's updater:
 
 ```bash
 ccb update
 ```
 
 <details>
-<summary><b>GitHub release 包和源码安装兜底</b></summary>
+<summary><b>GitHub release package and source install fallbacks</b></summary>
 
-如果当前环境不方便使用 npm，可以到 [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) 下载与你的平台匹配的包，解压后安装：
+If npm is not convenient in your environment, download the matching package from [Releases](https://github.com/SeemSeam/claude_codex_bridge/releases), unpack it, and install:
 
 ```bash
 tar -xzf ccb-*.tar.gz
@@ -76,7 +77,7 @@ cd ccb-*
 ./install.sh install
 ```
 
-源码安装只建议开发或临时兜底使用：
+Source install is intended only for development or temporary fallback:
 
 ```bash
 git clone https://github.com/SeemSeam/claude_codex_bridge.git
@@ -84,23 +85,23 @@ cd claude_codex_bridge
 ./install.sh install
 ```
 
-源码安装会让全局 `ccb` / `ask` 链接回当前 checkout。普通用户更建议使用 npm 包。
+Source install links global `ccb` / `ask` back to the checkout. Regular users should prefer the npm package.
 
 </details>
 
 <a id="quick-start"></a>
 
-## 快速开始
+## Quick Start
 
-### 1. 启动
+### 1. Launch
 
-在工作目录执行：
+Run this from your working directory:
 
 ```bash
 ccb
 ```
 
-如果启动时提示无法自动创建 `.ccb` 或找不到项目锚点，需要手动创建 `.ccb` 作为项目锚点：
+If startup reports that `.ccb` cannot be created automatically or that the project anchor is missing, create `.ccb` manually:
 
 ```bash
 mkdir -p .ccb
@@ -108,9 +109,19 @@ mkdir -p .ccb
 
 <a id="configure-agents"></a>
 
-### 2. 创建项目配置
+### 2. Configure The Workspace
 
-在项目根目录创建 `.ccb/ccb.config`。推荐使用 v2 `[windows]` 拓扑：window 内的 agent 排布由 `,` 和 `;` 控制上下堆叠和左右分栏，例如 `A,B;C,D` 接近四宫格布局。
+A blank project starts light: CCB opens one `main` window with a single agent named `demo`, selecting the first supported CLI available on the machine (Codex, Claude, Gemini, then other providers). It no longer mounts a multi-agent team by default.
+
+Click the **⚙ Settings** icon at the top-left of the CCB sidebar to open the local configuration control panel. You can also run `ccb config ui` from the project directory.
+
+<p align="center">
+  <img src="assets/readme_v7/config-control-panel.png" alt="CCB configuration control panel editing the default demo agent" width="960">
+</p>
+
+The panel edits windows, pane splits, providers, models, thinking levels, API overrides, workspaces, Rich mode, and sidebar settings. It validates changes before saving and supports reload dry-runs and guarded hot reload. Saving creates `.ccb/ccb.config` and pins the selected provider and topology for this project.
+
+For an advanced multi-agent topology, edit it visually or create `.ccb/ccb.config` manually. In v2 `[windows]`, `,` and `;` control vertical stacking and horizontal splits inside each window, so `A,B;C,D` is close to a four-pane layout.
 
 ```toml
 version = 2
@@ -130,206 +141,221 @@ tips_height = "35%"
 comms_limit = 3
 ```
 
-验证配置并启动工作台：
+Validate the config and start the workspace:
 
 ```bash
 ccb config validate
 ccb
 ```
 
-### 3. 开始协作
+### 3. Collaborate
 
-你可以直接在某个 agent pane 里输入，也可以让 agent 之间协作：
+You can type directly in any agent pane, or let agents collaborate:
 
 ```text
 /ask reviewer review the latest parser changes and list blocking issues.
 ```
 
-也可以在工作编排中让 agent 自动调用 `/ask` 完成委派和交接。建议通过修改 agent 记忆或项目共享记忆 `.ccb/ccb_memory.md` 进行编排。
+Agents can also call `/ask` during workflow orchestration to delegate and hand off work. Use agent memory or the project-wide shared memory file `.ccb/ccb_memory.md` for durable coordination.
 
 <a id="mobile-app"></a>
 
-## 手机远程控制（Android）
+## Mobile Remote Control (Android)
 
-推荐使用手机控制 CCB：可以接入所有 CCB 项目，控制每个 agent，语音输入，并传递文件。
+The recommended way to control CCB from a phone can connect to all CCB projects, control each agent, accept voice input, and transfer files.
 
 ```bash
 ccb update mobile
 ```
 
-该命令会指导你完成安装和配置。
+This command guides installation and configuration.
 
 <p align="center">
-  <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">
+  <img src="assets/readme_v7/mobile-control-chat.jpg" alt="CCB Mobile agent chat" 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>
 
 <details>
-<summary><b>Mobile App 详情、安全边界和源码</b></summary>
+<summary><b>Mobile App details, safety boundary, and source</b></summary>
 
-CCB 8.0.19 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，并在 GitHub Release 中发布 Android APK：
+CCB 8.1.1 includes the Flutter CCB Mobile source in [`mobile/`](mobile/) and publishes the Android APK through GitHub Releases:
 
-- [下载 CCB Mobile v8.0.19 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.0.19/ccb-mobile-v8.0.19.apk)
-- App 源码：[`mobile/app`](mobile/app)
-- 服务端 gateway 源码：[`lib/mobile_gateway`](lib/mobile_gateway)
+- [Download CCB Mobile v8.1.1 APK](https://github.com/SeemSeam/claude_codex_bridge/releases/download/v8.1.1/ccb-mobile-v8.1.1.apk)
+- App source: [`mobile/app`](mobile/app)
+- Server gateway source: [`lib/mobile_gateway`](lib/mobile_gateway)
 
-手机端定位是远程控制真实服务器上的 CCB 项目。它可以从 server-wide mobile gateway 获取所有已挂载项目，切换 window/agent，渲染 agent 对话上下文，以 pane-native 输入方式发送文本，打开 terminal 视图，并通过认证 gateway 上传/下载图片和文档附件。
+The phone app is a remote controller for real CCB projects running on a server. It can discover mounted projects from the server-wide mobile gateway, switch windows and agents, render agent conversation context, send text through pane-native input, open a terminal view, and upload/download images and documents through the authenticated gateway.
 
-安全边界：
+Safety boundary:
 
-- CCB gateway 只绑定 loopback，例如 `127.0.0.1:8787`。
-- 远程访问使用 Tailscale Serve，不启用 Tailscale Funnel。
-- CCB 不保存 Tailscale 密码、OAuth token、admin API token，也不会自动修改 tailnet ACL/grants。
-- 手机只获得 pairing profile 授权的 scope，例如 view、content、terminal、file upload 和 file download。
+- The CCB gateway binds only to loopback, for example `127.0.0.1:8787`.
+- Remote access uses Tailscale Serve, not Tailscale Funnel.
+- CCB does not store Tailscale passwords, OAuth tokens, admin API tokens, or automatically modify tailnet ACLs/grants.
+- The phone receives only the scopes authorized by the pairing profile, such as view, content, terminal, file upload, and file download.
 
 </details>
 
 <a id="rich-mode"></a>
 
-## Rich 富媒体终端
+## Rich Media Terminal
 
-在终端查看文件结构、打开文件、编辑文档和预览媒体内容。
+Browse file trees, open files, edit documents, and preview media inside the terminal.
 
 <p align="center">
-  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
+  <img src="assets/readme_v7/rich-workbench.png" alt="CCB rich media workbench using Yazi preview in WezTerm" width="860">
 </p>
 
 ```bash
 ccb update rich
 ```
 
-rich 启用后，普通 `ccb` 会自动打开 rich WezTerm launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；运行 `ccb uninstall rich` 可退回普通终端启动。
+After rich mode is enabled, plain `ccb` opens the rich WezTerm launcher automatically unless it is already running inside a CCB-managed rich WezTerm session. Run `ccb uninstall rich` to return to normal terminal startup.
 
 <a id="agent-roles"></a>
 
-## Agent Roles Spec 规范和角色库
+## Agent Roles Spec And Role Catalog
 
-CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把 skills、记忆和工具依赖打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
+CCB supports [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec), a host-neutral specification for packaging specialist agents. It can bundle skills, memory, and tool dependencies into installable, mountable, and removable Role Packs. That repository also serves as the public role catalog.
 
 <details>
-<summary><b>查看公开角色列表</b></summary>
+<summary><b>View the public role catalog</b></summary>
 
-| Role | 基本功能 |
+| Role | Purpose |
 | :--- | :--- |
-| `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、归档和恢复。 |
+| `agentroles.ccb_self` | CCB self-maintenance, config help, runtime diagnosis, protected recovery, and workflow orchestration. |
+| `agentroles.archi` | Architecture review, boundary checks, coupling analysis, maintainability risks, and follow-up gate advice. |
+| `agentroles.frontend_engineer` | Frontend design and implementation, design systems, accessibility, browser QA, and reviewed AGY delegation. |
+| `agentroles.mobile_app_engineer` | Mobile design and implementation for iOS, Android, React Native, Expo, Flutter, SwiftUI, Jetpack Compose, and more. |
+| `agentroles.mother` | Role creation, role source audit, role research, blueprint design, and Agent Roles spec compliance checks. |
+| `agentroles.su_ccb` | SU-CCB workflow operations for requirement analysis, planning, dispatch, review gates, archiving, and recovery. |
 
 </details>
 
 <a id="config-memory"></a>
 
-## 配置和共享记忆
+## Config And Shared Memory
 
-如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API，可以直接问当前工作台里的 `ccb_self`。它是 CCB 内置的 self-agent，理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径，并能用私有 `ccb-config` skill 和你讨论后生成配置方案。空白项目默认包含 `ccb_self`；已有自定义配置可以用 `ccb roles add agentroles.ccb_self:codex` 添加。
+Use the **⚙ Settings** control panel for normal project configuration. If you want agent-assisted configuration and runtime diagnosis, `ccb_self` remains available as an optional Role Pack and can be added with `ccb roles add agentroles.ccb_self:codex`.
 
-`.ccb/ccb_memory.md` 是项目级共享记忆文档，适合记录团队协作规则、项目约束、长期上下文和 agent 交接约定。把跨 agent 的稳定信息放在这里，比把同一段说明复制到多个 provider 私有记忆里更可靠。
+`.ccb/ccb_memory.md` is the project-wide shared memory document. Use it for team collaboration rules, project constraints, long-lived context, and agent handoff conventions. Stable cross-agent information belongs there instead of being copied into several provider-private memory files.
 
 <a id="contact"></a>
 
-## 联系方式
+## Contact
 
 - Email: `bfly123@126.com`
 - [Telegram group & contact / TG 群与联系](https://t.me/+BKn03v8I_ehmYzRk)
-- 微信: `seemseam-com`
+- WeChat: `seemseam-com`
 
 <p align="center">
-  <img src="assets/weixin.jpg" alt="微信群" width="240">
+  <img src="assets/weixin.jpg" alt="WeChat group" width="240">
 </p>
 
 <a id="community"></a>
 
-## 社区和致谢
+## Community And Credits
 
-感谢 [Linux.do 社区](https://linux.do) 在测试、反馈和讨论中的支持。
+Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and discussion.
 
-感谢 [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) 提供的 sidebar 思路和启发。
+Thanks to [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) for sidebar ideas and inspiration.
 
 <a id="release-notes"></a>
 
-## 新版本记录
+## Release Notes
 
 <details open>
-<summary><b>v8.0.19</b> - Mobile host 启动健康检查修复</summary>
+<summary><b>v8.1.1</b> - Mobile realtime recovery and macOS installer resilience</summary>
+
+- Added a bounded Mobile gateway SSE invalidation stream so project, activity, and conversation changes refresh authoritative state without active-view polling.
+- Added bounded read-only Mobile snapshots, reconnect status and automatic recovery while retaining the selected host, project, agent, recent conversation state, and completion notifications.
+- Mobile host startup now recognizes and safely adopts matching legacy gateway processes, avoiding duplicate listeners during upgrades.
+- macOS release updates preserve healthy managed Python environments and retry `watchdog` installation through a configurable mirror after TLS or network failures.
+
+</details>
+
+<details>
+<summary><b>v8.1.0</b> - Config control plane and lighter defaults</summary>
+
+- Added a visual project configuration control panel, opened from the sidebar's top-left **⚙ Settings** action or with `ccb config ui`, with validation, diff review, save, reload dry-run, and guarded hot reload.
+- Blank projects now mount exactly one agent named `demo`, selecting the first locally available supported CLI; explicit project and user configs still support any single- or multi-agent topology.
+- Added managed Grok CLI integration, Kimi Code v0.23.1 readiness support, correct OpenCode fresh-session behavior, and reliable Claude/Gemini hook launcher execution.
+- Improved CCB Mobile gateway profile persistence, paired-credential retention, project health caching, warm-list visibility, and terminal UI efficiency.
+- Reorganized localized READMEs under `README/`, added the real config-control screenshot, and synchronized package, Mobile, workflow, and release metadata for 8.1.0.
+
+</details>
+
+<details>
+<summary><b>v8.0.19</b> - Mobile host startup health-check fix</summary>
 
-- `ccb update mobile` 对 server-wide loopback `/v1/health` 使用更宽松的单次请求超时和总启动等待窗口，避免挂载项目较多时误判后台 gateway 不健康。
-- 新增 regression test 覆盖健康响应晚于旧 0.5 秒请求超时时仍应启动成功。
-- `ccb update mobile` 默认 APK 下载链接、README、package metadata 和 mobile app version metadata 对齐到 8.0.19。
+- `ccb update mobile` now uses more tolerant per-request and overall startup timeouts for the server-wide loopback `/v1/health` endpoint, avoiding false failures when many projects are mounted.
+- Added a regression test covering health responses that arrive after the previous 0.5-second request timeout.
+- The default APK URL, README, package metadata, and mobile app version metadata now point to 8.0.19.
 
 </details>
 
 <details>
-<summary><b>v8.0.18</b> - Codex auth 投影与 Mobile host health 修复</summary>
+<summary><b>v8.0.18</b> - Codex auth projection and Mobile host health fixes</summary>
 
-- Codex managed `CODEX_HOME` materialize 阶段会同步 `auth.json`、`config.toml`、`company-codex-api-key`、`company-codex.config.toml`，以及 `config.toml` 中引用到的安全 auth/key/token sidecar 文件名。
-- 新增 `.ccb-auth-projection.json` 证据 manifest，只记录来源/目标存在性、大小和 SHA256，不保存密钥明文。
-- 显式 Codex API authority 会清理继承来的 auth sidecar，避免全局登录态和 agent-local API 配置混用。
-- WSL 下 Codex 解析到 Windows interop 可执行文件时，`ccb doctor` 会标记 `reason=wsl_windows_interop_executable`。
-- server-wide mobile 项目发现会容忍 stale project 记录，避免单个失效项目拖垮整体列表。
-- README 角色列表改为折叠显示，并更新联系方式中的微信图片。
-- `ccb update mobile` 默认 APK 下载链接、README、package metadata 和 mobile app version metadata 对齐到 8.0.18。
+- Managed Codex homes now project `auth.json`, `config.toml`, company API sidecars, and safe auth/key/token sidecar filenames referenced by `config.toml`.
+- Added `.ccb-auth-projection.json` evidence manifests that record source and target presence, size, and SHA256 without storing secret values.
+- Explicit Codex API authority clears inherited auth sidecars, WSL diagnostics identify Windows interop executables, and server-wide mobile discovery tolerates stale project records.
+- The role catalog is now collapsed by default, the WeChat image is refreshed, and mobile release metadata points to 8.0.18.
 
 </details>
 
 <details>
-<summary><b>v8.0.17</b> - Ask 回复稳定性与 Mobile 更新修复</summary>
+<summary><b>v8.0.17</b> - Ask reply reliability and Mobile update fixes</summary>
 
-- Codex ask 回复检测改为基于无进展时间，长 session 文件持续写入时不会按提交时间误失败。
-- 官方 session/log 缺失时返回可诊断的非成功状态，避免 silent stuck；明确 shutdown 时标记为 provider crashed。
-- Mobile frontdesk 消息提交改走 ccbd ask job，不再直接写 pane。
-- `ccb watch` 默认不再 10 秒超时，`ccb update mobile` 等长等待路径可以等到真实终态；显式 `CCB_WATCH_TIMEOUT_S` 仍会生效。
-- `ccb update mobile` 默认 APK 下载链接、README、package metadata 和 mobile app version metadata 对齐到 8.0.17。
+- Codex ask completion now uses no-progress time, so actively growing long-session files do not fail based only on submission age.
+- Missing official session or log evidence returns a diagnosable non-success state, while explicit shutdown is reported as a provider crash.
+- Mobile frontdesk submissions use ccbd ask jobs, and `ccb watch` no longer defaults to a 10-second timeout.
 
 </details>
 
 <details>
-<summary><b>v8.0.16</b> - Mobile 重连与 pane 活动记录</summary>
+<summary><b>v8.0.16</b> - Mobile reconnect and pane activity tracking</summary>
 
-- CCB Mobile Terminal 模式增加自动重连诊断与恢复路径，断线时会显示 Reconnecting，并在恢复后继续使用当前 agent pane。
-- mobile gateway 在 pane 输入路径记录项目活动，保证 mobile 项目列表最近使用排序能感知 Terminal 输入。
-- `ccb update mobile` 默认 APK 下载链接、README、package metadata 和 mobile release manifest 对齐到 8.0.16。
+- CCB Mobile Terminal mode adds reconnect diagnostics and recovery while keeping the current agent pane selected.
+- Pane-native mobile input now records project activity so project recency reflects Terminal usage.
 
 </details>
 
 <details>
-<summary><b>v8.0.12</b> - Release CI 可移植性与 README 多语言同步</summary>
+<summary><b>v8.0.12</b> - Release CI portability and README localization</summary>
 
-- mobile host registry 测试现在把临时 Unix socket 放到短的 `/tmp/ccb-sock-*` 路径，避免 macOS CI 触发 `AF_UNIX path too long`。
-- `ccb update mobile`、README 链接、package metadata 和 mobile release manifest 对齐到 8.0.12 APK。
-- 中文 README 现在是 GitHub 主 README；英文迁移到 `readme_en.md`，并新增日语、法语、德语、阿拉伯语、西班牙语、葡萄牙语、韩语和俄语版本，所有语言保持同一章节结构。
+- Mobile host registry tests now place temporary Unix sockets under a short `/tmp/ccb-sock-*` path, avoiding `AF_UNIX path too long` failures on macOS CI.
+- `ccb update mobile`, README links, package metadata, and the mobile release manifest now point to the 8.0.12 APK.
+- v8.0.12 introduced a multilingual README set with a shared section structure; localized files now live under [`README/`](README/), with Chinese at [`README/zh.md`](README/zh.md).
 
 </details>
 
 <details>
-<summary><b>v8.0.0</b> - CCB Mobile Monorepo 发布</summary>
+<summary><b>v8.0.0</b> - CCB Mobile Monorepo release</summary>
 
-- Flutter 版 CCB Mobile 源码正式进入本仓库，并在 GitHub Release 中发布 Android APK。
-- 新增 server-wide mobile 项目发现、配对、认证 gateway 路由、pane-native 消息输入、对话上下文渲染、terminal 访问，以及图片/文档上传下载能力。
-- 将 `ccb update mobile` 提升为 Tailscale Tailnet onboarding 的统一入口，同时保持 gateway 仅监听 loopback，不启用 Funnel、不保存 token、不自动修改 ACL/grants。
+- The Flutter CCB Mobile source officially moved into this repository, with the Android APK published through GitHub Releases.
+- Added server-wide mobile project discovery, pairing, authenticated gateway routes, pane-native message input, conversation context rendering, terminal access, and image/document upload and download.
+- Promoted `ccb update mobile` into the unified Tailscale Tailnet onboarding entrypoint while keeping the gateway loopback-only, avoiding Funnel, not storing tokens, and not automatically modifying ACLs/grants.
 
 </details>
 
 <details>
-<summary><b>v7.7.0</b> - Runtime Accelerator 发布加固</summary>
+<summary><b>v7.7.0</b> - Runtime Accelerator release hardening</summary>
 
-- Release artifacts 现在会携带可选 Rust `ccb-runtime-accelerator`，安装版 Codex agent 在预期存在 sidecar 时不再静默退回 Python 热路径。
-- 当项目路径导致 Unix socket 路径过长时，accelerator socket 会自动落到短的 per-user runtime socket root。
-- 加固 callback repair 和 Codex binding cache invalidation，并记录完整回归、长 idle Codex soak、Claude callback 和混合 provider 集成测试证据。
+- Release artifacts now include the optional Rust `ccb-runtime-accelerator`; installed Codex agents no longer silently fall back to the Python hot path when the sidecar is expected.
+- When a project path makes the Unix socket path too long, the accelerator socket automatically moves to a short per-user runtime socket root.
+- Hardened callback repair and Codex binding cache invalidation, with recorded regression, long-idle Codex soak, Claude callback, and mixed-provider integration evidence.
 
 </details>
 
 <details>
-<summary><b>v7.6.19</b> - 长任务 ask 默认等待策略</summary>
+<summary><b>v7.6.19</b> - Long-running ask default wait policy</summary>
 
-- 普通长时间 `ask` 默认继续等待真实 provider/completion 结果，不再仅因 heartbeat 诊断自动 terminalize 为 `incomplete/heartbeat_timeout`。
-- Codex、Claude、Gemini 的 pane-backed no-terminal timeout 默认改为显式 opt-in，仍保留显式 reliability timeout 策略。
-- 已用 32 分钟 source-runtime ask smoke 验证：任务超过 30 分钟仍保持 running，随后以 `result_message` 完成，未出现 `heartbeat_timeout` 或 `incomplete` 证据。
+- Regular long-running `ask` calls now continue waiting for real provider/completion results instead of terminalizing as `incomplete/heartbeat_timeout` only because of heartbeat diagnostics.
+- Codex, Claude, and Gemini pane-backed no-terminal timeouts are now explicit opt-in by default, while explicit reliability timeout policies remain available.
+- A 32-minute source-runtime ask smoke confirmed that a task can remain running for more than 30 minutes, then complete with `result_message`, without `heartbeat_timeout` or `incomplete` evidence.
 
 </details>
 
-完整历史请看 [CHANGELOG.md](CHANGELOG.md)。
+See the full history in [CHANGELOG.md](CHANGELOG.md).

package/VERSION

@@ -1 +1 @@
-8.0.19
+8.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seemseam/ccb",
-  "version": "8.0.19",
-  "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.",
+  "version": "8.1.1",
+  "description": "Lightweight multi-agent TUI and stable cross-provider collaboration layer for Codex, Claude, Gemini, Grok, Kimi, DeepSeek, and other CLI agents.",
   "license": "AGPL-3.0-only",
   "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",
   "repository": {
@@ -17,7 +17,9 @@
     "codex",
     "claude",
     "gemini",
+    "grok",
     "kimi",
+    "deepseek",
     "mimo",
     "qwen",
     "cursor",
@@ -43,8 +45,8 @@
     "bin/ctx-transfer.js",
     "bin/ccb-npm-install.js",
     "bin/ccb-npm-runner.js",
-    "README*.md",
-    "readme_*.md",
+    "README.md",
+    "README/*.md",
     "LICENSE",
     "VERSION"
   ],