
agent-brain 发布:面向 AI 编程代理的第二大脑运行模型
来源标题:How HN: Agent-brain – Notes-agnostic second-brain operating model for AI agents
agent-brain 是一个与笔记格式无关的第二大脑运行模型,可为 Claude Code、OpenCode、Codex 等 AI 编程代理提供配置与记忆版本管理。安装脚本会克隆仓库到本地并引导用户指定 Obsidian 库或笔记目录,默认只做 dry-run。项目用 Python 标准库编写,需已安装 git 和至少一个受支持的代理运行时。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
面向 AI agent 的与笔记系统无关的第二大脑操作模型,支持多运行时 agent 配置与记忆版本管理。
agent-brain 是一套面向 AI 编码 agent(Claude Code、OpenCode、Codex、Antigravity CLI)的个人操作模型。它提供:
Python 3.x(运行时脚本仅使用标准库;完整的受控测试门禁通过 uv 安装其验证依赖) PATH 中有 git 至少安装一个受支持的 agent 运行时: Claude Code → ~/.claude/ OpenCode → ~/.config/opencode/ 共享 agents 目录 → ~/.agents/ code CLI → ~/.codex/(AGENTS.md 和 config.toml 持久化在私有 brain 的 _AGENTS/CODEX/ 下;brain skill 安装在 ~/.agents/skills/brain) Antigravity CLI → ~/.gemini/antigravity-cli/(仅 skill 集成)
安装
curl -fsSL https://raw.githubusercontent.com/juanyque/agent-brain/main/bootstrap-zero.sh | bash
该命令会把 agent-brain 克隆到 ~/.local/share/agent-brain 并运行 orchestrator,后者会询问你的 brain 路径(一个 Obsidian vault、一个笔记文件夹,或一个新的空目录)。默认执行 dry-run。审阅计划后,使用末尾打印的准确 public apply 命令;它会保留所选的 brain、运行时过滤器和符号链接策略:
curl -fsSL https://raw.githubusercontent.com/juanyque/agent-brain/main/bootstrap-zero.sh
| bash -s -- --brain /path/to/brain --apply
如果 _COMMON 已存在 如果你的 brain 已有一个指向其他模型(例如之前某次安装)的 _COMMON 符号链接,dry-run 会分别报告当前条目和期望的符号链接,包括失效链接的原始目标。它还会检查 home_setup 管理的每个模板符号链接,并报告过期目标。执行 --apply 时,安装器会把现有的 _COMMON 条目保留为 _COMMON.backup-<ts>,将 _COMMON 重新指向 agent-brain,并通过新的 _COMMON 重新链接过期的受管模板。常规模板文件保持不变。安装前创建的 Git 快照提供了额外的回滚锚点。
Flag 用途 --brain <path> Brain 根路径(跳过交互式提示) --apply 执行(默认:dry-run) --update 在接线前对仓库执行 git pull --ff-only --runtime claude,opencode,agents,codex,antigravity 限制为逗号分隔的运行时子集(默认:所有检测到的) --symlink-policy copy|keep 摄取顶层符号链接内容,或在 brain 根目录保留符合条件的非规范链接
工作原理 安装器是一个轻量 orchestrator,委托给两层:
运行时策略和私有配置属于私有 brain,而不是这个公共仓库。
当 brain 包含 _AGENTS/SHARED/memory/ 时,Codex 会在 ~/.agents/brain-memory 获得一个稳定指针;捆绑的查询工具会按需对少量已索引笔记进行排序。Codex 自己生成的 ~/.codex/memories/ 目录仍保留在本地并保持独立。
环境 profile 提供了一种运行时中立的契约,用于选择 issue tracker、仓库、项目约定和可选私有资源,而无需把这些值嵌入公共核心。Profile 存放在私有 brain 的 _AGENTS/SHARED/profiles/ 下;当 profile 变化时,全局运行时符号链接保持稳定。有关版本化 schema、选择算法、优先级、安全规则和脱敏示例,请参阅 docs/runtime-profiles.md。model/SCRIPTS/runtime_health.py 会在 brain 中存在这些文件时加载并验证它们。使用 --profile <id> 进行显式选择,或使用 --cwd <path> 来测试项目规则选择。MCP/API 可用性委托给活动运行时适配器;只读检查绝不会把已配置的 provider 名称视为实时访问的证明。
Skill 可以调用 skills/brain/scripts/profile_context.py,将通用能力解析为脱敏的 provider 上下文。--live 会检查 Codex MCP registry/auth 边界,而调用方可以传入准确的 --available-tool 名称以及 --tool-catalog-complete,以强制要求活动暴露。省略或不完整的目录仍视为未验证。Claude 的实时发现会被拒绝,因为其官方 registry 命令可能重写运行时设置。
运行时适配器可以通过 model/SCRIPTS/profile_overlays.py 投射独立的私有 profile 资源。适配器为每种选定的资源类型提供显式根路径;先 dry-run 的投射器会链接 brain 拥有的源、隔离冲突,并且可以安全地重复应用而不会重写运行时配置。model/SCRIPTS/profile_secrets.py 会检查被引用的 secret 名称,但不会返回其值。环境存在性、仅元数据的 macOS keychain 查找以及脱敏的运行时原生目录共享同一套失败关闭状态契约。
Git 被用作回滚锚点:在任何变更之前都会创建一个本地快照提交或带注释的 tag。快照消息是确定性的,并且禁用快照签名,因此无人值守的 bootstrap 运行绝不会打开编辑器或 GPG 提示。不会自动推送任何内容。
Agent-brain 附带多个 skill,但只有 operating skill 会自动安装;其余为可选安装:
Skill 位于 brain 之外,并符号链接到仓库。Codex 和 OpenCode 共享 ~/.agents/skills/;Claude 使用 ~/.claude/skills/;Antigravity CLI 使用 ~/.gemini/antigravity-cli/skills/。旧版 Gemini CLI 路径不受管理。Skill 文件使用普通名称,不带 .common.md 后缀。
brain skill 的 session-open apply 是幂等的:它会创建或更新一条 session 笔记,按完整 session ID 精确插入一条每日恢复条目,保留手动编辑过的摘要,并检查生成的 session/每日状态。活动的 WIP 笔记可以通过捆绑的只读 brain_check.py 工具对照 WIP/WIP.md 仪表盘进行检查。
仅在需要时安装可选 skill(这里以 boyscout 为例,用于 Codex)。先审阅 dry-run;其他可选 skill 以相同方式按其目录名安装: bash ~/.local/share/agent-brain/model/SCRIPTS/skill_link.sh boyscout ~/.agents bash ~/.local/share/agent-brain/model/SCRIPTS/skill_link.sh boyscout ~/.agents --apply
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。