evolcore 0.0.45 → 0.0.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (204) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/bin/ecmsg.js +33 -23
  3. package/dist/ability/application-service.js +1 -2
  4. package/dist/ability/package.js +28 -0
  5. package/dist/agent-template/jobs.js +158 -36
  6. package/dist/agent-template/runtime.js +401 -34
  7. package/dist/agent-template/service.js +764 -369
  8. package/dist/agent-template/tool-runner.js +35 -17
  9. package/dist/agent-template/types.js +7 -4
  10. package/dist/agents/baseagent.js +10 -9
  11. package/dist/agents/claude-runner.js +13 -5
  12. package/dist/agents/codex/app-server-client.js +2 -4
  13. package/dist/agents/codex/diagnostics.js +18 -1
  14. package/dist/agents/codex-runner.js +3 -1
  15. package/dist/agents/ecagent-runner.js +3 -1
  16. package/dist/agents/gemini-runner.js +2 -1
  17. package/dist/aun/menu/client.js +142 -182
  18. package/dist/aun/rpc/client.js +33 -17
  19. package/dist/aun/service-proxy.js +6 -23
  20. package/dist/channels/aun.js +656 -112
  21. package/dist/cli/agent-create.js +37 -10
  22. package/dist/cli/agent-template.js +105 -84
  23. package/dist/cli/agent.js +31 -18
  24. package/dist/cli/daemon-commands.js +15 -17
  25. package/dist/cli/daemon-lifecycle-client.js +40 -18
  26. package/dist/cli/directory.js +12 -4
  27. package/dist/cli/ecmsg-gateway.js +5 -2
  28. package/dist/cli/events-command.js +2 -1
  29. package/dist/cli/init.js +50 -20
  30. package/dist/cli/integrity-command.js +2 -0
  31. package/dist/cli/managed-command-guard.js +20 -1
  32. package/dist/cli/menu-client.js +7 -5
  33. package/dist/cli/restart-monitor.js +33 -20
  34. package/dist/cli/services-command.js +28 -5
  35. package/dist/config/config-field-policy.js +24 -0
  36. package/dist/config/config-manager.js +20 -2
  37. package/dist/config/peer-book-store.js +152 -120
  38. package/dist/config/peer-role-resolver.js +24 -4
  39. package/dist/config/provider-identity-migration.js +1 -1
  40. package/dist/config/provider-identity.js +10 -4
  41. package/dist/config/provider-ipc-service.js +10 -2
  42. package/dist/config/provider-local-sync.js +2 -2
  43. package/dist/config/providers-config.js +95 -10
  44. package/dist/config/providers-import.js +4 -6
  45. package/dist/config/providers.js +14 -3
  46. package/dist/config/role-store.js +1 -1
  47. package/dist/config-store.js +9 -1
  48. package/dist/core/agent-application-service.js +56 -29
  49. package/dist/core/agent-create-status.js +3 -1
  50. package/dist/core/agent-creation-claim.js +1 -0
  51. package/dist/core/agent-ipc-registration.js +2 -2
  52. package/dist/core/agent-reload-coordinator.js +38 -1
  53. package/dist/core/agent-runtime.js +85 -38
  54. package/dist/core/auth/agent-delegation.js +5 -0
  55. package/dist/core/auth/operation-authorizer.js +1 -1
  56. package/dist/core/auth/operation-catalog.js +3 -3
  57. package/dist/core/bootstrap-service.js +3 -0
  58. package/dist/core/capability/capability-manager.js +3 -1
  59. package/dist/core/channel-loader.js +29 -3
  60. package/dist/core/channel-runtime.js +1 -1
  61. package/dist/core/command/agent-control.js +6 -5
  62. package/dist/core/command/agent-template-menu.js +32 -97
  63. package/dist/core/command/eventcenter-menu.js +61 -13
  64. package/dist/core/command/menu-catalog.js +11 -4
  65. package/dist/core/command/menu-handler.js +35 -8
  66. package/dist/core/command/menu-protocol.js +8 -16
  67. package/dist/core/command/skill-slash.js +6 -2
  68. package/dist/core/command/team-workspace-bootstrap.js +1 -2
  69. package/dist/core/command/team-workspace-management-store.js +83 -0
  70. package/dist/core/command/team-workspace-management.js +1 -2
  71. package/dist/core/command/team-workspace-team.js +26 -3
  72. package/dist/core/daemon-control.js +3 -4
  73. package/dist/core/daemon-lifecycle.js +146 -110
  74. package/dist/core/evolagent-registry.js +42 -0
  75. package/dist/core/evolagent.js +2 -1
  76. package/dist/core/file-integrity/read.js +9 -16
  77. package/dist/core/file-integrity/store.js +94 -34
  78. package/dist/core/handoff/dispatcher.js +33 -7
  79. package/dist/core/handoff/runtime.js +8 -0
  80. package/dist/core/inference/text-inference.js +12 -2
  81. package/dist/core/invoke/invoke-service.js +24 -3
  82. package/dist/core/ipc-registration.js +3 -0
  83. package/dist/core/message/aun-ipc-sender.js +109 -7
  84. package/dist/core/message/contact-admission.js +6 -2
  85. package/dist/core/message/message-bridge.js +13 -0
  86. package/dist/core/message/message-queue.js +131 -30
  87. package/dist/core/message/pending-hints.js +8 -0
  88. package/dist/core/message/response-engine.js +48 -2
  89. package/dist/core/message/send-routing.js +3 -12
  90. package/dist/core/model/catalog-service.js +13 -0
  91. package/dist/core/model/model-catalog.js +57 -18
  92. package/dist/core/pack-auth.js +163 -31
  93. package/dist/core/pack-install.js +42 -1
  94. package/dist/{services/ledger.js → core/pack-ledger.js} +17 -6
  95. package/dist/core/permission/ec-command-parser.js +3 -1
  96. package/dist/core/permission/shell-environment.js +23 -0
  97. package/dist/core/rate-window.js +6 -1
  98. package/dist/core/session/session-idle-monitor.js +0 -1
  99. package/dist/core/session/session-manager.js +14 -0
  100. package/dist/core/session/session-title.js +26 -6
  101. package/dist/core/skill/index-generator.js +3 -4
  102. package/dist/core/thread/thread-service.js +0 -1
  103. package/dist/core/thread/topic-id.js +8 -0
  104. package/dist/directory/owner-directory-admission.js +17 -0
  105. package/dist/directory/owner-directory-cache.js +3 -1
  106. package/dist/directory/owner-directory-markdown.js +145 -23
  107. package/dist/directory/owner-directory-policy.js +23 -0
  108. package/dist/directory/owner-directory-query-operation.js +20 -6
  109. package/dist/directory/owner-directory-search.js +47 -0
  110. package/dist/eck/message-renderer.js +171 -32
  111. package/dist/ecweb/basic-settings-service.js +7 -3
  112. package/dist/ecweb/providers-service.js +17 -10
  113. package/dist/ecweb/runtime/lifecycle.js +1 -1
  114. package/dist/ecweb/runtime/supervisor.js +77 -35
  115. package/dist/event-center/admission-materializer.js +1 -1
  116. package/dist/event-center/bus-gate.js +48 -4
  117. package/dist/event-center/bus-host.js +3 -3
  118. package/dist/event-center/center-config.js +57 -28
  119. package/dist/event-center/dispatcher.js +8 -0
  120. package/dist/event-center/event-log.js +69 -27
  121. package/dist/event-center/index-generator.js +6 -1
  122. package/dist/event-center/ipc-operation.js +66 -25
  123. package/dist/event-center/pack-loader.js +12 -55
  124. package/dist/event-center/pack-manager.js +5 -3
  125. package/dist/event-center/registry.js +48 -52
  126. package/dist/event-center/runtime.js +219 -81
  127. package/dist/event-center/script-runner.js +18 -7
  128. package/dist/event-center/types.js +9 -1
  129. package/dist/event-center/validation.js +33 -4
  130. package/dist/index.js +96 -42
  131. package/dist/ipc.js +33 -7
  132. package/dist/product.js +1 -0
  133. package/dist/proxy/manager.js +52 -11
  134. package/dist/proxy/service-supervisor.js +265 -67
  135. package/dist/services/dispatcher.js +26 -3
  136. package/dist/services/idempotency.js +128 -0
  137. package/dist/services/identity.js +3 -27
  138. package/dist/services/index-generator.js +5 -1
  139. package/dist/services/index.js +244 -45
  140. package/dist/services/ipc-operation.js +164 -20
  141. package/dist/services/pack-manager.js +37 -9
  142. package/dist/services/router.js +100 -31
  143. package/dist/services/script-runner.js +15 -4
  144. package/dist/services/service-payload.js +50 -2
  145. package/dist/services/validation.js +107 -3
  146. package/dist/trigger/scheduler.js +14 -4
  147. package/dist/trigger/script-sandbox.js +39 -2
  148. package/dist/utils/cross-platform.js +35 -11
  149. package/dist/utils/error-utils.js +13 -1
  150. package/dist/utils/instance-registry.js +33 -35
  151. package/dist/utils/process-introspect.js +35 -20
  152. package/dist/utils/project-path.js +47 -3
  153. package/dist/utils/windows-shell-trust.js +174 -68
  154. package/kits/docs/context-assembly.md +3 -3
  155. package/kits/docs/evolcore/agent.md +28 -10
  156. package/kits/docs/evolcore/config.md +22 -0
  157. package/kits/docs/evolcore/directory.md +46 -12
  158. package/kits/docs/evolcore/event-center.md +6 -6
  159. package/kits/docs/evolcore/group-collaboration.md +1 -1
  160. package/kits/docs/evolcore/menu-client.md +7 -5
  161. package/kits/docs/evolcore/menu-protocol.md +5 -3
  162. package/kits/docs/evolcore/msg.md +10 -3
  163. package/kits/docs/evolcore/provider.md +7 -3
  164. package/kits/docs/evolcore/services.md +145 -12
  165. package/kits/docs/evolcore/thread-chain.md +17 -9
  166. package/kits/docs/prompt-loading-architecture.md +4 -4
  167. package/kits/eck_message_manifest.json +46 -3
  168. package/kits/rules/04-relation.md +10 -2
  169. package/kits/rules/06-channel.md +2 -1
  170. package/kits/schemas/providers.schema.2.json +1 -0
  171. package/kits/skills/ec-group/SKILL.md +4 -0
  172. package/kits/skills/ec-skill/scripts/cli.mjs +1 -1
  173. package/kits/skills/ec-skill/scripts/skill.mjs +13 -2
  174. package/kits/skills/thread-ops/SKILL.md +8 -5
  175. package/kits/templates/message-fragments/group-batch-item.md +3 -0
  176. package/kits/templates/message-fragments/group-batch.md +1 -0
  177. package/kits/templates/message-fragments/item-group.md +4 -0
  178. package/kits/templates/message-fragments/item-private.md +4 -0
  179. package/kits/templates/message-fragments/thread-context.md +1 -1
  180. package/kits/templates/system-fragments/commands.md +5 -5
  181. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  182. package/kits/templates/system-fragments/relation.md +11 -7
  183. package/package.json +3 -2
  184. package/scripts/agent-template/index.mjs +9 -4
  185. package/scripts/agent-template/inspect.mjs +16 -9
  186. package/scripts/agent-template/shared/plan.mjs +3 -33
  187. package/scripts/agent-template/shared/template-contract.mjs +186 -3
  188. package/scripts/agent-template/shared/template-package.mjs +119 -10
  189. package/scripts/agent-template/shared/template-runtime.mjs +49 -6
  190. package/scripts/agent-template/shared/template.mjs +5 -5
  191. package/scripts/agent-template/team-pack.mjs +245 -0
  192. package/scripts/agent-template/team-preview.mjs +111 -0
  193. package/scripts/aid-batch/identity-batch.mjs +143 -0
  194. package/dist/ability/versions.js +0 -32
  195. package/dist/aun/model-headers.js +0 -17
  196. package/dist/channels/builtin-plugins.js +0 -19
  197. package/dist/core/command/team-workspace-initializer.js +0 -2
  198. package/dist/core/command/team-workspace-job-store.js +0 -88
  199. package/dist/core/command/team-workspace-management-service.js +0 -2
  200. package/dist/core/contact-bind-registry.js +0 -27
  201. package/dist/event-center/ledger.js +0 -52
  202. package/dist/services/reply.js +0 -55
  203. package/kits/templates/message-fragments/item.md +0 -3
  204. package/scripts/agent-template/pack.mjs +0 -169
@@ -64,6 +64,28 @@ ec config init [--self <aid>] [--peer <X>] [--default] [--process]
64
64
  - 实际连接时,变量未设置或为空会报错;`baseUrl` 解析后仍必须是 HTTP(S) URL,服务路径仍必须保持在公共 origin 内。
65
65
  - 使用变量 `baseUrl` 时不会根据 hostname 自动命名或按 hostname 自动合并 Provider;请显式填写 `name`。
66
66
 
67
+ ## 默认项目根目录环境变量引用
68
+
69
+ `agents/defaults.json` 的 `projects.defaultPath` 支持绝对路径,以及 `$VAR`、`${VAR}` 环境变量引用和路径拼接:
70
+
71
+ ```json
72
+ {
73
+ "projects": {
74
+ "defaultPath": "${EVOLCORE_PROJECT_ROOT}/projects"
75
+ }
76
+ }
77
+ ```
78
+
79
+ - 变量名可以自定义;仅配置显式引用时生效,没有环境变量覆盖配置的额外优先级。
80
+ - 配置读取、合并、CLI 查询、快照和 Web 设置保留引用原文;实际使用路径时从执行进程的 `process.env` 解析。
81
+ - 支持整字段引用,也支持 `${ROOT}/projects`、`$ROOT/projects`、`${ROOT}/${TEAM}/projects`、`/data/${TEAM}/projects` 等拼接;变量可以是目录根或路径片段,最终结果必须是绝对路径。
82
+ - 每个引用的变量未设置或为空、含嵌套引用,或最终结果不是绝对路径时明确报错,不回退默认目录。
83
+ - `$ROOT_suffix` 表示变量 `ROOT_suffix`;需要给 `ROOT` 的值追加 `_suffix` 时写 `${ROOT}_suffix`。
84
+ - 只替换一轮;不支持 `${VAR:-default}` 等 Shell 默认值、递归替换或旧 `$ENV:NAME`。
85
+ - daemon 启动加载的全局 `.env` 可补充进程环境,已有进程变量优先;独立 CLI 必须自行获得相应环境变量。
86
+ - 新建 Agent 仍在根目录下按 AID 派生并保存具体项目路径;已有 Agent 的显式路径及已有会话目录保持不变,不自动迁移。
87
+ - 未配置该字段时沿用现有默认目录;既有普通绝对路径无需修改。环境变量引用配置需要支持本功能的版本,旧版本不能保证识别。
88
+
67
89
  ## 快照 / 回滚
68
90
 
69
91
  总开关直接保存在 `$EVOLCORE_HOME/daemon.json` 顶层,默认 `true`:
@@ -13,7 +13,7 @@ Agent 侧可以查询或向 Owner 发送入录申请,不能直接增删名录
13
13
  命令与 `ec skill` 对齐:**`list` 列举/过滤,`info` 看单条详情**。
14
14
 
15
15
  ```bash
16
- ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--scope internal|external|pa-team|all] [--owner <aid|unbound>] [--limit <n>] [--page <n>] [--format json]
16
+ ec directory list [<关键词>...] [--filter '<kw1,kw2>']... [--type <type>] [--scope internal|external|pa-team|my-agent-team|all] [--owner <aid|unbound>] [--limit <n>] [--page <n>] [--format json]
17
17
  ec directory info <contact-aid|名字> [--limit <n>] [--format json]
18
18
  ec directory refresh [--format json]
19
19
  ec directory blocked [--format json]
@@ -58,10 +58,24 @@ Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agen
58
58
  多个 `--filter` 之间为 AND**;
59
59
  - 位置参数(`list 张三 采购`):保留旧 `find` 的语义,多个词**同时命中**(AND)。
60
60
 
61
- 其它过滤:`--type`、`--scope internal|external|pa-team|all`(默认 `all`;`pa-team`
62
- 只列 `open_pa_context` 里且已核验的成员)、
61
+ 其它过滤:`--type`、`--scope internal|external|pa-team|my-agent-team|all`(默认 `all`)、
63
62
  `--owner <aid|unbound>`(按条目归属过滤,`unbound` 只列没有 `owner_aid` 的条目)。
64
63
 
64
+ `--scope` 的取值:
65
+
66
+ | 值 | 含义 |
67
+ |---|---|
68
+ | `internal` | 内部联系人(见「归属核验」) |
69
+ | `external` | 外部条目 |
70
+ | `pa-team` | `open_pa_context` 里且 `ownership_status=owned` 的成员 |
71
+ | `my-agent-team` | `config.team` 里的成员,**以名单为准** |
72
+ | `all` | 不过滤,等同不传 |
73
+
74
+ `my-agent-team` 与另外三个**不是同一类筛法**:那三个是"名录的子集",这个是一份独立
75
+ 名单。所以顺序是名单顺序(不是内部优先排序),且**名录里已经没有的残留成员也会列出**——
76
+ 这种条目只有 `AID`、`ownerAid` 为 `null`,用来排查"配了但联系不上"。
77
+ `all` 仍然只遍历名录条目,不会带出 `config.team` 里名录外的 AID。
78
+
65
79
  **黑名单**:`blocked_aids` 里的主体不会出现在注入的 `directory.md` 里,也不该被
66
80
  主动联系;名单本身用 `ec directory blocked` 查。
67
81
 
@@ -198,18 +212,38 @@ updated_at: <unix 秒>
198
212
  | `name_with_aid` | 名字 \| 备注名 \| AID | 内部联系人(PA Team 之外) |
199
213
  | `name_no_aid` | 名字 \| 备注名 | 外部 Agent / 外部人类 / 加入的群 / 其他 / 白名单 |
200
214
 
201
- ### 八个分组
215
+ ### 九个分组
202
216
 
203
217
  | 顺序 | 分组 | 判据 | 形态 |
204
218
  |---|---|---|---|
205
219
  | 固定 | Owner / 个人助理 / 我 | 顶层身份块 + 自己 | 名字 \| 备注名 \| AID |
206
- | 1 | **PA Team** | `aid ∈ open_pa_context` 且 `ownership_status=owned` | `full` |
207
- | 2 | 内部联系人(其余) | 内部且不在 PA Team | `name_with_aid` |
208
- | 3 | 外部 Agent | `classifyEntry` = `external_agent` | `name_no_aid` |
209
- | 4 | 外部人类 | `classifyEntry` = `external_human` | `name_no_aid` |
210
- | 5 | 加入的群 | `type=group` | `name_no_aid` |
211
- | 6 | 其他 | 类型未知 / 归属未核实 / 无 owner | `name_no_aid`,附「不要主动联系」 |
212
- | 7 | 白名单 | `allowedAids` 命中且不在 1–6 组 | `name_no_aid` |
220
+ | 1 | **My Agent Team** | `aid ∈ config.team` | `full`(异常行只有 AID + 状态) |
221
+ | 2 | **PA Team** | `aid ∈ open_pa_context` 且 `ownership_status=owned` | `full` |
222
+ | 3 | 内部联系人(其余) | 内部且不在 My Agent Team / PA Team | `name_with_aid` |
223
+ | 4 | 外部 Agent | `classifyEntry` = `external_agent` | `name_no_aid` |
224
+ | 5 | 外部人类 | `classifyEntry` = `external_human` | `name_no_aid` |
225
+ | 6 | 加入的群 | `type=group` | `name_no_aid` |
226
+ | 7 | 其他 | 类型未知 / 归属未核实 / 无 owner | `name_no_aid`,附「不要主动联系」 |
227
+ | 8 | 白名单 | `allowedAids` 命中且不在 1–7 组 | `name_no_aid` |
228
+
229
+ **My Agent Team 判据**:本 Agent 自己 `config.json` 里的 `team` 数组,由 Owner 在
230
+ Evol App 的 Team Workspace 里维护(Menu protocol 写入),是**每个 Agent 都能有的
231
+ 自有团队**,不是只有个人助理才有。
232
+
233
+ - **以名单为准,不是名录的子集**:渲染按 `config.team` 遍历,名录里有的成员走
234
+ `full`;名录里没有的、或条目没有 `owner_aid` 的,只列 `AID | 不在联系人中` /
235
+ `AID | 未绑定 Owner`,并在组提示里报数。这是"配了但用不了"的诊断信息,不能静默丢弃。
236
+ - **不受准入开关控制**:`allowExternalContacts` / `allowAllContacts` 都不影响这一组。
237
+ 外部 agent 进了名单照样 `full` 渲染——名单是 Owner 亲手加的,比准入开关更明确。
238
+ - **黑名单优先**:被拉黑的主体一条都不出现,`directory.md` 里不出现任何黑名单成员。
239
+ - **最多渲染 50 人**:超出部分**整条不渲染**(连名字也不留),只在提示里报总数。
240
+ 与 PA Team 的"降级为仅名字"不同——这份名单是本端自己的,少露几个人比挤掉预算划算。
241
+ - **与 PA Team 重叠时以前者为准**:同时出现在两份名单里的人只在 My Agent Team 里
242
+ 完整渲染;PA Team 组里仍列名字,并说明「其中 N 人也在 My Agent Team 里,完整记录
243
+ 已在上面的分组」——PA 下发的名单不能因为去重而看起来少了人。
244
+ - 写入校验(`ec team members update --members-json` / App 侧菜单):必须是 Owner 名录里的
245
+ agent / human / assistant、未被拉黑、**有 `owner_aid`**、不能是自己、最多 200 人。
246
+ 改完立即重算 `directory.md`,不需要手动 refresh。
213
247
 
214
248
  **PA Team 判据**:服务端在 `contacts.json` 顶层下发 `open_pa_context`(AID 数组)。
215
249
  判据是**这个列表**,不再看 `exttype` 前缀。成员必须同时满足 `ownership_status=owned`,
@@ -225,7 +259,7 @@ PA Team 里,该组为空、不渲染;Owner 手动把某人移出团队清单
225
259
 
226
260
  **白名单**是**准入控制清单**,不是联系人分组:命中的主体本来就能入站,这里只是让 PA
227
261
  知道"有这么个通道"。因此白名单成员可能**根本不在联系人清单里**——那种情况下只给名字,
228
- 不展示 AID 与描述。与 1–6 组去重,一个人只出现一次。
262
+ 不展示 AID 与描述。与 1–7 组去重,一个人只出现一次。
229
263
 
230
264
  **其他组**:`type` 不在协议 8 种之内(如 `ai`)、`type=agent` 但 `ownership_status !== 'owned'`、
231
265
  或没有 `owner_aid` 的条目。只注入名字与备注名,不展示 AID、类型与描述,并明确提示
@@ -164,7 +164,7 @@ $AGENT_DIR/events/
164
164
  | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
165
165
  | 输出上限 | stdout+stderr 合计 1 MiB,超出终止 |
166
166
  | 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_EVENT` / `EC_EVENT_ID` / `EC_BUS` / `EC_PUBLISHER` |
167
- | 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
167
+ | 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
168
168
  | 沙箱 | 非 fullaccess 模式走 trigger 同款沙箱(cwd 为 agent 工程目录,脚本被快照执行);fullaccess 下 cwd 为包目录 |
169
169
  | Windows | 沙箱模式需预置 codex 沙箱,未预置时报 `SCRIPT_SANDBOX_UNAVAILABLE`;`node` 运行时用本机 node.exe,`.mjs` 可跑 |
170
170
 
@@ -177,7 +177,7 @@ ec events status [<包名>] # 每包状态
177
177
  ec events doctor <包名> # 白名单/脚本/路径/租约诊断
178
178
  ec events ledger [<包名>] [--tail 20] # 台账(不传包名 = 中心台账:bus.start/stop、gate、rules 变更)
179
179
  ec events tail <包名> # 事件日志
180
- ec events reload [<包名>] # 手动重载
180
+ ec events reload # 手动重载(全量,不接受包名)
181
181
  ec events rules add <事件> --publish <aid> [--deny]
182
182
  ec events rules remove <事件> --publish <aid> [--deny]
183
183
  ec events rules show [--event <事件>]
@@ -187,14 +187,14 @@ ec events pack list
187
187
  ec events publish <包名> <事件名> --data '<json>'
188
188
  ```
189
189
 
190
- 改 `pack.json` / `center.json` 后约 2 秒自动热重载(目录监听),无需手动命令;
191
- `ec events reload` 仍可用(托管任务内也可用——委托身份下仅限只读与 reload,
192
- `allowlist` / `publish` 仅宿主终端)。
190
+ **改完 `pack.json` / `events-config.json` 必须显式 `ec events reload`**——没有目录监听,
191
+ 文件不会自己生效。(`reload` 托管任务内也可用;委托身份下仅限只读与 reload,
192
+ `rules` / `publish` 仅宿主终端。)
193
193
 
194
194
  订阅生效与自愈的完整时机:
195
195
 
196
196
  1. **agent 启动**:调度器启动即扫描 `events/` 并接入(authorize → 回调 → subscribe)。
197
- 2. **目录监听**:改包配置自动 reload(增量 diff,不重建连接)。
197
+ 2. **手动 reload**:`ec events reload` 重新扫描全部包并按差集重建订阅(不重建连接)。
198
198
  3. **contacts 变化**:`$pa` 等占位符在名录变化且解析结果真的改变时自动重解析重订阅。
199
199
  4. **失败对账**:authorize/subscribe 失败按指数退避(5s→60s 封顶)自动重试,
200
200
  连接恢复(state_change ready)即刻重试;台账只在失败与恢复两个时刻各记一条。
@@ -18,4 +18,4 @@ ec skill load ec-group-collaboration
18
18
  - `group.md`:群消息、管理命令、邀请审核和只读本地历史。
19
19
  - `group-rules.md`:`/rules.md` 签名、发布、验证与上下文加载。
20
20
  - `fs.md`:个人空间和群空间的统一文件入口。
21
- - `thread-chain.md`:话题路由、跨话题上下文与复查。
21
+ - `thread-chain.md`:话题路由、跨话题委托/自派、委托提醒与复查。
@@ -1,6 +1,6 @@
1
1
  # ec menu-client — 远程 Daemon Menu 客户端
2
2
 
3
- 向另一台主机的 EvolCore Control AID 发送标准 `menu.*` 请求。独立终端使用 AUN 短连接完成发送、拉取、匹配和 ACK;EvolCore 托管 Agent 自动通过当前 daemon 的委托入口与现有 AUN 连接完成调用。
3
+ 向另一台主机的 EvolCore Control AID 发送标准 `menu.*` 请求。独立终端在 AUN 短连接建立前注册消息订阅,通过 SDK 标准事件接收响应;EvolCore 托管 Agent 自动通过当前 daemon 的委托入口与现有 AUN 连接完成调用。分类能力协商、control 降级、游标、恢复和 ACK 均由 SDK 管理。
4
4
 
5
5
  > **本文只讲工具用法**(CLI 语法、参数、连接与输出行为)。
6
6
  > Menu 消息的格式、`protected_headers`、鉴权机制见 `menu-protocol.md`;通过 menu exec 取配置 schema 见 `menu-exec-schema-commands.md`。
@@ -17,9 +17,11 @@ ec menu-client request <from-aid> <daemon-aid> \
17
17
 
18
18
  - `--request-file` 与 `--request-json` 二选一,内容是**现有 Menu request**(结构见 `menu-protocol.md §三`);缺少 `id` 时自动生成 UUID。
19
19
  - 请求与响应的 `ttl`、volatile 游标、`to_device_id` 定向回复等传输细节由 CLI 与 daemon 自动处理,调用方无需关心。
20
- - 默认使用 E2EE,并发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`。
20
+ - 请求声明 `message_class=control`,发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`;接收端共用 SDK 标准事件,不按类别分设业务处理器。
21
+ - `--encrypt` / `--no-encrypt` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
21
22
  - 独立终端默认 slot 是 `evolcore-menu-client`;`--app <slot>` 可覆盖,但会切换消费游标,调用方须自行串行化。托管模式使用 daemon 的现有连接和 ACK 路径。
22
23
  - `menu.query` / `menu.options` 等待响应超时时自动重发一次相同 request id;写操作不自动重试。
24
+ - 默认收到 `menu.response` 即返回,作业受理响应中的 `jobId` 不代表作业完成。升级或模板作业可加 `--wait` 等待终态,`--timeout` 分别限制初始响应和受理后的终态等待。终态字段合并到响应 `data`,保留原响应 `id`;作业失败/取消退出码为 1。超时错误保留 `jobId`,可用已有作业查询接口恢复状态,客户端不重新执行 action。
23
25
 
24
26
  ## 鉴权入口
25
27
 
@@ -32,9 +34,9 @@ ec menu-client request <from-aid> <daemon-aid> \
32
34
 
33
35
  ## 托管会话边界
34
36
 
35
- 托管调用必须使用当前 self AID,并拥有 `ec.menu.request` 的 relation 权限。daemon 校验当前 session、委托和角色,按目标 AID 与 request ID 匹配加密响应;普通角色的聊天权限不自动授予远程 Menu 调用能力。
37
+ 托管调用必须使用当前 self AID,并拥有 `ec.menu.request` 的 relation 权限。daemon 校验当前 session、委托和角色,按 SDK 确认的目标 AID 与 request ID 匹配响应;普通角色的聊天权限不自动授予远程 Menu 调用能力。
36
38
 
37
- 托管模式不接受 `--app`、`--aun-path`、`--no-encrypt`,也不创建独立连接或清理 daemon 的消息。`--request-file` 由 daemon 校验后读取,须为当前项目或本会话 `$TMPDIR` 内不受保护的普通文件,最大 128 KiB;也可用 `--request-json`。目标是否允许具体操作,仍由远端 Control Menu 的 Token/Owner 鉴权决定。
39
+ 托管模式不接受 `--app`、`--aun-path`,也不创建独立连接或清理 daemon 的消息;加密选项与独立终端一致。`--request-file` 由 daemon 校验后读取,须为当前项目或本会话 `$TMPDIR` 内不受保护的普通文件,最大 128 KiB;也可用 `--request-json`。目标是否允许具体操作,仍由远端 Control Menu 的 Token/Owner 鉴权决定。
38
40
 
39
41
  ## 配对码与 token 生命周期
40
42
 
@@ -44,7 +46,7 @@ ec menu-client request <from-aid> <daemon-aid> \
44
46
 
45
47
  ## 输出与退出码
46
48
 
47
- - 成功时 stdout 是完整 `menu.response` JSON。远端业务错误仍在响应的 `error` 字段中;本地传输/超时错误退出码非 0。独立终端的 ACK 错误也以非零退出码返回;托管模式由 daemon 的正常消费路径处理 ACK。
49
+ - 成功时 stdout 是完整 `menu.response` JSON。远端业务错误仍在响应的 `error` 字段中,退出码为 1;本地传输/超时错误退出码非 0。SDK 管理消息确认与恢复,收到响应只表示业务结果已交付,不表示网关 ACK 已完成。
48
50
 
49
51
  ## 常用请求示例
50
52
 
@@ -30,19 +30,21 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
30
30
 
31
31
  ## 一、传输层约定
32
32
 
33
- 所有 Menu 请求通过 AUN `message.send` 点对点发送给 daemon 的 Control AID:
33
+ Menu 请求通过 AUN `message.send` 点对点发送给 daemon 的 Control AID 或目标 Agent AID:
34
34
 
35
35
  | 参数 | 值 | 说明 |
36
36
  |------|-----|------|
37
- | `to` | daemon control AID | 目标 daemon 的 AID |
37
+ | `to` | Control AID 或 Agent AID | 按操作所属范围选择目标 |
38
38
  | `message_class` | `control` | Menu 是应用控制协议,使用独立 control 消息流;不使用 SDK 内部的 `sdk_control` |
39
- | `encrypt` | `true` | 必须 E2EE 加密 |
39
+ | `encrypt` | boolean | 遵循 Menu/渠道加密策略;凭据授权及要求 E2EE 的操作仍须加密 |
40
40
  | `ttl` | `60` | 秒,短生命周期 |
41
41
  | `payload` | menu request 对象 | 见下方消息类型 |
42
42
  | `protected_headers` | 见下方 | 身份认证信息 |
43
43
 
44
44
  响应通过 daemon 向请求方 AID 发送 `menu.response` 消息,以 `id` 字段配对。
45
45
 
46
+ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处理。两类应用消息均从 SDK 标准消息事件交付,EvolCore 不按实际投递类别另建回包或消费分支。普通响应与 `menu.event` 沿用 daemon 的 `aun.defaultEncrypt`;特定敏感业务可以显式要求加密。加密与消息类别是独立维度,ec-menu-client 不额外要求所有请求或响应必须 E2EE。Token 申请/使用、远程 token 授权及其它敏感操作继续按各自规则校验。
47
+
46
48
  ---
47
49
 
48
50
  ## 二、protected_headers
@@ -11,12 +11,19 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
11
11
  和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
12
12
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
13
13
 
14
- 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。按目标分三种形态:
14
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。消息分三种概念:
15
+
16
+ | 概念 | 含义 |
17
+ |---|---|
18
+ | 普通消息 | 当前话题的会话对端发来;回复用 `ecmsg send '<text>'` |
19
+ | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
20
+ | 跨话题自派 | 本端从另一个话题把任务派给自己 |
21
+
22
+ 跨话题**发送**有两个动作:
15
23
 
16
24
  | 形态 | 写法 | 目标 |
17
25
  |---|---|---|
18
- | 普通回复 | `ecmsg send '<text>'` | 当前会话的对端/群 |
19
- | 跨话题委派 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
26
+ | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
20
27
  | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 |
21
28
 
22
29
  `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
@@ -34,7 +34,7 @@ ec provider sync [--format json]
34
34
 
35
35
  `ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
36
36
 
37
- 1. 复用初始化界面的本机基座导入机制,扫描 Claude、Codex、Gemini 和 ecagent 的本机连接;只导入具有有效密钥的来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
37
+ 1. 复用初始化界面的本机基座导入机制,只扫描 Claude、Codex、Gemini 的本机连接;只导入具有有效密钥的来源。ecagent 为内置基座,直接使用 EvolCore 内部 Provider 配置,不作为导入来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
38
38
  2. 将可识别域名的 Provider ID 转为稳定八位格式,同步 defaults、Agent 和 relation 配置内的 Provider/fallback 引用;冻结初始化计划及其请求指纹不修改,单独记录运行时 Provider 迁移绑定。在线同步暂留旧 ID aliases,到下次成功启动迁移后自动清除。
39
39
  3. 仅将全局 defaults 的 `active_baseagent` 改为 `ecagent`;不覆盖已有 Agent 的显式基座或模型选择。
40
40
  4. 若注册表存在 `provider-96659517`,从其适用于 ecagent 的实时模型目录选择已启用、已列出的 `deepseek…flash` 模型;多个版本按模型 ID 的数字版本降序选择,例如 `deepseek-v4.1-flash` 优先于 `deepseek-v4-flash`。写入全局 `baseagents.ecagent.provider/model`,不写入拼错的 `deekseek` 或通配符字面量。与新模型不兼容的全局 effort 会清除。
@@ -51,7 +51,7 @@ ec provider sync [--format json]
51
51
 
52
52
  ## 启动迁移收尾
53
53
 
54
- 纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,扫描检测到的基座并自动导入有效的本机 Provider 连接;同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
54
+ 纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,仅对检测到的 Claude、Codex、Gemini 自动导入有效的本机 Provider 连接;ecagent 直接校验并使用内部 Provider 配置,不搜索或导入外部来源。同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒,保留已知的具体错误码。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
55
55
 
56
56
  `ec init --web` 不执行终端侧 Baseagent 扫描或 Provider 自动导入;这些步骤由网页初始化流程负责。终端仍检查并准备启动所需的主机控制 AID,不停止或重启已运行的 daemon。
57
57
 
@@ -71,6 +71,8 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
71
71
 
72
72
  ## 完整对象示例
73
73
 
74
+ 服务类型可选 `modelPolicy: allowlist | denylist | manual`,原 `models` 映射保留:白名单条目默认开启,黑名单条目默认关闭,手动白名单默认开启且无需 `manual:true`、不请求远端目录。白/黑名单的模型键支持 `*`、`?`;精确条目优先,通配冲突禁用优先。通配条目只接受 `enabled` 或空对象,名称和图片属性用精确 ID 配置。未填写策略保持旧配置行为,不自动补写。显式布尔值覆盖模式默认值;`null` 恢复默认。新功能代码需宿主加载后可用。
75
+
74
76
  ~~~json
75
77
  {
76
78
  "name": "Example",
@@ -87,13 +89,15 @@ apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据
87
89
 
88
90
  Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。静态 `baseUrl` 自动推导 domain;若 `baseUrl` 是环境变量引用,必须显式填写 domain,且运行时地址必须匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
89
91
 
92
+ hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一为 URL hostname 使用的压缩、带方括号形式(如 `[::1]`);显式 domain 也接受不带方括号的 IPv6。端口仍属于连接地址,不参与身份计算;同一主机的不同协议或端口不能合并。DNS 身份与已有固定 ID 的生成规则保持不变。
93
+
90
94
  ## 输出与并发
91
95
 
92
96
  文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
93
97
 
94
98
  常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、PROVIDER_CONFLICT(域名已存在)、PROVIDER_ID_COLLISION(八位哈希碰撞)、PROVIDER_DOMAIN_IMMUTABLE(不能修改已有域名)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
95
99
 
96
- 升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
100
+ 升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain 时暂保留旧 ID,并报告待处理;localhost 和 IP 地址按规范化主机名生成固定 ID。不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
97
101
 
98
102
  不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
99
103
 
@@ -126,6 +126,10 @@ ec aid agentmd set <本AID> exttype order
126
126
 
127
127
  装好后:`ec services reload` → `ec services status` 确认 `status=active`。
128
128
 
129
+ > **没有自动热重载**:改完 `pack.json` 或脚本都必须显式 `ec services reload`
130
+ > 才生效(事件中心同样如此,两边一致)。包目录没有 `fs.watch`,
131
+ > 改完不 reload 不会有任何提示,日志里也看不出异常。
132
+
129
133
  ## 六、`requires` 写什么
130
134
 
131
135
  **限制这个包能在什么名片的 AID 上生效。**
@@ -204,9 +208,9 @@ ec services call <aid> <type> --data '<json>' # 发起调用
204
208
  | 项 | 值 |
205
209
  | --- | --- |
206
210
  | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
207
- | 输出上限 | 1 MiB,超出截断 |
208
- | 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_SERVICE_TYPE` / `EC_REQUEST_ID` |
209
- | 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
211
+ | 输出上限 | stdout+stderr 合计 1 MiB;**超出即终止进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断 |
212
+ | 环境变量 | `EC_SELF_AID` / `EC_SELF_TYPE` / `EC_SELF_EXTTYPE` / `EC_PACK_DIR` / `EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` / `EC_ENCRYPTED` |
213
+ | 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
210
214
  | 沙箱 | 非 fullaccess 走 trigger 同款沙箱;Windows 上 `runtime` 必须是原生可执行文件 |
211
215
 
212
216
  最后一条容易踩,但**不是「`.mjs` 不能跑」**:要求的是 `runtime` 是可执行文件(`"node"` →
@@ -225,24 +229,153 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
225
229
 
226
230
  ## 九、准入与限流
227
231
 
228
- 服务调用**认联系人配置**,与普通消息一致。陌生人调用会收到:
232
+ 服务调用**认联系人配置**,与普通消息一致。准入判定在包匹配**之前**完成:未准入的
233
+ 调用不会触达包、不会进调度器、不会起脚本沙箱。
234
+
235
+ 陌生人第一次调用会收到一条**与请求内容无关**的拒绝:
229
236
 
230
237
  ```json
231
- { "ok": false, "error": { "code": "NOT_AUTHORIZED" }, "request_contact": "<你的Owner>" }
238
+ { "ok": false, "error": { "code": "NOT_AUTHORIZED", "message": "service call is not authorized" } }
232
239
  ```
233
240
 
241
+ - 不带 `request_contact`、不带包名/type/脚本路径——回包不能变成探测手段;
242
+ - 无论目标 type 是否存在,回包完全一样(否则"有没有回包"就是枚举信道);
243
+ - 同一个来源 **24 小时内只回这一次**,之后一律静默;全局另有 30 次/分、200 次/时
244
+ 的回复上限,换 AID 也放不大。
245
+
234
246
  **不会自动建联系人申请**,对方需自己 `ec directory request` 找你的 Owner。
235
247
 
236
- 内置查询(`ping`/`list`/`describe`/`schema`/`skill`)**免准入**,但受限流。
248
+ 内置查询按「返回体里有没有我方内部结构」分级:
249
+
250
+ | type | 未准入时 |
251
+ | --- | --- |
252
+ | `services.ping` | 正常返回 `{ok, ts, version}`,零信息,任何来源都答 |
253
+ | `services.list` | 降级为空壳:`{"services":[],"builtin":["services.ping"]}` |
254
+ | `services.describe`(不带 service) | 同上,降级为空壳 |
255
+ | `services.describe` / `schema` / `skill`(带 service) | 走统一拒绝,与业务调用一致 |
256
+
257
+ 限流(按来源 AID 独立计):
237
258
 
238
- | 类别 | 额度(按来源 AID 独立计) |
259
+ | 类别 | 额度 |
239
260
  | --- | --- |
240
261
  | 内置查询 | 20 次/分、200 次/时 |
241
262
  | 业务调用 | 50 次/分、1000 次/时 |
242
263
 
243
- 超限回 `RATE_LIMITED`,带 `retry_after` 秒数。
264
+ 超限回 `RATE_LIMITED`,带 `retry_after` 秒数;未准入来源超限时直接静默,不回限流细节。
265
+
266
+ ### 按服务类型细分的准入规则
267
+
268
+ 默认口径(上面那套)是 **agent 级**的:一个来源要么能调全部服务,要么一个都不能。
269
+ 需要放开个别服务时可以按 type 加规则,写在 `services-config.json`:
270
+
271
+ ```json
272
+ {
273
+ "v": 1,
274
+ "enabled": true,
275
+ "rateLimit": { "builtin": {...}, "service": {...} },
276
+ "rules": {
277
+ "services.order.create": {
278
+ "allow": ["buyer.agentid.cn"],
279
+ "deny": ["spam.agentid.cn"]
280
+ },
281
+ "services.order.*": { "allow": [], "deny": ["spam.agentid.cn"] }
282
+ }
283
+ }
284
+ ```
285
+
286
+ 语义与事件中心的 allowlist **完全一致**:
287
+
288
+ | 集合 | 作用 |
289
+ | --- | --- |
290
+ | 联系人快照(基础集合) | 不受 `rules` 影响,照常放行 |
291
+ | `allow` | 在基础集合**之上**额外放行——可以放行联系人之外的人 |
292
+ | `deny` | 命中即拒,**优先于** `allow` 与基础集合 |
293
+
294
+ 几条不变的约束:
295
+
296
+ - **临时授权不算数**。服务调用属长效口径,`temp-grant` 这类分钟级放行不影响调试结果;
297
+ 需要临时开就给 `rules.allow`。
298
+ - 同一个 AID 不能同时写在 `allow` 和 `deny` 里——校验期直接报错。`deny` 会赢,但
299
+ 写的人多半以为 `allow` 会赢。
300
+ - 规则按 type **精确匹配**优先,其次 `.*` 通配(只吃一整段,与 `listen` 同口径)。
301
+ - `deny` 的回包与"未准入"**完全相同**,否则"被拉黑"和"没这个服务"就成了可区分的探测信号。
302
+ - **内置保留字不接受 rules**(`services.ping` / `list` / `describe` / `schema` / `skill`)。
303
+ 它们的准入是固定分级的,写这类键会在校验期直接报错,而不是存下来却不生效。
304
+
305
+ 改规则:
306
+
307
+ ```bash
308
+ ec services rules show # 看全部规则
309
+ ec services rules show services.order.create # 看单个 type
310
+ ec services rules add services.order.create buyer.agentid.cn
311
+ ec services rules add services.order.create spam.agentid.cn --deny
312
+ ec services rules remove services.order.create spam.agentid.cn --deny
313
+ ```
314
+
315
+ ## 十、权限模型
316
+
317
+ `ec services` 的运维命令分**四档操作**,对着**两类目标**(自己的 AID / 本机的其他 AID):
318
+
319
+ | 操作 | 包含的命令 | 自己的 AID | 本机的其他 AID |
320
+ | --- | --- | --- | --- |
321
+ | **查看** | `status` `types` `ledger` `tail` `doctor` `reload` `rules show` `pack list` | member 及以上 | member 及以上 + 同 Owner |
322
+ | **管理** | `pack add` `pack remove` `pack enable` `pack disable` `rules add` `rules remove` | owner / admin | daemonOwner + fullaccess + 同 Owner |
323
+ | **总闸** | `enable` `disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
324
+ | **调用** | `describe` `schema` `call` | 准入决定(本机不判权) | 准入决定(本机不判权) |
325
+
326
+ ### 概念
327
+
328
+ **daemonOwner**:`getDaemonOwners()` 列出的身份。这是"这台机器的主人",与"某个
329
+ agent 的 owner"是两个层级——一台机器上可以挂着不同 Owner 的 agent。
330
+
331
+ **fullaccess**:本次执行通过 `isTrustedFullAccessRuntimeContext`——
332
+ `permissionMode === 'fullaccess'`、`processRole === 'fullaccess-run'`、
333
+ `dataScope === 'daemon'`、`authorizedBy` 非空,四条同时成立。由 daemon 按校验过的
334
+ `TaskRuntimeContext` 计算,**不能**由命令行参数或请求体自报。
335
+
336
+ **总闸的"两件不同的事"**:`services-config.json` 的 `enabled` 是 **AID 级总闸**
337
+ (这个 AID 是否对外提供全部服务);`pack.json` 的 `enabled` 是**单包开关**。前者
338
+ 要 daemonOwner + fullaccess,后者 owner / admin 即可。
339
+
340
+ ### 为什么这样分层
341
+
342
+ - **查看**不改变执行面。跨 AID 要求同 Owner,是因为台账与消息日志含真实调用记录,
343
+ 不该跨租户暴露。
344
+ - **管理**分两档:给自己装包是"自己装给自己",owner / admin 足够;给别人装包是
345
+ "用对方的身份执行以后会跑起来的代码",只有 daemonOwner + fullaccess 且双方同
346
+ Owner 才存在这种正当性。
347
+ - **总闸**是整机决策:开了这个 AID 就对外接活了,所以独立成一档。
348
+ - **调用**不判本机权限:发出去的消息由对端准入决定,本机这边无权干涉。
349
+
350
+ ### `pack add` 不自动开总闸
351
+
352
+ 装包时若不存在 `services-config.json`,会建一份 **`enabled: false`** 的。装包
353
+ (owner / admin)和开服务(daemonOwner + fullaccess)是两件事;自动开机等于让
354
+ 装包顺带绕过总闸那道闸。
355
+
356
+ 装完之后要显式开:
357
+
358
+ ```bash
359
+ ec services enable
360
+ ```
361
+
362
+ ### 主机终端
363
+
364
+ 持有 `control.token` 的终端(`local-control`)四档全部放行——人自己在操作,
365
+ OS 账户权限就是信任边界。托管会话则按上表判定。
366
+
367
+ ### 错误码
368
+
369
+ | 码 | 含义 |
370
+ | --- | --- |
371
+ | `NOT_ALLOWED` | 托管会话没有会话身份(缺 sessionId / delegationToken) |
372
+ | `ROLE_ACCESS_DENIED` | 同 AID 管理需要 owner 或 admin,当前角色不够 |
373
+ | `FULLACCESS_REQUIRED` | 该操作要求 fullaccess 执行,当前不是 |
374
+ | `DAEMON_OWNER_REQUIRED` | fullaccess 的授权者不在本机 daemonOwner 列表里 |
375
+ | `OWNERSHIP_UNAVAILABLE` | 查不到协议 owner 归属(数据尚未同步或归属不存在) |
376
+ | `CROSS_AGENT_DENIED` | 双方或本机 daemon 不属于同一个 Owner |
244
377
 
245
- ## 十、保留字
378
+ ## 十一、保留字
246
379
 
247
380
  保留字**只占两段形式** `services.<保留字>`:
248
381
 
@@ -255,7 +388,7 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
255
388
  `exttype` 可以设成这些名字,但 `services.<该名字>` 会被内置抢走,其余照常。
256
389
  `ec services doctor` 会告警这种部分遮蔽。
257
390
 
258
- ## 十一、排查
391
+ ## 十二、排查
259
392
 
260
393
  ```
261
394
  ec services status # 包状态:active / skipped / invalid
@@ -273,7 +406,7 @@ ec services tail <包名>
273
406
  | 收不到回复 | `reply.allowed` 是不是 `false`(默认就是) |
274
407
  | `RATE_LIMITED` | 超限,看 `retry_after` |
275
408
 
276
- ## 十二、不要做的事
409
+ ## 十三、不要做的事
277
410
 
278
411
  1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 去重 24 小时,
279
412
  超出窗口的重试会重新执行。
@@ -285,7 +418,7 @@ ec services tail <包名>
285
418
  5. **不要在一个包里给同一个 `type` 写两条 `listen`**。
286
419
  6. **不要在两个包里写同一个 `type`**。两个包都会 invalid。
287
420
 
288
- ## 十三、相关文档
421
+ ## 十四、相关文档
289
422
 
290
423
  | 文档 | 用途 |
291
424
  | --- | --- |
@@ -2,7 +2,7 @@
2
2
 
3
3
  话题(Thread)是在私聊或群聊关系里切出的独立对话分支。一组对话可以同时推进多个话题,每个话题有自己的上下文、历史和生命周期,互不干扰。话题链(Thread Chain)则是跨会话、跨 agent 的协作机制:A 可以把一条任务"分支"到 B 的某个话题,B 也可以在自己的话题里继续工作,两者通过 `ecmsg send --thread` 和 thread-inbox 上下文注入关联起来。
4
4
 
5
- 触发词:话题/thread/跨话题/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨话题上下文/跨话题复查。
5
+ 触发词:话题/thread/跨话题/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨话题委托/跨话题复查。
6
6
 
7
7
  ## 标准工作流
8
8
 
@@ -135,11 +135,19 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
135
135
 
136
136
  ## 跨话题发送(话题链核心)
137
137
 
138
- 跨话题发送分两种:
138
+ 消息分三种概念:
139
+
140
+ | 概念 | 定义 |
141
+ |---|---|
142
+ | 普通消息 | 当前话题的会话对端发来 |
143
+ | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
144
+ | 跨话题自派 | 本端从另一个话题把任务派给自己 |
145
+
146
+ 跨话题**发送**有两个动作:
139
147
 
140
148
  | 形态 | 写法 | 目标 | 用途 |
141
149
  |---|---|---|---|
142
- | 跨话题委派 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
150
+ | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
143
151
  | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
144
152
 
145
153
  不带 `--thread` 的 `ecmsg send '<text>'` 是普通回复,只发当前会话对端/群。
@@ -147,7 +155,7 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
147
155
  跨话题自派的派活通知按话题对端类型送达:对端是人类时发普通 text,对端是 agent 时发 notice(`subtype=self_dispatch`),避免被当成一条要执行的聊天消息。
148
156
 
149
157
  ```bash
150
- # 跨话题委派(本端/对端由话题推断)
158
+ # 跨话题委托(本端/对端由话题推断)
151
159
  ecmsg send '<消息内容>' --thread <threadId>
152
160
 
153
161
  # 自定义复查周期(缺省 20m)
@@ -169,7 +177,7 @@ ecmsg send '<消息内容>' --thread <threadId> --to <本端AID>
169
177
  主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题)
170
178
  - **跨话题自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`)
171
179
  - 跨话题发送成功后,系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时,
172
- 这条记录会以「‹跨话题上下文 · 来源话题:xxx›」的形式注入一次,然后删除
180
+ 这条记录会以「‹提醒:跨话题委托 · 话题:xxx …›」的形式注入一次,然后删除
173
181
  - `--check-every` 会创建**跨话题复查**(名称 `check-<目标>-from-<来源>-<唯一后缀>`,
174
182
  `kind=cross-thread-review`,执行类型 `target_session`)。到期时**不新建会话**,
175
183
  而是向**目标话题**投递一条【跨话题复查】通知,由目标话题侧的 agent 在它自己的上下文里
@@ -194,10 +202,10 @@ ecmsg send '请处理项目A的数据清洗' --thread thread-T2-xxxx --check-eve
194
202
 
195
203
  **A 收到 B 的回复时感知来源上下文:**
196
204
 
197
- inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(通常是 B 回复),prompt 开头会注入一条跨话题上下文,格式如下:
205
+ inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(通常是 B 回复),prompt 开头会注入一条跨话题委托提醒,格式如下:
198
206
 
199
207
  ```
200
- ‹【跨话题上下文】来源话题:thread-T1-xxxx · 对端:alice.agentid.cn · 发送于:2026-10-10 10:00:00 +08:00 · 复查:trig_1791765199642_5371c8ff → self:bob.agentid.cn›
208
+ ‹提醒:跨话题委托 · 话题:thread-T1-xxxx(对端:alice.agentid.cn) · 发送于:2026-10-10 10:00:00 +08:00 · 原消息:m-… · 来源会话:meta_… · 复查:trig_1791765199642_5371c8ff · self:bob.agentid.cn›
201
209
  ⚠️ 来源话题在发送后已有 3 条新消息(2026-10-10 10:01:00 +08:00 - 2026-10-10 10:15:00 +08:00)—— 处理前建议先回查该话题的空洞期消息。
202
210
  【原消息内容】
203
211
  ```
@@ -206,7 +214,7 @@ inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(
206
214
 
207
215
  注入只发生一次。之后 A 靠自身上下文记住"我从哪个话题跨过来的",可随时用
208
216
  `ec thread history <来源话题 id>` 回查空洞期消息(主话题的 id 是 `main:<a>:<b>`,
209
- 通知里的「来源话题 ID」字段可直接使用)。
217
+ 通知里的 `话题:` 字段可直接使用)。
210
218
 
211
219
  **复查通知到达时(目标话题内):**
212
220
 
@@ -289,7 +297,7 @@ CAS 说明:`--if-rev <n>` 指定当前已知的版本号;若实际版本不
289
297
  data/threads/
290
298
  ├── index.json 话题索引
291
299
  ├── summaries/ 话题摘要(<sessionId>.summary.jsonl)
292
- └── inbox/ 跨话题上下文收件箱
300
+ └── inbox/ 跨话题委托收件箱
293
301
  ```
294
302
 
295
303
  ```bash