Astrid Polyrepo地图一张表看懂19个仓库在AI Agent运行时中的分工【免费下载链接】handbookContributor handbook for Astrid: the polyrepo, public contracts, contribution process, and release workflow.项目地址: https://gitcode.com/gh_mirrors/handbook76/handbookAstrid 是一个基于 WASM 沙箱的 AI Agent 运行时它的源码采用polyrepo多仓库架构除了内核、SDK、RFC 三个基础仓库外还有19 个独立仓库的胶囊Capsule各自承担 AI Agent 运行时的不同职能。这篇指南用一张 Polyrepo 地图带你快速看懂 Astrid 的 22 个仓库3 个基础 19 个胶囊如何分工协作以及在新手参与贡献前必须知道的操作细节。 全景速览一张表看懂 Polyrepo 结构Astrid 不是一个 monorepo。本地工作目录下每个组件都是一个独立的 git 仓库层叠在同一个父目录中。完整清单如下本地路径远端仓库层级在 AI Agent 运行时中的分工core/astrid基础内核、守护进程、CLI事件路由、能力校验、WASM 沙箱宿主sdk-rust/sdk-rust基础胶囊开发 SDKastrid-sdk、astrid-sdk-macros、astrid-sysastrid-rfcs/rfcs基础内核-用户空间契约的设计提案RFC无版本号capsules/astrid-capsule-agents/capsule-agents胶囊Agent 编排capsules/astrid-capsule-react/capsule-react胶囊响应式事件处理认知循环capsules/astrid-capsule-session/capsule-session胶囊会话生命周期管理capsules/astrid-capsule-skills/capsule-skills胶囊技能Skill加载器capsules/astrid-capsule-prompt-builder/capsule-prompt-builder胶囊Prompt 组装capsules/astrid-capsule-context-engine/capsule-context-engine胶囊上下文窗口管理capsules/astrid-capsule-memory/capsule-memory胶囊持久化 Agent 记忆capsules/astrid-capsule-registry/capsule-registry胶囊模型注册表与当前模型选择capsules/astrid-capsule-openai/capsule-openai胶囊OpenAI 模型提供商接入capsules/astrid-capsule-openai-compat/capsule-openai-compat胶囊OpenAI 兼容推理路由capsules/astrid-capsule-fs/capsule-fs胶囊文件系统宿主函数capsules/astrid-capsule-http/capsule-http胶囊出站 HTTP 请求capsules/astrid-capsule-shell/capsule-shell胶囊Shell 命令执行host_process特权豁免capsules/astrid-capsule-identity/capsule-identity胶囊认证与主体Principal管理capsules/astrid-capsule-users/capsule-users胶囊用户管理capsules/astrid-capsule-system/capsule-system胶囊系统级能力capsules/astrid-capsule-router/capsule-router胶囊IPC 主题路由capsules/astrid-capsule-cli/capsule-cli胶囊CLI 前端的 Unix socket 桥接Uplinkcapsules/astrid-capsule-hook-bridge/capsule-hook-bridge胶囊Hook 桥接胶水层 命名规律本地目录统一叫astrid-capsule-name而 GitHub 远端仓库去掉前缀只叫capsule-name。这是新手最容易踩坑的地方。 分工核心法则内核很笨胶囊干活Astrid 的架构有一条硬性法则——内核是笨的The Kernel Is Dumb内核只干三件事路由 IPC 事件、执行能力校验、管理 WASM 沙箱。它不含任何业务逻辑、没有 LLM 胶水代码、没有会话状态所有智能都住进胶囊Prompt 组装、模型选择、工具调度、会话管理、记忆读写——分别由capsule-prompt-builder、capsule-registry、capsule-session、capsule-memory各自承载胶囊之间只通过 IPC 事件总线通信内核只负责投递字节永远不解包也不解释负载的语义契约变更必须先写 RFC主机 ABI、IPC 主题格式、能力令牌、Capsule.toml清单、VFS 语义、SDK 公开 API 这 7 类契约面的任何改动都要先在astrid-rfcs/走 RFC 流程简单说内核管能不能做胶囊管做什么。这也是为什么 19 个胶囊仓库比内核更重要——AI Agent 的绝大部分行为都由它们定义。️ Polyrepo 实战Git 操作的 3 个关键细节先cd再gitgit命令只对当前所在的那个仓库生效。在 Polyrepo 根目录跑git status看到的既不是内核也不是 SDK 的状态分支永远从origin/main切出本地main经常是过期的并使用feat/、fix/、refactor/等 Conventional Commits 风格命名提交必须带 GPG 签名构建目标因仓库而异组件目标平台Rust 工具链core/内核宿主机1.95sdk-rust/SDK宿主机1.9419 个胶囊wasm32-unknown-unknown1.94由各自rust-toolchain.toml锁定⚠️ 胶囊不要手动传--target每个胶囊的.cargo/config.toml已替你选好目标用内核的 cargo 去编译胶囊会编译失败。另外贡献者分为New / Astrinaut / Core / Maintainer四级由 CI 的contributor-gate任务强制8 个安全关键 crate如astrid-crypto、astrid-capabilities、astrid-audit只对高层级贡献者开放新手改非核心 crateCLI、SDK、胶囊、文档即可起步。 配套文件与延伸阅读本文所有信息均可在 Contributor Handbook 中溯源Polyrepo 与 Git 工作流polyrepo-and-workflow.md内核是笨的法则the-kernel-is-dumb-law.mdRFC 触发边界rfc-trigger.md贡献层级与安全关键 cratecontribution-tiers.md发布流程与编码标准release-and-standards.md全书入口与章节导航SUMMARY.md、introduction.md一句话总结Astrid 的 Polyrepo 世界里core/是交通警察sdk-rust/是工具箱astrid-rfcs/是法典而 19 个胶囊仓库才是真正开车的 AI Agent 们——看懂这张表你就拿到了参与贡献的第一把钥匙。【免费下载链接】handbookContributor handbook for Astrid: the polyrepo, public contracts, contribution process, and release workflow.项目地址: https://gitcode.com/gh_mirrors/handbook76/handbook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考