@doubao-dev/cli 0.0.26 → 0.0.28

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/10-/347/275/221/347/273/234.md

@@ -82,7 +82,7 @@ request(params: RequestParams): Promise<RequestResponse>
 <tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>data</code></td><td><code>string | Record&lt;string, any&gt; | ArrayBuffer</code></td><td>否</td><td><code>-</code></td><td>-</td><td>请求体数据。<br><br>传给服务器的数据最终会是 `String` 或 `ArrayBuffer`：<br>- 若 `data` 是 `string` 或 `ArrayBuffer`，直接使用；<br>- 若 `header['content-type']` 是 `application/x-www-form-urlencoded`，会被编码为 query string，例如：`encodeURIComponent(k)=encodeURIComponent(v)`；<br>- 若 `header['content-type']` 是 `application/json`，会执行 JSON 序列化；<br>- 若 `data` 是普通对象且未命中上述类型，也会执行 JSON 序列化；<br>- 其他类型会调用 `toString()`</td></tr>
+<tr><td><code>data</code></td><td><code>string | ArrayBuffer | Record&lt;string, any&gt;</code></td><td>否</td><td><code>-</code></td><td>-</td><td>请求体数据。<br><br>传给服务器的数据最终会是 `String` 或 `ArrayBuffer`：<br>- 若 `data` 是 `string` 或 `ArrayBuffer`，直接使用；<br>- 若 `header['content-type']` 是 `application/x-www-form-urlencoded`，会被编码为 query string，例如：`encodeURIComponent(k)=encodeURIComponent(v)`；<br>- 若 `header['content-type']` 是 `application/json`，会执行 JSON 序列化；<br>- 若 `data` 是普通对象且未命中上述类型，也会执行 JSON 序列化；<br>- 其他类型会调用 `toString()`</td></tr>
 <tr><td><code>dataType</code></td><td><code>&quot;string&quot; | &quot;json&quot; | &quot;arraybuffer&quot;</code></td><td>否</td><td><code>&quot;json&quot;</code></td><td>-</td><td>期望返回的数据格式。<br>- `json`：尝试按 JSON 解析；<br>- `string`：按字符串返回。<br>- `arraybuffer`：按二进制数据返回。</td></tr>
 <tr><td><code>header</code></td><td><code>Record&lt;string, string&gt;</code></td><td>否</td><td><code>{&quot;content-type&quot;: &quot;application/json&quot;}</code></td><td>-</td><td>请求 Header。</td></tr>
 <tr><td><code>method</code></td><td><code>RequestMethod</code></td><td>否</td><td><code>&quot;GET&quot;</code></td><td>-</td><td>请求方法。Android、iOS：Android 仅支持 GET/POST/PUT/DELETE，其余方法返回 &quot;Illegal method&quot;；iOS 仅支持 GET/POST，其余方法返回 &quot;method type not supported&quot;。</td></tr>
@@ -113,7 +113,7 @@ console.log(result.statusCode, result.data);
 <tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>data</code></td><td><code>string | Record&lt;string, any&gt; | ArrayBuffer</code></td><td>否</td><td>响应数据，类型由 `dataType` 决定。</td></tr>
+<tr><td><code>data</code></td><td><code>string | ArrayBuffer | Record&lt;string, any&gt;</code></td><td>否</td><td>响应数据，类型由 `dataType` 决定。</td></tr>
 <tr><td><code>header</code></td><td><code>Record&lt;string, string&gt;</code></td><td>是</td><td>HTTP 响应头。</td></tr>
 <tr><td><code>statusCode</code></td><td><code>number</code></td><td>是</td><td>HTTP 状态码。</td></tr>
 </tbody>
@@ -292,8 +292,8 @@ socketTask.onError((event) => {
 <tr><td><code>CLOSED</code></td><td><code>3</code></td><td>是</td><td>表示 Socket 连接已关闭。<br><br>进入该状态后，该任务不会再收到新的消息，也不应继续调用 `send`。</td></tr>
 <tr><td><code>CLOSING</code></td><td><code>2</code></td><td>是</td><td>表示 Socket 连接关闭中。<br><br>调用 SocketTask.close 后，等待豆包客户端完成关闭流程时通常处于该状态。</td></tr>
 <tr><td><code>CONNECTING</code></td><td><code>0</code></td><td>是</td><td>表示 Socket 正在连接。<br><br>`connectSocket` 刚返回且豆包客户端尚未完成握手时通常处于该状态。</td></tr>
-<tr><td><code>onClose</code></td><td><code>(callback: (event: SocketTaskCloseEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 与服务器连接断开的事件。<br><br>主动关闭、服务端关闭、连接被回收都可能触发该回调。<br>回调触发后当前任务会从内部连接表移除。</td></tr>
-<tr><td><code>onError</code></td><td><code>(callback: (event: SocketTaskErrorEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 发生错误的事件。<br><br>连接创建、发送、关闭或底层通道出现异常时触发。<br>该回调只表示发生错误，不等同于连接一定已经关闭；是否关闭应结合 `readyState`<br>或后续 `onClose` 事件判断。</td></tr>
+<tr><td><code>onClose</code></td><td><code>(callback: (event: SocketTaskCloseEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 与服务器连接断开的事件。<br><br>主动关闭、服务端关闭、连接被回收都可能触发该回调。<br>回调触发后当前任务已经结束，不应继续使用。</td></tr>
+<tr><td><code>onError</code></td><td><code>(callback: (event: SocketTaskErrorEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 发生错误的事件。<br><br>连接创建、发送、关闭或 WebSocket 通道出现异常时触发。<br>该回调只表示发生错误，不等同于连接一定已经关闭；是否关闭应结合 `readyState`<br>或后续 `onClose` 事件判断。</td></tr>
 <tr><td><code>onMessage</code></td><td><code>(callback: (event: SocketTaskMessageEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 接收到服务器发送信息的事件。<br><br>服务端每下发一条消息都会触发一次回调。消息内容通过 `event.data` 返回，<br>类型可能是 `string` 或 `ArrayBuffer`。</td></tr>
 <tr><td><code>onOpen</code></td><td><code>(callback: (event: SocketTaskOpenEvent) =&gt; void) =&gt; void</code></td><td>是</td><td>监听 WebSocket 连接服务器成功的事件。<br><br>可以注册多个回调。连接成功后触发回调，并携带握手响应 Header、协议类型等信息。<br>通常应在该回调中或之后调用 `send`。</td></tr>
 <tr><td><code>OPEN</code></td><td><code>1</code></td><td>是</td><td>表示 Socket 连接已经打开。<br><br>进入该状态后可以调用 SocketTask.send 发送数据。</td></tr>
@@ -347,7 +347,7 @@ socketTask.onError((event) => {
 </thead>
 <tbody>
 <tr><td><code>102</code></td><td><code>internal error</code></td><td>内部错误</td><td>Android</td></tr>
-<tr><td><code>113</code></td><td><code>bridge unavailable</code></td><td>Bridge 不可用</td><td>Android、iOS</td></tr>
+<tr><td><code>113</code></td><td><code>bridge unavailable</code></td><td>JS API 暂不可用</td><td>Android、iOS</td></tr>
 </tbody>
 </table>
 
@@ -428,7 +428,7 @@ uploadFile(params: UploadFileParams): UploadTask
 <tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>enableProfile</code></td><td><code>false</code></td><td>否</td><td><code>false</code></td><td>-</td><td>是否返回网络 profile。当前 native upload 链路暂不支持，仅支持 false。</td></tr>
+<tr><td><code>enableProfile</code></td><td><code>false</code></td><td>否</td><td><code>false</code></td><td>-</td><td>是否返回网络 profile。豆包当前仅支持 false。</td></tr>
 <tr><td><code>filePath</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>要上传文件资源的本地路径。</td></tr>
 <tr><td><code>formData</code></td><td><code>Record&lt;string, unknown&gt;</code></td><td>否</td><td><code>-</code></td><td>-</td><td>额外的 form-data 字段。对象或数组值会按 JSON 字符串传递。</td></tr>
 <tr><td><code>header</code></td><td><code>Record&lt;string, string&gt;</code></td><td>否</td><td><code>-</code></td><td>-</td><td>HTTP 请求 Header。`referer`、`user-agent`、`content-type` 等由豆包客户端管理的字段不会被业务覆盖。</td></tr>
@@ -710,11 +710,11 @@ downloadTask.onHeadersReceived((event) => {
 <a id="sockettasksendparams"></a>
 ### SocketTaskSendParams
 
-SocketTask.send 的参数。 send 只负责向已打开的 WebSocket 连接写入一条消息，不返回 Promise。 发送失败、连接未就绪或底层通道异常时，会通过同一个 SocketTask 的 onError 回调通知。
+SocketTask.send 的参数。 send 只负责向已打开的 WebSocket 连接写入一条消息，不返回 Promise。 发送失败、连接未就绪或 WebSocket 通道异常时，会通过同一个 SocketTask 的 onError 回调通知。
 
 #### Properties
 
-• **data**: `string | ArrayBuffer` - 需要发送给服务端的数据。 - 传入 string 时按文本消息发送； - 传入 ArrayBuffer 时按二进制消息发送，内部会编码后交给豆包客户端处理。 建议只在 onOpen 回调触发后调用 send，此时 readyState 通常为 SocketTask.OPEN
+• **data**: `string | ArrayBuffer` - 需要发送给服务端的数据。 - 传入 string 时按文本消息发送； - 传入 ArrayBuffer 时按二进制消息发送。 建议只在 onOpen 回调触发后调用 send，此时 readyState 通常为 SocketTask.OPEN
 
 <a id="sockettaskcloseparams"></a>
 ### SocketTaskCloseParams
@@ -734,8 +734,8 @@ WebSocket 连接成功事件。 当豆包客户端完成 WebSocket 握手并进
 #### Properties
 
 • **header**: `Record<string, string>` - WebSocket 握手响应中的 Response Header。 豆包 Android、iOS 当前不会透出真实握手响应头，该字段固定返回空对象 {}， 请不要依赖它读取服务端返回的握手 Header
-• **protocolType?**: `string` - 当前连接使用的网络传输层协议。 该字段由豆包客户端返回，部分运行环境可能不提供
-• **socketType?**: `string` - 豆包客户端使用的 WebSocket 实现类型。 可能的值由豆包客户端实现决定，例如系统 WebSocket 实现或豆包网络库实现； 部分运行环境可能不提供
+• **protocolType?**: `string` - 当前连接使用的网络传输层协议。 豆包无法获取时不返回该字段
+• **socketType?**: `string` - 当前连接使用的 WebSocket 组件类型。 具体值因客户端平台而异；豆包无法获取时不返回该字段
 
 <a id="sockettaskmessageevent"></a>
 ### SocketTaskMessageEvent
@@ -744,9 +744,9 @@ WebSocket 收到服务端消息事件。 服务端通过当前连接下发消息
 
 #### Properties
 
-• **data**: `string | ArrayBuffer` - 收到的服务端消息。 - 文本消息返回 string； - 二进制消息返回 ArrayBuffer。 如果运行环境不支持二进制解码能力，底层传回的内容可能仍保持字符串形式
-• **protocolType?**: `string` - 当前消息所属连接使用的协议。 该字段由豆包客户端返回，部分运行环境可能不提供
-• **socketType?**: `string` - 豆包客户端使用的 WebSocket 实现类型。 该字段由豆包客户端返回，部分运行环境可能不提供
+• **data**: `string | ArrayBuffer` - 收到的服务端消息。 - 文本消息返回 string； - 二进制消息返回 ArrayBuffer。 豆包无法将二进制消息转换为 ArrayBuffer 时，内容会保持字符串形式
+• **protocolType?**: `string` - 当前消息所属连接使用的协议。 豆包无法获取时不返回该字段
+• **socketType?**: `string` - 当前连接使用的 WebSocket 组件类型。 具体值因客户端平台而异；豆包无法获取时不返回该字段
 
 <a id="sockettaskcloseevent"></a>
 ### SocketTaskCloseEvent
@@ -758,17 +758,17 @@ WebSocket 关闭事件。 当前连接被主动关闭、服务端关闭或豆包
 • **code?**: `number` - 关闭状态码。 可能来自调用 SocketTask.close 时传入的 code，也可能来自服务端或豆包客户端
 • **reason?**: `string` - 关闭原因。 可能来自调用 SocketTask.close 时传入的 reason，也可能来自服务端或豆包客户端
 • **errMsg?**: `string` - 错误信息。 非正常关闭时豆包客户端可能通过该字段补充失败原因；正常关闭时通常为空
-• **protocolType?**: `string` - 当前连接使用的网络传输层协议。 该字段由豆包客户端返回，部分运行环境可能不提供
-• **socketType?**: `string` - 豆包客户端使用的 WebSocket 实现类型。 该字段由豆包客户端返回，部分运行环境可能不提供
+• **protocolType?**: `string` - 当前连接使用的网络传输层协议。 豆包无法获取时不返回该字段
+• **socketType?**: `string` - 当前连接使用的 WebSocket 组件类型。 具体值因客户端平台而异；豆包无法获取时不返回该字段
 
 <a id="sockettaskerrorevent"></a>
 ### SocketTaskErrorEvent
 
-WebSocket 错误事件。 连接创建失败、发送失败、主动关闭失败、底层通道异常等错误都会通过该事件通知。 如果错误发生在连接创建阶段，readyState 会变为 undefined 或 SocketTask.CLOSED。
+WebSocket 错误事件。 连接创建失败、发送失败、主动关闭失败、WebSocket 通道异常等错误都会通过该事件通知。 如果错误发生在连接创建阶段，readyState 会变为 undefined 或 SocketTask.CLOSED。
 
 #### Properties
 
-• **errMsg**: `string` - 错误信息。 由前端参数校验、编码过程或豆包客户端返回的失败原因组成，可直接用于日志上报
+• **errMsg**: `string` - 错误信息。 描述参数校验、数据编码或 WebSocket 操作的失败原因，可直接用于日志上报
 
 <a id="sockettask"></a>
 ### SocketTask
@@ -785,9 +785,9 @@ WebSocket 错误事件。 连接创建失败、发送失败、主动关闭失败
 • **send**: `(params: SocketTaskSendParams) => void` - 通过 WebSocket 连接发送数据。 该方法只发起发送动作，不返回发送结果。建议在 readyState === SocketTask.OPEN 或收到 onOpen 事件后调用；如果连接未就绪、数据编码失败或发送失败， 会触发 onError
 • **close**: `(params?: SocketTaskCloseParams) => void` - 关闭 WebSocket 连接。 调用后会发起关闭动作，并把 readyState 置为 SocketTask.CLOSING。 最终关闭完成时触发 onClose；关闭动作失败时触发 onError
 • **onOpen**: `(callback: (event: SocketTaskOpenEvent) => void) => void` - 监听 WebSocket 连接服务器成功的事件。 可以注册多个回调。连接成功后触发回调，并携带握手响应 Header、协议类型等信息。 通常应在该回调中或之后调用 send
-• **onClose**: `(callback: (event: SocketTaskCloseEvent) => void) => void` - 监听 WebSocket 与服务器连接断开的事件。 主动关闭、服务端关闭、连接被回收都可能触发该回调。 回调触发后当前任务会从内部连接表移除
+• **onClose**: `(callback: (event: SocketTaskCloseEvent) => void) => void` - 监听 WebSocket 与服务器连接断开的事件。 主动关闭、服务端关闭、连接被回收都可能触发该回调。 回调触发后当前任务已经结束，不应继续使用
 • **onMessage**: `(callback: (event: SocketTaskMessageEvent) => void) => void` - 监听 WebSocket 接收到服务器发送信息的事件。 服务端每下发一条消息都会触发一次回调。消息内容通过 event.data 返回， 类型可能是 string 或 ArrayBuffer
-• **onError**: `(callback: (event: SocketTaskErrorEvent) => void) => void` - 监听 WebSocket 发生错误的事件。 连接创建、发送、关闭或底层通道出现异常时触发。 该回调只表示发生错误，不等同于连接一定已经关闭；是否关闭应结合 readyState 或后续 onClose 事件判断
+• **onError**: `(callback: (event: SocketTaskErrorEvent) => void) => void` - 监听 WebSocket 发生错误的事件。 连接创建、发送、关闭或 WebSocket 通道出现异常时触发。 该回调只表示发生错误，不等同于连接一定已经关闭；是否关闭应结合 readyState 或后续 onClose 事件判断
 
 <a id="uploadfileresult"></a>
 ### UploadFileResult
@@ -813,7 +813,7 @@ WebSocket 错误事件。 连接创建失败、发送失败、主动关闭失败
 • **header?**: `Record<string, string>` - HTTP 请求 Header。referer、user-agent、content-type 等由豆包客户端管理的字段不会被业务覆盖
 • **formData?**: `Record<string, unknown>` - 额外的 form-data 字段。对象或数组值会按 JSON 字符串传递
 • **timeout?**: `number` - 超时时间，单位 ms；不传时使用豆包客户端的默认超时配置
-• **enableProfile?**: `false` - 是否返回网络 profile。当前 native upload 链路暂不支持，仅支持 false
+• **enableProfile?**: `false` - 是否返回网络 profile。豆包当前仅支持 false
 
 <a id="uploadtask"></a>
 ### UploadTask

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/11-/345/252/222/344/275/223.md

@@ -180,7 +180,7 @@ audio.play();
 </thead>
 <tbody>
 <tr><td><code>event.errCode</code></td><td><code>-1001</code></td><td><code>background audio src is empty</code></td><td>Android、iOS</td><td>未设置 src 就调用 play</td><td>设置有效 src 后重试。</td></tr>
-<tr><td><code>event.errCode</code></td><td><code>-1002</code></td><td><code>background audio play failed</code></td><td>Android</td><td>底层播放器启动失败</td><td>检查资源地址和网络状态后重试。</td></tr>
+<tr><td><code>event.errCode</code></td><td><code>-1002</code></td><td><code>background audio play failed</code></td><td>Android</td><td>播放器启动失败</td><td>检查资源地址和网络状态后重试。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-1003</code></td><td><code>background audio seek failed</code></td><td>Android、iOS</td><td>播放位置跳转失败</td><td>等待 canplay 后在音频时长范围内重试。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-1004</code></td><td><code>background audio player unavailable</code></td><td>Android、iOS</td><td>播放器无法创建或已经不可用</td><td>重新设置 src 后重试。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-1005</code></td><td><code>background audio is occupied by another applet</code></td><td>Android、iOS</td><td>另一智能服务正在占用背景音频</td><td>提示用户结束其他背景音频后重试。</td></tr>
@@ -963,7 +963,7 @@ audio.play();
 <tr><td><code>event.errCode</code></td><td><code>-2006</code></td><td><code>inner audio seek failed</code></td><td>Android、iOS</td><td>播放位置跳转失败</td><td>等待 canplay 后在音频时长范围内重试。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-2007</code></td><td><code>inner audio play failed</code></td><td>Android、iOS</td><td>音频播放失败</td><td>检查资源地址和网络状态后重试。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-2009</code></td><td><code>inner audio playback is interrupted</code></td><td>Android、iOS</td><td>播放被其他音频任务中断</td><td>根据业务需要在中断结束后重新调用 play。</td></tr>
-<tr><td><code>event.errCode</code></td><td><code>-2010</code></td><td><code>inner audio runtime is unavailable</code></td><td>Android、iOS</td><td>当前页面的音频运行环境不可用</td><td>确保页面仍处于有效状态后重新创建实例。</td></tr>
+<tr><td><code>event.errCode</code></td><td><code>-2010</code></td><td><code>inner audio runtime is unavailable</code></td><td>Android、iOS</td><td>当前页面无法创建音频实例</td><td>确保页面仍处于有效状态后重新创建实例。</td></tr>
 <tr><td><code>event.errCode</code></td><td><code>-2012</code></td><td><code>invalid seek position</code></td><td>Android、iOS</td><td>seek 位置不是有限非负数</td><td>传入大于或等于 0 的秒数。</td></tr>
 </tbody>
 </table>

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/12-/344/270/232/345/212/241/350/203/275/345/212/233.md

@@ -240,7 +240,6 @@ if (result.toolError) {
 ## 使用说明
 
 用于将状态已经过期的 Widget 实例转换为固定卡片，用户点击后可跳转到指定页面。
-底层通过 updateWidget 实现。
 
 `getWidgetInstanceId` 仅在卡片环境中有效，在智能服务页面中会返回 `undefined`。如果需要在页面中调用，
 请在 `navigateTo` 时通过参数传递卡片实例 ID。
@@ -600,7 +599,7 @@ createTask(params: CreateTaskParams): Promise<CreateTaskResult>
 </thead>
 <tbody>
 <tr><td><code>outTaskId</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>开发者侧任务唯一标识，用于幂等和关联</td></tr>
-<tr><td><code>taskDetail</code></td><td><code>TaskDetail</code></td><td>是</td><td>-</td><td>-</td><td>模板对应的数据，传入对象时会在调用 native 前自动 JSON.stringify</td></tr>
+<tr><td><code>taskDetail</code></td><td><code>TaskDetail</code></td><td>是</td><td>-</td><td>-</td><td>模板对应的数据，传入对象时会自动序列化为 JSON 字符串</td></tr>
 <tr><td><code>taskDetail.display_data</code></td><td><code>TaskDisplayData</code></td><td>是</td><td>-</td><td>-</td><td>任务展示数据。</td></tr>
 <tr><td><code>taskDetail.display_data.sub_title</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>-</td><td>任务副标题。</td></tr>
 <tr><td><code>taskDetail.display_data.title</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>任务标题。</td></tr>
@@ -1169,7 +1168,7 @@ Widget 更新阶段的错误。
 <a id="taskdetail"></a>
 ### TaskDetail
 
-任务详情。传入对象时会在调用 native 前自动 JSON.stringify。
+任务详情。传入对象时会自动序列化为 JSON 字符串。
 
 #### Type
 
@@ -1184,7 +1183,7 @@ Widget 更新阶段的错误。
 
 • **outTaskId**: `string` - 开发者侧任务唯一标识，用于幂等和关联
 • **taskTemplate**: `TaskTemplate` - 任务样式模板，当前仅支持 remote_normal_v1
-• **taskDetail**: `TaskDetail` - 模板对应的数据，传入对象时会在调用 native 前自动 JSON.stringify
+• **taskDetail**: `TaskDetail` - 模板对应的数据，传入对象时会自动序列化为 JSON 字符串
 • **taskType**: `TaskType` - 任务类型，当前支持 local 和 remote
 
 <a id="createtaskresult"></a>

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/16-/350/223/235/347/211/231.md

@@ -580,7 +580,7 @@ console.log(available, discovering);
 
 通常先调用 startBluetoothDevicesDiscovery。
 
-- advertisData 与 serviceData 已由框架从 Base64 解码为 ArrayBuffer 返回
+- `advertisData` 与 `serviceData` 以 ArrayBuffer 返回
 
 ## 调用方式
 
@@ -2695,7 +2695,7 @@ off();
 
 ## 使用说明
 
-- advertisData 与 serviceData 已由框架从 Base64 解码为 ArrayBuffer 返回
+- `advertisData` 与 `serviceData` 以 ArrayBuffer 返回
 
 ## 调用方式
 
@@ -2932,7 +2932,7 @@ off();
 
 `readBLECharacteristicValue` 读到的数据和 `notifyBLECharacteristicValueChange` 开启后的通知都会从此事件回传。
 
-- 读取结果与订阅通知都会从此事件回传，value 已由框架从 Base64 解码为 ArrayBuffer
+- 读取结果与订阅通知都会从此事件回传，`value` 以 ArrayBuffer 返回
 
 ## 调用方式
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/25-/346/227/240/351/232/234/347/242/215.md

@@ -112,7 +112,7 @@ console.log(open);
 <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</td><td>当前运行环境无法获取系统无障碍服务</td><td>在具备系统无障碍服务的设备上调用。</td></tr>
+<tr><td><code>103</code></td><td><code>feature not support</code></td><td>Android</td><td>当前设备不支持获取系统无障碍服务状态</td><td>在支持系统无障碍服务的设备上调用。</td></tr>
 </tbody>
 </table>
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/26-/345/237/272/347/241/200/344/277/241/346/201/257.md

@@ -155,7 +155,7 @@ console.log(result.platform, result.benchmarkLevel);
 
 ## 使用说明
 
-- `platform` 优先取自 globalProps.platform，未注入时由 globalProps.os 推导；`benchmarkLevel`、`memorySize`、`deviceAbi` 和 `cpuType` 也取自 globalProps
+- `platform` 返回小写的客户端平台标识；`benchmarkLevel` 无法获取时返回 -1
 
 ## 调用方式
 
@@ -214,8 +214,8 @@ console.log(result.platform, result.benchmarkLevel);
 
 ## 平台差异
 
-- **Android**：`abi`、`deviceAbi`、`cpuType` 仅在运行环境注入对应 globalProps 字段时返回
-- **iOS**：未注入时不返回 `abi`、`deviceAbi`、`cpuType`
+- **Android**：`abi`、`deviceAbi`、`cpuType` 为可选字段，豆包无法获取时不返回
+- **iOS**：不返回 `abi`、`deviceAbi`、`cpuType`
 
 ## 相关类型
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/28-/345/211/252/350/264/264/346/235/277.md

@@ -135,7 +135,7 @@ console.log(data);
 <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>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>当前豆包版本不支持读取剪贴板</td><td>升级至支持剪贴板能力的豆包版本后重试。</td></tr>
 </tbody>
 </table>
 
@@ -268,7 +268,7 @@ await setClipboardData({ data: '复制内容' });
 <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>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>当前豆包版本不支持写入剪贴板</td><td>升级至支持剪贴板能力的豆包版本后重试。</td></tr>
 <tr><td><code>106</code></td><td><code>system permission denied</code></td><td>Android</td><td>写入后系统未授予剪贴板访问权限，写入未生效</td><td>引导用户在系统设置中开启剪贴板相关权限后重试。</td></tr>
 </tbody>
 </table>

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/32-/346/211/253/347/240/201.md

@@ -158,7 +158,7 @@ console.log(result, scanType);
 <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>103</code></td><td><code>feature not support</code></td><td>Android、iOS</td><td>当前豆包版本不支持扫码</td><td>升级至支持扫码能力的豆包版本后重试。</td></tr>
 <tr><td><code>112</code></td><td><code>invalid result</code></td><td>iOS</td><td>扫码成功但未返回可用的扫码结果数据</td><td>稍后重试；持续失败时反馈扫码结果异常。</td></tr>
 </tbody>
 </table>

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/33-/345/261/217/345/271/225.md

@@ -30,7 +30,7 @@
 ## 使用限制
 
 > [!WARNING]
-> **iOS**：豆包 iOS 未注册 doubao.getScreenBrightness，仅提供 IDL 抽象类，调用直接失败；iOS 上调用无法取得屏幕亮度。
+> **iOS**：豆包 iOS 暂不支持该接口，调用直接失败；iOS 上调用无法取得屏幕亮度。
 
 ## 支持版本
 

package/skills/doubao-agentic-service-development/references/frontend/doubao-agentic-service-api/34-/351/234/207/345/212/250.md

@@ -26,7 +26,7 @@
 ## 使用限制
 
 > [!WARNING]
-> **Android**：Android 底层要求必传 type，省略可能导致调用不生效；未显式传 type 的调用在 Android 上行为不确定。
+> **Android**：Android 要求必传 type，省略可能导致调用不生效；未显式传 type 的调用在 Android 上行为不确定。
 
 ## 支持版本
 
@@ -77,7 +77,7 @@ vibrateShort(params?: VibrateShortParams): Promise<object>
 <tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>type</code></td><td><code>VibrateShortType</code></td><td>否</td><td><code>medium</code></td><td>heavy 为强震动，medium 为中等震动，light 为轻微震动</td><td>震动强度类型。Android：Android 底层要求必传 type，省略可能导致调用不生效。</td></tr>
+<tr><td><code>type</code></td><td><code>VibrateShortType</code></td><td>否</td><td><code>medium</code></td><td>heavy 为强震动，medium 为中等震动，light 为轻微震动</td><td>震动强度类型。Android：Android 要求必传 type，省略可能导致调用不生效。</td></tr>
 </tbody>
 </table>
 

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

@@ -39,7 +39,7 @@ JS API 调用失败时，异步 API 会 reject、同步 API 会 throw 一个错
 <tr><td><code>107</code></td><td><code>user permission denied</code></td><td>用户未授权</td></tr>
 <tr><td><code>110</code></td><td><code>API call prohibited</code></td><td>API 调用被禁止</td></tr>
 <tr><td><code>112</code></td><td><code>invalid result</code></td><td>返回结果无效</td></tr>
-<tr><td><code>113</code></td><td><code>bridge unavailable</code></td><td>Bridge 不可用</td></tr>
+<tr><td><code>113</code></td><td><code>bridge unavailable</code></td><td>JS API 暂不可用</td></tr>
 <tr><td><code>114</code></td><td><code>operation cancelled</code></td><td>操作已取消</td></tr>
 <tr><td><code>115</code></td><td><code>operation timeout</code></td><td>操作超时</td></tr>
 <tr><td><code>116</code></td><td><code>resource not found</code></td><td>资源不存在</td></tr>

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 回填时，再读 [列表卡协议字段](#列表卡协议字段)。