evolcore 0.0.23 → 0.0.25

package/kits/docs/identity/AID_PROFILE_SPEC.md

@@ -1,26 +1,26 @@
-# AID 档案规范
-
-<!-- TODO: 填充 AID 档案格式规范 -->
-
-## 档案类型
-
-| 类型 | 位置 | 说明 |
-|------|------|------|
-| 自身人格 | `$SELF_DIR/persona.md` | 行为规范、人格定义 |
-| 关系档案 | `$RELATIONS_DIR/<peerKey>/profile.md` | 对端关系记录（含具体群实例） |
-
-## persona.md 结构
-
-```markdown
-# <agent-name>
-
-## 基本信息
-- AID: <aid>
-- 名称: <name>
-
-## 行为规范
-（定义称呼、语气、风格等）
-
-## 能力声明
-（对外公开的能力描述）
-```
+# AID 档案规范
+
+<!-- TODO: 填充 AID 档案格式规范 -->
+
+## 档案类型
+
+| 类型 | 位置 | 说明 |
+|------|------|------|
+| 自身人格 | `$SELF_DIR/persona.md` | 行为规范、人格定义 |
+| 关系档案 | `$RELATIONS_DIR/<peerKey>/profile.md` | 对端关系记录（含具体群实例） |
+
+## persona.md 结构
+
+```markdown
+# <agent-name>
+
+## 基本信息
+- AID: <aid>
+- 名称: <name>
+
+## 行为规范
+（定义称呼、语气、风格等）
+
+## 能力声明
+（对外公开的能力描述）
+```

package/kits/docs/identity/PATH_OPS.md

@@ -1,16 +1,16 @@
-# 路径运维操作
-
-<!-- TODO: 填充路径失效处理、迁移、新增路径等运维操作 -->
-
-## 路径失效处理
-
-当 `$ECK/path-registry.md` 中某路径不存在时：
-1. 检查路径是否已迁移（查 git log）
-2. 尝试按派生规则重新计算
-3. 如无法恢复，标记为 `❌` 并通知用户
-
-## 新增路径
-
-1. 在 `$KITS_DOCS/path-registry.md` 添加定义
-2. 在 `$ECK/path-registry.md` 添加实例值
-3. 更新 `$KITS_DOCS/INDEX.md`
+# 路径运维操作
+
+<!-- TODO: 填充路径失效处理、迁移、新增路径等运维操作 -->
+
+## 路径失效处理
+
+当 `$ECK/path-registry.md` 中某路径不存在时：
+1. 检查路径是否已迁移（查 git log）
+2. 尝试按派生规则重新计算
+3. 如无法恢复，标记为 `❌` 并通知用户
+
+## 新增路径
+
+1. 在 `$KITS_DOCS/path-registry.md` 添加定义
+2. 在 `$ECK/path-registry.md` 添加实例值
+3. 更新 `$KITS_DOCS/INDEX.md`

package/kits/docs/identity/ROLE_DETAIL.md

@@ -1,25 +1,25 @@
-# 角色与场景详细规则
-
-<!-- TODO: 填充权限矩阵、场景矩阵、对端发现流程 -->
-
-## 权限矩阵
-
-| 角色 | 对话 | 配置 | 管理 | 运维 |
-|------|------|------|------|------|
-| owner | Yes | Yes | Yes | Yes |
-| admin | Yes | Yes | Yes | No |
-| member | Yes | 仅自身关系 | No | No |
-| visitor | Yes | No | No | No |
-| none | No | No | No | No |
-
-上表描述 Agent/relation 角色，不包含 daemon 进程控制面。进程级 `daemon-owner` 是独立角色，
-用于 daemon、Agent 生命周期、ECWeb 和指定 Trigger 控制操作；它通过 Agent channel 进入时仍保留
-实际关系角色，不会自动成为该 Agent 的 `owner`。
-
-## 场景矩阵
-
-| 场景 | 响应策略 | 工具可用性 |
-|------|----------|-----------|
-| coding | 每条响应 | 全部 |
-| private | 自主决定 | 全部 |
-| group | 被@响应 | 全部 |
+# 角色与场景详细规则
+
+<!-- TODO: 填充权限矩阵、场景矩阵、对端发现流程 -->
+
+## 权限矩阵
+
+| 角色 | 对话 | 配置 | 管理 | 运维 |
+|------|------|------|------|------|
+| owner | Yes | Yes | Yes | Yes |
+| admin | Yes | Yes | Yes | No |
+| member | Yes | 仅自身关系 | No | No |
+| visitor | Yes | No | No | No |
+| none | No | No | No | No |
+
+上表描述 Agent/relation 角色，不包含 daemon 进程控制面。进程级 `daemon-owner` 是独立角色，
+用于 daemon、Agent 生命周期、ECWeb 和指定 Trigger 控制操作；它通过 Agent channel 进入时仍保留
+实际关系角色，不会自动成为该 Agent 的 `owner`。
+
+## 场景矩阵
+
+| 场景 | 响应策略 | 工具可用性 |
+|------|----------|-----------|
+| coding | 每条响应 | 全部 |
+| private | 自主决定 | 全部 |
+| group | 被@响应 | 全部 |

package/kits/docs/identity/identity-tools.md

@@ -1,26 +1,26 @@
-# 身份/环境层工具用法
-
-## 身份识别
-
-当你在对话中识别出对端的真实身份时，可以调用：
-
-```bash
-ec ctl identity.identify --aid <对端AID> --name <名称> --type person --method self-declaration
-```
-
-## 查看对端信息
-
-```bash
-ec ctl identity.show <对端AID>
-```
-
-## 查看当前环境
-
-```bash
-ec ctl venue.show
-```
-
-## 注意
-
-- 身份层工具仅在身份层运行时实现后可用（当前为占位文档）
-- 对端名片通过 `https://<aid>/agent.md` 获取，由 AUN 网络提供
+# 身份/环境层工具用法
+
+## 身份识别
+
+当你在对话中识别出对端的真实身份时，可以调用：
+
+```bash
+ec ctl identity.identify --aid <对端AID> --name <名称> --type person --method self-declaration
+```
+
+## 查看对端信息
+
+```bash
+ec ctl identity.show <对端AID>
+```
+
+## 查看当前环境
+
+```bash
+ec ctl venue.show
+```
+
+## 注意
+
+- 身份层工具仅在身份层运行时实现后可用（当前为占位文档）
+- 对端名片通过 `https://<aid>/agent.md` 获取，由 AUN 网络提供

package/kits/docs/path-registry.md

@@ -1,62 +1,62 @@
-# 路径定义
-
-本文件定义所有预定义路径的含义和派生规则。真相源是 `src/paths.ts`（基础/派生路径）
-和 `src/eck/manifest-engine.ts` 的 `buildPathMappings`（ECK 认识哪些别名）。
-
-## 基础路径（三个锚点）
-
-| 名称 | 含义 | 来源 |
-|------|------|------|
-| `$EVOLCORE_HOME` | evolcore 用户数据根 | `resolveRoot()`：环境变量 `EVOLCORE_HOME` → `~/.evolcore` |
-| `$PACKAGE_ROOT` | evolcore 包根目录 | `getPackageRoot()`，由 `import.meta` 推出（不是 `require.resolve`） |
-| `$CURRENT_PROJECT` | 当前工作目录 | 会话的 projectPath |
-
-> dev 模式下 `$EVOLCORE_HOME` 和 `$PACKAGE_ROOT` 可能是**同一个目录**（本机就是 `/home/evolcore`）。
-
-## ECK 能解析的别名
-
-只有下面这些能出现在 manifest 的 `path` 字段里；其它写法会被判为未解析变量、整段静默丢弃。
-
-| 名称 | 派生规则 | 说明 |
-|------|----------|------|
-| `$KITS` | `$PACKAGE_ROOT/kits` | kits 根目录 |
-| `$KITS_RULES` | `$KITS/rules` | 自动加载的规则文件 |
-| `$KITS_DOCS` | `$KITS/docs` | 按需加载的文档 |
-| `$KITS_TEMPLATES` | `$KITS/templates` | 运行时 prompt 组装模板 |
-| `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | system prompt fragment 模板 |
-| `$KITS_MESSAGE_FRAGMENTS` | `$KITS_TEMPLATES/message-fragments` | 逐条消息渲染的 fragment 模板 |
-| `$AGENT_DIR` | `$EVOLCORE_HOME/agents/<selfAid>` | 当前 agent 数据目录 |
-| `$PERSONAL_DIR` | `$AGENT_DIR/personal` | 身份层个人数据（旧名 `$SELF_DIR` 已废弃） |
-| `$RELATIONS_DIR` | `$AGENT_DIR/relations` | 对端关系数据（含具体群/私聊实例数据） |
-| `$VENUES_DIR` | `$AGENT_DIR/venues` | 环境层；**当前是死目录**，`agentVenuesDir()` 零调用点 |
-| `$CURRENT_PROJECT` | 会话 projectPath | — |
-| `$EVOLCORE_HOME` | 见上 | — |
-| `$PACKAGE_ROOT` | 见上 | — |
-
-`selfAid` 为空时（本地 coding 会话），`$AGENT_DIR` / `$PERSONAL_DIR` / `$RELATIONS_DIR` /
-`$VENUES_DIR` 这四个别名**不会注册**。
-
-## 仅文档书写约定（ECK 不解析）
-
-| 名称 | 实际位置 | 说明 |
-|------|----------|------|
-| `$ECK` | `$EVOLCORE_HOME/eck` | ECK 实例数据，见下节告警 |
-| `$AGENTS_DIR` | `$EVOLCORE_HOME/agents` | 所有 agent 数据根 |
-| `$AGENT_INDEX` | `$AGENT_DIR/index` | agent 级索引 |
-| `$PEER_DIR` | `$RELATIONS_DIR/<peerKey>` | 当前对端的关系目录 |
-
-## 外部依赖路径（需寻找）
-
-| 名称 | 寻找规则 | 说明 |
-|------|----------|------|
-| `$AUN_SDK` | `node -e "console.log(require.resolve('@agentunion/fastaun/package.json'))"` | 本机是本地依赖 `$PACKAGE_ROOT/node_modules/@agentunion/fastaun`，`npm ls -g` 查不到 |
-| `$AUN_PROTOCOL_DOCS` | `$AUN_SDK/_packed_docs/protocol` | 注意是 `_packed_docs/`，该包**没有** `docs/` 目录 |
-
-`$KITE` / `$AUN_SDK_CORE`（Kite 框架时代的 SDK 源码路径）已废弃，不再有对应实现。
-
-## 路径实例文件
-
-`$ECK/path-registry.md` 和 `$ECK/runtime.md` 由 `src/eck/init.ts` **写一次就不再更新**
-（`if (fs.existsSync(file)) return`），且只渲染 `EVOLCORE_HOME` / `PACKAGE_ROOT` 两个变量——
-其余 `{{...}}` 占位符原样留在文件里；源码也**没有任何地方读回它们**。
-不要把它们当作真实路径的依据，按本文件的派生规则自己算，或直接读 `src/paths.ts`。
+# 路径定义
+
+本文件定义所有预定义路径的含义和派生规则。真相源是 `src/paths.ts`（基础/派生路径）
+和 `src/eck/manifest-engine.ts` 的 `buildPathMappings`（ECK 认识哪些别名）。
+
+## 基础路径（三个锚点）
+
+| 名称 | 含义 | 来源 |
+|------|------|------|
+| `$EVOLCORE_HOME` | evolcore 用户数据根 | `resolveRoot()`：环境变量 `EVOLCORE_HOME` → `~/.evolcore` |
+| `$PACKAGE_ROOT` | evolcore 包根目录 | `getPackageRoot()`，由 `import.meta` 推出（不是 `require.resolve`） |
+| `$CURRENT_PROJECT` | 当前工作目录 | 会话的 projectPath |
+
+> dev 模式下 `$EVOLCORE_HOME` 和 `$PACKAGE_ROOT` 可能是**同一个目录**（本机就是 `/home/evolcore`）。
+
+## ECK 能解析的别名
+
+只有下面这些能出现在 manifest 的 `path` 字段里；其它写法会被判为未解析变量、整段静默丢弃。
+
+| 名称 | 派生规则 | 说明 |
+|------|----------|------|
+| `$KITS` | `$PACKAGE_ROOT/kits` | kits 根目录 |
+| `$KITS_RULES` | `$KITS/rules` | 自动加载的规则文件 |
+| `$KITS_DOCS` | `$KITS/docs` | 按需加载的文档 |
+| `$KITS_TEMPLATES` | `$KITS/templates` | 运行时 prompt 组装模板 |
+| `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | system prompt fragment 模板 |
+| `$KITS_MESSAGE_FRAGMENTS` | `$KITS_TEMPLATES/message-fragments` | 逐条消息渲染的 fragment 模板 |
+| `$AGENT_DIR` | `$EVOLCORE_HOME/agents/<selfAid>` | 当前 agent 数据目录 |
+| `$PERSONAL_DIR` | `$AGENT_DIR/personal` | 身份层个人数据（旧名 `$SELF_DIR` 已废弃） |
+| `$RELATIONS_DIR` | `$AGENT_DIR/relations` | 对端关系数据（含具体群/私聊实例数据） |
+| `$VENUES_DIR` | `$AGENT_DIR/venues` | 环境层；**当前是死目录**，`agentVenuesDir()` 零调用点 |
+| `$CURRENT_PROJECT` | 会话 projectPath | — |
+| `$EVOLCORE_HOME` | 见上 | — |
+| `$PACKAGE_ROOT` | 见上 | — |
+
+`selfAid` 为空时（本地 coding 会话），`$AGENT_DIR` / `$PERSONAL_DIR` / `$RELATIONS_DIR` /
+`$VENUES_DIR` 这四个别名**不会注册**。
+
+## 仅文档书写约定（ECK 不解析）
+
+| 名称 | 实际位置 | 说明 |
+|------|----------|------|
+| `$ECK` | `$EVOLCORE_HOME/eck` | ECK 实例数据，见下节告警 |
+| `$AGENTS_DIR` | `$EVOLCORE_HOME/agents` | 所有 agent 数据根 |
+| `$AGENT_INDEX` | `$AGENT_DIR/index` | agent 级索引 |
+| `$PEER_DIR` | `$RELATIONS_DIR/<peerKey>` | 当前对端的关系目录 |
+
+## 外部依赖路径（需寻找）
+
+| 名称 | 寻找规则 | 说明 |
+|------|----------|------|
+| `$AUN_SDK` | `node -e "console.log(require.resolve('@agentunion/fastaun/package.json'))"` | 本机是本地依赖 `$PACKAGE_ROOT/node_modules/@agentunion/fastaun`，`npm ls -g` 查不到 |
+| `$AUN_PROTOCOL_DOCS` | `$AUN_SDK/_packed_docs/protocol` | 注意是 `_packed_docs/`，该包**没有** `docs/` 目录 |
+
+`$KITE` / `$AUN_SDK_CORE`（Kite 框架时代的 SDK 源码路径）已废弃，不再有对应实现。
+
+## 路径实例文件
+
+`$ECK/path-registry.md` 和 `$ECK/runtime.md` 由 `src/eck/init.ts` **写一次就不再更新**
+（`if (fs.existsSync(file)) return`），且只渲染 `EVOLCORE_HOME` / `PACKAGE_ROOT` 两个变量——
+其余 `{{...}}` 占位符原样留在文件里；源码也**没有任何地方读回它们**。
+不要把它们当作真实路径的依据，按本文件的派生规则自己算，或直接读 `src/paths.ts`。