evolcore 0.0.25 → 0.0.26

package/kits/docs/evolcore/msg.md

@@ -1,165 +1,166 @@
-# ec msg — 私聊消息命令
-
-私聊场景下收发消息的命令集。触发词：回复/发消息/拉取/撤回/查在线。
-
-## Agent 会话中的 Shell 调用边界
-
-在 EvolCore 托管会话中，每次工具调用只能执行一条完整的 `ec` 命令。禁止把
-`command -v`、`ec aid`、`&&`、`||`、`;`、`|`、重定向、子 shell、`bash -lc` 或其它脚本
-和 `ec msg` 拼在一起。不要做单独的 CLI 探测；直接调用本页的单条命令，读取结构化结果后
-再决定下一步。工具审批被拒绝时应报告原始错误并停止，不要通过追加命令或提权参数重试。
-
-以自己的 AID 为发送者（`<from>`），对端 AID 为 `<to>`。
-
-## 发送消息
-
-```bash
-# 文本（明文）
-ec msg send <from> <to> "<text>" --return none|required
-
-# 从文件读取文本内容（用于超长消息或避免 Shell 转义）
-ec msg send <from> <to> --text-from-file <path> --return none|required
-
-# 文本（密文 E2EE）
-ec msg send <from> <to> "<text>" --encrypt --return none|required
-
-# 强制明文（同时出现时优先于 --encrypt）
-ec msg send <from> <to> "<text>" --no-encrypt --return none|required
-
-# 文件：--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>"]
-
-# 自定义 payload（JSON）
-ec msg send <from> <to> --payload '<json>'
-```
-
-每一行都必须单独执行，且是该次 shell 调用中的唯一命令。
-
-发送相关选项：
-- `--text-from-file <path>` — 从文件读取文本（UTF-8），用于超长消息或避免 Shell 转义
-- `--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`）
-
-托管 Agent 通过 daemon 发送时，若发送方使用 `policyMode: contacts`，私聊普通出站只允许 Owner 或实际 `active` 联系人。无条目、`pending`、`declined` 会拒绝发送并提示：
-
-```bash
-ec contact add <target-aid> --self <self-aid>
-```
-
-该命令在托管会话中会创建/更新联系人申请并给 Owner 发送审核卡片；`blocked` 目标必须先执行：
-
-```bash
-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`）不得声称已发送。
-
-成功输出：`✓ 已发送 <message_id> seq=<n> status=<status>`
-
-> 正文写法：含空格/换行/特殊字符时用引号包起来；纯短词可不包，但多空格会被压成一个。
-> 正文恰好以 `--` 开头：带空格的（如 `"--file 是正文"`）会被正确识别为正文；
-> 若正文**精确等于**某个 flag 名（如要发送文本 `--encrypt`），用 `--` 分隔：
-> `ec msg send <from> <to> -- --encrypt`
-
-## 拉取消息
-
-```bash
-ec msg pull <from> --app <name>
-ec msg pull <from> --app <name> --after-seq <N> --limit <N>
-```
-
-`--app <name>` 指定独立消费通道（slot）。**不传 `--app` 会与 daemon 共享 evolcore 消费游标，可能影响 daemon 收消息。**
-
-## 确认已读
-
-```bash
-ec msg ack <from> <seq> --app <name>
-```
-
-同样：不传 `--app` 会推进与 daemon 共享的游标。
-
-## 撤回消息
-
-```bash
-ec msg recall <from> <message-id> [<message-id>...]
-```
-
-## 查询在线状态
-
-```bash
-ec msg online <from> <target-aid> [<target-aid>...]
-```
-
-输出：`🟢` 在线 / `⚫` 离线。
-
-## 查询本地消息历史
-
-```bash
-# 查询最新激活会话最近 50 条本地历史
-ec msg history <self-aid> <target-aid>
-
-# 只查询 active.json 当前激活的 EvolCore 会话
-ec msg history <self-aid> <target-aid> --session latest
-
-# 查询指定归档会话
-ec msg history <self-aid> <target-aid> --session <session-id>
-
-# 查询该 AID 对全部本地历史（包括没有 sessionId 的旧记录）
-ec msg history <self-aid> <target-aid> --session all
-
-# 组合过滤
-ec msg history <self-aid> <target-aid> \
-  --after 2026-07-13T00:00:00+08:00 \
-  --direction in --limit 100 --format json
-```
-
-历史查询读取本地 `messages.jsonl`，不调用 `message.pull`，不会读取或推进网络收件箱游标。
-
-托管任务限制：只能使用当前 self AID，并且只能读取当前 AUN 私聊对端；群聊、非 AUN 渠道和其他对端都会被拒绝。托管任务不支持 `--channel`、`--channel-name`、`--aun-path` 或 `--app`，仅可使用 `--session`、`--limit`、`--before`、`--after`、`--direction` 和 `--format`。
-
-- 不传 `--session`：等价于 `--session latest`。
-- `--session latest`：使用该 AID 对 `active.json` 中的最新激活会话；找不到时直接报错。
-- `--session all`：包含该 AID 对全部本地历史以及没有会话标识的旧记录。
-- `--session <session-id>`：只返回精确属于该逻辑会话的消息。
-- 使用会话过滤时，旧版本中没有 `sessionId` 的消息不会返回。
-- `--limit` 默认 50，最大 500。
-- `--before` / `--after` 支持 epoch 毫秒或 ISO 时间，均为开区间。
-- `--direction` 支持 `in|out|all`，默认 `all`。
-- 内部 `handoff_state` 记录不会出现在结果中。
-
-`sessionId` 是 EvolCore 本地逻辑会话 ID，不是 Claude/Codex 等后端的会话 ID。
-
-## 共享选项
-
-- `--format json` — 对支持结构化结果的子命令输出 JSON
-- `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
-- `--aun-path <path>` — 指定 AUN keystore 根
-
-## 自主回复策略
-
-收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
-
-加密策略：
-- 对端发来密文消息时，回复也应使用 `--encrypt`（保持对话加密一致性）
-- 对端发来明文消息时，默认明文回复
-
-## 在当前会话中快速回复（备选）
-
-仅当无法使用 `ec msg send` 时（如拿不到自己的 AID），可用 `ec ctl send`，它自动继承当前会话的 AID 和对端：
-
-```bash
-ec ctl send "<text>"
-ec ctl send --encrypt "<text>"
-```
+# ec msg — 私聊消息命令
+
+私聊场景下收发消息的命令集。触发词：回复/发消息/拉取/撤回/查在线。
+
+## Agent 会话中的 Shell 调用边界
+
+在 EvolCore 托管会话中，每次工具调用只能执行一条完整的 `ec` 命令。禁止把
+`command -v`、`ec aid`、`&&`、`||`、`;`、`|`、重定向、子 shell、`bash -lc` 或其它脚本
+和 `ec msg` 拼在一起。不要做单独的 CLI 探测；直接调用本页的单条命令，读取结构化结果后
+再决定下一步。工具审批被拒绝时应报告原始错误并停止，不要通过追加命令或提权参数重试。
+
+以自己的 AID 为发送者（`<from>`），对端 AID 为 `<to>`。
+
+## 发送消息
+
+```bash
+# 文本（明文）
+ec msg send <from> <to> "<text>" --return none|required
+
+# 从文件读取文本内容（用于超长消息或避免 Shell 转义）
+ec msg send <from> <to> --text-from-file <path> --return none|required
+
+# 文本（密文 E2EE）
+ec msg send <from> <to> "<text>" --encrypt --return none|required
+
+# 强制明文（同时出现时优先于 --encrypt）
+ec msg send <from> <to> "<text>" --no-encrypt --return none|required
+
+# 文件：--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>"]
+
+# 自定义 payload（JSON）
+ec msg send <from> <to> --payload '<json>'
+```
+
+每一行都必须单独执行，且是该次 shell 调用中的唯一命令。
+
+发送相关选项：
+- `--text-from-file <path>` — 从文件读取文本（UTF-8），用于超长消息或避免 Shell 转义
+- `--handoff-context <text>` — 仅托管私聊跨会话发送可用，1–65536 字符；为本 Agent 的目标会话保存额外交接上下文，处理对端回复时补入。该内容不加入网络 payload，实际发送正文不变；不能用来迁移整个运行中的任务。
+- `--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`）
+
+托管 Agent 通过 daemon 发送时，若发送方使用 `policyMode: contacts`，私聊普通出站只允许 Owner 或实际 `active` 联系人。无条目、`pending`、`declined` 会拒绝发送并提示：
+
+```bash
+ec contact add <target-aid> --self <self-aid>
+```
+
+该命令在托管会话中会创建/更新联系人申请并给 Owner 发送审核卡片；`blocked` 目标必须先执行：
+
+```bash
+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`）不得声称已发送。
+
+成功输出：`✓ 已发送 <message_id> seq=<n> status=<status>`
+
+> 正文写法：含空格/换行/特殊字符时用引号包起来；纯短词可不包，但多空格会被压成一个。
+> 正文恰好以 `--` 开头：带空格的（如 `"--file 是正文"`）会被正确识别为正文；
+> 若正文**精确等于**某个 flag 名（如要发送文本 `--encrypt`），用 `--` 分隔：
+> `ec msg send <from> <to> -- --encrypt`
+
+## 拉取消息
+
+```bash
+ec msg pull <from> --app <name>
+ec msg pull <from> --app <name> --after-seq <N> --limit <N>
+```
+
+`--app <name>` 指定独立消费通道（slot）。**不传 `--app` 会与 daemon 共享 evolcore 消费游标，可能影响 daemon 收消息。**
+
+## 确认已读
+
+```bash
+ec msg ack <from> <seq> --app <name>
+```
+
+同样：不传 `--app` 会推进与 daemon 共享的游标。
+
+## 撤回消息
+
+```bash
+ec msg recall <from> <message-id> [<message-id>...]
+```
+
+## 查询在线状态
+
+```bash
+ec msg online <from> <target-aid> [<target-aid>...]
+```
+
+输出：`🟢` 在线 / `⚫` 离线。
+
+## 查询本地消息历史
+
+```bash
+# 查询最新激活会话最近 50 条本地历史
+ec msg history <self-aid> <target-aid>
+
+# 只查询 active.json 当前激活的 EvolCore 会话
+ec msg history <self-aid> <target-aid> --session latest
+
+# 查询指定归档会话
+ec msg history <self-aid> <target-aid> --session <session-id>
+
+# 查询该 AID 对全部本地历史（包括没有 sessionId 的旧记录）
+ec msg history <self-aid> <target-aid> --session all
+
+# 组合过滤
+ec msg history <self-aid> <target-aid> \
+  --after 2026-07-13T00:00:00+08:00 \
+  --direction in --limit 100 --format json
+```
+
+历史查询读取本地 `messages.jsonl`，不调用 `message.pull`，不会读取或推进网络收件箱游标。
+
+托管任务限制：只能使用当前 self AID，并且只能读取当前 AUN 私聊对端；群聊、非 AUN 渠道和其他对端都会被拒绝。托管任务不支持 `--channel`、`--channel-name`、`--aun-path` 或 `--app`，仅可使用 `--session`、`--limit`、`--before`、`--after`、`--direction` 和 `--format`。
+
+- 不传 `--session`：等价于 `--session latest`。
+- `--session latest`：使用该 AID 对 `active.json` 中的最新激活会话；找不到时直接报错。
+- `--session all`：包含该 AID 对全部本地历史以及没有会话标识的旧记录。
+- `--session <session-id>`：只返回精确属于该逻辑会话的消息。
+- 使用会话过滤时，旧版本中没有 `sessionId` 的消息不会返回。
+- `--limit` 默认 50，最大 500。
+- `--before` / `--after` 支持 epoch 毫秒或 ISO 时间，均为开区间。
+- `--direction` 支持 `in|out|all`，默认 `all`。
+- 内部 `handoff_state` 记录不会出现在结果中。
+
+`sessionId` 是 EvolCore 本地逻辑会话 ID，不是 Claude/Codex 等后端的会话 ID。
+
+## 共享选项
+
+- `--format json` — 对支持结构化结果的子命令输出 JSON
+- `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
+- `--aun-path <path>` — 指定 AUN keystore 根
+
+## 自主回复策略
+
+收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
+
+加密策略：
+- 对端发来密文消息时，回复也应使用 `--encrypt`（保持对话加密一致性）
+- 对端发来明文消息时，默认明文回复
+
+## 在当前会话中快速回复（备选）
+
+仅当无法使用 `ec msg send` 时（如拿不到自己的 AID），可用 `ec ctl send`，它自动继承当前会话的 AID 和对端：
+
+```bash
+ec ctl send "<text>"
+ec ctl send --encrypt "<text>"
+```

package/kits/docs/evolcore/response.md

@@ -1,75 +1,75 @@
-# ec response — 响应模式管理命令集
-
-按作用域查看/切换/配置会话的响应模式。触发词：切换响应模式/列响应模式/看当前模式/改响应配置/响应模式详情。
-
-> 响应模式决定「收到消息怎么处理 + 怎么回复」。不同模式适用不同场景（人机单聊、Agent 对话、繁忙群、任务群等）。
-> 与模型选择正交：response 改的是响应策略，menu 或 slash `/model` 改的是使用哪个模型。
-
-## 命令
-
-```bash
-# 列出所有响应模式（含适用场景）
-ec response list
-
-# 显示当前作用域生效的默认模式 + 配置
-ec response current [--self <aid>] [--peer <X>]
-
-# 查看单个模式详情（场景/配置参数）
-ec response info <mode-id>
-
-# 设置当前作用域的响应模式
-ec response set <mode-id> --self <aid> [--peer <X>]
-
-# 清除指定作用域的 responseMode 和 responseModeParams 设置
-ec response reset --self <aid> [--peer <X>]
-
-# 查看模式配置参数
-ec response config [<mode-id>] [--self <aid>] [--peer <X>]
-
-# 修改模式配置参数
-ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
-```
-
-## 内置模式
-
-| 模式 id | 显示名 | 场景 | 用途 |
-|---------|--------|------|------|
-| `single-session` | 单会话模式 | 私聊/群聊 | 单会话直接处理；具体投递方式由 `chatmode` 的 `interactive` / `proactive` 决定 |
-
-当前注册表只内置 `single-session`。历史的 `interactive` / `proactive` 已合并为该模式下的
-`chatmode` 流程，不再是可传给 `ec response set` 的 mode id。
-
-## 作用域（越具体越优先：关系 > agent > 全局）
-
-| 参数 | 作用域 | 落盘 |
-|------|--------|------|
-| `--self <aid>` | agent 级 | `config.json` 的 `responseMode` / `responseModeParams` |
-| `--self <aid> --peer <X>` | 关系级 | `relations/<peerKey>/config.json` 的 `responseMode` / `responseModeParams` |
-
-`--peer` 取 `channelType#channelId` 或裸 aid（裸 aid 视为 `aun#<aid>`）。
-
-> **写操作必须 --self**：响应模式是行为参数，从 agent 级起步，全局默认（defaults）不承载。
-> 读操作（list/info/current/config 查看）无此限制。
-
-## 解析优先级
-
-```
-1. relation `responseMode`
-2. agent `responseMode`
-3. defaults `responseMode`
-4. 注册表首选模式
-```
-
-## 权限
-
-| 操作 | 私聊 | 群聊 |
-|------|------|------|
-| list/current/info/config 查看 | 任何角色 | 任何角色 |
-| set/reset/config set | 对端是「我的 agent」时 owner 可改 | owner 可改「我的在群 agent」 |
-
-## 通用约定
-
-- `--format json` 所有子命令通用
-- 本命令操作本地配置，不连 AUN 网络
-- 改某作用域后，对应范围所有会话的下一条消息即时生效
-- 完整说明见 `docs/response-system/command-reference.md`
+# ec response — 响应模式管理命令集
+
+按作用域查看/切换/配置会话的响应模式。触发词：切换响应模式/列响应模式/看当前模式/改响应配置/响应模式详情。
+
+> 响应模式决定「收到消息怎么处理 + 怎么回复」。不同模式适用不同场景（人机单聊、Agent 对话、繁忙群、任务群等）。
+> 与模型选择正交：response 改的是响应策略，menu 或 slash `/model` 改的是使用哪个模型。
+
+## 命令
+
+```bash
+# 列出所有响应模式（含适用场景）
+ec response list
+
+# 显示当前作用域生效的默认模式 + 配置
+ec response current [--self <aid>] [--peer <X>]
+
+# 查看单个模式详情（场景/配置参数）
+ec response info <mode-id>
+
+# 设置当前作用域的响应模式
+ec response set <mode-id> --self <aid> [--peer <X>]
+
+# 清除指定作用域的 responseMode 和 responseModeParams 设置
+ec response reset --self <aid> [--peer <X>]
+
+# 查看模式配置参数
+ec response config [<mode-id>] [--self <aid>] [--peer <X>]
+
+# 修改模式配置参数
+ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
+```
+
+## 内置模式
+
+| 模式 id | 显示名 | 场景 | 用途 |
+|---------|--------|------|------|
+| `single-session` | 单会话模式 | 私聊/群聊 | 单会话直接处理；具体投递方式由 `chatmode` 的 `interactive` / `proactive` 决定 |
+
+当前注册表只内置 `single-session`。历史的 `interactive` / `proactive` 已合并为该模式下的
+`chatmode` 流程，不再是可传给 `ec response set` 的 mode id。
+
+## 作用域（越具体越优先：关系 > agent > 全局）
+
+| 参数 | 作用域 | 落盘 |
+|------|--------|------|
+| `--self <aid>` | agent 级 | `config.json` 的 `responseMode` / `responseModeParams` |
+| `--self <aid> --peer <X>` | 关系级 | `relations/<peerKey>/config.json` 的 `responseMode` / `responseModeParams` |
+
+`--peer` 取 `channelType#channelId` 或裸 aid（裸 aid 视为 `aun#<aid>`）。
+
+> **写操作必须 --self**：响应模式是行为参数，从 agent 级起步，全局默认（defaults）不承载。
+> 读操作（list/info/current/config 查看）无此限制。
+
+## 解析优先级
+
+```
+1. relation `responseMode`
+2. agent `responseMode`
+3. defaults `responseMode`
+4. 注册表首选模式
+```
+
+## 权限
+
+| 操作 | 私聊 | 群聊 |
+|------|------|------|
+| list/current/info/config 查看 | 任何角色 | 任何角色 |
+| set/reset/config set | 对端是「我的 agent」时 owner 可改 | owner 可改「我的在群 agent」 |
+
+## 通用约定
+
+- `--format json` 所有子命令通用
+- 本命令操作本地配置，不连 AUN 网络
+- 改某作用域后，对应范围所有会话的下一条消息即时生效
+- 完整说明见 `docs/response-system/command-reference.md`

package/kits/docs/evolcore/rpc.md

@@ -1,37 +1,37 @@
-# ec rpc — 底层 AUN RPC 调用
-
-直接调用 AUN 协议方法的逃生通道。触发词：直接调协议方法/批量 RPC。
-
-> 常规消息收发用 `ec msg` / `ec group`，文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
-
-## 用法
-
-```bash
-ec rpc --as <aid> --params <params>
-```
-
-- `--as <aid>` — 以哪个本地 AID 身份发起调用
-- `--params` — 调用参数，自动判断输入形式：
-  - 单行 JSON（以 `{` 开头）→ 单次调用
-  - 多行 JSONL → 逐行执行，失败即停
-  - 文件路径（文件存在）→ 读取文件内容作为 JSONL
-- `--app <name>` — 指定独立消费 slot，仅对 `message.pull` / `group.pull` 等消费类方法有意义
-- `--aun-path <path>` — 指定 AUN keystore 根
-
-每行 JSON 格式：`{"method":"<namespace.method>","params":{...}}`
-
-## 示例
-
-```bash
-# 单次调用
-ec rpc --as alice.agentid.pub --params '{"method":"message.send","params":{"to":"bob.agentid.pub","payload":{"type":"text","text":"hello"}}}'
-
-# 批量（从文件读 JSONL）
-ec rpc --as alice.agentid.pub --params calls.jsonl
-```
-
-输出为每次调用的 JSON 结果（批量则逐行输出）。
-
-## 命名空间速查
-
-完整协议命名空间（auth/message/group/storage/stream/meta 等）见 `$KITS_DOCS/aun/CHEATSHEET.md`；完整协议文档 Read `$AUN_PROTOCOL_DOCS`。
+# ec rpc — 底层 AUN RPC 调用
+
+直接调用 AUN 协议方法的逃生通道。触发词：直接调协议方法/批量 RPC。
+
+> 常规消息收发用 `ec msg` / `ec group`，文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
+
+## 用法
+
+```bash
+ec rpc --as <aid> --params <params>
+```
+
+- `--as <aid>` — 以哪个本地 AID 身份发起调用
+- `--params` — 调用参数，自动判断输入形式：
+  - 单行 JSON（以 `{` 开头）→ 单次调用
+  - 多行 JSONL → 逐行执行，失败即停
+  - 文件路径（文件存在）→ 读取文件内容作为 JSONL
+- `--app <name>` — 指定独立消费 slot，仅对 `message.pull` / `group.pull` 等消费类方法有意义
+- `--aun-path <path>` — 指定 AUN keystore 根
+
+每行 JSON 格式：`{"method":"<namespace.method>","params":{...}}`
+
+## 示例
+
+```bash
+# 单次调用
+ec rpc --as alice.agentid.pub --params '{"method":"message.send","params":{"to":"bob.agentid.pub","payload":{"type":"text","text":"hello"}}}'
+
+# 批量（从文件读 JSONL）
+ec rpc --as alice.agentid.pub --params calls.jsonl
+```
+
+输出为每次调用的 JSON 结果（批量则逐行输出）。
+
+## 命名空间速查
+
+完整协议命名空间（auth/message/group/storage/stream/meta 等）见 `$KITS_DOCS/aun/CHEATSHEET.md`；完整协议文档 Read `$AUN_PROTOCOL_DOCS`。

package/kits/docs/evolcore/self-summary.md

@@ -1,29 +1,29 @@
-# 自我总结流程指南
-
-自我总结是 agent 的自省行为——在会话结束或空闲时，回顾本次交互，提炼值得记住的信息。
-
-## 触发时机
-
-- 会话结束时（`on_session_end: true`）
-- 空闲超过 N 分钟（`on_idle_minutes: 30`）
-- 每日定时（`daily_at: "03:00"`）
-- 每周定时（`weekly_on: "Sunday"`）
-
-## 总结目标
-
-| 目标层 | 写入位置 | 内容 |
-|---|---|---|
-| 事件性记忆 | `personal/memory/episodic.jsonl` | "我经历了什么"——关键事件、决策、结果 |
-| 语义性记忆 | `personal/memory/semantic.md` | 习得的事实、规律、结论 |
-| 当前关注 | `personal/memory/working.md` | 短期关注点（下次会话开始时加载） |
-| 反思日志 | `personal/journal.jsonl` | 关键决策的复盘、自我修订 |
-
-## 预算控制
-
-- `max_tokens_per_day: 50000`——每日总结消耗的 token 上限
-- 超出预算时跳过本次总结，记录到 `self_summary_failures.jsonl`
-
-## 去重
-
-- episodic.jsonl 按时间窗口去重（同一小时内的重复事件合并）
-- semantic.md 由 LLM 判断是否已有等价结论
+# 自我总结流程指南
+
+自我总结是 agent 的自省行为——在会话结束或空闲时，回顾本次交互，提炼值得记住的信息。
+
+## 触发时机
+
+- 会话结束时（`on_session_end: true`）
+- 空闲超过 N 分钟（`on_idle_minutes: 30`）
+- 每日定时（`daily_at: "03:00"`）
+- 每周定时（`weekly_on: "Sunday"`）
+
+## 总结目标
+
+| 目标层 | 写入位置 | 内容 |
+|---|---|---|
+| 事件性记忆 | `personal/memory/episodic.jsonl` | "我经历了什么"——关键事件、决策、结果 |
+| 语义性记忆 | `personal/memory/semantic.md` | 习得的事实、规律、结论 |
+| 当前关注 | `personal/memory/working.md` | 短期关注点（下次会话开始时加载） |
+| 反思日志 | `personal/journal.jsonl` | 关键决策的复盘、自我修订 |
+
+## 预算控制
+
+- `max_tokens_per_day: 50000`——每日总结消耗的 token 上限
+- 超出预算时跳过本次总结，记录到 `self_summary_failures.jsonl`
+
+## 去重
+
+- episodic.jsonl 按时间窗口去重（同一小时内的重复事件合并）
+- semantic.md 由 LLM 判断是否已有等价结论