企业官网建设流程全解析

1. Substrate 是什么？不是区块链框架，也不是 Rust 库——它是一套“可编程运行时”的底层操作系统思维

很多人第一次看到substrate这个词，会下意识联想到“基底”“底层”“支撑物”，然后立刻跳转到两个常见误区：一是把它当成某个区块链项目的代号（比如 Polkadot 的底层），二是把它当作一个类似 libc 或 tokio 的通用 Rust 工具库。这完全偏离了它的本质。Substrate 的核心定位，是为构建可信执行环境（Trusted Execution Environment, TEE）和轻量级隔离沙箱提供一套可组合、可裁剪、可验证的运行时基础设施。它不直接解决“怎么写智能合约”，也不负责“怎么调度 Pod”，但它决定了：当一个 agent 在 Kubernetes 集群里被调度执行时，它的代码到底是在裸金属上跑、在 gVisor 的用户态内核里跑、还是在 Intel SGX enclave 里跑——而这个“跑在哪、怎么跑、跑得是否可信”，正是 Substrate 要回答的问题。

你能在热搜词里频繁看到substrate + agent + OCI + kubernetes + gVisor的组合，绝非偶然。这背后是一条正在快速收敛的技术路径：现代 AI agent 不再是简单调用 API 的脚本，而是需要具备状态记忆、工具调用、多步推理、安全隔离能力的“数字实体”。它必须能加载外部 skill（比如调用数据库的 PL/SQL 模块），必须能与 Kubernetes 原生集成（比如通过 CRD 管理 agent 生命周期），必须能规避传统容器逃逸风险（所以要引入 gVisor 或 Kata Containers 这类强隔离层）。而 Substrate，就是把这一切“运行保障能力”标准化、模块化、声明化的那个“操作系统内核层”。

举个生活化类比：如果把 Kubernetes 比作一座现代化城市，那么 kubelet 是市政工程队，CNI 插件是道路规划局，CSI 插件是水电管网公司——而 Substrate 就相当于这座城市的“地基规范标准”。它不盖楼，但规定了每栋楼的地基深度、承重结构、抗震等级、管线预埋位置；它不管 agent 做什么业务逻辑，但强制定义了 agent 的内存页表如何映射、系统调用如何拦截、密钥如何安全注入、状态快照如何原子保存。这也是为什么你在搜索“plsql 无法定位 oci dll”时，最终会绕回到 Substrate 的 OCI runtime 配置——因为问题根源不在 PL/SQL 驱动本身，而在于 agent 运行时是否正确挂载了 host 的 Oracle 客户端库路径，以及该路径是否被 gVisor 的 syscall 过滤器放行。

对开发者而言，Substrate 的价值非常具体：它让你摆脱“每次换一个隔离方案就要重写一遍 agent 启动逻辑”的泥潭。你写一次 agent 的业务代码（比如一个调用数据库并生成报告的 Rust 函数），就能通过 Substrate 的 runtime descriptor 文件，一键部署到 gVisor 容器、Kata 虚拟机、甚至 WebAssembly 沙箱中，而无需修改任何业务逻辑。这种“一次编写、多环境可信运行”的能力，正是当前 agent 开发最痛的刚需——毕竟，没人想为每个测试环境都单独维护一套 Dockerfile + seccomp profile + capabilities 配置。

2. Substrate 的核心设计哲学：从“进程抽象”到“可信执行单元抽象”

2.1 为什么传统容器 runtime 不足以支撑 modern agent？

要真正理解 Substrate 的不可替代性，必须先看清现有技术栈的断层。我们以 Kubernetes 中运行一个典型 AI agent 为例：

• 标准 containerd + runc 流程：agent 镜像解压 → rootfs 挂载 → namespace 创建 → cgroups 限制 → execve 启动主进程
• gVisor 补充流程：在上述基础上插入 Sentry 用户态内核 → syscall 拦截 → 转译为 host syscall 或模拟实现
• Kata Containers 补充流程：用轻量级 VM 替代 namespace/cgroups，每个 pod 独占一个 microVM

表面看，这些方案都在做“隔离”，但它们共同的致命缺陷是：隔离粒度与 agent 的语义需求完全错配。Agent 不是一个静态进程，而是一个动态实体：它需要在执行中加载新 skill（如动态 dlopen oci.dll），需要跨步骤保持 memory（短期记忆缓存），需要响应外部事件（如 webhook 触发重试），需要安全导出结果（如加密后写入 S3）。而 runc/gVisor/Kata 全部停留在“进程生命周期管理”层面，对“agent 状态生命周期”、“skill 加载策略”、“memory 安全边界”等更高阶语义毫无感知。

Substrate 的破局点，就在于它把“agent”本身提升为一级原语（first-class primitive）。它不抽象“进程”，而是抽象“可信执行单元（Trusted Execution Unit, TEU）”。一个 TEU 包含四个不可分割的契约：

1. Execution Context（执行上下文）：定义 CPU 架构（x86_64 / aarch64）、ABI（Linux ABI / WASI）、特权级别（user-mode only / with SGX attestation）
2. State Boundary（状态边界）：明确划分 volatile memory（RAM）、persistent storage（encrypted volume）、ephemeral cache（in-memory LRU）的访问权限与持久化策略
3. Skill Interface（技能接口）：声明 agent 可调用的外部能力，如oci://oracle-client@19.21、http://api.example.com/v1、wasm://data-processor.wasm，并附带 capability token
4. Attestation Policy（证明策略）：指定如何向远程 verifier 证明当前 TEU 的完整性，例如 “必须运行在 gVisor v2024.3.1 + kernel 5.15.123 + no ptrace enabled”

提示：Substrate 的 descriptor 文件（通常为substrate.yaml）就是对这四个契约的 YAML 声明。它不是 Dockerfile 的替代品，而是比 Dockerfile 更底层的“可信运行时蓝图”。一个典型的 descriptor 片段如下：

teu: name: "db-report-agent" version: "1.2.0" execution_context: runtime: "gvisor" gvisor_version: "v2024.3.1" kernel: "5.15.123" state_boundary: volatile_memory_mb: 512 persistent_storage: "encrypted-volume://report-db" cache_policy: "lru-10m" skill_interfaces: - uri: "oci://oracle-client@19.21" capability: "database:read-write" mount_path: "/usr/lib/oracle" attestation_policy: type: "sgx-ecdsa" quote_url: "https://attest.example.com/v1/quote"

2.2 Substrate 如何实现“可编程运行时”？关键在三个分层引擎

Substrate 的架构不是单体二进制，而是由三个松耦合但强协同的引擎构成，每个引擎解决一类根本问题：

第一层：Runtime Composition Engine（运行时组合引擎）
这是 Substrate 的心脏。它不自己实现 syscall 拦截或 VM 启动，而是作为“胶水层”，将上游 runtime（如 gVisor 的 Sentry、Kata 的 firecracker）和下游 agent 代码桥接起来。其核心能力是dynamic runtime binding：在 agent 启动前，根据 descriptor 中的execution_context.runtime字段，自动下载、校验、加载对应版本的 runtime 组件，并注入 agent 所需的初始化参数（如 gVisor 的--platform=ptrace或 Kata 的--kernel=/path/to/vmlinux）。这解决了运维中最头疼的问题——gVisor 升级后，所有依赖旧版 syscall table 的 agent 全部崩溃。Substrate 让每个 agent 拥有自己专属的 runtime 版本，互不干扰。

第二层：State Orchestrator（状态编排器）
传统容器 runtime 对“状态”只有粗暴的 binary blob 概念（即整个 rootfs）。Substrate 则将状态细分为三类，并为每类提供专用管理器：

• Volatile State Manager：基于 mmap 的零拷贝共享内存，用于 agent 内部多线程间高速通信（如 LLM 推理 pipeline 的 tensor buffer）
• Persistent State Vault：对接 KMS（Key Management Service）的加密卷，所有写入自动 AES-256-GCM 加密，密钥由 agent 的 attestation report 动态派生
• Ephemeral Cache Broker：一个内存中的 LRU 缓存代理，支持 TTL 和 size-based eviction，且 cache key 自动绑定 agent 的 identity hash，杜绝跨 agent 数据污染

第三层：Skill Gateway（技能网关）
这才是真正让 agent “活起来”的模块。它不是一个简单的网络代理，而是一个带策略的 capability router。当 agent 代码执行dlopen("/usr/lib/oracle/libclntsh.so")时，Skill Gateway 拦截该调用，检查 descriptor 中是否声明了oci://oracle-client@19.21，验证 capability token 是否包含database:read-write权限，确认 mount_path/usr/lib/oracle是否在 sandbox 的 allowed paths 列表中，最后才将 host 上的真实 so 文件映射进 TEU 的地址空间。整个过程对 agent 代码完全透明——它只管dlopen，剩下的全由 Substrate 保障。

这三个引擎共同构成了 Substrate 的“可编程”本质：你不需要改写 agent 代码，只需修改 descriptor 中的 YAML 字段，就能在不重启 agent 的情况下，动态切换 runtime（从 gVisor 切到 Kata）、调整内存配额（从 512MB 升到 1GB）、增删 skill 接口（添加s3://bucket-name读取权限）。这种声明式、细粒度、运行时可变的控制能力，是 Docker 或 Podman 永远无法提供的。

3. Substrate 在 Kubernetes 生态中的落地实操：从 descriptor 到 PodSpec 的完整链路

3.1 为什么不能直接用 Kubernetes 原生资源？——缺失的 TEU 抽象层

Kubernetes 的核心资源对象（Pod、Deployment、StatefulSet）全部围绕“容器”设计。一个 Pod 的 spec 定义了 containers、volumes、initContainers，但它无法表达：“这个容器必须运行在 gVisor 下，且其 /usr/lib/oracle 目录必须从 host 的 /opt/oracle/instantclient_19_21 映射，且该映射需通过 gVisor 的 fsmap 机制而非 bind mount 实现”。更关键的是，Kubernetes 没有“TEU 状态边界”的概念——你无法告诉 kubelet：“这个 Pod 的 volatile memory 必须严格限制在 512MB，超出部分立即 OOM kill，且不允许 swap to disk”。

因此，Substrate 在 Kubernetes 中的集成，不是简单地替换 container runtime，而是引入一个 CRD（Custom Resource Definition）来承载 TEU 抽象。这个 CRD 名为TrustedExecutionUnit（简称 TEU），其 schema 直接映射 Substrate descriptor 的字段。当你创建一个 TEU 资源时，Substrate Controller（一个独立的 operator）会监听该事件，并将其编译为标准的 Kubernetes PodSpec，同时注入必要的 runtime-specific annotations 和 initContainers。

注意：Substrate Controller 不是 kubelet 的插件，而是一个独立的 controller manager。它与 kubelet 平等协作，而非替代。这种设计保证了最大兼容性——即使你的集群没有安装 Substrate Controller，标准 Pod 依然能正常运行；反之，安装了 Controller 后，TEU 资源也能无缝转换为 Pod。

3.2 实操：手把手部署一个带 Oracle skill 的 agent TEU

假设我们要部署一个名为sales-report-agent的 agent，它需要连接 Oracle 数据库生成日报。以下是完整步骤，全部基于真实生产环境验证：

第一步：准备 agent 二进制与 OCI 客户端

# agent 代码使用 Rust 编写，依赖 oracle-sys crate # 编译为静态链接二进制（避免 runtime 依赖） cargo build --release --target x86_64-unknown-linux-musl # 输出 target/x86_64-unknown-linux-musl/release/sales-report-agent # 下载 Oracle Instant Client 19.21（官方 RPM） wget https://download.oracle.com/otn_software/linux/instantclient/192100/oracle-instantclient19.21-basic-19.21.0.0.0-1.x86_64.rpm # 解压 RPM 获取 so 文件（使用 rpm2cpio + cpio） rpm2cpio oracle-instantclient19.21-basic-19.21.0.0.0-1.x86_64.rpm | cpio -idmv # 得到 libclntsh.so.19.1 等文件

第二步：编写 substrate.yaml descriptor

teu: name: "sales-report-agent" version: "1.0.0" # 关键：指定 gVisor runtime，避免传统容器逃逸 execution_context: runtime: "gvisor" gvisor_version: "v2024.3.1" kernel: "5.15.123" # 内存严格限制，防止 agent 泄露敏感数据 state_boundary: volatile_memory_mb: 512 persistent_storage: "encrypted-volume://sales-reports" cache_policy: "lru-5m" # 声明 Oracle skill，指定 capability 和挂载路径 skill_interfaces: - uri: "oci://oracle-client@19.21" capability: "database:read-only" mount_path: "/usr/lib/oracle" # gVisor 特有的 fsmap 配置，确保 syscall 正确转发 fsmap: source: "/opt/oracle/instantclient_19_21" target: "/usr/lib/oracle" readonly: true # 安全证明策略，要求 gVisor 完整性 attestation_policy: type: "gvisor-integrity" expected_hash: "sha256:abc123...def456"

第三步：创建 TEU CRD 资源

# teu-sales-report.yaml apiVersion: substrate.io/v1alpha1 kind: TrustedExecutionUnit metadata: name: sales-report-agent namespace: default spec: # 直接嵌入 descriptor 内容 descriptor: | teu: name: "sales-report-agent" version: "1.0.0" execution_context: runtime: "gvisor" gvisor_version: "v2024.3.1" kernel: "5.15.123" state_boundary: volatile_memory_mb: 512 persistent_storage: "encrypted-volume://sales-reports" cache_policy: "lru-5m" skill_interfaces: - uri: "oci://oracle-client@19.21" capability: "database:read-only" mount_path: "/usr/lib/oracle" fsmap: source: "/opt/oracle/instantclient_19_21" target: "/usr/lib/oracle" readonly: true attestation_policy: type: "gvisor-integrity" expected_hash: "sha256:abc123...def456" # 指定 agent 二进制镜像（已打包进镜像） image: "registry.example.com/agents/sales-report:v1.0.0" # 启动命令，Substrate 会自动注入 runtime 环境 command: ["/sales-report-agent"] args: ["--db-host", "db.example.com", "--db-port", "1521"]

第四步：应用并观察转换过程

# 应用 TEU 资源 kubectl apply -f teu-sales-report.yaml # 查看 Substrate Controller 日志，确认转换 kubectl logs -n substrate-system deploy/substrate-controller | grep "TEU sales-report-agent converted" # 查看生成的 Pod（注意 annotations） kubectl get pod -l app=sales-report-agent -o wide # NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES # sales-report-agent-7c8b9d4f5-xyzab 1/1 Running 0 2m 10.244.1.12 node-01 <none> <none> kubectl get pod sales-report-agent-7c8b9d4f5-xyzab -o yaml | grep -A 10 "annotations" # annotations: # substrate.io/runtime: "gvisor" # substrate.io/gvisor-version: "v2024.3.1" # substrate.io/state-boundary: "volatile-memory-512mb" # # 这些 annotation 是 Substrate Controller 注入的，kubelet 会据此调用对应 runtime

第五步：验证 Oracle skill 加载成功
进入 Pod 执行诊断命令：

kubectl exec -it sales-report-agent-7c8b9d4f5-xyzab -- sh # 检查 /usr/lib/oracle 是否存在且可读 ls -la /usr/lib/oracle/ # total 12288 # drwxr-xr-x 2 root root 4096 Apr 10 08:22 . # drwxr-xr-x 1 root root 4096 Apr 10 08:22 .. # -rwxr-xr-x 1 root root 2222222 Apr 10 08:22 libclntsh.so.19.1 # -rwxr-xr-x 1 root root 1111111 Apr 10 08:22 libocci.so.19.1 # 检查 agent 是否能 dlopen（关键！） /sales-report-agent --dry-run # INFO: Loaded OCI client from /usr/lib/oracle/libclntsh.so.19.1 # INFO: Connected to database successfully # SUCCESS: All skill interfaces verified

这个过程看似复杂，但实际只需 5 个 YAML 文件（1 个 TEU + 1 个 encrypted volume + 1 个 secret for db creds + 1 个 service account + 1 个 network policy），远少于手动配置 gVisor + seccomp + capabilities + volumes 的 15+ 个参数。更重要的是，所有安全策略（内存限制、只读挂载、capability 验证）都在 descriptor 中声明，而非分散在 PodSpec 的各个角落，极大提升了可审计性和可复现性。

4. Substrate 与 gVisor、OCI、Kubernetes 的深度协同机制解析

4.1 Substrate 如何接管 gVisor？不是 fork，而是“runtime injection”

很多开发者误以为 Substrate 要求你 fork gVisor 代码并打 patch。这是完全错误的理解。Substrate 与 gVisor 的关系，类似于 Webpack 与 Babel：Substrate 不修改 gVisor 一行代码，而是通过标准的 gVisor extension mechanism，在 runtime 启动时动态注入 custom platform 和 syscall handler。

gVisor 的核心组件 Sentry，设计上就支持 plugin-based architecture。它定义了Platform接口（负责底层资源分配）和SyscallHandler接口（负责 syscall 处理逻辑）。Substrate 提供的gvisor-substrate-platform是一个符合 gVisor Platform 接口的独立 crate，它在 Sentry 启动时被动态加载，接管以下关键职责：

• Memory Layout Enforcement：传统 gVisor 允许 agent 进程申请任意大小内存，Substrate Platform 会拦截mmapsyscall，检查请求 size 是否超过 descriptor 中volatile_memory_mb限制，超限则返回ENOMEM
• FSMap Validation：当 agent 调用open("/usr/lib/oracle/libclntsh.so.19.1")时，Substrate SyscallHandler 先检查该路径是否在 descriptor 的fsmap白名单中，再调用 gVisor 原生的fsmap.Open，而非直接透传给 host
• Capability Token Injection：在 agent 进程启动前，Substrate Platform 将 descriptor 中声明的 skill capability tokens（如database:read-only的 JWT）写入进程的/proc/self/environ，agent 代码可通过std::env::var("SUBSTRATE_SKILL_TOKEN")安全读取

这种设计带来两大优势：

1. 零侵入升级：gVisor 发布新版时，你只需更新gvisor-substrate-platformcrate 的依赖版本，无需修改 gVisor 源码
2. 多 runtime 兼容：同一份 Substrate descriptor，可以无缝切换到 Kata Containers 的kata-substrate-platform，因为两者都实现了相同的 Substrate Platform trait

实测心得：我们在生产环境对比过 Substrate + gVisor 与原生 gVisor 的性能开销。在纯 CPU 密集型任务（如 LLM tokenization）上，性能损失约 3.2%；但在涉及大量 syscall 的场景（如数据库连接池初始化），由于 Substrate 的 syscall 预检机制，反而比原生 gVisor 快 12%，因为它避免了无效的 syscall 转译开销。

4.2 Substrate 如何与 OCI 标准融合？超越 docker build 的镜像语义

OCI（Open Container Initiative）规范定义了image-spec和runtime-spec，但这两个 spec 都停留在“如何运行一个进程”的层面。Substrate 通过扩展 OCI image layout，为镜像赋予了“TEU 语义”：

• 新增 descriptor layer：在 OCI 镜像的 manifest 中，增加一个特殊 layer，其 mediaType 为application/vnd.substrate.teu.v1+json，内容即为substrate.yaml的 JSON 序列化版本
• 新增 runtime hook：在 OCI runtime config.json 中，增加"hooks"字段，指向 Substrate 的 prestart hook：/usr/bin/substrate-runtime-hook，该 hook 负责解析 descriptor layer 并初始化 TEU 环境
• 新增 image annotation：镜像 build 时，通过docker build --label substrate.teu=true标记，Substrate Controller 会优先选择此类镜像，确保 runtime 一致性

这意味着，一个 Substrate-aware 的 OCI 镜像，本身就包含了完整的 TEU 契约。你可以用ctr images pull拉取镜像后，直接用ctr run --rm --net-plugin=cni --runtime=io.containerd.substrate.v1启动，无需额外配置文件。这种“镜像即契约”的理念，彻底解决了 agent 开发中“开发环境能跑，生产环境报错”的经典难题——因为镜像里已经固化了 runtime、skill、state 的全部约束。

4.3 Substrate 如何赋能 Kubernetes 的 agent 编排？从 CRD 到 admission webhook 的闭环

Substrate 在 Kubernetes 中的价值，不仅在于 TEU CRD，更在于它补全了 agent 编排的全链路安全控制：

Admission Control Layer：Substrate 提供一个 Mutating Admission Webhook，当用户提交 PodSpec 时，webhook 会检查该 Pod 是否引用了 Substrate-managed 的 image（通过 image labelsubstrate.teu=true）。如果是，则自动注入securityContext和runtimeClassName，并拒绝任何违反 descriptor 约束的字段（如用户手动设置resources.limits.memory: "2Gi"，但 descriptor 只允许 512Mi，webhook 会拦截并返回 error）。

Observability Integration：Substrate Controller 会为每个 TEU 生成 Prometheus metrics endpoint，暴露substrate_teu_state_volatile_memory_bytes、substrate_teu_skill_call_total{skill="oci://oracle-client"}、substrate_teu_attestation_success{policy="gvisor-integrity"}等指标。这些指标与 Kubernetes 的kube_pod_container_resource_limits_memory_bytes形成互补，前者反映 agent 实际内存使用，后者反映 kubelet 的配额限制，便于精准定位 OOM 原因。

Lifecycle Management：Substrate 定义了 TEU 的TerminationPolicy字段，支持三种模式：

• graceful（默认）：发送 SIGTERM，等待 agent 完成当前 skill 调用后再退出
• atomic：立即 kill，但确保所有 persistent state 已加密 flush 到 volume
• attested：仅当 attestation verifier 返回 success 时才允许终止，用于合规审计场景

这种细粒度的生命周期控制，是 Kubernetes 原生terminationGracePeriodSeconds无法比拟的。它让 agent 的启停不再是“粗暴的进程开关”，而是“受控的状态迁移”。

5. 常见问题排查与实战避坑指南：来自 37 个生产集群的血泪经验

5.1 “plsql 无法定位 oci dll” 的 5 种根因与精准修复方案

这个错误在 Substrate + Oracle agent 场景中出现频率极高，但 90% 的工程师都只在 agent 代码里加LD_LIBRARY_PATH，治标不治本。根据我们对 37 个客户集群的故障分析，真实根因如下表：

实操心得：我们曾遇到一个案例，错误日志显示libclntsh.so.19.1: cannot open shared object file，但ls显示文件存在。最终发现是 gVisor 的fsmap机制要求 source 和 target 的 inode number 必须相同，而用户用了cp复制文件导致 inode 变化。解决方案是改用rsync -aH保留硬链接，或直接mount --bind。这个细节在 gVisor 文档里都没有明确说明，完全是踩坑总结。

5.2 Kubernetes 中 TEU 启动失败的 3 类高频陷阱

陷阱一：NodeAffinity 与 runtimeClassName 冲突
现象：TEU 资源创建成功，但 Pod 一直处于Pending状态，kubectl describe pod显示0/3 nodes are available: 3 node(s) didn't match Pod's node affinity/selector.
根因：Substrate Controller 为 TEU 生成的 PodSpec 中，spec.runtimeClassName: "gvisor"，但集群中只有部分节点安装了 gVisor CRI-O shim。
修复：在 TEU descriptor 中添加node_selector，或更优方案——使用topologySpreadConstraints强制调度到 gVisor-ready 节点：

teu: # ... 其他字段 node_affinity: required_during_scheduling_ignored_during_execution: node_selector_terms: - matchExpressions: - key: "substrate.io/runtime" operator: "In" values: ["gvisor"]

陷阱二：Encrypted Volume 初始化超时
现象：Pod 卡在Init:0/1，initContainersubstrate-state-init日志显示waiting for encrypted volume 'sales-reports' to be ready... timeout after 300s。
根因：KMS 密钥轮换后，旧密钥无法解密 volume header，或网络策略阻断了 KMS endpoint。
修复：在 descriptor 中配置volume_timeout_seconds: 600，并添加kms_endpoint: "https://kms.internal.example.com"显式指定 endpoint，避免 DNS 解析失败。

陷阱三：Attestation Policy 验证失败
现象：Pod 启动后立即 CrashLoopBackOff，log 显示attestation failed: expected_hash mismatch。
根因：gVisor 的 binary hash 在不同 OS 发行版上略有差异（如 Ubuntu vs CentOS 的 libc 版本影响），或 Substrate Controller 缓存了旧版 hash。
修复：在 descriptor 中使用attestation_policy.type: "gvisor-digest"，让 Substrate Controller 在首次启动时动态计算 host 上 gVisor binary 的 sha256，并写入 status 字段，后续 TEU 复用该 digest。

5.3 Agent 开发者的 5 条黄金法则（来自一线踩坑总结）

1. 永远不要在 agent 代码里硬编码路径：/usr/lib/oracle这样的路径必须由 Substrate descriptor 声明，agent 代码应通过std::env::var("SUBSTRATE_ORACLE_PATH").unwrap_or("/usr/lib/oracle")获取。这样既能适配不同 runtime，又便于测试（本地开发时设为/tmp/oracle-test）。

2. skill capability token 必须 JWT 格式且含 exp 字段：Substrate 生成的 token 是标准 JWT，包含exp（过期时间）、sub（agent identity）、scope（capability）。agent 代码必须校验exp，否则可能被重放攻击。我们见过客户因忽略此校验，导致数据库凭证泄露。

3. volatile memory 限制是硬边界，不是 soft limit：Kubernetes 的resources.limits.memory是 soft limit，OOM killer 会按 priority 杀进程；而 Substrate 的volatile_memory_mb是硬边界，mmap超限直接返回ENOMEM。agent 必须处理ENOMEM错误，而不是假设内存总会分配成功。

4. TEU 的 restartPolicy 必须设为 Never：Kubernetes 的restartPolicy: Always与 Substrate 的 TEU 语义冲突。TEU 的生命周期由 descriptor 的TerminationPolicy控制，Pod 重启会导致 state boundary 丢失。正确做法是用 Deployment 的replicas: 1+strategy.type: RollingUpdate实现高可用。

5. 调试优先使用substrate debugCLI 工具：不要kubectl exec进去手动调试。Substrate 提供substrate debug --teu sales-report-agent --dump-state命令，可一键导出 TEU 的完整 runtime state、loaded skills、memory map，比pstack+cat /proc/*/maps高效 10 倍。

这些法则看似琐碎，但每一条都源于真实生产事故。比如第 4 条，某金融客户因设置restartPolicy: Always，导致 agent 在 OOM 后重启，丢失了正在处理的交易 session，造成资金重复扣款。后来我们强制 Substrate Controller 拒绝任何restartPolicy != Never的 TEU，才彻底杜绝此类问题。

6. Substrate 的演进方向与 agent 开发者的行动建议

Substrate 不是一个静态的工具，而是一个持续演进的可信执行基础设施。从我们参与的 12 个开源贡献和客户定制项目来看，未来 12 个月有三个确定性趋势：

第一，WASI 与 Substrate 的深度整合：WebAssembly System Interface（WASI）正从“浏览器沙箱”走向“服务端可信执行”。Substrate 已在 v0.8.0 中实验性支持runtime: "wasi"，允许 agent 以.wasm文件形式部署，无需编译为 native binary。这对 PL/SQL skill 尤其重要——Oracle 正在开发 WASI 版的 OCI driver，未来 agent 可直接加载oci-driver.wasm，彻底规避oci.dll加载问题。建议开发者现在就开始用wasmer或wasmtime测试 WASI 兼容性。

第二，AI agent memory 的硬件级加速：当前 agent 的短期记忆（如 LLM 的 KV cache）依赖 RAM，但 Substrate 正在与 Intel 合作，将 Optane PMem 的 byte-addressable 特性接入State Boundary。这意味着 agent 的 memory 可以跨越 volatile RAM 和 persistent memory，既保证速度又保证断电不丢。如果你的 agent 需要处理 GB 级中间状态，现在就该评估 Optane 硬件。

第三，multi-TEU coordination 协议标准化：单个 agent 能力有限，但多个 TEU 协同能爆发巨大能量。Substrate 正在定义TEU Coordination Protocol (TCP)，一种基于 attested TLS 的 TEU 间安全通信协议。例如，sales-report-agentTEU 可以安全地将加密