@bolloon/bolloon-agent 0.3.46 → 0.3.48

package/dist/agents/skill-organizer.js

@@ -0,0 +1,322 @@
+/**
+ * skill-organizer.ts — 自动整理心跳 (2026-08-10)
+ *
+ * 目的: 把"自动整理"变成 Bolloon 的心跳之一 (与社交心跳并列), 周期性做两件事:
+ *
+ *   A. 扫描 skills view (~/.bolloon/skills + <cwd>/.bolloon/skills), 找出"遗留下来的 skills 指导":
+ *      - 外部智能体迁移残留 (openclaw/hermes 迁移的 skills 展平为 `<分类>-<技能>`, 如 apple-* / creative-* / autonomous-ai-agents-*)
+ *      - 空 body / 无 description 的占位 skill
+ *      - status: archived 的归档残留
+ *      - 用户级与项目级同名重复
+ *   B. 经验进化 (完整总结, 不再只是记录使用什么工具): 读 run-end 候选, 用 LLM 把
+ *      "工具调用记录" 扩写成完整的经验文档 (背景/触发条件/流程/注意事项/验证), 转正为正式 skill.
+ *
+ * 设计原则 (compile-first / 可测):
+ *   - 所有目录/LLM 可注入 (home/cwd/llm), 测试用临时 HOME + mock LLM.
+ *   - runSkillOrganize 纯函数式: 输入候选 + 现有 skills, 输出进化结果 + 遗留报告, 不依赖网络.
+ *   - startOrganizeHeartbeat 提供 CLI/server 统一的心跳壳: interval + 重入锁 + onStart/onEnd/onError,
+ *     CLI 通过 onStart/onEnd 把显示接到颜文字行 (inkSetTransient), 结束后清空.
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { getUserSkillsDir, getProjectSkillsDir, sanitizeSkillName } from './skill-writer.js';
+/** 迁移来源分类前缀 — 这些是外部智能体 (openclaw/hermes 等) 迁移进来的 skills, 属于"遗留"候选 */
+const MIGRATED_PREFIXES = [
+    'apple-',
+    'autonomous-ai-agents-',
+    'creative-',
+    'data-science-',
+    'email-',
+    'github-',
+    'media-',
+    'mlops-',
+    'note-taking-',
+    'openclaw-imports-',
+    'productivity-',
+    'research-',
+    'smart-home-',
+    'social-media-',
+    'software-development-',
+];
+// ───────────────────────── A. 遗留 skills 扫描 ─────────────────────────
+/** 判定一个 skill 是否"遗留": 返回原因列表 (空数组 = 正常) */
+export function leftoverReasons(meta) {
+    const reasons = [];
+    const name = meta.name || '';
+    // 1. 迁移残留: 带外部智能体分类前缀
+    if (MIGRATED_PREFIXES.some((p) => name.startsWith(p))) {
+        reasons.push('迁移遗留 (外部智能体分类前缀)');
+    }
+    // 2. 占位: 无描述或正文过短
+    const desc = (meta.description || '').trim();
+    const body = (meta.body || '').trim();
+    if (!desc)
+        reasons.push('无 description');
+    if (body.length < 50)
+        reasons.push('正文过短 (疑似占位)');
+    // 3. 归档残留
+    if (meta.status === 'archived')
+        reasons.push('status=archived (归档残留)');
+    return reasons;
+}
+/** 扫描一个 skill 目录, 返回遗留报告 */
+export async function scanSkillDir(dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() || entry.name.startsWith('.'))
+            continue;
+        const skillFile = path.join(dir, entry.name, 'SKILL.md');
+        let raw = '';
+        try {
+            raw = await fs.readFile(skillFile, 'utf-8');
+        }
+        catch {
+            continue; // 没有 SKILL.md 不算 skill
+        }
+        const meta = parseSkillRaw(raw, entry.name);
+        const reasons = leftoverReasons(meta);
+        if (reasons.length > 0) {
+            out.push({ dir, name: meta.name, description: meta.description || '', reasons });
+        }
+    }
+    return out;
+}
+/** 轻量 frontmatter/正文解析 (不依赖 skill-loader, 避免循环依赖) */
+function parseSkillRaw(raw, fallbackName) {
+    let name = fallbackName;
+    let description = '';
+    let status = '';
+    let body = raw;
+    const fmMatch = raw.match(/^---\n([\s\S]*?)\n---\n?/);
+    if (fmMatch) {
+        body = raw.slice(fmMatch[0].length);
+        const fm = fmMatch[1];
+        const nameM = fm.match(/^name:\s*(.+)$/m);
+        const descM = fm.match(/^description:\s*(.+)$/m);
+        const statusM = fm.match(/^status:\s*(.+)$/m);
+        if (nameM)
+            name = nameM[1].trim();
+        if (descM)
+            description = descM[1].trim();
+        if (statusM)
+            status = statusM[1].trim();
+    }
+    return { name, description, status, body: body.trim() };
+}
+/** 扫描全部 skills view (用户级 + 项目级), 找同名重复 */
+export async function scanLeftoverSkills(opts = {}) {
+    const home = opts.home || os.homedir();
+    const cwd = opts.cwd || process.cwd();
+    const dirs = [getUserSkillsDir(home), getProjectSkillsDir(cwd)];
+    const found = new Map();
+    const seenNames = new Set();
+    for (const dir of dirs) {
+        const items = await scanSkillDir(dir);
+        for (const it of items) {
+            found.set(`${dir}::${it.name}`, it);
+        }
+        // 同名重复检测 (跨目录)
+        const names = (await fs.readdir(dir).catch(() => [])).filter((n) => !n.startsWith('.'));
+        for (const n of names) {
+            if (seenNames.has(n)) {
+                const dup = {
+                    dir,
+                    name: n,
+                    description: '同名 skill 已在其他目录存在',
+                    reasons: ['跨目录同名重复'],
+                };
+                found.set(`${dir}::dup::${n}`, dup);
+            }
+            seenNames.add(n);
+        }
+    }
+    return Array.from(found.values());
+}
+// ───────────────────────── 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 对象, 不要任何其他文字:
+{"name": "...", "description": "...", "body": "..."}`;
+}
+/** 解析 LLM 返回的 JSON (容错: 剥 markdown 代码块, 取第一个 {...}) */
+export function parseEvolveJson(raw) {
+    if (!raw)
+        return null;
+    const cleaned = raw.replace(/```(?:json)?/g, '').trim();
+    const m = cleaned.match(/\{[\s\S]*\}/);
+    if (!m)
+        return null;
+    try {
+        const obj = JSON.parse(m[0]);
+        return {
+            name: typeof obj.name === 'string' ? obj.name : undefined,
+            description: typeof obj.description === 'string' ? obj.description : undefined,
+            body: typeof obj.body === 'string' ? obj.body : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** 完整经验进化: 候选 → LLM 总结 → 正式 skill (转正 + 清理候选). 返回转正 skill 名列表 */
+export async function evolveCandidates(opts) {
+    const { listSkillCandidates, writeSkillCandidate } = await import('./skill-writer.js');
+    const home = opts.home || os.homedir();
+    const cands = await listSkillCandidates(home);
+    const evolved = [];
+    const max = opts.maxEvolve ?? 3;
+    // 优先进化 runs 多的 (更可能可复用)
+    const sorted = [...cands].sort((a, b) => (b.runs ?? 1) - (a.runs ?? 1)).slice(0, max);
+    for (const c of sorted) {
+        try {
+            const raw = await opts.llm(buildEvolvePrompt(c));
+            const parsed = parseEvolveJson(raw);
+            if (!parsed?.body || parsed.body.trim().length < 50) {
+                // LLM 输出不可用 → 保留候选, 记录一次失败 (不转正)
+                await writeSkillCandidate({
+                    ...c,
+                    body: `${c.body}\n- ${new Date().toISOString().slice(0, 16)} ${opts.source || 'organize'}: LLM 总结失败, 保留待人工`,
+                }).catch(() => { });
+                continue;
+            }
+            const { createSkill } = await import('./skill-writer.js');
+            const safeName = sanitizeSkillName(parsed.name || c.name) || sanitizeSkillName(c.name);
+            const r = await createSkill(safeName, parsed.description || c.description, parsed.body, {
+                status: 'active',
+                triggers: c.description ? [c.description.slice(0, 60)] : undefined,
+            });
+            if (!r.ok)
+                continue;
+            evolved.push(safeName);
+            // 转正成功 → 清理候选文件
+            const { listSkillCandidates: listAgain } = await import('./skill-writer.js');
+            const after = await listAgain(home);
+            for (const cc of after) {
+                if (cc.file && (cc.name === c.name || sanitizeSkillName(cc.name) === sanitizeSkillName(c.name))) {
+                    await fs.rm(cc.file, { force: true }).catch(() => { });
+                }
+            }
+        }
+        catch {
+            /* 单个候选失败不阻塞整轮 */
+        }
+    }
+    return { evolved, scanned: cands.length };
+}
+/** 自动整理主流程: 遗留扫描 (必做) + 经验进化 (有 LLM 时) */
+export async function runSkillOrganize(opts = {}) {
+    const evolve = opts.evolve ?? true;
+    const result = { scannedCandidates: 0, evolved: [], leftovers: [] };
+    try {
+        result.leftovers = await scanLeftoverSkills({ home: opts.home, cwd: opts.cwd });
+    }
+    catch (e) {
+        result.error = `遗留扫描失败: ${e?.message || String(e)}`;
+    }
+    if (evolve && opts.llm) {
+        try {
+            const { evolved, scanned } = await evolveCandidates({
+                llm: opts.llm,
+                source: opts.source,
+                home: opts.home,
+                maxEvolve: opts.maxEvolve,
+            });
+            result.evolved = evolved;
+            result.scannedCandidates = scanned;
+        }
+        catch (e) {
+            result.error = `${result.error ? result.error + '; ' : ''}经验进化失败: ${e?.message || String(e)}`;
+        }
+    }
+    else {
+        try {
+            const { listSkillCandidates } = await import('./skill-writer.js');
+            result.scannedCandidates = (await listSkillCandidates(opts.home || os.homedir())).length;
+        }
+        catch {
+            result.scannedCandidates = 0;
+        }
+    }
+    return result;
+}
+/** 自动整理总入口 (2026-08-10): skills 整理 (遗留扫描 + 经验进化) + 知识层整理 (9 类) */
+export async function runAutoOrganize(opts = {}) {
+    const result = await runSkillOrganize(opts);
+    try {
+        const { runKnowledgeOrganize } = await import('./knowledge-organizer.js');
+        result.knowledge = await runKnowledgeOrganize({ home: opts.home, cwd: opts.cwd, llm: opts.llm });
+    }
+    catch (e) {
+        result.error = `${result.error ? result.error + '; ' : ''}知识层整理失败: ${e?.message || String(e)}`;
+    }
+    return result;
+}
+/** 自动整理心跳: 定时触发整理, 带重入锁 (上一轮没跑完不重复触发) */
+export function startOrganizeHeartbeat(opts) {
+    const intervalMs = opts.intervalMs ?? 30 * 60_000;
+    let timer = null;
+    let stopped = false;
+    let running = false;
+    const runOnce = async () => {
+        if (running || stopped)
+            return null;
+        running = true;
+        try {
+            opts.onStart?.();
+            const r = await opts.run();
+            opts.onEnd?.(r);
+            return r;
+        }
+        catch (e) {
+            opts.onError?.(e instanceof Error ? e : new Error(String(e)));
+            return null;
+        }
+        finally {
+            running = false;
+        }
+    };
+    const schedule = () => {
+        if (stopped)
+            return;
+        timer = setTimeout(async () => {
+            await runOnce();
+            schedule();
+        }, intervalMs);
+    };
+    schedule();
+    return {
+        stop() {
+            stopped = true;
+            if (timer)
+                clearTimeout(timer);
+            timer = null;
+        },
+        runOnce,
+    };
+}

package/dist/bootstrap/context-os.js

@@ -48,7 +48,16 @@ const LAYER_KEYS = new Set(CONTEXT_OS_LAYERS.map((l) => l.key));
 export function getContextOsRoot(home = os.homedir()) {
     return path.join(home, '.bolloon', 'context-os');
 }
-export function getLayerDir(layer, home = os.homedir()) {
+/**
+ * 2026-08-09: 层目录 — 支持按 agentId 分区 (每个智能体独立 Context OS).
+ *   agentId 有值 → ~/.bolloon/context-os/<sanitizeAgentId>/<layer>
+ *   agentId 空   → ~/.bolloon/context-os/<layer> (旧全局路径, 兼容)
+ */
+export function getLayerDir(layer, home = os.homedir(), agentId) {
+    const safeId = String(agentId || '').replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
+    if (safeId) {
+        return path.join(getContextOsRoot(home), safeId, layer);
+    }
     return path.join(getContextOsRoot(home), layer);
 }
 /** 校验 layer 合法; 非法返回 null */
@@ -86,11 +95,11 @@ ${l.usage}
 → 阶段2 固化 (本层唯一位置) → 阶段3 索引化 (高频引用) → 阶段4 归档/删除.
 `;
 }
-export async function ensureContextOsDirs(home) {
+export async function ensureContextOsDirs(home, agentId) {
     const root = getContextOsRoot(home);
     await fs.mkdir(root, { recursive: true });
     for (const l of CONTEXT_OS_LAYERS) {
-        const dir = getLayerDir(l.key, home);
+        const dir = getLayerDir(l.key, home, agentId);
         await fs.mkdir(dir, { recursive: true });
         const readmePath = path.join(dir, 'README.md');
         try {
@@ -106,7 +115,7 @@ export async function ensureContextOsDirs(home) {
  * 文件名: <ts>-<slug>.md; frontmatter v2 (stage0 = 临时价值点, 待验证).
  * 幂等: 同层同 slug 已存在 → 跳过 (不重复造文件, Context OS §6 Step3).
  */
-export async function writeContextAsset(input, home) {
+export async function writeContextAsset(input, home, agentId) {
     const layer = resolveLayer(input.layer);
     if (!layer) {
         return { ok: false, error: `layer 非法: '${input.layer}'. 合法: ${CONTEXT_OS_LAYERS.map((l) => l.key).join(' / ')}` };
@@ -117,15 +126,15 @@ export async function writeContextAsset(input, home) {
     const content = String(input.content || '').trim();
     if (!content)
         return { ok: false, error: 'content 必填' };
-    await ensureContextOsDirs(home);
+    await ensureContextOsDirs(home, agentId);
     const now = new Date().toISOString();
     const ts = Date.now();
     const slug = slugify(title);
     const fileName = `${ts}-${slug}.md`;
-    const filePath = path.join(getLayerDir(layer.key, home), fileName);
+    const filePath = path.join(getLayerDir(layer.key, home, agentId), fileName);
     // 幂等: 同 slug 已存在 → 跳过
     try {
-        const files = await fs.readdir(getLayerDir(layer.key, home));
+        const files = await fs.readdir(getLayerDir(layer.key, home, agentId));
         if (files.some((f) => f.endsWith(`-${slug}.md`))) {
             return { ok: true, skipped: true, error: `同标题资产已存在 (${slug}.md), 未重复写入` };
         }
@@ -157,7 +166,7 @@ export async function writeContextAsset(input, home) {
     }
 }
 /** 列出层资产; layer 为空 → 全层汇总 */
-export async function readContextAssets(layer, keyword, home) {
+export async function readContextAssets(layer, keyword, home, agentId) {
     const root = getContextOsRoot(home);
     const kw = String(keyword || '').trim().toLowerCase();
     const wanted = layer ? [resolveLayer(layer)].filter(Boolean).map((l) => l.key) : CONTEXT_OS_LAYERS.map((l) => l.key);
@@ -165,11 +174,11 @@ export async function readContextAssets(layer, keyword, home) {
     for (const key of wanted) {
         const l = resolveLayer(key);
         try {
-            const files = (await fs.readdir(getLayerDir(key, home))).filter((f) => f.endsWith('.md') && f !== 'README.md');
+            const files = (await fs.readdir(getLayerDir(key, home, agentId))).filter((f) => f.endsWith('.md') && f !== 'README.md');
             const entries = [];
             for (const f of files) {
                 try {
-                    const raw = await fs.readFile(path.join(getLayerDir(key, home), f), 'utf-8');
+                    const raw = await fs.readFile(path.join(getLayerDir(key, home, agentId), f), 'utf-8');
                     const titleM = raw.match(/^title:\s*(.+)$/m);
                     const createdM = raw.match(/^created:\s*(.+)$/m);
                     const title = titleM ? titleM[1].trim() : f.replace(/\.md$/, '');

package/dist/cli/ink-app.js

@@ -54,6 +54,9 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
     const [status, setStatus] = useState(initialStatus);
     const { exit } = useApp();
     const [thinking, setThinking] = useState(false);
+    // 2026-08-10: 临时状态行 (自动整理心跳/run-end 经验整理用) — 显示在颜文字行位置,
+    //   结束后设 null 即清空 (显示为空). 不进入消息历史, 不会残留显示效果.
+    const [transient, setTransient] = useState(null);
     const thinkingIdx = useRef(0);
     // 双击 Esc 退出当前进程 (500ms 窗口内第二次按下)
     const lastEscRef = useRef(0);
@@ -286,10 +289,15 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         globalThis.__inkSetStatus = (s) => {
             setStatus(s);
         };
+        // 2026-08-10: 临时状态行 (自动整理/经验整理): 传字符串显示, 传 null 清空 (显示为空)
+        globalThis.__inkSetTransient = (v) => {
+            setTransient(v === undefined ? null : v);
+        };
         return () => {
             delete globalThis.__inkAppend;
             delete globalThis.__inkSetStatus;
             delete globalThis.__inkSetThinking;
+            delete globalThis.__inkSetTransient;
         };
     }, []);
     const onSubmit = useCallback((value) => {
@@ -539,7 +547,7 @@ const InkApp = ({ onPrompt, initialStatus, getStatusUpdate, terminalW, terminalH
         }, 600);
         return () => clearInterval(timer);
     }, [thinking]);
-    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(LogoBox, { width: terminalW }), _jsx(Messages, { msgs: msgs }), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), picker && (_jsx(MentionPopup, { title: picker.title, items: picker.items, sel: Math.min(picker.sel, picker.items.length - 1), width: terminalW })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "#c4d640", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen && !picker, placeholder: "\u8F93\u5165\u6D88\u606F... @\u667A\u80FD\u4F53 /\u547D\u4EE4 #\u6587\u4EF6 \u00B7 Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", height: "100%", children: [_jsxs(Box, { flexGrow: 1, flexDirection: "column", justifyContent: "flex-start", children: [_jsx(LogoBox, { width: terminalW }), _jsx(Messages, { msgs: msgs }), thinking && (_jsx(Box, { children: _jsxs(Text, { color: "yellow", children: [KAOMOJI[thinkingIdx.current], " \u601D\u8003\u4E2D..."] }) })), transient && (_jsx(Box, { children: _jsx(Text, { children: transient }) }))] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), _jsx(Box, { children: _jsx(Text, { children: status }) }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) }), popupOpen && (tabState || mention) && (_jsx(MentionPopup, { title: popupTitle, items: filtered, sel: safeSel, width: terminalW, loading: loadingFiles })), picker && (_jsx(MentionPopup, { title: picker.title, items: picker.items, sel: Math.min(picker.sel, picker.items.length - 1), width: terminalW })), _jsxs(Box, { children: [_jsx(Text, { bold: true, color: "#c4d640", children: "\u276F " }), _jsx(TextInput, { value: input, onChange: setInput, onSubmit: onSubmit, focus: !popupOpen && !picker, placeholder: "\u8F93\u5165\u6D88\u606F... @\u667A\u80FD\u4F53 /\u547D\u4EE4 #\u6587\u4EF6 \u00B7 Esc \u53CC\u51FB\u9000\u51FA \u00B7 /queue \u6392\u961F \u00B7 !\u7EC8\u7AEF\u547D\u4EE4" }, tiKey)] }), _jsx(Box, { children: _jsx(Text, { bold: true, color: "#c4d640", children: '─'.repeat(terminalW) }) })] }));
 };
 export { InkApp };
 // ─── 启动 ────────────────────────────────────────────────────────────────────
@@ -576,3 +584,9 @@ export function inkSetThinking(v) {
     if (fn)
         fn(v);
 }
+/** 2026-08-10: 设置/清除临时状态行 (自动整理/经验整理). 传 null 清空 → 显示为空 */
+export function inkSetTransient(v) {
+    const fn = globalThis.__inkSetTransient;
+    if (fn)
+        fn(v);
+}

package/dist/cli/loading-tui.js

@@ -45,14 +45,20 @@ function getPackageVersion() {
     }
 }
 const BOLLOON_VERSION = getPackageVersion();
-// ── 品牌图标: 顶部带圆标注的 0 (气球) ──────────────
+// ── 品牌图标: 笑脸机器人 (2026-08-09, bolloon 色系填充) ──────
+//   头: 主色边框 + 亮绿填充 (C_ACCENT_BG); 眼睛 ◉ / 嘴 ◡ 用亮色填充;
+//   末行 BOLLOON 主色艺术字 (仅 printBanner 用, brandArtLines 会裁掉避免双 logo).
+const ROBOT_HEAD = [
+    `${C_ACCENT}   ╭───────╮${RESET}`,
+    `${C_ACCENT} ╭─╯${C_ACCENT_BG}  ${C_WHITE}◉${C_ACCENT_BG} ${C_WHITE}◉${C_ACCENT_BG}  ${RESET}${C_ACCENT}╰─╮${RESET}`,
+    `${C_ACCENT} │${C_ACCENT_BG}     ${C_WHITE}◡${C_ACCENT_BG}     ${RESET}${C_ACCENT}│${RESET}`,
+    `${C_ACCENT} ╰─╮${C_ACCENT_BG}       ${RESET}${C_ACCENT}╭─╯${RESET}`,
+    `${C_ACCENT}   ╰───┬───╯${RESET}`,
+    `${C_ACCENT}       │${RESET}`,
+];
 export const BOLLOON_ICON = [
-    `${C_ACCENT}        ✦${RESET}`,
-    `${C_ACCENT}      ╱ ╲${RESET}`,
-    `${C_ACCENT}  ════◆════${RESET}`,
-    `${C_ACCENT}      ╲ ╱${RESET}`,
-    `${C_ACCENT}       ╲${RESET}`,
-    `${C_ACCENT}    ✦  ╲${RESET}`,
+    ...ROBOT_HEAD,
+    `${C_ACCENT}${BOLD}     BOLLOON${RESET}`,
 ].join('\n');
 // ── 艺术字: BOLLOON (box 字体) + Bolloon Agent 副标题 ──
 export const BOLLOON_BANNER = [
@@ -64,9 +70,10 @@ export const BOLLOON_BANNER = [
     `${C_TEXT}${BOLD}╚═════╝  ╚═════╝ ╚══════╝╚══════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝${RESET}`,
     `${C_DIM}Bolloon Agent v${BOLLOON_VERSION}${RESET}`,
 ].join('\n');
-/** 艺术字全部行 (图标在左, BOLLOON 艺术字在右), 供框内渲染 */
+/** 艺术字全部行 (机器人头在左, BOLLOON 艺术字在右), 供框内渲染 */
 export function brandArtLines() {
-    const icon = BOLLOON_ICON.split('\n');
+    // 2026-08-09: icon 只取机器人头 (裁掉末行 BOLLOON 文字), 避免和右侧 banner 双 logo
+    const icon = ROBOT_HEAD;
     const banner = BOLLOON_BANNER.split('\n');
     const gap = 2;
     const iconW = Math.max(1, ...icon.map(l => dispWidth(l)));
@@ -81,8 +88,9 @@ export function brandArtLines() {
     return rows;
 }
 export function printBanner(version) {
+    // 2026-08-09: 新品牌 logo = 笑脸机器人 (BOLLOON_ICON 自带 BOLLOON 文字),
+    //   不再叠加旧 box 字体 banner (避免双 logo)
     console.log(BOLLOON_ICON);
-    console.log(BOLLOON_BANNER);
     if (version)
         console.log(`${C_DIM}  Bolloon Agent v${version}${RESET}`);
     console.log(`${C_DIM}  P2P AI Agent · 文档智能体${RESET}`);