evolcore 0.0.28 → 0.0.29

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

@@ -97,12 +97,40 @@
         }
       }
     },
+    "decision_model": {
+      "type": "object",
+      "description": "Session Renew 和群聊 auto 注意力分类使用的 Decision Model 配置；base_url 为完整请求地址，运行时直接 POST。",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "model": { "type": "string", "minLength": 1 },
+        "base_url": { "type": "string", "minLength": 1 },
+        "apikey": { "type": "string", "minLength": 1 },
+        "headers": {
+          "type": "object",
+          "propertyNames": { "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$" },
+          "additionalProperties": { "type": "string", "pattern": "^[^\\u0000\\r\\n]*$" }
+        },
+        "queryParams": {
+          "type": "object",
+          "propertyNames": { "minLength": 1 },
+          "additionalProperties": { "type": "string" }
+        }
+      }
+    },
     "responseMode": { "type": "string", "x-merge": "scalar" },
     "responseModeParams": {
       "type": "object",
       "x-merge": "dict",
       "description": "响应模式特有参数的全局默认字典，按模式 id 分桶：{ [modeId]: {...} }"
     },
+    "autoMentionQuietWindowMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 3000,
+      "x-merge": "scalar",
+      "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
+    },
     "config": { "type": "object", "x-merge": "dict" },
     "session_renew": {
       "type": "object",
@@ -113,6 +141,7 @@
         "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": "开启新会话" } }
+        ,"new_probability_threshold": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.85, "description": "noul 达到该概率后开启新会话" }
       }
     }
   }

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

@@ -64,7 +64,19 @@
       }
     },
     "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" },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only", "auto"], "x-merge": "scalar" },
+    "autoMentionQuietWindowMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 3000,
+      "x-merge": "scalar",
+      "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
+    },
+    "sessionIdleSec": {
+      "type": "number",
+      "x-merge": "scalar",
+      "description": "会话闲置周期，单位为秒；缺省或小于等于 0 关闭，正值小于 30 秒按 30 秒处理"
+    },
     "model": { "type": "string", "x-merge": "scalar" },
     "responseMode": { "type": "string", "x-merge": "scalar" },
     "responseModeParams": { "type": "object", "x-merge": "dict" },
@@ -80,6 +92,7 @@
         "enabled": { "type": "boolean" },
         "after_hours": { "type": "number", "exclusiveMinimum": 0 },
         "fallback_action": { "type": "string", "enum": ["continue", "new"] }
+        ,"new_probability_threshold": { "type": "number", "minimum": 0, "maximum": 1 }
       }
     },
     "group_venue_sync": { "type": "object", "x-merge": "dict" },

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

@@ -0,0 +1,129 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.9.json",
+  "title": "RelationConfig v9 (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "anyOf": [
+      { "required": ["permissionMode"] },
+      { "required": ["roles"] },
+      {
+        "required": ["aun"],
+        "properties": {
+          "aun": {
+            "type": "object",
+            "required": ["defaultEncrypt"]
+          }
+        }
+      }
+    ]
+  },
+  "properties": {
+    "$schema_version": { "type": "number", "const": 9, "default": 9, "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",
+      "description": "关系级模型覆盖；备用模型链只能在 defaults.json 配置。",
+      "additionalProperties": {
+        "not": {
+          "type": "object",
+          "required": ["fallbackModels"]
+        },
+        "properties": {
+          "headers": {
+            "type": "object",
+            "propertyNames": { "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$" },
+            "additionalProperties": { "type": "string", "pattern": "^[^\\u0000\\r\\n]*$" }
+          },
+          "queryParams": {
+            "type": "object",
+            "propertyNames": { "minLength": 1 },
+            "additionalProperties": { "type": "string" }
+          },
+          "auxiliaryModel": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Session Renew 语义连续性判断使用的 direct 辅助模型。"
+          },
+          "auxiliaryEffort": {
+            "type": "string",
+            "enum": ["low", "medium", "high", "xhigh", "max"],
+            "description": "Session Renew 辅助模型的可选推理强度。"
+          }
+        },
+        "dependencies": {
+          "auxiliaryEffort": ["auxiliaryModel"]
+        }
+      }
+    },
+    "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", "auto"], "x-merge": "scalar" },
+    "autoMentionQuietWindowMs": {
+      "type": "number",
+      "minimum": 0,
+      "default": 3000,
+      "x-merge": "scalar",
+      "description": "群聊 auto 注意力分类的静默等待窗口，单位为毫秒；默认 3000"
+    },
+    "sessionIdleSeconds": {
+      "type": "number",
+      "x-merge": "scalar",
+      "description": "会话闲置周期，单位为秒；缺省或小于等于 0 关闭，正值小于 30 秒按 30 秒处理"
+    },
+    "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"] },
+        "new_probability_threshold": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "description": "关系级记忆开关；enableRelation 由对端自主配置，与 agent 级 memory.enableRelation 做 AND 合并（任意层为 false 则关闭）。",
+      "properties": {
+        "enableRelation": {
+          "type": "boolean",
+          "x-merge-logic": "AND",
+          "description": "对端自主控制本关系的 relation 作用域记忆是否启用；与 agent 级 enableRelation 做 AND 合并。"
+        }
+      }
+    },
+    "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/role-config.schema.1.json

@@ -9,7 +9,7 @@
     { "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": "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": "auto", "label": "Auto" }] },
     { "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" }] },
@@ -73,9 +73,9 @@
           "additionalProperties": false,
           "description": "该角色在群聊场景中的提及响应策略。",
           "properties": {
-            "default": { "type": "string", "enum": ["disabled", "mention-only"], "description": "未设置有效关系级覆盖时使用的群聊提及响应策略。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应" } },
+            "default": { "type": "string", "enum": ["disabled", "mention-only", "auto"], "description": "未设置有效关系级覆盖时使用的群聊提及响应策略。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应", "auto": "按群内上下文自动判断" } },
             "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。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["disabled", "mention-only", "auto"], "description": "一个可用于群聊提及响应策略覆盖的值。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应", "auto": "按群内上下文自动判断" } }, "uniqueItems": true, "description": "允许关系级覆盖到的群聊提及响应策略白名单；若提供，必须包含 default。" },
             "reason": { "type": "string", "description": "采用该群聊提及响应策略的可审计原因或管理备注。" }
           }
         },

package/kits/skills/.switches.json

@@ -0,0 +1,3 @@
+{
+  "ec-skill": { "enabled": true, "locked": true }
+}

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

@@ -0,0 +1,217 @@
+---
+name: ec-skill
+description: >-
+  EC 技能系统的说明与工具。用于新建、安装、删除、启用、禁用、查看和校验 EC 技能。
+  当用户要求"创建技能""新建 skill""安装技能""装个 skill""删除/禁用/启用技能"
+  "看看有哪些技能""这个技能为什么没生效"，或询问技能系统怎么工作、
+  SKILL.md 怎么写、技能放在哪里时使用。
+  不适用于 base agent（Claude Code / Codex）自己的技能——那些由各自的工具管理。
+license: MIT
+---
+
+# EC Skill 管理
+
+EC 的技能系统：**一组可加载的能力单元**，每个技能是一个目录，里面放 `SKILL.md`。
+本技能既是这套系统的说明书，也是操作它的工具。
+
+## 先读文档
+
+**机制概要（随包发布，推荐先读）**：
+
+```
+<包根>/kits/docs/evolcore/ec-capabilities.md
+```
+
+> 文件名不叫 `skills.md`——`package.json` 的 `files` 里有 `!skills/` 规则，
+> 任何名字含 `skills` 的文件在打包时会被一并排除。这个坑别再踩。
+
+涵盖：三级目录、开关覆盖链、`locked` 正交语义、渐进式披露、`description` 写法、
+路径拼接约定、依赖声明、权限取交集、边界情况与常见坑。本文只列操作要点，细节以那份为准。
+
+改写技能正文、排查「技能为什么没生效」、判断某个做法是否合规时，**先读它**。
+
+**开发设计文档（仅源码仓库，不随包发布）**：
+
+如果你手上是 evolcore 源码仓库（`<仓库根>/docs/skills/` 存在），以下四份讲的是
+机制**为什么这么设计**：
+
+| 文档 | 内容 |
+|---|---|
+| `docs/skills/skill-md-spec-and-loading.md` | `SKILL.md` 规范、frontmatter 字段语义、渐进式披露、三家对照 |
+| `docs/skills/ec-skill-system-design.md` | 三级目录、开关模型、覆盖链、`locked` 正交语义、前端展示 |
+| `docs/skills/ec-skill-injection.md` | 索引怎么生成、防抖、文件格式、manifest 注入段位 |
+| `docs/skills/skill-script-execution.md` | 脚本执行、路径解析、依赖检查、权限闸门、隔离与 8 个待澄清问题 |
+
+**不要假设这些文档存在**——npm 包只发布 `kits/`，`docs/` 被排除。先确认目录再读。
+
+## 系统怎么工作
+
+### 三级目录
+
+| 级别 | 位置 | 谁维护 |
+|---|---|---|
+| 内置级 | `<包根>/kits/skills/` | 随包发布，用户不应改 |
+| 本机级 | `$EVOLCORE_HOME/skills/` | 用户安装，本机所有 agent 共享 |
+| Agent 级 | `$EVOLCORE_AGENT_DIR/skills/` | 只放开关，不放 SKILL.md |
+
+用 `ec skill where` 可打印这三条路径的**实际值**，不要凭记忆猜。
+
+### 开关：每级一个 `.switches.json`
+
+开关**不是**每技能一个文件，而是每级一个字典：
+
+```json
+{
+  "my-skill": { "enabled": true },
+  "core-guard": { "enabled": true, "locked": true }
+}
+```
+
+- **技能名不在字典里 → 禁用**（开关字典是显式白名单，缺省即关）
+- `enabled: true` 才启用；字段缺失或写成其它值都按禁用处理
+- `locked` 只在**内置级**有意义，表示"任何级别都关不掉"
+- 覆盖链：**Agent 级 > 本机级 > 内置级**（由近及远，谁有声明谁说了算）
+
+`locked: true` 与 `enabled` 是独立维度：`locked` 只表达"不可覆盖"，不表达"强制开"。
+所以 `{"enabled": false, "locked": true}` 是"关着且谁都打不开"。
+
+> 缺省即禁用是刻意设计：**安装不写开关文件**，兄弟技能不会因为"忘了关"而悄悄生效，
+> 只有显式 `enable` 过的技能才进索引。
+
+### 索引：渐进式披露
+
+技能正文**不常驻上下文**。常驻的只有每个技能的 `name` + `description`，写在
+`<Agent 目录>/skills/.index-builtin.md` 与 `.index-local.md` 两个文件里，
+由 ECK manifest 注入。
+
+模型看到索引 → 按 description 判断相关性 → 命中才 Read 完整 `SKILL.md`。
+所以 **description 是路由器**，不是介绍文案：写得含糊，技能永远不会被选中。
+
+索引在技能变更后由监控器约 2 秒内标记待更新，下一条消息处理时重建，不需要手工触发。
+
+### 路径：模型自己拼绝对路径
+
+EC 不会把 cwd 设到技能目录，所以 `SKILL.md` 里写裸相对路径（`scripts/foo.mjs`）时，
+**必须由模型自己拼成绝对路径再执行**。索引文件里给了根目录和拼法。
+
+配套硬要求：**脚本内部要用自身位置定位资源**，不能依赖 cwd：
+
+```js
+// 好：从脚本自身推
+const SKILL_DIR = path.resolve(import.meta.dirname, '..');
+
+// 差：依赖 cwd，cwd 不对就挂
+fs.readFileSync('assets/template.csv');
+```
+
+## 怎么写一个技能
+
+一个技能一个目录，目录名 = `SKILL.md` 里 `name` 字段（kebab-case）：
+
+```
+my-skill/
+├── SKILL.md          必须。frontmatter + Markdown 正文
+├── references/       可选。大块资料，按需读取，不进默认上下文
+├── scripts/          可选。确定性脚本
+└── assets/           可选。模板、样例数据
+```
+
+frontmatter 必填两项：
+
+```yaml
+---
+name: my-skill                    # 必须与目录名一致
+description: >-                   # 最关键：写清做什么 + 触发场景 + 不适用场景
+  一句话说清能力。当用户要求……时使用。不适用于……
+---
+```
+
+正文建议结构：**目标 → 步骤（编号、祈使句）→ 输出契约 → 边界情况 → 参考资料指引**。
+超过 500 行就把细节挪到 `references/`。
+
+## 工具
+
+脚本自定位，**执行时必须写完整绝对路径**（不要依赖 cwd）：
+
+```bash
+node "<技能目录>/scripts/cli.mjs" <子命令>
+```
+
+| 子命令 | 作用 |
+|---|---|
+| `list [--json]` | 列出所有技能：名称、来源、最终状态 |
+| `info <name> [--json]` | 单技能详情：路径、描述、三级开关、生效依据、校验问题 |
+| `create <name> [--desc "..."] [--force] [--enable]` | 新建技能骨架到本机级（默认禁用） |
+| `install <源> [--force] [--enable]` | 安装技能（目录 / `.zip` / `.md`）到本机级（默认禁用） |
+| `remove <name>` | 删除本机技能（内置技能不能删） |
+| `enable <name> [--level agent\|local]` | 启用（默认 agent 级） |
+| `disable <name> [--level agent\|local]` | 禁用（默认 agent 级） |
+| `validate <name\|路径>` | 校验 SKILL.md 是否合规 |
+| `where` | 打印三级根目录的实际路径 |
+
+### 常见任务
+
+**新建一个技能**：
+
+```bash
+node "<技能目录>/scripts/cli.mjs" create my-analyzer --desc "分析日志并汇总。当用户要求分析日志时使用。"
+```
+
+生成后**必须补全 description**——它是技能被选中的唯一依据。
+
+**安装**：支持目录、`.zip`、单个 `.md`。安装前会校验 `SKILL.md`，
+不合规直接拒绝。`.zip` 首次使用会自动装解压依赖（需要联网，之后离线可用）。
+
+**装完默认禁用**：`install`（和 `create`）**不写开关文件**——开关字典里没有该技能
+就等于禁用，技能不进索引、不会被模型选中。确认要用之后显式启用：
+
+```bash
+node "<技能目录>/scripts/cli.mjs" enable <name>
+```
+
+需要装完即启用时加 `--enable`（此时才写入 `{"enabled": true}`）：
+`install <源> --enable`。这是刻意设计——陌生技能不应在未经确认时自动生效。
+
+> **装完必须问一句**：`install` 成功后，**主动询问用户是否启用**，别默认替用户开。
+> 用户确认后再跑 `enable <name>`（本机级全机生效要 `--level local`）；
+> 用户明确说"启用"时也可直接用 `install <源> --enable` 一步到位。
+> 询问话术一句话即可，不要展开成选项清单。
+
+**为什么某个技能没生效**：用 `info <name>` 看 `生效依据` 那一行，
+它会指出是 Agent 级 / 本机级 / 内置级 / 默认值决定了当前状态。
+
+### 权限：写入类子命令不是谁都能跑
+
+写入类子命令（`create` / `install` / `remove` / `enable` / `disable`）有权限门禁，
+判据取自当前会话的角色与场景：
+
+| 情形 | 结果 |
+|------|------|
+| 群聊里（**含 owner 本人**） | 一律拒绝 |
+| 私聊 + Agent 级写（`--level agent`，默认） | 需本 Agent 的 **owner** |
+| 私聊 + 本机级写（`install` / `remove` / `create` / `--level local`） | 需 **daemonowner** |
+| 宿主终端直连（无会话上下文） | 放行 |
+
+**在群里被拒时不要重试、不要换参数绕过**：这是设计使然——技能开关是 agent 自身配置，
+不该被群里的对话推动。直接把结论告诉对方，请其私聊提出或由管理员在终端执行。
+
+本机级目录是**整机所有 agent 共享**的，所以装/删/建和本机级开关同档，都要 daemonowner。
+
+只读子命令（`list` / `info` / `where` / `validate`）不受限制。
+
+## 边界情况
+
+- **装完默认禁用**：`install` / `create` 不写开关文件，缺省即禁用，
+  技能不进索引、不被选中，等确认后再 `enable`。加 `--enable` 可装完即启用。
+- **开关是显式白名单**：字典里没有该技能 = 关。手改 `.switches.json` 时别写 `false` 当"关"——
+  删掉条目才是缺省关。
+- **内置技能不可删**：随包发布，`remove` 会拒绝。要停用请用 `disable`。
+- **Agent 级不能装技能**：那一级只有 `.switches.json`。想让某技能只对单个 agent 生效，
+  先装到本机级，再对其他 agent `disable`。
+- **`locked` 技能关不掉**：`enable/disable` 会拒绝，并说明原因。
+- **离线环境**：`install` 用目录方式不受影响；`.zip` 需要联网装一次解压依赖。
+
+## 依赖说明
+
+`scripts/deps.mjs` 负责按需把第三方包装到 `$EVOLCORE_HOME/skills/.deps/`，
+版本在文件里锁死。装过一次后**离线可用**——每次都先查该目录，命中就不再联网。

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

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * ec-skill 命令行入口。
+ *
+ * 这是薄壳：解析参数 → 调用 skill.mjs 的导出函数。
+ * 逻辑一律不写在这里，避免和模型侧的用法产生两份实现。
+ */
+
+import * as S from './skill.mjs';
+
+const USAGE = `ec skill —— EC 技能管理
+
+用法:
+  ec skill list [--json]                     列出所有技能
+  ec skill info <name> [--json]              查看单个技能详情
+  ec skill create <name> [--desc "..."] [--force] [--enable]
+                                             新建技能骨架（默认禁用）
+  ec skill install <源> [--force] [--enable] 安装技能（目录 / .zip / .md，默认禁用）
+  ec skill remove <name>                     删除本机技能
+  ec skill enable <name> [--level agent|local]
+                                             启用技能（默认 agent 级）
+  ec skill disable <name> [--level agent|local]
+                                             禁用技能（默认 agent 级）
+  ec skill validate <name|路径>              校验 SKILL.md 是否合规
+  ec skill where                             打印三级根目录路径
+
+说明:
+  - 安装目标只能是本机级（Agent 级只放开关，不放 SKILL.md）
+  - create / install 装完默认**禁用**，确认后再用 enable 启用（--enable 可一步到位）
+  - 内置级（随包发布）不可写、不可删
+  - 改动后约 2 秒内标记待更新，下一条消息处理时重建索引
+`;
+
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--json') flags.json = true;
+    else if (a === '--force') flags.force = true;
+    else if (a === '--enable') flags.enable = true;
+    else if (a === '--help' || a === '-h') flags.help = true;
+    else if (a.startsWith('--')) {
+      const key = a.slice(2);
+      const val = argv[i + 1];
+      if (val === undefined || val.startsWith('--')) { flags[key] = true; }
+      else { flags[key] = val; i++; }
+    } else positional.push(a);
+  }
+  return { flags, positional };
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0 || argv[0] === 'help' || argv[0] === '--help' || argv[0] === '-h') {
+    console.log(USAGE);
+    return 0;
+  }
+
+  const sub = argv[0];
+  const { flags, positional } = parseArgs(argv.slice(1));
+
+  if (flags.help) { console.log(USAGE); return 0; }
+
+  const asJson = Boolean(flags.json);
+  const emit = (result) => {
+    if (asJson) console.log(JSON.stringify(result, null, 2));
+    else if (typeof result === 'string') console.log(result);
+    else console.log(JSON.stringify(result, null, 2));
+  };
+
+  switch (sub) {
+    case 'list':
+      emit(S.cmdList({ json: asJson }));
+      return 0;
+
+    case 'info':
+      emit(S.cmdInfo(positional[0], { json: asJson }));
+      return 0;
+
+    case 'create':
+      emit(S.cmdCreate(positional[0], { desc: flags.desc || '', force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
+      return 0;
+
+    case 'install':
+      emit(S.cmdInstall(positional[0], { force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
+      return 0;
+
+    case 'remove':
+      emit(S.cmdRemove(positional[0], { json: asJson }));
+      return 0;
+
+    case 'enable':
+      emit(S.cmdEnableDisable(positional[0], true, { level: flags.level || 'agent', json: asJson }));
+      return 0;
+
+    case 'disable':
+      emit(S.cmdEnableDisable(positional[0], false, { level: flags.level || 'agent', json: asJson }));
+      return 0;
+
+    case 'validate': {
+      const result = S.cmdValidate(positional[0], { json: asJson });
+      // 校验失败必须以非零退出，否则调用方（模型/脚本）无法判断结果
+      if (result && result.__isText) {
+        console.log(result.output);
+        return result.valid ? 0 : 1;
+      }
+      emit(result);
+      return result && result.valid === false ? 1 : 0;
+    }
+
+    case 'where':
+      emit(S.cmdWhere({ json: asJson }));
+      return 0;
+
+    default:
+      console.error(`未知子命令: ${sub}\n`);
+      console.error(USAGE);
+      return 1;
+  }
+}
+
+main()
+  .then(code => process.exit(code ?? 0))
+  .catch(err => {
+    console.error(`❌ ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  });