evolcore 0.0.19 → 0.0.21

package/CHANGELOG.md

@@ -3,6 +3,48 @@
 本文件记录 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 网关与投递可靠性
+
+- 接入 SDK 网关发现结果，校验消息 ID、投递状态和显式路由，区分永久失败与可重试失败。
+- Outbox 保留永久失败诊断，并以路由条件更新避免并发投递覆盖修正后的目标。
+
+### Bootstrap 与配置生命周期
+
+- 收紧 Bootstrap 消息路由和 Agent 生命周期门禁，补充配置兼容校验及 `ec init` 的 ecagent 配置交互。
+- 增加 Agent、Daemon 和默认配置 schema 版本，权限审计记录命中的策略路径。
+
+### 观察者模式
+
+- 观察者模式默认开启，显式设置 `false` 才关闭并持久化覆盖。
+
+### 跨平台运行与安装
+
+- 统一运行时根目录解析，延长 Windows Daemon IPC 优雅关闭等待，并完善 Codex 受管目录安装准备。
+
 ## 0.0.19 (2026-08-27)
 
 ### PowerShell EC 命令安全
@@ -18,7 +60,7 @@
 ### 跨平台安装与诊断
 
 - Windows 数据迁移固定调用系统 `bsdtar`，避免 Git Bash GNU tar 误解析 Windows 绝对路径。
-- Linux 安装器幂等创建真实 `/etc/codex` 目录，拒绝同名文件和符号链接。
+- Linux 公开安装器与 npm 全局安装/升级均幂等创建真实 `/etc/codex` 目录；root 历史实例可在启动任务时自愈缺失目录，同名文件和符号链接仍被拒绝。
 - 统一数据根解析，仅使用 `EVOLCORE_HOME` 或 `~/.evolcore`，避免因启动目录不同误用数据目录。
 - `ec start` 已运行提示新增 Daemon 持续运行时长，并支持 IPC uptime 回退探测。
 

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. 安装
@@ -103,6 +103,8 @@ curl -fsSL https://download.evolai.cn/install.sh | bash
 npm install -g evolcore
 ```
 
+Linux 全局安装会在 `postinstall` 阶段准备 Codex 受管运行所需的真实目录 `/etc/codex`。如果当前 npm 全局目录属于普通用户且该系统目录尚不存在，请先执行 `sudo install -d -m 0755 /etc/codex`，再重新安装。
+
 > **Windows 用户**：首次运行前可能需要执行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
 
 **从源码安装**：
@@ -141,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）
@@ -175,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
 {
@@ -198,6 +200,15 @@ Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接
       "queryParams": {
         "source": "evolcore"
       }
+    },
+    "ecagent": {
+      "baseUrl": "https://example.com/ecagent/v1",
+      "headers": {
+        "X-Tenant-Id": "${TENANT_ID}"
+      },
+      "queryParams": {
+        "source": "evolcore"
+      }
     }
   }
 }
@@ -205,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. 运行
 
@@ -267,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 渠道
@@ -378,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/bin/install-codex-managed-hooks.mjs

@@ -18,6 +18,59 @@ function fail(message) {
   process.exit(1);
 }
 
+function isGlobalInstall() {
+  return ['1', 'true'].includes(String(process.env.npm_config_global || '').toLowerCase());
+}
+
+function ensureRealDirectory(directory) {
+  let stat;
+  try {
+    stat = fs.lstatSync(directory);
+  } catch (error) {
+    if (error?.code !== 'ENOENT') {
+      fail(`could not inspect the Codex managed requirements mountpoint ${directory}: ${error?.message || String(error)}`);
+    }
+  }
+
+  if (stat) {
+    if (!stat.isDirectory() || stat.isSymbolicLink()) {
+      fail(`Codex managed requirements mountpoint is unsafe: ${directory} must be a real directory.`);
+    }
+    return;
+  }
+
+  try {
+    fs.mkdirSync(directory, { mode: 0o755 });
+    fs.chmodSync(directory, 0o755);
+  } catch (error) {
+    if (error?.code === 'EEXIST') {
+      const raced = fs.lstatSync(directory);
+      if (raced.isDirectory() && !raced.isSymbolicLink()) return;
+    }
+    fail(
+      `Linux global installation requires the real directory ${directory}, but it could not be created: `
+      + `${error?.message || String(error)}. `
+      + `Create it first with: sudo install -d -m 0755 ${directory}`,
+    );
+  }
+
+  const created = fs.lstatSync(directory);
+  if (!created.isDirectory() || created.isSymbolicLink()) {
+    fail(`Codex managed requirements mountpoint provisioning failed: ${directory} must be a real directory.`);
+  }
+  process.stdout.write(`[evolcore] Prepared Codex managed requirements mountpoint at ${directory}.\n`);
+}
+
+function runLinuxPostinstall() {
+  const explicitMountpoint = argument('--mountpoint');
+  if (process.platform !== 'linux') return;
+  // Local source installs do not launch the Linux Codex guard and must not
+  // mutate machine-wide configuration. An explicit path is accepted only for
+  // isolated lifecycle behavior tests.
+  if (!isGlobalInstall() && !explicitMountpoint) return;
+  ensureRealDirectory(explicitMountpoint || '/etc/codex');
+}
+
 function tomlString(value) {
   return JSON.stringify(value);
 }
@@ -139,6 +192,14 @@ try {
 }
 
 function main() {
+  if (process.env.npm_lifecycle_event === 'postinstall') {
+    runLinuxPostinstall();
+    return;
+  }
+  if (process.platform === 'linux' && argument('--mountpoint')) {
+    runLinuxPostinstall();
+    return;
+  }
   if (process.platform !== 'win32' && !argument('--requirements')) {
     fail('Codex managed hook provisioning is only supported on Windows.');
   }

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,
     };
 }