evolcore 0.0.2 → 0.0.3

package/kits/docs/evolcore/msg.md

@@ -16,6 +16,9 @@ ec msg send <from> <to> --text-from-file <path>
 # 文本（密文 E2EE）
 ec msg send <from> <to> "<text>" --encrypt
 
+# 强制明文（同时出现时优先于 --encrypt）
+ec msg send <from> <to> "<text>" --no-encrypt
+
 # 文件：--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 <required|none>` — 跨会话回流策略；跨会话默认 `required`
 - `--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 根

package/kits/docs/evolcore/trigger.md

@@ -34,6 +34,16 @@ ec trigger history [triggerId] --limit 500 --json
 
 ## 创建
 
+创建操作统一使用 `create`：
+
+| 入口 | 正式命令 | 兼容别名 |
+| --- | --- | --- |
+| CLI | `ec trigger create ...` | `ec trigger set ...` |
+| Slash | `/trigger create ...` | `/trigger set ...` |
+| Menu Protocol | `menu.action name=trigger action=create` | `action=set` |
+
+新调用只使用 `create`；`set` 仅用于兼容旧脚本和旧客户端。三种入口最终都映射到内部操作 `trigger.create`。
+
 Flag 模式适合 agent 现场创建常规 trigger：
 
 ```bash
@@ -147,9 +157,12 @@ script trigger 返回 `[[NOOP]]` 或 `outcome: "noop"` 时走 noop 分支；默
 ```bash
 --model <模型>
 --effort <low|medium|high|xhigh|max>
+--baseagent <claude|codex|gemini>
 ```
 
-`--model` / `--effort` 只覆盖本 trigger 执行时传给 base agent 的模型与推理强度。baseagent 不在 trigger 中指定，始终沿用该 trigger 所属 agent 当前 active baseagent；未设置时继承当前关系级 / agent 级 / 全局模型配置。
+`--model` / `--effort` 只覆盖本 trigger 执行时传给 base agent 的模型与推理强度。
+`--baseagent` 仅支持 `--exec trigger-session`，用于给该 trigger 会话单独选择 base agent；
+`script` 和 `target-session` 不接受该参数。未设置时沿用 trigger 所属 agent 当前 active baseagent。
 
 无人值守 trigger 不适合 `request`。需要写文件、git、安装升级、重启服务、管理 trigger 时应显式使用：
 
@@ -157,7 +170,7 @@ script trigger 返回 `[[NOOP]]` 或 `outcome: "noop"` 时走 noop 分支；默
 --permission bypass
 ```
 
-owner/admin 通过 `/trigger set` 创建时默认使用 `bypass`；非 admin 默认 `readonly`，不能提权到 `bypass`，也不能跨渠道或跨会话指定 target。
+owner/admin 通过 `/trigger create` 创建时默认使用 `bypass`；非 admin 默认 `readonly`，不能提权到 `bypass`，也不能跨渠道或跨会话指定 target。历史 `/trigger set` 仍是兼容别名。
 
 ## 执行边界
 
@@ -177,6 +190,8 @@ ec trigger enable <triggerId>
 ec trigger disable <triggerId>
 ec trigger cancel <triggerId>   # disable 的兼容别名
 ec trigger delete <triggerId>
+ec trigger remove <triggerId>   # delete 的兼容别名
+ec trigger rm <triggerId>       # delete 的兼容别名
 ```
 
 语义区别：

package/kits/eck_manifest.json

@@ -55,6 +55,18 @@
       ] },
       "description": "当前关注（working memory）"
     },
+    {
+      "id": "preferences",
+      "type": "file",
+      "file": "$PERSONAL_DIR/preferences/active-preferences.md",
+      "order": 23,
+      "needsInjection": false,
+      "when": { "and": [
+        { "var": "chatType", "eq": "private" },
+        { "var": "lifecycle", "neq": "bootstrapping" }
+      ] },
+      "description": "用户偏好（自动记忆，仅私聊注入）"
+    },
     {
       "id": "relation-layer",
       "type": "file",