@bolloon/bolloon-agent 0.4.14 → 0.4.15

package/bin/bolloon-daemon.sh

@@ -0,0 +1,207 @@
+#!/bin/bash
+# Bolloon Daemon - 守护进程启动脚本
+# 支持自动重启、日志轮转、PID 管理
+
+set -e
+
+APP_NAME="bolloon"
+APP_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PID_FILE="$HOME/.bolloon/daemon.pid"
+LOG_FILE="$HOME/.bolloon/daemon.log"
+MAX_RESTARTS=5
+RESTART_DELAY=5
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+log() {
+    echo -e "${GREEN}[$(date '+%Y-%m-%d %H:%M:%S')]${NC} $1"
+}
+
+warn() {
+    echo -e "${YELLOW}[$(date '+%Y-%m-%d %H:%M:%S')] WARN:${NC} $1"
+}
+
+error() {
+    echo -e "${RED}[$(date '+%Y-%m-%d %H:%M:%S')] ERROR:${NC} $1"
+}
+
+# 获取 PID
+get_pid() {
+    if [ -f "$PID_FILE" ]; then
+        cat "$PID_FILE"
+    fi
+}
+
+# 检查进程是否运行
+is_running() {
+    local pid=$(get_pid)
+    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+        return 0
+    fi
+    return 1
+}
+
+# 启动守护进程
+start() {
+    if is_running; then
+        log "Bolloon 已在运行 (PID: $(get_pid))"
+        return 0
+    fi
+
+    log "启动 Bolloon 守护进程..."
+
+    # 确保日志目录存在
+    mkdir -p "$(dirname "$LOG_FILE")"
+
+    # 启动进程
+    cd "$APP_DIR"
+    nohup npx tsx src/index.ts >> "$LOG_FILE" 2>&1 &
+    local pid=$!
+
+    # 保存 PID
+    echo "$pid" > "$PID_FILE"
+    log "Bolloon 已启动 (PID: $pid)"
+    log "日志文件: $LOG_FILE"
+}
+
+# 停止守护进程
+stop() {
+    local pid=$(get_pid)
+
+    if [ -z "$pid" ]; then
+        warn "Bolloon 未运行"
+        return 0
+    fi
+
+    log "停止 Bolloon (PID: $pid)..."
+
+    # 发送 SIGTERM
+    kill -TERM "$pid" 2>/dev/null || true
+
+    # 等待进程退出
+    local count=0
+    while kill -0 "$pid" 2>/dev/null && [ $count -lt 10 ]; do
+        sleep 1
+        count=$((count + 1))
+    done
+
+    # 如果还在运行，强制终止
+    if kill -0 "$pid" 2>/dev/null; then
+        warn "进程未响应，发送 SIGKILL..."
+        kill -KILL "$pid" 2>/dev/null || true
+    fi
+
+    # 清理 PID 文件
+    rm -f "$PID_FILE"
+    log "Bolloon 已停止"
+}
+
+# 重启守护进程
+restart() {
+    log "重启 Bolloon..."
+    stop
+    sleep 2
+    start
+}
+
+# 查看状态
+status() {
+    if is_running; then
+        log "Bolloon 运行中 (PID: $(get_pid))"
+        # 显示资源使用
+        local pid=$(get_pid)
+        if [ -n "$pid" ]; then
+            ps -p "$pid" -o %cpu,%mem,etime 2>/dev/null | tail -1 || true
+        fi
+    else
+        warn "Bolloon 未运行"
+    fi
+}
+
+# 查看日志
+logs() {
+    if [ -f "$LOG_FILE" ]; then
+        tail -100 "$LOG_FILE"
+    else
+        warn "日志文件不存在: $LOG_FILE"
+    fi
+}
+
+# 健康检查
+health() {
+    local port=${PORT:-54188}
+    local response=$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:$port/api/health" 2>/dev/null || echo "000")
+
+    if [ "$response" = "200" ]; then
+        log "健康检查通过"
+        curl -s "http://localhost:$port/api/health" 2>/dev/null | head -5
+    else
+        error "健康检查失败 (HTTP $response)"
+        return 1
+    fi
+}
+
+# 清理日志
+clean_logs() {
+    if [ -f "$LOG_FILE" ]; then
+        local size=$(du -h "$LOG_FILE" | cut -f1)
+        log "当前日志大小: $size"
+        > "$LOG_FILE"
+        log "日志已清空"
+    fi
+}
+
+# 显示帮助
+show_help() {
+    echo "Bolloon Daemon 守护进程管理脚本"
+    echo ""
+    echo "用法: $0 [命令]"
+    echo ""
+    echo "命令:"
+    echo "  start    启动 Bolloon 守护进程"
+    echo "  stop     停止 Bolloon 守护进程"
+    echo "  restart  重启 Bolloon 守护进程"
+    echo "  status   查看运行状态"
+    echo "  logs     查看最近日志"
+    echo "  health   健康检查"
+    echo "  clean    清空日志"
+    echo "  help     显示帮助"
+    echo ""
+}
+
+# 主逻辑
+case "${1:-help}" in
+    start)
+        start
+        ;;
+    stop)
+        stop
+        ;;
+    restart)
+        restart
+        ;;
+    status)
+        status
+        ;;
+    logs)
+        logs
+        ;;
+    health)
+        health
+        ;;
+    clean)
+        clean_logs
+        ;;
+    help|--help|-h)
+        show_help
+        ;;
+    *)
+        error "未知命令: $1"
+        show_help
+        exit 1
+        ;;
+esac

package/dist/agents/constraint-layer.js

@@ -7,25 +7,25 @@ import { ToolPermissionContext, BudgetTracker } from '@bolloon/constraint-runtim
  * System prompt for constraint layer
  * Defines boundaries and autonomous permissions
  */
-export const SYSTEM_PROMPT = `
-你是一个文档处理Agent，在以下规则下运行：
-
-【边界规则】
-1. 只处理：txt, md, pdf, docx 格式文档
-2. 不修改原始文件，只输出改进版本
-3. 发送前必须记录操作日志
-
-【自主权限】
-- ✅ 自主决定：摘要详细程度、chunk分块策略
-- ✅ 自主决定：重试次数（最多3次）
-- ✅ 自主决定：是否需要补充信息
-- ❌ 必须确认：首次向新对等节点发送文档
-- ❌ 必须确认：删除操作
-
-【敏感操作拦截】
-if (操作 === '发送文档' && 对等节点不在已知列表) {
-  拦截 → 记录 → 等待确认
-}
+export const SYSTEM_PROMPT = `
+你是一个文档处理Agent，在以下规则下运行：
+
+【边界规则】
+1. 只处理：txt, md, pdf, docx 格式文档
+2. 不修改原始文件，只输出改进版本
+3. 发送前必须记录操作日志
+
+【自主权限】
+- ✅ 自主决定：摘要详细程度、chunk分块策略
+- ✅ 自主决定：重试次数（最多3次）
+- ✅ 自主决定：是否需要补充信息
+- ❌ 必须确认：首次向新对等节点发送文档
+- ❌ 必须确认：删除操作
+
+【敏感操作拦截】
+if (操作 === '发送文档' && 对等节点不在已知列表) {
+  拦截 → 记录 → 等待确认
+}
 `;
 /**
  * Actions that can be executed autonomously without confirmation

package/dist/agents/judgment-protocol.js

@@ -148,20 +148,20 @@ export async function distillDissent(ask) {
         .slice(-10)
         .flatMap((j) => j.reasons || [])
         .slice(0, 20);
-    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
-${ask.context ? `\n补充: ${ask.context}` : ''}
-
-[用户价值画像] ${valueHint}
-[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
-[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
-
-请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
-要求:
-- 每个反方 1-2 句, 总长 < 80 字
-- 必须是这个特定决定的"反对声音", 不是通用建议
-- 第 1 个: 历史/经验类风险
-- 第 2 个: 关系/信任类风险
-- 第 3 个: 隐藏代价/时间类风险
+    const prompt = `你是用户的判断力代理. 用户发起了一个决定: "${ask.decision}"
+${ask.context ? `\n补充: ${ask.context}` : ''}
+
+[用户价值画像] ${valueHint}
+[相关历史判断 (${relevant.length} 条)] ${relevant.slice(0, 3).map((j) => j.decision || '').join(' | ').slice(0, 300)}
+[历史理由样本] ${recentReasons.join(' | ').slice(0, 400) || '(无)'}
+
+请基于上述判断力, 生成正好 3 个"反方观点" (用户应该考虑但可能忽略的风险/盲点).
+要求:
+- 每个反方 1-2 句, 总长 < 80 字
+- 必须是这个特定决定的"反对声音", 不是通用建议
+- 第 1 个: 历史/经验类风险
+- 第 2 个: 关系/信任类风险
+- 第 3 个: 隐藏代价/时间类风险
 - 用 JSON 数组返回: ["反方1", "反方2", "反方3"]`;
     // LLM 调用 (OpenAI 兼容, 复用 p2p-chat-tools 的方式)
     let dissents = [];

package/dist/agents/pi-sdk-types.js

@@ -1,13 +1,13 @@
-export const TOOL_DEFINITIONS = `
-可用工具:
-1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
-2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
-3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
-4. list_peers() - 列出已连接的对等节点
-5. send_message(peer_id, message) - 向指定对等节点发送消息
-6. broadcast_message(message) - 向所有对等节点广播消息
-7. get_identity() - 获取当前智能体身份信息
-8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
-9. run_workflow(steps) - 执行预定义工作流
-10. get_operation_logs() - 获取操作日志
+export const TOOL_DEFINITIONS = `
+可用工具:
+1. read_document(path) - 读取文档内容，支持 .txt, .md, .pdf, .docx
+2. summarize_document(path, context?) - 总结文档内容，可选提供上下文
+3. improve_document(path, requirements) - 改进文档，需提供文件路径和改进要求
+4. list_peers() - 列出已连接的对等节点
+5. send_message(peer_id, message) - 向指定对等节点发送消息
+6. broadcast_message(message) - 向所有对等节点广播消息
+7. get_identity() - 获取当前智能体身份信息
+8. set_persona(persona_json) - 更新智能体 persona，包含 name、description、personality、greeting 等
+9. run_workflow(steps) - 执行预定义工作流
+10. get_operation_logs() - 获取操作日志
 `;

package/dist/agents/pi-sdk.js

@@ -202,13 +202,13 @@ export class PiAgentSession {
     /** Bootstrap SessionStart 拼的 system prompt 片段 (用完即清) */
     bootstrapAddition = '';
     /** 2026-08-12 (Task3 认知卸载): 工具选择与认知卸载指南 — 注入 system prompt, 降低"模型不触发 write/edit/read"率. */
-    static TOOL_SELECTION_GUIDE = `【工具选择与认知卸载指南 (严格遵循)】
-- 写/改文件: 必须用 write_file / edit_file (不要用 terminal 拼字符串写文件).
-- 读文件: 用 read_file / read_directory / list_files.
-- 跑命令/查状态/装依赖/跑脚本: 用 terminal.
-- 执行 git 操作: 用 git_* 专用工具 (git_diff/git_commit/git_push/git_branch/git_log).
-- 查看/调用技能: 用 list_skills / use_skill.
-- 认知卸载: 当任务对你过大或反复失败时, 不要死磕 — 用 delegate_to_engine 把编码/复杂任务委派给外部引擎 (codex/claude-code/opencode), 或把目标拆小分步完成.
+    static TOOL_SELECTION_GUIDE = `【工具选择与认知卸载指南 (严格遵循)】
+- 写/改文件: 必须用 write_file / edit_file (不要用 terminal 拼字符串写文件).
+- 读文件: 用 read_file / read_directory / list_files.
+- 跑命令/查状态/装依赖/跑脚本: 用 terminal.
+- 执行 git 操作: 用 git_* 专用工具 (git_diff/git_commit/git_push/git_branch/git_log).
+- 查看/调用技能: 用 list_skills / use_skill.
+- 认知卸载: 当任务对你过大或反复失败时, 不要死磕 — 用 delegate_to_engine 把编码/复杂任务委派给外部引擎 (codex/claude-code/opencode), 或把目标拆小分步完成.
 - 每步只选一个最合适的工具, 先读后写, 写完验证 (跑 tsc/vitest 或读回文件).`;
     /** 当前 prompt 开始时间 (供 Stop hook 计算 durationMs) */
     promptStartTime = 0;
@@ -1061,40 +1061,40 @@ export class PiAgentSession {
         }
         // M2.4: persona 缓存
         if (!this.cachedPersonaSection && this.persona) {
-            this.cachedPersonaSection = `
-角色描述: ${this.persona.description || '无'}
-性格特点: ${this.persona.personality || '无'}
-问候语: ${this.persona.greeting || '无'}
+            this.cachedPersonaSection = `
+角色描述: ${this.persona.description || '无'}
+性格特点: ${this.persona.personality || '无'}
+问候语: ${this.persona.greeting || '无'}
 `;
         }
-        const systemPrompt = `${this.bootstrapAddition}你是 ${this.identity.name}，基于ReAct (Reasoning + Acting)模式工作。${this.cachedPersonaSection}
-当前工作目录: ${this.cwd}
-当前身份: ${this.identity.name} (${this.identity.did})
-${this.currentIntentHint}
-
-${this.getToolDefinitions()}
-
-${PiAgentSession.TOOL_SELECTION_GUIDE}
-
-工作模式:
-1. 理解用户自然语言请求
-2. 分析需要哪些工具来完成
-3. 按顺序调用工具并观察结果
-4. 根据观察结果决定下一步
-5. 最终给出完整回答
-
-重要 (一次命中要求):
-- 每次只调用一个工具
-- 仔细分析工具返回结果
-- 当任务完成时，必须在回答末尾添加 <final gen> 标记表示结束
-- 如果需要更多信息，继续调用工具
-
-【工具调用格式 (严格遵守, 否则系统无法解析)】
-- 你只能输出**一个**工具调用, 不要堆叠多个 invoke
-- 工具调用格式: {"name":"<tool_name>","input":{"arg1":"value1"}}
-- 用 markdown json code block 包裹: \`\`\`json\n{"name":"X","input":{...}}\n\`\`\`
-- 工具调用前可以简短思考 (1-2 句话), 但**不要写长篇 thinking** (会撞 max_tokens)
-- 工具调用后必须等结果, 不要在同一个回复里继续输出
+        const systemPrompt = `${this.bootstrapAddition}你是 ${this.identity.name}，基于ReAct (Reasoning + Acting)模式工作。${this.cachedPersonaSection}
+当前工作目录: ${this.cwd}
+当前身份: ${this.identity.name} (${this.identity.did})
+${this.currentIntentHint}
+
+${this.getToolDefinitions()}
+
+${PiAgentSession.TOOL_SELECTION_GUIDE}
+
+工作模式:
+1. 理解用户自然语言请求
+2. 分析需要哪些工具来完成
+3. 按顺序调用工具并观察结果
+4. 根据观察结果决定下一步
+5. 最终给出完整回答
+
+重要 (一次命中要求):
+- 每次只调用一个工具
+- 仔细分析工具返回结果
+- 当任务完成时，必须在回答末尾添加 <final gen> 标记表示结束
+- 如果需要更多信息，继续调用工具
+
+【工具调用格式 (严格遵守, 否则系统无法解析)】
+- 你只能输出**一个**工具调用, 不要堆叠多个 invoke
+- 工具调用格式: {"name":"<tool_name>","input":{"arg1":"value1"}}
+- 用 markdown json code block 包裹: \`\`\`json\n{"name":"X","input":{...}}\n\`\`\`
+- 工具调用前可以简短思考 (1-2 句话), 但**不要写长篇 thinking** (会撞 max_tokens)
+- 工具调用后必须等结果, 不要在同一个回复里继续输出
 - <final gen> 只在**真完成所有任务**时输出, 不要在工具调用前/中输出${this.judgmentGateAddition}${this.contextHintAddition}`;
         // 2026-06-15: 把 currentOnStream 传给 loop, 让 step-timeline 在 pivot 循环里也能 emit step_start/done
         //   之前 loop.execute() 不接 streamCallback, 导致 step-timeline 只能看到老 runReActLoop 路径
@@ -1286,10 +1286,10 @@ ${PiAgentSession.TOOL_SELECTION_GUIDE}
             }
             // M2.4: persona section 缓存 — persona 在 loadPersona() 时一次设定, 此后不变
             if (!this.cachedPersonaSection && this.persona) {
-                this.cachedPersonaSection = `
-角色描述: ${this.persona.description || '无'}
-性格特点: ${this.persona.personality || '无'}
-问候语: ${this.persona.greeting || '无'}
+                this.cachedPersonaSection = `
+角色描述: ${this.persona.description || '无'}
+性格特点: ${this.persona.personality || '无'}
+问候语: ${this.persona.greeting || '无'}
 `;
             }
             const personaSection = this.cachedPersonaSection;
@@ -1307,28 +1307,28 @@ ${PiAgentSession.TOOL_SELECTION_GUIDE}
                     .join('\n');
                 loopProgressSection = `\n【本轮循环进度】你已完成以下 ${loopActionLog.length} 个动作, 这是连续执行的同一轮任务:\n${actionLines}\n请基于已有结果继续推进, 不要重复执行上面已成功的动作. 全部完成后用 <final gen> 结束.\n`;
             }
-            const systemPrompt = `${this.bootstrapAddition}你是 ${this.identity.name}，基于ReAct (Reasoning + Acting)模式工作。${personaSection}
-当前工作目录: ${this.cwd}
-当前身份: ${this.identity.name} (${this.identity.did})
-${refineContext}
-${this.currentIntentHint}
-${loopProgressSection}
-
-${toolDefs}
-
-${PiAgentSession.TOOL_SELECTION_GUIDE}
-
-工作模式:
-1. 理解用户自然语言请求
-2. 分析需要哪些工具来完成
-3. 按顺序调用工具并观察结果
-4. 根据观察结果决定下一步
-5. 最终给出完整回答
-
-重要:
-- 每次只调用一个工具
-- 仔细分析工具返回结果
-- 当任务完成时，必须在回答末尾添加 <final gen> 标记表示结束
+            const systemPrompt = `${this.bootstrapAddition}你是 ${this.identity.name}，基于ReAct (Reasoning + Acting)模式工作。${personaSection}
+当前工作目录: ${this.cwd}
+当前身份: ${this.identity.name} (${this.identity.did})
+${refineContext}
+${this.currentIntentHint}
+${loopProgressSection}
+
+${toolDefs}
+
+${PiAgentSession.TOOL_SELECTION_GUIDE}
+
+工作模式:
+1. 理解用户自然语言请求
+2. 分析需要哪些工具来完成
+3. 按顺序调用工具并观察结果
+4. 根据观察结果决定下一步
+5. 最终给出完整回答
+
+重要:
+- 每次只调用一个工具
+- 仔细分析工具返回结果
+- 当任务完成时，必须在回答末尾添加 <final gen> 标记表示结束
 - 如果需要更多信息，继续调用工具${this.judgmentGateAddition}${this.contextHintAddition}`;
             // 3 个恢复机制 (Claude Code 论文 9-step pipeline 内部):
             //   1. max output token 升级 (最多 3 次, 每次 maxOutputTokens 翻倍)
@@ -2399,37 +2399,37 @@ ${PiAgentSession.TOOL_SELECTION_GUIDE}
     getDefaultResponse(input) {
         const operationsRef = PiAgentSession.getOperationsReference();
         if (operationsRef) {
-            return `收到了: "${input}"
-
-我是一个判断力处理智能体，支持自然语言交互。
-
-可用操作（直接说出即可）:
-${this.extractOperationsFromRef(operationsRef)}
-
-示例请求:
-  - "读取 src/index.ts 文件"
-  - "总结一下 README.md"
-  - "查看当前连接了哪些节点"
+            return `收到了: "${input}"
+
+我是一个判断力处理智能体，支持自然语言交互。
+
+可用操作（直接说出即可）:
+${this.extractOperationsFromRef(operationsRef)}
+
+示例请求:
+  - "读取 src/index.ts 文件"
+  - "总结一下 README.md"
+  - "查看当前连接了哪些节点"
   - "向 QmABC... 发送测试消息"`;
         }
-        return `收到了: "${input}"
-
-我是一个判断力处理智能体，支持自然语言交互。
-
-可用操作（直接说出即可）:
-  - "读取 README.md" - 读取并分析文档
-  - "总结文档" - 总结文档内容
-  - "改进文档，按照X要求" - 改进文档
-  - "查看节点" - 查看已连接的对等节点
-  - "向X发送消息Y" - 向对等节点发送消息
-  - "广播消息X" - 广播消息到所有节点
-  - "查看身份" - 查看当前智能体身份
-  - "查看日志" - 查看最近操作日志
-
-示例请求:
-  - "读取 src/index.ts 文件"
-  - "总结一下 README.md"
-  - "查看当前连接了哪些节点"
+        return `收到了: "${input}"
+
+我是一个判断力处理智能体，支持自然语言交互。
+
+可用操作（直接说出即可）:
+  - "读取 README.md" - 读取并分析文档
+  - "总结文档" - 总结文档内容
+  - "改进文档，按照X要求" - 改进文档
+  - "查看节点" - 查看已连接的对等节点
+  - "向X发送消息Y" - 向对等节点发送消息
+  - "广播消息X" - 广播消息到所有节点
+  - "查看身份" - 查看当前智能体身份
+  - "查看日志" - 查看最近操作日志
+
+示例请求:
+  - "读取 src/index.ts 文件"
+  - "总结一下 README.md"
+  - "查看当前连接了哪些节点"
   - "向 QmABC... 发送测试消息"`;
     }
     extractOperationsFromRef(ref) {
@@ -2454,13 +2454,13 @@ ${this.extractOperationsFromRef(operationsRef)}
             }
         }
         return operationLines.length > 0 ? operationLines.join('\n') :
-            `  - "读取 README.md" - 读取并分析文档
-  - "总结文档" - 总结文档内容
-  - "改进文档，按照X要求" - 改进文档
-  - "查看节点" - 查看已连接的对等节点
-  - "向X发送消息Y" - 向对等节点发送消息
-  - "广播消息X" - 广播消息到所有节点
-  - "查看身份" - 查看当前智能体身份
+            `  - "读取 README.md" - 读取并分析文档
+  - "总结文档" - 总结文档内容
+  - "改进文档，按照X要求" - 改进文档
+  - "查看节点" - 查看已连接的对等节点
+  - "向X发送消息Y" - 向对等节点发送消息
+  - "广播消息X" - 广播消息到所有节点
+  - "查看身份" - 查看当前智能体身份
   - "查看日志" - 查看最近操作日志`;
     }
     async suggestRename(messages) {

package/dist/agents/skill-organizer.js

@@ -143,25 +143,25 @@ export async function scanLeftoverSkills(opts = {}) {
 // ───────────────────────── B. 经验进化 (LLM 完整总结) ─────────────────────────
 /** 把候选的工具调用记录扩写成完整经验 — LLM prompt (结构化 JSON 输出) */
 export function buildEvolvePrompt(c) {
-    return `你是经验总结专家。下面是 Bolloon 智能体在一轮运行中连续成功调用的工具记录 (已运行 ${c.runs || 1} 次)。
-
-工具记录:
-名称: ${c.name}
-描述: ${c.description}
-原始记录:
-${String(c.body || '').slice(0, 4000)}
-
-请把这份"工具调用记录"扩写成一份完整的、可复用的经验文档, 要求:
-1. name: 一个简短的小写英文名 (字母数字连字符, 概括这套操作)
-2. description: 一句话描述 (什么场景用)
-3. body: 完整经验正文, 按以下结构:
-   ## 背景 — 这套操作在什么场景下用, 解决什么问题
-   ## 触发条件 — 什么信号/需求出现时应该使用
-   ## 流程 — 具体步骤 (保留原始工具名), 每步说明目的
-   ## 注意事项 — 易错点 / 边界情况 / 已知坑
-   ## 验证 — 怎么确认结果正确
-
-只输出一个 JSON 对象, 不要任何其他文字:
+    return `你是经验总结专家。下面是 Bolloon 智能体在一轮运行中连续成功调用的工具记录 (已运行 ${c.runs || 1} 次)。
+
+工具记录:
+名称: ${c.name}
+描述: ${c.description}
+原始记录:
+${String(c.body || '').slice(0, 4000)}
+
+请把这份"工具调用记录"扩写成一份完整的、可复用的经验文档, 要求:
+1. name: 一个简短的小写英文名 (字母数字连字符, 概括这套操作)
+2. description: 一句话描述 (什么场景用)
+3. body: 完整经验正文, 按以下结构:
+   ## 背景 — 这套操作在什么场景下用, 解决什么问题
+   ## 触发条件 — 什么信号/需求出现时应该使用
+   ## 流程 — 具体步骤 (保留原始工具名), 每步说明目的
+   ## 注意事项 — 易错点 / 边界情况 / 已知坑
+   ## 验证 — 怎么确认结果正确
+
+只输出一个 JSON 对象, 不要任何其他文字:
 {"name": "...", "description": "...", "body": "..."}`;
 }
 /** 解析 LLM 返回的 JSON (容错: 剥 markdown 代码块, 取第一个 {...}) */

package/dist/agents/workflow-pivot-loop.js

@@ -876,8 +876,8 @@ export class WorkflowPivotLoop {
         //   完整重装只在 iter=1 和 compact 之后两次
         const lines = fullSystemPrompt.split('\n');
         const identityLine = lines.find((l) => l.includes('你是') && !l.includes('(续)')) ?? '';
-        return `[continuation] 你的 persona + tools + judgments 已在首轮 messageHistory 中.
-${identityLine ? identityLine + '\n' : ''}当前 step 别再读 persona 全文, 继续推进任务即可.
+        return `[continuation] 你的 persona + tools + judgments 已在首轮 messageHistory 中.
+${identityLine ? identityLine + '\n' : ''}当前 step 别再读 persona 全文, 继续推进任务即可.
 > <final gen> 只在真完成时输出.`;
     }
     /**

package/dist/agents/x402/x402Pay.js

@@ -216,6 +216,10 @@ export async function createX402PaymentFetch(params) {
         client.register(info.caip2, new ExactEvmScheme(signer));
         client.registerV1(info.v1, new ExactEvmScheme(signer));
     }
+    // @x402 2.25+ 新增 spendControls 默认白名单 (只放行各网络 default asset), 会拒掉
+    // USDC 等非默认代币的支付要求 → 关掉资产门禁, 恢复 2.21 语义 (额度上限仍由
+    // 上面的 registerPolicy / maxPaymentAmount 控制, 资产种类信任服务端 402 头声明)
+    client.setSpendControls(false);
     return wrapFetchWithPayment(params.fetchImpl || fetch, client);
 }
 function parseHumanTokenAmount(amount, decimals) {

package/dist/bollharness/src/scripts/deploy-guard.js

@@ -104,17 +104,17 @@ function checkRsync(cmd) {
 function block(reason, host = null) {
     let guidance;
     if (host === PROD_IP) {
-        guidance = `请使用标准部署流程：
-  后端: bash scripts/deploy.sh --yes
-  Demo 正式: bash scripts/deploy-demo.sh <name> --channel prod --yes
-  Demo 内测: bash scripts/deploy-demo.sh <name> --channel preview --yes
-  Edge/Nginx: bash scripts/deploy-edge.sh --yes
+        guidance = `请使用标准部署流程：
+  后端: bash scripts/deploy.sh --yes
+  Demo 正式: bash scripts/deploy-demo.sh <name> --channel prod --yes
+  Demo 内测: bash scripts/deploy-demo.sh <name> --channel preview --yes
+  Edge/Nginx: bash scripts/deploy-edge.sh --yes
 详见 Bolloon.md Development Commands。`;
     }
     else if (BRIDGE_VPS_HOSTS.includes(host ?? "")) {
-        guidance = `Bridge VPS 必须走 git pull 更新路径：
-  ssh root@${host} 'sudo -u boll git -C /opt/boll pull --ff-only'
-  scp/rsync 直传会重新制造 orphan worktree。
+        guidance = `Bridge VPS 必须走 git pull 更新路径：
+  ssh root@${host} 'sudo -u boll git -C /opt/boll pull --ff-only'
+  scp/rsync 直传会重新制造 orphan worktree。
   详见 docs/issues/guard-20260408-0445-bridge-vps-orphan-worktree.md。`;
     }
     else {