evolcore 0.0.20 → 0.0.21

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 本文件记录 EvolCore 的重要变更。EvolClaw 版本线的历史记录已归档至
 [`docs/_archive/CHANGELOG-evolclaw.md`](docs/_archive/CHANGELOG-evolclaw.md)。
 
+## 0.0.21 (2026-09-03)
+
+### 话题与权限控制
+
+- 新增话题 `/renew`，支持在空闲状态下安全续接话题后端会话，并强化并发操作与异常恢复处理。
+- 新增 `/fa`、`/fullaccess` 和持久 Fullaccess Trigger，统一 daemon-owner 授权、可信运行身份与审计记录。
+
+### 服务与消息管理
+
+- 统一本机服务和 AUN Service Proxy 的配置与旧版迁移，支持按实例配置本机服务及代理。
+- `ec msg history` 支持按完整渠道实例和原生对端 ID 查询已落盘的非 AUN 私聊历史。
+
+### AUN 投递与联系人
+
+- 完善 AUN Outbox 投递与回执处理，覆盖排队、重试、过期和永久失败等状态。
+- 新增联系人申请与 Owner 审核流程，并将联系人策略应用到托管私聊的入站和出站准入。
+
+### 安全与运行兼容
+
+- 加固 Codex Shell 载体解析、受管权限校验和受保护路径沙箱边界，并将受保护路径策略归入权限模块。
+- 统一 BaseAgent 请求地址和身份请求头处理，升级 AUN SDK 至 0.5.10，并兼容 Node.js 22.16.0。
+
 ## 0.0.20 (2026-08-28)
 
 ### AUN 网关与投递可靠性

package/README.md

@@ -78,7 +78,7 @@ ResponseEngine.processMessage()
 ### 环境要求
 
 - **操作系统**：macOS / Linux / Windows
-- **Node.js** >= 22.19.0（依赖 `node:sqlite`）
+- **Node.js** >= 22.16.0（依赖 `node:sqlite`，并与 AUN SDK 要求保持一致）
 - **Claude Code** >= 2.1.32（`npm install -g @anthropic-ai/claude-code`）
 
 ### 1. 安装
@@ -143,7 +143,7 @@ ec init aun
 ```
 
 交互式引导完成以下配置：
-- 环境检查（Node.js >= 22、claude CLI、SDK 版本）
+- 环境检查（Node.js >= 22.16.0、claude CLI、SDK 版本）
 - 渠道选择（飞书 / 微信 / 钉钉 / QQ 频道 / 企业微信 / AUN）并扫码登录
 - 默认项目路径
 - 模型选择（sonnet/opus/haiku）
@@ -177,8 +177,8 @@ ec init aun
 - `model`：配置文件 → `~/.claude/settings.json` → 默认 `sonnet`
 - `effort`：配置文件 → `~/.claude/settings.json` → SDK 默认值（`auto`）
 
-Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接在 EvolCore 的
-`baseagents` 配置中设置，不需要修改 Claude/Codex 的全局配置文件：
+Claude、Codex 或 EC Agent 兼容网关需要额外请求头或查询参数时，可以直接在 EvolCore 的
+`baseagents` 配置中设置，不需要修改各 base agent 的全局配置文件：
 
 ```json
 {
@@ -200,6 +200,15 @@ Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接
       "queryParams": {
         "source": "evolcore"
       }
+    },
+    "ecagent": {
+      "baseUrl": "https://example.com/ecagent/v1",
+      "headers": {
+        "X-Tenant-Id": "${TENANT_ID}"
+      },
+      "queryParams": {
+        "source": "evolcore"
+      }
     }
   }
 }
@@ -207,9 +216,48 @@ Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接
 
 `${VAR}` 会按 EvolCore 的环境变量规则展开。Claude 通过 `ANTHROPIC_CUSTOM_HEADERS`
 传递 Header；Codex app-server 启动时由 EvolCore 注入 `env_http_headers` 和
-`query_params`，所以不需要手改 `~/.codex/config.toml`。`queryParams` 不应放置密钥等敏感信息。
+`query_params`；EC Agent 主推理、模型列表和辅助推理直接在请求 URL 上追加参数。
+因此不需要手改 Claude/Codex 的全局配置文件。`queryParams` 不应放置密钥等敏感信息。
+
+完整设计、运行链路和排障说明见：[Baseagent 自定义请求元数据技术文档](docs/baseagent-request-metadata.md)。
+
+### Baseagent 模型与备用链
+
+Session Renew 的辅助模型配置与主模型、推理强度放在同一个
+`baseagents.<baseagent>` 块中，与 `responseMode` 正交。主模型故障备用链
+`fallbackModels` 只在 `agents/defaults.json` 中配置：
+
+```jsonc
+{
+  "baseagents": {
+    "claude": {
+      "model": "claude-opus",
+      "effort": "medium",
+      "auxiliaryModel": "claude-haiku-4-5-20251001",
+      "auxiliaryEffort": "low",
+      "fallbackModels": [
+        { "model": "claude-sonnet-4-5", "effort": "medium" },
+        { "model": "claude-haiku-4-5", "effort": "low" }
+      ]
+    },
+    "codex": {
+      "model": "gpt-5.6",
+      "effort": "high",
+      "auxiliaryModel": "gpt-5.6-sol",
+      "auxiliaryEffort": "medium",
+      "fallbackModels": [
+        { "model": "gpt-5.4", "effort": "medium" }
+      ]
+    }
+  }
+}
+```
+
+`auxiliaryEffort` 必须与同一 baseagent 块中的 `auxiliaryModel` 一起配置；未配置辅助模型时，
+Session Renew 按 `session_renew.fallback_action` 处理。`fallbackModels` 不会被辅助推理使用。
 
-完整设计、运行链路和排障说明见：[Claude/Codex 自定义请求元数据技术文档](docs/baseagent-request-metadata.md)。
+升级旧版本时，daemon 启动前会自动把模式桶中的辅助字段迁移到对应的 baseagent 块并创建备份。
+迁移逻辑集中在 `src/config/schema-migration.ts`，运行时不会回退读取旧字段。
 
 ### 3. 运行
 
@@ -269,10 +317,11 @@ evolcore/
 │   │   │   ├── session-fs-store.ts # 文件系统存储原语
 │   │   │   └── session-manager.ts  # 会话管理（多项目支持）
 │   │   ├── auth/                   # 授权审计与 Trigger 鉴权
+│   │   ├── permission/             # 权限策略与沙箱边界
+│   │   │   └── protected-paths.ts  # 受保护路径分级
 │   │   ├── evolagent.ts            # EvolAgent 实体
 │   │   ├── evolagent-registry.ts   # Agent 注册表（扫描/路由/热重载）
-│   │   ├── interaction-router.ts   # 卡片交互回调路由
-│   │   └── protected-paths.ts      # 受保护路径分级
+│   │   └── interaction-router.ts   # 卡片交互回调路由
 │   ├── channels/
 │   │   ├── feishu.ts               # 飞书 WebSocket 渠道
 │   │   ├── wechat.ts               # 微信 ClawBot 渠道
@@ -380,7 +429,7 @@ v3.2 新增进程级身份标识。启动时自动生成 `ec+5位数字.agentid.
 
 ## 技术栈
 
-- **运行时**：Node.js >= 22 + TypeScript（ES modules）
+- **运行时**：Node.js >= 22.16.0 + TypeScript（ES modules）
 - **AI 后端**：@anthropic-ai/claude-agent-sdk 0.3.220（固定版本）、Codex CLI app-server、Gemini CLI
 - **消息渠道**：飞书（@larksuiteoapi/node-sdk）、微信（ClawBot ilink API）、钉钉（dingtalk-stream）、QQ频道（pure-qqbot）、企业微信（AI Bot API）、AUN 网络
 - **数据存储**：文件系统（per-chat 目录） + JSONL（CLI 共用）

package/dist/agents/baseagent.js

@@ -28,12 +28,16 @@ const BASEAGENT_ALIASES = {
     geminicli: { canonical: 'gemini', displayName: 'Gemini CLI' },
     ecagent: { canonical: 'ecagent', displayName: 'ecagent' },
     'ec-agent': { canonical: 'ecagent', displayName: 'ecagent' },
-    hermes: { canonical: 'hermes', displayName: 'Hermes' },
 };
+const SUPPORTED_BASEAGENTS = new Set(['claude', 'codex', 'gemini', 'ecagent']);
 export function normalizeBaseagent(input) {
     const key = String(input || '').trim().toLowerCase().replace(/_/g, '-');
     return BASEAGENT_ALIASES[key] || { canonical: 'unknown', displayName: input ? String(input) : 'Unknown' };
 }
+export function isSupportedBaseagent(input) {
+    const key = String(input || '').trim().toLowerCase();
+    return SUPPORTED_BASEAGENTS.has(key);
+}
 function directInferencePair(apiKey, baseUrl) {
     const normalizedApiKey = directInferenceValue(apiKey);
     const normalizedBaseUrl = directInferenceValue(baseUrl);
@@ -232,7 +236,7 @@ export function resolveOpenaiDirectConfig(override) {
         }
         : undefined;
 }
-export function resolveOpenaiConfig(config, override) {
+export function resolveOpenaiConfig(config, override, runtime) {
     const codexSettings = loadCodexSettings();
     const isPlaceholder = (v) => !v || v.includes('your-') || v.includes('placeholder');
     const overrideApiKey = isPlaceholder(override?.apiKey) ? undefined : override?.apiKey;
@@ -279,8 +283,8 @@ export function resolveOpenaiConfig(config, override) {
         effort,
         enableRequestUserInput,
         approvalsReviewer,
-        evolcoreAgentAid: override?.evolcoreAgentAid ?? config.agents?.codex?.evolcoreAgentAid,
-        evolcoreAgentConfig: override?.evolcoreAgentConfig ?? config.agents?.codex?.evolcoreAgentConfig,
+        agentAid: runtime?.agentAid,
+        agentConfig: runtime?.agentConfig,
     };
 }
 export function resolveGoogleConfig(config, override) {
@@ -328,18 +332,18 @@ export function resolveEcagentConfig(config, override) {
         || DEFAULT_ECAGENT_BASE_URL;
     const model = override?.model || configured?.model || DEFAULT_ECAGENT_MODEL;
     const headers = normalizeStringMap(override?.headers ?? configured?.headers, 'headers');
+    const queryParams = normalizeStringMap(override?.queryParams ?? configured?.queryParams, 'queryParams');
     const effort = override?.effort ?? configured?.effort;
     const numberOr = (value, fallback) => (typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : fallback);
     return {
         apiKey,
         baseUrl,
         headers,
+        queryParams,
         model,
         effort,
         timeoutMs: numberOr(override?.timeoutMs ?? configured?.timeoutMs, DEFAULT_ECAGENT_TIMEOUT_MS),
         maxRetries: numberOr(override?.maxRetries ?? configured?.maxRetries, DEFAULT_ECAGENT_MAX_RETRIES),
         maxRetryDelayMs: numberOr(override?.maxRetryDelayMs ?? configured?.maxRetryDelayMs, DEFAULT_ECAGENT_MAX_RETRY_DELAY_MS),
-        evolcoreAgentAid: configured?.evolcoreAgentAid,
-        evolcoreAgentConfig: configured?.evolcoreAgentConfig,
     };
 }