@doubao-apps/ai 0.0.33 → 0.0.34

package/dist/skills/doubao-apps-dev/references/reference/open-api.md

@@ -1,11 +1,393 @@
 # Open API
 
-> 公开可用的端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
+> 端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
 
-覆盖 0 个函数。详细参数、返回值、示例和相关类型请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
+覆盖 144 个函数。详细参数、返回值、示例和相关类型请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
 
 ## 使用方式
 
 ```typescript
 import { showToast, request, getStorage } from '@doubao-apps/framework/api';
 ```
+
+## 基础
+
+账号、授权、宿主基础信息、窗口信息和能力可用性。
+
+| API | 说明 |
+| --- | --- |
+| [getAccountInfo](open-api/01-基础.md#getaccountinfo) | 异步获取账号信息。 |
+| [getAccountInfoSync](open-api/01-基础.md#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
+| [authorize](open-api/01-基础.md#authorize) | 初始化授权。 |
+| [canIUse](open-api/01-基础.md#caniuse) | 检测当前宿主是否支持指定 API 或能力。 |
+
+## 系统
+
+宿主基础信息、窗口信息和系统设置。
+
+| API | 说明 |
+| --- | --- |
+| [getWindowInfoSync](open-api/02-系统.md#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
+| [getSystemSetting](open-api/02-系统.md#getsystemsetting) | 获取设备设置。 |
+| [getAppBaseInfoSync](open-api/02-系统.md#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
+| [getWindowInfo](open-api/02-系统.md#getwindowinfo) | 获取窗口信息。 |
+| [getAppBaseInfo](open-api/02-系统.md#getappbaseinfo) | 获取应用基础信息。 |
+| [ThemeChangeListener](open-api/02-系统.md#themechangelistener) | 应用主题变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [onThemeChange](open-api/02-系统.md#onthemechange) | 监听应用主题变化。 |
+
+## 定位
+
+获取设备当前的地理位置信息。
+
+| API | 说明 |
+| --- | --- |
+| [LocationChangeListener](open-api/03-定位.md#locationchangelistener) | LocationChangeListener API。<br><br>返回 void，不是 Promise。 |
+| [LocationChangeErrorListener](open-api/03-定位.md#locationchangeerrorlistener) | LocationChangeErrorListener API。<br><br>返回 void，不是 Promise。 |
+| [getLocation](open-api/03-定位.md#getlocation) | 获取设备当前的地理位置信息。 |
+| [chooseLocation](open-api/03-定位.md#chooselocation) | 打开地图选择位置。 |
+| [openLocation](open-api/03-定位.md#openlocation) | 使用地图查看位置。 |
+| [startLocationUpdate](open-api/03-定位.md#startlocationupdate) | 开始接收位置更新。 |
+| [stopLocationUpdate](open-api/03-定位.md#stoplocationupdate) | 停止接收位置更新。 |
+| [onLocationChange](open-api/03-定位.md#onlocationchange) | 注册地理位置变化回调。<br><br>返回 void，不是 Promise。 |
+| [offLocationChange](open-api/03-定位.md#offlocationchange) | 取消注册地理位置变化回调。<br><br>返回 void，不是 Promise。 |
+| [onLocationChangeError](open-api/03-定位.md#onlocationchangeerror) | 注册位置更新异常回调。<br><br>返回 void，不是 Promise。 |
+| [offLocationChangeError](open-api/03-定位.md#offlocationchangeerror) | 取消注册位置更新异常回调。<br><br>返回 void，不是 Promise。 |
+
+## 存储
+
+本地缓存；带 Sync 后缀的是同步 API。
+
+| API | 说明 |
+| --- | --- |
+| [setStorage](open-api/04-存储.md#setstorage) | 将数据写入本地缓存。 |
+| [setStorageSync](open-api/04-存储.md#setstoragesync) | 将数据写入本地缓存。<br><br>同步 API。 |
+| [getStorage](open-api/04-存储.md#getstorage) | 从本地缓存读取数据。 |
+| [getStorageSync](open-api/04-存储.md#getstoragesync) | 从本地缓存同步读取数据。<br><br>同步 API。 |
+| [removeStorage](open-api/04-存储.md#removestorage) | 删除本地缓存中指定 key 的数据。 |
+| [removeStorageSync](open-api/04-存储.md#removestoragesync) | 删除本地缓存中指定 key 的数据。<br><br>同步 API。 |
+| [clearStorage](open-api/04-存储.md#clearstorage) | 清空本地缓存。 |
+| [clearStorageSync](open-api/04-存储.md#clearstoragesync) | 清空本地缓存。<br><br>同步 API。 |
+| [getStorageInfo](open-api/04-存储.md#getstorageinfo) | 获取本地缓存信息。 |
+| [getStorageInfoSync](open-api/04-存储.md#getstorageinfosync) | 同步获取本地缓存信息。<br><br>同步 API。 |
+
+## 路由
+
+应用内页面跳转、返回、退出和关闭。
+
+| API | 说明 |
+| --- | --- |
+| [navigateTo](open-api/05-路由.md#navigateto) | 保留当前页面，跳转到应用内的某个页面。 |
+| [redirectTo](open-api/05-路由.md#redirectto) | 关闭当前页面，跳转到应用内的某个页面。 |
+| [reLaunch](open-api/05-路由.md#relaunch) | 关闭所有页面并跳转到应用内页面。 |
+| [navigateBack](open-api/05-路由.md#navigateback) | 关闭当前页面，返回上一页面或多级页面。 |
+| [exitApp](open-api/05-路由.md#exitapp) | 退出当前所有页面。 |
+| [close](open-api/05-路由.md#close) | 关闭栈顶页面。 |
+
+## 交互
+
+Toast、Loading、Modal、ActionSheet 和返回前提醒。
+
+| API | 说明 |
+| --- | --- |
+| [showModal](open-api/06-交互.md#showmodal) | 显示模态对话框。 |
+| [showLoading](open-api/06-交互.md#showloading) | 显示 loading 提示框。 |
+| [hideToast](open-api/06-交互.md#hidetoast) | 隐藏当前 Toast。 |
+| [hideLoading](open-api/06-交互.md#hideloading) | 隐藏当前 loading。 |
+| [showActionSheet](open-api/06-交互.md#showactionsheet) | 显示操作菜单。 |
+| [getMenuButtonBoundingClientRect](open-api/06-交互.md#getmenubuttonboundingclientrect) | 获取菜单按钮的布局位置信息。 |
+| [enableAlertBeforeUnload](open-api/06-交互.md#enablealertbeforeunload) | 开启页面返回前提醒。 |
+| [disableAlertBeforeUnload](open-api/06-交互.md#disablealertbeforeunload) | 关闭页面返回前提醒。 |
+| [showToast](open-api/06-交互.md#showtoast) | 显示 Toast 提示。 |
+
+## 输入
+
+键盘和输入框选区能力。
+
+| API | 说明 |
+| --- | --- |
+| [hideKeyboard](open-api/07-输入.md#hidekeyboard) | 收起当前键盘。 |
+| [getSelectedTextRange](open-api/07-输入.md#getselectedtextrange) | 获取当前输入框的选区范围。 |
+
+## 网络
+
+网络请求与 WebSocket。
+
+| API | 说明 |
+| --- | --- |
+| [request](open-api/08-网络.md#request) | 发起网络请求。 |
+| [connectSocket](open-api/08-网络.md#connectsocket) | 创建一个 WebSocket 连接，并返回可操作该连接的 SocketTask。 |
+
+## 媒体
+
+图片选择、预览、保存、压缩和信息读取。
+
+| API | 说明 |
+| --- | --- |
+| [saveImageToPhotosAlbum](open-api/09-媒体.md#saveimagetophotosalbum) | 保存图片到系统相册。 |
+| [previewImage](open-api/09-媒体.md#previewimage) | 预览图片。 |
+| [getImageInfo](open-api/09-媒体.md#getimageinfo) | 获取图片信息。 |
+| [chooseImage](open-api/09-媒体.md#chooseimage) | 选择图片。 |
+| [compressImage](open-api/09-媒体.md#compressimage) | 压缩图片。 |
+
+## 业务能力
+
+开放业务能力、隐私设置、上下文和外部应用打开。
+
+| API | 说明 |
+| --- | --- |
+| [dispatchActionDirective](open-api/10-业务能力.md#dispatchactiondirective) | 描述用户行为，约束模型行为并指定后续执行路径。 |
+| [expiredWidget](open-api/10-业务能力.md#expiredwidget) | 更新过期的 widget 为固定卡片。 |
+| [openApp](open-api/10-业务能力.md#openapp) | 通过 deep link 等方式打开外部应用。 |
+| [getPrivacySetting](open-api/10-业务能力.md#getprivacysetting) | 获取隐私设置状态。 |
+| [sendQueryMessage](open-api/10-业务能力.md#sendquerymessage) | 以用户身份发送一条消息。<br><br>返回 void，不是 Promise。 |
+| [setAdditionalContext](open-api/10-业务能力.md#setadditionalcontext) | 设置全局上下文供大模型理解。 |
+| [createTask](open-api/10-业务能力.md#createtask) | 创建任务。 |
+| [updateTask](open-api/10-业务能力.md#updatetask) | 更新任务状态或任务详情。 |
+| [getTask](open-api/10-业务能力.md#gettask) | 查询任务。 |
+| [updateModelContext](open-api/10-业务能力.md#updatemodelcontext) | 向 Agent 捐赠上下文。 |
+| [updateWidget](open-api/10-业务能力.md#updatewidget) | 更新指定卡片。 |
+
+## 登录
+
+豆包登录和登录结果回传能力。
+
+| API | 说明 |
+| --- | --- |
+| [loginWithDoubaoWidget](open-api/11-登录.md#loginwithdoubaowidget) | 发起豆包 Widget 登录。 |
+| [login](open-api/11-登录.md#login) | 发起登录并获取登录凭证。 |
+| [postLoginResult](open-api/11-登录.md#postloginresult) | 回传 MCP 授权登录凭证。 |
+
+## 支付
+
+订单创建、签名和支付能力。
+
+| API | 说明 |
+| --- | --- |
+| [createSignOrder](open-api/12-支付.md#createsignorder) | 创建签约订单。 |
+| [getOrderPaymentWithSign](open-api/12-支付.md#getorderpaymentwithsign) | 使用签名信息拉起收银台完成订单支付。 |
+| [getOrderPayment](open-api/12-支付.md#getorderpayment) | 拉起收银台完成订单支付。 |
+| [requestCombineOrder](open-api/12-支付.md#requestcombineorder) | 请求创建合单订单。 |
+| [requestOrder](open-api/12-支付.md#requestorder) | 发起订单支付流程。 |
+| [sign](open-api/12-支付.md#sign) | 拉起签约流程。 |
+
+## 数据分析
+
+监控上报、事件和数据分析上报。
+
+| API | 说明 |
+| --- | --- |
+| [reportEvent](open-api/13-数据分析.md#reportevent) | 上报数据分析事件。 |
+
+## 蓝牙
+
+蓝牙和 BLE 能力；通常先打开适配器，再扫描、连接和读写。
+
+| API | 说明 |
+| --- | --- |
+| [openBluetoothAdapter](open-api/14-蓝牙.md#openbluetoothadapter) | 打开蓝牙适配器。 |
+| [startBluetoothDevicesDiscovery](open-api/14-蓝牙.md#startbluetoothdevicesdiscovery) | 开始搜索附近的蓝牙设备。 |
+| [stopBluetoothDevicesDiscovery](open-api/14-蓝牙.md#stopbluetoothdevicesdiscovery) | 停止搜索附近的蓝牙设备。 |
+| [getBluetoothAdapterState](open-api/14-蓝牙.md#getbluetoothadapterstate) | 获取蓝牙适配器状态。 |
+| [getBluetoothDevices](open-api/14-蓝牙.md#getbluetoothdevices) | 获取当前蓝牙模块发现的设备列表。 |
+| [getConnectedBluetoothDevices](open-api/14-蓝牙.md#getconnectedbluetoothdevices) | 获取已连接的蓝牙设备列表。 |
+| [makeBluetoothPair](open-api/14-蓝牙.md#makebluetoothpair) | 发起蓝牙配对。 |
+| [isBluetoothDevicePaired](open-api/14-蓝牙.md#isbluetoothdevicepaired) | 查询蓝牙设备是否已经配对。 |
+| [closeBluetoothAdapter](open-api/14-蓝牙.md#closebluetoothadapter) | 关闭蓝牙适配器。 |
+| [createBLEConnection](open-api/14-蓝牙.md#createbleconnection) | 创建 BLE 连接。 |
+| [closeBLEConnection](open-api/14-蓝牙.md#closebleconnection) | 关闭 BLE 连接。 |
+| [getBLEDeviceServices](open-api/14-蓝牙.md#getbledeviceservices) | 获取 BLE 服务列表。 |
+| [getBLEDeviceCharacteristics](open-api/14-蓝牙.md#getbledevicecharacteristics) | 获取 BLE 特征值列表。 |
+| [getBLEDeviceRSSI](open-api/14-蓝牙.md#getbledevicerssi) | 获取 BLE 设备 RSSI。 |
+| [getBLEMTU](open-api/14-蓝牙.md#getblemtu) | 获取 BLE MTU。 |
+| [notifyBLECharacteristicValueChange](open-api/14-蓝牙.md#notifyblecharacteristicvaluechange) | 订阅 BLE 特征值变化。 |
+| [readBLECharacteristicValue](open-api/14-蓝牙.md#readblecharacteristicvalue) | 读取 BLE 特征值。 |
+| [setBLEMTU](open-api/14-蓝牙.md#setblemtu) | 设置 BLE MTU。 |
+| [writeBLECharacteristicValue](open-api/14-蓝牙.md#writeblecharacteristicvalue) | 写入 BLE 特征值。 |
+
+## Wi-Fi
+
+Wi-Fi 模块能力；通常先 startWifi，再获取列表或连接。
+
+| API | 说明 |
+| --- | --- |
+| [WifiConnectedListener](open-api/15-wi-fi.md#wificonnectedlistener) | Wi-Fi 连接事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [startWifi](open-api/15-wi-fi.md#startwifi) | 初始化 Wi-Fi 模块。 |
+| [stopWifi](open-api/15-wi-fi.md#stopwifi) | 关闭 Wi-Fi 模块。 |
+| [setWifiList](open-api/15-wi-fi.md#setwifilist) | 设置 Wi-Fi 预设列表（iOS 特有）。 |
+| [connectWifi](open-api/15-wi-fi.md#connectwifi) | 连接指定 Wi-Fi。 |
+| [getConnectedWifi](open-api/15-wi-fi.md#getconnectedwifi) | 获取当前已连接 Wi-Fi 信息。 |
+| [getWifiList](open-api/15-wi-fi.md#getwifilist) | 获取 Wi-Fi 列表。 |
+
+## 加速度计
+
+加速度计监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [AccelerometerChangeListener](open-api/16-加速度计.md#accelerometerchangelistener) | 加速度数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [startAccelerometer](open-api/16-加速度计.md#startaccelerometer) | 开始监听加速度。 |
+| [stopAccelerometer](open-api/16-加速度计.md#stopaccelerometer) | 停止监听加速度。 |
+
+## iBeacon
+
+iBeacon 搜索和结果读取能力。
+
+| API | 说明 |
+| --- | --- |
+| [startBeaconDiscovery](open-api/17-ibeacon.md#startbeacondiscovery) | 开始搜索附近的 iBeacon。 |
+| [stopBeaconDiscovery](open-api/17-ibeacon.md#stopbeacondiscovery) | 停止搜索附近的 iBeacon。 |
+| [getBeacons](open-api/17-ibeacon.md#getbeacons) | 获取已搜索到的 iBeacon 列表。 |
+
+## 罗盘
+
+罗盘监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [CompassChangeListener](open-api/18-罗盘.md#compasschangelistener) | 罗盘数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [startCompass](open-api/18-罗盘.md#startcompass) | 开始监听罗盘。 |
+| [stopCompass](open-api/18-罗盘.md#stopcompass) | 停止监听罗盘。 |
+
+## 设备方向
+
+设备方向监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [DeviceMotionChangeListener](open-api/19-设备方向.md#devicemotionchangelistener) | 设备方向变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [startDeviceMotionListening](open-api/19-设备方向.md#startdevicemotionlistening) | 开始监听设备方向变化。 |
+| [stopDeviceMotionListening](open-api/19-设备方向.md#stopdevicemotionlistening) | 停止监听设备方向变化。 |
+
+## 陀螺仪
+
+陀螺仪监听能力。
+
+| API | 说明 |
+| --- | --- |
+| [GyroscopeChangeListener](open-api/20-陀螺仪.md#gyroscopechangelistener) | 陀螺仪数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [startGyroscope](open-api/20-陀螺仪.md#startgyroscope) | 开始监听陀螺仪。 |
+| [stopGyroscope](open-api/20-陀螺仪.md#stopgyroscope) | 停止监听陀螺仪。 |
+
+## 设备 / 网络
+
+网络类型和本机局域网 IP。
+
+| API | 说明 |
+| --- | --- |
+| [getLocalIPAddress](open-api/21-设备-网络.md#getlocalipaddress) | 获取局域网 IP 地址。 |
+| [getNetworkType](open-api/21-设备-网络.md#getnetworktype) | 获取当前网络类型。 |
+| [NetworkStatusChangeListener](open-api/21-设备-网络.md#networkstatuschangelistener) | 网络状态变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+
+## 短信
+
+拉起系统短信发送面板。
+
+| API | 说明 |
+| --- | --- |
+| [sendSms](open-api/22-短信.md#sendsms) | 拉起系统短信发送面板。 |
+
+## 无障碍
+
+检测无障碍能力开关状态。
+
+| API | 说明 |
+| --- | --- |
+| [checkIsOpenAccessibility](open-api/23-无障碍.md#checkisopenaccessibility) | 检测无障碍能力是否开启。 |
+
+## 基础信息
+
+设备品牌、型号、系统、内存和性能等级。
+
+| API | 说明 |
+| --- | --- |
+| [getDeviceInfo](open-api/24-基础信息.md#getdeviceinfo) | 获取设备基础信息。 |
+| [getDeviceInfoSync](open-api/24-基础信息.md#getdeviceinfosync) | 同步获取设备基础信息。<br><br>同步 API。 |
+
+## 电池
+
+电池信息读取与变化监听。
+
+| API | 说明 |
+| --- | --- |
+| [BatteryInfoChangeListener](open-api/25-电池.md#batteryinfochangelistener) | 电池信息变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [getBatteryInfo](open-api/25-电池.md#getbatteryinfo) | 获取电池信息。 |
+
+## 日历
+
+向系统日历添加事件和重复事件。
+
+| API | 说明 |
+| --- | --- |
+| [addPhoneCalendar](open-api/26-日历.md#addphonecalendar) | 向系统日历添加事件。 |
+| [addPhoneRepeatCalendar](open-api/26-日历.md#addphonerepeatcalendar) | 向系统日历添加重复事件。 |
+
+## 剪贴板
+
+读取和设置系统剪贴板内容。
+
+| API | 说明 |
+| --- | --- |
+| [getClipboardData](open-api/27-剪贴板.md#getclipboarddata) | 获取剪贴板内容。 |
+| [setClipboardData](open-api/27-剪贴板.md#setclipboarddata) | 设置系统剪贴板内容。 |
+
+## 联系人
+
+选择和添加手机联系人。
+
+| API | 说明 |
+| --- | --- |
+| [chooseContact](open-api/28-联系人.md#choosecontact) | 选择手机联系人。 |
+| [addPhoneContact](open-api/28-联系人.md#addphonecontact) | 添加手机联系人。 |
+
+## 加密
+
+安全随机数能力。
+
+| API | 说明 |
+| --- | --- |
+| [getRandomValues](open-api/29-加密.md#getrandomvalues) | 获取安全随机数。 |
+
+## 电话
+
+拨打电话。
+
+| API | 说明 |
+| --- | --- |
+| [makePhoneCall](open-api/30-电话.md#makephonecall) | 拨打电话。 |
+
+## 扫码
+
+调起扫码并读取扫码结果。
+
+| API | 说明 |
+| --- | --- |
+| [scanCode](open-api/31-扫码.md#scancode) | 调起扫码能力。 |
+
+## 屏幕
+
+屏幕亮度、常亮和截屏/录屏相关能力。
+
+| API | 说明 |
+| --- | --- |
+| [UserCaptureScreenListener](open-api/32-屏幕.md#usercapturescreenlistener) | 用户主动截屏事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [getScreenBrightness](open-api/32-屏幕.md#getscreenbrightness) | 获取屏幕亮度。 |
+| [setVisualEffectOnCapture](open-api/32-屏幕.md#setvisualeffectoncapture) | 设置截屏或录屏时的视觉表现。 |
+| [setScreenBrightness](open-api/32-屏幕.md#setscreenbrightness) | 设置屏幕亮度。 |
+| [setKeepScreenOn](open-api/32-屏幕.md#setkeepscreenon) | 设置屏幕常亮状态。 |
+
+## 震动
+
+触发短震动和长震动。
+
+| API | 说明 |
+| --- | --- |
+| [vibrateShort](open-api/33-震动.md#vibrateshort) | 触发短震动。 |
+| [vibrateLong](open-api/33-震动.md#vibratelong) | 触发长震动。 |
+
+## 文件系统
+
+文件读写、目录管理和文件信息操作。
+
+| API | 说明 |
+| --- | --- |
+| [getFileSystemManager](open-api/34-文件系统.md#getfilesystemmanager) | 获取文件系统管理器。 |

package/dist/skills/doubao-apps-dev/references/rules/dos-and-donts.md

@@ -27,7 +27,7 @@ npm install @doubao-apps/framework
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用'
 });
 ```
@@ -38,7 +38,7 @@ export default defineAppConfig({
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用',
   pages: [
     {
@@ -51,8 +51,8 @@ export default defineAppConfig({
 });
 ```
 
-一级页面目录不写进 `pages` 也会自动发现；如果首页不是历史默认的 `index`，或需要固定首页顺序，建议显式配置 `pages`
-数组第一项。
+一级页面目录不写进 `pages` 也会自动发现；如果首页不是默认入口 `index`，或需要固定首页顺序，建议显式配置
+`pages` 数组第一项。entry 必须写到 `index`，例如 `pages/home/index`。
 
 #### ✅ 需要补充展示信息时在 app.config.ts 定义 metadata
 ```ts
@@ -60,7 +60,7 @@ export default defineAppConfig({
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用',
   pages: [
     {
@@ -78,7 +78,7 @@ export default defineAppConfig({
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用',
   pages: [
     {
@@ -96,7 +96,7 @@ export default defineAppConfig({
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用',
   pages: [
     // 只声明入口、不补 metadata 时，可以直接写字符串
@@ -175,7 +175,7 @@ export default defineWidget({
 import { defineAppConfig } from '@doubao-apps/kit';
 
 export default defineAppConfig({
-  appId: 'com.example.my-doubao-app',
+  appId: 'db_xxxxxx',
   name: '我的豆包应用',
   widgets: [
     {
@@ -192,7 +192,8 @@ export default defineAppConfig({
 // ❌ 不好的做法
 export default defineWidget({
   render() {
-    const viewData = getViewData<any>();  // 使用 any 类型，失去类型检查
+    // 错误：类型和实际任务字段不匹配
+    const viewData = getViewData<{ title: string }>();
     return <view>{viewData.name}</view>;
   }
 });
@@ -247,7 +248,7 @@ export default defineWidget({
 // ❌ 不好的做法
 export default defineWidget({
   render() {
-    const viewData = getViewData<any>();
+    const viewData = getViewData<{ items?: string[] }>();
     // 没有检查 viewData.items 是否存在
     return (
       <view>
@@ -264,20 +265,24 @@ export default defineWidget({
 
 ### 样式相关
 
-#### ❌ 内联样式长度值必须带单位
+#### ❌ 不在 TSX 中写 style 对象
 
-Lynx CSS encoder 要求：**所有 CSS 长度值必须显式带单位**，裸数字（无单位）会触发运行时错误 `CSS length need units (except 0)`。
+样式统一写到 `index.scss`，TSX 中通过 `className` 切换状态。不要把 Web 写法里的内联 style 对象迁移过来。
 
 ```tsx
-// ❌ 错误：裸数字（无单位）
+// ❌ 错误：内联 style 对象
 <view style={{ width: 100, height: 56, fontSize: 14 }} />
 
-// ✅ 正确：带单位字符串
-<view style={{ width: '100px', height: '56px', fontSize: '14px' }} />
+// ✅ 正确：使用 className
+<view className="profile-card" />
+```
 
-// ✅ 例外：以下属性可以使用裸数字（无单位）
-// flex, opacity, zIndex, fontWeight, aspectRatio
-<view style={{ flex: 1, opacity: 0.5, zIndex: 10 }} />
+```scss
+.profile-card {
+  width: 100px;
+  height: 56px;
+  font-size: 14px;
+}
 ```
 
 #### ❌ 不写内联样式
@@ -314,11 +319,11 @@ export default definePage({
 #### ❌ 不在 render 中发起请求
 ```tsx
 // ❌ 错误 - 每次渲染都会发请求
+import { request } from '@doubao-apps/framework/api';
+
 export default definePage({
   render() {
-    fetch('/api/data').then(data => {
-      // 处理数据
-    });
+    void request({ url: 'https://api.example.com/data', method: 'GET' });
 
     return <view>内容</view>;
   }
@@ -328,18 +333,30 @@ export default definePage({
 ```tsx
 // ✅ 推荐 - 使用 Hook 管理请求和状态
 import { useEffect, useState } from '@doubao-apps/framework';
+import { request } from '@doubao-apps/framework/api';
 
 function UserPage() {
   const [userData, setUserData] = useState<{ name?: string } | null>(null);
+  const [error, setError] = useState('');
 
   useEffect(() => {
-    fetch('/api/data')
-      .then(res => res.json())
-      .then(data => {
-        setUserData(data);
-      });
+    const loadUser = async () => {
+      try {
+        setError('');
+        const response = await request({ url: 'https://api.example.com/data', method: 'GET' });
+        setUserData(response.data as { name?: string });
+      } catch (caughtError) {
+        setError(caughtError instanceof Error ? caughtError.message : '请求失败');
+      }
+    };
+
+    void loadUser();
   }, []);
 
+  if (error) {
+    return <view>{error}</view>;
+  }
+
   return <view>{userData?.name}</view>;
 }
 
@@ -398,7 +415,7 @@ export default definePage({
 // ❌ 错误
 export default defineWidget({
   render() {
-    const viewData = getViewData<any>();
+    const viewData = getViewData<{ name: string }>();
     // @ts-ignore
     return <view>{viewData.unknownProperty}</view>;
   }

package/dist/skills/h5-to-doubao/SKILL.md

@@ -37,9 +37,10 @@ description: Migrate H5 projects to Doubao Apps SDK (React Lynx). Supports stand
 | Agent 环境 | 知识库路径 |
 |------------|-----------|
 | Claude Code | `.claude/skills/doubao-apps-dev` |
-| 其他（Cursor 等） | `.agent/skills/doubao-apps-dev` |
+| Codex / Cursor / Cline / opencode | `.agents/skills/doubao-apps-dev` |
+| Antigravity | `.agent/skills/doubao-apps-dev` |
 
-通过 `npx @doubao-apps/ai skills add doubao-apps-dev --agent claude` 安装。
+通过 `npx @doubao-apps/ai skills add doubao-apps-dev --agent claude-code` 安装；其他 Agent 按 CLI 支持值替换 `--agent`。
 
 | 文档 | 路径 | 用途 |
 |------|------|------|
@@ -142,14 +143,17 @@ view {
 # Claude Code 优先
 ls .claude/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.claude/skills/doubao-apps-dev"
 
-# 其他 Agent（Cursor 等）
+# Codex / Cursor / Cline / opencode
+ls .agents/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.agents/skills/doubao-apps-dev"
+
+# Antigravity
 ls .agent/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.agent/skills/doubao-apps-dev"
 ```
 
 **2. 如未安装，执行安装**：
 
 ```bash
-npx @doubao-apps/ai skills add doubao-apps-dev --agent claude
+npx @doubao-apps/ai skills add doubao-apps-dev --agent claude-code
 ```
 
 **3. 初始化 Doubao Apps 目标项目**

package/dist/skills/weixin-to-doubao/SKILL.md

@@ -35,9 +35,10 @@ description: Migrate WeChat Mini Program (微信小程序) projects to Doubao Ap
 | Agent 环境 | 知识库路径 |
 |------------|-----------|
 | Claude Code | `.claude/skills/doubao-apps-dev` |
-| 其他（Cursor 等） | `.agent/skills/doubao-apps-dev` |
+| Codex / Cursor / Cline / opencode | `.agents/skills/doubao-apps-dev` |
+| Antigravity | `.agent/skills/doubao-apps-dev` |
 
-通过 `npx @doubao-apps/ai skills add doubao-apps-dev --agent claude` 安装。
+通过 `npx @doubao-apps/ai skills add doubao-apps-dev --agent claude-code` 安装；其他 Agent 按 CLI 支持值替换 `--agent`。
 
 | 文档 | 路径 | 用途 |
 |------|------|------|
@@ -80,14 +81,17 @@ description: Migrate WeChat Mini Program (微信小程序) projects to Doubao Ap
 # Claude Code 优先
 ls .claude/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.claude/skills/doubao-apps-dev"
 
-# 其他 Agent（Cursor 等）
+# Codex / Cursor / Cline / opencode
+ls .agents/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.agents/skills/doubao-apps-dev"
+
+# Antigravity
 ls .agent/skills/doubao-apps-dev/SKILL.md 2>/dev/null && echo "SKILLS_BASE=.agent/skills/doubao-apps-dev"
 ```
 
 **2. 如未安装，执行安装**：
 
 ```bash
-npx @doubao-apps/ai skills add doubao-apps-dev --agent claude
+npx @doubao-apps/ai skills add doubao-apps-dev --agent claude-code
 ```
 
 **3. 初始化 Doubao Apps 目标项目**

package/dist/skills/weixin-to-doubao/assets/migration-checklist-template.md

@@ -7,7 +7,7 @@
 ## 前置准备
 
 - [ ] 备份原始微信小程序项目
-- [ ] 安装 Doubao Apps 知识库：`npx @doubao-apps/ai --skills --agent claude`
+- [ ] 安装 Doubao Apps 知识库：`npx @doubao-apps/ai skills add doubao-apps-dev --agent claude`
 - [ ] 梳理项目页面列表（来自 `app.json` 的 `pages` 字段）
 - [ ] 梳理自定义组件列表
 - [ ] 识别所有 `wx.*` API 调用，标记无直接映射的 API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubao-apps/ai",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "description": "Doubao Apps SDK AI tools with context and skills management",
   "type": "module",
   "bin": {
@@ -17,8 +17,7 @@
       "types": "./dist/cli.d.ts"
     },
     "./manifest": "./dist/manifest.json",
-    "./skills/*": "./dist/skills/*",
-    "./contexts/*": "./dist/contexts/*"
+    "./skills/*": "./dist/skills/*"
   },
   "files": [
     "bin.js",