@doubao-dev/cli 0.0.26 → 0.0.27

package/skills/doubao-agentic-service-development/SKILL.md

@@ -64,7 +64,7 @@ description: 豆包智能服务全链路开发指南。当用户需要从零开
 
 最终回复前检查交付边界；不要只写“已完成”“构建通过”或“未启动 dbx dev”。只要只完成局部前端、只做静态检查/build、缺能力入口、缺 `manifest.yaml` / 运行态 Skill / MCP / 真实 `app_key` / MCP endpoint，或未跑通 `dbx dev` / simulator，就要追加“下一步”。
 
-“下一步”用一两句自然语言说明当前验证范围，并只点名实际缺失或未验证的项；不要照抄完整清单，也不要用“这些”“等”“闭环”“真实应用配置”“项目配置”概括。Page 只有 `app.config.ts` 注册时，要说明当前只是前端 Page；若要从对话触达，还缺 Widget 出卡、`tool_card_binding` 和 Page 跳转。完整智能服务交付需要 `manifest.yaml`、运行态 Skill、MCP、真实 `app_key` 和 MCP endpoint；这些产物或配置就绪后，再把 `dbx app artifacts validate <manifest.yaml路径> --json` 和 `dbx dev --mcp-endpoint <mcp_endpoint>` 写成验证下一步；工具/出卡链路再按需用 `dbx simulator eval` 验证。
+“下一步”用一两句自然语言说明当前验证范围，并只点名实际缺失或未验证的项；不要照抄完整清单，也不要用“这些”“等”“闭环”“真实应用配置”“项目配置”概括。Page 只有 `app.config.ts` 注册时，要说明当前只是前端 Page；若要从对话触达，还缺 Widget 出卡、`tool_card_binding` 和 Page 跳转。完整智能服务交付需要 `manifest.yaml`、运行态 Skill、MCP、真实 `app_key` 和 MCP endpoint；这些产物或配置就绪后，再把 `dbx check --file <manifest.yaml路径> --json` 和 `dbx dev --mcp-endpoint <mcp_endpoint>` 写成验证下一步；工具/出卡链路再按需用 `dbx check` 验证。
 
 ## 核心速查手册与代码模板 (Cheat Sheet)
 
@@ -73,7 +73,7 @@ description: 豆包智能服务全链路开发指南。当用户需要从零开
 #### 选择正确的调试命令
 
 - **`dbx dev`**：需要前台 REPL 或 Web 调试器时使用。默认只启动和使用 Web 调试能力；涉及 App 配置分流、路径、Manifest/Skill 加载、MCP endpoint 或 Web 模拟器排障时，读 [references/local-debug/overview.md](references/local-debug/overview.md)。
-- **`dbx simulator eval`**：需要验证 Skill / MCP / Manifest / `card_delta` 的后端链路时使用；它不验证前端视觉效果，具体读 [references/local-debug/simulator-eval.md](references/local-debug/simulator-eval.md)。
+- **`dbx check`**：需要验证 Skill / MCP / Manifest / `card_delta` 的后端链路时使用；它不验证前端视觉效果，具体读 [`dbx check` 指南](references/local-debug/simulator-eval.md)。
 
 两者可以串联，但不要互相替代：先确认当前需要的是交互现场，还是后端协议链路。
 
@@ -108,15 +108,15 @@ dbx dev --mcp-endpoint <mcp_endpoint>
 默认直接运行 `dbx dev --mcp-endpoint <mcp_endpoint>`；只有默认解析失败时再补 `--manifest`、`--skill`。
 确实需要传路径参数时，优先使用绝对路径；相对路径会按当前目录解析。
 
-`dbx dev` 启动交互式调试控制台；返回 Web 调试地址时必须保留完整 query。出卡链路不确定时再用 `dbx simulator eval` 排查 MCP / Manifest / Skill / card_delta。
+`dbx dev` 启动交互式调试控制台；返回 Web 调试地址时必须保留完整 query。出卡链路不确定时再用 `dbx check` 排查 MCP / Manifest / Skill / card_delta。
 
 `dbx dev` 已运行时，纯前端 Page / Widget / 样式改动不要重启工程；等待热更新后在 REPL 执行 `web` 刷新调试器。业务模板内容变化时先重新校验，再在 Web 调试面板点击“撤回并重建 session”；只刷新页面不会更新已有 Session。Manifest `app_key`、MCP endpoint、PPE 环境或路径等启动边界变化时才重启 `dbx dev`。
 
 ### 2. 高频 CLI 命令
 在开发排查过程中，最常用的 `dbx` 命令如下（执行操作时优先考虑）：
-- **校验配置**：`dbx app artifacts validate <manifest.yaml路径> --json` (修改 `manifest.yaml` 后必须执行，检查格式是否合法)
-- **校验业务模板**：`dbx app artifacts validate <business-templates.yaml路径> --type business-templates --json`（修改业务模板后执行兼容校验；通知模板缺少非空 `brief` 时不得继续调试或上传）
-- **后端评测**：`dbx simulator eval` (测试 MCP 协议、验证大模型 Tool Call 与 `card_delta` 数据流)
+- **校验配置**：`dbx check --file <manifest.yaml路径> --json` (修改 `manifest.yaml` 后必须执行，检查格式是否合法)
+- **校验业务模板**：`dbx check --file <business-templates.yaml路径> --json`（修改业务模板后执行兼容校验；通知模板缺少非空 `brief` 时不得继续调试或上传）
+- **后端评测**：`dbx check --query "<当前轮用户问题>"` (测试 MCP 协议、验证大模型 Tool Call 与 `card_delta` 数据流)
 - **本地 Web 调试**：`dbx dev --mcp-endpoint <mcp_endpoint>` (在 dbx 项目目录启动 REPL，默认只使用 Web 调试器)
 - **管理内置开发 skills**：`dbx skills sync` 同步内置开发 skills。
 - **UGC Bot 真机预览**：用户选择上传后扫码预览时，按构建上传流程生成版本，再通过版本详情页二维码和 UGC Bot 调试对话预览
@@ -201,7 +201,7 @@ tools:
 
 ### 5. MCP Server 实现规范（必须遵守）
 
-开发 MCP Server 时，**必须**满足以下协议要求，否则 `dbx simulator eval` 会直接失败：
+开发 MCP Server 时，**必须**满足以下协议要求，否则 `dbx check` 会直接失败：
 
 **1. 必须实现标准 Streamable HTTP 协议：**
 - 提供 `/mcp` 端点，支持 POST 请求。
@@ -375,7 +375,7 @@ export default defineAppConfig({
 👉 **[Read `references/frontend/components/overview.md`](references/frontend/components/overview.md)**
 
 ### 9. 本地联调与评测
-当卡片无法渲染、大模型未调用 Tool、或者 `dbx simulator eval` 报错时：
+当卡片无法渲染、大模型未调用 Tool、或者 `dbx check` 报错时：
 👉 **[Read `references/local-debug/overview.md`](references/local-debug/overview.md)**
 👉 **[Read `references/local-debug/simulator-eval.md`](references/local-debug/simulator-eval.md)**
 

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

@@ -190,7 +190,7 @@ tools:
 - `mcp_server.user_auth` 是 MCP Server 级配置，不写到单个 tool 下。
 - 单个 tool 是否要求登录由 `tools.<tool>.login_type` 决定。
 - `login_type: normal` 表示业务侧自定义登录态，当前平台校验不允许在该类型下填写 `login_params`。不要为了宿主手机号一键登录把 `login_params: [user_mobile]` 写到 `normal` tool 上；需要宿主手机号时由登录入口回调提供 `phone_code`。
-- `login_params` 只在平台校验允许的登录类型中使用；修改后必须执行 `dbx app artifacts validate <manifest.yaml路径> --json`，以 validator 结果为准。
+- `login_params` 只在平台校验允许的登录类型中使用；修改后必须执行 `dbx check --file <manifest.yaml路径> --json`，以 validator 结果为准。
 - `fetch_token_url`、`refresh_token_url`、`delete_userinfo_url` 必须是稳定可访问的 HTTPS 地址；本地调试时可以使用 localhost。
 - FetchTokenURL 和 RefreshTokenURL 需要能被平台服务端按协议直接请求通过；如有额外鉴权要求，提前和平台确认。
 - 修改 Manifest 后重启本地调试器或重新构建，确保最新配置被平台读取。
@@ -510,7 +510,7 @@ dbx dev --mcp-endpoint http://127.0.0.1:<port>/mcp
 
 4. 使用 Web 调试器或真机触发需要登录的 tool，分别验证一键登录和自定义登录页的 UI、业务接口、`postLoginResult` 和后续 MCP 调用。
 
-业务 Server、登录 callback、前端业务 API、Manifest 和 `--mcp-endpoint` 的地址与端口必须一致；本地 callback 可以通过调试 Bridge 联调，但业务 Server 必须持续运行。修改 `src/auth` 下的登录页代码后等待热更新并刷新 Web 调试器；只有路径、Manifest、运行态 Skill 或 MCP endpoint 变化时才重启 `dbx dev`。需要验证 Skill、Manifest、MCP 和出卡链路时，另行使用 `dbx simulator eval`。
+业务 Server、登录 callback、前端业务 API、Manifest 和 `--mcp-endpoint` 的地址与端口必须一致；本地 callback 可以通过调试 Bridge 联调，但业务 Server 必须持续运行。修改 `src/auth` 下的登录页代码后等待热更新并刷新 Web 调试器；只有路径、Manifest、运行态 Skill 或 MCP endpoint 变化时才重启 `dbx dev`。需要验证 Skill、Manifest、MCP 和出卡链路时，另行使用 `dbx check`。
 
 ## 隐私协议
 

package/skills/doubao-agentic-service-development/references/business-template-debug.md

@@ -28,7 +28,7 @@
 | 命令 | 项目参数 | Manifest / 模板默认位置 | 相对路径基准 |
 | --- | --- | --- | --- |
 | `dbx dev` | `--project-path`，默认当前目录 | Manifest 默认是 `<project>/manifest.yaml`；业务模板默认是**解析后的 Manifest 同目录**下的 `business-templates.yaml` | `--manifest`、`--skill` 相对 `--project-path` 解析 |
-| `dbx simulator eval` | `--project-path`，默认当前目录 | 默认读取项目目录下的 Manifest 和 Skill | 相对路径参数按 `--project-path` 解析 |
+| `dbx check` | `--project-path`，默认当前目录 | 默认读取项目目录下的 Manifest 和 Skill | 相对路径参数按 `--project-path` 解析 |
 | `dbx app artifacts upload` | `--project`，默认当前目录 | 完整上传默认读取项目根目录的 `business-templates.yaml` | `--business-templates` 相对 `--project` 解析 |
 
 因此，使用自定义 Manifest 路径时必须显式对齐本地调试和完整上传。例如 Manifest 为 `configs/manifest.yaml`：
@@ -57,7 +57,7 @@ dbx app artifacts upload \
 
 | 校验 | 使用位置 | 含义 |
 | --- | --- | --- |
-| 兼容校验 | `dbx dev` 启动预检、`dbx app artifacts validate` | 尽早发现结构和兼容性问题，适合本地开发 |
+| 兼容校验 | `dbx dev` 启动预检、`dbx check --file` | 尽早发现结构和兼容性问题，适合本地开发 |
 | 严格校验 | 模板单独同步、完整制品上传 | 正式进入平台模板同步前的最终门槛 |
 
 兼容校验通过不保证严格校验一定通过。正式上传失败时，应以严格校验返回的 `code`、`path` 和逐模板结果为准。
@@ -66,7 +66,7 @@ dbx app artifacts upload \
 
 - 模拟器调试中，创建 Sandbox Session 的请求会携带当前 Manifest 和可选 `business-templates.yaml`。已有 Session 不会因为只修改本地 YAML 就自动获得新模板；模板变化后应按 CLI 支持的流程重新创建 Session。
 - `dbx dev` 启动时会自动发现解析后 Manifest 同目录的可选 `business-templates.yaml`。文件存在时必须非空并通过兼容校验；文件不存在表示本次 Session 不配置业务模板。
-- `dbx dev` 的自动兼容校验只发生在启动预检阶段。启动后修改业务模板，再点击“撤回并重建 session”不会自动重新运行这次 CLI 校验；必须先手动执行 `dbx app artifacts validate <business-templates.yaml路径> --type business-templates --json`，再重建 Session。仅刷新 Web 页面或点击“刷新资源并重载卡片”也不会更新已有 Session。
+- `dbx dev` 的自动兼容校验只发生在启动预检阶段。启动后修改业务模板，再点击“撤回并重建 session”不会自动重新运行这次 CLI 校验；必须先手动执行 `dbx check --file <business-templates.yaml路径> --json`，再重建 Session。仅刷新 Web 页面或点击“刷新资源并重载卡片”也不会更新已有 Session。
 - Sandbox Session 由 CLI/平台模拟器链路创建和管理。Agent 和业务代码都不得调用私有接口手工创建 Session，不得自行构造、替换或持久化 Sandbox Session 凭证。
 - 真机调试中，`business-templates.yaml` 必须跟随当前工具链要求与本次使用的 Manifest、前端资源及其它产物一起处理。只做模板单独同步，不能替代真机调试包上传。
 - Session 创建/重建不等于真机调试包上传；模拟器验证通过也不等于真机调试通过。报告结果时必须明确写“模拟器调试”或“真机调试”。

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

@@ -10,7 +10,7 @@
 
 “真机调试”专指本文的 `dbx dev` 设备连接与 Page / Widget 推送。产物上传并云构建后在版本详情页扫码、进入 UGC Bot 调试对话的流程称为“真机预览”，不属于本文。
 
-门禁满足后，使用 `dbx dev` 前台 REPL 连接真机、打开 Page 或推送 Widget。本文流程不替代 `dbx simulator eval` 的 Skill / MCP / Manifest 链路验证。
+门禁满足后，使用 `dbx dev` 前台 REPL 连接真机、打开 Page 或推送 Widget。本文流程不替代 `dbx check` 的 Skill / MCP / Manifest 链路验证。
 
 如果项目存在 `business-templates.yaml`，先读 [业务模板调试边界](business-template-debug.md)。真机调试资源准备时，必须将它与当前 Manifest、前端资源及其它真机调试产物一起上传打包；不能复用模拟器创建 Sandbox Session 时的模板上传，也不能用 `--business-templates-only` 代替真机调试整包。
 
@@ -20,7 +20,7 @@
 | ------------------------------- | --------------------------------------------------- | -------------------------------------------- |
 | 真机打开指定页面                | 真机模式内执行 `page <page-url>`                    | 用户确认手机实际打开；CLI 仅证明请求已发送。 |
 | 真机推送卡片                    | 真机模式内执行 `widget <widget-id> --data '<json>'` | 用户确认设备已显示并正确渲染。               |
-| Skill / MCP / Manifest 出卡链路 | 改用 `dbx simulator eval`                           | `Verdict: PASS`、tool report 与 card delta。 |
+| Skill / MCP / Manifest 出卡链路 | 改用 `dbx check --query "<当前轮用户问题>"` | `Verdict: PASS`、tool report 与 card delta。 |
 
 不要把 `status: ok`、`page pushed` 或 `widget pushed` 描述成“设备已渲染成功”；它们最多证明 dev service 接收并派发了请求。
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/01-/345/237/272/347/241/200.md

@@ -11,6 +11,8 @@
 | [getAccountInfo](#getaccountinfo) | 异步获取账号信息。 |
 | [getAccountInfoSync](#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
 | [authorize](#authorize) | 提前向用户发起指定 scope 的授权；scope.healthData 仅用于选择 iOS HealthKit 系统授权路径。 |
+| [arrayBufferToBase64](#arraybuffertobase64) | 将 ArrayBuffer 转换为 Base64 字符串。 |
+| [base64ToArrayBuffer](#base64toarraybuffer) | 将 Base64 字符串转换为 ArrayBuffer。 |
 | [getPerformance](#getperformance) | 获取当前智能服务应用的性能数据。 Entry 由客户端保存；getEntries*() 同步查询当前快照，observer 只接收新完成的 Entry。 |
 | [getSetting](#getsetting) | 获取用户当前的应用授权设置。 |
 | [openSetting](#opensetting) | 打开智能服务授权设置页面。 |
@@ -90,10 +92,10 @@ console.log(result.miniProgram.appId, result.miniProgram.envVersion, result.mini
 <tr><th>名称</th><th>类型</th><th>必返</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>miniProgram</code></td><td><code>DoubaoAppAccountInfo</code></td><td>是</td><td>-</td><td>豆包 App 账号信息</td></tr>
-<tr><td><code>miniProgram.appId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>豆包 App appId</td></tr>
-<tr><td><code>miniProgram.envVersion</code></td><td><code>&quot;develop&quot; | &quot;trial&quot; | &quot;release&quot;</code></td><td>是</td><td>豆包 Android、iOS 当前只返回 develop 或 release，不会返回 trial</td><td>豆包 App 运行环境。<br><br>- develop：开发版<br>- trial：体验版<br>- release：正式版。Android、iOS：仅返回 develop 或 release，永远不会返回 trial。</td></tr>
-<tr><td><code>miniProgram.version</code></td><td><code>string</code></td><td>是</td><td>-</td><td>线上豆包 App 版本号。</td></tr>
+<tr><td><code>miniProgram</code></td><td><code>DoubaoAppAccountInfo</code></td><td>是</td><td>-</td><td>智能服务账号信息</td></tr>
+<tr><td><code>miniProgram.appId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>智能服务 appId</td></tr>
+<tr><td><code>miniProgram.envVersion</code></td><td><code>&quot;develop&quot; | &quot;trial&quot; | &quot;release&quot;</code></td><td>是</td><td>Android、iOS 当前只返回 develop 或 release，不会返回 trial</td><td>当前智能服务的版本类型。<br><br>- develop：开发版<br>- trial：体验版<br>- release：正式版。Android、iOS：仅返回 develop 或 release，永远不会返回 trial。</td></tr>
+<tr><td><code>miniProgram.version</code></td><td><code>string</code></td><td>是</td><td>-</td><td>智能服务版本号。</td></tr>
 <tr><td><code>plugin</code></td><td><code>PluginAccountInfo</code></td><td>否</td><td>-</td><td>插件账号信息（仅在插件中调用时包含）</td></tr>
 <tr><td><code>plugin.appId</code></td><td><code>string</code></td><td>否</td><td>-</td><td>插件 appId</td></tr>
 <tr><td><code>plugin.version</code></td><td><code>string</code></td><td>否</td><td>-</td><td>插件版本号，'a.b.c' 形式</td></tr>
@@ -202,10 +204,10 @@ console.log(result.miniProgram.appId, result.miniProgram.envVersion, result.mini
 <tr><th>名称</th><th>类型</th><th>必返</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>miniProgram</code></td><td><code>DoubaoAppAccountInfo</code></td><td>是</td><td>-</td><td>豆包 App 账号信息</td></tr>
-<tr><td><code>miniProgram.appId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>豆包 App appId</td></tr>
-<tr><td><code>miniProgram.envVersion</code></td><td><code>&quot;develop&quot; | &quot;trial&quot; | &quot;release&quot;</code></td><td>是</td><td>豆包 Android、iOS 当前只返回 develop 或 release，不会返回 trial</td><td>豆包 App 运行环境。<br><br>- develop：开发版<br>- trial：体验版<br>- release：正式版。Android、iOS：仅返回 develop 或 release，永远不会返回 trial。</td></tr>
-<tr><td><code>miniProgram.version</code></td><td><code>string</code></td><td>是</td><td>-</td><td>线上豆包 App 版本号。</td></tr>
+<tr><td><code>miniProgram</code></td><td><code>DoubaoAppAccountInfo</code></td><td>是</td><td>-</td><td>智能服务账号信息</td></tr>
+<tr><td><code>miniProgram.appId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>智能服务 appId</td></tr>
+<tr><td><code>miniProgram.envVersion</code></td><td><code>&quot;develop&quot; | &quot;trial&quot; | &quot;release&quot;</code></td><td>是</td><td>Android、iOS 当前只返回 develop 或 release，不会返回 trial</td><td>当前智能服务的版本类型。<br><br>- develop：开发版<br>- trial：体验版<br>- release：正式版。Android、iOS：仅返回 develop 或 release，永远不会返回 trial。</td></tr>
+<tr><td><code>miniProgram.version</code></td><td><code>string</code></td><td>是</td><td>-</td><td>智能服务版本号。</td></tr>
 <tr><td><code>plugin</code></td><td><code>PluginAccountInfo</code></td><td>否</td><td>-</td><td>插件账号信息（仅在插件中调用时包含）</td></tr>
 <tr><td><code>plugin.appId</code></td><td><code>string</code></td><td>否</td><td>-</td><td>插件 appId</td></tr>
 <tr><td><code>plugin.version</code></td><td><code>string</code></td><td>否</td><td>-</td><td>插件版本号，'a.b.c' 形式</td></tr>
@@ -402,6 +404,164 @@ await authorize({
 
 - **iOS**：网络类失败会细分为 301/302/303/305，并可能返回 112；Android 的网络类失败统一返回 305。
 
+<a id="arraybuffertobase64"></a>
+### arrayBufferToBase64()
+
+# arrayBufferToBase64
+
+将 ArrayBuffer 转换为 Base64 字符串。
+
+## 扫码预览
+![扫码预览 arrayBufferToBase64](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fbase64%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.1.0`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>支持</td></tr>
+<tr><td>HarmonyOS</td><td>支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>支持</td></tr>
+</tbody>
+</table>
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+arrayBufferToBase64(buffer: ArrayBuffer): string
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>buffer</code></td><td><code>ArrayBuffer</code></td><td>是</td><td>-</td><td>-</td><td>需要编码的二进制数据。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { arrayBufferToBase64 } from '@doubao-dev/framework/api';
+
+const base64 = arrayBufferToBase64(new Uint8Array([1, 2, 3, 4]).buffer);
+console.log(base64); // AQIDBA==
+```
+
+## 返回值
+
+标准 Base64 编码字符串。
+
+### 返回示例
+
+```json
+"AQIDBA=="
+```
+
+<a id="base64toarraybuffer"></a>
+### base64ToArrayBuffer()
+
+# base64ToArrayBuffer
+
+将 Base64 字符串转换为 ArrayBuffer。
+
+## 扫码预览
+![扫码预览 base64ToArrayBuffer](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fbasic%252Fbase64%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.1.0`。
+
+## 支持平台
+
+<table>
+<thead>
+<tr><th>平台</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>Android</td><td>支持</td></tr>
+<tr><td>iOS</td><td>支持</td></tr>
+<tr><td>PC</td><td>支持</td></tr>
+<tr><td>HarmonyOS</td><td>支持</td></tr>
+</tbody>
+</table>
+
+## 支持场景
+
+<table>
+<thead>
+<tr><th>场景</th><th>支持情况</th></tr>
+</thead>
+<tbody>
+<tr><td>页面</td><td>支持</td></tr>
+<tr><td>卡片</td><td>支持</td></tr>
+</tbody>
+</table>
+
+## 调用方式
+
+### 同步 API
+
+```typescript
+base64ToArrayBuffer(base64: string): ArrayBuffer
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>base64</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>需要解码的标准 Base64 字符串。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { base64ToArrayBuffer } from '@doubao-dev/framework/api';
+
+const buffer = base64ToArrayBuffer('AQIDBA==');
+console.log(Array.from(new Uint8Array(buffer))); // [1, 2, 3, 4]
+```
+
+## 返回值
+
+解码后的二进制数据。
+
+### 返回示例
+
+```json
+{
+  "byteLength": 4
+}
+```
+
 <a id="getperformance"></a>
 ### getPerformance()
 
@@ -545,7 +705,7 @@ observer.disconnect();
 
 ## 使用说明
 
-- authSetting 只表示当前智能服务的 scope 授权，不表示宿主系统权限；HealthKit 逐类型系统状态通过 getAppAuthorizeSetting 查询。
+- authSetting 只表示当前智能服务的 scope 授权，不表示操作系统权限；HealthKit 逐类型系统状态通过 getAppAuthorizeSetting 查询。
 - authSetting 只包含已向用户请求过且状态明确的权限；豆包当前不支持订阅模板，不要传入 withSubscriptions: true。
 
 ## 调用方式
@@ -623,7 +783,7 @@ console.log(result.authSetting['scope.userLocation']);
 </thead>
 <tbody>
 <tr><td><code>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>传入 withSubscriptions: true，豆包当前不支持订阅消息模板</td><td>不要传入 withSubscriptions: true，仅使用默认的 false</td></tr>
-<tr><td><code>116</code></td><td><code>resource not found</code></td><td>Android</td><td>未找到当前应用对应的运行环境记录</td><td>确认应用已正确安装并在有效运行环境中调用后重试</td></tr>
+<tr><td><code>116</code></td><td><code>resource not found</code></td><td>Android</td><td>豆包未找到当前智能服务</td><td>确认当前智能服务已正确安装后重试</td></tr>
 </tbody>
 </table>
 
@@ -759,13 +919,13 @@ try {
 <a id="doubaoappaccountinfo"></a>
 ### DoubaoAppAccountInfo
 
-豆包 App 账号信息。
+智能服务账号信息。
 
 #### Properties
 
-• **appId**: `string` - 豆包 App appId
-• **envVersion**: `'develop' | 'trial' | 'release'` - 豆包 App 运行环境。 - develop：开发版 - trial：体验版 - release：正式版
-• **version**: `string` - 线上豆包 App 版本号
+• **appId**: `string` - 智能服务 appId
+• **envVersion**: `'develop' | 'trial' | 'release'` - 当前智能服务的版本类型。 - develop：开发版 - trial：体验版 - release：正式版
+• **version**: `string` - 智能服务版本号
 
 <a id="pluginaccountinfo"></a>
 ### PluginAccountInfo
@@ -784,7 +944,7 @@ try {
 
 #### Properties
 
-• **miniProgram**: `DoubaoAppAccountInfo` - 豆包 App 账号信息
+• **miniProgram**: `DoubaoAppAccountInfo` - 智能服务账号信息
 • **plugin?**: `PluginAccountInfo` - 插件账号信息（仅在插件中调用时包含）
 
 <a id="healthdatatype"></a>

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/02-/347/263/273/347/273/237.md

@@ -430,7 +430,7 @@ console.log(result.healthDataAuthorizationDetail?.readStatus);
 
 ## 使用说明
 
-- enableDebug 由同步读取的运行环境信息决定，非调试环境下可能不返回该字段。
+- 当前不返回 `enableDebug`；如需获取调试状态，请使用 getSystemInfo 或 getSystemInfoSync。
 
 ## 调用方式
 
@@ -528,7 +528,7 @@ console.log(result.host?.appId);
 
 ## 使用说明
 
-- 该接口从运行环境同步读取窗口信息，若无需异步调用可改用 getWindowInfoSync。
+- 该接口与 getWindowInfoSync 返回相同信息；无需异步调用时可直接使用 getWindowInfoSync。
 
 ## 调用方式
 
@@ -798,7 +798,7 @@ offThemeChange();
 
 ## 平台差异
 
-- **Android**：主题变化事件依赖豆包客户端接入主题通知，未接入时可能不触发
+- **Android**：部分豆包 Android 版本可能不会触发主题变化事件
 
 <a id="getsysteminfo"></a>
 ### getSystemInfo()

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/03-/350/207/252/345/256/232/344/271/211/351/200/232/344/277/241.md

@@ -1,6 +1,6 @@
 # 豆包智能服务的端能力 API: 自定义通信
 
-在智能服务的多个 Runtime 之间发送和接收自定义事件。
+在智能服务的页面或卡片实例之间发送和接收自定义事件。
 
 [返回目录](./groups.md) | [返回速查](./quick-reference.md)
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/04-/345/256/232/344/275/215.md

@@ -718,7 +718,7 @@ unsubscribe();
 • **mode?**: `number` - 定位模式 0：低功耗 1：仅设备 2：高精度（默认）
 • **acceptLightLocation?**: `boolean` - 是否接受轻定位结果。轻定位会直接利用设备已有的 Wi-Fi 扫描缓存，由服务端快速计算当前位置，缩短定位耗时
 • **timeoutMs?**: `number` - 超时时间，单位毫秒，默认 30000
-• **maxCacheMs?**: `number` - 兼容保留字段，当前原生接口未消费该字段
+• **maxCacheMs?**: `number` - 兼容保留字段，当前不生效
 
 <a id="getlocationresponse"></a>
 ### GetLocationResponse