evolcore 0.0.1 → 0.0.2

package/kits/rules/03-identity.md

@@ -0,0 +1,34 @@
+# 身份层：我是谁
+
+身份层包含当前 agent 的一切自我认知。动态注入的 `$SELF_AID` 和 `$SELF_NAME` 标识当前身份。
+
+## 数据位置
+
+| 位置 | 内容 |
+|------|------|
+| `$SELF_DIR`（`$AGENT_DIR/personal/`） | 个人数据（可写） |
+| `$KITS_DOCS/identity/` | 身份层详细规则（只读，按需加载） |
+
+## 数据结构
+
+| 文件 | 用途 |
+|------|------|
+| `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 可以有不同人格——切换身份即切换行为。

package/kits/rules/04-relation.md

@@ -0,0 +1,59 @@
+# 关系层：跟我聊天的是谁
+
+关系层管理你对所有对端的认知。动态注入的 `peerKey`（`<channel>#<urlEncode(peerId)>`）是对端在所有渠道中的稳定标识。`peerId` 是对端在当前渠道的原生 ID（AUN 是 AID，飞书是 user_id 等），`channel` 是当前渠道类型。
+
+**对端包括群**：AID 四类型（human/agent/group/service，见 `01-overview.md`）对你而言都是对端，数据都在关系层。
+- 私聊：`peerId` = 对端 ID，`peerKey` = `<channel>#<对端ID>`。
+- 群聊：`peerId` = **群 ID**（群本身的 AID / 渠道群 ID），群内所有发言者共用同一个 `peerKey`（群的键）。群规则、群 profile 等**具体群实例数据**落 `$RELATIONS_DIR/<peerKey>/`（如群规则物化到 `relations/<peerKey>/rules.md`）。
+
+> 为什么用 `peerId` 而非直接用 AID：非 AUN 渠道的对端（飞书群、微信）没有 AID，用 `<channel>#<peerId>` 才能统一覆盖所有渠道的对端。
+
+## 数据位置
+
+| 位置 | 内容 |
+|------|------|
+| `$RELATIONS_DIR`（`$AGENT_DIR/relations/`） | 关系数据（可写） |
+| `$KITS_DOCS/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 后的重定向占位
+```
+
+**例子**：
+- AUN 对端：`relations/aun#alice.aid.pub/`
+- 飞书对端：`relations/feishu#ou_xxx/`
+- 微信对端：`relations/wechat#wxid_xxx/`
+
+## 查找逻辑
+
+| 场景 | 路径 |
+|------|------|
+| 已知 channel + peerId | 直接拼路径 `relations/<channel>#<urlEncode(peerId)>/` |
+| 已知 name（如"给王老板发消息"） | 读 `_index/name_<urlEncode(name)>.json` 拿到 peerKey，再拼路径 |
+
+## 对端身份与权限
+
+| 身份 | 权限 |
+|------|------|
+| owner | agent 级最高关系权限，可执行 agent 管理和 owner 审批 |
+| admin | agent 管理权限，不能修改 owner，危险操作向 owner 申请审批 |
+| member | 任务型普通成员，默认使用 `auto` |
+| visitor | 特选只读角色，默认使用 `readonly` |
+| 自定义角色 | 按 agent 配置定义，未指定模式时默认按 `auto` |
+| none | 无有效关系角色，拒绝访问 |
+
+进程级 daemon owner 是最高管理者；通过 agent channel 访问时，按设计映射为该 agent 的 `owner` 关系角色。
+
+兜底：无 token → coding 模式；token 残缺或角色无效 → `none`，拒绝访问。
+
+## 详细规则
+
+关系层的详细规则（直接交互判定、merge/split、profile.md 完整格式）：Read `$KITS_DOCS/relations/` 中的相关文档。

package/kits/rules/05-venue.md

@@ -0,0 +1,44 @@
+# 环境层：当前对话场景
+
+环境层决定当前会话加载哪些信息。动态注入的 `chatType` 标识当前聊天类型（private/group/null），`venueUid` 是场所唯一标识（预留）。
+
+## 场景判定
+
+| 场景 | 条件 | 加载的层 | 你的行为 |
+|------|------|----------|----------|
+| coding | 无 channel（无 token） | 仅 rules | 本地模式，每条消息都响应 |
+| private | 单聊 | rules + 身份层 + 关系层（对端）+ 环境层 + 渠道层 | 自主模式，通过 CLI 回复 |
+| group | 群聊 | rules + 身份层 + 关系层（群）+ 环境层 + 渠道层 | 自主模式，mentionMode 决定响应策略 |
+
+## 数据位置
+
+| 位置 | 内容 |
+|------|------|
+| `$VENUES_DIR`（`$AGENT_DIR/venues/`） | 环境数据（可写，预留） |
+| `$KITS_DOCS/venues/` | 环境层详细规则（只读，按需加载） |
+
+> **重要**：环境层承载比"单个群/私聊实例"更高的抽象（如组织、类型级共性），**不为具体群/私聊实例建目录**。
+> 具体群实例的数据（如群规则 `rules.md`、群 profile）落**关系层** `$RELATIONS_DIR/<peerKey>/`。
+
+## Venue 类型抽象
+
+环境层关注的是**类型**，而非具体实例：
+
+| 类型 | 含义 |
+|------|------|
+| private | 一对一私聊（类型抽象） |
+| group | 群聊（类型抽象） |
+| broadcast | 广播频道（类型抽象） |
+
+`chatType`（private/group/coding）是类型级参数，属于环境层范畴。但"张三所在的 team-alpha 这个**具体群**"是关系层的对端实例，其数据落 `relations/<peerKey>/`。
+
+## 群规则（关系层数据）
+
+AUN 群规则文件固定来自 `<group-aid>:/rules.md`。EvolCore 先读取 signed `rules.content`
+元信息并用远端 stat 的 `size + mtimeMs` 校验 `/rules.md`，一致后把远端字节原样物化到
+**`$RELATIONS_DIR/<peerKey>/rules.md`**（群的 peerKey = `aun#<group-aid>`）并通过 manifest 注入。
+群规则可定义本群特有的工作流程、职责分工、交付格式、禁区和升级路径；当群规则与通用规则冲突时，
+优先遵守群规则，但不能越过系统安全、权限和用户明确指令。
+
+其它群资源不预先注入，需要时用 `ec fs ls/find/stat/cat <group-aid>:/...` 查询。
+不要把本地残留的 `rules.md` 当作权威源；只有本轮校验通过并暴露 `groupRulesPath` 时才使用。

package/kits/rules/06-channel.md

@@ -0,0 +1,59 @@
+# 渠道层：我通过什么通信
+
+渠道层决定你使用什么方式收发消息。动态注入的 `$CHANNEL_TYPE` 标识当前渠道。
+
+## 数据位置
+
+| 位置 | 内容 |
+|------|------|
+| `$KITS_DOCS/channels/` | 各渠道的**知识文档**：配置、参数、特有机制（只读，按需加载） |
+| `$AGENT_DIR/channels/` | 各渠道的运行时数据（可写） |
+
+> 运行时"当前渠道怎么发消息"由动态注入的 `[channel]` 段决定（见下方通信规则）；
+> `$KITS_DOCS/channels/` 是**不依赖当前渠道**的知识库，任意会话都可按需 Read 任意渠道文档。
+
+## 通信规则
+
+"当前这一刻怎么回复、怎么发消息"由动态注入的 `[channel]` 段决定——它能拿到 `chatMode`
+并按模式分流，是唯一的事实源。本节只讲**模式无关的恒定知识**。
+
+要点：
+- **回复方式随 `chatMode` 走**，以 `[channel]` 段为准：
+  - interactive：直接输出即回复
+  - proactive：见 `[channel]` 段的机制说明（thought.put vs message.send）
+- **附加能力与模式无关、始终需要 CLI**：发文件/图片/语音、@某人、加密、联系第三方
+- **以自己的 AID 为发送者**；拿不到时退回 `ec ctl send "<text>"`
+
+### 命令返回值
+
+- 成功：`ok` 或包含 `✓ 已发送 ...` 的输出（exit 0）
+- 失败：`✗ ...` 错误信息（exit 非零）
+
+发送成功后**继续后续处理**。一次任务可能发 0 到多条消息不要因为看到"已发送"就反复发送同一条消息。
+
+## 命令集
+
+**重要**：遇到明确触发词（费用/用量/统计/创建/查群等）时，优先查 `$KITS_DOCS/evolcore/INDEX.md`
+或直接试对应 ec 命令。`[commands]` 段仅列常用命令，完整目录在 INDEX.md。
+
+所有命令以 `ec` 为前缀，以自己的 AID 为发送者。**运行时按当前场景（有无对端/群、对端角色）注入的精简能力卡由 `commands` fragment 决定**（见动态注入的 `[commands]` 段）。
+
+**完整命令集目录（含分类、触发词、适用场景）**：`$KITS_DOCS/evolcore/INDEX.md`。
+单个命令集的详细用法按需 Read 对应文档。
+
+共同约定：
+- 以自己的 AID 为发送者
+- 回复方式随 `chatMode` 走（见上方通信规则）；附加能力（文件/@/加密/发第三方）任何模式下都用 CLI
+- `--format json` 所有命令通用
+- `--app <name>` 指定应用 slot
+
+## 各渠道知识文档（按需加载）
+
+`$KITS_DOCS/channels/` 下每个渠道一份知识文档，内容是该渠道的**配置、参数、特有机制**——
+属于知识性内容，**不依赖**当前注入的渠道类型。需要了解某渠道怎么配置、有哪些参数、
+有哪些特别机制时，按需 Read 对应文档（在 aun 会话里也可查飞书，反之亦然）。
+
+| 渠道 | 文档 | 触发词 |
+|------|------|--------|
+| AUN | `$KITS_DOCS/channels/aun.md` | aun 怎么配置/网关/E2EE/群 ID 格式/证书链 |
+| 飞书 | `$KITS_DOCS/channels/feishu.md` | 飞书怎么配置/appId/合并转发/卡片/user_id |

package/kits/schemas/_meta.json

@@ -0,0 +1,29 @@
+{
+  "schemas": {
+    "daemon":          { "currentVersion": 1 },
+    "defaults":        { "currentVersion": 1 },
+    "agent-config":    { "currentVersion": 5 },
+    "relation-config": { "currentVersion": 4 },
+    "contact-book":    { "currentVersion": 1 },
+    "single-session":  { "currentVersion": 1 },
+    "role-registry":   { "currentVersion": 1 },
+    "role-config":     { "currentVersion": 1 }
+  },
+  "history": [
+    { "schema": "daemon",          "version": 1, "date": "2026-06-14", "description": "initial: process config (daemon.json)" },
+    { "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" },
+    { "schema": "agent-config",    "version": 3, "date": "2026-07-08", "description": "move user role policy into agent config" },
+    { "schema": "relation-config", "version": 1, "date": "2026-06-14", "description": "initial: relation config" },
+    { "schema": "relation-config", "version": 2, "date": "2026-07-08", "description": "move user/group role assignments into relation config" },
+    { "schema": "relation-config", "version": 3, "date": "2026-07-16", "description": "persist relation target kind for unambiguous private/group classification" },
+    { "schema": "agent-config",    "version": 4, "date": "2026-07-20", "description": "move permissionMode exclusively into role definitions" },
+    { "schema": "agent-config",    "version": 5, "date": "2026-07-22", "description": "move role registry and definitions into the standalone roles domain" },
+    { "schema": "relation-config", "version": 4, "date": "2026-07-20", "description": "replace role assignment maps with a single top-level role pointer" },
+    { "schema": "contact-book",    "version": 1, "date": "2026-07-10", "description": "agent contact aliases for cross-channel identity mapping" },
+    { "schema": "single-session",  "version": 1, "date": "2026-07-15", "description": "response mode bucket schema: single-session params (chatMode delivery + proactive toggles); validates responseModeParams['single-session']" },
+    { "schema": "role-registry",   "version": 1, "date": "2026-07-22", "description": "registered role ids and private/group defaults" },
+    { "schema": "role-config",     "version": 1, "date": "2026-07-22", "description": "standalone role policy definition" }
+  ]
+}

package/kits/schemas/agent-config.schema.1.json

@@ -0,0 +1,177 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.1.json",
+  "title": "AgentConfig (agents/{aid}/config.json)",
+  "description": "单 agent 的身份、凭证、管控字段。覆盖链中级，覆盖 defaults。",
+  "x-logical-name": "agent-config",
+  "x-scope": "agent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["aid", "channels"],
+  "properties": {
+    "$schema_version": { "type": "number", "default": 1, "x-merge": "scalar" },
+    "aid": { "type": "string", "description": "Agent 标识（必填）", "x-merge": "scalar" },
+    "enabled": { "type": "boolean", "description": "Agent 启用状态", "x-merge": "scalar" },
+    "initialized": { "type": "boolean", "description": "AUN 首次初始化标记", "x-merge": "scalar" },
+    "owners": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Agent owner（AID，沿链并集）",
+      "x-merge": "list"
+    },
+    "admins": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Agent 管理员（AID，沿链并集）",
+      "x-merge": "list"
+    },
+    "channels": {
+      "type": "array",
+      "items": { "type": "object" },
+      "description": "渠道实例（含 appSecret/token，应为 ${VAR} 引用）",
+      "x-merge": "list"
+    },
+    "aun": {
+      "type": "object",
+      "description": "该 agent 的 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "models": {
+      "type": "object",
+      "description": "模型白名单（覆盖 defaults）",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string" },
+        "allowed": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "active_baseagent": {
+      "type": "string",
+      "description": "当前活跃的 base agent（claude/codex/gemini）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "scalar"
+    },
+    "baseagents": {
+      "type": "object",
+      "description": "各 base agent 配置（model/effort/apiKey/baseUrl 等）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "dict"
+    },
+    "projects": {
+      "type": "object",
+      "description": "项目路径配置",
+      "x-merge": "dict",
+      "properties": {
+        "defaultPath": { "type": "string", "description": "Agent 项目路径" }
+      }
+    },
+    "debug": {
+      "type": "object",
+      "description": "调试配置",
+      "x-merge": "dict",
+      "properties": {
+        "logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"] },
+        "flusherDiag": { "type": "boolean" },
+        "aunTrace": { "type": "boolean" },
+        "aunSdkLog": { "type": "boolean" },
+        "upmsg": { "type": "boolean" }
+      }
+    },
+    "observable": { "type": "boolean", "description": "观察者模式：入站/出站各转一份给 owners", "x-merge": "scalar" },
+    "chatmode": {
+      "type": "object",
+      "description": "聊天模式配置（private/group/nothuman）",
+      "x-merge": "dict",
+      "properties": {
+        "private": { "type": "string", "enum": ["interactive", "proactive"], "description": "私聊模式" },
+        "group": { "type": "string", "enum": ["interactive", "proactive"], "description": "群聊模式" },
+        "nothuman": { "type": "string", "enum": ["interactive", "proactive"], "description": "无人类场景模式" }
+      }
+    },
+    "dispatch": {
+      "type": "string",
+      "enum": ["mention", "broadcast", "none"],
+      "description": "群聊响应策略：mention=仅@时, broadcast=所有消息, none=不响应",
+      "x-merge": "scalar"
+    },
+    "response_modes": {
+      "type": "object",
+      "description": "响应模式配置（响应系统插件化）。default_private/default_group/configs/overrides 按第一层键合并",
+      "x-merge": "dict",
+      "properties": {
+        "default_private": { "type": "string", "description": "单聊默认响应模式 id" },
+        "default_group": { "type": "string", "description": "群聊默认响应模式 id" },
+        "configs": { "type": "object", "description": "各模式配置参数（modeId → 配置对象）" },
+        "overrides": { "type": "object", "description": "按对端/群覆盖（peerKey → {mode, config}）" }
+      }
+    },
+    "extra_backup": {
+      "type": "array",
+      "description": "快照额外备份文件声明（不得指向 .env）",
+      "x-merge": "list",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string" },
+          "pattern": { "type": "string" }
+        }
+      }
+    },
+    "lifecycle": {
+      "type": "string",
+      "enum": ["created", "bootstrapping", "active"],
+      "description": "Agent 生命周期状态",
+      "x-merge": "scalar"
+    },
+    "capabilities": {
+      "type": "object",
+      "description": "Agent 能力配置",
+      "x-merge": "dict"
+    },
+    "flush_delay": {
+      "type": "number",
+      "description": "消息 flush 间隔（毫秒）",
+      "x-merge": "scalar"
+    },
+    "debounce": {
+      "type": "number",
+      "description": "入站消息去抖间隔（毫秒）",
+      "x-merge": "scalar"
+    },
+    "show_activities": {
+      "type": "string",
+      "enum": ["all", "text", "none"],
+      "description": "中间活动可见性",
+      "x-merge": "scalar"
+    },
+    "proactive": {
+      "type": "object",
+      "description": "Proactive 模式策略配置",
+      "x-merge": "dict"
+    },
+    "render": {
+      "type": "object",
+      "description": "渲染配置",
+      "x-merge": "dict"
+    },
+    "enable_rich_content": {
+      "type": "boolean",
+      "description": "启用富内容渲染",
+      "x-merge": "scalar"
+    },
+    "permissionMode": {
+      "type": "string",
+      "description": "权限模式",
+      "x-merge": "scalar"
+    },
+    "roles": {
+      "type": "object",
+      "description": "角色配置（RBAC）",
+      "x-merge": "dict"
+    }
+  }
+}

package/kits/schemas/agent-config.schema.2.json

@@ -0,0 +1,239 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.2.json",
+  "title": "AgentConfig (agents/{aid}/config.json)",
+  "description": "单 agent 的身份、凭证、管控字段。覆盖链中级，覆盖 defaults。",
+  "x-logical-name": "agent-config",
+  "x-scope": "agent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["aid", "channels"],
+  "properties": {
+    "$schema_version": { "type": "number", "default": 2, "x-merge": "scalar" },
+    "aid": { "type": "string", "description": "Agent 标识（必填）", "x-merge": "scalar" },
+    "enabled": { "type": "boolean", "description": "Agent 启用状态", "x-merge": "scalar" },
+    "lifecycle": {
+      "type": "string",
+      "enum": ["created", "bootstrapping", "active"],
+      "description": "Agent 生命周期状态：created → bootstrapping → active",
+      "x-merge": "scalar"
+    },
+    "initialized": { "type": "boolean", "description": "Deprecated: AUN 首次初始化标记，仅兼容旧配置", "x-merge": "scalar" },
+    "owners": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?){2,}$"
+      },
+      "uniqueItems": true,
+      "description": "Static agent owner AID allowlist. These owners resolve to owner before scoped role assignments and relation-level config.",
+      "x-merge": "list"
+    },
+    "channels": {
+      "type": "array",
+      "items": { "type": "object" },
+      "description": "渠道实例（含 appSecret/token，应为 ${VAR} 引用）",
+      "x-merge": "list"
+    },
+    "aun": {
+      "type": "object",
+      "description": "该 agent 的 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "models": {
+      "type": "object",
+      "description": "模型白名单（覆盖 defaults）",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string" },
+        "allowed": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "active_baseagent": {
+      "type": "string",
+      "description": "当前活跃的 base agent（claude/codex/gemini）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "scalar"
+    },
+    "baseagents": {
+      "type": "object",
+      "description": "各 base agent 配置（model/effort/apiKey/baseUrl 等）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "dict"
+    },
+    "projects": {
+      "type": "object",
+      "description": "项目路径配置",
+      "x-merge": "dict",
+      "properties": {
+        "defaultPath": { "type": "string", "description": "Agent 项目路径" }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "description": "EvolCore 层能力策略（baseagent → type → mode/overrides）",
+      "x-merge": "dict",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "skill": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "mode": { "type": "string", "enum": ["inherit", "all", "none"] },
+              "overrides": {
+                "type": "object",
+                "additionalProperties": { "type": "string", "enum": ["enabled", "disabled"] }
+              }
+            }
+          },
+          "mcp": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "mode": { "type": "string", "enum": ["inherit", "all", "none"] },
+              "overrides": {
+                "type": "object",
+                "additionalProperties": { "type": "string", "enum": ["enabled", "disabled"] }
+              }
+            }
+          },
+          "plugin": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "mode": { "type": "string", "enum": ["inherit", "all", "none"] },
+              "overrides": {
+                "type": "object",
+                "additionalProperties": { "type": "string", "enum": ["enabled", "disabled"] }
+              }
+            }
+          }
+        }
+      }
+    },
+    "debug": {
+      "type": "object",
+      "description": "调试配置",
+      "x-merge": "dict",
+      "properties": {
+        "logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"] },
+        "flusherDiag": { "type": "boolean" },
+        "aunTrace": { "type": "boolean" },
+        "aunSdkLog": { "type": "boolean" },
+        "upmsg": { "type": "boolean" }
+      }
+    },
+    "observable": { "type": "boolean", "description": "观察者模式：入站/出站各转一份给 owner 角色对端", "x-merge": "scalar" },
+    "chatmode": {
+      "type": "object",
+      "description": "聊天模式配置（private/group/nothuman）",
+      "x-merge": "dict",
+      "properties": {
+        "private": { "type": "string", "enum": ["interactive", "proactive"], "description": "私聊模式" },
+        "group": { "type": "string", "enum": ["interactive", "proactive"], "description": "群聊模式" },
+        "nothuman": { "type": "string", "enum": ["interactive", "proactive"], "description": "无人类场景模式" }
+      }
+    },
+    "response_modes": {
+      "type": "object",
+      "description": "响应模式配置（响应系统插件化）。default_private/default_group/configs/overrides 按第一层键合并",
+      "x-merge": "dict",
+      "properties": {
+        "default_private": { "type": "string", "description": "单聊默认响应模式 id" },
+        "default_group": { "type": "string", "description": "群聊默认响应模式 id" },
+        "configs": { "type": "object", "description": "各模式配置参数（modeId → 配置对象）" },
+        "overrides": { "type": "object", "description": "按对端/群覆盖（peerKey → {mode, config}）" }
+      }
+    },
+    "flush_delay": {
+      "type": "number",
+      "description": "消息 flush 间隔（秒）",
+      "x-merge": "scalar"
+    },
+    "debounce": {
+      "type": "number",
+      "description": "入站消息去抖间隔（秒）",
+      "x-merge": "scalar"
+    },
+    "dispatch": {
+      "type": "string",
+      "enum": ["mention", "broadcast"],
+      "description": "群聊分发策略：mention=仅@时响应, broadcast=广播响应",
+      "x-merge": "scalar"
+    },
+    "show_activities": {
+      "type": "string",
+      "enum": ["all", "text", "none"],
+      "description": "中间活动可见性",
+      "x-merge": "scalar"
+    },
+    "proactive": {
+      "type": "object",
+      "description": "Proactive 模式细粒度策略",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "pre_tool_1stmsgchk": {
+          "type": "boolean",
+          "description": "Proactive 下首次工具调用前必须先 send/file 表态"
+        },
+        "tool_use_reminder": {
+          "type": "boolean",
+          "description": "Proactive 下启用队列未读提醒和工具汇报提醒"
+        }
+      }
+    },
+    "render": {
+      "type": "object",
+      "description": "各渲染类型当前激活的 modeName",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "private": { "type": "string", "description": "私聊渲染模式名称" },
+        "group": { "type": "string", "description": "群聊渲染模式名称" },
+        "inject": { "type": "string", "description": "注入渲染模式名称" }
+      }
+    },
+    "enable_rich_content": {
+      "type": "boolean",
+      "description": "启用富内容渲染",
+      "x-merge": "scalar"
+    },
+    "permissionMode": {
+      "type": "string",
+      "description": "执行权限模式；公开值为 readonly/auto/request/bypass，历史 edit/plan/noask 在运行时安全迁移",
+      "x-merge": "scalar"
+    },
+    "roles": {
+      "type": "object",
+      "description": "角色级行为覆盖：role → { baseagents, permissionMode }",
+      "x-merge": "dict",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "baseagents": { "type": "object", "description": "角色级 baseagents 覆盖" },
+          "permissionMode": { "type": "string", "description": "角色级 permissionMode 覆盖" }
+        }
+      }
+    },
+    "extra_backup": {
+      "type": "array",
+      "description": "快照额外备份文件声明（不得指向 .env）",
+      "x-merge": "list",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string" },
+          "pattern": { "type": "string" }
+        }
+      }
+    }
+  }
+}