evolcore 0.0.25 → 0.0.26

package/kits/docs/eck_templates/GUIDE.template.md

@@ -1,22 +1,22 @@
-# Agent 查阅指南
-
-本文件是 {{SELF_AID}} 的个人查阅指南。
-
-## 查阅优先级
-
-1. `$KITS_RULES`（自动加载）— ECK 机制骨架
-2. `$AGENT_INDEX/INDEX.md`（本目录）— 个人索引
-3. `$KITS_DOCS/INDEX.md` — evolcore 级文档索引
-4. 按索引中的路径 Read 具体文档
-
-## 路径解析
-
-遇到 `$名称` 时：
-1. 查 `$ECK/path-registry.md` 获取实际路径
-2. 如果实例文件中没有，查 `$KITS_DOCS/path-registry.md` 了解派生规则
-
-## 索引维护
-
-当以下范围内有文档变动时，更新本索引：
-- `{{CURRENT_PROJECT}}`
-- `{{AGENT_DIR}}`
+# Agent 查阅指南
+
+本文件是 {{SELF_AID}} 的个人查阅指南。
+
+## 查阅优先级
+
+1. `$KITS_RULES`（自动加载）— ECK 机制骨架
+2. `$AGENT_INDEX/INDEX.md`（本目录）— 个人索引
+3. `$KITS_DOCS/INDEX.md` — evolcore 级文档索引
+4. 按索引中的路径 Read 具体文档
+
+## 路径解析
+
+遇到 `$名称` 时：
+1. 查 `$ECK/path-registry.md` 获取实际路径
+2. 如果实例文件中没有，查 `$KITS_DOCS/path-registry.md` 了解派生规则
+
+## 索引维护
+
+当以下范围内有文档变动时，更新本索引：
+- `{{CURRENT_PROJECT}}`
+- `{{AGENT_DIR}}`

package/kits/docs/eck_templates/INDEX.template.md

@@ -1,28 +1,28 @@
-# Agent 索引
-
-本文件是 {{SELF_AID}} 的 agent 级文档索引。
-
-## 项目文档
-
-| 文档 | 路径 | 说明 | 最后更新 |
-|------|------|------|----------|
-| — | — | （初始化后由 agent 维护） | — |
-
-## 个人档案
-
-| 文档 | 路径 | 说明 | 最后更新 |
-|------|------|------|----------|
-| 人格档案 | `$SELF_DIR/persona.md` | 行为规范与人格定义 | {{CREATED_AT}} |
-| 工作记忆 | `$SELF_DIR/memory/working.md` | 短期关注点 | {{CREATED_AT}} |
-
-## 关系档案
-
-| 对端 AID | 路径 | 最后交互 |
-|----------|------|----------|
-| — | — | — |
-
-## 场所档案
-
-| 场所 | 路径 | 说明 |
-|------|------|------|
-| — | — | — |
+# Agent 索引
+
+本文件是 {{SELF_AID}} 的 agent 级文档索引。
+
+## 项目文档
+
+| 文档 | 路径 | 说明 | 最后更新 |
+|------|------|------|----------|
+| — | — | （初始化后由 agent 维护） | — |
+
+## 个人档案
+
+| 文档 | 路径 | 说明 | 最后更新 |
+|------|------|------|----------|
+| 人格档案 | `$SELF_DIR/persona.md` | 行为规范与人格定义 | {{CREATED_AT}} |
+| 工作记忆 | `$SELF_DIR/memory/working.md` | 短期关注点 | {{CREATED_AT}} |
+
+## 关系档案
+
+| 对端 AID | 路径 | 最后交互 |
+|----------|------|----------|
+| — | — | — |
+
+## 场所档案
+
+| 场所 | 路径 | 说明 |
+|------|------|------|
+| — | — | — |

package/kits/docs/eck_templates/path-registry.template.md

@@ -1,33 +1,33 @@
-# 路径注册表实例
-
-本文件记录运行时解析出的实际路径值。由 evolcore 初始化时生成。
-
-## 基础路径
-
-| 名称 | 实际路径 |
-|------|----------|
-| `$EVOLCORE_HOME` | {{EVOLCORE_HOME}} |
-| `$PACKAGE_ROOT` | {{PACKAGE_ROOT}} |
-| `$CURRENT_PROJECT` | {{CURRENT_PROJECT}} |
-
-## 派生路径
-
-| 名称 | 实际路径 |
-|------|----------|
-| `$KITS` | {{KITS}} |
-| `$KITS_RULES` | {{KITS_RULES}} |
-| `$KITS_DOCS` | {{KITS_DOCS}} |
-| `$KITS_TEMPLATES` | {{KITS_TEMPLATES}} |
-| `$ECK` | {{ECK}} |
-| `$AGENT_DIR` | {{AGENT_DIR}} |
-| `$SELF_DIR` | {{SELF_DIR}} |
-| `$RELATIONS_DIR` | {{RELATIONS_DIR}} |
-| `$VENUES_DIR` | {{VENUES_DIR}} |
-| `$AGENT_INDEX` | {{AGENT_INDEX}} |
-
-## 外部依赖
-
-| 名称 | 实际路径 | 状态 |
-|------|----------|------|
-| `$KITE` | {{KITE}} | {{KITE_STATUS}} |
-| `$AUN_SDK_CORE` | {{AUN_SDK_CORE}} | {{AUN_SDK_STATUS}} |
+# 路径注册表实例
+
+本文件记录运行时解析出的实际路径值。由 evolcore 初始化时生成。
+
+## 基础路径
+
+| 名称 | 实际路径 |
+|------|----------|
+| `$EVOLCORE_HOME` | {{EVOLCORE_HOME}} |
+| `$PACKAGE_ROOT` | {{PACKAGE_ROOT}} |
+| `$CURRENT_PROJECT` | {{CURRENT_PROJECT}} |
+
+## 派生路径
+
+| 名称 | 实际路径 |
+|------|----------|
+| `$KITS` | {{KITS}} |
+| `$KITS_RULES` | {{KITS_RULES}} |
+| `$KITS_DOCS` | {{KITS_DOCS}} |
+| `$KITS_TEMPLATES` | {{KITS_TEMPLATES}} |
+| `$ECK` | {{ECK}} |
+| `$AGENT_DIR` | {{AGENT_DIR}} |
+| `$SELF_DIR` | {{SELF_DIR}} |
+| `$RELATIONS_DIR` | {{RELATIONS_DIR}} |
+| `$VENUES_DIR` | {{VENUES_DIR}} |
+| `$AGENT_INDEX` | {{AGENT_INDEX}} |
+
+## 外部依赖
+
+| 名称 | 实际路径 | 状态 |
+|------|----------|------|
+| `$KITE` | {{KITE}} | {{KITE_STATUS}} |
+| `$AUN_SDK_CORE` | {{AUN_SDK_CORE}} | {{AUN_SDK_STATUS}} |

package/kits/docs/eck_templates/runtime.template.md

@@ -1,19 +1,19 @@
-# 运行时配置
-
-## 基本信息
-
-- AID: {{SELF_AID}}
-- 名称: {{AGENT_NAME}}
-- 创建时间: {{CREATED_AT}}
-
-## 运行时参数
-
-- 模型: {{MODEL_ID}}
-- 推理强度: {{EFFORT_LEVEL}}
-- 权限模式: {{PERMISSION_MODE}}
-
-## 行为配置
-
-- 自我总结: {{SELF_SUMMARY_ENABLED}}
-- 空闲总结间隔: {{IDLE_SUMMARY_MINUTES}} 分钟
-- 每日总结 token 预算: {{DAILY_SUMMARY_BUDGET}}
+# 运行时配置
+
+## 基本信息
+
+- AID: {{SELF_AID}}
+- 名称: {{AGENT_NAME}}
+- 创建时间: {{CREATED_AT}}
+
+## 运行时参数
+
+- 模型: {{MODEL_ID}}
+- 推理强度: {{EFFORT_LEVEL}}
+- 权限模式: {{PERMISSION_MODE}}
+
+## 行为配置
+
+- 自我总结: {{SELF_SUMMARY_ENABLED}}
+- 空闲总结间隔: {{IDLE_SUMMARY_MINUTES}} 分钟
+- 每日总结 token 预算: {{DAILY_SUMMARY_BUDGET}}

package/kits/docs/evolcore/INDEX.md

@@ -1,71 +1,71 @@
-# EvolCore 命令集目录
-
-所有 `ec` 命令集的专属索引：用途、触发词、适用场景、详细文档。
-运行时 evolcore 会通过 `commands` fragment 按当前场景（有无 peer/group、对端角色）
-注入一张精简能力卡，指向本目录下对应文档；需要完整用法时 Read 对应文档。
-
-> 对外通信命令以自己的 AID 为发送者；当前渠道是否需要 CLI 回复，以运行时注入的
-> `channel` 规则为准。参数不是全局通用的：`--format json` 仅用于对应帮助中明确支持的命令，
-> `--app <name>` 仅用于消息 pull/ack、消费类 RPC 和明确支持 app slot 的文件操作。
-
-## 如何使用本索引
-
-1. **遇到触发词**（用户提到"费用/用量/创建/查群/上传文件"等）→ Ctrl+F 本文档找触发词 → 定位命令集 → Read 对应文档
-2. **不确定有没有命令**时，直接 `ec <猜测的子命令> --help` 试一下（如 `ec stats --help`）
-3. **已知场景需求**（如"要给对端发消息"）→ 看下方分类表 → 定位到对应命令集
-
-## 服务运维类（本地，无需 AUN）
-
-| 命令 | 用途 | 触发词 |
-|------|------|--------|
-| `ec --version` / `-v` / `-V` | 查看版本号 | 版本 |
-| `ec restart` | 重启服务（含自动升级检查） | 重启 |
-| `ec status` | 查看运行状态、进程、会话、渠道连接 | 状态/查看状态 |
-| `ec logs` | 查看日志（`--level` `--module` `--raw` `--no-color`） | 日志/查看日志 |
-| `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
-
-Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSecurityInfoW ... 5`、`unelevated ... cannot enforce deny-read` 或 daemon 管道 `EPERM` 时，参见 `codex-windows-sandbox.md`。
-
-## 对外通信 / 网络类（连 AUN，以 AID 为发送者）
-
-| 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
-|--------|------|--------|----------|------|
-| `ec msg` | 私聊收发消息 | 回复/发消息/拉取/撤回/查在线 | 有对端（peerId） | `msg.md` |
-| `ec group` | 群聊收发与群管理 | 群发/建群/邀请/踢人/退群/群成员/角色/封禁/规则/协作 | 群聊（groupId） | `group.md`；完整协作流程见 `group-collaboration.md` |
-| `ec group rules` | 群规则文件发布与上下文注入 | 群规则/工作流程/职责分工/rules.md/发布规则 | AUN 群聊（groupId） | `group-rules.md` |
-| `ec aid` | AID 身份管理 | 身份/证书/名片/探测对端 | 任意有渠道场景 | `aid.md` |
-| `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
-| `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
-| `ec agent` | EvolAgent 生命周期 | 创建/启停/热重载/改配置 | 管理员（owner/admin） | `agent.md`；完整创建与 Bootstrap 见 `agent-create.md` |
-| `ec contact` | Contact Book 与访问控制 | 申请添加、拉黑/解除拉黑、查拉黑 | Agent 当前私聊可申请添加；管理写操作按角色限制 | `contact.md` |
-| `ec rpc` | 底层 AUN RPC（逃生通道） | 直接调协议方法 | 高级/兜底 | `rpc.md` |
-| `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/daemon 日志/监控/原始配置 | 非托管 eclink/运维主机 | `menu-client.md` |
-
-## 会话自管理类（不连 AUN，操作当前会话）
-
-| 命令集 | 用途 | 触发词 | 文档 |
-|--------|------|--------|------|
-| `ec ctl` | 当前会话工具 | 主动发消息/文件、重命名、队列、项目路径、会话状态 | `ctl.md` |
-
-## 本地工具类（不连 AUN，操作本地配置）
-
-| 命令集 | 用途 | 触发词 | 文档 |
-|--------|------|--------|------|
-| `ec model` | 模型与推理强度管理（按作用域持久化） | 切模型/列模型/当前模型/模型详情/改强度/诊断网关 | `model.md` |
-| `ec response` | 响应模式管理（按作用域持久化） | 切换响应模式/列响应模式/看当前模式/改响应配置 | `response.md` |
-| `ec config` | 配置体系底层入口（读写/快照/回滚） | 看配置/改配置/查字段/查schema/校验/快照/回滚/历史/启动记录 | `config.md` |
-| `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
-| `ec trigger` | 定时与事件触发器管理（创建用 `create`，`set` 为兼容别名） | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
-| `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
-
-## 开发者工具（非 agent 会话能力）
-
-| 命令 | 用途 | 说明 |
-|------|------|------|
-| `ec bench` | AUN 消息系统性能基准测试 | CLI 工具，agent 一般不主动调用；`ec bench --help` 查看用法 |
-
-## 其他
-
-| 文档 | 说明 |
-|------|------|
-| `self-summary.md` | 自我总结流程指南 |
+# EvolCore 命令集目录
+
+所有 `ec` 命令集的专属索引：用途、触发词、适用场景、详细文档。
+运行时 evolcore 会通过 `commands` fragment 按当前场景（有无 peer/group、对端角色）
+注入一张精简能力卡，指向本目录下对应文档；需要完整用法时 Read 对应文档。
+
+> 对外通信命令以自己的 AID 为发送者；当前渠道是否需要 CLI 回复，以运行时注入的
+> `channel` 规则为准。参数不是全局通用的：`--format json` 仅用于对应帮助中明确支持的命令，
+> `--app <name>` 仅用于消息 pull/ack、消费类 RPC 和明确支持 app slot 的文件操作。
+
+## 如何使用本索引
+
+1. **遇到触发词**（用户提到"费用/用量/创建/查群/上传文件"等）→ Ctrl+F 本文档找触发词 → 定位命令集 → Read 对应文档
+2. **不确定有没有命令**时，直接 `ec <猜测的子命令> --help` 试一下（如 `ec stats --help`）
+3. **已知场景需求**（如"要给对端发消息"）→ 看下方分类表 → 定位到对应命令集
+
+## 服务运维类（本地，无需 AUN）
+
+| 命令 | 用途 | 触发词 |
+|------|------|--------|
+| `ec --version` / `-v` / `-V` | 查看版本号 | 版本 |
+| `ec restart` | 重启服务（含自动升级检查） | 重启 |
+| `ec status` | 查看运行状态、进程、会话、渠道连接 | 状态/查看状态 |
+| `ec logs` | 查看日志（`--level` `--module` `--raw` `--no-color`） | 日志/查看日志 |
+| `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
+
+Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSecurityInfoW ... 5`、`unelevated ... cannot enforce deny-read` 或 daemon 管道 `EPERM` 时，参见 `codex-windows-sandbox.md`。
+
+## 对外通信 / 网络类（连 AUN，以 AID 为发送者）
+
+| 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
+|--------|------|--------|----------|------|
+| `ec msg` | 私聊收发消息 | 回复/发消息/拉取/撤回/查在线 | 有对端（peerId） | `msg.md` |
+| `ec group` | 群聊收发与群管理 | 群发/建群/邀请/踢人/退群/群成员/角色/封禁/规则/协作 | 群聊（groupId） | `group.md`；完整协作流程见 `group-collaboration.md` |
+| `ec group rules` | 群规则文件发布与上下文注入 | 群规则/工作流程/职责分工/rules.md/发布规则 | AUN 群聊（groupId） | `group-rules.md` |
+| `ec aid` | AID 身份管理 | 身份/证书/名片/探测对端 | 任意有渠道场景 | `aid.md` |
+| `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
+| `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
+| `ec agent` | EvolAgent 生命周期 | 创建/启停/热重载/改配置 | 管理员（owner/admin） | `agent.md`；完整创建与 Bootstrap 见 `agent-create.md` |
+| `ec contact` | Contact Book 与访问控制 | 申请添加、拉黑/解除拉黑、查拉黑 | Agent 当前私聊可申请添加；管理写操作按角色限制 | `contact.md` |
+| `ec rpc` | 底层 AUN RPC（逃生通道） | 直接调协议方法 | 高级/兜底 | `rpc.md` |
+| `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/daemon 日志/监控/原始配置 | 运维主机或具备 `ec.menu.request` 权限的托管 Agent | `menu-client.md` |
+
+## 会话自管理类（不连 AUN，操作当前会话）
+
+| 命令集 | 用途 | 触发词 | 文档 |
+|--------|------|--------|------|
+| `ec ctl` | 当前会话工具 | 主动发消息/文件、重命名、队列、项目路径、会话状态 | `ctl.md` |
+
+## 本地工具类（不连 AUN，操作本地配置）
+
+| 命令集 | 用途 | 触发词 | 文档 |
+|--------|------|--------|------|
+| `ec model` | 模型与推理强度管理（按作用域持久化） | 切模型/列模型/当前模型/模型详情/改强度/诊断网关 | `model.md` |
+| `ec response` | 响应模式管理（按作用域持久化） | 切换响应模式/列响应模式/看当前模式/改响应配置 | `response.md` |
+| `ec config` | 配置体系底层入口（读写/快照/回滚） | 看配置/改配置/查字段/查schema/校验/快照/回滚/历史/启动记录 | `config.md` |
+| `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
+| `ec trigger` | 定时与事件触发器管理（创建用 `create`，`set` 为兼容别名） | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
+| `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
+
+## 开发者工具（非 agent 会话能力）
+
+| 命令 | 用途 | 说明 |
+|------|------|------|
+| `ec bench` | AUN 消息系统性能基准测试 | CLI 工具，agent 一般不主动调用；`ec bench --help` 查看用法 |
+
+## 其他
+
+| 文档 | 说明 |
+|------|------|
+| `self-summary.md` | 自我总结流程指南 |