evolcore 0.0.1 → 0.0.3

package/kits/docs/evolcore/response.md

@@ -0,0 +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`

package/kits/docs/evolcore/rpc.md

@@ -0,0 +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`。

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

@@ -0,0 +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 判断是否已有等价结论

package/kits/docs/evolcore/stats.md

@@ -0,0 +1,83 @@
+# ec stats — Token 用量与费用统计
+
+查看 token 用量、费用消耗、预算状态、上下文细目。触发词：用量/费用/统计/预算/token/cost/花了多少。
+
+## 查看今日概览
+
+```bash
+ec stats
+ec stats --today
+```
+
+## 按时间段查看
+
+```bash
+ec stats --hour              # 最近 24h，按小时分组
+ec stats --week              # 本周
+ec stats --month             # 本月
+ec stats --from 2026-05-01 --to 2026-06-01   # 任意区间
+```
+
+## 按维度过滤（可组合）
+
+```bash
+ec stats --agent <aid>       # 指定 agent
+ec stats --peer <X>          # 指定对端（裸 AID 自动前缀 aun#）
+ec stats --model <model-id>  # 指定模型
+ec stats --session <id>      # 指定会话
+```
+
+> `--peer` 简写：`alice.aid.pub` 等价于 `aun#alice.aid.pub`；其他渠道需显式写 `feishu#ou_xxx`。
+
+## 聚合粒度
+
+```bash
+ec stats --by hour|day|week|month      # 时间维度
+ec stats --by model                    # 按模型分组
+ec stats --by peer                     # 按对端分组
+ec stats --by agent                    # 按 agent 分组
+```
+
+## 快捷视图
+
+```bash
+ec stats --session <id>              # 会话明细（每轮 token/cost/ctx%）
+ec stats --context <session-id>      # 上下文 breakdown 细目
+ec stats --budget                    # 预算状态（daily + monthly）
+ec stats --top-peers [--limit 10]    # 对端排行
+ec stats --top-models [--limit 10]   # 模型用量排行
+ec stats --traffic                   # 网络流量概览（收发条数/字节数）
+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
+ec stats --sql "SELECT model, COUNT(*) AS cnt FROM usage_events GROUP BY model"
+```
+
+仅允许 SELECT 查询（只读安全）。
+
+## 输出格式
+
+- `--format json`：JSON 输出
+- 默认：彩色终端表格
+
+## 通用选项
+
+- `--help`, `-h`：显示帮助
+- `--format json`：本命令的 JSON 输出

package/kits/docs/evolcore/storage.md

@@ -0,0 +1,50 @@
+# ec storage — 文件存储
+
+AUN 网络上的文件存储：上传、下载、列举、删除、查配额。触发词：上传/下载/存文件/配额。
+
+以自己的 AID 为操作者（`<aid>`）。
+
+## 子命令
+
+```bash
+# 上传文件（默认私有，--public 公开）
+ec storage upload <aid> <local-file> <remote-path> [--public]
+
+# 下载文件
+ec storage download <aid> <url> [local-path]
+
+# 列文件
+ec storage ls <aid> [prefix]
+
+# 删文件
+ec storage rm <aid> <remote-path>
+
+# 查配额
+ec storage quota <aid>
+```
+
+## `<url>` 格式
+
+`[https://]<owner-aid>/<path>` —— 下载可指向自己或他人的公开文件：
+
+```bash
+# 下载自己的文件
+ec storage download myaid.agentid.pub myaid.agentid.pub/notes/doc.txt ./doc.txt
+
+# 下载他人的公开文件
+ec storage download myaid.agentid.pub bob.agentid.pub/public/file.pdf ./file.pdf
+```
+
+## 示例
+
+```bash
+ec storage upload myaid.agentid.pub ./pic.png images/pic.png --public
+ec storage ls myaid.agentid.pub notes/
+ec storage rm myaid.agentid.pub notes/doc.txt
+ec storage quota myaid.agentid.pub
+```
+
+## 通用约定
+
+- `--format json` — 输出 JSON
+- `--aun-path <path>` — 指定 AUN keystore 根