evolcore 0.0.1 → 0.0.2

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

@@ -0,0 +1,200 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "role-config.schema.1.json",
+  "title": "RoleConfig (agents/{aid}/roles/{roleId}.json)",
+  "description": "单个角色的独立策略配置。角色 ID 由文件名表达，本文件定义访问权限、行为字段约束、命令权限和用量额度。",
+  "x-logical-name": "role-config",
+  "x-scope": "role",
+  "x-permission-fields": [
+    { "value": "permissionMode", "label": "Permission Mode", "description": "角色的工具调用审批模式；只能由角色策略决定，关系级不可覆盖。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "readonly", "label": "Readonly" }, { "value": "auto", "label": "Auto" }, { "value": "request", "label": "Request" }, { "value": "bypass", "label": "Bypass" }] },
+    { "value": "chatmode.private", "label": "Private Chat Mode", "description": "角色在私聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
+    { "value": "chatmode.group", "label": "Group Chat Mode", "description": "角色在群聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
+    { "value": "mentionMode", "label": "Group Mention Mode", "description": "角色在群聊场景中的提及响应策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "disabled", "label": "Disabled" }, { "value": "mention-only", "label": "Mention Only" }] },
+    { "value": "baseagents.claude.model", "label": "Claude Model", "description": "角色可使用的 Claude 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Claude models" }, { "value": "claude-opus-*", "label": "Claude Opus family" }, { "value": "claude-sonnet-*", "label": "Claude Sonnet family" }, { "value": "claude-haiku-*", "label": "Claude Haiku family" }] },
+    { "value": "baseagents.claude.effort", "label": "Claude Effort", "description": "角色使用 Claude 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
+    { "value": "baseagents.codex.model", "label": "Codex Model", "description": "角色可使用的 Codex 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Codex models" }, { "value": "gpt-5.4*", "label": "GPT-5.4 family" }, { "value": "gpt-5.3-codex*", "label": "GPT-5.3 Codex family" }] },
+    { "value": "baseagents.codex.reasoning", "label": "Codex Reasoning", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }] },
+    { "value": "baseagents.gemini.model", "label": "Gemini Model", "description": "角色可使用的 Gemini 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Gemini models" }, { "value": "gemini-*", "label": "Gemini model family" }] },
+    { "value": "baseagents.hermes.model", "label": "Hermes Model", "description": "角色可使用的 Hermes 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Hermes models" }] }
+  ],
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "description", "permissions"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 1, "default": 1, "description": "角色配置 Schema 版本，固定为 1。" },
+    "description": { "type": "string", "description": "角色的用途、信任级别和授权边界说明。" },
+    "allowAccess": { "type": "boolean", "default": true, "description": "是否允许该角色访问 Agent；缺省为 true。" },
+    "permissions": {
+      "type": "object",
+      "required": ["permissionMode"],
+      "description": "角色对运行时行为字段施加的默认值、关系级覆盖权及候选值约束。",
+      "properties": {
+        "permissionMode": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "工具调用审批模式策略；该策略必须存在且不允许关系级覆盖。",
+          "properties": {
+            "default": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "description": "该角色实际使用的工具调用审批模式。", "x-enumDescriptions": { "readonly": "只读模式：明确只读工具自动执行，写入、普通 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"], "description": "一个可列入权限模式候选集合的值。", "x-enumDescriptions": { "readonly": "只读模式", "auto": "自动模式", "request": "请求人工审批模式", "bypass": "受强制危险规则约束的放行模式" } }, "uniqueItems": true, "description": "保留的权限模式候选集合；permissionMode 当前不可由关系级覆盖，通常无需配置。" },
+            "reason": { "type": "string", "description": "采用该权限模式策略的可审计原因或管理备注。" }
+          }
+        },
+        "chatmode.private": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在私聊场景中的响应方式策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的私聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖私聊响应方式；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["interactive", "proactive"], "description": "一个可用于私聊响应方式覆盖的值。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "uniqueItems": true, "description": "允许关系级覆盖到的私聊响应方式白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该私聊响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "chatmode.group": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在群聊场景中的响应方式策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的群聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊响应方式；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["interactive", "proactive"], "description": "一个可用于群聊响应方式覆盖的值。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "uniqueItems": true, "description": "允许关系级覆盖到的群聊响应方式白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该群聊响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "mentionMode": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在群聊场景中的提及响应策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["disabled", "mention-only"], "description": "未设置有效关系级覆盖时使用的群聊提及响应策略。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊提及响应策略；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["disabled", "mention-only"], "description": "一个可用于群聊提及响应策略覆盖的值。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应" } }, "uniqueItems": true, "description": "允许关系级覆盖到的群聊提及响应策略白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该群聊提及响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "baseagents.claude.effort": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色使用 Claude runner 时的推理强度策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Claude 推理强度。", "x-enumDescriptions": { "auto": "由 Claude runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 Claude 推理强度；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "一个允许覆盖到的 Claude 推理强度。", "x-enumDescriptions": { "auto": "由 Claude runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Claude 推理强度白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该 Claude 推理强度策略的可审计原因或管理备注。" }
+          }
+        },
+        "baseagents.codex.reasoning": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色使用 Codex runner 时的推理强度策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 Codex 推理强度；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "一个允许覆盖到的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Codex 推理强度白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该 Codex 推理强度策略的可审计原因或管理备注。" }
+          }
+        }
+      },
+      "patternProperties": {
+        "^baseagents\\.[a-z0-9_-]+\\.model$": {
+          "type": "object",
+          "required": ["default", "allowOverride", "allowedModels"],
+          "additionalProperties": false,
+          "description": "指定 base agent 的角色模型策略；默认模型必须匹配 allowedModels。",
+          "properties": {
+            "default": { "type": "string", "minLength": 1, "description": "该角色默认使用的模型标识；必须被 allowedModels 中的精确值或通配符允许。" },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖模型；缺省为 false。" },
+            "allowedModels": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "description": "一个允许使用的模型标识或以 * 表达的通配符模式。" }, "uniqueItems": true, "description": "该角色可用的模型白名单；支持通配符，且至少包含一个条目。" },
+            "reason": { "type": "string", "description": "采用该角色模型策略的可审计原因或管理备注。" }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "commandPermissions": {
+      "type": "object",
+      "x-optionsSource": "operation-catalog",
+      "description": "按 operation 标识定义角色的命令执行权限；候选 operation 来自运行时 operation catalog。",
+      "propertyNames": { "type": "string", "minLength": 1, "description": "非空 operation 标识，支持精确名称及系统识别的通配规则。" },
+      "additionalProperties": {
+        "type": "object",
+        "required": ["allow"],
+        "additionalProperties": false,
+        "description": "一个 operation 的角色授权规则。",
+        "properties": {
+          "allow": { "type": "boolean", "description": "是否允许该角色执行匹配的 operation。" },
+          "dangerous": { "type": "boolean", "default": false, "description": "是否将该授权规则标记为危险操作规则；危险操作还会应用额外安全约束。" },
+          "scopes": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["relation", "role", "agent", "process", "filesystem", "control", "raw-cli"], "description": "该命令权限适用的一个配置或执行作用域。", "x-enumDescriptions": { "relation": "当前 Agent 与对端的关系配置域", "role": "独立角色注册表或角色策略配置域", "agent": "单个 Agent 的配置与生命周期域", "process": "EvolCore 进程级配置与运行域", "filesystem": "受控文件系统操作域", "control": "控制面命令和管理通道域", "raw-cli": "未经结构化 operation 封装的原始 CLI 执行域" } },
+            "uniqueItems": true,
+            "description": "该授权规则允许生效的作用域白名单；未配置时由 operation 自身和鉴权器决定。"
+          },
+          "constraints": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "operation 级附加约束，例如对端、Agent、群聊、控制通道、参数或工作目录限制。",
+            "properties": {
+              "ownPeerOnly": { "type": "boolean" },
+              "ownAgentOnly": { "type": "boolean" },
+              "targetCurrentAgentOnly": { "type": "boolean" },
+              "requireAgentAdmin": { "type": "boolean" },
+              "requireAgentOwner": { "type": "boolean" },
+              "privateOnly": { "type": "boolean" },
+              "groupOnly": { "type": "boolean" },
+              "requireDaemonOwner": { "type": "boolean" },
+              "requireControlChannel": { "type": "boolean" },
+              "requireExplicitDangerousGrant": { "type": "boolean" },
+              "currentRelationOnly": { "type": "boolean" },
+              "requireFieldOverride": { "type": "string", "minLength": 1 },
+              "configFieldPolicy": { "type": "string", "enum": ["behavior-read", "role-overridable-write"] },
+              "allowedArgs": { "$ref": "#/definitions/argumentConstraints" },
+              "deniedArgs": { "$ref": "#/definitions/argumentConstraints" },
+              "forbiddenFlags": { "$ref": "#/definitions/stringList" },
+              "allowedConfigKeys": { "$ref": "#/definitions/stringList" },
+              "allowedPrefixes": { "$ref": "#/definitions/stringList" },
+              "timeoutMs": { "type": "integer", "minimum": 0 },
+              "outputLimitBytes": { "type": "integer", "minimum": 0 },
+              "cwdPolicy": { "type": "string", "enum": ["agentProject", "evolcoreHome", "none"] },
+              "envAllowlist": { "$ref": "#/definitions/stringList" }
+            }
+          },
+          "reason": { "type": "string", "description": "采用该命令权限规则的可审计原因或管理备注。" }
+        }
+      }
+    },
+    "usageLimits": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "角色用量额度策略；enabled 未开启或未配置时不启用额度限制。",
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用该角色的用量额度限制；缺省为 false。" },
+        "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": "同一角色的所有主体共享统计" } }
+      }
+    }
+  },
+  "definitions": {
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "argumentConstraints": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": ["string", "number", "boolean"] }
+      }
+    }
+  }
+}

package/kits/schemas/role-registry.schema.1.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "role-registry.schema.1.json",
+  "title": "RoleRegistry (agents/{aid}/roles/index.json)",
+  "description": "Agent 的角色注册表。声明可加载的角色 ID，并配置未显式分配角色时私聊和群聊使用的默认角色。",
+  "x-logical-name": "role-registry",
+  "x-scope": "role",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "roles", "defaultRoles"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 1, "default": 1, "x-merge": "scalar", "description": "角色注册表 Schema 版本，固定为 1。" },
+    "roles": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "contains": { "const": "visitor", "description": "注册表必须包含 visitor，以保证始终存在低权限安全回退角色。" },
+      "items": { "type": "string", "pattern": "^[a-z0-9_-]+$", "description": "一个已注册角色 ID；对应 roles/{roleId}.json 或同名内置模板。" },
+      "x-merge": "list",
+      "description": "允许加载、展示和分配的角色 ID 列表；未注册的角色文件不产生运行时权限。"
+    },
+    "defaultRoles": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["private", "group"],
+      "default": { "private": null, "group": null },
+      "description": "未显式分配角色时，私聊和群聊分别采用的默认角色；null 表示不自动授予角色。",
+      "properties": {
+        "private": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "私聊对端的默认角色；非 null 时必须已注册、有效且不能为 owner/admin。" },
+        "group": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "群聊对端的默认角色；非 null 时必须已注册、有效且不能为 owner/admin。" }
+      },
+      "x-merge": "dict"
+    }
+  }
+}

package/kits/schemas/single-session.schema.1.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "single-session.schema.1.json",
+  "title": "SingleSessionParams (responseModeParams['single-session'])",
+  "x-logical-name": "single-session",
+  "x-scope": "mode",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pre_tool_1stmsgchk": {
+      "type": "boolean",
+      "enum": [true, false],
+      "default": true,
+      "description": "proactive 首工具表态检查（仅 chatmode=proactive 生效）：首个工具调用前必须先向对端表态，否则拦截。",
+      "x-enumDescriptions": {
+        "true": "启用：首工具前必须先发送消息或文件",
+        "false": "禁用：允许直接调用工具"
+      }
+    },
+    "tool_use_reminder": {
+      "type": "boolean",
+      "enum": [true, false],
+      "default": true,
+      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "x-enumDescriptions": {
+        "true": "启用：自动汇报工具使用情况",
+        "false": "禁用：静默执行工具"
+      }
+    }
+  }
+}

package/kits/templates/bootstrap-welcome.md

@@ -0,0 +1,15 @@
+你好，我是 {{agentName}}。
+
+我刚刚完成连接，需要先和你确认我的基础信息，然后再进入正常工作状态。
+
+请帮我确认三项内容：
+1. 显示名：你希望我叫什么？
+2. 简介：我主要负责什么？一句到两句话即可。
+3. 标签：给我 3 到 6 个标签，例如 `代码审查`、`客服助手`、`项目管理`。
+
+当前信息：
+- AID: {{agentAid}}
+- 渠道: {{channel}}
+- Baseagent: {{baseagent}}
+
+你可以直接按上面的三项回复。

package/kits/templates/message-fragments/handoff-request-to-target.md

@@ -0,0 +1,13 @@
+说明：
+- 跨会话请求回复，仅本端可见。
+- 请结合下方内容理解当前对端回复。
+- 当前回流策略：{{handoffReturnPolicy}}
+- 若策略为 required 且当前回复足以处理请求，使用：`ec handoff return {{handoffId}} "<完整回流内容>"`
+- 若策略为 none 且当前回复已处理请求，使用：`ec handoff return {{handoffId}}`
+- 若回复不足，不要执行 return。
+
+此前发给当前对端的内容：
+{{handoffPreviousContent}}
+
+当前对端回复内容：
+{{content}}

package/kits/templates/message-fragments/handoff-response-to-origin.md

@@ -0,0 +1,10 @@
+说明：
+- 跨会话结果回流，仅本端可见。
+- 这是此前本会话请求的返回结果，请结合当前上下文回复当前对端。
+- 不要提及 handoff 或内部路由机制。
+
+此前跨会话请求内容：
+{{handoffPreviousContent}}
+
+回流内容：
+{{content}}

package/kits/templates/message-fragments/inject-default.md

@@ -0,0 +1,2 @@
+‹owner 提示 · 已验证 · {{injectTime}}{{?ownerAid}} · from:{{ownerAid}}{{/}}›（仅你可见，对端无感；请据此决定如何回复对端）
+{{content}}

package/kits/templates/message-fragments/item.md

@@ -0,0 +1,2 @@
+‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?peerRole}} · role:{{peerRole}}{{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?encrypted=true}} · 🔒密文{{/}}{{?encrypted=false}} · ✉️明文{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
+{{content}}

package/kits/templates/roles/admin.json

@@ -0,0 +1,8 @@
+{
+  "$schema_version": 1,
+  "description": "Agent administrator with guarded management authority",
+  "allowAccess": true,
+  "permissions": {
+    "permissionMode": { "default": "request", "allowOverride": false }
+  }
+}

package/kits/templates/roles/member.json

@@ -0,0 +1,40 @@
+{
+  "$schema_version": 1,
+  "description": "Trusted user with own-scope access",
+  "allowAccess": true,
+  "usageLimits": {
+    "enabled": true,
+    "resetMode": "daily",
+    "currency": "CNY",
+    "limitAmount": 50,
+    "costBasis": "gateway",
+    "scope": "subject"
+  },
+  "permissions": {
+    "permissionMode": { "default": "auto", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "role.assign": { "allow": false },
+    "role.revoke": { "allow": false },
+    "category:read": { "allow": true },
+    "category:write-own": { "allow": true },
+    "config.get": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "behavior-read" } },
+    "config.set": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "role-overridable-write" } },
+    "config.unset": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "role-overridable-write" } },
+    "model.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.answer": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.update": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
+    "mentionmode.update": { "allow": false },
+    "trigger.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "ec.msg.send": { "allow": true, "constraints": { "ownPeerOnly": true } },
+    "ec.msg.file": { "allow": true, "constraints": { "ownPeerOnly": true } },
+    "ec.group.send": { "allow": true, "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.group.file": { "allow": true, "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.ctl.*": { "allow": false },
+    "cli.exec.raw": { "allow": false, "dangerous": true },
+    "dangerous:*": { "allow": false, "dangerous": true }
+  }
+}

package/kits/templates/roles/owner.json

@@ -0,0 +1,8 @@
+{
+  "$schema_version": 1,
+  "description": "Agent owner with full Agent management authority",
+  "allowAccess": true,
+  "permissions": {
+    "permissionMode": { "default": "bypass", "allowOverride": false }
+  }
+}

package/kits/templates/roles/visitor.json

@@ -0,0 +1,39 @@
+{
+  "$schema_version": 1,
+  "description": "Low-trust visitor with minimal own-scope access",
+  "allowAccess": true,
+  "usageLimits": {
+    "enabled": true,
+    "resetMode": "daily",
+    "currency": "CNY",
+    "limitAmount": 5,
+    "costBasis": "gateway",
+    "scope": "subject"
+  },
+  "permissions": {
+    "permissionMode": { "default": "readonly", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "role.assign": { "allow": false },
+    "role.revoke": { "allow": false },
+    "config.get": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "behavior-read" } },
+    "model.list": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "model.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "model.use": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.answer": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.update": { "allow": false },
+    "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
+    "mentionmode.update": { "allow": false },
+    "trigger.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "session.list": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true } },
+    "ec.msg.send": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "privateOnly": true } },
+    "ec.msg.file": { "allow": false },
+    "ec.group.send": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.group.file": { "allow": false },
+    "ec.ctl.*": { "allow": false },
+    "cli.exec.raw": { "allow": false, "dangerous": true },
+    "dangerous:*": { "allow": false, "dangerous": true }
+  }
+}

package/kits/templates/system-fragments/baseagent.md

@@ -0,0 +1,14 @@
+[baseagent]
+baseAgentName: {{baseAgentName}} # 底层推理引擎（Claude Code / Codex / Gemini CLI）
+{{?effectiveModel}}
+effectiveModel: {{effectiveModel}} # 当前实际生效的模型（关系级 > agent级 > 全局 优先级解析）
+{{/}}
+{{?baseAgentModel}}
+baseAgentModel: {{baseAgentModel}} # base agent 引擎底座模型（evolcore 作用域无配置时的兜底）
+{{/}}
+{{?modelFallbackActive}}
+modelFallbackActive: true # evolcore 配置的模型不可用，当前正在使用降级模型 {{modelFallbackModel}}
+{{/}}
+{{?agentSessionId}}
+agentSessionId: {{agentSessionId}} # 底层引擎的会话 ID（区别于 evolcore sessionId）
+{{/}}

package/kits/templates/system-fragments/bootstrap.md

@@ -0,0 +1,16 @@
+[bootstrap]
+phase: bootstrapping
+
+你正在进行首次自我设定。当前目标不是处理普通任务，而是和 owner 确认并写入你的基础名片信息。
+
+需要确认的字段：
+- name：显示名，简短清晰
+- description：一句到两句话描述你的职责或定位
+- tags：3 到 6 个标签，用于检索和归类
+
+流程：
+1. 如果 owner 尚未明确这些信息，继续提问并收敛选项。
+2. 信息齐全后，编辑本地 agent.md（`$EVOLCORE_HOME/AIDs/{{selfAid}}/agent.md`）中的 YAML frontmatter：更新 `name`、`description`、`tags`。
+3. 调用 `ec aid agentmd put {{selfAid}}` 签名并发布 agent.md。
+4. 发布成功后，调用 `ec agent ready {{selfAid}}` 完成 bootstrap。
+5. 完成前不要承诺已经进入正常工作状态。

package/kits/templates/system-fragments/channel.md

@@ -0,0 +1,48 @@
+[channel]
+channel: {{channel}} # 渠道类型：aun|feishu|wechat|dingtalk|qqbot|wecom
+{{?capabilities}}
+capabilities: {{capabilities}} # 当前渠道支持的能力
+{{/}}
+{{?supportsFileMarker}}
+发送文件语法：
+  [SEND_FILE:文件路径]
+相对路径从项目根目录解析，图片自动内联预览。
+{{/}}
+# ── 怎么回复（唯一事实源，跟 chatMode 走）──
+chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送
+{{?chatMode=interactive}}
+# interactive：你直接输出的文本就是回复，无需调用发送命令。
+# 下面的命令仅用于附加能力（发文件/@某人/加密/联系第三方），不是回复手段。
+{{/}}
+{{?chatMode=proactive}}
+# proactive：你的普通文本被投影成「思考过程」（message.thought.put）：
+#   - 前端可见，但不入历史、不触发对端 message.received 事件
+#   - 对端大模型不会被唤醒，因此不是回复
+# 要正式回复，必须调用发送命令（message.send 协议）触发对端接收。
+# 设计意图：避免 agent↔agent 无限循环；某一方不再发送 → 对话自然终止。
+# 拿不到 self-aid 时可用 ec ctl send "<text>"（自动继承当前 AID 和对端）。
+{{/}}
+{{?groupId}}
+{{?channel=aun}}
+ec group send {{selfAid}} {{groupId}} "<text>" [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
+group-send 是群内公开回复；interactive 下直接输出即为公开回复，仅 @某人/发文件/手动控制加密时才需此命令
+# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 group send 时【必须】跟随本轮入站消息的加密态——
+# 回复某条密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送。
+# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送（批次含密文则整轮密文），无需你操心。
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
+{{/}}
+{{/}}
+{{?peerId}}
+{{?channel=aun}}
+ec msg send {{selfAid}} {{peerId}} "<text>" [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+msg-send 用于私聊对端的附加能力（文件/链接/手动控制加密）；群聊中仅在确需私下联系本条消息发送者时才用，否则用上面的 group send
+# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 msg send 时【必须】跟随你所回复的那条入站消息的加密态——
+# 回复密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送（密文会话漏发明文是严重事故）。
+# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送，无需你操心；仅当你显式调用 msg send 时才需自己带加密参数。
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
+{{/}}
+{{/}}

package/kits/templates/system-fragments/commands.md

@@ -0,0 +1,26 @@
+[commands] 当前场景可用命令集（前缀 ec，以自己 AID 为发送者；完整用法 Read 对应文档）
+遇到明确触发词（费用/用量/统计/创建agent/建群/查群等）优先查 INDEX.md 或直接试对应 ec 命令
+
+ec ctl     当前会话工具（主动发消息/文件、重命名、队列、项目路径、会话状态）  $KITS_DOCS/evolcore/ctl.md
+ec model   模型与推理强度管理（切模型/列模型/当前模型/模型详情/改强度/诊断网关）  $KITS_DOCS/evolcore/model.md
+ec response 响应模式管理（切换响应模式/列响应模式/看当前模式/改响应配置）  $KITS_DOCS/evolcore/response.md
+ec stats   Token 用量与费用统计（用量/费用/统计/预算/token/cost）  $KITS_DOCS/evolcore/stats.md
+ec config  读配置/查字段/看生效值（get/show/list/effective/fields/history/diff/current/boots/validate）；set/unset 权限由 API 层控制  $KITS_DOCS/evolcore/config.md
+ec trigger 定时与事件触发器管理（定时任务/cron/提醒/自动执行/巡检/禁用/删除）。需要写操作的无人值守任务用 --permission bypass；单个 trigger 可用 --model/--effort 覆盖执行模型/强度  $KITS_DOCS/evolcore/trigger.md
+ec aid     身份/证书/名片/探测对端                   $KITS_DOCS/evolcore/aid.md
+ec fs      AUN 文件系统统一入口（ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/setfacl/getfacl/token/find/df/mount/approve/reject/umount；个人/群空间同一入口；没有 ec group fs） $KITS_DOCS/evolcore/fs.md
+ec storage 文件上传/下载/配额（底层调试入口，日常优先 ec fs） $KITS_DOCS/evolcore/storage.md
+ec rpc     底层 AUN RPC 逃生通道                      $KITS_DOCS/evolcore/rpc.md
+{{?peerId}}
+ec msg     私聊收发消息（回复/拉取/撤回）            $KITS_DOCS/evolcore/msg.md
+{{/}}
+{{?selfAid}}
+ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/封禁/规则；高级 group.* 用 ec rpc） $KITS_DOCS/evolcore/group.md
+{{/}}
+{{?peerRole=owner}}
+ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md
+{{/}}
+{{?peerRole=admin}}
+ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md
+{{/}}
+完整命令集目录（含触发词与适用场景）：$KITS_DOCS/evolcore/INDEX.md

package/kits/templates/system-fragments/identity.md

@@ -0,0 +1,11 @@
+[identity]
+{{?selfAid}}
+selfName: {{selfName}}
+selfAid: {{selfAid}}
+{{/}}
+{{?hasPersona}}
+hasPersona: active
+{{/}}
+{{?hasWorkingMemory}}
+hasWorkingMemory: active
+{{/}}

package/kits/templates/system-fragments/relation.md

@@ -0,0 +1,19 @@
+[relation]
+{{?peerKey}}
+peerName: {{peerName}}
+peerId: {{peerId}} # 对端在当前渠道内的原生 ID
+peerRole: {{peerRole}} # owner|admin|member|visitor|自定义角色|none
+{{?peerType}}
+peerType: {{peerType}} # human 或 agent
+{{/}}
+peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
+{{/}}
+{{?groupId}}
+groupId: {{groupId}}
+{{?groupRulesStatus}}
+groupRulesStatus: {{groupRulesStatus}} # synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
+{{/}}
+{{?groupRulesError}}
+groupRulesError: {{groupRulesError}}
+{{/}}
+{{/}}