yuangs 5.43.0 → 5.45.0

package/dist/core/capability/DegradationPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"DegradationPolicy.js","sourceRoot":"","sources":["../../../src/core/capability/DegradationPolicy.ts"],"names":[],"mappings":";;;AAAA,uDAA0F;AAkB1F,MAAa,0BAA0B;IAC3B,SAAS,CAAS;IAClB,mBAAmB,CAAS;IAEpC,YAAY,UAGR,EAAE;QACF,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,KAAoB,EAAE,aAA4B;QACrD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,WAAW,sBAAsB,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC9G,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACH,aAAa,EAAE,KAAK;gBACpB,WAAW,EAAE,aAAa,CAAC,aAAa;gBACxC,MAAM,EAAE,2CAA2C;aACtD,CAAC;QACN,CAAC;QAED,MAAM,aAAa,GAAG,CAAC,aAAa,CAAC,aAAa,EAAE,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAEpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO;oBACH,aAAa,EAAE,IAAI;oBACnB,WAAW;oBACX,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,kCAAkC,WAAW,EAAE;iBAC/E,CAAC;YACN,CAAC;YAED,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;YAE1C,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxC,OAAO;oBACH,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,SAAS;oBACtB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAoB,WAAW,OAAO,SAAS,EAAE;iBACjF,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO;YACH,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,iCAAe,CAAC,IAAI;YACjC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAwB;SACxD,CAAC;IACN,CAAC;CACJ;AA7DD,gEA6DC;AAED,MAAa,qBAAqB;IAC9B,MAAM,CAAC,KAAoB,EAAE,aAA4B;QACrD,OAAO;YACH,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,aAAa,CAAC,aAAa;YACxC,MAAM,EAAE,8BAA8B;SACzC,CAAC;IACN,CAAC;CACJ;AARD,sDAQC"}
+{"version":3,"file":"DegradationPolicy.js","sourceRoot":"","sources":["../../../src/core/capability/DegradationPolicy.ts"],"names":[],"mappings":";;;AAAA,uDAA6F;AAkB7F,MAAa,0BAA0B;IAC3B,SAAS,CAAS;IAClB,mBAAmB,CAAS;IAEpC,YAAY,UAGR,EAAE;QACF,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,KAAoB,EAAE,aAA4B;QACrD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,WAAW,sBAAsB,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC9G,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACH,aAAa,EAAE,KAAK;gBACpB,WAAW,EAAE,aAAa,CAAC,aAAa;gBACxC,MAAM,EAAE,2CAA2C;aACtD,CAAC;QACN,CAAC;QAED,MAAM,aAAa,GAAG,CAAC,aAAa,CAAC,aAAa,EAAE,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAEpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO;oBACH,aAAa,EAAE,IAAI;oBACnB,WAAW;oBACX,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,kCAAkC,WAAW,EAAE;iBAC/E,CAAC;YACN,CAAC;YAED,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;YAE1C,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxC,OAAO;oBACH,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,SAAS;oBACtB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,oBAAoB,WAAW,OAAO,SAAS,EAAE;iBACjF,CAAC;YACN,CAAC;QACL,CAAC;QAED,OAAO;YACH,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,iCAAe,CAAC,IAAI;YACjC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,wBAAwB;SACxD,CAAC;IACN,CAAC;CACJ;AA7DD,gEA6DC;AAED,MAAa,qBAAqB;IAC9B,MAAM,CAAC,KAAoB,EAAE,aAA4B;QACrD,OAAO;YACH,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,aAAa,CAAC,aAAa;YACxC,MAAM,EAAE,8BAA8B;SACzC,CAAC;IACN,CAAC;CACJ;AARD,sDAQC"}

package/dist/core/capability/Logger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 日志级别
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    NONE = 4
+}
+/**
+ * 日志接口
+ * 支持依赖注入，便于测试和自定义日志输出
+ */
+export interface Logger {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+/**
+ * 控制台日志实现（默认）
+ */
+export declare class ConsoleLogger implements Logger {
+    private level;
+    constructor(level?: LogLevel);
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    setLevel(level: LogLevel): void;
+}
+/**
+ * 无操作日志（用于测试）
+ */
+export declare class NoOpLogger implements Logger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}

package/dist/core/capability/Logger.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpLogger = exports.ConsoleLogger = exports.LogLevel = void 0;
+/**
+ * 日志级别
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 4] = "NONE";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * 控制台日志实现（默认）
+ */
+class ConsoleLogger {
+    level;
+    constructor(level = LogLevel.INFO) {
+        this.level = level;
+    }
+    debug(message, ...args) {
+        if (this.level <= LogLevel.DEBUG) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.log(message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LogLevel.WARN) {
+            console.warn(message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LogLevel.ERROR) {
+            console.error(message, ...args);
+        }
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+/**
+ * 无操作日志（用于测试）
+ */
+class NoOpLogger {
+    debug() { }
+    info() { }
+    warn() { }
+    error() { }
+}
+exports.NoOpLogger = NoOpLogger;
+//# sourceMappingURL=Logger.js.map

package/dist/core/capability/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../../src/core/capability/Logger.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;AACZ,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAaD;;GAEG;AACH,MAAa,aAAa;IACd,KAAK,CAAW;IAExB,YAAY,QAAkB,QAAQ,CAAC,IAAI;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACjC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAChC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAChC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACjC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,KAAe;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ;AAlCD,sCAkCC;AAED;;GAEG;AACH,MAAa,UAAU;IACnB,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACnB;AALD,gCAKC"}

package/dist/core/capability/Pipeline.d.ts

@@ -0,0 +1,146 @@
+import { CapabilityLevel, MinCapability } from './CapabilityLevel';
+export { CapabilityLevel };
+import { CostProfile, CostProfileCalculator } from './CostProfile';
+import { DegradationPolicy } from './DegradationPolicy';
+import { Logger } from './Logger';
+/**
+ * Pipeline 元数据接口
+ * 类型安全，避免使用 Record<string, any>
+ */
+export interface PipelineMetadata {
+    costProfile?: CostProfile;
+    [key: string]: unknown;
+}
+/**
+ * Pipeline 阶段接口
+ */
+export interface PipelineStage {
+    name: string;
+    minCapability: MinCapability;
+    execute: (context: PipelineContext) => Promise<PipelineResult>;
+}
+/**
+ * Pipeline 上下文
+ * 包含执行过程中的所有状态信息
+ */
+export interface PipelineContext {
+    /** 任务描述 */
+    taskDescription: string;
+    /** 涉及的文件列表 */
+    files: string[];
+    /** 总行数 */
+    totalLines: number;
+    /** 用户提供的额外数据 */
+    metadata?: PipelineMetadata;
+    /** 当前能力等级 */
+    currentCapability: CapabilityLevel;
+    /** 执行历史（用于分析降级原因） */
+    executionHistory: ExecutionRecord[];
+}
+/**
+ * 执行记录
+ * 包含实际执行时的能力等级
+ */
+export interface ExecutionRecord {
+    stage: string;
+    actualCapability: CapabilityLevel;
+    startTime: number;
+    endTime: number;
+    success: boolean;
+    confidence: number;
+    degradationApplied?: boolean;
+    degradationReason?: string;
+}
+/**
+ * Pipeline 执行结果
+ * capability 字段明确表示最终达到的能力等级
+ */
+export interface PipelineResult {
+    success: boolean;
+    data?: unknown;
+    error?: Error;
+    confidence: number;
+    finalCapability: CapabilityLevel;
+    degradation?: {
+        applied: boolean;
+        originalLevel: CapabilityLevel;
+        targetLevel: CapabilityLevel;
+        reason: string;
+    };
+}
+/**
+ * Pipeline 配置
+ */
+export interface PipelineConfig {
+    /** 阶段列表 */
+    stages: PipelineStage[];
+    /** 降级策略 */
+    degradationPolicy: DegradationPolicy;
+    /** 成本计算器 */
+    costCalculator: CostProfileCalculator;
+    /** 日志记录器 */
+    logger: Logger;
+    /** 是否启用自动降级 */
+    autoDegradation: boolean;
+    /** 最大执行时间（毫秒） */
+    maxExecutionTime?: number;
+    /** 置信度阈值 */
+    confidenceThreshold?: number;
+}
+/**
+ * Pipeline 执行统计
+ */
+export interface PipelineStats {
+    /** 总执行时间（毫秒） */
+    totalTime: number;
+    /** 总 token 消耗 */
+    totalTokens: number;
+    /** 实际达到的能力等级 */
+    finalCapability: CapabilityLevel;
+    /** 降级次数 */
+    degradationCount: number;
+    /** 执行的阶段数 */
+    stagesExecuted: number;
+    /** 成功的阶段数 */
+    stagesSucceeded: number;
+}
+/**
+ * 能力感知的 Pipeline 执行器
+ *
+ * 核心功能：
+ * 1. 根据任务复杂度自动计算能力需求
+ * 2. 执行过程中动态调整能力等级
+ * 3. 支持优雅降级（Graceful Degradation）
+ * 4. 提供完整的执行追踪和统计
+ */
+export declare class CapabilityPipeline {
+    private config;
+    constructor(config?: Partial<PipelineConfig>);
+    /**
+     * 计算任务的成本和能力需求
+     */
+    calculateCostProfile(files: string[], totalLines: number): CostProfile;
+    /**
+     * 创建 Pipeline 上下文
+     */
+    createContext(taskDescription: string, files: string[], totalLines: number): PipelineContext;
+    /**
+     * 执行 Pipeline
+     */
+    execute(context: PipelineContext): Promise<PipelineResult & {
+        stats: PipelineStats;
+    }>;
+    /**
+     * 计算总体置信度
+     * 使用加权平均策略，而非简单的最小值
+     */
+    private calculateOverallConfidence;
+    /**
+     * 构建统计信息
+     */
+    private buildStats;
+    /**
+     * 描述能力等级
+     */
+    private describeCapability;
+}

package/dist/core/capability/Pipeline.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityPipeline = exports.CapabilityLevel = void 0;
+const CapabilityLevel_1 = require("./CapabilityLevel");
+Object.defineProperty(exports, "CapabilityLevel", { enumerable: true, get: function () { return CapabilityLevel_1.CapabilityLevel; } });
+const CostProfile_1 = require("./CostProfile");
+const DegradationPolicy_1 = require("./DegradationPolicy");
+const Logger_1 = require("./Logger");
+/**
+ * 能力感知的 Pipeline 执行器
+ *
+ * 核心功能：
+ * 1. 根据任务复杂度自动计算能力需求
+ * 2. 执行过程中动态调整能力等级
+ * 3. 支持优雅降级（Graceful Degradation）
+ * 4. 提供完整的执行追踪和统计
+ */
+class CapabilityPipeline {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            stages: [],
+            degradationPolicy: new DegradationPolicy_1.NoOpDegradationPolicy(),
+            costCalculator: new CostProfile_1.CostProfileCalculator(),
+            logger: new Logger_1.ConsoleLogger(),
+            autoDegradation: true,
+            maxExecutionTime: 30000,
+            confidenceThreshold: 0.7,
+            ...config,
+        };
+    }
+    /**
+     * 计算任务的成本和能力需求
+     */
+    calculateCostProfile(files, totalLines) {
+        return this.config.costCalculator.calculate(files, totalLines);
+    }
+    /**
+     * 创建 Pipeline 上下文
+     */
+    createContext(taskDescription, files, totalLines) {
+        const costProfile = this.calculateCostProfile(files, totalLines);
+        return {
+            taskDescription,
+            files,
+            totalLines,
+            metadata: {
+                costProfile,
+            },
+            currentCapability: costProfile.requiredCapability,
+            executionHistory: [],
+        };
+    }
+    /**
+     * 执行 Pipeline
+     */
+    async execute(context) {
+        const startTime = Date.now();
+        const executionHistory = [];
+        let degradationCount = 0;
+        let stagesSucceeded = 0;
+        let totalTokens = 0;
+        // 获取成本信息（安全校验）
+        const costProfile = context.metadata?.costProfile;
+        if (!costProfile) {
+            throw new Error('Cost profile not found in context metadata. Please use createContext() to initialize.');
+        }
+        this.config.logger.info(`\n📊 Pipeline 启动`);
+        this.config.logger.info(`   任务: ${context.taskDescription}`);
+        this.config.logger.info(`   文件: ${context.files.length} 个 (${context.totalLines} 行)`);
+        this.config.logger.info(`   要求能力: ${costProfile.requiredCapability} (${this.describeCapability(costProfile.requiredCapability)})`);
+        this.config.logger.info(`   预计时间: ${costProfile.estimatedTime}ms`);
+        this.config.logger.info(`   预计 Token: ${costProfile.estimatedTokens}\n`);
+        for (const stage of this.config.stages) {
+            const stageStartTime = Date.now();
+            this.config.logger.info(`🔄 执行阶段: ${stage.name}`);
+            // 检查当前能力是否满足阶段最低要求
+            if (!(0, CapabilityLevel_1.canExecute)(context.currentCapability, stage.minCapability.minCapability)) {
+                this.config.logger.warn(`⚠️  当前能力 ${context.currentCapability} 不满足阶段要求 ${stage.minCapability.minCapability}`);
+                this.config.logger.warn(`   尝试降级到 ${stage.minCapability.minCapability}\n`);
+                // 直接降级到阶段要求的最低能力
+                context.currentCapability = stage.minCapability.minCapability;
+            }
+            try {
+                // 执行阶段
+                const result = await stage.execute(context);
+                const timeElapsed = Date.now() - stageStartTime;
+                // 记录执行历史
+                const record = {
+                    stage: stage.name,
+                    actualCapability: context.currentCapability,
+                    startTime: stageStartTime,
+                    endTime: Date.now(),
+                    success: result.success,
+                    confidence: result.confidence,
+                };
+                executionHistory.push(record);
+                // 统计 token 使用（从结果中提取）
+                if (result.data && typeof result.data === 'object' && 'tokensUsed' in result.data) {
+                    totalTokens += result.data.tokensUsed || 0;
+                }
+                if (!result.success) {
+                    this.config.logger.error(`❌ 阶段失败: ${stage.name}`);
+                    this.config.logger.error(`   错误: ${result.error?.message}\n`);
+                    return {
+                        success: false,
+                        error: result.error,
+                        confidence: result.confidence,
+                        finalCapability: context.currentCapability,
+                        stats: this.buildStats(executionHistory, degradationCount, stagesSucceeded, totalTokens, Date.now() - startTime),
+                    };
+                }
+                stagesSucceeded++;
+                // 检查是否需要降级
+                if (this.config.autoDegradation) {
+                    const decisionInput = {
+                        timeElapsed,
+                        confidence: result.confidence,
+                    };
+                    const decision = this.config.degradationPolicy.decide(decisionInput, stage.minCapability);
+                    if (decision.shouldDegrade) {
+                        degradationCount++;
+                        this.config.logger.warn(`⚠️  降级触发: ${decision.reason}`);
+                        this.config.logger.warn(`   ${context.currentCapability} → ${decision.targetLevel}\n`);
+                        // 更新上下文能力等级
+                        context.currentCapability = decision.targetLevel;
+                        record.degradationApplied = true;
+                        record.degradationReason = decision.reason;
+                    }
+                }
+                // 如果有数据，传递给下一个阶段
+                if (result.data !== undefined) {
+                    context.metadata = {
+                        ...context.metadata,
+                        [`${stage.name}_result`]: result.data,
+                    };
+                }
+                this.config.logger.info(`✅ 阶段完成: ${stage.name} (${timeElapsed}ms, 置信度 ${(result.confidence * 100).toFixed(1)}%)\n`);
+            }
+            catch (error) {
+                const timeElapsed = Date.now() - stageStartTime;
+                // 记录失败历史
+                const record = {
+                    stage: stage.name,
+                    actualCapability: context.currentCapability,
+                    startTime: stageStartTime,
+                    endTime: Date.now(),
+                    success: false,
+                    confidence: 0,
+                };
+                executionHistory.push(record);
+                this.config.logger.error(`❌ 阶段异常: ${stage.name}`);
+                this.config.logger.error(`   错误: ${error.message}\n`);
+                return {
+                    success: false,
+                    error: error,
+                    confidence: 0,
+                    finalCapability: context.currentCapability,
+                    stats: this.buildStats(executionHistory, degradationCount, stagesSucceeded, totalTokens, Date.now() - startTime),
+                };
+            }
+        }
+        // 所有阶段执行完成
+        const finalResult = {
+            success: true,
+            data: context.metadata,
+            confidence: this.calculateOverallConfidence(executionHistory),
+            finalCapability: context.currentCapability,
+        };
+        if (degradationCount > 0) {
+            const firstDegradation = executionHistory.find(r => r.degradationApplied);
+            const lastCapability = firstDegradation?.actualCapability || context.currentCapability;
+            finalResult.degradation = {
+                applied: true,
+                originalLevel: lastCapability,
+                targetLevel: context.currentCapability,
+                reason: `${degradationCount} 次降级，最终达到 ${context.currentCapability}`,
+            };
+        }
+        return {
+            ...finalResult,
+            stats: this.buildStats(executionHistory, degradationCount, stagesSucceeded, totalTokens, Date.now() - startTime),
+        };
+    }
+    /**
+     * 计算总体置信度
+     * 使用加权平均策略，而非简单的最小值
+     */
+    calculateOverallConfidence(history) {
+        if (history.length === 0)
+            return 0;
+        // 使用加权平均，最近执行的阶段权重更高
+        let weightedSum = 0;
+        let totalWeight = 0;
+        for (let i = 0; i < history.length; i++) {
+            const weight = i + 1; // 后面的阶段权重更高
+            weightedSum += history[i].confidence * weight;
+            totalWeight += weight;
+        }
+        return weightedSum / totalWeight;
+    }
+    /**
+     * 构建统计信息
+     */
+    buildStats(history, degradationCount, stagesSucceeded, totalTokens, totalTime) {
+        const finalCapability = history.length > 0
+            ? history[history.length - 1].actualCapability
+            : CapabilityLevel_1.CapabilityLevel.NONE;
+        return {
+            totalTime,
+            totalTokens,
+            finalCapability,
+            degradationCount,
+            stagesExecuted: history.length,
+            stagesSucceeded,
+        };
+    }
+    /**
+     * 描述能力等级
+     */
+    describeCapability(level) {
+        const labels = {
+            [CapabilityLevel_1.CapabilityLevel.SEMANTIC]: '语义理解',
+            [CapabilityLevel_1.CapabilityLevel.STRUCTURAL]: '结构分析',
+            [CapabilityLevel_1.CapabilityLevel.LINE]: '行级操作',
+            [CapabilityLevel_1.CapabilityLevel.TEXT]: '文本处理',
+            [CapabilityLevel_1.CapabilityLevel.NONE]: '无智能要求',
+        };
+        return labels[level];
+    }
+}
+exports.CapabilityPipeline = CapabilityPipeline;
+//# sourceMappingURL=Pipeline.js.map

package/dist/core/capability/Pipeline.js.map

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

package/dist/core/capability/PipelineFactory.d.ts

@@ -0,0 +1,40 @@
+import { CapabilityPipeline, PipelineStage } from './Pipeline';
+import { CostProfileOptions } from './CostProfile';
+/**
+ * Pipeline 工厂配置
+ */
+export interface PipelineFactoryOptions {
+    /** 降级策略类型 */
+    degradationType?: 'threshold' | 'noop';
+    /** 成本计算配置 */
+    costProfileOptions?: CostProfileOptions;
+    /** 是否启用自动降级 */
+    autoDegradation?: boolean;
+    /** 最大执行时间 */
+    maxExecutionTime?: number;
+    /** 置信度阈值 */
+    confidenceThreshold?: number;
+}
+/**
+ * Pipeline 工厂
+ *
+ * 提供预定义的 Pipeline 模板，快速创建符合不同场景的 Pipeline
+ */
+export declare class PipelineFactory {
+    /**
+     * 创建代码审查 Pipeline
+     */
+    static createCodeReviewPipeline(options?: PipelineFactoryOptions): CapabilityPipeline;
+    /**
+     * 创建代码生成 Pipeline
+     */
+    static createCodeGenerationPipeline(options?: PipelineFactoryOptions): CapabilityPipeline;
+    /**
+     * 创建 Commit Message 生成 Pipeline
+     */
+    static createCommitMessagePipeline(options?: PipelineFactoryOptions): CapabilityPipeline;
+    /**
+     * 创建自定义 Pipeline
+     */
+    static createCustomPipeline(stages: PipelineStage[], options?: PipelineFactoryOptions): CapabilityPipeline;
+}