@seemseam/ccb 8.0.19 → 8.1.1

package/{README_zh.md → README/zh.md}

@@ -2,19 +2,20 @@
 
 # CCB 手机 App 来了！
 
-**基于去中心化多 Agent 设计**
-**可见、可控的多 Agent 交互 TUI 工作台**
+**轻快的多 Agent TUI，稳定的跨 Provider 协作底座**<br>
+**让 Codex、Claude、Gemini 等 CLI Agent 可见、可控、可接管地协同工作**
 
 <p>
-  <img src="https://img.shields.io/badge/version-8.0.15-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,12 +30,12 @@
   <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)
+**中文** | [English](../README.md) | [日本語](ja.md) | [Français](fr.md) | [Deutsch](de.md) | [العربية](ar.md) | [Español](es.md) | [Português](pt.md) | [한국어](ko.md) | [Русский](ru.md)
 
-[快速开始](#quick-start) · [Mobile App](#mobile-app) · [Rich 模式](#rich-mode) · [配置团队](#configure-agents) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
+[快速开始](#quick-start) · [Mobile App](#mobile-app) · [Rich 模式](#rich-mode) · [配置团队](#configure-agents) · [使用文档](../docs/manuals/user-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-zh-light.png" alt="CCB 可见多 Agent CLI 工作台" width="960">
 </p>
 
 </div>
@@ -108,9 +109,19 @@ mkdir -p .ccb
 
 <a id="configure-agents"></a>
 
-### 2. 创建项目配置
+### 2. 配置工作台
 
-在项目根目录创建 `.ccb/ccb.config`。推荐使用 v2 `[windows]` 拓扑：window 内的 agent 排布由 `,` 和 `;` 控制上下堆叠和左右分栏，例如 `A,B;C,D` 接近四宫格布局。
+空白项目现在会轻量启动：CCB 只打开一个 `main` window，并根据本机实际可用的 CLI（依次优先 Codex、Claude、Gemini，再到其他 provider）创建一个名为 `demo` 的 agent，不再默认挂载多 Agent 团队。
+
+点击 CCB sidebar 左上角的 **⚙ 设置** 图标即可打开本地配置控制面；也可以在项目目录运行 `ccb config ui`。
+
+<p align="center">
+  <img src="../assets/readme_v7/config-control-panel.png" alt="CCB 配置控制面正在编辑默认 demo agent" width="960">
+</p>
+
+控制面可以配置 windows、pane 拆分、provider、模型、thinking 等级、API 覆盖、workspace、Rich 模式和 sidebar；保存前会先校验，并支持 reload dry-run 和受保护的热加载。保存后会生成 `.ccb/ccb.config`，将当前 provider 和拓扑固定为项目配置。
+
+需要高级多 Agent 拓扑时，可以继续在控制面中可视化添加，或手动创建 `.ccb/ccb.config`。v2 `[windows]` 中的 `,` 和 `;` 分别控制 window 内的上下堆叠和左右分栏，例如 `A,B;C,D` 接近四宫格布局。
 
 ```toml
 version = 2
@@ -160,20 +171,20 @@ ccb update mobile
 该命令会指导你完成安装和配置。
 
 <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 对话" 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>
 
 <details>
 <summary><b>Mobile App 详情、安全边界和源码</b></summary>
 
-CCB 8.0.15 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，并在 GitHub Release 中发布 Android APK：
+CCB 8.1.1 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](../mobile/)，并在 GitHub Release 中发布 Android APK：
 
-- [下载 CCB Mobile v8.0.15 APK](https://github.com/bfly123/claude_code_bridge/releases/download/v8.0.15/ccb-mobile-v8.0.15.apk)
-- App 源码：[`mobile/app`](mobile/app)
-- 服务端 gateway 源码：[`lib/mobile_gateway`](lib/mobile_gateway)
+- [下载 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 源码：[`mobile/app`](../mobile/app)
+- 服务端 gateway 源码：[`lib/mobile_gateway`](../lib/mobile_gateway)
 
 手机端定位是远程控制真实服务器上的 CCB 项目。它可以从 server-wide mobile gateway 获取所有已挂载项目，切换 window/agent，渲染 agent 对话上下文，以 pane-native 输入方式发送文本，打开 terminal 视图，并通过认证 gateway 上传/下载图片和文档附件。
 
@@ -193,7 +204,7 @@ CCB 8.0.15 已把 Flutter 版 CCB Mobile 源码放入 [`mobile/`](mobile/)，并
 在终端查看文件结构、打开文件、编辑文档和预览媒体内容。
 
 <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 富媒体工作台在 WezTerm 中使用 Yazi 预览" width="860">
 </p>
 
 ```bash
@@ -208,6 +219,9 @@ rich 启用后，普通 `ccb` 会自动打开 rich WezTerm launcher，只有当
 
 CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：这是一个 host-neutral 的专业 agent 封装规范，可把 skills、记忆和工具依赖打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。
 
+<details>
+<summary><b>查看公开角色列表</b></summary>
+
 | Role | 基本功能 |
 | :--- | :--- |
 | `agentroles.ccb_self` | CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。 |
@@ -217,11 +231,13 @@ CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：
 | `agentroles.mother` | Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。 |
 | `agentroles.su_ccb` | SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。 |
 
+</details>
+
 <a id="config-memory"></a>
 
 ## 配置和共享记忆
 
-如果你不确定应该如何分组、要几个 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` 添加。
+普通项目配置推荐直接使用左上角的 **⚙ 设置** 控制面。如果希望由 Agent 辅助设计配置或诊断运行状态，`ccb_self` 仍作为可选 Role Pack 提供，可以用 `ccb roles add agentroles.ccb_self:codex` 添加。
 
 `.ccb/ccb_memory.md` 是项目级共享记忆文档，适合记录团队协作规则、项目约束、长期上下文和 agent 交接约定。把跨 agent 的稳定信息放在这里，比把同一段说明复制到多个 provider 私有记忆里更可靠。
 
@@ -234,7 +250,7 @@ CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：
 - 微信: `seemseam-com`
 
 <p align="center">
-  <img src="assets/weixin.jpg" alt="微信群" width="240">
+  <img src="../assets/weixin.jpg" alt="微信群" width="240">
 </p>
 
 <a id="community"></a>
@@ -250,11 +266,74 @@ CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：
 ## 新版本记录
 
 <details open>
+<summary><b>v8.1.1</b> - Mobile 实时恢复与 macOS 安装稳定性</summary>
+
+- Mobile gateway 新增有界 SSE invalidation 流，项目、活动和对话变化可刷新权威状态，不再依赖活跃页面轮询。
+- 新增有界只读快照、重连状态和自动恢复；gateway 中断期间保留所选 host、项目、agent、近期对话及完成通知。
+- Mobile host 启动时可识别并安全接管匹配的旧 gateway 进程，避免升级期间出现重复监听。
+- macOS release 更新会保留健康的托管 Python 环境，并在 TLS 或网络失败后通过可配置镜像重试安装 `watchdog`。
+
+</details>
+
+<details>
+<summary><b>v8.1.0</b> - 配置控制面与轻量默认工作台</summary>
+
+- 新增可视化项目配置控制面，可通过 sidebar 左上角的 **⚙ 设置** 或 `ccb config ui` 打开，支持配置校验、差异审查、保存、reload dry-run 和受保护的热加载。
+- 空白项目现在只挂载一个名为 `demo` 的 agent，并自动选择本机首个可用 CLI；显式项目配置和用户配置仍可定义任意单 Agent 或多 Agent 拓扑。
+- 新增 Grok CLI 托管支持、Kimi Code v0.23.1 readiness 兼容、OpenCode fresh session 修复，以及 Claude/Gemini hook launcher 可靠执行。
+- 改进 CCB Mobile gateway profile 持久化、配对凭据保留、项目健康缓存、列表预热显示和 terminal UI 效率。
+- 多语言 README 统一整理到 `README/`，加入真实配置控制面截图，并将 package、Mobile、workflow 和 release metadata 对齐到 8.1.0。
+
+</details>
+
+<details>
+<summary><b>v8.0.19</b> - Mobile host 启动健康检查修复</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。
+
+</details>
+
+<details>
+<summary><b>v8.0.18</b> - Codex auth 投影与 Mobile host health 修复</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。
+
+</details>
+
+<details>
+<summary><b>v8.0.17</b> - Ask 回复稳定性与 Mobile 更新修复</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。
+
+</details>
+
+<details>
+<summary><b>v8.0.16</b> - Mobile 重连与 pane 活动记录</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。
+
+</details>
+
+<details>
 <summary><b>v8.0.12</b> - Release CI 可移植性与 README 多语言同步</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`，并新增日语、法语、德语、阿拉伯语、西班牙语、葡萄牙语、韩语和俄语版本，所有语言保持同一章节结构。
+- v8.0.12 引入了结构一致的多语言 README；当前多语言文件统一放在 [`README/`](./) 目录，中文版本为 [`zh.md`](zh.md)，根目录 `README.md` 为英文首页。
 
 </details>
 
@@ -285,4 +364,4 @@ CCB 支持 [Agent Roles Spec](https://github.com/SeemSeam/agent-roles-spec)：
 
 </details>
 
-完整历史请看 [CHANGELOG.md](CHANGELOG.md)。
+完整历史请看 [CHANGELOG.md](../CHANGELOG.md)。