@doubao-dev/cli 0.0.26 → 0.0.27

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/groups.md

@@ -6,14 +6,14 @@
 
 | 分组 | 说明 | API 数量 | 详细文档 |
 | --- | --- | ---: | --- |
-| 基础 | 账号、授权、豆包客户端信息、窗口信息和能力可用性。 | 6 | [查看](./01-基础.md) |
+| 基础 | 账号、授权、豆包客户端信息、窗口信息和能力可用性。 | 8 | [查看](./01-基础.md) |
 | 系统 | 豆包客户端信息、窗口信息和系统设置。 | 9 | [查看](./02-系统.md) |
-| 自定义通信 | 在智能服务的多个 Runtime 之间发送和接收自定义事件。 | 1 | [查看](./03-自定义通信.md) |
+| 自定义通信 | 在智能服务的页面或卡片实例之间发送和接收自定义事件。 | 1 | [查看](./03-自定义通信.md) |
 | 定位 | 获取设备当前的地理位置信息。 | 5 | [查看](./04-定位.md) |
 | 存储 | 本地缓存；带 Sync 后缀的是同步 API。 | 10 | [查看](./05-存储.md) |
 | 路由 | 应用内页面跳转、返回、退出和关闭。 | 6 | [查看](./06-路由.md) |
 | 界面 | 对话框状态、Toast、Loading、Modal、ActionSheet、BottomSheet、返回前提醒、键盘和输入框能力。 | 2 | [查看](./07-界面.md) |
-| 交互 | Toast、Loading、Modal、ActionSheet、BottomSheet 和返回前提醒。 | 8 | [查看](./08-交互.md) |
+| 交互 | Toast、Loading、Modal、ActionSheet、BottomSheet 和返回前提醒。 | 10 | [查看](./08-交互.md) |
 | 输入 | 键盘和输入框选区能力。 | 2 | [查看](./09-输入.md) |
 | 网络 | 网络请求与 WebSocket。 | 4 | [查看](./10-网络.md) |
 | 媒体 | 图片选择、预览、保存、压缩和信息读取；录音管理；背景音频和内部音频播放。 | 8 | [查看](./11-媒体.md) |

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/quick-reference.md

@@ -2,7 +2,7 @@
 
 > 这是豆包智能服务运行时 API，也称 Open API。默认从 `@doubao-dev/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
 
-覆盖 146 个函数。详细参数、返回值、示例和相关类型请查看 [豆包智能服务的端能力 API 分组目录](groups.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-dev/framework/api` 类型定义。
+覆盖 150 个函数。详细参数、返回值、示例和相关类型请查看 [豆包智能服务的端能力 API 分组目录](groups.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-dev/framework/api` 类型定义。
 
 ## 使用方式
 
@@ -41,6 +41,8 @@ import { showToast, request, getStorage } from '@doubao-dev/framework/api';
 | [getAccountInfo](01-基础.md#getaccountinfo) | 异步获取账号信息。 |
 | [getAccountInfoSync](01-基础.md#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
 | [authorize](01-基础.md#authorize) | 提前向用户发起指定 scope 的授权；scope.healthData 仅用于选择 iOS HealthKit 系统授权路径。 |
+| [arrayBufferToBase64](01-基础.md#arraybuffertobase64) | 将 ArrayBuffer 转换为 Base64 字符串。 |
+| [base64ToArrayBuffer](01-基础.md#base64toarraybuffer) | 将 Base64 字符串转换为 ArrayBuffer。 |
 | [getPerformance](01-基础.md#getperformance) | 获取当前智能服务应用的性能数据。 Entry 由客户端保存；getEntries*() 同步查询当前快照，observer 只接收新完成的 Entry。 |
 | [getSetting](01-基础.md#getsetting) | 获取用户当前的应用授权设置。 |
 | [openSetting](01-基础.md#opensetting) | 打开智能服务授权设置页面。 |
@@ -63,7 +65,7 @@ import { showToast, request, getStorage } from '@doubao-dev/framework/api';
 
 ## 自定义通信
 
-在智能服务的多个 Runtime 之间发送和接收自定义事件。
+在智能服务的页面或卡片实例之间发送和接收自定义事件。
 
 | API | 说明 |
 | --- | --- |
@@ -126,12 +128,14 @@ Toast、Loading、Modal、ActionSheet、BottomSheet 和返回前提醒。
 
 | API | 说明 |
 | --- | --- |
+| [enableAlertBeforeUnload](08-交互.md#enablealertbeforeunload) | 开启页面返回前提醒。 当用户在智能服务的非最底层页面点击左上角返回按钮、左上角首页按钮或客户端返回键时,弹起询问弹窗 返回询问对话框只会对调用的当前页面生效，通过手势滑动返回时不会弹起询问对话框。 |
+| [disableAlertBeforeUnload](08-交互.md#disablealertbeforeunload) | 关闭页面返回前提醒。 |
 | [showModal](08-交互.md#showmodal) | 显示模态对话框。 |
 | [showLoading](08-交互.md#showloading) | 显示 loading 提示框。 |
 | [hideToast](08-交互.md#hidetoast) | 隐藏当前 Toast。 |
 | [hideLoading](08-交互.md#hideloading) | 隐藏当前 loading。 |
 | [showActionSheet](08-交互.md#showactionsheet) | 显示操作菜单。 |
-| [showBottomSheet](08-交互.md#showbottomsheet) | 显示 Native 底部弹窗。 |
+| [showBottomSheet](08-交互.md#showbottomsheet) | 显示豆包底部弹窗。 |
 | [getMenuButtonBoundingClientRect](08-交互.md#getmenubuttonboundingclientrect) | 取菜单按钮（右上角胶囊按钮）的布局位置信息。 |
 | [showToast](08-交互.md#showtoast) | 显示 Toast 提示。 |
 

package/skills/doubao-agentic-service-development/references/frontend-dev.md

@@ -8,7 +8,7 @@
 |------|----------|
 | 找不到前端目录 | 读取 `.dbx/config.json` 的 `frontend.directory`；缺失时再按项目结构判断，常见目录是 `doubao-agentic-service` |
 | 需要新建智能服务前端工程 | 使用公开版智能服务框架创建命令；不要在已有 dbx 项目里另起一套平行前端 |
-| 卡片没出现、模型没调 tool、Manifest 绑定不确定 | 先读 [Simulator Eval 指南](local-debug/simulator-eval.md)，用 `dbx simulator eval` 验证 Skill、MCP、Manifest、tool result 和 `card_delta` |
+| 卡片没出现、模型没调 tool、Manifest 绑定不确定 | 先读 [`dbx check` 指南](local-debug/simulator-eval.md)，用 `dbx check --query "<当前轮用户问题>"` 验证 Skill、MCP、Manifest、tool result 和 `card_delta` |
 | 需要看页面、卡片样式、点击或路由 | 先读 [本地调试总流程](local-debug/overview.md)，用 `dbx dev` 打开 Web 模拟器 |
 | 开发对话卡片 Widget | 先读 [frontend/widget-templates/overview.md](frontend/widget-templates/overview.md) 选模板，再读 [frontend/guides/component-development.md](frontend/guides/component-development.md) |
 | 使用内置组件 props 或事件 | 读 [frontend/components/overview.md](frontend/components/overview.md)，不要猜 props |
@@ -41,10 +41,10 @@ pnpm install
 
 ## dbx 调试顺序
 
-`dbx simulator eval` 验证后端出卡数据链路，不验证前端视觉效果：
+`dbx check` 验证后端出卡数据链路，不验证前端视觉效果：
 
 ```bash
-dbx simulator eval --query "<当前轮用户问题>" --verbose
+dbx check --query "<当前轮用户问题>" --verbose
 ```
 
 `dbx dev` 用于看真实 Page / Widget 渲染、交互和路由：

package/skills/doubao-agentic-service-development/references/generate-skill.md

@@ -10,7 +10,7 @@ python3 <skill_dir>/scripts/workspace.py skill path --create --json
 
 先读取返回 JSON 的 `layout` 和 `entries`。`missing` 时创建默认 `skill/SKILL.md`；已有 entries 时改写与能力域对应的文件，也可以新增任意层级的 `SKILL.md`。返回的 `path` 是运行态 Skill 目录，供上传等命令使用。
 
-只要本轮新增或修改 MCP tool、tool schema、工具返回、Manifest `entities/tools.output/tool_card_binding`、登录身份、卡片输出，或准备执行 `dbx simulator eval`，都应检查并更新运行态 Skill。
+只要本轮新增或修改 MCP tool、tool schema、工具返回、Manifest `entities/tools.output/tool_card_binding`、登录身份、卡片输出，或准备执行 `dbx check`，都应检查并更新运行态 Skill。
 
 ## 工作流
 

package/skills/doubao-agentic-service-development/references/local-debug/simulator-eval.md

@@ -1,13 +1,13 @@
-# 豆包智能服务 Simulator Eval 指南
+# `dbx check` 后端链路检查指南
 
-`dbx simulator eval` 用于在本机验证智能服务模拟器后端数据链路。它不验证前端视觉效果，而是确认 **query / history / skill / MCP / manifest / tool result / trace / card_delta** 是否已经跑通。`dbx dev` 不强制以前置 eval 为门禁；只有在需要判断问题是否出在后端出卡链路时，才优先跑 eval。
+`dbx check` 用于在本机验证智能服务模拟器后端数据链路。它不验证前端视觉效果，而是确认 **query / history / skill / MCP / manifest / tool result / trace / card_delta** 是否已经跑通。`dbx dev` 不强制以前置 eval 为门禁；只有在需要判断问题是否出在后端出卡链路时，才优先跑 eval。
 
 ## 默认评测
 
 在项目目录下直接运行：
 
 ```bash
-dbx simulator eval --query "<当前轮用户问题>" --verbose
+dbx check --query "<当前轮用户问题>" --verbose
 ```
 
 默认约定：
@@ -21,7 +21,7 @@ dbx simulator eval --query "<当前轮用户问题>" --verbose
 只有默认路径有问题时才加参数：
 
 ```bash
-dbx simulator eval \
+dbx check \
   --project-path <project_dir> \
   --query "<当前轮用户问题>" \
   --history ./history.json \
@@ -46,10 +46,10 @@ eval 是由本机 CLI 发起的一次完整链路测试：
 
 `manifest.mcp_server.end_point` 不强求是公网 URL。只要 CLI 所在机器能访问即可，例如本机开发时可以是 `http://localhost:8000/mcp` 或 `http://127.0.0.1:<port>/mcp`。反过来，如果 CLI 在远端机器或 CI 里运行，`localhost` 指的是那台机器。
 
-当前 `dbx simulator eval` 能力边界：
+当前 `dbx check` 能力边界：
 
-- 输入方式：`--demo <name>`、`--case <yaml_or_json>`，或用 flags 临时传 `--app-id`、`--app-name`、`--query`、`--history`、`--skill`、`--manifest`、`--mcp-url`。
-- MCP：`--mcp-url` 支持标准 Streamable HTTP `/mcp` 和 SSE `/sse`；CLI 会执行 `initialize`、`notifications/initialized`、`tools/list`，并在模型下发工具调用后执行 `tools/call`。
+- 输入方式：`--file <path>` 单独校验 YAML；`--demo <name>` 跑内置 demo；`--query <query>` 检查业务项目。`--demo` 和 `--query` 可以组合，此时 query 会覆盖 demo 默认问题。
+- MCP：业务检查读取 Manifest 中的 Streamable HTTP `/mcp` 或 SSE `/sse`；内置 demo 会自动启动临时 Demo MCP Server。CLI 会执行 `initialize`、`notifications/initialized`、`tools/list`，并在模型下发工具调用后执行 `tools/call`。
 - Simulator 网关：默认使用 CLI build config 的 `apiBaseUrl`；需要切环境时传 `--gateway-origin <origin>`。
 - 调试控制：`--max-step` 调整 Agent 最大循环步数；`--verbose` 展示更多 trace 和工具结果摘要；`--force` 可在 preflight 有 error 时仍继续请求 Simulator。
 - 路径解析：`--project-path` 是 dbx 项目目录；相对路径参数按该目录解析。
@@ -64,9 +64,9 @@ eval 是由本机 CLI 发起的一次完整链路测试：
 
 标准动作顺序：
 
-1. 如果当前线程没有明确的 demo PASS 证据，先跑内置 demo：`dbx mcp demo-server --demo milk-tea`，再跑 `dbx simulator eval --demo milk-tea --verbose`。
+1. 如果当前线程没有明确的 demo PASS 证据，先跑内置 demo：`dbx check --demo milk-tea --verbose`。CLI 会自动启动并在结束时关闭临时 Demo MCP Server。
 2. demo PASS 后，确认业务项目根目录已有 `manifest.yaml`，且 `skill/` 中至少有一个 `SKILL.md`。
-3. 跑业务 eval：`dbx simulator eval --query "<当前轮用户问题>" --verbose`。
+3. 跑业务 eval：`dbx check --query "<当前轮用户问题>" --verbose`。
 4. 业务 eval PASS 后，再进入 `dbx dev` / Web 模拟器 / Widget UI 调试看真实渲染；如果用户只是要求打开 Web 模拟器，直接执行 `dbx dev --mcp-endpoint <mcp_endpoint>`。
 
 不要跳过 demo。demo 的作用是确认 CLI、网关、标准 MCP 客户端、trace 和 card_delta 基准链路正常；没有这个基准时，业务 eval 失败很容易被误判成模型或前端问题。
@@ -75,26 +75,30 @@ eval 是由本机 CLI 发起的一次完整链路测试：
 
 如果你完全不知道 eval 怎么用，先跑内置 demo，建立一条正确链路的参照。
 
-开第一个终端启动标准 MCP demo server：
+直接运行：
 
 ```bash
-dbx mcp demo-server --demo milk-tea
+dbx check --demo milk-tea --verbose
 ```
 
-它会自动选择空闲端口，并输出类似：
+CLI 会自动选择空闲端口启动临时 Demo MCP Server，检查结束后自动关闭，不需要手动复制端口或打开第二个终端。
 
-```text
-streamable_http: http://127.0.0.1:53886/mcp
-sse: http://127.0.0.1:53886/sse
+如果只想独立调试 Demo MCP Server，运行：
+
+```bash
+dbx mcp demo
+# 非交互或 AI 调用：
+dbx mcp demo --milk-tea --json
 ```
 
-CLI 同时会把实际 URL 写入当前项目 `.dbx/mcp-demo-server/milk-tea.json`。所以第二个终端可以直接运行：
+无参数的交互模式会提示选择 demo；显式传 demo 时会直接前台启动，并输出类似：
 
-```bash
-dbx simulator eval --demo milk-tea --verbose
+```text
+streamable_http: http://127.0.0.1:53886/mcp
+sse: http://127.0.0.1:53886/sse
 ```
 
-不用手动复制端口。
+按 `Ctrl+C` 停止独立 Server。它不会写入项目目录。
 
 当前内置 demo：
 
@@ -139,7 +143,7 @@ Cards
 demo 跑通后，在业务项目根目录直接跑 eval：
 
 ```bash
-dbx simulator eval --query "我想点一杯适合下午提神的少糖奶茶" --verbose
+dbx check --query "我想点一杯适合下午提神的少糖奶茶" --verbose
 ```
 
 迁移顺序建议：
@@ -153,7 +157,7 @@ dbx simulator eval --query "我想点一杯适合下午提神的少糖奶茶" --
 
 ## MCP 要求
 
-`dbx simulator eval` 只支持标准 MCP 协议。地址只需要 CLI 当前运行环境可访问，不要求公网 URL。
+`dbx check` 只支持标准 MCP 协议。地址只需要 CLI 当前运行环境可访问，不要求公网 URL。
 
 CLI 会完成：
 
@@ -212,7 +216,7 @@ MCP server unreachable
 - 确认 MCP server 进程还在运行。
 - 确认 `manifest.mcp_server.end_point` 是 CLI 所在机器可访问的 `/mcp` 或 `/sse` 地址。
 - 确认服务支持标准 MCP 的 `initialize`、`notifications/initialized`、`tools/list`、`tools/call`。
-- 如果是内置 demo，先运行 `dbx mcp demo-server --demo milk-tea`，再运行 `dbx simulator eval --demo milk-tea --verbose`。
+- 如果是内置 demo，直接运行 `dbx check --demo milk-tea --verbose`；CLI 会自动管理临时 Demo MCP Server。
 
 ### MCP server 内部异常
 

package/skills/doubao-agentic-service-development/references/manifest-guide.md

@@ -4,7 +4,7 @@
 
 本 Skill 用于编写一个应用版本对应的一份 Manifest。Manifest 是版本完整配置的声明式文件，描述这个版本的基础信息、业务实体 schema、工具运行配置、MCP Server 连接配置和权限配置。
 
-涉及出卡协议正确性时，Manifest 写完后先用 `dbx simulator eval` 验证 MCP tools、entity schema、`tool_card_binding` 和 `card_delta`；如果只是验证本地 Manifest 是否能被 Web 模拟器加载，可以直接执行 `dbx dev`。
+涉及出卡协议正确性时，Manifest 写完后先用 `dbx check --query "<当前轮用户问题>"` 验证 MCP tools、entity schema、`tool_card_binding` 和 `card_delta`；如果只是验证本地 Manifest 是否能被 Web 模拟器加载，可以直接执行 `dbx dev`。
 
 ### 使用方式
 
@@ -507,12 +507,12 @@ tools:
 
 ## Manifest 校验
 
-写完或修改 Manifest 后，**必须使用 `dbx app artifacts validate` 进行校验**。
+写完或修改 Manifest 后，**必须使用 `dbx check --file` 进行校验**。
 
 ### 校验入口
 
 ```bash
-dbx app artifacts validate <manifest.yaml> --json
+dbx check --file <manifest.yaml> --json
 ```
 
 必须显式传入 Manifest 路径。若在本 lifecycle 流程中，先用 `workspace.py manifest path --create --json` 获取路径，再把返回的 `path` 传给本命令。

package/skills/doubao-agentic-service-development/references/mcp-protocol.md

@@ -8,7 +8,7 @@
 - Manifest 中 `entities`、`tool_card_binding`、`tools.output` 如何配置。
 - 哪些业务字段给模型看，哪些字段只给卡片代码或后续业务动作使用。
 
-协议写完后，如果要确认出卡数据链路，先使用 `dbx simulator eval` 跑通内置 demo，再在业务项目中用 `dbx simulator eval --query "<当前轮用户问题>"` 验证 MCP result、Manifest、tool_card_binding 和 `card_delta` 都正确；如果只是打开 Web 模拟器验证前端渲染或交互，直接执行 `dbx dev`。
+协议写完后，如果要确认出卡数据链路，先使用 `dbx check --demo milk-tea` 跑通内置 demo，再在业务项目中用 `dbx check --query "<当前轮用户问题>"` 验证 MCP result、Manifest、tool_card_binding 和 `card_delta` 都正确；如果只是打开 Web 模拟器验证前端渲染或交互，直接执行 `dbx dev`。
 
 需要从业务对象出发决定 entity 拆分、模板选型、模型可见字段或动作结果形态时，先读 [业务建模方法](#业务建模方法)，产出 `entities_designed`。需要设计列表卡、列表 item 是否给模型筛选、`llm_modifiable` 或 item 回填时，再读 [列表卡协议字段](#列表卡协议字段)。
 

package/skills/doubao-agentic-service-development/references/overview.md

@@ -551,8 +551,7 @@ export default defineWidget({
 
 3. 一旦修改了 Manifest，**一定要进行校验**。
    ```bash
-   dbx app artifacts validate \
-     --file <manifest_path> \
+   dbx check --file <manifest_path> \
      --json
    ```
 
@@ -562,7 +561,7 @@ export default defineWidget({
 
 - `workspace.py manifest path --create --json` 返回的 `path` 存在。
 - Manifest 覆盖本轮要提交的工具、实体、输出和权限配置。
-- `dbx app artifacts validate` 校验通过。
+- `dbx check --file` 校验通过。
 
 ## auth
 

package/skills/doubao-agentic-service-development/references/service-notice.md

@@ -101,9 +101,7 @@ notice_templates:
 先在 dbx 项目根目录运行兼容校验：
 
 ```bash
-dbx app artifacts validate ./business-templates.yaml \
-  --type business-templates \
-  --json
+dbx check --file ./business-templates.yaml --json
 ```
 
 修复所有 error 后再继续。重点检查返回问题中的 `code` 和 `path`，不要只看错误文案。

package/skills/doubao-agentic-service-development/references/task-management.md

@@ -140,9 +140,7 @@ task_templates:
 先运行：
 
 ```bash
-dbx app artifacts validate ./business-templates.yaml \
-  --type business-templates \
-  --json
+dbx check --file ./business-templates.yaml --json
 ```
 
 只同步模板时运行：