autosnippet 3.3.5 → 3.3.7

package/dist/lib/agent/forced-summary.js

@@ -37,7 +37,7 @@ export async function produceForcedSummary({ aiProvider, source, toolCalls = [],
     const candidateCount = toolCalls.filter((tc) => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check').length;
     let finalReply;
     // 如果熔断器已打开，跳过 AI 调用直接合成摘要
-    const isCircuitOpen = aiProvider._circuitState === 'OPEN';
+    const isCircuitOpen = aiProvider._circuitState === 'OPEN' || aiProvider.name === 'mock';
     if (isCircuitOpen) {
         const outputType = isAnalyst ? 'analysis' : isSystem ? 'digest' : 'summary';
         logger.warn(`[ForcedSummary] circuit breaker is OPEN — skipping AI summary, using synthetic ${outputType}`);
@@ -160,7 +160,7 @@ ${toolContextSummary}
                 .slice(0, 8);
             const classesExplored = toolCalls
                 .filter((tc) => tc.tool === 'get_class_info' || tc.tool === 'get_class_hierarchy')
-                .map((tc) => (tc.args || tc.params || {}).className)
+                .map((tc) => (tc.args || tc.params)?.className)
                 .filter((v) => Boolean(v))
                 .slice(0, 10);
             finalReply = `## 代码分析报告\n\n通过 **${toolCalls.length} 次工具调用**（${iterations} 轮迭代）探索了项目代码。\n\n`;
@@ -228,6 +228,11 @@ ${toolContextSummary}
             finalReply += '> ⚠️ AI 服务异常，未能生成完整分析。请稍后重试或缩小分析范围。';
         }
     }
+    // 兜底: 确保 finalReply 始终非空
+    if (!finalReply) {
+        logger.warn('[ForcedSummary] ⚠ finalReply is empty after all paths — using fallback');
+        finalReply = `## 分析总结\n\n通过 **${toolCalls.length} 次工具调用**探索了项目代码，但未能生成完整分析。请重试或缩小分析范围。`;
+    }
     logger.info(`[ForcedSummary] ✅ forced summary — ${finalReply.length} chars`);
     return { reply: finalReply, tokenUsage: resultTokenUsage };
 }

package/dist/lib/agent/memory/ActiveContext.d.ts

@@ -21,6 +21,7 @@
  *
  * @module ActiveContext
  */
+import type { DistilledContext } from './memory-flush-contract.js';
 interface ActiveContextOptions {
     maxRecentRounds?: number;
     lightweight?: boolean;
@@ -189,34 +190,7 @@ export declare class ActiveContext {
      * 蒸馏 ActiveContext 为结构化报告
      * 在 Agent execute 结束时调用，结果写入 SessionStore
      */
-    distill(): {
-        keyFindings: {
-            finding: string;
-            evidence: string;
-            importance: number;
-        }[];
-        toolCallSummary: string[];
-        stats: {
-            totalRounds: number;
-            thoughtCount: number;
-            totalActions: number;
-            totalObservations: number;
-            reflectionCount: number;
-            totalDurationMs: number;
-        };
-        plan: {
-            steps: {
-                description: string;
-                status: string;
-                keywords: string[];
-            }[];
-            text: string;
-            createdAtIteration: number;
-            lastUpdatedAtIteration: number;
-        } | null;
-        totalObservations: number;
-        compressedCount: number;
-    };
+    distill(): DistilledContext;
     /**
      * 获取所有有 Thought 的轮次
      * @returns >}

package/dist/lib/agent/memory/MemoryCoordinator.d.ts

@@ -14,7 +14,7 @@
  * @module MemoryCoordinator
  */
 import { ActiveContext } from './ActiveContext.js';
-import type { SessionStore } from './SessionStore.js';
+import type { DimensionReportInput, SessionStore } from './SessionStore.js';
 /** PersistentMemory 接口 (声明式) */
 interface PersistentMemoryLike {
     toPromptSection(opts: {
@@ -153,7 +153,7 @@ export declare class MemoryCoordinator {
      * 完成维度: 蒸馏 + 存储到 SessionStore
      * @param [report] 附加报告数据
      */
-    completeDimension(scopeId: string, report?: Record<string, unknown>): void;
+    completeDimension(scopeId: string, report?: DimensionReportInput): void;
     /**
      * 完成会话: 触发 Consolidator
      * @returns |null>}

package/dist/lib/agent/memory/SessionStore.d.ts

@@ -22,6 +22,7 @@
  *
  * @module SessionStore
  */
+import type { SessionStoreSerialized } from './session-store-schema.js';
 /** Finding 结构 */
 export interface Finding {
     finding: string;
@@ -59,7 +60,10 @@ export interface WorkingMemoryDistilled {
         tool: string;
         summary: string;
     }>;
-    [key: string]: unknown;
+    stats?: Record<string, number>;
+    plan?: Record<string, unknown> | null;
+    totalObservations?: number;
+    compressedCount?: number;
 }
 /** 维度摘要 */
 export interface DimensionDigest {
@@ -168,17 +172,7 @@ export declare class SessionStore {
     set(toolName: string, args: ToolArgs, result: unknown): void;
     saveCheckpoint(projectRoot: string): Promise<void>;
     loadCheckpoint(projectRoot: string): Promise<boolean>;
-    toJSON(): {
-        dimensionReports: {
-            [k: string]: DimensionReport;
-        };
-        crossReferences: CrossReference[];
-        tierReflections: TierReflection[];
-        submittedCandidates: {
-            [k: string]: CandidateSummary[];
-        };
-        projectContext: Record<string, unknown>;
-    };
+    toJSON(): SessionStoreSerialized;
     static fromJSON(json: Record<string, unknown>): SessionStore;
     /** 获取所有已引用文件 (去重, F10) */
     getAllReferencedFiles(): Set<string>;

package/dist/lib/agent/memory/SessionStore.js

@@ -26,6 +26,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import Logger from '#infra/logging/Logger.js';
 import { CACHE } from '#shared/constants.js';
+import { validateSessionStoreShape } from './session-store-schema.js';
 // ── 类型定义 ──
 /** 副作用工具 — 不缓存结果 (B3 fix) */
 const NON_CACHEABLE = new Set([
@@ -570,24 +571,17 @@ export class SessionStore {
         };
     }
     static fromJSON(json) {
+        const validated = validateSessionStoreShape(json);
         const store = new SessionStore({
-            projectContext: json.projectContext || {},
+            projectContext: validated.projectContext,
         });
-        if (json.dimensionReports) {
-            for (const [k, v] of Object.entries(json.dimensionReports)) {
-                store.#dimensionReports.set(k, v);
-            }
-        }
-        if (json.crossReferences) {
-            store.#crossReferences = json.crossReferences;
+        for (const [k, v] of Object.entries(validated.dimensionReports)) {
+            store.#dimensionReports.set(k, v);
         }
-        if (json.tierReflections) {
-            store.#tierReflections = json.tierReflections;
-        }
-        if (json.submittedCandidates) {
-            for (const [k, v] of Object.entries(json.submittedCandidates)) {
-                store.#submittedCandidates.set(k, v);
-            }
+        store.#crossReferences = validated.crossReferences;
+        store.#tierReflections = validated.tierReflections;
+        for (const [k, v] of Object.entries(validated.submittedCandidates)) {
+            store.#submittedCandidates.set(k, v);
         }
         return store;
     }

package/dist/lib/agent/memory/memory-flush-contract.d.ts

@@ -0,0 +1,49 @@
+/**
+ * §11.3 H3: MemoryFlushContract — 层级数据流转规约
+ *
+ * 定义 completeDimension() 保存数据的显式检查表,
+ * 确保 distill() 的结果在 ActiveContext.clear() 之前完整提取。
+ */
+import type { Finding } from './SessionStore.js';
+/** ActiveContext.distill() 的结构化返回类型 */
+export interface DistilledContext {
+    keyFindings: Array<{
+        finding: string;
+        evidence: string;
+        importance: number;
+    }>;
+    toolCallSummary: string[];
+    stats: {
+        totalRounds: number;
+        thoughtCount: number;
+        totalActions: number;
+        totalObservations: number;
+        reflectionCount: number;
+        totalDurationMs: number;
+    };
+    plan: {
+        text: string;
+        steps: Array<{
+            description: string;
+            status: string;
+            keywords: string[];
+        }>;
+        createdAtIteration: number;
+        lastUpdatedAtIteration: number;
+    } | null;
+    totalObservations: number;
+    compressedCount: number;
+}
+/** completeDimension() 执行数据保存时使用的结构化清单 */
+export interface DimensionFlushManifest {
+    /** distill() 的结果 — 总是存入 SessionStore */
+    distilled: DistilledContext;
+    /** 原始 scratchpad findings — 重要性 >= threshold 的需要转发 */
+    highPriorityFindings: Finding[];
+    /** 工具调用统计 — 用于 SessionStore.toolCallLog */
+    toolCallSummary: string[];
+    /** 是否触发向 PersistentMemory 的异步 consolidation */
+    shouldConsolidate: boolean;
+}
+/** 从 DistilledContext 提取高优先级 findings (importance >= threshold) */
+export declare function extractHighPriorityFindings(distilled: DistilledContext, threshold?: number): Finding[];

package/dist/lib/agent/memory/memory-flush-contract.js

@@ -0,0 +1,16 @@
+/**
+ * §11.3 H3: MemoryFlushContract — 层级数据流转规约
+ *
+ * 定义 completeDimension() 保存数据的显式检查表,
+ * 确保 distill() 的结果在 ActiveContext.clear() 之前完整提取。
+ */
+/** 从 DistilledContext 提取高优先级 findings (importance >= threshold) */
+export function extractHighPriorityFindings(distilled, threshold = 7) {
+    return distilled.keyFindings
+        .filter((f) => f.importance >= threshold)
+        .map((f) => ({
+        finding: f.finding,
+        evidence: f.evidence,
+        importance: f.importance,
+    }));
+}

package/dist/lib/agent/memory/session-store-schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SessionStore 序列化校验
+ *
+ * `SessionStore.fromJSON()` 的反序列化入口，对边界数据做轻量类型校验。
+ *
+ * @module agent/memory/session-store-schema
+ */
+import type { CandidateSummary, CrossReference, DimensionReport, TierReflection, WorkingMemoryDistilled } from './SessionStore.js';
+export interface SessionStoreSerialized {
+    dimensionReports: Record<string, DimensionReport>;
+    crossReferences: CrossReference[];
+    tierReflections: TierReflection[];
+    submittedCandidates: Record<string, CandidateSummary[]>;
+    projectContext: Record<string, unknown>;
+    workingMemory?: WorkingMemoryDistilled;
+}
+/**
+ * 校验反序列化数据的关键字段类型，返回类型安全的结构。
+ */
+export declare function validateSessionStoreShape(raw: Record<string, unknown>): SessionStoreSerialized;

package/dist/lib/agent/memory/session-store-schema.js

@@ -0,0 +1,41 @@
+/**
+ * SessionStore 序列化校验
+ *
+ * `SessionStore.fromJSON()` 的反序列化入口，对边界数据做轻量类型校验。
+ *
+ * @module agent/memory/session-store-schema
+ */
+// ── Helpers ──────────────────────────────────────────────────
+function isRecord(val) {
+    return val !== null && typeof val === 'object' && !Array.isArray(val);
+}
+// ── Public API ───────────────────────────────────────────────
+/**
+ * 校验反序列化数据的关键字段类型，返回类型安全的结构。
+ */
+export function validateSessionStoreShape(raw) {
+    if (raw.dimensionReports !== undefined && !isRecord(raw.dimensionReports)) {
+        throw new Error('SessionStore schema: dimensionReports must be a Record');
+    }
+    if (raw.crossReferences !== undefined && !Array.isArray(raw.crossReferences)) {
+        throw new Error('SessionStore schema: crossReferences must be an array');
+    }
+    if (raw.tierReflections !== undefined && !Array.isArray(raw.tierReflections)) {
+        throw new Error('SessionStore schema: tierReflections must be an array');
+    }
+    if (raw.submittedCandidates !== undefined && !isRecord(raw.submittedCandidates)) {
+        throw new Error('SessionStore schema: submittedCandidates must be a Record');
+    }
+    return {
+        dimensionReports: raw.dimensionReports ?? {},
+        crossReferences: raw.crossReferences ?? [],
+        tierReflections: raw.tierReflections ?? [],
+        submittedCandidates: raw.submittedCandidates ?? {},
+        projectContext: isRecord(raw.projectContext)
+            ? raw.projectContext
+            : {},
+        workingMemory: isRecord(raw.workingMemory)
+            ? raw.workingMemory
+            : undefined,
+    };
+}

package/dist/lib/agent/presets.d.ts

@@ -19,7 +19,7 @@
  *
  * @module presets
  */
-import { insightGateEvaluator } from './domain/insight-gate.js';
+import { evolutionGateEvaluator, insightGateEvaluator } from './domain/insight-gate.js';
 import { producerRejectionGateEvaluator } from './domain/insight-producer.js';
 import { BudgetPolicy, QualityGatePolicy, SafetyPolicy } from './policies.js';
 import { type Strategy } from './strategies.js';
@@ -168,6 +168,50 @@ export declare const PRESETS: Readonly<{
             enabled: boolean;
         };
     };
+    evolution: {
+        name: string;
+        description: string;
+        capabilities: string[];
+        strategy: {
+            type: string;
+            maxRetries: number;
+            stages: ({
+                name: string;
+                capabilities: string[];
+                budget: {
+                    temperature: number;
+                    timeoutMs: number;
+                    maxIterations: number;
+                    searchBudget: number;
+                    searchBudgetGrace: number;
+                    maxSubmits: number;
+                    softSubmitLimit: number;
+                    idleRoundsToExit: number;
+                };
+                systemPrompt: string;
+                promptBuilder: (ctx: Record<string, unknown>) => string;
+                gate?: undefined;
+            } | {
+                name: string;
+                gate: {
+                    evaluator: typeof evolutionGateEvaluator;
+                    maxRetries: number;
+                };
+                capabilities?: undefined;
+                budget?: undefined;
+                systemPrompt?: undefined;
+                promptBuilder?: undefined;
+            })[];
+        };
+        policies: ((config?: PolicyFactoryConfig) => BudgetPolicy)[];
+        persona: {
+            role: string;
+            description: string;
+        };
+        memory: {
+            enabled: boolean;
+        };
+    };
     lark: {
         name: string;
         description: string;
@@ -323,6 +367,50 @@ declare const _default: {
                 enabled: boolean;
             };
         };
+        evolution: {
+            name: string;
+            description: string;
+            capabilities: string[];
+            strategy: {
+                type: string;
+                maxRetries: number;
+                stages: ({
+                    name: string;
+                    capabilities: string[];
+                    budget: {
+                        temperature: number;
+                        timeoutMs: number;
+                        maxIterations: number;
+                        searchBudget: number;
+                        searchBudgetGrace: number;
+                        maxSubmits: number;
+                        softSubmitLimit: number;
+                        idleRoundsToExit: number;
+                    };
+                    systemPrompt: string;
+                    promptBuilder: (ctx: Record<string, unknown>) => string;
+                    gate?: undefined;
+                } | {
+                    name: string;
+                    gate: {
+                        evaluator: typeof evolutionGateEvaluator;
+                        maxRetries: number;
+                    };
+                    capabilities?: undefined;
+                    budget?: undefined;
+                    systemPrompt?: undefined;
+                    promptBuilder?: undefined;
+                })[];
+            };
+            policies: ((config?: PolicyFactoryConfig) => BudgetPolicy)[];
+            persona: {
+                role: string;
+                description: string;
+            };
+            memory: {
+                enabled: boolean;
+            };
+        };
         lark: {
             name: string;
             description: string;

package/dist/lib/agent/presets.js

@@ -21,7 +21,8 @@
  */
 // v3.0: 导入 Insight 领域函数 (domain/ 模块)
 import { ANALYST_BUDGET, ANALYST_SYSTEM_PROMPT, buildAnalystPrompt, } from './domain/insight-analyst.js';
-import { buildRetryPrompt, insightGateEvaluator } from './domain/insight-gate.js';
+import { buildEvolverPrompt, EVOLVER_BUDGET, EVOLVER_SYSTEM_PROMPT, } from './domain/insight-evolver.js';
+import { buildRetryPrompt, evolutionGateEvaluator, insightGateEvaluator, } from './domain/insight-gate.js';
 import { buildProducerPromptV2, PRODUCER_BUDGET, PRODUCER_SYSTEM_PROMPT, producerRejectionGateEvaluator, } from './domain/insight-producer.js';
 import { PipelineStrategy } from './PipelineStrategy.js';
 import { BudgetPolicy, QualityGatePolicy, SafetyPolicy } from './policies.js';
@@ -81,7 +82,7 @@ export const PRESETS = Object.freeze({
                         timeoutMs: 300_000,
                     },
                     systemPrompt: ANALYST_SYSTEM_PROMPT,
-                    promptBuilder: (ctx) => buildAnalystPrompt(ctx.dimConfig, ctx.projectInfo, ctx.dimContext, ctx.sessionStore, ctx.semanticMemory, ctx.codeEntityGraph),
+                    promptBuilder: (ctx) => buildAnalystPrompt(ctx.dimConfig, ctx.projectInfo, ctx.dimContext, ctx.sessionStore, ctx.semanticMemory, ctx.codeEntityGraph, ctx.rescanContext, ctx.panorama, ctx.evidenceStarters, ctx.gateArtifact),
                     retryPromptBuilder: (retryCtx, _origPrompt, prev) => {
                         const prevAnalysis = prev.analyze?.reply || '';
                         const retryHint = buildRetryPrompt(retryCtx.reason ?? '');
@@ -106,7 +107,7 @@ export const PRESETS = Object.freeze({
                     budget: { ...PRODUCER_BUDGET, temperature: 0.3, timeoutMs: 180_000 },
                     systemPrompt: PRODUCER_SYSTEM_PROMPT,
                     promptBuilder: (ctx) => buildProducerPromptV2(ctx.gateArtifact, // 来自 quality_gate 的 AnalysisArtifact
-                    ctx.dimConfig, ctx.projectInfo),
+                    ctx.dimConfig, ctx.projectInfo, ctx.rescanContext, ctx.panorama),
                     // 拒绝率过高时: 缩减预算 + 特定修复 prompt (对齐旧 ProducerAgent 的 rejection retry)
                     retryBudget: { maxIterations: 5, temperature: 0.3, timeoutMs: 120_000 },
                     retryPromptBuilder: (retryCtx, _origPrompt, prev) => {
@@ -129,7 +130,7 @@ export const PRESETS = Object.freeze({
 2. content.markdown 字段 ≥ 200 字符，含代码块 (\`\`\`)
 3. content.rationale 必填 — 设计原理说明（为什么这样设计）
 4. 包含来源标注 (来源: FileName.m:行号)
-5. 标题使用项目真实类名
+5. 标题使用项目真实类名，不以项目名开头
 6. 必填: trigger (@kebab-case)、kind (rule/pattern/fact)、doClause (英文祈使句)`;
                     },
                     skipOnDegrade: true,
@@ -150,7 +151,7 @@ export const PRESETS = Object.freeze({
                 maxIterations: config?.maxIterations ?? 24,
                 maxTokens: config?.maxTokens ?? 4096,
                 temperature: config?.temperature ?? 0.3,
-                timeoutMs: config?.timeoutMs ?? 600_000,
+                timeoutMs: config?.timeoutMs ?? 3_600_000,
             }),
             (config) => new QualityGatePolicy({
                 minEvidenceLength: config?.minEvidenceLength ?? 500,
@@ -166,6 +167,53 @@ export const PRESETS = Object.freeze({
             enabled: false, // 无状态 worker
         },
     },
+    // ─── evolution: 衰退 Recipe 进化决策 ─────────
+    evolution: {
+        name: '进化',
+        description: '审查衰退 Recipe，决定进化（supersede）、废弃或跳过。Evolve→EvolutionGate。',
+        capabilities: ['evolution_analysis'],
+        strategy: {
+            type: 'pipeline',
+            maxRetries: 1,
+            stages: [
+                // ── Phase 1: Evolver ──
+                {
+                    name: 'evolve',
+                    capabilities: ['evolution_analysis'],
+                    budget: {
+                        ...EVOLVER_BUDGET,
+                        temperature: 0.3,
+                        timeoutMs: 180_000,
+                    },
+                    systemPrompt: EVOLVER_SYSTEM_PROMPT,
+                    promptBuilder: (ctx) => buildEvolverPrompt(null, null, ctx),
+                },
+                // ── Phase 2: Evolution Gate ──
+                {
+                    name: 'evolution_gate',
+                    gate: {
+                        evaluator: evolutionGateEvaluator,
+                        maxRetries: 1,
+                    },
+                },
+            ],
+        },
+        policies: [
+            (config) => new BudgetPolicy({
+                maxIterations: config?.maxIterations ?? 16,
+                maxTokens: config?.maxTokens ?? 4096,
+                temperature: config?.temperature ?? 0.3,
+                timeoutMs: config?.timeoutMs ?? 180_000,
+            }),
+        ],
+        persona: {
+            role: 'analyst',
+            description: '知识进化专家',
+        },
+        memory: {
+            enabled: false,
+        },
+    },
     // ─── lark: 飞书知识管理对话 ─────────────
     lark: {
         name: '飞书对话',

package/dist/lib/agent/tools/_shared.d.ts

@@ -5,17 +5,7 @@ export declare const PROJECT_ROOT: string;
 export declare const SKILLS_DIR: string;
 /** 项目级 skills 目录 */
 export declare const PROJECT_SKILLS_DIR: string;
-export declare const DIMENSION_DISPLAY_GROUP: {
-    architecture: string;
-    'code-pattern': string;
-    'project-profile': string;
-    'best-practice': string;
-    'code-standard': string;
-    'event-and-data-flow': string;
-    'objc-deep-scan': string;
-    'category-scan': string;
-    'agent-guidelines': string;
-};
+export { DIMENSION_DISPLAY_GROUP } from '#domain/dimension/DimensionRegistry.js';
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
  * @param dimensionMeta
@@ -25,10 +15,7 @@ export declare const DIMENSION_DISPLAY_GROUP: {
 export declare function checkDimensionType(dimensionMeta: DimensionMeta, params: Record<string, unknown>, logger?: {
     info(msg: string, ...args: unknown[]): void;
     warn(msg: string, ...args: unknown[]): void;
-} | null): {
-    status: string;
-    reason: string;
-} | null;
+} | null): null;
 /** DI container service lookup (returns dynamic service instances) */
 export interface ServiceContainer {
     get(name: string): any;
@@ -67,3 +54,8 @@ export interface ToolSchemaEntry {
     description: string;
     parameters: Record<string, unknown>;
 }
+/**
+ * 剥离标题中冗余的项目名前缀（如 "BiliDili 分页控制器" → "分页控制器"）
+ * 同一知识库内所有条目都属于同一项目，标题中重复项目名没有信息量。
+ */
+export declare function stripProjectNamePrefix(title: string, projectRoot: string): string;

package/dist/lib/agent/tools/_shared.js

@@ -6,18 +6,8 @@ export const PROJECT_ROOT = PACKAGE_ROOT;
 export const SKILLS_DIR = _SKILLS_DIR;
 /** 项目级 skills 目录 */
 export const PROJECT_SKILLS_DIR = path.resolve(PACKAGE_ROOT, '.autosnippet', 'skills');
-// Bootstrap 维度展示分组 — 将 9 个细粒度维度合并为 4 个展示组
-export const DIMENSION_DISPLAY_GROUP = {
-    architecture: 'architecture', // → 架构与设计
-    'code-pattern': 'architecture', // → 架构与设计
-    'project-profile': 'architecture', // → 架构与设计
-    'best-practice': 'best-practice', // → 规范与实践
-    'code-standard': 'best-practice', // → 规范与实践
-    'event-and-data-flow': 'event-and-data-flow', // → 事件与数据流
-    'objc-deep-scan': 'objc-deep-scan', // → 深度扫描
-    'category-scan': 'objc-deep-scan', // → 深度扫描
-    'agent-guidelines': 'agent-guidelines', // skill-only
-};
+// Bootstrap 维度展示分组 — 从 DimensionRegistry 自动生成
+export { DIMENSION_DISPLAY_GROUP } from '#domain/dimension/DimensionRegistry.js';
 /**
  * 基于维度元数据 (dimensionMeta) 检查提交是否合法
  * @param dimensionMeta
@@ -25,15 +15,7 @@ export const DIMENSION_DISPLAY_GROUP = {
  * @returns | null} 不合法返回 rejected，合法返回 null
  */
 export function checkDimensionType(dimensionMeta, params, logger) {
-    // 1. Skill-only 维度不允许提交 Candidate
-    if (dimensionMeta.outputType === 'skill') {
-        logger?.info(`[submit_knowledge] ✗ rejected — dimension "${dimensionMeta.id}" is skill-only, cannot submit candidates`);
-        return {
-            status: 'rejected',
-            reason: `当前维度 "${dimensionMeta.id}" 的输出类型为 skill-only，不允许调用 submit_knowledge。请只在最终回复中提供 dimensionDigest JSON。`,
-        };
-    }
-    // 2. knowledgeType 校验 — 不在允许列表时自动修正为第一个允许类型
+    // 1. knowledgeType 校验 — 不在允许列表时自动修正为第一个允许类型
     const allowed = dimensionMeta.allowedKnowledgeTypes || [];
     if (allowed.length > 0 && params.knowledgeType) {
         if (!allowed.includes(params.knowledgeType)) {
@@ -44,3 +26,20 @@ export function checkDimensionType(dimensionMeta, params, logger) {
     }
     return null;
 }
+/**
+ * 剥离标题中冗余的项目名前缀（如 "BiliDili 分页控制器" → "分页控制器"）
+ * 同一知识库内所有条目都属于同一项目，标题中重复项目名没有信息量。
+ */
+export function stripProjectNamePrefix(title, projectRoot) {
+    if (!title || !projectRoot) {
+        return title;
+    }
+    const projectName = path.basename(projectRoot);
+    if (!projectName || projectName.length < 2) {
+        return title;
+    }
+    // 匹配: "ProjectName 标题" / "ProjectName的标题" / "ProjectName — 标题"
+    const prefix = new RegExp(`^${projectName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*[的—–-]?\\s*`, 'i');
+    const stripped = title.replace(prefix, '');
+    return stripped.length > 0 ? stripped : title;
+}