evolcore 0.0.25 → 0.0.27

package/kits/docs/evolcore/stats.md

@@ -1,83 +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 输出
+# 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

@@ -1,50 +1,53 @@
-# 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 根
+# ec storage — 文件存储
+
+AUN 网络上的文件存储：上传、下载、列举、删除、查配额。触发词：上传/下载/存文件/配额。
+
+以自己的 AID 为操作者（`<aid>`）。
+
+上传和删除通过 SDK 文件系统执行；上传自动协商 inline、去重或 session，并统一 MIME 与请求头。
+`--public` 返回稳定的 AID 文件 URL，私有上传不返回公开 URL。日常文件操作优先使用 `ec fs`。
+
+## 子命令
+
+```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 根

package/kits/docs/evolcore/task.md

@@ -0,0 +1,14 @@
+# ec task - 会话任务恢复
+
+`ec task resume` 统一恢复暂停任务和基础设施异常中断任务。它定位已有会话并读取会话持久化的任务、路由、加密和 baseagent 绑定；恢复时继续原 provider 会话。
+
+```text
+ec task resume <sessionId>
+ec task resume <sessionId> --format json
+```
+
+暂停任务会释放原有的工具门控。异常中断任务会把内部恢复提示排入同一会话，并继续原 baseagent 会话。命令只确认恢复请求已被可靠接纳，不会等待模型运行结束。
+
+以下情况会安全结束而不创建新会话：任务已完成或正在运行、任务等待必要输入/审批、会话已删除、原 provider 会话文件不存在、渠道不可用，或任务状态已被更新。
+
+独立 CLI 必须通过 daemon 的本地 control token。托管任务使用当前任务 delegation token，并需要 Agent 管理权限；普通 Agent 只能恢复当前 Agent 的会话，daemon scope 才能恢复其它 Agent 的会话。