evolclaw 3.1.5 → 3.1.6

package/CHANGELOG.md

@@ -1,13 +1,63 @@
 # Changelog
 
+## v3.1.6 (2026-06-03)
+
+### New Features
+
+- **AUN 图片附件支持** — AUN 私聊/群聊附件中的图片自动检测（元数据/文件名/magic bytes 三重检测），base64 编码后直接传给 Agent，不再要求 Read 工具读取
+- **selfAID session 注入** — 从 channel key 解析 selfAID，透传至 MessageBridge → CommandHandler → `getOrCreateSession`，修复 AUN 多身份场景 session 归属错误
+- **watch-web 单实例保护** — 启动前清理旧实例（按 instance 文件 + 端口兜底），端口冲突时自动切换并提示；前端新增 token 失效自动回配对页、退出按钮、配对码过期刷新
+
+### Improvements
+
+- **init 流程优化** — `cmdInit` 一次性写入所有可用 baseagents（不只写选中的那个）；新增 projects 默认目录询问步骤；默认项目路径改为 `EVOLCLAW_HOME/projects`；取消 init 后自动进入 `agent new`，改为打印提示
+- **1M 上下文窗口** — `claude-opus-4-8` / `claude-sonnet-4-6` 自动追加 `[1m]` 后缀，`autoCompactWindow` 随之调整为 900000
+- **上下文用量追踪** — complete 事件新增 `contextUsage`（totalTokens/maxTokens/percentage），`usage` 字段重命名为 `tokenUsage`，随 `status.completed` 元数据下发
+- **模型别名缓存 TTL** — 从 1h 缩短至 5min
+- **`/cli` 远程透传** — 经消息通道远程执行 CLI，仅 owner 可用，白名单只读+配置命令，spawn 无 shell，15s 超时 + 128KB 截断
+- **proximity ECK 注入** — `same_device/same_network/same_egress_ip` 从 V2 E2EE 解密结果提取，注入 venue.md 条件块渲染
+- **fastaun 0.4.9** — 含 SPKI 双格式指纹匹配（0.4.8）和 watch-web 单实例相关修复（0.4.9）
+
+### Bug Fixes
+
+- **Feishu merge_forward 内容重复** — 直接转发时丢弃 quotedText，避免内容重复
+- **Feishu seenMsg 文件写入** — 仅在有记录被 GC 清理时才重写文件；seenMessages 清空时改为 unlink
+- **peer-identity 验签** — 新增 `agentmd-unverified` 来源；缓存命中时从 `verify_status` 恢复验签状态，修复 source 误降级
+- **process-introspect** — 改用 `/proc/stat btime`（绝对 epoch）替代 uptime 计算进程启动时间，修复长时间运行后 PID 复用误判
+- **evolagent.load IPC 超时** — AUN WebSocket 冷启动常 >3s，IPC 超时从默认值调整为 30s
+- **交互路由 markWaiting/unmarkWaiting** — 新增提前占位方法，适配异步发卡片场景的等待计数
+
 ## v3.1.5 (2026-06-02)
 
+### New Features
+
+- **Web 监控面板（watch-web）** — 全新 `evolclaw watch` Web 面板：实时会话视图、对话视图、AID 状态、消息流，含上下文大小与费用估算；新增 `src/cli/watch-web/` server + 静态前端 + session/msg/aid 数据源
+- **CLI model 命令** — 新增 `src/cli/model.ts`：动态模型目录管理，`/models` 端点拉取（1h 缓存）+ 静态表 fallback，注入已验证但未上线 API 的模型
+- **飞书交互卡片 JSON 2.0 + 表单** — `FeishuCardManager` 管理 CardKit 实体生命周期，`buildActionCardV2()` 表单卡片，动态输入框追加（card.element.create API）
+- **proactive→interactive 模式切换提示** — 模式切换时注入提示信息
+
+### Improvements
+
+- **AUN/AID 三主体模型重构** — fastaun 0.3.3 → 0.4.7 大版本跨越：适配三主体模型与 slot 隔离键，`createAid` 拆分为 `registerAid` + `authenticate`，新增 `AIDStore`，`uploadAgentMd` 迁移至 AIDStore
+- **ECK 上下文组装体系对齐** — 四阶段改造：channelKey 第二段 `selfPeerId`→`selfAID`，sessions 目录统一三层化 `<channelType>/<selfAID>/<channelId>/`，新增 `peer-key.ts` helper，ECK manifest 诊断输出
+- **Session 持久化重构** — 统一 `persistSession(session, intent, opts)` 原语替代 `writeSessionIfChanged`/快照模式，内置去重，`markProcessing`/`clearProcessing` 不再扫描全部 chat 目录
+- **idle-check 消息队列可靠性** — 提升空闲检测与消息队列稳定性
+- **飞书卡片 schema 2.0 统一** — 交互卡片统一为 schema 2.0 inline，用户交互期间暂停 idle monitor，修复 V2 卡片回调 schema 不一致（error 200830/200810）
+- **IPC 出站统计** — 新增 `aun-aid-stats-record-outbound` IPC handler，p2p/group/thought.put 出站消息统计追踪
+- **/model 列表逻辑简化** — `listModels` 走缓存，model 显示标签同时展示完整 ID 与短别名
+- **清理冗余日志与代码** — 移除过时诊断日志和未使用的 skills 代码
+
 ### Bug Fixes
 
-- **Trigger channelType 传播** — Trigger 新增 `targetChannelType` 字段，`buildSyntheticMessage` 正确填充 `channelType`，修复触发器消息无法创建 session 的问题
-- **Session mapper 过滤 channelName** — `sessionToFile` 不再将 `channelName` 写入 metadata
+- **Trigger channelType 传播** — Trigger 新增 `targetChannelType` 字段，`buildSyntheticMessage` 正确填充 `channelType`，修复触发器消息无法创建 session
+- **session selfAID/channelType 注入** — 修复 session 创建时 selfAID 与 channelType 注入缺失
+- **/model 短别名解析** — `/model sonnet` 等短别名正确解析为完整 model ID
+- **aidCreate 成功路径泄漏 AIDStore** — 修复 AID 创建成功后 AIDStore 资源泄漏
+- **peer-identity type 解析** — 修复对端身份类型解析错误
+- **飞书卡片标题重复 emoji** — 修复 resolved card 标题与 checkers summary 中的双 emoji
+- **消息可靠性与 session 迁移** — 提升消息投递可靠性，改进 session 迁移逻辑
+- **session-mapper 过滤 channelName** — `sessionToFile` 不再将 `channelName` 写入 metadata
 - **resolveChatDirFromSession 严格校验** — 缺失 `channelType` 时抛出明确错误而非静默 fallback
-- **/model 别名解析** — `/model sonnet` 等短别名正确解析为完整 model ID
 - **test 脚本修复** — `package.json` test 脚本改为 `vitest run`
 
 ## v3.1.4 (2026-05-27)

package/dist/agents/claude-runner.js

@@ -24,7 +24,7 @@ const STATIC_MODEL_ALIASES = {
     'sonnet': 'claude-sonnet-4-6',
     'haiku': 'claude-haiku-4-5-20251001',
 };
-const MODEL_ALIAS_TTL_MS = 60 * 60 * 1000; // 1h
+const MODEL_ALIAS_TTL_MS = 5 * 60 * 1000; // 5min
 const modelAliasCache = new Map(); // key: baseUrl
 const modelAliasInFlight = new Set(); // 去重并发刷新
 /** 从模型 ID 列表中提取各 claude 系列的最新版本（按 major.minor 取最高） */
@@ -70,9 +70,9 @@ async function refreshModelAliases(baseUrl, apiKey) {
             ? json.data.map((m) => m?.id).filter((x) => typeof x === 'string')
             : [];
         const aliases = deriveAliasesFromModelIds(ids);
-        if (Object.keys(aliases).length > 0) {
-            modelAliasCache.set(baseUrl, { aliases, fetchedAt: Date.now() });
-            logger.info(`[AgentRunner] Refreshed model aliases from ${url}: ${JSON.stringify(aliases)}`);
+        if (ids.length > 0 || Object.keys(aliases).length > 0) {
+            modelAliasCache.set(baseUrl, { aliases, ids, fetchedAt: Date.now() });
+            logger.info(`[AgentRunner] Refreshed models from ${url}: ${ids.length} ids, aliases ${JSON.stringify(aliases)}`);
         }
     }
     catch {
@@ -97,6 +97,27 @@ function resolveModelAlias(model, baseUrl) {
     // 回退静态表
     return STATIC_MODEL_ALIASES[model] || model;
 }
+/** 支持 1M 上下文窗口的模型 ID 前缀（SDK 通过 `[1m]` 后缀启用）。 */
+const ONE_M_CONTEXT_PREFIXES = ['claude-opus-4-8', 'claude-sonnet-4-6'];
+/**
+ * 为支持 1M 上下文的模型追加 `[1m]` 后缀——仅在交给 SDK query() 时调用。
+ * 目录与校验层始终使用不带后缀的基础 ID，避免与网关 /models 返回值（无 `[1m]`）冲突。
+ */
+function applyContextWindow(modelId) {
+    if (/\[1m\]$/.test(modelId))
+        return modelId; // 已带后缀
+    if (ONE_M_CONTEXT_PREFIXES.some(p => modelId === p))
+        return `${modelId}[1m]`;
+    return modelId;
+}
+/** 根据 SDK model 串（含 [1m] 后缀）返回合适的 autoCompactWindow 值。 */
+function contextWindowFor(sdkModel) {
+    return /\[1m\]$/.test(sdkModel) ? 900000 : 200000;
+}
+/** 解析别名 + 追加 1M 后缀，得到最终交给 SDK 的 model 串。 */
+function resolveSdkModel(model, baseUrl) {
+    return applyContextWindow(resolveModelAlias(model, baseUrl));
+}
 class MessageStream {
     queue = [];
     waiting = null;
@@ -213,16 +234,23 @@ export class AgentRunner {
     getModel() {
         return this.model;
     }
-    listModels() {
-        // 触发异步刷新（不阻塞）
-        if (this.baseUrl)
-            refreshModelAliases(this.baseUrl, this.apiKey);
-        // 有缓存时返回完整 ID 列表，否则返回短别名
+    async listModels() {
         if (this.baseUrl) {
-            const cached = modelAliasCache.get(this.baseUrl);
-            if (cached)
-                return Object.values(cached.aliases);
+            let cached = modelAliasCache.get(this.baseUrl);
+            const stale = !cached || (Date.now() - cached.fetchedAt > MODEL_ALIAS_TTL_MS);
+            // 缓存为空（首次打开）→ 等待刷新；缓存仅过期 → 后台刷新不阻塞
+            if (!cached) {
+                await refreshModelAliases(this.baseUrl, this.apiKey);
+                cached = modelAliasCache.get(this.baseUrl);
+            }
+            else if (stale) {
+                refreshModelAliases(this.baseUrl, this.apiKey);
+            }
+            // 有缓存时返回网关 /models 的全量原始 ID
+            if (cached && cached.ids.length > 0)
+                return cached.ids;
         }
+        // 无 baseUrl / 刷新超时或失败 → 回退短别名
         return Object.values(STATIC_MODEL_ALIASES);
     }
     /** 将短别名解析为当前代理实际使用的完整 model ID（仅用于展示，不改变持久化值） */
@@ -413,11 +441,8 @@ export class AgentRunner {
                 }
                 continue;
             }
-            // 等待用户交互（unmark 占位，register 接管计数）
-            if (waitMarked) {
-                permCtx?.interactionRouter?.unmarkWaiting(sessionId);
-                waitMarked = false;
-            }
+            // 等待用户交互：先 register 接管计数，再 unmark 占位，消除空窗期
+            // （unmark 必须在 register 之后，否则计数短暂降为 0 触发 onWaitEnd→resume，idle 时钟被重置）
             const answer = await new Promise((resolve) => {
                 permCtx?.interactionRouter?.register(requestId, sessionId, (action, values) => {
                     if (action === 'cancel') {
@@ -442,6 +467,11 @@ export class AgentRunner {
                         resolve(action);
                     }
                 });
+                // register 已接管计数（计数 +1），现在才能安全释放 markWaiting 占位（计数 -1），避免空窗
+                if (waitMarked) {
+                    permCtx?.interactionRouter?.unmarkWaiting(sessionId);
+                    waitMarked = false;
+                }
             });
             if (answer === null) {
                 const firstLabel = q.options[0]?.label || '';
@@ -656,7 +686,7 @@ export class AgentRunner {
      * SDK 原始事件 → 标准 AgentEvent 转换
      * 所有 SDK 特有的事件类型引用封装在此方法内
      */
-    async *transformStream(sdkStream, sessionId) {
+    async *transformStream(sdkStream, sessionId, callModel, callEffort, sdkModel) {
         let lastSessionId;
         // tool_use_id → tool_name 映射，用于从 SDKUserMessage 的 tool_result 块中还原工具名
         const toolUseNames = new Map();
@@ -760,6 +790,19 @@ export class AgentRunner {
                     const cleanResult = typeof event.result === 'string'
                         ? event.result.replace(/<thinking>[\s\S]*?<\/thinking>\s*/g, '').trim()
                         : event.result;
+                    // 从 usage 三项求和得到当前上下文占用（与 claude-hud getTotalTokens 相同算法）
+                    const u = event.usage;
+                    const totalTokens = u
+                        ? (u.input_tokens ?? 0) + (u.cache_creation_input_tokens ?? 0) + (u.cache_read_input_tokens ?? 0)
+                        : 0;
+                    const maxTokens = sdkModel ? contextWindowFor(sdkModel) : 200000;
+                    const contextUsage = totalTokens > 0 ? {
+                        totalTokens,
+                        maxTokens,
+                        percentage: Math.round((totalTokens / maxTokens) * 100),
+                        model: callModel ?? this.model,
+                        effort: callEffort ?? this.effort,
+                    } : undefined;
                     yield {
                         type: 'complete',
                         result: cleanResult,
@@ -772,7 +815,8 @@ export class AgentRunner {
                         terminalReason: event.terminal_reason,
                         sessionTitle: event.session_title,
                         numTurns: event.num_turns,
-                        usage: event.usage,
+                        tokenUsage: event.usage,
+                        contextUsage,
                     };
                     // result 是 SDK 流的终结事件，不再等待后续（防止 interrupt 后流不关闭导致挂起）
                     return;
@@ -980,12 +1024,13 @@ export class AgentRunner {
         else {
             logger.info(`[AgentRunner] systemPromptAppend: none`);
         }
+        const sdkModel = resolveSdkModel(callModel, this.baseUrl);
         const commonOptions = {
             cwd: projectPath,
-            model: resolveModelAlias(callModel, this.baseUrl),
+            model: sdkModel,
             ...(callEffort ? { effort: callEffort } : {}),
             ...(this.claudeExecutablePath ? { pathToClaudeCodeExecutable: this.claudeExecutablePath } : {}),
-            autoCompactWindow: 200000,
+            autoCompactWindow: contextWindowFor(sdkModel),
             advisorModel: 'haiku',
             canUseTool: canUseToolCallback,
             permissionMode: sdkPermissionMode,
@@ -1110,7 +1155,7 @@ export class AgentRunner {
         }
         let sdkStream;
         if (images && images.length > 0) {
-            logger.debug('[AgentRunner] Creating query with images, images:', images.length);
+            logger.info('[AgentRunner] Creating query with images:', images.length, 'first image size:', images[0]?.data?.length ?? 0);
             logger.debug('[AgentRunner] Skipping resume for image message to avoid history conflict');
             const stream = new MessageStream();
             stream.push(prompt, images);
@@ -1126,7 +1171,7 @@ export class AgentRunner {
             this.interruptFns.set(sessionId, () => sdkStream.interrupt());
         }
         // 返回标准 AgentEvent 流（重试由 MessageProcessor 层负责）
-        return this.transformStream(sdkStream, sessionId);
+        return this.transformStream(sdkStream, sessionId, callModel, callEffort, sdkModel);
     }
     async interrupt(sessionId) {
         const fn = this.interruptFns.get(sessionId);
@@ -1165,7 +1210,7 @@ export class AgentRunner {
             prompt,
             options: {
                 cwd: projectPath,
-                model: resolveModelAlias(this.model, this.baseUrl),
+                model: resolveSdkModel(this.model, this.baseUrl),
                 resume: agentSessionId,
                 maxTurns: 1,
                 permissionMode: this.toSdkPermissionMode(),

package/dist/agents/kit-renderer.js

@@ -19,6 +19,9 @@ const PARAM_DESCRIPTIONS = {
     peerName: '对端显示名',
     peerRole: '对端角色（owner/admin/guest/anonymous）',
     peerType: '对端类型（human/agent）',
+    sameDevice: '对端与本端同一物理设备（E2EE 消息 proximity，仅加密消息有值）',
+    sameNetwork: '对端与本端在同一网络内',
+    sameEgressIp: '对端与本端共享同一出口 IP',
     groupId: '群组 ID（群聊时）',
     chatType: '聊天类型（private=私聊 / group=群聊 / null=本地开发）',
     channel: '渠道类型（aun/feishu/wechat/dingtalk/qqbot/wecom）',
@@ -32,12 +35,19 @@ const PARAM_DESCRIPTIONS = {
     sessionName: '会话名称',
     sessionKey: '会话路由键（channelType#urlEncode(channelId)#urlEncode(threadId)）',
     sessionCreatedAt: '会话创建时间（ISO）',
+    timezone: 'IANA 时区名（把 ISO 时间戳转本地时间用，如 Asia/Shanghai）',
+    tzOffset: '当前 UTC 偏移（如 +08:00）',
+    osInfo: '操作系统及版本（如 Windows 11 Pro (win32 10.0.26200)）',
     threadId: '话题 ID（多话题路由时）',
     chatMode: '会话模式（interactive=同步交互 / proactive=主动推送）',
     readonly: '是否只读模式',
+    evolclawMode: 'evolclaw 运行模式（dev=源码仓库可直接修改 | install=全局安装包只读）',
     baseAgent: 'base agent 规范值（claude/codex/gemini/hermes）',
     baseAgentName: 'base agent 显示名',
-    baseAgentModel: 'base agent 使用的模型',
+    baseAgentModel: 'base agent 引擎底座模型（evolclaw 作用域无配置时的兜底）',
+    effectiveModel: '当前实际生效模型（关系级 > agent级 > 全局 优先级解析结果）',
+    modelFallbackActive: 'evolclaw 配置的模型不可用，当前正在使用降级模型',
+    modelFallbackModel: '当前降级使用的 base agent 模型名',
     agentSessionId: 'base agent 会话 ID',
 };
 function buildPathMappings(vars) {
@@ -355,9 +365,10 @@ function isTruthy(val) {
 // CHUNK_CONTINUE_6
 // ── Template rendering ──
 function resolveConditions(template, vars) {
-    // Find innermost {{?...}}...{{/}} block (no nested {{? inside) and resolve it.
-    // Repeat until no blocks remain.
-    const inner = /\{\{\?(\w+)(?:(!=|=)([^}]*))?\}\}([^]*?)\{\{\/\}\}/;
+    // 只匹配**最内层** {{?...}}...{{/}} 块：body 内不允许再出现 {{? ，
+    // 否则非贪婪 ([^]*?) 会匹配到嵌套内层的 {{/}}，导致外层提前闭合、残留多余 {{/}}。
+    // 逐字符负向前瞻 (?!\{\{\?) 排除嵌套起始，配合 do/while 由内向外逐层消解。
+    const inner = /\{\{\?(\w+)(?:(!=|=)([^}]*))?\}\}((?:(?!\{\{\?)[^])*?)\{\{\/\}\}/;
     let result = template;
     let prev;
     do {

package/dist/aun/aid/agentmd.js

@@ -110,6 +110,10 @@ export async function agentmdPut(content, opts) {
  * Check if agent.md is up-to-date (30-day TTL), fetch if changed.
  * Returns changed=true + content when a new version was downloaded.
  *
+ * verification 透传 SDK 的验签结果：
+ * - downloaded（changed=true）时为 SDK downloadAgentMd 的 verification
+ * - 命中本地缓存或网络失败 fallback 时为 undefined（调用方需自行离线验签或视为未验证）
+ *
  * Note: store.checkAgentMd tracks freshness via the store's in-memory cache,
  * so a freshly-built store reports local_found=false and will fetch.
  */
@@ -120,16 +124,19 @@ export async function agentmdSync(aid, opts) {
     const localPath = agentMdPath(aid);
     try {
         const check = await store.checkAgentMd(aid, 30);
-        // In sync (cache fresh) — return local file content unchanged.
+        // In sync (cache fresh) — return local file content with cached verification status.
         if (check.ok && !check.data.needs_update && check.data.local_found) {
             const content = fs.existsSync(localPath) ? fs.readFileSync(localPath, 'utf-8') : undefined;
-            return { changed: false, content };
+            const verification = check.data.verify_status
+                ? normalizeVerification({ status: check.data.verify_status, reason: check.data.verify_error || undefined })
+                : undefined;
+            return { changed: false, content, verification };
         }
         // Needs update (or check failed) — fetch fresh content.
         // SDK's downloadAgentMd persists to disk internally (AgentMdManager.saveRecord → writeContent).
         const fetched = await store.downloadAgentMd(aid);
         if (fetched.ok) {
-            return { changed: true, content: fetched.data.content };
+            return { changed: true, content: fetched.data.content, verification: normalizeVerification(fetched.data.verification) };
         }
         // Fetch failed (network) — fall back to local file if present.
         const content = fs.existsSync(localPath) ? fs.readFileSync(localPath, 'utf-8') : undefined;

package/dist/aun/msg/group.js

@@ -70,11 +70,11 @@ export async function groupPull(args) {
 export async function groupAck(args) {
     const conn = await createShortConnection(args.from, { aunPath: args.aunPath, slotId: args.slotId });
     try {
-        const result = await conn.call('group.ack', { group_id: args.groupId, seq: args.seq });
+        const result = await conn.call('group.ack', { group_id: args.groupId, msg_seq: args.seq });
         return {
             ok: true,
             group_id: result?.group_id ?? args.groupId,
-            ack_seq: result?.ack_seq ?? args.seq,
+            ack_seq: result?.cursor ?? result?.ack_seq ?? args.seq,
             latest_message_seq: result?.latest_message_seq,
         };
     }

package/dist/channels/aun.js

@@ -576,7 +576,7 @@ export class AUNChannel {
         const store = await getAidStore({
             slotId: SLOT.daemon,
             aunPath,
-            debug: this.config.aunSdkLog ?? true,
+            debug: this.config.aunSdkLog ?? false,
         });
         this.store = store;
         const client = await loadClient(store, aidName);
@@ -790,18 +790,16 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
 
 📋 **日常使用方法**：
 
-1. **绑定项目**：发送 \`/bind <项目路径>\` 绑定工作目录
-2. **查看帮助**：发送 \`/help\` 查看所有可用命令
-3. **切换项目**：发送 \`/project <项目名>\` 切换到其他项目
-4. **查看状态**：发送 \`/status\` 查看当前会话状态
-5. **会话管理**：发送 \`/session\` 查看和切换会话
+1. **查看帮助**：发送 \`/help\` 查看所有可用命令
+2. **查看状态**：发送 \`/status\` 查看当前会话状态
+3. **会话管理**：发送 \`/session\` 查看和切换会话
 
 💡 **提示**：
 - 直接发送消息即可与 Claude/Codex 对话
-- 支持多项目会话管理，每个项目独立会话
+- 支持多会话管理，每个会话独立上下文
 - 所有命令以 \`/\` 开头
 
-现在，请先使用 \`/bind\` 命令绑定您的项目目录，然后就可以开始工作了！`;
+现在就可以开始工作了！`;
             // First contact with Owner races against Owner's async cert fetch from
             // gateway PKI; a 3s pause lets the cert propagate. persist_required asks
             // the gateway to durably store the message so Owner can recover it via
@@ -818,6 +816,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 persist_required: true,
             });
             logger.info(`${this.logPrefix()} Welcome message sent to owner: ${owner}`);
+            // Send binding credential for Evol App to persist locally
+            await this.sendBindingCredential(owner, agentDisplayName, agentConfig.active_baseagent || 'claude').catch(e => logger.warn(`${this.logPrefix()} Binding credential failed: ${e}`));
             // Mark agent as initialized in config.json (replaces old agent.md frontmatter flag)
             try {
                 const fresh = loadAgent(aidName);
@@ -835,7 +835,57 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             logger.warn(`${this.logPrefix()} Failed to send welcome message: ${e}`);
         }
     }
+    async sendBindingCredential(owner, name, baseagent) {
+        if (!this.client)
+            return;
+        await this.callAndTrace('message.send', {
+            to: owner,
+            payload: { type: 'binding', aid: this.config.aid, name, owner, baseagent },
+            encrypt: true,
+            persist_required: true,
+        });
+        logger.info(`${this.logPrefix()} Binding credential sent to owner: ${owner}`);
+    }
     // ── Event handlers ──────────────────────────────────────────
+    /**
+     * 判断附件是否为图片，返回 MIME 类型（非图片返回空）。
+     * 多重检测：附件元数据字段 → 文件名后缀 → 文件 magic bytes。
+     */
+    detectImageMime(att, filePath) {
+        const extToMime = {
+            '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+            '.gif': 'image/gif', '.webp': 'image/webp',
+        };
+        // 1. 附件元数据字段（content_type / mime_type / mimeType）
+        const metaCt = (att?.content_type || att?.mime_type || att?.mimeType || '');
+        if (typeof metaCt === 'string' && metaCt.startsWith('image/'))
+            return metaCt;
+        // 2. 文件名后缀
+        const name = (att?.filename || att?.object_key || filePath || '').toLowerCase();
+        for (const [ext, mime] of Object.entries(extToMime)) {
+            if (name.endsWith(ext))
+                return mime;
+        }
+        // 3. magic bytes
+        try {
+            const { openSync, readSync, closeSync } = require('node:fs');
+            const fd = openSync(filePath, 'r');
+            const head = Buffer.alloc(12);
+            readSync(fd, head, 0, 12, 0);
+            closeSync(fd);
+            if (head[0] === 0x89 && head[1] === 0x50 && head[2] === 0x4e && head[3] === 0x47)
+                return 'image/png';
+            if (head[0] === 0xff && head[1] === 0xd8 && head[2] === 0xff)
+                return 'image/jpeg';
+            if (head[0] === 0x47 && head[1] === 0x49 && head[2] === 0x46)
+                return 'image/gif';
+            if (head[0] === 0x52 && head[1] === 0x49 && head[2] === 0x46 && head[3] === 0x46 &&
+                head[8] === 0x57 && head[9] === 0x45 && head[10] === 0x42 && head[11] === 0x50)
+                return 'image/webp';
+        }
+        catch { /* not readable, skip */ }
+        return '';
+    }
     async downloadAttachment(att, channelId) {
         const ownerAid = att.owner_aid || this._aid || '';
         const objectKey = att.object_key;
@@ -844,7 +894,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             return null;
         }
         const filename = att.filename || objectKey.split('/').pop() || 'unknown';
-        let downloadUrl;
+        // 安全：始终通过受信任的 ticket 路径获取下载 URL。
+        // 不信任 att.url（来自对端消息 payload，可被构造为内网/元数据地址，SSRF）。
+        let downloadUrl = '';
         try {
             const ticket = await this.callAndTrace('storage.create_download_ticket', {
                 owner_aid: ownerAid,
@@ -924,12 +976,21 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
         // Process attachments (顶层 + 嵌套在 merge.items / quote.quote 中的)
         const rawAttachments = this.collectAllAttachments(payload);
         let finalText = text;
+        const inboundImages = [];
         if (rawAttachments.length > 0 && this.client) {
             const fileParts = [];
             for (const att of rawAttachments) {
                 const filePath = await this.downloadAttachment(att, fromAid);
                 if (filePath) {
                     const name = sanitizeFileName(att.filename || att.object_key?.split('/').pop() || 'file');
+                    const mime = this.detectImageMime(att, filePath);
+                    if (mime) {
+                        try {
+                            const { readFileSync } = await import('node:fs');
+                            inboundImages.push({ data: readFileSync(filePath).toString('base64'), mimeType: mime });
+                        }
+                        catch { /* fallback to file path */ }
+                    }
                     fileParts.push(`[文件: ${name} → ${filePath}]`);
                 }
             }
@@ -938,9 +999,11 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 if (text)
                     parts.push(text);
                 parts.push(...fileParts);
-                parts.push('请使用 Read 工具读取文件内容。');
+                if (inboundImages.length === 0)
+                    parts.push('请使用 Read 工具读取文件内容。');
                 finalText = parts.join('\n\n');
             }
+            logger.info(`${this.logPrefix()} [img-debug] private attachments=${rawAttachments.length} images=${inboundImages.length}`);
         }
         // 私聊 channelId = 对端 AID（不再读 payload.chat_id 含 device 三段式）
         // device_id 仅 SDK 内部多实例去重用，evolclaw session 层面跨端共享会话
@@ -993,7 +1056,11 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             mentions,
             peerName: displayName || undefined,
             peerType: peerIdentity.type,
+            sameDevice: msg.same_device === true || undefined,
+            sameNetwork: msg.same_network === true || undefined,
+            sameEgressIp: msg.same_egress_ip === true || undefined,
             replyContext,
+            images: inboundImages.length > 0 ? inboundImages : undefined,
         });
     }
     async handleIncomingGroupMessage(data) {
@@ -1144,12 +1211,21 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             : mentionedSelf && this._aid ? [this._aid] : [];
         // Process attachments
         let finalText = strippedText;
+        const inboundImages = [];
         if (hasAttachments && this.client) {
             const fileParts = [];
             for (const att of rawAttachments) {
                 const filePath = await this.downloadAttachment(att, groupId);
                 if (filePath) {
                     const name = sanitizeFileName(att.filename || att.object_key?.split('/').pop() || 'file');
+                    const mime = this.detectImageMime(att, filePath);
+                    if (mime) {
+                        try {
+                            const { readFileSync } = await import('node:fs');
+                            inboundImages.push({ data: readFileSync(filePath).toString('base64'), mimeType: mime });
+                        }
+                        catch { /* fallback to file path */ }
+                    }
                     fileParts.push(`[文件: ${name} → ${filePath}]`);
                 }
             }
@@ -1158,7 +1234,8 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
                 if (strippedText)
                     parts.push(strippedText);
                 parts.push(...fileParts);
-                parts.push('请使用 Read 工具读取文件内容。');
+                if (inboundImages.length === 0)
+                    parts.push('请使用 Read 工具读取文件内容。');
                 finalText = parts.join('\n\n');
             }
         }
@@ -1191,6 +1268,9 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             userId: senderAid,
             peerName: displayName || undefined,
             peerType: peerIdentity.type,
+            sameDevice: msg.same_device === true || undefined,
+            sameNetwork: msg.same_network === true || undefined,
+            sameEgressIp: msg.same_egress_ip === true || undefined,
             text: finalText,
             chatType: 'group',
             messageId,
@@ -1198,6 +1278,7 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             threadId,
             mentions,
             replyContext: this.buildGroupReplyContext(threadId, senderAid, msgEncrypted, messageId, msgChatmode),
+            images: inboundImages.length > 0 ? inboundImages : undefined,
         });
     }
     dispatchMessage(event) {
@@ -1260,10 +1341,14 @@ EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
             peerId: event.userId || event.channelId || '',
             peerName: event.peerName,
             peerType: event.peerType,
+            sameDevice: event.sameDevice,
+            sameNetwork: event.sameNetwork,
+            sameEgressIp: event.sameEgressIp,
             messageId: event.messageId,
             threadId: event.threadId,
             mentions: mentionObjects,
             replyContext,
+            images: event.images,
         }).catch(err => {
             logger.error(`${this.logPrefix()} Message handler error:`, err);
         });
@@ -2444,7 +2529,7 @@ export class AUNChannelPlugin {
             const adapter = {
                 channelName: inst.name,
                 channelKey: inst.name, // channelName 实际上就是 channelKey
-                capabilities: { file: true, image: true, interaction: true, markdown: true, thought: true, status: true },
+                capabilities: { file: true, image: true, interaction: true, markdown: true, thought: true, status: true, thread: true },
                 send: async (envelope, payload) => {
                     const ctx = envelope.replyContext;
                     const channelId = envelope.channelId;
@@ -2637,6 +2722,7 @@ export class AUNChannelPlugin {
                             threadId: opts.threadId,
                             replyContext: opts.replyContext,
                             source: opts.source,
+                            images: opts.images,
                         });
                     }), (channelId, text, replyContext) => channel.sendMessage(channelId, text, replyContext), adapter, channelType);
                 },

package/dist/channels/dingtalk.js

@@ -448,7 +448,7 @@ export class DingtalkChannelPlugin {
             const adapter = {
                 channelName: inst.name,
                 channelKey: inst.name,
-                capabilities: { file: true, image: true, interaction: false, markdown: true, thought: false, status: false },
+                capabilities: { file: true, image: true, interaction: false, markdown: true, thought: false, status: false, thread: false },
                 send: async (envelope, payload) => {
                     const ctx = envelope.replyContext;
                     const channelId = envelope.channelId;