@bolloon/bolloon-agent 0.3.38 → 0.3.41

package/dist/llm/tool-manifest/index.js

@@ -48,65 +48,6 @@ export function getToolsByLayer(layerId) {
  *
  * 不包含: 完整 parameters schema (那是 PiAI 客户端在调用时读)
  */
-/**
- * 把 ToolManifest 转成 OpenAI function calling 格式 (tools 数组)
- * 用于 native tool_choice: "auto" 模式, 让 LLM 选择调用.
- *
- * 注意: 递归处理嵌套参数 (type='object' 的 properties / type='array' 的 items)
- */
-export function formatForOpenAI(tools) {
-    const list = tools ?? ALL;
-    return list.map((t) => {
-        const properties = {};
-        const required = [];
-        for (const p of t.parameters) {
-            properties[p.name] = convertParameter(p);
-            if (p.required)
-                required.push(p.name);
-        }
-        return {
-            type: 'function',
-            function: {
-                name: t.id,
-                description: t.oneLine,
-                parameters: {
-                    type: 'object',
-                    properties,
-                    required,
-                },
-            },
-        };
-    });
-}
-function convertParameter(p) {
-    const schema = { type: p.type === 'enum' ? 'string' : p.type };
-    if (p.description)
-        schema.description = p.description;
-    if (p.enumValues)
-        schema.enum = p.enumValues;
-    if (p.default !== undefined)
-        schema.default = p.default;
-    if (p.minimum !== undefined)
-        schema.minimum = p.minimum;
-    if (p.maximum !== undefined)
-        schema.maximum = p.maximum;
-    if (p.format)
-        schema.format = p.format;
-    if (p.type === 'object' && p.properties) {
-        schema.properties = {};
-        for (const sub of p.properties) {
-            schema.properties[sub.name] = convertParameter(sub);
-        }
-    }
-    if (p.type === 'array' && p.items) {
-        schema.items = convertParameter(p.items);
-        if (p.minItems !== undefined)
-            schema.minItems = p.minItems;
-        if (p.maxItems !== undefined)
-            schema.maxItems = p.maxItems;
-    }
-    return schema;
-}
 export function formatForPrompt(tools) {
     const list = tools ?? ALL;
     const lines = [

package/dist/llm/tool-manifest/mcp.js

@@ -15,7 +15,7 @@ export const search_mcp_registry = {
     parameters: [
         { name: 'keywords', type: 'array', required: true, description: '搜索关键词', minItems: 1, items: { name: 'kw', type: 'string', required: true, description: '关键词' } }
     ],
-    callExample: `[TOOL:search_mcp_registry]
+    callExample: `[TOOL:search_mcp_registry]
 [P:keywords]${'${'}JSON.stringify(["calendar","schedule"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };
@@ -37,7 +37,7 @@ export const suggest_connectors = {
     parameters: [
         { name: 'uuids', type: 'array', required: true, description: '从 search_mcp_registry 结果的 directoryUuid 复制', minItems: 1, items: { name: 'u', type: 'string', required: true, description: 'uuid' } }
     ],
-    callExample: `[TOOL:suggest_connectors]
+    callExample: `[TOOL:suggest_connectors]
 [P:uuids]${'${'}JSON.stringify(["uuid-from-search-result"])[ENDTOOL]`,
     layerId: 'tool.mcp_apps',
 };

package/dist/llm/tool-manifest/message_compose.js

@@ -23,9 +23,9 @@ export const message_compose_v1 = {
                 ],
             } },
     ],
-    callExample: `[TOOL:message_compose_v1]
-[P:kind]email
-[P:summary_title]Follow-up on Q3 review
+    callExample: `[TOOL:message_compose_v1]
+[P:kind]email
+[P:summary_title]Follow-up on Q3 review
 [P:variants]${'${'}JSON.stringify([{"label":"direct","subject":"Quick follow-up","body":"..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/places.js

@@ -23,7 +23,7 @@ export const places_search = {
         { name: 'location_bias_lng', type: 'number', required: false, description: '可选经度' },
         { name: 'location_bias_radius', type: 'number', required: false, description: '米 (默认 5000)', default: 5000 }
     ],
-    callExample: `[TOOL:places_search]
+    callExample: `[TOOL:places_search]
 [P:queries]${'${'}JSON.stringify([{"query":"ramen restaurants Tokyo"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };
@@ -77,7 +77,7 @@ export const places_map_display_v0 = {
         { name: 'title', type: 'string', required: false, description: '行程标题' },
         { name: 'narrative', type: 'string', required: false, description: '行程叙述' },
     ],
-    callExample: `[TOOL:places_map_display_v0]
+    callExample: `[TOOL:places_map_display_v0]
 [P:locations]${'${'}JSON.stringify([{"name":"Senso-ji","latitude":35.7148,"longitude":139.7967,"place_id":"ChIJ..."}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/present_files.js

@@ -15,7 +15,7 @@ export const present_files = {
     parameters: [
         { name: 'filepaths', type: 'array', required: true, description: '至少 1 个文件路径', minItems: 1, items: { name: 'path', type: 'string', required: true, description: '容器内路径' } },
     ],
-    callExample: `[TOOL:present_files]
+    callExample: `[TOOL:present_files]
 [P:filepaths]${'${'}JSON.stringify(["/home/bolloon/report.md"])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/recipe.js

@@ -33,8 +33,8 @@ export const recipe_display_v0 = {
             } },
         { name: 'notes', type: 'string', required: false, description: '附加说明' },
     ],
-    callExample: `[TOOL:recipe_display_v0]
-[P:title]Pasta
+    callExample: `[TOOL:recipe_display_v0]
+[P:title]Pasta
 [P:ingredients]${'${'}JSON.stringify([{"id":"a1","amount":500,"name":"pasta"}])[ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/str_replace.js

@@ -17,11 +17,11 @@ export const str_replace = {
         { name: 'new_str', type: 'string', required: true, description: '新字符串 (空字符串 = 删除)', default: '' },
         { name: 'path', type: 'string', required: true, description: '文件路径' },
     ],
-    callExample: `[TOOL:str_replace]
-[P:description]修复 typo
-[P:old_str]recieve
-[P:new_str]receive
-[P:path]/home/bolloon/main.py
+    callExample: `[TOOL:str_replace]
+[P:description]修复 typo
+[P:old_str]recieve
+[P:new_str]receive
+[P:path]/home/bolloon/main.py
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/view.js

@@ -16,9 +16,9 @@ export const view = {
         { name: 'path', type: 'string', required: true, description: '绝对路径' },
         { name: 'view_range', type: 'array', required: false, description: '[start, end] 1-indexed, end=-1 表示到末尾', minItems: 2, maxItems: 2, items: { name: 'r', type: 'integer', required: true, description: '行号' } }
     ],
-    callExample: `[TOOL:view]
-[P:description]读 README
-[P:path]/home/bolloon/README.md
+    callExample: `[TOOL:view]
+[P:description]读 README
+[P:path]/home/bolloon/README.md
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/weather.js

@@ -18,10 +18,10 @@ export const weather_fetch = {
         { name: 'latitude', type: 'number', required: true, description: '纬度' },
         { name: 'longitude', type: 'number', required: true, description: '经度' },
     ],
-    callExample: `[TOOL:weather_fetch]
-[P:location_name]San Francisco, CA
-[P:latitude]37.78
-[P:longitude]-122.41
+    callExample: `[TOOL:weather_fetch]
+[P:location_name]San Francisco, CA
+[P:latitude]37.78
+[P:longitude]-122.41
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/llm/tool-manifest/web.js

@@ -15,8 +15,8 @@ export const web_search = {
     parameters: [
         { name: 'query', type: 'string', required: true, description: '搜索查询 (1-6 词最佳)' },
     ],
-    callExample: `[TOOL:web_search]
-[P:query]S&P 500 current price
+    callExample: `[TOOL:web_search]
+[P:query]S&P 500 current price
 [ENDTOOL]`,
     layerId: 'tool.web_search',
 };
@@ -44,8 +44,8 @@ export const web_fetch = {
         { name: 'web_fetch_rate_limit_key', type: 'string', required: false, description: '速率限制键' },
         { name: 'web_fetch_rate_limit_dark_launch', type: 'boolean', required: false, description: '速率限制暗启动模式' },
     ],
-    callExample: `[TOOL:web_fetch]
-[P:url]https://example.com/article
+    callExample: `[TOOL:web_fetch]
+[P:url]https://example.com/article
 [ENDTOOL]`,
     layerId: 'tool.manifest',
 };

package/dist/migration/external-agent-migrator.js

@@ -0,0 +1,405 @@
+/**
+ * migration/external-agent-migrator.ts — 把本机 OpenClaw / Hermes 的智能体数据
+ *   按相同格式整理进 Bolloon 系统路径, 实现"无缝兼容" (性格 / 记忆 / 技能 / 文档).
+ *
+ * 动机 (2026-08-08, v0.3.39):
+ *   - 用户在本机用 OpenClaw / Hermes 设计了智能体 (人格文档 + 技能 + 记忆 + 文档).
+ *   - Bolloon 初始化加载时, 希望把这些"别人的系统"的数据按 Bolloon 的既有格式
+ *     (persona 6 文件 / SKILL.md / memory sessions / context-os 资产) 迁移进来,
+ *     这样 Bolloon 能直接加载同一套性格 / 记忆 / 技能, 无缝兼容.
+ *   - 隐式处理: 启动时静默跑, 失败不影响主流程; 完成后通告给用户 (见 report).
+ *
+ * 异构布局 (2026-08-08 v0.3.40):
+ *   - OpenClaw 平铺在 ~/.openclaw/workspace/ (SOUL/IDENTITY/USER/AGENTS/TOOLS/MEMORY.md +
+ *     skills/<name>/ + memory/*.md)
+ *   - Hermes 根在 %LOCALAPPDATA%\hermes (Windows, 兜底 ~/.hermes), persona 分布在
+ *     SOUL.md(根) + memories/{USER,MEMORY}.md, skills 是 skills/<分类>/<技能>/SKILL.md
+ *     两级嵌套 (235 个). 迁移时展平并以 <分类>-<技能> 命名避免重名冲突.
+ *
+ * 幂等: 每个源落一份 manifest (~/.bolloon/migration/<source>.json),
+ *   记录已迁移的文件 hash; 未变化则跳过, 已存在则覆盖源文档 (文档允许演进),
+ *   技能只复制新增/变化的 (不删除目标已存在但源已删的, 保守).
+ *
+ * 安全: 不读取/复制 API key 类文件 (credentials/identity/*auth*), 不碰 secret.
+ *
+ * 设计范式: 与 external-engines/discovery.ts 一致 — 纯函数 + 可注入 deps, 便于单测.
+ */
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { sanitizeAgentId } from '../bootstrap/persona-loader.js';
+// ============================================================
+// 默认 deps (真实 IO)
+// ============================================================
+function realReadFile(p) {
+    return fs.readFile(p, 'utf-8').then((c) => c).catch(() => undefined);
+}
+function realReaddir(dir) {
+    return fs.readdir(dir).then((c) => c).catch(() => undefined);
+}
+function realStat(p) {
+    return fs.stat(p).then((s) => ({ isDirectory: s.isDirectory(), isFile: s.isFile(), mtimeMs: s.mtimeMs })).catch(() => undefined);
+}
+function realExists(p) {
+    return fs.access(p).then(() => true).catch(() => false);
+}
+export function defaultDeps() {
+    const home = os.homedir();
+    return {
+        home,
+        platform: os.platform(),
+        localAppData: (typeof process !== 'undefined' && process.env && (process.env.LOCALAPPDATA || process.env.ProgramData))
+            ? (process.env.LOCALAPPDATA || process.env.ProgramData)
+            : path.join(home, 'AppData', 'Local'),
+        readFile: realReadFile,
+        readdir: realReaddir,
+        stat: realStat,
+        mkdir: async (p) => { await fs.mkdir(p, { recursive: true }); },
+        copyFile: (f, t) => fs.copyFile(f, t),
+        writeFile: (p, d) => fs.writeFile(p, d, 'utf-8'),
+        exists: realExists,
+    };
+}
+// ============================================================
+// 纯函数: 目录布局 + hash
+// ============================================================
+/** 各源默认根目录: openclaw 在 home/.openclaw; hermes 兜底 home/.hermes (真实见 candidates) */
+export function sourceRootPath(source, home) {
+    return source === 'openclaw'
+        ? path.join(home, '.openclaw')
+        : path.join(home, '.hermes');
+}
+/**
+ * 各源全部候选根路径 (按优先级, 遍历时取第一个存在者).
+ *
+ * 覆盖三大平台的实际安装位置:
+ *   OpenClaw: 主目录 ~/.openclaw (三平台一致), 兜底 ~/.config/openclaw
+ *   Hermes :
+ *     - win32   %LOCALAPPDATA%\hermes  → ~/.hermes
+ *     - darwin  ~/Library/Application Support/hermes  → ~/.hermes
+ *     - linux   ~/.local/share/hermes  → ~/.config/hermes  → ~/.hermes
+ */
+export function sourceRootCandidates(source, deps) {
+    const home = deps.home;
+    const platform = deps.platform || 'linux';
+    if (source === 'openclaw') {
+        return [
+            path.join(home, '.openclaw'),
+            path.join(home, '.config', 'openclaw'),
+        ];
+    }
+    const candidates = [];
+    if (platform === 'win32') {
+        if (deps.localAppData)
+            candidates.push(path.join(deps.localAppData, 'hermes'));
+    }
+    else if (platform === 'darwin') {
+        candidates.push(path.join(home, 'Library', 'Application Support', 'hermes'));
+    }
+    else {
+        candidates.push(path.join(home, '.local', 'share', 'hermes'));
+        candidates.push(path.join(home, '.config', 'hermes'));
+    }
+    candidates.push(path.join(home, '.hermes'));
+    return candidates;
+}
+/** workspace 路径 (openclaw 用 workspace/, hermes 平铺在根) */
+export function workspacePath(source, sourceRoot) {
+    return source === 'openclaw'
+        ? path.join(sourceRoot, 'workspace')
+        : sourceRoot;
+}
+/** 计算文件内容 hash (幂等用) */
+export function sha1(content) {
+    return crypto.createHash('sha1').update(content).digest('hex');
+}
+/**
+ * 内容级脱敏: 抹掉明敏凭据, 防止迁移产物把真实的 Bearer token / API key /
+ * MT5 会话标识 / 长随机串 带进 Bolloon 落盘. 迁移只搬运"知识", 不搬运"秘密".
+ *
+ * 处理模式:
+ *   - Authorization / Bearer <token>
+ *   - token: / api_key: / access_token: / secret: 等 key 声明后的随机串
+ *   - 形如 sk-... / ghp_... / AKIA... 的 platform token
+ *   - 一行冒号后跟 20+ 位 base64/hex 随机串 ("MT5 data: D0E8...", "token: Ab...")
+ *
+ * 保留中文句子与结构说明, 只替换被判定为凭据的 token 片段.
+ */
+export function redactSecrets(text) {
+    const REDACTED = '***REDACTED***';
+    let out = text;
+    // 0. Bearer <JWT/base64> / Authorization: Bearer ... — 最优先, 连同包头一起抹
+    out = out.replace(/\bBearer\s+[A-Za-z0-9_./\-=+]{12,}/gi, REDACTED);
+    out = out.replace(/\bAuthorization\s*[:=]\s*(?:Bearer\s+)?[A-Za-z0-9_./\-=+]{12,}/gi, REDACTED);
+    // 1. explicit key=value 声明 (token/apiKey/access_token/key/secret/password)
+    out = out.replace(/\b(token|api[_-]?key|access[_-]?token|secret|password)\b\s*[:=]\s*["']?[A-Za-z0-9_./+\-]{8,}["']?/gi, (_m, k) => `${k}: ${REDACTED}`);
+    // 2. platform 前缀 token (sk- / sk-proj- / sk-ant- / ghp_ / AKIA / xoxb-)
+    out = out.replace(/\b(sk-[A-Za-z0-9_]{8,}|sk-proj-[A-Za-z0-9_-]{8,}|sk-ant-[A-Za-z0-9_-]{8,}|ghp_[A-Za-z0-9]{20,}|AKIA[0-9A-Z]{16}|xox[bp]-[A-Za-z0-9-]{8,})\b/g, REDACTED);
+    // 3. "标签: <20+位随机串>" 结构 — 冒号后跟长的 alnum token (MT5 data: D0E8...).
+    //    保守: 只匹配不含 `/`(避开 URL/路径) 且不含域名点 的纯 token 骨架.
+    out = out.replace(/([A-Za-z][A-Za-z0-9 _-]{0,20})\s*[:：]\s*([A-Za-z0-9_+\-]{20,})\b(?![A-Za-z0-9])/g, (_m, name) => `${name}: ${REDACTED}`);
+    // 4. 宽松: 独立长串 24+ (base64) — 前后为空白/标点/行首行尾, 避开 URL 与中文段.
+    //    保守: 不含 `/` 与 `.`, 防误伤 URL/域名/路径.
+    out = out.replace(/(^|[\s(（[:：\]）])[A-Za-z0-9_+=]{22,}(?=[\s)）\].,，。；;:：§]|$)/gm, (_m, prefix) => `${prefix}${REDACTED}`);
+    return out;
+}
+/** bolloon 目标根 (默认 ~/.bolloon, 可注入 override) */
+function bolloonRoot(home) {
+    return path.join(home, '.bolloon');
+}
+// ============================================================
+// 单文件迁移 helper
+// ============================================================
+async function copyIfNeeded(deps, from, to, manifest, redact = false) {
+    const content = await deps.readFile(from);
+    if (content === undefined)
+        return false;
+    const contentOut = redact ? redactSecrets(content) : content;
+    const hash = sha1(contentOut);
+    if (manifest.get(to) === hash)
+        return false; // 未变化, 跳过
+    await deps.mkdir(path.dirname(to));
+    await deps.writeFile(to, contentOut);
+    manifest.set(to, hash);
+    return true;
+}
+async function copyDirIfNeeded(deps, srcDir, destDir, manifest) {
+    const copied = [];
+    const entries = await deps.readdir(srcDir);
+    if (!entries)
+        return copied;
+    for (const name of entries) {
+        const s = path.join(srcDir, name);
+        const st = await deps.stat(s);
+        if (!st)
+            continue;
+        if (st.isDirectory) {
+            copied.push(...await copyDirIfNeeded(deps, s, path.join(destDir, name), manifest));
+        }
+        else if (st.isFile) {
+            const to = path.join(destDir, name);
+            if (await copyIfNeeded(deps, s, to, manifest))
+                copied.push(name);
+        }
+    }
+    return copied;
+}
+// ============================================================
+// 主迁移
+// ============================================================
+/** 探测某源是否安装: 返回选中的根目录 or null. */
+export async function detectSource(deps, source) {
+    for (const root of sourceRootCandidates(source, deps)) {
+        const st = await deps.stat(root);
+        if (st?.isDirectory)
+            return root;
+    }
+    return null;
+}
+const OPENCLAW_PERSONA = [
+    { src: 'SOUL.md', toName: 'soul.md' },
+    { src: 'IDENTITY.md', toName: 'identity.md' },
+    { src: 'USER.md', toName: 'user.md' },
+    { src: 'AGENTS.md', toName: 'agent.md' },
+    { src: 'TOOLS.md', toName: 'project.md' },
+    { src: 'MEMORY.md', toName: 'wiki.md' },
+];
+const HERMES_PERSONA = [
+    { src: 'SOUL.md', toName: 'soul.md' },
+    { src: 'memories/USER.md', toName: 'user.md' },
+    { src: 'memories/MEMORY.md', toName: 'wiki.md' },
+];
+/**
+ * 迁移单个源的全部数据到 Bolloon.
+ * 返回 report; 源不存在 → migrated=false 且不抛错 (静默).
+ */
+export async function migrateExternalAgent(source, deps = defaultDeps()) {
+    const report = {
+        source,
+        sourceRoot: sourceRootPath(source, deps.home),
+        migratedAt: new Date().toISOString(),
+        migrated: false,
+        personaAgentId: '',
+        persona: [],
+        skillsCopied: [],
+        memoryCopied: [],
+        docsCopied: [],
+        entries: [],
+        errors: [],
+    };
+    try {
+        const root = await detectSource(deps, source);
+        if (!root) {
+            report.migrated = false;
+            return report; // 未安装, 静默
+        }
+        report.sourceRoot = root;
+        const ws = workspacePath(source, root);
+        const wsStat = await deps.stat(ws);
+        if (!wsStat?.isDirectory) {
+            report.migrated = false;
+            report.errors.push(`workspace 目录不存在: ${ws}`);
+            return report;
+        }
+        // agentId: 用源名 + 目录名 (openclaw main agent) 兜底
+        const rawAgent = source === 'openclaw' ? 'main' : 'hermes-main';
+        const agentId = sanitizeAgentId(`ext-${source}-${rawAgent}`);
+        report.personaAgentId = agentId;
+        const bRoot = bolloonRoot(deps.home);
+        const personaDir = path.join(bRoot, 'persona', agentId);
+        const skillsRoot = path.join(bRoot, 'skills');
+        const memoryRoot = path.join(bRoot, 'memory', agentId, 'sessions');
+        const docsRoot = path.join(bRoot, 'context-os', '04-Projects', `${source}-docs`);
+        // manifest (幂等)
+        const manifestFile = path.join(bRoot, 'migration', `${source}.json`);
+        const manifest = new Map();
+        const prev = await deps.readFile(manifestFile);
+        if (prev) {
+            try {
+                const obj = JSON.parse(prev);
+                if (obj && typeof obj === 'object') {
+                    for (const [k, v] of Object.entries(obj))
+                        manifest.set(k, String(v));
+                }
+            }
+            catch { /* 损坏忽略, 从头迁 */ }
+        }
+        await deps.mkdir(path.join(bRoot, 'migration'));
+        // 1. persona (per-source spec) — 含敏感 token, 内容级脱敏后写入
+        const personaSpec = source === 'openclaw' ? OPENCLAW_PERSONA : HERMES_PERSONA;
+        for (const { src, toName } of personaSpec) {
+            const from = path.join(ws, src);
+            const to = path.join(personaDir, toName);
+            if (await copyIfNeeded(deps, from, to, manifest, true)) {
+                report.persona.push(toName);
+                report.entries.push({ from, to, kind: 'persona' });
+            }
+        }
+        // 2. skills → ~/.bolloon/skills/<name>/
+        const skillsSrc = path.join(ws, 'skills');
+        const skillDirs = await deps.readdir(skillsSrc);
+        if (skillDirs) {
+            // OpenClaw: skills/<name>/SKILL.md 一层, 直接落盘 <name>.
+            // Hermes: skills/<分类>/<技能>/SKILL.md 两层, 逐 <技能> 递归找 SKILL.md,
+            //   落盘 <分类>-<技能> 展平, 避免跨分类重名.
+            for (const entryName of skillDirs) {
+                if (entryName.startsWith('.'))
+                    continue;
+                const entry = path.join(skillsSrc, entryName);
+                const st = await deps.stat(entry);
+                if (!st?.isDirectory)
+                    continue;
+                if (source === 'hermes') {
+                    // 分类下的每个技能目录 → 目标 <分类>-<技能>
+                    const cat = entryName;
+                    const subDirs = await deps.readdir(entry);
+                    if (!subDirs)
+                        continue;
+                    for (const skillName of subDirs) {
+                        if (skillName.startsWith('.'))
+                            continue;
+                        const skillDir = path.join(entry, skillName);
+                        const sst = await deps.stat(skillDir);
+                        if (!sst?.isDirectory)
+                            continue;
+                        // 该分类下菊 不一定有 SKILL.md → 跳过
+                        const hasSkill = await deps.exists(path.join(skillDir, 'SKILL.md'));
+                        if (!hasSkill)
+                            continue;
+                        const targetName = `${cat}-${skillName}`;
+                        const destDir = path.join(skillsRoot, targetName);
+                        const copied = await copyDirIfNeeded(deps, skillDir, destDir, manifest);
+                        if (copied.length > 0) {
+                            report.skillsCopied.push(targetName);
+                            report.entries.push({ from: skillDir, to: destDir, kind: 'skill' });
+                        }
+                    }
+                }
+                else {
+                    const destDir = path.join(skillsRoot, entryName);
+                    const copied = await copyDirIfNeeded(deps, entry, destDir, manifest);
+                    if (copied.length > 0) {
+                        report.skillsCopied.push(entryName);
+                        report.entries.push({ from: entry, to: destDir, kind: 'skill' });
+                    }
+                }
+            }
+        }
+        // 3. memory: openclaw workspace/memory/*.md → sessions/; hermes 无独立 memory 目录
+        const memSrc = path.join(ws, 'memory');
+        const memFiles = await deps.readdir(memSrc);
+        if (memFiles) {
+            let idx = 0;
+            for (const f of memFiles) {
+                if (!f.endsWith('.md'))
+                    continue;
+                const from = path.join(memSrc, f);
+                const to = path.join(memoryRoot, `${idx + 1}-${f}`);
+                if (await copyIfNeeded(deps, from, to, manifest, true)) {
+                    report.memoryCopied.push(f);
+                    report.entries.push({ from, to, kind: 'memory' });
+                }
+                idx++;
+            }
+        }
+        // 4. docs: workspace 根其他 .md → context-os/04-Projects/<source>-docs/
+        const wsFiles = await deps.readdir(ws);
+        if (wsFiles) {
+            const excluded = personaSpec.map((p) => p.toName);
+            for (const f of wsFiles) {
+                if (!f.endsWith('.md'))
+                    continue;
+                if (excluded.includes(f))
+                    continue;
+                const from = path.join(ws, f);
+                const st = await deps.stat(from);
+                if (!st?.isFile)
+                    continue;
+                const to = path.join(docsRoot, f);
+                if (await copyIfNeeded(deps, from, to, manifest)) {
+                    report.docsCopied.push(f);
+                    report.entries.push({ from, to, kind: 'docs' });
+                }
+            }
+        }
+        // 写回 manifest
+        await deps.writeFile(manifestFile, JSON.stringify(Object.fromEntries(manifest), null, 2));
+        report.migrated = true;
+        return report;
+    }
+    catch (err) {
+        report.errors.push(err.message?.slice(0, 300) || String(err));
+        return report;
+    }
+}
+/** 一次性迁移所有已安装源 (openclaw + hermes). 隐式, 静默. */
+export async function migrateAllExternalAgents(deps = defaultDeps()) {
+    const sources = ['openclaw', 'hermes'];
+    const out = [];
+    for (const s of sources) {
+        const r = await migrateExternalAgent(s, deps);
+        if (r.migrated)
+            out.push(r);
+    }
+    return out;
+}
+/** 把迁移结果格式化成给用户看的中文通告 (纯函数, 可单测) */
+export function formatMigrationNotices(reports) {
+    const lines = [];
+    for (const r of reports) {
+        if (!r.migrated)
+            continue;
+        const parts = [];
+        if (r.persona.length)
+            parts.push(`性格 ${r.persona.length} 份`);
+        if (r.skillsCopied.length)
+            parts.push(`技能 ${r.skillsCopied.length} 个`);
+        if (r.memoryCopied.length)
+            parts.push(`记忆 ${r.memoryCopied.length} 条`);
+        if (r.docsCopied.length)
+            parts.push(`文档 ${r.docsCopied.length} 份`);
+        lines.push(`[迁移:${r.source}] 外部智能体数据已并入 Bolloon (agentId=${r.personaAgentId}): ${parts.join(', ') || '已就绪'}${r.errors.length ? ` (${r.errors.length} 个错误)` : ''}`);
+    }
+    return lines;
+}