架构与包
CAPiX 是可组合、可观测的 Agent 框架。结构表达处理组织，资源提供受控操作，调用建立本次执行及事实，Runner 装配并驱动入口。模型是一种资源能力，框架不要求所有场景都遵循同一种模型循环。
作者首先使用的对象
| 对象 | 职责 |
|---|---|
| Scene / Group / Node | 配置 deps/run/output/checkpoint；Scene 和 Group 组织成员，Node 直接处理 |
| Resource / ResourceOffer / Resources | 持有供给、声明操作、登记资源；绑定后按调用窗口提供端点 |
| Runner | 固定场景与机制，build 接线，run 创建本次调用，resume 显式核验后恢复 |
| Interaction | 固定独立外部请求并持有反馈；局部等待不控制外部发送生命周期 |
| 实体 / View | 实体拥有内容及版本规则；View 保存所选来源和成员，读取本次固定材料 |
Scene、Group 和 Node 共同满足 callable 切面；组合能力来自成员契约，执行不需要针对每种结构创建另一套机制。结构实例在一棵树内唯一，业务函数与资源可以复用。build 不执行按次 capture、不创建 Invocation，也不创建第二棵可运行结构树。
调用与活动窗口
结构配置 + 资源登记 + 可选机制
↓ build
固定接线的 Runner
↓ run(input)
Invocation / Context
↓ 当前阶段
Work → 资源操作 / 子调用
↓
接纳排空、关闭、最终交付每次调用独立持有输入、信号和阶段窗口。子调用返回与父层接纳分开；取消请求停止，但入口须等已启动子调用真实退出才释放。外部 Interaction 可以继续存活，其反馈与流订阅通过准确资源操作接入。
固定值、正式交付、持久保存分别成立。CP 消费 Context／Relation 已成立的事实，不对活对象重新猜测历史；恢复只消费完整依据及显式声明的 point，不恢复任意 JavaScript 栈或外部效果。
包的所有者
全部框架源码在 packages/；公开包前缀为 @weiliang0121/capix-。表中名称省略该前缀。
| 包 | 责任 |
|---|---|
| contracts | 共同进程内端口、稳定值与唯一 RuntimeError |
| protocol | Transcript wire 的单帧编码形状与接纳，不持有传输或领域实体 |
| changes | 领域 FactType、捕获、同步发布与转交 |
| resources | Resource、Offer、Request、登记、绑定与访问窗口 |
| structure | 可调用结构、成员、作者类型、Sequence/Dynamic |
| invocation | Context/Invocation、控制、关系、接纳、输出、关闭和调用侧 CP |
| checkpoint | Frame v6、固定块、关系与选择认证、Store 契约及内存实现 |
| runtime | 结构构建与供给装配、Runner、Work 适配、可选记录安装 |
| interaction | 请求、独立发送、反馈、等待与有界过程流 |
| transcript / memory | 正式消息与独立总结实体，各自写入、持久与资源契约 |
| view / measurement | 通用来源与成员选择、准确消息身份的使用计数 |
| records / diagnostics | 记录实体与显式解释；持久故障身份及有界诊断 |
| model-provider | 模型正文、工具调用及原生续接的协议适配 |
| model-exchanges | 固定起点、完整模型回复、工具反馈槽与固定接纳凭据 |
| tool | 使用公开结构、资源与交互的普通 Group 工具预设 |
结构、资源、调用和实体不反向依赖 Runtime；调用不依赖结构实现。实体不依赖 protocol，记录的默认内容解释消费实体公开事实类型。Tool 不依赖 Runtime 实现。准确依赖由每个 package.json 声明，并由仓库检查验证。
共同类型按实际跨包责任晋级 contracts；可序列化数据也未必是跨端协议，例如 Frame 属于 checkpoint。Message、Memory 和记录数据仍从其领域包公开出口获取，不通过 protocol 汇总。参见契约与协议。
实体与资源的组合
实体可以由作者实现，不需要统一 Entity 基类或统一内容状态。固定读取、版本核验、条件更新、历史查询和持久确认是分别兑现的能力；没有实现历史读取，就不能仅凭版本号承诺旧正文可找回。
资源负责操作接口与窗口，不替实体解释业务内容。View 组织来源和成员，不管理实体生命周期。Memory 是总结实体，不要求业务事实都编码成记忆；具体材料选择、提取和压缩由结构与资源组合。
记录属于可选消费。领域事实通过准确资源操作建立来源关联，不等于证明该操作造成所有变化，也不替代恢复依据。完整说明见实体、自定义实体与记录。
运行环境与验证
执行内核在 Node.js 上验证，使用 AsyncLocalStorage、node:crypto 等能力；包目录与 ESM 格式不代表浏览器或 Edge 兼容。纯值、纯类型出口与执行实现分别判断，额外运行时支持需要实际验证。
只检出本仓即可构建、测试与验证分发。测试随责任包，组合测试归真实协调者，文档使用同一份可执行示例；详见测试。取消、恢复、资源权限和外部效果的边界不能因示例简化而扩大。