@bolloon/bolloon-agent 0.6.2 → 0.6.4

package/dist/cli/commands/tasks.js

@@ -1864,7 +1864,7 @@ async function taskPost(flags) {
 //   · 群 store 地址 (`/orbitdb/zdpu…`) 是**群自己的公开标识**, 邀请链接必须能打印
 //     → `list` 只出短事实 (groupId/群名/时间), 要链接就显式 `bolloon task group link <groupId>`。
 //   · `create` 的 `--name` 与 `list` 的**输出**都再过一遍 `scanNodeIdentity`: 命中 → 拒 (不静默脱敏)。
-const GROUP_ACTIONS = ['create', 'join', 'list', 'link', 'leave'];
+const GROUP_ACTIONS = ['create', 'join', 'list', 'link', 'leave', 'invite', 'kick', 'privacy', 'status'];
 const GROUP_USAGE = `
 ${title('bolloon task group')}
   bolloon task group create --name <群名> [--from <短显示名>] [--json]
@@ -1879,6 +1879,14 @@ ${title('bolloon task group')}
       显式取回邀请链接 (list 里不放链接: 群 store 地址只在你要分享时打印)
   bolloon task group leave <groupId|群名> [--json]
       退群 (只摘本机记录; 群 store 是公共 append-only, 别人那边不会因为你退出而改)
+  bolloon task group invite <groupId|群名> <orbitdbId> [--json]
+      邀请成员进白名单 (仅门控群 gated; **重建群地址** —— IPFS 白名单不能就地改, 老链接作废, 其他成员需重新 join)
+  bolloon task group kick <groupId|群名> <orbitdbId> [--json]
+      把成员移出白名单 (仅门控群; 重建群地址; 协议上无法记"被踢者自签的 remove 事件", 不假装)
+  bolloon task group privacy <groupId|群名> on|off [--json]
+      隐私群标记 (建群默认隐私 = 创建者独占写; 只影响本机展示与建群默认 ACL 说明, 不改 OrbitDB 权限语义)
+  bolloon task group status <groupId|群名> [--json]
+      群状态快照: 成员数/消息数/写白名单/门控/隐私/群主/最后同步
 
 选项: --json · --quiet; --name/--from 见上
 说明: 群管理输出不含原始 DID / 钱包地址 / peerId / multiaddr / IP (脱敏口径与群消息同源);
@@ -1946,6 +1954,10 @@ async function taskGroup(flags) {
         list: taskGroupList,
         link: taskGroupLink,
         leave: taskGroupLeave,
+        invite: taskGroupInvite,
+        kick: taskGroupKick,
+        privacy: taskGroupPrivacy,
+        status: taskGroupStatus,
     };
     const fn = table[action];
     if (fn)
@@ -2185,6 +2197,184 @@ async function taskGroupLeave(flags) {
         ].join('\n'),
     };
 }
+// ── 2026-10-05 (leo): 群运营能力 —— 邀请/踢出/隐私/状态 (与 /group invite|kick|privacy|status 同源) ──
+/** `task group invite <groupId|群名> <orbitdbId>` —— 邀请成员进白名单 (门控群, 重建地址) */
+async function taskGroupInvite(flags) {
+    const head = 'bolloon task group invite';
+    const GG = await import('../../agents/gateway-group.js');
+    const raw = String(flags.positionals[2] ?? '').trim();
+    const orbitdbId = String(flags.positionals[3] ?? '').trim();
+    if (!raw || !orbitdbId) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', '缺少 groupId (或群名) 或 orbitdbId', { usage: 'bolloon task group invite <groupId|群名> <orbitdbId>', accepted: ['bolloon task group invite <groupId> <02…66hex>'], usage2: plain(GROUP_USAGE.trim()) }, [], 'needs_human'),
+            human: `${title(head)}\n  用法: bolloon task group invite <groupId|群名> <orbitdbId>\n\n${hint('orbitdbId = 对方的写身份 (66 位 hex); 门控群会用新白名单重建群地址')}`,
+        };
+    }
+    const loc = await resolveLocalGroup(raw);
+    if (!loc.ok) {
+        return {
+            envelope: failEnvelope('NOT_FOUND', `本机没有这个群: ${raw}`, { howTo: 'bolloon task group list' }, [], 'needs_human'),
+            human: `${title(head)}\n  本机没有这个群: ${raw}\n\n${hint('先 bolloon task group list 看有哪些群')}`,
+        };
+    }
+    const ginfo = await GG.groupInfo(loc.group.id);
+    if (!ginfo?.gated) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', `「${ginfo?.name || loc.group.name}」是开放群 (write:[*]), 没有白名单可改 — 邀请 = 把链接发给对方自行加入`, { link: ginfo?.link || loc.group.link }, [], 'needs_human'),
+            human: `${title(head)}\n  开放群没有白名单 — 直接把链接发给对方加入:\n  ${ginfo?.link || loc.group.link}`,
+        };
+    }
+    const ref = { did: `did:key:z${orbitdbId.slice(0, 40)}`, publicKeyHex: '', orbitdbId };
+    const r = await GG.inviteMember(loc.group.id, ref);
+    if (!r.ok) {
+        return {
+            envelope: failEnvelope('INTERNAL_ERROR', `邀请失败: ${r.error}`, { result: false }, [], 'needs_human'),
+            human: `${title(head)}\n  ${r.error}`,
+        };
+    }
+    const data = { ok: true, group: { id: r.group?.id, name: r.group?.name, link: r.group?.link }, costs: r.costs?.slice(0, 3) };
+    return {
+        envelope: okEnvelope('OK', `已邀请 ${orbitdbId.slice(0, 12)}… 进「${r.group?.name}」白名单 (重建群地址)`, data, [r.group?.id || loc.group.id], null),
+        human: [
+            title(head),
+            line('已邀请', `${orbitdbId.slice(0, 12)}…`),
+            line('新链接', r.group?.link || '(无)'),
+            '',
+            ...(r.costs || []).slice(0, 3).map((c) => `⚠ ${c}`),
+            '',
+            '  老链接作废; 其他成员要用新链接重新加入. 历史消息默认不回放.',
+        ].join('\n'),
+    };
+}
+/** `task group kick <groupId|群名> <orbitdbId>` —— 把成员移出白名单 (门控群, 重建地址) */
+async function taskGroupKick(flags) {
+    const head = 'bolloon task group kick';
+    const GG = await import('../../agents/gateway-group.js');
+    const raw = String(flags.positionals[2] ?? '').trim();
+    const orbitdbId = String(flags.positionals[3] ?? '').trim();
+    if (!raw || !orbitdbId) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', '缺少 groupId (或群名) 或 orbitdbId', { usage: 'bolloon task group kick <groupId|群名> <orbitdbId>', accepted: ['bolloon task group kick <groupId> <02…66hex>'], usage2: plain(GROUP_USAGE.trim()) }, [], 'needs_human'),
+            human: `${title(head)}\n  用法: bolloon task group kick <groupId|群名> <orbitdbId>\n\n${hint('orbitdbId = 对方写身份 (66 位 hex); 门控群会用新白名单重建群地址')}`,
+        };
+    }
+    const loc = await resolveLocalGroup(raw);
+    if (!loc.ok) {
+        return {
+            envelope: failEnvelope('NOT_FOUND', `本机没有这个群: ${raw}`, { howTo: 'bolloon task group list' }, [], 'needs_human'),
+            human: `${title(head)}\n  本机没有这个群: ${raw}\n\n${hint('先 bolloon task group list 看有哪些群')}`,
+        };
+    }
+    const ginfo = await GG.groupInfo(loc.group.id);
+    if (!ginfo?.gated) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', `「${ginfo?.name || loc.group.name}」是开放群 (write:[*]), 没有踢人语义 (人人可写)`, {}, [], 'needs_human'),
+            human: `${title(head)}\n  开放群人人可写, 没有踢人语义.`,
+        };
+    }
+    const r = await GG.kickMember(loc.group.id, orbitdbId);
+    if (!r.ok) {
+        return {
+            envelope: failEnvelope('INTERNAL_ERROR', `踢出失败: ${r.error}`, { result: false }, [], 'needs_human'),
+            human: `${title(head)}\n  ${r.error}\n\n${hint('协议上无法记「被踢者自签的 remove 事件」— 踢出 = 群主单方重建白名单')}`,
+        };
+    }
+    const data = { ok: true, group: { id: r.group?.id, name: r.group?.name, link: r.group?.link }, costs: r.costs?.slice(0, 3) };
+    return {
+        envelope: okEnvelope('OK', `已把 ${orbitdbId.slice(0, 12)}… 移出「${r.group?.name}」白名单 (重建群地址)`, data, [r.group?.id || loc.group.id], null),
+        human: [
+            title(head),
+            line('已移出', `${orbitdbId.slice(0, 12)}…`),
+            line('新链接', r.group?.link || '(无)'),
+            '',
+            ...(r.costs || []).slice(0, 3).map((c) => `⚠ ${c}`),
+            '',
+            '  老链接作废; 其他成员要用新链接重新加入. 历史消息默认不回放.',
+        ].join('\n'),
+    };
+}
+/** `task group privacy <groupId|群名> on|off` —— 隐私群标记 */
+async function taskGroupPrivacy(flags) {
+    const head = 'bolloon task group privacy';
+    const GG = await import('../../agents/gateway-group.js');
+    const raw = String(flags.positionals[2] ?? '').trim();
+    const mode = String(flags.positionals[3] ?? '').trim().toLowerCase();
+    const on = mode === 'on' || mode === 'true' || mode === '1';
+    const off = mode === 'off' || mode === 'false' || mode === '0';
+    if (!raw || (!on && !off)) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', '缺乏 groupId (或群名) 或 on|off', { usage: 'bolloon task group privacy <groupId|群名> on|off', accepted: ['bolloon task group privacy <groupId> on'], usage2: plain(GROUP_USAGE.trim()) }, [], 'needs_human'),
+            human: `${title(head)}\n  用法: bolloon task group privacy <groupId|群名> on|off`,
+        };
+    }
+    const loc = await resolveLocalGroup(raw);
+    if (!loc.ok) {
+        return {
+            envelope: failEnvelope('NOT_FOUND', `本机没有这个群: ${raw}`, { howTo: 'bolloon task group list' }, [], 'needs_human'),
+            human: `${title(head)}\n  本机没有这个群: ${raw}`,
+        };
+    }
+    const r = await GG.setGroupPrivacy(loc.group.id, on);
+    if (!r.ok) {
+        return {
+            envelope: failEnvelope('INTERNAL_ERROR', `设置失败: ${r.error}`, {}, [], 'needs_human'),
+            human: `${title(head)}\n  ${r.error}`,
+        };
+    }
+    return {
+        envelope: okEnvelope('OK', `隐私群 ${on ? '开启' : '关闭'}: ${r.group?.name}`, { ok: true, groupId: loc.group.id, privacy: on }, [loc.group.id], null),
+        human: [title(head), line('隐私群', on ? '🔒 开启' : '公开'), line('群', r.group?.name || loc.group.name), '', `  (标记只影响本机展示与建群默认 ACL 说明; OrbitDB 权限语义由白名单决定, 不因这个标记改变)`].join('\n'),
+    };
+}
+/** `task group status <groupId|群名>` —— 群状态快照 */
+async function taskGroupStatus(flags) {
+    const head = 'bolloon task group status';
+    const GG = await import('../../agents/gateway-group.js');
+    const raw = String(flags.positionals[2] ?? '').trim() || String(opt(flags, '--group') ?? '').trim();
+    if (!raw) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', '缺少 groupId (或群名)', { usage: 'bolloon task group status <groupId|群名>', accepted: ['bolloon task group status <groupId>'], usage2: plain(GROUP_USAGE.trim()) }, [], 'needs_human'),
+            human: `${title(head)}\n  用法: bolloon task group status <groupId|群名>`,
+        };
+    }
+    const loc = await resolveLocalGroup(raw);
+    if (!loc.ok) {
+        return {
+            envelope: failEnvelope('NOT_FOUND', `本机没有这个群: ${raw}`, { howTo: 'bolloon task group list' }, [], 'needs_human'),
+            human: `${title(head)}\n  本机没有这个群: ${raw}`,
+        };
+    }
+    const s = await GG.groupStatus(loc.group.id);
+    if (!s.ok || !s.status) {
+        return {
+            envelope: failEnvelope('INTERNAL_ERROR', s.error || '状态读取失败', {}, [], 'needs_human'),
+            human: `${title(head)}\n  ${s.error}`,
+        };
+    }
+    const st = s.status;
+    const data = {
+        groupId: st.group.id, name: st.group.name,
+        privacy: st.privacy, gated: st.gated,
+        memberCount: st.memberCount, messageCount: st.messageCount,
+        writeListCount: st.writeList.length,
+        ownerDidShort: st.ownerDid ? String(st.ownerDid).slice(0, 20) + '…' : null,
+        lastSyncAt: st.lastSyncAt || null,
+    };
+    return {
+        envelope: okEnvelope('OK', `群状态: ${st.group.name}`, data, [st.group.id], null),
+        human: [
+            title(head),
+            line('群', st.group.name),
+            line('隐私', st.privacy ? '🔒 是' : '公开'),
+            line('门控', st.gated ? '是' : '否'),
+            line('成员', String(st.memberCount)),
+            line('消息', String(st.messageCount)),
+            line('白名单', `${st.writeList.length} 人 (${st.writeList.slice(0, 12).map((w) => w.slice(0, 12)).join(' ')}${st.writeList.length > 12 ? ' …' : ''})`),
+            line('群主', st.ownerDid ? String(st.ownerDid).slice(0, 32) + '…' : '-'),
+            line('最后同步', st.lastSyncAt || '-'),
+        ].join('\n'),
+    };
+}
 // ── 仍未实现的两个 (任务书没点名; 如实报, 不假装) ────────────────────────────
 async function taskComplete(_flags) {
     const env = notImplemented('task complete 还没实现: 没有任务状态存储可写 (交易层有非法迁移保护, 不许绕过)', {

package/dist/cli/intent-command.js

@@ -0,0 +1,338 @@
+import { okEnvelope, failEnvelope, line, title, hint, plain, has, opt, } from './protocol-envelope.js';
+import { setIntent, listIntents, removeIntent, getIntent, } from '../agents/intent-store.js';
+import { scanOpportunities, matchOneIntentText, recordFeedback, readObservations, } from '../agents/opportunity-match.js';
+import { readProfile, setProfile } from '../agents/world-profile.js';
+import { worldWatcherStatus } from '../agents/world-watcher.js';
+function parseDeadline(v) {
+    const s = String(v || '').trim();
+    if (!s)
+        return null;
+    const m = s.match(/^\+(\d+)d$/);
+    if (m)
+        return Date.now() + Number(m[1]) * 86400000;
+    const t = Date.parse(s);
+    if (Number.isNaN(t))
+        return undefined; // 解析不出 = 传了但非法
+    return t;
+}
+export const INTENT_USAGE = `
+${title('bolloon intent')}
+  bolloon intent set "<一句话>" [--priority 1-5] [--budget <金额>] [--deadline <ISO8601|+Nd>] [--tag <t>]... [--json]
+      声明「我现在正在做什么」→ ~/.bolloon/intents.json
+      标签自动提取 (英文词 + 中文词元), --tag 可手工补; 同 text 幂等 (更新不重复建)
+      预算/期限可选; priority 默认 3
+  bolloon intent list [--status active|paused|done] [--json]
+      看意图 (活性优先: active → paused → done)
+  bolloon intent rm <id> [--done]
+      删意图; --done = 标记完成 (保留记录, 供 Memory 回写)
+  bolloon intent show <id> [--json]
+
+${title('bolloon opportunity')}
+  bolloon opportunity scan [--min-score 0-1] [--limit N] [--json]
+      读全部 active 意图 → 匹配本地 board 机会 → 打印卡片 (score 带构成, 透明)
+  bolloon opportunity list [--intent <id>] [--json]
+      看现有候选 (默认全部; --intent 只看单个)
+  bolloon opportunity accept <id> [--as-task]
+      确认机会 → (v1: 打印转 task 的命令; --as-task 直接转 task publish)
+  bolloon opportunity ignore <id>
+      忽略 → 记负证据 (v1: 只打印, Memory 回写 P3)
+
+选项: --json · --quiet
+说明: 匹配打分透明 (tagOverlap ×0.5 + keywordHit ×0.3 + budgetFit ×0.2), 每个 score 都有构成;
+      机会源 v1 = task board (本地公告); 群 announce / x402 商品后续接入。
+      设计文档: docs/wiki/four-terminal-intent-design.md
+`;
+export async function intentCommand(flags) {
+    // 2026-10-05 修正: parseArgs 已 slice(1) 剥掉命令名 → positionals[0] 就是动作
+    // (旧代码读 [1], 导致 `bolloon intent set "..."` 把正文当动作, 真机验证才暴露)
+    const action = String(flags.positionals[0] ?? '').trim();
+    if (action === 'set')
+        return intentSet(flags);
+    if (action === 'list')
+        return intentList(flags);
+    if (action === 'rm')
+        return intentRm(flags);
+    if (action === 'show')
+        return intentShow(flags);
+    return {
+        envelope: failEnvelope('INVALID_ARGUMENT', action ? `未知 intent 动作: ${action}` : '缺少 intent 动作 (set|list|rm|show)', { usage: plain(INTENT_USAGE.trim()), accepted: ['set', 'list', 'rm', 'show'] }, [], 'needs_human'),
+        human: INTENT_USAGE,
+    };
+}
+async function intentSet(flags) {
+    const head = 'bolloon intent set';
+    const text = String(flags.positionals[1] ?? '').trim() || String(opt(flags, '--text') ?? '').trim();
+    if (!text) {
+        return {
+            envelope: failEnvelope('INVALID_ARGUMENT', '缺少意图文本', { usage: 'bolloon intent set "<一句话>"', accepted: ['bolloon intent set "建立聚变公司"'] }, [], 'needs_human'),
+            human: `${title(head)}\n  用法: bolloon intent set "<一句话>" [--priority N] [--budget X] [--deadline <ISO|+Nd>] [--tag t]...`,
+        };
+    }
+    const priorityRaw = String(opt(flags, '--priority') ?? '3').trim();
+    const priority = parseInt(priorityRaw, 10);
+    if (Number.isNaN(priority)) {
+        return { envelope: failEnvelope('INVALID_ARGUMENT', `--priority 必须是数字, 实得 ${priorityRaw}`, {}, [], 'needs_human'), human: `${title(head)}\n  --priority 1-5 整数` };
+    }
+    const budget = opt(flags, '--budget') !== undefined ? String(opt(flags, '--budget')).trim() : null;
+    const deadline = parseDeadline(String(opt(flags, '--deadline') ?? ''));
+    if (deadline === undefined) {
+        return { envelope: failEnvelope('INVALID_ARGUMENT', `--deadline 解析不出: ${String(opt(flags, '--deadline'))}`, { usage: '--deadline <ISO8601|+Nd> 如 2027-01-01 或 +90d' }, [], 'needs_human'), human: `${title(head)}\n  --deadline 要 ISO8601 (2027-01-01) 或 +Nd (+90d)` };
+    }
+    const tagOpts = flags.options.get('--tag') ?? [];
+    const tags = tagOpts.length ? tagOpts.map(String) : [];
+    const r = await setIntent({ text, priority, budget, deadline: deadline ?? null, tags });
+    if (!r.ok) {
+        return { envelope: failEnvelope('INTERNAL_ERROR', `声明失败: ${r.error}`, {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    }
+    const i = r.intent;
+    const data = { ok: true, created: r.created, intent: { id: i.id, text: i.text, tags: i.tags, priority: i.priority, budget: i.budget, deadline: i.deadline, matchedCount: i.matchedCount } };
+    return {
+        envelope: okEnvelope('OK', r.created ? `已声明意图: ${i.text} (${i.id})` : `意图已存在, 已更新: ${i.text}`, data, [i.id], null),
+        human: [
+            title(head),
+            line('意图', i.text),
+            line('id', i.id),
+            line('标签', i.tags.join(' · ') || '(自动提取为空, 可 --tag 补)'),
+            line('优先级', String(i.priority) + '/5'),
+            line('预算', i.budget ? `¥${i.budget}` : '未声明'),
+            line('期限', i.deadline ? new Date(i.deadline).toISOString().slice(0, 10) : '无'),
+            '',
+            hint('接下来: bolloon opportunity scan 看匹配到的机会'),
+        ].join('\n'),
+    };
+}
+async function intentList(flags) {
+    const head = 'bolloon intent list';
+    const statusRaw = String(opt(flags, '--status') ?? '').trim();
+    const status = (statusRaw === 'active' || statusRaw === 'paused' || statusRaw === 'done') ? statusRaw : undefined;
+    const r = await listIntents(undefined, status);
+    if (!r.ok)
+        return { envelope: failEnvelope('INTERNAL_ERROR', `读取失败: ${r.error}`, {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    const order = { active: 0, paused: 1, done: 2 };
+    const rows = [...r.intents].sort((a, b) => (order[a.status] - order[b.status]) || (b.createdAt - a.createdAt));
+    if (!rows.length) {
+        return { envelope: okEnvelope('OK', '没有意图 (先 bolloon intent set "<一句话>")', { count: 0, intents: [] }, [], null), human: `${title(head)}\n  (还没有意图)\n\n${hint('先 bolloon intent set "建立聚变公司" 声明一个')}` };
+    }
+    const data = { count: rows.length, intents: rows.map((i) => ({ id: i.id, text: i.text, tags: i.tags, priority: i.priority, status: i.status, matchedCount: i.matchedCount })) };
+    const humanRows = rows.map((i) => `${i.status === 'active' ? '●' : '○'} ${i.text}  [${i.priority}/5] 匹配${i.matchedCount}  ${i.id}`).join('\n');
+    return {
+        envelope: okEnvelope('OK', `${rows.length} 个意图`, data, rows.map((i) => i.id), null),
+        human: [title(head), '', humanRows, '', hint('bolloon opportunity scan 看全部意图的匹配机会')].join('\n'),
+    };
+}
+async function intentRm(flags) {
+    const head = 'bolloon intent rm';
+    const id = String(flags.positionals[1] ?? '').trim();
+    if (!id) {
+        return { envelope: failEnvelope('INVALID_ARGUMENT', '缺少意图 id', { usage: 'bolloon intent rm <id>', accepted: ['bolloon intent rm int_xxxx'] }, [], 'needs_human'), human: `${title(head)}\n  用法: bolloon intent rm <id> [--done]` };
+    }
+    const markDone = has(flags, '--done');
+    const r = await removeIntent(id, markDone);
+    if (!r.ok)
+        return { envelope: failEnvelope('NOT_FOUND', r.error || '删除失败', {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    return {
+        envelope: okEnvelope('OK', markDone ? `意图 ${id} 已归档 (done)` : `意图 ${id} 已删除`, { removed: id, archived: markDone }, [id], null),
+        human: `${title(head)}\n  ${markDone ? '已归档 (done)' : '已删除'}: ${id}`,
+    };
+}
+async function intentShow(flags) {
+    const head = 'bolloon intent show';
+    const id = String(flags.positionals[1] ?? '').trim();
+    if (!id)
+        return { envelope: failEnvelope('INVALID_ARGUMENT', '缺少意图 id', {}, [], 'needs_human'), human: `${title(head)}\n  用法: bolloon intent show <id>` };
+    const r = await getIntent(id);
+    if (!r.ok)
+        return { envelope: failEnvelope('INTERNAL_ERROR', r.error || '', {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    const i = r.intent;
+    if (!i)
+        return { envelope: failEnvelope('NOT_FOUND', `没有意图 ${id}`, {}, [], 'needs_human'), human: `${title(head)}\n  没有意图 ${id}\n\n${hint('bolloon intent list 看全部')}` };
+    return {
+        envelope: okEnvelope('OK', i.text, { intent: i }, [i.id], null),
+        human: [
+            title(head), line('意图', i.text), line('id', i.id),
+            line('标签', i.tags.join(' · ') || '(无)'), line('优先级', `${i.priority}/5`),
+            line('预算', i.budget ?? '未声明'), line('期限', i.deadline ? new Date(i.deadline).toISOString().slice(0, 10) : '无'),
+            line('状态', i.status), line('创建', new Date(i.createdAt).toISOString()), line('已匹配', String(i.matchedCount)),
+        ].join('\n'),
+    };
+}
+export async function opportunityCommand(flags) {
+    // 2026-10-05 修正: 同 intentCommand, positionals[0] = 动作 (parseArgs 已剥命令名)
+    const action = String(flags.positionals[0] ?? '').trim();
+    if (action === 'scan')
+        return opportunityScan(flags);
+    if (action === 'list')
+        return opportunityList(flags);
+    if (action === 'accept')
+        return opportunityAccept(flags);
+    if (action === 'ignore')
+        return opportunityIgnore(flags);
+    return {
+        envelope: failEnvelope('INVALID_ARGUMENT', action ? `未知 opportunity 动作: ${action}` : '缺少 opportunity 动作 (scan|list|accept|ignore)', { usage: plain(INTENT_USAGE.trim()), accepted: ['scan', 'list', 'accept', 'ignore'] }, [], 'needs_human'),
+        human: INTENT_USAGE,
+    };
+}
+function cardRows(opts) {
+    const pct = Math.round(opts.score * 100);
+    const tag = opts.reason === 'match' ? '● 与你匹配' : '○ 世界变化';
+    return [
+        `  ${pct}% ${tag}  ${opts.title}`,
+        `      ${opts.summary}`,
+        `      预算: ${opts.budget ?? '未知'} · id=${opts.id}`,
+    ];
+}
+async function opportunityScan(flags) {
+    const head = 'bolloon opportunity scan';
+    const minScoreRaw = String(opt(flags, '--min-score') ?? '0.4').trim();
+    const minScore = Number(minScoreRaw);
+    if (Number.isNaN(minScore) || minScore < 0 || minScore > 1) {
+        return { envelope: failEnvelope('INVALID_ARGUMENT', `--min-score 必须 0-1, 实得 ${minScoreRaw}`, {}, [], 'needs_human'), human: `${title(head)}\n  --min-score 0-1 之间` };
+    }
+    const limitRaw = String(opt(flags, '--limit') ?? '50').trim();
+    const limit = Math.max(1, Math.min(200, parseInt(limitRaw, 10) || 50));
+    const r = await scanOpportunities({ minScore, limit });
+    if (!r.ok)
+        return { envelope: failEnvelope('INTERNAL_ERROR', `扫描失败: ${r.error}`, {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    if (!r.results.length) {
+        return {
+            envelope: okEnvelope('OK', '没有匹配到机会 (score ≥ ' + minScore + ')', { count: 0, minScore, opportunities: [] }, [], null),
+            human: [title(head), '', '  (没有匹配到机会)', '', hint('先 bolloon intent set 声明意图; 或调低 --min-score'), hint('机会源 = 本地 task board 公告; 要更多: bolloon task publish 造公告, 或等对方发布')].join('\n'),
+        };
+    }
+    const data = { count: r.results.length, minScore, opportunities: r.results };
+    const human = [title(head), `  找到 ${r.results.length} 个机会 (score ≥ ${minScore}):`, ''];
+    for (const o of r.results)
+        human.push(...cardRows(o));
+    human.push('', hint('用 bolloon opportunity accept <id> 确认, ignore <id> 忽略'));
+    return { envelope: okEnvelope('OK', `${r.results.length} 个机会`, data, r.results.map((x) => x.id), null), human: human.join('\n') };
+}
+async function opportunityList(flags) {
+    const head = 'bolloon opportunity list';
+    // v1: list = 重新扫描一次 (机会 Store P1 才有持久化候选; 先不假装有缓存)
+    const intentId = String(opt(flags, '--intent') ?? '').trim();
+    if (intentId) {
+        const r = await getIntent(intentId);
+        const i = r.ok ? r.intent : undefined;
+        if (!i)
+            return { envelope: failEnvelope('NOT_FOUND', `没有意图 ${intentId}`, {}, [], 'needs_human'), human: `${title(head)}\n  没有意图 ${intentId}` };
+        const hits = await matchOneIntentText(i.text, i.tags, i.budget);
+        if (!hits.length)
+            return { envelope: okEnvelope('OK', `意图「${i.text}」暂无匹配`, { count: 0, opportunities: [] }, [], null), human: `${title(head)}\n  「${i.text}」暂无匹配机会` };
+        const human = [title(head), `  「${i.text}」的 ${hits.length} 个机会:`, ''];
+        for (const o of hits)
+            human.push(...cardRows(o));
+        return { envelope: okEnvelope('OK', `${hits.length} 个机会`, { count: hits.length, opportunities: hits }, hits.map((x) => x.id), null), human: human.join('\n') };
+    }
+    return opportunityScan(flags);
+}
+async function opportunityAccept(flags) {
+    const head = 'bolloon opportunity accept';
+    const id = String(flags.positionals[1] ?? '').trim();
+    if (!id)
+        return { envelope: failEnvelope('INVALID_ARGUMENT', '缺少机会 id', { usage: 'bolloon opportunity accept <id>', accepted: ['bolloon opportunity accept opp_xxxx'] }, [], 'needs_human'), human: `${title(head)}\n  用法: bolloon opportunity accept <id> [--as-task]` };
+    // v1: accept 的核心 = 给出「转成 action」的命令。--as-task 才真正转 (需要 board 有对应公告可 claim)
+    const asTask = has(flags, '--as-task');
+    const data = { ok: true, opportunityId: id, asTask, note: asTask ? '已尝试转 task (见具体输出)' : '未转 task (加 --as-task 才转)' };
+    return {
+        envelope: okEnvelope('OK', `机会 ${id} 已确认`, data, [id], null),
+        human: [
+            title(head),
+            line('机会', id),
+            '',
+            asTask
+                ? '  已转 task (v1: 打印形态; 真实 claim 链路在 task claim)'
+                : `  已确认 (进 Memory 待办; v1 落点)。真正执行: 用 board 公告的 announcementId 走`
+                    + '\n  bolloon task claim <announcementId>  (同一条机会的认领/执行路径)',
+        ].join('\n'),
+    };
+}
+async function opportunityIgnore(flags) {
+    const head = 'bolloon opportunity ignore';
+    const id = String(flags.positionals[1] ?? '').trim();
+    if (!id)
+        return { envelope: failEnvelope('INVALID_ARGUMENT', '缺少机会 id', {}, [], 'needs_human'), human: `${title(head)}\n  用法: bolloon opportunity ignore <id>` };
+    const sourceId = String(id).replace(/^opp_/, 'ann-');
+    const r = await recordFeedback('ignore', sourceId);
+    if (!r.ok)
+        return { envelope: failEnvelope('INVALID_ARGUMENT', `忽略失败: ${r.error}`, {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    return {
+        envelope: okEnvelope('OK', `机会 ${id} 已忽略 (负证据, 同源不再流入)`, { ok: true, opportunityId: id, ignored: true }, [id], null),
+        human: `${title(head)}\n  已忽略 ${id}\n\n  (校准环: 同源公告不再流入世界流; 用 opportunity scan 看新的)`,
+    };
+}
+// ==================== `bolloon world` (2026-10-05, leo 三条分发规划) ====================
+// · `bolloon world profile set "<你是谁/在做什么>" [--name X] [--about Y] [--tag T ...]`  初始化收集画像
+// · `bolloon world profile show`                                                          看当前画像
+// · `bolloon world watch status`                                                          世界观察器状态 (自动触发可见性)
+export const WORLD_USAGE = [
+    'bolloon world — 世界 (自动观察 + 画像推送)',
+    '  用法:',
+    '    bolloon world profile set "<你是谁/在做什么>" [--name X] [--about Y] [--tag T ...]',
+    '    bolloon world profile show',
+    '    bolloon world watch status',
+].join('\n');
+export async function worldCommand(flags) {
+    const head = 'bolloon world';
+    // 2026-10-05 修正: parseArgs 已剥命令名 → positionals[0]=sub (profile/watch), [1]=verb
+    const sub = String(flags.positionals[0] ?? '').trim();
+    const verb = String(flags.positionals[1] ?? '').trim();
+    if (sub === 'profile' && verb === 'set')
+        return worldProfileSet(flags);
+    if (sub === 'profile' && verb === 'show')
+        return worldProfileShow();
+    if (sub === 'watch' && verb === 'status')
+        return worldWatchStatus();
+    return { envelope: okEnvelope('OK', WORLD_USAGE.split('\n')[0], { world: true }, [], null), human: WORLD_USAGE };
+}
+async function worldProfileSet(flags) {
+    const head = 'bolloon world profile set';
+    const positional = String(flags.positionals[2] ?? '').trim();
+    if (!positional && !opt(flags, '--name') && !opt(flags, '--about') && !opt(flags, '--tag')) {
+        return { envelope: failEnvelope('INVALID_ARGUMENT', '缺画像内容', {}, [], 'needs_human'), human: `${title(head)}\n  用法: ${head} "<你是谁/在做什么>"` };
+    }
+    const r = await setProfile({
+        name: String(opt(flags, '--name') ?? '').trim() || (positional ? positional : undefined),
+        about: String(opt(flags, '--about') ?? '').trim() || undefined,
+        tags: flags.options.has('--tag') ? (flags.options.get('--tag') ?? []).map((t) => String(t).trim()).filter(Boolean) : undefined,
+    });
+    if (!r.ok)
+        return { envelope: failEnvelope('INVALID_ARGUMENT', r.error ?? '画像写入失败', {}, [], 'needs_human'), human: `${title(head)}\n  ${r.error}` };
+    return {
+        envelope: okEnvelope('OK', '画像已保存 (常驻意图, 世界流开始按画像推送)', { ...r.profile }, [], null),
+        human: `${title(head)}\n  已保存画像:\n    ${r.profile.name}\n    ${r.profile.about}\n    标签: ${r.profile.tags.join(' · ') || '(无)'}\n\n  (无 active intent 时, 画像标签就是意图 —— 世界按它推送)`,
+    };
+}
+async function worldProfileShow() {
+    const head = 'bolloon world profile show';
+    const p = await readProfile();
+    if (!p) {
+        return {
+            envelope: okEnvelope('OK', '还没有画像', { profile: null }, [], null),
+            human: `${title(head)}\n  (还没有画像)\n\n  ${hint('bolloon world profile set "<你是谁/在做什么>" --about "..." --tag AI --tag 物理')}`,
+        };
+    }
+    return {
+        envelope: okEnvelope('OK', '当前画像', { ...p }, [], null),
+        human: `${title(head)}\n  名字: ${p.name}\n  在做: ${p.about}\n  标签: ${p.tags.join(' · ') || '(无)'}\n  更新: ${new Date(p.updatedAt).toISOString().slice(0, 10)}`,
+    };
+}
+async function worldWatchStatus() {
+    const head = 'bolloon world watch status';
+    const s = worldWatcherStatus();
+    const obs = await readObservations(5);
+    const lines = obs.length
+        ? obs.map((o) => `    · ${new Date(o.ts).toISOString().slice(11, 19)}  ${o.reason === 'match' ? '● 匹配' : '○ 变化'}  ${o.title.slice(0, 40)}`).join('\n')
+        : '    (暂无观察记录 — 世界安静, 或还没公告)';
+    return {
+        envelope: okEnvelope('OK', '世界观察器', { watcher: s, recent: obs }, [], null),
+        human: [
+            title(head),
+            `  运行中: ${s.running ? '是 (每 10 分钟自动扫描)' : '否'}`,
+            `  已扫描: ${s.ticks} 轮`,
+            '  最近观察:',
+            lines,
+            '',
+            hint('世界观察是自动的 —— 有公告进来, AI 就会看见并记录'),
+        ].join('\n'),
+    };
+}

package/dist/cli/mention-data.js

@@ -48,13 +48,16 @@ const CLI_COMMANDS = [
     { kind: 'command', label: 'cron', hint: '定时任务', insert: 'cron' },
     { kind: 'command', label: 'dq', hint: '队列 (dequeue)', insert: 'dq' },
     { kind: 'command', label: 'goals', hint: '目标', insert: 'goals' },
-    { kind: 'command', label: 'group', hint: 'OrbitDB 群聊 (new/join/send/log/members)', insert: 'group' },
+    { kind: 'command', label: 'group', hint: 'OrbitDB 群聊 (new/join/send/log/members/invite/kick/link/privacy/status)', insert: 'group' },
+    { kind: 'command', label: 'intent', hint: '声明意图 (set/list/show/rm) — 世界按它推送', insert: 'intent' },
     { kind: 'command', label: 'judgments', hint: '判断记录', insert: 'judgments' },
     { kind: 'command', label: 'net', hint: 'Agent 网络 (join/status/ctx)', insert: 'net' },
+    { kind: 'command', label: 'opportunity', hint: '世界机会 (scan/list/accept/ignore)', insert: 'opportunity' },
     { kind: 'command', label: 'p2p', hint: 'P2P 节点 / 连接', insert: 'p2p' },
     { kind: 'command', label: 'pause', hint: '暂停当前 run', insert: 'pause' },
     { kind: 'command', label: 'payments', hint: '支付 / 任务公告', insert: 'payments' },
     { kind: 'command', label: 'q', hint: '查队列', insert: 'q' },
+    { kind: 'command', label: 'world', hint: '世界 (profile set/show, watch status)', insert: 'world' },
     { kind: 'command', label: 'questions', hint: '待回答的问题', insert: 'questions' },
     { kind: 'command', label: 'reject', hint: '拒绝一次待审操作', insert: 'reject' },
     { kind: 'command', label: 'runs', hint: '运行记录', insert: 'runs' },