@bolloon/bolloon-agent 0.6.5 → 0.6.7

package/dist/llm/pi-ai.js

@@ -9,6 +9,42 @@ export const LLAMACPP_DEFAULT_BASE_URL = 'http://localhost:8080/v1';
 export const LLAMACPP_DEFAULT_MODEL = 'local';
 /** 唯一的重路径用途 */
 export const MAIN_AGENT_PURPOSE = 'main-agent';
+// ---------------------------------------------------------------------------
+// 模型调用并发闸 (2026-10-15, leo: 「[AI 服务调用失败] ... 429 并发请求已达上限, 有错误也要修复」)
+// ---------------------------------------------------------------------------
+// 根因: CLI/Web/心跳/会话总结等多路会同时打同一个 provider, 上游按 API key 限并发
+//   (实测 zai/glm: `当前 API Key 的并发请求已达到上限` 429 rate_limit_error)。
+// 修复: 在**全仓唯一模型调用咽喉** generateText 前按 `providerId|baseUrl` 分桶限流 —
+//   同 key 同时最多 LLM_MAX_CONCURRENCY 个在途请求, 其余排队 (轮询, 可响应 abort)。
+const llmConcurrencyBuckets = new Map();
+export const LLM_MAX_CONCURRENCY = (() => {
+    const n = Number(process.env.BOLLOON_LLM_MAX_CONCURRENCY ?? '');
+    return Number.isFinite(n) && n >= 1 ? Math.min(n, 8) : 2;
+})();
+/** 包一个模型调用进并发闸: 同 key 超限则排队, abort 时尽快退出 (轮询 120ms, 最坏等一拍) */
+export async function withLlmConcurrency(key, signal, fn) {
+    for (;;) {
+        if (signal?.aborted)
+            throw new Error(String(signal.reason || 'AbortError'));
+        const b = llmConcurrencyBuckets.get(key) ?? { active: 0, waiting: 0 };
+        if (b.active < LLM_MAX_CONCURRENCY) {
+            b.active++;
+            llmConcurrencyBuckets.set(key, b);
+            try {
+                return await fn();
+            }
+            finally {
+                b.active--;
+                if (b.active <= 0 && b.waiting <= 0)
+                    llmConcurrencyBuckets.delete(key);
+            }
+        }
+        b.waiting++;
+        llmConcurrencyBuckets.set(key, b);
+        await new Promise((r) => setTimeout(r, 120));
+        b.waiting--;
+    }
+}
 /** 轻量前缀的 system 上限 (字符). 只对**自动装配部分 + 调用方自带短提示**做兜底截断, 正常调用远低于它 */
 export const LIGHTWEIGHT_SYSTEM_MAX_CHARS = 2000;
 /**
@@ -577,7 +613,9 @@ export class PiAIModel {
                     error = retryErr; // 记录最后一次错误, 循环继续重试 (backoff 递增)
                 }
             }
-            console.error('PiAI chat error:', error);
+            // 2026-10-15: 单行标签形 (`[pi-ai]` 是 log-gate INTERNAL_CHATTER_TAG, 只落盘不上屏;
+            //   `分类` 在 for 循环块级作用域内, errMsg 在下面才解析 —— 这里自包含一行, 不引块内变量)
+            console.error(`[pi-ai] chat 失败: ${String(error?.message ?? error).replace(/\n/g, ' ').slice(0, 300)}`);
             // 2026-06-15: 真实 error 信息 + 明确告诉 LLM "这是 API 错, 不要 retry"
             // 旧版: "抱歉，AI服务暂时不可用。" → LLM 看到 isTooShort=false(< 50 但 > 0),
             //       needsMoreWork 不会触发, 但 hasError 模式 (含 "error" / "失败") 会判定要继续修
@@ -655,29 +693,36 @@ export class PiAIModel {
                 finalMessages = [{ role: 'system', content: `可用工具:\n${toolDescriptions}` }, ...messages];
             }
         }
-        switch (this.provider) {
-            case 'openai':
-            case 'minimax':
-            case 'deepseek':
-            case 'kimi':
-            case 'glm':
-            case 'qwen':
-            case 'mimo':
-            case 'grok':
-                return this.callOpenAI(finalMessages, temperature, maxTokens, signal, openaiTools, onToken, purpose, source);
-            case 'anthropic':
-                return this.callAnthropic(finalMessages, temperature, maxTokens, signal);
-            case 'ollama':
-                return this.callOllama(finalMessages, temperature, signal);
-            case 'openrouter':
-                return this.callOpenRouter(finalMessages, temperature, maxTokens, signal);
-            case 'gemini':
-                return this.callGemini(finalMessages, temperature, maxTokens, signal);
-            case 'local':
-                return this.callLocal(finalMessages, temperature, signal);
-            default:
-                throw new Error(`Unsupported provider: ${this.provider}`);
-        }
+        // 2026-10-15 (leo: 429 并发已达上限, 有错误也要修复): 全仓唯一模型调用咽喉 —
+        //   所有入口 (CLI/Web/MCP/技能/子 Agent/长期任务) 都经 generateText 出网,
+        //   在这里按 `providerId|baseUrl` 分桶限流, 同 key 同时最多 LLM_MAX_CONCURRENCY 个在途,
+        //   排队等待 (轮询 120ms, abort 时尽快退出) — 不再把同一 API key 的并发打爆。
+        const bucketKey = `${this.config.providerId ?? this.provider}|${this.getBaseUrl()}`;
+        return withLlmConcurrency(bucketKey, signal, async () => {
+            switch (this.provider) {
+                case 'openai':
+                case 'minimax':
+                case 'deepseek':
+                case 'kimi':
+                case 'glm':
+                case 'qwen':
+                case 'mimo':
+                case 'grok':
+                    return this.callOpenAI(finalMessages, temperature, maxTokens, signal, openaiTools, onToken, purpose, source);
+                case 'anthropic':
+                    return this.callAnthropic(finalMessages, temperature, maxTokens, signal);
+                case 'ollama':
+                    return this.callOllama(finalMessages, temperature, signal);
+                case 'openrouter':
+                    return this.callOpenRouter(finalMessages, temperature, maxTokens, signal);
+                case 'gemini':
+                    return this.callGemini(finalMessages, temperature, maxTokens, signal);
+                case 'local':
+                    return this.callLocal(finalMessages, temperature, signal);
+                default:
+                    throw new Error(`Unsupported provider: ${this.provider}`);
+            }
+        });
     }
     getApiKey() {
         // 2026-09-28: llama.cpp (本地 OpenAI 兼容服务) —— 声明 id 单独接 key, key 可空
@@ -1138,7 +1183,7 @@ export class PiAIModel {
     }
     // 注: callLocal 直接代理 ollama. 工具清单由 generateText 在外层拼到 messages, 这里 messages 已是 finalMessages.
     /**
-     * 2026-09-28: 装配系统提示词并拆成「稳定段 / 动态段」, 按 working dir 缓存 (TTL 10 分钟)。
+     * 2026-09-28: 装配系统提示词并拆成「稳定段 / 动态段」, 按 working dir + **文档指纹** 缓存 (TTL 10 分钟)。
      *
      * 返回: `{ stableText, dynamicText, cached }`
      *   - `stableText` 进 system (逐字节稳定 → 服务端前缀 KV 可复用);
@@ -1147,14 +1192,27 @@ export class PiAIModel {
      * 为什么缓存: 旧版每轮都跑 25 次 fs.readFile + 装配; 缓存后同一次会话内只装一次,
      *   且装配结果逐字节相同 (缓存本身也是"前缀稳定"的必要条件 —— 每次重装都可能因动态层
      *   内容变化而抖动)。
+     *
+     * 2026-10-15 (leo: 「文档改了要下一轮生效, 对齐 Hermes invalidate_system_prompt」):
+     *   缓存 key 并入 `contextFingerprint` —— project Bolloon.md / AGENTS.md / CLAUDE.md /
+     *   hierarchy 4 层 / 当前 agent persona 任一文档的 mtime+size 变了, key 就变 ⇒ 缓存 miss
+     *   ⇒ 下一轮重装配。此前只有 working dir 作 key: 文档改了要等 10 分钟 TTL 才生效。
      */
     async buildSystemPromptParts(context) {
-        const key = context || process.cwd();
         const now = Date.now();
+        const workingDir = context || process.cwd();
+        let fp = '';
+        try {
+            const { contextFingerprint } = await import('../bootstrap/context-collector.js');
+            fp = await contextFingerprint(workingDir);
+        }
+        catch { /* 指纹不可得 → 退回无指纹 key (文档失效钩子缺席, 但装配不阻塞) */ }
+        // 缓存 key = workingDir + 指纹; 装配时 workingDir 保持原值 (不把指纹拼进 prompt 文本)
+        const key = `${workingDir}\u0000${fp}`;
         if (_systemPromptCache && _systemPromptCache.key === key && now - _systemPromptCache.at < SYSTEM_PROMPT_CACHE_TTL_MS) {
             return { stableText: _systemPromptCache.stableText, dynamicText: _systemPromptCache.dynamicText, cached: true };
         }
-        const parts = await this.assembleSystemPromptPartsText(key);
+        const parts = await this.assembleSystemPromptPartsText(workingDir);
         _systemPromptCache = { key, at: now, ...parts };
         return { ...parts, cached: false };
     }
@@ -1390,9 +1448,8 @@ export function initPiAI(config = {}) {
     const isLlamacpp = declared === LLAMACPP_PROVIDER_ID;
     const provider = isLlamacpp ? 'openai' : declared;
     const providerId = config.providerId || (isLlamacpp ? LLAMACPP_PROVIDER_ID : undefined);
-    const model = config.model
-        || (isLlamacpp ? (process.env.LLAMACPP_MODEL || LLAMACPP_DEFAULT_MODEL) : detectModel(provider));
-    let baseUrl = config.baseUrl || (isLlamacpp ? (process.env.LLAMACPP_BASE_URL || LLAMACPP_DEFAULT_BASE_URL) : undefined);
+    let model = config.model || undefined;
+    let baseUrl = config.baseUrl || undefined;
     console.log('[PiAIModel] Initializing with provider:', provider, 'model:', model);
     // 如果没有提供 apiKey，从配置文件读取
     let apiKey = config.apiKey;
@@ -1400,26 +1457,42 @@ export function initPiAI(config = {}) {
     //   否则"换 key"这种真变化不会重建实例, 指纹就失去意义)
     if (!apiKey && isLlamacpp)
         apiKey = process.env.LLAMACPP_API_KEY || undefined;
-    if (!apiKey) {
+    // ── 2026-10-06 技术债重构: 配置文件对所有 provider 生效 (不只 llamacpp) ──
+    //   用户是 200+ 模型 / 自适应 URL 的重度用户: 在配置里自定义 baseUrl/model 必须被尊重。
+    //   之前只有 llamacpp 走这条, 其他 provider 一律被 getBaseUrl()/mapModel() 的
+    //   内置默认 / env 覆盖掉 ⇒ 配置了自定义网关 URL 却打官方端点 (401 真实事故)。
+    //   优先级: 显式 config > 配置文件 > env > 内置默认 (getBaseUrl/mapModel 天然如此,
+    //   这里只把配置值塞进去, 让"配置文件"这一层对所有 provider 生效)。
+    {
         try {
             const configPath = resolveConfigPath();
             if (configPath) {
                 const configData = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                const providerConfig = configData.providers[declared];
-                if (providerConfig?.apiKey) {
+                const providerConfig = configData.providers?.[declared];
+                if (!apiKey && providerConfig?.apiKey) {
                     apiKey = providerConfig.apiKey;
                     console.log('[PiAIModel] Loaded apiKey from config for', declared);
                 }
-                // 2026-09-28: 本地服务 (llamacpp) 的 baseUrl 常写在配置里 → 只对这一家多读一个字段
-                //   (别人保持"只读 apiKey"的老行为: 让 model/baseUrl 的优先级变动会牵连 llm-config 那条线)
-                if (isLlamacpp && !baseUrl && providerConfig?.baseUrl)
+                // 2026-10-06: baseUrl / model 不再只给 llamacpp —— 所有 provider 都尊重配置文件
+                //   (显式 config 优先; 配置里的值只作为"未显式指定"时的兜底)
+                if (!baseUrl && providerConfig?.baseUrl)
                     baseUrl = providerConfig.baseUrl;
+                if (!model && providerConfig?.model)
+                    model = providerConfig.model;
+                if (providerConfig?.baseUrl || providerConfig?.model) {
+                    console.log('[PiAIModel] Loaded baseUrl/model from config for', declared, baseUrl ? 'baseUrl=' + baseUrl : '', model ? 'model=' + model : '');
+                }
             }
         }
         catch (e) {
-            console.log('[PiAIModel] Error reading apiKey from config:', e);
+            console.log('[PiAIModel] Error reading config:', e);
         }
     }
+    // 兜底: 配置文件也没给 → 回落 llamacpp env / detectModel 内置默认 (老行为不变)
+    if (!model)
+        model = isLlamacpp ? (process.env.LLAMACPP_MODEL || LLAMACPP_DEFAULT_MODEL) : detectModel(provider);
+    if (!baseUrl)
+        baseUrl = isLlamacpp ? (process.env.LLAMACPP_BASE_URL || LLAMACPP_DEFAULT_BASE_URL) : undefined;
     // ── 2026-09-28: 按指纹幂等 ──────────────────────────────────────────────
     //   同一份配置重复 init (CLI 每轮 / web 每次请求 / 脚本多入口) **不再重建实例、不再清装配缓存**.
     //   之前每次 init 都清缓存 → 每轮重装 system → 前缀抖动 → 服务端前缀 KV 永远用不上.

package/dist/llm/system-prompt/registry.js

@@ -87,13 +87,14 @@ const DEFAULT_META = (ttlDays) => ({
 const STATIC_LAYERS = [
     // ── core/ ──
     { id: 'core.identity', version: '1.0.0', priority: 50, appliesTo: ['all'], source: 'static-md', maxChars: 800, meta: DEFAULT_META(TTL_KNOWLEDGE) },
-    { id: 'core.knowledge', version: '1.0.0', priority: 60, appliesTo: ['all'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_KNOWLEDGE) },
-    { id: 'core.tools.thin', version: '1.0.0', priority: 70, appliesTo: ['all'], source: 'static-md', maxChars: 400, meta: DEFAULT_META(TTL_SAFETY) },
+    // 2026-10-16: 停用过时的通用知识/Computer Use 提示；实际工具与知识边界由运行时提供。
+    { id: 'core.knowledge', version: '1.0.0', priority: 60, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.tools.thin', version: '1.0.0', priority: 70, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_SAFETY) },
     { id: 'core.hibs_reminders', version: '1.0.0', priority: 80, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_SAFETY) },
     { id: 'core.refusal', version: '1.0.0', priority: 100, appliesTo: ['all'], source: 'static-md', maxChars: 800, meta: DEFAULT_META(TTL_SAFETY) },
-    { id: 'core.tone', version: '1.0.0', priority: 110, appliesTo: ['all'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_KNOWLEDGE) },
-    { id: 'core.wellbeing', version: '1.0.0', priority: 120, appliesTo: ['all'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_KNOWLEDGE) },
-    { id: 'core.evenhandedness', version: '1.0.0', priority: 130, appliesTo: ['all'], source: 'static-md', maxChars: 300, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.tone', version: '1.0.0', priority: 110, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.wellbeing', version: '1.0.0', priority: 120, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    { id: 'core.evenhandedness', version: '1.0.0', priority: 130, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
     { id: 'core.artifacts_storage', version: '1.0.0', priority: 145, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
     { id: 'core.network_filesystem', version: '1.0.0', priority: 148, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
     // ── role/ ── 阶段 0 只用 expert, 其他 3 个停用 (节省 + 阶段 0 不分 role)
@@ -111,7 +112,8 @@ const STATIC_LAYERS = [
     { id: 'channel.human-async', version: '1.0.0', priority: 150, appliesTo: ['local'], source: 'static-md', maxChars: 500, meta: DEFAULT_META(TTL_CHANNEL) },
     { id: 'channel.session-handoff', version: '1.0.0', priority: 150, appliesTo: ['local', 'p2p-visitor', 'p2p-agent'], source: 'static-md', maxChars: 600, meta: DEFAULT_META(TTL_CHANNEL) },
     // ── core/ ──
-    { id: 'core.memory_system', version: '1.0.0', priority: 140, appliesTo: ['all'], source: 'static-md', maxChars: 200, meta: DEFAULT_META(TTL_KNOWLEDGE) },
+    // 2026-10-16: 停用 memory_system — 静态"无记忆"描述与真实记忆系统不符, 记忆状态由 buildStableMemoryBlock 动态注入。
+    { id: 'core.memory_system', version: '1.0.0', priority: 140, appliesTo: ['never'], source: 'static-md', maxChars: 0, meta: DEFAULT_META(TTL_KNOWLEDGE) },
     // 2026-07-10 双栖 agent 网络新增 (按 plan 阶段 4):
     // priority 90 (在 channel 150 之后) — 保证 channel 装完后再装 core, 避免 channel 预算被 core 吃掉
     // maxChars 700 → 400: 7 个新 layer 总预算 3900 chars, 必须让出空间给 tool.p2p_request (700) + tool.goal_handoff (600)

package/dist/orbitdb/memory-sync.js

@@ -0,0 +1,70 @@
+/**
+ * memory-sync.ts — 记忆条目级 OrbitDB 复制 (P3, decentralized-memory-design §2.6)
+ *
+ * 在现有 CID 快照(整快照)之上加「条目级同步」:
+ *   - 保存: MemoryEntry.id (sha256) 作为经内容寻址的 key
+ *   - 存储: CIDDatabase type='memory', metadata 带 entryId + entryUpdatedAt
+ *   - 复制: OrbitDB pubsub 自动 (既有机制)
+ *   - 冲突: 同 entryId 冲突 → updatedAt 大者胜 (LWW), 平手比 content hash
+ *
+ * 诚实边界 (写死):
+ *   - 条目级复制依赖 OrbitDB 网络就绪 (getCIDDatabase 初始化); 网络不可用 /
+ *     初始化失败 → 静默跳过 (本地记忆仍是权威, 复制是增强不是阻塞)
+ *   - 本模块不建新 store, 复用既有 bolloon-cid-store (type='memory')
+ *   - 跨机器真同步需双节点 (设计文档 §5 已记「跨机读群未验证」, P3 只保证
+ *     条目可被 CID 化 + 可恢复; 真双节点验证是 P3b)
+ */
+import { getCIDDatabase } from './cid-database.js';
+/** 条目 → CID 记录的 metadata 常量键 */
+const META_ENTRY_ID = 'entryId';
+const META_ENTRY_UPDATED = 'entryUpdatedAt';
+/** 从 CID 记录还原 MemoryEntry (metadata 无 entryId 的旧记录 → null) */
+export function entryFromRecord(rec) {
+    if (!rec)
+        return null;
+    const meta = rec.metadata || {};
+    if (!meta[META_ENTRY_ID])
+        return null;
+    const e = rec.content;
+    if (!e || typeof e !== 'object' || !e.id || !e.agentId)
+        return null;
+    return e;
+}
+/**
+ * 同步入口: 把一条 MemoryEntry 写入 OrbitDB (条目级)。
+ * 失败静默 (本地记忆不受影响), 返回 CID 或 null。
+ */
+export async function syncMemoryEntryToOrbit(entry, db = getCIDDatabase()) {
+    try {
+        const rec = await db.save({
+            agentId: entry.agentId,
+            type: 'memory',
+            content: entry,
+            metadata: {
+                [META_ENTRY_ID]: entry.id,
+                [META_ENTRY_UPDATED]: entry.updatedAt,
+                kind: 'memory-entry',
+            },
+        });
+        return rec.id;
+    }
+    catch {
+        return null; // 网络/初始化失败静默 — 本地记忆仍权威
+    }
+}
+/**
+ * 拉取远端条目: 列出该 agent 的全部 memory type 记录, 还原成 MemoryEntry。
+ * 仅返回「本地没有 或 远端 updatedAt 更新」的条目 (LWW)。
+ * 不写本地 — 由调用方决定如何合并。
+ */
+export async function fetchRemoteEntries(agentId, db = getCIDDatabase()) {
+    try {
+        const recs = await db.list({ agentId, type: 'memory' });
+        return recs
+            .map((r) => entryFromRecord(r))
+            .filter((e) => e !== null);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/pi-ecosystem-judgment/adaptive-scan.js

@@ -18,7 +18,7 @@
 import * as fs from 'fs/promises';
 import * as os from 'os';
 import * as path from 'path';
-import { loadAllJudgments } from './human-value-store.js';
+import { loadAllJudgments, } from './human-value-store.js';
 // 用 getter 函数而非模块顶层 const: process.env.HOME 在测试 beforeAll 才设,
 // 模块顶层求值时还是真 home. 运行时求值才能正确响应测试 fixture.
 // 跨平台: 优先 process.env.HOME (测试可控), 然后 os.homedir() (Windows 上读 USERPROFILE).

package/dist/security/tool-gate.js

@@ -70,6 +70,8 @@ const TOOL_WHITELIST = new Set([
     'ui_save_component', 'ui_load_component',
     // 2026-08-12: Kanban 看板工具 (Hermes kanban_db → OrbitDB, src/orbitdb/kanban-store.ts)
     'kanban_create', 'kanban_list', 'kanban_get', 'kanban_claim', 'kanban_complete', 'kanban_status',
+    // 2026-10-14: 结构化记忆工具 (src/agents/memory-store.ts, P0)
+    'memory_save', 'memory_recall',
     // 2026-08-07: Bolloon 自身配置读写 (bolloon-config.json, agent 有修改自身配置权限)
     'bolloon_config_get', 'bolloon_config_set',
     // 2026-09-13: 下一代工具集 (人机问答 / 精确补丁 / 代码执行 / 桌面操作 / 技能分享 / 浏览器)

package/dist/setup/setup-store.js

@@ -257,18 +257,36 @@ export async function evaluateSetup(opts = {}) {
     checks.credentialPresent = hasKey;
     checks.providerUsable = providerSelected && credentialOk;
     checks.modelPresent = modelOk;
-    // 3) 连通性 (24h 有效期)
+    // 3) 连通性 (2026-10-13 重构: 结论有效期 = 「测过 + 配置没变」, 不再只看墙钟 24h)
+    //   - 旧逻辑: 24h 墙钟一到就过期, 即使 provider/key/baseUrl/model 一个没动 → 用户隔天启动必见
+    //     「未就绪」, 被迫重测 (体验债: 配置没变重测无意义, 且评估会把 connectivityOk 覆盖成 false 落盘,
+    //     于是「测过」这个事实被销毁, 更修不回来)。
+    //   - 新语义: connectivityAt 存在(测过) 且 配置指纹一致(配置没变) ⇒ 结论仍有效; 只有配置真变了才重测。
     const connAt = checks.connectivityAt ? Date.parse(checks.connectivityAt) : 0;
-    const connFresh = !!connAt && now - connAt < ttl;
+    const hadConnTest = !!connAt;
+    // 配置指纹: 当前配置 vs 上次通过时的配置 —— 相同则连通性结论仍有效 (provider/key/baseUrl/model 都没变)
+    let configUnchanged = false;
+    try {
+        const { hash: curHash } = await hashConfigFiles(bolloonHome);
+        configUnchanged = !!prev.configHash && prev.configHash === curHash;
+    }
+    catch {
+        configUnchanged = false;
+    }
     let connectivityOk = false;
-    if (checks.connectivityOk && connFresh)
+    if (hadConnTest && configUnchanged) {
+        // 测过 + 配置没变 ⇒ 结论有效 (即使墙钟过了 24h)
         connectivityOk = true;
-    else if (checks.connectivityOk && !connFresh) {
-        reasons.push('连通性结果已过期 (>24h) → 需要重新测试');
+        checks.connectivityOk = true; // 救回被旧逻辑覆盖的 false
+    }
+    else if (hadConnTest && !configUnchanged) {
+        // 测过但配置变了 (或 configHash 缺失) ⇒ 需要重测
+        connectivityOk = false;
         checks.connectivityOk = false;
+        reasons.push('LLM 配置已变化 → 需要重新测试连通性');
     }
     if (!connectivityOk)
-        why.basic.push(connAt && !connFresh ? '连通性结果过期 (需重测)' : '还没做过连通性测试');
+        why.basic.push(hadConnTest && !configUnchanged ? '配置变化, 连通性需重测' : '还没做过连通性测试');
     // 4) 运行时 (真实: initMinimax + session; 不是"singleton 存在")
     let runtimeOk = checks.runtimeInitialized === true;
     if (!opts.light) {
@@ -545,6 +563,16 @@ export async function recordSetupStage(stage, patch = {}, bolloonHome = resolveB
         lastError: undefined,
         updatedAt: new Date().toISOString(),
     };
+    // 2026-10-13 重构: 补算并落盘配置指纹 —— 与 evaluateSetup (413-414) 同一逻辑。
+    //   之前只有 evaluateSetup 落 configHash; 直写路径 (onboard 连通性成功 / 测试模拟) 缺 hash ⇒
+    //   连通性判定 (「测过且配置没变 → 结论有效」) 在非 evaluateSetup 路径下永远 configUnchanged=false。
+    //   行为不变 (configHash 仍是同一文件的 sha256), 只是所有写 state 的路径都带上指纹。
+    try {
+        const fp = await hashConfigFiles(bolloonHome);
+        state.configHash = fp.hash;
+        state.configVersion = fp.version;
+    }
+    catch { /* hash 计算失败不阻塞记录 */ }
     await writeSetupState(state, bolloonHome);
     return state;
 }

package/dist/social/heartbeat.js

@@ -260,6 +260,9 @@ export class SocialHeartbeat {
     currentPeerDids = new Set();
     greetingMessage;
     ownIpfsCid;
+    // 2026-10-12: IPFS/IPNS 发布失败只提示一次 (本地没跑节点时每次心跳刷 warn)
+    _ipfsPublishWarned = false;
+    _ipnsPublishWarned = false;
     // 蚁群组件
     pheromoneEngine = null;
     adaptiveHeartbeat = null;
@@ -393,7 +396,7 @@ export class SocialHeartbeat {
             return;
         try {
             const { IpfsClient } = await import('@diap/sdk');
-            const ipfs = new IpfsClient('http://127.0.0.1:5001', null);
+            const ipfs = new IpfsClient('http://127.0.0.1:5001', 'http://127.0.0.1:8080');
             console.log(`[Heartbeat] 从 IPNS 加载 persona: ${this.config.ownIpnsName}`);
             const cid = await ipfs.resolveIpns(this.config.ownIpnsName);
             if (cid) {
@@ -524,7 +527,7 @@ export class SocialHeartbeat {
             return;
         try {
             const { IpfsClient } = await import('@diap/sdk');
-            const ipfs = new IpfsClient('http://127.0.0.1:5001', null);
+            const ipfs = new IpfsClient('http://127.0.0.1:5001', 'http://127.0.0.1:8080');
             const doc = {
                 name: persona.name,
                 description: persona.description,
@@ -541,6 +544,9 @@ export class SocialHeartbeat {
             const content = JSON.stringify(doc);
             const result = await ipfs.upload(content);
             const cid = typeof result === 'string' ? result : result?.cid;
+            // 2026-10-12 (leo: 「IPFS 发布失败刷屏 27 行」): 本地没跑 IPFS 节点时每次心跳都 warn。
+            //   成功一次就重置提示标志 —— 节点恢复后重新可提示。
+            this._ipfsPublishWarned = false;
             if (cid && cid !== this.ownIpfsCid) {
                 this.ownIpfsCid = cid;
                 console.log(`[Heartbeat] Persona 发布到 IPFS: ${cid}`);
@@ -550,13 +556,20 @@ export class SocialHeartbeat {
                         console.log(`[Heartbeat] Persona 发布到 IPNS: ${this.config.ownIpnsName}`);
                     }
                     catch (err) {
-                        console.warn(`[Heartbeat] IPNS 发布失败:`, err);
+                        if (!this._ipnsPublishWarned) {
+                            this._ipnsPublishWarned = true;
+                            console.warn('[Heartbeat] IPNS 发布失败:', err);
+                        }
                     }
                 }
             }
         }
         catch (err) {
-            console.warn('[Heartbeat] IPFS 发布失败:', err);
+            // 只提示第一次 (配置缺失 / 节点未跑是常态, 不该每个心跳刷一条)
+            if (!this._ipfsPublishWarned) {
+                this._ipfsPublishWarned = true;
+                console.warn('[Heartbeat] IPFS 发布失败:', err);
+            }
         }
     }
     async discoverPeers() {
@@ -652,7 +665,7 @@ export class SocialHeartbeat {
             return;
         try {
             const { IpfsClient } = await import('@diap/sdk');
-            const ipfs = new IpfsClient('http://127.0.0.1:5001', null);
+            const ipfs = new IpfsClient('http://127.0.0.1:5001', 'http://127.0.0.1:8080');
             const cid = await ipfs.resolveIpns(agent.ipnsName);
             if (cid) {
                 agent.cid = cid;

package/dist/web/bolloon-web.json

@@ -1,10 +1,10 @@
 {
   "schema": "bolloon-mobile-web/1",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "channel": "stable",
   "build": "stable",
-  "commit": "0d876c1b48ea86d5a390bd21b62468c8d2487fe0",
-  "builtAt": "2026-10-06T07:04:38.761Z",
+  "commit": "94ac12e0c01b2136d9034a38ee1545efb21b23c1",
+  "builtAt": "2026-10-16T19:05:31.069Z",
   "layer": "web",
   "note": "web 资源层构建戳 (手机端 OTA 的身份第 ③ 级回退; 装机后以 OTA state.json 为准)"
 }