# 豆包智能服务 Starter

这是一个由 `dbx init` 创建的豆包智能服务工程，包含 Manifest、运行态 Skill、Widget 和 Page。

## 快速开始

在项目根目录启动本地开发与调试：

```sh
dbx dev
```

进入调试控制台后，输入 `web` 打开 Web 模拟器：

```text
web
```

Web 模拟器成功打开，即表示本地调试服务已启动。

## 开始开发

```text
.
├── manifest.yaml       # App ID、MCP、工具、实体和 Widget 绑定
├── skill/SKILL.md      # 工具触发条件、参数规则和调用流程
├── src/
│   ├── app.config.ts   # Page 和 Widget 注册
│   ├── pages/          # 独立页面
│   └── widgets/        # 工具结果组件
├── package.json        # 前端依赖和脚本
├── .dbx/config.json    # DBX 项目配置
└── AGENTS.md           # Agent 开发引导
```

初始工程使用共享的购物方案示例 MCP，并提供 `create_shopping_plan` 工具和 `shopping-plan` Widget。开发实际业务时，请替换 `manifest.yaml`、`skill/SKILL.md` 和 `src/` 中的示例内容。

修改配置时，请注意以下对应关系：

- `manifest.yaml` 中的工具名称，需要与 MCP Server 提供的工具名称相同。
- `manifest.yaml` 中的实体类型，需要与工具返回结果中的 `entity_type` 相同。
- `manifest.yaml` 中绑定的 Widget ID，需要与 `src/app.config.ts` 中注册的 Widget ID 相同。
- App ID 统一在 `manifest.yaml` 的 `app_key` 字段中配置。

## 校验和上传

上传前，请将 MCP 地址替换为公网可访问的正式地址。不要在 Manifest、Skill 或源码中保存密钥和访问令牌。

```sh
dbx app artifacts validate manifest.yaml
dbx app artifacts upload
```

上传成功后，将 `YOUR_VERSION_TAG` 替换为返回的 `version_tag`，查询云构建状态：

```sh
dbx app artifacts status --version-tag YOUR_VERSION_TAG --poll
```

## 进一步阅读

- [快速开始](https://developer.doubao.com/docs/overview/quick-start)
- [本地调试与预览](https://developer.doubao.com/docs/development-tools/local-debugging)
- [打包与提审](https://developer.doubao.com/docs/release/package-and-submit)