evolcore 0.0.32 → 0.0.34

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`
@@ -256,7 +260,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/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'`。
 
 **清标的两种方式**：
 

package/kits/docs/evolcore/memory.md

@@ -9,40 +9,40 @@
 - 仅在 evolcore 托管会话中可用（通过 daemon IPC 执行，依赖 `EVOLCORE_SESSION_ID`）。
 - `note` 写入当前关系，**必须有对端**（peerKey）；没有对端的会话不要调用。
 - `memory.enableRelation=false` 时整个命令族被拒绝。
-- **不要用 Write / Edit 直接写记忆文件，也不要用 baseagent 的原生记忆工具**：绕过签名和索引，整理会话不感知。
+- **不要用 Write / Edit 直接写记忆文件，也不要用 baseagent 的原生记忆工具**：绕过完整性台账和索引，会被当作带外修改恢复掉，整理会话也不感知。
 - `create` / `update` / `archive` 只在整理会话（`sessionType=memory`）里可用，主会话调用会被拒绝。
 
 ## note 写入
 
 ```bash
-ec memory note --slug <slug> [--tags <tag1,tag2,...>] [--speakers <id1,id2,...>] "<正文>"
+ec memory note --slug <slug> [--tags '<tag1>,<tag2>'] [--speakers '<id1>,<id2>'] '<正文>'
 ```
 
 | 参数 | 说明 |
 |------|------|
 | `--slug` | **必填**。字母/数字/连字符，1-64 字符，当前关系内唯一，后续 update / drop 靠它定位 |
-| `--tags` | 可选。逗号分隔，取值见 `$KITS_DOCS/evolcore/memory-tags.md` |
-| `--speakers` | 可选，**群聊专用**。逗号分隔，填本条 note 涉及的发言人 AID 或渠道原生 ID（如 `alice.agentid.pub,bob.agentid.pub`）。整理会话会据此把发言人相关信息分流写入各发言人自己的 relation 记忆，而不是只落在群的 relation 下。私聊场景无需填写。 |
+| `--tags` | 可选。写法固定为 `--tags 'tag1,tag2'`：单引号包住，逗号分隔。取值见 `$KITS_DOCS/evolcore/memory-tags.md` |
+| `--speakers` | 可选，**群聊专用**。写法固定为 `--speakers '<aid1>,<aid2>'`：单引号包住，逗号分隔。填本条 note 涉及的发言人 AID 或渠道原生 ID。整理会话会据此把发言人相关信息分流写入各发言人自己的 relation 记忆，而不是只落在群的 relation 下。私聊场景无需填写。 |
 | 正文 | 必填。写清事实本身即可，不用组织成索引描述 |
 
 ```bash
-ec memory note --slug commit-chinese --tags "rule,long-term" \
-  "对端要求：commit message 必须用中文，并列出所有功能改动点。"
+ec memory note --slug commit-chinese --tags 'rule,long-term' \
+  '对端要求：commit message 必须用中文，并列出所有功能改动点。'
 ```
 
-note 是原料：不进索引、不签名，由整理会话读取后决定留下什么。
+note 是原料：不进索引、不进台账，由整理会话读取后决定留下什么。
 
 ## note 修改
 
 ```bash
-ec memory note update <slug> [--slug <新slug>] [--tags <...>] ["<新正文>"]
+ec memory note update <slug> [--slug <新slug>] [--tags 'tag1,tag2'] ['<新正文>']
 ```
 
 不传的字段保持不变；至少提供一项。判据：**还是在说同一件事 → update；不是 → 新建。**
 
 ```bash
-ec memory note update commit-chinese --tags "rule,long-term" \
-  "commit 消息必须用中文；代码注释可以是英文"
+ec memory note update commit-chinese --tags 'rule,long-term' \
+  'commit 消息必须用中文；代码注释可以是英文'
 ```
 
 ## note 撤销
@@ -87,19 +87,31 @@ context:        C:\...\consolidation-batches\20261005T103000-toleiliang4.agentid
 
 反馈规则：手动、上下文压缩、renew、`/new` 四种触发路径都会把整理结果反馈回**发起时的会话和话题**（用发起时抓取的 channelId / peerId / threadId 直接投递，不依赖会话 ID 是否变化）。只有定时触发不发反馈——结果只记录在整理批次目录的 `ops.jsonl` 里，供事后审计。
 
-反馈内容优先取整理会话调用 `ec memory feedback` 写入的文本；未调用时回退到默认模板（模式、触发方式、耗时、新建/更新/归档条数等统计）。
+反馈内容取整理会话写入任务书指定反馈文件（`<batchDir>/scratch/feedback.txt`）的文本；未写入时回退到默认模板（模式、触发方式、耗时、新建/更新/归档条数等统计）。
 
 没有 `--scope`，作用域由模式唯一决定。
 
+## JSON 输出
+
+所有子命令都支持在末尾加 `--format json`，取值只能是 `json`。
+
+```bash
+ec memory note list --format json
+```
+
+成功时 stdout 输出 daemon 返回的结果对象，如 `{ "ok": true, "filePath": "..." }`、`{ "ok": true, "notes": [...] }`；
+失败时 stdout 输出 `{ "ok": false, "code": "...", "error": "..." }` 并以退出码 1 结束，参数错误另带 `usage` 字段。
+
 ## 常见报错
 
 | 报错 | 原因与处理 |
 |------|-----------|
-| `必须提供 --slug` | 写入漏了 `--slug`，补上：`ec memory note --slug <slug> "<正文>"` |
+| `必须提供 --slug` | 写入漏了 `--slug`，补上：`ec memory note --slug <slug> '<正文>'` |
 | `必须提供记忆内容（content）` | 正文缺失或被 shell 吞掉，正文整体加引号 |
 | `SLUG_EXISTS: 该 slug 已存在同名 note: <路径>` | 撞名。补充同一件事 → `note update <slug>`；确实是新事 → 换 slug |
 | `至少提供一项要改的内容` | `note update` 只给了 slug，补 `--slug` / `--tags` / 正文之一 |
 | `未知参数: --xxx` | 参数拼错，未识别的参数一律报错 |
+| `--format 仅支持 json: <值>` | `--format` 后只能跟 `json` |
 | `--scope 已废弃` | 改用 `--mode` |
 | `<op> 只能由整理会话（sessionType=memory）调用` | 主会话调用了 `create` / `update` / `archive`，改用 `ec memory note` |
 

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/model.md

@@ -49,3 +49,19 @@ ec model check [--self <aid>]
 - 本地终端直接运行时不伪造远端角色。显式传入 `--role` 可检查该角色的模型可见性和有效模型。
 - `use`、`effort`、`reset` 不直接修改角色策略；传入 role 写作用域会返回 `ROLE_POLICY_MANAGED`。
 - `check` 会连接已配置的模型网关并发送最小探测请求；未配置自定义网关时跳过 API 探测。
+
+## 模型参数与执行窗口
+
+公共统计层通过 `resolveModelSpec()` 读取 `model-prices.jsonl`，但统计参数不等于底层执行器配置。
+
+| Base agent | 执行与统计的处理方式 |
+|------------|--------------------|
+| Claude Code | 由参数表解析窗口，设置 SDK 自动压缩阈值；查询与手动压缩使用同一解析路径 |
+| ecagent | 由参数表设置模型对象的 `contextWindow` 和输出上限 `maxTokens`；查询、手动压缩和上下文统计共用参数 |
+| Codex | 优先使用 app-server 实时窗口；缺窗口时仅用参数表补齐统计，不修改 Codex 的执行窗口或压缩配置 |
+| Gemini | 执行窗口和压缩仍交给 Gemini CLI 管理，不从参数表注入执行参数 |
+
+Claude Code 和 ecagent 的窗口优先级为：显式 `[1m]` / `[200k]` 后缀 → 有效参数表记录 → runner 原有硬编码兜底。
+ecagent 发给网关的模型 ID 不携带窗口后缀。Codex 没有实时窗口且参数表也无记录时，不虚构通用窗口。
+
+模型理论窗口与网关、团队的请求额度是不同限制；查表得到 1M 窗口，不代表可以突破团队的 200K 请求上限。

package/kits/docs/evolcore/msg.md

@@ -17,22 +17,22 @@
 
 ```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>]
 
 # 链接卡片
-ec msg send <from> <to> --link <url> [--title "<title>"] [--description "<desc>"]
+ec msg send <from> <to> --link <url> [--title '<title>'] [--description '<desc>']
 
 # 自定义 payload（JSON）
 ec msg send <from> <to> --payload '<json>'
@@ -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>`
 
@@ -166,6 +163,6 @@ ec msg history <self-aid> <target-aid> \
 仅当无法使用 `ec msg send` 时（如拿不到自己的 AID），可用 `ec ctl send`，它自动继承当前会话的 AID 和对端：
 
 ```bash
-ec ctl send "<text>"
-ec ctl send --encrypt "<text>"
+ec ctl send '<text>'
+ec ctl send --encrypt '<text>'
 ```

package/kits/docs/evolcore/thread-chain.md

@@ -0,0 +1,267 @@
+# ec thread — 话题链命令
+
+话题（Thread）是在私聊或群聊关系里切出的独立对话分支。一组对话可以同时推进多个话题，每个话题有自己的上下文、历史和生命周期，互不干扰。话题链（Thread Chain）则是跨会话、跨 agent 的协作机制：A 可以把一条任务"分支"到 B 的某个话题，B 也可以在自己的话题里继续工作，两者通过 `ec msg send --thread` 和 thread-inbox 上下文注入关联起来。
+
+触发词：话题/thread/跨会话/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨会话上下文。
+
+## 标准工作流
+
+话题是对端级别的操作，先找到 agent 和对端，再操作话题：
+
+```bash
+# 第一步：列出本机所有 agent（找到目标 selfAid）
+ec agent list
+
+# 第二步：列出该 agent 有话题记录的所有对端
+ec thread peers --self <selfAid>
+
+# 第三步：列出与某对端的所有话题（默认每页10条）
+ec thread list <peer> --self <selfAid>
+
+# 第四步：翻页（页脚会给出完整翻页命令）
+ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
+
+# 第五步：查看某话题的历史消息
+ec thread history <peer>/<threadId> --self <selfAid> --limit 20
+
+# 第六步：查看/写入 summary
+ec thread summary show <peer>/<threadId> --self <selfAid>
+# 写入时必须带 --name（同时设标题）；不想改名传 -（详见「话题摘要」一节）
+ec thread summary set <peer>/<threadId> '<摘要内容>' --name '<新标题>' --self <selfAid>
+```
+
+## 什么时候用
+
+- 同一对端有多条并行任务线（项目 A、项目 B 分开管理）
+- 跨 agent 委托：A 向 B 发起一个话题，B 接收后在自己的话题里处理
+- 需要给某段对话贴标签、跟踪状态（pending / in_progress / completed / archived）
+- 想保存话题摘要（summary），供下次激活时快速恢复上下文
+- 整理完成或废弃的话题时（删除话题）
+
+主会话（主对话，无 threadId）不能删除。话题是主会话之外额外创建的分支。
+
+## 基础操作
+
+### 列出话题
+
+```bash
+ec thread peers                     # 列出该 agent 有话题的所有对端
+ec thread list <peer>
+ec thread list <peer> --status in_progress
+ec thread list <peer> --label 项目A
+ec thread list <peer> --unlabeled
+ec thread list <peer> --sort recent --limit 20
+ec thread list <peer> --format json
+```
+
+`ec thread list` 必须带 `<peer>` 参数，不带 peer 会报错并提示用 `ec thread peers` 查找对端。每条话题显示消息(24h/总计)统计、最后一条消息截断（50字）和当前摘要（未设置时显示"未总结"）。
+
+### 查看话题详情
+
+```bash
+ec thread show <peer>/<threadId>
+ec thread show current          # 当前任务所在话题
+ec thread show <peer>           # 该对端的主会话
+```
+
+### 读取话题历史消息
+
+```bash
+ec thread history <peer>/<threadId>
+ec thread history <peer>/<threadId> --limit 100
+ec thread history <peer>/<threadId> --after 1700000000000
+ec thread history <peer>/<threadId> --before 1700000000000
+ec thread history <peer>/<threadId> --format json
+```
+
+托管会话中可以直接用 `ec msg history --thread <id>`，from/to 会自动从运行时上下文推断：
+
+```bash
+ec msg history --thread <threadId>
+```
+
+`ec thread history` 是推荐用法。
+
+### 新建话题
+
+```bash
+ec thread create <peer> --name "项目A需求讨论"
+ec thread create <peer> --name "项目A" --label 项目A --status in_progress
+```
+
+创建成功后返回 `threadId`，格式为 `thread-<ms>-<seq4>-<rand4>`（如 `thread-1791028341906-0000-136a`）。创建时会自动向对端发一条系统消息通知。
+
+### 修改话题
+
+```bash
+ec thread rename <peer>/<threadId> "新名称"
+ec thread label <peer>/<threadId> 重要
+ec thread label <peer>/<threadId> --clear       # 清除标签
+ec thread status <peer>/<threadId> completed    # pending|in_progress|completed|archived
+```
+
+`/name` 和 `/rename` 也会同步更新话题索引。
+
+### 删除话题
+
+```bash
+ec thread delete <peer>/<threadId>    # 软删除：session 文件移入 _trash/，索引条目删除
+```
+
+删除后话题从索引中消失，`ec thread list` 不再显示。底层 session 文件通过 `unbindSession` 机制移入 `chatDir/_trash/`，与系统其他删除行为一致。不能删除正在处理中（busy）的话题，也不能删除主会话。
+
+删除时会自动取消该话题的所有关联 Trigger，防止 ghost wakeup。
+
+删除后历史仍可通过 `ec thread history <peer>/<threadId>` 读取（直接读 messages.jsonl，不依赖索引）。
+
+## 跨会话发送（话题链核心）
+
+在托管会话中，`ec msg send` 支持 `--thread` 参数直接路由到某个话题：
+
+```bash
+# 完整形式
+ec msg send <from> <to> '<消息内容>' --thread <threadId>
+
+# 托管会话简化形式（from/to 自动从运行时上下文推断）
+ec msg send '<消息内容>' --thread <threadId>
+
+# 附带复查 Trigger（跨话题时必填；每 30m 唤醒本端回查）
+ec msg send '<消息内容>' --thread <threadId> --check-every 30m
+```
+
+注意事项：
+
+- `--thread` 指定的话题必须已存在于本端索引（`ec thread list` 可见），否则返回 `TOPIC_NOT_FOUND`
+- **跨话题发送时 `--check-every` 为必填项**，不指定会直接报错。取值如 `5m` / `30m` / `2h` / `1d`
+- 跨话题发送成功后，系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时，
+  这条记录会以「⟵ 跨会话上下文 · 来源话题:xxx」的形式注入一次，然后删除
+- `--check-every` 会创建周期复查 Trigger（名称 `check-<目标>-from-<来源>-<唯一后缀>`，`kind=thread-check`），
+  每隔指定时长唤醒本端话题，提示回查目标话题与来源话题，直到显式
+  `ec trigger cancel <triggerId>` 结束。**每次发送都新建一个 Trigger**，取消/调整用
+  返回的 `trigger_id`（形如 `trig_…`）——`ec trigger` 的定位标识是 **id 不是名称**
+- `--trigger-prompt "<text>"` 可选，用于替换复查 prompt 中的自定义段（默认给出通用的检查/决策指引）
+
+### 跨会话委托的完整流程
+
+**A 委托 B 处理某个任务：**
+
+```bash
+# A 向 B 的话题 T2 发送任务，并设置周期复查
+ec msg send "请处理项目A的数据清洗" --thread thread-T2-xxxx --check-every 2h
+```
+
+**B 接收时感知来源上下文：**
+
+B 的目标话题下次被唤醒时，prompt 开头会注入一条跨会话上下文，格式如下：
+
+```
+‹跨会话上下文 · 来源话题:thread-T1-xxxx · 对端:alice.agentid.cn · 发送于:2026-10-10 10:00›
+⚠️ 来源话题在发送后已有 3 条新消息（10:01 - 10:15）—— 处理前建议先回查该话题的空洞期消息。
+🔔 复查 Trigger:trig_1791765199642_5371c8ff（尚未触发/待处理）
+【原消息内容】
+```
+
+注入只发生一次。之后 B 靠自身上下文记住"我从哪个话题跨过来的"，可随时用
+`ec thread history <来源peer>/<来源话题>` 回查空洞期消息。
+
+## 话题摘要（Summary）
+
+摘要用于跨会话保留话题的核心信息，在下次激活或委托时快速恢复上下文。
+daemon 不自动总结，需要 agent 主动写入。
+
+```bash
+# 查看当前摘要（同时打印 coveredThroughTs 覆盖游标）
+ec thread summary show <peer>/<threadId>
+
+# 写入摘要 —— --name 必填：同时把话题改成这个标题
+ec thread summary set <peer>/<threadId> "项目A需求已确认，正在开发登录模块" --name "项目A登录模块"
+# 不想改话题名就显式传 -
+ec thread summary set <peer>/<threadId> '<摘要内容>' --name -
+
+# 支持 CAS（乐观锁），防止并发覆盖
+ec thread summary set <peer>/<threadId> "新内容" --name - --if-rev 3
+
+# 查看历史版本
+ec thread summary log <peer>/<threadId>
+
+# 清空当前摘要（历史版本保留）
+ec thread summary clear <peer>/<threadId>
+```
+
+### 覆盖游标与增量总结
+
+`summary set` 会在写入时自动记录 `coveredThroughTs`——**当时该话题最后一条消息的时间戳**，
+表示"这条摘要覆盖到哪"。`summary show` 会把它打印出来。
+
+下次总结时用它作起点，只读增量（不必拍脑袋定 `--limit`）：
+
+```bash
+# 1. 拿覆盖游标
+ec thread summary show <peer>/<threadId>          # 输出中的 coveredThroughTs
+
+# 2. 读游标之后的增量（首次总结无游标时省略 --after，全量读）
+ec thread history <peer>/<threadId> --after <coveredThroughTs> --limit 50
+
+# 3. 增量较多时往回翻页（history 支持 before 逆序分页）
+ec thread history <peer>/<threadId> --before <本页最早一条的ts> --limit 50
+
+# 4. 读完增量后写摘要，游标自动推进到当前最新一条
+ec thread summary set <peer>/<threadId> "新摘要" --name -
+```
+
+**约束**：`summary set` 把游标设为**写入时刻话题的最新一条**，所以跨话题总结必须**先把增量读完再写**——
+没读完就写，游标会越过未读的那段，它们下次不会再被返回。
+
+存储位置：`~/.evolcore/agents/<selfAid>/data/threads/summaries/<sessionId>.summary.jsonl`。
+
+CAS 说明：`--if-rev <n>` 指定当前已知的版本号；若实际版本不匹配，写入失败并返回 `SUMMARY_CAS_CONFLICT`。先用 `show` 拿到当前 rev，再带上 `--if-rev` 写入，可防止并发覆盖。
+
+## 重建索引
+
+话题索引损坏或和 session 文件不同步时，可以重建。
+
+索引与摘要、跨会话收件箱统一收在 `~/.evolcore/agents/<selfAid>/data/threads/` 下：
+
+```
+data/threads/
+├── index.json      话题索引
+├── summaries/      话题摘要（<sessionId>.summary.jsonl）
+└── inbox/          跨会话上下文收件箱
+```
+
+```bash
+ec thread rebuild-index
+ec thread rebuild-index --agent <aid>   # 跨身份操作
+ec thread rebuild-index --check         # 只检查不写盘
+ec thread check-index                   # 同 rebuild-index --check
+```
+
+## 引用格式（\<ref\>）
+
+命令里的 `<ref>` 参数支持三种格式：
+
+| 格式 | 含义 |
+|---|---|
+| `current` | 当前任务所在话题 |
+| `<peer>` | 该对端的主会话 |
+| `<peer>/<threadId>` | 指定话题，如 `bob.agentid.cn/thread-xxx-0001-aaaa` |
+
+## 话题状态值
+
+| 值 | 含义 |
+|---|---|
+| `pending` | 待开始（默认） |
+| `in_progress` | 进行中 |
+| `completed` | 已完成 |
+| `archived` | 已归档 |
+
+## 常见错误码
+
+| 错误码 | 含义 | 处理建议 |
+|---|---|---|
+| `TOPIC_NOT_FOUND` | 话题不存在或 threadId 错误 | 用 `ec thread list <peer>` 确认 threadId |
+| `TOPIC_CONFLICT` | 同名话题已存在 | 改名或用现有话题 |
+| `TOPIC_BUSY` | 话题正在处理中 | 等待处理完成后再删除 |
+| `SUMMARY_CAS_CONFLICT` | 摘要版本冲突 | 重新 `show` 获取最新 rev，再重试 |
+| `INVALID_NAME` | 话题名称不合法 | 名称不能为空，不超过 80 字符 |
+| `NAME_TOO_LONG` | 话题名称超过 80 字符 | 缩短名称 |

package/kits/docs/prompt-loading-architecture.md

@@ -103,7 +103,6 @@
 | 10 | rules | always | ✗ | `$KITS_RULES/` 目录（ECK 核心规则） |
 | 20 | identity-layer | chatType≠null | ✓ | 身份层 fragment |
 | 21 | persona | chatType≠null | ✗ | `$PERSONAL_DIR/persona.md` |
-| 21.5 | personal-profile | chatType≠null | ✗ | `$PERSONAL_DIR/personal.md` |
 | 30 | relation-layer | chatType∈{private,group} | ✓ | 关系层 fragment |
 | 35 | memory | memoryEnableRelation≠false | ✓ | 记忆系统 fragment（按 sessionType 分支） |
 | 36 | agent-memory | memoryEnableAgent≠false | ✗ | `$PERSONAL_DIR/memory/MEMORY.md` |
@@ -117,6 +116,7 @@
 | 55 | commands | channel≠null | ✓ | 命令集能力卡 |
 | 60 | session | always | ✓ | 会话层 fragment（含 localDate/weekday） |
 | 70 | baseagent | baseAgent≠null | ✓ | base agent 配置 fragment |
+| 80 | managed-runtime-notice | lifecycle=active | ✓ | 托管运行时提示（勿重复读 $KITS_RULES/ 与 CLAUDE.md 指令） |
 
 ### 输出结构