@windypro-rourou/dsh-eda 0.1.4 → 0.1.5

package/skill/references/classes/LIB_Symbol.md

@@ -1,1195 +1,1341 @@
-# LIB\_Symbol class
-
-Comprehensive library / symbol class
-
-## Signature
-
-```typescript
-class LIB_Symbol
-```
-
-## Methods
-
-<table><thead><tr><th>
-
-Method
-
-</th><th>
-
-Modifiers
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[copy(symbolUuid, libraryUuid, targetLibraryUuid, targetClassification, newSymbolName)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Copy Symbol
-
-</td></tr>
-<tr><td>
-
-[create(libraryUuid, symbolName, classification, symbolType, description)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Create Symbol
-
-</td></tr>
-<tr><td>
-
-[delete(symbolUuid, libraryUuid)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Delete Symbol
-
-</td></tr>
-<tr><td>
-
-[get(symbolUuid, libraryUuid)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get all properties of the symbol
-
-</td></tr>
-<tr><td>
-
-[getRenderImage(source)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Get the symbol render image
-
-</td></tr>
-<tr><td>
-
-[modify(symbolUuid, libraryUuid, symbolName, classification, description)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Modify Symbol
-
-</td></tr>
-<tr><td>
-
-[openInEditor(symbolUuid, libraryUuid, splitScreenId)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Open in the editor document
-
-</td></tr>
-<tr><td>
-
-[search(key, libraryUuid, classification, symbolType, itemsOfPage, page)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Search symbol
-
-</td></tr>
-<tr><td>
-
-[searchByProperties(properties, libraryUuid)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Search symbols precisely by properties
-
-</td></tr>
-<tr><td>
-
-[updateDocumentSource(symbolUuid, libraryUuid, documentSource)](./LIB_Symbol.md)
-
-</td><td>
-
-</td><td>
-
-**_(BETA)_** Update the document source code of the symbol
-
-</td></tr>
-</tbody></table>
-
----
-
-## 方法详情
-
-### copy
-
-# LIB\_Symbol.copy() 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.
-
-Copy Symbol
-
-## Signature
-
-```typescript
-function copy(
-	symbolUuid: string,
-	libraryUuid: string,
-	targetLibraryUuid: string,
-	targetClassification?: ILIB_ClassificationIndex | Array<string>,
-	newSymbolName?: string,
-): Promise<string | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-targetLibraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Target library UUID
-
-</td></tr>
-<tr><td>
-
-targetClassification
-
-</td><td>
-
-[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
-
-</td><td>
-
-_(Optional)_ Classification in the target library
-
-</td></tr>
-<tr><td>
-
-newSymbolName
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ New symbol name. If a symbol with the same name exists in the target library, the copy will fail
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;string \| undefined&gt;
-
-UUID of the new symbol in the target library
-
-## Example
-
-```javascript
-// 1. 列出系统库符号（关键字传空 = 列出全部），取一个作为复制来源
-const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
-
-// 2. 获取个人库 UUID
-const targetLibraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-
-// 3. 从系统库复制到个人库，指定新名称避免同名冲突（分类传 [] = 不分类）
-const newName = `嘉立创示例_符号副本_${Date.now()}`;
-const copiedUuid = await eda.lib_Symbol.copy(
-	source.uuid,
-	source.libraryUuid,
-	targetLibraryUuid,
-	[],
-	newName
-);
-
-// 创建类保留现场（副本留在个人库中供观察）
-
-console.log('sourceUuid:', source.uuid);
-console.log('copiedUuid:', copiedUuid);
-console.log('newName:', newName);
-```
-
-### create
-
-# LIB\_Symbol.create() 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.
-
-Create Symbol
-
-## Signature
-
-```typescript
-function create(
-	libraryUuid: string,
-	symbolName: string,
-	classification?: ILIB_ClassificationIndex | Array<string>,
-	symbolType?: ELIB_SymbolType,
-	description?: string,
-): Promise<string | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-symbolName
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol name
-
-</td></tr>
-<tr><td>
-
-classification
-
-</td><td>
-
-[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
-
-</td><td>
-
-_(Optional)_ Classification
-
-</td></tr>
-<tr><td>
-
-symbolType
-
-</td><td>
-
-[ELIB\_SymbolType](../enums/ELIB_SymbolType.md)
-
-</td><td>
-
-_(Optional)_ Symbol type
-
-</td></tr>
-<tr><td>
-
-description
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Description
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;string \| undefined&gt;
-
-Symbol UUID
-
-## Example
-
-```javascript
-// 1. 获取个人库 UUID
-const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-
-// 2. 创建符号（分类传 [] = 不分类；符号类型 '1' = 原理图符号，见 ELIB_SymbolType）
-const symbolName = `嘉立创示例_新符号_${Date.now()}`;
-const symbolUuid = await eda.lib_Symbol.create(libraryUuid, symbolName, [], '1', '示例符号描述');
-
-// 创建类保留现场（新符号留在个人库中供观察）
-
-console.log('symbolUuid:', symbolUuid);
-console.log('symbolName:', symbolName);
-```
-
-### delete
-
-# LIB\_Symbol.delete() 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 Symbol
-
-## Signature
-
-```typescript
-function delete(symbolUuid: string, libraryUuid: string): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Whether the operation is successful
-
-## Example
-
-```javascript
-// 1. 获取个人库 UUID 并新建删除对象
-const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-const symbolUuid = await eda.lib_Symbol.create(libraryUuid, `嘉立创示例_待删除符号_${Date.now()}`, []);
-
-// 2. 删除该符号
-const deleted = await eda.lib_Symbol.delete(symbolUuid, libraryUuid);
-
-console.log('symbolUuid:', symbolUuid);
-console.log('deleted:', deleted);
-```
-
-### get
-
-# LIB\_Symbol.get() 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 all properties of the symbol
-
-## Signature
-
-```typescript
-function get(symbolUuid: string, libraryUuid?: string): Promise<ILIB_SymbolItem | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;[ILIB\_SymbolItem](../interfaces/ILIB_SymbolItem.md) \| undefined&gt;
-
-Symbol property
-
-### getrenderimage
-
-# LIB\_Symbol.getRenderImage() 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 symbol render image
-
-## Signature
-
-```typescript
-function getRenderImage(source: {
-	symbolUuid: string;
-	libraryUuid: string;
-	subPartName?: undefined | string;
-}): Promise<Blob | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-source
-
-</td><td>
-
-\{ symbolUuid: string; libraryUuid: string; subPartName?: undefined \| string \}
-
-</td><td>
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;Blob \| undefined&gt;
-
-Symbol render image
-
-## Example
-
-```javascript
-// 1. 列出系统库符号，取一个作为渲染来源
-const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
-
-// 2. 获取渲染图（PNG Blob）
-const blob = await eda.lib_Symbol.getRenderImage({
-	symbolUuid: source.uuid,
-	libraryUuid: source.libraryUuid,
-});
-
-// 3. Blob 可转成 URL 直接展示：URL.createObjectURL(blob)
-console.log('sourceName:', source.name);
-console.log('imageSize:', blob.size);
-console.log('imageType:', blob.type);
-```
-
-### modify
-
-# LIB\_Symbol.modify() 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.
-
-Modify Symbol
-
-## Signature
-
-```typescript
-function modify(
-	symbolUuid: string,
-	libraryUuid: string,
-	symbolName?: string,
-	classification?: ILIB_ClassificationIndex | Array<string> | null,
-	description?: string | null,
-): Promise<boolean>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-symbolName
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Symbol name
-
-</td></tr>
-<tr><td>
-
-classification
-
-</td><td>
-
-[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt; \| null
-
-</td><td>
-
-_(Optional)_ Classification
-
-</td></tr>
-<tr><td>
-
-description
-
-</td><td>
-
-string \| null
-
-</td><td>
-
-_(Optional)_ Description
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean&gt;
-
-Whether the operation is successful
-
-## Remarks
-
-If you want to clear certain properties, set their values to `null`
-
-## Example
-
-```javascript
-// 1. 获取个人库 UUID 并新建修改对象
-const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-const symbolUuid = await eda.lib_Symbol.create(
-	libraryUuid,
-	`嘉立创示例_符号修改前_${Date.now()}`,
-	[],
-	'1',
-	'修改前的描述'
-);
-
-// 2. 修改名称和描述（分类保持不变传 []）
-const newName = `嘉立创示例_符号修改后_${Date.now()}`;
-const modified = await eda.lib_Symbol.modify(symbolUuid, libraryUuid, newName, [], '修改后的描述');
-
-// 修改类保留现场
-
-console.log('symbolUuid:', symbolUuid);
-console.log('modified:', modified);
-console.log('newName:', newName);
-```
-
-### openineditor
-
-# LIB\_Symbol.openInEditor() 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 in the editor document
-
-## Signature
-
-```typescript
-function openInEditor(
-	symbolUuid: string,
-	libraryUuid: string,
-	splitScreenId?: string,
-): Promise<string | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-splitScreenId
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Split screen ID. If not filled in, it opens in the split screen with the last input focus by default. It can be obtained using the APIs in [DMT\_EditorControl](./DMT_EditorControl.md)
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;string \| undefined&gt;
-
-Tab ID, corresponding to [IDMT\_EditorTabItem.tabId](../interfaces/IDMT_EditorTabItem.md)<!-- -->. You can use [DMT\_EditorControl.getSplitScreenIdByTabId()](./DMT_EditorControl.md) to get the split screen ID
-
-## Example
-
-```javascript
-// 1. 获取个人库 UUID，从系统库复制一个符号作为编辑对象
-const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
-const symbolUuid = await eda.lib_Symbol.copy(
-	source.uuid,
-	source.libraryUuid,
-	libraryUuid,
-	[],
-	`嘉立创示例_编辑符号_${Date.now()}`
-);
-
-// 2. 在编辑器中打开该符号，返回标签页 ID（uuid@libraryUuid 格式）
-const tabId = await eda.lib_Symbol.openInEditor(symbolUuid, libraryUuid);
-
-// 打开后保留现场（编辑器停留在新符号页供观察；不需要时可传 tabId 给
-// dmt_EditorControl.closeDocument 关闭）
-
-console.log('symbolUuid:', symbolUuid);
-console.log('tabId:', tabId);
-```
-
-### search
-
-# LIB\_Symbol.search() 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.
-
-Search symbol
-
-## Signature
-
-```typescript
-function search(
-	key: string,
-	libraryUuid?: string,
-	classification?: ILIB_ClassificationIndex | Array<string>,
-	symbolType?: ELIB_SymbolType,
-	itemsOfPage?: number,
-	page?: number,
-): Promise<Array<ILIB_SymbolSearchItem>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-key
-
-</td><td>
-
-string
-
-</td><td>
-
-Search keyword
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-classification
-
-</td><td>
-
-[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
-
-</td><td>
-
-_(Optional)_ Classification, defaults to all
-
-</td></tr>
-<tr><td>
-
-symbolType
-
-</td><td>
-
-[ELIB\_SymbolType](../enums/ELIB_SymbolType.md)
-
-</td><td>
-
-_(Optional)_ Symbol type, defaults to all
-
-</td></tr>
-<tr><td>
-
-itemsOfPage
-
-</td><td>
-
-number
-
-</td><td>
-
-_(Optional)_ Number of search results per page
-
-</td></tr>
-<tr><td>
-
-page
-
-</td><td>
-
-number
-
-</td><td>
-
-_(Optional)_ Page count
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;Array&lt;[ILIB\_SymbolSearchItem](../interfaces/ILIB_SymbolSearchItem.md)<!-- -->&gt;&gt;
-
-List of searched symbol properties
-
-## Example
-
-```javascript
-// 1. 尝试按关键字搜索（当前版本非空关键字会抛错，如实展示）
-try {
-	const keywordResults = await eda.lib_Symbol.search('0402');
-	console.log('关键字搜索返回', keywordResults.length, '条');
-}
-catch (e) {
-	// 剥掉错误类型前缀；注意：正则写法尾部会产生星号+斜杠序列，会闭掉 tsdoc 注释，故用 split
-	console.log('关键字搜索当前版本抛错：', String(e.message).split('Error: ').pop());
-}
-
-// 2. 改用空关键字列出系统库符号，每页 5 条
-const results = await eda.lib_Symbol.search('', undefined, [], undefined, 5, 1);
-
-// 3. 输出搜索结果（需要过滤时可按 item.name 自行筛选）
-console.log('count:', results.length);
-results.forEach((item, i) => {
-	console.log(`[${i}] name:`, item.name, 'uuid:', item.uuid, 'libraryUuid:', item.libraryUuid);
-});
-```
-
-### searchbyproperties
-
-# LIB\_Symbol.searchByProperties() 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.
-
-Search symbols precisely by properties
-
-## Signature
-
-```typescript
-function searchByProperties(
-	properties: ILIB_SymbolPropertiesForSearch,
-	libraryUuid?: string,
-): Promise<Array<ILIB_SymbolSearchItem>>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-properties
-
-</td><td>
-
-[ILIB\_SymbolPropertiesForSearch](../interfaces/ILIB_SymbolPropertiesForSearch.md)
-
-</td><td>
-
-Property
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;Array&lt;[ILIB\_SymbolSearchItem](../interfaces/ILIB_SymbolSearchItem.md)<!-- -->&gt;&gt;
-
-List of searched symbol properties
-
-## Example
-
-```javascript
-// 1. 按名称精确搜索（官方属性集合目前仅支持 name）
-// 当前版本该接口不稳定：可能抛错，也可能正常返回 undefined，两种都要兼容
-let results;
-try {
-	results = await eda.lib_Symbol.searchByProperties({ name: '0402' });
-}
-catch (e) {
-	console.log('当前版本按 name 搜索抛错：', e.message);
-}
-if (!Array.isArray(results))
-	results = [];
-
-// 2. 输出搜索结果
-console.log('count:', results.length);
-results.forEach((item, i) => {
-	console.log(`[${i}] name:`, item.name, 'uuid:', item.uuid, 'libraryUuid:', item.libraryUuid);
-});
-```
-
-### updatedocumentsource
-
-# LIB\_Symbol.updateDocumentSource() 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.
-
-Update the document source code of the symbol
-
-## Signature
-
-```typescript
-function updateDocumentSource(
-	symbolUuid: string,
-	libraryUuid: string,
-	documentSource: string,
-): Promise<boolean | undefined>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-</th><th>
-
-Type
-
-</th><th>
-
-Description
-
-</th></tr></thead>
-<tbody><tr><td>
-
-symbolUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Symbol UUID
-
-</td></tr>
-<tr><td>
-
-libraryUuid
-
-</td><td>
-
-string
-
-</td><td>
-
-Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
-
-</td></tr>
-<tr><td>
-
-documentSource
-
-</td><td>
-
-string
-
-</td><td>
-
-Document source code
-
-</td></tr>
-</tbody></table>
-
-## Returns
-
-Promise&lt;boolean \| undefined&gt;
-
-Whether the update is successful
-
-## Example
-
-```javascript
-// 1. 获取个人库 UUID，从系统库复制一个符号（有内容，源码链路才完整）
-const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
-const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
-const symbolUuid = await eda.lib_Symbol.copy(
-	source.uuid,
-	source.libraryUuid,
-	libraryUuid,
-	[],
-	`嘉立创示例_源码符号_${Date.now()}`
-);
-
-// 2. 在编辑器中打开符号，等待文档加载完成
-const tabId = await eda.lib_Symbol.openInEditor(symbolUuid, libraryUuid);
-await new Promise(r => setTimeout(r, 1500));
-
-// 3. 读取当前打开符号的文档源码
-const documentSource = await eda.sys_FileManager.getDocumentSource();
-
-// 4. 把源码写回库中的符号（此处原样写回；实际使用时可先改写 documentSource）
-const updated = await eda.lib_Symbol.updateDocumentSource(symbolUuid, libraryUuid, documentSource);
-
-// 5. 关闭编辑器标签页（符号本体保留在库中）
-await eda.dmt_EditorControl.closeDocument(tabId);
-
-// 修改类保留现场
-
-console.log('symbolUuid:', symbolUuid);
-console.log('sourceLength:', documentSource.length);
-console.log('updated:', updated);
-```
+# LIB\_Symbol class
+
+Comprehensive library / symbol class
+
+## Signature
+
+```typescript
+class LIB_Symbol
+```
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+</th><th>
+
+Modifiers
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[copy(symbolUuid, libraryUuid, targetLibraryUuid, targetClassification, newSymbolName)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Copy Symbol
+
+</td></tr>
+<tr><td>
+
+[create(libraryUuid, symbolName, classification, symbolType, description, otherProperty)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Create Symbol
+
+</td></tr>
+<tr><td>
+
+[delete(symbolUuid, libraryUuid)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Delete Symbol
+
+</td></tr>
+<tr><td>
+
+[get(symbolUuid, libraryUuid)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get all properties of the symbol
+
+</td></tr>
+<tr><td>
+
+[getDocumentSource(symbolUuid, libraryUuid)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** 获取符号的文档源码
+
+</td></tr>
+<tr><td>
+
+[getRenderImage(source)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Get the symbol render image
+
+</td></tr>
+<tr><td>
+
+[modify(symbolUuid, libraryUuid, symbolName, classification, description, otherProperty)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Modify Symbol
+
+</td></tr>
+<tr><td>
+
+[openInEditor(symbolUuid, libraryUuid, splitScreenId)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Open in the editor document
+
+</td></tr>
+<tr><td>
+
+[search(key, libraryUuid, classification, symbolType, itemsOfPage, page)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Search symbol
+
+</td></tr>
+<tr><td>
+
+[searchByProperties(properties, libraryUuid)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Search symbols precisely by properties
+
+</td></tr>
+<tr><td>
+
+[updateDocumentSource(symbolUuid, libraryUuid, documentSource)](./LIB_Symbol.md)
+
+</td><td>
+
+</td><td>
+
+**_(BETA)_** Update the document source code of the symbol
+
+</td></tr>
+</tbody></table>
+
+---
+
+## 方法详情
+
+### copy
+
+# LIB\_Symbol.copy() 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.
+
+Copy Symbol
+
+## Signature
+
+```typescript
+function copy(
+	symbolUuid: string,
+	libraryUuid: string,
+	targetLibraryUuid: string,
+	targetClassification?: ILIB_ClassificationIndex | Array<string>,
+	newSymbolName?: string,
+): Promise<string | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+targetLibraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Target library UUID
+
+</td></tr>
+<tr><td>
+
+targetClassification
+
+</td><td>
+
+[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ Classification in the target library
+
+</td></tr>
+<tr><td>
+
+newSymbolName
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ New symbol name. If a symbol with the same name exists in the target library, the copy will fail
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+UUID of the new symbol in the target library
+
+## Example
+
+```javascript
+// 1. 列出系统库符号（关键字传空 = 列出全部），取一个作为复制来源
+const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
+
+// 2. 获取个人库 UUID
+const targetLibraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+
+// 3. 从系统库复制到个人库，指定新名称避免同名冲突（分类传 [] = 不分类）
+const newName = `嘉立创示例_符号副本_${Date.now()}`;
+const copiedUuid = await eda.lib_Symbol.copy(
+	source.uuid,
+	source.libraryUuid,
+	targetLibraryUuid,
+	[],
+	newName
+);
+
+// 创建类保留现场（副本留在个人库中供观察）
+
+console.log('sourceUuid:', source.uuid);
+console.log('copiedUuid:', copiedUuid);
+console.log('newName:', newName);
+```
+
+### create
+
+# LIB\_Symbol.create() 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.
+
+Create Symbol
+
+## Signature
+
+```typescript
+function create(
+	libraryUuid: string,
+	symbolName: string,
+	classification?: ILIB_ClassificationIndex | Array<string>,
+	symbolType?: ELIB_SymbolType,
+	description?: string,
+	otherProperty?: Record<string, boolean | number | string | undefined>,
+): Promise<string | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+symbolName
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol name
+
+</td></tr>
+<tr><td>
+
+classification
+
+</td><td>
+
+[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ Classification
+
+</td></tr>
+<tr><td>
+
+symbolType
+
+</td><td>
+
+[ELIB\_SymbolType](../enums/ELIB_SymbolType.md)
+
+</td><td>
+
+_(Optional)_ Symbol type
+
+</td></tr>
+<tr><td>
+
+description
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Description
+
+</td></tr>
+<tr><td>
+
+otherProperty
+
+</td><td>
+
+Record&lt;string, boolean \| number \| string \| undefined&gt;
+
+</td><td>
+
+_(Optional)_ 其它属性
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+Symbol UUID
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+
+// 2. 创建符号（分类传 [] = 不分类；符号类型见 ELIB_SymbolType）
+const symbolName = `嘉立创示例_新符号_${Date.now()}`;
+const symbolUuid = await eda.lib_Symbol.create(libraryUuid, symbolName, [], ELIB_SymbolType.COMPONENT, '示例符号描述');
+
+// 创建类保留现场（新符号留在个人库中供观察）
+
+console.log('symbolUuid:', symbolUuid);
+console.log('symbolName:', symbolName);
+```
+
+### delete
+
+# LIB\_Symbol.delete() 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 Symbol
+
+## Signature
+
+```typescript
+function delete(symbolUuid: string, libraryUuid: string): Promise<boolean | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean \| undefined&gt;
+
+Whether the operation is successful
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID 并新建删除对象
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+const symbolUuid = await eda.lib_Symbol.create(libraryUuid, `嘉立创示例_待删除符号_${Date.now()}`, []);
+
+// 2. 删除该符号
+const deleted = await eda.lib_Symbol.delete(symbolUuid, libraryUuid);
+
+console.log('symbolUuid:', symbolUuid);
+console.log('deleted:', deleted);
+```
+
+### get
+
+# LIB\_Symbol.get() 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 all properties of the symbol
+
+## Signature
+
+```typescript
+function get(symbolUuid: string, libraryUuid?: string): Promise<ILIB_SymbolItem | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;[ILIB\_SymbolItem](../interfaces/ILIB_SymbolItem.md) \| undefined&gt;
+
+Symbol property
+
+### getdocumentsource
+
+# LIB\_Symbol.getDocumentSource() 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 getDocumentSource(symbolUuid: string, libraryUuid?: string): Promise<string | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+符号 UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ 库 UUID，默认为系统库，可以使用 [LIB\_LibrariesList](./LIB_LibrariesList.md) 内的接口获取
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+符号的 3.0 文档源码（esym JSON 字符串），获取失败返回 `undefined`
+
+## Remarks
+
+与 [LIB\_Symbol.updateDocumentSource()](./LIB_Symbol.md) 对称的读取接口；返回 \*\*3.0 格式\*\*（esym）的符号源数据， 可直接用于组装原理图源数据（如 AI 生成 eprj3 工程）。
+
+支持工程库 / 非工程库（系统库 / 个人库 / 扩展库）： - 工程库：从当前打开的工程 worker 读取（含未保存内容）； - 非工程库：从 lib.worker 读取（含未保存内容），worker 无缓存时回退网络获取， 自动处理 `history_uuid`<!-- -->（历史版本）、`dataStrId`<!-- -->（远程存储）与 2.0 → 3.0 格式转换。
+
+获取失败（如库条目不存在）将返回 `undefined`
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID 并新建符号作为读取对象（第四参数为符号类型，见 ELIB_SymbolType）
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+const symbolUuid = await eda.lib_Symbol.create(
+	libraryUuid,
+	`嘉立创示例_读取源码_${Date.now()}`,
+	[],
+	ELIB_SymbolType.COMPONENT
+);
+
+// 2. 读取该符号的文档源码（第二参数为符号所属库）
+const pending = eda.lib_Symbol.getDocumentSource(symbolUuid, libraryUuid);
+
+// 3. 等待 3 秒观察结果状态（当前版本 Promise 不 settle，用超时保护避免卡住）
+const settled = await Promise.race([
+	Promise.resolve(pending).then(
+		source => `fulfilled，源码长度 ${source ? source.length : '空'}`,
+		() => 'rejected'
+	),
+	new Promise(resolve => setTimeout(() => resolve('pending（3 秒内未返回）'), 3000)),
+]);
+
+// 4. 清理测试符号（查询类需要清理）
+await eda.lib_Symbol.delete(symbolUuid, libraryUuid);
+
+console.log('symbolUuid:', symbolUuid);
+console.log('returns:', typeof pending.then === 'function' ? 'Promise' : typeof pending);
+console.log('settled:', settled);
+```
+
+### getrenderimage
+
+# LIB\_Symbol.getRenderImage() 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 symbol render image
+
+## Signature
+
+```typescript
+function getRenderImage(source: {
+	symbolUuid: string;
+	libraryUuid: string;
+	subPartName?: string;
+}): Promise<Blob | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+source
+
+</td><td>
+
+\{ symbolUuid: string; libraryUuid: string; subPartName?: string \}
+
+</td><td>
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Blob \| undefined&gt;
+
+Symbol render image
+
+## Example
+
+```javascript
+// 1. 列出系统库符号，取一个作为渲染来源
+const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
+
+// 2. 获取渲染图（PNG Blob）
+const blob = await eda.lib_Symbol.getRenderImage({
+	symbolUuid: source.uuid,
+	libraryUuid: source.libraryUuid,
+});
+
+// 3. Blob 可转成 URL 直接展示：URL.createObjectURL(blob)
+console.log('sourceName:', source.name);
+console.log('imageSize:', blob.size);
+console.log('imageType:', blob.type);
+```
+
+### modify
+
+# LIB\_Symbol.modify() 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.
+
+Modify Symbol
+
+## Signature
+
+```typescript
+function modify(
+	symbolUuid: string,
+	libraryUuid: string,
+	symbolName?: string,
+	classification?: ILIB_ClassificationIndex | Array<string> | null,
+	description?: string | null,
+	otherProperty?: Record<string, boolean | number | string | undefined | null>,
+): Promise<boolean>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+symbolName
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Symbol name
+
+</td></tr>
+<tr><td>
+
+classification
+
+</td><td>
+
+[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt; \| null
+
+</td><td>
+
+_(Optional)_ Classification
+
+</td></tr>
+<tr><td>
+
+description
+
+</td><td>
+
+string \| null
+
+</td><td>
+
+_(Optional)_ Description
+
+</td></tr>
+<tr><td>
+
+otherProperty
+
+</td><td>
+
+Record&lt;string, boolean \| number \| string \| undefined \| null&gt;
+
+</td><td>
+
+_(Optional)_ 其它属性，如希望清除某些属性，则将其的值设置为 `null`
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean&gt;
+
+Whether the operation is successful
+
+## Remarks
+
+If you want to clear certain properties, set their values to `null`
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID 并新建修改对象
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+const symbolUuid = await eda.lib_Symbol.create(
+	libraryUuid,
+	`嘉立创示例_符号修改前_${Date.now()}`,
+	[],
+	ELIB_SymbolType.COMPONENT,
+	'修改前的描述'
+);
+
+// 2. 修改名称和描述（分类保持不变传 []）
+const newName = `嘉立创示例_符号修改后_${Date.now()}`;
+const modified = await eda.lib_Symbol.modify(symbolUuid, libraryUuid, newName, [], '修改后的描述');
+
+// 修改类保留现场
+
+console.log('symbolUuid:', symbolUuid);
+console.log('modified:', modified);
+console.log('newName:', newName);
+```
+
+### openineditor
+
+# LIB\_Symbol.openInEditor() 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 in the editor document
+
+## Signature
+
+```typescript
+function openInEditor(
+	symbolUuid: string,
+	libraryUuid: string,
+	splitScreenId?: string,
+): Promise<string | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+splitScreenId
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Split screen ID. If not filled in, it opens in the split screen with the last input focus by default. It can be obtained using the APIs in [DMT\_EditorControl](./DMT_EditorControl.md)
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;string \| undefined&gt;
+
+Tab ID, corresponding to [IDMT\_EditorTabItem.tabId](../interfaces/IDMT_EditorTabItem.md)<!-- -->. You can use [DMT\_EditorControl.getSplitScreenIdByTabId()](./DMT_EditorControl.md) to get the split screen ID
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID，从系统库复制一个符号作为编辑对象
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
+const symbolUuid = await eda.lib_Symbol.copy(
+	source.uuid,
+	source.libraryUuid,
+	libraryUuid,
+	[],
+	`嘉立创示例_编辑符号_${Date.now()}`
+);
+
+// 2. 在编辑器中打开该符号，返回标签页 ID（uuid@libraryUuid 格式）
+const tabId = await eda.lib_Symbol.openInEditor(symbolUuid, libraryUuid);
+
+// 打开后保留现场（编辑器停留在新符号页供观察；不需要时可传 tabId 给
+// dmt_EditorControl.closeDocument 关闭）
+
+console.log('symbolUuid:', symbolUuid);
+console.log('tabId:', tabId);
+```
+
+### search
+
+# LIB\_Symbol.search() 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.
+
+Search symbol
+
+## Signature
+
+```typescript
+function search(
+	key: string,
+	libraryUuid?: string,
+	classification?: ILIB_ClassificationIndex | Array<string>,
+	symbolType?: ELIB_SymbolType,
+	itemsOfPage?: number,
+	page?: number,
+): Promise<Array<ILIB_SymbolSearchItem>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+key
+
+</td><td>
+
+string
+
+</td><td>
+
+Search keyword
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+classification
+
+</td><td>
+
+[ILIB\_ClassificationIndex](../interfaces/ILIB_ClassificationIndex.md) \| Array&lt;string&gt;
+
+</td><td>
+
+_(Optional)_ Classification, defaults to all
+
+</td></tr>
+<tr><td>
+
+symbolType
+
+</td><td>
+
+[ELIB\_SymbolType](../enums/ELIB_SymbolType.md)
+
+</td><td>
+
+_(Optional)_ Symbol type, defaults to all
+
+</td></tr>
+<tr><td>
+
+itemsOfPage
+
+</td><td>
+
+number
+
+</td><td>
+
+_(Optional)_ Number of search results per page
+
+</td></tr>
+<tr><td>
+
+page
+
+</td><td>
+
+number
+
+</td><td>
+
+_(Optional)_ Page count
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;[ILIB\_SymbolSearchItem](../interfaces/ILIB_SymbolSearchItem.md)<!-- -->&gt;&gt;
+
+List of searched symbol properties
+
+## Example
+
+```javascript
+// 1. 尝试按关键字搜索（当前版本非空关键字会抛错，如实展示）
+try {
+	const keywordResults = await eda.lib_Symbol.search('0402');
+	console.log('关键字搜索返回', keywordResults.length, '条');
+}
+catch (e) {
+	// 剥掉错误类型前缀；注意：正则写法尾部会产生星号+斜杠序列，会闭掉 tsdoc 注释，故用 split
+	console.log('关键字搜索当前版本抛错：', String(e.message).split('Error: ').pop());
+}
+
+// 2. 改用空关键字列出系统库符号，每页 5 条
+const results = await eda.lib_Symbol.search('', undefined, [], undefined, 5, 1);
+
+// 3. 输出搜索结果（需要过滤时可按 item.name 自行筛选）
+console.log('count:', results.length);
+results.forEach((item, i) => {
+	console.log(`[${i}] name:`, item.name, 'uuid:', item.uuid, 'libraryUuid:', item.libraryUuid);
+});
+```
+
+### searchbyproperties
+
+# LIB\_Symbol.searchByProperties() 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.
+
+Search symbols precisely by properties
+
+## Signature
+
+```typescript
+function searchByProperties(
+	properties: ILIB_SymbolPropertiesForSearch,
+	libraryUuid?: string,
+): Promise<Array<ILIB_SymbolSearchItem>>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+properties
+
+</td><td>
+
+[ILIB\_SymbolPropertiesForSearch](../interfaces/ILIB_SymbolPropertiesForSearch.md)
+
+</td><td>
+
+Property
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+_(Optional)_ Library UUID, default is system library, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;Array&lt;[ILIB\_SymbolSearchItem](../interfaces/ILIB_SymbolSearchItem.md)<!-- -->&gt;&gt;
+
+List of searched symbol properties
+
+## Remarks
+
+该接口暂时不支持工程库的精确搜索
+
+## Example
+
+```javascript
+// 1. 按名称精确搜索（官方属性集合目前仅支持 name）
+// 当前版本该接口不稳定：可能抛错，也可能正常返回 undefined，两种都要兼容
+let results;
+try {
+	results = await eda.lib_Symbol.searchByProperties({ name: '0402' });
+}
+catch (e) {
+	console.log('当前版本按 name 搜索抛错：', e.message);
+}
+if (!Array.isArray(results))
+	results = [];
+
+// 2. 输出搜索结果
+console.log('count:', results.length);
+results.forEach((item, i) => {
+	console.log(`[${i}] name:`, item.name, 'uuid:', item.uuid, 'libraryUuid:', item.libraryUuid);
+});
+```
+
+### updatedocumentsource
+
+# LIB\_Symbol.updateDocumentSource() 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.
+
+Update the document source code of the symbol
+
+## Signature
+
+```typescript
+function updateDocumentSource(
+	symbolUuid: string,
+	libraryUuid: string,
+	documentSource: string,
+): Promise<boolean | undefined>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+symbolUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Symbol UUID
+
+</td></tr>
+<tr><td>
+
+libraryUuid
+
+</td><td>
+
+string
+
+</td><td>
+
+Library UUID, you can use [LIB\_LibrariesList](./LIB_LibrariesList.md) APIs in
+
+</td></tr>
+<tr><td>
+
+documentSource
+
+</td><td>
+
+string
+
+</td><td>
+
+Document source code
+
+</td></tr>
+</tbody></table>
+
+## Returns
+
+Promise&lt;boolean \| undefined&gt;
+
+Whether the update is successful
+
+## Example
+
+```javascript
+// 1. 获取个人库 UUID，从系统库复制一个符号（有内容，源码链路才完整）
+const libraryUuid = await eda.lib_LibrariesList.getPersonalLibraryUuid();
+const [source] = await eda.lib_Symbol.search('', undefined, [], undefined, 1, 1);
+const symbolUuid = await eda.lib_Symbol.copy(
+	source.uuid,
+	source.libraryUuid,
+	libraryUuid,
+	[],
+	`嘉立创示例_源码符号_${Date.now()}`
+);
+
+// 2. 在编辑器中打开符号，等待文档加载完成
+const tabId = await eda.lib_Symbol.openInEditor(symbolUuid, libraryUuid);
+await new Promise(r => setTimeout(r, 1500));
+
+// 3. 读取当前打开符号的文档源码
+const documentSource = await eda.sys_FileManager.getDocumentSource();
+
+// 4. 把源码写回库中的符号（此处原样写回；实际使用时可先改写 documentSource）
+const updated = await eda.lib_Symbol.updateDocumentSource(symbolUuid, libraryUuid, documentSource);
+
+// 5. 关闭编辑器标签页（符号本体保留在库中）
+await eda.dmt_EditorControl.closeDocument(tabId);
+
+// 修改类保留现场
+
+console.log('symbolUuid:', symbolUuid);
+console.log('sourceLength:', documentSource.length);
+console.log('updated:', updated);
+```