For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/core-concepts/package-structure.md.

包构成

提示

豆包应用插件采用代码化、声明式的目录结构:运行所需的所有元信息都内聚在产物包里,无需在平台做额外配置。理解包结构有助于你快速上手开发与排查问题。执行 dbx init 即可生成下述标准骨架。

目录结构

.
├── AGENTS.md
├── manifest.yaml      # 配置:基础信息、工具定义、UI 绑定关系
├── package.json       # 依赖
├── skill              # 业务 Skill
│   └── SKILL.md
├── src
│   ├── app.config.ts   # 应用配置
│   ├── app.ts
│   ├── pages           # 全页
│   └── widgets         # 卡片
└── tsconfig.json

三大组成部分

目录 / 文件类型说明
manifest.yaml配置基础配置:app_name、版本,以及 MCP 工具定义、业务实体与卡片的绑定关系等。它是平台理解你的应用插件“有哪些能力、如何出卡”的入口。
package.json依赖配置声明前端依赖、构建脚本和包信息。
src/前端源码包含应用入口、页面、卡片及其他界面与交互源码。
skill/业务 Skill描述业务编排(SKILL.md,告诉模型应如何使用工具),由豆包主 Bot 渐进式按需加载。

关键文件详解

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 管「模型如何编排」。三者共同构成一个完整的豆包应用插件。