@doubao-dev/cli 0.0.19 → 0.0.20

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

@@ -11,7 +11,7 @@
 | [getAccountInfo](#getaccountinfo) | 异步获取账号信息。 |
 | [getAccountInfoSync](#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
 | [authorize](#authorize) | 提前向用户发起指定 scope 的应用授权。 |
-| [getPackageInfoSync](#getpackageinfosync) | 同步获取当前 package 信息。<br><br>同步 API。 |
+| [getPerformance](#getperformance) | 获取当前智能服务应用的性能数据。 Entry 由客户端保存；getEntries*() 同步查询当前快照，observer 只接收新完成的 Entry。 |
 | [getSetting](#getsetting) | 获取用户当前的应用授权设置。 |
 | [openSetting](#opensetting) | 打开智能服务授权设置页面。 |
 
@@ -353,16 +353,18 @@ await authorize({ scope: 'scope.userLocation' });
 
 - **iOS**：网络类失败会细分为 301/302/303/305，并可能返回 112；Android 的网络类失败统一返回 305。
 
-<a id="getpackageinfosync"></a>
-### getPackageInfoSync()
+<a id="getperformance"></a>
+### getPerformance()
 
-# getPackageInfoSync
+# getPerformance
 
-同步获取当前 package 信息。
+获取当前智能服务应用的性能数据。
+
+Entry 由客户端保存；`getEntries*()` 同步查询当前快照，observer 只接收新完成的 Entry。
 
 ## 支持版本
 
-前端库版本不低于 `0.0.34`。
+前端库版本不低于 `0.0.42`。
 
 ## 支持平台
 
@@ -372,18 +374,22 @@ await authorize({ scope: 'scope.userLocation' });
 </thead>
 <tbody>
 <tr><td>Android</td><td>支持</td></tr>
-<tr><td>iOS</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>
 
+## 使用说明
+
+- 仅在需要接收后续新完成的 Entry 时创建 observer；不再需要时调用 disconnect。
+
 ## 调用方式
 
 ### 同步 API
 
 ```typescript
-getPackageInfoSync(): GetPackageInfoResult
+getPerformance(): Performance
 ```
 
 ## 入参
@@ -393,11 +399,17 @@ getPackageInfoSync(): GetPackageInfoResult
 ## 调用示例
 
 ```typescript
-import { getPackageInfoSync } from '@doubao-dev/framework/api';
+import { getPerformance } from '@doubao-dev/framework/api';
 
-const result = getPackageInfoSync();
+const performance = getPerformance();
+const observer = performance.createObserver((entryList) => {
+  console.log(entryList.getEntries());
+});
 
-console.log(result.appId, result.name, result.iconSrc);
+performance.setBufferSize(100);
+observer.observe({ entryTypes: ['render'] });
+console.log(performance.getEntriesByType('render'));
+observer.disconnect();
 ```
 
 ## 返回值
@@ -407,20 +419,27 @@ console.log(result.appId, result.name, result.iconSrc);
 <tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>appId</code></td><td><code>string</code></td><td>是</td><td>当前 package 的 appId。</td></tr>
-<tr><td><code>iconSrc</code></td><td><code>string</code></td><td>否</td><td>当前 package 的展示图标地址。</td></tr>
-<tr><td><code>name</code></td><td><code>string</code></td><td>是</td><td>当前 package 的展示名称。</td></tr>
+<tr><td><code>createObserver</code></td><td><code>(callback: PerformanceObserverCallback) =&gt; PerformanceObserver</code></td><td>是</td><td>创建性能观察者。调用返回对象的 `observe` 后，回调会接收之后新完成且匹配的 Entry。</td></tr>
+<tr><td><code>getEntries</code></td><td><code>() =&gt; PerformanceEntry[]</code></td><td>是</td><td>返回当前智能服务已记录的全部性能 Entry。</td></tr>
+<tr><td><code>getEntriesByName</code></td><td><code>(name: string, entryType?: string) =&gt; PerformanceEntry[]</code></td><td>是</td><td>返回指定名称的性能 Entry；传入 entryType 时同时按类型筛选。</td></tr>
+<tr><td><code>getEntriesByType</code></td><td><code>(entryType: string) =&gt; PerformanceEntry[]</code></td><td>是</td><td>返回指定 entryType 的性能 Entry。</td></tr>
+<tr><td><code>setBufferSize</code></td><td><code>(size: number) =&gt; void</code></td><td>是</td><td>设置客户端最多保留的性能 Entry 数量。</td></tr>
 </tbody>
 </table>
 
 ### 返回示例
 
 ```json
-{
-  "appId": "7000000000000000000",
-  "name": "示例智能服务",
-  "iconSrc": "https://example.com/icon.png"
-}
+[
+  {
+    "entryType": "render",
+    "name": "firstRender",
+    "startTime": 1730000000000,
+    "duration": 42,
+    "path": "pages/index/index",
+    "pageId": 1
+  }
+]
 ```
 
 <a id="getsetting"></a>
@@ -703,16 +722,77 @@ try {
 
 • **scope**: `Scope` - 授权范围
 
-<a id="getpackageinforesult"></a>
-### GetPackageInfoResult
+<a id="performanceentry"></a>
+### PerformanceEntry
+
+#### Properties
+
+• **entryType**: `PerformanceEntryType` - 性能指标所属类别
+• **name**: `string` - 性能指标名称，例如 appLaunch、route、evaluateScript 或 firstRender
+• **startTime**: `number` - 指标开始或发生时刻的 Unix 时间戳，单位为毫秒
+• **duration?**: `number` - 指标持续时间，单位为毫秒；仅耗时类指标提供
+• **path?**: `string` - 页面路径；仅页面的 navigation 和 render 类型指标提供
+• **pageId?**: `number` - path 对应的页面实例 Id（随机生成，不保证递增）；仅页面相关指标提供
+• **referrerPath?**: `string` - 路由来源页面的路径；仅 navigation / route 指标提供
+• **referrerPageId?**: `number` - 路由来源页面的实例 ID；仅 navigation / route 指标提供
+• **navigationStart?**: `number` - 路由开始被渲染层处理的 Unix 时间戳，单位为毫秒；仅 navigation 类型指标提供
+• **navigationType?**: `string` - 路由类型。仅 navigation 类型的 Entry 有效
+• **moduleName?**: `string` - 被执行脚本的模块名称；仅 script / evaluateScript 指标提供
+• **viewLayerReadyTime?**: `number` - 视图层准备完成的 Unix 时间戳，单位为毫秒；仅 render / firstRender 指标提供
+• **viewLayerRenderStartTime?**: `number` - 视图层首次渲染开始的 Unix 时间戳，单位为毫秒；仅 render / firstRender 指标提供
+• **viewLayerRenderEndTime?**: `number` - 视图层首次渲染结束的 Unix 时间戳，单位为毫秒；仅 render / firstRender 指标提供
+• **widgetId?**: `string` - Widget 标识；仅 Widget 的 render 类型指标提供
+• **widgetInstanceId?**: `string` - Widget 实例 Id（随机生成，不保证递增）；仅 Widget 的 render 类型指标提供
+• **isAppColdLaunch?**: `boolean` - Widget 关联的应用是否冷启动；仅 Widget 的 render 类型指标提供
+
+<a id="performanceobservercallback"></a>
+### PerformanceObserverCallback
+
+#### Type
+
+`(entryList: PerformanceObserverEntryList) => void`
+
+<a id="performanceobserver"></a>
+### PerformanceObserver
+
+#### Properties
+
+• **observe**: `(options: PerformanceObserverOptions) => void`
+• **disconnect**: `() => void`
+
+<a id="performance"></a>
+### Performance
+
+#### Properties
+
+• **createObserver**: `(callback: PerformanceObserverCallback) => PerformanceObserver` - 创建性能观察者。调用返回对象的 observe 后，回调会接收之后新完成且匹配的 Entry
+• **setBufferSize**: `(size: number) => void` - 设置客户端最多保留的性能 Entry 数量
+• **getEntries**: `() => PerformanceEntry[]` - 返回当前智能服务已记录的全部性能 Entry
+• **getEntriesByType**: `(entryType: string) => PerformanceEntry[]` - 返回指定 entryType 的性能 Entry
+• **getEntriesByName**: `(name: string, entryType?: string) => PerformanceEntry[]` - 返回指定名称的性能 Entry；传入 entryType 时同时按类型筛选
+
+<a id="performanceentrytype"></a>
+### PerformanceEntryType
+
+#### Type
+
+`'navigation' | 'script' | 'render'`
+
+<a id="performanceobserverentrylist"></a>
+### PerformanceObserverEntryList
+
+#### Properties
+
+• **getEntries**: `() => PerformanceEntry[]`
+• **getEntriesByType**: `(entryType: string) => PerformanceEntry[]`
+• **getEntriesByName**: `(name: string, entryType?: string) => PerformanceEntry[]`
 
-当前 package 信息。
+<a id="performanceobserveroptions"></a>
+### PerformanceObserverOptions
 
 #### Properties
 
-• **appId**: `string` - 当前 package 的 appId
-• **name**: `string` - 当前 package 的展示名称
-• **iconSrc?**: `string` - 当前 package 的展示图标地址
+• **entryTypes**: `string[]`
 
 <a id="getsettingparams"></a>
 ### GetSettingParams

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

@@ -10,7 +10,7 @@
 | --- | --- |
 | [getWindowInfoSync](#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
 | [getSystemSetting](#getsystemsetting) | 获取设备设置。 |
-| [getAppAuthorizeSetting](#getappauthorizesetting) | 获取豆包客户端的系统授权设置。 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。状态字段固定返回 authorized、denied 或 not determined。 |
+| [getAppAuthorizeSetting](#getappauthorizesetting) | 获取豆包客户端的系统授权设置。 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回 authorized、denied 或 not determined，精细授权字段用于区分部分、只读、只写、前后台等能力。 |
 | [getAppBaseInfoSync](#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
 | [getWindowInfo](#getwindowinfo) | 获取窗口信息。 |
 | [getAppBaseInfo](#getappbaseinfo) | 获取应用基础信息。 |
@@ -222,8 +222,8 @@ console.log(result.wifiEnabled, result.deviceOrientation);
 
 获取豆包客户端的系统授权设置。
 
-调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。状态字段固定返回
-`authorized`、`denied` 或 `not determined`。
+调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回
+`authorized`、`denied` 或 `not determined`，精细授权字段用于区分部分、只读、只写、前后台等能力。
 
 ## 扫码预览
 ![扫码预览 getAppAuthorizeSetting](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%252Fget-app-authorize-setting%252Findex)
@@ -269,8 +269,12 @@ getAppAuthorizeSetting(params?: object): GetAppAuthorizeSettingResult
 import { getAppAuthorizeSetting } from '@doubao-dev/framework/api';
 
 const result = getAppAuthorizeSetting();
-console.log(result.cameraAuthorized, result.microphoneAuthorized);
-console.log(result.notificationAuthorized, result.locationReducedAccuracy);
+const detail = result.phoneCalendarAuthorizationDetail;
+const canWriteCalendar =
+  detail === 'full' ||
+  detail === 'write only' ||
+  (detail == null && result.phoneCalendarAuthorized === 'authorized');
+console.log(canWriteCalendar);
 ```
 
 ## 返回值
@@ -280,16 +284,23 @@ console.log(result.notificationAuthorized, result.locationReducedAccuracy);
 <tr><th>名称</th><th>类型</th><th>必返</th><th>说明</th></tr>
 </thead>
 <tbody>
+<tr><td><code>albumAuthorizationDetail</code></td><td><code>AlbumAuthorizationDetail | null</code></td><td>否</td><td>相册精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `limited`：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。<br>- `add only`：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。</td></tr>
 <tr><td><code>albumAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>相册授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>bluetoothAuthorizationDetail</code></td><td><code>BluetoothAuthorizationDetail | null</code></td><td>否</td><td>蓝牙精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `partial`：只获得部分已声明的蓝牙子权限；仅 Android 支持。</td></tr>
 <tr><td><code>bluetoothAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>蓝牙授权状态</td></tr>
+<tr><td><code>cameraAuthorizationDetail</code></td><td><code>BasicAuthorizationDetail | null</code></td><td>否</td><td>摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。</td></tr>
 <tr><td><code>cameraAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>摄像头授权状态</td></tr>
+<tr><td><code>locationAuthorizationDetail</code></td><td><code>LocationAuthorizationDetail | null</code></td><td>否</td><td>定位精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 UnauthorizedDetail 的全部取值；获得权限时返回：<br>- `foreground approximate`：仅应用在前台时可以获取模糊定位。<br>- `foreground precise`：仅应用在前台时可以获取精确定位。<br>- `background approximate`：应用在前台或后台时均可以获取模糊定位。<br>- `background precise`：应用在前台或后台时均可以获取精确定位。</td></tr>
 <tr><td><code>locationAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>定位授权状态</td></tr>
 <tr><td><code>locationReducedAccuracy</code></td><td><code>boolean</code></td><td>是</td><td>是否只能使用模糊定位；仅在 iOS 且定位已授权时具有精度含义，Android 固定返回 false</td></tr>
+<tr><td><code>microphoneAuthorizationDetail</code></td><td><code>BasicAuthorizationDetail | null</code></td><td>否</td><td>麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 `null`。</td></tr>
 <tr><td><code>microphoneAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>麦克风授权状态</td></tr>
 <tr><td><code>notificationAlertAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知提醒授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>notificationAuthorizationDetail</code></td><td><code>NotificationAuthorizationDetail | null</code></td><td>否</td><td>通知精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `provisional`：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。</td></tr>
 <tr><td><code>notificationAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知总授权状态</td></tr>
 <tr><td><code>notificationBadgeAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知角标授权状态；Android 固定返回 not determined</td></tr>
 <tr><td><code>notificationSoundAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>通知声音授权状态；Android 固定返回 not determined</td></tr>
+<tr><td><code>phoneCalendarAuthorizationDetail</code></td><td><code>PhoneCalendarAuthorizationDetail | null</code></td><td>否</td><td>系统日历精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 `null`。<br><br>继承 BasicAuthorizationDetail 的全部取值，并增加：<br>- `read only`：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。<br>- `write only`：只能新增日程，不能读取现有日历数据。</td></tr>
 <tr><td><code>phoneCalendarAuthorized</code></td><td><code>AppAuthorizeStatus</code></td><td>是</td><td>系统日历授权状态</td></tr>
 </tbody>
 </table>
@@ -308,7 +319,14 @@ console.log(result.notificationAuthorized, result.locationReducedAccuracy);
   "notificationAlertAuthorized": "authorized",
   "notificationBadgeAuthorized": "denied",
   "notificationSoundAuthorized": "authorized",
-  "phoneCalendarAuthorized": "not determined"
+  "phoneCalendarAuthorized": "denied",
+  "albumAuthorizationDetail": "limited",
+  "bluetoothAuthorizationDetail": "full",
+  "cameraAuthorizationDetail": "full",
+  "locationAuthorizationDetail": "foreground precise",
+  "microphoneAuthorizationDetail": "full",
+  "notificationAuthorizationDetail": "provisional",
+  "phoneCalendarAuthorizationDetail": "write only"
 }
 ```
 
@@ -317,7 +335,9 @@ console.log(result.notificationAuthorized, result.locationReducedAccuracy);
 - **Android**：albumAuthorized 和通知分项固定返回 not determined，locationReducedAccuracy 固定返回 false 且不表示实际定位精度
 - **Android**：bluetoothAuthorized、cameraAuthorized、locationAuthorized、microphoneAuthorized、notificationAuthorized 和 phoneCalendarAuthorized 不区分尚未申请和已经拒绝，两种情况均返回 denied
 - **Android**：locationAuthorized 在粗略或精确定位任一权限已授权时返回 authorized；phoneCalendarAuthorized 仅在读、写日历权限均授权时返回 authorized
+- **Android**：精细字段区分 Android 14 部分相册、日历读写、定位前后台和精度，以及蓝牙部分子权限
 - **iOS**：相册 limited 映射为 authorized，通知 provisional 和 ephemeral 映射为 authorized
+- **iOS**：精细字段区分相册 limited/add only、日历 write only、定位前后台和精度，以及通知 provisional；ephemeral 暂不映射
 
 <a id="getappbaseinfosync"></a>
 ### getAppBaseInfoSync()
@@ -1012,6 +1032,73 @@ console.log(result.screenWidth, result.screenHeight);
 
 `'authorized' | 'denied' | 'not determined'`
 
+<a id="unauthorizeddetail"></a>
+### UnauthorizedDetail
+
+尚未获得权限时的精细状态。 取值说明： - not determined：系统明确表示用户尚未作出选择 - denied：当前没有权限；可能是用户拒绝、关闭权限，或平台无法进一步区分拒绝原因 - restricted：系统明确表示权限受设备管理、家长控制等策略限制，用户无法直接修改。
+
+#### Type
+
+`'not determined' | 'denied' | 'restricted'`
+
+<a id="basicauthorizationdetail"></a>
+### BasicAuthorizationDetail
+
+只有完整授权和未授权状态的权限所使用的通用精细状态。 继承 UnauthorizedDetail 的全部取值，并增加： - full：已获得该权限的完整访问能力。
+
+#### Type
+
+`UnauthorizedDetail | 'full'`
+
+<a id="albumauthorizationdetail"></a>
+### AlbumAuthorizationDetail
+
+相册精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - limited：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。 - add only：只能向相册添加照片，不能读取相册内容；仅 iOS 支持。
+
+#### Type
+
+`BasicAuthorizationDetail | 'limited' | 'add only'`
+
+<a id="phonecalendarauthorizationdetail"></a>
+### PhoneCalendarAuthorizationDetail
+
+系统日历精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - read only：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。 - write only：只能新增日程，不能读取现有日历数据。
+
+#### Type
+
+`BasicAuthorizationDetail | 'read only' | 'write only'`
+
+<a id="locationauthorizationdetail"></a>
+### LocationAuthorizationDetail
+
+定位精细授权状态。 继承 UnauthorizedDetail 的全部取值；获得权限时返回： - foreground approximate：仅应用在前台时可以获取模糊定位。 - foreground precise：仅应用在前台时可以获取精确定位。 - background approximate：应用在前台或后台时均可以获取模糊定位。 - background precise：应用在前台或后台时均可以获取精确定位。
+
+#### Type
+
+`| UnauthorizedDetail
+  | 'foreground approximate'
+  | 'foreground precise'
+  | 'background approximate'
+  | 'background precise'`
+
+<a id="bluetoothauthorizationdetail"></a>
+### BluetoothAuthorizationDetail
+
+蓝牙精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - partial：只获得部分已声明的蓝牙子权限；仅 Android 支持。
+
+#### Type
+
+`BasicAuthorizationDetail | 'partial'`
+
+<a id="notificationauthorizationdetail"></a>
+### NotificationAuthorizationDetail
+
+通知精细授权状态。 继承 BasicAuthorizationDetail 的全部取值，并增加： - provisional：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心。
+
+#### Type
+
+`BasicAuthorizationDetail | 'provisional'`
+
 <a id="getappauthorizesettingresult"></a>
 ### GetAppAuthorizeSettingResult
 
@@ -1028,6 +1115,31 @@ console.log(result.screenWidth, result.screenHeight);
 • **notificationBadgeAuthorized**: `AppAuthorizeStatus` - 通知角标授权状态；Android 固定返回 not determined
 • **notificationSoundAuthorized**: `AppAuthorizeStatus` - 通知声音授权状态；Android 固定返回 not determined
 • **phoneCalendarAuthorized**: `AppAuthorizeStatus` - 系统日历授权状态
+• **albumAuthorizationDetail?**: `AlbumAuthorizationDetail | null` - 相册精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - limited：只能访问用户选择的部分照片；支持 iOS 和 Android 14 及以上版本。 - add only：只能向相册添加照片，不能读取相册内容；仅 iOS 支持
+• **bluetoothAuthorizationDetail?**: `BluetoothAuthorizationDetail | null` - 蓝牙精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - partial：只获得部分已声明的蓝牙子权限；仅 Android 支持
+• **cameraAuthorizationDetail?**: `CameraAuthorizationDetail | null` - 摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 null
+• **locationAuthorizationDetail?**: `LocationAuthorizationDetail | null` - 定位精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 UnauthorizedDetail 的全部取值；获得权限时返回： - foreground approximate：仅应用在前台时可以获取模糊定位。 - foreground precise：仅应用在前台时可以获取精确定位。 - background approximate：应用在前台或后台时均可以获取模糊定位。 - background precise：应用在前台或后台时均可以获取精确定位
+• **microphoneAuthorizationDetail?**: `MicrophoneAuthorizationDetail | null` - 麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致；旧客户端或无法可靠映射时不返回该字段或返回 null
+• **notificationAuthorizationDetail?**: `NotificationAuthorizationDetail | null` - 通知精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - provisional：iOS 临时静默授权；不会弹出授权框，通知只进入通知中心
+• **phoneCalendarAuthorizationDetail?**: `PhoneCalendarAuthorizationDetail | null` - 系统日历精细授权状态；旧客户端或无法可靠映射时不返回该字段或返回 null。 继承 BasicAuthorizationDetail 的全部取值，并增加： - read only：只能读取日历，不能新增、修改或删除日程；仅 Android 支持。 - write only：只能新增日程，不能读取现有日历数据
+
+<a id="cameraauthorizationdetail"></a>
+### CameraAuthorizationDetail
+
+摄像头精细授权状态，取值与 BasicAuthorizationDetail 一致。
+
+#### Type
+
+`BasicAuthorizationDetail`
+
+<a id="microphoneauthorizationdetail"></a>
+### MicrophoneAuthorizationDetail
+
+麦克风精细授权状态，取值与 BasicAuthorizationDetail 一致。
+
+#### Type
+
+`BasicAuthorizationDetail`
 
 <a id="appbaseinfohost"></a>
 ### AppBaseInfoHost

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

@@ -49,14 +49,14 @@ Toast、Loading、Modal、ActionSheet、BottomSheet 和返回前提醒。
 
 ## 使用说明
 
-- content 必填；仅当 showCancel 为 true 时展示取消按钮，仅当 tapMaskToDismiss 为 true 时点击蒙层可关闭。
+- 仅当 showCancel 为 true 时展示取消按钮；仅当 tapMaskToDismiss 为 true 时点击蒙层可关闭；editable 为 true 且用户确认时返回输入 content。
 
 ## 调用方式
 
 ### 异步 API
 
 ```typescript
-showModal(params: ShowModalParams): Promise<ShowModalResult>
+showModal(params?: ShowModalParams): Promise<ShowModalResult>
 ```
 
 ## 入参
@@ -66,9 +66,13 @@ showModal(params: ShowModalParams): Promise<ShowModalResult>
 <tr><th>名称</th><th>类型</th><th>必填</th><th>默认值</th><th>约束</th><th>说明</th></tr>
 </thead>
 <tbody>
-<tr><td><code>cancelText</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>Android 默认文案为“cancel”，iOS 默认文案为“Cancel”，需统一时请显式传入。</td><td>取消按钮的文字，省略时使用平台默认文案。</td></tr>
-<tr><td><code>confirmText</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>Android 默认文案为“confirm”，iOS 默认文案为“OK”，需统一时请显式传入。</td><td>确认按钮的文字，省略时使用平台默认文案。</td></tr>
-<tr><td><code>content</code></td><td><code>string</code></td><td>是</td><td>-</td><td>-</td><td>模态对话框的内容。</td></tr>
+<tr><td><code>cancelColor</code></td><td><code>string</code></td><td>否</td><td><code>#000000</code></td><td>必须是 16 进制格式的颜色字符串。</td><td>取消按钮的文字颜色。</td></tr>
+<tr><td><code>cancelText</code></td><td><code>string</code></td><td>否</td><td><code>取消</code></td><td>最多 4 个字符。</td><td>取消按钮的文字。</td></tr>
+<tr><td><code>confirmColor</code></td><td><code>string</code></td><td>否</td><td><code>#F85959</code></td><td>必须是 16 进制格式的颜色字符串。</td><td>确认按钮的文字颜色。</td></tr>
+<tr><td><code>confirmText</code></td><td><code>string</code></td><td>否</td><td><code>确定</code></td><td>最多 4 个字符。</td><td>确认按钮的文字。</td></tr>
+<tr><td><code>content</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>-</td><td>模态对话框的内容。</td></tr>
+<tr><td><code>editable</code></td><td><code>boolean</code></td><td>否</td><td><code>false</code></td><td>-</td><td>是否显示输入框。</td></tr>
+<tr><td><code>placeholderText</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>-</td><td>显示输入框时的提示文本。</td></tr>
 <tr><td><code>showCancel</code></td><td><code>boolean</code></td><td>否</td><td><code>true</code></td><td>-</td><td>是否显示取消按钮。</td></tr>
 <tr><td><code>tapMaskToDismiss</code></td><td><code>boolean</code></td><td>否</td><td><code>true</code></td><td>-</td><td>是否允许点击蒙层关闭对话框。</td></tr>
 <tr><td><code>title</code></td><td><code>string</code></td><td>否</td><td><code>-</code></td><td>-</td><td>模态对话框的标题。</td></tr>
@@ -100,6 +104,7 @@ if (result.action === 'confirm') {
 </thead>
 <tbody>
 <tr><td><code>action</code></td><td><code>&quot;confirm&quot; | &quot;cancel&quot; | &quot;mask&quot;</code></td><td>是</td><td>用户点击的动作。</td></tr>
+<tr><td><code>content</code></td><td><code>string</code></td><td>否</td><td>`editable` 为 true 时，用户点击确认后输入的文本。</td></tr>
 </tbody>
 </table>
 
@@ -831,10 +836,14 @@ showToast({
 #### Properties
 
 • **title?**: `string` - 模态对话框的标题
-• **content**: `string` - 模态对话框的内容
+• **content?**: `string` - 模态对话框的内容
 • **showCancel?**: `boolean` - 是否显示取消按钮
-• **cancelText?**: `string` - 取消按钮的文字，省略时使用平台默认文案
-• **confirmText?**: `string` - 确认按钮的文字，省略时使用平台默认文案
+• **cancelText?**: `string` - 取消按钮的文字
+• **cancelColor?**: `string` - 取消按钮的文字颜色
+• **confirmText?**: `string` - 确认按钮的文字
+• **confirmColor?**: `string` - 确认按钮的文字颜色
+• **editable?**: `boolean` - 是否显示输入框
+• **placeholderText?**: `string` - 显示输入框时的提示文本
 • **tapMaskToDismiss?**: `boolean` - 是否允许点击蒙层关闭对话框
 
 <a id="showmodalresult"></a>
@@ -845,6 +854,7 @@ showToast({
 #### Properties
 
 • **action**: `'confirm' | 'cancel' | 'mask'` - 用户点击的动作
+• **content?**: `string` - editable 为 true 时，用户点击确认后输入的文本
 
 <a id="showloadingparams"></a>
 ### ShowLoadingParams

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

@@ -28,7 +28,7 @@ import { showToast, request, getStorage } from '@doubao-dev/framework/api';
 | 位置 | 获取当前位置、选择位置、打开地图、持续监听位置变化 | [getLocation](03-定位.md#getlocation)、[startLocationUpdate](03-定位.md#startlocationupdate)、[onLocationChange](03-定位.md#onlocationchange) |
 | 图片和录音 | 选择、预览、保存、压缩图片，读取图片信息，或获取录音管理器 | [chooseImage](09-媒体.md#chooseimage)、[previewImage](09-媒体.md#previewimage)、[saveImageToPhotosAlbum](09-媒体.md#saveimagetophotosalbum)、[compressImage](09-媒体.md#compressimage)、[getImageInfo](09-媒体.md#getimageinfo)、[getRecorderManager](09-媒体.md#getrecordermanager) |
 | WebSocket | 创建长连接并收发消息、监听连接状态 | [connectSocket](08-网络.md#connectsocket) |
-| 系统、窗口、设备信息 | 读取系统信息、窗口信息、设备信息和包信息 | [getSystemInfo](02-系统.md#getsysteminfo)、[getWindowInfo](02-系统.md#getwindowinfo)、[getDeviceInfo](24-基础信息.md#getdeviceinfo)、[getPackageInfoSync](01-基础.md#getpackageinfosync) |
+| 系统、窗口、设备信息 | 读取系统信息、窗口信息和设备信息 | [getSystemInfo](02-系统.md#getsysteminfo)、[getWindowInfo](02-系统.md#getwindowinfo)、[getDeviceInfo](24-基础信息.md#getdeviceinfo) |
 | 剪贴板、扫码、电话和短信 | 调用常见系统能力读取/写入剪贴板、扫码、拨号或发短信 | [getClipboardData](26-剪贴板.md#getclipboarddata)、[setClipboardData](26-剪贴板.md#setclipboarddata)、[scanCode](30-扫码.md#scancode)、[makePhoneCall](29-电话.md#makephonecall)、[sendSms](22-短信.md#sendsms) |
 | 蓝牙、Wi-Fi 和传感器 | 打开蓝牙/Wi-Fi、扫描或连接设备，监听加速度计、罗盘、陀螺仪和设备方向 | [openBluetoothAdapter](14-蓝牙.md#openbluetoothadapter)、[startBluetoothDevicesDiscovery](14-蓝牙.md#startbluetoothdevicesdiscovery)、[startWifi](15-wi-fi.md#startwifi)、[connectWifi](15-wi-fi.md#connectwifi)、[startAccelerometer](16-加速度计.md#startaccelerometer)、[startCompass](18-罗盘.md#startcompass)、[startGyroscope](20-陀螺仪.md#startgyroscope)、[startDeviceMotionListening](19-设备方向.md#startdevicemotionlistening) |
 
@@ -41,7 +41,7 @@ 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 的应用授权。 |
-| [getPackageInfoSync](01-基础.md#getpackageinfosync) | 同步获取当前 package 信息。<br><br>同步 API。 |
+| [getPerformance](01-基础.md#getperformance) | 获取当前智能服务应用的性能数据。 Entry 由客户端保存；getEntries*() 同步查询当前快照，observer 只接收新完成的 Entry。 |
 | [getSetting](01-基础.md#getsetting) | 获取用户当前的应用授权设置。 |
 | [openSetting](01-基础.md#opensetting) | 打开智能服务授权设置页面。 |
 
@@ -53,7 +53,7 @@ import { showToast, request, getStorage } from '@doubao-dev/framework/api';
 | --- | --- |
 | [getWindowInfoSync](02-系统.md#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
 | [getSystemSetting](02-系统.md#getsystemsetting) | 获取设备设置。 |
-| [getAppAuthorizeSetting](02-系统.md#getappauthorizesetting) | 获取豆包客户端的系统授权设置。 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。状态字段固定返回 authorized、denied 或 not determined。 |
+| [getAppAuthorizeSetting](02-系统.md#getappauthorizesetting) | 获取豆包客户端的系统授权设置。 调用只读取当前系统授权状态，不会申请权限或触发系统授权弹窗。原有状态字段固定返回 authorized、denied 或 not determined，精细授权字段用于区分部分、只读、只写、前后台等能力。 |
 | [getAppBaseInfoSync](02-系统.md#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
 | [getWindowInfo](02-系统.md#getwindowinfo) | 获取窗口信息。 |
 | [getAppBaseInfo](02-系统.md#getappbaseinfo) | 获取应用基础信息。 |

package/skills/doubao-agentic-service-development/references/frontend/examples/page-widget-basics.md

@@ -30,8 +30,8 @@ src/pages/user-profile/
 
 ### app.config.ts
 
-`app.config.ts` 需要配置 `appId` 和 `name`。这里额外配置 `pages` 是为了补充标题和描述，并确保
-`user-profile` 作为页面 ID 使用。
+`app.config.ts` 需要配置 `appId` 和 `name`。这里额外配置 `pages` 是为了补充标题和描述；页面使用
+`/pages/user-profile/index` 作为完整路径。
 
 ```ts
 import { defineAppConfig } from '@doubao-dev/framework/config';
@@ -42,7 +42,6 @@ export default defineAppConfig({
   pages: [
     {
       entry: 'pages/user-profile/index',
-      id: 'user-profile',
       title: '用户资料',
       description: '显示用户个人信息和统计数据'
     }

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

@@ -266,7 +266,8 @@ Widget 时先读模板库的选型指南和 props 参考，选中模板后再回
 需要补 metadata 或声明多级目录时，再配置 `widgets` 数组。显式声明入口时，entry 写到 `index`，例如
 `'widgets/my-widget/index'`，不要省略入口文件名。
 多级目录如 `src/widgets/order/detail/index.tsx` 需要显式写 `'widgets/order/detail/index'`。
-如果不配置 `id`，默认 `widgetId` 是最后一级目录名 `detail`。
+如果不配置 `id`，默认 `widgetId` 是最后一级目录名 `detail`。Widget ID 必须在应用内全局唯一；如果多个入口得到
+相同 ID，构建会失败，需要在 `app.config.ts` 中为它们配置不同的 `id`。
 
 ```ts
 import { defineAppConfig } from '@doubao-dev/framework/config';

package/skills/doubao-agentic-service-development/references/frontend/guides/debugger-mcp.md

@@ -39,12 +39,18 @@ Page / Widget 运行现场。它不替代用户业务 MCP server，只描述 deb
 ## Transport
 
 - 协议：MCP Streamable HTTP。
+- 协议版本：支持 `2026-07-28` modern era，也接受 2025-era legacy 请求；modern client 通过
+  `server/discover` 协商版本。
 - 方法：`POST /__wsd_mcp`。
 - 会话：当前实现不生成 session id，每次请求创建一次 MCP server / transport。
 - CORS 预检：`OPTIONS /__wsd_mcp` 返回 204。
 - 数据来源：调试台 UI 会把运行期快照写回 `/__agent_trace`，查询 tools 从 debugger server 内存中的最新快照读取数据。
 - 浏览器控制：调试台通过内部 SSE 通道接收控制命令；渲染命令会在目标完成渲染且生成匹配命令的新 DOM 快照后回执。
 
+Web SDK Debugger 连接用户业务 MCP endpoint 时使用自动版本协商：优先选择 `2026-07-28`，对只支持 2025-era
+的 server 回退到 legacy handshake。每次 `tools/list` 或 `tools/call` 都建立独立 client，因此会重新执行协商，不缓存
+endpoint 的 era 判定。
+
 当 debugger server 尚未收到快照，或当前没有 Page / Widget 运行现场时，tools 返回：
 
 ```json
@@ -61,7 +67,7 @@ MCP tools 读取 debugger server 内存中的最新 snapshot。
 
 所有 tools 都返回 MCP tool result：
 
-- `structuredContent`：结构化 JSON。
+- `structuredContent`：任意 JSON value；当前 debugger 内置 tools 返回对象。
 - `content[0].text`：默认是同一 JSON 的格式化字符串；`take_snapshot` 直接返回 uid 文本树，方便 Agent 阅读。
 
 分页类 tools 的通用字段：

package/skills/doubao-agentic-service-development/references/frontend/rules/dos-and-donts.md

@@ -45,7 +45,6 @@ export default defineAppConfig({
   pages: [
     {
       entry: 'pages/home/index',
-      id: 'home',
       title: '首页',
       description: '应用默认打开的页面'
     }
@@ -67,7 +66,6 @@ export default defineAppConfig({
   pages: [
     {
       entry: 'pages/user-profile/index',
-      id: 'user-profile',
       title: '用户资料',
       description: '展示和编辑用户个人资料'
     }
@@ -84,8 +82,7 @@ export default defineAppConfig({
   name: '我的豆包应用',
   pages: [
     {
-      entry: 'pages/user-profile/index',
-      id: 'page1'
+      entry: 'pages/user-profile/index'
     }
   ]
 });
@@ -105,7 +102,6 @@ export default defineAppConfig({
     'pages/account/demo/index',
     {
       entry: 'pages/account/settings/index',
-      id: 'account-settings',
       title: '账号设置页'
     }
   ],
@@ -124,8 +120,9 @@ export default defineAppConfig({
 });
 ```
 
-如果不配置 `id`，默认取入口最后一级目录名：`pages/account/demo/index` 默认为 `demo`，`widgets/order/detail/index`
-默认为 `detail`。
+Page 使用由完整 entry 派生的 URL，例如 `pages/account/demo/index` 对应 `/pages/account/demo/index`。
+Widget 如果不配置 `id`，默认取入口最后一级目录名，例如 `widgets/order/detail/index` 默认为 `detail`；该 ID
+必须在应用内全局唯一。
 
 #### ✅ 分离样式文件
 ```tsx

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

@@ -291,7 +291,6 @@ export default defineAppConfig({
     'pages/home/index',
     {
       entry: 'pages/account/settings/index',
-      id: 'account-settings',
       title: '账号设置页'
     }
   ],