autosnippet 2.8.3 → 2.10.0

package/lib/service/automation/handlers/AlinkHandler.js

@@ -30,9 +30,11 @@ export async function handleAlink(alinkLine) {
 
       let recipeId = null;
       if (db) {
+        const rawDb = typeof db.getDb === 'function' ? db.getDb() : db;
         try {
-          const row = db.prepare(
-            'SELECT id FROM recipes WHERE trigger = ? LIMIT 1',
+          // V3: knowledge_entries, trigger_key
+          const row = rawDb.prepare(
+            'SELECT id FROM knowledge_entries WHERE trigger_key = ? AND lifecycle = \'active\' LIMIT 1',
           ).get(completionKey);
           if (row) recipeId = row.id;
         } catch {
@@ -43,8 +45,8 @@ export async function handleAlink(alinkLine) {
         if (!recipeId) {
           try {
             const escaped = completionKey.replace(/[%_\\]/g, ch => `\\${ch}`);
-            const row = db.prepare(
-              "SELECT id FROM recipes WHERE trigger LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\' LIMIT 1",
+            const row = rawDb.prepare(
+              "SELECT id FROM knowledge_entries WHERE (trigger_key LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\') AND lifecycle = 'active' LIMIT 1",
             ).get(`%${escaped}%`, `%${escaped}%`);
             if (row) recipeId = row.id;
           } catch { /* silent */ }

package/lib/service/automation/handlers/CreateHandler.js

@@ -95,16 +95,17 @@ async function silentCreateCandidate(watcher, text, relativePath) {
       headers: r.headers || [],
     }));
 
-  // 先尝试批量解析
+  // 先尝试批量解析（仅对 Recipe Markdown 格式有效）
   const allRecipes = parser.parseAll(text);
-  if (allRecipes.length > 0) {
-    const items = normalize(allRecipes);
+  const validRecipes = allRecipes.filter(r => r.title && r.title.trim());
+  if (validRecipes.length > 0) {
+    const items = normalize(validRecipes);
     await watcher._resolveHeadersIfNeeded(items[0], relativePath, text);
     await watcher._appendCandidates(items, 'watch-create');
     const msg =
-      allRecipes.length === 1
-        ? `已创建候选「${allRecipes[0].title}」，请在 Dashboard Candidates 页审核`
-        : `已创建 ${allRecipes.length} 条候选，请在 Dashboard Candidates 页审核`;
+      validRecipes.length === 1
+        ? `已创建候选「${validRecipes[0].title}」，请在 Dashboard Candidates 页审核`
+        : `已创建 ${validRecipes.length} 条候选，请在 Dashboard Candidates 页审核`;
     console.log(`✅ [as:create] ${msg}`);
     watcher._notify(msg);
     return;
@@ -113,7 +114,7 @@ async function silentCreateCandidate(watcher, text, relativePath) {
   // 尝试单条解析
   if (parser.isCompleteRecipe(text)) {
     const one = parser.parse(text);
-    if (one) {
+    if (one && one.title && one.title.trim()) {
       const item = normalize([one])[0];
       await watcher._resolveHeadersIfNeeded(item, relativePath, text);
       await watcher._appendCandidates([item], 'watch-create');
@@ -123,22 +124,56 @@ async function silentCreateCandidate(watcher, text, relativePath) {
     }
   }
 
-  // 最后用 AI 摘要（通过 ChatAgent 统一入口）
+  // -c 模式：剪贴板内容整体作为一条候选（不拆分）
+  // 先用 AI 生成标题和摘要，code 保持剪贴板原文
+  const lang = relativePath && /\.swift$/i.test(relativePath) ? 'swift' : 'objc';
+  const fileName = relativePath
+    ? relativePath.split('/').pop()
+    : `clipboard.${lang === 'swift' ? 'swift' : 'm'}`;
+
+  let title = fileName.replace(/\.\w+$/, '') || 'Clipboard Snippet';
+  let summary = '';
+  let usageGuide = '';
+  let category = 'Utility';
+  let headers = [];
+  let tags = [];
+  let trigger = '';
+
+  // 尝试用 AI 生成摘要信息（但 code 始终保持原文）
   try {
     const { getServiceContainer } = await import('../../../injection/ServiceContainer.js');
     const container = getServiceContainer();
     const chatAgent = container.get('chatAgent');
-    const lang = relativePath && /\.swift$/i.test(relativePath) ? 'swift' : 'objc';
-    const result = await chatAgent.executeTool('summarize_code', { code: text, language: lang });
-    if (result && !result.error && result.title && result.code) {
-      await watcher._appendCandidates([result], 'watch-create');
-      console.log(`✅ [as:create] 已静默创建候选「${result.title}」`);
-      watcher._notify(`已创建候选「${result.title}」，请在 Candidates 页审核`);
-      return;
+    const aiResult = await chatAgent.executeTool('summarize_code', { code: text, language: lang });
+    if (aiResult && !aiResult.error) {
+      title = aiResult.title || title;
+      summary = aiResult.summary || aiResult.summary_cn || '';
+      usageGuide = aiResult.usageGuide || aiResult.usageGuide_cn || '';
+      category = aiResult.category || category;
+      headers = aiResult.headers || [];
+      tags = aiResult.tags || [];
+      trigger = aiResult.trigger || '';
     }
-  } catch { /* ChatAgent 不可用 */ }
-
-  throw new Error('无法从剪贴板内容解析出候选');
+  } catch { /* AI 不可用，使用默认值 */ }
+
+  const item = {
+    title,
+    summary,
+    summary_cn: summary,
+    trigger,
+    category,
+    language: lang,
+    code: text,  // 剪贴板原文整体
+    usageGuide,
+    usageGuide_cn: usageGuide,
+    headers,
+    tags,
+  };
+
+  await watcher._resolveHeadersIfNeeded(item, relativePath, text);
+  await watcher._appendCandidates([item], 'watch-create');
+  console.log(`✅ [as:create -c] 已创建候选「${title}」，请在 Candidates 页审核`);
+  watcher._notify(`已创建候选「${title}」，请在 Candidates 页审核`);
 }
 
 /**

package/lib/service/automation/handlers/GuardHandler.js

@@ -1,42 +1,183 @@
 /**
  * GuardHandler — 处理 // as:a (audit/guard/lint) 指令
+ *
+ * 用法:
+ *   // as:a          — 检查当前文件 (scope=file)
+ *   // as:a file     — 同上，显式 file scope
+ *   // as:a target   — 检查当前文件所在目录树 (scope=target)
+ *   // as:a project  — 检查整个项目所有源文件 (scope=project)
+ *   // as:a <keyword> — 检查当前文件 + 搜索相关规范
  */
 
-import { basename } from 'node:path';
+import { basename, join, extname, dirname } from 'node:path';
+import { readFile } from 'node:fs/promises';
+
+/** 已知的 scope 关键词 */
+const SCOPE_KEYWORDS = new Set(['file', 'target', 'project', 'all']);
+
+/** 支持审计的源文件扩展名 */
+const SOURCE_EXTS = new Set([
+  '.m', '.mm', '.h', '.swift',
+  '.c', '.cpp', '.cc', '.cxx', '.hpp',
+  '.js', '.ts', '.jsx', '.tsx',
+  '.java', '.kt', '.py', '.rb', '.go', '.rs',
+]);
 
 /**
- * @param {string} fullPath
- * @param {string} code
- * @param {string} guardLine
+ * 递归收集目录下所有源文件路径
  */
-export async function handleGuard(fullPath, code, guardLine) {
+async function collectSourceFiles(dir) {
+  const { readdir } = await import('node:fs/promises');
+  const files = [];
+
+  // 跳过的目录
+  const SKIP_DIRS = new Set([
+    'node_modules', '.git', 'build', 'DerivedData',
+    'Pods', '.build', 'vendor', 'dist', '.next',
+    'Carthage', 'xcuserdata', '__pycache__',
+  ]);
+
+  async function walk(currentDir) {
+    let entries;
+    try {
+      entries = await readdir(currentDir, { withFileTypes: true });
+    } catch {
+      return; // 权限不足等情况跳过
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith('.') && entry.name !== '.') continue;
+      const fullPath = join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        if (!SKIP_DIRS.has(entry.name)) {
+          await walk(fullPath);
+        }
+      } else if (entry.isFile() && SOURCE_EXTS.has(extname(entry.name).toLowerCase())) {
+        files.push(fullPath);
+      }
+    }
+  }
+
+  await walk(dir);
+  return files;
+}
+
+/**
+ * @param {import('../FileWatcher').default} watcher  FileWatcher 实例
+ * @param {string} fullPath  当前文件绝对路径
+ * @param {string} code      当前文件内容
+ * @param {string} guardLine 触发行原文
+ */
+export async function handleGuard(watcher, fullPath, code, guardLine) {
   const rest = guardLine.replace(/^\/\/\s*as:(?:audit|a|lint|l|guard|g)\s*/, '').trim();
-  console.log(`\n🛡️  [Guard] 正在检查文件: ${basename(fullPath)}`);
+  const scopeArg = rest.toLowerCase();
+  const isScope = SCOPE_KEYWORDS.has(scopeArg);
+  // 确定 scope：无参数或 'file' → file；'target' → target；'project'/'all' → project
+  const scope = !rest || scopeArg === 'file' ? 'file'
+    : scopeArg === 'target' ? 'target'
+    : (scopeArg === 'project' || scopeArg === 'all') ? 'project'
+    : 'file'; // 非 scope 关键词回退到 file
 
   try {
     const { detectLanguage } = await import('../../guard/GuardCheckEngine.js');
     const { ServiceContainer } = await import('../../../injection/ServiceContainer.js');
     const container = ServiceContainer.getInstance();
     const engine = container.get('guardCheckEngine');
-    const language = detectLanguage(fullPath);
-    const violations = engine.checkCode(code, language);
 
-    if (violations.length === 0) {
-      console.log(`  ✅ 无违规`);
-    } else {
-      const errors = violations.filter((v) => v.severity === 'error');
-      const warnings = violations.filter((v) => v.severity === 'warning');
-      console.log(`  🛡️ ${errors.length} errors, ${warnings.length} warnings`);
-      for (const v of errors) {
-        console.log(`  ❌ L${v.line} [${v.ruleId}] ${v.message}`);
+    /* ── 多文件审计 (target / project) ── */
+    if (scope === 'project' || scope === 'target') {
+      let scanRoot;
+      if (scope === 'project') {
+        scanRoot = watcher?.projectRoot;
+      } else {
+        // target: 扫描当前文件所在目录树
+        scanRoot = dirname(fullPath);
+      }
+
+      if (!scanRoot) {
+        console.warn('  ⚠️ 无法确定扫描根目录，回退到单文件检查');
+        return _auditSingleFile(engine, fullPath, code, detectLanguage, 'file');
+      }
+
+      const scopeLabel = scope === 'project' ? '整个项目' : '当前目录';
+      console.log(`\n🛡️  [Guard] 正在扫描${scopeLabel}: ${scanRoot}`);
+      const sourcePaths = await collectSourceFiles(scanRoot);
+      console.log(`  📁 找到 ${sourcePaths.length} 个源文件`);
+
+      if (sourcePaths.length === 0) {
+        console.log('  ✅ 未找到源文件');
+        return;
+      }
+
+      // 读取所有文件内容
+      const fileEntries = [];
+      let readErrors = 0;
+      for (const p of sourcePaths) {
+        try {
+          const content = await readFile(p, 'utf-8');
+          fileEntries.push({ path: p, content });
+        } catch {
+          readErrors++;
+        }
       }
-      for (const v of warnings.slice(0, 5)) {
-        console.log(`  ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
+      if (readErrors > 0) {
+        console.log(`  ⚠️ ${readErrors} 个文件无法读取，已跳过`);
       }
+
+      // 批量审计（传递 scope 以启用对应维度规则）
+      const report = engine.auditFiles(fileEntries, { scope });
+      const { summary } = report;
+
+      if (summary.totalViolations === 0) {
+        console.log(`  ✅ ${summary.filesChecked} 个文件全部通过，无违规`);
+      } else {
+        console.log(`  🛡️ 扫描 ${summary.filesChecked} 个文件:`);
+        console.log(`     ${summary.totalErrors} errors, ${summary.totalViolations - summary.totalErrors} warnings`);
+        console.log(`     ${summary.filesWithViolations} 个文件存在问题\n`);
+
+        // 按文件输出详情（限制输出前 10 个有问题的文件）
+        const filesWithIssues = report.files.filter(f => f.summary.total > 0);
+        for (const file of filesWithIssues.slice(0, 10)) {
+          const rel = file.filePath.replace(scanRoot + '/', '');
+          console.log(`  📄 ${rel}  (${file.summary.errors}E / ${file.summary.warnings}W)`);
+          const errors = file.violations.filter(v => v.severity === 'error');
+          const warnings = file.violations.filter(v => v.severity === 'warning');
+          for (const v of errors.slice(0, 5)) {
+            console.log(`     ❌ L${v.line} [${v.ruleId}] ${v.message}`);
+          }
+          if (errors.length > 5) console.log(`     ... 还有 ${errors.length - 5} 个 errors`);
+          for (const v of warnings.slice(0, 3)) {
+            console.log(`     ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
+          }
+          if (warnings.length > 3) console.log(`     ... 还有 ${warnings.length - 3} 个 warnings`);
+        }
+        if (filesWithIssues.length > 10) {
+          console.log(`\n  ... 还有 ${filesWithIssues.length - 10} 个文件有问题，已省略`);
+        }
+
+        // 跨文件问题汇总
+        if (report.crossFileViolations?.length > 0) {
+          console.log(`\n  🔗 跨文件问题 (${report.crossFileViolations.length}):`);
+          for (const v of report.crossFileViolations.slice(0, 10)) {
+            console.log(`     ⚠️  [${v.ruleId}] ${v.message}`);
+            if (v.locations) {
+              for (const loc of v.locations.slice(0, 5)) {
+                const relLoc = loc.filePath.replace(scanRoot + '/', '');
+                console.log(`        📄 ${relLoc}:L${loc.line}`);
+              }
+              if (v.locations.length > 5) console.log(`        ... 还有 ${v.locations.length - 5} 处`);
+            }
+          }
+        }
+      }
+      return;
     }
 
-    // 如果有关键词，也做语义搜索
-    if (rest) {
+    /* ── 单文件审计 (file scope) ── */
+    console.log(`\n🛡️  [Guard] 正在检查文件: ${basename(fullPath)}`);
+    _auditSingleFile(engine, fullPath, code, detectLanguage, scope);
+
+    // 如果有非 scope 关键词，也做语义搜索
+    if (rest && !isScope) {
       try {
         const searchEngine = container.get('searchEngine');
         const results = await searchEngine.search(rest, { limit: 3, mode: 'keyword' });
@@ -54,3 +195,25 @@ export async function handleGuard(fullPath, code, guardLine) {
     console.warn(`  ⚠️ Guard 检查失败: ${err.message}`);
   }
 }
+
+/**
+ * 检查单个文件并打印结果
+ */
+function _auditSingleFile(engine, fullPath, code, detectLanguage, scope = 'file') {
+  const language = detectLanguage(fullPath);
+  const violations = engine.checkCode(code, language, { scope });
+
+  if (violations.length === 0) {
+    console.log(`  ✅ 无违规`);
+  } else {
+    const errors = violations.filter((v) => v.severity === 'error');
+    const warnings = violations.filter((v) => v.severity === 'warning');
+    console.log(`  🛡️ ${errors.length} errors, ${warnings.length} warnings`);
+    for (const v of errors) {
+      console.log(`  ❌ L${v.line} [${v.ruleId}] ${v.message}`);
+    }
+    for (const v of warnings.slice(0, 5)) {
+      console.log(`  ⚠️  L${v.line} [${v.ruleId}] ${v.message}`);
+    }
+  }
+}

package/lib/service/automation/handlers/SearchHandler.js

@@ -26,22 +26,35 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
     const container = ServiceContainer.getInstance();
     const searchEngine = container.get('searchEngine');
 
+    // 诊断：输出索引状态
+    const stats = searchEngine.getStats();
+    if (stats.totalDocuments === 0) {
+      console.log(`  ⚠️  知识库为空（索引 0 条记录），请先通过 asd setup / Dashboard 添加知识条目`);
+    } else {
+      console.log(`  📊 索引 ${stats.totalDocuments} 条知识`);
+    }
+
+    // BM25 → keyword 逐级降级：空结果也触发降级（中文分词不足时 BM25 可能零命中）
     try {
       results = await searchEngine.search(query, { limit: 10, mode: 'bm25' });
+      if (!results || (results.items || []).length === 0) {
+        results = await searchEngine.search(query, { limit: 10, mode: 'keyword' });
+      }
     } catch {
       results = await searchEngine.search(query, { limit: 10, mode: 'keyword' });
     }
   } catch (err) {
     console.warn(`  ⚠️ 搜索失败: ${err.message}`);
-    watcher._openDashboard(`/?action=search&q=${encodeURIComponent(query)}`);
+    console.log(`  ℹ️  未找到「${query}」的相关结果`);
+    watcher._notify(`搜索「${query}」失败: ${err.message}`);
     return;
   }
 
   const items = normalizeSearchResults(results);
 
   if (items.length === 0) {
-    console.log(`  ℹ️  未找到相关结果`);
-    watcher._openDashboard(`/?action=search&q=${encodeURIComponent(query)}&path=${encodeURIComponent(relativePath)}`);
+    console.log(`  ℹ️  未找到「${query}」的相关结果`);
+    watcher._notify(`未找到「${query}」的相关结果`);
     return;
   }
 
@@ -103,35 +116,40 @@ export function normalizeSearchResults(results) {
         }
       } catch { /* ignore */ }
     }
-    // headers 优先从 dimensions_json 取（V2 标准存储位置）
-    if (headers.length === 0 && r.dimensions_json) {
+    // V3: headers 是独立 JSON 列（字符串），优先解析
+    if (headers.length === 0 && r.headers) {
       try {
-        const dims = typeof r.dimensions_json === 'string' ? JSON.parse(r.dimensions_json) : r.dimensions_json;
-        if (Array.isArray(dims.headers) && dims.headers.length > 0) {
-          headers = dims.headers;
+        const parsed = typeof r.headers === 'string' ? JSON.parse(r.headers) : r.headers;
+        if (Array.isArray(parsed) && parsed.length > 0) {
+          headers = parsed;
         }
       } catch { /* ignore */ }
     }
-    // 兜底：顶层 r.headers
-    if (headers.length === 0 && Array.isArray(r.headers) && r.headers.length > 0) {
-      headers = r.headers;
-    }
-    // moduleName: 从 dimensions_json 或 content_json 或顶层提取
-    let moduleName = null;
-    if (r.dimensions_json) {
+    // V2 兜底：从 dimensions_json 取
+    if (headers.length === 0 && r.dimensions_json) {
       try {
         const dims = typeof r.dimensions_json === 'string' ? JSON.parse(r.dimensions_json) : r.dimensions_json;
-        moduleName = dims.moduleName || dims.module_name || null;
+        if (Array.isArray(dims.headers) && dims.headers.length > 0) {
+          headers = dims.headers;
+        }
       } catch { /* ignore */ }
     }
+    // moduleName: V3 独立列 > content_json > dimensions_json > 顶层
+    let moduleName = r.module_name || null;
     if (!moduleName && r.content_json) {
       try {
         const content = typeof r.content_json === 'string' ? JSON.parse(r.content_json) : r.content_json;
         moduleName = content.moduleName || content.module_name || null;
       } catch { /* ignore */ }
     }
+    if (!moduleName && r.dimensions_json) {
+      try {
+        const dims = typeof r.dimensions_json === 'string' ? JSON.parse(r.dimensions_json) : r.dimensions_json;
+        moduleName = dims.moduleName || dims.module_name || null;
+      } catch { /* ignore */ }
+    }
     if (!moduleName) {
-      moduleName = r.moduleName || r.module_name || null;
+      moduleName = r.moduleName || null;
     }
 
     return {

package/lib/service/chat/AnalystAgent.js

@@ -19,20 +19,31 @@ import Logger from '../../infrastructure/logging/Logger.js';
 // System Prompt — Analyst 专用 (~100 tokens)
 // ──────────────────────────────────────────────────────────────────
 
-const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度分析一个真实项目。
+const ANALYST_SYSTEM_PROMPT = `你是一位高级软件架构师，正在深度分析一个真实项目的某个维度。
 
-## 工具使用优先级
-1. **结构化查询优先** — get_project_overview → get_class_hierarchy → get_class_info
-   这些工具返回精确的类继承、协议实现、方法签名信息，比文本搜索更高效。
-2. **文本搜索补充** — search_project_code 用于查找特定模式/关键字
-3. **文件阅读验证** — read_project_file 用于确认具体实现细节
+## 执行计划
+你有 **N 轮**工具调用机会（系统会告知具体数字）。请严格按以下节奏分配：
 
-> ⚠️ 避免反复调用 search_project_code 搜索不同关键词。
-> 如果需要了解类结构，直接用 get_class_info 查询。
+| 阶段 | 轮次占比 | 目标 |
+|------|---------|------|
+| 1. 全局扫描 | 第 1-3 轮 | get_project_overview + list_project_structure 了解项目结构 |
+| 2. 结构化探索 | 第 4-N×60% 轮 | get_class_hierarchy / get_class_info 理解核心类；search_project_code 批量搜索关键模式 |
+| 3. 深度验证 | 第 N×60%-N×80% 轮 | read_project_file 阅读关键实现，确认细节 |
+| 4. 输出总结 | 最后 20% | **停止调用工具**，直接输出你的分析文本 |
 
+## 关键规则
+- **到达 80% 轮次时必须开始写总结**，不要等系统提醒
+- 每一轮都必须调用工具获取新信息，不要花轮次在纯文本思考上
+- 不要重复搜索相同关键词或读取相同文件（系统会返回缓存并扣轮次）
+
+## 工具效率
+- **批量搜索**: search_project_code({ patterns: ["keywordA", "keywordB", "keywordC"] }) — 一次搜 3-5 个
+- **批量读文件**: read_project_file({ filePaths: ["a.m", "b.m", "c.m"] }) — 一次读 3-5 个
+- **结构化查询优先**: get_class_hierarchy / get_class_info 比文本搜索更精确高效
+
+## 输出要求
 输出你的分析发现，包括具体的文件路径和代码位置。
-不需要任何特定格式，用自然语言描述你的理解即可。
-尽可能多地使用工具来获取准确信息，不要猜测。`;
+用自然语言描述你的理解，不需要特定格式。`;
 
 // ──────────────────────────────────────────────────────────────────
 // Analyst 可用工具白名单 — 只做探索，不做提交
@@ -61,12 +72,12 @@ const ANALYST_TOOLS = [
 // ──────────────────────────────────────────────────────────────────
 
 const ANALYST_BUDGET = {
-  maxIterations: 12,      // was 20 — 多数维度 5-9 轮完成
-  searchBudget: 10,       // was 15 — 探索为主，精简预算
-  searchBudgetGrace: 6,   // was 10
+  maxIterations: 24,      // was 18 — 大项目维度需要充足探索轮次
+  searchBudget: 18,       // was 14 — 匹配更大探索空间
+  searchBudgetGrace: 10,  // was 8
   maxSubmits: 0,          // Analyst 不提交候选
   softSubmitLimit: 0,
-  idleRoundsToExit: 2,    // was 3 — 减少空转
+  idleRoundsToExit: 2,    // 减少空转
 };
 
 // ──────────────────────────────────────────────────────────────────

package/lib/service/chat/CandidateGuardrail.js

@@ -27,7 +27,7 @@ export class CandidateGuardrail {
 
   /**
    * 验证候选结构
-   * @param {object} candidate — submit_candidate 工具参数
+   * @param {object} candidate — submit_knowledge 工具参数
    * @returns {{ valid: boolean, error?: string }}
    */
   validateStructure(candidate) {