@doubao-dev/cli 0.0.25 → 0.0.27

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

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/08-/344/272/244/344/272/222.md

@@ -8,17 +8,222 @@ Toast、Loading、Modal、ActionSheet、BottomSheet 和返回前提醒。
 
 | API | 说明 |
 | --- | --- |
+| [enableAlertBeforeUnload](#enablealertbeforeunload) | 开启页面返回前提醒。 当用户在智能服务的非最底层页面点击左上角返回按钮、左上角首页按钮或客户端返回键时,弹起询问弹窗 返回询问对话框只会对调用的当前页面生效，通过手势滑动返回时不会弹起询问对话框。 |
+| [disableAlertBeforeUnload](#disablealertbeforeunload) | 关闭页面返回前提醒。 |
 | [showModal](#showmodal) | 显示模态对话框。 |
 | [showLoading](#showloading) | 显示 loading 提示框。 |
 | [hideToast](#hidetoast) | 隐藏当前 Toast。 |
 | [hideLoading](#hideloading) | 隐藏当前 loading。 |
 | [showActionSheet](#showactionsheet) | 显示操作菜单。 |
-| [showBottomSheet](#showbottomsheet) | 显示 Native 底部弹窗。 |
+| [showBottomSheet](#showbottomsheet) | 显示豆包底部弹窗。 |
 | [getMenuButtonBoundingClientRect](#getmenubuttonboundingclientrect) | 取菜单按钮（右上角胶囊按钮）的布局位置信息。 |
 | [showToast](#showtoast) | 显示 Toast 提示。 |
 
 ## API 详情
 
+<a id="enablealertbeforeunload"></a>
+### enableAlertBeforeUnload()
+
+# enableAlertBeforeUnload
+
+开启页面返回前提醒。
+当用户在智能服务的非最底层页面点击左上角返回按钮、左上角首页按钮或客户端返回键时,弹起询问弹窗
+
+返回询问对话框只会对调用的当前页面生效，通过手势滑动返回时不会弹起询问对话框
+
+## 扫码预览
+![扫码预览 enableAlertBeforeUnload](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fui%252Falert-before-unload%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.43`。
+
+## 支持平台
+
+<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>
+
+## 接入准备
+
+### 前置条件
+
+- 必须在页面容器内调用
+
+## 使用说明
+
+配合 disableAlertBeforeUnload 使用。
+
+- 仅非根页面的显式返回会展示提醒；根页面退出不拦截，iOS 侧滑返回不拦截。
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+enableAlertBeforeUnload(params: EnableAlertBeforeUnloadParams): Promise<object>
+```
+
+## 入参
+
+<table>
+<thead>
+<tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
+</thead>
+<tbody>
+<tr><td><code>message</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>返回前确认弹窗的文案。</td></tr>
+</tbody>
+</table>
+
+## 调用示例
+
+```typescript
+import { enableAlertBeforeUnload } from '@doubao-dev/framework/api';
+
+await enableAlertBeforeUnload({ message: '确定离开当前页面吗？' });
+```
+
+## 成功返回
+
+无返回字段。
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 失败示例
+
+```json
+{
+  "errNo": 103,
+  "errMsg": "feature not support"
+}
+```
+
+### 错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>平台</th><th>触发条件</th><th>处理建议</th></tr>
+</thead>
+<tbody>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>当前调用不来自页面容器</td><td>请在页面生命周期内调用。</td></tr>
+<tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>Android、iOS</td><td>message 缺失或类型不是字符串</td><td>传入字符串类型的 message。</td></tr>
+</tbody>
+</table>
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
+<a id="disablealertbeforeunload"></a>
+### disableAlertBeforeUnload()
+
+# disableAlertBeforeUnload
+
+关闭页面返回前提醒。
+
+## 扫码预览
+![扫码预览 disableAlertBeforeUnload](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fui%252Falert-before-unload%252Findex)
+
+## 支持版本
+
+前端库版本不低于 `0.0.43`。
+
+## 支持平台
+
+<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>
+
+## 接入准备
+
+### 前置条件
+
+- 必须在页面容器内调用
+
+## 调用方式
+
+### 异步 API
+
+```typescript
+disableAlertBeforeUnload(params?: object): Promise<object>
+```
+
+## 入参
+
+无。
+
+## 调用示例
+
+```typescript
+import { disableAlertBeforeUnload } from '@doubao-dev/framework/api';
+
+await disableAlertBeforeUnload();
+```
+
+## 成功返回
+
+无返回字段。
+
+## 错误处理
+
+错误对象和通用错误码见 [通用错误处理](./common-errors.md#错误返回)。
+
+### 失败示例
+
+```json
+{
+  "errNo": 103,
+  "errMsg": "feature not support"
+}
+```
+
+### 错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>平台</th><th>触发条件</th><th>处理建议</th></tr>
+</thead>
+<tbody>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>当前调用不来自页面容器</td><td>请在页面生命周期内调用。</td></tr>
+</tbody>
+</table>
+
+#### 通用错误码
+
+<table>
+<thead>
+<tr><th>errNo</th><th>errMsg</th><th>说明</th><th>平台</th></tr>
+</thead>
+<tbody>
+<tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android、iOS</td></tr>
+</tbody>
+</table>
+
 <a id="showmodal"></a>
 ### showModal()
 
@@ -523,7 +728,7 @@ console.log(result.tapIndex);
 
 # showBottomSheet
 
-显示 Native 底部弹窗。
+显示豆包底部弹窗。
 
 ## 扫码预览
 ![扫码预览 showBottomSheet](https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fapi%252Fui%252Fshow-bottom-sheet%252Findex)
@@ -531,7 +736,7 @@ console.log(result.tapIndex);
 ## 使用限制
 
 > [!WARNING]
-> **Android、iOS**：iOS 在 provider 不可用或不支持三按钮时返回 errNo 103 失败，Android 在 provider 不可用时返回 action=cancel、source=hostUnavailable 的成功结果，且不检测三按钮能力；调用方无法用统一逻辑处理弹窗不可用场景。
+> **Android、iOS**：iOS 无法展示弹窗或不支持三按钮时返回 errNo 103 失败，Android 无法展示弹窗时返回 action=cancel、source=hostUnavailable 的成功结果，且不检测三按钮能力；调用方无法用统一逻辑处理弹窗不可用场景。
 
 ## 支持版本
 
@@ -565,8 +770,8 @@ console.log(result.tapIndex);
 
 ## 使用说明
 
-`content` 接收受限 HTML 字符串，当前支持段落、加粗和链接，Native 会拦截危险标签、事件属性和危险链接协议。
-链接点击由 Native 打开 H5，不会关闭弹窗。
+`content` 接收受限 HTML 字符串，当前支持段落、加粗和链接；危险标签、事件属性和危险链接协议会被拦截。
+链接会在豆包内打开，不会关闭弹窗。
 Promise 在用户点击按钮或点击蒙层关闭后 resolve。
 
 - content 为受限 HTML，仅支持段落、加粗和链接，危险标签、事件属性和非 http(s) 链接会被拦截并触发失败；链接点击打开 H5，不关闭弹窗。
@@ -671,13 +876,13 @@ if (result.action === 'buttonClick') {
 </thead>
 <tbody>
 <tr><td><code>104</code></td><td><code>invalid parameter</code></td><td>Android、iOS</td><td>title 或 content 为空、content 含被拦截的标签/事件属性/危险链接、buttons 数量不在 1-3 范围；iOS 还会在按钮语义重复或按钮文案为空时返回</td><td>修正参数后重试。</td></tr>
-<tr><td><code>103</code></td><td><code>feature not support</code></td><td>iOS</td><td>豆包底部弹窗能力不可用，或按钮数为 3 时当前 provider 不支持三按钮</td><td>降级到自定义弹窗；同场景 Android 返回 action=cancel、source=hostUnavailable 的成功结果，请一并做降级处理。</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>iOS</td><td>豆包 iOS 无法展示底部弹窗，或不支持包含 3 个按钮的弹窗</td><td>降级到自定义弹窗；同场景 Android 返回 action=cancel、source=hostUnavailable 的成功结果，请一并做降级处理。</td></tr>
 </tbody>
 </table>
 
 ## 平台差异
 
-- **iOS**：provider 不可用或不支持三按钮时返回 errNo 103 失败；Android 在 provider 不可用时返回 action=cancel、source=hostUnavailable 的成功结果，且不校验三按钮能力。
+- **iOS**：无法展示底部弹窗或不支持三按钮时返回 errNo 103 失败；Android 无法展示底部弹窗时返回 action=cancel、source=hostUnavailable 的成功结果，且不校验三按钮能力。
 
 <a id="getmenubuttonboundingclientrect"></a>
 ### getMenuButtonBoundingClientRect()
@@ -924,6 +1129,15 @@ showToast({
 
 ## 相关类型
 
+<a id="enablealertbeforeunloadparams"></a>
+### EnableAlertBeforeUnloadParams
+
+开启返回前提醒的参数。
+
+#### Properties
+
+• **message**: `string` - 返回前确认弹窗的文案
+
 <a id="showmodalparams"></a>
 ### ShowModalParams