6.9 资源格式与内部接口
这些格式服务于当前 Alpha 的导入与内部通信，版本升级时应重新验证，不是永久兼容的公开 API 承诺。
常用资源格式
| 格式 | 用途 | 核对重点 |
|---|---|---|
teloa.business-package/v2 | 业务包清单 | 资源身份、固定版本、关联与范围 |
teloa.role/v1 | 岗位定义 | 职责、资料范围、执行范围 |
teloa.work-template/v1 | 任务模板 | 输入要求、输出、技能引用版本 |
teloa.mcp-connection/v1 | MCP 连接声明 | serverName 与工具集合 |
teloa.reference-list/v1 | MCP 资料列表 | 来源、字节数、SHA-256 版本 |
teloa.reference/v1 | MCP 读取结果 | 正文与同版本来源 |
资源包的 scope 默认取 domain。引用的版本与资源声明必须一致；不要依赖 JSON 字段顺序作为对象相等判据。
未知字段与损坏数据
多处读取器采用严格字段校验，拼错的字段不会自动忽略。格式不合法与已存数据损坏应分别处理：前者修正输入，后者保留证据并从可信备份或来源修复。
内部 RPC
客户端经 Harness 使用内部 RPC 请求。端点、请求信封、鉴权 Cookie 与返回解析会随版本变化，不应把浏览器抓到的请求直接当成面向第三方的稳定 REST 接口。
系统集成优先使用已支持的 MCP 路径。若需要新的稳定集成接口，先明确身份、权限、幂等、版本和错误契约，再实现适配。