evolcore 0.0.25 → 0.0.27

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

@@ -1,326 +1,326 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "agent-config.schema.5.json",
-  "title": "AgentConfig v5 (agents/{aid}/config.json)",
-  "description": "Agent v5 主配置。保存 Agent 身份、渠道、模型、会话行为和渲染设置；角色策略已迁移到独立 roles/ 配置域。",
-  "x-logical-name": "agent-config",
-  "x-scope": "agent",
-  "type": "object",
-  "additionalProperties": true,
-  "not": {
-    "description": "禁止继续使用 v4 及更早版本的顶层权限配置；permissionMode 和 roles 均不得出现在 Agent v5 主配置中。",
-    "anyOf": [
-      {
-        "description": "禁止旧版顶层 permissionMode；权限模式由独立角色策略决定。",
-        "required": [
-          "permissionMode"
-        ]
-      },
-      {
-        "description": "禁止旧版内嵌 roles；角色定义和默认角色已迁移到独立 roles/ 配置域。",
-        "required": [
-          "roles"
-        ]
-      }
-    ]
-  },
-  "required": [
-    "aid",
-    "channels"
-  ],
-  "properties": {
-    "$schema_version": {
-      "type": "number",
-      "const": 5,
-      "default": 5,
-      "x-merge": "scalar",
-      "description": "配置 Schema 版本；v5 将角色策略移入独立 roles/ 配置域"
-    },
-    "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",
-        "description": "一个 Agent owner 的身份标识，通常为 AID。"
-      },
-      "uniqueItems": true,
-      "x-merge": "list",
-      "description": "Agent 所有者身份列表；用于 owner 级控制和通知"
-    },
-    "admins": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "description": "一个 Agent admin 的身份标识，通常为 AID。"
-      },
-      "uniqueItems": true,
-      "x-merge": "list",
-      "description": "Agent 管理员身份列表"
-    },
-    "channels": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "description": "一个渠道实例配置；具体字段由渠道类型及其适配器定义。"
-      },
-      "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",
-      "description": "AUN 群资源同步配置；控制规则文件路径、资源索引路径、条目/字节限制及刷新间隔。"
-    },
-    "render": {
-      "type": "object",
-      "x-merge": "dict",
-      "description": "私聊、群聊及注入内容使用的渲染器标识配置。"
-    },
-    "sessionManifests": {
-      "type": "object",
-      "x-merge": "dict",
-      "description": "会话类型到 manifest 文件的映射，用于选择对应的系统提示词清单。"
-    },
-    "enable_rich_content": {
-      "type": "boolean",
-      "x-merge": "scalar",
-      "description": "是否允许渠道使用富内容消息；未设置时由渠道能力和运行时默认决定"
-    },
-    "extra_backup": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "description": "一个额外备份规则，包含相对 path 和可选的文件匹配 pattern。"
-      },
-      "x-merge": "list",
-      "description": "配置快照需要额外包含的文件声明；不得指向 .env。"
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.5.json",
+  "title": "AgentConfig v5 (agents/{aid}/config.json)",
+  "description": "Agent v5 主配置。保存 Agent 身份、渠道、模型、会话行为和渲染设置；角色策略已迁移到独立 roles/ 配置域。",
+  "x-logical-name": "agent-config",
+  "x-scope": "agent",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "description": "禁止继续使用 v4 及更早版本的顶层权限配置；permissionMode 和 roles 均不得出现在 Agent v5 主配置中。",
+    "anyOf": [
+      {
+        "description": "禁止旧版顶层 permissionMode；权限模式由独立角色策略决定。",
+        "required": [
+          "permissionMode"
+        ]
+      },
+      {
+        "description": "禁止旧版内嵌 roles；角色定义和默认角色已迁移到独立 roles/ 配置域。",
+        "required": [
+          "roles"
+        ]
+      }
+    ]
+  },
+  "required": [
+    "aid",
+    "channels"
+  ],
+  "properties": {
+    "$schema_version": {
+      "type": "number",
+      "const": 5,
+      "default": 5,
+      "x-merge": "scalar",
+      "description": "配置 Schema 版本；v5 将角色策略移入独立 roles/ 配置域"
+    },
+    "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",
+        "description": "一个 Agent owner 的身份标识，通常为 AID。"
+      },
+      "uniqueItems": true,
+      "x-merge": "list",
+      "description": "Agent 所有者身份列表；用于 owner 级控制和通知"
+    },
+    "admins": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "description": "一个 Agent admin 的身份标识，通常为 AID。"
+      },
+      "uniqueItems": true,
+      "x-merge": "list",
+      "description": "Agent 管理员身份列表"
+    },
+    "channels": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "一个渠道实例配置；具体字段由渠道类型及其适配器定义。"
+      },
+      "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",
+      "description": "AUN 群资源同步配置；控制规则文件路径、资源索引路径、条目/字节限制及刷新间隔。"
+    },
+    "render": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "私聊、群聊及注入内容使用的渲染器标识配置。"
+    },
+    "sessionManifests": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "会话类型到 manifest 文件的映射，用于选择对应的系统提示词清单。"
+    },
+    "enable_rich_content": {
+      "type": "boolean",
+      "x-merge": "scalar",
+      "description": "是否允许渠道使用富内容消息；未设置时由渠道能力和运行时默认决定"
+    },
+    "extra_backup": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "一个额外备份规则，包含相对 path 和可选的文件匹配 pattern。"
+      },
+      "x-merge": "list",
+      "description": "配置快照需要额外包含的文件声明；不得指向 .env。"
+    }
+  }
+}