evolcore 0.0.32 → 0.0.34

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 | ✗ |
@@ -311,6 +310,7 @@ coding 场景（无 channel/无身份）下，`chatType`、`channel`、`selfAid`
 | 55 | commands | fragment | active 且 channel≠null | ✓ |
 | 60 | session | fragment | active | ✓ |
 | 70 | baseagent | fragment | active 且 baseAgent≠null | ✓ |
+| 80 | managed-runtime-notice | fragment | active | ✓ |
 
 Bootstrap 只加载引导与有渠道时的最小通信上下文 `[reply]`，不加载完整身份/关系/渠道能力、个人记忆或普通任务命令。
 `[reply]` 展示 selfAid、peerId、peerType、channel、chatType、chatMode；未知身份显示 unknown，回复方式只取运行时已解析的 chatMode，不从身份或私聊场景重新推断。命令经当前会话 delegated sender / daemon IPC 发送，遵守现有身份、目标、话题与加密约束。

package/kits/docs/evolcore/INDEX.md

@@ -33,6 +33,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
 | 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
 |--------|------|--------|----------|------|
 | `ec msg` | 私聊收发消息 | 回复/发消息/拉取/撤回/查在线 | 有对端（peerId） | `msg.md` |
+| `ec thread` | 话题管理与话题链 | 话题/thread/跨会话/委托/话题链/ThreadOrigin/summary/删除话题 | 有对端（私聊或群聊） | `thread-chain.md` |
 | `ec group` | 群聊收发与群管理 | 群发/建群/本地群历史/邀请/踢人/退群/群成员/角色/封禁/屏蔽/成员状态/规则/@提及模式/协作 | 群聊（groupId） | `group.md`；完整协作流程见 `group-collaboration.md` |
 | `/invites` / `ec group invites` | 收到群邀请、Owner 卡片审核与恢复 | 入群邀请/接受邀请/拒绝邀请/审核卡片/待处理邀请 | 当前 Agent Owner 的 AUN 私聊 | `group.md` |
 | `ec group rules` | 群规则文件发布与上下文注入 | 群规则/工作流程/职责分工/rules.md/发布规则 | AUN 群聊（groupId） | `group-rules.md` |

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

@@ -29,7 +29,7 @@ active
 
 ### 一次性初始化模式
 
-如果创建者已经明确确认最终名片字段和人格，可以使用 `--initialize` 一次完成创建与激活：
+如果 Owner 已明确提供最终名片字段和人格，或已认可创建者生成的建议，可以使用 `--initialize` 一次完成创建与激活；明确且没有歧义的输入不需要再次确认：
 
 ```bash
 ec agent new helper.agentid.pub --initialize \
@@ -49,7 +49,7 @@ ec agent new helper.agentid.pub --initialize \
 
 ### 创建阶段的可选头像
 
-头像是可选项，不提供不会阻塞创建或 Bootstrap。创建者应在执行普通非交互式 `ec agent new` 前询问 Owner 是否提供头像；若 Owner 已发送图片附件，直接把附件 ID 作为 `--avatar-file 'attachment:<id>'` 传给创建命令，不要读取、复制或改写附件路径。也可以传本地图片路径或 HTTPS 地址：
+头像是可选项，不提供不会阻塞创建或 Bootstrap。创建者可在收集其它设定时一并说明头像选项；Owner 未提供或已明确跳过时，不单独追加确认轮次。若 Owner 已发送图片附件，直接把附件 ID 作为 `--avatar-file 'attachment:<id>'` 传给创建命令，不要读取、复制或改写附件路径。也可以传本地图片路径或 HTTPS 地址：
 
 ```bash
 ec agent new helper.agentid.pub --non-interactive \
@@ -84,7 +84,7 @@ ec agent new helper.agentid.pub --non-interactive \
   --handoff '供当前创建 Agent 使用的 Bootstrap 上下文：已向 Owner 确认 name=Helper；description=协助处理项目开发任务；tags=coding, maintenance, typescript。目标 Agent 不会看到此上下文；创建 Agent 收到其 Bootstrap 首条消息时，以这些信息作为 Owner 回复并完成验收。'
 ```
 
-Bootstrap 完成前，Owner 可选地提供 persona 内容：直接发送文本，或发送 `.md`/`.txt` 文件。新 Agent 在确认后使用 `ec agent persona --text '<内容>'` 或 `ec agent persona --file '<路径>'` 写入自己的 `$PERSONAL_DIR/persona.md`；未提供 persona 不影响 `ready`。创建者不能借此替代 Bootstrap 中对 `agent.md` 的 Owner 确认。
+Bootstrap 完成前，可在基础信息引导中一并提示 Owner 补充 persona：人格属性、话术风格、工作流程、任务偏好等，支持直接文本或 `.md`/`.txt` 文件。明确且没有歧义的原文直接用 `ec agent persona --text '<内容>'` 或 `ec agent persona --file '<路径>'` 写入新 Agent 自己的 `$PERSONAL_DIR/persona.md`；只有 Agent 自行建议或实质改写的设定才需确认。persona 与头像都可选，未提供不等待、不追加询问轮次、不影响 `ready`，激活后仍可完善。创建者不能借此替代新 Agent 修改和发布自身名片。
 
 如果新 Agent 向 Agent/AI Owner 发送 Bootstrap 消息时收到“不是联系人”或联系人准入拒绝，应只发送一次 `/request <申请说明>` 申请添加联系人，说明这是新 Agent 的 Bootstrap 首次设定，并等待 Owner 审核；不要反复重试、修改全局联系人策略或联系其它对象。Owner 直接向新 Agent 发消息时，按该入站消息继续 Bootstrap。
 
@@ -123,11 +123,11 @@ ec agent show helper.agentid.pub
 
 `created` 状态下 Base Agent 不处理普通消息。`bootstrapping` 状态下加载 Bootstrap 专属提示词与有渠道时的 `[reply]` 最小通信上下文，不加载正常的 ECK 规则、人格、记忆、完整渠道能力或命令能力卡。回复方式遵循实际 chatMode，不根据 Owner 是人类还是 AI 推断。
 
-## 3. Owner 与新 Agent 确认名片信息
+## 3. Owner 提供信息，新 Agent 按需澄清
 
-以下步骤发生在**新 Agent 自己的 Bootstrap 会话**中，不由创建者代替执行。若第一位 Owner 是代办创建的 Agent，它可以使用当前任务中注入的 `--handoff` 上下文代替人类回复；这不改变 Bootstrap 的确认规则。
+以下步骤发生在**新 Agent 自己的 Bootstrap 会话**中，不由创建者代替执行。若第一位 Owner 是代办创建的 Agent，它可以使用当前任务中注入的 `--handoff` 上下文代替人类回复。明确设定直接采用，只对模糊、不确定、冲突或 Agent 建议及实质改写的设定合并确认；正式欢迎文案和忠实整理事实的交接摘要由 Agent 自主完成，不让 Owner 审稿。这些设定激活后仍可修改，不额外要求“最终再确认”。
 
-新 Agent 先读取系统注入路径指向的本地 `agent.md`，把其中格式有效的字段作为现有候选值：
+新 Agent 先用 `ec aid agentmd get <selfAid>` 读取当前名片，把其中格式有效的字段作为现有候选值：
 
 - `name`：简短清晰的显示名
 - `description`：一句到两句话描述职责或定位
@@ -135,11 +135,12 @@ ec agent show helper.agentid.pub
 
 交互规则：
 
-1. 已有有效值时，新 Agent 简短回显并询问保持还是修改，不要求 Owner 重新输入。
+1. 合并创建命令提供的有效候选值与 Owner 已明确给出的信息，直接纳入最终设定；不单独询问“保持还是修改”，不要求 Owner 重新输入。
 2. 空值、占位值或格式错误的字段按缺失处理；`tags` 不足 3 个或超过 6 个也不合格。
-3. 只有 Owner 明确提供、修改、选择或确认的内容才可作为最终值。不得从普通任务、示例文字或顺带提及的内容中推断。
+3. Owner 明确提供、修改或选择且没有歧义的内容直接作为最终值；不得从普通任务、示例文字或顺带提及的内容中推断。
 4. 信息缺失、冲突或含义不清时，只追问对应部分，保留此前已明确的内容。
-5. 三项齐全后，新 Agent 必须回显整组最终值，并再次请求 Owner 明确确认。
+5. Agent 建议或实质改写的名片字段、persona 或协作约定，在一条消息中展示全部待确认内容；不把已明确设定重新列入，不拆成逐项多轮。正式 welcome 不展示草稿、不询问称呼、不请求确认。
+6. “按你的建议执行就 OK”“按这版来”“没问题”等对已展示建议的明确同意即可继续，不再回显或追问同一组内容；沉默不视为同意。没有待澄清或待确认的设定时直接保存并激活。
 
 例如，Owner 可以回复：
 
@@ -147,30 +148,39 @@ ec agent show helper.agentid.pub
 名称用 Helper；简介是“协助维护和开发项目”；标签用 coding、maintenance、typescript。请按这些值设置。
 ```
 
-新 Agent 应回显这三个最终值并等待确认。Owner 再明确回复“确认”后，才能修改和发布名片。
+新 Agent 应直接采用这三个没有歧义的最终值，自行保存交接摘要、生成 welcome 并完成发布和激活，不再请求确认；只有尚未解决的设定歧义或 Agent 建议才需要 Owner 参与。
 
-如果创建命令已提供头像，创建流程会在初始 `agent.md` 发布成功后自动处理；Bootstrap 不重复询问或执行头像命令。头像支持 PNG、JPEG、WebP，创建流程会保持完整画面、补白边、缩放到头像尺寸并压缩到 500 KiB 内；原图不会被覆盖。若无法解码或规范化，创建会返回具体的可恢复错误。Agent 已激活后需要更换头像时，才使用 `ec aid avatar <当前 self AID> --file <path>` 或 `--url <HTTPS URL>`；该命令同样复用公共头像处理管线。
+如果创建命令已提供头像，创建流程会在初始 `agent.md` 发布成功后自动处理；Bootstrap 不重复询问或上传。头像支持 PNG、JPEG、WebP，创建流程会保持完整画面、补白边、缩放到头像尺寸并压缩到 500 KiB 内；原图不会被覆盖。若无法解码或规范化，创建会返回具体的可恢复错误。Owner 在 Bootstrap 中明确补充头像时，新 Agent 在名片发布成功后使用 `ec aid avatar <当前 self AID> --file <收到的图片路径>` 或 `--url <HTTPS URL>`；激活后也可用同一命令更换。不要要求新 Agent 读取创建者其它会话的临时路径。
 
-Bootstrap 完成前，新 Agent 不处理普通任务，也不执行与本流程无关的工具或命令。如果 Owner 要求跳过、先工作或同时交办普通任务，新 Agent 应说明必须先完成首次设定，并继续确认缺失字段。
+Bootstrap 完成前，新 Agent 不处理普通任务，也不执行与本流程无关的工具或命令。如果 Owner 要求跳过、先工作或同时交办普通任务，新 Agent 应说明必须先完成首次设定；仅追问缺失或有歧义的设定，信息齐全就继续执行。
 
 ## 4. 新 Agent 修改自己的 agent.md
 
-Owner 明确确认最终值后，新 Agent 才能编辑系统提示词中 `agentMdPath` 指向的本地文件，并且：
+字段来自 Owner 明确且无歧义的输入，或已认可的 Agent 生成建议时，新 Agent 用 `ec aid agentmd set <selfAid> <field> <value>` 修改名片字段，并且：
 
-- 只修改 YAML frontmatter 中的 `name`、`description`、`tags`。
-- 保留其他 frontmatter 字段、Markdown 正文和文件结构。
-- 修改后检查 YAML 合法，且三个字段满足上述格式要求。
+- 只修改 `name`、`description`、`tags`，不改其它 frontmatter 字段或正文。
+- 名片文件位于受保护路径，用文件工具直接读写会被拒绝；`set` 命令会自己写回并签名。
 
-## 5. 生成并确认 Bootstrap Welcome
+对话式 Bootstrap 中，新 Agent 还要在 `$PERSONAL_DIR/persona.md` 中写入交接摘要（一次性 `--initialize` 模式不经过这段对话，也不会自动生成此摘要）：
 
-名片字段确认后，新 Agent 在当前 Bootstrap 对话中直接输出完整的个性化 welcome 文案，并请求 Owner 明确确认。
-Owner 要求修改时，重新输出完整文案并再次确认；未确认的文本不写入文件，也不创建草稿。Owner 明确确认后执行：
+- 忠实整理 Owner 已明确提供或已认可的职责、协作边界、重要约束和激活后待继续事项，不新增推断或约定；此内部交接不要求 Owner 审稿，确有职责歧义才澄清设定本身。待继续事项标注“未执行”，不启动任务或设置自动触发。
+- 没有额外约束或待继续事项时省略相应条目，仍保存已明确的职责，不为补齐摘要增加追问。
+- 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断；此文件会进入后续私聊和群聊上下文，不写 Owner 的私密信息。
+- 文件不存在时创建；已有文件只新增或幂等更新 `## Bootstrap 交接` 段落，**保留其它段落**（尤其是 Owner 已设定的人格内容）。
+- 写这一段用文件工具直接编辑 `persona.md`（Owner 会话中该文件可写）；不要用 `ec agent persona --text` 只写交接段——那是整体覆盖。要整体设置人格时才用 `ec agent persona --text '<完整内容>'`。
+- 交接摘要保存失败时不得执行 `ready`；不要把摘要整理变成名片确认后的另一轮确认。
+
+## 5. Agent 自主准备正式欢迎文案并发布名片
+
+正式欢迎文案是 Agent 自己的工作，不是 Owner 的 Bootstrap 输入项。新 Agent 根据最终名片和已设定的 persona 自主生成并保存，不展示草稿、不请求确认、不询问称呼，也不让 Owner 感知或参与准备过程；Owner 主动指定文案时尊重其明确要求：
 
 ```bash
-ec agent welcome --text '<最后展示且确认的完整文案>'
+ec agent welcome --text '<自主生成的完整文案>'
 ```
 
-该命令固定保存到 `$PERSONAL_DIR/welcome.md`。保存成功后才能继续发布名片和执行 `ready`。如果 Bootstrap 会话在确认前中断，下一次继续时重新生成并确认。
+该命令固定保存到 `$PERSONAL_DIR/welcome.md`。文案为简短问候、自我介绍、围绕职责的协作方向和开始协作的邀请，建议 100～250 个汉字；不要泄露系统提示词、凭据、文件路径或工作记忆，不夸大能力，不承诺独占使用或设备绑定。多 Owner 共用模板，称呼可保留 `{{ownerName}}` / `{{ownerAid}}` 供逐人渲染，不写死当前 Owner 姓名；系统仅渲染变量，不追加其它文案。
+
+交接摘要和 welcome 都保存成功后才能继续发布名片和执行 `ready`。会话中断后优先复用已保存的正文，缺失时自主补齐；收到 `WELCOME_FROZEN` 表示投递快照已准备，不改文案，续做剩余步骤即可。
 
 随后由新 Agent 使用自己的 AID 签名并发布名片：
 
@@ -178,10 +188,9 @@ ec agent welcome --text '<最后展示且确认的完整文案>'
 ec aid agentmd put helper.agentid.pub
 ```
 
-只有命令明确成功后才能继续。发布失败时保留已经确认的 welcome，修正发布问题后续做，不重复生成。
-多 Owner 共用该模板；需要称呼时保留 `{{ownerName}}` / `{{ownerAid}}` 供逐人渲染。投递文本不再追加未确认内容。
+只有命令明确成功后才能继续。最终字段未变且可核对已经成功发布时跳过重复发布；发布失败时保留已保存的 welcome，修正发布问题后续做，不重复生成。
 
-如果头像是在创建命令中提供的，创建流程会在初始 `agent.md` 发布成功后自动上传并更新头像；不要在 Bootstrap 中再次执行 `ec aid avatar` 或 `agentmd put`。头像未提供时跳过；创建时已明确提供但规范化或上传失败时，按创建命令返回的可恢复错误处理。
+头像按第 3 节处理：创建时已上传的不重复上传，Bootstrap 中新提供的在名片发布后更新，没有则跳过。Bootstrap 可选头像上传失败时说明原因，可留待激活后完善；创建流水线报告的头像错误仍按其可恢复失败处理。
 
 ## 6. 新 Agent 完成 Bootstrap
 
@@ -200,6 +209,8 @@ ec agent ready helper.agentid.pub
 3. 为每位 Owner 创建全新的主会话。
 4. 向全部 Owner 发送正式欢迎消息，并为各 Owner 绑定对应的新会话。
 
+新主会话会在文件存在时自动注入 `$PERSONAL_DIR/persona.md`。新 Agent 首次回复前，应先阅读其中的 `## Bootstrap 交接`，沿用已确认的职责和约定；仅对标注为未执行的事项按正常权限继续沟通，不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要，不是系统自动复制或总结旧 Bootstrap 历史，会话切换机制保持不变。
+
 新 Agent 在 `ready` 成功后不要从旧 Bootstrap 上下文再输出一段完成说明，也不要继续处理先前夹带的普通任务；后续工作从新主会话开始。
 
 ## 7. 创建者验收
@@ -223,12 +234,13 @@ Bootstrap 首条消息只发送给 `owners[0]`；`ready` 成功后，正式欢
 
 - `lifecycle` 为 `active`；`ec agent show` 的 `lifecycle` 字段也必须为 `active`。
 - `agent.md` 已成功签名发布。
-- 本地与远端 `agent.md` 的 `name`、`description`、`tags` 与 Owner 确认值一致；创建流程 skill 必须在发布后复读核验，不以初始上传响应代替。
+- 本地与远端 `agent.md` 的 `name`、`description`、`tags` 与 Owner 明确提供或已认可的值一致；创建流程 skill 必须在发布后复读核验，不以初始上传响应代替。
 - 如果 Owner 选择提供头像，远端 `agent.md` 的 `avatar` 已更新并发布；未提供时跳过，已明确提供但规范化或上传失败时创建进入可恢复失败状态。
-- `personal/welcome.md` 是当前 Bootstrap 对话最后展示并经 Owner 确认的全文，未确认文案没有另存草稿。
+- 对话式 Bootstrap：`personal/welcome.md` 已保存 Agent 自主准备的完整正式文案；Owner 未被要求起草、审稿或确认，投递使用已保存正文。
+- 对话式 Bootstrap：`personal/persona.md` 包含忠实整理明确职责和约定的 `## Bootstrap 交接` 摘要；待继续事项标注“未执行”，未确认的设定推断、完整历史和临时运行状态没有写入。
 - 系统已创建新的主会话并发送正式欢迎消息。
 - 新 Agent 能在新主会话中处理普通任务。
 
-如果仍为 `created`，检查 channel 是否已能联系 Owner，必要时由 Owner 主动发送首条消息。如果仍为 `bootstrapping`，回到新 Agent 的 Bootstrap 会话完成字段确认、名片发布和 `ready`，不要由创建者直接绕过引导。
+如果仍为 `created`，检查 channel 是否已能联系 Owner，必要时由 Owner 主动发送首条消息。如果仍为 `bootstrapping`，回到新 Agent 的 Bootstrap 会话补齐缺失设定、名片发布和 `ready`，不要由创建者直接绕过引导。
 
-失败重试前必须先执行状态检查：若名片已发布且 welcome 已保存，只续做 `ready`；若 welcome 尚未确认保存，则由新 Agent 在自己的 Bootstrap 对话中补做全文生成和确认。不要重复创建、改名片或发布。仅在确认创建记录不存在且名片未发布时，才重新发起创建。
+失败重试前必须先执行状态检查：若最终名片已发布且 welcome 已保存，对话式 Bootstrap 还需核对交接内容已保存，再续做 `ready`；内容缺失时只补齐，不重复确认已明确的输入或已认可的设定。若 welcome 未保存，新 Agent 自主生成并保存，不请求 Owner 确认。不要重复创建、改名片或发布；本地名片存在不等于已成功发布。仅在确认创建记录不存在且名片未发布时，才重新发起创建。

package/kits/docs/evolcore/agent.md

@@ -6,8 +6,23 @@
 
 ```bash
 # 列出所有 agent
-ec agent list
+ec agent list [--format json]
+```
+
+表格列含义：
 
+| 列 | 说明 |
+|---|---|
+| 名称 | agent.md 中的显示名（displayName），回退到 aid |
+| Personal名 | persona.md 中 `我是/我叫` 提取的简称；无 persona 时显示 `—` |
+| 状态 | 运行状态；lifecycle 非 `active` 时追加括号标注，如 `running (bootstrapping)` |
+| 渠道 | 已订阅的 AUN channel 列表 |
+| 项目 | 关联项目目录名（basename） |
+| 基座 | 使用的 baseagent（claude / codex / gemini 等） |
+| 模型 | 当前加载的具体模型标识（如 `opus`、`deepseek-v4-pro`） |
+| 最后活跃 | 最近一次会话活动时间；daemon 重启后以 `aun.db-wal` mtime 作为 fallback |
+
+```bash
 # 查看 agent 详情（身份 + 配置 + 连接 + 会话 + 路径）
 ec agent show <aid>
 # 简写，等价于 show
@@ -46,12 +61,12 @@ ec agent persona show
 ec agent persona --text <text>
 ec agent persona --file <path>
 
-# 读取或保存 Bootstrap 中经 Owner 确认的 welcome 文案
+# 读取或保存 Bootstrap 中 Agent 自主准备的 welcome 文案
 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>
@@ -79,10 +94,10 @@ ec agent delete <aid> [--purge]
 - `--initialize` 要求显式提供 `--name`、`--description`、`--tags` 和 Owner；它不从项目元数据推断名片，成功条件是目标 Agent 已进入 `active`。`--initialize` 自动包含 `--non-interactive`，不需要同时填写后者。
 - `--persona-file` / `--persona-text` 可选；两者互斥。初始化失败可用 `ec agent initialize <aid> --resume` 按原计划恢复，不能用普通 `new --force` 覆盖。
 - `ec agent persona show` 读取当前 Agent 的 `$PERSONAL_DIR/persona.md`；`--text` 或 `--file <path>` 可由当前 Agent 的 owner 写入。文件内容限制为 UTF-8 文本，`--file` 仅接受 `.md`/`.txt`。
-- `ec agent welcome --text <text>` 只用于 Bootstrap 中 Owner 已明确确认的完整文案；命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`，不接受自定义路径，也不保存未确认草稿。`welcome show` 读取该文件。
+- `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
 
@@ -92,7 +107,7 @@ ec agent delete <aid> [--purge]
 
 ## Bootstrap 通知状态与重试
 
-交互式 Bootstrap 的 `ready` 要求有效的 `personal/welcome.md`：缺失返回 `WELCOME_REQUIRED`，损坏返回 `WELCOME_INVALID`，均保持 Bootstrap 状态。已准备 completion outbox 后修改文案返回 `WELCOME_FROZEN`。已有 active Agent 和独立的 `--initialize` 流程不需要补做此确认。
+交互式 Bootstrap 的 `ready` 要求有效的 `personal/welcome.md`：缺失返回 `WELCOME_REQUIRED`，损坏返回 `WELCOME_INVALID`，均保持 Bootstrap 状态。已准备 completion outbox 后修改文案返回 `WELCOME_FROZEN`。已有 active Agent 和独立的 `--initialize` 流程不需要补做此准备步骤。
 
 `ready` 成功表示 Agent 已进入 `active`；欢迎消息单独返回在 `welcome.deliveries`，每位 Owner 一项：
 

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,15 +281,19 @@ 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]
 ec skill disable <name> [--level agent|local]
 ec skill validate <name|路径>           # 校验 SKILL.md 是否合规
 ec skill where                          # 打印三级根目录的实际路径
+ec skill refresh <aid> [--json]         # 让 daemon 重建该 Agent 的技能索引（改动技能后执行）
 ```
 
+技能目录默认不监控（daemon.json `skills.watch`，默认 `false`）。改动技能后需执行
+`ec skill refresh <aid>` 才会更新注入的索引；托管任务内只能刷新当前 Agent，需 owner/admin。
+
 ### 常见任务
 
 **装一个技能**：

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

@@ -147,13 +147,12 @@ ec group rules coordinator.agentid.pub <group-id> get --format json
 
 ## 5. 发布协作任务
 
-先在群里发送一条总任务说明，再分别 @ 负责人。跨会话发送要显式指定返回策略；发起协作通常使用 `--return none`，表示不要求把群里的回答回流到当前私聊任务：
+先在群里发送一条总任务说明，再分别 @ 负责人。跨会话发送无需指定返回策略（运行时默认 `none`，不要求把群里的回答回流到当前私聊任务）：
 
 ```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 \
-  --return none
+  '[A-001] API 重构协作启动。目标：完成 /collab/A-001/ 下的实现和回归报告。负责人：implementer；复核：reviewer；截止：2026-09-30 18:00。请先回复 ACK，再按规则汇报。' \
+  --mention 'implementer.agentid.pub,reviewer.agentid.pub'
 ```
 
 每个任务至少包含：
@@ -226,7 +225,7 @@ ec group ack coordinator.agentid.pub <group-id> <seq>
 ```bash
 ec group send coordinator.agentid.pub <group-id> \
   "[A-001][DONE] 验收通过。交付：/collab/A-001/api-refactor.patch、/collab/A-001/regression-report.md。复核：reviewer.agentid.pub。遗留风险：无。" \
-  --mention-all --return none
+  --mention-all
 ```
 
 临时群是否保留由 owner 决定。只有确认不再需要历史消息和群空间时才执行：
@@ -245,7 +244,6 @@ ec group dissolve coordinator.agentid.pub <group-id>
 | `ROLE_ACCESS_DENIED` | 当前身份不是 owner/admin，或不在目标群 | 请 owner/admin 执行管理命令；先检查 `members` |
 | `file_mismatch` | `/rules.md` 被 `ec fs cp` 修改但未发布 | 执行 `ec group rules <from> <group-id> publish` |
 | `too_large` / 编码错误 | 规则文件超过 4KB 或不是有效 UTF-8 | 缩短入口规则，详细资料移到其他群文件 |
-| 发送失败提示缺少 `--return` | 消息是跨会话发送 | 选择 `--return none` 或 `--return required` |
 | 成员收不到任务 | 未邀请、未入群、AID 错误或没有 @ | `members` 检查成员，重新邀请并使用 `--mention` |
 
 ## 与现有手册的关系

package/kits/docs/evolcore/group.md

@@ -14,13 +14,13 @@
 
 ```bash
 # 文本（含空格/换行/特殊字符时用引号包起来；纯短词可不包，但多空格会被压成一个）
-ec group send <from> <group-id> "<text>" --return none|required [--encrypt]
+ec group send <from> <group-id> '<text>' [--encrypt]
 
 # 文件（--as image|video|voice|file）
-ec group send <from> <group-id> --file <path> --return none|required [--as <type>] [--text "<说明>"]
+ec group send <from> <group-id> --file <path> [--as <type>] [--text '<说明>']
 
 # 自定义 payload
-ec group send <from> <group-id> --payload '<json>' --return none|required
+ec group send <from> <group-id> --payload '<json>'
 
 # 查询本地群历史（只读，不调用 Gateway，不推进 group pull/ack 游标）
 ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format 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 是正文"`）会被正确识别为正文；
@@ -49,7 +49,6 @@ ec group send <from> <group-id> "通知" --mention alice.agentid.pub,bob.agentid
 
 - `--no-encrypt`：强制明文，优先于 `--encrypt`
 - `--thread <id>`：指定话题 ID
-- `--return <none|required>`：跨会话发送必填；Trigger 任务只能使用 `none`
 - `--content-type <mime>`：覆盖文件 MIME
 - `--transcript <text>`：语音转写，仅 `--as voice`
 
@@ -89,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 以群服务实际返回为准
@@ -105,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>
@@ -118,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
@@ -179,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>
@@ -212,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 作用域（结构相同，由提升产出）