evolcore 0.0.3 → 0.0.4

package/kits/rules/01-overview.md

@@ -12,7 +12,10 @@ AUN（Agent Union Network）是 agent 间安全通信的网络协议，SDK 的 n
 
 ### AID
 
-AID（Agent Identifier）是主体在 AUN 网络中的唯一身份标识，格式为 `{name}.{issuer}`（如 `alice.aid.pub`）。任何拥有域名的组织都可以作为 Issuer 签发 AID——去中心化，无需中央权威。AID 同时也是通信地址：身份即入口。
+AID（Agent Identifier）是主体在 AUN 网络中的唯一身份标识，格式为 `{name}.{issuer}`（如 `alice.agentid.pub`）。任何拥有域名的组织都可以作为 Issuer 签发 AID——去中心化，无需中央权威。AID 同时也是通信地址：身份即入口。
+
+> 本机 evolcore 新建 AID 时的默认 issuer 是 `agentid.pub`（`src/aun/aid/control-aid.ts` 的
+> `resolveControlIssuer()`，可用 `EVOLCORE_ISSUER` 覆盖）。文档里出现的 `xxx.aid.pub` 是旧例子。
 
 访问 `https://{aid}` 可获取该主体的个人主页。
 
@@ -114,7 +117,7 @@ ECK（EvolCore Context Kit）是 EvolCore 的上下文组装系统。你正在
 
 ### 上下文组装流程
 
-evolcore 收到每条消息时，由一份**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
+evolcore 收到每条消息时，由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
 每个 section 带 `when` 条件，evolcore 按当前会话构造一组运行时变量（`chatType`、`channel`、
 `selfAid`、`peerKey` 等）逐段求值，命中的才按顺序拼进 system prompt（`needsInjection` 的段还会先做模板渲染）。
 
@@ -123,15 +126,22 @@ evolcore 收到每条消息时，由一份**声明式 manifest** 决定加载哪
 | 场景 | 命中的层/段 |
 |------|------------|
 | coding（无渠道） | rules + 会话层 + baseagent（身份/关系/环境/渠道层因无 channel、无身份而落选） |
-| private（私聊） | rules + 身份层 + 关系层（对端）+ 环境层 + 渠道层 + 会话层 + baseagent |
-| group（群聊） | rules + 身份层 + 关系层（群）+ 环境层 + 渠道层 + 会话层 + baseagent |
+| private（私聊） | rules + 身份层（含 preferences）+ 关系层（对端）+ 环境层 + 渠道层 + 会话层 + baseagent |
+| group（群聊） | rules + 身份层（**无 preferences**）+ 关系层（群）+ 环境层 + 渠道层 + 会话层 + baseagent |
+| bootstrapping | rules + bootstrap 引导 + 会话层 + baseagent |
 
 > 会话层（session fragment）是 `when:always`、baseagent 段只要注入了 base agent 信息就加载——
 > 二者与 chatType 无关，每个场景都在；所以 coding 并非"仅 rules"。
 
-manifest schema、when 条件、合并覆盖、模板渲染、运行时变量目录，以及**实际渲染结果的调试输出**
-（`$EVOLCORE_HOME/data/eck-debug/` 下的 vars / context / fragments / manifest 四个文件）：
-详见 `$KITS_DOCS/context-assembly.md`。
+三份 manifest 各管一段：`kits/eck_manifest.json`（system prompt 默认）、
+`kits/eck_manifest.auxiliary.json`（备用，可由 `config.sessionManifests` 指定）、
+`kits/eck_message_manifest.json`（逐条消息渲染）。
+
+manifest schema、when 条件、合并覆盖、模板渲染、运行时变量目录详见 `$KITS_DOCS/context-assembly.md`。
+
+**实际渲染结果的调试输出**默认**关闭**，要在进程级配置里打开 `debug.eckSnapshots: true` 才会写；
+开启后落 `$EVOLCORE_HOME/data/eck-debug/`，文件名带时间戳：`vars-<ts>.json`、`context-<ts>.md`、
+`fragments-<ts>.md`、`manifest-<ts>.md`（逐条消息渲染另有 `msg-render-<ts>.md`），保留 24 小时。
 
 ## 术语
 

package/kits/rules/02-navigation.md

@@ -6,28 +6,38 @@
 
 | 路径 | 含义 |
 |------|------|
-| `$EVOLCORE_HOME` | 用户数据根（默认 `~/.evolcore`） |
-| `$PACKAGE_ROOT` | evolcore 包根目录 |
+| `$EVOLCORE_HOME` | 用户数据根。解析顺序：`EVOLCORE_HOME` 环境变量 → cwd 下有 `agents/defaults.json` 则取 cwd → `~/.evolcore`（第二步意味着**包根和数据根可能是同一个目录**） |
+| `$PACKAGE_ROOT` | evolcore 包根目录（由 `getPackageRoot()` 从 `import.meta` 推出） |
 | `$CURRENT_PROJECT` | 当前工作目录 |
 
 ### 派生路径
 
+以下是 ECK 真正认识的别名（`src/eck/manifest-engine.ts` 的 `buildPathMappings`）：
+
 | 名称 | 派生自 | 含义 |
 |------|--------|------|
 | `$KITS` | `$PACKAGE_ROOT/kits` | ECK 知识包根 |
 | `$KITS_RULES` | `$KITS/rules` | 自动载入部分（本目录） |
 | `$KITS_DOCS` | `$KITS/docs` | 按需载入文档 |
 | `$KITS_TEMPLATES` | `$KITS/templates` | prompt 模板 |
-| `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | ECK 动态注入 fragment 模板 |
-| `$ECK` | `$EVOLCORE_HOME/eck` | 运行时配置 |
-| `$AGENTS_DIR` | `$EVOLCORE_HOME/agents` | per-agent 数据根 |
-| `$AGENT_DIR` | `$AGENTS_DIR/<self-aid>` | 当前 agent 根 |
-| `$SELF_DIR` | `$AGENT_DIR/personal` | 个人数据层（身份层） |
+| `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | system prompt fragment 模板 |
+| `$KITS_MESSAGE_FRAGMENTS` | `$KITS_TEMPLATES/message-fragments` | 逐条消息渲染的 fragment 模板 |
+| `$PERSONAL_DIR` | `$AGENT_DIR/personal` | 个人数据层（身份层） |
 | `$RELATIONS_DIR` | `$AGENT_DIR/relations` | 关系层 |
-| `$VENUES_DIR` | `$AGENT_DIR/venues` | 环境层 |
-| `$AGENT_INDEX` | `$AGENT_DIR/index` | agent 级文档索引 |
+| `$VENUES_DIR` | `$AGENT_DIR/venues` | 环境层（当前是死目录，见 `05-venue.md`） |
+| `$AGENT_DIR` | `$EVOLCORE_HOME/agents/<selfAid>` | 当前 agent 根（`selfAid` 为空时这四个别名都不注册） |
+
+> ⚠️ **只有上表这些别名能在 manifest 的 `path` 字段里用**。写成 `$SELF_DIR`（旧名）、
+> `$PEER_DIR`、`$AGENTS_DIR`、`$AGENT_INDEX`、`$ECK` 会被判为未解析变量，**整段静默丢弃**。
 
-会话级动态注入：`$PEER_DIR` → 当前对端的关系目录。
+下面这些只是**文档里的书写约定**，不是 ECK 能解析的别名，引用时要么写全路径要么当散文读：
+
+| 名称 | 实际位置 | 含义 |
+|------|----------|------|
+| `$ECK` | `$EVOLCORE_HOME/eck` | 运行时配置实例（见下文 Bootstrap 的告警） |
+| `$AGENTS_DIR` | `$EVOLCORE_HOME/agents` | per-agent 数据根 |
+| `$AGENT_INDEX` | `$AGENT_DIR/index` | agent 级文档索引 |
+| `$PEER_DIR` | `$RELATIONS_DIR/<peerKey>` | 当前对端的关系目录 |
 
 ## 路径注册表机制
 
@@ -44,9 +54,12 @@
 ### 两类路径
 
 - **可直接派生**：从基础路径按固定规则算出（如 `$KITS = $PACKAGE_ROOT/kits`）
-- **不可直接派生**：需按寻找规则搜索，找到后写入实例文件。例如：
-  - `$AUN_SDK`：寻找规则 `npm list -g @agentunion/fastaun --parseable`
-  - `$AUN_PROTOCOL_DOCS`：`$AUN_SDK/docs/protocol`（AUN 协议详细文档）
+- **不可直接派生**：需按寻找规则搜索。例如：
+  - `$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/` 目录**
 
 ### 按需加载时机
 
@@ -69,8 +82,15 @@ agent 级索引范围：`$CURRENT_PROJECT` + `$AGENT_DIR`。
 ## Bootstrap（独立使用 ECK 时）
 
 无 evolcore 动态注入时，路径确定顺序：
-1. `$EVOLCORE_HOME`：环境变量 → 默认 `~/.evolcore`
-2. 读取 `$ECK/runtime.md` 获取基础路径和运行时参数
-3. 按派生规则构造其余路径
-
-参数加载优先级：evolcore 动态注入 > 环境变量 > `$ECK/runtime.md` > 硬编码默认值。
+1. `$EVOLCORE_HOME`：环境变量 → cwd 下有 `agents/defaults.json` 则取 cwd → `~/.evolcore`
+2. `$PACKAGE_ROOT`：evolcore 安装目录（dev 模式下可能与上一步同一个目录）
+3. 按上面的派生规则构造其余路径
+
+> ⚠️ **不要指望 `$ECK/runtime.md` 和 `$ECK/path-registry.md`**。这两个文件由
+> `src/eck/init.ts` **写一次就不再更新**（`if (fs.existsSync(file)) return`），而且只渲染
+> `EVOLCORE_HOME` / `PACKAGE_ROOT` 两个变量，其余 `{{...}}` 占位符会原样留在文件里；
+> 源码中也**没有任何地方读回它们**。本机这两个文件仍是 evolclaw 时代生成的，
+> 里面写着 `$EVOLCLAW_HOME | /home/evolclaw`。要真实路径就按上面 1-3 步自己算，
+> 或直接读 `src/paths.ts`。
+
+参数加载优先级：evolcore 动态注入 > 环境变量 > 硬编码默认值。

package/kits/rules/03-identity.md

@@ -1,34 +1,38 @@
 # 身份层：我是谁
 
-身份层包含当前 agent 的一切自我认知。动态注入的 `$SELF_AID` 和 `$SELF_NAME` 标识当前身份。
+身份层是当前 agent 的自我认知。ECK 在 identity fragment 注入 `selfAid`（当前 AID），
+并把 `$EVOLCORE_HOME/AIDs/<aid>/agent.md` frontmatter 的 `name` 投影为 `selfName`。
+`selfName` 仅用于展示，名片缺失或尚未拉取完成时可能为空；身份与授权判断必须使用 `selfAid`。
 
 ## 数据位置
 
 | 位置 | 内容 |
 |------|------|
-| `$SELF_DIR`（`$AGENT_DIR/personal/`） | 个人数据（可写） |
+| `$PERSONAL_DIR`（`$AGENT_DIR/personal/`） | 个人数据（可写） |
 | `$KITS_DOCS/identity/` | 身份层详细规则（只读，按需加载） |
 
-## 数据结构
+> manifest 模板里只认 `$PERSONAL_DIR` / `$RELATIONS_DIR` / `$VENUES_DIR` / `$AGENT_DIR` 这几个路径别名。
+> 写成 `$SELF_DIR` 会被判为未解析变量，**整段静默丢弃**。
 
-| 文件 | 用途 |
-|------|------|
-| `persona.md` | 人格（行为规范、心理独白、身份认知） |
-| `memory/episodic.jsonl` | 事件性记忆（"我经历了什么"） |
-| `memory/semantic.md` | 语义性记忆（习得的事实/规律） |
-| `memory/working.md` | 当前关注（短期，每会话加载） |
-| `style.md` | 表达风格（用词偏好、句式偏好） |
-| `preferences.json` | 工具/模型/操作偏好 |
-| `skills/` | 技能清单（`_index.json` + 每技能一文件） |
-| `goals.md` | 长期目标 |
-| `journal.jsonl` | 反思日志（关键决策、自我修订） |
-
-## 行为规范加载
-
-```
-evolcore 注入了当前 AID？
-  ├─ 是 → Read $SELF_DIR/persona.md，执行其中行为规范
-  └─ 否（coding 模式）→ 使用默认行为
-```
-
-不同 AID 可以有不同人格——切换身份即切换行为。
+## 数据结构（以源码实际读写为准）
+
+| 路径 | 用途 | 实际状态 |
+|------|------|----------|
+| `persona.md` | 人格（行为规范、身份认知） | evolcore 自动注入；无写入命令，带外手改 |
+| `memory/working.md` | 当前关注（短期） | evolcore 自动注入 |
+| `preferences/active-preferences.md` | 已确认的稳定用户偏好 | **仅私聊**注入；由用户态 trigger 维护 |
+| `preferences/stats.json`、`preferences/preferences-conflicts.md` | 偏好计分状态与冲突记录 | trigger 私有，无 schema 保证 |
+| `memory/`、`skills/` 目录 | 预留 | 会被创建，但目前无人读写 |
+
+`memory/episodic.jsonl`、`memory/semantic.md`、`style.md`、`preferences.json`、`goals.md`、`journal.jsonl`
+是早期设计稿里的约定，**源码尚未实现读写**——不要假设写了就会生效。
+
+## 人格与行为规范怎么生效
+
+- **注入条件**是 `chatType ≠ null` 且 `lifecycle ≠ bootstrapping`（即有渠道的会话），不是"有没有注入 AID"。本地 coding 模式不注入身份层。
+- persona.md 由 evolcore **自动前置**进 system prompt，你不需要主动 Read。
+- persona.md 缺失时**没有默认人格兜底**，只是这一段不出现；行为约束改由 `kits/rules/` + `roles/` 权限定义承担。
+- 改完 persona.md 后 `ec agent reload` 生效（mtime 门控缓存）。
+- `agents/<aid>/behavior.json` 是**已废弃**的旧配置（基座/模型/权限模式已并入 `config.json`），与人格无关。
+
+不同 AID 可以有不同 persona——切换身份即切换人格。

package/kits/rules/04-relation.md

@@ -8,52 +8,68 @@
 
 > 为什么用 `peerId` 而非直接用 AID：非 AUN 渠道的对端（飞书群、微信）没有 AID，用 `<channel>#<peerId>` 才能统一覆盖所有渠道的对端。
 
+relation fragment 注入的全部变量：`peerKey`、`peerId`、`peerName`、`peerRole`、`peerType`，
+群聊另有 `groupId`、`groupRulesStatus`、`groupRulesError`。`groupRulesStatus=ignored` 表示本轮由
+本地 `groupRules.mode=ignore` 主动跳过，不是远端缺失、无权限或同步失败。
+
 ## 数据位置
 
-| 位置 | 内容 |
-|------|------|
-| `$RELATIONS_DIR`（`$AGENT_DIR/relations/`） | 关系数据（可写） |
-| `$KITS_DOCS/relations/` | 关系层详细规则（只读，按需加载） |
+关系数据（可写）在 `$RELATIONS_DIR`（= `$AGENT_DIR/relations/`）。
 
-## 数据结构
+## 数据结构（以源码实际读写为准）
 
 ```
 relations/
-├── _index/                          名字反查索引
-│   └── name_<urlEncode(name)>.json    { "name": "王老板", "channel": "feishu", "peerId": "ou_xxx", "peerKey": "feishu#ou_xxx" }
-├── <channel>#<urlEncode(peerId)>/   每个对端一个目录（统一命名，不区分 contacts/_observed）
-│   ├── profile.md                     身份、关系评注、交互历史
-│   └── history.jsonl                  关系演化事件流
-└── _trash/                          merged/split 后的重定向占位
+└── <channel>#<urlEncode(peerId)>/   每个对端一个目录
+    ├── peer-identity.json             身份快照缓存（PeerIdentityCache 唯一的写入方）
+    ├── config.json                    关系级配置——**对端角色 config.role 就存在这里**；群可覆盖 groupRules.mode
+    └── rules.md                       仅群目录：校验通过后物化的群规则字节
 ```
 
+群规则加载策略按 Agent `config.json` → 当前群 relation `config.json` 覆盖，缺省为 `load`。当有效值为
+`ignore` 时，本轮不访问远端规则、不读取本地 `rules.md`、不暴露 `groupRulesPath`；旧文件保留但不
+作为回退来源。该字段仅 owner/daemon owner 可修改，其他角色可读取当前 relation 的有效值。
+
 **例子**：
-- AUN 对端：`relations/aun#alice.aid.pub/`
+- AUN 对端：`relations/aun#alice.agentid.pub/`
 - 飞书对端：`relations/feishu#ou_xxx/`
 - 微信对端：`relations/wechat#wxid_xxx/`
 
+**下列条目只是设计稿，源码尚未实现——不要假设读了/写了会生效**：
+
+| 条目 | 真实状态 |
+|------|----------|
+| `<peerKey>/profile.md` | manifest 声明了加载槽（`peer-profile`、`relation-group-profile`，缺失即跳过），但**没有任何代码写它**，磁盘上零文件。你可以手写一份，它会被加载 |
+| `_index/name_<name>.json` 名字反查索引 | 目录会被创建，但**无任何读写代码**，磁盘上全是空目录。"已知 name 反查 peerKey" 这条路走不通 |
+| `<peerKey>/history.jsonl` | 关系层无此实现（同名文件都属于 handoff / trigger / CC 自己的历史） |
+| `_trash/` | 只创建目录，没有 merge/split 重定向逻辑 |
+| `relations/contacts/`、`relations/_observed/` | 目录骨架仍在创建这两个旧结构（`ensureAgentDirSkeleton`），但已不再使用，都是空的 |
+| `<peerKey>/behavior.json` | 旧配置残留，已并入 `config.json` |
+
 ## 查找逻辑
 
-| 场景 | 路径 |
-|------|------|
-| 已知 channel + peerId | 直接拼路径 `relations/<channel>#<urlEncode(peerId)>/` |
-| 已知 name（如"给王老板发消息"） | 读 `_index/name_<urlEncode(name)>.json` 拿到 peerKey，再拼路径 |
+已知 channel + peerId → 直接拼 `relations/<channel>#<urlEncode(peerId)>/`。这是**唯一可用的查找路径**；
+只知道名字（"给王老板发消息"）时没有索引可查，用 `ec aid`/联系人命令或直接问用户。
 
 ## 对端身份与权限
 
-| 身份 | 权限 |
-|------|------|
-| owner | agent 级最高关系权限，可执行 agent 管理和 owner 审批 |
-| admin | agent 管理权限，不能修改 owner，危险操作向 owner 申请审批 |
-| member | 任务型普通成员，默认使用 `auto` |
-| visitor | 特选只读角色，默认使用 `readonly` |
-| 自定义角色 | 按 agent 配置定义，未指定模式时默认按 `auto` |
-| none | 无有效关系角色，拒绝访问 |
+四个内置角色（rank 从高到低）+ 自定义角色 + `none`：
 
-进程级 daemon owner 是最高管理者；通过 agent channel 访问时，按设计映射为该 agent 的 `owner` 关系角色。
+| 身份 | rank | 默认 permissionMode | 权限 |
+|------|------|--------------------|------|
+| owner | 900 | `bypass` | agent 级最高关系权限，可执行 agent 管理和 owner 审批 |
+| admin | 700 | `request` | agent 管理权限，不能修改 owner，危险操作向 owner 申请审批 |
+| member | 300 | `auto` | 任务型普通成员 |
+| visitor | 100 | `readonly` | 只读角色，且是**强制保留角色**（兜底用） |
+| 自定义角色 | 按配置 | 缺失/非法时安全兜底 **`readonly`** | 按 agent 角色模板定义 |
+| none | — | — | 无有效关系角色，拒绝访问 |
 
-兜底：无 token → coding 模式；token 残缺或角色无效 → `none`，拒绝访问。
+角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。
+进程级 daemon owner 是最高管理者；命中时在 auth 层直接提升为 `owner`（不经过角色解析器，
+后者的 owner 只来自 agent 级 `config.owners`）。
 
-## 详细规则
+**兜底链**：无匹配角色 → 回落内置 `visitor`（即 `readonly`）；只有角色注册表本身缺失、
+或 `visitor` 未注册时才落到 `none` 拒绝访问。所以正常配置下几乎总是降权到只读，而不是拒绝。
 
-关系层的详细规则（直接交互判定、merge/split、profile.md 完整格式）：Read `$KITS_DOCS/relations/` 中的相关文档。
+> permissionMode 的合法取值只有 `readonly` / `auto` / `request` / `bypass` 四个。
+> "coding" 是**场景**名（无渠道的本地会话，见 `05-venue.md`），**不是** permissionMode。

package/kits/rules/05-venue.md

@@ -1,36 +1,47 @@
 # 环境层：当前对话场景
 
-环境层决定当前会话加载哪些信息。动态注入的 `chatType` 标识当前聊天类型（private/group/null），`venueUid` 是场所唯一标识（预留）。
+环境层决定当前会话加载哪些信息。ECK 在 venue fragment 注入的环境层变量：
+
+| 变量 | 取值 | 说明 |
+|------|------|------|
+| `chatType` | `private` / `group` / null | null = 无渠道的本地 coding 会话 |
+| `mentionMode` | `mention-only` / `disabled` | 群内响应策略；取 agent/relation 配置，缺省时由服务器 `dispatchMode` 翻译（mention→mention-only，broadcast→disabled） |
+| `clientType` | `desktop` / `web` / `mobile` | 有值时额外加载客户端场景文档 |
+| `permissionMode` | readonly/auto/request/bypass | 当前生效权限模式 |
+| `venueUid` | 恒为 undefined | 声明了但源码固定不填，模板有 `{{?}}` 守卫所以永不渲染——**不要依赖它** |
 
 ## 场景判定
 
-| 场景 | 条件 | 加载的层 | 你的行为 |
+命中哪些段由 `kits/eck_manifest.json` 的 `when` 条件决定，不是写死的分支：
+
+| 场景 | 条件 | 加载的段 | 你的行为 |
 |------|------|----------|----------|
-| coding | 无 channel（无 token） | 仅 rules | 本地模式，每条消息都响应 |
-| private | 单聊 | rules + 身份层 + 关系层（对端）+ 环境层 + 渠道层 | 自主模式，通过 CLI 回复 |
-| group | 群聊 | rules + 身份层 + 关系层（群）+ 环境层 + 渠道层 | 自主模式，mentionMode 决定响应策略 |
+| coding | `chatType = null`（无渠道） | rules + 会话层 + baseagent | 本地模式，每条消息都响应 |
+| private | `chatType = private` | 上述 + 身份层（含 persona/working-memory/**preferences**）+ 关系层（对端 profile）+ 环境层 + 渠道层 + commands | 自主模式，回复方式随 `chatMode` |
+| group | `chatType = group` | 同 private，但**无 preferences**；`groupId` 有值加群 profile，`groupRulesPath` 有值加群规则 | 自主模式，`mentionMode` 决定是否响应 |
+| bootstrapping | `lifecycle = bootstrapping` | rules + bootstrap 引导 + 会话层 + baseagent（身份/关系/环境层全部落选） | 初始化引导 |
+
+> coding 场景**不是"仅 rules"**：`session` 段 `when:always`、`baseagent` 段只要注入了 base agent 就加载。
 
 ## 数据位置
 
 | 位置 | 内容 |
 |------|------|
-| `$VENUES_DIR`（`$AGENT_DIR/venues/`） | 环境数据（可写，预留） |
-| `$KITS_DOCS/venues/` | 环境层详细规则（只读，按需加载） |
+| `$KITS_DOCS/venues/` | 环境层场景文档（只读，按需加载）：`private.md` `group.md` `<channel>-<chatType>.md` `client-*.md` |
+| `$VENUES_DIR`（`$AGENT_DIR/venues/`） | **目前是死目录**：会被创建（含 `_index/` `_trash/`），但源码里 `agentVenuesDir()` 零调用点，无人读写 |
+
+> `venues/` 下若有 `aun#<group-aid>` 之类的实例目录，是已删除模块 `group-venue-sync.ts` 的历史残留，
+> 不再有效——群规则现在走关系层（见下文）。
 
 > **重要**：环境层承载比"单个群/私聊实例"更高的抽象（如组织、类型级共性），**不为具体群/私聊实例建目录**。
 > 具体群实例的数据（如群规则 `rules.md`、群 profile）落**关系层** `$RELATIONS_DIR/<peerKey>/`。
 
 ## Venue 类型抽象
 
-环境层关注的是**类型**，而非具体实例：
+环境层关注的是**类型**，而非具体实例。类型只有 `private` 和 `group` 两种（即 `chatType` 的两个非空取值）——
+没有 `broadcast` 这个 venue 类型，`broadcast` 是**群分发模式** `dispatchMode` 的取值之一（另一个是 `mention`）。
 
-| 类型 | 含义 |
-|------|------|
-| private | 一对一私聊（类型抽象） |
-| group | 群聊（类型抽象） |
-| broadcast | 广播频道（类型抽象） |
-
-`chatType`（private/group/coding）是类型级参数，属于环境层范畴。但"张三所在的 team-alpha 这个**具体群**"是关系层的对端实例，其数据落 `relations/<peerKey>/`。
+"张三所在的 team-alpha 这个**具体群**"不属于环境层，它是关系层的对端实例，数据落 `relations/<peerKey>/`。
 
 ## 群规则（关系层数据）
 
@@ -42,3 +53,8 @@ AUN 群规则文件固定来自 `<group-aid>:/rules.md`。EvolCore 先读取 sig
 
 其它群资源不预先注入，需要时用 `ec fs ls/find/stat/cat <group-aid>:/...` 查询。
 不要把本地残留的 `rules.md` 当作权威源；只有本轮校验通过并暴露 `groupRulesPath` 时才使用。
+
+本地有效配置 `groupRules.mode` 决定是否进入上述流程：relation 值覆盖 Agent 值，缺省为 `load`。
+`ignore` 时返回 `groupRulesStatus=ignored`，且不访问远端规则、不读取本地物化文件、不设置
+`groupRulesPath`，因此不会注入正文。切换配置不会自动清空或新建 base agent 会话；配置提交后开始
+处理的新 turn 使用新策略。

package/kits/rules/06-channel.md

@@ -1,15 +1,17 @@
 # 渠道层：我通过什么通信
 
-渠道层决定你使用什么方式收发消息。动态注入的 `$CHANNEL_TYPE` 标识当前渠道。
+渠道层决定你使用什么方式收发消息。ECK 在 channel fragment 注入 `channel`
+（取值 `aun|feishu|wechat|dingtalk|qqbot|wecom`）。变量名就是小写 `channel`，没有 `$CHANNEL_TYPE`。
 
 ## 数据位置
 
 | 位置 | 内容 |
 |------|------|
 | `$KITS_DOCS/channels/` | 各渠道的**知识文档**：配置、参数、特有机制（只读，按需加载） |
-| `$AGENT_DIR/channels/` | 各渠道的运行时数据（可写） |
+| `$AGENT_DIR/config.json` 的 `channels[]` | 该 agent 接入的渠道实配置（类型、凭据、网关等） |
 
-> 运行时"当前渠道怎么发消息"由动态注入的 `[channel]` 段决定（见下方通信规则）；
+> **没有 `$AGENT_DIR/channels/` 目录**——渠道不按目录分家：配置在 `config.json` 的
+> `channels[]` 列表里，运行时状态落会话层 `$AGENT_DIR/sessions/`。
 > `$KITS_DOCS/channels/` 是**不依赖当前渠道**的知识库，任意会话都可按需 Read 任意渠道文档。
 
 ## 通信规则
@@ -26,8 +28,10 @@
 
 ### 命令返回值
 
-- 成功：`ok` 或包含 `✓ 已发送 ...` 的输出（exit 0）
-- 失败：`✗ ...` 错误信息（exit 非零）
+判断成败**看 exit code**，别靠字符串前缀——各命令集格式不统一：
+
+- `ec ctl send`：成功打印 `ok`；失败把**裸错误信息**打到 stderr（如 `消息内容不能为空`、`adapter 未找到: feishu`），exit≠0
+- `ec msg` / `ec group` 发送类：成功 `✓ 已发送 message_id=… seq=…`；失败 `❌ 发送失败: <原因>`，exit≠0
 
 发送成功后**继续后续处理**。一次任务可能发 0 到多条消息不要因为看到"已发送"就反复发送同一条消息。
 
@@ -44,8 +48,8 @@
 共同约定：
 - 以自己的 AID 为发送者
 - 回复方式随 `chatMode` 走（见上方通信规则）；附加能力（文件/@/加密/发第三方）任何模式下都用 CLI
-- `--format json` 所有命令通用
-- `--app <name>` 指定应用 slot
+- `--format json` / `--app <name>` **不是全局参数**：只在自身 `--help` 明确列出的命令上有效
+  （`--app` 主要用于消息 pull/ack、消费类 RPC 和支持 app slot 的文件操作）。拿不准就先跑 `--help`
 
 ## 各渠道知识文档（按需加载）
 

package/kits/schemas/_meta.json

@@ -1,16 +1,17 @@
 {
   "schemas": {
-    "daemon":          { "currentVersion": 1 },
-    "defaults":        { "currentVersion": 1 },
-    "agent-config":    { "currentVersion": 6 },
-    "relation-config": { "currentVersion": 5 },
-    "contact-book":    { "currentVersion": 2 },
-    "single-session":  { "currentVersion": 1 },
+    "daemon":          { "currentVersion": 3 },
+    "defaults":        { "currentVersion": 3 },
+    "agent-config":    { "currentVersion": 9 },
+    "relation-config": { "currentVersion": 7 },
+    "contact-book":    { "currentVersion": 3 },
+    "single-session":  { "currentVersion": 2 },
     "role-registry":   { "currentVersion": 1 },
     "role-config":     { "currentVersion": 1 }
   },
   "history": [
     { "schema": "daemon",          "version": 1, "date": "2026-06-14", "description": "initial: process config (daemon.json)" },
+    { "schema": "daemon",          "version": 2, "date": "2026-07-28", "description": "add AUN Menu minimum Evol client version" },
     { "schema": "defaults",        "version": 1, "date": "2026-06-14", "description": "global defaults (models.allowed/projects/aun)" },
     { "schema": "agent-config",    "version": 1, "date": "2026-06-14", "description": "initial: agent config with all parameters unified in config.json" },
     { "schema": "agent-config",    "version": 2, "date": "2026-06-23", "description": "add lifecycle state for bootstrap flow; initialized retained for compatibility" },
@@ -27,6 +28,16 @@
     { "schema": "role-config",     "version": 1, "date": "2026-07-22", "description": "standalone role policy definition" },
     { "schema": "agent-config",    "version": 6, "date": "2026-07-23", "description": "move admin identities into AUN private relation role and reject admins[]" },
     { "schema": "contact-book",    "version": 2, "date": "2026-07-24", "description": "AID display names, full-channelKey aliases, and extensible contact status" },
-    { "schema": "relation-config", "version": 5, "date": "2026-07-23", "description": "restore authoritative private/group relation role; allow admin and forbid owner" }
+    { "schema": "relation-config", "version": 5, "date": "2026-07-23", "description": "restore authoritative private/group relation role; allow admin and forbid owner" },
+    { "schema": "defaults",        "version": 2, "date": "2026-07-27", "description": "remove Session Renew effort and add globally defaultable response-mode parameters" },
+    { "schema": "agent-config",    "version": 7, "date": "2026-07-27", "description": "remove Session Renew effort; auxiliary inference is response-mode owned" },
+    { "schema": "relation-config", "version": 6, "date": "2026-07-27", "description": "remove relation Session Renew effort; auxiliary inference is response-mode owned" },
+    { "schema": "single-session",  "version": 2, "date": "2026-07-27", "description": "add optional baseagent-aware auxiliaryModel and auxiliaryEffort without factory defaults" },
+    { "schema": "daemon",          "version": 3, "date": "2026-07-29", "description": "make daemon.json the exclusive source for all process debug settings" },
+    { "schema": "defaults",        "version": 3, "date": "2026-07-29", "description": "remove debug from the Agent configuration inheritance chain" },
+    { "schema": "agent-config",    "version": 8, "date": "2026-07-29", "description": "reject Agent-level debug because debug is process-owned" },
+    { "schema": "agent-config",    "version": 9, "date": "2026-07-29", "description": "add owner-controlled AUN group rules loading and Agent message access policy" },
+    { "schema": "relation-config", "version": 7, "date": "2026-07-29", "description": "add per-group override for the AUN group rules loading policy" },
+    { "schema": "contact-book",    "version": 3, "date": "2026-07-29", "description": "add versioned contact requests and declined status" }
   ]
 }