@doubao-apps/ai 0.0.35-rc.0 → 0.0.35

package/dist/{skills → public/skills}/doubao-apps-dev/references/reference/open-api/32-/345/261/217/345/271/225.md

@@ -8,33 +8,14 @@
 
 | API | 说明 |
 | --- | --- |
-| [UserCaptureScreenListener](#usercapturescreenlistener) | 用户主动截屏事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [getScreenBrightness](#getscreenbrightness) | 获取屏幕亮度。 |
 | [setVisualEffectOnCapture](#setvisualeffectoncapture) | 设置截屏或录屏时的视觉表现。 |
 | [setScreenBrightness](#setscreenbrightness) | 设置屏幕亮度。 |
 | [setKeepScreenOn](#setkeepscreenon) | 设置屏幕常亮状态。 |
+| [onUserCaptureScreen](#onusercapturescreen) | 监听用户主动截屏事件。 |
 
 ## API 详情
 
-<a id="usercapturescreenlistener"></a>
-### UserCaptureScreenListener()
-
-用户主动截屏事件监听函数。
-
-## 代码示例
-
-```typescript
-// 暂无代码示例
-```
-
-## 入参
-
-无入参。
-
-## 返回值
-
-返回 `void`。
-
 <a id="getscreenbrightness"></a>
 ### getScreenBrightness()
 
@@ -75,6 +56,10 @@ import { setVisualEffectOnCapture } from '@doubao-apps/framework/api';
 await setVisualEffectOnCapture({ visualEffect: 'hidden' });
 ```
 
+## 注意事项
+
+控制截屏或录屏时的视觉效果。
+
 ## 入参
 
 |参数名|类型|必填|说明|
@@ -134,3 +119,58 @@ await setKeepScreenOn({ keepScreenOn: true });
 ## 返回值
 
 返回 `Promise<object>`。
+
+<a id="onusercapturescreen"></a>
+### onUserCaptureScreen()
+
+监听用户主动截屏事件。
+
+## 代码示例
+
+```ts
+import { onUserCaptureScreen } from '@doubao-apps/framework/api';
+
+const off = onUserCaptureScreen(() => {
+  console.log('用户截屏了');
+});
+
+off();
+```
+
+## 入参
+
+|参数名|类型|必填|说明|
+|---|---|---|---|
+|handler|`Function`|是|-|
+|handler.event|`UserCaptureScreenEvent`|是|-|
+
+## 返回值
+
+返回取消当前监听函数的函数。
+
+## 相关类型
+
+<a id="getscreenbrightnessresult"></a>
+### GetScreenBrightnessResult
+
+#### Properties
+
+• **value**: `number` - 屏幕亮度值，范围 0 ~ 1，0 最暗，1 最亮
+
+<a id="capturevisualeffect"></a>
+### CaptureVisualEffect
+
+录屏或截屏时的视觉表现。
+
+#### Type
+
+`'none' | 'hidden'`
+
+<a id="usercapturescreenevent"></a>
+### UserCaptureScreenEvent
+
+用户主动截屏事件。
+
+#### Properties
+
+无字段。

package/dist/{skills → public/skills}/doubao-apps-dev/references/reference/open-api/33-/351/234/207/345/212/250.md

@@ -60,3 +60,14 @@ await vibrateLong();
 ## 返回值
 
 返回 `Promise<object>`。
+
+## 相关类型
+
+<a id="vibrateshorttype"></a>
+### VibrateShortType
+
+短震动类型。
+
+#### Type
+
+`'heavy' | 'medium' | 'light'`

package/dist/public/skills/doubao-apps-dev/references/reference/open-api/34-/346/226/207/344/273/266/347/263/273/347/273/237.md

@@ -0,0 +1,334 @@
+# Open API: 文件系统
+
+文件读写、目录管理和文件信息操作。
+
+[返回目录](./README.md) | [返回速查](../open-api.md)
+
+## 速查
+
+| API | 说明 |
+| --- | --- |
+| [getFileSystemManager](#getfilesystemmanager) | 获取文件系统管理器。 |
+
+## API 详情
+
+<a id="getfilesystemmanager"></a>
+### getFileSystemManager()
+
+获取文件系统管理器。
+
+## 代码示例
+
+```typescript
+import { getFileSystemManager } from '@doubao-apps/framework/api';
+
+const fs = getFileSystemManager();
+const { data } = await fs.readFile({
+  filePath: '/tmp/profile.json',
+  encoding: 'utf-8'
+});
+
+console.log(data);
+```
+
+## 入参
+
+无入参。
+
+## 返回值
+
+返回 `FileSystemManager`。
+
+|字段名|类型|说明|
+|---|---|---|
+|access|`(params: AccessParams) => Promise<void>`|-|
+|accessSync|`(params: AccessParams) => void`|-|
+|appendFile|`(params: AppendFileParams) => Promise<void>`|-|
+|appendFileSync|`(params: AppendFileParams) => void`|-|
+|copyFile|`(params: CopyFileParams) => Promise<void>`|-|
+|copyFileSync|`(params: CopyFileParams) => void`|-|
+|getFileInfo|`(params: GetFileInfoParams) => Promise<GetFileInfoResult>`|-|
+|getSavedFileList|`() => Promise<GetSavedFileListResult>`|-|
+|mkdir|`(params: MkdirParams) => Promise<void>`|-|
+|mkdirSync|`(params: MkdirParams) => void`|-|
+|readdir|`(params: ReaddirParams) => Promise<ReaddirResult>`|-|
+|readdirSync|`(params: ReaddirParams) => ReaddirResult`|-|
+|readFile|`(params: ReadFileParams) => Promise<ReadFileResult>`|-|
+|readFileSync|`(params: ReadFileParams) => ReadFileResult`|-|
+|removeSavedFile|`(params: RemoveSavedFileParams) => Promise<void>`|-|
+|rename|`(params: RenameParams) => Promise<void>`|-|
+|renameSync|`(params: RenameParams) => void`|-|
+|rmdir|`(params: RmdirParams) => Promise<void>`|-|
+|rmdirSync|`(params: RmdirParams) => void`|-|
+|saveFile|`(params: SaveFileParams) => Promise<SaveFileResult>`|-|
+|saveFileSync|`(params: SaveFileParams) => SaveFileResult`|-|
+|stat|`(params: StatParams) => Promise<StatResult>`|-|
+|statSync|`(params: StatParams) => StatResult`|-|
+|truncate|`(params: TruncateParams) => Promise<void>`|-|
+|truncateSync|`(params: TruncateParams) => void`|-|
+|unlink|`(params: UnlinkParams) => Promise<void>`|-|
+|unlinkSync|`(params: UnlinkParams) => void`|-|
+|unzip|`(params: UnzipParams) => Promise<void>`|-|
+|writeFile|`(params: WriteFileParams) => Promise<void>`|-|
+|writeFileSync|`(params: WriteFileParams) => void`|-|
+
+## 相关类型
+
+<a id="readfileparams"></a>
+### ReadFileParams
+
+FileSystemManager.readFile 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要读取的文件路径（本地路径）
+• **encoding?**: `'utf-8' | 'base64'` - 指定读取文件的字符编码。 - 'utf-8'：以 UTF-8 字符串形式返回文件内容。 - 'base64'：以 Base64 编码字符串形式返回文件内容，适用于二进制文件
+
+<a id="readfileresult"></a>
+### ReadFileResult
+
+FileSystemManager.readFile 的返回结果。
+
+#### Properties
+
+• **data**: `string` - 文件内容。 具体格式由 ReadFileParams.encoding 决定： - 编码为 'utf-8' 时返回 UTF-8 字符串； - 编码为 'base64' 时返回 Base64 编码后的字符串
+
+<a id="writefileparams"></a>
+### WriteFileParams
+
+FileSystemManager.writeFile 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要写入的文件路径（本地路径）
+• **data**: `string` - 要写入的内容。 - 当 encoding 为 'utf-8' 时，直接写入该字符串； - 当 encoding 为 'base64' 时，将该字符串先进行 Base64 解码再写入文件
+• **encoding?**: `'utf-8' | 'base64'` - 指定写入文件的字符编码
+
+<a id="appendfileparams"></a>
+### AppendFileParams
+
+FileSystemManager.appendFile 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要追加内容的文件路径（本地路径）
+• **data**: `string` - 要追加的内容。 - 当 encoding 为 'utf-8' 时，直接追加该字符串； - 当 encoding 为 'base64' 时，将该字符串先进行 Base64 解码再追加到文件末尾
+• **encoding?**: `'utf-8' | 'base64'` - 指定写入文件的字符编码
+
+<a id="accessparams"></a>
+### AccessParams
+
+FileSystemManager.access 的参数。
+
+#### Properties
+
+• **path**: `string` - 要判断是否存在的文件或目录路径
+
+<a id="mkdirparams"></a>
+### MkdirParams
+
+FileSystemManager.mkdir 的参数。
+
+#### Properties
+
+• **dirPath**: `string` - 要创建的目录路径
+• **recursive?**: `boolean` - 是否递归创建该目录的上级目录。 设为 true 时，即使中间路径不存在也会一并创建（类似 mkdir -p）
+
+<a id="rmdirparams"></a>
+### RmdirParams
+
+FileSystemManager.rmdir 的参数。
+
+#### Properties
+
+• **dirPath**: `string` - 要删除的目录路径
+• **recursive?**: `boolean` - 是否递归删除目录下的所有子文件和子目录。 设为 false 时，仅当目录为空才能删除成功；设为 true 时会递归删除所有内容
+
+<a id="readdirparams"></a>
+### ReaddirParams
+
+FileSystemManager.readdir 的参数。
+
+#### Properties
+
+• **dirPath**: `string` - 要读取的目录路径
+
+<a id="readdirresult"></a>
+### ReaddirResult
+
+FileSystemManager.readdir 的返回结果。
+
+#### Properties
+
+• **files**: `string[]` - 目录下的文件和子目录名称列表（不含 . 和 ..）
+
+<a id="unlinkparams"></a>
+### UnlinkParams
+
+FileSystemManager.unlink 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要删除的文件路径。 该接口只能删除文件，不能删除目录；删除目录应使用 FileSystemManager.rmdir
+
+<a id="statparams"></a>
+### StatParams
+
+FileSystemManager.stat 的参数。
+
+#### Properties
+
+• **path**: `string` - 要获取状态信息的文件或目录路径
+
+<a id="statresult"></a>
+### StatResult
+
+FileSystemManager.stat 的返回结果。
+
+#### Properties
+
+• **size**: `number` - 文件大小，单位为字节（Byte）
+• **lastModifiedTime**: `number` - 文件最近一次被修改的时间戳，单位为毫秒
+• **isDirectory**: `boolean` - 判断当前路径是否是一个目录
+
+<a id="copyfileparams"></a>
+### CopyFileParams
+
+FileSystemManager.copyFile 的参数。
+
+#### Properties
+
+• **srcPath**: `string` - 源文件路径（被复制的文件）
+• **destPath**: `string` - 目标文件路径（复制后生成的文件）
+
+<a id="renameparams"></a>
+### RenameParams
+
+FileSystemManager.rename 的参数。
+
+#### Properties
+
+• **oldPath**: `string` - 源文件路径（即当前文件路径）
+• **newPath**: `string` - 新文件路径（即重命名或移动后的目标路径）
+
+<a id="truncateparams"></a>
+### TruncateParams
+
+FileSystemManager.truncate 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要截断的文件路径
+• **length?**: `number` - 截断后的文件字节长度。 - 若 length 小于文件原始长度，文件将被截取到指定长度，多余部分丢弃。 - 若 length 大于文件原始长度，文件将被扩展到指定长度，扩展部分用 \0 填充
+
+<a id="getfileinfoparams"></a>
+### GetFileInfoParams
+
+FileSystemManager.getFileInfo 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 要获取信息的文件路径
+• **digestAlgorithm?**: `'md5' | 'sha1'` - 用于计算文件摘要的哈希算法。 - 'md5'：使用 MD5 算法计算文件摘要。 - 'sha1'：使用 SHA-1 算法计算文件摘要。 不传时不计算摘要，返回结果中 GetFileInfoResult.digest 为 undefined
+
+<a id="getfileinforesult"></a>
+### GetFileInfoResult
+
+FileSystemManager.getFileInfo 的返回结果。
+
+#### Properties
+
+• **size**: `number` - 文件大小，单位为字节（Byte）
+• **digest?**: `string` - 按照 GetFileInfoParams.digestAlgorithm 计算得到的文件摘要（十六进制字符串）。 仅当请求时指定了 digestAlgorithm 才会返回
+
+<a id="savefileparams"></a>
+### SaveFileParams
+
+FileSystemManager.saveFile 的参数。
+
+#### Properties
+
+• **tempFilePath**: `string` - 临时文件路径（需先通过下载或其他方式获得的临时文件路径）
+• **filePath?**: `string` - 保存到的目标文件路径。 若不指定，则由宿主决定存储位置并通过 SaveFileResult.savedFilePath 返回
+
+<a id="savefileresult"></a>
+### SaveFileResult
+
+FileSystemManager.saveFile 的返回结果。
+
+#### Properties
+
+• **savedFilePath**: `string` - 文件保存后的实际存储路径
+
+<a id="getsavedfilelistresult"></a>
+### GetSavedFileListResult
+
+FileSystemManager.getSavedFileList 的返回结果。
+
+#### Properties
+
+• **fileList**: `Array<{
+    /** 文件的本地路径。 */
+    filePath: string;
+    /** 文件大小，单位为字节（Byte）。 */
+    size: number;
+    /** 文件保存时的时间戳，单位为毫秒。 */
+    createTime: number;
+  }>` - 已保存的本地文件列表，每项包含文件路径、大小和创建时间
+
+<a id="removesavedfileparams"></a>
+### RemoveSavedFileParams
+
+FileSystemManager.removeSavedFile 的参数。
+
+#### Properties
+
+• **filePath**: `string` - 需要删除的已保存文件路径（应为 SaveFileResult.savedFilePath 返回的路径）
+
+<a id="unzipparams"></a>
+### UnzipParams
+
+FileSystemManager.unzip 的参数。
+
+#### Properties
+
+• **zipFilePath**: `string` - 要解压的 zip 文件路径
+• **targetPath**: `string` - 解压后的目标目录路径。 目标目录须已存在，否则解压会失败
+
+<a id="filesystemmanager"></a>
+### FileSystemManager
+
+文件系统管理器，提供对本地文件系统的完整读写能力。 通过 getFileSystemManager 获取实例后，可使用该接口上的方法执行文件和目录操作。 大多数方法同时提供异步（返回 Promise）和同步（Sync 后缀）两种调用方式。
+
+#### Properties
+
+• **readFile**: `(params: ReadFileParams) => Promise<ReadFileResult>` - 读取文件内容（异步）
+• **readFileSync**: `(params: ReadFileParams) => ReadFileResult` - 读取文件内容（同步）
+• **writeFile**: `(params: WriteFileParams) => Promise<void>` - 写入文件内容（异步）。如果文件不存在则创建，已存在则覆盖
+• **writeFileSync**: `(params: WriteFileParams) => void` - 写入文件内容（同步）。如果文件不存在则创建，已存在则覆盖
+• **appendFile**: `(params: AppendFileParams) => Promise<void>` - 在文件末尾追加内容（异步）。如果文件不存在则创建
+• **appendFileSync**: `(params: AppendFileParams) => void` - 在文件末尾追加内容（同步）。如果文件不存在则创建
+• **access**: `(params: AccessParams) => Promise<void>` - 判断文件或目录是否存在（异步）。 路径存在时 Promise resolve；路径不存在时 Promise reject
+• **accessSync**: `(params: AccessParams) => void` - 判断文件或目录是否存在（同步）。 路径不存在时会抛出异常
+• **mkdir**: `(params: MkdirParams) => Promise<void>` - 创建目录（异步）
+• **mkdirSync**: `(params: MkdirParams) => void` - 创建目录（同步）
+• **rmdir**: `(params: RmdirParams) => Promise<void>` - 删除目录（异步）
+• **rmdirSync**: `(params: RmdirParams) => void` - 删除目录（同步）
+• **readdir**: `(params: ReaddirParams) => Promise<ReaddirResult>` - 读取目录下的文件和子目录列表（异步）
+• **readdirSync**: `(params: ReaddirParams) => ReaddirResult` - 读取目录下的文件和子目录列表（同步）
+• **unlink**: `(params: UnlinkParams) => Promise<void>` - 删除文件（异步）。不能用于删除目录
+• **unlinkSync**: `(params: UnlinkParams) => void` - 删除文件（同步）。不能用于删除目录
+• **stat**: `(params: StatParams) => Promise<StatResult>` - 获取文件或目录的状态信息（异步）
+• **statSync**: `(params: StatParams) => StatResult` - 获取文件或目录的状态信息（同步）
+• **copyFile**: `(params: CopyFileParams) => Promise<void>` - 复制文件（异步）。不支持复制目录
+• **copyFileSync**: `(params: CopyFileParams) => void` - 复制文件（同步）。不支持复制目录
+• **rename**: `(params: RenameParams) => Promise<void>` - 重命名或移动文件（异步）
+• **renameSync**: `(params: RenameParams) => void` - 重命名或移动文件（同步）
+• **truncate**: `(params: TruncateParams) => Promise<void>` - 截断文件到指定长度（异步）
+• **truncateSync**: `(params: TruncateParams) => void` - 截断文件到指定长度（同步）
+• **getFileInfo**: `(params: GetFileInfoParams) => Promise<GetFileInfoResult>` - 获取文件信息，可选计算文件摘要（异步）
+• **saveFile**: `(params: SaveFileParams) => Promise<SaveFileResult>` - 将临时文件保存到本地持久化存储（异步）
+• **saveFileSync**: `(params: SaveFileParams) => SaveFileResult` - 将临时文件保存到本地持久化存储（同步）
+• **getSavedFileList**: `() => Promise<GetSavedFileListResult>` - 获取已保存的本地文件列表（异步）
+• **removeSavedFile**: `(params: RemoveSavedFileParams) => Promise<void>` - 删除通过 FileSystemManager.saveFile 保存的本地文件（异步）
+• **unzip**: `(params: UnzipParams) => Promise<void>` - 解压 zip 文件到指定目录（异步）

package/dist/{skills → public/skills}/doubao-apps-dev/references/reference/open-api/README.md

@@ -6,13 +6,13 @@
 
 | 分组 | 说明 | API 数量 | 详细文档 |
 | --- | --- | ---: | --- |
-| 基础 | 账号、授权、宿主基础信息、窗口信息和能力可用性。 | 4 | [查看](./01-基础.md) |
-| 系统 | 宿主基础信息、窗口信息和系统设置。 | 7 | [查看](./02-系统.md) |
-| 定位 | 获取设备当前的地理位置信息。 | 11 | [查看](./03-定位.md) |
+| 基础 | 账号、授权、宿主基础信息、窗口信息和能力可用性。 | 6 | [查看](./01-基础.md) |
+| 系统 | 宿主基础信息、窗口信息和系统设置。 | 8 | [查看](./02-系统.md) |
+| 定位 | 获取设备当前的地理位置信息。 | 9 | [查看](./03-定位.md) |
 | 存储 | 本地缓存；带 Sync 后缀的是同步 API。 | 10 | [查看](./04-存储.md) |
 | 路由 | 应用内页面跳转、返回、退出和关闭。 | 6 | [查看](./05-路由.md) |
 | 交互 | Toast、Loading、Modal、ActionSheet 和返回前提醒。 | 9 | [查看](./06-交互.md) |
-| 输入 | 键盘和输入框选区能力。 | 2 | [查看](./07-输入.md) |
+| 输入 | 键盘和输入框选区能力。 | 3 | [查看](./07-输入.md) |
 | 网络 | 网络请求与 WebSocket。 | 2 | [查看](./08-网络.md) |
 | 媒体 | 图片选择、预览、保存、压缩和信息读取。 | 5 | [查看](./09-媒体.md) |
 | 业务能力 | 开放业务能力、隐私设置、上下文和外部应用打开。 | 11 | [查看](./10-业务能力.md) |

package/dist/{skills → public/skills}/doubao-apps-dev/references/reference/open-api.md

@@ -2,7 +2,7 @@
 
 > 端能力 API。默认从 `@doubao-apps/framework/api` 导入；本文件根据 `packages/open-api/src` 的导出结构自动生成，按模块列出 API 名称和说明。
 
-覆盖 144 个函数。详细参数、返回值、示例和相关类型请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
+覆盖 146 个函数。详细参数、返回值、示例和相关类型请查看 [Open API 目录](open-api/README.md)，精确字段也可按参数/结果类型名查看 IDE 类型提示或 `@doubao-apps/framework/api` 类型定义。
 
 ## 使用方式
 
@@ -20,6 +20,8 @@ import { showToast, request, getStorage } from '@doubao-apps/framework/api';
 | [getAccountInfoSync](open-api/01-基础.md#getaccountinfosync) | 同步获取账号信息。<br><br>同步 API。 |
 | [authorize](open-api/01-基础.md#authorize) | 初始化授权。 |
 | [canIUse](open-api/01-基础.md#caniuse) | 检测当前宿主是否支持指定 API 或能力。 |
+| [getPackageInfo](open-api/01-基础.md#getpackageinfo) | 获取当前 package 信息。 |
+| [getPackageInfoSync](open-api/01-基础.md#getpackageinfosync) | 同步获取当前 package 信息。<br><br>同步 API。 |
 
 ## 系统
 
@@ -32,8 +34,9 @@ import { showToast, request, getStorage } from '@doubao-apps/framework/api';
 | [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) | 监听应用主题变化。 |
+| [getSystemInfo](open-api/02-系统.md#getsysteminfo) | 获取系统信息。 |
+| [getSystemInfoSync](open-api/02-系统.md#getsysteminfosync) | 同步获取系统信息。<br><br>同步 API。 |
 
 ## 定位
 
@@ -41,8 +44,6 @@ import { showToast, request, getStorage } from '@doubao-apps/framework/api';
 
 | 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) | 使用地图查看位置。 |
@@ -106,6 +107,7 @@ Toast、Loading、Modal、ActionSheet 和返回前提醒。
 | API | 说明 |
 | --- | --- |
 | [hideKeyboard](open-api/07-输入.md#hidekeyboard) | 收起当前键盘。 |
+| [onKeyboardHeightChange](open-api/07-输入.md#onkeyboardheightchange) | 监听键盘高度变化事件。 |
 | [getSelectedTextRange](open-api/07-输入.md#getselectedtextrange) | 获取当前输入框的选区范围。 |
 
 ## 网络
@@ -210,13 +212,13 @@ 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 列表。 |
+| [onWifiConnected](open-api/15-wi-fi.md#onwificonnected) | 监听连接上 Wi-Fi 的事件。 |
 
 ## 加速度计
 
@@ -224,9 +226,9 @@ Wi-Fi 模块能力；通常先 startWifi，再获取列表或连接。
 
 | API | 说明 |
 | --- | --- |
-| [AccelerometerChangeListener](open-api/16-加速度计.md#accelerometerchangelistener) | 加速度数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [startAccelerometer](open-api/16-加速度计.md#startaccelerometer) | 开始监听加速度。 |
 | [stopAccelerometer](open-api/16-加速度计.md#stopaccelerometer) | 停止监听加速度。 |
+| [onAccelerometerChange](open-api/16-加速度计.md#onaccelerometerchange) | 监听加速度数据变化事件。 |
 
 ## iBeacon
 
@@ -244,9 +246,9 @@ iBeacon 搜索和结果读取能力。
 
 | API | 说明 |
 | --- | --- |
-| [CompassChangeListener](open-api/18-罗盘.md#compasschangelistener) | 罗盘数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [startCompass](open-api/18-罗盘.md#startcompass) | 开始监听罗盘。 |
 | [stopCompass](open-api/18-罗盘.md#stopcompass) | 停止监听罗盘。 |
+| [onCompassChange](open-api/18-罗盘.md#oncompasschange) | 监听罗盘数据变化事件。 |
 
 ## 设备方向
 
@@ -254,9 +256,9 @@ iBeacon 搜索和结果读取能力。
 
 | API | 说明 |
 | --- | --- |
-| [DeviceMotionChangeListener](open-api/19-设备方向.md#devicemotionchangelistener) | 设备方向变化事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [startDeviceMotionListening](open-api/19-设备方向.md#startdevicemotionlistening) | 开始监听设备方向变化。 |
 | [stopDeviceMotionListening](open-api/19-设备方向.md#stopdevicemotionlistening) | 停止监听设备方向变化。 |
+| [onDeviceMotionChange](open-api/19-设备方向.md#ondevicemotionchange) | 监听设备方向变化事件。 |
 
 ## 陀螺仪
 
@@ -264,9 +266,9 @@ iBeacon 搜索和结果读取能力。
 
 | API | 说明 |
 | --- | --- |
-| [GyroscopeChangeListener](open-api/20-陀螺仪.md#gyroscopechangelistener) | 陀螺仪数据变化事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [startGyroscope](open-api/20-陀螺仪.md#startgyroscope) | 开始监听陀螺仪。 |
 | [stopGyroscope](open-api/20-陀螺仪.md#stopgyroscope) | 停止监听陀螺仪。 |
+| [onGyroscopeChange](open-api/20-陀螺仪.md#ongyroscopechange) | 监听陀螺仪数据变化事件。 |
 
 ## 设备 / 网络
 
@@ -276,7 +278,7 @@ iBeacon 搜索和结果读取能力。
 | --- | --- |
 | [getLocalIPAddress](open-api/21-设备-网络.md#getlocalipaddress) | 获取局域网 IP 地址。 |
 | [getNetworkType](open-api/21-设备-网络.md#getnetworktype) | 获取当前网络类型。 |
-| [NetworkStatusChangeListener](open-api/21-设备-网络.md#networkstatuschangelistener) | 网络状态变化事件监听函数。<br><br>返回 void，不是 Promise。 |
+| [onNetworkStatusChange](open-api/21-设备-网络.md#onnetworkstatuschange) | 监听网络状态变化事件。 |
 
 ## 短信
 
@@ -309,8 +311,8 @@ iBeacon 搜索和结果读取能力。
 
 | API | 说明 |
 | --- | --- |
-| [BatteryInfoChangeListener](open-api/25-电池.md#batteryinfochangelistener) | 电池信息变化事件监听函数。<br><br>返回 void，不是 Promise。 |
 | [getBatteryInfo](open-api/25-电池.md#getbatteryinfo) | 获取电池信息。 |
+| [onBatteryInfoChange](open-api/25-电池.md#onbatteryinfochange) | 监听电池信息变化事件。 |
 
 ## 日历
 
@@ -369,11 +371,11 @@ iBeacon 搜索和结果读取能力。
 
 | 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) | 设置屏幕常亮状态。 |
+| [onUserCaptureScreen](open-api/32-屏幕.md#onusercapturescreen) | 监听用户主动截屏事件。 |
 
 ## 震动
 

package/dist/public/skills/doubao-components-api/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: doubao-components-api
+description: |
+  豆包小程序内置组件 API 参考。覆盖所有经 components-loader 自动注入的小写标签组件，
+  包含 props、事件、ref 方法和使用约束。当用户询问组件用法、props 类型、事件回调格式时使用。
+---
+
+# 豆包小程序组件 API
+
+## 核心规则
+
+所有组件使用**小写标签**，`components-loader` 在构建时自动注入 import，业务代码不需要手动 import 运行时组件：
+
+```tsx
+// ✅ 直接使用小写标签
+<view><text>你好</text><button text="提交" /></view>
+
+// ❌ 不要手动 import 运行时组件
+import { View, Button } from '@doubao-apps/framework/components';
+```
+
+类型标注可以 import：
+
+```tsx
+import type { ButtonProps, SwiperRef, VideoRef, PopupRef } from '@doubao-apps/framework/components';
+```
+
+## 参考文档
+
+| 类别 | 文件 | 涵盖标签 |
+|------|------|---------|
+| 滚动与列表 | [layout-scroll.md](references/reference/layout-scroll.md) | `scroll-view` `list` `list-item` `swiper` `swiper-item` |
+| 容器与覆层 | [layout-overlay.md](references/reference/layout-overlay.md) | `view` `popup` `movable-area` `movable-view` `theme-provider` |
+| 文本与媒体 | [media.md](references/reference/media.md) | `text` `image` `svg` `video` `long-image` `web-view` |
+| 交互控件 | [interactive.md](references/reference/interactive.md) | `button` `switch` `slider` `radio` `radio-group` |
+| 表单 | [form.md](references/reference/form.md) | `input` `textarea` `picker-view` `picker-column` `picker-divider` |
+| 地图与画布 | [map-canvas.md](references/reference/map-canvas.md) | `map` `map-marker` `canvas` |
+
+## 常见错误
+
+| 错误 | 修正 |
+|------|------|
+| 手动 import 运行时组件 | 直接用小写标签，loader 自动注入 |
+| `<list>` 没设置 height | 必须 `style={{ height: '...' }}`，list 不支持自适应高度 |
+| `list-item` 没传 `item-key` | item-key 是必填项（原生 Lynx 元素，连字符属性名） |
+| `picker-view` 高度只写在 CSS class | 必须同时写 `style={{ height: '...' }}` |
+| `slider` 不传 value | slider 仅支持受控用法 |
+| `image` 没设置 width/height 也没设 autoSize | 不满足条件图片不显示 |
+| `popup` 没传 scrollContainerId | scrollContainerId 是必填项 |
+| `long-image` 接外部滚动容器直接传外层 scrollTop | 有 header 时需减去 header 高度 |