@isdk/ai-tool 0.8.2 → 0.9.0

package/dist/test/util.js

@@ -1 +1 @@
-"use strict";var e,r=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,u=Object.getOwnPropertyNames,o=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,i=(e,r,o,i)=>{if(r&&"object"==typeof r||"function"==typeof r)for(let f of u(r))c.call(e,f)||f===o||t(e,f,{get:()=>r[f],enumerable:!(i=n(r,f))||i.enumerable});return e},f={};function a(e,r){expect(e.length).toBeGreaterThanOrEqual(r.length);for(let t=0;t<r.length;t++)if(e[t]!==r[t])return!1;return!0}((e,r)=>{for(var n in r)t(e,n,{get:r[n],enumerable:!0})})(f,{compareStr:()=>a,findPort:()=>s,rmFile:()=>m}),module.exports=(e=f,i(t({},"__esModule",{value:!0}),e));var l=((e,n,u)=>(u=null!=e?r(o(e)):{},i(!n&&e&&e.__esModule?u:t(u,"default",{value:e,enumerable:!0}),e)))(require("net"));async function s(e,r=10){return new Promise((t,n)=>{void 0===e?e=0:("string"==typeof e&&(e=parseInt(e)),e>=0||(e=0));const u=l.default.createServer();u.on("error",t=>{"EADDRINUSE"===t.code&&(e++,--r>0)?u.listen(e):n(t)}),u.on("listening",async()=>{const e=u.address().port;u.close(r=>{r?n(r):t(e)})}),u.listen(e)})}var b=require("fs");function m(e){(0,b.existsSync)(e)&&(0,b.rmSync)(e,{recursive:!0}),(0,b.existsSync)(e+".temp")&&(0,b.rmSync)(e+".temp",{recursive:!0})}
+"use strict";var e,r=Object.defineProperty,t=Object.getOwnPropertyDescriptor,u=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,o={};function c(e,r){expect(e.length).toBeGreaterThanOrEqual(r.length);for(let t=0;t<r.length;t++)if(e[t]!==r[t])return!1;return!0}((e,t)=>{for(var u in t)r(e,u,{get:t[u],enumerable:!0})})(o,{compareStr:()=>c,findPort:()=>f.findPort,rmFile:()=>l}),module.exports=(e=o,((e,o,c,f)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let n of u(o))i.call(e,n)||n===c||r(e,n,{get:()=>o[n],enumerable:!(f=t(o,n))||f.enumerable});return e})(r({},"__esModule",{value:!0}),e));var f=require("@isdk/util"),n=require("fs");function l(e){(0,n.existsSync)(e)&&(0,n.rmSync)(e,{recursive:!0}),(0,n.existsSync)(e+".temp")&&(0,n.rmSync)(e+".temp",{recursive:!0})}

package/dist/test/util.mjs

@@ -1 +1 @@
-import{findPort as r}from"../chunk-TGTHY57V.mjs";function e(r,e){expect(r.length).toBeGreaterThanOrEqual(e.length);for(let t=0;t<e.length;t++)if(r[t]!==e[t])return!1;return!0}import{existsSync as t,rmSync as o}from"fs";function f(r){t(r)&&o(r,{recursive:!0}),t(r+".temp")&&o(r+".temp",{recursive:!0})}export{e as compareStr,r as findPort,f as rmFile};
+import{findPort as r}from"../chunk-BIJ2JH4U.mjs";function e(r,e){expect(r.length).toBeGreaterThanOrEqual(e.length);for(let t=0;t<e.length;t++)if(r[t]!==e[t])return!1;return!0}import{existsSync as t,rmSync as o}from"fs";function f(r){t(r)&&o(r,{recursive:!0}),t(r+".temp")&&o(r+".temp",{recursive:!0})}export{e as compareStr,r as findPort,f as rmFile};

package/docs/api/@isdk/namespaces/ClientTools/README.md

@@ -0,0 +1,11 @@
+[**@isdk/ai-tool**](../../../README.md)
+
+***
+
+[@isdk/ai-tool](../../../globals.md) / ClientTools
+
+# ClientTools
+
+## Functions
+
+- [get](functions/get.md)

package/docs/api/@isdk/namespaces/ClientTools/functions/get.md

@@ -0,0 +1,27 @@
+[**@isdk/ai-tool**](../../../../README.md)
+
+***
+
+[@isdk/ai-tool](../../../../globals.md) / [ClientTools](../README.md) / get
+
+# Function: get()
+
+> **get**(`name`): [`ClientTools`](../../../../classes/ClientTools.md)
+
+Defined in: @isdk/ai-tools/packages/tool-rpc/dist/index-359784IS.d.ts:202
+
+Gets a registered `ClientTools` instance by name.
+
+## Parameters
+
+### name
+
+`string`
+
+The name of the tool function.
+
+## Returns
+
+[`ClientTools`](../../../../classes/ClientTools.md)
+
+The `ClientTools` instance.

package/docs/api/@isdk/namespaces/EventStates/variables/ABORT.md

@@ -8,4 +8,4 @@
 
 > `const` **ABORT**: `-1`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/consts.d.ts:11
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/node\_modules/events-ex/lib/consts.d.ts:11

package/docs/api/@isdk/namespaces/EventStates/variables/CONTINUE.md

@@ -8,4 +8,4 @@
 
 > `const` **CONTINUE**: `any`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/consts.d.ts:8
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/node\_modules/events-ex/lib/consts.d.ts:8

package/docs/api/@isdk/namespaces/EventStates/variables/DONE.md

@@ -8,4 +8,4 @@
 
 > `const` **DONE**: `1`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/consts.d.ts:9
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/node\_modules/events-ex/lib/consts.d.ts:9

package/docs/api/@isdk/namespaces/EventStates/variables/STOPPED.md

@@ -8,4 +8,4 @@
 
 > `const` **STOPPED**: `2`
 
-Defined in: @isdk/ai-tools/node\_modules/.pnpm/events-ex@2.1.0/node\_modules/events-ex/lib/consts.d.ts:10
+Defined in: @isdk/util/node\_modules/.pnpm/events-ex@2.1.1/node\_modules/events-ex/lib/consts.d.ts:10

package/docs/api/classes/BinarySemaphore.md

@@ -6,35 +6,26 @@
 
 # Class: BinarySemaphore
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:88](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L88)
+Defined in: @isdk/util/dist/index.d.ts:746
 
-A binary semaphore implementation for managing concurrency in asynchronous operations.
-Unlike a general semaphore, a binary semaphore allows only one caller to acquire the semaphore at a time.
-It provides methods to acquire, release, and manage waiting tasks efficiently.
+二进制信号量（Binary Semaphore）实现。
+二进制信号量在任何时刻只允许一个调用方获取成功（类似于互斥锁）。
+它提供了获取（acquire）、释放（release）以及管理等待队列的机制，并支持背压控制（通过 pauseFn/resumeFn）。
 
-Example usage:
+示例用法：
 
 ```typescript
-const semaphore = new Semaphore(5); // Allows 5 concurrent operations.
+const semaphore = new BinarySemaphore();
 
-const semaphore = new Semaphore(
-  4, // Allow 4 concurrent async calls
-  {
-    capacity: 100 // Prealloc space for 100 tokens
-  }
-);
-
-async function fetchData(x) {
-  await semaphore.acquire()
+async function performTask(data) {
+  const release = await semaphore.acquire();
   try {
-    console.log(semaphore.pendingCount + ' calls to fetch are waiting')
-    // ... do some async stuff with x
+    console.log('正在处理:', data);
+    // 执行异步操作...
   } finally {
-    semaphore.release();
+    release(); // 或者使用 semaphore.release();
   }
 }
-
-const data = await Promise.all(array.map(fetchData));
 ```
 
 ## Extended by
@@ -45,29 +36,37 @@ const data = await Promise.all(array.map(fetchData));
 
 ### Constructor
 
-> **new BinarySemaphore**(`options`): `BinarySemaphore`
+> **new BinarySemaphore**(`options?`): `BinarySemaphore`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:145](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L145)
+Defined in: @isdk/util/dist/index.d.ts:771
 
-Creates a binary semaphore object for managing concurrency in asynchronous operations.
+创建一个二进制信号量实例。
 
 #### Parameters
 
-##### options
+##### options?
+
+[`BinarySemaphoreOptions`](../interfaces/BinarySemaphoreOptions.md)
 
-[`BinarySemaphoreOptions`](../interfaces/BinarySemaphoreOptions.md) = `{}`
+配置选项。
 
 #### Returns
 
 `BinarySemaphore`
 
+#### Throws
+
+如果只提供了 pauseFn 而未提供 resumeFn，或者反之，则抛出错误。
+
 ## Properties
 
 ### \_activeCount
 
 > `protected` **\_activeCount**: `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:97](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L97)
+Defined in: @isdk/util/dist/index.d.ts:764
+
+记录当前活跃的（已获取但未释放）操作总数。
 
 ***
 
@@ -75,7 +74,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:97](ht
 
 > `protected` **emitter**: [`EventEmitter`](EventEmitter.md)
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:91](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L91)
+Defined in: @isdk/util/dist/index.d.ts:752
+
+内部事件触发器，用于协调释放和分发逻辑。
 
 ***
 
@@ -83,7 +84,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:91](ht
 
 > `protected` **free**: `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:90](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L90)
+Defined in: @isdk/util/dist/index.d.ts:750
+
+当前空闲的令牌。对于二进制信号量，只能持有一个令牌。
 
 ***
 
@@ -91,7 +94,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:90](ht
 
 > `protected` **initTokenFn**: (`token?`) => `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:95](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L95)
+Defined in: @isdk/util/dist/index.d.ts:760
+
+令牌初始化函数。
 
 #### Parameters
 
@@ -109,7 +114,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:95](ht
 
 > `protected` **paused**: `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:96](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L96)
+Defined in: @isdk/util/dist/index.d.ts:762
+
+记录当前是否处于暂停状态。
 
 ***
 
@@ -117,7 +124,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:96](ht
 
 > `protected` `optional` **pauseFn**: () => `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:93](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L93)
+Defined in: @isdk/util/dist/index.d.ts:756
+
+获取积压时的暂停回调。
 
 #### Returns
 
@@ -129,7 +138,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:93](ht
 
 > `protected` `optional` **resumeFn**: () => `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:94](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L94)
+Defined in: @isdk/util/dist/index.d.ts:758
+
+恢复处理的回调。
 
 #### Returns
 
@@ -141,15 +152,19 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:94](ht
 
 > `protected` **useDefaultTokens**: `boolean`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:92](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L92)
+Defined in: @isdk/util/dist/index.d.ts:754
+
+标记是否使用默认的令牌初始化函数。
 
 ***
 
 ### waiting
 
-> `readonly` **waiting**: `Deque`\<`undefined` \| [`SemaphoreTaskItem`](../interfaces/SemaphoreTaskItem.md)\>
+> `readonly` **waiting**: `Deque`\<[`SemaphoreTaskItem`](../interfaces/SemaphoreTaskItem.md) \| `undefined`\>
+
+Defined in: @isdk/util/dist/index.d.ts:748
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:89](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L89)
+存储等待获取令牌的任务队列。
 
 ## Accessors
 
@@ -159,19 +174,18 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:89](ht
 
 > **get** **activeCount**(): `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:318](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L318)
+Defined in: @isdk/util/dist/index.d.ts:874
 
-Get the total count of all active operations.
-
-This method returns the number of operations that are either:
-- Waiting in the queue to acquire the semaphore (`pendingCount`).
-- Already acquired the semaphore but have not yet released it.
+获取所有活跃操作的总数。
+包含：
+- 正在队列中等待获取信号量的操作（`pendingCount`）。
+- 已经成功获取信号量但尚未释放的操作。
 
 ##### Returns
 
 `number`
 
-The total count of active operations, including both waiting and ongoing tasks.
+活跃操作的总数。
 
 ***
 
@@ -181,15 +195,15 @@ The total count of active operations, including both waiting and ongoing tasks.
 
 > **get** **pendingCount**(): `number`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:327](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L327)
+Defined in: @isdk/util/dist/index.d.ts:880
 
-Get the number of callers waiting on the semaphore, i.e. the number of pending promises.
+获取当前在等待队列中的调用方数量。
 
 ##### Returns
 
 `number`
 
-The number of waiters in the waiting list.
+等待中的 Promise 数量。
 
 ## Methods
 
@@ -197,7 +211,11 @@ The number of waiters in the waiting list.
 
 > **\_dispatchTask**(`task`, `options?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:212](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L212)
+Defined in: @isdk/util/dist/index.d.ts:805
+
+**`Internal`**
+
+将令牌分发给等待的任务。
 
 #### Parameters
 
@@ -205,10 +223,14 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:212](h
 
 [`SemaphoreTaskItem`](../interfaces/SemaphoreTaskItem.md)
 
+等待中的任务项。
+
 ##### options?
 
 [`BinarySemaphoreReleaseOptions`](../interfaces/BinarySemaphoreReleaseOptions.md)
 
+释放时传递的选项。
+
 #### Returns
 
 `void`
@@ -217,9 +239,14 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:212](h
 
 ### \_newReleaser()
 
-> **\_newReleaser**(`options?`): [`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)
+> **\_newReleaser**(`options?`): `BinarySemaphoreReleaserFunc`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:199](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L199)
+Defined in: @isdk/util/dist/index.d.ts:797
+
+**`Internal`**
+
+创建一个新的释放函数。
+确保释放逻辑只被执行一次，并携带相关的释放选项。
 
 #### Parameters
 
@@ -227,9 +254,13 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:199](h
 
 [`BinarySemaphoreReleaseOptions`](../interfaces/BinarySemaphoreReleaseOptions.md)
 
+释放选项。
+
 #### Returns
 
-[`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)
+`BinarySemaphoreReleaserFunc`
+
+返回一个可调用的释放函数。
 
 ***
 
@@ -237,7 +268,10 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:199](h
 
 > **abort**(`reason?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:301](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L301)
+Defined in: @isdk/util/dist/index.d.ts:865
+
+中止所有正在等待的任务。
+所有在等待队列中的 Promise 将被拒绝并抛出 `AbortError`。
 
 #### Parameters
 
@@ -245,6 +279,8 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:301](h
 
 `any`
 
+中止的原因。
+
 #### Returns
 
 `void`
@@ -253,11 +289,20 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:301](h
 
 ### acquire()
 
-> **acquire**(`options?`): `Promise`\<[`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)\>
+> **acquire**(`options?`): `Promise`\<`BinarySemaphoreReleaserFunc`\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:243](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L243)
+Defined in: @isdk/util/dist/index.d.ts:842
 
-Acquire a token from the semaphore, thus decrement the number of available execution slots. If initFn is not used then the return value of the function can be discarded.
+获取信号量。
+如果信号量当前可用，将立即解析。否则，调用方将被加入等待队列，
+直到有令牌被释放。
+
+逻辑流程：
+1. 增加活跃计数。
+2. 尝试通过 `tryAcquire` 立即获取令牌。
+3. 如果 `tryAcquire` 返回的是异步结果（通过 `isAsync` 判断），则等待其解析。
+4. 如果最终未获得令牌，则将任务推入 `waiting` 队列，并处理可选的 `AbortSignal`。
+5. 如果此时是队列中的第一个任务且定义了 `pauseFn`，则触发暂停回调。
 
 #### Parameters
 
@@ -265,11 +310,13 @@ Acquire a token from the semaphore, thus decrement the number of available execu
 
 [`BinarySemaphoreAcquireOptions`](../interfaces/BinarySemaphoreAcquireOptions.md)
 
+获取选项，可包含 `signal` 用于取消。
+
 #### Returns
 
-`Promise`\<[`BinarySemaphoreReleaserFunc`](../interfaces/BinarySemaphoreReleaserFunc.md)\>
+`Promise`\<`BinarySemaphoreReleaserFunc`\>
 
-A promise that resolves to a release function when a token is acquired. If the semaphore is full, the caller will be added to a waiting queue.
+解析为释放函数（`BinarySemaphoreReleaserFunc`）的 Promise。
 
 ***
 
@@ -277,21 +324,27 @@ A promise that resolves to a release function when a token is acquired. If the s
 
 > **drain**(): `Promise`\<`any`[]\>
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:296](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L296)
+Defined in: @isdk/util/dist/index.d.ts:858
 
-Drains the semaphore and returns all the initialized tokens in an array. Draining is an ideal way to ensure there are no pending async tasks, for example before a process will terminate.
+等待所有当前活跃的操作完成。
+它通过尝试获取一次信号量来确保之前的操作已经释放。
+在进程终止前使用此方法以确保没有挂起的异步任务。
 
 #### Returns
 
 `Promise`\<`any`[]\>
 
+解析为包含已获取令牌的数组的 Promise。
+
 ***
 
 ### init()
 
 > **init**(`options`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:193](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L193)
+Defined in: @isdk/util/dist/index.d.ts:788
+
+初始化事件监听。在构造函数中被调用。
 
 #### Parameters
 
@@ -299,6 +352,8 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:193](h
 
 [`BinarySemaphoreOptions`](../interfaces/BinarySemaphoreOptions.md)
 
+配置选项。
+
 #### Returns
 
 `void`
@@ -309,7 +364,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:193](h
 
 > **initFree**(`options?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:173](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L173)
+Defined in: @isdk/util/dist/index.d.ts:776
+
+初始化空闲令牌。在构造函数中被调用。
 
 #### Parameters
 
@@ -317,6 +374,8 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:173](h
 
 [`BinarySemaphoreOptions`](../interfaces/BinarySemaphoreOptions.md)
 
+配置选项。
+
 #### Returns
 
 `void`
@@ -327,7 +386,9 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:173](h
 
 > **lock**(`options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:217](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L217)
+Defined in: @isdk/util/dist/index.d.ts:812
+
+锁定信号量。尝试从空闲池中提取令牌。
 
 #### Parameters
 
@@ -335,17 +396,24 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:217](h
 
 [`BinarySemaphoreAcquireOptions`](../interfaces/BinarySemaphoreAcquireOptions.md)
 
+获取选项。
+
 #### Returns
 
 `any`
 
+如果有可用令牌则返回该令牌，否则返回 undefined。
+
 ***
 
 ### onReleased()
 
 > **onReleased**(`options?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:177](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L177)
+Defined in: @isdk/util/dist/index.d.ts:783
+
+当信号量被释放时执行的内部处理逻辑。
+检查等待队列，如果有任务则分发令牌；否则将令牌归还至空闲池，并视情况调用 `resumeFn`。
 
 #### Parameters
 
@@ -353,6 +421,8 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:177](h
 
 [`BinarySemaphoreReleaseOptions`](../interfaces/BinarySemaphoreReleaseOptions.md)
 
+释放选项，可能包含令牌。
+
 #### Returns
 
 `void`
@@ -363,9 +433,11 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:177](h
 
 > **release**(`options?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:288](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L288)
+Defined in: @isdk/util/dist/index.d.ts:850
 
-Releases the semaphore, incrementing the number of free execution slots. If there are tasks in the waiting queue, the next task will be dispatched.
+释放信号量，增加可用执行槽位。
+如果等待队列中有任务，将触发下一个任务的执行。
+此方法会减少 `activeCount` 并发出 'release' 事件。
 
 #### Parameters
 
@@ -373,6 +445,8 @@ Releases the semaphore, incrementing the number of free execution slots. If ther
 
 [`BinarySemaphoreReleaseOptions`](../interfaces/BinarySemaphoreReleaseOptions.md)
 
+释放选项。
+
 #### Returns
 
 `void`
@@ -383,9 +457,10 @@ Releases the semaphore, incrementing the number of free execution slots. If ther
 
 > **tryAcquire**(`options?`): `any`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:234](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L234)
+Defined in: @isdk/util/dist/index.d.ts:826
 
-Attempt to acquire a token from the semaphore, if one is available immediately. Otherwise, return undefined.
+尝试立即获取令牌。
+如果信号量当前不可用，则立即返回 `undefined` 而不进入等待队列。
 
 #### Parameters
 
@@ -393,11 +468,13 @@ Attempt to acquire a token from the semaphore, if one is available immediately.
 
 [`BinarySemaphoreAcquireOptions`](../interfaces/BinarySemaphoreAcquireOptions.md)
 
+获取选项。
+
 #### Returns
 
 `any`
 
-Returns a token if the semaphore is not full; otherwise, returns `undefined`.
+如果获取成功则返回令牌，否则返回 `undefined`。
 
 ***
 
@@ -405,7 +482,9 @@ Returns a token if the semaphore is not full; otherwise, returns `undefined`.
 
 > **unlock**(`token?`): `void`
 
-Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:225](https://github.com/isdk/ai-tool.js/blob/e883e341c67e937e7d3a3e95e8bc56844896f5a3/src/utils/async-semaphore.ts#L225)
+Defined in: @isdk/util/dist/index.d.ts:818
+
+解锁信号量。将令牌归还至空闲池。
 
 #### Parameters
 
@@ -413,6 +492,8 @@ Defined in: [@isdk/ai-tools/packages/ai-tool/src/utils/async-semaphore.ts:225](h
 
 `any`
 
+要归还的令牌。如果未提供，则使用初始化函数生成。
+
 #### Returns
 
 `void`