evolcore 0.0.25 → 0.0.27

package/dist/cli/aun-commands.js

@@ -1,10 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import { agentMdPath, resolvePaths, resolveRoot } from '../paths.js';
-import { isExplicitGroupId } from '../aun/group-identity.js';
+import { isExplicitGroupId, normalizeGroupAid, sameGroupAid } from '../aun/group/index.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { ipcQuery } from '../ipc.js';
-import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
+import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { isManagementRole } from '../config/builtin-roles.js';
 import { readBestTaskRuntimeContext } from './task-context.js';
 // ==================== AID ====================
@@ -107,7 +107,7 @@ async function runManagedAid(args, formatJson) {
     const sessionId = process.env.EVOLCORE_SESSION_ID;
     if (!sessionId)
         failManagedAid(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
-    const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+    const delegationToken = readDelegationCredential();
     if (!delegationToken) {
         failManagedAid(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
     }
@@ -184,7 +184,7 @@ async function runManagedGroup(args, formatJson) {
     const sessionId = process.env.EVOLCORE_SESSION_ID;
     if (!sessionId)
         failManagedGroup(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
-    const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+    const delegationToken = readDelegationCredential();
     if (!delegationToken) {
         failManagedGroup(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
     }
@@ -214,7 +214,7 @@ async function runManagedMsg(args, formatJson) {
     const sessionId = process.env.EVOLCORE_SESSION_ID;
     if (!sessionId)
         failManagedGroup(formatJson, 'NO_SESSION', 'EVOLCORE_SESSION_ID is not set');
-    const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+    const delegationToken = readDelegationCredential();
     if (!delegationToken) {
         failManagedGroup(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
     }
@@ -274,7 +274,7 @@ function validateManagedGroupScope(from, groupId, runtime, formatJson) {
     if (runtime.channel !== 'aun' || runtime.chatType !== 'group') {
         failManagedGroup(formatJson, 'ARGUMENT_MISMATCH', `当前角色 ${runtime.peerRole} 只能在 AUN 群聊任务中操作当前群`);
     }
-    if (!runtime.channelId || groupId !== runtime.channelId) {
+    if (!runtime.channelId || !sameGroupAid(groupId, runtime.channelId)) {
         failManagedGroup(formatJson, 'ARGUMENT_MISMATCH', `当前角色 ${runtime.peerRole} 只能操作当前群 ${runtime.channelId ?? '<unknown>'}，不能操作 ${groupId}`);
     }
 }
@@ -307,6 +307,27 @@ function renderManagedGroupResult(args, result, formatJson) {
         return;
     }
     const sub = args[0];
+    if (sub === 'history') {
+        if (result.mode === 'message')
+            console.log(result.content);
+        else {
+            console.log('本地群历史：' + result.count + ' 条');
+            for (const message of result.messages ?? []) {
+                console.log('[' + message.time + '] ' + message.from + ' → ' + message.to
+                    + ' thread=' + (message.threadId || 'main') + '\n' + message.content);
+                if (message.content_truncated)
+                    console.log('正文尚未读完');
+                if (message.content_truncated && message.msgId) {
+                    console.log('--all --message ' + message.msgId + ' --offset ' + message.next_offset);
+                }
+            }
+        }
+        if (result.next_offset != null)
+            console.log('next_offset=' + result.next_offset);
+        if (result.has_more)
+            console.log('还有更多历史');
+        return;
+    }
     if (sub === 'list') {
         if (!result.items?.length)
             console.log('(没有加入任何群)');
@@ -317,8 +338,35 @@ function renderManagedGroupResult(args, result, formatJson) {
         }
         return;
     }
+    if (sub === 'blocklist') {
+        const items = result.items ?? [];
+        console.log(items.length ? `共 ${result.total ?? items.length} 条屏蔽:` : '(没有屏蔽成员)');
+        for (const item of items) {
+            console.log(`  ${item.subject ?? item.aid ?? '-'} blocked_by=${item.blocked_by ?? '-'} reason=${item.reason ?? ''}`);
+        }
+        return;
+    }
+    if (sub === 'member-statuses') {
+        console.log(`成员上报状态（共 ${result.items?.length ?? 0} 名成员）:`);
+        for (const item of result.items ?? []) {
+            console.log(`  ${item.aid ?? '-'} online_status=${item.online_status || '(未上报)'} work_status=${item.work_status || '(未上报)'}`);
+        }
+        return;
+    }
+    if (sub === 'report-status') {
+        console.log('✓ 已上报当前成员状态');
+        console.log(JSON.stringify(result.data?.status ?? {}, null, 2));
+        return;
+    }
+    if (sub === 'block' || sub === 'unblock') {
+        const target = result.data?.block?.subject ?? result.data?.subject ?? args[3];
+        console.log(`✓ 已${sub === 'block' ? '屏蔽' : '取消屏蔽'} ${target} 接收群消息`);
+        return;
+    }
     if (sub === 'create') {
-        console.log(`✓ 已创建群 ${result.group?.group_id ?? '-'}`);
+        console.log(`✓ 已创建群 ${result.group?.group_aid ?? result.group?.group_id ?? '-'}`);
+        if (result.warning)
+            console.warn(result.warning);
         return;
     }
     if (sub === 'rules' && args[3] === 'get' && result.status === 'ok') {
@@ -338,7 +386,7 @@ function renderManagedGroupResult(args, result, formatJson) {
         return;
     }
     if (sub === 'accept-invite' || sub === 'reject-invite' || sub === 'revoke-invite') {
-        console.log(`✓ group ${sub} 完成`);
+        console.log(typeof result.message === 'string' ? result.message : `✓ group ${sub} 完成`);
         return;
     }
     console.log(`✓ group ${sub} 完成`);
@@ -348,37 +396,37 @@ export async function cmdAid(args) {
     const formatJson = getArgValue(args, '--format') === 'json';
     const aunPath = resolveAunPath(args);
     if (!sub || isHelpFlag(sub)) {
-        console.log(`用法: ec aid <command>
-
-Commands:
-  list              列出本地所有 AID（实测 sign+verify）
-  show <aid>        查看本地 AID 详情（证书、私钥、签名能力）
-  new <aid>         创建新 AID 身份
-  delete <aid>      删除指定本地 AID（无网络注销）
-  delete --orphan         批量清理无私钥的外部 AID 缓存
-  delete --no-cert        批量清理无私钥也无公钥证书的孤儿目录
-  delete --unrecoverable  批量清理云端公钥已变更、本地不可恢复的 AID
-                          批量删除默认 dry-run，加 --yes 执行
-  lookup <aid>      远程探测 AID（是否存在 + 网关 + agent.md）
+        console.log(`用法: ec aid <command>
+
+Commands:
+  list              列出本地所有 AID（实测 sign+verify）
+  show <aid>        查看本地 AID 详情（证书、私钥、签名能力）
+  new <aid>         创建新 AID 身份
+  delete <aid>      删除指定本地 AID（无网络注销）
+  delete --orphan         批量清理无私钥的外部 AID 缓存
+  delete --no-cert        批量清理无私钥也无公钥证书的孤儿目录
+  delete --unrecoverable  批量清理云端公钥已变更、本地不可恢复的 AID
+                          批量删除默认 dry-run，加 --yes 执行
+  lookup <aid>      远程探测 AID（是否存在 + 网关 + agent.md）
   agentmd put <aid> 读本地 agent.md → 签名 → 上传
   agentmd get <aid> 下载 agent.md → 验签 → 本地持久化
   avatar <aid> --file <path> | --url <https-url>  上传头像并更新 agent.md
-
-Options:
-  --format json     输出 JSON 格式
-  --aun-path <path> 指定 AUN keystore 根（默认 EVOLCORE_HOME，可由 AUN_HOME 设置）
-  --help, -h        各子命令均支持，查看详细用法
-
-示例:
-  ec aid list
-  ec aid show toleiliang2.agentid.pub
-  ec aid new reviewer.agentid.pub
-  ec aid delete --help
-  ec aid delete old.agentid.pub
-  ec aid delete --orphan
-  ec aid delete --unrecoverable --yes
-  ec aid lookup someone.agentid.pub
-  ec aid agentmd put mybot.agentid.pub
+
+Options:
+  --format json     输出 JSON 格式
+  --aun-path <path> 指定 AUN keystore 根（默认 EVOLCORE_HOME，可由 AUN_HOME 设置）
+  --help, -h        各子命令均支持，查看详细用法
+
+示例:
+  ec aid list
+  ec aid show toleiliang2.agentid.pub
+  ec aid new reviewer.agentid.pub
+  ec aid delete --help
+  ec aid delete old.agentid.pub
+  ec aid delete --orphan
+  ec aid delete --unrecoverable --yes
+  ec aid lookup someone.agentid.pub
+  ec aid agentmd put mybot.agentid.pub
   ec aid agentmd get someone.agentid.pub`);
         return;
     }
@@ -389,33 +437,33 @@ Options:
     const { aidList, aidListVerified, aidCreate, aidShow, aidDelete, aidLookup, agentmdPut, agentmdGet, buildInitialAgentMd, isValidAid } = await import('../aun/aid/index.js');
     if (sub === 'list') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec aid list [筛选选项] [--no-verify] [--format json]
-
-列出本地 AID 并跑 sign+verify 自检。
-
-筛选选项（可组合，不指定 = 列出 mine + broken + peer-cert）:
-  --mine            仅本地可用身份（实测可签名+验签通过）
-  --broken          仅有私钥但不可用（公钥不匹配 / 证书过期 / sign 失败）
-  --peer-cert       仅对端 AID（无私钥，有公钥证书）
-  --no-cert         仅无私钥无证书的目录（默认隐藏，需用 aid delete --no-cert 清理）
-
-选项:
-  --no-verify       跳过 sign+verify 实测，仅静态扫描（更快，mine/broken 仅按静态判定近似）
-  --format json     JSON 格式输出
-
-输出图标:
-  🔑   有私钥
-  ✅   实测可签名/验签
-  ❌   不可签名（公钥不匹配 / sign 失败 / verify 失败等）
-  ⌛   证书过期
-  📜   有公钥证书
-  📄   有 agent.md
-
-示例:
-  ec aid list                  列出 mine + broken + peer-cert
-  ec aid list --mine           仅可用身份
-  ec aid list --mine --broken  所有有私钥的 AID
-  ec aid list --no-cert        仅无私钥无证书的孤儿目录
+            console.log(`用法: ec aid list [筛选选项] [--no-verify] [--format json]
+
+列出本地 AID 并跑 sign+verify 自检。
+
+筛选选项（可组合，不指定 = 列出 mine + broken + peer-cert）:
+  --mine            仅本地可用身份（实测可签名+验签通过）
+  --broken          仅有私钥但不可用（公钥不匹配 / 证书过期 / sign 失败）
+  --peer-cert       仅对端 AID（无私钥，有公钥证书）
+  --no-cert         仅无私钥无证书的目录（默认隐藏，需用 aid delete --no-cert 清理）
+
+选项:
+  --no-verify       跳过 sign+verify 实测，仅静态扫描（更快，mine/broken 仅按静态判定近似）
+  --format json     JSON 格式输出
+
+输出图标:
+  🔑   有私钥
+  ✅   实测可签名/验签
+  ❌   不可签名（公钥不匹配 / sign 失败 / verify 失败等）
+  ⌛   证书过期
+  📜   有公钥证书
+  📄   有 agent.md
+
+示例:
+  ec aid list                  列出 mine + broken + peer-cert
+  ec aid list --mine           仅可用身份
+  ec aid list --mine --broken  所有有私钥的 AID
+  ec aid list --no-cert        仅无私钥无证书的孤儿目录
   ec aid list --no-verify      跳过实测，快速静态扫描`);
             return;
         }
@@ -467,8 +515,8 @@ Options:
     }
     if (sub === 'show') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec aid show <aid> [--format json]
-
+            console.log(`用法: ec aid show <aid> [--format json]
+
 查看本地 AID 详情：私钥/证书/agent.md 状态、签名能力实测。`);
             return;
         }
@@ -483,16 +531,16 @@ Options:
     }
     if (sub === 'new') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec aid new <完整AID> [--force] [--format json]
-
-创建新 AID 身份：生成 ECDSA 密钥对、向 Issuer 申请证书、构建并上传初始 agent.md。
-
-选项:
-  --force    强制重新注册，覆盖已存在的身份（即使签名验证失败）
-  --format json      输出 JSON
-  --aun-path <path>  指定 AUN keystore 根
-
-例: ec aid new reviewer.agentid.pub
+            console.log(`用法: ec aid new <完整AID> [--force] [--format json]
+
+创建新 AID 身份：生成 ECDSA 密钥对、向 Issuer 申请证书、构建并上传初始 agent.md。
+
+选项:
+  --force    强制重新注册，覆盖已存在的身份（即使签名验证失败）
+  --format json      输出 JSON
+  --aun-path <path>  指定 AUN keystore 根
+
+例: ec aid new reviewer.agentid.pub
     ec aid new reviewer.agentid.pub --force`);
             return;
         }
@@ -575,34 +623,34 @@ Options:
     }
     if (sub === 'delete') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec aid delete <子命令>
-
-单个删除:
-  ec aid delete <aid>           删除指定 AID 的本地数据（无网络注销）
-
-批量删除（默认 dry-run，加 --yes 才真删）:
-  ec aid delete --orphan        删除所有"无私钥"的本地缓存（外部 AID）
-  ec aid delete --no-cert       删除所有"无私钥也无公钥证书"的目录
-                                       条件：!hasPrivateKey && !hasCert
-                                       这些目录最多只剩 agent.md 或 SQLite 残留，
-                                       对验签和加密通信都没用，删除安全。
-  ec aid delete --unrecoverable 删除所有不可恢复的 AID
-                                       条件：本地 sign+verify 实测失败
-                                       且 PKI 探测确认云端公钥也不等本地 key.json
-
-选项:
-  --yes              跳过 dry-run，立即执行
-  --skip-pki         --unrecoverable 时跳过 PKI 探测，仅依据本地 sign+verify 失败判断（危险，可能误删可恢复 AID）
-  --format json      输出 JSON 格式
-  --aun-path <path>  指定 AUN keystore 根
-
-示例:
-  ec aid delete old.agentid.pub
-  ec aid delete --orphan                列出会被清理的孤儿
-  ec aid delete --orphan --yes          实际清理
-  ec aid delete --no-cert               列出无证书孤儿目录
-  ec aid delete --no-cert --yes         实际清理
-  ec aid delete --unrecoverable         联网探测后列出无救 AID
+            console.log(`用法: ec aid delete <子命令>
+
+单个删除:
+  ec aid delete <aid>           删除指定 AID 的本地数据（无网络注销）
+
+批量删除（默认 dry-run，加 --yes 才真删）:
+  ec aid delete --orphan        删除所有"无私钥"的本地缓存（外部 AID）
+  ec aid delete --no-cert       删除所有"无私钥也无公钥证书"的目录
+                                       条件：!hasPrivateKey && !hasCert
+                                       这些目录最多只剩 agent.md 或 SQLite 残留，
+                                       对验签和加密通信都没用，删除安全。
+  ec aid delete --unrecoverable 删除所有不可恢复的 AID
+                                       条件：本地 sign+verify 实测失败
+                                       且 PKI 探测确认云端公钥也不等本地 key.json
+
+选项:
+  --yes              跳过 dry-run，立即执行
+  --skip-pki         --unrecoverable 时跳过 PKI 探测，仅依据本地 sign+verify 失败判断（危险，可能误删可恢复 AID）
+  --format json      输出 JSON 格式
+  --aun-path <path>  指定 AUN keystore 根
+
+示例:
+  ec aid delete old.agentid.pub
+  ec aid delete --orphan                列出会被清理的孤儿
+  ec aid delete --orphan --yes          实际清理
+  ec aid delete --no-cert               列出无证书孤儿目录
+  ec aid delete --no-cert --yes         实际清理
+  ec aid delete --unrecoverable         联网探测后列出无救 AID
   ec aid delete --unrecoverable --yes`);
             return;
         }
@@ -732,8 +780,8 @@ Options:
     }
     if (sub === 'lookup') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec aid lookup <aid> [--format json]
-
+            console.log(`用法: ec aid lookup <aid> [--format json]
+
 远程探测 AID：是否注册、所在网关、是否有 agent.md（不验签，仅获取）。`);
             return;
         }
@@ -754,9 +802,9 @@ Options:
         const verb = args[1];
         const aid = args[2];
         if (!verb || isHelpFlag(verb) || wantsHelp(args)) {
-            console.log(`用法: ec aid agentmd <put|get> <aid> [--format json]
-
-  put <aid>   读本地 agent.md → 用本地私钥签名 → 上传到 PKI
+            console.log(`用法: ec aid agentmd <put|get> <aid> [--format json]
+
+  put <aid>   读本地 agent.md → 用本地私钥签名 → 上传到 PKI
   get <aid>   从 PKI 下载 agent.md → 验签 → 持久化到本地`);
             return;
         }
@@ -867,24 +915,24 @@ Options:
 // ==================== RPC ====================
 export async function cmdRpc(args) {
     if (args.length === 0 || wantsHelp(args)) {
-        console.log(`用法: ec rpc --as <aid> --params <params>
-
-通用 AUN RPC 调用。
-
---params 自动判断输入形式:
-  单行 JSON (以 { 开头)     → 单次调用
-  多行 JSONL                → 逐行执行，失败即停
-  文件路径 (文件存在)        → 读取文件内容作为 JSONL
-
-每行 JSON 格式: {"method":"<namespace.method>","params":{...}}
-
-Options:
-  --app <name>   指定应用 slot（独立消费通道）。仅对 message.pull / group.pull
-                 等消费类方法有意义——隔离 seq 游标与消息过滤；默认与 daemon 共享通道。
-  --aun-path <path> 指定 AUN keystore 根
-
-示例:
-  ec rpc --as alice.agentid.pub --params '{"method":"message.send","params":{"to":"bob.agentid.pub","payload":{"type":"text","text":"hello"}}}'
+        console.log(`用法: ec rpc --as <aid> --params <params>
+
+通用 AUN RPC 调用。
+
+--params 自动判断输入形式:
+  单行 JSON (以 { 开头)     → 单次调用
+  多行 JSONL                → 逐行执行，失败即停
+  文件路径 (文件存在)        → 读取文件内容作为 JSONL
+
+每行 JSON 格式: {"method":"<namespace.method>","params":{...}}
+
+Options:
+  --app <name>   指定应用 slot（独立消费通道）。仅对 message.pull / group.pull
+                 等消费类方法有意义——隔离 seq 游标与消息过滤；默认与 daemon 共享通道。
+  --aun-path <path> 指定 AUN keystore 根
+
+示例:
+  ec rpc --as alice.agentid.pub --params '{"method":"message.send","params":{"to":"bob.agentid.pub","payload":{"type":"text","text":"hello"}}}'
   ec rpc --as alice.agentid.pub --params calls.jsonl`);
         return;
     }
@@ -952,29 +1000,29 @@ export async function cmdStorage(args) {
     const aunPath = resolveAunPath(args);
     const formatJson = getArgValue(args, '--format') === 'json';
     if (!sub || wantsHelp(args)) {
-        console.log(`用法: ec storage <command> <aid> [options]
-
-Commands:
-  upload <aid> <local-file> <remote-path> [--public]   上传文件（默认私有）
-  download <aid> <url> [local-path]                    下载文件
-  ls <aid> [prefix]                                    列文件
-  rm <aid> <remote-path>                               删文件
-  quota <aid>                                          查配额
-
-<url> 格式: [https://]<owner-aid>/<path>
-
-Options:
-  --public          上传后公开可读（仅 upload）
-  --format json     输出 JSON
-  --aun-path <path> 指定 AUN keystore 根
-
-示例:
-  ec storage upload myaid.agentid.pub ./doc.txt notes/doc.txt
-  ec storage upload myaid.agentid.pub ./pic.png images/pic.png --public
-  ec storage download myaid.agentid.pub myaid.agentid.pub/notes/doc.txt ./doc.txt
-  ec storage download myaid.agentid.pub bob.agentid.pub/public/file.pdf ./file.pdf
-  ec storage ls myaid.agentid.pub notes/
-  ec storage rm myaid.agentid.pub notes/doc.txt
+        console.log(`用法: ec storage <command> <aid> [options]
+
+Commands:
+  upload <aid> <local-file> <remote-path> [--public]   上传文件（默认私有）
+  download <aid> <url> [local-path]                    下载文件
+  ls <aid> [prefix]                                    列文件
+  rm <aid> <remote-path>                               删文件
+  quota <aid>                                          查配额
+
+<url> 格式: [https://]<owner-aid>/<path>
+
+Options:
+  --public          上传后公开可读（仅 upload）
+  --format json     输出 JSON
+  --aun-path <path> 指定 AUN keystore 根
+
+示例:
+  ec storage upload myaid.agentid.pub ./doc.txt notes/doc.txt
+  ec storage upload myaid.agentid.pub ./pic.png images/pic.png --public
+  ec storage download myaid.agentid.pub myaid.agentid.pub/notes/doc.txt ./doc.txt
+  ec storage download myaid.agentid.pub bob.agentid.pub/public/file.pdf ./file.pdf
+  ec storage ls myaid.agentid.pub notes/
+  ec storage rm myaid.agentid.pub notes/doc.txt
   ec storage quota myaid.agentid.pub`);
         return;
     }
@@ -992,15 +1040,47 @@ Options:
         const operation = { ls: 'storage.list', quota: 'storage.quota', upload: 'storage.upload', download: 'storage.download', rm: 'storage.delete' }[sub];
         if (!operation)
             failManagedGroup(formatJson, 'NOT_ALLOWED', `unsupported managed storage command: ${sub}`);
-        const delegationToken = process.env[AGENT_DELEGATION_TOKEN_ENV];
+        const delegationToken = readDelegationCredential();
         if (!delegationToken)
             failManagedGroup(formatJson, 'DELEGATION_REQUIRED', `${AGENT_DELEGATION_TOKEN_ENV} is not set for the active task`);
+        if (sub === 'upload') {
+            const localFile = args[2];
+            const remotePath = args[3];
+            if (!localFile || !remotePath) {
+                console.error('用法: ec storage upload <aid> <local-file> <remote-path> [--public]');
+                process.exit(1);
+            }
+            if (!fs.existsSync(localFile)) {
+                console.error(`❌ 文件不存在: ${localFile}`);
+                process.exit(1);
+            }
+            const result = await ipcQuery(resolvePaths().socket, {
+                type: 'storage.upload',
+                aid,
+                localFile,
+                remotePath,
+                isPublic: args.includes('--public'),
+                sessionId: process.env.EVOLCORE_SESSION_ID,
+                delegationToken,
+            }, null);
+            if (!result)
+                failManagedGroup(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
+            if (!result.ok)
+                failManagedGroup(formatJson, result.code || 'STORAGE_UPLOAD_FAILED', result.error || 'Storage upload failed');
+            if (formatJson)
+                console.log(JSON.stringify({ ok: true, objectKey: remotePath, isPublic: args.includes('--public'), ref: `${aid}/${remotePath}`, publicUrl: result.publicUrl ?? null }));
+            else {
+                console.log(`✓ 已上传: ${remotePath}${args.includes('--public') ? ' (公开)' : ''}`);
+                if (result.publicUrl)
+                    console.log(`  🔗 访问: ${result.publicUrl}`);
+                else
+                    console.log(`  引用: ${aid}/${remotePath}`);
+                console.log(`  下载: ec storage download ${aid} ${aid}/${remotePath}`);
+            }
+            return;
+        }
         const authorization = await ipcQuery(resolvePaths().socket, {
-            type: 'storage.auth',
-            operation,
-            aid,
-            sessionId: process.env.EVOLCORE_SESSION_ID,
-            delegationToken,
+            type: 'storage.auth', operation, aid, sessionId: process.env.EVOLCORE_SESSION_ID, delegationToken,
         }, 10_000);
         if (!authorization)
             failManagedGroup(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
@@ -1129,83 +1209,84 @@ export async function cmdMsg(args) {
     const formatJson = getArgValue(args, '--format') === 'json';
     const appSlot = getArgValue(args, '--app');
     if (!sub || isHelpFlag(sub) || (wantsHelp(args) && sub !== 'history')) {
-        console.log(`用法: ec msg <command> <from-aid> [args...] [options]
-
-Commands:
-  send <from> <to> <text> --return <none|required>     发送文本（跨会话时 --return 必填）
-  send <from> <to> --text-from-file <path>             从文件读取文本内容
-  send <from> <to> --file <path> [--as <type>]         发送文件（image|video|voice|file）
-  send <from> <to> --link <url> [--title T]            发送链接卡片
-  send <from> <to> --payload <json>                    发送自定义 payload
+        console.log(`用法: ec msg <command> <from-aid> [args...] [options]
+
+Commands:
+  send <from> <to> <text> --return <none|required>     发送文本（跨会话时 --return 必填）
+  send <from> <to> --text-from-file <path>             从文件读取文本内容
+  send <from> <to> --file <path> [--as <type>]         发送文件（image|video|voice|file）
+  send <from> <to> --link <url> [--title T]            发送链接卡片
+  send <from> <to> --payload <json>                    发送自定义 payload
   pull <from> [--after-seq N] [--limit N] --app <name> 拉取收件箱（必须使用独立 slot）
-  ack <from> <seq> [--app <name>]                      确认已读
-  recall <from> <message-id> [<message-id>...]         撤回消息
-  online <from> <target-aid> [<target-aid>...]         查询在线状态
-  history <from> [<target-aid>|selector] [筛选选项]    查询本地消息历史
-
-Options:
-  --text-from-file <path>  从文件读取文本（UTF-8），用于超长消息或避免 Shell 转义
-  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
-  --aun-path <path>     指定 AUN keystore 根
-  --format json         输出 JSON 格式
-  --encrypt             强制端到端加密（未指定时使用 daemon 默认值）
-  --no-encrypt          强制明文发送（优先于 --encrypt）
-  --thread <id>         指定话题 ID（用于多话题路由）
-  --session <latest|all|id> 按 EvolCore 逻辑会话过滤历史（默认 latest）
-  --before <time>       只返回该时间之前的历史
-  --after <time>        只返回该时间之后的历史
-  --direction <value>   历史方向：in|out|all
-  --channel <type>      历史渠道：aun|feishu|wechat|dingtalk|qqbot|wecom
-  --channel-name <name> 历史渠道实例名（非 AUN 渠道必须匹配 Agent 配置）
-  --channel-key <key>   非 AUN 已落盘渠道的完整实例键（与 --peer-id 成对）
-  --peer-id <id>        非 AUN 渠道的原生对端 ID（与 --channel-key 成对）
-  --return <none|required> 跨会话发送必填：none=仅补充目标上下文，required=回答回流来源
-  --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
-  --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
-  --text <说明>          附件说明文字（仅 --file 模式）
-  --transcript <text>   语音转写（仅 --as voice）
-  --title <text>        链接标题（仅 --link 模式）
-  --description <text>  链接描述（仅 --link 模式）
-  --                    end-of-options：其后所有参数按正文处理
-                        （用于发送恰好等于某 flag 的文本，如 send a b -- --encrypt）
-
-示例:
-  ec msg send alice.agentid.pub bob.agentid.pub "hello" --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt --return none
-  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "project-A" --return required
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN" --return none
-  ec msg pull alice.agentid.pub --app my-bot
-  ec msg ack alice.agentid.pub 42 --app my-bot
-  ec msg recall alice.agentid.pub msg-uuid-1 msg-uuid-2
-  ec msg online alice.agentid.pub bob.agentid.pub carol.agentid.pub
-  ec msg history alice.agentid.pub bob.agentid.pub --session latest --limit 50
+  ack <from> <seq> [--app <name>]                      确认已读
+  recall <from> <message-id> [<message-id>...]         撤回消息
+  online <from> <target-aid> [<target-aid>...]         查询在线状态
+  history <from> [<target-aid>|selector] [筛选选项]    查询本地消息历史
+
+Options:
+  --text-from-file <path>  从文件读取文本（UTF-8），用于超长消息或避免 Shell 转义
+  --handoff-context <text>  仅托管会话：为目标会话补充本地上下文，不发给对端
+  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
+  --aun-path <path>     指定 AUN keystore 根
+  --format json         输出 JSON 格式
+  --encrypt             强制端到端加密（未指定时使用 daemon 默认值）
+  --no-encrypt          强制明文发送（优先于 --encrypt）
+  --thread <id>         指定话题 ID（用于多话题路由）
+  --session <latest|all|id> 按 EvolCore 逻辑会话过滤历史（默认 latest）
+  --before <time>       只返回该时间之前的历史
+  --after <time>        只返回该时间之后的历史
+  --direction <value>   历史方向：in|out|all
+  --channel <type>      历史渠道：aun|feishu|wechat|dingtalk|qqbot|wecom
+  --channel-name <name> 历史渠道实例名（非 AUN 渠道必须匹配 Agent 配置）
+  --channel-key <key>   非 AUN 已落盘渠道的完整实例键（与 --peer-id 成对）
+  --peer-id <id>        非 AUN 渠道的原生对端 ID（与 --channel-key 成对）
+  --return <none|required> 跨会话发送必填：none=仅补充目标上下文，required=回答回流来源
+  --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
+  --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
+  --text <说明>          附件说明文字（仅 --file 模式）
+  --transcript <text>   语音转写（仅 --as voice）
+  --title <text>        链接标题（仅 --link 模式）
+  --description <text>  链接描述（仅 --link 模式）
+  --                    end-of-options：其后所有参数按正文处理
+                        （用于发送恰好等于某 flag 的文本，如 send a b -- --encrypt）
+
+示例:
+  ec msg send alice.agentid.pub bob.agentid.pub "hello" --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt --return none
+  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "project-A" --return required
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video --return none
+  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN" --return none
+  ec msg pull alice.agentid.pub --app my-bot
+  ec msg ack alice.agentid.pub 42 --app my-bot
+  ec msg recall alice.agentid.pub msg-uuid-1 msg-uuid-2
+  ec msg online alice.agentid.pub bob.agentid.pub carol.agentid.pub
+  ec msg history alice.agentid.pub bob.agentid.pub --session latest --limit 50
   ec msg history alice.agentid.pub --channel-key feishu#alice.agentid.pub#main --peer-id ou_xxx --session all --format json`);
         return;
     }
     if (sub === 'history' && wantsHelp(args)) {
-        console.log(`用法: ec msg history <self-aid> [<target-aid> | --channel-key <key> --peer-id <id>] [options]
-
-查询指定会话对的本地历史，不调用 message.pull，也不影响收件箱游标。非 AUN selector 按已落盘的 session metadata、完整 channelKey 与原生 peer ID 精确读取，不能传入文件路径。
-
-托管会话限制：普通会话只能使用当前 self AID 和当前 AUN 私聊对端；可信 daemon Trigger 可用精确的 --channel-key/--peer-id selector 读取已落盘的非 AUN 私聊历史。托管任务不支持 --channel、--channel-name、--aun-path 或 --app。
-
-Options:
-  --session <latest|all|id> 默认 latest；all 查询全部；也可指定会话 ID
-  --limit <N>             返回最新 N 条（默认 50，最大 500）
-  --before <time>         开区间；epoch 毫秒或 ISO 时间
-  --after <time>          开区间；epoch 毫秒或 ISO 时间
-  --direction <value>     in|out|all（默认 all）
-  --channel-key <key>     非 AUN 已落盘渠道完整键；必须与 --peer-id 同时给出
-  --peer-id <id>          原生私聊对端 ID；必须与 --channel-key 同时给出
-  --format <text|json>    输出格式（默认 text）
-
-示例:
-  ec msg history alice.agentid.pub bob.agentid.pub
-  ec msg history alice.agentid.pub bob.agentid.pub --session latest
-  ec msg history alice.agentid.pub bob.agentid.pub --session all
-  ec msg history alice.agentid.pub bob.agentid.pub --session meta_20260713_1783920000000 --format json
+        console.log(`用法: ec msg history <self-aid> [<target-aid> | --channel-key <key> --peer-id <id>] [options]
+
+查询指定会话对的本地历史，不调用 message.pull，也不影响收件箱游标。非 AUN selector 按已落盘的 session metadata、完整 channelKey 与原生 peer ID 精确读取，不能传入文件路径。
+
+托管会话限制：普通会话只能使用当前 self AID 和当前 AUN 私聊对端；可信 daemon Trigger 可用精确的 --channel-key/--peer-id selector 读取已落盘的非 AUN 私聊历史。托管任务不支持 --channel、--channel-name、--aun-path 或 --app。
+
+Options:
+  --session <latest|all|id> 默认 latest；all 查询全部；也可指定会话 ID
+  --limit <N>             返回最新 N 条（默认 50，最大 500）
+  --before <time>         开区间；epoch 毫秒或 ISO 时间
+  --after <time>          开区间；epoch 毫秒或 ISO 时间
+  --direction <value>     in|out|all（默认 all）
+  --channel-key <key>     非 AUN 已落盘渠道完整键；必须与 --peer-id 同时给出
+  --peer-id <id>          原生私聊对端 ID；必须与 --channel-key 同时给出
+  --format <text|json>    输出格式（默认 text）
+
+示例:
+  ec msg history alice.agentid.pub bob.agentid.pub
+  ec msg history alice.agentid.pub bob.agentid.pub --session latest
+  ec msg history alice.agentid.pub bob.agentid.pub --session all
+  ec msg history alice.agentid.pub bob.agentid.pub --session meta_20260713_1783920000000 --format json
   ec msg history alice.agentid.pub --channel-key feishu#alice.agentid.pub#main --peer-id ou_xxx --session all --format json`);
         return;
     }
@@ -1442,28 +1523,14 @@ Options:
             console.error(`❌ --return 仅支持 required|none: ${returnPolicyRaw}`);
             process.exit(1);
         }
-        // 文件上传进度展示（非 JSON 输出时）。仅在大文件降级到 HTTP PUT 阶段会逐块更新。
-        let lastPctShown = -1;
+        // SDK 尚未提供字节进度回调，只展示上传开始和成功完成。
         const onUploadProgress = formatJson ? undefined : (info) => {
-            if (info.phase === 'inline')
-                return; // 内联阶段不分块，跳过
-            if (info.phase === 'http-put') {
-                const pct = info.total > 0 ? Math.floor((info.bytes / info.total) * 100) : 0;
-                if (pct === lastPctShown && info.bytes < info.total)
-                    return;
-                lastPctShown = pct;
-                const mb = (n) => (n / 1024 / 1024).toFixed(2);
-                const eol = info.bytes >= info.total ? '\n' : '\r';
-                process.stderr.write(`  ⏫ uploading: ${pct}% (${mb(info.bytes)}/${mb(info.total)} MB)${eol}`);
-            }
-            else if (info.phase === 'session-create') {
-                process.stderr.write('  ⏫ requesting upload session...\n');
-            }
-            else if (info.phase === 'session-complete') {
-                process.stderr.write('  ⏫ finalizing upload...\n');
-            }
+            if (info.phase === 'upload')
+                process.stderr.write('  ⏫ uploading...\n');
+            else if (info.phase === 'done')
+                process.stderr.write('  ✓ upload complete\n');
         };
-        const result = await msgSend({ from, to, body, encrypt, thread, returnPolicy: returnPolicyRaw, onUploadProgress, ...commonOpts });
+        const result = await msgSend({ from, to, body, encrypt, thread, returnPolicy: returnPolicyRaw, handoffContext: getArgValue(args, '--handoff-context'), onUploadProgress, ...commonOpts });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));
@@ -1632,77 +1699,104 @@ export async function cmdGroup(args) {
     const aunPath = resolveAunPath(args);
     const formatJson = getArgValue(args, '--format') === 'json';
     const appSlot = getArgValue(args, '--app');
+    if (sub === 'history' && wantsHelp(args)) {
+        console.log(`用法: ec group history <self-aid> <group-aid> --unread|--all [options]
+本地 messages.jsonl 查询，不访问 Gateway，不推进 group pull/ack 游标。
+--unread               返回最早未读的未提及背景，并自动记录本页已读
+--all                  浏览群会话历史（返回最近 N 条），不改变已读状态
+--limit <N>            默认 50，范围 1–500；另有 24 KiB 单页消息预算
+--thread <main|all|id>  当前群任务缺省继承当前话题；其他调用缺省 all
+--direction <in|out|all> 按方向筛选，默认 all
+--before/--after <time> 按接收时间筛选，开区间；epoch 毫秒或 ISO 时间
+--format <text|json>    默认 text
+--message <msg-id>     配合 --all 查看指定长消息正文
+--offset <bytes>       配合 --message 从 next_offset 继续读取，默认 0
+--unread 返回的消息会记为已读；--all（包括 --all --message）始终只读，之后仍可回看。
+visitor 不开放历史；群权限仍由托管会话校验。
+旧日志通过 --all 查询，只有带本地未提及标记的新记录参与 --unread。`);
+        return;
+    }
     const rulesActionHelp = sub === 'rules' && isHelpFlag(args[3]);
     if (!sub || isHelpFlag(sub) || (wantsHelp(args) && !rulesActionHelp)) {
-        console.log(`用法: ec group <command> <from-aid> [args...] [options]
-
-消息:
-  send <from> <group-id> <text> --return <none|required> 发送群文本（跨会话时 --return 必填）
-  send <from> <group-id> --file <path> [--as <type>]   发送群文件
-  send <from> <group-id> --payload <json>              发送自定义 payload
+        console.log(`用法: ec group <command> <from-aid> [args...] [options]
+
+消息:
+  send <from> <group-id> <text> --return <none|required> 发送群文本（跨会话时 --return 必填）
+  send <from> <group-id> --file <path> [--as <type>]   发送群文件
+  send <from> <group-id> --payload <json>              发送自定义 payload
   pull <from> <group-id> [--after-seq N] [--limit N] --app <name>   拉取群消息（必须使用独立 slot）
-  ack <from> <group-id> <seq> [--app <name>]           确认已读
-
-群管理:
-  create <from> <name> [--visibility public|private] [--description D]
-                       [--join-mode open|approval|invite_only|closed]  创建群
-  list <from> [--size N]                                列出我加入的群
-  info <from> <group-id>                                查看群详情
-  update <from> <group-id> [--name N] [--description D] 修改群信息
-  dissolve <from> <group-id>                            解散群
-  suspend <from> <group-id>                             暂停群
-  resume <from> <group-id>                              恢复群
-  rules <from> <group-id> get                          读取已发布群规则文件 /rules.md
-  rules <from> <group-id> set <file>                   上传并发布群规则文件
-  rules <from> <group-id> publish                      发布当前群空间 /rules.md
-  rules <from> <group-id> [--mode M] [--question Q] [--max-pending N]  查看/更新入群规则
-
-成员:
-  join <from> <group-id> [--message M] [--answer A]    申请加入
-  leave <from> <group-id>                              退出群
-  invite <from> <group-id> <member-aid> [<member-aid>...]   创建定向邀请
-  invites <from> [--page N] [--size N]                    查看收到的邀请
-  accept-invite <from> <invite-id>                         接受邀请
-  reject-invite <from> <invite-id>                         拒绝邀请
-  revoke-invite <from> <invite-id>                         撤回邀请
-  kick <from> <group-id> <member-aid>                  踢出成员
-  members <from> <group-id> [--page N] [--size N]      列出群成员
-  online <from> <group-id>                             查看在线成员
-  role <from> <group-id> <member-aid> <admin|member>   设置成员角色
-  owner <from> <group-id> <new-owner-aid>               转让群主
-  ban <from> <group-id> [<member-aid>] [--duration N]   封禁成员；不带 member-aid 时列出封禁
-  unban <from> <group-id> <member-aid>                  解封成员
-
-Options:
-  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
-  --aun-path <path>     指定 AUN keystore 根
-  --format json         输出 JSON 格式
-  --encrypt             强制端到端加密（未指定时使用 daemon 默认值；仅 send）
-  --no-encrypt          强制明文发送（优先于 --encrypt；仅 send）
-  --thread <id>         指定话题 ID（仅 send）
-  --return <none|required> 跨会话发送必填（仅 send；Trigger 只能使用 none）
-  --mention <aid>       发送时 @ 某个成员（可多次，或用逗号分隔多个 aid）
-  --mention-all         发送时 @ 所有人
-  --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
-  --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
-  --text <说明>          附件说明文字（仅 --file 模式）
-  --transcript <text>   语音转写（仅 --as voice）
-  --group-id <aid>      指定自定义群 AID（仅 create）
-  --member-type <type>  定向邀请成员类型：human|ai（仅 invite）
-  --                    end-of-options：其后所有参数按正文处理
-                        （用于发送恰好等于某 flag 的文本，如 send a g -- --encrypt）
-
-格式示例（.example.invalid 是保留的虚构域，以下 AID 均不是真实地址）:
-  ec group create sender.example.invalid "Dev Team" --visibility private
-  ec group send sender.example.invalid 12345.example.invalid "hello team" --return none
-  ec group send sender.example.invalid 12345.example.invalid "@member 看下 PR" --mention member.example.invalid
-  ec group send sender.example.invalid 12345.example.invalid --file ./arch.png
-  ec group rules sender.example.invalid 12345.example.invalid set ./rules.md
-  ec group invite sender.example.invalid 12345.example.invalid member.example.invalid
-  ec group members sender.example.invalid 12345.example.invalid
-
-查询真实群 AID:
-  ec group list <发送方AID>`);
+  ack <from> <group-id> <seq> [--app <name>]           确认已读
+  history <from> <group-id> [--unread|--all]           查询本地群消息历史
+
+群管理:
+  create <from> <name> [--visibility public|private] [--description D]
+                       [--join-mode open|approval|invite_only|closed]  创建群
+  list <from> [--size N]                                列出我加入的群
+  info <from> <group-id>                                查看群详情
+  update <from> <group-id> [--name N] [--description D] 修改群信息
+  dissolve <from> <group-id>                            解散群
+  suspend <from> <group-id>                             暂停群
+  resume <from> <group-id>                              恢复群
+  rules <from> <group-id> get                          读取已发布群规则文件 /rules.md
+  rules <from> <group-id> set <file>                   上传并发布群规则文件
+  rules <from> <group-id> publish                      发布当前群空间 /rules.md
+  rules <from> <group-id> [--mode M] [--question Q] [--max-pending N]  查看/更新入群规则
+
+成员:
+  join <from> <group-id> [--message M] [--answer A]    申请加入
+  leave <from> <group-id>                              退出群
+  invite <from> <group-id> <member-aid> [<member-aid>...]   创建定向邀请
+  invites <from> [--page N] [--size N]                    查看收到的邀请
+  accept-invite <from> <invite-id>                         接受邀请
+  reject-invite <from> <invite-id>                         拒绝邀请
+  revoke-invite <from> <invite-id>                         撤回邀请
+  kick <from> <group-id> <member-aid>                  踢出成员
+  members <from> <group-id> [--page N] [--size N]      列出群成员
+  online <from> <group-id>                             查看在线成员
+  role <from> <group-id> <member-aid> <admin|member>   设置成员角色
+  owner <from> <group-id> <new-owner-aid>               转让群主
+  ban <from> <group-id> [<member-aid>] [--duration N]   封禁成员；不带 member-aid 时列出封禁
+  unban <from> <group-id> <member-aid>                  解封成员
+  block <from> <group-id> <member-aid> [--reason R]     屏蔽成员接收群消息
+  unblock <from> <group-id> <member-aid>                取消屏蔽
+  blocklist <from> <group-id>                            查看屏蔽列表（群管理员）
+  report-status <from> <group-id> --online-status O --work-status W  上报自己的状态
+  member-statuses <from> <group-id>                     查看成员上报状态（独立于 online）
+
+Options:
+  --app <name>          指定应用 slot（独立消费通道，不影响 daemon）
+  --aun-path <path>     指定 AUN keystore 根
+  --format json         输出 JSON 格式
+  --encrypt             强制端到端加密（未指定时使用 daemon 默认值；仅 send）
+  --no-encrypt          强制明文发送（优先于 --encrypt；仅 send）
+  --thread <id>         指定话题 ID（仅 send）
+  --return <none|required> 跨会话发送必填（仅 send；Trigger 只能使用 none）
+  --mention <aid>       发送时 @ 某个成员（可多次，或用逗号分隔多个 aid）
+  --mention-all         发送时 @ 所有人
+  --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
+  --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
+  --text <说明>          附件说明文字（仅 --file 模式）
+  --transcript <text>   语音转写（仅 --as voice）
+  --group-id <aid>      指定自定义群 AID（仅 create）；省略时生成 g- 加五位随机数字
+  --member-type <type>  定向邀请成员类型：human|agent（仅 invite）
+  --                    end-of-options：其后所有参数按正文处理
+                        （用于发送恰好等于某 flag 的文本，如 send a g -- --encrypt）
+
+格式示例（.example.invalid 是保留的虚构域，以下 AID 均不是真实地址）:
+  ec group create sender.example.invalid "Dev Team" --visibility private
+  ec group send sender.example.invalid 12345.example.invalid "hello team" --return none
+  ec group send sender.example.invalid 12345.example.invalid "@member 看下 PR" --mention member.example.invalid
+  ec group send sender.example.invalid 12345.example.invalid --file ./arch.png
+  ec group rules sender.example.invalid 12345.example.invalid set ./rules.md
+  ec group invite sender.example.invalid 12345.example.invalid member.example.invalid
+  ec group members sender.example.invalid 12345.example.invalid
+
+查询真实群 AID:
+  ec group list <发送方AID>
+
+群 AID 使用 base.issuer（如 ontology.example.invalid、g-12345.example.invalid）。
+群命令支持本域 base 简写；不再支持 group.issuer/base 或 base@issuer。
+g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g-99999。`);
         return;
     }
     const from = args[1];
@@ -1719,13 +1813,55 @@ Options:
         printGroupSendAidHint();
         process.exit(1);
     }
-    if (process.env.EVOLCORE_SESSION_ID && sub !== 'send') {
+    if ((process.env.EVOLCORE_SESSION_ID || (sub === 'history' && readDelegationCredential())) && sub !== 'send') {
         const result = await runManagedGroup(args, formatJson);
         renderManagedGroupResult(args, result, formatJson);
         return;
     }
-    const { groupSend, groupPull, groupAck, groupCreate, groupInfo, groupList, groupUpdate, groupDissolve, groupSuspend, groupResume, groupJoin, groupLeave, groupInvite, groupInvites, groupAcceptInvite, groupRejectInvite, groupRevokeInvite, groupKick, groupMembers, groupOnline, groupSetRole, groupTransferOwner, groupBan, groupUnban, groupBanlist, groupRules, groupUpdateRules, groupRulesFileGet, groupRulesFileSet, groupRulesFilePublish, } = await import('../aun/msg/index.js');
+    const { groupSend, groupPull, groupAck, groupHistory, parseGroupHistoryArgs, groupCreate, groupInfo, groupList, groupUpdate, groupDissolve, groupSuspend, groupResume, groupJoin, groupLeave, groupInvite, groupInvites, groupAcceptInvite, groupRejectInvite, groupRevokeInvite, groupKick, groupMembers, groupOnline, groupSetRole, groupTransferOwner, groupBan, groupUnban, groupBanlist, groupBlock, groupUnblock, groupBlocklist, groupReportStatus, groupMemberStatuses, groupRules, groupUpdateRules, groupRulesFileGet, groupRulesFileSet, groupRulesFilePublish, } = await import('../aun/msg/index.js');
     const commonOpts = { aunPath, slotId: appSlot };
+    if (['block', 'unblock', 'blocklist', 'report-status', 'member-statuses'].includes(sub)) {
+        // Share validation with the daemon; standalone connection options stay local.
+        const operationArgs = [];
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] === '--aun-path' || args[i] === '--app') {
+                if (args[i + 1] === undefined || args[i + 1].startsWith('--')) {
+                    failManagedGroup(formatJson, 'INVALID_ARGUMENT', `${args[i]} requires a value`);
+                }
+                i++;
+            }
+            else {
+                operationArgs.push(args[i]);
+            }
+        }
+        const { resolveManagedGroupOperation } = await import('../aun/msg/managed-operation.js');
+        const parsed = resolveManagedGroupOperation(operationArgs);
+        if (!parsed.ok)
+            failManagedGroup(formatJson, parsed.code, parsed.reason);
+        const command = parsed.command;
+        const base = { from: command.from, groupId: command.groupId, ...commonOpts };
+        let result;
+        switch (sub) {
+            case 'block':
+                result = await groupBlock({ ...base, memberAid: command.memberAid, reason: command.reason });
+                break;
+            case 'unblock':
+                result = await groupUnblock({ ...base, memberAid: command.memberAid });
+                break;
+            case 'blocklist':
+                result = await groupBlocklist(base);
+                break;
+            case 'report-status':
+                result = await groupReportStatus({ ...base, onlineStatus: command.onlineStatus, workStatus: command.workStatus });
+                break;
+            default:
+                result = await groupMemberStatuses(base);
+        }
+        if (!result.ok)
+            failManagedGroup(formatJson, result.code ?? 'GROUP_OPERATION_FAILED', result.error);
+        renderManagedGroupResult(operationArgs, result, formatJson);
+        return;
+    }
     // 通用 group_id 提取（第三参数）
     const requireGroupId = () => {
         const gid = args[2];
@@ -1734,12 +1870,14 @@ Options:
             printGroupSendAidHint();
             process.exit(1);
         }
-        if (!isExplicitGroupId(gid)) {
-            console.error(`❌ 第 2 个位置参数 <group-aid> 不是有效群 AID: ${gid}`);
+        try {
+            return normalizeGroupAid(gid, from.slice(from.indexOf('.') + 1));
+        }
+        catch (error) {
+            console.error(`❌ 第 2 个位置参数 <group-aid> 不是有效群 AID: ${gid}: ${error.message}`);
             printGroupSendAidHint();
             process.exit(1);
         }
-        return gid;
     };
     // 收集 --mention（可多次；每次的值支持逗号分隔多个 aid）
     const collectMentions = () => {
@@ -1852,6 +1990,16 @@ Options:
         return parts.join(' ');
     };
     // ---- 消息 ----
+    if (sub === 'history') {
+        try {
+            const result = groupHistory(parseGroupHistoryArgs(args));
+            renderManagedGroupResult(args, result, formatJson);
+        }
+        catch (error) {
+            failManagedGroup(formatJson, error.code || 'HISTORY_READ_FAILED', error instanceof Error ? error.message : String(error));
+        }
+        return;
+    }
     if (sub === 'send') {
         const groupId = requireGroupId();
         // Group sends use the dedicated AUN message daemon route rather than the
@@ -2049,9 +2197,11 @@ Options:
         });
         outputResult(result, () => {
             const r = result;
-            console.log(`✓ 已创建群 ${r.group?.group_id}`);
+            console.log(`✓ 已创建群 ${r.group?.group_aid ?? r.group?.group_id}`);
             console.log(`  名称: ${r.group?.name}`);
             console.log(`  可见性: ${r.group?.visibility}`);
+            if (r.warning)
+                console.warn(r.warning);
         });
         return;
     }
@@ -2133,18 +2283,18 @@ Options:
         const groupId = requireGroupId();
         const action = args[3];
         const printRulesFileUsage = () => {
-            console.log(`用法:
-  ec group rules <from> <group-id> get
-  ec group rules <from> <group-id> set <file>
-  ec group rules <from> <group-id> publish
-  ec group rules <from> <group-id> [--mode open|approval|invite_only|closed] [--question Q] [--max-pending N]
-
-说明:
-  get      读取当前已发布的群规则文件 /rules.md
-  set      上传本地文件到群空间 /rules.md，发布 rules.content 元数据，并发送 group.rules.updated 通知
-  publish  不上传文件，仅发布当前群空间 /rules.md 的元数据并发送通知
-
-兼容:
+            console.log(`用法:
+  ec group rules <from> <group-id> get
+  ec group rules <from> <group-id> set <file>
+  ec group rules <from> <group-id> publish
+  ec group rules <from> <group-id> [--mode open|approval|invite_only|closed] [--question Q] [--max-pending N]
+
+说明:
+  get      读取当前已发布的群规则文件 /rules.md
+  set      上传本地文件到群空间 /rules.md，发布 rules.content 元数据，并发送 group.rules.updated 通知
+  publish  不上传文件，仅发布当前群空间 /rules.md 的元数据并发送通知
+
+兼容:
   不带 get/set/publish 时仍使用旧的入群规则接口。`);
         };
         const printRulesFileState = (result, verb) => {
@@ -2292,8 +2442,8 @@ Options:
             }
         }
         const memberType = getArgValue(args, '--member-type');
-        if (memberType !== undefined && memberType !== 'human' && memberType !== 'ai') {
-            console.error('❌ --member-type 必须是 human 或 ai');
+        if (memberType !== undefined && memberType !== 'human' && memberType !== 'agent') {
+            console.error('❌ --member-type 必须是 human 或 agent');
             process.exit(1);
         }
         const result = await groupInvite({ from, groupId, members, memberType: memberType, ...commonOpts });
@@ -2449,7 +2599,7 @@ Options:
         });
         return;
     }
-    console.error(`未知子命令: ${sub}\n用法: ec group [send|pull|ack|create|list|info|update|dissolve|suspend|resume|rules|join|leave|invite|invites|accept-invite|reject-invite|revoke-invite|kick|members|online|role|owner|ban|unban]`);
+    console.error(`未知子命令: ${sub}\n用法: ec group [send|pull|ack|history|create|list|info|update|dissolve|suspend|resume|rules|join|leave|invite|invites|accept-invite|reject-invite|revoke-invite|kick|members|online|role|owner|ban|unban|block|unblock|blocklist|report-status|member-statuses]`);
     process.exit(1);
 }
 // ==================== Main ====================
@@ -2472,7 +2622,7 @@ const VALUE_FLAGS = new Set([
     '--as', '--content-type', '--mention', '--visibility', '--join-mode',
     '--group-id', '--name', '--message', '--answer', '--page', '--size',
     '--member-type',
-    '--aun-path', '--thread', '--return',
+    '--aun-path', '--thread', '--return', '--handoff-context',
 ]);
 const BOOLEAN_FLAGS = new Set([
     '--encrypt', '--no-encrypt', '--mention-all',