front-cpu 0.1.1

package/dist/stages/WB.js

@@ -0,0 +1,102 @@
+/**
+ * WB阶段：Write Back（写回）
+ *
+ * 职责：
+ * 1. 调用 commit 函数（成功时）
+ * 2. 回滚乐观更新（失败时）
+ */
+import { InstructionStatus } from '../types';
+import { getISA } from '../isa';
+import { cpuEventCollector, cpuConsole } from '../logging/runtime';
+export class WriteBackStage {
+    /**
+     * 回滚乐观更新
+     */
+    rollbackOptimisticUpdate(instruction) {
+        const ISA = getISA();
+        const definition = ISA[instruction.type];
+        if (instruction.optimisticSnapshot && definition?.optimistic?.rollback) {
+            // 记录回滚操作
+            if (!instruction.writeBackExecution) {
+                instruction.writeBackExecution = { hasCommit: false, rollbackExecuted: true };
+            }
+            instruction.writeBackExecution.rollbackExecuted = true;
+            instruction.writeBackExecution.rollbackSnapshot = instruction.optimisticSnapshot;
+            // 🎯 记录乐观更新回滚事件
+            cpuEventCollector.onOptimisticRolledBack(instruction.id, instruction.type, instruction.context.correlationId, instruction.optimisticSnapshot, '指令执行失败', instruction.error);
+            cpuConsole.onOptimisticRolledBack(instruction, '指令执行失败');
+            try {
+                definition.optimistic.rollback(instruction.optimisticSnapshot);
+            }
+            catch (rollbackError) {
+                instruction.writeBackExecution.rollbackError =
+                    rollbackError instanceof Error ? rollbackError : new Error(String(rollbackError));
+                console.error('❌ [CPU] 乐观更新回滚失败:', {
+                    instructionId: instruction.id,
+                    type: instruction.type,
+                    error: rollbackError,
+                });
+            }
+        }
+    }
+    /**
+     * 写回/完成指令
+     */
+    async writeBack(instruction, success) {
+        // 标记WB阶段
+        instruction.timestamps.WB = Date.now();
+        const ISA = getISA();
+        const definition = ISA[instruction.type];
+        // 初始化WB执行记录
+        instruction.writeBackExecution = {
+            hasCommit: !!(definition && definition.commit),
+            rollbackExecuted: false,
+        };
+        // 🔥 如果指令已被取消，只回滚不提交
+        if (instruction.cancelled) {
+            this.rollbackOptimisticUpdate(instruction);
+            return;
+        }
+        if (success) {
+            // ==================== 成功路径 ====================
+            // 🔥 调用 commit 函数（如果存在）
+            if (definition && definition.commit) {
+                // 记录commit调用参数
+                instruction.writeBackExecution.commitArgs = {
+                    result: instruction.result,
+                    payload: instruction.payload,
+                    context: instruction.context,
+                    optimisticSnapshot: instruction.optimisticSnapshot,
+                };
+                try {
+                    await definition.commit(instruction.result, instruction.payload, instruction.context, instruction.optimisticSnapshot // 🔥 传递乐观更新快照
+                    );
+                    instruction.writeBackExecution.commitSuccess = true;
+                }
+                catch (error) {
+                    instruction.writeBackExecution.commitSuccess = false;
+                    instruction.writeBackExecution.commitError =
+                        error instanceof Error ? error : new Error(String(error));
+                    // commit失败 → 回滚乐观更新
+                    this.rollbackOptimisticUpdate(instruction);
+                    // 设置为失败状态
+                    instruction.status = InstructionStatus.FAILED;
+                    instruction.error = instruction.writeBackExecution.commitError;
+                    return;
+                }
+            }
+            // 成功场景
+            instruction.status = InstructionStatus.COMMITTED;
+        }
+        else {
+            // ==================== 失败路径 ====================
+            // 🔥 回滚乐观更新
+            this.rollbackOptimisticUpdate(instruction);
+            // 设置失败状态（如果不是已取消）
+            if (instruction.status !== InstructionStatus.CANCELLED) {
+                instruction.status = InstructionStatus.FAILED;
+            }
+        }
+    }
+}
+//# sourceMappingURL=WB.js.map

package/dist/stages/WB.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * CPU流水线核心类型定义
+ */
+import type { CallSource } from './logging/types';
+/**
+ * 流水线阶段
+ */
+export declare const PipelineStage: {
+    readonly IF: "IF";
+    readonly SCH: "SCH";
+    readonly EX: "EX";
+    readonly RES: "RES";
+    readonly WB: "WB";
+};
+export type PipelineStage = (typeof PipelineStage)[keyof typeof PipelineStage];
+/**
+ * 指令状态
+ */
+export declare const InstructionStatus: {
+    readonly PENDING: "pending";
+    readonly ISSUED: "issued";
+    readonly EXECUTING: "executing";
+    readonly RESPONDED: "responded";
+    readonly COMMITTED: "committed";
+    readonly FAILED: "failed";
+    readonly CANCELLED: "cancelled";
+};
+export type InstructionStatus = (typeof InstructionStatus)[keyof typeof InstructionStatus];
+/**
+ * 指令执行上下文
+ */
+export interface InstructionContext {
+    /** 指令唯一ID */
+    instructionId: string;
+    /** 关联ID（用于SSE去重等） */
+    correlationId: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 来源 */
+    source: 'user' | 'system' | 'test';
+    /** 重试次数 */
+    retryCount: number;
+    /** 调用源（哪个文件哪一行发起的指令） */
+    callSource?: CallSource;
+}
+/**
+ * WB阶段执行信息
+ */
+export interface WriteBackExecution {
+    /** 是否有commit函数 */
+    hasCommit: boolean;
+    /** commit函数调用参数 */
+    commitArgs?: {
+        result: any;
+        payload: any;
+        context: InstructionContext;
+        optimisticSnapshot?: any;
+    };
+    /** commit执行结果 */
+    commitSuccess?: boolean;
+    /** commit错误信息 */
+    commitError?: Error;
+    /** 是否执行了回滚 */
+    rollbackExecuted?: boolean;
+    /** 回滚快照 */
+    rollbackSnapshot?: any;
+    /** 回滚错误 */
+    rollbackError?: Error;
+}
+/**
+ * 队列中的指令
+ */
+export interface QueuedInstruction<TPayload = any> {
+    /** 指令ID */
+    id: string;
+    /** 指令类型 */
+    type: string;
+    /** 指令负载 */
+    payload: TPayload;
+    /** 执行上下文 */
+    context: InstructionContext;
+    /** 当前状态 */
+    status: InstructionStatus;
+    /** 各阶段时间戳 */
+    timestamps: {
+        IF?: number;
+        SCH?: number;
+        EX?: number;
+        RES?: number;
+        WB?: number;
+    };
+    /** 执行结果 */
+    result?: any;
+    /** 错误信息 */
+    error?: Error;
+    /** 乐观更新快照（用于回滚） */
+    optimisticSnapshot?: any;
+    /** WB阶段执行详情 */
+    writeBackExecution?: WriteBackExecution;
+    /** 是否已取消（用于 switchMap 策略） */
+    cancelled?: boolean;
+    /** 取消原因 */
+    cancelReason?: string;
+    /** 取消发生的阶段 */
+    cancelledAt?: 'SCH' | 'EX' | 'RES';
+    /** 用于取消网络请求 */
+    abortController?: AbortController;
+    /** 指令标签 */
+    tags?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAA;AAE9E;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;CAQpB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAA;AAE1F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS;IACT,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAClC,WAAW;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,mBAAmB;IACnB,UAAU,CAAC,EAAE;QACX,MAAM,EAAE,GAAG,CAAA;QACX,OAAO,EAAE,GAAG,CAAA;QACZ,OAAO,EAAE,kBAAkB,CAAA;QAC3B,kBAAkB,CAAC,EAAE,GAAG,CAAA;KACzB,CAAA;IACD,iBAAiB;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iBAAiB;IACjB,WAAW,CAAC,EAAE,KAAK,CAAA;IACnB,cAAc;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,WAAW;IACX,gBAAgB,CAAC,EAAE,GAAG,CAAA;IACtB,WAAW;IACX,aAAa,CAAC,EAAE,KAAK,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,GAAG;IAC/C,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,OAAO,EAAE,QAAQ,CAAA;IACjB,YAAY;IACZ,OAAO,EAAE,kBAAkB,CAAA;IAC3B,WAAW;IACX,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa;IACb,UAAU,EAAE;QACV,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,EAAE,CAAC,EAAE,MAAM,CAAA;KACZ,CAAA;IACD,WAAW;IACX,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,mBAAmB;IACnB,kBAAkB,CAAC,EAAE,GAAG,CAAA;IACxB,eAAe;IACf,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc;IACd,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,CAAA;IAClC,eAAe;IACf,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB"}

package/dist/types.js

@@ -0,0 +1,26 @@
+/**
+ * CPU流水线核心类型定义
+ */
+/**
+ * 流水线阶段
+ */
+export const PipelineStage = {
+    IF: 'IF', // Instruction Fetch
+    SCH: 'SCH', // Scheduler
+    EX: 'EX', // Execute
+    RES: 'RES', // Response
+    WB: 'WB', // Write Back
+};
+/**
+ * 指令状态
+ */
+export const InstructionStatus = {
+    PENDING: 'pending', // 在IF缓冲区等待调度
+    ISSUED: 'issued', // 已发射到EX阶段
+    EXECUTING: 'executing', // 正在执行
+    RESPONDED: 'responded', // 已收到响应
+    COMMITTED: 'committed', // 已提交完成
+    FAILED: 'failed', // 执行失败
+    CANCELLED: 'cancelled', // 被取消/丢弃（可能在任何阶段）
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,IAAI,EAAE,oBAAoB;IAC9B,GAAG,EAAE,KAAK,EAAE,YAAY;IACxB,EAAE,EAAE,IAAI,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK,EAAE,WAAW;IACvB,EAAE,EAAE,IAAI,EAAE,aAAa;CACf,CAAA;AAIV;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS,EAAE,aAAa;IACjC,MAAM,EAAE,QAAQ,EAAE,WAAW;IAC7B,SAAS,EAAE,WAAW,EAAE,OAAO;IAC/B,SAAS,EAAE,WAAW,EAAE,QAAQ;IAChC,SAAS,EAAE,WAAW,EAAE,QAAQ;IAChC,MAAM,EAAE,QAAQ,EAAE,OAAO;IACzB,SAAS,EAAE,WAAW,EAAE,kBAAkB;CAClC,CAAA"}

package/dist/utils/InstructionCancellation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 指令取消管理器
+ *
+ * 提供统一的指令取消机制，可以在任何阶段取消指令
+ */
+import type { QueuedInstruction } from '../types';
+/**
+ * 取消指令
+ *
+ * @param instruction 要取消的指令
+ * @param reason 取消原因
+ * @param stage 取消发生的阶段
+ */
+export declare function cancelInstruction(instruction: QueuedInstruction, reason: string, stage: 'SCH' | 'EX' | 'RES'): void;
+/**
+ * 检查指令是否已被取消
+ */
+export declare function isInstructionCancelled(instruction: QueuedInstruction): boolean;
+/**
+ * 获取取消信息（用于日志）
+ */
+export declare function getCancellationInfo(instruction: QueuedInstruction): {
+    cancelled: boolean;
+    reason?: string;
+    stage?: string;
+};
+/**
+ * 批量取消指令（用于 switchMap 等场景）
+ */
+export declare function cancelInstructions(instructions: QueuedInstruction[], reason: string, stage: 'SCH' | 'EX' | 'RES'): void;
+//# sourceMappingURL=InstructionCancellation.d.ts.map

package/dist/utils/InstructionCancellation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstructionCancellation.d.ts","sourceRoot":"","sources":["../../src/utils/InstructionCancellation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAGjD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,GAC1B,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAE9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,iBAAiB,GAAG;IACnE,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAMA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,iBAAiB,EAAE,EACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,GAC1B,IAAI,CAMN"}

package/dist/utils/InstructionCancellation.js

@@ -0,0 +1,53 @@
+/**
+ * 指令取消管理器
+ *
+ * 提供统一的指令取消机制，可以在任何阶段取消指令
+ */
+import { InstructionStatus } from '../types';
+/**
+ * 取消指令
+ *
+ * @param instruction 要取消的指令
+ * @param reason 取消原因
+ * @param stage 取消发生的阶段
+ */
+export function cancelInstruction(instruction, reason, stage) {
+    // 标记为已取消
+    instruction.cancelled = true;
+    instruction.cancelReason = reason;
+    instruction.cancelledAt = stage;
+    instruction.status = InstructionStatus.CANCELLED;
+    // 设置错误信息
+    instruction.error = new Error(`[${stage}] ${reason}`);
+    // 🔥 实际取消网络请求
+    if (instruction.abortController && !instruction.abortController.signal.aborted) {
+        instruction.abortController.abort(instruction.cancelReason);
+    }
+}
+/**
+ * 检查指令是否已被取消
+ */
+export function isInstructionCancelled(instruction) {
+    return instruction.cancelled === true || instruction.status === InstructionStatus.CANCELLED;
+}
+/**
+ * 获取取消信息（用于日志）
+ */
+export function getCancellationInfo(instruction) {
+    return {
+        cancelled: isInstructionCancelled(instruction),
+        reason: instruction.cancelReason,
+        stage: instruction.cancelledAt,
+    };
+}
+/**
+ * 批量取消指令（用于 switchMap 等场景）
+ */
+export function cancelInstructions(instructions, reason, stage) {
+    for (const instruction of instructions) {
+        if (!isInstructionCancelled(instruction)) {
+            cancelInstruction(instruction, reason, stage);
+        }
+    }
+}
+//# sourceMappingURL=InstructionCancellation.js.map

package/dist/utils/InstructionCancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstructionCancellation.js","sourceRoot":"","sources":["../../src/utils/InstructionCancellation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAA8B,EAC9B,MAAc,EACd,KAA2B;IAE3B,SAAS;IACT,WAAW,CAAC,SAAS,GAAG,IAAI,CAAA;IAC5B,WAAW,CAAC,YAAY,GAAG,MAAM,CAAA;IACjC,WAAW,CAAC,WAAW,GAAG,KAAK,CAAA;IAC/B,WAAW,CAAC,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAA;IAEhD,SAAS;IACT,WAAW,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC,CAAA;IAErD,cAAc;IACd,IAAI,WAAW,CAAC,eAAe,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/E,WAAW,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAA8B;IACnE,OAAO,WAAW,CAAC,SAAS,KAAK,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,iBAAiB,CAAC,SAAS,CAAA;AAC7F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAA8B;IAKhE,OAAO;QACL,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC;QAC9C,MAAM,EAAE,WAAW,CAAC,YAAY;QAChC,KAAK,EAAE,WAAW,CAAC,WAAW;KAC/B,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAiC,EACjC,MAAc,EACd,KAA2B;IAE3B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;YACzC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/abortable.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 可取消的 Promise 包装器
+ *
+ * 将任意 Promise 与 AbortSignal 结合，使其可以被外部取消
+ */
+/**
+ * 将 Promise 包装为可取消的版本
+ *
+ * @param promise 原始 Promise
+ * @param abortSignal 取消信号
+ * @returns 可取消的 Promise
+ *
+ * 工作原理：
+ * - 使用 Promise.race 让 promise 和 abortPromise 竞争
+ * - 如果 abort 先触发，整个操作会立即被 reject
+ * - 如果 promise 先完成，正常返回结果
+ *
+ * 效果：
+ * - 对 fetch：网络请求会被立即取消
+ * - 对自定义 execute：即使不处理 signal，也会被中断
+ */
+export declare function makeAbortable<T>(promise: Promise<T>, abortSignal?: AbortSignal): Promise<T>;
+/**
+ * 创建一个可取消的延迟函数
+ *
+ * @param ms 延迟毫秒数
+ * @param abortSignal 取消信号
+ */
+export declare function cancellableDelay(ms: number, abortSignal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=abortable.d.ts.map

package/dist/utils/abortable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable.d.ts","sourceRoot":"","sources":["../../src/utils/abortable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBrF"}

package/dist/utils/abortable.js

@@ -0,0 +1,76 @@
+/**
+ * 可取消的 Promise 包装器
+ *
+ * 将任意 Promise 与 AbortSignal 结合，使其可以被外部取消
+ */
+/**
+ * 将 AbortSignal 转换为 Promise
+ * 当 abort 事件触发时，Promise 会 reject
+ */
+function abortSignalToPromise(signal) {
+    return new Promise((_, reject) => {
+        // 如果已经被 abort，立即 reject
+        if (signal.aborted) {
+            reject(new Error('Operation was aborted'));
+            return;
+        }
+        // 监听 abort 事件
+        const abortHandler = () => {
+            reject(new Error('Operation was aborted'));
+        };
+        signal.addEventListener('abort', abortHandler, { once: true });
+    });
+}
+/**
+ * 将 Promise 包装为可取消的版本
+ *
+ * @param promise 原始 Promise
+ * @param abortSignal 取消信号
+ * @returns 可取消的 Promise
+ *
+ * 工作原理：
+ * - 使用 Promise.race 让 promise 和 abortPromise 竞争
+ * - 如果 abort 先触发，整个操作会立即被 reject
+ * - 如果 promise 先完成，正常返回结果
+ *
+ * 效果：
+ * - 对 fetch：网络请求会被立即取消
+ * - 对自定义 execute：即使不处理 signal，也会被中断
+ */
+export function makeAbortable(promise, abortSignal) {
+    // 如果没有提供 signal，直接返回原 promise
+    if (!abortSignal) {
+        return promise;
+    }
+    // 如果 signal 已经 aborted，立即 reject
+    if (abortSignal.aborted) {
+        return Promise.reject(new Error('Operation was aborted'));
+    }
+    // 使用 Promise.race 让执行和取消竞争
+    return Promise.race([
+        promise,
+        abortSignalToPromise(abortSignal)
+    ]);
+}
+/**
+ * 创建一个可取消的延迟函数
+ *
+ * @param ms 延迟毫秒数
+ * @param abortSignal 取消信号
+ */
+export function cancellableDelay(ms, abortSignal) {
+    return new Promise((resolve, reject) => {
+        if (abortSignal?.aborted) {
+            reject(new Error('Operation was aborted'));
+            return;
+        }
+        const timeoutId = setTimeout(() => {
+            resolve();
+        }, ms);
+        abortSignal?.addEventListener('abort', () => {
+            clearTimeout(timeoutId);
+            reject(new Error('Operation was aborted'));
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=abortable.js.map

package/dist/utils/abortable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abortable.js","sourceRoot":"","sources":["../../src/utils/abortable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,SAAS,oBAAoB,CAAC,MAAmB;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/B,wBAAwB;QACxB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;YAC1C,OAAM;QACR,CAAC;QAED,cAAc;QACd,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;QAC5C,CAAC,CAAA;QAED,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAmB,EACnB,WAAyB;IAEzB,8BAA8B;IAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,iCAAiC;IACjC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,2BAA2B;IAC3B,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,OAAO;QACP,oBAAoB,CAAC,WAAW,CAAC;KAClC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,WAAyB;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;YAC1C,OAAM;QACR,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE,CAAA;QACX,CAAC,EAAE,EAAE,CAAC,CAAA;QAEN,WAAW,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC1C,YAAY,CAAC,SAAS,CAAC,CAAA;YACvB,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;QAC5C,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/utils/request.d.ts

@@ -0,0 +1,27 @@
+/**
+ * FrontCPU 统一请求工具（解耦版）
+ *
+ * 通过依赖注入实现HTTP客户端解耦
+ *
+ * 支持：
+ * 1. 单个请求
+ * 2. 多个请求（并发/串行）
+ * 3. 自动添加 correlation-id
+ */
+import type { IHttpClient } from '../interfaces';
+import type { InstructionContext } from '../types';
+import type { RequestConfig, MultiRequestConfig } from '../isa/types';
+/**
+ * 设置HTTP客户端（必须在使用前调用）
+ */
+export declare function setHttpClient(client: IHttpClient): void;
+/**
+ * 执行 HTTP 请求（单个或多个）
+ *
+ * @param config 请求配置（单个或多个）
+ * @param payload 指令负载
+ * @param context 指令上下文
+ * @returns 请求结果
+ */
+export declare function executeRequest(config: RequestConfig | MultiRequestConfig, payload: any, context: InstructionContext, abortSignal?: AbortSignal): Promise<any>;
+//# sourceMappingURL=request.d.ts.map

package/dist/utils/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAKrE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEvD;AA0DD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,GAAG,kBAAkB,EAC1C,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,kBAAkB,EAC3B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,GAAG,CAAC,CA8Bd"}

package/dist/utils/request.js

@@ -0,0 +1,96 @@
+/**
+ * FrontCPU 统一请求工具（解耦版）
+ *
+ * 通过依赖注入实现HTTP客户端解耦
+ *
+ * 支持：
+ * 1. 单个请求
+ * 2. 多个请求（并发/串行）
+ * 3. 自动添加 correlation-id
+ */
+// 全局HTTP客户端（通过setHttpClient注入）
+let httpClient = null;
+/**
+ * 设置HTTP客户端（必须在使用前调用）
+ */
+export function setHttpClient(client) {
+    httpClient = client;
+}
+/**
+ * 执行单个 HTTP 请求
+ */
+async function executeSingleRequest(config, payload, context, abortSignal) {
+    if (!httpClient) {
+        throw new Error('HttpClient未初始化，请先调用setHttpClient()');
+    }
+    // 解析 URL
+    const url = typeof config.url === 'function' ? config.url(payload) : config.url;
+    // 解析请求体
+    const body = config.body ? config.body(payload) : payload;
+    // 统一添加 correlation-id
+    const headers = {
+        'X-Correlation-ID': context.correlationId,
+        ...config.headers,
+    };
+    const requestConfig = {
+        headers,
+        signal: abortSignal // 传递取消信号
+    };
+    // 根据方法执行请求
+    switch (config.method) {
+        case 'GET':
+            return await httpClient.get(url, requestConfig);
+        case 'POST':
+            return await httpClient.post(url, body, requestConfig);
+        case 'PUT':
+            return await httpClient.put(url, body, requestConfig);
+        case 'PATCH':
+            return await httpClient.patch(url, body, requestConfig);
+        case 'DELETE':
+            return await httpClient.delete(url, requestConfig);
+        default:
+            throw new Error(`Unsupported HTTP method: ${config.method}`);
+    }
+}
+/**
+ * 判断是否是多请求配置
+ */
+function isMultiRequestConfig(config) {
+    return 'requests' in config && Array.isArray(config.requests);
+}
+/**
+ * 执行 HTTP 请求（单个或多个）
+ *
+ * @param config 请求配置（单个或多个）
+ * @param payload 指令负载
+ * @param context 指令上下文
+ * @returns 请求结果
+ */
+export async function executeRequest(config, payload, context, abortSignal) {
+    // 单个请求
+    if (!isMultiRequestConfig(config)) {
+        return await executeSingleRequest(config, payload, context, abortSignal);
+    }
+    // 多个请求
+    const { requests, mode, combineResults } = config;
+    let results;
+    if (mode === 'parallel') {
+        // 🔥 并发执行所有请求
+        results = await Promise.all(requests.map((req) => executeSingleRequest(req, payload, context, abortSignal)));
+    }
+    else {
+        // 🔥 串行执行所有请求
+        results = [];
+        for (const req of requests) {
+            const result = await executeSingleRequest(req, payload, context, abortSignal);
+            results.push(result);
+        }
+    }
+    // 合并结果（如果提供了合并函数）
+    if (combineResults) {
+        return combineResults(results);
+    }
+    // 默认：返回结果数组
+    return results;
+}
+//# sourceMappingURL=request.js.map

package/dist/utils/request.js.map

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