evolcore 0.0.1 → 0.0.3

package/README.md

@@ -1,34 +1,338 @@
 # EvolCore
 
-Core utilities and abstractions for EvolClaw ecosystem.
+> AI Agent 统一网关 —— 连接 IM、终端、Agent 网络
 
-## Installation
+EvolCore 是一个轻量级 AI Agent 网关系统。它为 Claude Code / Codex 等 Coding Agent 提供统一接入层，使其作为通用基座 Agent，接入到飞书、微信、钉钉、QQ频道、企业微信等多种 IM 通道，以及 AUN 多智能体网络。人类可以通过手机 IM 随时接力开发，其他 Agent 也可以通过 AUN 网络直接调用你的 Agent —— 不只是人机交互，也是 Agent 间协作的基础设施。
+
+## 核心特性
+
+- 🔄 **多端会话接力**：跨终端共享会话、环境、项目，无缝切换开发体验
+- ♻️ **配置自动继承**：复用 CLI 环境的 API Key/URL、记忆文件、MCP/Skills 插件，零额外配置
+- 🚀 **轻量化设计**：进程模式运行，CLI 命令行管理，无端口开放，无容器依赖，无 UI 界面
+- 🌐 **多渠道接入**：Channel Adapter 模式，飞书 + 微信 + 钉钉 + QQ频道 + 企业微信 + AUN 网络
+- 🤖 **Agent 间互联**：通过 AUN 网络，你的 Agent 可被其他 Agent 发现和调用
+- 🔐 **分层权限**：进程 owner、agent owner/admin、关系 member/visitor/自定义角色分层，多用户安全隔离
+- 🛠️ **Agent 自管理**：Agent 可通过 CLI 命令自主管理运行时（查看状态、切换模型、调整配置等）
+- 📦 **项目搬家**：`ec mv` 一键迁移项目目录，保留 Claude/Codex/EvolCore 全部会话历史
+- 💾 **会话与队列持久化**：会话数据与 CLI 工具共享，队列状态持久化存储，服务重启不丢失，支持 `/queue` 命令查看队列状态
+- ⚡ **执行中插入**：任务执行中可发送新消息，自动中断当前任务并处理新请求
+- 🔕 **消息智能发送**：前台任务动态聚合批量发送，后台任务静默完成后通知
+- 🧩 **Agent 多实例**：一个 JSON 文件定义一个 Agent，多 Agent 并发运行，Agent 运行时隔离 + 热重载无需重启
+- ⏰ **Trigger 自主任务**：Agent 可设置延迟/定时/周期任务，cron 表达式支持，独立 silent session 执行，支持脚本模式和 prompt 模式
+- 🔧 **Daemon 模块**：系统级后台服务，管理升级检查、全局触发器等跨 Agent 任务
+- 🎯 **Agent 启动引导**：首次启动自动引导配置 AID、owners、channels，降低上手门槛
+- 🎭 **主动模式策略**：proactive 模式下智能判断响应时机，群聊支持静默策略，避免无效打扰
+- 🎴 **交互卡片体系**：CommandCard + ActionInteraction，Feishu 与 AUN 统一支持
+
+## 适合场景
+
+- **通勤路上**：手机打开飞书，继续昨晚的代码 review，到公司无缝切回终端
+- **会议间隙**：微信快速问一句「这个接口的返回格式是什么」，Agent 直接查代码回复
+- **Agent 协作**：通过 AUN 网络，让你的 Agent 被其他 Agent 调用，组成分布式协作
+- **外出离开工位**：不带电脑也能通过 IM 给 Agent 下达任务，回来看结果
+- **团队协作**：拉个飞书群，成员共享同一个 Agent 会话，一起讨论和调试
+
+## 系统架构
+
+```
+消息渠道层 → 消息队列层 → 命令处理层 → 消息处理层 → 会话管理层 → 存储层
+```
+
+### 核心组件
+
+1. **消息渠道层** (`src/channels/`) - Feishu + WeChat + DingTalk + QQBot + WeCom + AUN 网络
+2. **消息队列层** (`src/core/message/message-queue.ts`) - 会话级串行处理 + 中断支持
+3. **命令处理层** (`src/core/command/`) - 斜杠命令处理（slash-handler / menu-handler / command-handler）
+4. **消息处理层** (`src/core/message/message-processor.ts`) - 统一事件处理引擎
+5. **会话管理层** (`src/core/session/session-manager.ts`) - 多项目会话管理
+6. **交互路由层** (`src/core/interaction-router.ts`) - 卡片交互回调注册与路由
+7. **会话存储层** - JSONL 文件（CLI 共用）+ 文件系统（每 chat 一个目录，含 active.json / meta_*.jsonl / messages.jsonl / health.jsonl）
+
+### 消息流转
 
-```bash
-npm install evolcore
 ```
+用户发送消息
+    ↓
+Channel.onMessage
+    ↓
+检查命令 → 是 → CommandHandler.handle() → 立即响应（绕过队列）
+    ↓ 否
+MessageQueue.enqueue(streamKey, message)
+    ↓
+检测正在处理 → 是 → 触发中断 → AgentRunner.interrupt()
+    ↓ 否                                    ↓
+MessageQueue.processNext()  ←──────────────┘
+    ↓
+MessageProcessor.processMessage()
+    ↓
+├─ 解析会话和项目路径
+├─ 创建 StreamFlusher（3 秒批量发送）
+├─ AgentRunner.runQuery() → 事件流
+├─ 处理事件（tool_use / text / result）
+├─ 提取文件标记（Feishu）
+└─ 发送最终响应
+```
+
+## 快速开始
 
-## Usage
+### 环境要求
 
-```typescript
-import { version } from 'evolcore';
+- **操作系统**：macOS / Linux / Windows
+- **Node.js** >= 18
+- **Claude Code** >= 2.1.32（`npm install -g @anthropic-ai/claude-code`）
 
-console.log(`EvolCore version: ${version}`);
+### 1. 安装
+
+**npm 全局安装**（推荐）：
+
+```bash
+npm install -g evolcore
 ```
 
-## Development
+> **Windows 用户**：首次运行前可能需要执行 `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
+**从源码安装**：
 
 ```bash
-# Build
+git clone https://github.com/eLeanwang/evolcore.git
+cd evolcore
+npm install
 npm run build
+npm link
+```
+
+### 2. 初始化
+
+```bash
+# 完整初始化（选择飞书或微信）
+ec init
+
+# 单独配置飞书（扫码登录）
+ec init feishu
+
+# 单独配置微信（扫码登录）
+ec init wechat
+
+# 单独配置钉钉（扫码登录）
+ec init dingtalk
+
+# 单独配置 QQ 频道（扫码登录）
+ec init qqbot
+
+# 单独配置企业微信（手动输入 Bot ID + Secret）
+ec init wecom
+
+# 单独配置 AUN（Mesh 网络通道）
+ec init aun
+```
+
+交互式引导完成以下配置：
+- 环境检查（Node.js >= 22、claude CLI、SDK 版本）
+- 渠道选择（飞书/微信）并扫码登录
+- 默认项目路径
+- 模型选择（sonnet/opus/haiku）
+- owner 配置：默认走 **Evol App 扫码绑定**，若无 Evol App 可手工录入 AID 兜底
+- 自动写入 `EVOLCORE_HOME` 到 shell profile（Unix）或用户环境变量（Windows）
+
+配置文件生成在 `{EVOLCORE_HOME}/data/daemon.json`（默认 `~/.evolcore/data/daemon.json`）。
+
+### 补充配置（可选）
+
+以下参数不包含在 `ec init` 交互流程中，需要手动编辑 `daemon.json`：
+
+```jsonc
+{
+  "projects": {
+    "autoCreate": true                          // 绑定不存在的项目路径时自动创建目录
+  },
+  "idleMonitor": {
+    "enabled": true,                            // 任务超时监控开关
+    "timeout": 120,                             // 超时阈值（秒），默认 120 秒
+    "safeModeThreshold": 3                      // 连续超时 N 次后进入安全模式（设为 0 禁用安全模式）
+  },
+  "flushDelay": 4                               // 工具活动消息聚合发送间隔（秒），默认 4 秒
+}
+```
 
-# Watch mode
+**API 继承机制**：`agents.claude` 整个 section 可省略，系统自动按以下优先级继承：
+- `apiKey`：配置文件 → `ANTHROPIC_AUTH_TOKEN` 环境变量 → `~/.claude/settings.json`
+- `baseUrl`：配置文件 → `ANTHROPIC_BASE_URL` 环境变量 → `~/.claude/settings.json`
+- `model`：配置文件 → `~/.claude/settings.json` → 默认 `sonnet`
+- `effort`：配置文件 → `~/.claude/settings.json` → SDK 默认值（`auto`）
+
+### 3. 运行
+
+```bash
+# 服务管理
+ec start      # 启动服务
+ec stop       # 停止服务
+ec restart    # 重启服务
+ec status     # 查看状态
+ec logs       # 查看日志（tail -f）
+ec agent      # 管理 EvolAgent（list / show / new / reload）
+ec mv <old> <new>  # 项目搬家（保留全部会话）
+ec queue --agent <aid>   # 查看/操作 agent 消息队列（队列重启后持久化恢复）
+ec diagnose   # 诊断启动环境
+
+# 配置管理（v3.4+）
+ec config show       # 查看某一层文件原始内容
+ec config effective  # 打印合并后的生效配置 + 来源
+ec config get <field>      # 读 effective 值
+ec config set <field> <v>  # 写参数（scope 自动推断）
+ec config validate   # 按 schema 校验
+ec config history    # 配置快照历史
+
+# 开发模式（热重载）
 npm run dev
 
-# Test
+# 运行测试
 npm test
 ```
 
-## License
+## 项目结构
+
+```
+evolcore/
+├── src/
+│   ├── agents/
+│   │   ├── claude-runner.ts        # Claude Agent SDK 封装
+│   │   ├── codex-runner.ts         # Codex Agent 封装
+│   │   └── gemini-runner.ts        # Gemini CLI 封装
+│   ├── aun/                        # AUN 协议工具
+│   ├── core/
+│   │   ├── command/
+│   │   │   ├── command-handler.ts  # 命令派发入口
+│   │   │   ├── slash-handler.ts    # 斜杠命令实现
+│   │   │   ├── menu-handler.ts     # Menu 协议处理
+│   │   │   └── slash-gate.ts       # 权限前置拦截
+│   │   ├── message/
+│   │   │   ├── message-bridge.ts   # 渠道 ↔ 核心消息桥
+│   │   │   ├── message-processor.ts # 统一消息处理引擎
+│   │   │   ├── message-queue.ts    # 消息队列（串行+中断）
+│   │   │   ├── message-cache.ts    # 消息缓存
+│   │   │   ├── message-log.ts      # 每 chat 的 messages.jsonl
+│   │   │   └── im-renderer.ts      # IM 渲染 + 批量发送
+│   │   ├── session/
+│   │   │   ├── adapters/           # 各后端会话文件适配器
+│   │   │   ├── session-fs-store.ts # 文件系统存储原语
+│   │   │   └── session-manager.ts  # 会话管理（多项目支持）
+│   │   ├── trigger/                # 触发器引擎
+│   │   ├── evolagent.ts            # EvolAgent 实体
+│   │   ├── evolagent-registry.ts   # Agent 注册表（扫描/路由/热重载）
+│   │   ├── interaction-router.ts   # 卡片交互回调路由
+│   │   └── permission.ts           # 权限网关
+│   ├── channels/
+│   │   ├── feishu.ts               # 飞书 WebSocket 渠道
+│   │   ├── wechat.ts               # 微信 ClawBot 渠道
+│   │   ├── dingtalk.ts             # 钉钉 Stream 渠道
+│   │   ├── qqbot.ts                # QQ 频道渠道
+│   │   ├── wecom.ts                # 企业微信 AI Bot 渠道
+│   │   └── aun.ts                  # AUN Mesh 网络渠道
+│   ├── cli/                        # CLI 命令
+│   ├── utils/                      # 工具函数
+│   ├── types.ts                    # 类型定义
+│   ├── config-store.ts             # 配置加载
+│   ├── paths.ts                    # 路径解析
+│   └── index.ts                    # 主入口
+└── kits/                           # 共享上下文模板
+```
+
+## 斜杠命令
+
+### 用户级命令（所有用户可用）
+
+**会话管理**：
+- `/new [名称]` - 创建新会话
+- `/slist` - 列出当前项目的所有会话
+- `/slist cli` - 列出未导入的 CLI 会话
+- `/s <名称|序号|uuid>` - 切换到指定会话
+- `/name <新名称>` - 重命名当前会话
+- `/del <名称>` - 删除指定会话（仅解绑，不删除文件）
+- `/status` - 显示会话状态
+- `/check` - 系统健康检查（摘要）
+- `/help` - 显示所有命令
+
+### 管理员级命令（Admin+ 可用）
+
+**项目**：
+- `/pwd` - 显示当前项目路径
+
+**Agent 与模型**：
+- `/baseagent [name]` - 查看或切换 Agent 后端（claude / codex / gemini）（别名 `/base`）
+- `/model [model]` - 查看或切换模型
+- `/effort [level]` - 查看或切换推理强度（low / medium / high / max / auto）
+- `/perm [mode]` - 查看或切换权限模式（readonly / auto / request / bypass；旧值会安全迁移）
+
+**系统管理**：
+- `/compact` - 压缩会话上下文
+- `/rewind <turn>` - 回退会话到指定轮次
+- `/stop` - 中断当前任务
+- `/check` - 系统健康检查（详情）
+- `/activity [all|dm|owner|none]` - 查看/控制中间输出显示模式
+- `/chatmode [interactive|proactive]` - 查看/切换会话模式
+- `/dispatch [mention|broadcast]` - 群聊分发模式（仅 @ 响应或广播）
+- `/trigger <动作> ...` - 设置/查看 AI 自主触发器（延迟/定时/周期）
+- `/restart <channel>` - 重连指定渠道
+
+### Owner 专属命令
+
+- `/file <文件路径>` - 发送文件给用户
+- `/restart` - 重启服务（自愈机制）
+- `/repair` - 检查并修复会话
+
+### ⚠️ 进程级 menu 操作鉴权（v3.2 Breaking）
+
+进程级 menu 操作（`/system restart/upgrade`、`/agent` agent 生命周期管理）的鉴权已迁移到
+`daemon.json` 顶层 `owners` 字段（v3.2 起，不再读 `agents/defaults.json`）。
+升级后**必须**在 `daemon.json` 配置 `owners`，否则这些操作一律返回 `FORBIDDEN`（daemon 启动时也会 warn 提示）。
+
+```json
+{
+  "owners": ["eleans-2022.agentid.pub"]
+}
+```
+
+`ec init` 交互流程会在生成控制 AID 后提示录入 owners（可跳过后手动编辑）。
+
+- **`owners`**：进程级管理者 AID 名单。可执行 `/system`（重启/升级）与 `/agent`
+  （create / delete / enable / disable / list / show）。
+- 关系级的 `/trigger`（set / cancel / update / list）仍走 channel 角色（owner/admin）+ scoped 鉴权，**不**受 `owners` 影响。
+- `/agent create` 为「受理即返回」：立即回 `{ accepted: true, aid }`，后台跑完整创建流程并把各
+  环节写入 `agents/<aid>/create-status.json`；客户端用 `menu.query name=agent args={aid}` 轮询
+  `createProgress.status` 直到 `ready` / `failed`。
+
+### 控制 AID（control AID）
+
+v3.2 新增进程级身份标识。启动时自动生成 `ec+5位数字.agentid.pub` 格式的控制 AID，以
+`pureIdentity` 模式接入 AUN 网络（跳过 evolagent onboarding）。`ec status` 可查看控制 AID 连接状态。
+
+## 技术栈
+
+- **运行时**：Node.js >= 22 + TypeScript（ES modules）
+- **AI 后端**：@anthropic-ai/claude-agent-sdk >= 0.3.211、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 共用）
+- **测试框架**：Vitest
+
+## TODO
+
+- [x] AUN Mesh 网络通道接入
+- [x] 项目搬家工具（`ec mv`）
+- [x] 手动授权支持（文本回复 + 飞书卡片）
+- [x] 自动授权可配置（自动放行/自动拒绝）
+- [x] 触发器支持
+- [x] AUN 群组扩展功能支持
+- [x] 统计/状态监控
+
+
+## 许可证
+
+MIT — 详见 [LICENSE](LICENSE) 声明
+
+## 交流群
+
+EvolCore 正在内测中，欢迎加入微信群交流使用体验、反馈问题或参与讨论：
+
+<img src="assets/wechat-group-qr.jpeg" width="300" alt="EvolCore 内测群二维码" />
 
-MIT
+> 二维码过期后可在 [Issues](https://github.com/eLeanwang/evolcore/issues) 中留言，我会更新邀请链接。

package/ROLE_ACCESS_CONTROL.md

@@ -0,0 +1,174 @@
+# 角色访问控制功能实现总结
+
+## 新增功能
+
+### 1. 默认角色 (defaultRole)
+- **位置**: 全局配置 (`roles.json` 顶层字段)
+- **默认值**: `'anonymous'`
+- **语义**: 对端 AID 首次访问时，若不在 `owners/admins/members` 名单中，使用此角色作为兜底
+- **UI**: ecweb 角色定义页面顶部下拉选择器，change 时自动保存
+
+### 2. 是否允许访问 (allowAccess)
+- **位置**: 每个角色定义的顶层字段 (与 `description`/`permissions` 同级)
+- **默认值**:
+  - `anonymous`: `false` (拒绝访问)
+  - 其他角色 (`owner/admin/member/guest`): `true` (允许访问)
+- **语义**: 当角色的 `allowAccess=false` 时，该角色用户访问 agent 会被直接拦截
+- **拦截行为**: 返回系统错误消息 "暂无权限访问本 agent，请联系 agent 管理员授权访问"
+- **UI**: ecweb 角色编辑/新建弹窗中，描述下方的下拉选择器 (允许 true / 拒绝 false)
+
+## 实现架构
+
+### Backend 改动
+
+#### 1. Schema 升级 (v1 → v2)
+- `kits/schemas/roles.schema.2.json` — 新增 `defaultRole` (top-level) 和 `allowAccess` (per-role)
+- `kits/schemas/_meta.json` — currentVersion 更新为 2
+- **迁移逻辑** (`src/config/config-manager.ts`):
+  - `migrateRolesV1toV2()` — 直接升版本号，新字段由 merge 时从 builtin 补全 (overlay 模式)
+
+#### 2. 类型定义 (`src/types.ts`)
+```typescript
+export interface RolesConfig {
+  $schema_version: number;
+  defaultRole?: string;  // 新增
+  roles: Record<string, RoleDefinition>;
+}
+
+export interface RoleDefinition {
+  description: string;
+  allowAccess?: boolean;  // 新增
+  permissions: Record<string, FieldPermission>;
+}
+```
+
+#### 3. 内置配置 (`src/config/roles.ts`)
+- `getBuiltinRolesConfig()` 升级为 `$schema_version: 2`
+- 添加 `defaultRole: 'anonymous'`
+- 每个角色添加 `allowAccess` 字段 (owner/admin/member/guest 为 `true`, anonymous 为 `false`)
+
+#### 4. 角色解析器 (`src/config/role-resolver.ts`)
+- `resolveUserRole()` 返回类型改为 `string` (支持自定义角色名)
+- 移除 `isAuthenticated()` 判断，改为直接使用 `getDefaultRole()` 作为兜底
+- **新增** `getDefaultRole()` — 从 roles.json 读取 `defaultRole` 字段
+- **新增** `checkRoleAccess(role: string): boolean` — 读取该角色的 `allowAccess` 配置
+
+#### 5. 合并/Diff 逻辑 (`src/config/roles-merge.ts`)
+- `mergeRolesConfig()` — 合并 `defaultRole` (overlay 优先) 和每个角色的 `allowAccess`
+- `diffRolesConfig()` — 比对 `defaultRole` 和 `allowAccess`，仅写入改动
+
+#### 6. 访问控制拦截 (`src/core/message/response-engine.ts`)
+- `processMessage()` 入口处，在 `resolveSession()` 之后立即检查
+- 调用 `checkRoleAccess(userRole)`，为 `false` 时:
+  1. 记录 warn 日志
+  2. 通过 `adapter.send()` 回复 `system.error` 类型消息
+  3. `return` 终止处理，不进入后续流程
+
+### Frontend 改动 (ecweb)
+
+#### 1. HTML 结构 (`ecweb/src/static/index.html`)
+- 新增 `.role-default-selector` 区块 (在 header 和 grid 之间)
+- 包含 `<select id="default-role-select">` 和提示文案
+
+#### 2. JavaScript (`ecweb/src/static/app.js`)
+- `renderRoleDefinitions()` — 调用 `renderDefaultRoleSelector(data)` 填充下拉框
+- **新增** `renderDefaultRoleSelector()`:
+  - 填充所有角色为选项
+  - 绑定 `onchange` 事件 → 读取完整配置 → 更新 `defaultRole` → PUT 写回
+- `showRoleEditModal()` / `showNewRoleModal()` — 在 description 后添加 `allowAccess` 下拉
+- `saveRoleEdit()` — 收集 `allowAccess` 值 (转为真布尔), 写入 `updates` 对象
+
+#### 3. CSS (`ecweb/src/static/style.css`)
+- 新增 `.role-default-selector` / `.role-default-label` 样式
+- 原有按钮样式已是黑边框黑字 (`var(--fg)` / `var(--border)`)，无需修改
+
+## 配置示例
+
+### roles.json (用户 overlay)
+```json
+{
+  "$schema_version": 2,
+  "defaultRole": "guest",
+  "roles": {
+    "anonymous": {
+      "description": "匿名用户，完全未认证，极度受限",
+      "allowAccess": false
+    },
+    "guest": {
+      "description": "访客，只读权限，有身份但未授权",
+      "allowAccess": true
+    }
+  }
+}
+```
+
+### 内置基线 (builtin)
+```javascript
+{
+  $schema_version: 2,
+  defaultRole: 'anonymous',
+  roles: {
+    owner: { allowAccess: true, ... },
+    admin: { allowAccess: true, ... },
+    member: { allowAccess: true, ... },
+    guest: { allowAccess: true, ... },
+    anonymous: { allowAccess: false, ... }
+  }
+}
+```
+
+## 升级路径
+
+1. **v1 → v2 自动迁移**:
+   - 读取 v1 roles.json 时，`migrateRolesV1toV2()` 自动升版本号
+   - `defaultRole` 和 `allowAccess` 字段从 builtin 继承 (overlay 为空时)
+   - 原有用户改动 (permissions/description) 完整保留
+
+2. **向后兼容**:
+   - `defaultRole` 缺失时默认 `'anonymous'` (原有行为)
+   - `allowAccess` 缺失时默认 `true` (除 anonymous 为 `false`)
+   - 旧代码不读这两个字段时，功能降级但不报错
+
+## 测试要点
+
+1. **默认角色生效**:
+   - 清空某 agent 的 owners/admins/members
+   - 对端 AID 访问时，角色应为 `roles.json` 中的 `defaultRole`
+
+2. **访问控制拦截**:
+   - 设置某角色 `allowAccess: false`
+   - 将用户加入该角色 (如 guest)
+   - 用户访问时应收到 "暂无权限" 系统错误，后续流程不触发
+
+3. **ecweb UI**:
+   - 默认角色下拉能正常切换并保存
+   - 编辑角色时，`allowAccess` 下拉能正确读取/保存
+   - 保存按钮为黑边框黑字 (非白色)
+
+4. **Schema 迁移**:
+   - 备份旧 roles.json (v1)
+   - 启动新版本，读取时自动升级为 v2
+   - 原有改动不丢失，新字段从 builtin 补全
+
+## 文件清单
+
+### Backend
+- `kits/schemas/roles.schema.2.json` (新增)
+- `kits/schemas/_meta.json` (修改 - 版本号)
+- `src/types.ts` (修改 - RolesConfig/RoleDefinition)
+- `src/config/roles.ts` (修改 - builtin 配置)
+- `src/config/role-resolver.ts` (修改 - 添加 checkRoleAccess)
+- `src/config/roles-merge.ts` (修改 - merge/diff 逻辑)
+- `src/config/config-manager.ts` (修改 - 迁移函数)
+- `src/core/message/response-engine.ts` (修改 - 访问拦截)
+
+### Frontend (ecweb)
+- `ecweb/src/static/index.html` (修改 - 默认角色选择器)
+- `ecweb/src/static/app.js` (修改 - render/save 逻辑)
+- `ecweb/src/static/style.css` (修改 - 样式)
+
+---
+
+**实现完成时间**: 2026-06-25  
+**Schema 版本**: roles v2  
+**向后兼容**: ✅ (v1 自动迁移，字段缺失时使用默认值)

package/assets/.env.template

@@ -0,0 +1,4 @@
+# AUN 环境变量
+# 取消注释并填入值即可生效（进程已有的同名变量不会被覆盖）
+
+# AUN_ENCRYPTION_SEED=your-seed-here

package/bin/ec-safe-output.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import { spawn } from 'child_process';
+
+const MAX_OUTPUT_BYTES = 1024 * 1024;
+const EC_EXECUTABLES = new Set(['ec']);
+const HOST_PROCESS_EXECUTABLES = new Set(['ps', 'pgrep', 'pidof', 'kill', 'pkill', 'killall']);
+
+function fail(message) {
+  process.stderr.write(`ec-safe-output: ${message}\n`);
+  process.exit(2);
+}
+
+function sameOrDescendant(candidate, parent) {
+  const relative = path.relative(parent, candidate);
+  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
+}
+
+function decodePayload(encoded) {
+  try {
+    const value = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+    if (!value || value.v !== 1 || !Array.isArray(value.argv) || value.argv.some(arg => typeof arg !== 'string')) return null;
+    return value;
+  } catch {
+    return null;
+  }
+}
+
+function validateCommand(payload) {
+  const executable = path.basename(payload.argv[0] ?? '').toLowerCase();
+  if (payload.kind === 'ec') return EC_EXECUTABLES.has(executable);
+  if (payload.kind !== 'host-process' || !HOST_PROCESS_EXECUTABLES.has(executable)) return false;
+  return !payload.argv.some(arg => /\bnode(?:js|\.exe)?\b/i.test(arg));
+}
+
+function resolveExecutionPaths(payload) {
+  if (typeof payload.workspace !== 'string' || typeof payload.cwd !== 'string') fail('invalid workspace');
+  let workspace;
+  let cwd;
+  try {
+    workspace = fs.realpathSync(payload.workspace);
+    cwd = fs.realpathSync(payload.cwd);
+  } catch {
+    fail('workspace or cwd does not exist');
+  }
+  if (!sameOrDescendant(cwd, workspace)) fail('cwd escapes workspace');
+  return { workspace, cwd };
+}
+
+function openOutputFile(payload, paths) {
+  if (payload.outputPath === undefined) return undefined;
+  if (typeof payload.outputPath !== 'string' || !payload.outputPath || path.isAbsolute(payload.outputPath)) {
+    fail('output path must be relative');
+  }
+  const target = path.resolve(paths.cwd, payload.outputPath);
+  const parent = path.dirname(target);
+  let realParent;
+  try {
+    realParent = fs.realpathSync(parent);
+    if (!fs.statSync(realParent).isDirectory()) fail('output parent is not a directory');
+  } catch {
+    fail('output parent does not exist');
+  }
+  const canonicalTarget = path.join(realParent, path.basename(target));
+  if (!sameOrDescendant(canonicalTarget, paths.workspace)) fail('output path escapes workspace');
+  const relative = path.relative(paths.workspace, canonicalTarget);
+  if (relative === '.git' || relative.startsWith(`.git${path.sep}`)) fail('output path may not target Git metadata');
+
+  const noFollow = fs.constants.O_NOFOLLOW ?? 0;
+  try {
+    const fd = fs.openSync(
+      canonicalTarget,
+      fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL | noFollow,
+      0o600,
+    );
+    if (!fs.fstatSync(fd).isFile()) {
+      fs.closeSync(fd);
+      fail('output target is not a regular file');
+    }
+    return { fd, target: canonicalTarget };
+  } catch (error) {
+    fail(error?.code === 'EEXIST' ? 'output file already exists' : 'unable to create output file');
+  }
+}
+
+const payload = decodePayload(process.argv[2]);
+if (!payload) fail('invalid payload');
+if (!validateCommand(payload)) fail('command is not permitted');
+if (payload.headLines !== undefined
+  && (!Number.isSafeInteger(payload.headLines) || payload.headLines < 1 || payload.headLines > 10_000)) {
+  fail('invalid head line limit');
+}
+
+const paths = resolveExecutionPaths(payload);
+const output = openOutputFile(payload, paths);
+let bytesWritten = 0;
+let linesWritten = 0;
+let limitReached = false;
+let writeFailed = false;
+
+function writeLimited(chunk) {
+  if (limitReached || writeFailed) return;
+  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+  let allowed = Math.min(buffer.length, MAX_OUTPUT_BYTES - bytesWritten);
+  if (payload.headLines !== undefined) {
+    let cursor = 0;
+    while (cursor < allowed) {
+      const newline = buffer.indexOf(0x0a, cursor);
+      if (newline < 0 || newline >= allowed) break;
+      linesWritten++;
+      cursor = newline + 1;
+      if (linesWritten >= payload.headLines) {
+        allowed = cursor;
+        limitReached = true;
+        break;
+      }
+    }
+  }
+  if (allowed <= 0) {
+    limitReached = true;
+    return;
+  }
+  const slice = buffer.subarray(0, allowed);
+  try {
+    if (output) fs.writeSync(output.fd, slice);
+    else process.stdout.write(slice);
+    bytesWritten += slice.length;
+    if (bytesWritten >= MAX_OUTPUT_BYTES) limitReached = true;
+  } catch {
+    writeFailed = true;
+  }
+}
+
+const child = spawn(payload.argv[0], payload.argv.slice(1), {
+  cwd: paths.cwd,
+  env: process.env,
+  stdio: ['ignore', 'pipe', payload.mergeStderr ? 'pipe' : 'inherit'],
+});
+child.stdout.on('data', writeLimited);
+if (payload.mergeStderr) child.stderr.on('data', writeLimited);
+
+child.once('error', error => {
+  if (output) {
+    try { fs.closeSync(output.fd); } catch {}
+    try { fs.unlinkSync(output.target); } catch {}
+  }
+  fail(`unable to start command: ${error.message}`);
+});
+
+child.once('close', code => {
+  if (output) {
+    try { fs.closeSync(output.fd); } catch { writeFailed = true; }
+  }
+  if (writeFailed) {
+    if (output) try { fs.unlinkSync(output.target); } catch {}
+    fail('failed to write command output');
+  }
+  if (output) process.stderr.write(`Saved output to ${output.target}\n`);
+  process.exitCode = code ?? 1;
+});