autosnippet 3.1.5 → 3.1.7

package/lib/external/mcp/handlers/bootstrap/shared/skill-generator.js

@@ -20,24 +20,79 @@ const logger = Logger.getInstance();
 /** Skill 分析文本最低字符数 */
 const MIN_ANALYSIS_LENGTH = 100;
 
-/** 重复率阈值（低于此值视为重复内容） */
-const MAX_DUPLICATE_RATIO = 0.3;
+/** 重复率硬拒绝阈值（全局唯一率低于此值 → 尝试去重挽救） */
+const HARD_REJECT_RATIO = 0.10;
+
+/** 连续重复块阈值（连续相同行 ≥ 此值 → AI 循环信号） */
+const CONSECUTIVE_DUPE_THRESHOLD = 8;
 
 /** 短文本结构化豁免阈值（低于此字符数的文本必须有结构化内容） */
 const STRUCTURE_CHECK_THRESHOLD = 500;
 
 // ── 质量门控 ────────────────────────────────────────────────
 
+/**
+ * 规范化行文本 — 用于去重比较
+ * 去除列表标记、编号、代码围栏、引用标记等结构性前缀，
+ * 避免 category-scan 等维度中大量结构相似但内容不同的行被误判为重复。
+ */
+function normalizeLine(line) {
+  return line
+    .trim()
+    .replace(/^[-*•]\s+/, '')       // strip list markers
+    .replace(/^\d+\.\s+/, '')       // strip numbered list
+    .replace(/^[`>]+\s*/, '')       // strip code/quote markers
+    .replace(/^#{1,3}\s+/, '')      // strip Markdown headings
+    .replace(/\(来源[:：].*?\)/g, '') // strip source annotations
+    .replace(/\s+/g, ' ')          // collapse whitespace
+    .trim();
+}
+
+/**
+ * 检测最长连续重复块长度 — AI 循环的核心特征
+ */
+function maxConsecutiveDuplicates(lines) {
+  let max = 0;
+  let current = 0;
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i] === lines[i - 1] && lines[i].length > 0) {
+      current++;
+      if (current > max) max = current;
+    } else {
+      current = 0;
+    }
+  }
+  return max;
+}
+
+/**
+ * 去除连续重复行 — 将连续 N 行相同内容压缩为 1 行
+ */
+function deduplicateConsecutive(text) {
+  const lines = text.split('\n');
+  const result = [lines[0]];
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() !== lines[i - 1].trim() || lines[i].trim().length === 0) {
+      result.push(lines[i]);
+    }
+  }
+  return result.join('\n');
+}
+
 /**
  * 验证分析文本是否满足 Skill 生成的质量门控
  *
  * 门控规则:
  *   1. 文本长度 ≥ 100 字符
- *   2. 重复行比率 < 0.3（防止 AI 循环输出）
+ *   2. 重复检测 (两层):
+ *      a. 连续重复块 ≥ 8 行 → AI 循环信号 → 去重后挽救
+ *      b. 规范化后全局唯一率 < 0.10 → 极端重复 → 去重后挽救
  *   3. 短文本（<500 字符）必须包含结构化内容（标题/列表/代码块）
  *
+ * 挽救机制: 当检测到重复时，先去除连续重复行，如果去重后文本 ≥ 100 字符则放行。
+ *
  * @param {string} analysisText — Analyst 或外部 Agent 的分析文本
- * @returns {{ pass: boolean, reason: string|null }}
+ * @returns {{ pass: boolean, reason: string|null, deduplicatedText?: string }}
  */
 function validateSkillQuality(analysisText) {
   // 1. 文本过短
@@ -48,14 +103,32 @@ function validateSkillQuality(analysisText) {
     };
   }
 
-  // 2. 重复行检测（AI 陷入循环输出工具提示等）
+  // 2. 重复检测 — 规范化后比较，避免结构性前缀导致误判
   const textLines = analysisText.split('\n').filter((l) => l.trim().length > 0);
-  const uniqueLines = new Set(textLines.map((l) => l.trim()));
-  const uniqueRatio = textLines.length > 0 ? uniqueLines.size / textLines.length : 1;
-  if (textLines.length > 20 && uniqueRatio < MAX_DUPLICATE_RATIO) {
+  const normalizedLines = textLines.map(normalizeLine).filter((l) => l.length > 0);
+  const uniqueNormalized = new Set(normalizedLines);
+  const uniqueRatio = normalizedLines.length > 0 ? uniqueNormalized.size / normalizedLines.length : 1;
+
+  // 连续重复块检测（AI 循环的核心特征）
+  const maxConsDupes = maxConsecutiveDuplicates(normalizedLines);
+
+  const isRepetitive = (normalizedLines.length > 30 && uniqueRatio < HARD_REJECT_RATIO)
+    || maxConsDupes >= CONSECUTIVE_DUPE_THRESHOLD;
+
+  if (isRepetitive) {
+    // ── 挽救: 去除连续重复后重新评估 ──
+    const cleaned = deduplicateConsecutive(analysisText);
+    if (cleaned.trim().length >= MIN_ANALYSIS_LENGTH) {
+      logger.info(
+        `[SkillGenerator] Repetition detected (${uniqueNormalized.size}/${normalizedLines.length} unique, ` +
+        `ratio ${uniqueRatio.toFixed(2)}, maxConsec ${maxConsDupes}), salvaged via dedup ` +
+        `(${analysisText.length} → ${cleaned.length} chars)`
+      );
+      return { pass: true, reason: null, deduplicatedText: cleaned };
+    }
     return {
       pass: false,
-      reason: `repetitive content detected (${uniqueLines.size}/${textLines.length} unique, ratio ${uniqueRatio.toFixed(2)})`,
+      reason: `repetitive content detected (${uniqueNormalized.size}/${normalizedLines.length} unique, ratio ${uniqueRatio.toFixed(2)}, maxConsec ${maxConsDupes}) — dedup salvage also too short (${cleaned.trim().length} chars)`,
     };
   }
 
@@ -156,8 +229,11 @@ export async function generateSkill(ctx, dim, analysisText, referencedFiles = []
     return { success: false, skillName, error: validation.reason };
   }
 
+  // 1.5. 如果触发了去重挽救，使用清理后的文本
+  const effectiveText = validation.deduplicatedText || analysisText;
+
   // 2. 内容构建
-  const skillContent = buildSkillContent(dim, analysisText, referencedFiles, keyFindings, source);
+  const skillContent = buildSkillContent(dim, effectiveText, referencedFiles, keyFindings, source);
 
   // 3. 创建 Skill
   try {

package/lib/external/mcp/handlers/system.js

@@ -106,6 +106,22 @@ export async function health(ctx) {
   const allCritical = checks.database; // DB 是唯一硬性依赖
   const status = allCritical ? 'ok' : 'degraded';
 
+  // 如果 DB 不可用但冷启动仍可执行，附加提示避免 Agent 浪费时间修复 DB
+  const actionHints = [];
+  if (!checks.database) {
+    actionHints.push(
+      'DB 不可用不影响冷启动：autosnippet_bootstrap 不依赖数据库（纯文件系统分析），可直接调用。DB 会在首次 submit_knowledge 时自动重试初始化。'
+    );
+  }
+  if (!knowledgeBase || knowledgeBase.recipes.total === 0) {
+    actionHints.push(
+      '知识库为空，建议执行冷启动：(1) 调用 autosnippet_bootstrap 获取 Mission Briefing → (2) 按维度分析代码并提交知识 → (3) 调用 autosnippet_dimension_complete 完成每个维度。'
+    );
+    actionHints.push(
+      '💡 冷启动前建议先加载 Skill 获取详细指引：autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })'
+    );
+  }
+
   return envelope({
     success: true,
     data: {
@@ -118,6 +134,7 @@ export async function health(ctx) {
       services: ctx.container.getServiceNames(),
       knowledgeBase,
       ...(issues.length ? { issues } : {}),
+      ...(actionHints.length ? { actionHints } : {}),
     },
     meta: { tool: 'autosnippet_health' },
   });
@@ -224,8 +241,10 @@ export function capabilities() {
         {
           name: '冷启动（外部 Agent）',
           steps: [
-            'bootstrap（获取 Mission Briefing）',
-            'Agent 分析代码 + submit_knowledge × N',
+            '⚠️ 先加载 Skill 获取详细指引: autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })',
+            'bootstrap（获取 Mission Briefing，无参数直接调用）',
+            '按 Briefing 中的 submissionSchema.example 格式提交知识（注意: content 和 reasoning 都是 JSON 对象）',
+            'Agent 分析代码 + submit_knowledge / submit_knowledge_batch × N',
             'dimension_complete × N',
             'wiki_plan → Agent 写文章 → wiki_finalize（可选）',
           ],

package/lib/external/mcp/tools.js

@@ -230,7 +230,9 @@ export const TOOLS = [
     description:
       '提交单条知识到知识库（V3 统一实体）。严格前置校验，缺少必要字段将被直接拒绝（不入库）。\n' +
       '所有必填字段必须在单次调用中一次性提供，不要分步提交。\n' +
-      '必填: title, language, content(pattern或markdown + rationale), kind, doClause, dontClause, whenClause, coreCode, category, trigger, description, headers, usageGuide, knowledgeType, reasoning',
+      '⚠️ content 必须是对象: { "pattern": "代码片段", "markdown": "## 标题\\n正文...", "rationale": "设计原理" }（pattern/markdown 至少一个 + rationale 必填）\n' +
+      '⚠️ reasoning 必须是对象: { "whyStandard": "原因", "sources": ["file.ts"], "confidence": 0.85 }\n' +
+      '必填: title, language, content, kind, doClause, dontClause, whenClause, coreCode, category, trigger, description, headers, usageGuide, knowledgeType, reasoning',
     inputSchema: {
       type: 'object',
       properties: {
@@ -239,15 +241,18 @@ export const TOOLS = [
         language: { type: 'string', description: '编程语言（小写）' },
         content: {
           type: 'object',
-          description: '内容值对象（必须有 pattern 或 markdown + rationale）',
+          description:
+            '内容值对象（JSON 对象，不是字符串！）。必须包含: pattern(代码片段) 或 markdown(Markdown正文) 至少一个 + rationale(设计原理) 必填。' +
+            '示例: { "pattern": "func example() { ... }", "markdown": "## 标题\\n正文≥200字...", "rationale": "为什么这样设计" }',
           properties: {
-            pattern: { type: 'string' },
-            markdown: { type: 'string' },
+            pattern: { type: 'string', description: '核心代码片段（与 markdown 至少提供一个）' },
+            markdown: { type: 'string', description: 'Markdown 正文（≥200字符，与 pattern 至少提供一个）' },
             rationale: { type: 'string', description: '设计原理说明（必填）' },
             steps: { type: 'array', items: { type: 'object' } },
             codeChanges: { type: 'array', items: { type: 'object' } },
             verification: { type: 'object' },
           },
+          required: ['rationale'],
         },
         kind: {
           type: 'string',
@@ -289,14 +294,16 @@ export const TOOLS = [
         relations: { type: 'object', description: '关系' },
         reasoning: {
           type: 'object',
-          description: '推理依据（必填）{whyStandard, sources[], confidence}',
+          description:
+            '推理依据（JSON 对象，必填）。示例: { "whyStandard": "28/30 files follow this pattern", "sources": ["src/UserService.ts"], "confidence": 0.85 }',
           properties: {
-            whyStandard: { type: 'string' },
-            sources: { type: 'array', items: { type: 'string' } },
-            confidence: { type: 'number' },
+            whyStandard: { type: 'string', description: '为什么这是标准做法（必填）' },
+            sources: { type: 'array', items: { type: 'string' }, description: '参考的文件路径数组（必填，至少 1 个）' },
+            confidence: { type: 'number', description: '置信度 0.0-1.0（推荐 0.7-0.9）' },
             qualitySignals: { type: 'object' },
             alternatives: { type: 'array', items: { type: 'string' } },
           },
+          required: ['whyStandard', 'sources', 'confidence'],
         },
         headerPaths: { type: 'array', items: { type: 'string' } },
         moduleName: { type: 'string' },
@@ -330,7 +337,11 @@ export const TOOLS = [
   {
     name: 'autosnippet_submit_knowledge_batch',
     tier: 'agent',
-    description: '批量提交知识条目（V3 统一实体）。每条须含 kind/doClause/dontClause/whenClause/coreCode。支持去重。',
+    description:
+      '批量提交知识条目（V3 统一实体）。每条字段要求同 submit_knowledge。支持去重。\n' +
+      '⚠️ items 数组中每条的 content 和 reasoning 都必须是 JSON 对象（不是字符串）。\n' +
+      'content 格式: { "pattern": "代码...", "markdown": "正文...", "rationale": "原理..." }\n' +
+      'reasoning 格式: { "whyStandard": "原因", "sources": ["file.ts"], "confidence": 0.85 }',
     inputSchema: {
       type: 'object',
       properties: {
@@ -408,7 +419,9 @@ export const TOOLS = [
     name: 'autosnippet_bootstrap',
     tier: 'agent',
     description:
-      '冷启动 Mission Briefing — 自动分析项目结构、AST、依赖图和 Guard 审计，返回完整的执行计划和维度任务清单。无需任何参数，直接调用即可。',
+      '冷启动 Mission Briefing — 自动分析项目结构、AST、依赖图和 Guard 审计，返回完整的执行计划和维度任务清单。无需任何参数，直接调用即可。不依赖数据库，DB 不可用时也能正常工作。\n' +
+      '💡 建议先加载 Skill 获取详细冷启动指引: autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })\n' +
+      '返回的 submissionSchema.example 包含完整的提交 JSON 示例，请严格按其格式提交知识。',
     inputSchema: {
       type: 'object',
       properties: {},

package/lib/platform/ios/xcode/XcodeIntegration.js

@@ -101,7 +101,7 @@ const _SYSTEM_FRAMEWORKS = new Set([
  *   3. Xcode osascript 自动插入，失败则文件写入回退
  *   4. 附加 AutoSnippet 注释后缀
  *
- * @param {import('./FileWatcher.js').FileWatcher} watcher
+ * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
  * @param {string}   fullPath  目标文件绝对路径
  * @param {string[]} headers   待插入的 import 行数组
  * @param {object}   [opts]
@@ -296,7 +296,7 @@ export async function insertHeaders(watcher, fullPath, headers, opts = {}) {
  *   7. Jump 到粘贴行 → 选中行内容 → Cmd+V 粘贴替换
  *   8. 任一步失败 → 降级到纯文件写入
  *
- * @param {import('./FileWatcher.js').FileWatcher} watcher
+ * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
  */
 export async function insertCodeToXcode(watcher, fullPath, selected, triggerLine) {
   const XA = await import('./XcodeAutomation.js');

package/lib/service/candidate/CandidateAggregator.js

@@ -0,0 +1,52 @@
+/**
+ * CandidateAggregator — 候选条目去重聚合
+ *
+ * 对候选列表按 title 进行模糊去重，保留最优条目。
+ * 被 knowledge handler 的 submitKnowledgeBatch 使用。
+ *
+ * @module service/candidate/CandidateAggregator
+ */
+
+import { jaccardSimilarity, tokenizeForSimilarity } from '../../shared/similarity.js';
+
+/** title 相似度阈值，超过此值视为重复 */
+const TITLE_SIMILARITY_THRESHOLD = 0.85;
+
+/**
+ * 对候选条目列表进行去重聚合
+ *
+ * @param {Array<{title: string, code?: string, [key: string]: any}>} items
+ * @param {object} [opts]
+ * @param {number} [opts.threshold] 自定义相似度阈值 (0-1)
+ * @returns {{ items: Array, duplicates: Array<{item: any, duplicateOf: string}> }}
+ */
+export function aggregateCandidates(items, opts = {}) {
+  if (!Array.isArray(items) || items.length === 0) {
+    return { items: [], duplicates: [] };
+  }
+
+  const threshold = opts.threshold ?? TITLE_SIMILARITY_THRESHOLD;
+  const kept = [];
+  const duplicates = [];
+
+  for (const item of items) {
+    const titleTokens = tokenizeForSimilarity(item.title || '');
+    let isDuplicate = false;
+
+    for (const existing of kept) {
+      const existingTokens = tokenizeForSimilarity(existing.title || '');
+      const sim = jaccardSimilarity(titleTokens, existingTokens);
+      if (sim >= threshold) {
+        duplicates.push({ item, duplicateOf: existing.title });
+        isDuplicate = true;
+        break;
+      }
+    }
+
+    if (!isDuplicate) {
+      kept.push(item);
+    }
+  }
+
+  return { items: kept, duplicates };
+}

package/lib/service/chat/tools/ai-analysis.js

@@ -60,7 +60,7 @@ export const extractRecipes = {
     // 加载语言参考 Skill（如有），注入到 AI 提取 prompt
     let skillReference = null;
     try {
-      const { loadBootstrapSkills } = await import('../../external/mcp/handlers/bootstrap-internal.js');
+      const { loadBootstrapSkills } = await import('../../../external/mcp/handlers/bootstrap-internal.js');
       const langProfile = ctx.aiProvider._detectLanguageProfile?.(files);
       const primaryLang = langProfile?.primaryLanguage;
       if (primaryLang) {
@@ -240,7 +240,7 @@ export const enrichCandidate = {
       return { error: 'AI provider not available' };
     }
     // V3: 使用 MCP handler enrichCandidates 的逻辑
-    const { enrichCandidates: enrichFn } = await import('../../external/mcp/handlers/candidate.js');
+    const { enrichCandidates: enrichFn } = await import('../../../external/mcp/handlers/candidate.js');
     const result = await enrichFn(ctx, { candidateIds: params.candidateIds });
     return result?.data || result;
   },
@@ -273,7 +273,7 @@ export const refineBootstrapCandidates = {
       return { error: 'AI provider not available' };
     }
     // V3: 委托给 bootstrap handler 的 refine 逻辑
-    const { bootstrapRefine } = await import('../../external/mcp/handlers/bootstrap-internal.js');
+    const { bootstrapRefine } = await import('../../../external/mcp/handlers/bootstrap-internal.js');
     const result = await bootstrapRefine(ctx, {
       candidateIds: params.candidateIds,
       userPrompt: params.userPrompt,

package/lib/service/chat/tools/ast-graph.js

@@ -20,7 +20,7 @@
 /**
  * 辅助: 安全获取 ProjectGraph 实例
  * @param {object} ctx
- * @returns {import('../../core/ast/ProjectGraph.js').default|null}
+ * @returns {import('../../../core/ast/ProjectGraph.js').default|null}
  */
 function _getProjectGraph(ctx) {
   try {
@@ -558,7 +558,7 @@ export const queryCodeGraph = {
   },
   handler: async (params, ctx) => {
     try {
-      const { CodeEntityGraph } = await import('./../../service/knowledge/CodeEntityGraph.js');
+      const { CodeEntityGraph } = await import('../../knowledge/CodeEntityGraph.js');
       const db = ctx?.container?.get('database');
       if (!db) {
         return '代码实体图谱不可用: 数据库未初始化';

package/lib/shared/RecipeReadinessChecker.js

@@ -46,15 +46,21 @@ export function checkRecipeReadiness(item) {
   }
 
   // content 有效性（pattern/markdown/rationale 至少有实质内容）
-  const hasCode = !!(item.code || item.content?.pattern || item.content?.markdown);
-  if (!hasCode) {
+  // 先检查 content 是否为对象（Agent 常犯错误：传字符串而非对象）
+  if (item.content && typeof item.content !== 'object') {
     missing.push('content');
-    suggestions.push('content 需包含 pattern 或 markdown（代码片段或正文）');
+    suggestions.push('⚠️ content 必须是 JSON 对象（不是字符串！）。正确格式: { "pattern": "代码片段", "markdown": "## 标题\\n正文...", "rationale": "设计原理" }');
+  } else {
+    const hasCode = !!(item.code || item.content?.pattern || item.content?.markdown);
+    if (!hasCode) {
+      missing.push('content');
+      suggestions.push('content 必须是 JSON 对象且包含 pattern 或 markdown 至少一个。格式: { "pattern": "代码片段...", "rationale": "设计原理..." }');
+    }
   }
 
   if (!item.content?.rationale && !item.rationale) {
     missing.push('rationale');
-    suggestions.push('content.rationale 必须提供设计原理说明');
+    suggestions.push('content.rationale 必须提供设计原理说明（在 content 对象中: { ..., "rationale": "为什么这样设计" }）');
   }
 
   if (!item.language) {
@@ -130,13 +136,15 @@ export function checkRecipeReadiness(item) {
   // reasoning 检查
   if (!item.reasoning || typeof item.reasoning !== 'object') {
     missing.push('reasoning');
-    suggestions.push('reasoning 必须包含 whyStandard + sources + confidence');
+    suggestions.push('⚠️ reasoning 必须是 JSON 对象（不是字符串！）。正确格式: { "whyStandard": "为什么是标准做法", "sources": ["file1.ts", "file2.ts"], "confidence": 0.85 }');
   } else {
     if (!item.reasoning.whyStandard?.trim()) {
       missing.push('reasoning.whyStandard');
+      suggestions.push('reasoning.whyStandard 必须说明为什么这是标准做法');
     }
     if (!Array.isArray(item.reasoning.sources) || item.reasoning.sources.length === 0) {
       missing.push('reasoning.sources');
+      suggestions.push('reasoning.sources 必须是文件路径数组且至少包含 1 个来源');
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "lib/bootstrap.js",

package/scripts/migrate-md-to-knowledge.mjs

@@ -27,8 +27,11 @@ const noBackup = args.includes('--no-backup');
 const projectRoot = args.find((a) => !a.startsWith('--')) || process.cwd();
 
 // ── 动态导入（兼容 ESM） ──
-const { parseRecipeMarkdown } = await import('../lib/service/recipe/RecipeFileWriter.js');
-const { parseCandidateMarkdown } = await import('../lib/service/candidate/CandidateFileWriter.js');
+// NOTE: 旧的 RecipeFileWriter / CandidateFileWriter 已统一为 KnowledgeFileWriter
+// parseKnowledgeMarkdown 兼容解析旧格式
+const { parseKnowledgeMarkdown } = await import('../lib/service/knowledge/KnowledgeFileWriter.js');
+const parseRecipeMarkdown = parseKnowledgeMarkdown;
+const parseCandidateMarkdown = parseKnowledgeMarkdown;
 const { KnowledgeEntry } = await import('../lib/domain/knowledge/KnowledgeEntry.js');
 const { KnowledgeFileWriter } = await import('../lib/service/knowledge/KnowledgeFileWriter.js');
 const { Lifecycle } = await import('../lib/domain/knowledge/Lifecycle.js');

package/skills/autosnippet-analysis/SKILL.md

@@ -26,7 +26,7 @@ description: Deep project analysis — full scan + semantic field enrichment + g
 ### Workflow
 
 #### Phase 1: Collect & Baseline
-1. 调用 `autosnippet_bootstrap(operation=scan)` 获取文件列表 + Guard 审计基线
+1. 调用 `autosnippet_bootstrap`（无参数）获取 Mission Briefing（文件列表 + Guard 审计基线）
 2. 审视 Guard 违规 — 静态规则问题 (命名/API 使用/废弃 API)
 3. 确定高优先级文件 (核心模块/共享工具/Service 层)
 
@@ -116,11 +116,11 @@ Use `autosnippet_submit_knowledge_batch` for batch submission.
 **方式 B: 对已有候选调用 AI 补全**
 > 注：`autosnippet_enrich_candidates` 已移入 admin 层级，Agent 推荐使用方式 A 直接填写完整字段。
 
-**方式 C: Bootstrap 候选 AI 润色**
+**方式 C: 候选字段诊断**
 ```
-autosnippet_bootstrap(operation=refine, candidateIds: ["id1", "id2", ...])
+autosnippet_enrich_candidates({ candidateIds: ["id1", "id2", ...] })
 ```
-使用 AI 对 Bootstrap 候选做内容润色（改善 summary、补充 insight、推断 relations、调整 confidence）。
+诊断候选缺失字段（不使用 AI），Agent 根据诊断结果自行补全。
 
 ---
 
@@ -133,7 +133,7 @@ autosnippet_bootstrap(operation=refine, candidateIds: ["id1", "id2", ...])
 ### Workflow
 
 1. 对目标候选做结构补齐（确保所有字段完整）
-2. 调用 `autosnippet_bootstrap(operation=refine)` 对候选做 AI 润色（summary/insight/relations）
+2. 调用 `autosnippet_enrich_candidates` 诊断候选缺失字段，根据结果自行补全
 3. 提交时使用 `autosnippet_submit_knowledge`（内置自动校验 + 去重检查）
 4. 报告补全情况 + 缺失字段 + 重复风险
 5. 如缺失字段 AI 无法填充，提示用户手动补充