AgentKit Studio
参考

参考

由源码生成的契约参考:139 个 operation、198 个错误码、132 个环境变量、56 个 make 目标。

这一章是什么

这里是 AgentKit Studio 的机器可读契约:枚举值、字段名、错误码、operation id、环境变量与命令。本页所有数字都由 docs-site/scripts/extract-reference.mjs 从源码抽取,没有一个是手写的。

cd docs-site
node scripts/extract-reference.mjs          # 重新生成 22 个页面
node scripts/extract-reference.mjs --check  # CI:源码改了但页面没重生成就失败

改动 src/ 里的枚举、错误码或 operation 列表后,必须重跑脚本;否则 --check 会让 CI 失败。

页面索引

页面你会查到什么条数源
运行时与实体契约3 种运行时的能力矩阵、实体标识与校验错误3 runtime typessrc/runtime-contract.mjs
控制协议每个 operation id 的作用与 Host 处理器139 operations · 25 domainssrc/contracts/operations.mjs
配置参考四个配置文件的全部键与默认值4 manifestssrc/product.json
环境变量参考可配置 / 平台注入 / 禁止修改三档132 namessrc/**
模板 Schema专家团模板的字段约束与拒绝形状7 codessrc/team-template-contract.mjs
插件市场目录 Schema目录文档结构、合并规则与内置条目18 fields · 3 rowssrc/dsh-plugin-catalog.mjs
部署状态机状态、界面标签、轮询与需关注19 statessrc/client/state/deployment.mjs
错误码Top 30 用户动作 + 命名空间索引198 codessrc/**
命令参考make 目标、依赖与校验脚本56 make · 100 verifyMakefile
会话事件事件触发时机、配对规则与持久化16 events · 3 framessrc/host/dsh-session-contract.mjs

按角色阅读

你是先看为什么
集成方operations · errors按 operation id 对接控制协议,按错误码做分支。
插件作者plugin-catalog · templates写一个市场条目或一份专家团模板。
运维environment · deployment-states · commands配环境变量、看部署状态、跑门禁。
排障errors · session-events按错误码定位,再按事件流复现。

抽取口径

口径规则
契约常量直接 import 源码模块取值,不复制字面量
错误码src/** 的 code: '...' 字面量 + STUDIO_WIRE_ERRORS
环境变量process.env.X、env.X 与 *_ENV_NAMES 常量数组的并集
源码位置取第一次出现的 file:line,file 相对仓库根
脱敏commit SHA、发行源域名、内部模型代号在渲染时替换为占位符

开发者入口

内容源码位置
生成器docs-site/scripts/extract-reference.mjs
operation 契约src/contracts/operations.mjs
wire 错误src/contracts/definitions.mjs

相关测试:

测试文件位置
desktop-module-graph.test.mjstests/desktop-module-graph.test.mjs
studio-wire-contracts.test.mjstests/studio-wire-contracts.test.mjs
host-dispatcher.test.mjstests/host-dispatcher.test.mjs
host-route-contracts.test.mjstests/host-route-contracts.test.mjs

本页导航