evolcore 0.0.2 → 0.0.4

package/kits/docs/evolcore/agent.md

@@ -10,6 +10,8 @@ ec agent list
 
 # 查看 agent 详情（身份 + 配置 + 连接 + 会话 + 路径）
 ec agent show <aid>
+# 简写，等价于 show
+ec agent <aid>
 
 # 创建 agent（交互式）
 ec agent new [aid]
@@ -27,6 +29,12 @@ ec agent disable <aid>
 ec agent get <aid> <key>
 ec agent set <aid> <key> <val>
 
+# 修改 agent.md 显示名称
+ec agent rename <aid> "<name>"
+
+# 标记 bootstrap 完成，进入 active 状态
+ec agent ready <aid>
+
 # 热重载配置（无参数 = 全量 resync：扫磁盘，新增上线/删除下线/修改热更新）
 ec agent reload [aid]
 
@@ -65,5 +73,5 @@ ec agent delete <aid> [--purge]
 
 ## 通用约定
 
-- `--format json` — 输出 JSON
+- `--format json` — 用于 `list/show/new/enable/disable/get/set/rename/ready/reload/delete` 的结构化输出
 - `--help` / `-h` — 各子命令均支持，查看详细用法

package/kits/docs/evolcore/aid.md

@@ -12,7 +12,7 @@ ec aid list [筛选选项] [--no-verify]
 ec aid show <aid>
 
 # 创建新 AID 身份
-ec aid new <aid>
+ec aid new <aid> [--force]
 
 # 远程探测 AID（是否存在 + 网关 + agent.md）
 ec aid lookup <aid>
@@ -42,8 +42,11 @@ ec aid delete <aid>
 - `ec aid delete --orphan` — 清理无私钥的外部 AID 缓存
 - `ec aid delete --no-cert` — 清理无私钥也无公钥证书的孤儿目录
 - `ec aid delete --unrecoverable` — 清理云端公钥已变更、本地不可恢复的 AID
+- `--skip-pki` — 仅用于 `--unrecoverable`，跳过 PKI 探测并按本地自检结果判断；有误删风险
 
 ## 通用约定
 
-- `--format json` — 输出 JSON
+- `--format json` — 对支持结构化结果的子命令输出 JSON
+- `--aun-path <path>` — 指定 AUN keystore 根；未传时可由 `AUN_HOME` 提供
+- `aid delete --orphan|--no-cert|--unrecoverable` 默认 dry-run，`--yes` 才执行删除
 - `--help` / `-h` — 各子命令均支持

package/kits/docs/evolcore/config.md

@@ -3,7 +3,7 @@
 按作用域读写所有配置参数 + 配置快照/回滚/启动历史。触发词：看配置/改配置/查字段/列配置/校验配置/快照/回滚/历史/对比版本/启动记录。
 
 > `ec config` 是配置读写的统一 CLI 入口；模型交互由 menu 协议和 slash `/model` 提供。
-> 字段按 owner 路由：H 字段写 daemon/defaults/config，HA 行为字段写行为配置。
+> 字段由共享 field policy 决定路由、值类型和访问级别；同一套规则用于 CLI、Menu 和 agent-tool。
 
 ## 参数读写
 
@@ -114,7 +114,8 @@ ec config schema <name> [version]
 | `--process` | 进程级 | `~/.evolcore/daemon.json` |
 | 写操作三者全无 | — | **拒绝**（防误写全局） |
 
-`--peer` 取 `channelType#channelId` 或裸 aid（裸 aid 视为 `aun#<aid>`）。改某作用域后，对应范围所有会话的下一条消息即时生效。
+`--peer` 取 `channelType#channelId` 或裸 aid（裸 aid 视为 `aun#<aid>`）。配置提交后开始处理的新
+turn 使用新值；提交前已经开始的 turn 不被打断。
 
 ## 覆盖链
 
@@ -124,6 +125,49 @@ defaults → agent/config → relation/config
 
 ConfigManager 只合并上述物理层并返回物理来源。角色策略不进入配置合并链：`permissionMode` 和 `baseagents.*.model` 由消费方按当前角色单独应用。
 
+### Agent 消息准入策略
+
+消息准入策略保存在 `agents/<aid>/config.json` 的 `access` 字段，但它是 Agent 自身的安全边界，
+不参与 defaults/relation 有效覆盖：
+
+```json
+{
+  "access": {
+    "policyMode": "contacts",
+    "allowedGroupChannels": [],
+    "requestLimit": { "maxTimes": 600, "coolDown": 3600 }
+  }
+}
+```
+
+`policyMode` 为 `open | contacts | owners-only`；`allowedGroupChannels` 使用完整渠道实例键，空数组表示
+关闭全部群聊渠道；`coolDown` 单位为秒。该对象由 Connect 的访问设置入口整体修改并与 Agent Owner、
+已启用渠道实例共同校验，不通过通用 relation/defaults 覆盖链放宽。
+
+### AUN 群规则加载策略
+
+`groupRules.mode` 可设为 `load` 或 `ignore`，缺省为 `load`。该字段仅存在于 Agent 和 relation
+层，relation 可覆盖 Agent 默认值，`--default` 不支持。
+
+```bash
+# Agent 默认值
+ec config set groupRules.mode ignore --self bot.agentid.pub
+
+# 当前群覆盖
+ec config set groupRules.mode load \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub
+
+# 查看有效值和来源 / 删除群覆盖
+ec config get groupRules.mode \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub --format json
+ec config unset groupRules.mode \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub
+```
+
+`ignore` 表示运行时不访问远端群规则、不读本地物化文件、不注入规则正文，但不删除缓存，也不影响
+`ec group rules` 的远端管理命令。配置切换不会自动创建或清空会话。Claude/Codex 从后续新 turn
+按当前值重新组装上下文；其他 runner 的 Menu 写入结果会提示新建或清空群会话后生效。
+
 ## 权限控制
 
 **写权限**（API 层判定）：
@@ -131,6 +175,7 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
 - **角色专用入口**：`roles/index.json` 与 `roles/{roleId}.json` 由角色服务维护；relation 的
   `role` 由角色分配服务维护；`permissionMode` 仅在角色策略中维护
 - **兼容字段**：`enable_rich_content` 仍可读取旧值，但已废弃且不再产生运行时效果
+- **群规则策略**：`groupRules.mode` 仅 Agent owner 或 daemon owner 可 set/unset；其他角色可读取当前 relation 的有效值
 - **仅人可写**：channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
 - Agent 托管环境写仅人字段被拒
 

package/kits/docs/evolcore/contact.md

@@ -0,0 +1,61 @@
+# ec contact — Agent 联系人与访问控制
+
+`ec contact` 管理指定 Agent 的 Contact Book v3。它只接受 AUN AID 主键；拉黑的是该 canonical AID，
+因此会拒绝它在 AUN 以及所有已绑定外部渠道中的私聊入站。角色统一由 relation `config.json role` 管理。
+
+## 命令
+
+```bash
+ec contact block <aid> --self <agent-aid>
+ec contact unblock <aid> --self <agent-aid>
+ec contact list --blocked --self <agent-aid>
+```
+
+所有命令都要求显式 `--self`，支持 `--format json`。
+
+## 约束
+
+- `<aid>` 和 `--self` 必须是合法 AID。
+- 写入 Agent Owner 时，系统会自动创建该 Owner 的 active 联系人记录。
+- `block/unblock` 只接受已存在的联系人；不存在时返回 `NOT_FOUND`。
+- `block/unblock` 只改变本 Agent 的入站接收策略，不代表对端也拉黑了本 Agent。
+- Agent owner 不能被拉黑。
+- `list --blocked` 只列出当前 blocked contact，并返回 `contactRevision`。
+
+## 权限边界
+
+直接从本机终端运行时，这是本地管理命令。
+
+从 Agent 活动任务执行时，CLI 不直接写文件，而是携带当前 session delegation token 调用 daemon `contact.op`：
+
+| 操作 | owner | admin | 普通角色 |
+|---|---:|---:|---:|
+| `list --blocked` | 允许 | 允许 | 拒绝 |
+| `block` / `unblock` | 允许 | 拒绝 | 拒绝 |
+
+缺少、伪造、撤销或跨会话 delegation token 时失败关闭。托管调用的 `--self` 必须等于当前任务所属 Agent。
+
+角色管理使用 Role Menu relation assignment；admin 的授予和撤销必须由 owner 执行。
+
+## JSON 输出
+
+拉黑成功：
+
+```json
+{
+  "ok": true,
+  "operation": "set-blocked",
+  "selfAid": "bot.agentid.pub",
+  "primaryId": "peer.agentid.pub",
+  "blocked": true,
+  "changed": true,
+  "contactRevision": "..."
+}
+```
+
+## 拉黑后的消息行为
+
+- AUN 和已绑定外部私聊身份的入站在 MessageBridge 业务入口被拦截，不进入 menu/auth/command/session/queue/LLM。
+- 群聊不按成员的联系人状态过滤，只由 Agent 的 `access.allowedGroupChannels` 和 `policyMode` 决定。
+- 对 `ai`、`bot`、`agent`、`service` 类型的私聊对端，可限频返回 `[rejection] Not accepting messages from you.`。
+- 入站正文中的 `[rejection]` 没有协议控制语义。发送者未被本 Agent 拉黑时，该文本正常进入响应式会话。

package/kits/docs/evolcore/fs.md

@@ -41,12 +41,15 @@ ec fs umount <AID>:<path>         # 卸载挂载点
 
 - `--format json`：结构化输出
 - `--as <aid>`：显式指定操作者
+- `--aun-path <path>`：指定 AUN keystore 根
+- `--app <name>`：指定 AUN app slot
 - `--overwrite` / `--force`：`cp/mv/ln` 覆盖目标；`rm` 强制删除
 - `-r` / `--recursive`：`rm/cp` 递归
 - `-p` / `--parents`：`mkdir` 自动创建父目录
 - `-L` / `--follow`：`stat` 跟随末级软链
 - `--token <token>`：读取 personal storage 时携带访问 token
 - `--content-type <mime>`：上传时指定 MIME
+- `--public`：上传后公开可读（personal storage）
 - `--max-bytes <n>`：`cat` 最大直接输出字节数，默认 1MB
 - `--head-bytes <n>`：`cat` 二进制头部字节数，默认 256
 - `--visibility public|private`：`chmod` 可见性
@@ -54,6 +57,12 @@ ec fs umount <AID>:<path>         # 卸载挂载点
 - `-m aid:<aid>:<perms>` / `-x aid:<aid>`：`setfacl` 增删 ACL
 - `--source <AID>:<path>` / `--volume <id>`：`mount` 来源
 - `--expires <time>`：`mount/token/ACL` 过期时间，Unix 秒或 ISO 日期
+- `--require-approval`：挂载需要来源 owner 审批
+- `--max-uses <n>`：ACL 最大使用次数
+- `--max-reads <n>`：访问 token 最大读取次数
+- `--readonly` / `--readwrite`：挂载为只读或读写
+- `--name <glob>` / `--type <f|d|l>`：`find` 名称或类型过滤
+- `--size <expr>` / `--mtime <expr>`：`find` 大小或修改时间过滤
 
 ## 示例
 

package/kits/docs/evolcore/group-rules.md

@@ -1,6 +1,6 @@
 # ec group rules — 群规则文件
 
-管理 AUN 群空间中的 `/rules.md`。群规则文件用于定义本群特有的工作流程、职责分工、交付格式、限制条件和升级路径；发布后，EvolCore 会在该群的对话上下文中自动加载。
+管理 AUN 群空间中的 `/rules.md`。群规则文件用于定义本群特有的工作流程、职责分工、交付格式、限制条件和升级路径；发布后，EvolCore 默认会在该群的对话上下文中加载，本地 Agent 也可用 `groupRules.mode` 选择忽略。
 
 以自己的 AID 为操作者 `<from>`，群 AID 为 `<group-id>`。
 
@@ -30,6 +30,44 @@ ec group rules <from> <group-id> publish
 
 所有命令均支持 `--format json`。
 
+## 本地加载策略
+
+`ec group rules get/set/publish` 管理远端群规则；`groupRules.mode` 管理当前 Agent 是否把远端规则
+读取并注入上下文。两者互不替代。策略支持 Agent 默认值和当前群 relation 覆盖，优先级为：
+
+```text
+Agent groupRules.mode -> 当前群 relation groupRules.mode -> 缺省 load
+```
+
+```bash
+# 当前群的有效策略与来源
+ec config get groupRules.mode \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub --format json
+
+# 只忽略当前群；重新设为 load 可恢复
+ec config set groupRules.mode ignore \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub
+ec config set groupRules.mode load \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub
+
+# 删除当前群覆盖，回落 Agent 默认值或缺省 load
+ec config unset groupRules.mode \
+  --self bot.agentid.pub --peer aun#g-team.agentid.pub
+
+# 设置 Agent 默认策略；只能从允许 Agent 级写入的私聊或控制面执行
+ec config set groupRules.mode ignore --self bot.agentid.pub
+```
+
+`groupRules.mode` 只能由 Agent owner 或 daemon owner 修改，其他角色仍可读取当前 relation 的有效值。
+在群聊中，即使 owner 也只能修改当前群 relation，不能修改 Agent 默认值。命令沿用既有
+`ec config set/unset` 的授权、selector 和输出语义，不新增 Menu 协议。
+
+`ignore` 从配置提交后开始处理的新 turn 生效，并保证不访问远端规则、不读取本地
+`rules.md`、不注入规则正文；旧物化文件会保留，但不能作为回退来源。切回 `load` 后仍须重新完成
+远端元数据校验。配置切换不会清空、新建或 fork 会话，也不会删除已进入恢复会话历史的旧内容。
+Claude/Codex 的后续 turn 会按新策略重新组装上下文；其他 runner 仍保存配置，但 Menu 成功输出会
+提示新建或清空该群会话后生效。
+
 ## 推荐流程
 
 日常更新直接使用 `set`：
@@ -160,6 +198,7 @@ ec group rules bot.agentid.pub g-team.agentid.pub get --format json
 | status | 含义 | 是否加载 |
 |--------|------|----------|
 | `ok` | `get/set/publish` 校验或发布成功 | 是 |
+| `ignored` | 当前 Agent 的 `groupRules.mode=ignore`，本轮未访问远端或本地规则 | 否 |
 | `synced` | 运行时已刷新并物化本地规则 | 是 |
 | `cached` | 本地物化文件仍与已发布元信息一致 | 是 |
 | `missing` | 未发布规则，或 `/rules.md` 不存在 | 否 |
@@ -181,16 +220,19 @@ ec group rules bot.agentid.pub g-team.agentid.pub get --format json
 校验成功后，本地物化为：
 
 ```text
-$VENUES_DIR/<channel>#<urlEncode(groupId)>/rules.md
+$RELATIONS_DIR/<channel>#<urlEncode(groupId)>/rules.md
 ```
 
 AUN 示例：
 
 ```text
-$AGENT_DIR/venues/aun#g-team.agentid.pub/rules.md
+$AGENT_DIR/relations/aun#g-team.agentid.pub/rules.md
 ```
 
-该本地文件属于群环境层，而不是关系层。它只是远端规则的物化副本，不应直接编辑。只有当前处理轮次验证通过并设置 `groupRulesPath` 时，ECK manifest 才会把它注入 system context。
+该本地文件属于**关系层**（群是对端的一种，见 `kits/rules/04-relation.md`），落在
+`agentRelationsDir(selfAid)/<peerKey>/rules.md`（`src/eck/group-rules-sync.ts` 的 `relationPaths`）。
+`$VENUES_DIR` 下的同名文件是已删除模块 `group-venue-sync.ts` 的历史残留，不再有效。
+它只是远端规则的物化副本，不应直接编辑。只有当前处理轮次验证通过并设置 `groupRulesPath` 时，ECK manifest 才会把它注入 system context。
 
 ## 排障
 

package/kits/docs/evolcore/group.md

@@ -10,13 +10,13 @@
 
 ```bash
 # 文本（含空格/换行/特殊字符时用引号包起来；纯短词可不包，但多空格会被压成一个）
-ec group send <from> <group-id> "<text>" [--encrypt]
+ec group send <from> <group-id> "<text>" --return none|required [--encrypt]
 
 # 文件（--as image|video|voice|file）
-ec group send <from> <group-id> --file <path> [--as <type>] [--text "<说明>"]
+ec group send <from> <group-id> --file <path> --return none|required [--as <type>] [--text "<说明>"]
 
 # 自定义 payload
-ec group send <from> <group-id> --payload '<json>'
+ec group send <from> <group-id> --payload '<json>' --return none|required
 
 # 拉取群消息（建议带 --app 独立消费通道，避免影响 daemon）
 ec group pull <from> <group-id> [--after-seq <N>] [--limit <N>] [--app <name>]
@@ -38,11 +38,19 @@ ec group send <from> <group-id> "通知" --mention alice.agentid.pub,bob.agentid
 > 若正文**精确等于**某个 flag 名（如要发送文本 `--encrypt`），用 `--` 分隔：
 > `ec group send <from> <group-id> -- --encrypt`
 
+发送选项还包括：
+
+- `--no-encrypt`：强制明文，优先于 `--encrypt`
+- `--thread <id>`：指定话题 ID
+- `--return <none|required>`：跨会话发送必填；Trigger 任务只能使用 `none`
+- `--content-type <mime>`：覆盖文件 MIME
+- `--transcript <text>`：语音转写，仅 `--as voice`
+
 ## 群管理
 
 ```bash
 # 创建群
-ec group create <from> "<name>" [--visibility public|private] [--description "<desc>"] [--join-mode <mode>]
+ec group create <from> "<name>" [--visibility public|private] [--description "<desc>"] [--join-mode <mode>] [--group-id <aid>]
 
 # 列出我加入的群
 ec group list <from> [--size <N>]
@@ -126,8 +134,9 @@ ec group unban <from> <group-id> <member-aid>
 ## 通用约定
 
 - `<from>` 必须是合法 AID（入口统一校验，格式错直接报错）
-- `--format json` — 所有子命令通用
-- `--app <name>` — 指应用 slot（独立消费通道，不影响 daemon）
+- `--format json` — 对支持结构化结果的子命令输出 JSON
+- `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
+- `--aun-path <path>` — 指定 AUN keystore 根
 - `--encrypt` — 仅 send，启用端到端加密（群聊默认明文）
 - `create` 会通过 SDK 自动生成并导入群 `group_aid` 身份。
 - `owner` 会走 SDK 的群主转让授权签名流程，需要本机有该群 `group_aid` 的私钥；若网关返回 `pending_rekey`，CLI 会在本机存在新群主私钥时自动调用完成步骤，否则输出“已发起，等待新群主完成 rekey”。

package/kits/docs/evolcore/model.md

@@ -14,7 +14,7 @@ ec model current [--self <aid>] [--peer <peer>] [--role <role>]
 # 查看单个模型详情
 ec model info <model-id> [--self <aid>]
 
-# 设置模型，可同时设置推理强度
+# 设置模型，可同时设置推理强度；本机终端写操作需要 --self
 ec model use <model-id> --self <aid> [--peer <peer>] [--effort <level>]
 
 # 设置推理强度：low | medium | high | xhigh | max | auto
@@ -38,6 +38,9 @@ ec model check [--self <aid>]
 
 生效优先级为关系、角色、agent、defaults。`--peer` 可使用 `channelType#channelId`；裸 AID 按 `aun#<aid>` 处理。
 
+在 EvolCore 托管会话中，省略 `--self`、`--peer`、`--role` 时，`list/current/use/effort/reset`
+会通过 `ec ctl` 作用于当前会话；显式 selector 仍按上表访问持久化作用域。本机终端不具备该隐式当前会话语义。
+
 ## 输出与权限
 
 - 所有子命令支持 `--format json`。

package/kits/docs/evolcore/msg.md

@@ -8,13 +8,16 @@
 
 ```bash
 # 文本（明文）
-ec msg send <from> <to> "<text>"
+ec msg send <from> <to> "<text>" --return none|required
 
 # 从文件读取文本内容（用于超长消息或避免 Shell 转义）
-ec msg send <from> <to> --text-from-file <path>
+ec msg send <from> <to> --text-from-file <path> --return none|required
 
 # 文本（密文 E2EE）
-ec msg send <from> <to> "<text>" --encrypt
+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>]
@@ -29,7 +32,9 @@ ec msg send <from> <to> --payload '<json>'
 发送相关选项：
 - `--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`）
@@ -107,10 +112,11 @@ ec msg history <self-aid> <target-aid> \
 
 `sessionId` 是 EvolCore 本地逻辑会话 ID，不是 Claude/Codex 等后端的会话 ID。
 
-## 通用约定
+## 共享选项
 
-- `--format json` — 所有子命令通用，输出 JSON
-- `--app <name>` — 指定应用 slot
+- `--format json` — 对支持结构化结果的子命令输出 JSON
+- `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
+- `--aun-path <path>` — 指定 AUN keystore 根
 
 ## 自主回复策略
 

package/kits/docs/evolcore/response.md

@@ -9,7 +9,7 @@
 
 ```bash
 # 列出所有响应模式（含适用场景）
-ec response list [--scene private|group]
+ec response list
 
 # 显示当前作用域生效的默认模式 + 配置
 ec response current [--self <aid>] [--peer <X>]
@@ -17,10 +17,10 @@ ec response current [--self <aid>] [--peer <X>]
 # 查看单个模式详情（场景/配置参数）
 ec response info <mode-id>
 
-# 设置默认模式（--scene 指定 private/group）
-ec response set <mode-id> --self <aid> [--peer <X>] [--scene private|group]
+# 设置当前作用域的响应模式
+ec response set <mode-id> --self <aid> [--peer <X>]
 
-# 清除指定作用域的 response_modes 设置
+# 清除指定作用域的 responseMode 和 responseModeParams 设置
 ec response reset --self <aid> [--peer <X>]
 
 # 查看模式配置参数
@@ -30,39 +30,34 @@ ec response config [<mode-id>] [--self <aid>] [--peer <X>]
 ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
 ```
 
-## 内置模式（10 种）
+## 内置模式
 
 | 模式 id | 显示名 | 场景 | 用途 |
 |---------|--------|------|------|
-| `interactive` | 交互模式 | 私聊 | 输出即回复，人机单聊默认 |
-| `proactive` | 主动模式 | 私聊/群聊 | 工具调用才回复，Agent 对话默认 |
-| `dual-session` | 双会话模式 | 群聊 | 辅助会话判断相关性，繁忙群过滤 |
-| `thread-tracking` | 线索追踪 | 群聊 | 追踪对话线索，多话题群 |
-| `workflow` | 工作流模式 | 群聊 | 顺序处理任务，任务群 |
-| `context-enhanced` | 上下文增强 | 群聊 | 注入群规则文档，工作群 |
-| `batch-processing` | 批量处理 | 群聊 | 攒批节省资源，低优先级群 |
-| `selective-response` | 选择性响应 | 群聊 | 白名单/关键词过滤 |
-| `rate-limited` | 速率限制 | 私聊/群聊 | 控制响应频率，防刷屏 |
-| `autonomous` | 自主模式 | 私聊/群聊 | 触发器驱动，定时任务 |
+| `single-session` | 单会话模式 | 私聊/群聊 | 单会话直接处理；具体投递方式由 `chatmode` 的 `interactive` / `proactive` 决定 |
+
+当前注册表只内置 `single-session`。历史的 `interactive` / `proactive` 已合并为该模式下的
+`chatmode` 流程，不再是可传给 `ec response set` 的 mode id。
 
 ## 作用域（越具体越优先：关系 > agent > 全局）
 
 | 参数 | 作用域 | 落盘 |
 |------|--------|------|
-| `--self <aid>` | agent 级 | `config.json` 的 response_modes |
-| `--self <aid> --peer <X>` | 关系级 | `relations/<peerKey>/config.json` 的 response_modes |
+| `--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**：response_modes 是行为参数，从 agent 级起步，全局默认（defaults）不承载。
+> **写操作必须 --self**：响应模式是行为参数，从 agent 级起步，全局默认（defaults）不承载。
 > 读操作（list/info/current/config 查看）无此限制。
 
 ## 解析优先级
 
 ```
-1. overrides[peerKey]          （特定对端/群指定模式）
-2. default_private/default_group （chatType 默认）
-3. 系统兜底（private→interactive, group→proactive）
+1. relation `responseMode`
+2. agent `responseMode`
+3. defaults `responseMode`
+4. 注册表首选模式
 ```
 
 ## 权限

package/kits/docs/evolcore/rpc.md

@@ -15,6 +15,8 @@ ec rpc --as <aid> --params <params>
   - 单行 JSON（以 `{` 开头）→ 单次调用
   - 多行 JSONL → 逐行执行，失败即停
   - 文件路径（文件存在）→ 读取文件内容作为 JSONL
+- `--app <name>` — 指定独立消费 slot，仅对 `message.pull` / `group.pull` 等消费类方法有意义
+- `--aun-path <path>` — 指定 AUN keystore 根
 
 每行 JSON 格式：`{"method":"<namespace.method>","params":{...}}`
 

package/kits/docs/evolcore/stats.md

@@ -15,7 +15,7 @@ ec stats --today
 ec stats --hour              # 最近 24h，按小时分组
 ec stats --week              # 本周
 ec stats --month             # 本月
-ec stats --range 2026-05-01 2026-06-01   # 任意区间
+ec stats --from 2026-05-01 --to 2026-06-01   # 任意区间
 ```
 
 ## 按维度过滤（可组合）
@@ -51,6 +51,19 @@ ec stats --traffic --by peer         # 按对端分组流量
 ec stats --traffic --week            # 本周流量
 ```
 
+## 运维与结构化视图
+
+```bash
+ec stats --peers [--limit 50]
+ec stats --groups [--limit 50]
+ec stats --summary
+ec stats --peer-detail <aid|peer-key>
+ec stats --task-calls <task-id>
+ec stats --session-calls <session-id>
+ec stats --session <session-id> --last
+ec stats --rebuild
+```
+
 ## 直接 SQL 查询
 
 ```bash
@@ -67,4 +80,4 @@ ec stats --sql "SELECT model, COUNT(*) AS cnt FROM usage_events GROUP BY model"
 ## 通用选项
 
 - `--help`, `-h`：显示帮助
-- `--format json`：JSON 输出（所有命令集通用约定）
+- `--format json`：本命令的 JSON 输出

package/kits/docs/evolcore/storage.md

@@ -47,3 +47,4 @@ ec storage quota myaid.agentid.pub
 ## 通用约定
 
 - `--format json` — 输出 JSON
+- `--aun-path <path>` — 指定 AUN keystore 根