evolcore 0.0.43-test.6 → 0.0.43-test.8

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 (249) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/bin/ecmsg.js +188 -58
  3. package/dist/agent-template/jobs.js +62 -0
  4. package/dist/agent-template/runtime.js +214 -0
  5. package/dist/agent-template/service.js +465 -0
  6. package/dist/agent-template/tool-runner.js +45 -0
  7. package/dist/agent-template/types.js +5 -0
  8. package/dist/agents/baseagent-availability.js +1 -1
  9. package/dist/agents/claude-runner.js +1 -1
  10. package/dist/agents/codex/app-server-client.js +22 -0
  11. package/dist/agents/codex-runner.js +69 -2
  12. package/dist/aun/aid/agentmd.js +56 -1
  13. package/dist/aun/aid/client.js +3 -1
  14. package/dist/aun/menu/client.js +3 -2
  15. package/dist/aun/msg/p2p.js +6 -1
  16. package/dist/channels/aun.js +277 -49
  17. package/dist/cli/agent-command.js +5 -0
  18. package/dist/cli/agent-create.js +7 -3
  19. package/dist/cli/agent-template.js +124 -0
  20. package/dist/cli/aun-commands.js +2 -2
  21. package/dist/cli/ctl-command.js +2 -1
  22. package/dist/cli/daemon-commands.js +11 -66
  23. package/dist/cli/daemon-lifecycle-client.js +61 -0
  24. package/dist/cli/ecmsg-gateway.js +35 -2
  25. package/dist/cli/events-command.js +109 -0
  26. package/dist/cli/index.js +60 -14
  27. package/dist/cli/invoke-command.js +182 -0
  28. package/dist/cli/managed-command-guard.js +6 -1
  29. package/dist/cli/net-check.js +1 -1
  30. package/dist/cli/restart-monitor.js +160 -83
  31. package/dist/cli/services-command.js +137 -0
  32. package/dist/cli/team-workspace-command.js +134 -0
  33. package/dist/cli/thread-command.js +103 -13
  34. package/dist/cli/watch-msg.js +1 -1
  35. package/dist/config/boot-log.js +8 -8
  36. package/dist/config/config-field-policy.js +2 -2
  37. package/dist/config/config-manager.js +0 -7
  38. package/dist/config/invoke-ipc-service.js +118 -0
  39. package/dist/config/schema-migration.js +45 -15
  40. package/dist/config-store.js +2 -1
  41. package/dist/core/agent-ipc-registration.js +25 -4
  42. package/dist/core/agent-reload-coordinator.js +6 -4
  43. package/dist/core/agent-runtime.js +106 -10
  44. package/dist/core/auth/delegation-authorization.js +66 -0
  45. package/dist/core/auth/operation-authorizer.js +2 -0
  46. package/dist/core/auth/operation-catalog.js +29 -0
  47. package/dist/core/baseagent-loader.js +60 -130
  48. package/dist/core/channel-loader.js +10 -1
  49. package/dist/core/channel-runtime.js +20 -12
  50. package/dist/core/command/agent-control.js +12 -2
  51. package/dist/core/command/agent-storage-menu.js +1 -1
  52. package/dist/core/command/agent-template-menu.js +147 -0
  53. package/dist/core/command/chatmode-config.js +2 -36
  54. package/dist/core/command/command-handler.js +80 -17
  55. package/dist/core/command/data-root-resolver.js +32 -23
  56. package/dist/core/command/eventcenter-menu.js +468 -0
  57. package/dist/core/command/menu-catalog.js +15 -0
  58. package/dist/core/command/menu-handler.js +216 -90
  59. package/dist/core/command/menu-protocol.js +71 -13
  60. package/dist/core/command/menu-query-batch.js +194 -0
  61. package/dist/core/command/slash-gate.js +1 -1
  62. package/dist/core/command/slash-handler.js +34 -42
  63. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  64. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  65. package/dist/core/command/team-workspace-initializer.js +2 -0
  66. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  67. package/dist/core/command/team-workspace-job-store.js +88 -0
  68. package/dist/core/command/team-workspace-management-service.js +2 -0
  69. package/dist/core/command/team-workspace-management-store.js +96 -0
  70. package/dist/core/command/team-workspace-management.js +265 -0
  71. package/dist/core/command/team-workspace-members-menu.js +88 -0
  72. package/dist/core/command/team-workspace-store.js +612 -0
  73. package/dist/core/command/team-workspace-team.js +193 -0
  74. package/dist/core/daemon-control.js +22 -5
  75. package/dist/core/daemon-lifecycle.js +323 -191
  76. package/dist/core/handoff/runtime.js +45 -13
  77. package/dist/core/invoke/executors/index.js +13 -0
  78. package/dist/core/invoke/executors/media.js +283 -0
  79. package/dist/core/invoke/executors/text.js +198 -0
  80. package/dist/core/invoke/invoke-service.js +157 -0
  81. package/dist/core/invoke/style-router.js +48 -0
  82. package/dist/core/invoke/types.js +19 -0
  83. package/dist/core/ipc-registration.js +50 -7
  84. package/dist/core/legacy-rename.js +41 -0
  85. package/dist/core/memory/consolidation.js +7 -5
  86. package/dist/core/message/aun-ipc-sender.js +252 -17
  87. package/dist/core/message/im-renderer.js +116 -85
  88. package/dist/core/message/message-bridge.js +4 -0
  89. package/dist/core/message/message-queue.js +66 -15
  90. package/dist/core/message/message-utils.js +10 -2
  91. package/dist/core/message/peer-mode.js +7 -34
  92. package/dist/core/message/pending-hints.js +29 -5
  93. package/dist/core/message/response-engine.js +194 -61
  94. package/dist/core/message/send-options.js +7 -4
  95. package/dist/core/message/send-routing.js +50 -5
  96. package/dist/core/ownership/owner-resolver.js +7 -0
  97. package/dist/core/pack-auth.js +94 -0
  98. package/dist/core/pack-install.js +194 -0
  99. package/dist/core/permission/ec-command-parser.js +51 -17
  100. package/dist/core/permission/protected-paths.js +12 -2
  101. package/dist/core/permission/shell-environment.js +9 -0
  102. package/dist/core/rate-window.js +48 -0
  103. package/dist/core/relation/peer-identity.js +28 -0
  104. package/dist/core/session/session-file-health.js +243 -0
  105. package/dist/core/session/session-fs-store.js +67 -28
  106. package/dist/core/session/session-idle-monitor.js +59 -19
  107. package/dist/core/session/session-manager.js +13 -4
  108. package/dist/core/task/task-recovery-service.js +13 -2
  109. package/dist/core/thread/command-parser.js +9 -2
  110. package/dist/core/thread/thread-operation.js +21 -2
  111. package/dist/core/thread/thread-route.js +13 -2
  112. package/dist/core/thread/thread-service.js +52 -3
  113. package/dist/directory/owner-directory-admission.js +40 -53
  114. package/dist/directory/owner-directory-cache.js +89 -113
  115. package/dist/directory/owner-directory-query-operation.js +8 -10
  116. package/dist/eck/kit-renderer.js +7 -5
  117. package/dist/eck/message-renderer.js +2 -0
  118. package/dist/ecweb/basic-settings-service.js +1 -1
  119. package/dist/ecweb/message-context-service.js +0 -4
  120. package/dist/ecweb/runtime/lifecycle.js +6 -2
  121. package/dist/ecweb/runtime/supervisor.js +19 -4
  122. package/dist/event-center/admission-materializer.js +124 -0
  123. package/dist/event-center/bus-gate.js +154 -0
  124. package/dist/event-center/bus-host.js +307 -0
  125. package/dist/event-center/bus-resolver.js +120 -0
  126. package/dist/event-center/center-config.js +127 -0
  127. package/dist/event-center/daemon.js +44 -0
  128. package/dist/event-center/directory-source.js +55 -0
  129. package/dist/event-center/dispatcher.js +157 -0
  130. package/dist/event-center/event-log.js +110 -0
  131. package/dist/event-center/index-generator.js +73 -0
  132. package/dist/event-center/ipc-operation.js +423 -0
  133. package/dist/event-center/ledger.js +52 -0
  134. package/dist/event-center/pack-loader.js +207 -0
  135. package/dist/event-center/pack-manager.js +85 -0
  136. package/dist/event-center/registry.js +463 -0
  137. package/dist/event-center/runtime.js +837 -0
  138. package/dist/event-center/script-runner.js +356 -0
  139. package/dist/event-center/types.js +51 -0
  140. package/dist/event-center/validation.js +435 -0
  141. package/dist/index.js +424 -135
  142. package/dist/ipc.js +106 -12
  143. package/dist/paths.js +20 -0
  144. package/dist/product.js +14 -0
  145. package/dist/proxy/manager.js +5 -1
  146. package/dist/proxy/service-supervisor.js +13 -4
  147. package/dist/response-system/engines/v1/index.js +0 -1
  148. package/dist/response-system/engines/v1/proactive-flow.js +4 -2
  149. package/dist/response-system/modes/single-session/index.js +1 -1
  150. package/dist/services/dispatcher.js +100 -0
  151. package/dist/services/idempotency.js +90 -0
  152. package/dist/services/identity.js +52 -0
  153. package/dist/services/index-generator.js +70 -0
  154. package/dist/services/index.js +449 -0
  155. package/dist/services/ipc-operation.js +550 -0
  156. package/dist/services/ledger.js +52 -0
  157. package/dist/services/message-log.js +112 -0
  158. package/dist/services/pack-manager.js +215 -0
  159. package/dist/services/reply.js +55 -0
  160. package/dist/services/router.js +98 -0
  161. package/dist/services/script-runner.js +422 -0
  162. package/dist/services/service-payload.js +70 -0
  163. package/dist/services/types.js +18 -0
  164. package/dist/services/validation.js +297 -0
  165. package/dist/trigger/application-service.js +18 -0
  166. package/dist/trigger/event-source.js +1 -1
  167. package/dist/trigger/ipc-service.js +3 -1
  168. package/dist/trigger/scheduler.js +38 -0
  169. package/dist/trigger/script-sandbox.js +170 -24
  170. package/dist/utils/cross-platform.js +24 -10
  171. package/dist/utils/evolcore-version.js +69 -27
  172. package/dist/utils/instance-registry.js +19 -13
  173. package/dist/utils/npm-ops.js +2 -1
  174. package/dist/utils/package-version-info.js +6 -3
  175. package/dist/utils/process-introspect.js +45 -9
  176. package/dist/utils/startup-trace.js +74 -37
  177. package/dist/utils/windows-shell-trust.js +80 -6
  178. package/kits/docs/INDEX.md +2 -2
  179. package/kits/docs/aun/ABILITY_CALLING.md +9 -15
  180. package/kits/docs/context-assembly.md +1 -1
  181. package/kits/docs/evolcore/INDEX.md +3 -1
  182. package/kits/docs/evolcore/ability.md +4 -0
  183. package/kits/docs/evolcore/agent.md +22 -1
  184. package/kits/docs/evolcore/aid.md +1 -1
  185. package/kits/docs/evolcore/event-center.md +227 -0
  186. package/kits/docs/evolcore/file-navigation.md +10 -264
  187. package/kits/docs/evolcore/fs.md +5 -3
  188. package/kits/docs/evolcore/group.md +1 -1
  189. package/kits/docs/evolcore/memory-architecture.md +2 -0
  190. package/kits/docs/evolcore/menu-protocol.md +28 -1
  191. package/kits/docs/evolcore/msg.md +21 -9
  192. package/kits/docs/evolcore/provider.md +3 -1
  193. package/kits/docs/evolcore/response.md +5 -5
  194. package/kits/docs/evolcore/services.md +294 -0
  195. package/kits/docs/evolcore/task.md +2 -0
  196. package/kits/docs/evolcore/team-workspace.md +41 -0
  197. package/kits/docs/evolcore/thread-chain.md +15 -3
  198. package/kits/eck_manifest.json +26 -0
  199. package/kits/rules/02-navigation.md +10 -1
  200. package/kits/rules/06-channel.md +1 -0
  201. package/kits/schemas/_meta.json +17 -6
  202. package/kits/schemas/agent-config.schema.19.json +5 -7
  203. package/kits/schemas/agent-config.schema.20.json +936 -0
  204. package/kits/schemas/relation-config.schema.12.json +2 -3
  205. package/kits/schemas/role-config.schema.2.json +4 -4
  206. package/kits/skills/.switches.json +1 -5
  207. package/kits/skills/ability/SKILL.md +56 -0
  208. package/kits/skills/ability/references/calling.md +56 -0
  209. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  210. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  211. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  212. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  213. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  214. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  215. package/kits/skills/ec-group/SKILL.md +5 -8
  216. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  217. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  218. package/kits/skills/ec-trigger/SKILL.md +4 -4
  219. package/kits/skills/personal-assistant/SKILL.md +6 -6
  220. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  221. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  222. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  223. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  224. package/kits/skills/thread-ops/SKILL.md +10 -10
  225. package/kits/templates/message-fragments/item.md +1 -1
  226. package/kits/templates/system-fragments/channel.md +3 -3
  227. package/kits/templates/system-fragments/commands.md +5 -3
  228. package/kits/templates/system-fragments/reply.md +1 -5
  229. package/kits/templates/system-fragments/thread.md +13 -10
  230. package/package.json +5 -6
  231. package/scripts/agent-template/index.mjs +40 -0
  232. package/scripts/agent-template/inspect.mjs +240 -0
  233. package/scripts/agent-template/overlay.mjs +71 -0
  234. package/scripts/agent-template/pack.mjs +169 -0
  235. package/scripts/agent-template/shared/common.mjs +235 -0
  236. package/scripts/agent-template/shared/evolcore.mjs +75 -0
  237. package/scripts/agent-template/shared/plan.mjs +129 -0
  238. package/scripts/agent-template/shared/team-schema.json +70 -0
  239. package/scripts/agent-template/shared/template-contract.mjs +154 -0
  240. package/scripts/agent-template/shared/template-package.mjs +265 -0
  241. package/scripts/agent-template/shared/template-runtime.mjs +80 -0
  242. package/scripts/agent-template/shared/template.mjs +142 -0
  243. package/dist/cli/pa-workspace-command.js +0 -225
  244. package/dist/core/command/pa-workspace-store.js +0 -468
  245. package/dist/core/relation/pa-team.js +0 -132
  246. package/kits/docs/evolcore/pa-workspace.md +0 -51
  247. package/kits/skills/aid-ability/SKILL.md +0 -244
  248. package/kits/skills/ec-ability/SKILL.md +0 -67
  249. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -0,0 +1,227 @@
1
+ # 事件中心(`ec events`)
2
+
3
+ > 状态:[done]
4
+ > 创建:2026-11-08
5
+ > 对应实现:`src/event-center/` 和 `src/cli/events-command.ts`。
6
+
7
+ Agent 怎么建事件包、写处理脚本、注册/发布/订阅事件。
8
+
9
+ > 完整设计见仓库 `docs/event-center/`;Schema 见 `docs/event-center/schema/`。
10
+ > 本文是运行时知识卡,与 `docs/event-center/usage.md` 保持同步。
11
+
12
+ ## 一、先判断该不该用
13
+
14
+ | 要做的事 | 用什么 |
15
+ | --- | --- |
16
+ | 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是事件中心 |
17
+ | 有事情发生时通知**别的 AID** | 事件中心 |
18
+ | 收到别人的通知后跑确定性逻辑 | 事件中心 |
19
+ | 收到通知后要模型判断、要写报告 | 事件中心 + 脚本里调 `ecmsg` |
20
+ | 消息绝不能丢 | 普通持久消息,**不是**事件 |
21
+
22
+ 事件是 TTL 内的在线通知:TTL 到期、断线、Bus 重启都会丢。没有历史、没有重放、没有业务 ACK。
23
+
24
+ ## 二、目录
25
+
26
+ ```
27
+ $AGENT_DIR/events/
28
+ ├── events-config.json # 只有"我要当事件中心"时才需要
29
+ └── <包名>/
30
+ ├── pack.json
31
+ ├── ledger.jsonl
32
+ ├── scripts/
33
+ └── logs/
34
+ ```
35
+
36
+ 包名用英文短横线,如 `meeting`、`order-watch`。
37
+
38
+ ## 三、三种角色
39
+
40
+ 一个 `pack.json` 里三类声明互相独立:
41
+
42
+ | 角色 | 写在哪 | 含义 |
43
+ | --- | --- | --- |
44
+ | 登记 | `register[]` | 让本 AID 成为这个事件的事件中心 |
45
+ | 发布 | `publish[]` | 往别人的事件中心发 |
46
+ | 订阅 | `subscribe[]` | 收别人的事件,收到就跑脚本 |
47
+
48
+ 只订阅时不需要 `events-config.json`。
49
+
50
+ ## 四、pack.json
51
+
52
+ ```json
53
+ {
54
+ "v": 1,
55
+ "name": "会议通知",
56
+ "register": [
57
+ { "event": "meeting.created", "description": "新会议", "ttl": 30 }
58
+ ],
59
+ "publish": [
60
+ { "bus": "$owner", "event": "meeting.created" }
61
+ ],
62
+ "subscribe": [
63
+ {
64
+ "bus": "$owner",
65
+ "event": "meeting.created",
66
+ "handler": { "script": "scripts/on-created.mjs", "runtime": "node", "timeoutMs": 15000 }
67
+ }
68
+ ]
69
+ }
70
+ ```
71
+
72
+ ### bus 写什么
73
+
74
+ `bus` **不写字面 AID**,写占位符:
75
+
76
+ | 写法 | 指向 |
77
+ | --- | --- |
78
+ | `$self` | 本 AID 自己的事件中心 |
79
+ | `$owner` | 本 Agent 的 Owner(Evol App 往这里发) |
80
+ | `$pa` | 本 Owner 的个人助理 |
81
+ | `$pa.<role>` | PA Team 里担任 `<role>` 的人 |
82
+ | `"a.b.agentid.cn"` | 字面 AID,只在对方明确给了地址时用 |
83
+
84
+ 包之所以写占位符:包是拿来拷给别的 Agent 的,写死 AID 拷过去就指向错的人。
85
+
86
+ 约束:
87
+
88
+ - `$pa.<role>` 匹配多个时,取 AID 字典序第一个,不报错。同一个包在不同 Agent 上解析结果稳定。
89
+ - `subscribe[]` 内部同一个 `(bus, event)` 只能出现一次(同理 `publish[]`);publish 与 subscribe 之间互不冲突,可以既发又订同一事件。
90
+ - `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接。
91
+ - `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断,推断不出即校验失败。
92
+ - 一个包校验失败只废这个包,其余照常启动。
93
+ - 占位符解析失败时按顶层 `busResolve` 处理:`strict`(缺省)停该包,`keep-last` 沿用上次结果。
94
+
95
+ ## 五、events-config.json
96
+
97
+ ```json
98
+ {
99
+ "v": 1,
100
+ "enabled": true,
101
+ "authMode": "allowlist",
102
+ "rules": {
103
+ "meeting.created": {
104
+ "allow": {
105
+ "publish": ["bus.example.cn"],
106
+ "subscribe": []
107
+ }
108
+ }
109
+ }
110
+ }
111
+ ```
112
+
113
+ `allow.publish` / `allow.subscribe` 为**空数组表示不额外限制**,非空则只放行列出的 AID;可再加 `deny`(命中即拒,优先于 `allow`)。不接受旧写法 `publish_aids` / `subscribe_aids`,也不接受 `"*"` 通配。白名单放行不等于能发——最终还要叠加联系人准入。
114
+
115
+ `enabled=false`(缺省)时本 AID 只作订阅方/发布方,不承接任何人的事件。同一个 AID 不能在两台机器上同时开事件中心(`DEVICE_CONFLICT`)。
116
+
117
+ 白名单**不写进 pack.json**:包会被拷走,白名单不能跟着走。
118
+
119
+ 还有两个可选键:
120
+
121
+ | 键 | 缺省 | 说明 |
122
+ | --- | --- | --- |
123
+ | `admission` | `{"coupling":"on","rematerializeMs":300000}` | 与联系人准入耦合;`coupling` 只接受 `"on"`,`rematerializeMs` ∈ [60000,3600000] |
124
+ | `rateLimit` | `{"perMinute":60,"perHour":600}` | 发布限流,按发布方 AID 独立计 |
125
+
126
+ ## 六、脚本契约
127
+
128
+ ### stdin(一个 JSON)
129
+
130
+ ```json
131
+ {
132
+ "v": 1,
133
+ "pack": { "name": "meeting", "dir": "…/events/meeting" },
134
+ "bus": "bus.example.cn",
135
+ "event": {
136
+ "name": "meeting.created",
137
+ "id": "01J…",
138
+ "publisher": "bus.example.cn",
139
+ "receivedAt": 1794115720000,
140
+ "data": { "title": "周会" }
141
+ },
142
+ "agent": { "aid": "self.agentid.cn", "dir": "…" },
143
+ "paths": { "ledger": "…/ledger.jsonl", "logs": "…/logs" }
144
+ }
145
+ ```
146
+
147
+ **判断"谁发的"用 `event.publisher`**。信封上的 from 永远是 Bus 自己。
148
+
149
+ ### 输出
150
+
151
+ | 情况 | 写法 |
152
+ | --- | --- |
153
+ | 正常完成 | 退出码 0 |
154
+ | 无事发生 | 最后一行 `[[NOOP]]`(仍写 `handled` 记录,`outcome:"noop"`) |
155
+ | 有结果 | 最后一行 `{"outcome":"success","text":"…","files":[]}` |
156
+ | 失败 | 退出码非 0 |
157
+
158
+ 末行不是 JSON 也不是 `[[NOOP]]` 时按纯文本结果处理(`text` = 末行)。
159
+
160
+ ### 限制
161
+
162
+ | 项 | 值 |
163
+ | --- | --- |
164
+ | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
165
+ | 输出上限 | stdout+stderr 合计 1 MiB,超出终止 |
166
+ | 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_EVENT` / `EC_EVENT_ID` / `EC_BUS` / `EC_PUBLISHER` |
167
+ | 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
168
+ | 沙箱 | 非 fullaccess 模式走 trigger 同款沙箱(cwd 为 agent 工程目录,脚本被快照执行);fullaccess 下 cwd 为包目录 |
169
+ | Windows | 沙箱模式需预置 codex 沙箱,未预置时报 `SCRIPT_SANDBOX_UNAVAILABLE`;`node` 运行时用本机 node.exe,`.mjs` 可跑 |
170
+
171
+ 事件数据一律从 stdin JSON 读,不要依赖读包目录(`events/` 属 L-class,沙箱下不可读)。
172
+
173
+ ## 七、常用操作
174
+
175
+ ```
176
+ ec events status [<包名>] # 每包状态
177
+ ec events doctor <包名> # 白名单/脚本/路径/租约诊断
178
+ ec events ledger [<包名>] [--tail 20] # 台账(不传包名 = 中心台账:bus.start/stop、gate、rules 变更)
179
+ ec events tail <包名> # 事件日志
180
+ ec events reload [<包名>] # 手动重载
181
+ ec events rules add <事件> --publish <aid> [--deny]
182
+ ec events rules remove <事件> --publish <aid> [--deny]
183
+ ec events rules show [--event <事件>]
184
+ ec events pack add <包名> --from <源目录>
185
+ ec events pack remove <包名> [--purge]
186
+ ec events pack list
187
+ ec events publish <包名> <事件名> --data '<json>'
188
+ ```
189
+
190
+ 改 `pack.json` / `center.json` 后约 2 秒自动热重载(目录监听),无需手动命令;
191
+ `ec events reload` 仍可用(托管任务内也可用——委托身份下仅限只读与 reload,
192
+ `allowlist` / `publish` 仅宿主终端)。
193
+
194
+ 订阅生效与自愈的完整时机:
195
+
196
+ 1. **agent 启动**:调度器启动即扫描 `events/` 并接入(authorize → 回调 → subscribe)。
197
+ 2. **目录监听**:改包配置自动 reload(增量 diff,不重建连接)。
198
+ 3. **contacts 变化**:`$pa` 等占位符在名录变化且解析结果真的改变时自动重解析重订阅。
199
+ 4. **失败对账**:authorize/subscribe 失败按指数退避(5s→60s 封顶)自动重试,
200
+ 连接恢复(state_change ready)即刻重试;台账只在失败与恢复两个时刻各记一条。
201
+
202
+ ## 八、排查
203
+
204
+ | 症状 | 先看 |
205
+ | --- | --- |
206
+ | 订阅没生效 | `ledger.jsonl` 里 `subscribe` 的 `result` 和 `code` |
207
+ | 收不到事件 | 对方 Bus 的 `rules.<event>.allow.subscribe` 有没有放行你;也要看联系人准入 |
208
+ | 收到但脚本没跑 | 日志里 `filtered` 记录(filter 不匹配);或 `received` 后队列满 `dropped` |
209
+ | 脚本失败 | `handled` 记录的 `exit`、`outcome` 和 `cmd` |
210
+ | `DEVICE_CONFLICT` | 同一 AID 是否在别处已经开着事件中心 |
211
+ | `FORBIDDEN` | 目标 Bus 白名单没放行本 AID |
212
+ | 脚本全报 126 | 沙箱不可用:`SCRIPT_SANDBOX_UNAVAILABLE`(Windows 未预置沙箱,或 agent 无工程目录) |
213
+
214
+ ## 九、不要做的事
215
+
216
+ 1. **不要从 `message.received` 里解析事件**。事件只通过 SDK 的 `onEvent` 回调;消息层看到 `app.pubsub.v1` 直接忽略。
217
+ 2. **不要用 `from != self` 判断是不是事件**。自己的 Bus 发给自己时 from 就是自己。
218
+ 3. **不要指望事件重放**。没收到就是没了,要补用持久消息重新问。
219
+ 4. **不要把白名单写进 pack.json**。
220
+ 5. **不要在同一个包里给同一个 `(bus, event)` 写两个 handler**。
221
+
222
+ ## 十、相关文档
223
+
224
+ | 文档 | 用途 |
225
+ | --- | --- |
226
+ | `$KITS_DOCS/evolcore/event.md` | Trigger 的 EventBus 事件目录(**内部事件,不是 AUN 事件**) |
227
+ | `$KITS_DOCS/evolcore/trigger.md` | 定时/事件触发器,到点执行用这个 |
@@ -1,279 +1,25 @@
1
- # PA 工作区入口导航:agent 操作手册
1
+ # Team Workspace 文件入口
2
2
 
3
- 个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
4
- 新增一个产物目录要给用户看到,改导航即可,不需要 App 发版。
3
+ 状态只保存在 `$EVOLCORE_HOME/agents/<aid>/data/team-workspace-state.json`;不要手工编辑状态文件,也不要在工作区内创建导航副本。
5
4
 
6
- 本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
7
- **本文自包含**,按本文即可完成导航的增删改,不需要读其他文档。
8
-
9
- ## 1. 文件在哪
10
-
11
- ```text
12
- $AGENT_DATA_DIR/pa-workspace-state.json
13
-
14
- ```
15
-
16
- 其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
17
- 被导航指向的真实文件在 PA 工作区里(`capture/`、`output/` 等),导航只存"指向哪里",不存内容。
18
-
19
- ### 1.1 三个名字指同一份数据
20
-
21
- | 名字 | 指什么 |
22
- | --- | --- |
23
- | pa-workspace-state.json | 磁盘上的完整状态:绑定信息(workspaceId/ownerAid/rootPath)+ navigationRevision + entries |
24
- | file-navigation.json | 导航内容本身,即 {version, entries} 这部分。协议与设计文档里的叫法 |
25
- | --entries-json | 命令参数,取值就是 file-navigation.json 的 entries 数组 |
26
-
27
- **改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
28
- 递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
29
- 手工编辑 `pa-workspace-state.json` 会跳过全部这些保护。
30
-
31
- 导出当前导航为 `file-navigation.json`:
5
+ Agent 发布自己的产物:
32
6
 
33
7
  ```bash
34
- ec pa-workspace navigation show
35
-
36
- ```
37
-
38
- 该命令**只输出 JSON**,`--format json` / `--json` 可加但无区别。
39
-
40
- ## 2. 格式
41
-
42
- `file-navigation.json` 顶层:
43
-
44
- ```json
45
- {
46
- "version": 1,
47
- "entries": []
48
- }
49
-
8
+ ec team navigation update --upsert-json '[{"id":"report","title":"报告","path":"output/report.md","kind":"file","order":30}]'
50
9
  ```
51
10
 
52
- `--entries-json` 只接收 `entries` 数组,`version` 由命令维护。
53
-
54
- ### 2.1 完整 Schema
55
-
56
- Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
57
- 其余字段被静默丢弃 —— 写错字段名不会报错,只会无声失效。
58
-
59
- ```json
60
- {
61
- "$schema": "https://json-schema.org/draft/2020-12/schema",
62
- "$id": "urn:evol:schema:file-navigation:v1",
63
- "title": "PA workspace file navigation v1",
64
- "type": "object",
65
- "additionalProperties": false,
66
- "required": ["version", "entries"],
67
- "properties": {
68
- "version": { "const": 1 },
69
- "entries": {
70
- "type": "array",
71
- "maxItems": 200,
72
- "items": { "$ref": "#/$defs/entry" }
73
- }
74
- },
75
- "$defs": {
76
- "entry": {
77
- "type": "object",
78
- "additionalProperties": false,
79
- "required": ["path", "kind"],
80
- "properties": {
81
- "id": {
82
- "type": "string",
83
- "minLength": 1,
84
- "maxLength": 200,
85
- "description": "稳定标识。省略时由 path 的 sha256 前缀自动生成。改名必须保留原 id。"
86
- },
87
- "title": {
88
- "type": "string",
89
- "minLength": 1,
90
- "maxLength": 200,
91
- "description": "展示名。省略时回落为 path 的最后一段。"
92
- },
93
- "path": {
94
- "type": "string",
95
- "minLength": 1,
96
- "maxLength": 2048,
97
- "description": "工作区根下的相对路径。反斜杠会被归一化为 /。拒绝绝对路径、冒号、NUL、.. 段,以及任何以 . 开头的路径段和 capture/_manifest。"
98
- },
99
- "kind": {
100
- "enum": ["file", "directory"],
101
- "description": "必须与真实目标类型一致;目标不存在且 availability=unavailable 时按声明值保留。"
102
- },
103
- "order": {
104
- "type": "integer",
105
- "minimum": 0,
106
- "maximum": 1000000,
107
- "description": "升序展示。省略时回落为数组下标。"
108
- },
109
- "icon": {
110
- "type": "string",
111
- "minLength": 1,
112
- "maxLength": 100,
113
- "description": "语义图标名。超长截断而非报错;不认识的图标 App 用默认图标。"
114
- },
115
- "availability": {
116
- "enum": ["available", "unavailable"],
117
- "default": "available"
118
- },
119
- "reason": {
120
- "type": "string",
121
- "minLength": 1,
122
- "maxLength": 500,
123
- "description": "availability=unavailable 时必填。超长截断。"
124
- }
125
- }
126
- }
127
- }
128
- }
129
-
130
- ```
131
-
132
- ### 2.2 字段行为细节
133
-
134
- | 字段 | 省略时 | 校验失败时 |
135
- | --- | --- | --- |
136
- | id | 由 path 自动生成 pa-<sha256前16位> | 重复 ID → INVALID_ARGUMENT |
137
- | title | 回落 path 最后一段 | 超 200 字符 → INVALID_ARGUMENT |
138
- | path | 不可省略 | 绝对路径/冒号/../隐藏段 → INVALID_ROOT_PATH |
139
- | kind | 不可省略 | 与真实目标不一致 → INVALID_ARGUMENT |
140
- | order | 回落数组下标 | 非 0..1000000 整数 → INVALID_ARGUMENT |
141
- | icon | 无图标 | 超 100 字符截断,不报错 |
142
- | availability | available | 非法值 → INVALID_ARGUMENT |
143
- | reason | — | unavailable 却没给 → INVALID_ARGUMENT |
144
-
145
- 额外规则:
146
-
147
- - `entries` 最多 200 项。
148
- - `id` 不能重复,`path` 也不能重复,两者分别查重。
149
- - 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
150
- - 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
151
- - `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
152
-
153
- ### 2.3 隐藏路径的判据
154
-
155
- 任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
156
- 所以 `output/reports` 可以,`output/.cache/reports` 和 `.assistant/state` 不行。
157
-
158
- ## 3. 怎么改
159
-
160
- ### 3.1 先读,再写
11
+ Agent 删除入口:
161
12
 
162
13
  ```bash
163
- ec pa-workspace navigation show
164
-
14
+ ec team navigation update --remove-ids-json '["report"]'
165
15
  ```
166
16
 
167
- 拿到当前的 `navigationRevision`。
168
-
169
- ### 3.2 完整替换,不是局部 patch
17
+ 完整替换只用于有意重建导航:
170
18
 
171
19
  ```bash
172
- ec pa-workspace navigation update \
173
- --expected-revision 3 \
174
- --entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10},{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20}]'
175
-
176
- ```
177
-
178
- - `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
179
- - `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
180
- 重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
181
- - 成功后 `navigationRevision` 加 1,返回新状态。
182
-
183
- ### 3.3 先发布入口、后创建目录
184
-
185
- 目标还没建好时,用 `unavailable` 占位:
186
-
187
- ```json
188
- {"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20,"availability":"unavailable","reason":"目录尚未创建"}
189
-
20
+ ec team navigation update --replace-json '[{"id":"output","title":"团队产物","path":"output","kind":"directory","order":20}]'
190
21
  ```
191
22
 
192
- 目录建好后再次 update 改为 `available`。
193
-
194
- ### 3.4 隐藏入口
195
-
196
- 从 `entries` 数组里**移除**即可。不要用 `unavailable` 假装隐藏 —— 那会留一个带原因的可见入口。
197
-
198
- ## 4. 常见任务
199
-
200
- | 用户说 | 怎么做 |
201
- | --- | --- |
202
- | "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
203
- | "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
204
- | "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
205
- | "把 X 入口藏起来" | 从数组移除 X → update |
206
- | "让 B 助理那边也显示我的报告" | 在 B 的工作区执行 update,指到 B 自己可见的路径 |
207
- | "把我另一个助理的周报放进来看" | 当前版本不支持,见 §6 |
208
-
209
- ## 5. 自检清单
210
-
211
- 改完逐条确认:
212
-
213
- - [ ] 保留的入口都在新数组里(完整替换语义)
214
-
215
- - [ ] `id` 没重复,改名时 ID 未变
216
-
217
- - [ ] `path` 没重复
218
-
219
- - [ ] `path` 不含冒号、绝对路径前缀、`..` 段
220
-
221
- - [ ] `path` 没有以 `.` 开头的段,也没命中 `capture/_manifest`
222
-
223
- - [ ] `kind` 与实际目标是目录还是文件一致
224
-
225
- - [ ] `unavailable` 的入口都带了 `reason`
226
-
227
- - [ ] 用 `ec pa-workspace navigation show` 复核结果
228
-
229
- ## 6. 当前版本不支持跨 Agent 入口
230
-
231
- 一个 PA 的导航**只能指向自己工作区里的文件**。
232
-
233
- 不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
234
- Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
235
- 既不报错也不生效 —— 你会以为配置成功了,实际入口指向的还是自己。
236
-
237
- 跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
238
- 由各自 PA 在自己的导航里发布。
239
-
240
- ## 7. 不能做的事
241
-
242
- - 不要把这份数据叫 `manifest` —— 会和 EvolCore 已有的 manifest 体系混淆。
243
- - 不要把主机绝对路径、IP、端口写进导航。
244
- - 不要在导航里放短期凭证。凭证由 Core 在读取时另行签发。
245
- - 不要指望 App 按入口 ID 写死专用页面。`id` 只用于稳定关联,不影响能否打开。
246
- - 不要修改 `pa-workspace-state.json` 的 `workspaceId`、`ownerAid`、`rootPath`。
247
- 改绑定用 `ec pa-workspace bind --workspace "<新路径>"`。
248
- - 本命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用。
249
-
250
- ## 8. 点开后发生什么
251
-
252
- App 按 `kind` 和实际文件格式决定展示方式:
253
-
254
- | 格式 | 展示 |
255
- | --- | --- |
256
- | Markdown | Markdown 阅读页,相对链接和图片可解析 |
257
- | 静态 HTML | 静态文档阅读,保留版式与相对 CSS/图片,脚本被移除 |
258
- | 纯文本 | 等宽文本 |
259
- | JSON / JSONL / YAML | 按文本展示 |
260
- | 图片 / 音频 / 视频 / PDF | 有预览能力则预览,否则显示"不支持预览" |
261
- | 未知二进制 | 文件信息 |
262
-
263
- **新增产物只要落在通用阅读能力内,就不需要 App 发版。**
264
-
265
- ## 9. 相关
266
-
267
- - `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
268
- - 文件读取协议:`menu-protocol.md` 的 file 段
269
- - 工作区目录规范:`personal-assistant` Skill
270
-
271
- ## 10. 设计背景(仅源码仓库)
272
-
273
- 以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
274
- 完成导航操作不需要读它们,仅在参与开发时参考:
23
+ 命令默认读取 `navigationRevision`,也可以用 `--expected-revision` 做 compare-and-swap。冲突时重新执行 `ec team navigation show`,合并后再提交。入口路径只能是绑定工作区内的相对路径,Core 会验证真实路径、类型、符号链接和隐藏运行时目录。
275
24
 
276
- | 文档 | 内容 |
277
- | --- | --- |
278
- | docs/personal-assistant/workspace-browser-v1/schema.json | evol.pa-workspace 导航响应的正式 JSON Schema(与本文的写入格式不同) |
279
- | docs/personal-assistant/13-cross-agent-artifact-navigation.md | 跨 Agent 入口的设计、双端实施清单、权限边界 |
25
+ `team-workspace` Menu 仅限当前 Agent Owner 的 AUN 私聊。App 使用返回的短期 `fileRoot.rootId` 读取已发布路径;Root 不返回宿主绝对路径,成员列表也不授予其他 Agent 的读取权限。
@@ -1,4 +1,4 @@
1
- # ec fs — AUN 文件系统
1
+ # ec fs — AUN 文件系统
2
2
 
3
3
  `ec fs` 是个人空间和群空间的统一文件入口。群空间也用 `ec fs`,没有 `ec group fs`。
4
4
 
@@ -106,7 +106,7 @@ CLI 读取目标 AID 的 `agent.md`:
106
106
  文本文件:
107
107
 
108
108
  ```bash
109
- ec fs cat <current-peer-aid>:/ability/index.json
109
+ ec fs cat <current-peer-aid>:/.well-known/ability/index.json
110
110
  ```
111
111
 
112
112
  这个跨 AID 入口仅限 `cat`、仅限当前私聊关系,不允许 `ls/stat/find`、写操作或切换到其他对端;
@@ -124,7 +124,9 @@ ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authori
124
124
  个人存储内联读取携带预算加一字节的探测范围;HTTP 下载逐块计数,超限立即中止,
125
125
  单次 HTTP 读取最多等待 30 秒。文件大小元数据不能替代实际读取校验;非文本内容只返回有界摘要。
126
126
  需要更大文件时使用 `ec fs cp` 下载,不将大文件直接塞入会话上下文。
127
- 它适合 Ability 的 L1/L3 契约读取;不满足这些条件时使用 `ec storage download` 回退。
127
+ 此命令读取 AUN storage 对象路径。Ability 的 L1 索引固定读取 `/.well-known/ability/index.json`
128
+ (object not found 时可回退读取旧位置 `/ability/index.json`);L3 契约则按 Ability 索引中的
129
+ 精确 `detail_ref` 读取。
128
130
 
129
131
  托管 `ec fs` 对非 self 目标先读取并验证远端 `agent.md`,再按 `type` 选择 personal 或 group 后端:只有
130
132
  `type: group` 使用 group fs,而且普通托管任务只能访问当前 AUN 群;其它类型使用 personal storage,
@@ -2,7 +2,7 @@
2
2
 
3
3
  群聊场景下收发消息、管理群与成员。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
4
4
 
5
- **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`)。本页其余 `ec group` 命令用于群管理;宿主终端场景下它们也承担发送。
5
+ **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`;宿主终端用 `--from <本端AID>`)。本页其余 `ec group` 命令只用于群管理,不用于发消息。
6
6
 
7
7
  本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
8
8
 
@@ -21,6 +21,8 @@
21
21
 
22
22
  relation 是所有记忆的唯一出生地,agent 级和 owner 级都由它升格而来。
23
23
 
24
+ `ownerAid` 只有一个来源:归属协议共识(`ownerResolver.primaryOwner`)。`promote` / `forget` 写入的目录、整理会话的可写根、上下文里 owner 索引注入的路径都按同一个 AID 解析;名录快照里的 Owner 只做交叉核对,两边不一致时会在守护进程日志里告警,避免记忆写进一个 owner 的目录、读的时候去另一个 owner 的目录找。
25
+
24
26
  ## 整理什么时候启动
25
27
 
26
28
  | 触发 | 说明 |
@@ -5,6 +5,27 @@
5
5
 
6
6
  Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协议**,与 AUN SDK 本身无关。任何能发送 AUN 消息的客户端,只要按照本文约定的 payload 格式发送,都可以与 EvolCore daemon 交互。对应实现:`src/core/command/menu-protocol.ts`、`src/aun/menu/`。
7
7
 
8
+ > 2026-11-08:设置页混合批量查询使用 `menu.query name="menu" args.view="queries"`。单批 1~32 项,每项使用 `itemId/name/args`,可用 `argsFrom` 引用前项结果;最多 6 个并发,逐项鉴权、逐项返回。支持 role(capabilities/target/role/requester)、agent、baseagent、activity、effort、model、chatmode、team-workspace members。`agent.data.safeConfig.baseagentSkills === true` 可替代查询该字段的 CLI action。members 仍仅允许当前 Agent Owner 的 AUN 私聊。以下示例发送到目标 Agent AID 的 AUN 私聊。
9
+
10
+ ```json
11
+ {
12
+ "type": "menu.query",
13
+ "id": "settings-batch-001",
14
+ "name": "menu",
15
+ "args": {
16
+ "view": "queries",
17
+ "schemaVersion": 1,
18
+ "items": [
19
+ { "itemId": "agent", "name": "agent" },
20
+ { "itemId": "model", "name": "model", "args": { "scope": "agent" } },
21
+ { "itemId": "members", "name": "team-workspace", "args": { "view": "members", "managementVersion": 1 } }
22
+ ]
23
+ }
24
+ }
25
+ ```
26
+
27
+ 响应 `data.kind="menu.query_batch"`,`data.items` 按输入顺序逐项给出 `itemId/name/ok/data` 或 `itemId/name/ok/error`。`agent` 项可共用其 `fullaccessStatus`、`config.baseagent`、`safeConfig.baseagentSkills`,不必重复请求。Control AID / ECWeb 还需顶层 `agent` 指定目标;members 在这些入口返回该项权限错误。已有 `view="values"` 的 entryId 查询保持不变。
28
+
8
29
  ---
9
30
 
10
31
  ## 一、传输层约定
@@ -232,7 +253,13 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
232
253
 
233
254
  `/system upgrade` 的 `args.mode` 支持 `check`、`update` 和 `status`,缺省为 `check`。升级是 daemon 全局单例;`update` 不接受 `jobId`,重复请求复用当前任务,`status` 查询当前任务或最近终态。四个入口(Menu、slash、`ec` CLI、ECWeb)使用同一检查、升级和状态服务。进度仍通过 `menu.event` 的 `upgrade.progress` / `upgrade.result` 投递。
234
255
 
235
- ### Agent 初始化
256
+ ### Agent 模板与指定 Provider 模型目录
257
+
258
+ 主机 Control AID 上支持 `name=agent`、action=`inspect/build/push/pull/deploy`,要求当前操作者同时为 DaemonOwner 和对应 Agent Owner。inspect 即时返回,其他 action 返回 jobId,随后通过 `menu.event template.progress/result` 推送。任务查询为 `menu.query name=agent args={view:'template-job',jobId}`;首次响应丢失时以 requestId 替代 jobId,二者互斥。部署按 pullId 幂等,重启后按持久日志恢复;旧的 upgrade 事件格式保持兼容。
259
+
260
+ 指定连接的模型查询使用 `menu.query name=model args={scope:'process',view:'catalog',baseagent,providerId,serviceType?,refresh?}`,仅 DaemonOwner Control/受认证管理入口;返回 CatalogSnapshot,不要求先更改 Agent Provider。完整模板输入、分享短码、结果与错误码见仓库 `docs/agent-template/agent-template-app-integration.md`。
261
+
262
+ ### Agent 初始化参数
236
263
 
237
264
  主机 Agent 初始化通过 `menu.action`、`name="agent"`、`action="initialize"` 调用。参数可平铺在
238
265
  `args` 中,也可放入 `args.plan`;`aid` 必须与计划中的 AID 一致。`project` 可省略或为空,Core 会按普通
@@ -2,6 +2,8 @@
2
2
 
3
3
  私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询。
4
4
 
5
+ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`);协议语义见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。本文维护消息命令参数和请求查询行为。
6
+
5
7
  ## Agent 会话中的 Shell 调用边界
6
8
 
7
9
  在 EvolCore 托管会话中,每次工具调用只能执行一条完整的命令。禁止把
@@ -9,15 +11,25 @@
9
11
  和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
10
12
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
11
13
 
12
- 发送统一入口是 `ecmsg send`,本端恒为当前会话本端;目标三种说法:
14
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。按目标分三种形态:
15
+
16
+ | 形态 | 写法 | 目标 |
17
+ |---|---|---|
18
+ | 普通回复 | `ecmsg send '<text>'` | 当前会话的对端/群 |
19
+ | 跨话题委派 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
20
+ | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 |
21
+
22
+ `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
23
+
24
+ **跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self`。
13
25
 
14
- | 目标 | 写法 |
15
- |---|---|
16
- | 当前会话的对端/群(默认) | `ecmsg send '<text>'` |
17
- | 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
18
- | 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
26
+ 宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
27
+
28
+ ```bash
29
+ ecmsg send '<text>' --from <本端AID> --thread <话题id> --to <对端或本端AID>
30
+ ```
19
31
 
20
- `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。宿主终端没有会话上下文时,`ec msg send <from> <to> '<text>'` 是同一通道的非托管形态。
32
+ `--self` 已不再被接受(本端只由 `--from` 表达)。
21
33
 
22
34
  ## 发送消息
23
35
 
@@ -55,7 +67,7 @@ ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s -
55
67
  ecmsg send '<text>' --return none
56
68
  ```
57
69
 
58
- `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊 `msg send`,不能同时提供位置文本。
70
+ `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊发送(`ecmsg send`),不能同时提供位置文本。
59
71
  Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
60
72
  最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
61
73
  在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
@@ -101,7 +113,7 @@ ec peer unblock <target-aid> --self <self-aid>
101
113
 
102
114
  发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
103
115
 
104
- 非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
116
+ 宿主终端(非托管,带 `--from`)不加载 `agents/<aid>/config.json`,且只放行跨话题自派,不经过这条联系人准入链。跨话题自派的收件人是本端自己,在任何环境下都跳过联系人准入。
105
117
 
106
118
  在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
107
119
  要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),