Agent Substrate术语表完全解析从ActorTemplate到Uniform DNS Mesh的15个关键词【免费下载链接】substrateAgent Substrate: the core system项目地址: https://gitcode.com/GitHub_Trending/substrate7/substrate初学Agent Substrate一个面向 AI Agent 的大规模沙箱执行底座时最劝退的就是术语。这篇文章基于官方术语表 docs/glossary.md把Agent Substrate 术语表中最核心的 15 个关键词——从ActorTemplate到常被社区称为 Uniform DNS Mesh 的统一 Actor 路由——用大白话一次性讲透让你快速建立完整心智模型。先认识 Agent Substrate一个Agent 超密集调度器一句话理解Agent Substrate 把大量演员Actor映射到少量工人Worker上。Agent 类应用大部分时间在等待于是系统会在 Actor 空闲时把它冬眠Suspend、在请求到来时秒醒Resume靠快照实现 sub-500ms 的恢复和 30 倍以上的资源超卖。官方文档入口术语表docs/glossary.md架构原理docs/architecture.md快速上手README.md一、声明式资源系统的三张图纸这三类资源描述系统应该长什么样变更频率低属于静态配置。1. ActorTemplateActor 的类定义ActorTemplate定义了一个 Actor 的版本用哪个容器镜像、快照怎么配。它不可变——要发新版就建一个新模板而不是改旧的类似Pod 模板但专给可打快照的工作负载用。注意它不是 K8s 对象而是存在 Substrate 控制面数据库里的记录通过kubectl ate create actor-template管理。创建它会触发一次 黄金启动生成 Golden Snapshot。出处docs/glossary.md#L10-L172. WorkerPool预热算力池WorkerPool是一个K8s CRD声明一批已经启动好、随时待命的 worker Pod。控制面组件 atecontroller 会把它调谐成一个 K8sDeployment。它是实现秒级唤醒的关键——Pod 早就热好了省掉了 K8s 调度的秒级延迟。出处docs/glossary.md#L19-L213. SandboxConfig沙箱运行时的固件仓SandboxConfig是集群级资源存放某一代沙箱运行时的二进制gVisor 的runsc或 micro-VM 的内核/固件/配置以及 pause 镜像。一个ActorTemplate通过命名一个 SandboxConfig 来钉住运行时版本很多模板可以共享同一份配置。出处docs/glossary.md#L23-L29二、动态记录Actor、Atespace、Worker这三类记录变化太快放 etcd 会撑不住所以存在控制面的 PostgreSQL 数据库里。4. AtespaceActor 的隔离小区Atespace 是 Actor 所属的隔离边界也是 Actor 身份的前半段Actor 用(atespace, name)寻址所以同名 Actor 可以存在于不同 atespace。它是全局资源而非 K8s namespace——ActorTemplate也住在 atespace 里而WorkerPool住在 K8s namespace 里。Atespace 空了才能删除。出处docs/glossary.md#L36-L415. Actor被超卖的核心单元Actor 是从某个ActorTemplate派生的单个实例名字是 DNS-1123 标签。它是挂起/恢复的基本单位一生会在不同 Worker 之间来回迁移。Actor 记录跟踪它的生命周期状态和快照引用。出处docs/glossary.md#L43-L476. Worker一个 Pod 一条记录Worker 是WorkerPool中某个 worker Pod 的数据库记录。它同一时间最多托管一个 Actor但随时间可以在池内多路复用成百上千个 Actor。出处docs/glossary.md#L48-L50三、六大系统组件各司其职的岗位组件清单见 docs/glossary.md#L52-L77源码目录见 cmd/。#组件角色一句话类比7ate-api-server二进制ateapi控制面管 Actor 生命周期、把 Actor 调度到 Worker、协调快照大脑8atecontrollerK8s 控制器把WorkerPool等 CRD 调谐成 Deployment基建监理9atelet节点级 SupervisorDaemonSet拉镜像、组装 OCI bundle、驱动沙箱、搬运快照宿管员10ateom运行在每个 worker Pod 内部替 atelet 驱动沙箱运行时分ateom-gvisor/ateom-microvm两味车间主任11atenet网络栈router 按需唤醒挂起的 Actor 并把流量路由到正确的 worker Pod总机话务员12kubectl-atekubectl 插件 CLI管理 Actor 生命周期、列出 Worker指挥棒架构细节可对照 docs/architecture.md#L305-L367atenet 部署细节在 cmd/atenet/README.md。四、生命周期三件套Suspend、Pause、Resume这是理解 Agent Substrate 的钥匙三个词对应 docs/glossary.md#L79-L91Suspend冬眠把运行中或已暂停的 Actor 变成对象存储里的持久快照所在 Worker 随即释放——资源彻底回收。Pause小憩短期检查点快照文件留在节点上不上传下一次 Resume 会优先调度回原节点恢复更快。Resume唤醒把挂起/暂停的 Actor 恢复到某个 Worker。常规路径是从快照恢复而非冷启动这就是 sub-500ms 唤醒的来源。状态机全景SUSPENDED → RESUMING → RUNNING → PAUSED…见 docs/architecture.md#L404-L416。五、快照四兄弟状态如何存得住13. Golden Snapshot模板的出厂快照创建ActorTemplate时做一次黄金启动并拍下初始检查点之后该模板的每个 Actor首次唤醒都默认从这份共享快照恢复而不是冷启动镜像——这是秒醒的另一半秘密。它永远是Full作用域。出处docs/glossary.md#L145-L15014. 两个快照作用域Full 与 DataFull进程内存 rootfs 增量 DurableDir 卷恢复即热启动。Data只留 DurableDir 应用数据丢掉内存和 rootfs用来低成本持久化数据。它们通过onPause/onCommit按触发时机配置且onCommit必须是onPause的子集。与之配套的还有DurableDir 卷跨挂起/恢复保留的应用数据目录micro-VM 模板可挂多个、gVisor 目前限一个和Last SnapshotActor 最近一次的个人快照用于下次 Resume。出处docs/glossary.md#L93-L156快照最终落在Snapshot storageGCS 或 S3 对象存储保证状态跨集群持久、可移植。15. Uniform DNS Mesh统一的 Actor 寻址路由最后说清标题里的Uniform DNS Mesh。它是社区对 Substrate 网络层atenet能力的形象称呼任何 Actor 都可以用统一的atespace/actor名字被寻址——调用方只需在 HTTP 头带上ate-target-actor: atespace/actoratenet-router就会负责定位 Actor、必要时触发 Resume再通过 mTLS 隧道把请求送到正确 worker Pod 里的 Actor。对使用者来说就像一张名字即路由的均匀网格你不用知道 Actor 现在物理上在哪个 Pod像用 DNS 一样用名字访问即可。出处docs/glossary.md#L158-L162、docs/architecture.md#L340-L36715 个关键词速查表#关键词类别一句话1ActorTemplate声明式资源Actor 的不可变类定义2WorkerPoolK8s CRD预热 worker Pod 池3SandboxConfigK8s CRD钉住沙箱运行时版本4Atespace动态记录Actor 的隔离命名空间5Actor动态记录被挂起/恢复的核心实例6Worker动态记录一个 worker Pod 的记录7ate-api-server组件控制面大脑8atecontroller组件CRD 调谐器9atelet组件节点级 DaemonSet 监督者10ateom组件worker Pod 内的沙箱驱动11atenet组件Actor 感知路由与唤醒12kubectl-ate组件命令行操作入口13Golden Snapshot快照模板出厂的共享快照14Full / Data 作用域快照全量热恢复 vs 只存数据15Uniform DNS Mesh网络按名字统一寻址 Actor小结抓住一条主线就够了——ActorTemplate 定义类 → Actor 是实例 → 请求经 atenet 路由并 Resume 到 Worker → 空闲后 Suspend 成快照其余术语都是这条主线上的配角。想动手验证可以直接跑 Counter Demo它用一个有状态的计数器演示了挂起/恢复下的状态保持与按需唤醒源码在 demos/counter/。【免费下载链接】substrateAgent Substrate: the core system项目地址: https://gitcode.com/GitHub_Trending/substrate7/substrate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Agent Substrate术语表完全解析：从ActorTemplate到Uniform DNS Mesh的15个关键词
Agent Substrate术语表完全解析从ActorTemplate到Uniform DNS Mesh的15个关键词【免费下载链接】substrateAgent Substrate: the core system项目地址: https://gitcode.com/GitHub_Trending/substrate7/substrate初学Agent Substrate一个面向 AI Agent 的大规模沙箱执行底座时最劝退的就是术语。这篇文章基于官方术语表 docs/glossary.md把Agent Substrate 术语表中最核心的 15 个关键词——从ActorTemplate到常被社区称为 Uniform DNS Mesh 的统一 Actor 路由——用大白话一次性讲透让你快速建立完整心智模型。先认识 Agent Substrate一个Agent 超密集调度器一句话理解Agent Substrate 把大量演员Actor映射到少量工人Worker上。Agent 类应用大部分时间在等待于是系统会在 Actor 空闲时把它冬眠Suspend、在请求到来时秒醒Resume靠快照实现 sub-500ms 的恢复和 30 倍以上的资源超卖。官方文档入口术语表docs/glossary.md架构原理docs/architecture.md快速上手README.md一、声明式资源系统的三张图纸这三类资源描述系统应该长什么样变更频率低属于静态配置。1. ActorTemplateActor 的类定义ActorTemplate定义了一个 Actor 的版本用哪个容器镜像、快照怎么配。它不可变——要发新版就建一个新模板而不是改旧的类似Pod 模板但专给可打快照的工作负载用。注意它不是 K8s 对象而是存在 Substrate 控制面数据库里的记录通过kubectl ate create actor-template管理。创建它会触发一次 黄金启动生成 Golden Snapshot。出处docs/glossary.md#L10-L172. WorkerPool预热算力池WorkerPool是一个K8s CRD声明一批已经启动好、随时待命的 worker Pod。控制面组件 atecontroller 会把它调谐成一个 K8sDeployment。它是实现秒级唤醒的关键——Pod 早就热好了省掉了 K8s 调度的秒级延迟。出处docs/glossary.md#L19-L213. SandboxConfig沙箱运行时的固件仓SandboxConfig是集群级资源存放某一代沙箱运行时的二进制gVisor 的runsc或 micro-VM 的内核/固件/配置以及 pause 镜像。一个ActorTemplate通过命名一个 SandboxConfig 来钉住运行时版本很多模板可以共享同一份配置。出处docs/glossary.md#L23-L29二、动态记录Actor、Atespace、Worker这三类记录变化太快放 etcd 会撑不住所以存在控制面的 PostgreSQL 数据库里。4. AtespaceActor 的隔离小区Atespace 是 Actor 所属的隔离边界也是 Actor 身份的前半段Actor 用(atespace, name)寻址所以同名 Actor 可以存在于不同 atespace。它是全局资源而非 K8s namespace——ActorTemplate也住在 atespace 里而WorkerPool住在 K8s namespace 里。Atespace 空了才能删除。出处docs/glossary.md#L36-L415. Actor被超卖的核心单元Actor 是从某个ActorTemplate派生的单个实例名字是 DNS-1123 标签。它是挂起/恢复的基本单位一生会在不同 Worker 之间来回迁移。Actor 记录跟踪它的生命周期状态和快照引用。出处docs/glossary.md#L43-L476. Worker一个 Pod 一条记录Worker 是WorkerPool中某个 worker Pod 的数据库记录。它同一时间最多托管一个 Actor但随时间可以在池内多路复用成百上千个 Actor。出处docs/glossary.md#L48-L50三、六大系统组件各司其职的岗位组件清单见 docs/glossary.md#L52-L77源码目录见 cmd/。#组件角色一句话类比7ate-api-server二进制ateapi控制面管 Actor 生命周期、把 Actor 调度到 Worker、协调快照大脑8atecontrollerK8s 控制器把WorkerPool等 CRD 调谐成 Deployment基建监理9atelet节点级 SupervisorDaemonSet拉镜像、组装 OCI bundle、驱动沙箱、搬运快照宿管员10ateom运行在每个 worker Pod 内部替 atelet 驱动沙箱运行时分ateom-gvisor/ateom-microvm两味车间主任11atenet网络栈router 按需唤醒挂起的 Actor 并把流量路由到正确的 worker Pod总机话务员12kubectl-atekubectl 插件 CLI管理 Actor 生命周期、列出 Worker指挥棒架构细节可对照 docs/architecture.md#L305-L367atenet 部署细节在 cmd/atenet/README.md。四、生命周期三件套Suspend、Pause、Resume这是理解 Agent Substrate 的钥匙三个词对应 docs/glossary.md#L79-L91Suspend冬眠把运行中或已暂停的 Actor 变成对象存储里的持久快照所在 Worker 随即释放——资源彻底回收。Pause小憩短期检查点快照文件留在节点上不上传下一次 Resume 会优先调度回原节点恢复更快。Resume唤醒把挂起/暂停的 Actor 恢复到某个 Worker。常规路径是从快照恢复而非冷启动这就是 sub-500ms 唤醒的来源。状态机全景SUSPENDED → RESUMING → RUNNING → PAUSED…见 docs/architecture.md#L404-L416。五、快照四兄弟状态如何存得住13. Golden Snapshot模板的出厂快照创建ActorTemplate时做一次黄金启动并拍下初始检查点之后该模板的每个 Actor首次唤醒都默认从这份共享快照恢复而不是冷启动镜像——这是秒醒的另一半秘密。它永远是Full作用域。出处docs/glossary.md#L145-L15014. 两个快照作用域Full 与 DataFull进程内存 rootfs 增量 DurableDir 卷恢复即热启动。Data只留 DurableDir 应用数据丢掉内存和 rootfs用来低成本持久化数据。它们通过onPause/onCommit按触发时机配置且onCommit必须是onPause的子集。与之配套的还有DurableDir 卷跨挂起/恢复保留的应用数据目录micro-VM 模板可挂多个、gVisor 目前限一个和Last SnapshotActor 最近一次的个人快照用于下次 Resume。出处docs/glossary.md#L93-L156快照最终落在Snapshot storageGCS 或 S3 对象存储保证状态跨集群持久、可移植。15. Uniform DNS Mesh统一的 Actor 寻址路由最后说清标题里的Uniform DNS Mesh。它是社区对 Substrate 网络层atenet能力的形象称呼任何 Actor 都可以用统一的atespace/actor名字被寻址——调用方只需在 HTTP 头带上ate-target-actor: atespace/actoratenet-router就会负责定位 Actor、必要时触发 Resume再通过 mTLS 隧道把请求送到正确 worker Pod 里的 Actor。对使用者来说就像一张名字即路由的均匀网格你不用知道 Actor 现在物理上在哪个 Pod像用 DNS 一样用名字访问即可。出处docs/glossary.md#L158-L162、docs/architecture.md#L340-L36715 个关键词速查表#关键词类别一句话1ActorTemplate声明式资源Actor 的不可变类定义2WorkerPoolK8s CRD预热 worker Pod 池3SandboxConfigK8s CRD钉住沙箱运行时版本4Atespace动态记录Actor 的隔离命名空间5Actor动态记录被挂起/恢复的核心实例6Worker动态记录一个 worker Pod 的记录7ate-api-server组件控制面大脑8atecontroller组件CRD 调谐器9atelet组件节点级 DaemonSet 监督者10ateom组件worker Pod 内的沙箱驱动11atenet组件Actor 感知路由与唤醒12kubectl-ate组件命令行操作入口13Golden Snapshot快照模板出厂的共享快照14Full / Data 作用域快照全量热恢复 vs 只存数据15Uniform DNS Mesh网络按名字统一寻址 Actor小结抓住一条主线就够了——ActorTemplate 定义类 → Actor 是实例 → 请求经 atenet 路由并 Resume 到 Worker → 空闲后 Suspend 成快照其余术语都是这条主线上的配角。想动手验证可以直接跑 Counter Demo它用一个有状态的计数器演示了挂起/恢复下的状态保持与按需唤醒源码在 demos/counter/。【免费下载链接】substrateAgent Substrate: the core system项目地址: https://gitcode.com/GitHub_Trending/substrate7/substrate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考