evolcore 0.0.25 → 0.0.26

package/kits/rules/06-channel.md

@@ -1,63 +1,63 @@
-# 渠道层：我通过什么通信
-
-渠道层决定你使用什么方式收发消息。ECK 在 channel fragment 注入 `channel`
-（取值 `aun|feishu|wechat|dingtalk|qqbot|wecom`）。变量名就是小写 `channel`，没有 `$CHANNEL_TYPE`。
-
-## 数据位置
-
-| 位置 | 内容 |
-|------|------|
-| `$KITS_DOCS/channels/` | 各渠道的**知识文档**：配置、参数、特有机制（只读，按需加载） |
-| `$AGENT_DIR/config.json` 的 `channels[]` | 该 agent 接入的渠道实配置（类型、凭据、网关等） |
-
-> **没有 `$AGENT_DIR/channels/` 目录**——渠道不按目录分家：配置在 `config.json` 的
-> `channels[]` 列表里，运行时状态落会话层 `$AGENT_DIR/sessions/`。
-> `$KITS_DOCS/channels/` 是**不依赖当前渠道**的知识库，任意会话都可按需 Read 任意渠道文档。
-
-## 通信规则
-
-"当前这一刻怎么回复、怎么发消息"由动态注入的 `[channel]` 段决定——它能拿到 `chatMode`
-并按模式分流，是唯一的事实源。本节只讲**模式无关的恒定知识**。
-
-要点：
-- **回复方式随 `chatMode` 走**，以 `[channel]` 段为准：
-  - interactive：直接输出即回复
-  - proactive：见 `[channel]` 段的机制说明（thought.put vs message.send）
-- **附加能力与模式无关、始终需要 CLI**：发文件/图片/语音、@某人、加密、联系第三方
-- **以自己的 AID 为发送者**；拿不到时退回 `ec ctl send "<text>"`
-
-### 命令返回值
-
-判断成败**看 exit code**，别靠字符串前缀——各命令集格式不统一：
-
-- `ec ctl send`：成功打印 `ok`；失败把**裸错误信息**打到 stderr（如 `消息内容不能为空`、`adapter 未找到: feishu`），exit≠0
-- `ec msg` / `ec group` 发送类：成功 `✓ 已发送 message_id=… seq=…`；失败 `❌ 发送失败: <原因>`，exit≠0
-
-发送成功后**继续后续处理**。一次任务可能发 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>` **不是全局参数**：只在自身 `--help` 明确列出的命令上有效
-  （`--app` 主要用于消息 pull/ack、消费类 RPC 和支持 app slot 的文件操作）。拿不准就先跑 `--help`
-
-## 各渠道知识文档（按需加载）
-
-`$KITS_DOCS/channels/` 下每个渠道一份知识文档，内容是该渠道的**配置、参数、特有机制**——
-属于知识性内容，**不依赖**当前注入的渠道类型。需要了解某渠道怎么配置、有哪些参数、
-有哪些特别机制时，按需 Read 对应文档（在 aun 会话里也可查飞书，反之亦然）。
-
-| 渠道 | 文档 | 触发词 |
-|------|------|--------|
-| AUN | `$KITS_DOCS/channels/aun.md` | aun 怎么配置/网关/E2EE/群 ID 格式/证书链 |
-| 飞书 | `$KITS_DOCS/channels/feishu.md` | 飞书怎么配置/appId/合并转发/卡片/user_id |
+# 渠道层：我通过什么通信
+
+渠道层决定你使用什么方式收发消息。ECK 在 channel fragment 注入 `channel`
+（取值 `aun|feishu|wechat|dingtalk|qqbot|wecom`）。变量名就是小写 `channel`，没有 `$CHANNEL_TYPE`。
+
+## 数据位置
+
+| 位置 | 内容 |
+|------|------|
+| `$KITS_DOCS/channels/` | 各渠道的**知识文档**：配置、参数、特有机制（只读，按需加载） |
+| `$AGENT_DIR/config.json` 的 `channels[]` | 该 agent 接入的渠道实配置（类型、凭据、网关等） |
+
+> **没有 `$AGENT_DIR/channels/` 目录**——渠道不按目录分家：配置在 `config.json` 的
+> `channels[]` 列表里，运行时状态落会话层 `$AGENT_DIR/sessions/`。
+> `$KITS_DOCS/channels/` 是**不依赖当前渠道**的知识库，任意会话都可按需 Read 任意渠道文档。
+
+## 通信规则
+
+"当前这一刻怎么回复、怎么发消息"由动态注入的 `[channel]` 段决定——它能拿到 `chatMode`
+并按模式分流，是唯一的事实源。本节只讲**模式无关的恒定知识**。
+
+要点：
+- **回复方式随 `chatMode` 走**，以 `[channel]` 段为准：
+  - interactive：直接输出即回复
+  - proactive：见 `[channel]` 段的机制说明（thought.put vs message.send）
+- **附加能力与模式无关、始终需要 CLI**：发文件/图片/语音、@某人、加密、联系第三方
+- **以自己的 AID 为发送者**；拿不到时退回 `ec ctl send "<text>"`
+
+### 命令返回值
+
+判断成败**看 exit code**，别靠字符串前缀——各命令集格式不统一：
+
+- `ec ctl send`：成功打印 `ok`；失败把**裸错误信息**打到 stderr（如 `消息内容不能为空`、`adapter 未找到: feishu`），exit≠0
+- `ec msg` / `ec group` 发送类：成功 `✓ 已发送 message_id=… seq=…`；失败 `❌ 发送失败: <原因>`，exit≠0
+
+发送成功后**继续后续处理**。一次任务可能发 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>` **不是全局参数**：只在自身 `--help` 明确列出的命令上有效
+  （`--app` 主要用于消息 pull/ack、消费类 RPC 和支持 app slot 的文件操作）。拿不准就先跑 `--help`
+
+## 各渠道知识文档（按需加载）
+
+`$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

@@ -1,53 +1,53 @@
-{
-  "schemas": {
-    "daemon":          { "currentVersion": 6 },
-    "defaults":        { "currentVersion": 5 },
-    "agent-config":    { "currentVersion": 12 },
-    "relation-config": { "currentVersion": 8 },
-    "contact-book":    { "currentVersion": 3 },
-    "single-session":  { "currentVersion": 3 },
-    "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" },
-    { "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" },
-    { "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": "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": "single-session",  "version": 3, "date": "2026-08-31", "description": "move Session Renew auxiliary model and effort from mode buckets into baseagent settings" },
-    { "schema": "daemon",          "version": 3, "date": "2026-07-29", "description": "make daemon.json the exclusive source for all process debug settings" },
-    { "schema": "daemon",          "version": 4, "date": "2026-08-04", "description": "add configurable default AID domain for generated identities" },
-    { "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" },
-    { "schema": "defaults",        "version": 4, "date": "2026-08-02", "description": "add defaults-only fallback model chain" },
-    { "schema": "agent-config",    "version": 10, "date": "2026-08-02", "description": "reject Agent-level fallback model chain" },
-    { "schema": "relation-config", "version": 8, "date": "2026-08-02", "description": "reject relation-level fallback model chain" },
-    { "schema": "daemon",          "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
-    { "schema": "daemon",          "version": 6, "date": "2026-09-01", "description": "unify local service lifecycle and AUN proxy settings under services[]" },
-    { "schema": "defaults",        "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
-    { "schema": "agent-config",    "version": 11, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
-    { "schema": "agent-config",    "version": 12, "date": "2026-09-04", "description": "add Agent-level AUN group slash structured-mention policy" }
-  ]
-}
+{
+  "schemas": {
+    "daemon":          { "currentVersion": 6 },
+    "defaults":        { "currentVersion": 5 },
+    "agent-config":    { "currentVersion": 12 },
+    "relation-config": { "currentVersion": 8 },
+    "contact-book":    { "currentVersion": 3 },
+    "single-session":  { "currentVersion": 3 },
+    "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" },
+    { "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" },
+    { "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": "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": "single-session",  "version": 3, "date": "2026-08-31", "description": "move Session Renew auxiliary model and effort from mode buckets into baseagent settings" },
+    { "schema": "daemon",          "version": 3, "date": "2026-07-29", "description": "make daemon.json the exclusive source for all process debug settings" },
+    { "schema": "daemon",          "version": 4, "date": "2026-08-04", "description": "add configurable default AID domain for generated identities" },
+    { "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" },
+    { "schema": "defaults",        "version": 4, "date": "2026-08-02", "description": "add defaults-only fallback model chain" },
+    { "schema": "agent-config",    "version": 10, "date": "2026-08-02", "description": "reject Agent-level fallback model chain" },
+    { "schema": "relation-config", "version": 8, "date": "2026-08-02", "description": "reject relation-level fallback model chain" },
+    { "schema": "daemon",          "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
+    { "schema": "daemon",          "version": 6, "date": "2026-09-01", "description": "unify local service lifecycle and AUN proxy settings under services[]" },
+    { "schema": "defaults",        "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
+    { "schema": "agent-config",    "version": 11, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
+    { "schema": "agent-config",    "version": 12, "date": "2026-09-04", "description": "add Agent-level AUN group slash structured-mention policy" }
+  ]
+}

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

@@ -1,177 +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"
-    }
-  }
-}
+{
+  "$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"
+    }
+  }
+}