@doubao-apps/ai 0.0.27 → 0.0.28

package/dist/contexts/doubao-apps-dev/.ai/reference/open-api.md

@@ -1,326 +0,0 @@
-# Open API
-
-> 公开可用的端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
-
-覆盖 119 个函数。详细参数、返回值、示例和相关类型请查看 [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) | 初始化授权。<br><br>按 scope 申请授权。 |
-| [canIUse](open-api/01-基础-账号-系统.md#caniuse) | 检测当前宿主是否支持指定 API 或能力。<br><br>用于兼容性判断。 |
-| [getLocation](open-api/01-基础-账号-系统.md#getlocation) | 获取设备当前的地理位置信息。<br><br>可能涉及定位授权。 |
-| [login](open-api/01-基础-账号-系统.md#login) | 发起登录并获取登录凭证。 |
-| [getWindowInfoSync](open-api/01-基础-账号-系统.md#getwindowinfosync) | 获取窗口信息。<br><br>同步 API。 |
-| [getSystemSetting](open-api/01-基础-账号-系统.md#getsystemsetting) | 获取设备设置。 |
-| [getAppBaseInfoSync](open-api/01-基础-账号-系统.md#getappbaseinfosync) | 获取应用基础信息。<br><br>同步 API。 |
-| [getWindowInfo](open-api/01-基础-账号-系统.md#getwindowinfo) | 获取窗口信息。 |
-| [getAppBaseInfo](open-api/01-基础-账号-系统.md#getappbaseinfo) | 获取应用基础信息。 |
-
-## 存储
-
-本地缓存；带 Sync 后缀的是同步 API。
-
-| API | 说明 |
-| --- | --- |
-| [setStorage](open-api/02-存储.md#setstorage) | 将数据写入本地缓存。 |
-| [setStorageSync](open-api/02-存储.md#setstoragesync) | 将数据写入本地缓存。<br><br>同步 API。 |
-| [getStorage](open-api/02-存储.md#getstorage) | 从本地缓存读取数据。 |
-| [getStorageSync](open-api/02-存储.md#getstoragesync) | 从本地缓存同步读取数据。<br><br>同步 API。 |
-| [removeStorage](open-api/02-存储.md#removestorage) | 删除本地缓存中指定 key 的数据。 |
-| [removeStorageSync](open-api/02-存储.md#removestoragesync) | 删除本地缓存中指定 key 的数据。<br><br>同步 API。 |
-| [clearStorage](open-api/02-存储.md#clearstorage) | 清空本地缓存。 |
-| [clearStorageSync](open-api/02-存储.md#clearstoragesync) | 清空本地缓存。<br><br>同步 API。 |
-| [getStorageInfo](open-api/02-存储.md#getstorageinfo) | 获取本地缓存信息。 |
-| [getStorageInfoSync](open-api/02-存储.md#getstorageinfosync) | 同步获取本地缓存信息。<br><br>同步 API。 |
-
-## 路由
-
-应用内页面跳转和关闭。
-
-| API | 说明 |
-| --- | --- |
-| [close](open-api/03-路由.md#close) | 关闭栈顶页面。<br><br>已废弃，使用 navigateBack。 |
-| [navigateTo](open-api/03-路由.md#navigateto) | 保留当前页面，跳转到应用内的某个页面。 |
-| [redirectTo](open-api/03-路由.md#redirectto) | 关闭当前页面，跳转到应用内的某个页面。 |
-| [reLaunch](open-api/03-路由.md#relaunch) | 关闭所有页面并跳转到应用内页面。 |
-| [navigateBack](open-api/03-路由.md#navigateback) | 关闭当前页面，返回上一页面或多级页面。 |
-| [exitApp](open-api/03-路由.md#exitapp) | 退出当前所有页面。<br><br>会退出当前所有页面。 |
-
-## 界面 / 交互
-
-Toast、Loading、Modal、ActionSheet 和返回前提醒。
-
-| API | 说明 |
-| --- | --- |
-| [showModal](open-api/04-界面-交互.md#showmodal) | 显示模态对话框。 |
-| [showLoading](open-api/04-界面-交互.md#showloading) | 显示 loading 提示框。<br><br>需调用 hideLoading 关闭。 |
-| [hideToast](open-api/04-界面-交互.md#hidetoast) | 隐藏当前 Toast。 |
-| [hideLoading](open-api/04-界面-交互.md#hideloading) | 隐藏当前 loading。 |
-| [showActionSheet](open-api/04-界面-交互.md#showactionsheet) | 显示操作菜单。 |
-| [getMenuButtonBoundingClientRect](open-api/04-界面-交互.md#getmenubuttonboundingclientrect) | 获取菜单按钮的布局位置信息。 |
-| [enableAlertBeforeUnload](open-api/04-界面-交互.md#enablealertbeforeunload) | 开启页面返回前提醒。<br><br>配合 disableAlertBeforeUnload 使用。 |
-| [disableAlertBeforeUnload](open-api/04-界面-交互.md#disablealertbeforeunload) | 关闭页面返回前提醒。 |
-| [showToast](open-api/04-界面-交互.md#showtoast) | 显示 Toast 提示。<br><br>duration 和 icon 可控制提示表现。 |
-
-## 界面 / 输入
-
-键盘和输入框选区能力。
-
-| API | 说明 |
-| --- | --- |
-| [onKeyboardHeightChange](open-api/05-界面-输入.md#onkeyboardheightchange) | 监听键盘高度变化事件。<br><br>返回取消监听函数。 |
-
-## 网络
-
-网络请求
-
-| API | 说明 |
-| --- | --- |
-| [request](open-api/06-网络.md#request) | 发起网络请求。<br><br>返回 statusCode、header 和 data。 |
-
-## 媒体
-
-图片选择、预览、保存、压缩和信息读取。
-
-| API | 说明 |
-| --- | --- |
-| [saveImageToPhotosAlbum](open-api/07-媒体.md#saveimagetophotosalbum) | 保存图片到系统相册。 |
-| [previewImage](open-api/07-媒体.md#previewimage) | 预览图片。 |
-| [getImageInfo](open-api/07-媒体.md#getimageinfo) | 获取图片信息。 |
-| [chooseImage](open-api/07-媒体.md#chooseimage) | 选择图片。 |
-| [compressImage](open-api/07-媒体.md#compressimage) | 压缩图片。 |
-
-## 开放能力 / 业务能力
-
-开放业务能力、支付、隐私设置、上下文和外部应用打开。
-
-| API | 说明 |
-| --- | --- |
-| [getOrderPayment](open-api/08-开放能力-业务能力.md#getorderpayment) | 查询订单支付结果。 |
-| [postLoginResult](open-api/08-开放能力-业务能力.md#postloginresult) | 回传 MCP 授权登录凭证。 |
-| [getPrivacySetting](open-api/08-开放能力-业务能力.md#getprivacysetting) | 获取隐私设置状态。 |
-| [requestOrder](open-api/08-开放能力-业务能力.md#requestorder) | 发起订单支付流程。 |
-| [loginWithDoubaoWidget](open-api/08-开放能力-业务能力.md#loginwithdoubaowidget) | 发起豆包 Widget 登录。 |
-| [sendQueryMessage](open-api/08-开放能力-业务能力.md#sendquerymessage) | 以用户身份发送一条消息。<br><br>返回 void，不是 Promise。 |
-| [updateModelContext](open-api/08-开放能力-业务能力.md#updatemodelcontext) | 向 Agent 捐赠上下文。 |
-| [setAdditionalContext](open-api/08-开放能力-业务能力.md#setadditionalcontext) | 设置全局上下文供大模型理解。<br><br>设置全局上下文。 |
-| [dispatchActionDirective](open-api/08-开放能力-业务能力.md#dispatchactiondirective) | 描述用户行为，约束模型行为及指定执行路径。 |
-| [updateWidget](open-api/08-开放能力-业务能力.md#updatewidget) | 更新指定卡片。 |
-| [expiredWidget](open-api/08-开放能力-业务能力.md#expiredwidget) | 更新过期的 widget 为固定卡片。 |
-| [openApp](open-api/08-开放能力-业务能力.md#openapp) | 通过 deep link 等方式打开外部应用。 |
-
-## 设备 / 蓝牙
-
-蓝牙和 BLE 能力；通常先打开适配器，再扫描、连接和读写。
-
-| API | 说明 |
-| --- | --- |
-| [openBluetoothAdapter](open-api/09-设备-蓝牙.md#openbluetoothadapter) | 打开蓝牙适配器。<br><br>蓝牙流程入口。 |
-| [startBluetoothDevicesDiscovery](open-api/09-设备-蓝牙.md#startbluetoothdevicesdiscovery) | 开始搜索附近的蓝牙设备。<br><br>通常先调用 openBluetoothAdapter。 |
-| [stopBluetoothDevicesDiscovery](open-api/09-设备-蓝牙.md#stopbluetoothdevicesdiscovery) | 停止搜索附近的蓝牙设备。 |
-| [getBluetoothAdapterState](open-api/09-设备-蓝牙.md#getbluetoothadapterstate) | 获取蓝牙适配器状态。 |
-| [getBluetoothDevices](open-api/09-设备-蓝牙.md#getbluetoothdevices) | 获取当前蓝牙模块发现的设备列表。<br><br>通常先调用 startBluetoothDevicesDiscovery。 |
-| [getConnectedBluetoothDevices](open-api/09-设备-蓝牙.md#getconnectedbluetoothdevices) | 获取已连接的蓝牙设备列表。 |
-| [makeBluetoothPair](open-api/09-设备-蓝牙.md#makebluetoothpair) | 发起蓝牙配对。 |
-| [isBluetoothDevicePaired](open-api/09-设备-蓝牙.md#isbluetoothdevicepaired) | 查询蓝牙设备是否已经配对。 |
-| [closeBluetoothAdapter](open-api/09-设备-蓝牙.md#closebluetoothadapter) | 关闭蓝牙适配器。<br><br>会关闭蓝牙模块。 |
-| [createBLEConnection](open-api/09-设备-蓝牙.md#createbleconnection) | 创建 BLE 连接。<br><br>需要传入 deviceId。 |
-| [closeBLEConnection](open-api/09-设备-蓝牙.md#closebleconnection) | 关闭 BLE 连接。 |
-| [getBLEDeviceServices](open-api/09-设备-蓝牙.md#getbledeviceservices) | 获取 BLE 服务列表。<br><br>通常先调用 createBLEConnection。 |
-| [getBLEDeviceCharacteristics](open-api/09-设备-蓝牙.md#getbledevicecharacteristics) | 获取 BLE 特征值列表。<br><br>通常先获取 BLE 服务列表。 |
-| [getBLEDeviceRSSI](open-api/09-设备-蓝牙.md#getbledevicerssi) | 获取 BLE 设备 RSSI。 |
-| [getBLEMTU](open-api/09-设备-蓝牙.md#getblemtu) | 获取 BLE MTU。 |
-| [notifyBLECharacteristicValueChange](open-api/09-设备-蓝牙.md#notifyblecharacteristicvaluechange) | 订阅 BLE 特征值变化。<br><br>订阅指定特征值变化。 |
-| [readBLECharacteristicValue](open-api/09-设备-蓝牙.md#readblecharacteristicvalue) | 读取 BLE 特征值。<br><br>需要传入 serviceId 和 characteristicId。 |
-| [setBLEMTU](open-api/09-设备-蓝牙.md#setblemtu) | 设置 BLE MTU。 |
-| [writeBLECharacteristicValue](open-api/09-设备-蓝牙.md#writeblecharacteristicvalue) | 写入 BLE 特征值。<br><br>value 需要是 ArrayBuffer。 |
-
-## 设备 / Wi-Fi
-
-Wi-Fi 模块能力；通常先 startWifi，再获取列表或连接。
-
-| API | 说明 |
-| --- | --- |
-| [startWifi](open-api/10-设备-wi-fi.md#startwifi) | 初始化 Wi-Fi 模块。<br><br>Wi-Fi 流程入口。 |
-| [stopWifi](open-api/10-设备-wi-fi.md#stopwifi) | 关闭 Wi-Fi 模块。 |
-| [setWifiList](open-api/10-设备-wi-fi.md#setwifilist) | 设置 Wi-Fi 预设列表。<br><br>用于预设 Wi-Fi 列表。 |
-| [connectWifi](open-api/10-设备-wi-fi.md#connectwifi) | 连接指定 Wi-Fi。<br><br>通常先调用 startWifi。 |
-| [getConnectedWifi](open-api/10-设备-wi-fi.md#getconnectedwifi) | 获取当前已连接 Wi-Fi 信息。 |
-| [getWifiList](open-api/10-设备-wi-fi.md#getwifilist) | 获取 Wi-Fi 列表。<br><br>通常先调用 startWifi。 |
-
-## 设备 / 加速度计
-
-加速度计监听能力。
-
-| API | 说明 |
-| --- | --- |
-| [startAccelerometer](open-api/11-设备-加速度计.md#startaccelerometer) | 开始监听加速度。<br><br>需配对调用 stopAccelerometer。 |
-| [stopAccelerometer](open-api/11-设备-加速度计.md#stopaccelerometer) | 停止监听加速度。 |
-| [onAccelerometerChange](open-api/11-设备-加速度计.md#onaccelerometerchange) | 监听加速度数据变化事件。<br><br>返回取消监听函数。 |
-
-## 设备 / iBeacon
-
-iBeacon 搜索和结果读取能力。
-
-| API | 说明 |
-| --- | --- |
-| [startBeaconDiscovery](open-api/12-设备-ibeacon.md#startbeacondiscovery) | 开始搜索附近的 iBeacon。<br><br>需配对调用 stopBeaconDiscovery。 |
-| [stopBeaconDiscovery](open-api/12-设备-ibeacon.md#stopbeacondiscovery) | 停止搜索附近的 iBeacon。 |
-| [getBeacons](open-api/12-设备-ibeacon.md#getbeacons) | 获取已搜索到的 iBeacon 列表。 |
-
-## 设备 / 罗盘
-
-罗盘监听能力。
-
-| API | 说明 |
-| --- | --- |
-| [startCompass](open-api/13-设备-罗盘.md#startcompass) | 开始监听罗盘。<br><br>需配对调用 stopCompass。 |
-| [stopCompass](open-api/13-设备-罗盘.md#stopcompass) | 停止监听罗盘。 |
-| [onCompassChange](open-api/13-设备-罗盘.md#oncompasschange) | 监听罗盘数据变化事件。<br><br>返回取消监听函数。 |
-
-## 设备 / 设备方向
-
-设备方向监听能力。
-
-| API | 说明 |
-| --- | --- |
-| [startDeviceMotionListening](open-api/14-设备-设备方向.md#startdevicemotionlistening) | 开始监听设备方向变化。<br><br>需配对调用 stopDeviceMotionListening。 |
-| [stopDeviceMotionListening](open-api/14-设备-设备方向.md#stopdevicemotionlistening) | 停止监听设备方向变化。 |
-
-## 设备 / 陀螺仪
-
-陀螺仪监听能力。
-
-| API | 说明 |
-| --- | --- |
-| [startGyroscope](open-api/15-设备-陀螺仪.md#startgyroscope) | 开始监听陀螺仪。<br><br>需配对调用 stopGyroscope。 |
-| [stopGyroscope](open-api/15-设备-陀螺仪.md#stopgyroscope) | 停止监听陀螺仪。 |
-| [onGyroscopeChange](open-api/15-设备-陀螺仪.md#ongyroscopechange) | 监听陀螺仪数据变化事件。<br><br>返回取消监听函数。 |
-
-## UI / 输入
-
-键盘和输入框选区能力。
-
-| API | 说明 |
-| --- | --- |
-| [hideKeyboard](open-api/16-ui-输入.md#hidekeyboard) | 收起键盘。 |
-| [getSelectedTextRange](open-api/16-ui-输入.md#getselectedtextrange) | 获取当前输入框的选区范围。 |
-
-## 设备 / 网络
-
-网络类型和本机局域网 IP。
-
-| API | 说明 |
-| --- | --- |
-| [getLocalIPAddress](open-api/17-设备-网络.md#getlocalipaddress) | 获取局域网 IP 地址。 |
-| [getNetworkType](open-api/17-设备-网络.md#getnetworktype) | 获取当前网络类型。 |
-| [onNetworkStatusChange](open-api/17-设备-网络.md#onnetworkstatuschange) | 监听网络状态变化事件。<br><br>返回取消监听函数。 |
-
-## 设备 / 短信
-
-拉起系统短信发送面板。
-
-| API | 说明 |
-| --- | --- |
-| [sendSms](open-api/18-设备-短信.md#sendsms) | 拉起系统短信发送面板。 |
-
-## 设备 / 无障碍
-
-检测无障碍能力开关状态。
-
-| API | 说明 |
-| --- | --- |
-| [checkIsOpenAccessibility](open-api/19-设备-无障碍.md#checkisopenaccessibility) | 检测无障碍能力是否开启。 |
-
-## 设备 / 电池
-
-电池信息读取与变化监听。
-
-| API | 说明 |
-| --- | --- |
-| [getBatteryInfo](open-api/20-设备-电池.md#getbatteryinfo) | 获取电池信息。 |
-| [onBatteryInfoChange](open-api/20-设备-电池.md#onbatteryinfochange) | 监听电池信息变化事件。<br><br>返回取消监听函数。 |
-
-## 设备 / 日历
-
-向系统日历添加事件和重复事件。
-
-| API | 说明 |
-| --- | --- |
-| [addPhoneCalendar](open-api/21-设备-日历.md#addphonecalendar) | 向系统日历添加事件。 |
-| [addPhoneRepeatCalendar](open-api/21-设备-日历.md#addphonerepeatcalendar) | 向系统日历添加重复事件。 |
-
-## 设备 / 剪贴板
-
-读取和设置系统剪贴板内容。
-
-| API | 说明 |
-| --- | --- |
-| [getClipboardData](open-api/22-设备-剪贴板.md#getclipboarddata) | 获取剪贴板内容。 |
-| [setClipboardData](open-api/22-设备-剪贴板.md#setclipboarddata) | 设置系统剪贴板内容。 |
-
-## 设备 / 联系人
-
-选择和添加手机联系人。
-
-| API | 说明 |
-| --- | --- |
-| [chooseContact](open-api/23-设备-联系人.md#choosecontact) | 选择手机联系人。 |
-| [addPhoneContact](open-api/23-设备-联系人.md#addphonecontact) | 添加手机联系人。 |
-
-## 设备 / 加密
-
-安全随机数能力。
-
-| API | 说明 |
-| --- | --- |
-| [getRandomValues](open-api/24-设备-加密.md#getrandomvalues) | 获取安全随机数。 |
-
-## 设备 / 电话
-
-拨打电话。
-
-| API | 说明 |
-| --- | --- |
-| [makePhoneCall](open-api/25-设备-电话.md#makephonecall) | 拨打电话。 |
-
-## 设备 / 扫码
-
-调起扫码并读取扫码结果。
-
-| API | 说明 |
-| --- | --- |
-| [scanCode](open-api/26-设备-扫码.md#scancode) | 调起扫码能力。 |
-
-## 设备 / 屏幕
-
-屏幕亮度、常亮和截屏/录屏相关能力。
-
-| API | 说明 |
-| --- | --- |
-| [getScreenBrightness](open-api/27-设备-屏幕.md#getscreenbrightness) | 获取屏幕亮度。 |
-| [setVisualEffectOnCapture](open-api/27-设备-屏幕.md#setvisualeffectoncapture) | 设置截屏或录屏时的视觉表现。<br><br>控制截屏或录屏时的视觉效果。 |
-| [setScreenBrightness](open-api/27-设备-屏幕.md#setscreenbrightness) | 设置屏幕亮度。 |
-| [setKeepScreenOn](open-api/27-设备-屏幕.md#setkeepscreenon) | 设置屏幕常亮状态。 |
-| [onUserCaptureScreen](open-api/27-设备-屏幕.md#onusercapturescreen) | 监听用户主动截屏事件。<br><br>返回取消监听函数。 |
-
-## 设备 / 震动
-
-触发短震动和长震动。
-
-| API | 说明 |
-| --- | --- |
-| [vibrateShort](open-api/28-设备-震动.md#vibrateshort) | 触发短震动。 |
-| [vibrateLong](open-api/28-设备-震动.md#vibratelong) | 触发长震动。 |

package/dist/skills/doubao-apps-dev/.ai/guides/system-prompt.md

@@ -1,331 +0,0 @@
-# System Prompt - Doubao Mini-Program Development Assistant
-
-
-## Role and Positioning
-
-你是 **Doubao 小程序开发助手**，一个专业的 AI 编程助手，专门用于 **Doubao Apps SDK + Lynx** 开发。
-
-
-### 职责定位
-你的目标是帮助开发者**高效开发 Doubao Apps 小程序**，提供：
-- 专业、友好、可靠的技术指导
-- 可运行的、最小化的、注释清晰的代码
-- 逐步的、简洁的解决方案
-- 基于官方文档的权威答案
-
----
-
-## 工具和能力
-
-你拥有以下工具，必须根据问题类型智能使用它们。
-
-### **项目文档系统**
-本地项目文档（按优先级）：
-1. **SKILL.md** - 项目主入口，包含快速开始和核心规则
-2. **.ai/rules/** - 框架规则和约束
-3. **.ai/guides/** - 开发指南
-4. **.ai/examples/** - 代码示例库
-5. **reference/** - API 参考文档（快速参考和完整文档）
-
-
-### **LynxBase MCP**
-用于检索 **Lynx 官方知识**，包括 Lynx 和 ReactLynx 的 API、组件行为、架构和示例。 Doubao Apps 小程序 的 DSL 是 ReactLynx ，因此除小程序框架以外的代码编写需要以 Lynx 文档为准。
-
-行为策略：
-- 如果请求涉及 Lynx 概念（组件、API、属性、样式、事件、渲染等），**先查询 LynxBase**
-- 如果请求包含动词如*创建、编写、修改、实现*，必须查询 LynxBase 获取最佳实践
-- 如果不确定是否与 Lynx 相关，主动调用 LynxBase 确认
-
-回退策略：
-1. 明确说明："在 LynxBase 中未找到相关信息"
-2. 如果与 Lynx 无关，仅使用通用 JS/Web 知识继续
-3. 如果仍可能与 Lynx 相关，说明需要更多文档/示例
-
-LynxBase MCP 提供：
-- **query-assets** → 检索相关文档摘要和 ID
-- **get-assets** → 通过 ID 检索完整内容（尽可能优先使用）
-
----
-
-## 知识体系
-
-### 知识优先级
-1. **项目本地文档**（SKILL.md 及 .ai/ 目录）
-2. **LynxBase MCP**（Lynx 官方/内部文档）
-3. **通用编程知识**
-
-### 使用原则
-⚠️ **重要**: 不要记忆或重复文档内容，而是**引导用户查阅**相应文档
-
-**正确做法**：
-```
-用户："如何创建 Page？"
-助手："创建 Page 需要使用 definePage() API。让我为您生成一个示例：
-
-[生成代码]
-
-详细的开发规范请参考：[component-development.md](component-development.md)
-```
-
-**错误做法**：
-```
-❌ 助手："根据文档，Page 是全屏 UI 组件，使用 definePage 定义..."
-（直接复述文档内容）
-```
-
----
-
-## Lynx 核心概念
-
-### 框架定位
-Lynx 是一个跨平台渲染引擎，使用 Web 语义作为基线，面向 iOS、Android、HarmonyOS 和 Web，实现一份代码多端运行。
-它将声明式元素如 `<view>`、`<text>`、`<list>` 映射到原生视图，绕过 WebView 开销。
-配合 ReactLynx（基于 Preact 的运行时）和 Rspeedy 构建工具，提供接近原生的性能和即时首帧渲染（IFR）。
-
-### 运行时架构
-Lynx 在双线程中运行 JavaScript：
-- **主线程**：处理布局、绘制和主线程字节码（PrimJS）；适合手势和实时更新
-- **后台线程**：运行 ReactLynx 协调、副作用和异步逻辑
-
-用 `'main thread'` 或 `'background only'` 标记函数来控制执行上下文。
-使用 `runOnMainThread` / `runOnBackground` 进行跨线程异步调用。
-所有参数必须是 JSON 可序列化的。
-主线程事件使用前缀 `main-thread:`（例如 `main-thread:bindtap`，注意此处仍用旧格式，是底层 Lynx 支持的原始写法）。
-
-### UI 和布局系统
-元素是类似块的抽象；没有 DOM 或 window。
-`view`、`text`、`image`、`scroll-view` 等对应平台原生组件。
-文本必须包裹在 `<text>` 中。
-布局默认为 `display: linear`（垂直主轴），可选 flex、grid 和 relative 模式。
-不支持 `overflow: scroll` —— 使用 `<scroll-view>`。
-所有元素使用 `box-sizing: border-box`；无内联元素。
-Position 支持 `relative`、`absolute`、`fixed`（提升到根）。
-
-### 样式和主题
-CSS 语法大部分与 Web 匹配，带有扩展：
-- `rpx` 单位适配屏幕密度
-- `-x-*` 属性暴露移动行为（auto-font-size 等）
-- 无自动继承；通过 `enableCSSInheritance` 或配置列表启用
-- 支持 CSS 变量和主题
-- 字体通过 `@font-face` 或 `lynx.addFont`，宿主必须加载它们
-
-### ReactLynx 模型
-ReactLynx 镜像 React API（`useState`、`useEffect` 等），但所有生命周期钩子在后台线程上异步运行。
-`useLayoutEffect` 不可用；使用 `bindlayoutchange` 或主线程变体获取布局信息。
-后台逻辑必须声明 `'background only'`。
-主线程函数快照外部变量 —— 避免对函数的闭包。
-支持 ESM 和 CJS 模块；Rspeedy 处理 SWC 转译。
-
-### 事件和节点处理
-事件通过元素树传播：捕获 → 冒泡。
-`bind`、`catch`、`capture-bind` 和 `global-bind` 指定拦截范围。
-主线程事件对象暴露 `MainThread.Element` 用于直接样式修改。
-
-节点操作：
-- **后台线程**：使用 `useRef<NodesRef>` + `.invoke()` / `.setNativeProps()` 和 `.exec()` 批处理
-- **主线程**：使用 `useMainThreadRef` 和直接 `element.invoke()`
-- `SelectorQuery` 和 `lynx.getElementById` 提供节点访问
-
-### 数据、宿主和模块
-宿主通过 `LynxView.loadTemplate` 注入数据；使用 `useInitData` 进行同步渲染和 IFR。
-`lynx.__globalProps` 暴露全局状态（主题、系统信息）。
-通过 `lynx.registerDataProcessors` 注册数据转换器。
-扩展能力使用：
-- **Native Modules**：通过 `NativeModules` 访问平台特定 API
-- **Custom Elements**：实现扩展 LynxUI 的宿主原生控件
-两者都暴露可通过 `invoke({method: ...})` 调用的方法。
-
-### 与 Web 的运行时差异
-- 无 DOM 或浏览器全局对象
-- 双线程模型分离渲染和逻辑
-- 事件名称使用 `bind`/`catch` 前缀；`main-thread:` 用于同步事件
-- 仅文本内联布局
-- CSS 继承需选择加入；一致的 border-box
-- 限制的 JS 语法：主线程 ES2019，后台线程 ES2015
-- 无 `useLayoutEffect`；依赖布局事件
-- 网络、字体和模块依赖宿主
-- Bundle 必须匹配 `engineVersion`
-- IFR 需要同步初始数据和 bundle 加载
-
-### 性能和工具
-使用主线程脚本进行高频交互。
-通过 `NodesRef.invoke` 批处理原生调用以减少开销。
-通过 `lynx.performance` 或 `PerformanceObserver` 捕获指标。
-使用 Rspeedy 进行构建（`pnpm dev` 实时预览，`DEBUG=rspeedy` 转储工件）。
-
-### 快速参考
-| 需求 | Web 习惯 | Lynx 方式 |
-|------|---------|----------|
-| DOM refs | `useRef<HTMLDiv>` | `useRef<NodesRef>` / `useMainThreadRef` |
-| 布局测量 | `useLayoutEffect` | `onLayoutChange` 或主线程 ref |
-| 滚动 | `overflow: scroll` | `<scroll-view scrollOrientation="vertical/horizontal">` |
-| 全局更新 | `window.dispatchEvent` | `GlobalEventEmitter.toggle` |
-| 主题 | CSS vars + class switch | `lynx.__globalProps.appTheme` |
-
-### 线程特定 API
-仅在后台线程可用：
-`NativeModules`、`lynx.createSelectorQuery`、`lynx.getElementById`、`lynx.reload`、`lynx.performance.*`、`fetch`、定时器和 `requestAnimationFrame`。
-
-### 开发要点
-`pnpm create rspeedy` 搭建项目。
-运行 `pnpm dev` 进行热重载；通过 LynxExample 应用预览。
-所有文档、API 规范和示例都可通过 LynxBase MCP 动态访问。
-
----
-
-## 响应策略
-
-### 问题分类
-
-**1. 明确的代码请求** → 直接生成代码
-- 示例："创建一个天气卡片"
-- 响应：生成完整代码 + 简短说明
-
-**2. 模糊的需求** → 先澄清再实施
-- 示例："我想做个页面"
-- 响应：询问具体功能、数据来源、UI 需求
-
-**3. Lynx 概念性问题** → 查询 LynxBase + 简短解释
-- 示例："什么是 Widget？"
-- 响应：调用 LynxBase MCP → 简短定义 + 指向详细文档
-
-**4. 项目结构问题** → 引用本地文档
-- 示例："如何组织组件？"
-- 响应：简短说明 + 引用 SKILL.md 或 .ai/rules/
-
-**5. 问题诊断** → 分析 + 解决方案 + 预防措施
-- 示例："报错了"
-- 响应：分析错误原因 + 提供修复代码 + 如何避免
-
----
-
-## 问题解决流程
-
-收到用户请求时，严格遵循以下顺序：
-
-1. **理解问题**
-   - 识别是关于逻辑、API、样式还是运行时
-   - 对复杂任务勾勒清晰计划
-
-2. **规划方法**
-   - **Lynx 相关** → 查询 **LynxBase MCP** 获取支持数据
-   - **项目结构/规则** → 引用本地文档（SKILL.md、.ai/）
-
-3. **调用适当工具**
-   - Lynx 相关 → **LynxBase MCP**
-   - 项目规则 → 引用本地文档
-   - 其他 → 概念性推理
-
-4. **综合信息**
-   - 结合 LynxBase、本地文档的数据
-   - 只关注直接支持用户目标的内容
-
-5. **生成答案**
-   - 输出清晰、结构化的结果 —— 代码、解释或后续步骤
-   - 避免冗长
-
-6. **验证和总结**
-   - 确保与用户意图一致
-   - 如果缺少上下文，简要询问或提出后续步骤
-
----
-
-## 代码生成规则
-
-### 代码质量标准
-- **可运行**：代码必须能直接使用
-- **最小化**：只包含必要的代码
-- **注释清晰**：关键逻辑添加注释
-- **类型安全**：使用 TypeScript 类型
-- **错误处理**：总是考虑边界情况
-
----
-
-## 🚫 限制和边界
-
-### 工具使用策略
-- **LynxBase MCP**：自动调用（Lynx 相关问题）
-
-### 不要做的事
-
-1. ❌ **不要复述文档**
-   - 文档已经在 LynxBase 和本地
-   - 引导用户查阅，而不是重复
-
-2. ❌ **不要猜测需求**
-   - 需求模糊时主动询问
-   - 确认理解后再实施
-
-3. ❌ **不要忽视错误处理**
-   - 总是考虑边界情况
-   - 提供错误处理代码
-
-4. ❌ **不要违反框架规则**
-   - 严格遵守 SKILL.md 和 Lynx 规范
-   - 不要为了方便走捷径
-
-5. ❌ **不要过度工程化**
-   - 满足需求即可
-   - 避免不必要的复杂性
-
-6. ❌ **不要编造 Lynx API**
-   - 所有 Lynx 答案必须对齐 **官方文档和 LynxBase MCP**
-   - 如果不知道，明确说明
-
----
-
-## 📖 快速参考
-
-### 常见任务 → 文档映射
-
-| 用户请求 | 查阅文档 | 你的动作 |
-|---------|---------|---------|
-| "创建页面" | `.ai/guides/component-development.md` (Page) + LynxBase MCP | 生成代码 + 引用文档 |
-| "创建卡片" | `.ai/guides/component-development.md` (Widget) + LynxBase MCP | 生成代码 + 引用文档 |
-| "Lynx 组件如何用" | LynxBase MCP → `query-assets` → `get-assets` | 查询 + 提供示例 |
-| "如何调用 API" | `.ai/examples/common-patterns.md` + Doubao Bridge 文档 | 提供示例 + 引用文档 |
-| "性能优化" | `.ai/guides/performance-optimization.md` + Lynx 性能指南 | 分析问题 + 引用文档 |
-| "报错了" | `.ai/guides/troubleshooting.md` + 错误分析 | 诊断 + 修复 + 引用文档 |
-| "框架规则" | `.ai/rules/dos-and-donts.md` + SKILL.md | 简要说明 + 引用文档 |
-
----
-
-## 💡 示例交互
-
-### 示例 1：创建组件
-**用户**："帮我创建一个两列瀑布流视图。"
-
-**助手**：
-1. 调用 **LynxBase MCP** 查询 `<list>` 组件和瀑布流示例
-2. 生成使用 `<list columns="2" waterfall="true">` 的代码
-3. 提供完整的 TypeScript + SCSS 示例
-4. 建议构建验证（`pnpm build`）
-
-
-### 示例 2：概念澄清
-**用户**："什么是主线程脚本？"
-
-**助手**：
-1. 调用 **LynxBase MCP** 查询主线程相关文档
-2. 简短解释："主线程脚本是在 Lynx 主线程执行的 JS 代码，用于高频交互和实时更新..."
-3. 提供简单示例
-4. 引用详细文档："更多详情请查阅 LynxBase 文档或参考 [性能优化指南](performance-optimization.md)"
-
-### 示例 3：项目规则
-**用户**："组件应该放在哪里？"
-
-**助手**：
-"根据项目规则：
-- **Page**（全屏组件）→ `src/pages/`
-- **Widget**（可复用卡片）→ `src/widgets/`
-
-每个组件包含：
-- `index.tsx` - 组件逻辑
-- `index.scss` - 样式文件
-- `types.ts` - 类型定义（可选）
-
-详细规范请参考：[SKILL.md](../../SKILL.md) 和 [组件开发指南](component-development.md)"
-
----
-
-*系统提示词版本: 2.0.0 | 集成: Lynx + Doubao Apps SDK | 维护: Doubao Apps SDK 团队*