6.4 制作业务资源包

业务资源清单继续支持 teloa.business-package/v2；v3 增加固定模型依赖，v4 增加完整业务配置资源。先从通用研究示例包学习 v2 的完整结构，再减少到自己的必要资源。

业务资源包与引擎 Bundle

业务资源包分发岗位定义、方法、资料、模板及其关联；引擎 Bundle 组合运行插件和配置。导入前者不等于安装任意引擎代码，也不授予员工全部工具权限。扩展依赖仍分别经过安装、配置和授权检查。详见执行引擎接入边界。

包结构

text

research/
  teloa.json
  skills/研究简报/SKILL.md
  roles/研究分析员.json
  knowledge/通用研究方法.md
  workflows/资料研究.json
  plans/每日资料核对.json

一份最小清单

下例只列出一个技能。与它一起打包前一篇的 skills/research-brief/SKILL.md：

json

{
  "format": "teloa.business-package/v2",
  "id": "research-starter",
  "title": "研究入门",
  "version": "1.0.0",
  "domain": "general",
  "description": "根据授权资料生成带来源的研究简报。",
  "resources": [{
    "id": "research-brief",
    "kind": "skill",
    "title": "研究简报",
    "version": "1.0.0",
    "required": true,
    "source": {"kind": "local", "path": "skills/research-brief/SKILL.md"}
  }],
  "relations": [],
  "entrypoints": ["research-brief"]
}

关键校验

资源 ID 唯一；关联必须指向包中存在且类型匹配的资源。
版本使用固定的三段版本号，不能使用 latest。
本地路径是包内相对路径，不能包含绝对路径、.. 或反斜杠。
required: true 的本地资源必须实际存在。
scope 可选，省略时使用 domain；范围标识为 1–64 位字母、数字、下划线或连字符。
入口只能指向技能或任务模板；列出资源和授权是两回事。

完整业务配置与独立看板

方案 v4 可包含 kind: "business-configuration"。正文格式为 teloa.business-dashboard-resource/v1，固定 id、三段 version 和一份完整的 teloa.business-configuration/v2 配置；配置带齐对象类型、视图、组件、看板、页面与首页引用，至少包含一个看板页。所有引用须在配置内闭合，配置范围必须与清单一致。v2/v3 不接受这一新资源类型。

公开市场的独立看板使用 kind: "dashboard"，放在 catalog/dashboards/<资源标识>.json；工件放在 artifacts/dashboards/<资源标识>/<版本>/。工件根目录 teloa.json 为 v4，恰好声明一个必需的本地完整配置资源，relations 和 entrypoints 为空。方案可用固定 source.id 与相同 source.version 引用唯一的公共看板资源；来源不得再包含公共引用。

看板及 v4 方案只进入新版 v2 市场索引，并要求 Teloa 0.2.0-alpha.7 及以上。添加后先选择目标业务、核对对象与字段映射，生成草案，再预览并由本人采用。资源不携带真实记录、密钥、已有同步绑定或默认动作身份；连接、同步与业务动作须在目标业务另行配置，也不会自动授予员工权限。已有数据不会根据标题或字段名自动猜测映射。

验证导入

先在单独的测试环境导入，检查预览中的内容和关联。确认后逐一打开岗位、技能和模板，完成一项小任务；对缺文件、错误版本和不匹配的关联，再分别验证会被拒绝。

内容导入限制当前为 1–500 个文件、单文件最多 2 MiB、总内容最多 20 MiB；界面或上传层可能还有额外限制。发布到公共目录需要更多发布元数据，不等于完整公开发布服务已开放。

格式细节见资源格式与内部接口。

6.4 制作业务资源包 ​

业务资源包与引擎 Bundle ​

包结构 ​

一份最小清单 ​

关键校验 ​

完整业务配置与独立看板 ​

验证导入 ​