@doubao-apps/create 0.0.30 → 0.0.31

package/dist/template-empty/references/reference/open-api.md

@@ -408,6 +408,49 @@ socketTask.onError((event) => {
 
 ***
 
+### createTask()
+
+> **createTask**(`params`): `Promise`\<[`CreateTaskResult`](doubao-apps-sdk-open-api.md#createtaskresult)\>
+
+创建任务。
+
+#### Parameters
+
+• **params**: [`CreateTaskParams`](doubao-apps-sdk-open-api.md#createtaskparams)
+
+任务创建参数。
+
+#### Returns
+
+`Promise`\<[`CreateTaskResult`](doubao-apps-sdk-open-api.md#createtaskresult)\>
+
+返回创建后的任务 ID、远端任务 token 和过期时间。
+
+#### Remarks
+
+创建任务时需要传入开发者侧唯一任务标识、任务模板、任务详情和任务类型。开发者侧唯一任务标识
+可用于幂等创建和后续业务关联。远端任务创建成功后，返回的 taskId 可用于查询或更新任务。
+
+#### Example
+
+```typescript
+import { createTask } from '@doubao-apps/framework/api';
+
+const result = await createTask({
+  outTaskId: 'order-20260529-001',
+  taskTemplate: 'remote_normal_v1',
+  taskType: 'remote',
+  taskDetail: JSON.stringify({
+    title: '订单处理中',
+    description: '正在为你处理订单，请稍候'
+  })
+});
+
+console.log(result.taskId, result.token, result.expiresIn);
+```
+
+***
+
 ### disableAlertBeforeUnload()
 
 > **disableAlertBeforeUnload**(`params`?): `Promise`\<`object`\>
@@ -812,6 +855,18 @@ console.log(result.host?.appId, result.enableDebug);
 
 ***
 
+### getFileSystemManager()
+
+> **getFileSystemManager**(): [`FileSystemManager`](doubao-apps-sdk-open-api.md#filesystemmanager)
+
+获取文件系统管理器
+
+#### Returns
+
+[`FileSystemManager`](doubao-apps-sdk-open-api.md#filesystemmanager)
+
+***
+
 ### getImageInfo()
 
 > **getImageInfo**(`params`): `Promise`\<[`GetImageInfoResult`](doubao-apps-sdk-open-api.md#getimageinforesult)\>
@@ -1221,6 +1276,42 @@ console.log(result.wifiEnabled, result.deviceOrientation);
 
 ***
 
+### getTask()
+
+> **getTask**(`params`): `Promise`\<[`GetTaskResult`](doubao-apps-sdk-open-api.md#gettaskresult)\>
+
+查询任务。
+
+#### Parameters
+
+• **params**: [`GetTaskParams`](doubao-apps-sdk-open-api.md#gettaskparams)
+
+任务查询参数。
+
+#### Returns
+
+`Promise`\<[`GetTaskResult`](doubao-apps-sdk-open-api.md#gettaskresult)\>
+
+返回任务详情、状态、类型和 token 信息。
+
+#### Remarks
+
+根据任务 ID 查询任务的模板、详情、状态和类型。若返回 token，可在后续远端任务更新中继续使用。
+
+#### Example
+
+```typescript
+import { getTask } from '@doubao-apps/framework/api';
+
+const task = await getTask({ taskId: 'task_123' });
+
+if (task.taskStatus === 'running') {
+  console.log('任务仍在运行', task.taskDetail);
+}
+```
+
+***
+
 ### getWifiList()
 
 > **getWifiList**(`params`?): `Promise`\<[`GetWifiListResult`](doubao-apps-sdk-open-api.md#getwifilistresult)\>
@@ -1763,6 +1854,40 @@ off();
 
 ***
 
+### onWifiConnected()
+
+> **onWifiConnected**(`handler`): () => `void`
+
+监听连接上 Wi-Fi 的事件。
+
+#### Parameters
+
+• **handler**
+
+#### Returns
+
+`Function`
+
+返回取消当前监听函数的函数。
+
+##### Returns
+
+`void`
+
+#### Example
+
+```ts
+import { onWifiConnected } from '@doubao-apps/framework/api';
+
+const off = onWifiConnected(({ wifi }) => {
+  console.log(wifi.ssid);
+});
+
+off();
+```
+
+***
+
 ### openApp()
 
 > **openApp**(`params`): `Promise`\<[`OpenAppResult`](doubao-apps-sdk-open-api.md#openappresult)\>
@@ -2340,7 +2465,7 @@ setStorageSync({
 
 > **setWifiList**(`params`): `Promise`\<`object`\>
 
-设置 Wi-Fi 预设列表。
+设置 Wi-Fi 预设列表（iOS 特有）。
 
 #### Parameters
 
@@ -2352,7 +2477,7 @@ setStorageSync({
 
 #### Remarks
 
-用于预设 Wi-Fi 列表。
+该接口为 iOS 特有，用于预设 Wi-Fi 列表。
 
 ***
 
@@ -2777,6 +2902,48 @@ Wi-Fi 流程入口。
 
 ***
 
+### updateTask()
+
+> **updateTask**(`params`): `Promise`\<[`UpdateTaskResult`](doubao-apps-sdk-open-api.md#updatetaskresult)\>
+
+更新任务状态或任务详情。
+
+#### Parameters
+
+• **params**: [`UpdateTaskParams`](doubao-apps-sdk-open-api.md#updatetaskparams)
+
+任务更新参数，taskStatus 与 taskDetail 二选一。
+
+#### Returns
+
+`Promise`\<[`UpdateTaskResult`](doubao-apps-sdk-open-api.md#updatetaskresult)\>
+
+返回任务 ID、新 token 和过期时间。
+
+#### Remarks
+
+更新任务时至少传入 taskStatus 或 taskDetail 中的一个。更新远端任务成功后，旧 token 会失效，
+如返回 nextToken，后续需要使用新的 token 继续更新远端任务。
+
+#### Example
+
+```typescript
+import { updateTask } from '@doubao-apps/framework/api';
+
+const result = await updateTask({
+  taskId: 'task_123',
+  taskStatus: 'completed',
+  taskDetail: JSON.stringify({
+    title: '订单已完成',
+    description: '订单处理完成'
+  })
+});
+
+console.log(result.taskId, result.nextToken, result.expiresIn);
+```
+
+***
+
 ### updateWidget()
 
 > **updateWidget**(`params`): `Promise`\<`object`\>
@@ -2903,6 +3070,20 @@ Z 轴加速度，单位 m/s²。
 
 ***
 
+### AccessParams
+
+[FileSystemManager.access](doubao-apps-sdk-open-api.md#access) 的参数。
+
+#### Properties
+
+##### path
+
+> **path**: `string`
+
+要判断是否存在的文件或目录路径。
+
+***
+
 ### AddPhoneCalendarParams
 
 添加系统日历事件的请求参数。
@@ -3279,6 +3460,46 @@ Z 轴加速度，单位 m/s²。
 
 ***
 
+### AppendFileParams
+
+[FileSystemManager.appendFile](doubao-apps-sdk-open-api.md#appendfile) 的参数。
+
+#### Remarks
+
+- 如果文件不存在会自动创建。
+- 与 [WriteFileParams](doubao-apps-sdk-open-api.md#writefileparams) 不同，追加写入不会覆盖文件已有内容，而是在末尾追加。
+
+#### Properties
+
+##### data
+
+> **data**: `string`
+
+要追加的内容。
+
+- 当 `encoding` 为 `'utf-8'` 时，直接追加该字符串；
+- 当 `encoding` 为 `'base64'` 时，将该字符串先进行 Base64 解码再追加到文件末尾。
+
+##### encoding?
+
+> `optional` **encoding**: `"base64"` \| `"utf-8"`
+
+指定写入文件的字符编码。
+
+###### Default
+
+```ts
+'utf-8'
+```
+
+##### filePath
+
+> **filePath**: `string`
+
+要追加内容的文件路径（本地路径）。
+
+***
+
 ### AuthorizeRequest
 
 #### Properties
@@ -3903,6 +4124,31 @@ Wi-Fi SSID。
 
 ***
 
+### CopyFileParams
+
+[FileSystemManager.copyFile](doubao-apps-sdk-open-api.md#copyfile) 的参数。
+
+#### Remarks
+
+- 不支持复制目录，仅支持复制文件。
+- 如果目标路径已存在同名文件，会被覆盖。
+
+#### Properties
+
+##### destPath
+
+> **destPath**: `string`
+
+目标文件路径（复制后生成的文件）。
+
+##### srcPath
+
+> **srcPath**: `string`
+
+源文件路径（被复制的文件）。
+
+***
+
 ### CreateBLEConnectionParams
 
 创建 BLE 连接的请求参数。
@@ -3983,6 +4229,64 @@ Wi-Fi SSID。
 
 ***
 
+### CreateTaskParams
+
+创建任务的请求参数。
+
+#### Properties
+
+##### outTaskId
+
+> **outTaskId**: `string`
+
+开发者侧任务唯一标识，用于幂等和关联
+
+##### taskDetail
+
+> **taskDetail**: `string`
+
+模板对应的数据的 JSON 字符串
+
+##### taskTemplate
+
+> **taskTemplate**: `"remote_normal_v1"`
+
+任务样式模板，当前仅支持 remote_normal_v1
+
+##### taskType
+
+> **taskType**: [`TaskType`](doubao-apps-sdk-open-api.md#tasktype-2)
+
+任务类型，当前支持 local 和 remote
+
+***
+
+### CreateTaskResult
+
+创建任务的返回结果。
+
+#### Properties
+
+##### expiresIn?
+
+> `optional` **expiresIn**: `number`
+
+任务超时过期时间
+
+##### taskId
+
+> **taskId**: `string`
+
+任务 ID，后续可以使用这个 ID 更新任务
+
+##### token?
+
+> `optional` **token**: `string`
+
+远端任务 token，后续使用 token 通过 OpenAPI 更新远端任务
+
+***
+
 ### DeviceMotionChangeEvent
 
 设备方向变化事件。
@@ -4146,103 +4450,618 @@ mcp入参，如果expectedAction里预期要调用工具，需要在这里写明
 
 ***
 
-### GetAccountInfoResult
+### FileSystemManager
 
-获取当前账号信息。
+文件系统管理器，提供对本地文件系统的完整读写能力。
 
-#### Properties
+通过 [getFileSystemManager](doubao-apps-sdk-open-api.md#getfilesystemmanager) 获取实例后，可使用该接口上的方法执行文件和目录操作。
+大多数方法同时提供异步（返回 `Promise`）和同步（`Sync` 后缀）两种调用方式。
 
-##### miniProgram
+#### Remarks
 
-> **miniProgram**: [`DoubaoAppAccountInfo`](doubao-apps-sdk-open-api.md#doubaoappaccountinfo)
+- 所有路径参数均为本地文件路径，不支持网络路径。
+- 同步方法会阻塞当前 JS 线程直到操作完成；对于大文件操作建议使用异步方法以避免卡顿。
+- 文件操作失败时（如路径不存在、权限不足），Promise 会被 reject 或同步方法会抛出异常。
 
-豆包 App账号信息
+#### Methods
 
-##### plugin?
+##### access()
 
-> `optional` **plugin**: [`PluginAccountInfo`](doubao-apps-sdk-open-api.md#pluginaccountinfo)
+> **access**(`params`): `Promise`\<`void`\>
 
-插件账号信息（仅在插件中调用时包含）
+判断文件或目录是否存在（异步）。
 
-***
+路径存在时 Promise resolve；路径不存在时 Promise reject。
 
-### GetAppBaseInfoResult
+###### Parameters
 
-#### Properties
+• **params**: [`AccessParams`](doubao-apps-sdk-open-api.md#accessparams)
 
-##### SDKVersion?
+参见 [AccessParams](doubao-apps-sdk-open-api.md#accessparams)。
 
-> `optional` **SDKVersion**: `string`
+###### Returns
 
-客户端基础库版本
+`Promise`\<`void`\>
 
-##### enableDebug?
+##### accessSync()
 
-> `optional` **enableDebug**: `boolean`
+> **accessSync**(`params`): `void`
 
-是否已打开调试
+判断文件或目录是否存在（同步）。
 
-##### host?
+路径不存在时会抛出异常。
 
-> `optional` **host**: [`AppBaseInfoHost`](doubao-apps-sdk-open-api.md#appbaseinfohost)
+###### Parameters
 
-当前豆包 App运行的宿主环境
+• **params**: [`AccessParams`](doubao-apps-sdk-open-api.md#accessparams)
 
-##### language
+参见 [AccessParams](doubao-apps-sdk-open-api.md#accessparams)。
 
-> **language**: `string`
+###### Returns
 
-当前语言
+`void`
 
-##### theme?
+##### appendFile()
 
-> `optional` **theme**: `"light"` \| `"dark"`
+> **appendFile**(`params`): `Promise`\<`void`\>
 
-当前主题
+在文件末尾追加内容（异步）。如果文件不存在则创建。
 
-##### version?
+###### Parameters
 
-> `optional` **version**: `string`
+• **params**: [`AppendFileParams`](doubao-apps-sdk-open-api.md#appendfileparams)
 
-宿主版本号
+追加参数，参见 [AppendFileParams](doubao-apps-sdk-open-api.md#appendfileparams)。
 
-***
+###### Returns
 
-### GetBLEDeviceCharacteristicsParams
+`Promise`\<`void`\>
 
-获取 BLE 特征值列表的请求参数。
+##### appendFileSync()
 
-#### Properties
+> **appendFileSync**(`params`): `void`
 
-##### deviceId
+在文件末尾追加内容（同步）。如果文件不存在则创建。
 
-> **deviceId**: `string`
+###### Parameters
 
-蓝牙设备 ID。
+• **params**: [`AppendFileParams`](doubao-apps-sdk-open-api.md#appendfileparams)
 
-##### serviceId
+追加参数，参见 [AppendFileParams](doubao-apps-sdk-open-api.md#appendfileparams)。
 
-> **serviceId**: `string`
+###### Returns
 
-服务 ID。
+`void`
 
-***
+##### copyFile()
 
-### GetBLEDeviceCharacteristicsResult
+> **copyFile**(`params`): `Promise`\<`void`\>
 
-获取 BLE 特征值列表的返回结果。
+复制文件（异步）。不支持复制目录。
 
-#### Properties
+###### Parameters
 
-##### characteristics
+• **params**: [`CopyFileParams`](doubao-apps-sdk-open-api.md#copyfileparams)
 
-> **characteristics**: [`BluetoothCharacteristic`](doubao-apps-sdk-open-api.md#bluetoothcharacteristic)[]
+参见 [CopyFileParams](doubao-apps-sdk-open-api.md#copyfileparams)。
 
-特征值列表。
+###### Returns
 
-***
+`Promise`\<`void`\>
 
-### GetBLEDeviceRSSIParams
+##### copyFileSync()
+
+> **copyFileSync**(`params`): `void`
+
+复制文件（同步）。不支持复制目录。
+
+###### Parameters
+
+• **params**: [`CopyFileParams`](doubao-apps-sdk-open-api.md#copyfileparams)
+
+参见 [CopyFileParams](doubao-apps-sdk-open-api.md#copyfileparams)。
+
+###### Returns
+
+`void`
+
+##### getFileInfo()
+
+> **getFileInfo**(`params`): `Promise`\<[`GetFileInfoResult`](doubao-apps-sdk-open-api.md#getfileinforesult)\>
+
+获取文件信息，可选计算文件摘要（异步）。
+
+###### Parameters
+
+• **params**: [`GetFileInfoParams`](doubao-apps-sdk-open-api.md#getfileinfoparams)
+
+参见 [GetFileInfoParams](doubao-apps-sdk-open-api.md#getfileinfoparams)。
+
+###### Returns
+
+`Promise`\<[`GetFileInfoResult`](doubao-apps-sdk-open-api.md#getfileinforesult)\>
+
+返回一个 Promise，解析为 [GetFileInfoResult](doubao-apps-sdk-open-api.md#getfileinforesult)。
+
+##### getSavedFileList()
+
+> **getSavedFileList**(): `Promise`\<[`GetSavedFileListResult`](doubao-apps-sdk-open-api.md#getsavedfilelistresult)\>
+
+获取已保存的本地文件列表（异步）。
+
+###### Returns
+
+`Promise`\<[`GetSavedFileListResult`](doubao-apps-sdk-open-api.md#getsavedfilelistresult)\>
+
+返回一个 Promise，解析为 [GetSavedFileListResult](doubao-apps-sdk-open-api.md#getsavedfilelistresult)。
+
+##### mkdir()
+
+> **mkdir**(`params`): `Promise`\<`void`\>
+
+创建目录（异步）。
+
+###### Parameters
+
+• **params**: [`MkdirParams`](doubao-apps-sdk-open-api.md#mkdirparams)
+
+参见 [MkdirParams](doubao-apps-sdk-open-api.md#mkdirparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### mkdirSync()
+
+> **mkdirSync**(`params`): `void`
+
+创建目录（同步）。
+
+###### Parameters
+
+• **params**: [`MkdirParams`](doubao-apps-sdk-open-api.md#mkdirparams)
+
+参见 [MkdirParams](doubao-apps-sdk-open-api.md#mkdirparams)。
+
+###### Returns
+
+`void`
+
+##### readFile()
+
+> **readFile**(`params`): `Promise`\<[`ReadFileResult`](doubao-apps-sdk-open-api.md#readfileresult)\>
+
+读取文件内容（异步）。
+
+###### Parameters
+
+• **params**: [`ReadFileParams`](doubao-apps-sdk-open-api.md#readfileparams)
+
+读取参数，参见 [ReadFileParams](doubao-apps-sdk-open-api.md#readfileparams)。
+
+###### Returns
+
+`Promise`\<[`ReadFileResult`](doubao-apps-sdk-open-api.md#readfileresult)\>
+
+返回一个 Promise，解析为 [ReadFileResult](doubao-apps-sdk-open-api.md#readfileresult)。
+
+##### readFileSync()
+
+> **readFileSync**(`params`): [`ReadFileResult`](doubao-apps-sdk-open-api.md#readfileresult)
+
+读取文件内容（同步）。
+
+###### Parameters
+
+• **params**: [`ReadFileParams`](doubao-apps-sdk-open-api.md#readfileparams)
+
+读取参数，参见 [ReadFileParams](doubao-apps-sdk-open-api.md#readfileparams)。
+
+###### Returns
+
+[`ReadFileResult`](doubao-apps-sdk-open-api.md#readfileresult)
+
+返回 [ReadFileResult](doubao-apps-sdk-open-api.md#readfileresult)。
+
+##### readdir()
+
+> **readdir**(`params`): `Promise`\<[`ReaddirResult`](doubao-apps-sdk-open-api.md#readdirresult)\>
+
+读取目录下的文件和子目录列表（异步）。
+
+###### Parameters
+
+• **params**: [`ReaddirParams`](doubao-apps-sdk-open-api.md#readdirparams)
+
+参见 [ReaddirParams](doubao-apps-sdk-open-api.md#readdirparams)。
+
+###### Returns
+
+`Promise`\<[`ReaddirResult`](doubao-apps-sdk-open-api.md#readdirresult)\>
+
+返回一个 Promise，解析为 [ReaddirResult](doubao-apps-sdk-open-api.md#readdirresult)。
+
+##### readdirSync()
+
+> **readdirSync**(`params`): [`ReaddirResult`](doubao-apps-sdk-open-api.md#readdirresult)
+
+读取目录下的文件和子目录列表（同步）。
+
+###### Parameters
+
+• **params**: [`ReaddirParams`](doubao-apps-sdk-open-api.md#readdirparams)
+
+参见 [ReaddirParams](doubao-apps-sdk-open-api.md#readdirparams)。
+
+###### Returns
+
+[`ReaddirResult`](doubao-apps-sdk-open-api.md#readdirresult)
+
+返回 [ReaddirResult](doubao-apps-sdk-open-api.md#readdirresult)。
+
+##### removeSavedFile()
+
+> **removeSavedFile**(`params`): `Promise`\<`void`\>
+
+删除通过 [FileSystemManager.saveFile](doubao-apps-sdk-open-api.md#savefile) 保存的本地文件（异步）。
+
+###### Parameters
+
+• **params**: [`RemoveSavedFileParams`](doubao-apps-sdk-open-api.md#removesavedfileparams)
+
+参见 [RemoveSavedFileParams](doubao-apps-sdk-open-api.md#removesavedfileparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### rename()
+
+> **rename**(`params`): `Promise`\<`void`\>
+
+重命名或移动文件（异步）。
+
+###### Parameters
+
+• **params**: [`RenameParams`](doubao-apps-sdk-open-api.md#renameparams)
+
+参见 [RenameParams](doubao-apps-sdk-open-api.md#renameparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### renameSync()
+
+> **renameSync**(`params`): `void`
+
+重命名或移动文件（同步）。
+
+###### Parameters
+
+• **params**: [`RenameParams`](doubao-apps-sdk-open-api.md#renameparams)
+
+参见 [RenameParams](doubao-apps-sdk-open-api.md#renameparams)。
+
+###### Returns
+
+`void`
+
+##### rmdir()
+
+> **rmdir**(`params`): `Promise`\<`void`\>
+
+删除目录（异步）。
+
+###### Parameters
+
+• **params**: [`RmdirParams`](doubao-apps-sdk-open-api.md#rmdirparams)
+
+参见 [RmdirParams](doubao-apps-sdk-open-api.md#rmdirparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### rmdirSync()
+
+> **rmdirSync**(`params`): `void`
+
+删除目录（同步）。
+
+###### Parameters
+
+• **params**: [`RmdirParams`](doubao-apps-sdk-open-api.md#rmdirparams)
+
+参见 [RmdirParams](doubao-apps-sdk-open-api.md#rmdirparams)。
+
+###### Returns
+
+`void`
+
+##### saveFile()
+
+> **saveFile**(`params`): `Promise`\<[`SaveFileResult`](doubao-apps-sdk-open-api.md#savefileresult)\>
+
+将临时文件保存到本地持久化存储（异步）。
+
+###### Parameters
+
+• **params**: [`SaveFileParams`](doubao-apps-sdk-open-api.md#savefileparams)
+
+参见 [SaveFileParams](doubao-apps-sdk-open-api.md#savefileparams)。
+
+###### Returns
+
+`Promise`\<[`SaveFileResult`](doubao-apps-sdk-open-api.md#savefileresult)\>
+
+返回一个 Promise，解析为 [SaveFileResult](doubao-apps-sdk-open-api.md#savefileresult)。
+
+##### saveFileSync()
+
+> **saveFileSync**(`params`): [`SaveFileResult`](doubao-apps-sdk-open-api.md#savefileresult)
+
+将临时文件保存到本地持久化存储（同步）。
+
+###### Parameters
+
+• **params**: [`SaveFileParams`](doubao-apps-sdk-open-api.md#savefileparams)
+
+参见 [SaveFileParams](doubao-apps-sdk-open-api.md#savefileparams)。
+
+###### Returns
+
+[`SaveFileResult`](doubao-apps-sdk-open-api.md#savefileresult)
+
+返回 [SaveFileResult](doubao-apps-sdk-open-api.md#savefileresult)。
+
+##### stat()
+
+> **stat**(`params`): `Promise`\<[`StatResult`](doubao-apps-sdk-open-api.md#statresult)\>
+
+获取文件或目录的状态信息（异步）。
+
+###### Parameters
+
+• **params**: [`StatParams`](doubao-apps-sdk-open-api.md#statparams)
+
+参见 [StatParams](doubao-apps-sdk-open-api.md#statparams)。
+
+###### Returns
+
+`Promise`\<[`StatResult`](doubao-apps-sdk-open-api.md#statresult)\>
+
+返回一个 Promise，解析为 [StatResult](doubao-apps-sdk-open-api.md#statresult)。
+
+##### statSync()
+
+> **statSync**(`params`): [`StatResult`](doubao-apps-sdk-open-api.md#statresult)
+
+获取文件或目录的状态信息（同步）。
+
+###### Parameters
+
+• **params**: [`StatParams`](doubao-apps-sdk-open-api.md#statparams)
+
+参见 [StatParams](doubao-apps-sdk-open-api.md#statparams)。
+
+###### Returns
+
+[`StatResult`](doubao-apps-sdk-open-api.md#statresult)
+
+返回 [StatResult](doubao-apps-sdk-open-api.md#statresult)。
+
+##### truncate()
+
+> **truncate**(`params`): `Promise`\<`void`\>
+
+截断文件到指定长度（异步）。
+
+###### Parameters
+
+• **params**: [`TruncateParams`](doubao-apps-sdk-open-api.md#truncateparams)
+
+参见 [TruncateParams](doubao-apps-sdk-open-api.md#truncateparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### truncateSync()
+
+> **truncateSync**(`params`): `void`
+
+截断文件到指定长度（同步）。
+
+###### Parameters
+
+• **params**: [`TruncateParams`](doubao-apps-sdk-open-api.md#truncateparams)
+
+参见 [TruncateParams](doubao-apps-sdk-open-api.md#truncateparams)。
+
+###### Returns
+
+`void`
+
+##### unlink()
+
+> **unlink**(`params`): `Promise`\<`void`\>
+
+删除文件（异步）。不能用于删除目录。
+
+###### Parameters
+
+• **params**: [`UnlinkParams`](doubao-apps-sdk-open-api.md#unlinkparams)
+
+参见 [UnlinkParams](doubao-apps-sdk-open-api.md#unlinkparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### unlinkSync()
+
+> **unlinkSync**(`params`): `void`
+
+删除文件（同步）。不能用于删除目录。
+
+###### Parameters
+
+• **params**: [`UnlinkParams`](doubao-apps-sdk-open-api.md#unlinkparams)
+
+参见 [UnlinkParams](doubao-apps-sdk-open-api.md#unlinkparams)。
+
+###### Returns
+
+`void`
+
+##### unzip()
+
+> **unzip**(`params`): `Promise`\<`void`\>
+
+解压 zip 文件到指定目录（异步）。
+
+###### Parameters
+
+• **params**: [`UnzipParams`](doubao-apps-sdk-open-api.md#unzipparams)
+
+参见 [UnzipParams](doubao-apps-sdk-open-api.md#unzipparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### writeFile()
+
+> **writeFile**(`params`): `Promise`\<`void`\>
+
+写入文件内容（异步）。如果文件不存在则创建，已存在则覆盖。
+
+###### Parameters
+
+• **params**: [`WriteFileParams`](doubao-apps-sdk-open-api.md#writefileparams)
+
+写入参数，参见 [WriteFileParams](doubao-apps-sdk-open-api.md#writefileparams)。
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### writeFileSync()
+
+> **writeFileSync**(`params`): `void`
+
+写入文件内容（同步）。如果文件不存在则创建，已存在则覆盖。
+
+###### Parameters
+
+• **params**: [`WriteFileParams`](doubao-apps-sdk-open-api.md#writefileparams)
+
+写入参数，参见 [WriteFileParams](doubao-apps-sdk-open-api.md#writefileparams)。
+
+###### Returns
+
+`void`
+
+***
+
+### GetAccountInfoResult
+
+获取当前账号信息。
+
+#### Properties
+
+##### miniProgram
+
+> **miniProgram**: [`DoubaoAppAccountInfo`](doubao-apps-sdk-open-api.md#doubaoappaccountinfo)
+
+豆包 App账号信息
+
+##### plugin?
+
+> `optional` **plugin**: [`PluginAccountInfo`](doubao-apps-sdk-open-api.md#pluginaccountinfo)
+
+插件账号信息（仅在插件中调用时包含）
+
+***
+
+### GetAppBaseInfoResult
+
+#### Properties
+
+##### SDKVersion?
+
+> `optional` **SDKVersion**: `string`
+
+客户端基础库版本
+
+##### enableDebug?
+
+> `optional` **enableDebug**: `boolean`
+
+是否已打开调试
+
+##### host?
+
+> `optional` **host**: [`AppBaseInfoHost`](doubao-apps-sdk-open-api.md#appbaseinfohost)
+
+当前豆包 App运行的宿主环境
+
+##### language
+
+> **language**: `string`
+
+当前语言
+
+##### theme?
+
+> `optional` **theme**: `"light"` \| `"dark"`
+
+当前主题
+
+##### version?
+
+> `optional` **version**: `string`
+
+宿主版本号
+
+***
+
+### GetBLEDeviceCharacteristicsParams
+
+获取 BLE 特征值列表的请求参数。
+
+#### Properties
+
+##### deviceId
+
+> **deviceId**: `string`
+
+蓝牙设备 ID。
+
+##### serviceId
+
+> **serviceId**: `string`
+
+服务 ID。
+
+***
+
+### GetBLEDeviceCharacteristicsResult
+
+获取 BLE 特征值列表的返回结果。
+
+#### Properties
+
+##### characteristics
+
+> **characteristics**: [`BluetoothCharacteristic`](doubao-apps-sdk-open-api.md#bluetoothcharacteristic)[]
+
+特征值列表。
+
+***
+
+### GetBLEDeviceRSSIParams
 
 获取 BLE RSSI 的请求参数。
 
@@ -4470,6 +5289,53 @@ RSSI 信号强度，单位 dBm。
 
 ***
 
+### GetFileInfoParams
+
+[FileSystemManager.getFileInfo](doubao-apps-sdk-open-api.md#getfileinfo) 的参数。
+
+#### Properties
+
+##### digestAlgorithm?
+
+> `optional` **digestAlgorithm**: `"md5"` \| `"sha1"`
+
+用于计算文件摘要的哈希算法。
+
+- `'md5'`：使用 MD5 算法计算文件摘要。
+- `'sha1'`：使用 SHA-1 算法计算文件摘要。
+
+不传时不计算摘要，返回结果中 [GetFileInfoResult.digest](doubao-apps-sdk-open-api.md#digest) 为 `undefined`。
+
+##### filePath
+
+> **filePath**: `string`
+
+要获取信息的文件路径。
+
+***
+
+### GetFileInfoResult
+
+[FileSystemManager.getFileInfo](doubao-apps-sdk-open-api.md#getfileinfo) 的返回结果。
+
+#### Properties
+
+##### digest?
+
+> `optional` **digest**: `string`
+
+按照 [GetFileInfoParams.digestAlgorithm](doubao-apps-sdk-open-api.md#digestalgorithm) 计算得到的文件摘要（十六进制字符串）。
+
+仅当请求时指定了 `digestAlgorithm` 才会返回。
+
+##### size
+
+> **size**: `number`
+
+文件大小，单位为字节（Byte）。
+
+***
+
 ### GetImageInfoParams
 
 获取图片信息的请求参数。
@@ -4733,6 +5599,20 @@ RSSI 信号强度，单位 dBm。
 
 ***
 
+### GetSavedFileListResult
+
+[FileSystemManager.getSavedFileList](doubao-apps-sdk-open-api.md#getsavedfilelist) 的返回结果。
+
+#### Properties
+
+##### fileList
+
+> **fileList**: `object`[]
+
+已保存的本地文件列表，每项包含文件路径、大小和创建时间。
+
+***
+
 ### GetScreenBrightnessResult
 
 #### Properties
@@ -4847,6 +5727,70 @@ Wi-Fi 的系统开关
 
 ***
 
+### GetTaskParams
+
+查询任务的请求参数。
+
+#### Properties
+
+##### taskId
+
+> **taskId**: `string`
+
+任务 ID
+
+***
+
+### GetTaskResult
+
+查询任务的返回结果。
+
+#### Properties
+
+##### expiresIn?
+
+> `optional` **expiresIn**: `number`
+
+任务超时过期时间
+
+##### taskDetail
+
+> **taskDetail**: `string`
+
+模板对应的数据的 JSON 字符串
+
+##### taskId
+
+> **taskId**: `string`
+
+任务 ID
+
+##### taskStatus
+
+> **taskStatus**: [`TaskStatus`](doubao-apps-sdk-open-api.md#taskstatus-2)
+
+任务状态，运行中或已完成
+
+##### taskTemplate
+
+> **taskTemplate**: `"remote_normal_v1"`
+
+任务样式模板，当前仅支持 remote_normal_v1
+
+##### taskType
+
+> **taskType**: [`TaskType`](doubao-apps-sdk-open-api.md#tasktype-2)
+
+任务类型，local 或 remote
+
+##### token?
+
+> `optional` **token**: `string`
+
+每次更新后旧的 token 失效，必须使用新返回的 token
+
+***
+
 ### GetWifiListResult
 
 获取 Wi-Fi 列表的返回结果。
@@ -5113,6 +6057,34 @@ Whether the login is successful
 
 ***
 
+### MkdirParams
+
+[FileSystemManager.mkdir](doubao-apps-sdk-open-api.md#mkdir) 的参数。
+
+#### Properties
+
+##### dirPath
+
+> **dirPath**: `string`
+
+要创建的目录路径。
+
+##### recursive?
+
+> `optional` **recursive**: `boolean`
+
+是否递归创建该目录的上级目录。
+
+设为 `true` 时，即使中间路径不存在也会一并创建（类似 `mkdir -p`）。
+
+###### Default
+
+```ts
+false
+```
+
+***
+
 ### NavigateBackParams
 
 #### Properties
@@ -5373,41 +6345,135 @@ Login result, true means success, false means failure
 
 ***
 
-### PrivacySettingResult
+### PrivacySettingResult
+
+#### Properties
+
+##### needAuthorization
+
+> **needAuthorization**: `boolean`
+
+Whether user authorization for privacy agreement is required
+
+***
+
+### ReadBLECharacteristicValueParams
+
+读取 BLE 特征值的请求参数。
+
+#### Properties
+
+##### characteristicId
+
+> **characteristicId**: `string`
+
+特征值 ID。
+
+##### deviceId
+
+> **deviceId**: `string`
+
+蓝牙设备 ID。
+
+##### serviceId
+
+> **serviceId**: `string`
+
+服务 ID。
+
+***
+
+### ReadFileParams
+
+[FileSystemManager.readFile](doubao-apps-sdk-open-api.md#readfile) 的参数。
+
+#### Properties
+
+##### encoding?
+
+> `optional` **encoding**: `"base64"` \| `"utf-8"`
+
+指定读取文件的字符编码。
+
+- `'utf-8'`：以 UTF-8 字符串形式返回文件内容。
+- `'base64'`：以 Base64 编码字符串形式返回文件内容，适用于二进制文件。
+
+###### Default
+
+```ts
+'utf-8'
+```
+
+##### filePath
+
+> **filePath**: `string`
+
+要读取的文件路径（本地路径）。
+
+***
+
+### ReadFileResult
+
+[FileSystemManager.readFile](doubao-apps-sdk-open-api.md#readfile) 的返回结果。
+
+#### Properties
+
+##### data
+
+> **data**: `string`
+
+文件内容。
+
+具体格式由 [ReadFileParams.encoding](doubao-apps-sdk-open-api.md#encoding-1) 决定：
+- 编码为 `'utf-8'` 时返回 UTF-8 字符串；
+- 编码为 `'base64'` 时返回 Base64 编码后的字符串。
+
+***
+
+### ReaddirParams
+
+[FileSystemManager.readdir](doubao-apps-sdk-open-api.md#readdir) 的参数。
 
 #### Properties
 
-##### needAuthorization
+##### dirPath
 
-> **needAuthorization**: `boolean`
+> **dirPath**: `string`
 
-Whether user authorization for privacy agreement is required
+要读取的目录路径。
 
 ***
 
-### ReadBLECharacteristicValueParams
+### ReaddirResult
 
-读取 BLE 特征值的请求参数。
+[FileSystemManager.readdir](doubao-apps-sdk-open-api.md#readdir) 的返回结果。
 
 #### Properties
 
-##### characteristicId
+##### files
 
-> **characteristicId**: `string`
+> **files**: `string`[]
 
-特征值 ID。
+目录下的文件和子目录名称列表（不含 `.` 和 `..`）。
 
-##### deviceId
+***
 
-> **deviceId**: `string`
+### RemoveSavedFileParams
 
-蓝牙设备 ID。
+[FileSystemManager.removeSavedFile](doubao-apps-sdk-open-api.md#removesavedfile) 的参数。
 
-##### serviceId
+#### Remarks
 
-> **serviceId**: `string`
+- 该接口用于删除通过 [FileSystemManager.saveFile](doubao-apps-sdk-open-api.md#savefile) 保存的本地文件。
+- 对非已保存文件调用该接口可能会失败。
 
-服务 ID。
+#### Properties
+
+##### filePath
+
+> **filePath**: `string`
+
+需要删除的已保存文件路径（应为 [SaveFileResult.savedFilePath](doubao-apps-sdk-open-api.md#savedfilepath) 返回的路径）。
 
 ***
 
@@ -5423,6 +6489,31 @@ Whether user authorization for privacy agreement is required
 
 ***
 
+### RenameParams
+
+[FileSystemManager.rename](doubao-apps-sdk-open-api.md#rename) 的参数。
+
+#### Remarks
+
+- 可用于重命名文件或将文件移动到同一文件系统中的其他路径。
+- 如果目标路径已存在同名文件，行为取决于宿主实现（通常会覆盖）。
+
+#### Properties
+
+##### newPath
+
+> **newPath**: `string`
+
+新文件路径（即重命名或移动后的目标路径）。
+
+##### oldPath
+
+> **oldPath**: `string`
+
+源文件路径（即当前文件路径）。
+
+***
+
 ### ReportEventParams
 
 上报数据分析事件的请求参数。
@@ -5622,6 +6713,76 @@ HTTP 状态码。
 
 ***
 
+### RmdirParams
+
+[FileSystemManager.rmdir](doubao-apps-sdk-open-api.md#rmdir) 的参数。
+
+#### Properties
+
+##### dirPath
+
+> **dirPath**: `string`
+
+要删除的目录路径。
+
+##### recursive?
+
+> `optional` **recursive**: `boolean`
+
+是否递归删除目录下的所有子文件和子目录。
+
+设为 `false` 时，仅当目录为空才能删除成功；设为 `true` 时会递归删除所有内容。
+
+###### Default
+
+```ts
+false
+```
+
+***
+
+### SaveFileParams
+
+[FileSystemManager.saveFile](doubao-apps-sdk-open-api.md#savefile) 的参数。
+
+#### Remarks
+
+- 该接口用于将临时文件保存到本地持久化存储。临时文件在应用退出后可能被系统清理，
+  通过 `saveFile` 保存后的文件将不会被自动清理。
+- 保存成功后原临时文件会被移除。
+
+#### Properties
+
+##### filePath?
+
+> `optional` **filePath**: `string`
+
+保存到的目标文件路径。
+
+若不指定，则由宿主决定存储位置并通过 [SaveFileResult.savedFilePath](doubao-apps-sdk-open-api.md#savedfilepath) 返回。
+
+##### tempFilePath
+
+> **tempFilePath**: `string`
+
+临时文件路径（需先通过下载或其他方式获得的临时文件路径）。
+
+***
+
+### SaveFileResult
+
+[FileSystemManager.saveFile](doubao-apps-sdk-open-api.md#savefile) 的返回结果。
+
+#### Properties
+
+##### savedFilePath
+
+> **savedFilePath**: `string`
+
+文件保存后的实际存储路径。
+
+***
+
 ### SaveImageToPhotosAlbumParams
 
 保存图片到系统相册的请求参数。
@@ -5862,7 +7023,7 @@ HTTP 状态码。
 
 ### SetWifiListParams
 
-设置 Wi-Fi 预设列表的请求参数。
+设置 Wi-Fi 预设列表的请求参数（iOS 特有）。
 
 #### Properties
 
@@ -6496,6 +7657,113 @@ iOS 下是否忽略蓝牙可用性校验。
 
 ***
 
+### StatParams
+
+[FileSystemManager.stat](doubao-apps-sdk-open-api.md#stat) 的参数。
+
+#### Properties
+
+##### path
+
+> **path**: `string`
+
+要获取状态信息的文件或目录路径。
+
+***
+
+### StatResult
+
+[FileSystemManager.stat](doubao-apps-sdk-open-api.md#stat) 的返回结果。
+
+#### Properties
+
+##### isDirectory
+
+> **isDirectory**: `boolean`
+
+判断当前路径是否是一个目录。
+
+##### lastModifiedTime
+
+> **lastModifiedTime**: `number`
+
+文件最近一次被修改的时间戳，单位为毫秒。
+
+##### size
+
+> **size**: `number`
+
+文件大小，单位为字节（Byte）。
+
+***
+
+### TruncateParams
+
+[FileSystemManager.truncate](doubao-apps-sdk-open-api.md#truncate) 的参数。
+
+#### Properties
+
+##### filePath
+
+> **filePath**: `string`
+
+要截断的文件路径。
+
+##### length?
+
+> `optional` **length**: `number`
+
+截断后的文件字节长度。
+
+- 若 `length` 小于文件原始长度，文件将被截取到指定长度，多余部分丢弃。
+- 若 `length` 大于文件原始长度，文件将被扩展到指定长度，扩展部分用 `\0` 填充。
+
+###### Default
+
+```ts
+0
+```
+
+***
+
+### UnlinkParams
+
+[FileSystemManager.unlink](doubao-apps-sdk-open-api.md#unlink) 的参数。
+
+#### Properties
+
+##### filePath
+
+> **filePath**: `string`
+
+要删除的文件路径。
+
+该接口只能删除文件，不能删除目录；删除目录应使用 [FileSystemManager.rmdir](doubao-apps-sdk-open-api.md#rmdir)。
+
+***
+
+### UnzipParams
+
+[FileSystemManager.unzip](doubao-apps-sdk-open-api.md#unzip) 的参数。
+
+#### Properties
+
+##### targetPath
+
+> **targetPath**: `string`
+
+解压后的目标目录路径。
+
+目标目录须已存在，否则解压会失败。
+
+##### zipFilePath
+
+> **zipFilePath**: `string`
+
+要解压的 zip 文件路径。
+
+***
+
 ### UpdateModelContextParams
 
 #### Properties
@@ -6520,6 +7788,58 @@ iOS 下是否忽略蓝牙可用性校验。
 
 ***
 
+### UpdateTaskParams
+
+更新任务的请求参数。
+
+#### Properties
+
+##### taskDetail?
+
+> `optional` **taskDetail**: `string`
+
+模板对应的数据的 JSON 字符串，与 taskStatus 二选一
+
+##### taskId
+
+> **taskId**: `string`
+
+任务 ID
+
+##### taskStatus?
+
+> `optional` **taskStatus**: [`TaskStatus`](doubao-apps-sdk-open-api.md#taskstatus-2)
+
+任务状态，与 taskDetail 二选一
+
+***
+
+### UpdateTaskResult
+
+更新任务的返回结果。
+
+#### Properties
+
+##### expiresIn?
+
+> `optional` **expiresIn**: `number`
+
+任务超时过期时间
+
+##### nextToken?
+
+> `optional` **nextToken**: `string`
+
+每次更新后旧的 token 失效，必须使用新返回的 token
+
+##### taskId
+
+> **taskId**: `string`
+
+任务 ID，更新后任务 ID 不变
+
+***
+
 ### UpdateWidgetParams
 
 #### Properties
@@ -6564,6 +7884,20 @@ iOS 下是否忽略蓝牙可用性校验。
 
 ***
 
+### WifiConnectedEvent
+
+Wi-Fi 连接事件。
+
+#### Properties
+
+##### wifi
+
+> **wifi**: [`WifiInfo`](doubao-apps-sdk-open-api.md#wifiinfo)
+
+已连接的 Wi-Fi 信息。
+
+***
+
 ### WifiInfo
 
 Wi-Fi 信息。
@@ -6706,6 +8040,46 @@ Wi-Fi SSID。
 
 写入模式。
 
+***
+
+### WriteFileParams
+
+[FileSystemManager.writeFile](doubao-apps-sdk-open-api.md#writefile) 的参数。
+
+#### Remarks
+
+- 如果文件不存在会自动创建；如果文件已存在则会覆盖原有内容。
+- 父目录不存在时写入会失败，需先通过 [FileSystemManager.mkdir](doubao-apps-sdk-open-api.md#mkdir) 创建目录。
+
+#### Properties
+
+##### data
+
+> **data**: `string`
+
+要写入的内容。
+
+- 当 `encoding` 为 `'utf-8'` 时，直接写入该字符串；
+- 当 `encoding` 为 `'base64'` 时，将该字符串先进行 Base64 解码再写入文件。
+
+##### encoding?
+
+> `optional` **encoding**: `"base64"` \| `"utf-8"`
+
+指定写入文件的字符编码。
+
+###### Default
+
+```ts
+'utf-8'
+```
+
+##### filePath
+
+> **filePath**: `string`
+
+要写入的文件路径（本地路径）。
+
 ## Type Aliases
 
 ### AccelerometerChangeListener()
@@ -7001,6 +8375,36 @@ Widget 登录类型。
 
 ***
 
+### TaskStatus
+
+> **TaskStatus**: `"running"` \| `"completed"`
+
+任务状态。
+
+running 表示任务运行中，completed 表示任务已完成。
+
+***
+
+### TaskTemplate
+
+> **TaskTemplate**: `"remote_normal_v1"`
+
+任务样式模板。
+
+当前仅支持 remote_normal_v1。
+
+***
+
+### TaskType
+
+> **TaskType**: `"local"` \| `"remote"`
+
+任务类型。
+
+local 表示本地任务，remote 表示远端任务。
+
+***
+
 ### UserCaptureScreenListener()
 
 > **UserCaptureScreenListener**: (`event`) => `void`
@@ -7023,6 +8427,22 @@ Widget 登录类型。
 
 短震动类型。
 
+***
+
+### WifiConnectedListener()
+
+> **WifiConnectedListener**: (`event`) => `void`
+
+Wi-Fi 连接事件监听函数。
+
+#### Parameters
+
+• **event**: [`WifiConnectedEvent`](doubao-apps-sdk-open-api.md#wificonnectedevent)
+
+#### Returns
+
+`void`
+
 ## Variables
 
 ### LoginType