evolcore 0.0.22 → 0.0.23

package/AGENTS.md

@@ -0,0 +1,62 @@
+# AGENTS.md
+
+EvolCore 仓库的通用 AI agent 指引。与 CLAUDE.md 并列，供 Codex、Gemini CLI 等非 Claude base agent 使用。内容保持一致，修改时两边同步。
+
+## 这是什么
+
+EvolCore（npm 包 `evolcore`，CLI `ec`）运行在 base agent（Claude Code / Codex / Gemini）之上，为其接入 AUN 网络与各 IM 渠道，并提供身份、关系、环境感知与持久记忆。仓库内含两个子包：`ecweb/`（`ec-web`，Web 控制台）、`ecagent/`（agent harness）。
+
+**运行时行为去哪查**（先查 ECK，别凭记忆答）：
+
+| 需要什么 | 去哪 |
+|---|---|
+| `ec` 全部命令集（含触发词） | `kits/docs/evolcore/INDEX.md` |
+| 上下文组装 / manifest / 运行时变量 | `kits/docs/context-assembly.md` |
+| 身份、关系、环境、渠道、路径注册表 | `kits/rules/`（每会话全量加载）+ `kits/docs/INDEX.md` |
+
+## 开发命令
+
+| 目的 | 命令 |
+|---|---|
+| 热重载开发 | `npm run dev` |
+| 构建（含 ecweb 子包） | `npm run build` |
+| 全量测试（会先 build） | `npm test` |
+| 单文件测试（迭代时用这个） | `npx vitest run tests/unit/<name>.test.ts` |
+| 监听模式 | `npm run test:watch` |
+
+改了 `src/` 必须 `npm run build` + `ec restart` 才生效。`ec agent reload` 只重载配置/persona/memory，**不重载源码**。
+
+## 本机运行形态（重要）
+
+`resolveRoot()`（`src/paths.ts`）解析顺序：`EVOLCORE_HOME` → cwd 下存在 `agents/defaults.json` 则取 cwd → `~/.evolcore`。
+
+本机 `/home/evolcore` 既是包根也是运行时数据根（dev 模式），所以仓库里的 `data/`、`agents/`、`logs/`、`backups/`、`eck/` 是**线上真实数据**：不要清空或批量重写，提交前确认 diff 里没有混进会话文件。测试已自动隔离到临时 `EVOLCORE_HOME`（`tests/global-setup.ts` + `tests/setup.ts`），新测试沿用该机制，不要自己指向真实 root。
+
+## 硬约束
+
+- **ESM**：`"type": "module"`，所有相对 import 必须带 `.js` 后缀（即使源文件是 `.ts`）。
+- **命名边界**：产品名 / CLI 名 / 数据目录名 / 环境变量一律从 `src/product.ts` 取常量（`MAIN_CLI_BIN`、`RUNTIME_HOME_ENV`、`DAEMON_CONFIG_FILENAME` …）。仓库里仍有 evolclaw 时代的残留字符串，新代码不要跟着写死，也不要顺手做全局改名。
+- **跨平台**：进程与路径能力走 `src/utils/cross-platform.ts`（`isProcessRunning` / `killProcess` / `findProcesses` / `commandExists` / `tailFile` / `onShutdown` / `isMainScript`）；路径一律 `path.join`；入口判断用 `isMainScript(import.meta.url)`，不要拼 `file://${process.argv[1]}`。
+- **执行外部命令**：用 `execFile` 系列，不要用 `execSync` 拼字符串（安全 hook 会拦）。
+- **别改死代码**：`src/core/message/_archived/` 是留档，改了不生效。响应主流程在 `src/core/message/response-engine.ts`；`message-processor.ts` 只是它的类型门面（27 行）。
+- **SDK 会话文件**：`{projectPath}/.claude/` 下的 JSONL 由 SDK 管理，只读不写；续接会话走 resume/sessionId。
+- **代码风格**：`docs/DEV_GUIDELINES.md`（2 空格、单引号、分号、文件名 kebab-case）。
+
+## docs/ 的性质
+
+`docs/` 有 300+ 个文件，绝大多数是历史设计稿和阶段性报告，**相当一部分已与源码不符**。查实现以源码为准，docs 只当线索；引用某个结论前先核对当前代码。
+
+### 功能设计文档命名规范
+
+功能设计/方案文档必须在**文档头部**标注以下信息：
+
+```
+> 状态：[draft] | [wip] | [done]
+> 创建：YYYY-MM-DD
+```
+
+- `[draft]` — 规划了但尚未开始开发
+- `[wip]` — 部分阶段完成，还有后续阶段未实施
+- `[done]` — 已全部落地（含主动取消的范围，需在正文中注明）
+
+判断依据：文档状态必须与 `src/`、`ecweb/src/` 中的实际实现一致。引用文档结论前先核源码。

package/CHANGELOG.md

@@ -3,7 +3,30 @@
 本文件记录 EvolCore 的重要变更。EvolClaw 版本线的历史记录已归档至
 [`docs/_archive/CHANGELOG-evolclaw.md`](docs/_archive/CHANGELOG-evolclaw.md)。
 
-## 0.0.22 (2026-09-05)
+## 0.0.23 (2026-09-08)
+
+### 会话、Trigger 与 Codex 运行时
+
+- 完善 Codex 子代理的上下文继承、权限传递和任务生命周期收敛，并贯通工具调用标识与授权审计。
+- 为受信任的 root Fullaccess Claude 会话显式设置沙箱标记，并限制复杂 PowerShell carrier 的摘要解包范围。
+- 确保 daemon Trigger 在错误已经渲染后仍发送明确终态，并传播中断生命周期元数据、统一中断结果分类。
+- 完善话题续接、会话后端身份校验和跨客户端线程释放，降低重启、续接与并发操作造成的旧任务串入风险。
+
+### Windows、AUN 与配置安全
+
+- 统一 Windows IPC 端点路径规范和跨进程命名管道连接，修复实例 socket 路径在不同运行入口间不一致的问题。
+- 修复 Windows 配置与联系人数据的锁竞争，支持安全识别并回收损坏或遗留锁文件。
+- 强化 Windows Shell 签名信任校验，在允许受信任命令执行的同时收紧受管命令边界。
+- 增加受保护的 AUN Menu 客户端和 daemon 诊断入口，补充 E2EE 请求校验、EC Web token 授权与日志查询边界。
+- 校验并恢复 WeChat 增量同步游标，遇到无效游标时隔离本地状态并自动重试。
+- 升级 `@agentunion/fastaun` 至 `0.5.13`；`ec group invite` 改用定向邀请生命周期，并新增邀请类型与接受/拒绝/撤回命令。
+
+### EC Web 与监控
+
+- 完善 EC Web 认证恢复、Trigger 管理和操作授权审计上下文。
+- EC Web Monitor 按客户端订阅生命周期启停进程树采样，避免无订阅时持续采集。
+
+## 0.0.22 (2026-09-04)
 
 ### 话题续接与触发任务
 
@@ -32,19 +55,6 @@
 - 修复 Windows Codex managed hook 的动态 IPC 校验与安装配置，统一 proactive hook 可用性检查并保持 H-class/L-class 保护边界。
 - 修正 Codex Windows 文件系统 glob 规则，改善受管临时目录和锁目录的跨平台匹配。
 - 统一 BaseAgent 请求地址和身份请求头传递，完善 Codex 会话启动、重连与错误诊断。
-- 完善 Codex 子代理的上下文继承、权限传递和任务生命周期收敛，并贯通工具调用标识与授权审计。
-- 为受信任的 root Fullaccess Claude 会话显式设置沙箱标记，并限制复杂 PowerShell carrier 的摘要解包范围。
-
-### Windows IPC 与运行稳定性
-
-- 统一 Windows IPC 端点路径规范和跨进程命名管道连接，修复实例 socket 路径在不同运行入口间不一致的问题。
-- 修复 Windows 配置与联系人数据的锁竞争，支持安全识别并回收损坏或遗留锁文件。
-- 强化 Windows Shell 签名信任校验，在允许受信任命令执行的同时收紧受管命令边界。
-
-### Trigger 与监控收敛
-
-- 确保 daemon Trigger 在错误已经渲染后仍发送明确终态，并传播中断生命周期元数据、统一中断结果分类。
-- EC Web Monitor 按订阅生命周期启停进程树采样，避免无订阅时持续采集。
 
 ## 0.0.21 (2026-09-03)
 

package/README.md

@@ -105,6 +105,8 @@ npm install -g evolcore
 
 Linux 全局安装会在 `postinstall` 阶段准备 Codex 受管运行所需的真实目录 `/etc/codex`。如果当前 npm 全局目录属于普通用户且该系统目录尚不存在，请先执行 `sudo install -d -m 0755 /etc/codex`，再重新安装。
 
+Windows 的 npm 安装和升级不会修改机器级 Codex 配置。首次使用 Codex 托管 Hook 需运行上面的 PowerShell 安装器，并批准 Hook 部署步骤的管理员授权；部署完成后，只要 npm 包位置和 Node.js 路径不变，普通 npm 升级无需再次部署。更换 npm prefix 或 Node.js 路径后需重新部署，详见 [Windows Codex 托管 Hook](docs/evolcore-install-script.md#windows-codex-托管-hook)。
+
 > **Windows 用户**：首次运行前可能需要执行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
 
 **从源码安装**：

package/bin/codex-managed-acl.ps1

@@ -0,0 +1,155 @@
+param([Parameter(Mandatory = $true)][string]$Request)
+
+# Called by the Node installer. Paths and security descriptors are data, never
+# interpolated into PowerShell source. Use Windows PowerShell's built-in .NET ACL API.
+$ErrorActionPreference = 'Stop'
+# A parent pwsh session can export its incompatible PowerShell 7 modules.
+# This helper always runs in Windows PowerShell 5.1.
+$env:PSModulePath = Join-Path $PSHOME 'Modules'
+[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+
+function Get-Descriptor([string]$Target) {
+  return (Get-Acl -LiteralPath $Target).GetSecurityDescriptorSddlForm(
+    [Security.AccessControl.AccessControlSections]'Access,Owner,Group')
+}
+
+function Set-Descriptor([string]$Target, [string]$Sddl) {
+  $acl = Get-Acl -LiteralPath $Target
+  $acl.SetSecurityDescriptorSddlForm($Sddl, [Security.AccessControl.AccessControlSections]'Access,Owner,Group')
+  Set-Acl -LiteralPath $Target -AclObject $acl
+}
+
+function Add-Grant($Acl, [string]$Sid, [Security.AccessControl.FileSystemRights]$Rights, [bool]$Directory) {
+  $inheritance = if ($Directory) { [Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit' } else { [Security.AccessControl.InheritanceFlags]::None }
+  $rule = New-Object Security.AccessControl.FileSystemAccessRule(
+    (New-Object Security.Principal.SecurityIdentifier($Sid)), $Rights, $inheritance,
+    [Security.AccessControl.PropagationFlags]::None, [Security.AccessControl.AccessControlType]::Allow)
+  $Acl.AddAccessRule($rule)
+}
+
+function Initialize-AccessProbe {
+  # An elevated process reading the file is not evidence that a normal process
+  # can read it. Evaluate the DACL with its UAC linked token when available.
+  Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+using System.Security.Principal;
+public static class EvolCoreAclProbe {
+  [StructLayout(LayoutKind.Sequential)]
+  struct Mapping { public uint Read, Write, Execute, All; }
+  [DllImport("advapi32.dll", SetLastError=true)]
+  static extern bool GetTokenInformation(IntPtr token, int type, out IntPtr linked, int size, out int returned);
+  [DllImport("advapi32.dll", SetLastError=true)]
+  static extern bool DuplicateToken(IntPtr token, int level, out IntPtr duplicate);
+  [DllImport("advapi32.dll", SetLastError=true)]
+  static extern bool AccessCheck(byte[] descriptor, IntPtr token, uint desired,
+    ref Mapping mapping, byte[] privileges, ref uint length, out uint granted, out bool allowed);
+  [DllImport("kernel32.dll")] static extern bool CloseHandle(IntPtr handle);
+  public static string TokenKind;
+  public static long Granted(byte[] descriptor) {
+    using (var identity = WindowsIdentity.GetCurrent()) {
+      var principal = new WindowsPrincipal(identity);
+      IntPtr token = identity.Token, linked = IntPtr.Zero, duplicate = IntPtr.Zero;
+      try {
+        if (identity.IsSystem || principal.IsInRole(WindowsBuiltInRole.Administrator)) {
+          int size;
+          if (!GetTokenInformation(token, 19, out linked, IntPtr.Size, out size)) {
+            TokenKind = "unavailable";
+            return -1;
+          }
+          token = linked;
+          TokenKind = "linked-token";
+        } else { TokenKind = "current-token"; }
+        if (!DuplicateToken(token, 2, out duplicate))
+          throw new System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error());
+        var mapping = new Mapping { Read=0x120089, Write=0x120116, Execute=0x1200a0, All=0x1f01ff };
+        uint length=1024, granted;
+        bool allowed;
+        if (!AccessCheck(descriptor, duplicate, 0x02000000, ref mapping,
+            new byte[length], ref length, out granted, out allowed))
+          throw new System.ComponentModel.Win32Exception(Marshal.GetLastWin32Error());
+        return allowed ? granted : 0;
+      } finally {
+        if (duplicate != IntPtr.Zero) CloseHandle(duplicate);
+        if (linked != IntPtr.Zero) CloseHandle(linked);
+      }
+    }
+  }
+}
+'@
+}
+
+function Verify-Access($Entry) {
+  $target = [string]$Entry.path
+  $acl = Get-Acl -LiteralPath $target
+  $read = [long][Security.AccessControl.FileSystemRights]::ReadAndExecute
+  $write = [long][Security.AccessControl.FileSystemRights]'Write,Delete,DeleteSubdirectoriesAndFiles,ChangePermissions,TakeOwnership'
+  if ($Entry.protected) {
+    $grants = @{}
+    foreach ($rule in $acl.GetAccessRules($true, $true, [Security.Principal.SecurityIdentifier])) {
+      if (($rule.PropagationFlags -band [Security.AccessControl.PropagationFlags]::InheritOnly) -ne 0) { continue }
+      $sid = $rule.IdentityReference.Value
+      $rights = [long]$rule.FileSystemRights
+      if ($sid -in @('S-1-1-0','S-1-5-11','S-1-5-32-545')) {
+        if ($rule.AccessControlType -eq 'Allow' -and ($rights -band $write) -ne 0) {
+          throw "Unsafe write permission on ${target}: $sid has $($rule.FileSystemRights). Existing policy was not removed."
+        }
+        if ($rule.AccessControlType -eq 'Deny' -and ($rights -band $read) -ne 0) {
+          throw "Read permission denied on ${target}: $sid. Existing policy was not removed."
+        }
+      }
+      if ($rule.AccessControlType -eq 'Allow') { $grants[$sid] = ([long]$grants[$sid]) -bor $rights }
+    }
+    foreach ($sid in @('S-1-5-18','S-1-5-32-544','S-1-5-32-545')) {
+      $required = if ($sid -eq 'S-1-5-32-545') { $read } else { [long][Security.AccessControl.FileSystemRights]::FullControl }
+      if ((([long]$grants[$sid]) -band $required) -ne $required) { throw "Missing required access on ${target}: $sid" }
+    }
+  }
+  $granted = [EvolCoreAclProbe]::Granted($acl.GetSecurityDescriptorBinaryForm())
+  if ($granted -ge 0) {
+    $required = if ($Entry.execute) { $read } else { [long][Security.AccessControl.FileSystemRights]::Read }
+    if (($granted -band $required) -ne $required) { throw "Normal-token read/execute access denied: $target" }
+    if ($Entry.protected -and ($granted -band $write) -ne 0) { throw "Normal token can modify the protected file or its ACL: $target" }
+  }
+  return @{ path = $target; userProbe = [EvolCoreAclProbe]::TokenKind }
+}
+
+try {
+  $payload = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($Request)) | ConvertFrom-Json
+  $result = switch ($payload.action) {
+    'preflight' {
+      $principal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
+      if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
+        throw 'Machine-wide Codex hook provisioning requires an elevated Windows installer. npm installation does not require this step.'
+      }
+      @{ elevated = $true }
+    }
+    'snapshot' { @{ sddl = (Get-Descriptor $payload.path) } }
+    'prepare' {
+      $target = [string]$payload.path
+      if ($payload.reference) {
+        # Same-directory staging preserves the shared configuration's owner,
+        # inherited policy and custom administrator ACEs. Never reset its ACL.
+        Set-Descriptor $target (Get-Descriptor $payload.reference)
+      } else {
+        $flags = if ($payload.directory) { 'OICI' } else { '' }
+        Set-Descriptor $target "O:BAG:BAD:P(A;${flags};FA;;;SY)(A;${flags};FA;;;BA)(A;${flags};FRFX;;;BU)"
+      }
+      $acl = Get-Acl -LiteralPath $target
+      Add-Grant $acl 'S-1-5-18' 'FullControl' ([bool]$payload.directory)
+      Add-Grant $acl 'S-1-5-32-544' 'FullControl' ([bool]$payload.directory)
+      Add-Grant $acl 'S-1-5-32-545' 'ReadAndExecute' ([bool]$payload.directory)
+      Set-Acl -LiteralPath $target -AclObject $acl
+      @{ prepared = $true }
+    }
+    'verify' {
+      Initialize-AccessProbe
+      @($payload.entries | ForEach-Object { Verify-Access $_ })
+    }
+    default { throw "Unknown ACL operation: $($payload.action)" }
+  }
+  ConvertTo-Json -InputObject $result -Depth 8 -Compress
+} catch {
+  [Console]::Error.WriteLine("[evolcore] ACL $($payload.action) failed for $($payload.path): $($_.Exception.Message)")
+  exit 1
+}