evolcore 0.0.32 → 0.0.34

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

@@ -0,0 +1,140 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "daemon.schema.7.json",
+  "title": "ProcessConfig v7 (daemon.json)",
+  "description": "进程级配置：daemon 自身运行配置，链外独立作用域，不进覆盖链。",
+  "x-logical-name": "daemon",
+  "x-scope": "process",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 7, "default": 7, "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 日志级别" },
+        "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": {
+        "gatewayUrl": { "not": {}, "description": "已移除；网关由 fastaun 缓存和 AID discovery 决定" },
+        "defaultAidDomain": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$",
+          "description": "自动生成控制 AID 与 benchmark AID 使用的后缀域名；不影响已有 AID"
+        },
+        "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" },
+        "defaultEncrypt": { "type": "boolean", "description": "所有 daemon 管理的 AUN 通道共用的出站默认加密值；省略时为 true" }
+      }
+    },
+    "services": {
+      "type": "array",
+      "description": "daemon 管理的本机服务及其可选 AUN 代理",
+      "x-merge": "list",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "enabled"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9_-]+$",
+            "description": "服务的逻辑标识，同时作为 AUN 代理路由名；ecweb 表示本机 EC Web 服务实例"
+          },
+          "enabled": { "type": "boolean", "default": true, "description": "是否启用本机服务实例" },
+          "port": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "本机服务期望监听端口" },
+          "proxy": {
+            "type": "object",
+            "additionalProperties": false,
+            "allOf": [
+              {
+                "if": { "properties": { "enabled": { "const": true }, "source": { "const": "static" } }, "required": ["enabled", "source"] },
+                "then": { "required": ["endpoint", "visibility"] }
+              },
+              {
+                "if": { "properties": { "enabled": { "const": true } }, "required": ["enabled"] },
+                "then": { "required": ["source", "visibility"] }
+              }
+            ],
+            "properties": {
+              "enabled": { "type": "boolean", "default": false, "description": "是否通过 AUN Service Proxy 暴露该服务" },
+              "source": { "type": "string", "enum": ["instance", "static"], "description": "instance 表示自动发现同名本机服务；static 使用 endpoint 显式回连" },
+              "endpoint": { "type": "string", "maxLength": 2048, "description": "source=static 时使用的本机 HTTP/HTTPS 或 WS/WSS 回连地址" },
+              "serviceType": { "type": "string", "enum": ["http", "websocket", "ssh"], "default": "http", "description": "AUN 中公布的服务类型" },
+              "visibility": { "type": "string", "enum": ["public", "private", "aun-auth"], "default": "private", "description": "AUN Service Proxy 访问策略" },
+              "metadata": {
+                "type": "object",
+                "description": "非敏感服务描述；不得包含 endpoint、token、secret、cookie 等敏感信息",
+                "additionalProperties": { "type": "string", "maxLength": 8192 }
+              }
+            }
+          }
+        }
+      }
+    },
+    "configSnapshots": { "type": "boolean", "default": true, "description": "是否自动维护配置快照、启动日志和自检回落", "x-merge": "scalar" },
+    "restartRecovery": {
+      "type": "object",
+      "description": "重启失败后的自动修复配置；仅控制 restart-monitor 的 Claude self-heal",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否在重启失败后执行 Claude 自动修复；默认关闭" }
+      }
+    },
+    "delegationDiagnostics": {
+      "type": "object",
+      "description": "任务授权诊断持久化；仅用于排障，不恢复授权，事件保留 180 天、历史状态保留 90 天",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": true, "description": "是否持久化任务授权诊断；关闭后保留历史，内存诊断与权限校验不受影响，保存后热生效" }
+      }
+    },
+    "idleMonitor": {
+      "type": "object",
+      "description": "流式输出空闲监控配置",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true, "description": "是否启用空闲监控" },
+        "timeout": { "type": "number", "default": 120, "description": "空闲超时秒数" },
+        "apiRetryTimeout": { "type": "number", "description": "API 重试尝试连续无事件时的超时秒数；未设置时继承 timeout" },
+        "maxExecutionTime": { "type": "number", "description": "单个任务总执行时限（秒）；未配置、非数字或小于等于 0 表示不限制" }
+      }
+    },
+    "watch": {
+      "type": "object",
+      "description": "日志监听配置",
+      "x-merge": "dict",
+      "properties": {
+        "logTypes": { "type": "array", "description": "要监听的日志类型", "items": { "type": "string" } }
+      }
+    }
+  }
+}

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

@@ -72,10 +72,25 @@
       "x-merge": "scalar",
       "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
     },
-    "sessionIdleSec": {
-      "type": "number",
+    "sessionLoop": {
+      "type": "object",
       "x-merge": "scalar",
-      "description": "会话闲置周期，单位为秒；缺省或小于等于 0 关闭，正值小于 30 秒按 30 秒处理"
+      "description": "当前关系主会话的闲置触发设置；话题不继承",
+      "oneOf": [
+        {
+          "properties": { "enabled": { "const": false } },
+          "required": ["enabled"],
+          "additionalProperties": false
+        },
+        {
+          "properties": {
+            "enabled": { "const": true },
+            "idleSeconds": { "type": "integer", "minimum": 30, "maximum": 86400 }
+          },
+          "required": ["enabled", "idleSeconds"],
+          "additionalProperties": false
+        }
+      ]
     },
     "model": { "type": "string", "x-merge": "scalar" },
     "responseMode": { "type": "string", "x-merge": "scalar" },

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

@@ -13,9 +13,9 @@
     { "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.effort", "label": "Codex Effort", "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.codex.effort", "label": "Codex Effort", "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": "max", "label": "Max" }] },
     { "value": "baseagents.ecagent.model", "label": "EC Agent Model", "description": "角色可使用的 ecagent 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All ecagent models" }] },
-    { "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "minimal", "label": "Minimal" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
+    { "value": "baseagents.ecagent.effort", "label": "EC Agent Effort", "description": "角色使用 ecagent 时的默认推理强度及可覆盖范围。", "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.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" }] }
   ],
   "type": "object",
@@ -97,9 +97,9 @@
           "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": "很高" } },
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
             "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。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "一个允许覆盖到的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Codex 推理强度白名单；若提供，必须包含 default。" },
             "reason": { "type": "string", "description": "采用该 Codex 推理强度策略的可审计原因或管理备注。" }
           }
         },
@@ -109,9 +109,9 @@
           "additionalProperties": false,
           "description": "该角色使用 ecagent runner 时的推理强度策略。",
           "properties": {
-            "default": { "type": "string", "enum": ["auto", "minimal", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 ecagent 推理强度。" },
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 ecagent 推理强度。" },
             "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 ecagent 推理强度；缺省为 false。" },
-            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "minimal", "low", "medium", "high", "xhigh", "max"] }, "uniqueItems": true, "description": "允许关系级覆盖到的 ecagent 推理强度白名单；若提供，必须包含 default。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"] }, "uniqueItems": true, "description": "允许关系级覆盖到的 ecagent 推理强度白名单；若提供，必须包含 default。" },
             "reason": { "type": "string", "description": "采用该 ecagent 推理强度策略的可审计原因或管理备注。" }
           }
         }

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

@@ -11,20 +11,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   }

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

@@ -34,20 +34,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   },

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

@@ -12,20 +12,20 @@
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 首个本地工具表态检查（仅 chatmode=proactive 生效）：首个可被 PreToolUse 覆盖的本地工具必须是当前会话精确对应的 ec msg/group send，否则拦截；WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不进入此硬拒绝边界。",
+      "description": "proactive 意图表达门禁（仅 chatmode=proactive 生效）：每条新消息计数重置为 15，每轮结束后有意图表达成功则清零，否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图，≥ 16 时只放行 ec msg/group send。WebSearch、图像生成、浏览器和 Computer Use 等 hosted 工具不受门禁限制。",
       "x-enumDescriptions": {
-        "true": "启用：首个 hook 可覆盖的本地工具必须是精确会话 send",
-        "false": "禁用：不执行 proactive 首个本地工具 send 检查"
+        "true": "启用：开启意图表达门禁",
+        "false": "禁用：不启用意图表达门禁"
       }
     },
     "tool_use_reminder": {
       "type": "boolean",
       "enum": [true, false],
       "default": true,
-      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "description": "proactive 意图表达门禁与队列提醒（仅 chatmode=proactive 生效）：开启意图表达门禁（规则同 pre_tool_1stmsgchk），同时保留队列未读提醒。",
       "x-enumDescriptions": {
-        "true": "启用：自动汇报工具使用情况",
-        "false": "禁用：静默执行工具"
+        "true": "启用：开启意图表达门禁并保留队列未读提醒",
+        "false": "禁用：不启用门禁和队列提醒"
       }
     }
   }

package/kits/skills/.switches.json

@@ -1,3 +1,14 @@
 {
-  "ec-skill": { "enabled": true, "locked": true }
+  "ec-skill": {
+    "enabled": true,
+    "locked": true
+  },
+  "ec-group": {
+    "enabled": true,
+    "locked": false
+  },
+  "thread-ops": {
+    "enabled": true,
+    "locked": true
+  }
 }

package/kits/skills/ec-group/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: ec-group
+description: >-
+  群聊场景工作指南。当上下文里 chatType=group（你正在群里说话）时先加载本技能，
+  再用它判断要不要开口、怎么把消息真正发到群里、以及需要时怎么查历史、成员和群资源。
+  内容包含群消息发送语法、@ 点名、响应与否的判断、群规则与群文件的读取、群管理命令边界。
+  命令与权限部分只覆盖 **AUN 群**（channel=aun）；非 AUN 群（如飞书群）只在"要不要开口"这一层适用。
+  触发词：群聊、群消息、群成员、群规则、群文件、@某人、mention、发言。
+  不适用于私聊（chatType=private）和无渠道的本地会话；那两种情况不要加载本技能。
+license: MIT
+---
+
+# 群聊工作指南
+
+你在群里。群里有人、有其它 agent，也可能有人只是旁观。本技能说清三件事：**要不要开口、怎么开口、需要什么就去查什么**。
+
+**适用范围**：命令语法（第二节、第四节、第六节）只适用于 **AUN 群**（`channel=aun`）。非 AUN 群（飞书群等）
+只有判断响应、发言节奏这几节通用，具体发送方式走当前渠道的文档与 `[reply]` 段。
+
+> **本技能的建设任务**（技能本身的写作、ECK 清理、命令实测）记在同目录两份文档里：
+> `TASK.md` 是当前状态与任务清单，`WORKLOG.md` 是只追加的流水日志。
+> 私聊会话和群聊会话都往这两份里写，两边靠它们同步。开工先读 `TASK.md`，收工前把变化写回。
+> 与群聊任务无关时不用管它们。
+
+## 一、群规则压在所有东西之上
+
+上下文里 `groupRulesStatus` 为 `synced` / `cached` 时，群规则正文已注入，它定义本群的工作流、分工、交付格式和禁区。
+**群规则优先于本技能和其他通用群聊指引。** 与本技能冲突时按群规则办，但群规则不能越过系统权限边界和用户的明确指令。
+
+`missing` / `forbidden` / `ignored` 时没有群规则，按本技能办。状态含义完整表见 `$KITS_DOCS/evolcore/group-rules.md`。
+
+## 二、消息只有发了才算发
+
+群聊运行在 proactive 模式下，以 `[reply]` 段的实际 `chatMode` 为准：
+
+- **直接输出不会进群**。它只是思考过程，前端能看见，但不会触发对端的消息接收，也不进其他 agent 的输入。
+- **只有 `ec group send` 的正文才会到达群里。**
+
+命令语法只在此处完整写一遍，别处引用本节：
+
+```bash
+ec group send <selfAid> <groupId> '<text>' [选项]
+```
+
+| 选项 | 说明 |
+|---|---|
+| `--encrypt` / `--no-encrypt` | 必选一个，跟随收到消息的加密状态；不得省略后依赖默认 |
+| `--mention '<aid1>,<aid2>'` | @ 成员。写法固定为单引号包住、逗号分隔多个 aid，可重复传入 |
+| `--mention-all` | @ 所有人 |
+| `--file <path> [--as image\|video\|voice\|file]` | 发文件 |
+| `--payload '<json>'` | 附加结构化数据 |
+
+其它硬约束（同见 `[reply]` 段）：
+
+- 一次 shell 调用只跑一条完整的 `ec` 命令，不拼接管道、重定向或子 shell。
+- 正文一律用半角单引号包住；正文里的双引号、反引号和 `$` 前加反斜杠；半角撇号用 `ʼ`（U+02BC）或 `＇`（U+FF07）代替。
+- **正文必须以引号包住**。正文以 `/` 开头时尤其要注意——Git Bash 会把裸的 `/effort` 当成路径做 MSYS 转换，
+  实际发出去的是 `C:/Program Files/Git/effort`。这不是命令没生效，是正文被 shell 改了。
+- 一轮任务可能发 0 到多条消息。发成功就继续做剩下的，不要重复发同一条。
+- 被拒绝时不改目标、不改身份重试，直接说明原因。
+
+**判断成败**：失败一定 exit≠0 且带 `❌` 文案；但成功**不能只看那一行回执**。
+加密消息的回执里 `seq` 可能显示为空，看起来像没发出去。要确认交付，回群里查一次：
+
+```bash
+ec group history <selfAid> <groupId> --limit 6 --format json
+```
+
+看该条的 `encrypt` 与 `transport.status`（`accepted` 表示已投递）和 `transport.seq`。
+
+**参数校验发生在提交之前**，错法都有明确文案、不会静默降级：空正文报「缺少消息内容」；
+`--encrypt` 与 `--no-encrypt` 同用报「不能同时使用」。
+
+**外层输出保持极简**：工具调用之外用一两句说清当前状态或意图就够，不要把要发的正文在外面再抄一遍——那是纯浪费。
+
+**期望某人回应就要显式 @ 他**。对方若是 `mention-only`，不 @ 就不会被唤醒，说了等于没说。要跟多个人打交道时先查成员（见第四节）再决定 @ 谁。
+
+## 三、不是每条都要回
+
+群聊是一群人聊天，不是排队汇报。先判断，再决定开口还是收手。
+
+**该开口**：
+- 明确 @ 了你
+- 话题正需要你的能力或信息
+- 有人直接问你、在等你回应
+- 你有别人没说、且值得说的重要信息
+
+**该收手**（默认状态是沉默）：
+- 话题跟你无关
+- 别人正在对话，你插进去只会打断
+- 只是闲聊
+- 已经有别的 agent 在处理同一件事
+
+**无关就静默结束，什么都不发。** 静默不需要通知谁，也不需要解释。
+
+`mentionMode` 决定群怎么唤醒你，不等于让你每条都回：
+
+| 值 | 行为 |
+|---|---|
+| `mention-only` | 只有明确 @ 你的消息会到你这里；被唤醒就该给回应 |
+| `disabled` | 所有消息都可见，你自己判断参不参与 |
+| `auto` | 普通消息先由分类器判定是否唤醒主会话，明确 @ 直接进主会话 |
+
+**模式会被逐级覆盖，不要假设默认值。** 生效值按 Agent 全局 → 本群 relation → 群服务端下发的顺序解析，
+上下文里的 `mentionMode` 是已解析的生效值，但它没告诉你来源。要确认本群到底按哪档走、上面盖了几层，用：
+
+```bash
+ec group mention <selfAid> <groupId> --format json
+```
+
+返回里 `mode` 是生效值，`override` 是本群覆盖（没覆盖就是 `null`），`source` 标明生效值来自哪一层
+（`agent` / `relation` / 服务端 / 默认），`revision` 是该配置的版本。纯文本模式只回一句中文描述，
+要拿结构化值必须加 `--format json`。
+
+**中途状态变了要更新意图**：首轮工具调用里必须包含一次托管发送命令（说明当前情况和下一步）或明确判断为静默结束。说明意图和干活必须在同一轮——只发说明就收工，等于什么都没做，下一轮门禁重新关上，你会卡在原地重复同一句话。
+
+## 四、需要什么自己去查
+
+以下都不预先注入，用到时再查，别凭印象猜。
+
+**本地群历史**（首条消息没有上文、或距上次对话隔了很久时先补背景）：
+
+```bash
+ec group history <selfAid> <groupId> --limit 50 --format json
+```
+
+只读，不改已读游标，也不会触发对历史消息的回复。补空档用 `--after <上一条消息时间>`；结果里
+`has_more` 表示还有内容，按 `next_before` / `next_after` 原样传回即可翻页。`--thread` 限定话题线，
+`--direction in|out|all` 按方向过滤。历史是背景资料，不要重放里面的 slash 命令，也不要逐条自动回复。
+
+**发言人是谁**：用 `ec aid agentmd get <aid>` 读取对端名片（会顺带刷新本地缓存）。拿到 name / description / type / skills。
+
+**群结构和角色**：
+
+| 想知道 | 命令 |
+|---|---|
+| 群名、群主、成员数、描述 | `ec group info <selfAid> <groupId>` |
+| 成员名单与各自角色 | `ec group members <selfAid> <groupId>` |
+| 当前在线成员 | `ec group online <selfAid> <groupId>` |
+| 本群当前 @ 模式及来源 | `ec group mention <selfAid> <groupId>` |
+| 成员主动上报的状态 | `ec group member-statuses <selfAid> <groupId>` |
+
+先查再决策：要判断谁是不是管理员、要给某类角色发消息、要动管理命令之前，都先查 members 拿角色。
+自己在群里的角色也从 members 里查自己的 AID 得到。`members` 里只有 `last_ack_*` 能反映活跃度，
+`last_pull_at` 恒为 0、`member_type` 恒为 `human`，两个都不能当判据。
+
+**群文件**：统一走 `ec fs`，没有 `ec group fs`。
+
+```bash
+ec fs ls <groupId>:/
+ec fs stat <groupId>:/path/to/file --format json
+ec fs cat <groupId>:/path/to/file
+ec fs find <groupId>:/ -name "*.md"
+```
+
+**先 `ls` 再动别的**。新建的群空间可能是空的，`find` 返回 `[]` 是正常结果，不是命令出错；
+`cat` 一个不存在的路径才是错误。拿不准路径是否存在，先 `ls` 或 `stat`。
+
+名称过滤的选项是 **`--name <glob>`**（写 `-name` 会被判为不支持的选项）。
+
+写入看你在**群内**的角色：owner/admin 可写，member 只读，被拒时**不要重试、不要换参数绕**，
+直接说明原因。覆盖已有文件要加 `--force`。
+`ec fs` 的群操作只在当前 AUN 群会话里可用；跨群或私聊会话会报
+`Managed fs operations require the current AUN group relation`。
+
+**群规则文件**：远端权威路径固定是 `<groupId>:/rules.md`。
+
+```bash
+ec group rules <selfAid> <groupId> get [--format json]
+```
+
+`get` 会先验签名再比对远端 `size + mtimeMs`，不等同于 `ec fs cat`。日常读取以 `get` 为准。
+
+## 五、协作与发言节奏
+
+- **短比长好**。一两句说清就行，别写小作文；真有复杂东西要讲，先问大家要不要展开。
+- **接话比抢话好**。看看别人说了什么，顺着往下聊，不要各说各的。
+- **跟 agent 聊也是聊**。其他 agent 的发言同样是讨论的一部分，可以回应、追问、反驳。
+- 人类可能在旁观，不一定每次都发言，这很正常。
+- 不需要显式投票或流程，聊到大家都觉得「行了就这样」，共识自然形成。
+
+## 六、管理操作与权限
+
+管理命令（`create` / `invite` / `kick` / `role` / `ban` / `block` / `rules set` / `dissolve` / `suspend` 等）
+的 `<from>` 必须是当前 self AID，不要代替别的 agent 发起操作。
+
+权限有**两道门，判据不同，别互相推论**：
+
+1. **群管理命令看本轮 actor**。member 身份的一轮里，`ec group rules set` 会被直接判
+   `ROLE_ACCESS_DENIED`，即使该群的实际所有者是别人。
+2. **`ec fs` 群空间写入看你自己的群内角色**。你在群里是 member 时，即使本轮是 owner 在对话，写群空间依然 `forbidden`。
+
+**群内禁止技能操作**：创建、安装、删除、启用、禁用技能在群聊里一律被拒，与你在群里的角色无关——
+即使 owner 也一样。拒绝文案是「拒绝：本机级/Agent 级技能开关不支持在群聊中操作。请在私聊中提出，
+或由管理员在宿主终端执行。」（判定在 `ec-skill` 的 `assertPermission()`，按 `chatType === 'group'` 直接拦）。
+被拒时不要重试、不要换参数绕过，直接说明限制原因，建议对方走私聊或宿主终端。
+
+**群内可用的 slash 命令**只放行两组（按 `chatType === 'group'` 校验）：
+
+- 只读查询：`/model` `/effort` `/perm` `/baseagent`。这四个**不接受参数**——带参一律回
+  「群聊中 X 仅支持查询，请在私聊或管理界面操作」。`/model current|list|check` 是唯一例外。
+- 任务类：`/help` `/evolhelp` `/status` `/check` `/ask` `/pause` `/resume` `/stop` `/compact` `/renew` `/mention` `/memory`。
+
+其余一律回「群聊中不支持 /xxx」。所以 `/chatmode`、`/activity` 以及 `/model` 的切换、重置、审批等
+写操作在群内都不可用，需要走私聊或管理界面。
+
+注意：这条白名单拦的是**客户端发来的 slash 消息**。你用 `ec group send` 发出去的 `/xxx` 只是一段
+普通文字，不走命令解析——想通过群消息间接执行 slash 是行不通的。
+
+## 七、命令速查
+
+```bash
+# 发消息（唯一完整语法在第二节）
+ec group send <selfAid> <groupId> '<text>' [--encrypt|--no-encrypt] [--mention '<aid1>,<aid2>']
+
+# 查上下文
+ec group history <selfAid> <groupId> --limit 50 --format json
+ec group info <selfAid> <groupId>
+ec group members <selfAid> <groupId>
+ec group online <selfAid> <groupId>
+ec group mention <selfAid> <groupId>
+ec aid agentmd get <aid>
+
+# 群资源
+ec fs ls <groupId>:/
+ec fs cat <groupId>:/path/to/file
+ec group rules <selfAid> <groupId> get
+
+# 管理（owner/admin）
+ec group invite / kick / role / ban / block / rules set / dissolve / suspend ...
+```
+
+完整命令与参数见 `$KITS_DOCS/evolcore/group.md`；规则文件机制见 `$KITS_DOCS/evolcore/group-rules.md`；
+发起一次完整协作见 `$KITS_DOCS/evolcore/group-collaboration.md`。

package/kits/skills/ec-skill/SKILL.md

@@ -87,7 +87,9 @@ EC 的技能系统：**一组可加载的能力单元**，每个技能是一个
 模型看到索引 → 按 description 判断相关性 → 命中才 Read 完整 `SKILL.md`。
 所以 **description 是路由器**，不是介绍文案：写得含糊，技能永远不会被选中。
 
-索引在技能变更后由监控器约 2 秒内标记待更新，下一条消息处理时重建，不需要手工触发。
+索引**不会自动更新**（技能目录默认不监控）。`create` / `install` / `remove` / `enable` /
+`disable` 之后，或手改了 `.switches.json`、SKILL.md 的 description，都要再执行一次
+`refresh <当前 AID>` 让 daemon 重建索引，否则模型看到的仍是旧列表。
 
 ### 路径：模型自己拼绝对路径
 
@@ -148,6 +150,13 @@ node "<技能目录>/scripts/cli.mjs" <子命令>
 | `disable <name> [--level agent\|local]` | 禁用（默认 agent 级） |
 | `validate <name\|路径>` | 校验 SKILL.md 是否合规 |
 | `where` | 打印三级根目录的实际路径 |
+| `refresh <aid> [--json]` | 让 daemon 重建该 Agent 的技能索引（只能刷当前 Agent，需 owner/admin） |
+
+改动技能后执行一次 `refresh`，`<aid>` 填当前 Agent 自己的 AID（上下文里的 `selfAid`）：
+
+```bash
+node "<技能目录>/scripts/cli.mjs" refresh <selfAid>
+```
 
 ### 常见任务
 

package/kits/skills/ec-skill/scripts/cli.mjs

@@ -7,13 +7,15 @@
  */
 
 import * as S from './skill.mjs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 
 const USAGE = `ec skill —— EC 技能管理
 
 用法:
   ec skill list [--json]                     列出所有技能
   ec skill info <name> [--json]              查看单个技能详情
-  ec skill create <name> [--desc "..."] [--force] [--enable]
+  ec skill create <name> [--desc '...'] [--force] [--enable]
                                              新建技能骨架（默认禁用）
   ec skill install <源> [--force] [--enable] 安装技能（目录 / .zip / .md，默认禁用）
   ec skill remove <name>                     删除本机技能
@@ -23,12 +25,14 @@ const USAGE = `ec skill —— EC 技能管理
                                              禁用技能（默认 agent 级）
   ec skill validate <name|路径>              校验 SKILL.md 是否合规
   ec skill where                             打印三级根目录路径
+  ec skill refresh <aid> [--json]            重建该 Agent 的技能索引（经 daemon）
 
 说明:
   - 安装目标只能是本机级（Agent 级只放开关，不放 SKILL.md）
   - create / install 装完默认**禁用**，确认后再用 enable 启用（--enable 可一步到位）
   - 内置级（随包发布）不可写、不可删
-  - 改动后约 2 秒内标记待更新，下一条消息处理时重建索引
+  - 技能目录默认不再自动监控：create / install / remove / enable / disable 之后，
+    执行一次 ec skill refresh <aid> 才会更新注入给模型的技能索引
 `;
 
 function parseArgs(argv) {
@@ -58,6 +62,16 @@ async function main() {
   }
 
   const sub = argv[0];
+
+  // refresh 由 daemon 执行（索引生成与鉴权都在 daemon 里），本脚本不实现 IPC 客户端：
+  // 原样转交包内的 ec 入口（bin/ec.js 自动选 src 或 dist），连 --help 一起交过去。
+  if (sub === 'refresh') {
+    const ecBin = path.resolve(import.meta.dirname, '..', '..', '..', '..', 'bin', 'ec.js');
+    const r = spawnSync(process.execPath, [ecBin, 'skill', ...argv], { stdio: 'inherit' });
+    if (r.error) throw r.error;
+    return r.status ?? 1;
+  }
+
   const { flags, positional } = parseArgs(argv.slice(1));
 
   if (flags.help) { console.log(USAGE); return 0; }