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.
跳至主要内容
  • 简体中文
  • 参考

    指南用于构建插件,本章用于核对精确字段、参数、默认值和边界。 Target 与能力地图集中列出全部五个内置输出及其可投影功能。

    页面回答什么
    Target 与能力地图该编写哪个表面;原生 target、兼容读取方、开发/展示支持之间的区别。
    CLI命令、参数、选项、默认值和退出码,包括 inspection、hook、MCP、安装与本地 App 托管。
    配置agent-bundle.config.ts 的字段、类型和校验规则。
    Target 与产物全部五个内置投影布局、组合约束、分发形式及可执行文件所有权。
    产物清单规范 application、route、executable、launch、distribution 与 compiler 记录形状。
    宿主能力矩阵固定版本、原生文档、安装、路径 token、MCP 行为、lineage、插件组件和已记录兼容客户端。由适配器能力数据生成。
    事件与 hook 矩阵规范事件族、原生事件、payload 字段来源、工具选择器和推迟的原生事件。由相同记录生成。
    Notice 投递矩阵接收方身份维度、支持通道、敏感度约束和无法投递原因。由相同记录生成。
    诊断参考诊断代码、级别、触发条件和恢复方式。由仓库契约生成。
    开发服务器 HTTP高级集成使用的 invocation、trace、raw-log 和 hook-receipt 路由。
    运行环境Node 最低版本、路径 token、环境分层、观测上下文和可写状态。
    安全凭据、网络、沙箱、同意与信任边界。
    限制不支持、有意受限或现有证据尚未建立的行为。
    类型 API公开包导出的生成符号参考。
    故障排查路由/类型缺失、target 不匹配、App 生命周期、包根目录和验证问题。

    生成矩阵不是另一套手工维护的兼容列表。带日期的来源链接说明记录的行为。 supported、degraded、unavailable 和 prohibited 是功能判断; 尚未执行的账户相关运行测试属于独立的验证限制。 应查阅具体组件与客户端/版本,不要假定一个宿主徽标涵盖全部操作。

    编写模式见复用框架: 同一工具的 CLI 与 App 表面、规范 schema、语义/普通 hook、请求依赖、state、payload 与安装。 自定义服务器工厂和原生文档仍是高级集成路径,不是插件的最小必需代码。

    如何读诊断

    结构化诊断包含代码、严重级别、消息,以及可用时的源码位置与恢复提示。 也要阅读命令的最终结果:参数解析错误、失败或 inconclusive 的 eval,以及无效 inspection model 属于不同失败路径。

    只有 error 诊断会阻断由诊断决定的检查。 --strict 等选项可以把适用的宿主工具 warning 提升为 error, 因此不能仅因先前未提升的 warning 对某工作流只是信息,就忽略当前非零结果。 精确命令行为见 CLI 退出码。

    代码族领域
    AB30xxSkill 解析与渲染内容。
    AB40xx–AB47xx身份、target 组合、hook、MCP、assets、包输出和打包器策略。
    AB48xx–AB49xx约定路由、契约、布局、provider、state 和生成命令表面。
    AB5000通用命令/适配器边界失败。
    AB60xx产物、原生文档、引用文件和编译证据校验。
    AB7xxx包/安装检查、项目准备、重建和 Doctor。
    AB8xxx开发服务器与 Workbench 边界。
    AB9xxx评估与持久运行记录。

    这些代码族只是导航,不替代完整生成诊断参考。 修正拥有该行为的声明或输入;不要为压下错误而改写生成清单、虚构运行证据或扩大原生权限。