• 向后兼容的发布资源：Linux 发布 tarball 现在包含一个兼容别名，以便旧版 6.x 更新程序仍能找到解压后的安装路径
• 旧客户端可再次升级：现有的 v6.0.1 和 v6.0.2 安装现在可以直接更新到最新稳定版，无需先使用修补过的本地更新程序
• 现代更新程序依然干净：当前运行时保持正确的解压目录解析，不依赖于遗留别名

• 修复发布升级问题：ccb update 现在能正确解析解压后的发布目录，而不是将 .tar.gz 资源文件名当作文件夹处理
• 恢复安装程序交接流程：自更新现在能在解压后的发布资源中找到 install.sh，从而完成整个安装过程
• 发布构建规范化：Linux 发布打包现在会忽略本地 .ccb-requests/ 残留文件，确保官方构建可重复

• 正确识别调用者身份：ccb ask 现在会保留真实的发起智能体信息，因此回复会返回到正确的邮箱，而不会被归因于“用户”
• 稳定的回复路由：对于委派任务的异步回复，现在都能准确返回到预期的邮箱链路中，包括以 cmd 为起点的流程
• 大小写混合的智能体配置恢复：当配置的智能体名称使用大小写混合时，布局恢复功能不再出现偏差
• macOS Homebrew 警告：install.sh 现在会在用户尝试安装 tmux 等依赖项之前，明确提示 Homebrew 未安装

• 源码档案清理：移除了意外跟踪的 pytest 临时文件，使 GitHub 源码档案再次变得整洁
• 更安全的 tar 校验：升级解压现在会在解包前拒绝不安全的符号链接目标
• 更清晰的失败提示：不安全的档案解压错误现在会引导用户查看发布资源或干净的源码档案
• 回归测试覆盖：增加了测试，以防止短暂的仓库文件再次被跟踪

🚀 新的运行时方向：

• 无限并行智能体基础：CCB v6 构建为真正无限制的智能体间委派与编排的运行时基础
• 独立的智能体身份：智能体可以拥有不同的角色、任务所有权、技能库和个性
• 聚焦的用户命令界面：公开的用户工作流仍然以 ccb、ccb -s、ccb -n、ccb kill 和 ccb kill -f 为核心

🧱 项目语义重建：

• 配置保留的遗留清理：在 6.x 版本之前的项目中首次运行 ccb 时，CCB 会保留 .ccb/ccb.config 文件，移除其余旧的 .ccb 运行时状态，并在本地重新构建。
• 运行时标记：现代项目现在会记录 .ccb/project-runtime.json 文件，以便将当前运行时状态与遗留状态区分开来。
• 工作树安全保护：如果 CCB 管理的工作树处于脏状态或未合并状态，仍会阻止破坏性重建操作，直到用户解决这些问题。

🔄 升级政策：

• 仅限 Linux/WSL：ccb update 现在仅适用于 Linux/WSL 上的 6.x 系列。
• 仅发布版本升级：源代码标签仍然随每个版本一起发布，但 6.x 的 ccb update 会安装 GitHub 发布资产，而不是源代码压缩包。
• 稳定版为目标：默认升级现在会指向最新的稳定版，而不是不断变化的 main 分支。
• 重大版本确认：升级到 6.0.0 需要用户明确确认，才能替换已安装的运行时环境。

🤖 提供者可靠性：

• Gemini 多轮稳定性：Gemini 补全轮询现在会等待工具活动完成，不再在第一句稳定的规划性语句后就退出。

🚀 用户界面 CLI 简化：

• 精简主界面：公开启动流程现为 ccb、ccb -s、ccb -n、ccb kill 和 ccb kill -f。
• 模型控制平面仍可用：ask、ping、pend 和 watch 仍然用于代理间的协调，而不干扰主帮助信息。

🧱 工作空间语义明确化：

• 默认原地模式：紧凑的 ccb.config 条目现在会扩展为 workspace_mode='inplace'。
• 选择性隔离模式：当某个代理必须在其独立的 Git 工作树中运行时，可使用 agent:provider(worktree)。
• 安全的代理管理：添加代理不会干扰现有的工作树；移除或重命名工作树代理时，会退避干净的分支，并阻止对脏或未合并分支的操作。

🛠 恢复与重置加固：

• 保留配置的重置：ccb -n 会在保留 .ccb/ccb.config 的同时，重建项目运行时状态。
• 清理过时注册：启动和重置操作现在会在重新创建之前，先清除缺失的已注册 Git 工作树。
• 终止警告：ccb kill 会在工作树代理仍存在未合并或脏状态时发出明确警告。

🤖 Gemini 补全修复：

• 不再因规划文本提前结束：Gemini 补全轮询现在会跟踪工具调用活动，并等待真正的最终回复，而不是在第一条稳定的“我将……”语句后就结束。

🔧 Gemini CLI 0.29.0 支持：

• 双重哈希策略：会话路径发现现在同时支持基础名和 SHA-256 格式。
• 自动启动：ccb-ping 和 ccb-mounted 新增了 --autostart 标志，用于启动离线提供者守护进程。
• 清理路径：僵尸会话的清理现在由 ccb kill -f 负责。
• 🔗 异步通信修复：
• OpenCode 死锁：修复了导致第二次异步调用总是失败的会话 ID 锁定问题。
• 遗留补全兼容性：基于文本的遗留提供者在降级模式下仍能容忍不匹配的 CCB_DONE 行。
• req_id 正则表达式：opencode_comm.py 现在可以匹配旧的十六进制格式和新的基于时间戳的格式。
• Gemini 空闲超时：当 Gemini 忽略 CCB_DONE 标记时，系统会自动检测回复完成（15 秒空闲，可通过 CCB_GEMINI_IDLE_TIMEOUT 配置）。
• Gemini 提示强化：更严格的指令以降低 CCB_DONE 遗漏率。
• 🛠 其他修复：
• lpend：当注册表过时时，优先使用新的 Claude 会话路径。

🔧 异步转接停止修复：

• 全局护栏：在 claude-md-ccb.md 中新增强制性的“异步护栏”规则——涵盖 /ask 技能以及直接的 Bash(ask ...) 调用。
• 标记一致性：bin/ask 现在会发出 [CCB_ASYNC_SUBMITTED provider=xxx]，与其他所有提供者脚本保持一致。
• DRY 技能：Ask 技能规则引用全局护栏，并带有本地回退机制，确保单一事实来源。
• 这一修复防止了 Claude 在提交异步任务后继续轮询或休眠。

📂 项目本地历史：

• 本地存储：自动上下文导出现在会按项目保存到 ./.ccb/history/。
• 安全范围：自动转移仅针对当前工作目录运行。
• Claude /continue：新增技能，可通过 @ 附加最新的历史文件。
• 🧩 遗留兼容性：
• 自动迁移：.ccb_config 文件会在可能的情况下被检测并升级为 .ccb。
• 回退查找：过渡期间，遗留会话仍能正常解析。
• 这些更改使交接工件限定在项目范围内，并使升级过程更加平滑。

🔁 会话切换追踪：

• 旧会话字段：.claude-session 现在会记录 old_claude_session_id、old_claude_session_path 以及 old_updated_at。
• 自动上下文导出：之前的 Claude 会话会被自动提取到 ./.ccb/history/claude-<timestamp>-<old_id>.md。
• 更清洁的转移：噪声过滤会移除协议标记和护栏内容，同时保留仅与工具相关的操作。
• 这些更新使会话交接更加可靠，也更易于审计。

🔧 稳定性改进：

• 看门狗文件监控：通过高效的文件监控实现会话的实时更新。
• 强制调用者字段：提升了请求跟踪和路由的可靠性。
• 统一执行模型：简化了跨平台的 ask 技能执行。
• 自动依赖安装：看门狗库会在设置过程中自动安装。
• 会话注册表：增强了 Claude 适配器，实现了会话的自动监控。
• 这些改进显著提高了跨 AI 通信的可靠性，并减少了会话绑定失败的情况。

此版本引入了旧的邮件网关路径。该流程现已从支持的代理优先界面上移除，仅作为遗留代码保留在清理阶段。

🔧 修复与改进：

• tmux Claude ask：从窗格输出中读取回复，并自动进行管道窗格日志记录，以提高完成的可靠性。
• 更多详细信息请参阅 CHANGELOG.md。

🔧 修复与改进：

• Claude 补全钩子：统一的 askd 现在会触发 Claude 的补全钩子
• askd 生命周期：askd 已绑定到 CCB 生命周期，以避免出现过时的守护进程
• 挂载检测：ccb-mounted 在所有平台上都使用基于 ping 的检测方式
• 状态文件查找：askd_client 会在找不到守护进程状态文件时回退到 CCB_RUN_DIR

完整详情请参阅 CHANGELOG.md。

🔧 错误修复与改进：

• 统一守护进程：所有提供商现在都使用统一的 askd 守护进程架构
• 安装/卸载：修复了安装和卸载中的错误
• 进程管理：修复了杀死/终止相关的问题

完整详情请参阅 CHANGELOG.md。

🚀 统一命令 - 将各提供商特有的命令替换为以代理为中心的工作流：

支持的提供商： gemini, codex, opencode, droid, claude

🪟 历史性的原生 Windows 实验：

• 此前的版本曾探索过原生 Windows 分屏路径
• 后台执行使用 PowerShell + DETACHED_PROCESS
• 大型负载传递采用基于 stdin 的交接方式
• 该后端现已移除；未来原生 Windows 的多路复用支持将围绕 psmux 进行重新设计

📦 新技能：

• /ask <agent> <message> - 向指定代理发送任务
• /ping <agent|all> - 检查已挂载代理的健康状况
• /pend <agent|job_id> [N] - 查看代理的最新回复

完整详情请参阅 CHANGELOG.md。

• 僵尸清理：ccb kill -f 现在会全局清理孤儿 tmux 会话（即父进程已退出的会话）
• 挂载技能：优化为使用 pgrep 进行守护进程检测（速度提升约 4 倍），并提取为独立的 ccb-mounted 脚本
• Droid 技能：将全套技能（cask/gask/lask/oask 以及 ping/pend 变体）添加到 droid_skills/ 目录下
• 安装：新增 install_droid_skills() 函数，用于将 Droid 技能安装到 ~/.droid/skills/

• Droid：增加了委托工具（ccb_ask_* 以及 cask/gask/lask/oask 别名）。
• 设置：新增 ccb droid setup-delegation 命令，用于 MCP 注册。
• 安装程序：当检测到 droid 时，会自动注册 Droid 委托（可通过环境变量选择退出）。

/all-plan <requirement>

/all-plan 为 API 设计一个基于 Redis 的缓存层

• Claude 独立性：无需先启动 Claude；Codex 也可以作为主要 CLI。
• 统一控制：单一入口即可控制 Claude/OpenCode/Gemini。
• 简化启动：移除了 ccb up；直接使用 ccb ... 或默认的 ccb.config。
• 灵活挂载：分屏挂载和会话绑定更加灵活。
• 默认配置：缺失时会自动创建 ccb.config。
• 项目 askd 自动启动：项目 askd 和提供商运行时会在需要时自动在项目的 tmux 命名空间中启动。
• 会话稳健性：通过 PID 活性检查防止出现过时的会话。

• 全面重构：结构更清晰、稳定性更好、扩展更容易。
• 终端运行时清理：运行时转向单一的 tmux 导向的分屏/控制模型，而非并行的终端后端。
• 完美的 tmux 体验：稳定的布局 + 分屏标题/边框 + 会话范围的主题设置。
• 适用于任何终端：只要你的终端能够运行 tmux，CCB 就能提供完整的多模型分屏体验。

• 真正的并行处理：可以同时向 Codex、Gemini 或 OpenCode 提交多个任务。
• 跨 AI 协调：Claude 和 Codex 现在可以共同驱动 OpenCode 代理。
• 防弹级稳定性：守护进程会在首次请求时自动启动，并在空闲后停止。
• 链式执行：Codex 可以委托 OpenCode 来完成多步骤的工作流程。
• 智能中断处理：Gemini 任务能够安全地处理中断情况。

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

注意： 如果安装后命令未找到，请参阅 macOS 故障排除。

如果您的 Claude/Codex/Gemini 在 WSL 中运行，请使用此方法。

⚠️ 警告： 请勿以 root/administrator 身份安装或运行 ccb。请先切换到普通用户（su - username 或使用 adduser 创建一个新用户）。

# 在 WSL 终端内运行（以普通用户身份，而非 root）
git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

如果您的 Claude/Codex/Gemini 在 Windows 原生环境中运行，请使用此方法。

Windows 原生 mux 运行时目前正在围绕 psmux 进行重新设计。本分支中稳定的分屏路径仍然是 Linux/macOS/WSL + tmux。

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
powershell -ExecutionPolicy Bypass -File .\install.ps1 install

• 安装程序优先使用 pwsh.exe（PowerShell 7 及以上版本），如果不可用则使用 powershell.exe。

关键点： ccb 和底层代理 CLI 必须在同一环境中运行。最常见的问题就是环境不匹配，导致项目启动或代理连接失败。

注意：安装程序还会为 Claude/Codex 技能安装特定于操作系统的 SKILL.md 变体：

• Linux/macOS/WSL：bash heredoc 模板（SKILL.md.bash）
• Windows 原生：PowerShell here-string 模板（SKILL.md.powershell）

1) 当前后端状态

• 本分支中活跃的多窗格运行时仅为 tmux。
• 目前稳定的分屏使用方式是 Linux/macOS/WSL 配合 tmux。
• Windows 原生的 mux 支持正在围绕 psmux 进行重新设计；详情请参阅 docs/ccbd-windows-psmux-plan.md。

2) 如何识别您的环境

根据您安装/运行 Claude Code/Codex 的方式来判断：

• WSL 环境

  • 您通过 WSL 终端（Ubuntu/Debian）使用 bash 安装或运行（例如：curl ... | bash、apt、pip、npm）。
  • 路径看起来像是 /home/<user>/...，也可能看到 /mnt/c/...。
  • 验证方法：运行 cat /proc/version | grep -i microsoft 应有输出，或者 echo $WSL_DISTRO_NAME 不为空。

• Windows 原生环境

  • 您通过 Windows Terminal、PowerShell 或 CMD 安装或运行（例如：winget、PowerShell 脚本）。
  • 路径看起来像是 C:\Users\<user>\...。

3) 当前推荐方案

• 如果您希望采用稳定的分屏/运行时监督路径，请在 WSL 中运行 ccb 和所有代理 CLI，然后使用 tmux。
• 如果您的工具目前在 Windows 原生环境中运行，请保持该环境一致，但将原生分屏编排视为过渡方案，直到 psmux 推出为止。

4) 故障排除：ccb 无法正确启动

• 最常见原因： 环境不匹配（ccb 在 WSL 中而 codex 在 Windows 原生环境中，反之亦然）。
• tmux 未安装： 请在运行 ccb 的环境中安装 tmux。
• 终端未刷新： 安装完成后重启终端，以便使 PATH 变更生效。

安装后命令未找到

如果您在运行 ./install.sh install 后发现 ccb 未找到：

原因： 安装目录（~/.local/bin）未包含在您的 PATH 中。

解决方案：

nano ~/.zshrc
export PATH=$PATH:~/.local/bin
source ~/.zshrc

1. 检查安装目录是否存在

ls -la ~/.local/bin/

2. 检查 PATH 是否包含该目录

echo $PATH | tr ':' '\n' | grep local

3. 检查 shell 配置文件（macOS 默认使用 zsh）

cat ~/.zshrc | grep local

4. 如果未配置，手动添加

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

5. 重新加载配置

source ~/.zshrc

### tmux 中的 Shell 无法检测到命令

如果在 tmux 内启动的 shell 找不到 ccb 命令，而普通终端却可以找到：

- tmux 可能启动了不同的 shell 初始化路径。
- 同时将 PATH 添加到 `~/.zprofile` 文件中：

```bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile

然后完全重启 tmux 服务器：

tmux kill-server

使用方法：

/all-plan <需求>

示例：

/all-plan 使用 Redis 为 API 设计一个缓存层

工作原理：

1. 需求细化 - 通过苏格拉底式提问挖掘隐藏需求。
2. 并行独立设计 - 每个 AI 独立设计（避免群体思维）。
3. 对比分析 - 整合见解，识别反模式。
4. 迭代优化 - 多 AI 互相评审和批评。
5. 最终输出 - 可操作的实施计划。

关键特性：

• 苏格拉底阶梯：7 个结构化问题，深入挖掘需求。
• 超级能力视角：系统性地探索替代方案（10 倍规模、移除依赖、反转流程）。
• 反模式检测：主动识别所有设计方案中的风险。

适用场景：

• 需要多元视角的复杂功能。
• 有多种可行方案的架构决策。
• 需要彻底验证的高风险实施。

v5.0.6

• 僵尸清理：ccb kill -f 全局清理孤立的 tmux 会话。
• 挂载技能：优化了 pgrep，提取到 ccb-mounted 脚本中。
• Droid 技能：完整技能集已添加到 droid_skills/ 目录下。

v5.0.5

• Droid：增加了委托工具（ccb_ask_* 和 cask/gask/lask/oask），以及用于 MCP 安装的 ccb droid setup-delegation。

v5.0.4

• OpenCode：修复了 -r 恢复在多项目切换后失效的问题。

v5.0.3

• 守护进程：全新的稳定守护进程设计。

v5.0.1

• 技能：新增 /all-plan 技能，结合超级能力头脑风暴，并增加了可用性限制；Codex 新增 lping/lpend；gask 会保留简短摘要，并记录 CCB_DONE。
• 状态栏：角色标签现在从 .autoflow/roles.json 中读取角色名称（支持 _meta.name），并按路径缓存。
• 安装程序：复制技能子目录（如 references/），用于 Claude 和 Codex 的安装。
• CLI：新增 ccb uninstall / ccb reinstall 命令，同时清理 Claude 的配置。
• 路由：更精确的项目/会话解析（优先使用 .ccb 锚点，避免跨项目 Claude 会话不匹配）。

v5.0.0

• Claude 独立性：无需先启动 Claude；Codex 或任何其他代理都可以作为主要 CLI。
• 统一控制：单一入口可平等控制 Claude/OpenCode/Gemini。
• 简化启动：移除了 ccb up；当缺少 ccb.config 时，会自动创建默认配置。
• 灵活挂载：更灵活的窗格挂载和会话绑定。
• 项目 askd 自动启动：项目 askd 和提供商运行时会在需要时自动在项目 tmux 命名空间中启动。
• 会话鲁棒性：通过 PID 活性检查防止会话过期。

v4.1.3

• Codex 配置：自动将已弃用的 sandbox_mode = "full-auto" 迁移到 "danger-full-access"，以修复 Codex 启动问题。
• 稳定性：修复了快速退出命令可能在设置 remain-on-exit 之前关闭窗格的竞争条件。
• Tmux：增强了窗格检测（优先使用稳定的 $TMUX_PANE 环境变量），并在拆分目标消失时提供更好的回退机制。

v4.1.2

• 性能：为 Tmux 状态栏（Git 分支和 CCB 状态）添加缓存，以降低系统负载。
• 严格 Tmux：明确要求必须安装 tmux 才能自动启动；移除了容易出错的自动附加逻辑。
• CLI：新增 --print-version 标志，用于快速检查版本。

v4.1.1

• CLI 修复：改进了在 Tmux 中重新启动 ccb 时标志位（如 -a）的保留。
• 用户体验：在非交互式会话中运行时，提供更友好的错误信息。
• 安装：强制更新技能，确保应用最新版本。

v4.1.0

• 异步护栏：cask/gask/oask 在提交后会打印 Claude 的护栏提醒。
• 同步模式：新增 --sync 参数，用于抑制 Codex 调用者收到的护栏提示。
• Codex 技能：更新 oask/gask 技能，在使用 --sync 时静默等待。

v4.0.9

• Project_ID 简化：ccb_project_id 使用当前目录下的 .ccb/ 锚点（无需向上遍历父目录，也不依赖 Git）。
• Codex 技能稳定性：Codex 的 oask/gask 技能默认设置为等待状态（--timeout -1），以避免过早发送下一个任务。

v4.0.8

• Codex 日志绑定刷新：Codex 运行时现在会定期通过解析 start_cmd 并扫描最新日志来刷新 .codex-session 日志路径。
• Tmux 剪贴板增强：增加了对 xsel 的支持，并引入了 update-environment，以更好地实现 GUI 和远程会话之间的剪贴板集成。

v4.0.7

• Tmux 状态栏重新设计：采用双行状态栏，使用现代圆点指示器（●/○）、Git 分支和 CCB 版本显示。
• 会话新鲜度：始终扫描日志以获取最新的会话，而不是使用缓存的会话文件。
• 简化自动模式（历史记录）：自动权限行为现已整合到当前的主要启动流程中。

v4.0.6

• 会话覆盖：cping/gping/oping/cpend/opend 支持 --session-file / CCB_SESSION_FILE，以绕过错误的工作目录。

v4.0.5

• Gemini 可靠性：重试读取 Gemini 会话 JSON 文件，以避免短暂的部分写入失败。
• Claude 代码可靠性：gpend 支持 --session-file / CCB_SESSION_FILE，以绕过错误的工作目录。

v4.0.4

• 修复：在启动 Codex 之前，自动修复 ~/.codex/config.toml 中重复的 [projects.\"...\"] 条目。

v4.0.3

• 项目整洁性：将会话文件存储在 .ccb/ 目录下（回退到旧版根目录中的 dotfiles）。
• Claude 代码可靠性：cask/gask/oask 支持 --session-file / CCB_SESSION_FILE，以绕过错误的工作目录。
• Codex 配置安全性：将自动批准设置写入带有 CCB 标记的区块中，以避免配置冲突。

v4.0.2

• 剪贴板粘贴：在 Tmux 配置中支持跨平台工具（xclip/wl-paste/pbpaste）。
• 安装用户体验：安装完成后自动重新加载 Tmux 配置。
• 稳定性：默认将 TMUX_ENTER_DELAY 设置为 0.5 秒，以提高可靠性。

v4.0.1

• 东京之夜主题：将 Tmux 状态栏和窗格边框切换为东京之夜配色方案。

v4.0

• 全面重构：从头开始重建，采用更清晰的架构。
• 完美支持 Tmux：一流的拆分、窗格标签、边框和状态栏。
• 适用于任何终端：建议所有操作都在 Tmux 中进行（Windows 原生环境除外）。

v3.0.0

• 智能运行队列：项目询问具有 60 秒空闲超时，并支持提供商队列。
• 跨 AI 协作：支持多个代理（Claude/Codex）同时调用一个代理（OpenCode）。
• 中断检测：Gemini 现在支持智能的中断处理。
• 链式执行：Codex 可以调用 oask 来驱动 OpenCode。
• 稳定性：强大的队列管理和锁文件机制。

v2.3.9

• 修复 oask 会话跟踪 bug——当 OpenCode 创建新会话时，oask 会跟随新的会话。

v2.3.8

• 无论是否使用 -a 标志，自动流项目均可启用计划模式。

v2.3.7

• 按目录加锁：不同的工作目录可以独立运行 cask/gask/oask。

v2.3.6

• 为 cask/gask/oask 添加非阻塞锁，以防止并发请求。
• 统一 oask 与 cask/gask 的逻辑（使用 _wait_for_complete_reply）。

v2.3.5

• 修复计划模式与自动模式（--dangerously-skip-permissions）的冲突。
• 修复 oask 在 OpenCode 仍在处理时返回过时回复的问题。

v2.3.4

• 自动启用计划模式，当自动流功能被安装时。

v2.3.3

• 简化 cping.md，使其与 oping/gping 风格一致（减少约 65% 的令牌数量）。

v2.3.2

• 优化技能文件：将常见模式提取到 docs/async-ask-pattern.md 中（减少约 60% 的令牌数量）。

v2.3.1

• 修复 gask/cask 中的竞争条件：在进入等待循环前先检查是否存在消息。