@qimen-lab/core 0.1.4 → 0.1.5

package/dist/task/hash-task/hash/HashTaskRunner.esm.js

@@ -0,0 +1,234 @@
+import { Logger } from '../../../logger/index.esm.js';
+import { WorkerScriptBuilder } from '../worker';
+import { HashTaskHealthMonitor } from './HashTaskHealthMonitor';
+/**
+ * HashTaskRunner类
+ *
+ * 该类只负责流程控制：
+ * - 驱动任务生命周期
+ * - 串联 State / Progress / Resources
+ * - 把「计算」委托给 worker
+ * - 处理中断（pause / cancel）
+ *
+ * 明确不负责：
+ * - 不分块（ChunkProvider 的事）
+ * - 不实现 hash 算法
+ * - 不处理内存细节
+ * - 不做健康监控
+ * - 不做任务调度
+ */
+export class HashTaskRunner {
+    /**
+     * 构造函数
+     *
+     * @param state 任务状态管理器
+     * @param progress 任务进度管理器
+     * @param resources 任务资源管理器
+     * @param options 哈希任务选项
+     */
+    constructor(state, progress, resources, options) {
+        this.state = state;
+        this.progress = progress;
+        this.resources = resources;
+        this.options = options;
+        this.builder = new WorkerScriptBuilder();
+        this.logger = Logger.for('HashTaskRunner');
+    }
+    /**
+     * 获取ChunkProvider的辅助属性，让代码更易读
+     */
+    get chunkProvider() {
+        return this.options.chunkProvider;
+    }
+    /**
+     * 执行哈希任务
+     *
+     * 该方法负责：
+     * 1. 构建Worker脚本
+     * 2. 计算所需内存
+     * 3. 获取资源（内存和Worker）
+     * 4. 启动健康监控
+     * 5. 执行哈希计算
+     * 6. 最终释放资源
+     *
+     * @returns Promise<ArrayBuffer> 包含哈希结果的Promise
+     */
+    async run() {
+        this.logger.debug(`Starting hash task with algorithm: ${this.options.algorithm}`);
+        const scriptSource = this.builder.build(this.options.algorithm);
+        // 使用新定义的辅助属性计算内存
+        const memoryRequired = this.calculateRequiredMemory();
+        this.logger.debug(`Acquiring resources: memory=${(memoryRequired / 1024 / 1024).toFixed(2)}MB`);
+        await this.resources.acquire(scriptSource, memoryRequired);
+        const monitor = new HashTaskHealthMonitor(this.state, this.progress, this.resources);
+        monitor.start();
+        try {
+            // 注意：此时 State 的迁移需要符合你上传的 HashTaskState.ts 逻辑
+            if (this.state.canStart()) {
+                this.state.start();
+            }
+            return await this.executeHashing();
+        }
+        catch (err) {
+            // 如果 state 有 fail 方法，在这里调用
+            // this.state.fail(err);
+            this.logger.error('Task failed:', err);
+            throw err;
+        }
+        finally {
+            this.logger.debug('Releasing resources and stopping monitor.');
+            monitor.stop();
+            await this.resources.release();
+        }
+    }
+    /**
+     * 暂停任务：通过状态机实现
+     *
+     * 检查当前状态是否允许暂停，如果允许则更新状态为暂停
+     */
+    pause() {
+        if (this.state.canPause()) {
+            this.state.pause();
+        }
+    }
+    /**
+     * 恢复任务：通过状态机实现
+     *
+     * 检查当前状态是否允许恢复，如果允许则更新状态为运行中
+     */
+    resume() {
+        if (this.state.canResume()) {
+            this.state.resume();
+        }
+    }
+    /**
+     * 取消任务：直接调用状态机的 cancel
+     * 状态变更为 'cancelled' 后，executeHashing 循环中的 isCancelled() 会检测到并抛出异常
+     *
+     * 检查当前状态是否允许取消，如果允许则更新状态为已取消
+     */
+    cancel() {
+        if (this.state.canCancel()) {
+            this.state.cancel();
+        }
+    }
+    /**
+     * 等待任务恢复（如果处于暂停状态）
+     *
+     * 当任务处于暂停状态时，持续等待直到恢复运行或被取消
+     *
+     * @private
+     */
+    async waitIfPaused() {
+        // ✅ 统一使用 state 判定，不再需要私有变量
+        while (this.state.value === 'paused' && !this.state.isCancelled()) {
+            await new Promise(resolve => setTimeout(resolve, 200));
+        }
+    }
+    /**
+     * 运行单个数据块的哈希计算
+     *
+     * 该方法向Worker发送数据块进行哈希计算，并等待处理结果
+     *
+     * @param worker Worker句柄
+     * @param chunk 要处理的数据块
+     * @returns Promise<void> 表示处理完成的Promise
+     * @private
+     */
+    async runChunk(worker, chunk) {
+        return new Promise((resolve, reject) => {
+            let unsubscribe;
+            // 1. 定义处理器
+            const handler = (msg) => {
+                // 只响应当前 chunk 的确认消息
+                if (msg.type === 'ack' && msg.chunkId === chunk.id) {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 执行清理！
+                    resolve();
+                }
+                else if (msg.type === 'error') {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 出错也要清理！
+                    reject(new Error(msg.message));
+                }
+            };
+            // 2. 订阅消息
+            unsubscribe = worker.onMessage(handler);
+            // 3. 发送数据
+            worker.post({ type: 'update', chunkId: chunk.id, data: chunk.data }, [chunk.data] // 零拷贝转移
+            );
+        });
+    }
+    /**
+     * 完成哈希计算并获取最终结果
+     *
+     * 该方法向Worker发送完成信号并等待最终的哈希结果
+     *
+     * @param worker Worker句柄
+     * @returns Promise<ArrayBuffer> 包含最终哈希结果的Promise
+     * @private
+     */
+    async finalize(worker) {
+        return new Promise((resolve, reject) => {
+            let unsubscribe;
+            const onMessage = (msg) => {
+                if (msg.type === 'digest') {
+                    if (unsubscribe)
+                        unsubscribe(); // ✨ 清理
+                    resolve(msg.result);
+                }
+            };
+            unsubscribe = worker.onMessage(onMessage);
+            worker.post({ type: 'final' });
+        });
+    }
+    /**
+     * 计算所需内存大小
+     *
+     * 根据数据块大小计算所需的内存，预留额外空间用于处理
+     *
+     * @returns 所需的内存大小（以字节为单位）
+     * @private
+     */
+    calculateRequiredMemory() {
+        // 所有的 Provider 现在都有这个方法了
+        const chunkSize = this.chunkProvider.getChunkSize();
+        // 预留 2 个分片 + 1MB 冗余
+        return chunkSize * 2 + 1024 * 1024;
+    }
+    /**
+     * 执行哈希计算的主要逻辑
+     *
+     * 主循环：获取数据块 -> 检查暂停/取消 -> 执行哈希 -> 更新进度 -> 继续下一块
+     *
+     * @returns Promise<ArrayBuffer> 包含最终哈希结果的Promise
+     * @private
+     */
+    async executeHashing() {
+        const worker = this.resources.getWorker();
+        const provider = this.chunkProvider;
+        while (provider.hasNext()) {
+            // 1. 检查暂停
+            await this.waitIfPaused();
+            // 2. 检查取消
+            if (this.state.isCancelled()) {
+                throw new Error('Task cancelled');
+            }
+            const chunk = await provider.next();
+            if (!chunk)
+                break;
+            // 3. 执行哈希
+            await this.runChunk(worker, chunk);
+            // 4. 更新进度
+            this.progress.onChunk(chunk);
+        }
+        const result = await this.finalize(worker);
+        // ✨ 完成后同步状态机
+        if (this.state.canPause()) {
+            // 此时状态通常是 running
+            this.state.complete();
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=HashTaskRunner.js.map

package/dist/task/hash-task/hash/HashTaskRunner.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashTaskRunner.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/hash/HashTaskRunner.ts"],"names":[],"mappings":"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"}

package/dist/task/hash-task/hash/HashTaskState.esm.js

@@ -0,0 +1,203 @@
+import { TaskStateError } from '../errors';
+/**
+ * 哈希任务状态管理类
+ *
+ * 管理哈希任务的整个生命周期状态，包括状态迁移验证和状态查询
+ */
+export class HashTaskState {
+    constructor() {
+        this.status = 'idle';
+    }
+    /**
+     * 获取当前任务状态
+     */
+    get value() {
+        return this.status;
+    }
+    /* ---------------- 状态查询 ---------------- */
+    /**
+     * 检查是否可以开始任务
+     *
+     * @returns 如果当前状态为 'idle' 则返回 true，否则返回 false
+     */
+    canStart() {
+        return this.status === 'idle';
+    }
+    /**
+     * 检查是否可以暂停任务
+     *
+     * @returns 如果当前状态为 'running' 则返回 true，否则返回 false
+     */
+    canPause() {
+        return this.status === 'running';
+    }
+    /**
+     * 检查是否可以恢复任务
+     *
+     * @returns 如果当前状态为 'paused' 则返回 true，否则返回 false
+     */
+    canResume() {
+        return this.status === 'paused';
+    }
+    /**
+     * 检查是否可以取消任务
+     *
+     * @returns 如果当前状态为 'running' 或 'paused' 则返回 true，否则返回 false
+     */
+    canCancel() {
+        return this.status === 'running' || this.status === 'paused';
+    }
+    /**
+     * 检查任务是否已完成
+     *
+     * @returns 如果当前状态为 'completed'、'failed' 或 'cancelled' 则返回 true，否则返回 false
+     */
+    isFinished() {
+        return (this.status === 'completed' || this.status === 'failed' || this.status === 'cancelled');
+    }
+    /**
+     * 适配 Runner 的检查逻辑
+     * 判断任务是否因为用户操作而进入了取消状态
+     *
+     * @returns 如果当前状态为 'cancelled' 则返回 true，否则返回 false
+     */
+    isCancelled() {
+        return this.status === 'cancelled';
+    }
+    /* ---------------- 状态迁移 ---------------- */
+    /**
+     * 开始任务
+     *
+     * 将任务状态从 'idle' 迁移到 'running'，并记录开始时间
+     *
+     * @throws TaskStateError 如果当前状态不允许开始操作
+     */
+    start() {
+        if (!this.canStart()) {
+            throw new TaskStateError(`Cannot start task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'running';
+        this.startedAt = Date.now();
+    }
+    /**
+     * 暂停任务
+     *
+     * 将任务状态从 'running' 迁移到 'paused'，并记录暂停时间
+     *
+     * @throws TaskStateError 如果当前状态不允许暂停操作
+     */
+    pause() {
+        if (!this.canPause()) {
+            throw new TaskStateError(`Cannot pause task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'paused';
+        this.pausedAt = Date.now();
+    }
+    /**
+     * 恢复任务
+     *
+     * 将任务状态从 'paused' 迁移到 'running'，并清除暂停时间
+     *
+     * @throws TaskStateError 如果当前状态不允许恢复操作
+     */
+    resume() {
+        if (!this.canResume()) {
+            throw new TaskStateError(`Cannot resume task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'running';
+        this.pausedAt = undefined;
+    }
+    /**
+     * 完成任务
+     *
+     * 将任务状态从 'running' 迁移到 'completed'，并记录完成时间
+     *
+     * @throws TaskStateError 如果当前状态不允许完成操作
+     */
+    complete() {
+        // 修复：应该检查当前状态是否允许完成任务
+        if (this.status !== 'running') {
+            throw new TaskStateError(`Cannot complete task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'completed';
+        this.finishedAt = Date.now();
+    }
+    /**
+     * 标记任务失败
+     *
+     * 将任务状态迁移到 'failed'，并记录完成时间
+     *
+     * @param error 失败的错误对象
+     * @throws TaskStateError 如果当前状态不允许失败操作
+     */
+    fail(error) {
+        if (this.isFinished()) {
+            throw new TaskStateError(`Cannot fail task from state "${this.status}"`, {
+                current: this.status,
+                error,
+            });
+        }
+        this.status = 'failed';
+        this.finishedAt = Date.now();
+    }
+    /**
+     * 取消任务
+     *
+     * 将任务状态迁移到 'cancelled'，并记录完成时间
+     *
+     * @throws TaskStateError 如果当前状态不允许取消操作
+     */
+    cancel() {
+        // 修复：应该检查当前状态是否允许取消任务
+        if (!this.canCancel()) {
+            throw new TaskStateError(`Cannot cancel task from state "${this.status}"`, {
+                current: this.status,
+            });
+        }
+        this.status = 'cancelled';
+        this.finishedAt = Date.now();
+    }
+    /* ---------------- 快照 ---------------- */
+    /**
+     * 生成当前状态的快照
+     *
+     * @returns 任务状态快照
+     */
+    snapshot() {
+        return {
+            status: this.status,
+            startedAt: this.startedAt,
+            finishedAt: this.finishedAt,
+            pausedAt: this.pausedAt,
+        };
+    }
+    /**
+     * 适配 Runner 的状态更新逻辑
+     * 将状态迁移封装一层，方便 Runner 调用
+     *
+     * @param newStatus 新的任务状态
+     */
+    updateStatus(newStatus) {
+        // 简单的状态映射或直接赋值（如果外部已经校验过逻辑）
+        switch (newStatus) {
+            case 'running':
+                if (this.canStart())
+                    this.start();
+                break;
+            case 'cancelled':
+                if (this.canCancel())
+                    this.cancel();
+                break;
+            // ... 其他状态映射
+        }
+    }
+}
+//# sourceMappingURL=HashTaskState.js.map

package/dist/task/hash-task/hash/HashTaskState.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashTaskState.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/hash/HashTaskState.ts"],"names":[],"mappings":"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"}

package/dist/task/hash-task/hash/index.esm.js

@@ -0,0 +1,13 @@
+/**
+ * Hash任务模块的公共API导出
+ *
+ * 该模块提供了一个用于处理大文件或数据流的哈希计算任务的完整解决方案，
+ * 包括进度监控、暂停/恢复/取消操作、资源管理等功能。
+ */
+export * from './HashTask';
+export * from './HashTaskProgress';
+export * from './HashTaskResources';
+export * from './HashTaskRunner';
+export * from './HashTaskState';
+export * from './HashTaskHealthMonitor';
+//# sourceMappingURL=index.js.map

package/dist/task/hash-task/hash/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/hash/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

package/dist/task/hash-task/index.esm.js

@@ -0,0 +1,13 @@
+/**
+ * HashTask模块入口文件
+ *
+ * 该文件导出HashTask模块的所有公共API，包括工厂函数、数据块处理、错误定义、
+ * 哈希计算核心功能、类型定义和Worker相关功能
+ */
+export * from './factory';
+export * from './chunk';
+export * from './errors';
+export * from './hash';
+export * from './types';
+export * from './worker';
+//# sourceMappingURL=index.js.map

package/dist/task/hash-task/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task/hash-task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/task/hash-task/types/algorithm.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=algorithm.js.map

package/dist/task/hash-task/types/algorithm.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithm.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/types/algorithm.ts"],"names":[],"mappings":""}

package/dist/task/hash-task/types/chunk.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chunk.js.map

package/dist/task/hash-task/types/chunk.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/types/chunk.ts"],"names":[],"mappings":""}

package/dist/task/hash-task/types/index.esm.js

@@ -0,0 +1,5 @@
+export * from './algorithm';
+export * from './chunk';
+export * from './task';
+export * from './worker';
+//# sourceMappingURL=index.js.map

package/dist/task/hash-task/types/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/task/hash-task/types/task.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task.js.map

package/dist/task/hash-task/types/task.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/types/task.ts"],"names":[],"mappings":""}

package/dist/task/hash-task/types/worker.esm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.js.map

package/dist/task/hash-task/types/worker.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/types/worker.ts"],"names":[],"mappings":""}

package/dist/task/hash-task/worker/BrowserWorkerHandle.esm.js

@@ -0,0 +1,71 @@
+/**
+ * 浏览器环境下的Worker句柄实现
+ *
+ * 提供了浏览器环境下Worker句柄接口的实现，用于与Web Worker通信
+ * 设计原则：只负责与Worker的通信和生命周期管理，不关心具体执行的算法
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export class BrowserWorkerHandle {
+    /**
+     * 构造函数
+     *
+     * @param workerScriptUrl Worker脚本的URL
+     */
+    constructor(workerScriptUrl) {
+        this.id = `worker-${Math.random().toString(36).substr(2, 9)}`;
+        this.worker = new Worker(workerScriptUrl);
+    }
+    /**
+     * 向Worker发送消息
+     *
+     * @param message 要发送的消息内容
+     * @param transfer 可选的可转移对象数组，用于零拷贝传输
+     */
+    post(message, transfer) {
+        this.worker.postMessage(message, transfer || []);
+    }
+    /**
+     * 注册消息监听，并返回一个取消监听的函数
+     *
+     * @param handler 消息处理函数
+     * @returns 用于取消监听的函数
+     */
+    onMessage(handler) {
+        const wrapper = (e) => handler(e.data);
+        this.worker.addEventListener('message', wrapper);
+        // 返回一个清理函数，这就是我们之前讨论的"自清理"模式
+        return () => this.worker.removeEventListener('message', wrapper);
+    }
+    /**
+     * 注册错误监听，并返回一个取消监听的函数
+     *
+     * @param handler 错误处理函数
+     * @returns 用于取消监听的函数
+     */
+    onError(handler) {
+        const wrapper = (e) => handler(new Error(e.message));
+        this.worker.addEventListener('error', wrapper);
+        return () => this.worker.removeEventListener('error', wrapper);
+    }
+    /**
+     * 终止Worker
+     *
+     * 终止Worker线程
+     */
+    async terminate() {
+        this.worker.terminate();
+    }
+    /**
+     * 检查Worker是否仍在运行
+     *
+     * @returns 如果Worker正在运行则返回true，否则返回false
+     */
+    isAlive() {
+        return !!this.worker;
+    }
+}
+//# sourceMappingURL=BrowserWorkerHandle.js.map

package/dist/task/hash-task/worker/BrowserWorkerHandle.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerHandle.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerHandle.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAmB;IAI5B;;;;OAIG;IACH,YAAY,eAAuB;QAC/B,IAAI,CAAC,EAAE,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAU,OAAU,EAAE,QAAyB;QAC/C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAA2B;QACjC,MAAM,OAAO,GAAG,CAAC,CAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEjD,6BAA6B;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAA6B;QACjC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACX,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACH,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;CACJ"}

package/dist/task/hash-task/worker/BrowserWorkerPool.esm.js

@@ -0,0 +1,24 @@
+import { DefaultWorkerPool } from './DefaultWorkerPool';
+/**
+ * 浏览器环境下的Worker池实现
+ *
+ * 继承自DefaultWorkerPool，针对浏览器环境进行了优化
+ * 设计原则：只负责Worker的生命周期管理，不关心具体执行的任务
+ *
+ * 明确不负责：
+ * - 不执行具体的哈希计算
+ * - 不管理任务状态
+ * - 不处理算法逻辑
+ */
+export class BrowserWorkerPool extends DefaultWorkerPool {
+    /**
+     * 浏览器环境下的池子实现
+     *
+     * @param poolSize 并行 Worker 数量，默认根据 CPU 核心数计算
+     */
+    constructor(poolSize = Math.min(navigator.hardwareConcurrency || 4, 8)) {
+        // 现在父类构造函数只接收 maxWorkers
+        super(poolSize);
+    }
+}
+//# sourceMappingURL=BrowserWorkerPool.js.map

package/dist/task/hash-task/worker/BrowserWorkerPool.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserWorkerPool.js","sourceRoot":"","sources":["../../../../../src/task/hash-task/worker/BrowserWorkerPool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACpD;;;;OAIG;IACH,YAAY,WAAmB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,yBAAyB;QACzB,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;CACJ"}