One sentence. One brain.
你说一句「我在做什么、我要什么」,它把全网相关的 agent 汇总、仲裁、压缩成一颗脑。 你只和一颗脑对话。底下有多少 agent,与你无关。
$ brain "我在做跨境电商,需要选品和广告投放优化"
◐ 解析需求 ······ 3 个任务 / 7 项能力 / 2 个假设
◐ 检索能力库 ···· 12,480 张卡 → 候选 214
◐ 审计 ·········· 剔除 61
许可 12 · 权限过宽 31 · 提示注入 9 · 已失效 9
◐ 融合 ·········· 9 个能力编译进脑,4 个留在脑外
◐ 验真 ·········· 能力保持率 0.91 · 压缩比 11:1 · 单脑度 1.00
✔ ./brains/ecommerce-selection/ 42s
$ brain run
$ brain export opencode| Agent 目录 | Agent Brain | |
|---|---|---|
| 给你什么 | 48,000 个工具 | 一颗已经选完、融完、验过的脑 |
| 你的动作 | 挑选、配置、试错 | 直接用 |
| 失败方式 | 选错 | 能力保持率下降——可测 |
| 你能得到什么数字 | 无 | 保持率 / 压缩比 / 单脑度 / 增益 |
目录让你面对无穷的选择。brain 已经把选择做完了,并且留下了判据。
任何一条不达标,它就不算「一颗脑」。
| # | 契约 | 测试 |
|---|---|---|
| 1 | 单一身份 输出里永不出现「某个 agent 认为」 | 输出扫描 + 100 条抽样,命中率必须 0 |
| 2 | 单一立场 同一问题换 5 种问法,结论一致 | 一致率 ≥ 90% |
| 3 | 单一记忆 说一次,处处生效,跨会话 | 写入后 10 个能力都能取到 |
| 4 | 单一能力面 内部失败自己降级,不把内部结构暴露成错误 | 注入 20 种失败,可见错误里 0 次提及组件 |
| 5 | 单一演进 对外一个版本号;内部增删不改变对外语义 | 版本 diff 只允许能力变化 |
「要多深有多深」在预算上不可能:50 个 agent 全压进上下文 = 150k tokens,质量必崩。 所以每个能力各自决定自己被编译进脑多深:
| 级 | 形态 | 常驻成本 | 保持率 | 适用 |
|---|---|---|---|---|
L3 |
蒸馏进权重(以后) | 0 | 待测 | 极高频、可离线 |
L2 |
皮层：恒驻上下文 | 恒驻 | 80–90% | 高频、轻、要一致 |
L1 |
脑叶：编译成流程，按需加载 | 按需 | 90–95% | 中频、流程化 |
L0 |
外挂：保留原 agent，只做路由 | 0 | 100% | 低频、重、要实时数据 |
L0 也是合法的融合结果——一个能力留在脑外,不是失败,是「不值得装进脑子」。
用户感知不到区别。详见 docs/02-architecture.md。
两个来源意见相反时你怎么判,那才是人格。所以融合产物里必须有一份带判据的仲裁表, 而不是一段「你是一位专业、严谨的助手」。详见 docs/03-fusion.md。
M0 完成,站点已经能用。 输入一句话就能得到一颗脑的结构与可视化。
-
spec/card/v1— 能力卡 -
spec/brain/v1— 脑 -
brain validate— schema 校验器(构建期预编译,运行时零 eval) - 网页端:一句话 → 脑 → 可视图谱(brain.zxlumen.cn)
- 页面内模型配置(自带密钥)+ 站点默认通道
- 200 张真实能力卡(把"能力规划"接到真实实现)
- 融合:多来源 → 仲裁 → 压缩
- 能力保持率与归因(需要真卡才能做消融)
网页上直接下载 zip,不需要装任何命令行工具。
brain.zxlumen.cn 生成 → 点「导出」→ 下载 <name>-opencode.zip
解压到项目根目录 → cd 项目 && opencode
zip 里有四个文件:
opencode.jsonc 主控 + 每个能力一个 subagent,以及要连的 MCP 服务
AGENTS.md 项目说明与能力清单(opencode 会自动读)
gaps.md 哪些能力还没接上、缺什么密钥或数据
brain.yaml 这颗脑的原始定义
开发者也可以用命令行(可选):
brain export my-brain.yaml # → ./my-brain-opencode/
brain doctor my-brain.yaml # 体检:哪些来源连得上、缺什么密钥三档落地方式,取决于来源能不能跑:
| 来源状态 | 导出结果 |
|---|---|
| MCP(stdio / remote) | 写进 mcp,subagent 直接调用 |
| 库 / SDK | subagent 带「配方」,放开 bash 让它写脚本 |
| SaaS / 数据集 | 进 gaps.md,写清楚缺什么 |
https://brain.zxlumen.cn —— 打开就是一句话的输入框,不要求注册、不要求填密钥。
bun run web:dev # http://localhost:5173
bun run web:build # 产物 web/dist
bun run web:test站点是一个 Bun 服务(web/server/):发静态文件 + 转发模型请求。
编译逻辑全在浏览器里,服务端不理解 brain 的结构。
| 路由 | 内容 | 谁会看 |
|---|---|---|
#/ |
输入一句话 → 得到脑 → 看见结构 | 用户 |
#/?q=... |
预填并自动生成(可分享) | 用户 |
#/spec |
两份规范 | 开发者,不在导航里 |
#/playground |
校验器与开发者图谱 | 开发者,不在导航里 |
模型配置在页面右上角的齿轮里(自带密钥,只存 localStorage)。 不填也能用:站点提供了默认通道,令牌只在服务端,永不下发到浏览器。
部署方式见 docs/08-deployment.md。
| 文档 | 内容 |
|---|---|
| 00-vision | 定位、问题、不做什么 |
| 01-contract | 一颗脑的五条契约与测试 |
| 02-architecture | 皮层 / 脑叶 / 外挂、深度求解 |
| 03-fusion | 四层融合、冲突仲裁、人格涌现 |
| 04-evaluation | 保持率、压缩比、单脑度、UB-50 |
| 05-security | 供应链威胁模型与沙箱 |
| 06-landscape | 同名/近名产品扫描(2026-10) |
| 07-m1-plan | M1 四周计划与闸门 |
| 08-deployment | 站点部署(容器 / Caddy) |
| 10-sources | 来源层:能力 → 需求 → 真实实现 |
架构决策记录在 docs/adr。
bun install
bun run brain validate examples/card.example.yaml examples/brain.example.yaml
bun testApache-2.0。规范(spec/)与实现同许可,任何人可以实现自己的 brain 编译器。