@doubao-dev/cli 0.0.26 → 0.0.28

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