evolcore 0.0.49 → 0.0.50

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 (250) hide show
  1. package/CHANGELOG.md +64 -1
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +280 -6
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +4 -1
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +29 -1
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +537 -189
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/ecmsg-gateway.js +11 -9
  54. package/dist/cli/index.js +23 -4
  55. package/dist/cli/init.js +39 -63
  56. package/dist/cli/managed-command-guard.js +1 -0
  57. package/dist/cli/menu-client.js +32 -7
  58. package/dist/cli/pay-command.js +30 -0
  59. package/dist/cli/provider-command.js +6 -2
  60. package/dist/cli/restart-monitor.js +2 -2
  61. package/dist/cli/services-command.js +11 -9
  62. package/dist/cli/thread-command.js +78 -12
  63. package/dist/config/access-policy.js +16 -3
  64. package/dist/config/config-field-policy.js +17 -8
  65. package/dist/config/config-manager.js +86 -46
  66. package/dist/config/config-operation-service.js +22 -1
  67. package/dist/config/gateway-config.js +9 -8
  68. package/dist/config/owner-config.js +0 -16
  69. package/dist/config/peer-role-resolver.js +1 -7
  70. package/dist/config/providers-config.js +99 -16
  71. package/dist/config/providers-management.js +35 -19
  72. package/dist/config/resolved-config-op.js +1 -42
  73. package/dist/config/schema-migration.js +78 -5
  74. package/dist/config/schema-registry.js +52 -7
  75. package/dist/config-store.js +1309 -17
  76. package/dist/core/agent-application-service.js +220 -1
  77. package/dist/core/agent-ipc-registration.js +19 -2
  78. package/dist/core/agent-reload-coordinator.js +5 -0
  79. package/dist/core/agent-runtime.js +198 -54
  80. package/dist/core/auth/agent-delegation.js +14 -0
  81. package/dist/core/auth/operation-authorizer.js +16 -1
  82. package/dist/core/auth/operation-catalog.js +50 -7
  83. package/dist/core/baseagent-loader.js +30 -3
  84. package/dist/core/capability/capability-manager.js +16 -7
  85. package/dist/core/channel-runtime.js +4 -2
  86. package/dist/core/command/agent-control.js +20 -2
  87. package/dist/core/command/agent-template-menu.js +4 -3
  88. package/dist/core/command/cli-intent-parser.js +15 -0
  89. package/dist/core/command/menu-catalog.js +20 -4
  90. package/dist/core/command/menu-file-path.js +70 -0
  91. package/dist/core/command/menu-handler.js +91 -72
  92. package/dist/core/command/menu-protocol.js +5 -0
  93. package/dist/core/command/menu-query-batch.js +2 -2
  94. package/dist/core/command/private-mention-menu.js +71 -0
  95. package/dist/core/command/slash-handler.js +17 -26
  96. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  97. package/dist/core/command/topic-slash.js +7 -1
  98. package/dist/core/daemon-bootstrap.js +0 -4
  99. package/dist/core/daemon-control.js +2 -1
  100. package/dist/core/daemon-lifecycle.js +13 -5
  101. package/dist/core/evolagent-registry.js +12 -7
  102. package/dist/core/handoff/runtime.js +1 -1
  103. package/dist/core/host-snapshot.js +8 -3
  104. package/dist/core/initialization/service.js +3 -0
  105. package/dist/core/interaction-router.js +130 -0
  106. package/dist/core/ipc-registration.js +4 -0
  107. package/dist/core/memory/consolidation-context.js +2 -1
  108. package/dist/core/memory/consolidation.js +35 -64
  109. package/dist/core/message/aun-ipc-sender.js +98 -21
  110. package/dist/core/message/aun-request-registry.js +31 -0
  111. package/dist/core/message/message-bridge.js +105 -6
  112. package/dist/core/message/message-log.js +8 -0
  113. package/dist/core/message/message-queue.js +5 -3
  114. package/dist/core/message/peer-mode.js +15 -4
  115. package/dist/core/message/response-engine.js +23 -8
  116. package/dist/core/message/send-options.js +37 -3
  117. package/dist/core/message/send-routing.js +11 -7
  118. package/dist/core/model/model-catalog.js +5 -5
  119. package/dist/core/ownership/owner-resolver.js +12 -86
  120. package/dist/core/pack-auth.js +4 -0
  121. package/dist/core/permission/ec-command-parser.js +182 -58
  122. package/dist/core/permission/protected-paths.js +64 -9
  123. package/dist/core/permission/services-path-acl.js +9 -2
  124. package/dist/core/permission/tool-policy.js +21 -9
  125. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  126. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  127. package/dist/core/session/session-manager.js +47 -10
  128. package/dist/core/session/session-mapper.js +16 -0
  129. package/dist/core/skill/index-generator.js +2 -3
  130. package/dist/core/skill/switch-resolver.js +3 -0
  131. package/dist/core/thread/command-parser.js +4 -1
  132. package/dist/core/thread/ipc-operation.js +4 -2
  133. package/dist/core/thread/thread-operation.js +25 -10
  134. package/dist/core/thread/thread-service.js +294 -55
  135. package/dist/core/thread/topic-id.js +52 -2
  136. package/dist/core/thread/types.js +15 -1
  137. package/dist/eck/kit-renderer.js +2 -1
  138. package/dist/ecweb/basic-settings-service.js +5 -9
  139. package/dist/ecweb/providers-service.js +4 -2
  140. package/dist/index.js +116 -41
  141. package/dist/ipc.js +58 -2
  142. package/dist/paths.js +48 -1
  143. package/dist/pay/command.js +38 -0
  144. package/dist/pay/protocol.js +136 -0
  145. package/dist/pay/runtime.js +188 -0
  146. package/dist/pay/service.js +384 -0
  147. package/dist/pay/store.js +81 -0
  148. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  149. package/dist/services/dispatcher.js +23 -5
  150. package/dist/services/host/main.js +388 -0
  151. package/dist/services/host/protocol.js +118 -0
  152. package/dist/services/host/resident.js +310 -0
  153. package/dist/services/host-client.js +386 -0
  154. package/dist/services/host-deploy.js +180 -0
  155. package/dist/services/host-launch.js +117 -0
  156. package/dist/services/host-recycle.js +203 -0
  157. package/dist/services/host-runtime.js +802 -0
  158. package/dist/services/idempotency.js +44 -86
  159. package/dist/services/index-generator.js +4 -3
  160. package/dist/services/index.js +176 -18
  161. package/dist/services/ipc-operation.js +204 -44
  162. package/dist/services/script-runner.js +515 -83
  163. package/dist/services/validation.js +109 -4
  164. package/dist/trigger/application-service.js +6 -4
  165. package/dist/trigger/local-files.js +19 -9
  166. package/dist/trigger/scheduler.js +22 -12
  167. package/dist/trigger/script-sandbox.js +51 -20
  168. package/dist/utils/aid-bind.js +3 -0
  169. package/dist/utils/evolcore-version.js +2 -2
  170. package/dist/utils/host-info.js +73 -0
  171. package/dist/utils/logger.js +2 -2
  172. package/dist/utils/media-cache.js +190 -43
  173. package/dist/utils/restart-safety.js +14 -1
  174. package/dist/utils/system-memory.js +113 -25
  175. package/dist/utils/systemd-lifecycle.js +154 -0
  176. package/dist/utils/windows-shell-trust.js +7 -3
  177. package/kits/docs/INDEX.md +3 -2
  178. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  179. package/kits/docs/channels/aun.md +1 -1
  180. package/kits/docs/evolcore/INDEX.md +7 -6
  181. package/kits/docs/evolcore/agent.md +36 -1
  182. package/kits/docs/evolcore/aid.md +20 -3
  183. package/kits/docs/evolcore/config.md +1 -1
  184. package/kits/docs/evolcore/group.md +2 -1
  185. package/kits/docs/evolcore/memory-tags.md +2 -0
  186. package/kits/docs/evolcore/menu-client.md +3 -3
  187. package/kits/docs/evolcore/menu-protocol.md +7 -0
  188. package/kits/docs/evolcore/model.md +3 -0
  189. package/kits/docs/evolcore/msg.md +68 -10
  190. package/kits/docs/evolcore/pay.md +34 -0
  191. package/kits/docs/evolcore/provider.md +21 -0
  192. package/kits/docs/evolcore/services.md +46 -18
  193. package/kits/docs/evolcore/thread-chain.md +2 -0
  194. package/kits/docs/evolcore/tool-authorization.md +10 -0
  195. package/kits/rules/01-overview.md +11 -32
  196. package/kits/rules/02-navigation.md +7 -0
  197. package/kits/rules/06-channel.md +3 -3
  198. package/kits/schemas/_meta.json +38 -5
  199. package/kits/schemas/agent-config.schema.21.json +974 -0
  200. package/kits/schemas/agent-config.schema.22.json +977 -0
  201. package/kits/schemas/agent-config.schema.23.json +958 -0
  202. package/kits/schemas/daemon.schema.10.json +373 -0
  203. package/kits/schemas/daemon.schema.9.json +12 -0
  204. package/kits/schemas/defaults.schema.7.json +472 -0
  205. package/kits/schemas/providers.schema.3.json +18 -2
  206. package/kits/schemas/relation-config.schema.13.json +289 -0
  207. package/kits/skills/.switches.json +13 -1
  208. package/kits/skills/ability/SKILL.md +229 -34
  209. package/kits/skills/ability/STRUCTURE.md +333 -0
  210. package/kits/skills/ability/references/cli.md +208 -0
  211. package/kits/skills/ability/references/development.md +107 -37
  212. package/kits/skills/ability/references/management.md +106 -46
  213. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  214. package/kits/skills/agent-output-cards/SKILL.md +12 -5
  215. package/kits/skills/ec-group/SKILL.md +8 -6
  216. package/kits/skills/ec-group/TASK.md +186 -0
  217. package/kits/skills/ec-group/WORKLOG.md +180 -0
  218. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  219. package/kits/skills/ec-pay/SKILL.md +101 -0
  220. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  221. package/kits/skills/ec-provider/SKILL.md +1 -1
  222. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  223. package/kits/skills/ec-service-call/SKILL.md +135 -0
  224. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  225. package/kits/skills/ec-trigger/SKILL.md +1 -1
  226. package/kits/templates/memory-consolidation/notes.md +2 -2
  227. package/kits/templates/memory-consolidation/workflow.md +46 -0
  228. package/kits/templates/system-fragments/channel.md +13 -4
  229. package/kits/templates/system-fragments/commands.md +4 -3
  230. package/kits/templates/system-fragments/reply.md +1 -0
  231. package/kits/templates/system-fragments/session.md +1 -1
  232. package/kits/templates/system-fragments/thread.md +27 -129
  233. package/kits/templates/system-fragments/venue.md +16 -0
  234. package/package.json +4 -5
  235. package/scripts/agent-template/inspect.mjs +37 -23
  236. package/scripts/agent-template/overlay.mjs +20 -2
  237. package/scripts/agent-template/shared/common.mjs +16 -4
  238. package/scripts/agent-template/shared/team-schema.json +20 -4
  239. package/scripts/agent-template/shared/template-contract.mjs +53 -13
  240. package/scripts/agent-template/shared/template-package.mjs +90 -26
  241. package/scripts/agent-template/shared/template-runtime.mjs +111 -1
  242. package/scripts/agent-template/shared/template.mjs +65 -7
  243. package/scripts/agent-template/team-pack.mjs +89 -33
  244. package/scripts/agent-template/team-preview.mjs +249 -5
  245. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  246. package/kits/docs/evolcore/ability.md +0 -185
  247. package/kits/skills/ability/references/calling.md +0 -56
  248. package/kits/skills/ability/references/contract-checklist.md +0 -37
  249. package/kits/skills/ability/references/recovery.md +0 -27
  250. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -1,5 +1,13 @@
1
1
  # 服务路由(`ec services`)
2
2
 
3
+ 服务请求携带执行截止时间;排队或宿主准备期间到期的请求不再启动脚本。已经开始的
4
+ 业务副作用不会因调用方超时而自动撤销,超时后仍须核对结果。默认结果去重窗口为 15 秒;
5
+ 显式更长的调用窗口会将结果保留到截止时间后 3 秒,最长按 5 分钟调用窗口约束。
6
+
7
+ 常驻和一次性脚本保持相同的 `noop` 与无沙箱审计语义。宿主按工程、权限模式及
8
+ owner+bypass 例外区分执行策略;切换策略时等待旧调用完成,不复用旧权限的宿主。
9
+ `ec services host enable --aid <aid>` 启用宿主;`host disable` 先排空在途调用再释放进程。
10
+
3
11
  > 完整设计见仓库 `docs/services/`;Schema 见 `docs/services/schema/`。
4
12
 
5
13
  Agent 怎么建服务包、写处理脚本、让对端调到你。
@@ -11,15 +19,15 @@ Agent 怎么建服务包、写处理脚本、让对端调到你。
11
19
  | 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是服务 |
12
20
  | 对端发消息给我,我跑确定性逻辑并**回结果** | **服务** |
13
21
  | 我要主动通知别人 | 事件中心(`ec events`)或 `ecmsg` |
14
- | 消息绝不能丢、必须有应答 | **服务**(走普通持久消息) |
22
+ | 对端要当场拿到结果、拿不到就算了 | **服务**(走 volatile 消息,超时即失败) |
15
23
  | 广播给很多人 | 事件中心,不是服务 |
16
24
 
17
25
  一句话区分:**服务是点对点调用,事件是广播通知。**
18
26
 
19
27
  | | 服务 `services/` | 事件 `events/` |
20
28
  | --- | --- | --- |
21
- | 传输 | 普通持久消息 | AUN pubsub(volatile) |
22
- | 会丢吗 | 不会 | 会 |
29
+ | 传输 | 点对点 volatile 消息(TTL = 调用窗口) | AUN pubsub(volatile) |
30
+ | 会丢吗 | 会——超时即失败,不补投 | 会 |
23
31
  | 有应答吗 | 有,`.result` | 无 |
24
32
 
25
33
  ## 二、目录
@@ -41,9 +49,14 @@ $AGENT_DIR/services/
41
49
  ```bash
42
50
  ec services pack add <包名> --from <源目录>
43
51
  ec services pack remove <包名> [--purge]
52
+ ec services pack enable <包名>
53
+ ec services pack disable <包名>
44
54
  ec services pack list
45
55
  ```
46
56
 
57
+ `pack enable` / `pack disable` 改的是 `pack.json` 里的 `enabled`(单包开关),
58
+ 与 AID 级总闸 `ec services enable` / `disable` 是两个层级。
59
+
47
60
  `services-config.json` 装好后基本不用改:
48
61
 
49
62
  ```json
@@ -104,11 +117,18 @@ ec aid agentmd set <本AID> exttype order
104
117
  {
105
118
  "v": 1,
106
119
  "name": "订单受理",
120
+ "description": "订单受理相关的全部服务",
107
121
  "requires": { "type": ["services", "agent"], "exttype": "order" },
108
122
  "listen": [
109
123
  {
110
124
  "type": "services.order.create",
111
- "handler": { "script": "scripts/on-create.mjs", "runtime": "node", "timeoutMs": 15000 }
125
+ "handler": {
126
+ "script": "scripts/on-create.mjs",
127
+ "runtime": "node",
128
+ "timeoutMs": 15000,
129
+ "name": "下单",
130
+ "description": "创建订单。data: {sku, qty},返回 order_id"
131
+ }
112
132
  }
113
133
  ],
114
134
  "reply": { "allowed": true }
@@ -121,6 +141,12 @@ ec aid agentmd set <本AID> exttype order
121
141
  - `listen[].type` 必须是 `services[.<段>[.<段>]]`,末段可写 `*`
122
142
  - `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接
123
143
  - `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断
144
+ - `handler.name`(≤24 字)/ `handler.description`(≤120 字)可选,**建议写**:
145
+ 它们是 `data` 契约的唯一说明渠道,对端靠 `services.describe` 读到才知道该往 `data` 塞什么
146
+ - `handler.mode` ∈ `spawn`(默认)/ `resident`:后者是常驻子进程形态,需要按新契约写脚本
147
+ (先发 `{t:'ready'}`、每行带原样 `callId`、上下文从帧里读、日志走 stderr)。
148
+ **默认别用**。`host.enabled` 不是 `true` 时降级为每调用一个进程——结果一样,但没有稳态
149
+ 收益,`ec services doctor` 会提醒。完整契约(帧字段、两个目录、超时参数)见 `usage.md` §八·五
124
150
  - 同包内 `type` 重复 → 整包 invalid;跨包重复 → 两个包都 invalid
125
151
  - 一个包校验失败只废这个包,其余照常
126
152
 
@@ -146,12 +172,12 @@ ec aid agentmd set <本AID> exttype order
146
172
  ## 七、怎么调别人
147
173
 
148
174
  ```bash
149
- ec services describe <aid> # 对方有什么
150
- ec services schema <aid> <type> # 参数结构
151
- ec services call <aid> <type> --data '<json>' # 发起调用
175
+ ec services describe --aid <aid> # 对方有什么
176
+ ec services schema --aid <aid> --type <type> # 参数结构
177
+ ec services call --aid <aid> --type <type> --data '<json>' # 发起调用
152
178
  ```
153
179
 
154
- `call` 默认等结果,30 秒超时:
180
+ `call` 默认等结果,**12 秒**超时:
155
181
 
156
182
  ```json
157
183
  { "ok": true, "data": { "order_id": "O-1" } }
@@ -159,11 +185,10 @@ ec services call <aid> <type> --data '<json>' # 发起调用
159
185
 
160
186
  | 选项 | 作用 |
161
187
  | --- | --- |
162
- | `--timeout 60` | 自定等待时长;超时**不重试**,退出码 2 |
188
+ | `--timeout 5` | 自定等待时长;超时**不重试**,退出码 2 |
163
189
  | `--encrypted` | 加密调用,回复也加密 |
164
- | `--no-wait` | 只发不等 |
165
190
 
166
- **超时后不要直接重发**,先查一次确认是否已执行,否则会重复。
191
+ **超时后不要直接重发**。请求只活一个调用窗口,对端离线时到期即消失、不会补投;同一 `request_id` 默认保留结果 15 秒,显式更长窗口保留至截止后 3 秒。缓存过期后不再提供执行去重。
167
192
 
168
193
  ## 八、脚本契约
169
194
 
@@ -207,7 +232,7 @@ ec services call <aid> <type> --data '<json>' # 发起调用
207
232
 
208
233
  | 项 | 值 |
209
234
  | --- | --- |
210
- | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
235
+ | 超时 | 默认 10s,`timeoutMs` ∈ [1s, 300s]。默认值刻意短于调用方的 12 秒等待期 |
211
236
  | 输出上限 | stdout+stderr 合计 1 MiB;**超出即终止进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断 |
212
237
  | 环境变量 | `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
238
  | 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
@@ -240,8 +265,8 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
240
265
 
241
266
  - 不带 `request_contact`、不带包名/type/脚本路径——回包不能变成探测手段;
242
267
  - 无论目标 type 是否存在,回包完全一样(否则"有没有回包"就是枚举信道);
243
- - 同一个来源 **24 小时内只回这一次**,之后一律静默;全局另有 30 次/分、200 次/时
244
- 的回复上限,换 AID 也放不大。
268
+ - 同一个来源 **24 小时内只回这一次**(这是拒绝回包的去重窗口,与调用侧 12 秒
269
+ 无关),之后一律静默;全局另有 30 次/分、200 次/时 的回复上限,换 AID 也放不大。
245
270
 
246
271
  **不会自动建联系人申请**,对方需自己 `ec directory request` 找你的 Owner。
247
272
 
@@ -321,6 +346,7 @@ ec services rules remove services.order.create spam.agentid.cn --deny
321
346
  | **查看** | `status` `types` `ledger` `tail` `doctor` `reload` `rules show` `pack list` | member 及以上 | member 及以上 + 同 Owner |
322
347
  | **管理** | `pack add` `pack remove` `pack enable` `pack disable` `rules add` `rules remove` | owner / admin | daemonOwner + fullaccess + 同 Owner |
323
348
  | **总闸** | `enable` `disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
349
+ | **宿主** | `host enable` `host disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
324
350
  | **调用** | `describe` `schema` `call` | 准入决定(本机不判权) | 准入决定(本机不判权) |
325
351
 
326
352
  ### 概念
@@ -391,10 +417,12 @@ OS 账户权限就是信任边界。托管会话则按上表判定。
391
417
  ## 十二、排查
392
418
 
393
419
  ```
394
- ec services status # 包状态:active / skipped / invalid
395
- ec services doctor <包名> # requires、保留字遮蔽、脚本、路径
420
+ ec services status # 包状态:active / skipped / invalid;含 host 段
421
+ ec services types # 本 AID 现在能接的全部 services.*
422
+ ec services doctor <包名> # requires、保留字遮蔽、脚本、路径、ACL
396
423
  ec services ledger <包名> --tail 20
397
424
  ec services tail <包名>
425
+ ec services repair-acl # 历史包的 NTFS ACL 收口(幂等,仅 Windows)
398
426
  ```
399
427
 
400
428
  | 症状 | 先看 |
@@ -408,8 +436,8 @@ ec services tail <包名>
408
436
 
409
437
  ## 十三、不要做的事
410
438
 
411
- 1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 去重 24 小时,
412
- 超出窗口的重试会重新执行。
439
+ 1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 默认去重 15 秒,更长请求按截止时间扩展;
440
+ 超出窗口的重试会重新执行;真正的幂等键要由脚本按业务字段自己保证。
413
441
  2. **不要在脚本里自己发回复**。输出 `outcome` 让 daemon 发,否则话题、加密态、
414
442
  `request_id` 都会错。
415
443
  3. **注意保留字只占两段形式**。`exttype` 设成 `list` 时 `services.list` 被内置抢走,
@@ -90,6 +90,8 @@ ec thread create <peer> --name '项目A' --status active
90
90
 
91
91
  创建成功后返回 `threadId`,格式为 `thread-<ms>-<seq4>-<rand4>`(如 `thread-1791028341906-0000-136a`)。创建时会自动向对端发一条系统消息通知。
92
92
 
93
+ `<peer>` 不能是本端自己的 AID(含大小写差异与 `@` 前缀),否则报 `SELF_PEER_NOT_ALLOWED`。话题是两端结构,对端写成本端会得到「我↔我」的残缺话题:消息投得进去,但实际没有接收方。要给自己派活,请先以真实对端建话题,再用 `ecmsg send --thread <该话题> --to <本端AID>`。
94
+
93
95
  ### 修改话题
94
96
 
95
97
  ```bash
@@ -261,6 +261,16 @@ DaemonOwner 管理请求
261
261
 
262
262
  ## 三、查实现时从哪里开始
263
263
 
264
+ ### Windows Shell 签名校验
265
+
266
+ EC 特权路径先识别实际 EC 调用,再校验其 Windows Shell carrier 的可执行文件。
267
+ 普通 `Get-Content` 等 Shell 命令继续走原有文件路径策略和审批流程,不因 EC 专用签名检查失败而拒绝。
268
+ 命令参数中作为文字出现的 `ec` 不构成 EC 调用;携带托管会话凭据的 PowerShell 前缀仍受校验。
269
+
270
+ EC carrier 校验失败继续拒绝,错误保留具体环节及可执行文件路径,例如文件无法访问、
271
+ 校验程序启动/执行失败、超时、结果无法解析、签名无效或发布者不受信任。
272
+ daemon 日志同时保留原始错误码、退出码、签名状态及探测输出等适用诊断;缓存命中保留原始失败原因。
273
+
264
274
  ### Shell 查询的路径判定
265
275
 
266
276
  `readonly-shell-query` 是共享查询分析器,H/L 类路径预检在 `readonly`、`auto`、`request`、
@@ -56,16 +56,9 @@ agent 通过 AID 发现网关:`GET https://{aid}/.well-known/aun-gateway`,
56
56
 
57
57
  ### 核心服务
58
58
 
59
- | 命名空间 | 作用 |
60
- | --- | --- |
61
- | auth.* | AID 注册、认证、token 管理 |
62
- | message.* | 点对点消息、离线队列 |
63
- | group.* | 群组生命周期、群消息 |
64
- | storage.* | 文件上传下载 |
65
- | stream.* | 实时流 |
66
- | meta.* | 健康检查、状态查询 |
67
-
68
- 完整协议文档(含 mail/search/relay/ca/peer/task 等):Read `$AUN_PROTOCOL_DOCS`。
59
+ 网关按命名空间路由:`auth.*`(注册/认证/token)、`message.*`(点对点消息、离线队列)、
60
+ `group.*`(群生命周期)、`storage.*`(文件)、`stream.*`(实时流)、`meta.*`(健康检查)。
61
+ 完整协议(含 mail/search/relay/ca/peer/task 等):Read `$AUN_PROTOCOL_DOCS`。
69
62
 
70
63
  ### 自主模式
71
64
 
@@ -124,32 +117,18 @@ ECK(EvolCore Context Kit)是 EvolCore 的上下文组装系统。你正在
124
117
 
125
118
  ### 上下文组装流程
126
119
 
127
- evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
128
- 每个 section 带 `when` 条件,evolcore 按当前会话构造一组运行时变量(`chatType`、`channel`、
129
- `selfAid`、`peerKey` 等)逐段求值,命中的才按顺序拼进 system prompt(`needsInjection` 的段还会先做模板渲染)。
120
+ evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
121
+ 每个 section 带 `when` 条件,按当前会话构造的运行时变量(`chatType`、`channel`、`selfAid`、`peerKey` 等)
122
+ 逐段求值,命中的才拼进 system prompt。
130
123
 
131
- 按场景,命中的段大致是:
132
-
133
- | 场景 | 命中的层/段 |
134
- | --- | --- |
135
- | coding(无渠道) | active 时为 rules + 会话层 + baseagent(身份/关系/环境/渠道层因无 channel、无身份而落选) |
136
- | private(私聊) | rules + 身份层(含 soul)+ 关系层(对端)+ 环境层 + 渠道层 + 会话层 + baseagent |
137
- | group(群聊) | rules + 身份层(含 soul)+ 关系层(群)+ 环境层 + 渠道层 + 会话层 + baseagent |
138
- | bootstrapping | bootstrap 引导 + 有渠道时的共用回复规则 [reply](含最小身份、目标、chatMode);不加载 rules、完整身份/关系/环境/渠道能力、会话、baseagent 或 commands 段 |
124
+ **你当前看到的 system prompt 就是求值结果**,不需要先推导命中规则再判断自己有什么能力。
125
+ 想知道"某个场景会命中哪些段"、section 字段、when 语义、合并覆盖、模板渲染与 `debug.eckSnapshots`
126
+ 调试输出,Read `$KITS_DOCS/context-assembly.md`(该文档含完整默认 manifest 段清单)。
139
127
 
140
- > 共用 `reply-contract` 在有渠道且 `lifecycle∈{active,bootstrapping}` 时加载;其余常规段(包括 rules、session、baseagent)都要求 `lifecycle=active`。生命周期缺失按 `active` 处理;非法时,
141
- > Manifest 不加载任何常规段;agent-owned turn 也不会直接落入普通 runner。
142
-
143
- 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
144
- `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
128
+ 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
129
+ `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
145
130
  `kits/eck_message_manifest.json`(逐条消息渲染)。
146
131
 
147
- manifest schema、when 条件、合并覆盖、模板渲染、运行时变量目录详见 `$KITS_DOCS/context-assembly.md`。
148
-
149
- **实际渲染结果的调试输出**默认**关闭**,要在进程级配置里打开 `debug.eckSnapshots: true` 才会写;
150
- 开启后落 `$EVOLCORE_HOME/data/eck-debug/`,文件名带时间戳:`vars-<ts>.json`、`context-<ts>.md`、
151
- `fragments-<ts>.md`、`manifest-<ts>.md`(逐条消息渲染另有 `msg-render-<ts>.md`),保留 24 小时。
152
-
153
132
  ## 命令行的引号写法
154
133
 
155
134
  `ec` 命令里的自由文本参数(消息正文、`--desc`、`--prompt`、`--name`、`--question`、
@@ -38,6 +38,13 @@
38
38
  项目源码和工作文件仍按任务指定位置保存。已注册工作区的旧 `output/` 会在初始化时
39
39
  迁入 Agent 的 `output/`,旧位置保留兼容目录链接;原栏目注册和逻辑路径继续有效。
40
40
 
41
+ 正式成果的卡片发布属于默认交付流程。完成面向 Owner 的报告、文档、会议记录、媒体等可复用
42
+ 文件成果后,若已启用技能索引中有 `agent-output-cards`,在回复任务完成前主动执行
43
+ `ec skill load agent-output-cards`,按技能发布卡片并检查结果;无需 Owner 再提“卡片”“发布”
44
+ 或技能名。同一成果更新时复用原卡片 ID。普通聊天、临时文件、中间草稿、仅修改项目源码
45
+ 不触发发布;用户明确要求只回复、不保存或不发布时遵从。发布失败时保留成果并如实说明,
46
+ 不得把“文件已保存”当作“卡片已发布”。
47
+
41
48
  ## 路径注册表机制
42
49
 
43
50
  路径用 `$名称` 引用,不写死实际路径。
@@ -23,7 +23,7 @@
23
23
  - **回复方式随实际 `chatMode` 走**,以 `[reply]` 段为准,不按对端类型或是否私聊推断:
24
24
  - interactive:直接输出即回复
25
25
  - proactive:用 `ecmsg send` 正式回复,见 `[reply]` 段
26
- - **发消息只有 `ecmsg` 一个入口**:文字、文件、图片、语音、链接、@某人、加密、联系第三方,全部用 `ecmsg send`。本端恒为当前会话本端,无需指定
26
+ - **会话发言与通用消息发送用 `ecmsg`**:文字、文件、图片、语音、链接、@某人、加密、联系第三方,全部用 `ecmsg send`。Ability 业务使用 `ec ability remote discover/call` 专用工具,复用同一 daemon delegated sender;它不用于普通聊天。本端恒为当前会话本端,无需指定
27
27
  - **消息分三种**:**普通消息**(当前话题的会话对端发来)、**跨话题自派**(本端从另一个话题派给自己)、**跨话题委托**(本端从另一个话题委托给该话题的对端,对方回复后回流)
28
28
  - **跨话题发送有两个动作**:`--thread <话题id>` 是**跨话题委托**,目标是该话题的对端;`--thread <话题id> --to <本端AID>` 是**跨话题自派**,目标是该话题下的本端自己,用于「对端是人、不会自己推进」的分叉场景
29
29
 
@@ -41,7 +41,7 @@
41
41
  **重要**:遇到明确触发词(费用/用量/统计/创建/查群/远程 daemon 诊断/改配置/个人助理工作区入口调整等)时,优先查 `$KITS_DOCS/evolcore/INDEX.md`
42
42
  或直接试对应 ec 命令。`[commands]` 段仅列常用命令,完整目录在 INDEX.md。
43
43
 
44
- **发消息一律用 `ecmsg`**,它是唯一的发送入口。其余命令以 `ec` 为前缀。**运行时按当前场景(有无对端/群、对端角色)注入的精简能力卡由 `commands` fragment 决定**(见动态注入的 `[commands]` 段)。
44
+ **会话发言与通用消息发送用 `ecmsg`**。Ability 的发现和业务请求使用 `ec ability remote` 的协议专用授权:保留当前任务、Caller 和原命令绑定,不继承本机插件权限或普通聊天联系人准入准出,能力许可和确认由 Provider 执行;不能将普通聊天伪装成 Ability 发送。其余命令以 `ec` 为前缀。**运行时按当前场景(有无对端/群、对端角色)注入的精简能力卡由 `commands` fragment 决定**(见动态注入的 `[commands]` 段)。
45
45
 
46
46
  **完整命令集目录(含分类、触发词、适用场景)**:`$KITS_DOCS/evolcore/INDEX.md`。
47
47
  单个命令集的详细用法按需 Read 对应文档。
@@ -55,7 +55,7 @@
55
55
  修改承载当前会话的 EvolCore 源码后,Agent 只负责构建并报告需要宿主重启;`ec agent reload` 只重载配置/soul/memory,不重载源码。
56
56
 
57
57
  共同约定:
58
- - 发送只有 `ecmsg` 一个入口,本端恒为当前会话本端,不写 `--from`,也不需要知道自己的 AID
58
+ - 会话发言与通用消息发送用 `ecmsg`;Ability 业务用 `ec ability remote`,本端恒为当前会话本端,不写 `--from`
59
59
  - 回复方式随 `chatMode` 走(见上方通信规则);附加能力(文件/@/加密/发第三方)任何模式下都用 `ecmsg`
60
60
  - `--format json` / `--app <name>` **不是全局参数**:只在自身 `--help` 明确列出的命令上有效
61
61
  (`--app` 主要用于消息 pull/ack、消费类 RPC 和支持 app slot 的文件操作)。拿不准就先跑 `--help`
@@ -4,15 +4,25 @@
4
4
  "currentVersion": 3
5
5
  },
6
6
  "daemon": {
7
- "currentVersion": 9
7
+ "currentVersion": 10,
8
+ "history": [
9
+ {"version": 10, "date": "2026-11-17", "description": "删除顶层 owner/owners:控制 Owner 只由 ownership 协议授予,daemon.json 不再保存绑定目标。"}
10
+ ]
8
11
  },
9
12
  "defaults": {
10
- "currentVersion": 5,
11
- "history": []
13
+ "currentVersion": 7,
14
+ "history": [{ "version": 7, "date": "2026-11-17", "description": "新增插件全局 enabled 开关,与 Agent 配置继承隔离" }]
12
15
  },
13
16
  "agent-config": {
14
- "currentVersion": 20,
17
+ "currentVersion": 23,
15
18
  "history": [
19
+ {"version": 23, "date": "2026-11-17", "description": "删除顶层 owner/owners:Owner 只由 ownership 协议授予,配置字段不再作为绑定目标或授权来源。"},
20
+ { "version": 22, "date": "2026-11-17", "description": "支持随包发现的 baseagent 插件与描述符配置校验;默认值只挂最低声明层,删除对象级及错层默认值(见 docs/config/11-default-value-levels.md)" },
21
+ {
22
+ "version": 21,
23
+ "date": "2026-11-16",
24
+ "description": "新增 Owner 专属的私聊 @ 处理策略 privateMentionMode"
25
+ },
16
26
  {
17
27
  "version": 20,
18
28
  "date": "2026-11-07",
@@ -41,8 +51,13 @@
41
51
  ]
42
52
  },
43
53
  "relation-config": {
44
- "currentVersion": 12,
54
+ "currentVersion": 13,
45
55
  "history": [
56
+ {
57
+ "version": 13,
58
+ "date": "2026-11-16",
59
+ "description": "关系级只声明字段与类型,不声明任何业务默认值"
60
+ },
46
61
  {
47
62
  "version": 12,
48
63
  "date": "2026-11-05",
@@ -69,6 +84,18 @@
69
84
  }
70
85
  },
71
86
  "history": [
87
+ {
88
+ "schema": "relation-config",
89
+ "version": 13,
90
+ "date": "2026-11-16",
91
+ "description": "逐字段默认值收口:默认值只挂最低声明层,删除对象级默认值与错层默认值(规则见 docs/config/11-default-value-levels.md)"
92
+ },
93
+ {
94
+ "schema": "agent-config",
95
+ "version": 22,
96
+ "date": "2026-11-16",
97
+ "description": "关系级只声明字段与类型,不声明任何业务默认值"
98
+ },
72
99
  {
73
100
  "schema": "providers",
74
101
  "version": 3,
@@ -93,6 +120,12 @@
93
120
  "date": "2026-11-05",
94
121
  "description": "私聊支持 interactive/proactive;群聊固定 proactive;PA activity 自动按身份投递"
95
122
  },
123
+ {
124
+ "schema": "agent-config",
125
+ "version": 21,
126
+ "date": "2026-11-16",
127
+ "description": "新增 Owner 专属的私聊 @ 处理策略 privateMentionMode"
128
+ },
96
129
  {
97
130
  "schema": "agent-config",
98
131
  "version": 20,