evolcore 0.0.25 → 0.0.26

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

@@ -1,208 +1,208 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "agent-config.schema.4.json",
-  "title": "AgentConfig (agents/{aid}/config.json)",
-  "x-logical-name": "agent-config",
-  "x-scope": "agent",
-  "type": "object",
-  "additionalProperties": true,
-  "not": { "required": ["permissionMode"] },
-  "required": ["aid", "channels"],
-  "properties": {
-    "$schema_version": { "type": "number", "default": 4, "x-merge": "scalar", "description": "配置 Schema 版本；v4 使用角色级字段权限策略" },
-    "aid": { "type": "string", "x-merge": "scalar", "description": "Agent 的全局唯一身份标识" },
-    "enabled": { "type": "boolean", "default": true, "x-merge": "scalar", "description": "是否启用 Agent；缺省按启用处理" },
-    "lifecycle": { "type": "string", "enum": ["created", "bootstrapping", "active"], "x-merge": "scalar", "description": "agent 生命周期状态", "x-enumDescriptions": { "created": "已创建，尚未进入引导流程", "bootstrapping": "引导中（初始化配置/身份）", "active": "已激活，正常运行" } },
-    "initialized": { "type": "boolean", "x-merge": "scalar", "description": "是否已完成 Agent 初始化流程" },
-    "owners": { "type": "array", "items": { "type": "string" }, "uniqueItems": true, "x-merge": "list", "description": "Agent 所有者身份列表；用于 owner 级控制和通知" },
-    "admins": { "type": "array", "items": { "type": "string" }, "uniqueItems": true, "x-merge": "list", "description": "Agent 管理员身份列表" },
-    "channels": { "type": "array", "items": { "type": "object" }, "x-merge": "list", "description": "Agent 绑定的消息渠道实例列表" },
-    "aun": { "type": "object", "x-merge": "dict", "description": "Agent 级 AUN 通信配置" },
-    "models": { "type": "object", "x-merge": "dict", "description": "Agent 级模型别名、注册表或模型覆盖配置" },
-    "active_baseagent": { "type": "string", "x-merge": "scalar", "description": "默认使用的 base agent 标识，例如 claude 或 codex" },
-    "baseagents": { "type": "object", "x-merge": "dict", "description": "各 base agent 的模型、推理强度及运行参数" },
-    "projects": { "type": "object", "x-merge": "dict", "description": "Agent 可用项目路径和项目选择配置" },
-    "capabilities": { "type": "object", "x-merge": "dict", "description": "Agent 能力开关及能力参数" },
-    "debug": { "type": "object", "x-merge": "dict", "description": "Agent 级调试和诊断配置" },
-    "observable": { "type": "boolean", "default": false, "x-merge": "scalar", "description": "是否将 Agent 的入站和出站消息转发给 owners；默认关闭" },
-    "chatmode": { "type": "object", "x-merge": "dict", "default": { "private": "interactive", "group": "proactive", "nothuman": "proactive" }, "properties": { "private": { "enum": ["interactive", "proactive"], "description": "人类私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "group": { "enum": ["interactive", "proactive"], "description": "群聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "nothuman": { "enum": ["interactive", "proactive"], "description": "非人类（agent）私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } } }, "additionalProperties": false, "description": "chatmode 场景默认表；出厂默认值即此 default（agent 级改默认，关系级按键覆盖）。键封闭 private/group/nothuman，值枚举 interactive/proactive" },
-    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "default": "disabled", "x-merge": "scalar", "description": "@ 处理策略（顶层通用参数）", "x-enumDescriptions": { "disabled": "处理所有消息", "mention-only": "只处理被 @ 的消息，未 @ 作引用上下文" } },
-    "model": { "type": "string", "x-merge": "scalar", "description": "主会话模型（顶层通用参数）；无默认值，缺省时由响应模式/全局默认决定" },
-    "responseMode": { "type": "string", "x-merge": "scalar", "description": "响应模式 id（标量）；候选清单/默认值来自注册表，非 schema。关系级>agent级>注册表首选" },
-    "responseModeParams": { "type": "object", "x-merge": "dict", "description": "响应模式特有参数字典，按模式 id 分桶：{ [modeId]: {...} }" },
-    "flush_delay": { "type": "number", "minimum": 0, "default": 3, "x-merge": "scalar", "description": "流式出站消息的批量刷新间隔，单位为秒；默认 3 秒" },
-    "debounce": { "type": "number", "minimum": 0, "default": 0, "x-merge": "scalar", "description": "入站消息合并窗口，单位为秒；0 表示不合并，默认 0" },
-    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "default": "all", "x-merge": "scalar", "description": "中间输出展示范围（仅对 interactive 私聊有意义）", "x-enumDescriptions": { "all": "文本 + activity", "text": "仅文本", "none": "全部静默" } },
-    "session_renew": {
-      "type": "object",
-      "x-merge": "dict",
-      "additionalProperties": false,
-      "description": "会话超时后的续接判定",
-      "properties": {
-        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
-        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
-        "effort": { "type": "string", "enum": ["low", "medium", "high", "xhigh", "max"], "default": "low", "description": "续接判定的推理强度", "x-enumDescriptions": { "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
-        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
-      }
-    },
-    "group_venue_sync": { "type": "object", "x-merge": "dict" },
-    "render": { "type": "object", "x-merge": "dict" },
-    "sessionManifests": { "type": "object", "x-merge": "dict" },
-    "enable_rich_content": { "type": "boolean", "x-merge": "scalar", "description": "是否允许渠道使用富内容消息；未设置时由渠道能力和运行时默认决定" },
-    "roles": {
-      "type": "object",
-      "x-merge": "dict",
-      "additionalProperties": false,
-      "description": "Agent 级角色策略。权限模式仅在角色定义中配置，关系配置不可直接覆盖。",
-      "properties": {
-        "defaultRoles": {
-          "type": "object",
-          "additionalProperties": false,
-          "default": { "private": null, "group": null },
-          "description": "未显式分配角色时，私聊和群聊使用的默认角色；null 表示不授予默认角色。",
-          "properties": {
-            "private": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "私聊对端的默认角色；必须引用内置或 definitions 中的角色。" },
-            "group": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "群聊对端的默认角色；必须引用内置或 definitions 中的角色。" }
-          }
-        },
-        "definitions": {
-          "type": "object",
-          "propertyNames": { "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$" },
-          "description": "自定义角色定义。owner 和 admin 为系统保留角色，不能在此重定义。",
-          "additionalProperties": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["description", "permissions"],
-            "description": "一个自定义角色的访问、字段权限、命令权限及用量限制。",
-            "properties": {
-              "description": { "type": "string", "description": "角色的用途和授权边界说明。" },
-              "allowAccess": { "type": "boolean", "default": true, "description": "是否允许该角色访问 Agent；缺省为 true。" },
-              "permissions": {
-                "type": "object",
-                "required": ["permissionMode"],
-                "description": "角色对可配置行为字段施加的默认值、关系级覆盖权和可选值约束。",
-                "properties": {
-                  "permissionMode": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride"],
-                    "description": "工具调用的审批策略（角色级）",
-                    "properties": {
-                      "default": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "description": "角色默认的工具调用审批策略；未得到有效角色策略时运行时安全回退为 readonly。", "x-enumDescriptions": { "readonly": "只读模式：明确只读工具和普通路径上的受限只读 Shell 自动执行；写入、H/L 类读取、未知 Shell 和未知工具拒绝；EC 命令仍由 daemon 鉴权", "auto": "自动模式：常规 workspace 操作自动执行，已识别危险操作和扩权请求拒绝", "request": "请求模式：常规操作自动执行，危险 Bash 和沙箱扩权请求人工审批", "bypass": "放行模式：沙箱内常规和普通审批命令自动执行，强危险 Git 和越界扩权仍需审批" } },
-                      "allowOverride": { "const": false, "default": false, "description": "权限模式禁止关系级覆盖，固定为 false。" },
-                      "allowedValues": {
-                        "type": "array",
-                        "items": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"] },
-                        "uniqueItems": true,
-                        "description": "保留的权限模式候选集合；permissionMode 当前不可由关系级覆盖，通常无需配置。"
-                      },
-                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
-                    }
-                  },
-                  "chatmode.private": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride"],
-                    "description": "角色在私聊场景中的响应方式策略。",
-                    "properties": {
-                      "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的私聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
-                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖私聊响应方式；默认不允许。" },
-                      "allowedValues": {
-                        "type": "array",
-                        "items": { "type": "string", "enum": ["interactive", "proactive"] },
-                        "uniqueItems": true,
-                        "description": "允许覆盖到的响应方式白名单；未配置或为空时不额外限制枚举值。"
-                      },
-                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
-                    }
-                  },
-                  "chatmode.group": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride"],
-                    "description": "角色在群聊场景中的响应方式策略。",
-                    "properties": {
-                      "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的群聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
-                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊响应方式；默认不允许。" },
-                      "allowedValues": {
-                        "type": "array",
-                        "items": { "type": "string", "enum": ["interactive", "proactive"] },
-                        "uniqueItems": true,
-                        "description": "允许覆盖到的响应方式白名单；未配置或为空时不额外限制枚举值。"
-                      },
-                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
-                    }
-                  },
-                  "baseagents.claude.effort": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride"],
-                    "description": "Claude runner 的推理强度策略。",
-                    "properties": {
-                      "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Claude 推理强度。", "x-enumDescriptions": { "auto": "自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
-                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖 Claude 推理强度；默认不允许。" },
-                      "allowedValues": {
-                        "type": "array",
-                        "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"] },
-                        "uniqueItems": true,
-                        "description": "允许关系级覆盖的 Claude 推理强度白名单。"
-                      },
-                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
-                    }
-                  },
-                  "baseagents.codex.reasoning": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride"],
-                    "description": "Codex runner 的推理强度策略。",
-                    "properties": {
-                      "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } },
-                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖 Codex 推理强度；默认不允许。" },
-                      "allowedValues": {
-                        "type": "array",
-                        "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"] },
-                        "uniqueItems": true,
-                        "description": "允许关系级覆盖的 Codex 推理强度白名单。"
-                      },
-                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
-                    }
-                  }
-                },
-                "patternProperties": {
-                  "^baseagents\\.[a-z0-9_-]+\\.model$": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "required": ["default", "allowOverride", "allowedModels"],
-                    "description": "指定 base agent 的模型选择策略；模型必须同时匹配 allowedModels。",
-                    "properties": {
-                      "default": { "type": "string", "minLength": 1, "description": "角色默认模型标识；必须被 allowedModels 中的精确值或通配符允许。" },
-                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖模型；默认不允许。" },
-                      "allowedModels": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "description": "模型白名单；支持以 * 结尾的前缀通配符，且至少包含一个模型。" },
-                      "reason": { "type": "string", "description": "采用该角色模型策略的可审计原因或管理备注。" }
-                    }
-                  }
-                },
-                "additionalProperties": false
-              },
-              "commandPermissions": { "type": "object", "description": "按 operation 标识控制命令是否允许执行，可附带作用域、危险标记和约束。" },
-              "usageLimits": {
-                "type": "object",
-                "additionalProperties": false,
-                "description": "角色用量额度策略；enabled 未开启或未配置时不启用额度限制。",
-                "properties": {
-                  "enabled": { "type": "boolean", "default": false, "description": "是否启用该角色的用量额度限制；默认关闭。" },
-                  "resetMode": { "type": "string", "enum": ["never", "daily", "weekly", "monthly"], "description": "用量额度的重置周期", "x-enumDescriptions": { "never": "从不重置", "daily": "每日重置", "weekly": "每周重置", "monthly": "每月重置" } },
-                  "currency": { "type": "string", "enum": ["CNY", "USD"], "description": "额度计价货币", "x-enumDescriptions": { "CNY": "人民币", "USD": "美元" } },
-                  "limitAmount": { "type": ["number", "null"], "minimum": 0, "description": "额度上限金额；null 表示不限" },
-                  "costBasis": { "type": "string", "enum": ["gateway", "official"], "description": "计费口径", "x-enumDescriptions": { "gateway": "按网关计费价", "official": "按官方定价" } },
-                  "scope": { "type": "string", "enum": ["subject", "role"], "description": "额度统计范围", "x-enumDescriptions": { "subject": "按主体（对端）统计", "role": "按角色统计" } }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.4.json",
+  "title": "AgentConfig (agents/{aid}/config.json)",
+  "x-logical-name": "agent-config",
+  "x-scope": "agent",
+  "type": "object",
+  "additionalProperties": true,
+  "not": { "required": ["permissionMode"] },
+  "required": ["aid", "channels"],
+  "properties": {
+    "$schema_version": { "type": "number", "default": 4, "x-merge": "scalar", "description": "配置 Schema 版本；v4 使用角色级字段权限策略" },
+    "aid": { "type": "string", "x-merge": "scalar", "description": "Agent 的全局唯一身份标识" },
+    "enabled": { "type": "boolean", "default": true, "x-merge": "scalar", "description": "是否启用 Agent；缺省按启用处理" },
+    "lifecycle": { "type": "string", "enum": ["created", "bootstrapping", "active"], "x-merge": "scalar", "description": "agent 生命周期状态", "x-enumDescriptions": { "created": "已创建，尚未进入引导流程", "bootstrapping": "引导中（初始化配置/身份）", "active": "已激活，正常运行" } },
+    "initialized": { "type": "boolean", "x-merge": "scalar", "description": "是否已完成 Agent 初始化流程" },
+    "owners": { "type": "array", "items": { "type": "string" }, "uniqueItems": true, "x-merge": "list", "description": "Agent 所有者身份列表；用于 owner 级控制和通知" },
+    "admins": { "type": "array", "items": { "type": "string" }, "uniqueItems": true, "x-merge": "list", "description": "Agent 管理员身份列表" },
+    "channels": { "type": "array", "items": { "type": "object" }, "x-merge": "list", "description": "Agent 绑定的消息渠道实例列表" },
+    "aun": { "type": "object", "x-merge": "dict", "description": "Agent 级 AUN 通信配置" },
+    "models": { "type": "object", "x-merge": "dict", "description": "Agent 级模型别名、注册表或模型覆盖配置" },
+    "active_baseagent": { "type": "string", "x-merge": "scalar", "description": "默认使用的 base agent 标识，例如 claude 或 codex" },
+    "baseagents": { "type": "object", "x-merge": "dict", "description": "各 base agent 的模型、推理强度及运行参数" },
+    "projects": { "type": "object", "x-merge": "dict", "description": "Agent 可用项目路径和项目选择配置" },
+    "capabilities": { "type": "object", "x-merge": "dict", "description": "Agent 能力开关及能力参数" },
+    "debug": { "type": "object", "x-merge": "dict", "description": "Agent 级调试和诊断配置" },
+    "observable": { "type": "boolean", "default": false, "x-merge": "scalar", "description": "是否将 Agent 的入站和出站消息转发给 owners；默认关闭" },
+    "chatmode": { "type": "object", "x-merge": "dict", "default": { "private": "interactive", "group": "proactive", "nothuman": "proactive" }, "properties": { "private": { "enum": ["interactive", "proactive"], "description": "人类私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "group": { "enum": ["interactive", "proactive"], "description": "群聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "nothuman": { "enum": ["interactive", "proactive"], "description": "非人类（agent）私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } } }, "additionalProperties": false, "description": "chatmode 场景默认表；出厂默认值即此 default（agent 级改默认，关系级按键覆盖）。键封闭 private/group/nothuman，值枚举 interactive/proactive" },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "default": "disabled", "x-merge": "scalar", "description": "@ 处理策略（顶层通用参数）", "x-enumDescriptions": { "disabled": "处理所有消息", "mention-only": "只处理被 @ 的消息，未 @ 作引用上下文" } },
+    "model": { "type": "string", "x-merge": "scalar", "description": "主会话模型（顶层通用参数）；无默认值，缺省时由响应模式/全局默认决定" },
+    "responseMode": { "type": "string", "x-merge": "scalar", "description": "响应模式 id（标量）；候选清单/默认值来自注册表，非 schema。关系级>agent级>注册表首选" },
+    "responseModeParams": { "type": "object", "x-merge": "dict", "description": "响应模式特有参数字典，按模式 id 分桶：{ [modeId]: {...} }" },
+    "flush_delay": { "type": "number", "minimum": 0, "default": 3, "x-merge": "scalar", "description": "流式出站消息的批量刷新间隔，单位为秒；默认 3 秒" },
+    "debounce": { "type": "number", "minimum": 0, "default": 0, "x-merge": "scalar", "description": "入站消息合并窗口，单位为秒；0 表示不合并，默认 0" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "default": "all", "x-merge": "scalar", "description": "中间输出展示范围（仅对 interactive 私聊有意义）", "x-enumDescriptions": { "all": "文本 + activity", "text": "仅文本", "none": "全部静默" } },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "description": "会话超时后的续接判定",
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "effort": { "type": "string", "enum": ["low", "medium", "high", "xhigh", "max"], "default": "low", "description": "续接判定的推理强度", "x-enumDescriptions": { "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar", "description": "是否允许渠道使用富内容消息；未设置时由渠道能力和运行时默认决定" },
+    "roles": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "description": "Agent 级角色策略。权限模式仅在角色定义中配置，关系配置不可直接覆盖。",
+      "properties": {
+        "defaultRoles": {
+          "type": "object",
+          "additionalProperties": false,
+          "default": { "private": null, "group": null },
+          "description": "未显式分配角色时，私聊和群聊使用的默认角色；null 表示不授予默认角色。",
+          "properties": {
+            "private": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "私聊对端的默认角色；必须引用内置或 definitions 中的角色。" },
+            "group": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "群聊对端的默认角色；必须引用内置或 definitions 中的角色。" }
+          }
+        },
+        "definitions": {
+          "type": "object",
+          "propertyNames": { "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$" },
+          "description": "自定义角色定义。owner 和 admin 为系统保留角色，不能在此重定义。",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["description", "permissions"],
+            "description": "一个自定义角色的访问、字段权限、命令权限及用量限制。",
+            "properties": {
+              "description": { "type": "string", "description": "角色的用途和授权边界说明。" },
+              "allowAccess": { "type": "boolean", "default": true, "description": "是否允许该角色访问 Agent；缺省为 true。" },
+              "permissions": {
+                "type": "object",
+                "required": ["permissionMode"],
+                "description": "角色对可配置行为字段施加的默认值、关系级覆盖权和可选值约束。",
+                "properties": {
+                  "permissionMode": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride"],
+                    "description": "工具调用的审批策略（角色级）",
+                    "properties": {
+                      "default": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "description": "角色默认的工具调用审批策略；未得到有效角色策略时运行时安全回退为 readonly。", "x-enumDescriptions": { "readonly": "只读模式：明确只读工具和普通路径上的受限只读 Shell 自动执行；写入、H/L 类读取、未知 Shell 和未知工具拒绝；EC 命令仍由 daemon 鉴权", "auto": "自动模式：常规 workspace 操作自动执行，已识别危险操作和扩权请求拒绝", "request": "请求模式：常规操作自动执行，危险 Bash 和沙箱扩权请求人工审批", "bypass": "放行模式：沙箱内常规和普通审批命令自动执行，强危险 Git 和越界扩权仍需审批" } },
+                      "allowOverride": { "const": false, "default": false, "description": "权限模式禁止关系级覆盖，固定为 false。" },
+                      "allowedValues": {
+                        "type": "array",
+                        "items": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"] },
+                        "uniqueItems": true,
+                        "description": "保留的权限模式候选集合；permissionMode 当前不可由关系级覆盖，通常无需配置。"
+                      },
+                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
+                    }
+                  },
+                  "chatmode.private": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride"],
+                    "description": "角色在私聊场景中的响应方式策略。",
+                    "properties": {
+                      "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的私聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖私聊响应方式；默认不允许。" },
+                      "allowedValues": {
+                        "type": "array",
+                        "items": { "type": "string", "enum": ["interactive", "proactive"] },
+                        "uniqueItems": true,
+                        "description": "允许覆盖到的响应方式白名单；未配置或为空时不额外限制枚举值。"
+                      },
+                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
+                    }
+                  },
+                  "chatmode.group": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride"],
+                    "description": "角色在群聊场景中的响应方式策略。",
+                    "properties": {
+                      "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的群聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊响应方式；默认不允许。" },
+                      "allowedValues": {
+                        "type": "array",
+                        "items": { "type": "string", "enum": ["interactive", "proactive"] },
+                        "uniqueItems": true,
+                        "description": "允许覆盖到的响应方式白名单；未配置或为空时不额外限制枚举值。"
+                      },
+                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
+                    }
+                  },
+                  "baseagents.claude.effort": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride"],
+                    "description": "Claude runner 的推理强度策略。",
+                    "properties": {
+                      "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Claude 推理强度。", "x-enumDescriptions": { "auto": "自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
+                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖 Claude 推理强度；默认不允许。" },
+                      "allowedValues": {
+                        "type": "array",
+                        "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"] },
+                        "uniqueItems": true,
+                        "description": "允许关系级覆盖的 Claude 推理强度白名单。"
+                      },
+                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
+                    }
+                  },
+                  "baseagents.codex.reasoning": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride"],
+                    "description": "Codex runner 的推理强度策略。",
+                    "properties": {
+                      "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } },
+                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖 Codex 推理强度；默认不允许。" },
+                      "allowedValues": {
+                        "type": "array",
+                        "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"] },
+                        "uniqueItems": true,
+                        "description": "允许关系级覆盖的 Codex 推理强度白名单。"
+                      },
+                      "reason": { "type": "string", "description": "采用该角色策略的可审计原因或管理备注。" }
+                    }
+                  }
+                },
+                "patternProperties": {
+                  "^baseagents\\.[a-z0-9_-]+\\.model$": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["default", "allowOverride", "allowedModels"],
+                    "description": "指定 base agent 的模型选择策略；模型必须同时匹配 allowedModels。",
+                    "properties": {
+                      "default": { "type": "string", "minLength": 1, "description": "角色默认模型标识；必须被 allowedModels 中的精确值或通配符允许。" },
+                      "allowOverride": { "type": "boolean", "default": false, "description": "是否允许关系级覆盖模型；默认不允许。" },
+                      "allowedModels": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "description": "模型白名单；支持以 * 结尾的前缀通配符，且至少包含一个模型。" },
+                      "reason": { "type": "string", "description": "采用该角色模型策略的可审计原因或管理备注。" }
+                    }
+                  }
+                },
+                "additionalProperties": false
+              },
+              "commandPermissions": { "type": "object", "description": "按 operation 标识控制命令是否允许执行，可附带作用域、危险标记和约束。" },
+              "usageLimits": {
+                "type": "object",
+                "additionalProperties": false,
+                "description": "角色用量额度策略；enabled 未开启或未配置时不启用额度限制。",
+                "properties": {
+                  "enabled": { "type": "boolean", "default": false, "description": "是否启用该角色的用量额度限制；默认关闭。" },
+                  "resetMode": { "type": "string", "enum": ["never", "daily", "weekly", "monthly"], "description": "用量额度的重置周期", "x-enumDescriptions": { "never": "从不重置", "daily": "每日重置", "weekly": "每周重置", "monthly": "每月重置" } },
+                  "currency": { "type": "string", "enum": ["CNY", "USD"], "description": "额度计价货币", "x-enumDescriptions": { "CNY": "人民币", "USD": "美元" } },
+                  "limitAmount": { "type": ["number", "null"], "minimum": 0, "description": "额度上限金额；null 表示不限" },
+                  "costBasis": { "type": "string", "enum": ["gateway", "official"], "description": "计费口径", "x-enumDescriptions": { "gateway": "按网关计费价", "official": "按官方定价" } },
+                  "scope": { "type": "string", "enum": ["subject", "role"], "description": "额度统计范围", "x-enumDescriptions": { "subject": "按主体（对端）统计", "role": "按角色统计" } }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}