@bolloon/bolloon-agent 0.1.16 → 0.1.17

package/dist/agents/pi-sdk.js

@@ -861,7 +861,10 @@ ${this.getToolDefinitions()}
         let lastQualityScore = 0;
         let refineAttempts = 0;
         let consecutiveErrors = 0;
+        let lastFailedTool = ''; // 跟踪最近一次失败的 tool name
+        let lastFailedToolCount = 0; // 最近失败工具的连续失败次数
         const MAX_CONSECUTIVE_ERRORS = 3;
+        const MAX_SAME_TOOL_FAILURES = 3; // 同一工具连续失败 3 次, 强制让 LLM 给出最终答案
         // 发送循环开始的事件
         if (onStream) {
             onStream({ type: 'status', content: '🔄 开始 ReAct 循环...', tool: 'system' });
@@ -987,16 +990,35 @@ ${toolDefs}
                     }
                     else {
                         consecutiveErrors++;
-                        console.warn(`[PiAgent] 工具执行失败 (${consecutiveErrors}/${MAX_CONSECUTIVE_ERRORS}): ${result.error}`);
-                        // 连续错误达到上限，尝试换一种方式
+                        // 跟踪同一工具连续失败次数
+                        if (toolCall.name === lastFailedTool) {
+                            lastFailedToolCount++;
+                        }
+                        else {
+                            lastFailedTool = toolCall.name;
+                            lastFailedToolCount = 1;
+                        }
+                        console.warn(`[PiAgent] 工具 ${toolCall.name} 执行失败 (${lastFailedToolCount}/${MAX_SAME_TOOL_FAILURES}): ${result.error}`);
+                        // 同一工具连续失败达到上限, 不再重试, 强制 LLM 给出最终答案
+                        if (lastFailedToolCount >= MAX_SAME_TOOL_FAILURES) {
+                            console.log(`[PiAgent] 工具 ${toolCall.name} 连续 ${MAX_SAME_TOOL_FAILURES} 次失败, 放弃并要求直接回答`);
+                            this.messageHistory.push({
+                                role: 'system',
+                                content: `[注意] 工具 ${toolCall.name} 在这个上下文中不可用 (连续 ${MAX_SAME_TOOL_FAILURES} 次失败: ${result.error}). 请不要再次调用它, 直接用你已知的信息回答用户, 并在回答开头标记 <final gen>.`
+                            });
+                            lastFailedTool = '';
+                            lastFailedToolCount = 0;
+                            consecutiveErrors = 0;
+                            continue; // 让 LLM 看到系统提示后再决定
+                        }
+                        // 连续错误达到上限(混合不同工具), 尝试换一种方式
                         if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
                             console.log(`[PiAgent] 连续 ${MAX_CONSECUTIVE_ERRORS} 次错误，尝试换一种方式处理`);
-                            // 添加错误上下文，让 LLM 换一种方式
                             this.messageHistory.push({
                                 role: 'system',
-                                content: `[注意] 前面的工具调用连续失败。请尝试其他工具或换一种方式完成用户请求。`
+                                content: `[注意] 前面的工具调用连续失败。请尝试其他工具或换一种方式完成用户请求, 或用 <final gen> 给出最终回答.`
                             });
-                            consecutiveErrors = 0; // 重置以继续尝试
+                            consecutiveErrors = 0;
                         }
                     }
                 }
@@ -1045,9 +1067,14 @@ ${toolDefs}
             }
         }
         if (!finalResponse) {
-            finalResponse = '任务处理超时，请尝试更具体的请求。';
+            // 走到这里通常是 LLM 一直在调同一个不存在的工具, 没输出 <final gen>
+            // 把已知的失败信息也带回去, 让用户知道发生了什么
+            const reason = lastFailedTool
+                ? `(工具 ${lastFailedTool} 连续 ${MAX_SAME_TOOL_FAILURES} 次失败, 已放弃)`
+                : `(共 ${iteration - 1} 轮无最终输出)`;
+            finalResponse = `抱歉，任务未能完成 ${reason}。请换个方式提问，或明确告诉 agent 不要调用工具。`;
             if (onStream) {
-                onStream({ type: 'error', content: '⚠️ 任务处理超时', tool: 'system' });
+                onStream({ type: 'error', content: `⚠️ 任务未完成: ${reason}`, tool: 'system' });
             }
         }
         // 通知前端循环完成
@@ -1357,9 +1384,21 @@ ${this.extractOperationsFromRef(operationsRef)}
         try {
             const response = await llm.chat(`根据以下对话内容，为这个对话生成一个简短的名称（不超过20个字）：\n\n${conversation}\n\n直接输出名称，不要其他解释。`, '命名建议');
             const name = response.reply.trim();
-            if (name && name.length <= 20 && name !== '智能体') {
-                return `Agent | ${name}`;
+            // 拒绝错误回退串 (LLM 不可用时返回的占位文本)
+            if (!name)
+                return null;
+            if (/^(抱歉|对不起|sorry|error|错误|失败|暂不可用|服务不可用)/i.test(name)) {
+                console.log(`[suggestRename] 拒绝错误回退: "${name}"`);
+                return null;
             }
+            if (name.length > 20)
+                return null;
+            if (name === '智能体')
+                return null;
+            // 拒绝纯符号/标点
+            if (!/[一-鿿\w]/.test(name))
+                return null;
+            return `Agent | ${name}`;
         }
         catch {
             // ignore

package/dist/web/manifest.json

@@ -0,0 +1,21 @@
+{
+  "name": "Bolloon Agent",
+  "short_name": "Bolloon",
+  "description": "AI Agent with Claude API integration",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#1a1a2e",
+  "theme_color": "#1a1a2e",
+  "icons": [
+    {
+      "src": "/icons/favicon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icons/favicon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}

package/dist/web/server.js

@@ -58,12 +58,19 @@ async function saveChannels(channels) {
         return rest;
     });
     const jsonStr = JSON.stringify(sanitized, null, 2);
+    // 写盘保护: 内容和上次完全一致就跳过, 避免 SSE ping / 重新 init 触发的无意义写盘
+    if (jsonStr === lastChannelsJson) {
+        return; // 静默跳过, 不打日志
+    }
+    lastChannelsJson = jsonStr;
     console.log('[saveChannels] 保存频道数据, 数量:', sanitized.length);
     console.log('[saveChannels] JSON 长度:', jsonStr.length);
     await fs.writeFile(CHANNELS_PATH, jsonStr);
     // 写盘即令缓存失效: 用 lastChannelsWriteAt 标记, getChannelsWithDID 会检查
     lastChannelsWriteAt = Date.now();
 }
+// 写盘去重: 上次写盘内容, 用于跳过幂等调用
+let lastChannelsJson = '';
 // 模块级: 最近一次 channels.json 写盘时间. saveChannels 在模块顶层,
 // getChannelsWithDID 在 createWebServer 内部, 跨作用域用模块变量桥接.
 let lastChannelsWriteAt = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli.js",
@@ -32,7 +32,7 @@
     "src/constraint-runtime"
   ],
   "dependencies": {
-    "@bolloon/bolloon-agent": "^0.1.16",
+    "@bolloon/bolloon-agent": "^0.1.17",
     "@bolloon/constraint-runtime": "0.1.0",
     "@chainsafe/libp2p-noise": "^17.0.0",
     "@chainsafe/libp2p-yamux": "^8.0.1",

package/scripts/build-web.ts

@@ -57,6 +57,10 @@ async function main() {
   await fs.copyFile(path.join(ROOT, 'src/web/api-config.html'), path.join(DIST_WEB, 'api-config.html'));
   await fs.copyFile(path.join(ROOT, 'src/web/style.css'), path.join(DIST_WEB, 'style.css'));
   await fs.copyFile(path.join(ROOT, 'src/web/client.js'), path.join(DIST_WEB, 'client.js'));
+  // 复制 PWA manifest (index.html 里有 <link rel="manifest">, 否则浏览器会 404)
+  await fs.copyFile(path.join(ROOT, 'src/web/manifest.json'), path.join(DIST_WEB, 'manifest.json'));
+  // 复制 icons 目录 (manifest.json 里引用了 favicon 等)
+  await fs.cp(path.join(ROOT, 'src/web/icons'), path.join(DIST_WEB, 'icons'), { recursive: true });
 
   console.log('[build-web] 完成!');
 }

package/src/agents/pi-sdk.ts

@@ -1115,7 +1115,10 @@ ${this.getToolDefinitions()}
     let lastQualityScore = 0;
     let refineAttempts = 0;
     let consecutiveErrors = 0;
+    let lastFailedTool = ''; // 跟踪最近一次失败的 tool name
+    let lastFailedToolCount = 0; // 最近失败工具的连续失败次数
     const MAX_CONSECUTIVE_ERRORS = 3;
+    const MAX_SAME_TOOL_FAILURES = 3; // 同一工具连续失败 3 次, 强制让 LLM 给出最终答案
 
     // 发送循环开始的事件
     if (onStream) {
@@ -1260,17 +1263,36 @@ ${toolDefs}
             // 不 break，继续下一次循环
           } else {
             consecutiveErrors++;
-            console.warn(`[PiAgent] 工具执行失败 (${consecutiveErrors}/${MAX_CONSECUTIVE_ERRORS}): ${result.error}`);
+            // 跟踪同一工具连续失败次数
+            if (toolCall.name === lastFailedTool) {
+              lastFailedToolCount++;
+            } else {
+              lastFailedTool = toolCall.name;
+              lastFailedToolCount = 1;
+            }
+            console.warn(`[PiAgent] 工具 ${toolCall.name} 执行失败 (${lastFailedToolCount}/${MAX_SAME_TOOL_FAILURES}): ${result.error}`);
+
+            // 同一工具连续失败达到上限, 不再重试, 强制 LLM 给出最终答案
+            if (lastFailedToolCount >= MAX_SAME_TOOL_FAILURES) {
+              console.log(`[PiAgent] 工具 ${toolCall.name} 连续 ${MAX_SAME_TOOL_FAILURES} 次失败, 放弃并要求直接回答`);
+              this.messageHistory.push({
+                role: 'system',
+                content: `[注意] 工具 ${toolCall.name} 在这个上下文中不可用 (连续 ${MAX_SAME_TOOL_FAILURES} 次失败: ${result.error}). 请不要再次调用它, 直接用你已知的信息回答用户, 并在回答开头标记 <final gen>.`
+              });
+              lastFailedTool = '';
+              lastFailedToolCount = 0;
+              consecutiveErrors = 0;
+              continue; // 让 LLM 看到系统提示后再决定
+            }
 
-            // 连续错误达到上限，尝试换一种方式
+            // 连续错误达到上限(混合不同工具), 尝试换一种方式
             if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
               console.log(`[PiAgent] 连续 ${MAX_CONSECUTIVE_ERRORS} 次错误，尝试换一种方式处理`);
-              // 添加错误上下文，让 LLM 换一种方式
               this.messageHistory.push({
                 role: 'system',
-                content: `[注意] 前面的工具调用连续失败。请尝试其他工具或换一种方式完成用户请求。`
+                content: `[注意] 前面的工具调用连续失败。请尝试其他工具或换一种方式完成用户请求, 或用 <final gen> 给出最终回答.`
               });
-              consecutiveErrors = 0; // 重置以继续尝试
+              consecutiveErrors = 0;
             }
           }
         } catch (execError) {
@@ -1323,9 +1345,14 @@ ${toolDefs}
     }
 
     if (!finalResponse) {
-      finalResponse = '任务处理超时，请尝试更具体的请求。';
+      // 走到这里通常是 LLM 一直在调同一个不存在的工具, 没输出 <final gen>
+      // 把已知的失败信息也带回去, 让用户知道发生了什么
+      const reason = lastFailedTool
+        ? `(工具 ${lastFailedTool} 连续 ${MAX_SAME_TOOL_FAILURES} 次失败, 已放弃)`
+        : `(共 ${iteration - 1} 轮无最终输出)`;
+      finalResponse = `抱歉，任务未能完成 ${reason}。请换个方式提问，或明确告诉 agent 不要调用工具。`;
       if (onStream) {
-        onStream({ type: 'error', content: '⚠️ 任务处理超时', tool: 'system' });
+        onStream({ type: 'error', content: `⚠️ 任务未完成: ${reason}`, tool: 'system' });
       }
     }
 
@@ -1654,9 +1681,17 @@ ${this.extractOperationsFromRef(operationsRef)}
       );
 
       const name = response.reply.trim();
-      if (name && name.length <= 20 && name !== '智能体') {
-        return `Agent | ${name}`;
+      // 拒绝错误回退串 (LLM 不可用时返回的占位文本)
+      if (!name) return null;
+      if (/^(抱歉|对不起|sorry|error|错误|失败|暂不可用|服务不可用)/i.test(name)) {
+        console.log(`[suggestRename] 拒绝错误回退: "${name}"`);
+        return null;
       }
+      if (name.length > 20) return null;
+      if (name === '智能体') return null;
+      // 拒绝纯符号/标点
+      if (!/[一-鿿\w]/.test(name)) return null;
+      return `Agent | ${name}`;
     } catch {
       // ignore
     }

package/src/web/server.ts

@@ -117,6 +117,13 @@ async function saveChannels(channels: Channel[]): Promise<void> {
     return rest as Channel;
   });
   const jsonStr = JSON.stringify(sanitized, null, 2);
+
+  // 写盘保护: 内容和上次完全一致就跳过, 避免 SSE ping / 重新 init 触发的无意义写盘
+  if (jsonStr === lastChannelsJson) {
+    return; // 静默跳过, 不打日志
+  }
+  lastChannelsJson = jsonStr;
+
   console.log('[saveChannels] 保存频道数据, 数量:', sanitized.length);
   console.log('[saveChannels] JSON 长度:', jsonStr.length);
   await fs.writeFile(CHANNELS_PATH, jsonStr);
@@ -124,6 +131,9 @@ async function saveChannels(channels: Channel[]): Promise<void> {
   lastChannelsWriteAt = Date.now();
 }
 
+// 写盘去重: 上次写盘内容, 用于跳过幂等调用
+let lastChannelsJson = '';
+
 // 模块级: 最近一次 channels.json 写盘时间. saveChannels 在模块顶层,
 // getChannelsWithDID 在 createWebServer 内部, 跨作用域用模块变量桥接.
 let lastChannelsWriteAt = 0;