> 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.

# 包构成

:::info 提示

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

<div hidden data-lark-callout-end></div>

:::

## 目录结构

```bash
.
├── 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 规范」。

:::info 提示

简记：**manifest.yaml 管「能力与出卡配置」，项目根目录的 src 管「界面」，Skill 管「模型如何编排」**。三者共同构成一个完整的豆包应用插件。

<div hidden data-lark-callout-end></div>

:::
