@windypro-rourou/dsh-eda 0.1.3 → 0.1.5

package/skill/references/classes/SYS_FileSystem.md

@@ -1,1171 +1,1366 @@
-# SYS\_FileSystem class
-
-System / file system interaction class
-
-## Signature
-
-```typescript
-class SYS_FileSystem
-```
-
-## Remarks
-
-## Methods
-
-<table><thead><tr><th>
-
-Method
-
-</th><th>
-
-Modifiers
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[createDirectoryInFileSystem(folderPath)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** In file system in create folder
-
-</td></tr>
-<tr><td>
-
-[createObjectURL(blob)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-Create ObjectURL
-
-</td></tr>
-<tr><td>
-
-[deleteFileInFileSystem(uri, force)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Delete a file in the file system
-
-</td></tr>
-<tr><td>
-
-[existsPathInFileSystem(uri)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Check whether a file or directory exists in the file system
-
-</td></tr>
-<tr><td>
-
-[getDocumentsPath()](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get the document directory path
-
-</td></tr>
-<tr><td>
-
-[getEdaPath()](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get the EDA document directory path
-
-</td></tr>
-<tr><td>
-
-[getExtensionFile(uri)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-Get a file from the extension
-
-</td></tr>
-<tr><td>
-
-[getLibrariesPaths()](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get the library directory paths
-
-</td></tr>
-<tr><td>
-
-[getProjectsPaths()](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get the project directory paths
-
-</td></tr>
-<tr><td>
-
-[listFilesOfFileSystem(folderPath, recursive)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** View the file list under a file system path
-
-</td></tr>
-<tr><td>
-
-[openReadFileDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Open the read-file dialog
-
-</td></tr>
-<tr><td>
-
-[openReadFileDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Open the read-file dialog
-
-</td></tr>
-<tr><td>
-
-[openReadFolderDialog()](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Open the read-folder dialog
-
-</td></tr>
-<tr><td>
-
-[readFileFromFileSystem(uri)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Read a file from the file system
-
-</td></tr>
-<tr><td>
-
-[revokeObjectURL(url)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-Revoke the ObjectURL
-
-</td></tr>
-<tr><td>
-
-[saveFile(fileData, fileName)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-Save File
-
-</td></tr>
-<tr><td>
-
-[saveFileToFileSystem(uri, fileData, fileName, force)](./SYS_FileSystem.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Write a file to the file system
-
-</td></tr>
-</tbody></table>
-
----
-
-## 方法详情
-
-### createdirectoryinfilesystem
-
-# SYS\_FileSystem.createDirectoryInFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-In file system in create folder
-
-## Signature
-
-```typescript
-function createDirectoryInFileSystem(folderPath: string): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-folderPath
-
-</td><td>
-
-string
-
-</td><td>
-
-Folder path
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Create Whether the operation is successful
-
-## Remarks
-
-Supports recursively creating multi-level directories
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error` ADD since EDA v3.2.166
-
-### createobjecturl
-
-# SYS\_FileSystem.createObjectURL() method
-
-Create ObjectURL
-
-## Signature
-
-```typescript
-function createObjectURL(blob: Blob | File): string;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-blob
-
-</td><td>
-
-Blob \| File
-
-</td><td>
-
-Blob or File object
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-string
-
-ObjectURL string
-
-## Remarks
-
-Create an ObjectURL pointing to the passed-in Blob / File object ADD since EDA v3.2.162
-
-## Example
-
-```javascript
-// 1. 构造一段文本数据
-const blob = new Blob(['嘉立创示例数据'], { type: 'text/plain' });
-
-// 2. 创建 ObjectURL（同步方法，直接返回字符串）
-const url = eda.sys_FileSystem.createObjectURL(blob);
-
-console.log('ObjectURL：', url);
-```
-
-### deletefileinfilesystem
-
-# SYS\_FileSystem.deleteFileInFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Delete a file in the file system
-
-## Signature
-
-```typescript
-function deleteFileInFileSystem(uri: string, force?: boolean): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uri
-
-</td><td>
-
-string
-
-</td><td>
-
-File resource locator. If it ends with a slash `/` (a backslash `\` on Windows), it is recognized as a folder; if it does not end with a slash, it is recognized as a complete file name, in which case the `fileName` parameter is ignored
-
-</td></tr>
-<tr><td>
-
-force
-
-</td><td>
-
-boolean
-
-</td><td>
-
-_(Optional)_ Force delete the folder (whether to force delete the folder when the target is a folder containing files)
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Delete Whether the operation is successful
-
-## Remarks
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### existspathinfilesystem
-
-# SYS\_FileSystem.existsPathInFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Check whether a file or directory exists in the file system
-
-## Signature
-
-```typescript
-function existsPathInFileSystem(uri: string): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uri
-
-</td><td>
-
-string
-
-</td><td>
-
-File resource locator. An absolute path containing the complete file name is required
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Whether the file or directory exists
-
-## Remarks
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error` ADD since EDA v3.2.167
-
-### getdocumentspath
-
-# SYS\_FileSystem.getDocumentsPath() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Get the document directory path
-
-## Signature
-
-```typescript
-function getDocumentsPath(): Promise<string>;
-```
-
-## Returns
-
-Promise&lt;string&gt;
-
-Document directory path
-
-## Remarks
-
-In the returned path, the end does not contain a slash `/` (or a backslash `\`<!-- -->)
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### getedapath
-
-# SYS\_FileSystem.getEdaPath() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Get the EDA document directory path
-
-## Signature
-
-```typescript
-function getEdaPath(): Promise<string>;
-```
-
-## Returns
-
-Promise&lt;string&gt;
-
-EDA document directory path
-
-## Remarks
-
-In the returned path, the end does not contain a slash `/` (or a backslash `\`<!-- -->)
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### getextensionfile
-
-# SYS\_FileSystem.getExtensionFile() method
-
-Get a file from the extension
-
-## Signature
-
-```typescript
-function getExtensionFile(uri: string): Promise<File | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uri
-
-</td><td>
-
-string
-
-</td><td>
-
-File path
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;File \| undefined&gt;
-
-File format file
-
-## Example
-
-```javascript
-// 1. 读取扩展安装目录下的 extension.json
-const file = await eda.sys_FileSystem.getExtensionFile('extension.json');
-
-// 2. 输出文件信息（size 单位为字节，内容可用 file.text() 读取）
-console.log('文件名：', file.name);
-console.log('文件大小：', file.size);
-```
-
-### getlibrariespaths
-
-# SYS\_FileSystem.getLibrariesPaths() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Get the library directory paths
-
-## Signature
-
-```typescript
-function getLibrariesPaths(): Promise<Array<string>>;
-```
-
-## Returns
-
-Promise&lt;Array&lt;string&gt;&gt;
-
-Array of library directory paths
-
-## Remarks
-
-Note 1: This API is only valid for fully offline clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### getprojectspaths
-
-# SYS\_FileSystem.getProjectsPaths() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Get the project directory paths
-
-## Signature
-
-```typescript
-function getProjectsPaths(): Promise<Array<string>>;
-```
-
-## Returns
-
-Promise&lt;Array&lt;string&gt;&gt;
-
-Array of project directory paths
-
-## Remarks
-
-Note 1: This API is only valid for semi-offline and fully offline clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### listfilesoffilesystem
-
-# SYS\_FileSystem.listFilesOfFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-View the file list under a file system path
-
-## Signature
-
-```typescript
-function listFilesOfFileSystem(
-	folderPath: string,
-	recursive?: boolean,
-): Promise<Array<ISYS_FileSystemFileList>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-folderPath
-
-</td><td>
-
-string
-
-</td><td>
-
-Directory path
-
-</td></tr>
-<tr><td>
-
-recursive
-
-</td><td>
-
-boolean
-
-</td><td>
-
-_(Optional)_ Whether to recursively get all sub-files
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;Array&lt;[ISYS\_FileSystemFileList](../interfaces/ISYS_FileSystemFileList.md)<!-- -->&gt;&gt;
-
-File list in the current directory
-
-## Remarks
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### openreadfiledialog
-
-# SYS\_FileSystem.openReadFileDialog() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Open the read-file dialog
-
-## Signature
-
-```typescript
-function openReadFileDialog(
-	filenameExtensions?: string | Array<string>,
-	multiFiles?: true,
-): Promise<Array<File> | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-filenameExtensions
-
-</td><td>
-
-string \| Array&lt;string&gt;
-
-</td><td>
-
-_(Optional)_ File extension
-
-</td></tr>
-<tr><td>
-
-multiFiles
-
-</td><td>
-
-true
-
-</td><td>
-
-_(Optional)_ Whether multiple files are allowed to be read
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;Array&lt;File&gt; \| undefined&gt;
-
-File format file array
-
-## Example
-
-```javascript
-// 1. 打开选择窗口（限定 .json 文件，单选；用户选择前 Promise 一直挂起）
-eda.sys_FileSystem.openReadFileDialog('.json').then((file) => {
-	// 用户完成选择后触发；直接关闭窗口时 file 为 undefined
-	if (file) {
-		console.log('已选择文件：', file.name);
-	}
-});
-
-// 2. 窗口已弹出，主流程不等待用户操作
-console.log('已打开文件选择窗口');
-```
-
-### openreadfiledialog_1
-
-# SYS\_FileSystem.openReadFileDialog() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Open the read-file dialog
-
-## Signature
-
-```typescript
-function openReadFileDialog(
-	filenameExtensions?: string | Array<string>,
-	multiFiles?: false,
-): Promise<File | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-filenameExtensions
-
-</td><td>
-
-string \| Array&lt;string&gt;
-
-</td><td>
-
-_(Optional)_ File extension
-
-</td></tr>
-<tr><td>
-
-multiFiles
-
-</td><td>
-
-false
-
-</td><td>
-
-_(Optional)_ Whether multiple files are allowed to be read
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;File \| undefined&gt;
-
-File format file
-
-### openreadfolderdialog
-
-# SYS\_FileSystem.openReadFolderDialog() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Open the read-folder dialog
-
-## Signature
-
-```typescript
-function openReadFolderDialog(): Promise<Array<{ relativePath: string; file: File }>>;
-```
-
-## Returns
-
-Promise&lt;Array&lt;{ relativePath: string; file: File }&gt;&gt;
-
-All read files and their path information
-
-## Remarks
-
-developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory \| MDN<!-- -->} ADD since EDA v4.2
-
-### readfilefromfilesystem
-
-# SYS\_FileSystem.readFileFromFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Read a file from the file system
-
-## Signature
-
-```typescript
-function readFileFromFileSystem(uri: string): Promise<File | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uri
-
-</td><td>
-
-string
-
-</td><td>
-
-File resource locator. An absolute path containing the complete file name is required
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;File \| undefined&gt;
-
-File format file
-
-## Remarks
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
-
-### revokeobjecturl
-
-# SYS\_FileSystem.revokeObjectURL() method
-
-Revoke the ObjectURL
-
-## Signature
-
-```typescript
-function revokeObjectURL(url: string): void;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-url
-
-</td><td>
-
-string
-
-</td><td>
-
-ObjectURL string
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-void
-
-## Remarks
-
-Revoke the specified ObjectURL ADD since EDA v3.2.162
-
-## Example
-
-```javascript
-// 1. 先创建一个 ObjectURL
-const blob = new Blob(['嘉立创示例数据']);
-const url = eda.sys_FileSystem.createObjectURL(blob);
-console.log('创建的 ObjectURL：', url);
-
-// 2. 用完后吊销（同步方法，无返回值）
-eda.sys_FileSystem.revokeObjectURL(url);
-console.log('已吊销');
-```
-
-### savefile
-
-# SYS\_FileSystem.saveFile() method
-
-Save File
-
-## Signature
-
-```typescript
-function saveFile(fileData: File | Blob, fileName?: string): Promise<void>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-fileData
-
-</td><td>
-
-File \| Blob
-
-</td><td>
-
-File data
-
-</td></tr>
-<tr><td>
-
-fileName
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ File name
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;void&gt;
-
-## Remarks
-
-Calls the browser download API or the Electron save-file API to save the passed-in file stream locally
-
-## Example
-
-```javascript
-// 1. 构造要保存的 CSV 内容
-const content = '编号,器件,数量\n1,C0402,10\n2,C0603,20';
-const blob = new Blob([content], { type: 'text/csv' });
-
-// 2. 保存到本地（完成后 Promise 才结束）
-await eda.sys_FileSystem.saveFile(blob, '嘉立创示例_BOM导出.csv');
-
-console.log('已保存文件：', '嘉立创示例_BOM导出.csv', blob.size, '字节');
-```
-
-### savefiletofilesystem
-
-# SYS\_FileSystem.saveFileToFileSystem() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-
-Write a file to the file system
-
-## Signature
-
-```typescript
-function saveFileToFileSystem(
-	uri: string,
-	fileData: File | Blob,
-	fileName?: string,
-	force?: boolean,
-): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-uri
-
-</td><td>
-
-string
-
-</td><td>
-
-File resource locator. If it ends with a slash `/` (a backslash `\` on Windows), it is recognized as a folder; if it does not end with a slash, it is recognized as a complete file name, in which case the `fileName` parameter is ignored
-
-</td></tr>
-<tr><td>
-
-fileData
-
-</td><td>
-
-File \| Blob
-
-</td><td>
-
-File data
-
-</td></tr>
-<tr><td>
-
-fileName
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ File name
-
-</td></tr>
-<tr><td>
-
-force
-
-</td><td>
-
-boolean
-
-</td><td>
-
-_(Optional)_ Force write (overwrite the file if it exists)
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Whether the write operation was successful. If overwriting is not allowed but the file already exists, `false` is returned
-
-## Remarks
-
-Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
-
-Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+# SYS\_FileSystem class
+
+System / file system interaction class
+
+## Signature
+
+```typescript
+class SYS_FileSystem
+```
+
+## Remarks
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Modifiers
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[createDirectoryInFileSystem(folderPath)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** In file system in create folder
+
+</td></tr>
+<tr><td>
+
+[createObjectURL(blob)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+Create ObjectURL
+
+</td></tr>
+<tr><td>
+
+[deleteFileInFileSystem(uri, force)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Delete a file in the file system
+
+</td></tr>
+<tr><td>
+
+[existsPathInFileSystem(uri)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Check whether a file or directory exists in the file system
+
+</td></tr>
+<tr><td>
+
+[getDocumentsPath()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the document directory path
+
+</td></tr>
+<tr><td>
+
+[getEdaPath()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the EDA document directory path
+
+</td></tr>
+<tr><td>
+
+[getExtensionFile(uri)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+Get a file from the extension
+
+</td></tr>
+<tr><td>
+
+[getLibrariesPaths()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the library directory paths
+
+</td></tr>
+<tr><td>
+
+[getProjectsPaths()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the project directory paths
+
+</td></tr>
+<tr><td>
+
+[listFilesOfFileSystem(folderPath, recursive)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** View the file list under a file system path
+
+</td></tr>
+<tr><td>
+
+[openReadFileDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Open the read-file dialog
+
+</td></tr>
+<tr><td>
+
+[openReadFileDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Open the read-file dialog
+
+</td></tr>
+<tr><td>
+
+[openReadFilePathDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** 打开读取文件路径窗口
+
+</td></tr>
+<tr><td>
+
+[openReadFilePathDialog(filenameExtensions, multiFiles)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** 打开读取文件路径窗口
+
+</td></tr>
+<tr><td>
+
+[openReadFolderDialog()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Open the read-folder dialog
+
+</td></tr>
+<tr><td>
+
+[openReadFolderPathDialog()](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** 打开读取目录路径窗口
+
+</td></tr>
+<tr><td>
+
+[readFileFromFileSystem(uri)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Read a file from the file system
+
+</td></tr>
+<tr><td>
+
+[revokeObjectURL(url)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+Revoke the ObjectURL
+
+</td></tr>
+<tr><td>
+
+[saveFile(fileData, fileName)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+Save File
+
+</td></tr>
+<tr><td>
+
+[saveFileToFileSystem(uri, fileData, fileName)](./SYS_FileSystem.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Write a file to the file system
+
+</td></tr>
+</tbody></table>
+
+---
+
+## 方法详情
+
+### createdirectoryinfilesystem
+
+# SYS\_FileSystem.createDirectoryInFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+In file system in create folder
+
+## Signature
+
+```typescript
+function createDirectoryInFileSystem(folderPath: string): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+folderPath
+
+</td><td>
+
+string
+
+</td><td>
+
+Folder path
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean&gt;
+
+Create Whether the operation is successful
+
+## Remarks
+
+Supports recursively creating multi-level directories
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error` ADD since EDA v3.2.166
+
+### createobjecturl
+
+# SYS\_FileSystem.createObjectURL() method
+
+Create ObjectURL
+
+## Signature
+
+```typescript
+function createObjectURL(blob: Blob | File): string;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+blob
+
+</td><td>
+
+Blob \| File
+
+</td><td>
+
+Blob or File object
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+string
+
+ObjectURL string
+
+## Remarks
+
+Create an ObjectURL pointing to the passed-in Blob / File object ADD since EDA v3.2.162
+
+## Example
+
+```javascript
+// 1. 构造一段文本数据
+const blob = new Blob(['嘉立创示例数据'], { type: 'text/plain' });
+
+// 2. 创建 ObjectURL（同步方法，直接返回字符串）
+const url = eda.sys_FileSystem.createObjectURL(blob);
+
+console.log('ObjectURL：', url);
+```
+
+### deletefileinfilesystem
+
+# SYS\_FileSystem.deleteFileInFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Delete a file in the file system
+
+## Signature
+
+```typescript
+function deleteFileInFileSystem(uri: string, force?: boolean): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uri
+
+</td><td>
+
+string
+
+</td><td>
+
+File resource locator. If it ends with a slash `/` (a backslash `\` on Windows), it is recognized as a folder; if it does not end with a slash, it is recognized as a complete file name, in which case the `fileName` parameter is ignored
+
+</td></tr>
+<tr><td>
+
+force
+
+</td><td>
+
+boolean
+
+</td><td>
+
+_(Optional)_ Force delete the folder (whether to force delete the folder when the target is a folder containing files)
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean&gt;
+
+Delete Whether the operation is successful
+
+## Remarks
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### existspathinfilesystem
+
+# SYS\_FileSystem.existsPathInFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Check whether a file or directory exists in the file system
+
+## Signature
+
+```typescript
+function existsPathInFileSystem(uri: string): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uri
+
+</td><td>
+
+string
+
+</td><td>
+
+File resource locator. An absolute path containing the complete file name is required
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean&gt;
+
+Whether the file or directory exists
+
+## Remarks
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error` ADD since EDA v3.2.167
+
+### getdocumentspath
+
+# SYS\_FileSystem.getDocumentsPath() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the document directory path
+
+## Signature
+
+```typescript
+function getDocumentsPath(): Promise<string>;
+```
+
+## Returns
+
+Promise&lt;string&gt;
+
+Document directory path
+
+## Remarks
+
+In the returned path, the end does not contain a slash `/` (or a backslash `\`<!-- -->)
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### getedapath
+
+# SYS\_FileSystem.getEdaPath() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the EDA document directory path
+
+## Signature
+
+```typescript
+function getEdaPath(): Promise<string>;
+```
+
+## Returns
+
+Promise&lt;string&gt;
+
+EDA document directory path
+
+## Remarks
+
+In the returned path, the end does not contain a slash `/` (or a backslash `\`<!-- -->)
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### getextensionfile
+
+# SYS\_FileSystem.getExtensionFile() method
+
+Get a file from the extension
+
+## Signature
+
+```typescript
+function getExtensionFile(uri: string): Promise<File | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uri
+
+</td><td>
+
+string
+
+</td><td>
+
+File path
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;File \| undefined&gt;
+
+File format file
+
+## Example
+
+```javascript
+// 1. 读取扩展安装目录下的 extension.json
+const file = await eda.sys_FileSystem.getExtensionFile('extension.json');
+
+// 2. 输出文件信息（size 单位为字节，内容可用 file.text() 读取）
+console.log('文件名：', file.name);
+console.log('文件大小：', file.size);
+```
+
+### getlibrariespaths
+
+# SYS\_FileSystem.getLibrariesPaths() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the library directory paths
+
+## Signature
+
+```typescript
+function getLibrariesPaths(): Promise<Array<string>>;
+```
+
+## Returns
+
+Promise&lt;Array&lt;string&gt;&gt;
+
+Array of library directory paths
+
+## Remarks
+
+Note 1: This API is only valid for fully offline clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### getprojectspaths
+
+# SYS\_FileSystem.getProjectsPaths() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Get the project directory paths
+
+## Signature
+
+```typescript
+function getProjectsPaths(): Promise<Array<string>>;
+```
+
+## Returns
+
+Promise&lt;Array&lt;string&gt;&gt;
+
+Array of project directory paths
+
+## Remarks
+
+Note 1: This API is only valid for semi-offline and fully offline clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### listfilesoffilesystem
+
+# SYS\_FileSystem.listFilesOfFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+View the file list under a file system path
+
+## Signature
+
+```typescript
+function listFilesOfFileSystem(
+	folderPath: string,
+	recursive?: boolean,
+): Promise<Array<ISYS_FileSystemFileList>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+folderPath
+
+</td><td>
+
+string
+
+</td><td>
+
+Directory path
+
+</td></tr>
+<tr><td>
+
+recursive
+
+</td><td>
+
+boolean
+
+</td><td>
+
+_(Optional)_ Whether to recursively get all sub-files
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;[ISYS\_FileSystemFileList](../interfaces/ISYS_FileSystemFileList.md)<!-- -->&gt;&gt;
+
+File list in the current directory
+
+## Remarks
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### openreadfiledialog
+
+# SYS\_FileSystem.openReadFileDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Open the read-file dialog
+
+## Signature
+
+```typescript
+function openReadFileDialog(
+	filenameExtensions?: string | Array<string>,
+	multiFiles?: true,
+): Promise<Array<File> | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+filenameExtensions
+
+</td><td>
+
+string \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ File extension
+
+</td></tr>
+<tr><td>
+
+multiFiles
+
+</td><td>
+
+true
+
+</td><td>
+
+_(Optional)_ Whether multiple files are allowed to be read
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;File&gt; \| undefined&gt;
+
+File format file array
+
+## Remarks
+
+本接口需要打开浏览器模态窗口，在用户于页面上进行最后一次操作的时间节点开始计算， 达到 5000ms（部分浏览器时效）后将无法使用 JavaScript 脚本唤起窗口，这是浏览器的限制
+
+## Example
+
+```javascript
+// 1. 打开选择窗口（限定 .json 文件，单选；用户选择前 Promise 一直挂起）
+eda.sys_FileSystem.openReadFileDialog('.json').then((file) => {
+	// 用户完成选择后触发；直接关闭窗口时 file 为 undefined
+	if (file) {
+		console.log('已选择文件：', file.name);
+	}
+});
+
+// 2. 窗口已弹出，主流程不等待用户操作
+console.log('已打开文件选择窗口');
+```
+
+### openreadfiledialog_1
+
+# SYS\_FileSystem.openReadFileDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Open the read-file dialog
+
+## Signature
+
+```typescript
+function openReadFileDialog(
+	filenameExtensions?: string | Array<string>,
+	multiFiles?: false,
+): Promise<File | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+filenameExtensions
+
+</td><td>
+
+string \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ File extension
+
+</td></tr>
+<tr><td>
+
+multiFiles
+
+</td><td>
+
+false
+
+</td><td>
+
+_(Optional)_ Whether multiple files are allowed to be read
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;File \| undefined&gt;
+
+File format file
+
+### openreadfilepathdialog
+
+# SYS\_FileSystem.openReadFilePathDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+打开读取文件路径窗口
+
+## Signature
+
+```typescript
+function openReadFilePathDialog(
+	filenameExtensions?: string | Array<string>,
+	multiFiles?: true,
+): Promise<Array<string>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+filenameExtensions
+
+</td><td>
+
+string \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ 文件扩展名
+
+</td></tr>
+<tr><td>
+
+multiFiles
+
+</td><td>
+
+true
+
+</td><td>
+
+_(Optional)_ 是否允许读取多文件；受客户端协议限制，当前仅支持单选，`multiFiles=true` 时将返回单元素数组
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;string&gt;&gt;
+
+文件路径数组
+
+## Remarks
+
+ADD since EDA v3.2.201 注意：本接口仅客户端有效，在浏览器环境内调用将始终 `throw Error`
+
+/ EDA v4.1.54
+
+### openreadfilepathdialog_1
+
+# SYS\_FileSystem.openReadFilePathDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+打开读取文件路径窗口
+
+## Signature
+
+```typescript
+function openReadFilePathDialog(
+	filenameExtensions?: string | Array<string>,
+	multiFiles?: false,
+): Promise<string | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+filenameExtensions
+
+</td><td>
+
+string \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ 文件扩展名
+
+</td></tr>
+<tr><td>
+
+multiFiles
+
+</td><td>
+
+false
+
+</td><td>
+
+_(Optional)_ 是否允许读取多文件；受客户端协议限制，当前仅支持单选，`multiFiles=true` 时将返回单元素数组
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+文件路径
+
+## Remarks
+
+ADD since EDA v3.2.201 注意：本接口仅客户端有效，在浏览器环境内调用将始终 `throw Error`
+
+/ EDA v4.1.54
+
+### openreadfolderdialog
+
+# SYS\_FileSystem.openReadFolderDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Open the read-folder dialog
+
+## Signature
+
+```typescript
+function openReadFolderDialog(): Promise<Array<{ relativePath: string; file: File }>>;
+```
+
+## Returns
+
+Promise&lt;Array&lt;{ relativePath: string; file: File }&gt;&gt;
+
+All read files and their path information
+
+## Remarks
+
+developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory \| MDN<!-- -->} ADD since EDA v4.2
+
+### openreadfolderpathdialog
+
+# SYS\_FileSystem.openReadFolderPathDialog() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+打开读取目录路径窗口
+
+## Signature
+
+```typescript
+function openReadFolderPathDialog(): Promise<string | undefined>;
+```
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+目录路径
+
+## Remarks
+
+ADD since EDA v3.2.201 注意：本接口仅客户端有效，在浏览器环境内调用将始终 `throw Error`
+
+/ EDA v4.1.54
+
+### readfilefromfilesystem
+
+# SYS\_FileSystem.readFileFromFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Read a file from the file system
+
+## Signature
+
+```typescript
+function readFileFromFileSystem(uri: string): Promise<File | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uri
+
+</td><td>
+
+string
+
+</td><td>
+
+File resource locator. An absolute path containing the complete file name is required
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;File \| undefined&gt;
+
+File format file
+
+## Remarks
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+### revokeobjecturl
+
+# SYS\_FileSystem.revokeObjectURL() method
+
+Revoke the ObjectURL
+
+## Signature
+
+```typescript
+function revokeObjectURL(url: string): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+url
+
+</td><td>
+
+string
+
+</td><td>
+
+ObjectURL string
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+void
+
+## Remarks
+
+Revoke the specified ObjectURL ADD since EDA v3.2.162
+
+## Example
+
+```javascript
+// 1. 先创建一个 ObjectURL
+const blob = new Blob(['嘉立创示例数据']);
+const url = eda.sys_FileSystem.createObjectURL(blob);
+console.log('创建的 ObjectURL：', url);
+
+// 2. 用完后吊销（同步方法，无返回值）
+eda.sys_FileSystem.revokeObjectURL(url);
+console.log('已吊销');
+```
+
+### savefile
+
+# SYS\_FileSystem.saveFile() method
+
+Save File
+
+## Signature
+
+```typescript
+function saveFile(fileData: File | Blob, fileName?: string): Promise<void>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+fileData
+
+</td><td>
+
+File \| Blob
+
+</td><td>
+
+File data
+
+</td></tr>
+<tr><td>
+
+fileName
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ File name
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;void&gt;
+
+## Remarks
+
+Calls the browser download API or the Electron save-file API to save the passed-in file stream locally
+
+## Example
+
+```javascript
+// 1. 构造要保存的 CSV 内容
+const content = '编号,器件,数量\n1,C0402,10\n2,C0603,20';
+const blob = new Blob([content], { type: 'text/csv' });
+
+// 2. 保存到本地（完成后 Promise 才结束）
+await eda.sys_FileSystem.saveFile(blob, '嘉立创示例_BOM导出.csv');
+
+console.log('已保存文件：', '嘉立创示例_BOM导出.csv', blob.size, '字节');
+```
+
+### savefiletofilesystem
+
+# SYS\_FileSystem.saveFileToFileSystem() method
+
+> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
+
+Write a file to the file system
+
+## Signature
+
+```typescript
+function saveFileToFileSystem(
+	uri: string,
+	fileData: File | Blob,
+	fileName?: string,
+): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+uri
+
+</td><td>
+
+string
+
+</td><td>
+
+File resource locator. If it ends with a slash `/` (a backslash `\` on Windows), it is recognized as a folder; if it does not end with a slash, it is recognized as a complete file name, in which case the `fileName` parameter is ignored
+
+</td></tr>
+<tr><td>
+
+fileData
+
+</td><td>
+
+File \| Blob
+
+</td><td>
+
+File data
+
+</td></tr>
+<tr><td>
+
+fileName
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ File name
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean&gt;
+
+Whether the write operation was successful. If overwriting is not allowed but the file already exists, `false` is returned
+
+## Remarks
+
+Note 1: This API is only valid for clients. Calling it in a browser environment will always `throw Error`
+
+Note 2: This API requires the user to enable the extension external interaction permission, if not enabled, it will always `throw Error`
+
+注意 3：CLI 本地文件写入\*\*不做路径白名单校验\*\*、不受 `APP_PROJECT_DIR` 限制；`uri` 结尾带斜杠 `/`<!-- -->（Windows 为反斜杠 `\`<!-- -->）识别为目录，`force` 控制是否覆盖已存在文件