autosnippet 3.0.0 → 3.0.1

package/lib/service/chat/ChatAgent.js

@@ -939,7 +939,7 @@ export class ChatAgent {
     // ── 循环退出: 产出 dimensionDigest 总结 ──
     reasoning.afterRound();
     const forcedResult = await this.#produceForcedSummary({
-      source, toolCalls, toolSchemas, ctx, phaseRouter, execStartTime,
+      source, toolCalls, toolSchemas, ctx, phaseRouter, execStartTime, prompt,
     });
     forcedResult.reasoningTrace = reasoning.trace;
     forcedResult.reasoningQuality = reasoning.getQualityMetrics();
@@ -950,9 +950,10 @@ export class ChatAgent {
    * 强制退出后的摘要生成 — 独立方法，避免主循环代码膨胀
    * @private
    */
-  async #produceForcedSummary({ source, toolCalls, toolSchemas, ctx, phaseRouter, execStartTime }) {
+  async #produceForcedSummary({ source, toolCalls, toolSchemas, ctx, phaseRouter, execStartTime, prompt }) {
     const iterations = phaseRouter?.totalIterations || 0;
-    this.#logger.info(`[ChatAgent] ⚠ producing forced summary (${iterations} iters, ${toolCalls.length} calls)`);
+    const isSystem = source === 'system';
+    this.#logger.info(`[ChatAgent] ⚠ producing forced summary (${iterations} iters, ${toolCalls.length} calls, source=${source})`);
 
     const candidateCount = toolCalls.filter(tc =>
       tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check'
@@ -960,22 +961,30 @@ export class ChatAgent {
 
     let finalReply;
 
-    // 如果熔断器已打开，跳过 AI 调用直接合成 digest（避免无用的失败 + 计数累积）
+    // 如果熔断器已打开，跳过 AI 调用直接合成摘要（避免无用的失败 + 计数累积）
     const isCircuitOpen = this.#aiProvider._circuitState === 'OPEN';
     if (isCircuitOpen) {
-      this.#logger.warn(`[ChatAgent] circuit breaker is OPEN — skipping AI summary, using synthetic digest`);
+      this.#logger.warn(`[ChatAgent] circuit breaker is OPEN — skipping AI summary, using synthetic ${isSystem ? 'digest' : 'summary'}`);
     }
 
+    // ── 收集工具调用摘要（user / system 共用） ──
+    const submitSummary = toolCalls
+      .filter(tc => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check')
+      .map((tc, i) => `${i + 1}. ${tc.params?.title || tc.params?.category || 'untitled'}`)
+      .join('\n');
+
+    // ── 收集工具调用上下文（user 源需要更丰富的上下文来生成自然语言总结） ──
+    const toolContextSummary = isSystem ? '' : this.#buildToolContextForUserSummary(toolCalls);
+
     try {
-      if (isCircuitOpen) throw new Error('circuit open — skip to synthetic digest');
+      if (isCircuitOpen) throw new Error('circuit open — skip to synthetic summary');
 
-      const submitSummary = toolCalls
-        .filter(tc => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check')
-        .map((tc, i) => `${i + 1}. ${tc.params?.title || tc.params?.category || 'untitled'}`)
-        .join('\n');
+      let summaryPrompt;
+      let systemPrompt;
 
-      const summaryPrompt = source === 'system'
-        ? `你已完成 ${iterations} 轮工具调用（共 ${toolCalls.length} 次），提交了 ${candidateCount} 个候选。
+      if (isSystem) {
+        // ── system 源: 输出 dimensionDigest JSON（供 Bootstrap 管线消费） ──
+        summaryPrompt = `你已完成 ${iterations} 轮工具调用（共 ${toolCalls.length} 次），提交了 ${candidateCount} 个候选。
 ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
 **必须**输出 dimensionDigest JSON（用 \`\`\`json 包裹）：
 \`\`\`json
@@ -992,8 +1001,25 @@ ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
   }
 }
 \`\`\`
-> remainingTasks: 列出本次未来得及处理的信号/主题。已全部覆盖则留空 \`[]\`。`
-        : `Completed ${iterations} iterations with ${toolCalls.length} tool calls. Please summarize.`;
+> remainingTasks: 列出本次未来得及处理的信号/主题。已全部覆盖则留空 \`[]\`。`;
+        systemPrompt = '直接输出 dimensionDigest JSON 总结，不要调用工具。';
+      } else {
+        // ── user 源: 输出人类可读的 Markdown 结构化总结（前端 AI Chat 展示） ──
+        const userQuestion = prompt ? `用户的原始问题：「${prompt.slice(0, 500)}」\n\n` : '';
+        summaryPrompt = `${userQuestion}你刚才通过 ${toolCalls.length} 次工具调用分析了项目代码。以下是你调用过的工具和获取到的关键信息：
+
+${toolContextSummary}
+
+请基于以上收集到的信息，用**清晰易读的 Markdown** 格式撰写分析总结，直接回答用户的问题。
+
+要求：
+- 使用二级/三级标题组织内容
+- 要有具体的代码文件路径、类名、模式名称等细节
+- 关键发现用列表项罗列
+- 如果发现了架构模式或最佳实践，用简短代码块举例
+- 语言自然流畅，像一份技术分析报告`;
+        systemPrompt = '你是项目分析助手。请用纯 Markdown 格式输出结构清晰的分析总结，只输出人类可读的自然语言文档，不要输出 JSON 格式的数据。';
+      }
 
       // 用空 messages 避免累积上下文导致 400
       const summaryResult = await this.#aiProvider.chatWithTools(
@@ -1002,8 +1028,8 @@ ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
           messages: [],
           toolSchemas,
           toolChoice: 'none',
-          systemPrompt: '直接输出 dimensionDigest JSON 总结，不要调用工具。',
-          temperature: 0.3,
+          systemPrompt,
+          temperature: isSystem ? 0.3 : 0.5,
           maxTokens: 8192,
         },
       );
@@ -1015,11 +1041,13 @@ ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
       finalReply = this.#cleanFinalAnswer(summaryResult.text || '');
     } catch (err) {
       this.#logger.warn(`[ChatAgent] forced summary AI call failed: ${err.message}`);
-      // 合成 digest 兜底
-      const titles = toolCalls
-        .filter(tc => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check')
-        .map(tc => tc.params?.title || 'untitled');
-      finalReply = `\`\`\`json
+
+      if (isSystem) {
+        // ── system 源兜底: 合成 dimensionDigest JSON ──
+        const titles = toolCalls
+          .filter(tc => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check')
+          .map(tc => tc.params?.title || 'untitled');
+        finalReply = `\`\`\`json
 {
   "dimensionDigest": {
     "summary": "通过 ${toolCalls.length} 次工具调用分析了项目代码，提交了 ${candidateCount} 个候选。",
@@ -1030,6 +1058,33 @@ ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
   }
 }
 \`\`\``;
+      } else {
+        // ── user 源兜底: 合成人类可读的 Markdown 摘要 ──
+        const toolNames = [...new Set(toolCalls.map(tc => tc.tool))];
+        const filesRead = toolCalls
+          .filter(tc => tc.tool === 'read_project_file')
+          .flatMap(tc => {
+            if (tc.params?.filePaths) return tc.params.filePaths;
+            if (tc.params?.filePath) return [tc.params.filePath];
+            return [];
+          })
+          .slice(0, 10);
+        const searches = toolCalls
+          .filter(tc => tc.tool === 'search_project_code' || tc.tool === 'semantic_search_code')
+          .map(tc => tc.params?.patterns?.[0] || tc.params?.query || tc.params?.pattern)
+          .filter(Boolean)
+          .slice(0, 5);
+
+        finalReply = `## 分析总结\n\n通过 **${toolCalls.length} 次工具调用**探索了项目代码。\n\n`;
+        if (searches.length > 0) {
+          finalReply += `### 搜索的关键词\n${searches.map(s => `- \`${s}\``).join('\n')}\n\n`;
+        }
+        if (filesRead.length > 0) {
+          finalReply += `### 读取的文件\n${filesRead.map(f => `- \`${f}\``).join('\n')}\n\n`;
+        }
+        finalReply += `### 使用的工具\n${toolNames.map(t => `- ${t}`).join('\n')}\n\n`;
+        finalReply += `> ⚠️ AI 服务异常，未能生成完整分析。请稍后重试或缩小分析范围。`;
+      }
     }
 
     const totalDuration = Date.now() - execStartTime;
@@ -1037,6 +1092,72 @@ ${submitSummary ? `已提交候选:\n${submitSummary}\n` : ''}
     return { reply: finalReply, toolCalls, hasContext: toolCalls.length > 0 };
   }
 
+  /**
+   * 从工具调用记录中提取上下文摘要（供 user 源强制总结使用）
+   * @private
+   */
+  #buildToolContextForUserSummary(toolCalls) {
+    const sections = [];
+
+    // 目录结构探索
+    const structureCalls = toolCalls.filter(tc => tc.tool === 'list_project_structure');
+    if (structureCalls.length > 0) {
+      const dirs = structureCalls.map(tc => tc.params?.directory || '/').slice(0, 5);
+      sections.push(`**目录探索**: ${dirs.map(d => `\`${d}\``).join(', ')}`);
+    }
+
+    // 项目概况
+    const overviewCalls = toolCalls.filter(tc => tc.tool === 'get_project_overview');
+    if (overviewCalls.length > 0) {
+      sections.push('**项目概况**: 已获取');
+    }
+
+    // 代码搜索
+    const searchCalls = toolCalls.filter(tc => tc.tool === 'search_project_code' || tc.tool === 'semantic_search_code');
+    if (searchCalls.length > 0) {
+      const queries = searchCalls
+        .map(tc => tc.params?.patterns?.[0] || tc.params?.query || tc.params?.pattern)
+        .filter(Boolean)
+        .slice(0, 8);
+      sections.push(`**代码搜索** (${searchCalls.length} 次): ${queries.map(q => `\`${q}\``).join(', ')}`);
+    }
+
+    // 文件读取
+    const readCalls = toolCalls.filter(tc => tc.tool === 'read_project_file');
+    if (readCalls.length > 0) {
+      const files = readCalls
+        .flatMap(tc => {
+          if (tc.params?.filePaths) return tc.params.filePaths;
+          if (tc.params?.filePath) return [tc.params.filePath];
+          return [];
+        })
+        .slice(0, 10);
+      sections.push(`**文件读取** (${readCalls.length} 次): ${files.map(f => `\`${f}\``).join(', ')}`);
+    }
+
+    // AST 分析
+    const astCalls = toolCalls.filter(tc =>
+      ['get_class_hierarchy', 'get_class_info', 'get_protocol_info', 'get_method_overrides', 'get_category_map'].includes(tc.tool)
+    );
+    if (astCalls.length > 0) {
+      const entities = astCalls
+        .map(tc => tc.params?.className || tc.params?.name || tc.params?.protocolName || tc.params?.rootClass)
+        .filter(Boolean)
+        .slice(0, 5);
+      sections.push(`**AST 结构分析** (${astCalls.length} 次): ${entities.map(e => `\`${e}\``).join(', ')}`);
+    }
+
+    // 知识库搜索
+    const kbCalls = toolCalls.filter(tc =>
+      ['search_knowledge', 'search_recipes', 'knowledge_overview'].includes(tc.tool)
+    );
+    if (kbCalls.length > 0) {
+      sections.push(`**知识库查询**: ${kbCalls.length} 次`);
+    }
+
+    return sections.length > 0 ? sections.join('\n') : '（工具调用记录为空）';
+  }
+
   // ─── Text Parsing 已移除 (v5.0) ────────────────────────
   // 所有 Provider 统一走 chatWithTools() 原生函数调用路径。
   // 不支持 native tool calling 的 Provider 在基类 chatWithTools()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "AutoSnippet - 连接开发者、AI 与项目知识库的工具",
   "type": "module",
   "main": "lib/bootstrap.js",