evolcore 0.0.32 → 0.0.33

package/dist/utils/error-utils.js

@@ -466,7 +466,7 @@ export function getErrorMessage(error, terminalReason, includeEmoji = true) {
         }
     }
     // 回退到原有的错误消息匹配逻辑
-    const msg = error?.message || String(error);
+    const msg = resolveErrorMessage(error);
     const warnPrefix = includeEmoji ? '⚠️ ' : '';
     const errPrefix = includeEmoji ? '❌ ' : '';
     if (/invalid (?:jsonl )?session file/i.test(msg)) {
@@ -512,5 +512,26 @@ export function getErrorMessage(error, terminalReason, includeEmoji = true) {
     if (msg.includes('timeout')) {
         return `${warnPrefix}请求超时，请重试`;
     }
+    if (msg)
+        return `${errPrefix}暂无法判定错误原因：${msg}`;
     return `${errPrefix}处理消息时出错，请稍后重试`;
 }
+function resolveErrorMessage(error) {
+    if (typeof error === 'string')
+        return error.trim();
+    if (error === null || error === undefined)
+        return '';
+    if (typeof error === 'object') {
+        const message = 'message' in error ? String(error.message ?? '').trim() : '';
+        if (message)
+            return message;
+        const code = 'code' in error ? String(error.code ?? '').trim() : '';
+        if (code)
+            return code;
+        if ('message' in error)
+            return '';
+        const stringified = String(error).trim();
+        return stringified === '[object Object]' || stringified === 'Error' ? '' : stringified;
+    }
+    return String(error).trim();
+}

package/kits/docs/context-assembly.md

@@ -311,6 +311,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,38 @@ 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/personal.md` 中写入交接摘要（一次性 `--initialize` 模式不经过这段对话，也不会自动生成此摘要）：
 
-名片字段确认后，新 Agent 在当前 Bootstrap 对话中直接输出完整的个性化 welcome 文案，并请求 Owner 明确确认。
-Owner 要求修改时，重新输出完整文案并再次确认；未确认的文本不写入文件，也不创建草稿。Owner 明确确认后执行：
+- 忠实整理 Owner 已明确提供或已认可的职责、协作边界、重要约束和激活后待继续事项，不新增推断或约定；此内部交接不要求 Owner 审稿，确有职责歧义才澄清设定本身。待继续事项标注“未执行”，不启动任务或设置自动触发。
+- 没有额外约束或待继续事项时省略相应条目，仍保存已明确的职责，不为补齐摘要增加追问。
+- 不复制完整 Bootstrap 历史、临时闲聊、凭据、运行状态或未确认推断；此文件会进入后续私聊和群聊上下文，不写 Owner 的私密信息。
+- 文件不存在时创建；已有文件只新增或幂等更新 `## Bootstrap 交接` 段落，保留其它内容。
+- 交接摘要保存失败时不得执行 `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 +187,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 +208,8 @@ ec agent ready helper.agentid.pub
 3. 为每位 Owner 创建全新的主会话。
 4. 向全部 Owner 发送正式欢迎消息，并为各 Owner 绑定对应的新会话。
 
+新主会话会在文件存在时自动注入 `$PERSONAL_DIR/personal.md`。新 Agent 首次回复前，应先阅读其中的 `## Bootstrap 交接`，沿用已确认的职责和约定；仅对标注为未执行的事项按正常权限继续沟通，不把它们误称为已经完成。这个方案由新 Agent 在 `ready` 前写入摘要，不是系统自动复制或总结旧 Bootstrap 历史，会话切换机制保持不变。
+
 新 Agent 在 `ready` 成功后不要从旧 Bootstrap 上下文再输出一段完成说明，也不要继续处理先前夹带的普通任务；后续工作从新主会话开始。
 
 ## 7. 创建者验收
@@ -223,12 +233,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/personal.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,7 +61,7 @@ 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 文案>'
 
@@ -79,7 +94,7 @@ 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 / 持久授权来源。
@@ -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/ec-capabilities.md

@@ -288,8 +288,12 @@ 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/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
+  --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]
@@ -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`
 

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

@@ -256,7 +256,7 @@ daemon 按整理会话的模式校验 `--scope`：
 
 ## 十、session.md 的注入
 
-整理会话也加载 `$KITS_FRAGMENTS/session.md`，但其中的 proactive 行为约束（群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`ec group send` / `ec msg send` 语法速查、跨会话 `--return` 规则）**不会渲染**。
+整理会话也加载 `$KITS_FRAGMENTS/session.md`，但其中的 proactive 行为约束（群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`ec group send` / `ec msg send` 语法速查）**不会渲染**。
 
 原因：整理会话由触发器创建，`peerType` 是 `system`、`chatType` 是 `private`。`resolveChatModeForPeer` 对 system 对端有硬约束，返回 `interactive`，而 proactive 那段的条件是 `{{?chatMode=proactive}}`，所以整块跳过。已实测确认。
 

package/kits/docs/evolcore/menu-exec-schema-commands.md

@@ -175,8 +175,8 @@
 
 | 字段 | 类型 | 默认 | 作用 |
 |---|---|---|---|
-| `pre_tool_1stmsgchk` | boolean | `true` | 首工具表态检查：首个工具调用前必须先向对端发消息/文件，否则拦截 |
-| `tool_use_reminder` | boolean | `true` | 工具汇报提醒：启用队列未读提醒 + 每 10 次工具调用的汇报提醒 |
+| `pre_tool_1stmsgchk` | boolean | `true` | 意图表达门禁：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send |
+| `tool_use_reminder` | boolean | `true` | 意图表达门禁与队列提醒：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒 |
 
 - schema 里的 `default` 即**运行时出厂默认**——宿主组装 `modeConfig` 时先铺这层默认（`coordinator.schemaDefaults`），再叠用户显式桶值；flow 层不再硬编码默认。
 - `chatmode` 本身**不在此桶**：它由宿主按对端类型解析后强制注入 `modeConfig.chatmode`，与「选哪个模式」正交。

package/kits/docs/evolcore/menu-protocol.md

@@ -119,6 +119,13 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
 }
 ```
 
+`name="session"` 且 `args.resource="loop"` 时，`value` 必须是 JSON boolean：
+`true` 开启当前可信主会话或话题的一次闲置触发，`false` 关闭；开启时可在
+`args.idleSeconds` 指定 30–86400 的整数，省略时使用 300 秒。目标由当前关系和可信
+`thread_id` 自动选择，不接受 `sessionId`、`threadId` 或跨关系目标；关闭时不能携带
+`idleSeconds`。查询使用 `menu.query`、`name="session"`、`args.view="loop"`，返回值会标明
+实际目标级别 `relation-main` 或 `topic-session` 及 `sessionId`。
+
 ### `menu.action`
 
 触发动作类命令（如创建 agent、重启、生成配对码）。**不自动重试**。

package/kits/docs/evolcore/msg.md

@@ -17,16 +17,16 @@
 
 ```bash
 # 文本（明文）
-ec msg send <from> <to> "<text>" --return none|required
+ec msg send <from> <to> "<text>"
 
 # 从文件读取文本内容（用于超长消息或避免 Shell 转义）
-ec msg send <from> <to> --text-from-file <path> --return none|required
+ec msg send <from> <to> --text-from-file <path>
 
 # 文本（密文 E2EE）
-ec msg send <from> <to> "<text>" --encrypt --return none|required
+ec msg send <from> <to> "<text>" --encrypt
 
 # 强制明文（同时出现时优先于 --encrypt）
-ec msg send <from> <to> "<text>" --no-encrypt --return none|required
+ec msg send <from> <to> "<text>" --no-encrypt
 
 # 文件：--as 可选 image|video|voice|file（默认按扩展名推断）
 ec msg send <from> <to> --file <path> [--as <type>]
@@ -46,7 +46,6 @@ ec msg send <from> <to> --payload '<json>'
 - `--encrypt` — 端到端加密
 - `--no-encrypt` — 强制明文发送，优先于 `--encrypt`
 - `--thread <id>` — 指定话题 ID（多话题路由）
-- `--return <none|required>` — 跨会话发送必填；`none` 仅补充目标上下文，`required` 将回答回流来源。Trigger 任务只能使用 `none`
 - `--content-type <mime>` — 显式覆盖 MIME（仅 `--file`）
 - `--text <说>` — 附件说明文字（仅 `--file`）
 - `--transcript <text>` — 语音转写（仅 `--as voice`）
@@ -68,9 +67,7 @@ ec contact unblock <target-aid> --self <self-aid>
 
 非托管环境的 `ec msg send` 是独立 AUN CLI 发送，不读取或要求 `agents/<aid>/config.json`，因此不会触发这套 Agent 联系人准入判断。
 
-在 EvolCore 会话内，发送还会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member`
-默认只允许回复当前对端；从一个 agent 会话转发给第三个 agent 属于 relay 操作，可能因
-`ownPeerOnly` 被拒绝。没有成功 JSON 回执（含 `message_id`/`status`）不得声称已发送。
+在 EvolCore 会话内，发送会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member` 默认只允许回复当前对端；要联系当前对端以外的对象，必须通过话题路由：先 `ec thread list <对方AID>` 选话题（没有就 `ec thread create`），再用 `ec msg send "<text>" --thread <threadId> --check-every <时长>` 发送；from/to 由话题推断，无需手写。不带 `--thread` 直接改目标会被拒绝。完整话题路由操作序列见 `[memory-and-thread]` 段。没有成功 JSON 回执（含 `message_id`/`status`）不得声称已发送。
 
 成功输出：`✓ 已发送 <message_id> seq=<n> status=<status>`