/** * Unit Context Assembler — 功能单元智能上下文组装引擎 * * 核心设计:三层上下文模型 + Token 预算控制 * 1. 核心层(40%): 当前功能单元完整需求 * 2. 关联层(40%): 上下游单元摘要 + 相关源码 Top5 * 3. 全局层(20%): 术语表 + 接口契约 + 数据模型 * * 目标:给 AI 提供"全面且不漂移"的上下文 * * v8.2.0+ */ export interface UnitRef { id: string; name: string; content: string; } export interface UnitContextOptions { /** 总 Token 预算,默认 6000 */ maxTokens?: number; /** 核心层占比,默认 0.4 */ coreRatio?: number; /** 关联层占比,默认 0.4 */ relatedRatio?: number; /** 全局层占比,默认 0.2 */ globalRatio?: number; /** 最多几个上下游单元,默认 3 */ maxRelatedUnits?: number; /** 最多几个源码文件,默认 5 */ maxCodeFiles?: number; /** 每个源码文件取多少字符,默认 800 */ codeCharsPerFile?: number; /** 是否使用知识图谱增强关联 */ useKnowledgeGraph?: boolean; } export interface UnitContextResult { context: string; stats: { coreChars: number; relatedUnitChars: number; codeChars: number; globalChars: number; totalChars: number; estimatedTokens: number; relatedUnits: string[]; codeFiles: string[]; }; } export declare function assembleUnitContext(iterDir: string, iteration: string, unit: UnitRef, allUnits: UnitRef[], options?: UnitContextOptions): Promise; /** * v7.4.2+: 按功能单元从各分析文档中精准提取相关上下文 * CLI 做计算(提取),AI 做内容(填充) */ export declare function extractOverviewContext(iterationDir: string, unitName: string, platforms: string[]): Promise; //# sourceMappingURL=unit-context-assembler.d.ts.map