autosnippet 2.18.0 → 2.19.0

package/dashboard/dist/index.html

@@ -5,12 +5,12 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-9byoG7kd.js"></script>
+    <script type="module" crossorigin src="/assets/index-D8dCXLzr.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/syntax-highlighter-BkDyUteW.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-Ba1BZjav.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">
-    <link rel="modulepreload" crossorigin href="/assets/icons-C6kshpB1.js">
+    <link rel="modulepreload" crossorigin href="/assets/icons-C7FN32VL.js">
     <link rel="modulepreload" crossorigin href="/assets/react-markdown-Dc1U8Kko.js">
     <link rel="stylesheet" crossorigin href="/assets/index-BDmJqEkA.css">
   </head>

package/lib/external/ai/AiProvider.js

@@ -113,6 +113,36 @@ export class AiProvider {
     return { text, functionCalls: null };
   }
 
+  /**
+   * Structured Output — 请求 AI 返回严格 JSON 格式响应
+   *
+   * 子类覆盖以利用原生 JSON mode:
+   *   - Gemini: responseMimeType: 'application/json' + responseSchema
+   *   - OpenAI: response_format: { type: 'json_object' }
+   *   - Claude: 无原生支持，使用默认实现 (chat + extractJSON)
+   *
+   * @param {string} prompt — 完整提示词（应包含返回 JSON 的指令）
+   * @param {object} [opts]
+   * @param {object} [opts.schema] — JSON Schema（Gemini/OpenAI 的 structured output 用）
+   * @param {string} [opts.openChar='{'] — extractJSON 边界起始符（fallback 用）
+   * @param {string} [opts.closeChar='}'] — extractJSON 边界终止符
+   * @param {number} [opts.temperature=0.3]
+   * @param {number} [opts.maxTokens=32768]
+   * @param {string} [opts.systemPrompt] — 可选系统指令
+   * @returns {Promise<any>} — 解析后的 JSON 对象/数组，解析失败返回 null
+   */
+  async chatWithStructuredOutput(prompt, opts = {}) {
+    const response = await this.chat(prompt, {
+      temperature: opts.temperature ?? 0.3,
+      maxTokens: opts.maxTokens ?? 32768,
+      systemPrompt: opts.systemPrompt,
+    });
+    if (!response || response.trim().length === 0) return null;
+    const openChar = opts.openChar || '{';
+    const closeChar = opts.closeChar || '}';
+    return this.extractJSON(response, openChar, closeChar);
+  }
+
   /**
    * 从源码文件批量提取 Recipe 结构（AI 驱动）
    * 默认实现使用 chat() + 标准提示词；子类可覆盖以使用专用 API
@@ -124,16 +154,14 @@ export class AiProvider {
    */
   async extractRecipes(targetName, filesContent, options = {}) {
     const prompt = this._buildExtractPrompt(targetName, filesContent, options);
-    const response = await this.chat(prompt, { temperature: 0.3, maxTokens: 32768 });
-    if (!response || response.trim().length === 0) {
-      this._log('warn', `[extractRecipes] AI returned empty response for target: ${targetName}`);
-      return [];
-    }
-    const parsed = this.extractJSON(response, '[', ']');
+    const parsed = await this.chatWithStructuredOutput(prompt, {
+      openChar: '[',
+      closeChar: ']',
+      temperature: 0.3,
+      maxTokens: 32768,
+    });
     if (!Array.isArray(parsed)) {
-      // JSON 解析失败 — 记录原始响应尾部用于调试（截断诊断更有用）
-      const tail = response.length > 300 ? response.substring(response.length - 300) : response;
-      this._log('warn', `[extractRecipes] JSON parse failed for target: ${targetName}, response length: ${response.length}, tail: ${tail}`);
+      this._log('warn', `[extractRecipes] structured output parse failed for target: ${targetName}`);
       return [];
     }
     if (parsed.length === 0) {
@@ -454,8 +482,11 @@ ${files}`;
    */
   async enrichCandidates(candidates) {
     const prompt = this._buildEnrichPrompt(candidates);
-    const response = await this.chat(prompt, { temperature: 0.3 });
-    const parsed = this.extractJSON(response, '[', ']');
+    const parsed = await this.chatWithStructuredOutput(prompt, {
+      openChar: '[',
+      closeChar: ']',
+      temperature: 0.3,
+    });
     return Array.isArray(parsed) ? parsed : [];
   }
 

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

@@ -249,8 +249,10 @@ export class ClaudeProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    const text = await this.chat(prompt, { temperature: 0.3 });
-    return this.extractJSON(text) || { title: '', description: text };
+    return await this.chatWithStructuredOutput(prompt, {
+      temperature: 0.3,
+      maxTokens: 4096,
+    }) || { title: '', description: '' };
   }
 
   async embed(_text) {

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

@@ -216,7 +216,8 @@ export class GoogleGeminiProvider extends AiProvider {
   }
 
   /**
-   * 清理 JSON Schema 使之兼容 Gemini API 的 OpenAPI 子集
+   * 清理 JSON Schema 使之兼容 Gemini API 的 OpenAPI 子集（递归）
+   * Gemini API 不支持 default、examples 等 JSON Schema 扩展字段
    */
   #sanitizeSchemaForGemini(schema) {
     if (!schema || typeof schema !== 'object') {
@@ -224,20 +225,24 @@ export class GoogleGeminiProvider extends AiProvider {
     }
 
     const cleaned = { ...schema };
+    delete cleaned.default;
+    delete cleaned.examples;
     if (!cleaned.type) cleaned.type = 'object';
 
+    // 递归清理 properties
     if (cleaned.properties) {
       const props = {};
       for (const [key, val] of Object.entries(cleaned.properties)) {
-        const prop = { ...val };
-        delete prop.default;
-        delete prop.examples;
-        if (!prop.type) prop.type = 'string';
-        props[key] = prop;
+        props[key] = this.#sanitizeSchemaForGemini(val);
       }
       cleaned.properties = props;
     }
 
+    // 递归清理 items (array 类型)
+    if (cleaned.items && typeof cleaned.items === 'object') {
+      cleaned.items = this.#sanitizeSchemaForGemini(cleaned.items);
+    }
+
     return cleaned;
   }
 
@@ -297,8 +302,61 @@ export class GoogleGeminiProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    const text = await this.chat(prompt, { temperature: 0.3 });
-    return this.extractJSON(text) || { title: '', description: text };
+    return await this.chatWithStructuredOutput(prompt, {
+      temperature: 0.3,
+      maxTokens: 8192,
+    }) || { title: '', description: '' };
+  }
+
+  /**
+   * Structured Output — Gemini 原生 JSON mode
+   *
+   * 使用 responseMimeType: 'application/json' 强制 Gemini 返回合法 JSON。
+   * 可选传入 responseSchema 做编译期校验（Gemini 1.5+ / Gemini 2+）。
+   */
+  async chatWithStructuredOutput(prompt, opts = {}) {
+    return this._withRetry(async () => {
+      const {
+        schema,
+        temperature = 0.3,
+        maxTokens = 32768,
+        systemPrompt,
+      } = opts;
+
+      const contents = [{ role: 'user', parts: [{ text: prompt }] }];
+
+      const generationConfig = {
+        temperature,
+        maxOutputTokens: maxTokens,
+        responseMimeType: 'application/json',
+      };
+
+      // 如果提供了 JSON Schema，注入 responseSchema（Gemini 编译期校验）
+      if (schema) {
+        generationConfig.responseSchema = this.#sanitizeSchemaForGemini(schema);
+      }
+
+      const body = { contents, generationConfig };
+
+      if (systemPrompt) {
+        body.systemInstruction = { parts: [{ text: systemPrompt }] };
+      }
+
+      const url = `${GEMINI_BASE}/models/${this.model}:generateContent?key=${this.apiKey}`;
+      const data = await this._post(url, body);
+      const text = data?.candidates?.[0]?.content?.parts?.[0]?.text || '';
+
+      if (!text) return null;
+
+      try {
+        return JSON.parse(text);
+      } catch {
+        // Gemini JSON mode 偶尔返回前后有空白的 JSON，尝试 extractJSON 降级
+        const openChar = opts.openChar || '{';
+        const closeChar = opts.closeChar || '}';
+        return this.extractJSON(text, openChar, closeChar);
+      }
+    });
   }
 
   async embed(text) {

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

@@ -184,8 +184,54 @@ export class OpenAiProvider extends AiProvider {
 
   async summarize(code) {
     const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
-    const text = await this.chat(prompt, { temperature: 0.3 });
-    return this.extractJSON(text) || { title: '', description: text };
+    return await this.chatWithStructuredOutput(prompt, {
+      temperature: 0.3,
+      maxTokens: 4096,
+    }) || { title: '', description: '' };
+  }
+
+  /**
+   * Structured Output — OpenAI JSON mode
+   *
+   * 使用 response_format: { type: 'json_object' } 强制返回合法 JSON。
+   * 兼容 DeepSeek / Ollama 等 OpenAI-Compatible API。
+   */
+  async chatWithStructuredOutput(prompt, opts = {}) {
+    return this._withRetry(async () => {
+      const {
+        temperature = 0.3,
+        maxTokens = 32768,
+        systemPrompt,
+      } = opts;
+
+      const messages = [];
+      if (systemPrompt) {
+        messages.push({ role: 'system', content: systemPrompt });
+      }
+      messages.push({ role: 'user', content: prompt });
+
+      const body = {
+        model: this.model,
+        messages,
+        temperature,
+        max_tokens: maxTokens,
+        response_format: { type: 'json_object' },
+      };
+
+      const data = await this._post(`${this.baseUrl}/chat/completions`, body);
+      const text = data?.choices?.[0]?.message?.content || '';
+
+      if (!text) return null;
+
+      try {
+        return JSON.parse(text);
+      } catch {
+        // JSON mode 极少出错，降级到 extractJSON
+        const openChar = opts.openChar || '{';
+        const closeChar = opts.closeChar || '}';
+        return this.extractJSON(text, openChar, closeChar);
+      }
+    });
   }
 
   async embed(text) {

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

@@ -693,8 +693,7 @@ ${args.userPrompt ? `用户补充: ${args.userPrompt}` : ''}
   "insight": "架构洞察（一句话）"
 }`;
 
-      const response = await aiProvider.chat(prompt, { temperature: 0.3 });
-      const parsed = aiProvider.extractJSON(response, '{', '}');
+      const parsed = await aiProvider.chatWithStructuredOutput(prompt, { temperature: 0.3 });
 
       if (!parsed) {
         errors.push({ id: entry.id, title: entry.title, error: 'AI returned no valid JSON' });

package/lib/http/HttpServer.js

@@ -25,6 +25,7 @@ import spmRouter from './routes/spm.js';
 import violationsRouter from './routes/violations.js';
 import authRouter from './routes/auth.js';
 import skillsRouter from './routes/skills.js';
+import candidatesRouter from './routes/candidates.js';
 import knowledgeRouter from './routes/knowledge.js';
 import recipesRouter from './routes/recipes.js';
 import wikiRouter from './routes/wiki.js';
@@ -257,6 +258,9 @@ export class HttpServer {
     // Skills 路由
     this.app.use(`${apiPrefix}/skills`, skillsRouter);
 
+    // Candidates 路由（AI 补齐/润色）
+    this.app.use(`${apiPrefix}/candidates`, candidatesRouter);
+
     // SPM 路由
     this.app.use(`${apiPrefix}/spm`, spmRouter);