evolclaw 3.1.5 → 3.1.7

package/CHANGELOG.md

@@ -1,13 +1,78 @@
 # Changelog
 
+## v3.1.7 (2026-06-04)
+
+### New Features
+
+- **观察者模式（observable）** — `AgentConfig.observable` 开启后，AUN 入站/出站消息各转发一份给顶层 `owners[]`（`observer.forward` 格式），便于 owner 旁路监听 agent 会话
+
+### Improvements
+
+- **Trigger channelType 运行时解析** — 移除存储的 `Trigger.targetChannelType`，`buildSyntheticMessage` 改为运行时从 channel key 解析；trigger scheduler 注入与 `__upgrade-check` 播种移到 channel 注册之后，确保 `channelTypeMap` 完整
+
+### Bug Fixes
+
+- **watch 插件改名 ecweb → evolclaw-web** — npm 拒绝 `ecweb`（与 `rrweb` 过于相似），改为独立包 `evolclaw-web` 发布；`evolclaw watch` 的安装/调用引用同步更新
+- **cron trigger 紧密循环** — 定时器提前 ~1ms 唤醒（如 `0 9 * * *` 在 08:59:59.999 触发）会使下次触发落入 `now+50` 窗口被同轮重复触发；`nextCronFireAt` 从窗口外重算，循环守卫改读实时时钟确保收敛
+
+## 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(),