evolcore 0.0.31 → 0.0.33

package/kits/docs/evolcore/trigger.md

@@ -10,9 +10,9 @@
 
 文件输入限制为 4 MiB，拒绝符号链接、junction、硬链接、路径逃逸、其他会话临时目录、密钥及其他 Agent 私有数据。普通定义导入必须属于当前 Agent；脚本只上传 `execution.script.path` 指定的单个文件，不允许覆盖 `trigger.json`、`active.json` 等管理状态。绝对 `--script-path` 会上传脚本内容并保存 Agent 内相对路径，不保留宿主绝对路径。`--help` / `-h` 在鉴权和文件读取前返回。
 
-普通脚本 Trigger 按每次执行重新核验的 Agent 授权运行，`bypass` 不等于宿主权限：项目按有效模式只读或可写，脚本使用只读快照，只有当前 run 的临时工作目录可写，不继承 daemon 凭据或 IPC 入口，网络禁用。脚本快照位置不同于持久化 Trigger 目录；需要项目资源时按工作目录定位，不能依赖 Trigger 状态文件或其他脚本附件。Node `.js` 保留原 package 的模块类型。
+普通脚本 Trigger 按每次执行重新核验的 Agent 授权运行，复用主会话的权限模式与 H/L 路径保护：`readonly` 项目只读且禁止读取 L 类路径，`auto/request` 项目可写、L 类路径只读；认证 `owner + bypass` 关闭项目写入沙箱，但仍遮蔽 H 类路径并保护 L 类路径。网络默认开放，不需要网络权限配置；保留宿主 HOME、Git/SSH 与代理环境，清除 daemon 凭据、任务 delegation 和代码注入变量。`request` 的非交互脚本不能申请额外权限，越界操作直接失败，不自动升级。脚本使用只读快照和独立临时工作目录；快照位置不同于持久化 Trigger 目录，需要项目资源时按工作目录定位。Node `.js` 保留原 package 的模块类型。
 
-- Linux：需要可用的 `bubblewrap`，使用独立根文件系统及进程/网络命名空间，仅绑定项目、最小系统运行时和当前 run。
+- Linux：需要可用的 `bubblewrap`，复用会话权限运行时的进程隔离和 H/L 路径保护，不隔离网络命名空间；受限模式将宿主根目录只读映射，按权限开放项目和当前 run 临时目录，完整保留系统依赖及 `/etc/alternatives` 链接。
 - Windows：需要支持受限读取策略的原生 Codex CLI，以及宿主已准备好的 elevated sandbox。每次启动前先用同一个临时 canary 验证“显式授权可读、撤回授权后拒绝读取”和当前 run 可写；只有权限拒绝才算通过，文件不存在、探针超时或取消均失败关闭。旧初始化、不支持的运行时或无法证明读取隔离时返回 `SCRIPT_SANDBOX_UNAVAILABLE`，不会启动用户脚本；托管任务不会自动提权、初始化沙箱或降级为宿主执行。
 - 其他平台：当前普通脚本执行失败关闭，不提供未隔离的回退。
 

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

@@ -117,6 +117,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 指令） |
 
 ### 输出结构
 

package/kits/eck_manifest.json

@@ -45,6 +45,32 @@
       },
       "description": "身份层：我是谁"
     },
+    {
+      "id": "skills-builtin",
+      "type": "file",
+      "file": "$AGENT_DIR/skills/.index-builtin.md",
+      "order": 20.5,
+      "needsInjection": false,
+      "optional": true,
+      "when": {
+        "var": "lifecycle",
+        "eq": "active"
+      },
+      "description": "内置技能索引"
+    },
+    {
+      "id": "skills-local",
+      "type": "file",
+      "file": "$AGENT_DIR/skills/.index-local.md",
+      "order": 20.6,
+      "needsInjection": false,
+      "optional": true,
+      "when": {
+        "var": "lifecycle",
+        "eq": "active"
+      },
+      "description": "本机技能索引"
+    },
     {
       "id": "persona",
       "type": "file",
@@ -85,32 +111,6 @@
       },
       "description": "个人资料（personal.md）"
     },
-    {
-      "id": "skills-builtin",
-      "type": "file",
-      "file": "$AGENT_DIR/skills/.index-builtin.md",
-      "order": 20.5,
-      "needsInjection": false,
-      "optional": true,
-      "when": {
-        "var": "lifecycle",
-        "eq": "active"
-      },
-      "description": "内置技能索引"
-    },
-    {
-      "id": "skills-local",
-      "type": "file",
-      "file": "$AGENT_DIR/skills/.index-local.md",
-      "order": 20.6,
-      "needsInjection": false,
-      "optional": true,
-      "when": {
-        "var": "lifecycle",
-        "eq": "active"
-      },
-      "description": "本机技能索引"
-    },
     {
       "id": "relation-layer",
       "type": "file",
@@ -346,6 +346,29 @@
       },
       "description": "客户端环境文档"
     },
+    {
+      "id": "memory-and-thread",
+      "type": "file",
+      "file": "$KITS_RULES/07-memory-and-thread.md",
+      "order": 46,
+      "needsInjection": false,
+      "when": {
+        "and": [
+          {
+            "var": "chatType",
+            "in": [
+              "private",
+              "group"
+            ]
+          },
+          {
+            "var": "lifecycle",
+            "eq": "active"
+          }
+        ]
+      },
+      "description": "记忆与话题：持久化上下文的两套机制（memory + thread）"
+    },
     {
       "id": "reply-contract",
       "type": "file",
@@ -440,6 +463,18 @@
         ]
       },
       "description": "Base Agent 特定配置"
+    },
+    {
+      "id": "managed-runtime-notice",
+      "type": "file",
+      "file": "$KITS_FRAGMENTS/managed-runtime.md",
+      "order": 80,
+      "needsInjection": true,
+      "when": {
+        "var": "lifecycle",
+        "eq": "active"
+      },
+      "description": "托管运行时提示：上下文已就绪，勿重复读取"
     }
   ]
 }

package/kits/eck_message_manifest.json

@@ -10,7 +10,18 @@
       "modeType": "inject",
       "modeName": "default",
       "isDefault": true,
-      "when": { "and": [ { "var": "isOwnerHint", "eq": true }, { "var": "renderMode_inject", "eq": "default" } ] },
+      "when": {
+        "and": [
+          {
+            "var": "isOwnerHint",
+            "eq": true
+          },
+          {
+            "var": "renderMode_inject",
+            "eq": "default"
+          }
+        ]
+      },
       "description": "观察者插话提示渲染（owner 信封头·default 模式）"
     },
     {
@@ -21,8 +32,23 @@
       "needsInjection": true,
       "modeType": "handoff",
       "modeName": "request_to_target",
-      "when": { "and": [ { "var": "isHandoff", "eq": true }, { "var": "handoffKind", "eq": "request_to_target" }, { "var": "handoffReturnPolicy", "eq": "required" } ] },
-      "description": "msg send 跨会话请求回复上下文渲染"
+      "when": {
+        "and": [
+          {
+            "var": "isHandoff",
+            "eq": true
+          },
+          {
+            "var": "handoffKind",
+            "eq": "request_to_target"
+          },
+          {
+            "var": "handoffReturnPolicy",
+            "eq": "required"
+          }
+        ]
+      },
+      "description": "[DEPRECATED] msg send 跨会话请求回复上下文渲染（handoff 已被 Thread Context 取代，见 docs/thread-chain/handoff-deprecation.md）"
     },
     {
       "id": "msg-handoff-context-to-target",
@@ -32,8 +58,23 @@
       "needsInjection": true,
       "modeType": "handoff",
       "modeName": "request_to_target",
-      "when": { "and": [ { "var": "isHandoff", "eq": true }, { "var": "handoffKind", "eq": "request_to_target" }, { "var": "handoffReturnPolicy", "eq": "none" } ] },
-      "description": "msg send 跨会话单次本地上下文渲染"
+      "when": {
+        "and": [
+          {
+            "var": "isHandoff",
+            "eq": true
+          },
+          {
+            "var": "handoffKind",
+            "eq": "request_to_target"
+          },
+          {
+            "var": "handoffReturnPolicy",
+            "eq": "none"
+          }
+        ]
+      },
+      "description": "[DEPRECATED] msg send 跨会话单次本地上下文渲染（handoff 已被 Thread Context 取代，见 docs/thread-chain/handoff-deprecation.md）"
     },
     {
       "id": "msg-handoff-response-to-origin",
@@ -43,8 +84,80 @@
       "needsInjection": true,
       "modeType": "handoff",
       "modeName": "response_to_origin",
-      "when": { "and": [ { "var": "isHandoff", "eq": true }, { "var": "handoffKind", "eq": "response_to_origin" } ] },
-      "description": "msg send 跨会话结果回流上下文渲染"
+      "when": {
+        "and": [
+          {
+            "var": "isHandoff",
+            "eq": true
+          },
+          {
+            "var": "handoffKind",
+            "eq": "response_to_origin"
+          }
+        ]
+      },
+      "description": "[DEPRECATED] msg send 跨会话结果回流上下文渲染（handoff 已被 Thread Context 取代，见 docs/thread-chain/handoff-deprecation.md）"
+    },
+    {
+      "id": "msg-trigger-thread-check",
+      "type": "file",
+      "file": "$KITS_MESSAGE_FRAGMENTS/trigger-thread-check.md",
+      "order": 5,
+      "needsInjection": true,
+      "modeType": "trigger-thread-check",
+      "modeName": "default",
+      "isDefault": true,
+      "when": {
+        "and": [
+          {
+            "var": "isTriggerMsg",
+            "eq": true
+          },
+          {
+            "var": "triggerMsgKind",
+            "eq": "thread-check"
+          }
+        ]
+      },
+      "description": "跨话题复查 Trigger 专属渲染（kind=thread-check：来源话题 + 目标话题 + 周期）"
+    },
+    {
+      "id": "msg-trigger-session",
+      "type": "file",
+      "file": "$KITS_MESSAGE_FRAGMENTS/trigger-session.md",
+      "order": 6,
+      "needsInjection": true,
+      "modeType": "trigger-session",
+      "modeName": "default",
+      "isDefault": true,
+      "when": {
+        "and": [
+          {
+            "var": "isTriggerMsg",
+            "eq": true
+          },
+          {
+            "var": "triggerMsgKind",
+            "neq": "thread-check"
+          }
+        ]
+      },
+      "description": "Trigger 唤醒消息渲染（trigger 信封头 + 触发时间 + 正文）"
+    },
+    {
+      "id": "msg-thread-context",
+      "type": "file",
+      "file": "$KITS_MESSAGE_FRAGMENTS/thread-context.md",
+      "order": 8,
+      "needsInjection": true,
+      "modeType": "thread-context",
+      "modeName": "default",
+      "isDefault": true,
+      "when": {
+        "var": "isThreadContext",
+        "eq": true
+      },
+      "description": "跨会话上下文注入（来源话题 + 空洞提示 + 复查 Trigger）"
     },
     {
       "id": "msg-private-default",
@@ -55,7 +168,30 @@
       "modeType": "private",
       "modeName": "default",
       "isDefault": true,
-      "when": { "and": [ { "var": "isOwnerHint", "neq": true }, { "var": "chatType", "neq": "group" }, { "var": "renderMode_private", "eq": "default" } ] },
+      "when": {
+        "and": [
+          {
+            "var": "isOwnerHint",
+            "neq": true
+          },
+          {
+            "var": "isThreadContext",
+            "neq": true
+          },
+          {
+            "var": "isTriggerMsg",
+            "neq": true
+          },
+          {
+            "var": "chatType",
+            "neq": "group"
+          },
+          {
+            "var": "renderMode_private",
+            "eq": "default"
+          }
+        ]
+      },
       "description": "对端私聊消息渲染（default 模式；chatType 非 group 的非插话消息，含 handoff/coding/null 兜底）"
     },
     {
@@ -67,8 +203,31 @@
       "modeType": "group",
       "modeName": "default",
       "isDefault": true,
-      "when": { "and": [ { "var": "isOwnerHint", "neq": true }, { "var": "chatType", "eq": "group" }, { "var": "renderMode_group", "eq": "default" } ] },
+      "when": {
+        "and": [
+          {
+            "var": "isOwnerHint",
+            "neq": true
+          },
+          {
+            "var": "isThreadContext",
+            "neq": true
+          },
+          {
+            "var": "isTriggerMsg",
+            "neq": true
+          },
+          {
+            "var": "chatType",
+            "eq": "group"
+          },
+          {
+            "var": "renderMode_group",
+            "eq": "default"
+          }
+        ]
+      },
       "description": "群聊消息渲染（default 模式）"
     }
   ]
-}
+}

package/kits/rules/01-overview.md

@@ -6,15 +6,6 @@ ECK 的总览：前置概念和框架结构。
 
 Base agent 是提供推理与生成能力的底层智能，规范值有 `claude`（Claude Code）、`codex`（Codex）、`gemini`（Gemini CLI）、`ecagent`（EvolCore 内置基座）四类。你就是当前会话的 base agent；具体是哪一类以 `[baseagent]` 段注入的 `baseAgentName` 为准，不要默认自己是 Claude Code。
 
-### 外部 Coding Agent Skills 边界
-
-当前会话由 EvolCore 托管时，不加载、不读取、不执行工作区之外的 coding-agent `SKILL.md`，包括
-`/home/evolcore/skills/eclink/SKILL.md`。该类 skill 只服务于独立运行、未接入 EvolCore 会话上下文的
-Codex/Claude Code 等独立工具实例。EvolCore 会话必须遵循本 ECK、daemon IPC 和渠道适配层提供的通信与权限路径。
-
-尤其不要在 EvolCore 会话中因为看到 AUN/agent 间通信需求，就自行读取 `eclink` skill 或直接拼接 shell
-命令调用 `ec`；发送必须经过当前会话的 delegated sender，以便锁定 self/peer、角色、审计和回执。
-
 ## AUN 是什么
 
 AUN（Agent Union Network）是 agent 间安全通信的网络协议，SDK 的 npm 包名 `@agentunion/fastaun`。

package/kits/rules/05-venue.md

@@ -29,7 +29,7 @@
 
 | 位置 | 内容 |
 |------|------|
-| `$KITS_DOCS/venues/` | 环境层场景文档（只读，按需加载）：`private.md` `group.md` `<channel>-<chatType>.md` `client-*.md` |
+| `$KITS_DOCS/venues/` | 环境层场景文档（只读，按需加载）：`private.md` `<channel>-<chatType>.md` `client-*.md`。群聊场景的完整指引已抽离为内置技能 `ec-group`，不再有 `venues/group.md` |
 | `$VENUES_DIR`（`$AGENT_DIR/venues/`） | **目前是死目录**：会被创建（含 `_index/` `_trash/`），但源码里 `agentVenuesDir()` 零调用点，无人读写 |
 
 > `venues/` 下若有 `aun#<group-aid>` 之类的实例目录，是已删除模块 `group-venue-sync.ts` 的历史残留，

package/kits/rules/06-channel.md

@@ -45,7 +45,13 @@
 **完整命令集目录（含分类、触发词、适用场景）**：`$KITS_DOCS/evolcore/INDEX.md`。
 单个命令集的详细用法按需 Read 对应文档。
 
-托管 Agent 任务禁止调用 `ec start`、`ec stop`、`ec restart` 或 `ec restart-monitor`。这些是宿主终端的进程生命周期命令；源码改动后 Agent 只负责构建并报告需要宿主重启，不得尝试、重试或建议 Agent 自己执行 `ec restart`。
+### 当前托管实例的生命周期保护
+
+托管 Agent 不得自行停止、重启或替换承载当前会话的 EvolCore 实例，包括针对该实例的 `ec stop`、`ec restart`、`ec restart-monitor` 和会启动替代进程的 `ec start`。限制以实际目标实例为准，不按命令名称、是否同主机或调用通道一概判定；`fullaccess` 不解除自身实例保护。
+
+其他 EvolCore 实例（包括同主机的独立实例和远程实例）不属于上述保护范围，操作仍须获得用户授权并满足目标端权限。SSH、受鉴权 API 或其他获准的管理通道均可使用，不限定为 SSH；通过回连、代理或端口转发实际操作自身实例，仍受上述限制。无法确认目标是否为自身实例时，应先核实，不得仅凭“远程”调用形式认定允许。
+
+修改承载当前会话的 EvolCore 源码后，Agent 只负责构建并报告需要宿主重启；`ec agent reload` 只重载配置/persona/memory，不重载源码。
 
 共同约定：
 - 以自己的 AID 为发送者

package/kits/rules/07-memory-and-thread.md

@@ -0,0 +1,202 @@
+# 记忆与话题：持久化上下文的两套机制
+
+触发词：记忆/memory/话题/thread/summary/摘要/ec memory/ec thread/话题名/工作报告
+
+这两套机制共同解决"跨会话上下文丢失"的问题，但定位不同：
+
+| 机制 | 粒度 | 作用 | 写入时机 |
+|------|------|------|----------|
+| 记忆（memory） | 对端级 / agent 级 / owner 级 | 跨所有话题持久化的长期事实 | 每轮对话中识别到值得保留的事实时 |
+| 话题摘要（summary） | 话题级 | 这个话题的进展快照，供下次激活时快速恢复 | 阶段完成时、离开话题前 |
+
+两者不冲突，按粒度分工：对端的基本信息（偏好、角色、背景）写进记忆；这个任务线做了什么、结果如何写进话题摘要。
+
+---
+
+## 一、记忆系统（ec memory）
+
+记忆是写给自己、跨会话持久的事实。不要依赖会话上下文来记住用户说过的事，用记忆系统写下来。
+
+### 什么时候写记忆
+
+**必须写的情况**：
+- 用户告知了关于自己的事实（姓名、职业、偏好、背景）
+- 用户明确要求"记住"某件事
+- 发现了跨会话有用的规律（用户的工作方式、反馈模式）
+
+**不要写的情况**：
+- 当前话题的具体进展（写话题摘要，不写记忆）
+- 只在本会话有意义的临时状态
+- 代码结构、文件路径、git 历史（代码库本身就记录了）
+
+### 记忆命令
+
+```bash
+# 写入新 note
+ec memory note --slug <slug> [--tags <tag1,tag2>] "<正文>"
+
+# 修改已有 note
+ec memory note --slug <slug> --update "<新正文>"
+
+# 查看记忆概览
+ec memory show
+
+# 查看待整理 notes
+ec memory notes
+
+# 触发整理会话（将 notes 归档为正式记忆）
+ec memory consolidate
+```
+
+### 默认行为
+
+记忆写入动作默认**静默**，不打断对话。用户明确要求记住某事时，给一句简短确认（"已记下"），然后继续。
+
+---
+
+## 二、话题系统（ec thread）
+
+### 标准工作流
+
+```bash
+# 1. 列出本机所有 agent
+ec agent list
+
+# 2. 列出某 agent 有话题记录的所有对端
+ec thread peers --self <selfAid>
+
+# 3. 列出与某对端的所有话题（默认10条/页，含消息统计和摘要）
+ec thread list <peer> --self <selfAid>
+
+# 4. 翻页（页脚自动给出完整翻页命令，含真实 peer 和 selfAid）
+ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
+
+# 5. 查看某话题的历史消息
+ec thread history <peer>/<threadId> --self <selfAid> --limit 20
+
+# 6. 查看/更新话题摘要
+ec thread summary show <peer>/<threadId> --self <selfAid>
+```
+
+### 跨话题发送（联系当前对端以外的对象）
+
+一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端；要联系**其他**对象，必须换到与该对象的话题上发送：
+
+```bash
+# 1. 选中目标话题（没有就新建）
+ec thread list <对方AID> --self <selfAid>
+ec thread create <对方AID> --name "问题跟踪" --self <selfAid>   # 返回 threadId
+
+# 2. 带上话题发送；托管会话中 from/to 由话题推断，--check-every 必填
+ec msg send "<text>" --thread <threadId> --check-every 5m
+ec group send "<text>" --thread <threadId> --check-every 5m     # 群对端
+```
+
+- 不带 `--thread` 而直接把目标换成第三方，会被运行时拒绝（只能联系当前对端/群）
+- `--thread` 指定的话题必须已存在于本端索引，否则报 `TOPIC_NOT_FOUND`
+- 发送成功后本端写入 thread-inbox：目标话题下次被唤醒时注入一次来源话题上下文，然后删除
+- `--check-every` 会创建周期复查 Trigger（每次发送各新建一个，名称 `check-<目标>-from-<来源>-<唯一后缀>`），
+  需显式 `ec trigger cancel <trigger_id>` 结束；定位用返回的 `trigger_id`（`trig_…`），**不是名称**
+
+### 话题名称维护
+
+**何时更新名称**（主动触发，不等对端问）：
+
+| 情况 | 操作 |
+|------|------|
+| 名称是"话题会话"、"你好"等无意义短语 | 立即改名 |
+| 话题方向已明确，名称仍未反映内容 | 改名 |
+| 话题完成，名称与成果不符 | 改名 |
+
+**命名规范**：
+- 不超过 20 字，用动词短语描述核心动作
+- 好的示例：`skill 索引热更新 bug 修复`、`manifest 注入与 CLAUDE.md 冗余问题`
+- 避免：日期、轮次序号、"话题会话"等占位词
+
+```bash
+ec thread rename current "<新名称>"                              # 托管会话
+ec thread rename <peer>/<threadId> "<新名称>" --self <selfAid>  # 宿主终端
+```
+
+### 话题摘要维护
+
+摘要是话题的进展快照，**daemon 不自动总结**，需要主动写入。
+
+**用户说"总结一下话题"时**（触发词：总结一下话题 / 总结话题 / 给这个话题写个总结 / 更新一下摘要）：
+
+核心：`summary show` 打印 `coveredThroughTs`（上次覆盖到的时间戳）→ 用它作起点读增量 → 写新摘要。
+`summary set` 自动把游标推进到当时话题最新一条。
+
+```bash
+# 情形 A：就在当前话题里总结（对话在上下文，增量就是本轮对话，不用读历史）
+ec thread summary show current                # 1. 看上次摘要 + coveredThroughTs
+ec thread summary set current "<摘要内容>" --name "<新标题>"   # 2. 写摘要 + 标题（--name 必填）
+#    游标自动推进；不想改名就传 --name -
+
+# 情形 B：从别的话题/别处总结（必须读增量）
+ec thread summary show <peer>/<threadId>                              # 1. 拿 coveredThroughTs
+ec thread history <peer>/<threadId> --after <coveredThroughTs> --limit 50   # 2. 读增量
+ec thread history <peer>/<threadId> --before <最早ts-1> --limit 50    # 3. 增量多则往回翻页
+ec thread summary set <peer>/<threadId> "<摘要内容>"                   # 4. 读完再写（游标自动推进）
+ec thread rename <peer>/<threadId> "<新名称>"                           # 5. 必要时改名
+```
+
+**关键约束**：`summary set` 把游标设为**当时话题的最新一条**，所以跨话题总结**必须先把增量读完再写**——
+没读完就写，游标越过未读消息，它们下次不会再返回。
+
+**改名**：`summary set --name "<新标题>"` 一次完成写摘要 + 改名（比单独跑 `rename` 省一步）。
+`--name` 必填；要保留原标题就显式传 `--name -`。
+
+**首次总结**：`summary show` 没有 `coveredThroughTs`（从未总结过，或是只带 `updatedAt` 的旧记录），
+此时从最新往回翻到你认为已覆盖的开头再写。
+
+**必须写摘要的时机**：
+
+| 时机 | 操作 |
+|------|------|
+| 用户明确说"总结一下" | 按上面的情形 A / B 序列执行 |
+| 一个明确的阶段或任务完成 | 写入/更新摘要 |
+| 即将跨话题路由（去问另一个 agent）之前 | 写入当前状态 |
+| 话题状态改为 `completed` 之前 | 写入最终成果摘要 |
+| 被唤醒时发现摘要显示"未总结" | 回顾历史后补写 |
+
+**摘要规范**：
+- 100 字以内，写给自己下次看，不是给对端展示
+- 格式：`[谁]做了[什么]，结果是[什么]，遗留[什么]`
+- 示例：`leiliang 要求把 skill 开关从默认开改为默认关。tl3 完成 switch-resolver.ts 修改并验证，107 个开关记录对应，daemon 已重启。`
+- summary 是本端私有的（keyed by 本地 sessionId），只写"我下次该知道什么"，不写给对端的话
+
+```bash
+# 查看当前摘要和版本号
+ec thread summary show current
+
+# 写入摘要（单 agent）
+ec thread summary set current "<摘要内容>"
+
+# 写入摘要（多 agent 协作，用 CAS 防覆盖）
+ec thread summary set current "<摘要内容>" --if-rev <当前rev>
+
+# 查看摘要历史
+ec thread summary log current
+```
+
+`ec thread list` 输出里摘要显示"未总结"就是行动信号。
+
+### 话题状态管理
+
+```bash
+ec thread status current in_progress    # 开始处理
+ec thread status current completed      # 任务完成
+# 状态值：pending | in_progress | completed | archived
+```
+
+状态改为 `completed` 前，先写入最终摘要。
+
+---
+
+## 三、不需要做的事
+
+- 不要在每条消息后都更新摘要——只在阶段完成时
+- 不要把话题摘要当成会议纪要——简短的进展摘记即可
+- 不要把当前话题的进展写进记忆——那是话题摘要的工作
+- 不要因为对端没问就不更新——摘要和记忆都是给自己的

package/kits/schemas/relation-config.schema.9.json

@@ -72,10 +72,25 @@
       "x-merge": "scalar",
       "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
     },
-    "sessionIdleSec": {
-      "type": "number",
+    "sessionLoop": {
+      "type": "object",
       "x-merge": "scalar",
-      "description": "会话闲置周期，单位为秒；缺省或小于等于 0 关闭，正值小于 30 秒按 30 秒处理"
+      "description": "当前关系主会话的闲置触发设置；话题不继承",
+      "oneOf": [
+        {
+          "properties": { "enabled": { "const": false } },
+          "required": ["enabled"],
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "enabled": { "const": true },
+            "idleSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }
+          },
+          "required": ["enabled", "idleSeconds"],
+          "additionalProperties": false
+        }
+      ]
     },
     "model": { "type": "string", "x-merge": "scalar" },
     "responseMode": { "type": "string", "x-merge": "scalar" },