用途:brain-save 提供 Registrar 的完整操作员写入面,用于提交单条记忆提案或对已有记忆做生命周期转换。它不同于只读的 intent-brain 运行时,也不同于统一治理的 second-brain 插件。teamkb_propose、teamkb_transition、teamkb_status 均作用于 apps/mcp-server 配置的本地路径,即使配置了远程搜索也是如此;当搜索与写入需指向同一大脑时,应保持 TEAMKB_API_URL 未设置。
主要能力:保存新事实时,先用 teamkb_search({ query: "KEY_TERMS", scope: "all" }) 检索,若已有治理内容覆盖则停止,避免重复;排除临时调试、个人偏好、密钥、凭据及权威项目文档已维护的事实;类别可选 decision、pattern、convention、architecture、troubleshooting、onboarding、reference;调用 teamkb_propose({ title, content, category, filePaths? }),返回的 candidateId 仅表示已排入本地 spool,需由独立 curator 处理后才可能晋升。退役或恢复记忆时,从 UUID 形引用文件名提取 memoryId,调用 teamkb_transition({ memoryId, to, reason, actor });仅支持 active 到 deprecated 或 archived、deprecated 到 active 或 archived、superseded 到 archived,本版本不支持 active 到 superseded。teamkb_status 可查看本地数据库计数与近期治理反馈,但不列出 spool 提案,也无法确认新候选是否已晋升。
使用方式:需先构建并配置 apps/mcp-server,设置 TEAMKB_TENANT_ID、TEAMKB_BASE_PATH、TEAMKB_ROLE=admin,并用操作系统权限保护本地基础路径;TEAMKB_ROLE=admin 只是工具注册门槛,不是远程认证。混合本地/远程模式前应阅读运行时契约。
限制:绝不持久化密钥、令牌、凭据或私钥;转换需提供可读原因与真实 actor;本地文件系统访问是写入的安全边界,bearer token 不授权此工具路径;来源证明只证明捕获出处,不证明事实为真。写入工具缺失时说明只读插件或成员角色生效;spool 写入失败应报告错误,不得声称已排队;转换 ID 非 UUID 形应停止并获取精确 ID;转换被拒应报告状态机原因,不得绕过。