包构成
提示
豆包应用插件采用代码化、声明式的目录结构:运行所需的所有元信息都内聚在产物包里,无需在平台做额外配置。理解包结构有助于你快速上手开发与排查问题。执行 dbx init 即可生成下述标准骨架。
目录结构
三大组成部分
关键文件详解
manifest.yaml(配置)
声明式配置中心,核心内容包括:
app_name/ 版本等基础信息。tools:MCP 业务工具定义(入参 schema、输出实体类型)。entities:业务实体 schema(字段类型、是否模型可见等)。tool_card_binding:实体类型与卡片模板的绑定关系。
详见「MCP 工具与卡片 → MCP 工具与卡片配置」。
src/(前端包)
src/app.ts:应用入口;src/app.config.ts:应用级配置。src/pages:全页(每个页面含index.tsx组件 +index.scss样式)。src/widgets:卡片。
skill/SKILL.md(业务 Skill)
描述「模型应如何使用你的工具」的业务 SOP,采用渐进式加载设计。本期支持 Metadata 和 SKILL.md 正文两级加载;附属资源属于后续规划。详见「MCP 工具与卡片 → Skill 规范」。
提示
简记:manifest.yaml 管「能力与出卡配置」,项目根目录的 src 管「界面」,Skill 管「模型如何编排」。三者共同构成一个完整的豆包应用插件。