For AI agents: the complete documentation index is available at https://scriptedalchemy.github.io/agent-bundle/zh/llms.txt, the full documentation bundle is available at https://scriptedalchemy.github.io/agent-bundle/zh/llms-full.txt, and this page is available as Markdown at https://scriptedalchemy.github.io/agent-bundle/zh/reference/index.md.
  • 简体中文
  • 参考

    指南讲的是如何构建并交付一份捆绑包。本章是查阅用的那一半:确切的标志、确切的字段名、确切的默认值, 以及框架拒绝跨越的那些边界。

    这里不重复任何教程。凡是指南中已经解释过的概念——配置模型、七个钩子事件、证明级别——本章只链接过去, 并仅记录契约本身。

    页面回答什么
    命令行每条命令、参数、选项、默认值与退出码。
    配置agent-bundle.config.ts 的每个字段、类型与校验规则。
    Target 与产物各 target 输出什么,以及产物清单契约。
    宿主能力矩阵固定的各宿主能力表:版本、清单、安装方式、路径 token、MCP 传输、插件组件。构建时生成。
    事件与钩子矩阵各宿主的规范事件到原生事件、工具选择器到原生匹配器、被推迟的原生事件。构建时生成。
    通知投递矩阵每个宿主支持哪些通知通道,其余通道为何不可用。构建时生成。
    诊断参考每个 AB 代码族、触发条件、严重级别与恢复提示。构建时从仓库契约生成。
    运行时环境Node 版本下限、路径 token、环境变量、.env 分层与持久状态位置。
    安全凭据、网络与信任边界。
    已知限制框架目前不做什么、不能证明什么。
    类型 API全部公开导出的生成式符号参考。

    如何读诊断

    每条命令报告的都是结构化诊断,而不是散文式错误。一条诊断包含稳定的 AB 代码、一个严重级别、一条消息, 通常还有 sourcePath 与一条 recovery 提示。对于由诊断把关的命令——buildprepackvalidatedoctorinstalldev——只有 error 级别才会让命令以非零退出;warning 与 info 绝不会为构建、校验或 dev 重建把关。evalinspect 还有一个与诊断无关的以 1 退出的理由: 失败或无定论的试验,或者无效的模型——见命令行退出码

    完整的代码目录见诊断参考,它在构建时由仓库中的 docs/diagnostics.md 渲染而来。

    家族领域
    AB30xxSkill 文档:Markdown 解析与渲染式 skill 编译。
    AB40xxAB47xx插件元数据、规范化模型不变式、钩子、MCP、脚本、资源、包构建,以及打包器逃生舱。
    AB48xxAB49xx路由图、state、布局与 provider 约定:路由模块发现、config 提取、共享布局(AB4830AB4832),以及编译后的命令表面。
    AB5000通用的命令行与适配器失败。
    AB60xx已构建产物校验,包括宿主 schema 文档与被引用的文件。
    AB700xAB7013宿主安装与 npm prepack 门禁。
    AB7xxx项目准备与开发期重建,其中 AB7300AB7320 为只读 Doctor。
    AB8xxx开发服务器配置与 Workbench 路由。
    AB9xxxeval 选择、harness 与持久化运行记录。