参考与契约

这里用于查阅准确的 API、生命周期、失败行为和承诺边界。内容描述仓库当前实现；使用已发布版本时，应核对相应版本的包 README 和 CHANGELOG。

按你的问题选择入口

• 第一次构建： 便签助手教程。先运行完整任务，再通过七课拆解、验证和扩展同一个项目。
• 理解设计： 核心概念。每个维度说明是什么、如何使用、为何这样划分；Why CAPiX说明起点与适用范围。
• 尝试一种能力： 按主题实践。围绕结构、资源、实体、输出和记录运行独立例子。
• 核对精确行为： 从下面的契约表进入。包间依赖与运行环境见架构与包。

契约索引

主题	入口
结构与装配	结构、可调用结构、资源
调用与故障	运行边界、退出、异常、运行出口
数据与材料	实体、Transcript、Memory、View、自定义实体
外部交互与工具	交互、模型与工具、Tool API
恢复	Checkpoint、有序选择、版本支持
记录与协议	记录、观测增量、契约与协议、Transcript wire

维护框架

• 贡献、协作约定、安全报告。
• 测试归属与命令、包分发与发布。
• GitHub 维护流程：issue、PR、分支保护与版本维护。
• 文档站构建与发布：本地预览与 GitHub Pages。

框架契约、示例与正式测试均可仅凭本仓运行。文档站构建不读取外部仓库或个人开发资料；示例执行在 Node.js 中，网站展示不代表浏览器执行内核。