Agents Universe

一个 Apache-2.0 的智能体平台，把项目当作共享记忆的单位。知识是项目工作区里的 Markdown 文件——domain/、technical/、skills/——数据库按项目与 slug 建索引：选中项目时 primary 文件全文进上下文，detail 文件只给元数据与摘要，等某次工具调用去取。没有嵌入模型，也没有向量检索，结构靠显式 [[slug]] 交叉引用承载。写回是另一半：knowledge_rw 把新接口、指标口径与测试经验写进对应的那份文件，随后重新索引、版本号加一、旧正文存档、五项完整度分数重算，并用过期标记与一步显式退役让「遗忘」也可审计。平台自带十个角色定义——Product Owner、Tech Lead、Quality Assurance 等——一轮可以靠 @ 提及交给另一个智能体，也可以在同一个回合里把子任务委派出去。记忆从单轮上下文一路分层到会话、个人、情景、项目与全局知识，任何智能体都能发布成 API 或系统内嵌页面。

谁做的拥有这个仓库的 GitHub 账号，资料页上的名字是 yanqiu(Ian)，2017 年 11 月注册，4 个公开仓库，没有简介也没有关注者。仓库的 235 次提交里有 17 次署名是他，另有 2 次署名「Agents Universe」并带一个 localhost 地址；剩下 216 次署名「Agent Universe」，挂 GitHub 的 noreply 邮箱，且都是经 GitHub 的网页提交流而非本地 git 客户端提交——这和 README 里那句「仓库由它自己的 Product Owner 与 Tech Lead 智能体维护」对得上。108 条提交带共同作者尾注，其中 65 条署名 Claude，42 条署名 Claude Code，1 条署名 Claude Opus 4.8。

1. 01

   一个人，以及这个项目本身在讲的那些智能体

   仓库建于 2026-09-10，最近一次提交是 2026-09-28，但它最老的一次提交是 2026-08-18，更新日志里第一个版本条目写的是 2026-08-08——大约三周的活是跟着一个当时还不存在的仓库一起到的。235 次提交在八月 99 次、九月 136 次，署名才是有意思的部分：216 次署名「Agent Universe」、挂 GitHub 的 noreply 邮箱、经 GitHub 的网页提交流提交；17 次署名账号本人；另有 2 次带一个 localhost 地址。108 条带共同作者尾注——65 条 Claude、42 条 Claude Code、1 条 Claude Opus 4.8——贡献者列表只有两项：web-flow 216 次，账号本人 17 次。旁边是 383 个星、1 个 fork、0 个 watcher，以及唯一一个未关闭的 pull request；仓库是 Apache-2.0，topics 里写着 deepseek-harness 与 workbuddy-alternative。tag 有六个，从 v1.0.0 到 v1.5.0，而 GitHub release 一个都没有：真正的发布台账是一份 59,990 字节的 CHANGELOG.md，版本标题从 2026-08-08 的 0.1.0 一直排到 2026-09-24 的 1.5.0，最新的修复挤在一个 Unreleased 段里。

2. 02

   两个写入者，一份文件，以及碰撞都修在哪

   一条知识是一个 Markdown 文件，数据库里的那一行只是它的索引，于是所有一致性问题都落在同一个接缝上。并发的索引器为一个项目与 slug 插出重复行之后，走 scalar_one_or_none 的读取开始抛 MultipleResultsFound；迁移 w5h8k6g9h457 按同一对键保留最新一行（先删掉输家各自的加载事件与历史版本）给表去重，然后把索引改成唯一。现在索引器在保存点里逐文件 flush，一旦输掉插入竞争就重新取回赢家那一行、改走更新分支，而不是让整批作废——代码里还留着一句注解：add() 必须放在保存点里面，因为在保存点之前加进去的对象会以 pending 状态活过回滚，下一次 flush 会在任何保存点之外重抛同一个错误，照样把整批弄挂。最重的一次修复在人这一侧：知识 PUT 之前会把事务一直开着，于是后台重建索引对同一行元数据的更新会被行锁挡住，而响应还在等——这个死锁让 PostgreSQL 的 CI job 挂了 40 分钟。现在这个端点先写文件、把旧正文以「用户」为改动者存进 knowledge_versions、提交，之后才在新会话里重建索引并让进程级缓存失效，否则下一次对话还会拿旧的元数据。

3. 03

   什么算学习，以及它写回文件的那条路径

   在这里，学习是读与写，不是搜。交给它的资料——Confluence 页面、Swagger 导出、需求文档——走一遍 knowledge-ingestion 工作流：判断该归到哪一条，提取有用的部分，写成带交叉引用的条目；发现已有相似条目就先问是更新还是新建。干活过程中同一件事由 knowledge_rw 完成：新接口进 api-map.md，指标口径进 metric-catalog.md，测试经验进 test-patterns.md。每次写入都会重建索引、刷新完整度分数、把旧正文存进 knowledge_versions 并追加到 history.md；一个全新 slug 会收到一条软提醒，让它先填既有文件，API 与 Kong 的 detail 树和真正的层级子条目除外。遗忘也有流程：过时条目先打标记，经用户确认后退役，purge 负责清掉文件已不存在的索引行。另一条写入路径是自动的——会话的情景记忆摘要，取最近 50 条消息、且用户消息至少 3 条，用该用户第一个可用模型生成，且只在没有轮次在跑时由一次被动 WebSocket 断连触发，因为把半截会话拍成快照之后，「每个会话只留一条」的提前返回会把那份不完整的摘要永久锁住。

4. 04

   什么算共享，边界又画在哪里

   共享是刻意不均匀的。知识查询永远限定在当前项目或全局框架行内，切换项目会清空会话状态，每个项目在仓库之外的 PROJECTS_ROOT 下有自己的工作区。私有项目带一份成员名单——没有用户名目录，创建人直接粘贴单点登录的 user_id，成员自己也能管理这份名单，而可见性开关只留给创建人；名单上「先查后插」的竞争返回 409 而不是 500。密钥是界线最硬的一处：模型密钥与 Git token 分两个保险库用 AES-256-GCM 加密，只在服务端解密进子进程环境供需要的工具使用，永远不进模型上下文，safe_env() 还会把凭据类变量从子进程环境里剥掉。执行跑在双层沙箱里——Shell 的命令白名单，逐段、逐 token 校验路径；再加一个通过 sitecustomize 注入的 CPython audit hook 限制文件写入——而 README 写的是它的边界而不是「隔离」：os.stat 与 os.access 不产生 audit 事件，Node.js 没有等效的运行时钩子，非严格模式下受守护的 Python 再派生出的非 Python 子进程不在文件守卫覆盖内。

5. 05

   更新日志自己承认的那些事

   一份 32,376 字符、把自己的修理过程记下来的更新日志，是这个仓库里最有用的一份文档，而它列的失败都很具体。nginx 在 15 小时里静默死了三次，容器还 Up 着，公网则一直 502，原因是 entrypoint 把 PID 1 交给了 uvicorn；现在 entrypoint 是一个监督循环，负责重启 nginx 并清掉仍占着端口的孤儿 worker。一条横幅告诉用户「上次运行被打断，输入继续」，可那次运行其实还在跑——一个 16 秒的 run 被结算成「已中断」，而同一个会话又继续输出了一小时，因为 API 把一次中途注入当成了终态，此后 finish_run 只能空转。一个知识完整度接口在任何 PostgreSQL 部署上都返回 500，而本地开发与 SQLite 测试全绿，原因是那边的取整函数没有 double precision 重载。持续集成从来没装过浏览器，于是七个真实 Chromium 用例在每个 job 里静默跳过；装上之后那个 job 从 1,649 passed／9 skipped 变成 1,656／2。后台任务从结束的用例里漏出去，握着 SQLite 的写事务不放，后面的用例随机报 database is locked——而仓库最新的一次提交就是这个修复：在逐用例拆掉 engine 之前先把游离任务排空。全局索引器还曾把 29 个模板当成「系统行」扫进每个项目的知识面板，谁也删不掉，最后靠一条跳过规则加一次迁移才清干净。

6. 06

   社区这一轮，以及守着提交的那份契约

   外部贡献是三个 pull request，全部来自同一个账号 Mark-super-code：2026-08-21 注册，1 个公开仓库，0 个关注者，没有显示名。其中两个在开出后大约一分钟就被合并——60 秒与 53 秒——第三个开于 2026-09-28，是这个仓库唯一未关闭的事项，而它那条评论是作者自己的补充，不是评审。那个请求建议把文件系统工具的读取上限从 2 MB 提到 5 MB，并把同一个常量在 API 路由里一起改，理由是那个路由的注释写明它的字节上限是「镜像」这个工具的，不改的话，智能体能读到一个工作区查看器会回 413 的文件。它还如实报了测试结果——1,597 passed、2 skipped、47 failed——并用「把改动 stash 掉再跑一遍」证明这 47 个失败是既有的。这个项目本身还要过一份写下来的卫生契约：提交身份用 GitHub 的 noreply 邮箱，示例主机一律限制在保留的 example.com 家族里，由 scripts/check_commit_hygiene.py 经两个 pre-commit 钩子和一个 CI job 强制执行——加它的原因正是平台自己的智能体是在服务端克隆里提交的，本地钩子装不上。