evolcore 0.0.33 → 0.0.34

package/dist/utils/error-utils.js

@@ -91,6 +91,117 @@ export var ErrorType;
     ErrorType["CLAUDE_CODE_STARTUP_FAILED"] = "claude_code_startup_failed";
     ErrorType["UNKNOWN"] = "unknown";
 })(ErrorType || (ErrorType = {}));
+export function getErrorRawText(error, seen = new Set()) {
+    if (typeof error === 'string') {
+        const text = error.trim();
+        return text || undefined;
+    }
+    if (error === null || error === undefined)
+        return undefined;
+    if (typeof error === 'object') {
+        const record = error;
+        if (seen.has(error))
+            return undefined;
+        seen.add(error);
+        if ('raw' in record) {
+            const raw = record.raw;
+            if (typeof raw === 'string' && raw.trim())
+                return raw.trim();
+        }
+        const causeText = getErrorRawText(record.cause, seen);
+        if (causeText)
+            return causeText;
+        for (const key of ['message', 'error', 'reason']) {
+            const value = record[key];
+            if (typeof value === 'string' && value.trim())
+                return value.trim();
+            if (value && typeof value === 'object') {
+                const nestedText = getErrorRawText(value, seen);
+                if (nestedText)
+                    return nestedText;
+            }
+        }
+        const code = record.code;
+        if (typeof code === 'string' && code.trim())
+            return code.trim();
+        return undefined;
+    }
+    const text = String(error).trim();
+    return text || undefined;
+}
+export function normalizeCoreErrorSubtype(error, reportedSubtype, terminalReason) {
+    const reported = reportedSubtype?.trim().toLowerCase();
+    if (error instanceof OrphanedTargetSessionError)
+        return ErrorType.SESSION_UNAVAILABLE;
+    if (error instanceof ExecutionTimeoutError)
+        return ErrorType.SDK_TIMEOUT;
+    if (terminalReason === 'prompt_too_long' || terminalReason === 'context_compact_failed') {
+        return ErrorType.CONTEXT_TOO_LONG;
+    }
+    if (terminalReason === 'max_output_tokens')
+        return ErrorType.MAX_OUTPUT_TOKENS;
+    if (terminalReason === 'model_error')
+        return ErrorType.MODEL_UNAVAILABLE;
+    if (terminalReason === 'permission_denied')
+        return 'permission_error';
+    if (terminalReason === 'timeout' || terminalReason === 'total_execution_timeout')
+        return ErrorType.SDK_TIMEOUT;
+    if (reported === 'protocol_incomplete')
+        return 'protocol_incomplete';
+    if (reported === 'permission_denied' || reported?.startsWith('permission_'))
+        return 'permission_error';
+    const classified = classifyError(typeof error === 'string' ? new Error(error) : error);
+    if (classified !== ErrorType.UNKNOWN)
+        return classified;
+    if (reported && Object.values(ErrorType).includes(reported))
+        return reported;
+    switch (reported) {
+        case 'error_api':
+        case 'api':
+        case 'infrastructure':
+            return ErrorType.API_ERROR;
+        case 'error_model':
+        case 'model_error':
+            return ErrorType.MODEL_UNAVAILABLE;
+        case 'error_tool_use':
+        case 'tool_error':
+            return ErrorType.STREAM_ERROR;
+    }
+    if (terminalReason === 'rapid_refill_breaker')
+        return ErrorType.API_ERROR;
+    if (terminalReason === 'tool_error')
+        return ErrorType.STREAM_ERROR;
+    if (reported)
+        return reported;
+    return ErrorType.UNKNOWN;
+}
+export function normalizeCoreErrorReason(reason) {
+    const normalized = reason?.trim().toLowerCase();
+    switch (normalized) {
+        case 'retry.exhausted':
+            return 'retry_exhausted';
+        case 'sdk_timeout':
+        case 'total_execution_timeout':
+            return 'timeout';
+        case 'aborted_streaming':
+        case 'aborted_tools':
+        case 'stop':
+            return 'cancelled';
+        case 'protocol_incomplete':
+        case 'max_output_tokens':
+        case 'target_session_timeout':
+        case 'retry_exhausted':
+        case 'timeout':
+        case 'cancelled':
+        case 'permission_denied':
+        case 'input_already_submitted':
+        case 'fallback_exhausted':
+        case 'orphaned_target_session':
+            return normalized;
+        default:
+            return undefined;
+    }
+}
 /**
  * 错误来源前缀 — 区分基础设施异常 vs Agent 任务失败
  *
@@ -516,6 +627,16 @@ export function getErrorMessage(error, terminalReason, includeEmoji = true) {
         return `${errPrefix}暂无法判定错误原因：${msg}`;
     return `${errPrefix}处理消息时出错，请稍后重试`;
 }
+export function getToolResultErrorText(event) {
+    const text = event.error || event.reason
+        || (event.name === 'Shell'
+            ? typeof event.exitCode === 'number' && Number.isInteger(event.exitCode)
+                ? 'exitCode: ' + event.exitCode
+                : '执行失败'
+            : typeof event.result === 'string' ? event.result : JSON.stringify(event.result))
+        || '执行失败';
+    return text.replace(/<tool_use_error>(.*?)<\/tool_use_error>/gs, '$1');
+}
 function resolveErrorMessage(error) {
     if (typeof error === 'string')
         return error.trim();

package/dist/utils/instance-registry.js

@@ -11,8 +11,8 @@
 import fs from 'fs';
 import path from 'path';
 import { spawnSync } from 'child_process';
-import { getPackageRoot, resolvePaths } from '../paths.js';
-import { isProcessRunning, killProcess, isWindows, findProcesses } from './cross-platform.js';
+import { getPackageRoot, resolvePaths, isDevMode } from '../paths.js';
+import { isProcessRunning, killProcess, isWindows, findProcessesWithCommandLine } from './cross-platform.js';
 import { getProcessStartTime, startTimeMatches } from './process-introspect.js';
 import { isConfirmedLeakedTestDaemon, runtimeHomeFromEnv } from './restart-safety.js';
 import { decodeWindowsOutput } from './windows-output.js';
@@ -55,6 +55,7 @@ export function writeMain(launchedBy) {
         startedAt,
         startedAtIso: new Date(startedAt).toISOString(),
         launchedBy,
+        runMode: isDevMode() ? 'dev' : 'install',
     };
     const filePath = path.join(dir, mainFileName(process.pid));
     writeAtomic(filePath, JSON.stringify(record, null, 2));
@@ -376,10 +377,10 @@ export function isEvolCoreMainCommand(cmdline, packageRoot = getPackageRoot()) {
  *
  * 不会主动 kill——清理由调用方决定。
  */
-export function findOrphanProcesses() {
-    // 1. 已登记 PID（自己 HOME 下的 main + 自己进程）
+export function findOrphanProcesses(status = scanInstances()) {
+    // 1. 已登记 PID（自己 HOME 下的 main + 自己进程）。调用方刚扫过登记簿时可直接传入，
+    //    Windows 上每次 scanInstances 都要为活实例跑一遍 CIM 查询。
     const known = new Set([process.pid]);
-    const status = scanInstances();
     for (const m of status.mains) {
         if (m.alive)
             known.add(m.record.pid);
@@ -393,14 +394,18 @@ export function findOrphanProcesses() {
     // regex contains escaped separators and is applied after command lines have
     // been fetched; embedding it in the CIM pre-filter can silently miss a
     // backslash-delimited `dist\\index.js` command on some PowerShell builds.
-    const candidates = findProcesses('index\\.js');
+    // `index.js` 会命中所有 Node 服务（各会话拉起的 MCP server 常有十几个），
+    // 所以先用快照里的命令行过滤，只对真正的 EvolCore 入口做后续探测。
+    const candidates = findProcessesWithCommandLine('index\\.js');
     const orphans = [];
-    for (const pid of candidates) {
+    for (const { pid, commandLine } of candidates) {
         if (known.has(pid))
             continue;
+        if (commandLine !== undefined && !isEvolCoreMainCommand(commandLine))
+            continue;
         if (!isProcessRunning(pid))
             continue;
-        const cmdline = readCmdline(pid);
+        const cmdline = commandLine || readCmdline(pid);
         // 二次验证：入口必须是当前 EvolCore 包的 dist/index.js。
         if (!isEvolCoreMainCommand(cmdline))
             continue;

package/dist/utils/log-writer.js

@@ -122,6 +122,18 @@ export class LogWriter {
             // 写入失败不抛——日志不能影响业务
         }
     }
+    writeChecked(line) {
+        this.rotateIfNeeded(false);
+        const filePath = this.activePath();
+        const descriptor = fs.openSync(filePath, fs.constants.O_APPEND | fs.constants.O_CREAT | fs.constants.O_WRONLY | (fs.constants.O_NOFOLLOW ?? 0), 0o600);
+        try {
+            fs.fchmodSync(descriptor, 0o600);
+            fs.writeFileSync(descriptor, line + '\n');
+        }
+        finally {
+            fs.closeSync(descriptor);
+        }
+    }
     /** 关闭（停掉清理 timer）。一般不需要调用，进程退出 timer 自动失效 */
     close() {
         if (this.boundaryTimer) {

package/dist/utils/process-introspect.js

@@ -29,11 +29,22 @@ function readLinuxClockTicks() {
 const linuxClockTicks = readLinuxClockTicks();
 /** 容差：2 秒（覆盖 macOS 秒级精度 + 时钟漂移） */
 export const START_TIME_TOLERANCE_MS = 2000;
+/** 本进程的启动时间不会变；Windows 上每次查询都要拉起一次 PowerShell（约 0.4s）。 */
+let selfStartTime = null;
 /**
  * 获取进程启动时间（Unix 毫秒）。
  * 拿不到时返回 null，调用方应保守处理（不杀该 PID）。
  */
 export function getProcessStartTime(pid) {
+    if (pid === process.pid) {
+        // 只缓存成功结果，一次探测失败不会让后续调用永久拿到 null。
+        if (selfStartTime === null)
+            selfStartTime = readProcessStartTime(pid);
+        return selfStartTime;
+    }
+    return readProcessStartTime(pid);
+}
+function readProcessStartTime(pid) {
     try {
         if (isWindows)
             return getStartTimeWindows(pid);

package/kits/docs/context-assembly.md

@@ -295,7 +295,6 @@ coding 场景（无 channel/无身份）下，`chatType`、`channel`、`selfAid`
 | 15 | bootstrap-guide | `bootstrap.md` | lifecycle=bootstrapping | ✓ |
 | 20 | identity-layer | fragment | active 且 chatType≠null | ✓ |
 | 21 | persona | `$PERSONAL_DIR/persona.md` | active 且 chatType≠null | ✗ |
-| 21.5 | personal-profile | `$PERSONAL_DIR/personal.md` | active 且 chatType≠null | ✗ |
 | 30 | relation-layer | fragment | active 且 chatType∈{private,group} | ✓ |
 | 35 | memory | `$KITS_FRAGMENTS/memory.md` | active 且 memoryEnableRelation≠false | ✓ |
 | 36 | agent-memory | `$PERSONAL_DIR/memory/MEMORY.md` | active 且 memoryEnableAgent≠false | ✗ |

package/kits/docs/evolcore/agent-create.md

@@ -161,12 +161,13 @@ Bootstrap 完成前，新 Agent 不处理普通任务，也不执行与本流程
 - 只修改 `name`、`description`、`tags`，不改其它 frontmatter 字段或正文。
 - 名片文件位于受保护路径，用文件工具直接读写会被拒绝；`set` 命令会自己写回并签名。
 
-对话式 Bootstrap 中，新 Agent 还要在 `$PERSONAL_DIR/personal.md` 中写入交接摘要（一次性 `--initialize` 模式不经过这段对话，也不会自动生成此摘要）：
+对话式 Bootstrap 中，新 Agent 还要在 `$PERSONAL_DIR/persona.md` 中写入交接摘要（一次性 `--initialize` 模式不经过这段对话，也不会自动生成此摘要）：
 
 - 忠实整理 Owner 已明确提供或已认可的职责、协作边界、重要约束和激活后待继续事项，不新增推断或约定；此内部交接不要求 Owner 审稿，确有职责歧义才澄清设定本身。待继续事项标注“未执行”，不启动任务或设置自动触发。
 - 没有额外约束或待继续事项时省略相应条目，仍保存已明确的职责，不为补齐摘要增加追问。
 - 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断；此文件会进入后续私聊和群聊上下文，不写 Owner 的私密信息。
-- 文件不存在时创建；已有文件只新增或幂等更新 `## Bootstrap 交接` 段落，保留其它内容。
+- 文件不存在时创建；已有文件只新增或幂等更新 `## Bootstrap 交接` 段落，**保留其它段落**（尤其是 Owner 已设定的人格内容）。
+- 写这一段用文件工具直接编辑 `persona.md`（Owner 会话中该文件可写）；不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
 - 交接摘要保存失败时不得执行 `ready`；不要把摘要整理变成名片确认后的另一轮确认。
 
 ## 5. Agent 自主准备正式欢迎文案并发布名片
@@ -208,7 +209,7 @@ ec agent ready helper.agentid.pub
 3. 为每位 Owner 创建全新的主会话。
 4. 向全部 Owner 发送正式欢迎消息，并为各 Owner 绑定对应的新会话。
 
-新主会话会在文件存在时自动注入 `$PERSONAL_DIR/personal.md`。新 Agent 首次回复前，应先阅读其中的 `## Bootstrap 交接`，沿用已确认的职责和约定；仅对标注为未执行的事项按正常权限继续沟通，不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要，不是系统自动复制或总结旧 Bootstrap 历史，会话切换机制保持不变。
+新主会话会在文件存在时自动注入 `$PERSONAL_DIR/persona.md`。新 Agent 首次回复前，应先阅读其中的 `## Bootstrap 交接`，沿用已确认的职责和约定；仅对标注为未执行的事项按正常权限继续沟通，不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要，不是系统自动复制或总结旧 Bootstrap 历史，会话切换机制保持不变。
 
 新 Agent 在 `ready` 成功后不要从旧 Bootstrap 上下文再输出一段完成说明，也不要继续处理先前夹带的普通任务；后续工作从新主会话开始。
 
@@ -236,7 +237,7 @@ Bootstrap 首条消息只发送给 `owners[0]`；`ready` 成功后，正式欢
 - 本地与远端 `agent.md` 的 `name`、`description`、`tags` 与 Owner 明确提供或已认可的值一致；创建流程 skill 必须在发布后复读核验，不以初始上传响应代替。
 - 如果 Owner 选择提供头像，远端 `agent.md` 的 `avatar` 已更新并发布；未提供时跳过，已明确提供但规范化或上传失败时创建进入可恢复失败状态。
 - 对话式 Bootstrap：`personal/welcome.md` 已保存 Agent 自主准备的完整正式文案；Owner 未被要求起草、审稿或确认，投递使用已保存正文。
-- 对话式 Bootstrap：`personal/personal.md` 包含忠实整理明确职责和约定的 `## Bootstrap 交接` 摘要；待继续事项标注“未执行”，未确认的设定推断、完整历史和临时运行状态没有写入。
+- 对话式 Bootstrap：`personal/persona.md` 包含忠实整理明确职责和约定的 `## Bootstrap 交接` 摘要；待继续事项标注“未执行”，未确认的设定推断、完整历史和临时运行状态没有写入。
 - 系统已创建新的主会话并发送正式欢迎消息。
 - 新 Agent 能在新主会话中处理普通任务。
 

package/kits/docs/evolcore/agent.md

@@ -66,7 +66,7 @@ ec agent welcome show
 ec agent welcome --text '<完整 Markdown 文案>'
 
 # 修改 agent.md 显示名称
-ec agent rename <aid> "<name>"
+ec agent rename <aid> '<name>'
 
 # 标记 bootstrap 完成，进入 active 状态
 ec agent ready <aid>
@@ -97,7 +97,7 @@ ec agent delete <aid> [--purge]
 - `ec agent welcome --text <text>` 用于保存 Bootstrap 中 Agent 自主准备的完整正式文案，不要求 Owner 起草、审稿或确认；命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`，不接受自定义路径。`welcome show` 读取该文件。
 - welcome 托管写入要求当前 Agent 私聊 Owner；admin 仅可读。模板上限 4 KiB，渲染上限 8 KiB；变量为 `agentName`、`agentDescription`、`agentAid`、`agentTags`、`agentTagsText`、`ownerName`、`ownerAid`、`channel`，支持标签循环和真值条件。写入保留原始文本，投递不附加额外文案。
 - `agent show <target-aid>` 与 `agent get <target-aid> <key>` 的跨 Agent 读取对 owner/admin 开放，但普通 Agent 角色只获得安全摘要；敏感配置值和物理路径仅对 DaemonOwner 返回原值。跨 Agent 写入、启停、删除和 reload 仍遵循各自的目标与 DaemonOwner 权限边界。
-- Agent 配置可包含 `fullaccess.enabled`（默认关闭），仅可通过已认证的 EC Web Agent 设置修改。实际运行时，只有同时属于该 Agent Owner 和当前 daemon Owner 的直接私聊任务才会按调用使用宿主级 fullaccess；群聊、普通 Owner、跨 Agent 和 Trigger 不会因该开关自动提权。`/fa`、`/fullaccess` 和 Fullaccess Trigger 是内置能力，仍分别要求经过认证的 daemon Owner / 持久授权来源。
+- Agent 配置可包含 `fullaccess.enabled`（默认关闭）。可通过已认证的 EC Web Agent 设置修改；也可通过 Agent AID 的 `name: "agent"` Menu 管理自身，或通过 daemon Control AID 的同名 Menu 指定 `args.aid` 管理目标 Agent。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner；实际运行时也只有满足双 Owner 条件的直接私聊任务才会按调用使用宿主级 fullaccess。群聊、普通 Owner、跨 Agent 和 Trigger 不会因该开关自动提权。`/fa`、`/fullaccess` 和 Fullaccess Trigger 是内置能力，仍分别要求经过认证的 daemon Owner / 持久授权来源。
 
 ## 创建 Agent
 

package/kits/docs/evolcore/config.md

@@ -58,7 +58,7 @@ ec config set configSnapshots false --process
 
 ```bash
 # 立即创建快照（与当前版本比对，不一致才建；--full 强制新全量）（仅人）
-ec config snapshot [--full] [--desc "说明"]
+ec config snapshot [--full] [--desc '<说明>']
 
 # 列出快照版本（版本号/类型/触发/时间/说明）
 ec config history
@@ -221,7 +221,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行，不会
   `role` 由角色分配服务维护；`permissionMode` 仅在角色策略中维护
 - **兼容字段**：`enable_rich_content` 仍可读取旧值，但已废弃且不再产生运行时效果
 - **群规则策略**：`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset；DaemonOwner 不继承群或 relation 写权限，其他角色可读取当前 relation 的有效值
-- **Agent fullaccess 策略**：Agent 配置中的 `fullaccess.enabled` 缺失时关闭，仅可通过已认证的 EC Web Agent 设置修改；CLI、普通 Menu 和托管任务的 set/unset 均拒绝。双 Owner（Agent Owner + daemon Owner）条件在实际私聊任务执行时校验。`/fa`、`/fullaccess` 和 Fullaccess Trigger 不再依赖 daemon 级开关，而由各自的 daemon Owner 鉴权与批准链控制。
+- **Agent fullaccess 策略**：Agent 配置中的 `fullaccess.enabled` 缺失时关闭。已认证的 EC Web Agent 设置可修改；Menu 可经 Agent AID 管理自身，或经 daemon Control AID 以 `args.aid` 指定目标 Agent，Menu 写入要求同一请求者同时是目标 Agent Owner 与 daemon Owner。CLI 和托管任务的 set/unset 均拒绝。双 Owner（Agent Owner + daemon Owner）条件在实际私聊任务执行时再次校验。`/fa`、`/fullaccess` 和 Fullaccess Trigger 不依赖此 Agent 级开关，而由各自的 daemon Owner 鉴权与批准链控制。
 - **源码诊断白名单**：`readonlySourceDiagnostics` 默认关闭；开启后只读会话仅可在项目源码目录执行受限、可证明只读查询，配置/证书/快照/session/锁文件仍禁止访问
 - **仅人可写**：channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
 - Agent 托管环境写仅人字段被拒

package/kits/docs/evolcore/ctl.md

@@ -21,11 +21,11 @@ ec ctl name <新名称>
 ## 消息（兜底用）
 
 ```bash
-ec ctl send "<text>"      # 主动发送文本（proactive 模式）
+ec ctl send '<text>'      # 主动发送文本（proactive 模式）
 ec ctl file [channel] <path>   # 发送项目内文件
 ```
 
-> 发消息**首选 `ec msg send <self-aid> <peer-id> "<text>"`**（见 msg.md）。
+> 发消息**首选 `ec msg send <self-aid> <peer-id> '<text>'`**（见 msg.md）。
 > `ec ctl send` 只在拿不到自己的 AID 时兜底——它自动继承当前会话的 AID 和对端。
 
 ## 消息队列

package/kits/docs/evolcore/ec-capabilities.md

@@ -281,7 +281,7 @@ metadata:
 ```bash
 ec skill list [--json]                  # 列出所有技能：名称、来源、最终状态
 ec skill info <name> [--json]           # 单技能详情：路径、描述、三级开关、生效依据
-ec skill create <name> [--desc "..."] [--enable]   # 新建技能骨架到本机级（默认禁用）
+ec skill create <name> [--desc '...'] [--enable]   # 新建技能骨架到本机级（默认禁用）
 ec skill install <源> [--force] [--enable]         # 安装技能（目录 / .zip / .md，默认禁用）
 ec skill remove <name>                  # 删除本机技能（内置技能不能删）
 ec skill enable <name> [--level agent|local]

package/kits/docs/evolcore/fs-architecture.md

@@ -534,9 +534,8 @@ ec fs cp a.agentid.pub:/x bob.agentid.pub:/refs/x           # 跨主机
 ```bash
 ec fs chmod +r <AID>:<path>                   # 公开可读
 ec fs chmod o-r <AID>:<path>                  # 收回他人读权限
-ec fs chmod <AID>:<path> --allow-roles admin  # 限定角色
+ec fs chmod <AID>:<path> --allow-roles admin  # 限定角色（多个角色用单引号包住逗号分隔）
 ec fs chmod <AID>:<path> --visibility public|private
-ec fs chmod <AID>:<path> --tags "a,b"
 ```
 
 ### 8.3 细粒度 AID 授权（setfacl）
@@ -1052,11 +1051,11 @@ alice.aid.pub:/projects/myapp/
 ### 17.5 命令集
 
 ```bash
-ec collab snapshot create  <collab-root> [--major] [-m "说明"]      # 创建快照（默认自动算 bump）
+ec collab snapshot create  <collab-root> [--major] [-m '<说明>']      # 创建快照（默认自动算 bump）
 ec collab snapshot list    <collab-root>                           # 列出所有快照
 ec collab snapshot show    <collab-root> <version>                 # 看某快照的完整 entries
 ec collab snapshot diff    <collab-root> <vA> <vB>                 # 比较两快照（doc 增删 / 版本变化）
-ec collab snapshot restore <collab-root> <version> [-m "说明"]      # 回滚到某快照（非破坏性）
+ec collab snapshot restore <collab-root> <version> [-m '<说明>']      # 回滚到某快照（非破坏性）
 ec collab snapshot rm      <collab-root> <version>                 # 删除指定快照（只删 manifest）
 ec collab snapshot prune   <collab-root> --before <date> [--keep-last <n>]   # 按时间清理
 ```
@@ -1109,7 +1108,7 @@ forward 历史全部保留，任何时候都能再前滚。
 ```
 ✗ 快照创建失败：快照头已被他人推进（你基于 2.3.0，当前已是 2.4.0）
   你的目录状态未受影响
-  请重新执行: ec collab snapshot create alice.aid.pub:/projects/myapp -m "..."
+  请重新执行: ec collab snapshot create alice.aid.pub:/projects/myapp -m '...'
 ```
 
 ### 17.8 典型流程

package/kits/docs/evolcore/fs.md

@@ -53,7 +53,7 @@ ec fs umount <AID>:<path>         # 卸载挂载点
 - `--max-bytes <n>`：`cat` 最大直接输出字节数，默认 1MB
 - `--head-bytes <n>`：`cat` 二进制头部字节数，默认 256
 - `--visibility public|private`：`chmod` 可见性
-- `--allow-roles <roles>`：`chmod` 角色约束，逗号分隔
+- `--allow-roles <roles>`：`chmod` 角色约束，写法固定为单引号包住、逗号分隔，如 `--allow-roles 'owner,admin'`
 - `-m aid:<aid>:<perms>` / `-x aid:<aid>`：`setfacl` 增删 ACL
 - `--source <AID>:<path>` / `--volume <id>`：`mount` 来源
 - `--expires <time>`：`mount/token/ACL` 过期时间，Unix 秒或 ISO 日期

package/kits/docs/evolcore/group-collaboration.md

@@ -151,8 +151,8 @@ ec group rules coordinator.agentid.pub <group-id> get --format json
 
 ```bash
 ec group send coordinator.agentid.pub <group-id> \
-  "[A-001] API 重构协作启动。目标：完成 /collab/A-001/ 下的实现和回归报告。负责人：implementer；复核：reviewer；截止：2026-09-30 18:00。请先回复 ACK，再按规则汇报。" \
-  --mention implementer.agentid.pub,reviewer.agentid.pub
+  '[A-001] API 重构协作启动。目标：完成 /collab/A-001/ 下的实现和回归报告。负责人：implementer；复核：reviewer；截止：2026-09-30 18:00。请先回复 ACK，再按规则汇报。' \
+  --mention 'implementer.agentid.pub,reviewer.agentid.pub'
 ```
 
 每个任务至少包含：

package/kits/docs/evolcore/group.md

@@ -14,10 +14,10 @@
 
 ```bash
 # 文本（含空格/换行/特殊字符时用引号包起来；纯短词可不包，但多空格会被压成一个）
-ec group send <from> <group-id> "<text>" [--encrypt]
+ec group send <from> <group-id> '<text>' [--encrypt]
 
 # 文件（--as image|video|voice|file）
-ec group send <from> <group-id> --file <path> [--as <type>] [--text "<说明>"]
+ec group send <from> <group-id> --file <path> [--as <type>] [--text '<说明>']
 
 # 自定义 payload
 ec group send <from> <group-id> --payload '<json>'
@@ -33,12 +33,12 @@ ec group ack <from> <group-id> <seq> [--app <name>]
 ```
 
 @ 成员：
-- `--mention <aid>` — @ 某个成员，可多次，或单个槽位用逗号分隔多个（`--mention a,b,c`），每个 aid 都过格式校验
+- `--mention '<aid1>,<aid2>'` — @ 某个成员。写法固定为单引号包住、逗号分隔，可多次传入，每个 aid 都过格式校验
 - `--mention-all` — @ 所有人
 
 ```bash
-ec group send <from> <group-id> "@bob 看下 PR" --mention bob.agentid.pub
-ec group send <from> <group-id> "通知" --mention alice.agentid.pub,bob.agentid.pub
+ec group send <from> <group-id> '@bob 看下 PR' --mention 'bob.agentid.pub'
+ec group send <from> <group-id> '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
 ```
 
 > 正文恰好以 `--` 开头：带空格的（如 `"--file 是正文"`）会被正确识别为正文；
@@ -88,7 +88,7 @@ owner/admin 按 Agent 管理范围查询其他群；visitor 默认拒绝。
 
 ```bash
 # 创建群
-ec group create <from> "<name>" [--visibility public|private] [--description "<desc>"] [--join-mode <mode>] [--group-id <aid>]
+ec group create <from> '<name>' [--visibility public|private] [--description '<desc>'] [--join-mode <mode>] [--group-id <aid>]
 
 # 不指定 --group-id 时，默认名称为 g- 加五位随机数字（10000–99999）
 # 例如返回 g-12345.agentid.cn；issuer 以群服务实际返回为准
@@ -104,7 +104,7 @@ ec group list <from> [--size <N>]
 ec group info <from> <group-id>
 
 # 修改群信息
-ec group update <from> <group-id> [--name "<name>"] [--description "<desc>"]
+ec group update <from> <group-id> [--name '<name>'] [--description '<desc>']
 
 # 解散群
 ec group dissolve <from> <group-id>
@@ -117,7 +117,7 @@ ec group resume <from> <group-id>
 ec group rules <from> <group-id>
 
 # 更新入群规则
-ec group rules <from> <group-id> --mode open|approval|invite_only|closed [--question "<question>"] [--max-pending <N>]
+ec group rules <from> <group-id> --mode open|approval|invite_only|closed [--question '<question>'] [--max-pending <N>]
 
 # 查看已发布群规则文件 /rules.md
 ec group rules <from> <group-id> get
@@ -178,7 +178,7 @@ admin、普通成员或仅具 daemon-owner 身份者不能代替该 Agent Owner
 
 ```bash
 # 申请加入
-ec group join <from> <group-id> [--message "<msg>"] [--answer "<answer>"]
+ec group join <from> <group-id> [--message '<msg>'] [--answer '<answer>']
 
 # 退出群
 ec group leave <from> <group-id>
@@ -211,7 +211,7 @@ ec group ban <from> <group-id> <member-aid> [--duration <seconds>]
 ec group unban <from> <group-id> <member-aid>
 
 # 屏蔽成员接收群消息；member-aid 填 from 即屏蔽自己
-ec group block <from> <group-id> <member-aid> [--reason "<reason>"]
+ec group block <from> <group-id> <member-aid> [--reason '<reason>']
 
 # 取消屏蔽
 ec group unblock <from> <group-id> <member-aid>

package/kits/docs/evolcore/memory-architecture.md

@@ -8,8 +8,8 @@
 主会话写 note  →  pending/  →  整理会话产生正式记忆  →  consolidated/  →  索引自动注入
 ```
 
-- **note 是原料**：主会话写，不分类、不判断层级，不进索引、不签名。
-- **正式记忆只由整理会话产生**：读 note 或候选记忆，判断取舍，用 `create` / `update` / `archive` 写入。程序负责签名、重建索引、落日志。
+- **note 是原料**：主会话写，不分类、不判断层级，不进索引、不进台账。
+- **正式记忆只由整理会话产生**：读 note 或候选记忆，判断取舍，用 `create` / `update` / `archive` 写入。程序负责登记完整性台账、重建索引、落日志。
 
 ## 三个作用域
 
@@ -68,10 +68,9 @@ $RELATIONS_DIR/<peerKey>/memory/     ← relation 作用域（note 唯一写入
 ├── pending/                         # note 写入的临时记忆
 │   └── archive/                     # 被 drop 的 note
 ├── processing/                      # 整理中的快照
-├── consolidated/                    # 正式记忆（已签名）
+├── consolidated/                    # 正式记忆（已登记完整性台账）
 └── archive/
-    ├── notes/                       # 整理完成的 pending 原件
-    └── invalid/                     # 验签失败或未签名的文件
+    └── notes/                       # 整理完成的 pending 原件
 
 $PERSONAL_DIR/memory/                    ← agent 作用域（结构相同，由泛化产出）
 $EVOLCORE_HOME/memory/owner/<ownerAid>/  ← owner 作用域（结构相同，由提升产出）

package/kits/docs/evolcore/memory-consolidation.md

@@ -23,7 +23,7 @@
   │                    │                         ├─ 读上下文文件       │
   │                    │                         ├─ 读候选记忆         │
   │                    │                         ├─ create/update/archive
-  │                    │                         │                    ├─ 签名
+  │                    │                         │                    ├─ 登记
   │                    │                         │                    ├─ 日志落盘
   │                    │◄──── 会话结束 ───────────┤                    │
   │              onConsolidationComplete()       │                    │
@@ -63,24 +63,24 @@
 
 ## 三、三个写命令
 
-整理会话只能用这三个命令写正式记忆。**不允许用 Write / Edit 直接写文件**——那会绕过签名和索引。
+整理会话只能用这三个命令写正式记忆。**不允许用 Write / Edit 直接写文件**——那会绕过完整性台账和索引，被当作带外修改恢复掉。
 
 ### create — 新建
 
 ```bash
-ec memory create --scope <relation|agent|owner> --slug <slug> --desc "一句话描述" \
-  --tags <tag1,tag2,...> [--keywords <kw1,kw2,...>] [--replaces <路径,...>] "<正文>"
+ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话描述' \
+  --tags '<tag1>,<tag2>' [--keywords '<kw1>,<kw2>'] [--replaces '<路径1>,<路径2>'] '<正文>'
 ```
 
-- 程序负责签名、写入 `consolidated/`、重建索引。
+- 程序负责写入 `consolidated/`、登记完整性台账、重建索引。
 - `--replaces` 指定的旧文件会被自动归档——**合并、纠正内容、升格作用域都走这条路径**，一次调用完成，不会出现「新的写了、旧的没归档」的重复记忆。
 - **目标 slug 已存在且未在 `--replaces` 里列出 → 拒绝**，报错回传已有文件路径。这是防止漏用 `--replaces` 导致静默覆盖的闸门。
-- **正文上限 10KB**，超出报 `MEMORY_TOO_LARGE`。这不是技术限制（底层签名接口本身无上限），而是记忆的性质决定的：一条记忆应当是**一句话能说清的结论**。内容确实那么多时，拆成多条分别 `create`，或把细节留在归档文件里、记忆只记结论。
+- **正文上限 10KB**，超出报 `MEMORY_TOO_LARGE`。这不是技术限制，而是记忆的性质决定的：一条记忆应当是**一句话能说清的结论**。内容确实那么多时，拆成多条分别 `create`，或把细节留在归档文件里、记忆只记结论。
 
 ### update — 只改标签
 
 ```bash
-ec memory update <路径> --tags <tag1,tag2,...>     # 整体替换标签
+ec memory update <路径> --tags '<tag1>,<tag2>'       # 整体替换标签
 ec memory update <路径> --touch                   # 刷新 mtime 与 updatedAt，用于续期
 ```
 
@@ -175,12 +175,17 @@ daemon 按整理会话的模式校验 `--scope`：
 
 **能**：
 
-- 用 Read / Glob / Grep 读上下文文件、`processing/`、`consolidated/`、`MEMORY.md`、批次目录。
+- 用 Read / Glob / Grep 读任务书、`processing/`、`consolidated/`、`MEMORY.md`、本对话流水。
 - 用 Bash 执行**单条** `ec memory create` / `update` / `archive` 写正式记忆。
+- 用 Write / Edit 写任务书里指定的**反馈文件**（`<batchDir>/scratch/feedback.txt`）。
+  这是本会话唯一可写的文件：其余任何路径（含同目录下的其他文件）都拒绝。
+  未写入则收尾时回退到默认统计模板（模式、触发方式、耗时、新建/更新/归档条数等）。
+  `scratch/` 是会话期临时工作区：收尾时读出反馈写入 `batch.md` 的 `feedbackText`，随后整个目录删除（不分成败）。
 
 **不能**（程序拦截，提示「整理会话不允许执行此命令」）：
 
-- Write / Edit / MultiEdit / NotebookEdit（Codex 的文件变更同理）——直接写文件绕过签名和索引。
+- Write / Edit / MultiEdit / NotebookEdit（Codex 的文件变更同理）写反馈文件以外的任何路径——直接写文件绕过完整性台账和索引。
+- 经由 shell 写文件（`apply_patch`、重定向、`tee` 等）：同一个入参在不同 runner 里的含义不同，无法证明它写的就是那个文件。
 - 子代理（Agent / Task）、PowerShell——能绕开本策略。
 - Bash 里的其他任何命令，包括 `ls`、`cat`、`npm`、`git`，以及 `ec memory note` / `ec memory consolidate`
   （note 是主会话入口，用了会把结果变回原料；consolidate 会形成循环）。
@@ -194,7 +199,7 @@ daemon 按整理会话的模式校验 `--scope`：
 
 - 逐一读取所有 consolidated 文件查重。先查 `MEMORY.md` 索引，只在发现高度相似的描述时才读那一条确认。
 
-实现：`src/core/memory/memory-session-policy.ts`，由 response-engine 在 `sessionType=memory` 的会话上挂为 policyHook，Claude / Codex / ecagent 三个 runner 共用。整理 trigger 不带 `permissionMode`，不会进入 fullaccess，策略不会被跳过。
+实现：`src/core/system-session/memory.ts`，由 response-engine 在 `sessionType=memory` 的会话上挂为最终判定（`systemSessionCheck`）；同一份声明（`grants()`：可读根 + 唯一可写文件）同时交给 runner 的沙箱 / 工具执行器，Claude / Codex / ecagent 三个 runner 共用，与角色体系无关。整理 trigger 不带 `permissionMode`，不会进入 fullaccess，策略不会被跳过。
 
 ---
 
@@ -206,13 +211,12 @@ daemon 按整理会话的模式校验 `--scope`：
 ├── pending/            # note 写入；整理前整体移到 processing/
 │   └── archive/        # 被 drop 的 note
 ├── processing/         # 整理中快照
-├── consolidated/       # 正式记忆（已签名），文件名即 <slug>.md
+├── consolidated/       # 正式记忆（已登记完整性台账），文件名即 <slug>.md
 └── archive/
-    ├── notes/          # 整理完成的 pending 原件
-    └── invalid/        # 验签失败或未签名的文件
+    └── notes/          # 整理完成的 pending 原件
 ```
 
-**索引**：每个作用域一份，上限 `memory.indexMaxBytes`（默认 5KB）。重建时**逐份验签，只认 `verified`**——`invalid` 和 `unsigned` 都移入 `archive/invalid/`，都不进索引。筛选顺序：
+**索引**：每个作用域一份，上限 `memory.indexMaxBytes`（默认 5KB）。重建时**逐份过完整性台账**：被带外修改的先恢复到最后登记的版本再进索引，被改动且无法恢复的跳过、不移动文件。筛选顺序：
 
 1. `important`、`urgent`、`profile` 必进，**永不淘汰**
 2. `in-progress`、`pending`、`blocked`

package/kits/docs/evolcore/memory-tags.md

@@ -53,7 +53,9 @@ tags: [important, long-term, rule, verified]
 - 打上 `to-generalize` → 下次泛化模式会扫到它，评估能否升到 agent 级。
 - 打上 `to-promote` → 下次提升模式会扫到它，评估能否升到 owner 级。
 
-**打标的只有整理会话**（`create --tags`，事后可用 `update` 补）。主会话写的 note 不带标签。
+**打标的地方**：整理会话写正式记忆（`ec memory create --tags 'a,b'`，事后用 `ec memory update --tags 'a,b'` 整体替换），主会话写 note（`ec memory note --tags 'a,b'`）。note 的标签是临时的，整理会话读取后决定去留。
+
+写法固定为单引号包住、逗号分隔：`--tags 'to-generalize,urgent'`。
 
 **清标的两种方式**：