evolcore 0.0.3 → 0.0.4

package/kits/schemas/daemon.schema.3.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "daemon.schema.3.json",
+  "title": "ProcessConfig v3 (daemon.json)",
+  "description": "进程级配置：daemon 自身运行配置，链外独立作用域，不进覆盖链。",
+  "x-logical-name": "daemon",
+  "x-scope": "process",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 3, "default": 3, "x-merge": "scalar" },
+    "aid": { "type": "string", "description": "daemon 默认身份 AID", "x-merge": "scalar" },
+    "owners": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "进程控制面鉴权名单（谁能远程管 daemon）",
+      "x-merge": "list"
+    },
+    "debug": {
+      "type": "object",
+      "description": "进程级调试配置；唯一合法来源为 daemon.json，不参与 Agent 覆盖链",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "logLevel": {
+          "type": "string",
+          "enum": ["DEBUG", "INFO", "WARN", "ERROR"],
+          "description": "daemon 日志级别"
+        },
+        "flusherDiag": {
+          "type": "boolean",
+          "description": "是否启用消息 flusher 诊断"
+        },
+        "aunTrace": {
+          "type": "boolean",
+          "description": "是否记录 AUN 协议 trace"
+        },
+        "aunSdkLog": {
+          "type": "boolean",
+          "description": "是否启用 AUN SDK 调试日志"
+        },
+        "upmsg": {
+          "type": "boolean",
+          "description": "是否向 Agent owner 发送 daemon 上线通知"
+        },
+        "eckSnapshots": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照"
+        }
+      }
+    },
+    "tunnel": {
+      "type": "object",
+      "description": "内网穿透配置",
+      "x-merge": "dict",
+      "properties": {
+        "targets": { "type": "array", "description": "穿透目标列表", "items": { "type": "object" } }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "AUN 进程配置",
+      "x-merge": "dict",
+      "properties": {
+        "encryptionSeed": { "type": ["string", "null"], "description": "已废弃兼容字段；EvolCore 固定使用内置值，检测到其他值时拒绝启动并提示联系管理人员" },
+        "minEvolVersion": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+          "description": "AUN Menu 允许的最低 Evol 客户端版本；省略时不限制"
+        },
+        "menuTokenRequired": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否要求普通 AUN Menu 请求携带有效 menu_token；默认 false"
+        }
+      }
+    },
+    "serviceProxy": {
+      "type": "object",
+      "description": "AUN Service Proxy：把一个本地 HTTP/WS 服务暴露到 AUN 网络",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 Service Proxy" },
+        "services": { "type": "array", "description": "暴露到 AUN 的本地服务列表", "items": { "type": "object" } }
+      }
+    },
+    "configSnapshots": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否自动维护配置快照、启动日志和自检回落",
+      "x-merge": "scalar"
+    },
+    "idleMonitor": {
+      "type": "object",
+      "description": "流式输出空闲监控配置",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true, "description": "是否启用空闲监控" },
+        "timeout": { "type": "number", "default": 120, "description": "空闲超时秒数" },
+        "retryAttemptTimeout": { "type": "number", "description": "API 重试尝试连续无事件时的超时秒数；未设置时继承 timeout" },
+        "maxExecutionTime": { "type": "number", "default": 3600, "description": "单个任务总执行时限（秒），等待审批期间仍继续计时" }
+      }
+    },
+    "ecweb": {
+      "type": "object",
+      "description": "web 控制台开关/端口",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 web 控制台" },
+        "port": { "type": "number", "description": "web 控制台监听端口" }
+      }
+    },
+    "watch": {
+      "type": "object",
+      "description": "日志监听配置",
+      "x-merge": "dict",
+      "properties": {
+        "logTypes": { "type": "array", "description": "要监听的日志类型", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/kits/schemas/defaults.schema.2.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "defaults.schema.2.json",
+  "title": "DefaultsConfig v2 (agents/defaults.json)",
+  "description": "全局默认配置。覆盖链最低层。",
+  "x-logical-name": "defaults",
+  "x-scope": "defaults",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 2, "default": 2, "x-merge": "scalar" },
+    "models": {
+      "type": "object",
+      "description": "模型配置",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string", "description": "全局默认模型" },
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "全局模型白名单"
+        }
+      }
+    },
+    "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": {
+        "rootPath": { "type": "string", "description": "全局项目根路径" },
+        "defaultPath": { "type": "string", "description": "全局默认项目路径" }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "全局 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "debug": {
+      "type": "object",
+      "description": "全局调试配置",
+      "x-merge": "dict",
+      "properties": {
+        "logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"], "description": "日志级别", "x-enumDescriptions": { "DEBUG": "调试：最详细", "INFO": "信息：常规运行日志", "WARN": "警告：仅警告及以上", "ERROR": "错误：仅错误" } },
+        "flusherDiag": { "type": "boolean" },
+        "aunTrace": { "type": "boolean" },
+        "aunSdkLog": { "type": "boolean" },
+        "upmsg": { "type": "boolean" }
+      }
+    },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "响应模式特有参数的全局默认字典，按模式 id 分桶：{ [modeId]: {...} }"
+    },
+    "config": { "type": "object", "x-merge": "dict" },
+    "session_renew": {
+      "type": "object",
+      "description": "会话超时后的续接判定策略，默认关闭",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    }
+  }
+}

package/kits/schemas/defaults.schema.3.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "defaults.schema.3.json",
+  "title": "DefaultsConfig v3 (agents/defaults.json)",
+  "description": "全局默认配置。覆盖链最低层；进程级 debug 仅允许配置在 daemon.json。",
+  "x-logical-name": "defaults",
+  "x-scope": "defaults",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 3, "default": 3, "x-merge": "scalar" },
+    "models": {
+      "type": "object",
+      "description": "模型配置",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string", "description": "全局默认模型" },
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "全局模型白名单"
+        }
+      }
+    },
+    "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": {
+        "rootPath": { "type": "string", "description": "全局项目根路径" },
+        "defaultPath": { "type": "string", "description": "全局默认项目路径" }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "全局 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "响应模式特有参数的全局默认字典，按模式 id 分桶：{ [modeId]: {...} }"
+    },
+    "config": { "type": "object", "x-merge": "dict" },
+    "session_renew": {
+      "type": "object",
+      "description": "会话超时后的续接判定策略，默认关闭",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    }
+  }
+}

package/kits/schemas/relation-config.schema.6.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.6.json",
+  "title": "RelationConfig v6 (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "anyOf": [
+      { "required": ["permissionMode"] },
+      { "required": ["roles"] }
+    ]
+  },
+  "properties": {
+    "$schema_version": { "type": "number", "const": 6, "default": 6, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "role": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "x-merge": "scalar", "description": "关系角色；允许 admin/member/visitor/自定义角色，禁止 owner" },
+    "active_baseagent": { "type": "string", "x-merge": "scalar" },
+    "models": { "type": "object", "x-merge": "dict" },
+    "baseagents": { "type": "object", "x-merge": "dict" },
+    "chatmode": { "type": "object", "x-merge": "dict", "properties": { "private": { "enum": ["interactive", "proactive"] }, "group": { "enum": ["interactive", "proactive"] }, "nothuman": { "enum": ["interactive", "proactive"] } }, "additionalProperties": false },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "x-merge": "scalar" },
+    "model": { "type": "string", "x-merge": "scalar" },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": { "type": "object", "x-merge": "dict" },
+    "flush_delay": { "type": "number", "x-merge": "scalar" },
+    "debounce": { "type": "number", "x-merge": "scalar" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "x-merge": "scalar" },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar" },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0 },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"] }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}

package/kits/schemas/relation-config.schema.7.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.7.json",
+  "title": "RelationConfig v7 (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "anyOf": [
+      { "required": ["permissionMode"] },
+      { "required": ["roles"] }
+    ]
+  },
+  "properties": {
+    "$schema_version": { "type": "number", "const": 7, "default": 7, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "role": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "x-merge": "scalar", "description": "关系角色；允许 admin/member/visitor/自定义角色，禁止 owner" },
+    "active_baseagent": { "type": "string", "x-merge": "scalar" },
+    "models": { "type": "object", "x-merge": "dict" },
+    "baseagents": { "type": "object", "x-merge": "dict" },
+    "chatmode": { "type": "object", "x-merge": "dict", "properties": { "private": { "enum": ["interactive", "proactive"] }, "group": { "enum": ["interactive", "proactive"] }, "nothuman": { "enum": ["interactive", "proactive"] } }, "additionalProperties": false },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "x-merge": "scalar" },
+    "model": { "type": "string", "x-merge": "scalar" },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": { "type": "object", "x-merge": "dict" },
+    "flush_delay": { "type": "number", "x-merge": "scalar" },
+    "debounce": { "type": "number", "x-merge": "scalar" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "x-merge": "scalar" },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar" },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0 },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"] }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "groupRules": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["load", "ignore"],
+          "default": "load",
+          "description": "是否读取并注入当前 AUN 群已发布的 /rules.md；默认 load。"
+        }
+      }
+    },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}

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

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "single-session.schema.2.json",
+  "title": "SingleSessionParams (responseModeParams['single-session'])",
+  "x-logical-name": "single-session",
+  "x-scope": "mode",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "auxiliaryModel": {
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": false,
+          "properties": {
+            "claude": { "type": "string", "minLength": 1 },
+            "codex": { "type": "string", "minLength": 1 }
+          }
+        }
+      ],
+      "description": "辅助判断模型；可直接配置模型 ID，或按 claude/codex 配置映射。当前 Session 的 baseagent 在映射中无对应模型时执行 fallback_action。"
+    },
+    "auxiliaryEffort": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "xhigh", "max"],
+      "description": "辅助判断推理强度；配置时同一模式桶必须同时配置 auxiliaryModel，未配置时不向模型 API 发送 effort。"
+    },
+    "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": "禁用：静默执行工具"
+      }
+    }
+  },
+  "dependencies": {
+    "auxiliaryEffort": ["auxiliaryModel"]
+  }
+}

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

@@ -0,0 +1,9 @@
+说明：
+- 以下是此前未纳入本会话上下文的本地发言，仅补充一次。
+- 请结合这些发言与当前对端回复继续处理。
+
+本地发言：
+{{#each handoffContextEntries}}- {{previousContent}}
+{{/each}}
+当前对端回复内容：
+{{content}}

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

@@ -1,13 +1,19 @@
 说明：
-- 跨会话请求回复，仅本端可见。
-- 请结合下方内容理解当前对端回复。
-- 当前回流策略：{{handoffReturnPolicy}}
-- 若策略为 required 且当前回复足以处理请求，使用：`ec handoff return {{handoffId}} "<完整回流内容>"`
-- 若策略为 none 且当前回复已处理请求，使用：`ec handoff return {{handoffId}}`
+- 以下是尚未完成的跨会话请求，仅本端可见。
+- 请结合请求列表与当前对端回复，分别判断哪些请求已经得到充分回答。
+- 不要在对外回复中主动提及 handoff、ID、return 命令或内部路由机制。
+- 当前回复足以处理某项请求时，需要使用：`ec handoff return ID "<完整回流内容>"`
+- 命令双引号内若含双引号、反引号或 Shell 展开形式的 `$`，需经转义符转义，Shell 传给 ec 时会做还原。
 - 若回复不足，不要执行 return。
 
-此前发给当前对端的内容：
-{{handoffPreviousContent}}
-
+待回流请求：
+{{#each handoffRequiredEntries}}- ID：{{handoffId}}
+  原请求：{{previousContent}}
+{{/each}}
+{{?handoffContextEntries}}
+以下本地发言只用于补充上下文，不需要回流：
+{{#each handoffContextEntries}}- {{previousContent}}
+{{/each}}
+{{/}}
 当前对端回复内容：
 {{content}}

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

@@ -1,10 +1,9 @@
 说明：
 - 跨会话结果回流，仅本端可见。
-- 这是此前本会话请求的返回结果，请结合当前上下文回复当前对端。
+- 以下是此前本会话一个或多个请求的返回结果，请逐项结合当前上下文处理。
 - 不要提及 handoff 或内部路由机制。
 
-此前跨会话请求内容：
-{{handoffPreviousContent}}
-
-回流内容：
-{{content}}
+待处理结果：
+{{#each handoffOriginEntries}}- 原请求：{{previousContent}}
+  返回结果：{{responseContent}}
+{{/each}}

package/kits/templates/roles/admin.json

@@ -5,5 +5,51 @@
   "allowAccess": true,
   "permissions": {
     "permissionMode": { "default": "request", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "contact.read": { "allow": true, "scopes": ["agent"] },
+    "contact.block": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "connect.write": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "connect.access.write": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentOwner": true }
+    },
+    "role.assign": { "allow": true, "scopes": ["agent"] },
+    "role.revoke": { "allow": true, "scopes": ["agent"] },
+    "role.policy.read": { "allow": true, "scopes": ["agent"] },
+    "role.relation.read": { "allow": true, "scopes": ["agent"] },
+    "config.get": { "allow": true, "scopes": ["agent", "relation"] },
+    "config.set": { "allow": true, "scopes": ["agent", "relation"] },
+    "config.unset": { "allow": true, "scopes": ["agent", "relation"] },
+    "role.policy.write": {
+      "allow": true,
+      "dangerous": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "*": { "allow": true },
+    "agent.reload": {
+      "allow": true,
+      "dangerous": true,
+      "scopes": ["agent"],
+      "constraints": {
+        "targetCurrentAgentOnly": true,
+        "requireAgentAdmin": true
+      }
+    },
+    "dangerous:*": {
+      "allow": true,
+      "dangerous": true,
+      "constraints": { "requireDaemonOwner": true }
+    }
   }
 }

package/kits/templates/roles/member.json

@@ -29,6 +29,10 @@
     "chatmode.update": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
     "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
     "mentionmode.update": { "allow": false },
+    "group.mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.mentionmode.update": { "allow": false },
+    "group.rulespolicy.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.rulespolicy.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 } },

package/kits/templates/roles/visitor.json

@@ -27,6 +27,10 @@
     "chatmode.update": { "allow": false },
     "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
     "mentionmode.update": { "allow": false },
+    "group.mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.mentionmode.update": { "allow": false },
+    "group.rulespolicy.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.rulespolicy.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 } },

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

@@ -24,8 +24,13 @@ chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送
 {{/}}
 {{?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]
+ec group send {{selfAid}} {{groupId}} "<text>" [--return none|required] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
+# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
 group-send 是群内公开回复；interactive 下直接输出即为公开回复，仅 @某人/发文件/手动控制加密时才需此命令
+# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
+{{/}}
 # 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 group send 时【必须】跟随本轮入站消息的加密态——
 # 回复某条密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送。
 # interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送（批次含密文则整轮密文），无需你操心。
@@ -36,8 +41,13 @@ group-send 是群内公开回复；interactive 下直接输出即为公开回复
 {{/}}
 {{?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>']
+ec msg send {{selfAid}} {{peerId}} "<text>" [--return none|required] [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
 msg-send 用于私聊对端的附加能力（文件/链接/手动控制加密）；群聊中仅在确需私下联系本条消息发送者时才用，否则用上面的 group send
+# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
+{{/}}
 # 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 msg send 时【必须】跟随你所回复的那条入站消息的加密态——
 # 回复密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送（密文会话漏发明文是严重事故）。
 # interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送，无需你操心；仅当你显式调用 msg send 时才需自己带加密参数。

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

@@ -1,6 +1,8 @@
 [identity]
-{{?selfAid}}
+{{?selfName}}
 selfName: {{selfName}}
+{{/}}
+{{?selfAid}}
 selfAid: {{selfAid}}
 {{/}}
 {{?hasPersona}}

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

@@ -11,7 +11,7 @@ peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
 {{?groupId}}
 groupId: {{groupId}}
 {{?groupRulesStatus}}
-groupRulesStatus: {{groupRulesStatus}} # synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
+groupRulesStatus: {{groupRulesStatus}} # ignored/synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
 {{/}}
 {{?groupRulesError}}
 groupRulesError: {{groupRulesError}}