autosnippet 3.0.1 → 3.0.2

package/lib/external/ai/AiProvider.js

@@ -3,6 +3,8 @@
  * 所有具体 Provider 必须实现这3个方法
  */
 
+import { LanguageService } from '../../shared/LanguageService.js';
+
 export class AiProvider {
   constructor(config = {}) {
     this.model = config.model || '';
@@ -13,11 +15,11 @@ export class AiProvider {
     this.name = 'abstract';
 
     // ── CircuitBreaker 状态 ──
-    this._circuitState = 'CLOSED';       // 'CLOSED' | 'OPEN' | 'HALF_OPEN'
-    this._circuitFailures = 0;           // 连续失败计数
-    this._circuitThreshold = config.circuitThreshold || 5;  // 触发熔断的连续失败次数
-    this._circuitOpenedAt = 0;           // 熔断打开时间
-    this._circuitCooldownMs = 30_000;    // 初始冷却 30 秒
+    this._circuitState = 'CLOSED'; // 'CLOSED' | 'OPEN' | 'HALF_OPEN'
+    this._circuitFailures = 0; // 连续失败计数
+    this._circuitThreshold = config.circuitThreshold || 5; // 触发熔断的连续失败次数
+    this._circuitOpenedAt = 0; // 熔断打开时间
+    this._circuitCooldownMs = 30_000; // 初始冷却 30 秒
   }
 
   /**
@@ -102,8 +104,11 @@ export class AiProvider {
     // 默认降级: 忽略 tools/toolChoice，走纯文本 chat()
     const messages = opts.messages || [];
     const history = messages
-      .filter(m => m.role === 'user' || m.role === 'assistant')
-      .map(m => ({ role: m.role === 'assistant' ? 'assistant' : 'user', content: m.content || '' }));
+      .filter((m) => m.role === 'user' || m.role === 'assistant')
+      .map((m) => ({
+        role: m.role === 'assistant' ? 'assistant' : 'user',
+        content: m.content || '',
+      }));
     const text = await this.chat(prompt, {
       history,
       systemPrompt: opts.systemPrompt,
@@ -137,7 +142,9 @@ export class AiProvider {
       maxTokens: opts.maxTokens ?? 32768,
       systemPrompt: opts.systemPrompt,
     });
-    if (!response || response.trim().length === 0) return null;
+    if (!response || response.trim().length === 0) {
+      return null;
+    }
     const openChar = opts.openChar || '{';
     const closeChar = opts.closeChar || '}';
     return this.extractJSON(response, openChar, closeChar);
@@ -161,7 +168,10 @@ export class AiProvider {
       maxTokens: 32768,
     });
     if (!Array.isArray(parsed)) {
-      this._log('warn', `[extractRecipes] structured output parse failed for target: ${targetName}`);
+      this._log(
+        'warn',
+        `[extractRecipes] structured output parse failed for target: ${targetName}`
+      );
       return [];
     }
     if (parsed.length === 0) {
@@ -178,16 +188,17 @@ export class AiProvider {
       if (this.logger && typeof this.logger[level] === 'function') {
         this.logger[level](message);
       } else {
-        console[level === 'warn' ? 'warn' : 'log'](message);
       }
-    } catch { /* best effort */ }
+    } catch {
+      /* best effort */
+    }
   }
 
   /**
    * 构建 extractRecipes 标准提示词（语言自适应 + Skill 增强）
    */
   _buildExtractPrompt(targetName, filesContent, options = {}) {
-    const files = filesContent.map(f => `--- FILE: ${f.name} ---\n${f.content}`).join('\n\n');
+    const files = filesContent.map((f) => `--- FILE: ${f.name} ---\n${f.content}`).join('\n\n');
 
     // 检测文件主要语言
     const langProfile = this._detectLanguageProfile(filesContent);
@@ -251,7 +262,7 @@ Each item MUST use the following V3 KnowledgeEntry structure:
 - dontClause (string): What NOT to do (e.g. "Don't instantiate services with new directly")
 - whenClause (string): When this pattern applies (e.g. "When creating a new ViewController subclass")
 - topicHint (string): Group label for related patterns (e.g. "Networking", "UI-Layout", "Error-Handling")
-- coreCode (string): Minimal 3-10 line code skeleton that captures the essence
+- coreCode (string): Minimal 3-10 line code skeleton that captures the essence. Must be syntactically complete — balanced brackets/parentheses, never start with } or ) and never end with { or (
 - constraints (object, optional): { "preconditions": ["<conditions that must be true before using this pattern>"], "sideEffects": ["<observable side effects of using this code>"], "boundaries": ["<usage limitations or scope restrictions>"] }
 - aiInsight (string, optional): One-sentence concise insight — the single most important takeaway about this code pattern
 
@@ -312,7 +323,7 @@ Each item MUST use the following V3 KnowledgeEntry structure:
 - dontClause (string): What NOT to do (e.g. "Don't instantiate services with new directly")
 - whenClause (string): When this pattern applies (e.g. "When creating a new ViewController subclass")
 - topicHint (string): Group label (e.g. "Networking", "UI-Layout")
-- coreCode (string): Minimal 3-10 line code skeleton that captures the essence
+- coreCode (string): Minimal 3-10 line code skeleton that captures the essence. Must be syntactically complete — balanced brackets/parentheses, never start with } or ) and never end with { or (
 - constraints (object, optional): { "preconditions": ["<conditions that must be true before using this pattern>"], "sideEffects": ["<observable side effects of using this code>"], "boundaries": ["<usage limitations or scope restrictions>"] }
 - aiInsight (string, optional): One-sentence concise insight — the single most important takeaway about this code pattern
 
@@ -334,14 +345,17 @@ ${files}`;
       extCounts[ext] = (extCounts[ext] || 0) + 1;
     }
 
+    // 使用 LanguageService 推断主语言
+    const primaryLang = LanguageService.detectPrimary(extCounts);
     const dominant = Object.entries(extCounts).sort((a, b) => b[1] - a[1])[0]?.[0] || '';
 
     // iOS/macOS (Swift / Objective-C)
-    if (['swift', 'm', 'mm', 'h'].includes(dominant)) {
+    if (primaryLang === 'swift' || primaryLang === 'objectivec') {
       return {
-        primaryLanguage: dominant === 'swift' ? 'swift' : 'objectivec',
+        primaryLanguage: primaryLang,
         role: 'Senior iOS/macOS Architect',
-        patternExamples: 'how to set up a ViewController, configure a TableView with delegate/datasource, build a login UI, handle network responses',
+        patternExamples:
+          'how to set up a ViewController, configure a TableView with delegate/datasource, build a login UI, handle network responses',
         extractionExamples: `Examples of good extractions:
 - Complete \`init\` method with all tabBarItem/navigationItem configuration
 - Complete \`viewDidLoad\` with all setup calls
@@ -353,11 +367,12 @@ ${files}`;
     }
 
     // JavaScript / TypeScript
-    if (['js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx'].includes(dominant)) {
+    if (primaryLang === 'javascript' || primaryLang === 'typescript') {
       return {
-        primaryLanguage: ['ts', 'tsx'].includes(dominant) ? 'typescript' : 'javascript',
+        primaryLanguage: primaryLang,
         role: 'Senior Software Engineer',
-        patternExamples: 'Express/Koa middleware, React component patterns, service class with dependency injection, data processing pipeline, error handling wrapper, factory/strategy patterns',
+        patternExamples:
+          'Express/Koa middleware, React component patterns, service class with dependency injection, data processing pipeline, error handling wrapper, factory/strategy patterns',
         extractionExamples: `Examples of good extractions:
 - Complete class with constructor and key methods
 - Express route handler with validation and error handling
@@ -369,11 +384,12 @@ ${files}`;
     }
 
     // Python
-    if (['py'].includes(dominant)) {
+    if (primaryLang === 'python') {
       return {
         primaryLanguage: 'python',
         role: 'Senior Python Engineer',
-        patternExamples: 'Django/Flask views, data processing with pandas, async handlers, decorator patterns, class-based services',
+        patternExamples:
+          'Django/Flask views, data processing with pandas, async handlers, decorator patterns, class-based services',
         extractionExamples: `Examples of good extractions:
 - Complete class with __init__ and key methods
 - Decorator factory function
@@ -385,11 +401,12 @@ ${files}`;
     }
 
     // Go
-    if (['go'].includes(dominant)) {
+    if (primaryLang === 'go') {
       return {
         primaryLanguage: 'go',
         role: 'Senior Go Engineer',
-        patternExamples: 'HTTP handler with middleware, goroutine patterns, interface implementations, struct methods with error handling',
+        patternExamples:
+          'HTTP handler with middleware, goroutine patterns, interface implementations, struct methods with error handling',
         extractionExamples: `Examples of good extractions:
 - Complete struct with constructor and methods
 - HTTP handler function with error propagation
@@ -400,11 +417,12 @@ ${files}`;
     }
 
     // Kotlin / Java
-    if (['kt', 'java'].includes(dominant)) {
+    if (primaryLang === 'kotlin' || primaryLang === 'java') {
       return {
-        primaryLanguage: dominant === 'kt' ? 'kotlin' : 'java',
+        primaryLanguage: primaryLang,
         role: 'Senior Android/Backend Engineer',
-        patternExamples: 'Activity/Fragment lifecycle, repository pattern, ViewModel with LiveData, Retrofit service, dependency injection setup',
+        patternExamples:
+          'Activity/Fragment lifecycle, repository pattern, ViewModel with LiveData, Retrofit service, dependency injection setup',
         extractionExamples: `Examples of good extractions:
 - Complete class with constructor and key methods
 - Repository with CRUD operations
@@ -416,11 +434,12 @@ ${files}`;
     }
 
     // Rust
-    if (['rs'].includes(dominant)) {
+    if (primaryLang === 'rust') {
       return {
         primaryLanguage: 'rust',
         role: 'Senior Rust Engineer',
-        patternExamples: 'trait implementations, error handling with Result, async functions, builder patterns, iterator chains',
+        patternExamples:
+          'trait implementations, error handling with Result, async functions, builder patterns, iterator chains',
         extractionExamples: `Examples of good extractions:
 - Complete impl block with key methods
 - Trait implementation with all required methods
@@ -432,11 +451,12 @@ ${files}`;
     }
 
     // Vue
-    if (['vue'].includes(dominant)) {
+    if (dominant === 'vue') {
       return {
         primaryLanguage: 'vue',
         role: 'Senior Frontend Engineer',
-        patternExamples: 'Vue component with composition API, composable functions, Vuex/Pinia store modules, router guards',
+        patternExamples:
+          'Vue component with composition API, composable functions, Vuex/Pinia store modules, router guards',
         extractionExamples: `Examples of good extractions:
 - Complete Vue component with setup/template
 - Composable function with reactive state
@@ -447,11 +467,12 @@ ${files}`;
     }
 
     // Ruby
-    if (['rb'].includes(dominant)) {
+    if (primaryLang === 'ruby') {
       return {
         primaryLanguage: 'ruby',
         role: 'Senior Ruby Engineer',
-        patternExamples: 'Rails controller actions, model concerns, service objects, background jobs, API serializers',
+        patternExamples:
+          'Rails controller actions, model concerns, service objects, background jobs, API serializers',
         extractionExamples: `Examples of good extractions:
 - Complete controller with CRUD actions
 - Service object with call method
@@ -465,7 +486,8 @@ ${files}`;
     return {
       primaryLanguage: dominant || 'unknown',
       role: 'Senior Software Engineer',
-      patternExamples: 'design patterns, service abstractions, data flow handling, error management, configuration setup',
+      patternExamples:
+        'design patterns, service abstractions, data flow handling, error management, configuration setup',
       extractionExamples: `Examples of good extractions:
 - Complete class/function with full implementation
 - Service method with error handling and retries
@@ -494,17 +516,33 @@ ${files}`;
    * 构建 enrichCandidates 提示词
    */
   _buildEnrichPrompt(candidates) {
-    const items = candidates.map((c, i) => {
-      const existing = [];
-      if (c.rationale) existing.push(`rationale: ${c.rationale}`);
-      if (c.knowledgeType) existing.push(`knowledgeType: ${c.knowledgeType}`);
-      if (c.complexity) existing.push(`complexity: ${c.complexity}`);
-      if (c.scope) existing.push(`scope: ${c.scope}`);
-      if (c.steps?.length) existing.push(`steps: [${c.steps.length} steps already]`);
-      if (c.constraints?.preconditions?.length) existing.push(`preconditions: [${c.constraints.preconditions.length} items]`);
-      const existingStr = existing.length > 0 ? `\nAlready filled: ${existing.join(', ')}` : '\nNo semantic fields filled yet.';
-
-      return `--- CANDIDATE #${i + 1} ---
+    const items = candidates
+      .map((c, i) => {
+        const existing = [];
+        if (c.rationale) {
+          existing.push(`rationale: ${c.rationale}`);
+        }
+        if (c.knowledgeType) {
+          existing.push(`knowledgeType: ${c.knowledgeType}`);
+        }
+        if (c.complexity) {
+          existing.push(`complexity: ${c.complexity}`);
+        }
+        if (c.scope) {
+          existing.push(`scope: ${c.scope}`);
+        }
+        if (c.steps?.length) {
+          existing.push(`steps: [${c.steps.length} steps already]`);
+        }
+        if (c.constraints?.preconditions?.length) {
+          existing.push(`preconditions: [${c.constraints.preconditions.length} items]`);
+        }
+        const existingStr =
+          existing.length > 0
+            ? `\nAlready filled: ${existing.join(', ')}`
+            : '\nNo semantic fields filled yet.';
+
+        return `--- CANDIDATE #${i + 1} ---
 Title: ${c.title || '(untitled)'}
 Language: ${c.language || 'unknown'}
 Category: ${c.category || ''}
@@ -512,7 +550,8 @@ Description: ${c.description || c.summary || ''}
 ${existingStr}
 Code:
 ${(c.code || '').substring(0, 2000)}`;
-    }).join('\n\n');
+      })
+      .join('\n\n');
 
     return `# Role
 You are a Senior Software Architect performing deep semantic analysis on code candidates.
@@ -561,21 +600,28 @@ ${items}`;
   _resolveProxyUrl() {
     // Provider-specific vars: ASD_GOOGLE_PROXY_HTTPS, ASD_OPENAI_PROXY_HTTPS, etc.
     const tag = (this.name || '')
-      .replace(/-gemini$/, '')   // google-gemini → google
-      .replace(/-/g, '_')        // 其他连字符 → 下划线
-      .toUpperCase();            // google → GOOGLE
+      .replace(/-gemini$/, '') // google-gemini → google
+      .replace(/-/g, '_') // 其他连字符 → 下划线
+      .toUpperCase(); // google → GOOGLE
 
     if (tag) {
-      const specific = process.env[`ASD_${tag}_PROXY_HTTPS`]
-        || process.env[`ASD_${tag}_PROXY_HTTP`];
-      if (specific) return specific;
+      const specific =
+        process.env[`ASD_${tag}_PROXY_HTTPS`] || process.env[`ASD_${tag}_PROXY_HTTP`];
+      if (specific) {
+        return specific;
+      }
     }
 
-    return process.env.ASD_AI_PROXY
-      || process.env.HTTPS_PROXY || process.env.https_proxy
-      || process.env.HTTP_PROXY || process.env.http_proxy
-      || process.env.ALL_PROXY || process.env.all_proxy
-      || '';
+    return (
+      process.env.ASD_AI_PROXY ||
+      process.env.HTTPS_PROXY ||
+      process.env.https_proxy ||
+      process.env.HTTP_PROXY ||
+      process.env.http_proxy ||
+      process.env.ALL_PROXY ||
+      process.env.all_proxy ||
+      ''
+    );
   }
 
   /**
@@ -604,11 +650,15 @@ ${items}`;
    * 支持截断修复：当 AI 输出被 token 限制截断时，尝试关闭未完成的 JSON 结构
    */
   extractJSON(text, openChar = '{', closeChar = '}') {
-    if (!text) return null;
+    if (!text) {
+      return null;
+    }
     // 去除 markdown 代码块
     const cleaned = text.replace(/```(?:json)?\s*/gi, '').replace(/```/g, '');
     const start = cleaned.indexOf(openChar);
-    if (start === -1) return null;
+    if (start === -1) {
+      return null;
+    }
     const end = cleaned.lastIndexOf(closeChar);
 
     // 1. 常规路径：找到完整的 JSON 边界
@@ -637,11 +687,15 @@ ${items}`;
   _repairTruncatedArray(text) {
     // ── 策略 1：字符级深度追踪 ──
     const charResult = this._repairByCharTracking(text);
-    if (charResult) return charResult;
+    if (charResult) {
+      return charResult;
+    }
 
     // ── 策略 2：正则回退 — 找所有 "}," 或 "}\n" 位置，从后向前逐一尝试 JSON.parse ──
     const regexResult = this._repairByRegexFallback(text);
-    if (regexResult) return regexResult;
+    if (regexResult) {
+      return regexResult;
+    }
 
     return null;
   }
@@ -652,18 +706,30 @@ ${items}`;
   _repairByCharTracking(text) {
     let depth = 0;
     let inString = false;
-    let escape = false;
+    let isEscaped = false;
     let lastCompleteObjEnd = -1;
 
     for (let i = 0; i < text.length; i++) {
       const ch = text[i];
-      if (escape) { escape = false; continue; }
-      if (ch === '\\' && inString) { escape = true; continue; }
-      if (ch === '"') { inString = !inString; continue; }
-      if (inString) continue;
+      if (isEscaped) {
+        isEscaped = false;
+        continue;
+      }
+      if (ch === '\\' && inString) {
+        isEscaped = true;
+        continue;
+      }
+      if (ch === '"') {
+        inString = !inString;
+        continue;
+      }
+      if (inString) {
+        continue;
+      }
 
-      if (ch === '{' || ch === '[') depth++;
-      else if (ch === '}' || ch === ']') {
+      if (ch === '{' || ch === '[') {
+        depth++;
+      } else if (ch === '}' || ch === ']') {
         depth--;
         // depth === 1 表示回到数组顶层，刚关闭了一个完整对象
         if (depth === 1 && ch === '}') {
@@ -672,7 +738,9 @@ ${items}`;
       }
     }
 
-    if (lastCompleteObjEnd === -1) return null;
+    if (lastCompleteObjEnd === -1) {
+      return null;
+    }
     return this._tryRepairAt(text, lastCompleteObjEnd);
   }
 
@@ -683,7 +751,7 @@ ${items}`;
   _repairByRegexFallback(text) {
     // 收集所有 "}" 后跟 "," 或空白的位置（可能是对象边界）
     const candidates = [];
-    const re = /\}[\s,]*(?=\s*[\[{]|$)/g;
+    const re = /\}[\s,]*(?=\s*[[{]|$)/g;
     let m;
     while ((m = re.exec(text)) !== null) {
       candidates.push(m.index); // "}" 的位置
@@ -692,7 +760,9 @@ ${items}`;
     // 从后往前尝试
     for (let i = candidates.length - 1; i >= 0; i--) {
       const result = this._tryRepairAt(text, candidates[i]);
-      if (result) return result;
+      if (result) {
+        return result;
+      }
     }
     return null;
   }
@@ -711,10 +781,15 @@ ${items}`;
     try {
       const result = JSON.parse(repaired);
       if (Array.isArray(result) && result.length > 0) {
-        this._log('warn', `[extractJSON] Repaired truncated JSON array: recovered ${result.length} items from truncated response`);
+        this._log(
+          'warn',
+          `[extractJSON] Repaired truncated JSON array: recovered ${result.length} items from truncated response`
+        );
         return result;
       }
-    } catch { /* this position didn't work, try next */ }
+    } catch {
+      /* this position didn't work, try next */
+    }
     return null;
   }
 
@@ -733,7 +808,9 @@ ${items}`;
     if (this._circuitState === 'OPEN') {
       const elapsed = Date.now() - (this._circuitOpenedAt || 0);
       if (elapsed < (this._circuitCooldownMs || 30000)) {
-        const err = new Error(`AI 服务熔断中 (连续 ${this._circuitFailures} 次失败)，${Math.ceil(((this._circuitCooldownMs || 30000) - elapsed) / 1000)}s 后恢复`);
+        const err = new Error(
+          `AI 服务熔断中 (连续 ${this._circuitFailures} 次失败)，${Math.ceil(((this._circuitCooldownMs || 30000) - elapsed) / 1000)}s 后恢复`
+        );
         err.code = 'CIRCUIT_OPEN';
         throw err;
       }
@@ -753,27 +830,38 @@ ${items}`;
         // ── 综合判断是否为可重试的网络/服务端错误 ──
         const causeCode = err.cause?.code || '';
         // 网络级错误：无 HTTP status，底层连接失败
-        const isNetworkError = !err.status && (
-          err.message === 'fetch failed'
-          || err.code === 'ECONNRESET' || causeCode === 'ECONNRESET'
-          || err.code === 'ECONNREFUSED' || causeCode === 'ECONNREFUSED'
-          || err.code === 'ENOTFOUND' || causeCode === 'ENOTFOUND'
-          || err.code === 'ECONNABORTED' || causeCode === 'ECONNABORTED'
-          || err.code === 'ETIMEDOUT' || causeCode === 'ETIMEDOUT'
-          || err.code === 'UND_ERR_CONNECT_TIMEOUT' || causeCode === 'UND_ERR_CONNECT_TIMEOUT'
-          || err.code === 'UND_ERR_SOCKET' || causeCode === 'UND_ERR_SOCKET'
-        );
+        const isNetworkError =
+          !err.status &&
+          (err.message === 'fetch failed' ||
+            err.code === 'ECONNRESET' ||
+            causeCode === 'ECONNRESET' ||
+            err.code === 'ECONNREFUSED' ||
+            causeCode === 'ECONNREFUSED' ||
+            err.code === 'ENOTFOUND' ||
+            causeCode === 'ENOTFOUND' ||
+            err.code === 'ECONNABORTED' ||
+            causeCode === 'ECONNABORTED' ||
+            err.code === 'ETIMEDOUT' ||
+            causeCode === 'ETIMEDOUT' ||
+            err.code === 'UND_ERR_CONNECT_TIMEOUT' ||
+            causeCode === 'UND_ERR_CONNECT_TIMEOUT' ||
+            err.code === 'UND_ERR_SOCKET' ||
+            causeCode === 'UND_ERR_SOCKET');
         const isRetryable = err.status === 429 || err.status >= 500 || isNetworkError;
 
         // 首次失败记录详细诊断（含 cause）
         if (attempt === 0 && (isNetworkError || err.cause)) {
-          this._log?.('warn', `[_withRetry] ${err.message} — cause: ${err.cause?.message || causeCode || 'unknown'}`);
+          this._log?.(
+            'warn',
+            `[_withRetry] ${err.message} — cause: ${err.cause?.message || causeCode || 'unknown'}`
+          );
         }
 
         if (attempt >= retries || !isRetryable) {
           // 只有服务端错误 / 网络错误才累计熔断计数
           // 客户端错误 (4xx 非 429) 不应触发熔断 — 那是请求本身的问题
-          const isServerError = isNetworkError || err.status === 429 || err.status >= 500 || !err.status;
+          const isServerError =
+            isNetworkError || err.status === 429 || err.status >= 500 || !err.status;
           if (isServerError) {
             this._circuitFailures = (this._circuitFailures || 0) + 1;
             if (this._circuitFailures >= (this._circuitThreshold || 5)) {
@@ -781,15 +869,21 @@ ${items}`;
               this._circuitOpenedAt = Date.now();
               // 先用当前冷却值，再递增给下次: 30s → 60s → 120s（最大 5 分钟）
               const cooldown = this._circuitCooldownMs || 30_000;
-              this._log?.('warn', `[CircuitBreaker] OPEN — ${this._circuitFailures} consecutive failures, cooldown ${cooldown / 1000}s`);
+              this._log?.(
+                'warn',
+                `[CircuitBreaker] OPEN — ${this._circuitFailures} consecutive failures, cooldown ${cooldown / 1000}s`
+              );
               this._circuitCooldownMs = Math.min(cooldown * 2, 300_000);
             }
           }
           throw err;
         }
-        const delay = baseDelay * Math.pow(2, attempt) + Math.random() * 1000;
-        this._log?.('info', `[_withRetry] attempt ${attempt + 1} failed (${err.message}), retrying in ${Math.round(delay / 1000)}s…`);
-        await new Promise(r => setTimeout(r, delay));
+        const delay = baseDelay * 2 ** attempt + Math.random() * 1000;
+        this._log?.(
+          'info',
+          `[_withRetry] attempt ${attempt + 1} failed (${err.message}), retrying in ${Math.round(delay / 1000)}s…`
+        );
+        await new Promise((r) => setTimeout(r, delay));
       }
     }
   }

package/lib/external/ai/providers/ClaudeProvider.js

@@ -7,8 +7,8 @@
  *     - tool_result content blocks 用于回传工具执行结果
  */
 
-import { AiProvider } from '../AiProvider.js';
 import Logger from '../../../infrastructure/logging/Logger.js';
+import { AiProvider } from '../AiProvider.js';
 
 const CLAUDE_BASE = 'https://api.anthropic.com/v1';
 const ANTHROPIC_VERSION = '2023-06-01';
@@ -47,7 +47,7 @@ export class ClaudeProvider extends AiProvider {
     };
 
     const data = await this._post(`${CLAUDE_BASE}/messages`, body);
-    const textBlock = (data?.content || []).find(c => c.type === 'text');
+    const textBlock = (data?.content || []).find((c) => c.type === 'text');
     return textBlock?.text || '';
   }
 
@@ -77,9 +77,8 @@ export class ClaudeProvider extends AiProvider {
     } = opts;
 
     // 统一消息 → Anthropic Messages 格式
-    const srcMessages = unifiedMessages?.length > 0
-      ? unifiedMessages
-      : [{ role: 'user', content: prompt }];
+    const srcMessages =
+      unifiedMessages?.length > 0 ? unifiedMessages : [{ role: 'user', content: prompt }];
 
     const messages = this.#convertMessages(srcMessages);
 
@@ -98,7 +97,7 @@ export class ClaudeProvider extends AiProvider {
     // 工具声明 + tool_choice
     // toolChoice='none' 时不传 tools（Anthropic 没有 'none' tool_choice）
     if (toolChoice !== 'none' && toolSchemas?.length > 0) {
-      body.tools = toolSchemas.map(s => ({
+      body.tools = toolSchemas.map((s) => ({
         name: s.name,
         description: s.description || '',
         input_schema: s.parameters || { type: 'object', properties: {} },
@@ -159,7 +158,9 @@ export class ClaudeProvider extends AiProvider {
         i++;
       } else if (msg.role === 'assistant') {
         const content = [];
-        if (msg.content) content.push({ type: 'text', text: msg.content });
+        if (msg.content) {
+          content.push({ type: 'text', text: msg.content });
+        }
         if (msg.toolCalls?.length > 0) {
           for (const tc of msg.toolCalls) {
             content.push({
@@ -232,7 +233,9 @@ export class ClaudeProvider extends AiProvider {
     }
 
     if (functionCalls.length > 0) {
-      this.logger.debug(`[Claude] native function calls: ${functionCalls.map(fc => fc.name).join(', ')}`);
+      this.logger.debug(
+        `[Claude] native function calls: ${functionCalls.map((fc) => fc.name).join(', ')}`
+      );
       return {
         text: textParts.length > 0 ? textParts.join('\n') : null,
         functionCalls,
@@ -249,10 +252,12 @@ export class ClaudeProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    return await this.chatWithStructuredOutput(prompt, {
-      temperature: 0.3,
-      maxTokens: 4096,
-    }) || { title: '', description: '' };
+    return (
+      (await this.chatWithStructuredOutput(prompt, {
+        temperature: 0.3,
+        maxTokens: 4096,
+      })) || { title: '', description: '' }
+    );
   }
 
   async embed(_text) {
@@ -265,6 +270,14 @@ export class ClaudeProvider extends AiProvider {
   }
 
   async _post(url, body) {
+    if (!this.apiKey) {
+      const err = new Error(
+        'Claude API Key 未配置。请在 .env 中设置 ASD_CLAUDE_API_KEY，或运行 asd setup 完成配置。'
+      );
+      err.code = 'API_KEY_MISSING';
+      throw err;
+    }
+
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), this.timeout);