broco / v1.0.0 / 版本记录
更新日志
1.0.0
opus-manager / cc-bro 正式演进为 broco v1.0.0——跨 harness 本地协作 CLI,让你当前正在用的 coding agent 直接复用本机其他已登录官方 CLI 一起干活。
- L0 免
init开箱直跑与多宿主开放 Skill:broco setup一次完成本机 CLI 探测、全局允许名单单步确认(绝不静默全放行)、实时额度花名册输出,以及将开放SKILL.md写入~/.agents/skills/broco/并同步挂载到 Claude Code、Codex、Cursor、Antigravity、OpenCode、Pi(同时为 Pi 链接~/.pi/agent/skills/broco并支持PI_CODING_AGENT_DIR)。- 装完即在任意目录按全局策略开跑,工单按
realpath(gitRoot || cwd)归档于~/.broco/,项目仓库保持原样。 - 保留可选 L1
broco init用于私密仓硬隔离名单、独立并发上限、项目规矩或显式重度经理模式(--manager-mode);优先维护AGENTS.md标记段(--host支持auto|agents|claude|codex|cursor|agy|opencode|pi),无AGENTS.md且已有CLAUDE.md或显式传入--host claude时改为维护CLAUDE.md。
- 内置全对称
claude工人与防递归保护:- 新增原生
claude适配器(claude -p --output-format stream-json+--resume,stdin 传题、统一失败分类与凭据脱敏),与codex、agy、cursor-agent、pi:<厂商>、custom:<名称>全对称互调。 - runner 启动工人进程强制注入
BROCO_IN_WORKER=1,默认拒绝工人嵌套派单(除非显式--allow-nested)。
- 新增原生
- 默认跨模型盲审:
broco review <名字>支持省略--by,自动优先挑选与原单不同厂商且额度宽裕的已放行工人。
- 动态本机时区与像素西兰花视觉:
- 移除硬编码
Asia/Shanghai,按BROCO_TZ→TZ→ 系统时区 →UTC动态显示 CLI、审计日志、凭据代理与看板时间。 - 全面换装 16-bit 戴安全帽像素西兰花视觉体系(README、官网、文档、favicon 与本地看板)。
- 移除硬编码
- 统一更名与无损迁移:
- 包名、命令、数据目录、项目标记与环境变量统一迁至
broco、~/.broco/、.broco/与BROCO_*。
- 包名、命令、数据目录、项目标记与环境变量统一迁至
从 cc-bro(0.4.x)或 opus-manager 升级#
先确认需保留的在跑任务已完成,安装 broco 后运行 broco shutdown 和 broco setup。broco setup 自动探测本机 ~/.cc-bro/ 数据和旧版后台进程,提供一步无损迁移至 ~/.broco/,完整保留项目与工单历史。详见升级指南。
0.4.1
- 面向 Agent 的 CLI 易用性升级:
say支持--file <路径>、--file -及stdin(-/管道/heredoc)读取多行或含反引号与$变量的复杂提示词,免除 shell 转义困扰且不在ps暴露题面。- 新增
cc-bro status [--project 路径] [--all] [--json],在不额外拉起未启动服务的前提下查看后台健康度、协议兼容性、看板地址、凭据代理、在跑/排队单、批次进度与可清理 worktree。 - 新增
cc-bro diff <名字> [--stat] [--json](对比基线提交查看跟踪与未跟踪改动)与cc-bro clean [名字|前缀] [--dry-run] [--delete-branch] [--force] [--json](安全清理已完成 worktree 与孤立附件快照)。 ls新增--active、--status、--flag、--batch、--limit过滤;show新增--compact、--turn及批次--status/--full;新增批次级cc-bro retry <前缀>、map --inputs-file、roster --global、stats --project、init --project、~/路径展开,以及setup/ui/shutdown的--json输出。
- 后台性能、SQLite 与进程生命周期治理:
/wait改为微任务合并的事件驱动即刻唤醒(0ms,告别 140ms SQLite 轮询),直接返回task、cwd、worktree、branch与changedFiles。Store.ticketRows、batchDetail与ticketRecords重写为常数次批量 SQL 查询(BEGIN IMMEDIATE写事务、时间线索引、队列与 SSE 微任务合并、>4变更合并推送tickets帧、异步git改动统计),150 分片并发查询耗时约 260ms。- 无孤儿进程生命周期:
SIGTERM/SIGINT干净中止并回收在跑子进程且保留排队单;done、uninit与 10 分钟空闲定时器自动回收空闲pi进程;0700UID 校验套接字目录并兼容0.4.0旧套接字平滑升级;新增 Linux/proc平台支持、全通道凭据脱敏,以及setup/install-local.sh环境净化。
- 看板界面与额度体验:
- Svelte 5 看板全面适配
0.4.x(100dvh独立分栏滚动、Done 折叠、搜索与批次/结果筛选、map分片进度条与兄弟分片切换、排队名次、多任务历史、折叠北京时间UTC+8活动流、故障与上下文告警、准确的runningCount呼吸灯、重启自动恢复端口、agy副组额度告警及全类别模型picks)。
- Svelte 5 看板全面适配
从 0.4.0 及更早版本升级#
先用 cc-bro status 确认任务状态,等需保留的在跑任务完成后执行 cc-bro shutdown 和 cc-bro setup(0.4.1 使用协议 14,shutdown 兼容协议 4–13 及旧 /tmp 套接字)。
0.4.0
- 新增按项目隔离的先来先跑并发池(
--concurrency、cc-bro set concurrency)、cc-bro map批量分片派发、cc-bro retry、省略轮次的wait、agy原生 stdin 传题与/usage额度及五模态附件、Agent 直接配置命令与北京时间审计撤回(audit/undo)、init/uninit自动维护CLAUDE.md、cc-bro --version、后台生命周期恢复记录,以及本地回环凭据代理(proxy-open、proxy-list、proxy-close)。
0.3.1
- 花名册自动发现已安装、已登录 CLI 的全部模型与 pi 厂商,仍遵守项目允许名单。可按 bro 全局隐藏模型系列,项目可覆盖;隐藏后从经理花名册移除,派单和排队开跑均拒绝。
- 随包提供模型简介、定位、档次和任务 picks,可在
~/.cc-bro/models.json按 ID 覆盖。skill 先核对输入能力,用户备注和规矩优先,研究超过 60 天提醒更新。 - 输入能力取模型与当前 CLI 通道的交集;CLI 实报上下文和输出上限优先于目录 API 上限,缺数保留 unknown。
say --attach可通过原生 Codex 或 pi 交付支持的图片,并保存排队轮次的附件快照。 - 每个 bro 可设全局默认模型和档位,项目可覆盖。花名册与配置页显示生效值,下次派活使用新配置,不改其他 CLI 的设置。
- 文本和 JSON 花名册默认紧凑:未允许的 bro 只列名字和权限,档位/fast 变体合并一行,目录标记的旧型号折叠。
--full查询具体变体、上限和完整元数据,--worker ID只查一个 bro;用户备注和规矩完整保留。 - 中英文 Docs 补齐模型能力、附件、目录覆盖、隐藏、默认值和紧凑查询。
从 0.3.0 升级#
安装 cc-bro@0.3.1,再执行 cc-bro shutdown、cc-bro setup 更新服务和技能。想做完的单先等完成;停机会停止该服务下所有项目的运行单和排队单。原有设置、会话和工单保留。依赖模型详细字段的 JSON 调用方改用 roster --json --full。 完整模式也不展示未允许 bro 的模型,用户隐藏项仍不出现,详见升级指南。
0.3.0
- 新增实时项目花名册,列出允许的 CLI、模型、档位、检测默认值、登录、能力、规矩和用户备注。Claude Code 技能先读花名册再派活。
say和review支持--effort,完成一轮后可换模型。 - 内置 agy、cursor-agent,与原生 Codex、pi 并列。按明确会话 ID 续聊,运行中追加要求排到下一轮。CLI 有上报才显示缓存。各后端都可使用 worktree、互为关联审查者。
- 自定义 CLI 模板支持新对话、续聊、回复/ID 提取、可选模型和档位参数,保存前必须通过真实两轮记忆试跑。Gemini CLI 和 OpenCode 是可编辑降级预设,不冒充已验证的全功能适配器。
- 看板新增全局/项目配置:只读检测、在终端打开安装/升级/登录命令、允许名单、默认值、备注和规矩。经理提议的备注必须用户确认。配置只存在 cc-bro,不读凭据文件值,不写其他 CLI 配置。
- 官网新增中英花名册、自定义 CLI、配置页指南。
从 0.2.0 升级#
安装 cc-bro@0.3.0,用新版执行 cc-bro shutdown 后重跑 cc-bro setup。想让在跑的任务完成就先等待;停机会取消服务所有项目的运行单和排队单。保留 0.2 原有权限、具名会话和工单历史,不自动放行新工人。旧服务停机仍兼容 0.1.0、M2,详见升级指南。
0.2.0
不兼容:移除经理室#
直接在项目里打开 Claude Code。0.1.0 的独立经理室、目录里的技能和看板中的厂商设置都已移除。新版把技能装到用户目录,由你正在使用的对话派单。新登记库不会导入 0.1.0 的工单或经理笔记。
工人与工单#
- 每张单可选原生 Codex 或一个 pi 厂商。每个项目分别登记允许的工人和默认工人。原生 Codex 和通过 pi 使用 Codex 订阅是两个独立选项。
- 同名续会话,不同名可并行。运行中追加要求,回执明确显示已注入当轮、排到下一轮或被拒。
- 可以用独立 Git worktree 写单,也可以让另一个工人审查已完成的轮次。看板展示分支、改动文件、步骤、关联审查单和工人上报的输入缓存命中率。收单时保留分支和 worktree。
从 0.1.0 升级#
- 想让旧单做完就先等它们结束。经理室里有用的笔记可留在原文件夹查阅。
- 运行
npm install -g cc-bro@0.2.0。若旧服务仍在运行,用新版执行cc-bro shutdown。这会停止该服务所有项目的运行单和排队单;未完成的轮次不会自动续跑,已经写入的文件保留。 - 运行
cc-bro setup。进入实际项目根目录运行cc-bro init,选好允许的工人和默认工人。在这里打开 Claude Code,输入/cc-bro。旧工单数据库保留在磁盘上。
详见升级指南。
0.1.0
首个 macOS 预览版为每个项目建立独立的 Claude Code 经理室。具名 pi 工人在项目里执行任务,关闭经理对话后仍能继续工作。
- 可在引导看板安装 pi、用密钥或订阅连接厂商,并设置默认工人模型。
- 工单经过排队、进行中、待验收、已完成四列。命令行支持插话、查看历史、等待轮次和停止工人;本机看板可以查看多个项目的进度。