evolcore 0.0.50 → 0.0.51

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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -25,29 +25,32 @@
25
25
  | `ec upgrade [--format json]` | 检查 EvolCore、EC Web 与 FASTAUN 版本 | 检查更新/版本更新 |
26
26
  | `ec update [status] [--format json]` | 发起/复用唯一升级任务,或查询当前升级状态 | 立即升级/升级状态 |
27
27
  | `ec restart` | 重启目标 daemon(承载当前托管会话的实例受生命周期保护) | 重启 |
28
- | `ec status [--format json]` | 查看运行状态、Agent、队列、渠道连接;JSON 快照 | 状态/查看状态 |
28
+ | `ec status [--format json]` | 查看运行状态、Agent、队列、渠道连接;JSON 含渠道与基座插件诊断 | 状态/查看状态/渠道插件不可用/基座插件加载失败 |
29
+ | `ec plugin` | 随包渠道/基座插件的 list/show/doctor/enable/disable;部署变更需宿主重启,详见 `plugin.md` | 插件库存/插件诊断/启用插件/停用插件 |
29
30
  | `ec logs` | 查看日志(`--level` `--module` `--no-color`);`--raw` 可在宿主终端或 trusted fullaccess 托管任务中使用 | 日志/查看日志 |
30
31
  | `ec diagnose` | 诊断启动环境 | 诊断/环境诊断 |
31
32
 
32
33
  ECWeb 托管重启、端口占用与升级失败处理见 `ecweb-lifecycle.md`。
33
34
 
35
+ 插件排查用 `ec status --format json`:`channels.providers` 含渠道名称、依赖可用性和失败原因;`baseagents.items[].plugin` 含基座发现、启用、注册状态,实例是否已创建另看 `loaded`。原因的 `code/stage/message/detail` 区分配置缺项、依赖缺失、导入或注册失败;缺少凭据可保留配置,实例会报告不可用。`baseagents.items[].capabilities` 是环境匹配后的声明,不等于新增权限或完整契约验收。
36
+
34
37
  Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSecurityInfoW ... 5`、`unelevated ... cannot enforce deny-read` 或 daemon 管道 `EPERM` 时,参见 `codex-windows-sandbox.md`。
35
38
 
36
39
  ## 对外通信 / 网络类(连 AUN,发送统一走 `ecmsg`)
37
40
 
38
41
  | 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
39
42
  |--------|------|--------|----------|------|
40
- | `ecmsg` | **发送消息的统一入口**(当前会话 / `--thread` 跨话题 / `--to` 指定对端) | 回复/发消息/发文件/发链接/payload/加密/跨话题/WidgetCard/HTML表单 | 有对端(peerId) | `msg.md` |
43
+ | `ecmsg` | **发送消息的统一入口**(当前会话 / `--thread` 跨话题:默认委托,`--selfmode` 自派) | 回复/发消息/发文件/发链接/payload/加密/跨话题/WidgetCard/HTML表单 | 有对端(peerId) | `msg.md` |
41
44
  | `ec msg` | 私聊消息查询命令(拉取/撤回/查在线/请求状态/本地历史);发送一律用 `ecmsg` | 拉取/撤回/查在线/请求等待/结果查询/request_id/call_id | 有对端(peerId) | `msg.md` |
42
45
  | `ec thread` | 话题管理与话题链 | 话题/thread/跨会话/委托/话题链/ThreadOrigin/summary/删除话题 | 有对端(私聊或群聊) | `thread-chain.md` |
43
- | `ec group` | 群聊收发与群管理 | 群发/建群/本地群历史/邀请/踢人/退群/群成员/角色/封禁/屏蔽/成员状态/规则/@提及模式/协作 | AUN 群;可从私聊发起协作 | `group.md`;协作流程用 `ec-group-collaboration` 技能 |
46
+ | `ec group` | 建群与成员/角色/规则管理,群消息拉取与本地群历史查询(发消息一律用 `ecmsg`) | 群发/建群/本地群历史/拉取群消息/邀请/踢人/退群/群成员/角色/封禁/屏蔽/成员状态/规则/@提及模式/协作 | AUN 群;可从私聊发起协作 | `group.md`;协作流程用 `ec-group-collaboration` 技能 |
44
47
  | `/invites` / `ec group invites` | 收到群邀请、Owner 卡片审核与恢复 | 入群邀请/接受邀请/拒绝邀请/审核卡片/待处理邀请 | 当前 Agent Owner 的 AUN 私聊 | `group.md` |
45
48
  | `ec group rules` | 群规则文件发布与上下文注入 | 群规则/工作流程/职责分工/rules.md/发布规则 | AUN 群聊(groupId) | `group-rules.md` |
46
49
  | `ec aid` | AID 身份管理 | 身份/证书/名片/探测对端 | 任意有渠道场景 | `aid.md` |
47
50
  | `ec aid` | AID 身份、名片与头像管理 | 身份/证书/名片/头像/换头像/探测对端 | 任意有渠道场景 | `aid.md` |
48
51
  | `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
49
52
  | `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
50
- | `ec agent` | EvolAgent 生命周期、主机信息、模板及项目地址变更 | 创建/启停/热重载/改配置/查主机信息/打包模板/安装模板/项目路径迁移 | 管理操作按目标与角色鉴权;template/project 要求双 Owner | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
53
+ | `ec agent` | EvolAgent 生命周期、主机信息、模板及项目地址变更 | 创建/启停/热重载/改配置/查主机信息/打包模板/收到模板分享/下载模板/安装模板/项目路径迁移 | 管理操作按目标与角色鉴权;pull 需要 DaemonOwner,project 要求双 Owner | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
51
54
  | `ec directory` | Owner 名录查询、入录申请与本地备注 | 联系人/通讯录/名录/找人的 AID/申请添加联系人/这个人是谁/内外联系人/拉黑名单/记备注 | 查询需 Owner 名录授权;申请通过 `request` 发给本端 Owner | `directory.md` |
52
55
  | `ec rpc` | 底层 AUN RPC(逃生通道) | 直接调协议方法 | 仅宿主终端;托管会话仅可查看帮助 | `rpc.md` |
53
56
  | `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/远程 daemon 操作/daemon 日志/监控/原始配置/跨主机 | 运维主机或具备 `ec.menu.request` 权限的托管 Agent | `menu-client.md` |
@@ -74,11 +77,11 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
74
77
 
75
78
  | 命令集 | 用途 | 触发词 | 文档 |
76
79
  |--------|------|--------|------|
77
- | `ec ability` | remote 发现、契约、设备、调用和结果查询;本地插件开发、管理与打包 | 手机能力/远端能力/remote/ability/能力插件/上架/下架/插件打包/插件诊断 | 内置 `ability` 技能(`ec skill load ability`) |
80
+ | `ec ability` | remote 发现、契约、设备、调用和结果查询;本地插件开发、管理与打包 | 手机能力/手机号/短信/验证码/远端能力/remote/ability/能力插件/上架/下架/插件打包/插件诊断 | 内置 `ability` 技能(`ec skill load ability`) |
78
81
  | `ec provider` | 宿主 Provider 模板、注册表 CRUD 与单项 JSON 导入(宿主 DaemonOwner 控制入口或 trusted fullaccess 托管任务) | Provider/服务商/供应商/内置模板/套餐/导入服务商/注册表 | `provider.md` |
79
82
  | `ec model` | 模型与推理强度管理(按作用域持久化) | 切模型/列模型/当前模型/模型详情/改强度/诊断网关 | `model.md` |
80
83
  | `ec response` | 响应模式管理(按作用域持久化) | 切换响应模式/列响应模式/看当前模式/改响应配置 | `response.md` |
81
- | `ec config` | 配置体系底层入口(读写/快照/回滚) | 看配置/改配置/查字段/查schema/校验/快照/回滚/历史/启动记录 | `config.md` |
84
+ | `ec config` | 配置体系底层入口(读写/快照/回滚);Claude/Codex Agent 自动压缩阈值及原生 context-policy Menu 读写 | 看配置/改配置/自动压缩/上下文窗口/查字段/查schema/校验/快照/回滚/历史/启动记录 | `config.md` |
82
85
  | `ec role` | Owner 查询/设置角色用量配额,关系角色提升申请与审批 | 角色配额/角色限额/关闭限额/恢复继承/取消配额/usageLimits/申请角色/审批角色 | `role.md` |
83
86
  | `ec stats` | Token 用量与费用统计 | 用量/费用/统计/预算/token/cost | `stats.md` |
84
87
  | `ec quota` | 查询 Agent 与对端的生效限额、已用及剩余(status) | 自身限额/对端限额/剩余额度/是否超限 | `quota.md` |
@@ -87,7 +90,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
87
90
  | `ec events` | AUN 事件中心:注册/发布/订阅事件,事件到达跑脚本 | 事件中心/注册事件/发布事件/订阅事件/事件包/pack.json/events-config.json/scripts/AUN 事件 | `event-center.md` |
88
91
  | `ec services` | 服务路由:服务包状态/诊断/重载、宿主模式开关、ACL 收口;对端 describe/schema/call | 服务路由/服务包/提供接口/被对端调用/pack.json/services.call/服务节点/宿主模式/常驻/repair-acl/建服务包/调对端服务 | `services.md` |
89
92
  | `ec task` | 恢复暂停或异常中断的会话任务 | 任务恢复/异常中断/继续任务/resume | `task.md` |
90
- | `ec pay` | 网站付款卡片、二维码、渠道切换与订单核验 | 付款/支付/微信支付/支付宝/付款二维码/订单核验 | `pay.md`;先加载 `ec-pay` 技能 |
93
+ | `ec pay` | 网站付款卡片、二维码、渠道切换与订单核验 | 付款/支付/微信支付/支付宝/付款二维码/订单核验 | 先加载 `ec-pay` 技能;`pay.md` 仅为命令面索引 |
91
94
  | `ec skill` | EC 技能管理(新建/安装/删除/启用/禁用/校验/查路径) | 创建技能/新建 skill/安装技能/装个 skill/删除技能/禁用技能/启用技能/看看有哪些技能/技能为什么没生效 | `ec-capabilities.md` |
92
95
  | `ec pa-workspace` | 在 Owner 的 AUN 私聊中查看和维护 PA 工作区入口导航 | 个人助理工作区/工作区入口调整/产物入口/报告入口/任务入口/隐藏入口/改名入口/排序入口 | `pa-workspace.md` |
93
96
  | `ec pa-workspace` | 入口导航文件的位置、格式、schema 与安全改法;含跨 Agent 入口 | 导航格式/入口格式/加个入口/产物给用户看/加个报告入口/入口指向别的助理/file-navigation/导航文件在哪 | `file-navigation.md` |
@@ -36,6 +36,8 @@ active
36
36
 
37
37
  两种模式都可能短暂出现 `ownerpending`,区别在于它之后由谁推进:`--initialize` 由 daemon 自己确认共识并激活,`--bootstrap` 由 channel 触发引导对话。只有 `lifecycle=active` 才表示 Agent 已完成创建流程并可正常处理普通任务。
38
38
 
39
+ 当托管 Agent A 在当前 Owner O 的 AUN 私聊中创建 B,Core 会在 B 的精确初始 Ownership bind operation 保存后,把 `ownership_bind_request` 卡片发回 A-O 原话题。Evol App 必须在 O 的本地 SDK 中打开并核验同一 `operation_id`、B、O、requester 和关系版本,再由 O 明确接受或拒绝。`--initialize` 的状态见 `initialization.ownershipApproval`,旧版构建进度路径见 `createProgress.ownershipApproval`;两者都只描述卡片投递。缺少原始 SDK 回执的已提交请求继续查共识,不按最新任务补卡或重提绑定。字段与 App 处理契约见 `../../../docs/agent-creation-ownership-approval-card.md`。
40
+
39
41
  `--bootstrap` 下如果名片发布失败,配置会停在 `created` 而不是 `ownerpending`,此时不会发起 Ownership 绑定;先修好发布再谈 Bootstrap。
40
42
 
41
43
  ## 1. 触发 Bootstrap
@@ -1,19 +1,65 @@
1
1
  # ec agent — EvolAgent 生命周期管理
2
2
 
3
- 管理本机托管的 EvolAgent(创建、启停、配置、热重载、模板)。触发词:创建/新建/列出/查看/启用/禁用/删除/热重载/改配置/打包模板/安装模板。
3
+ 管理本机托管的 EvolAgent(创建、启停、配置、热重载、模板)。触发词:创建/新建/列出/查看/启用/禁用/删除/热重载/改配置/打包模板/收到模板分享/下载模板/安装模板。
4
4
 
5
5
  ## Agent 模板
6
6
 
7
- 单 Agent 可信来源绑定、周期提醒及 Owner 手动升级已加入 template Menu/CLI:`update-status`、`check-update`、`bind-update-source`、`confirm-update-source`、`preview-update`、`read-update-notice`。执行沿原 `deploy/status/resume/cancel` 作业;disabled 禁止检查/覆盖,auto 仅检查提醒。旧无来源明确未绑定,不根据 config.version 或 update.publisher 猜测。实际契约、私有目录配置、锁/提醒/恢复语义与 App 待办见[单 Agent 更新接入](../../../docs/agent-template/single-agent-manual-update-core-20261117.md)。
7
+ 本地中文帮助可离线查看:`ec agent template --help` 列出子命令的简短用途、常用流程及通用选项;`ec agent template <子命令> --help`(也支持 `-h`)提供语法、关键参数/默认值、一个短示例与必要下一步。帮助不展开完整 schema 或恢复教程,也不读取输入文件、连接 daemon 或执行模板操作。完整字段与复杂分支查询 `ec agent template capabilities` 返回的 `data.inputSchemas`,模块 include 与 project 索引结构分别见 `data.modules`、`data.selectionIndexSchema`;该查询需要 daemon,不同版本以目标 Host 为准。本节保留安装模式、采集索引、外部联系人与作业恢复的详细说明。
8
+
9
+ `pull` 仅下载和校验,不安装。需要目标主机的 DaemonOwner 权限;权限不足时,通知 Owner 并询问后续操作。
10
+
11
+ | 子命令 | 用途与主要输入 |
12
+ | --- | --- |
13
+ | `inspect` | 按 `module` 盘点 `members` 的 Agent 或目录来源,返回后续采集所需清单 |
14
+ | `collect` | 引用成功 `inspectionJobId`、`inventoryDigest` 和模块 `include`,生成可编辑副本 |
15
+ | `pack` | 用 `metadata` 与 `members[key].collections[].jobId` 组合成功采集副本 |
16
+ | `push` | 将 `packageId` 上传到 `location`;路径须为 `/templates/<id>/<id>-<version>.ectpl` |
17
+ | `list` | `--store AID` 查询仓库,可选 `--kind agent\|team --publisher AID --template-id ID --offset N --limit 1..50` |
18
+ | `detail` | `RELEASE_ID --store AID [--from-version VERSION]` 查看精确发行与组件汇总 |
19
+ | `publish` | `PACKAGE_ID --store AID` 上传到发布者自身 Storage、授权仓库读取并确认发行 |
20
+ | `download` | `RELEASE_ID --store AID --path PATH` 申请本 Host 下载授权,下载到指定路径并校验精确发行 |
21
+ | `pull` | `--input-file FILE [--path PATH]` 下载 Storage 分享,JSON 指定远程 source |
22
+ | `preview` | `--path PATH --install-mode create\|overwrite --member KEY --aid AID`,直接读取本地包,选择目标与本机 Provider |
23
+ | `deploy` | `--preview-id ID --plan-digest DIGEST` 执行同一次可执行预览 |
24
+ | `status` | `JOB_ID` 或 `--request-id ORIGINAL` 二选一查询作业 |
25
+ | `resume` | `JOB_ID` 恢复原可恢复作业 |
26
+ | `cancel` | `JOB_ID` 请求取消并查询恢复结果 |
27
+ | `capabilities` | 无业务参数,查询动作/模块/schema/平台/限制 |
28
+ | `check-update` | `targetAid` 直接返回当前版本与本次仓库检查结果或失败原因,不安装、不提醒 |
29
+ | `upgrade` | `TARGET_AID [--release-id ID]` 发起单 Agent 固定发行升级 |
30
+
31
+ `inspect/collect/pack/push/check-update` 通过 `--input-file FILE` 传入 JSON。已有本地包直接 `preview --path PATH`,无需 pull。远程 Storage 使用 `pull --input-file FILE [--path PATH]`,省略 `--path` 时由 Host 在受管 TMPDIR 分配临时文件。`preview` 只接受命令行参数,不再接受 `--input-file` 或 `--package-id`;Menu 的 preview 使用 path,历史 packageId 输入仍兼容。`--format json` 可省,业务结果默认即为 JSON。除 `status/capabilities/check-update` 外,解析器接受可选的 `--request-id ID` 和 `--wait 0..300`;`check-update` 接受 `--request-id`,直接等待本次检查结果,不接受 `--wait`。`status` 的 `--request-id` 仅表示查询原请求,不能与 JOB_ID 同传。
32
+
33
+ Store 四个命令都要求 `--store`,不接受 `--input-file`。`list/detail` 默认等待30秒,其余动作默认不等待;超时不取消原作业,返回的 jobId 可用 status/resume。`list` 默认每页20项;`releaseId` 是64位小写十六进制精确发行 ID。暂不提供 versions 命令。
34
+
35
+ Store 调用身份由可信入口决定:托管会话使用当前执行 Agent,宿主终端或 Control Menu 使用实际 Host;无需传身份参数,不借用 Owner 身份。远端仍分别检查 Caller 准入与业务权限。`download` 固定发行、摘要、大小和目标 Host,授权过期时 resume 原作业只续取原发行。成功后用 result.path 继续 preview/deploy;普通下载不要求发行已审核或启用升级,也不自动安装。`pull` 只负责普通 Storage 来源,不查询 Store 或替用户申请仓库下载授权。
36
+
37
+ 单 Agent 升级沿 template Menu/CLI,要求本地 `version`、`update.key`(原始 Agent AID)、`update.registryAid` 及 `update.mode=manual|auto` 齐全。真实 Owner 使用现有配置入口管理来源和开关;`disabled` 禁止检查/升级,`auto` 只检查提醒。新包不会覆盖本机策略、仓库或原始 key。历史未知来源保持未知,不根据 publisher、Storage 主体或 Host 推断仓库。
38
+
39
+ CLI 升级流程为 `check-update → upgrade → status`。`ec agent template check-update --input-file FILE`(内容 `{"targetAid":"目标AID"}`)直接返回 `data.currentVersion/updateAvailable/target/summary`,其中 target 含固定候选 releaseId;不能检查时返回 `error.code/message` 和经鉴权可读取的当前版本。它查询本次仓库唯一审核且启用的目标及上一发行到目标的组件汇总,保存检查结果,不安装、不向 Owner 或 Agent 会话发送提醒,也不写入新的已通知记录。无需先查本地状态或再查检查作业。CLI `update-status` 已移除。
40
+
41
+ `ec agent template upgrade 目标AID [--release-id 精确发行ID] --request-id 稳定请求ID --wait 300 --format json` 一次发起固定候选升级,随后使用 `status JOB_ID`、`resume JOB_ID` 或 `cancel JOB_ID`。Menu 仍保留 `template` 的 `check-update/upgrade` action 与 `job/update-status` query:Menu 检查继续返回原异步 job(也不发提醒),`update-status` 只读取本地资格、来源、最近检查及 activeJob;内部 `updateStatus` 继续供页面和 CLI 失败结果读取当前版本。升级 action 参数仅 `targetAid` 与可选 `releaseId`。无逐文件 diff 或冲突选项。
42
+
43
+ 内置 `__agent-template-upgrade-check` Trigger 默认每日检查,与 Core/npm 检查独立;可按原 Trigger 入口调整周期,启动不覆盖调整。只有后台定时检查发送新版提醒,由目标 Agent 的真实渠道向当前 Owner 主会话发送 notice,成功回执持久去重,失败重试,不调用模型、不自动安装。手动检查保留已有通知回执,不把本次检查记成已通知;之后后台仍检查并发送尚未通知的新版提醒。
44
+
45
+ 安装沿原工作门和持久作业备份、应用、验证,提交版本及渲染后 `template.manifest.json`;仅提交后清理摘要匹配旧清单的备份,修改/未知项保留并在结果中列出。旧清单失效时保留全备份,不猜测移除旧资源。
46
+
47
+ 仓库下载统一使用 `download RELEASE_ID --store AID --path PATH`。下载和安装不新建独立包缓存或 record.json 索引;临时文件放当前会话 TMPDIR,长期保存主动放项目目录。preview 用同一操作者成功下载作业中的路径及摘要沿用仓库来源;文件移动后不猜测来源。pull 不提供仓库选项。原 file/artifact JSON 可校验原文件并返回路径,不另存副本;历史包索引、作业及 pack/push/publish 的成品机制保留。单 Agent 原始 key 跨安装和再打包保留,作者一个版本一致写入 PACKAGE/team/member。旧方案的绑定、逐文件预览及已读动作已退役。
8
48
 
9
49
  单成员、多成员共用 `ec agent template`。新建支持一个或多个成员,只创建成员 AID,沿用本机 Host 和经鉴权的 Owner;覆盖仅支持一个已有 Agent,保留其 AID、Owner、角色和默认项目目录。打包不带记忆、消息、私钥或 Provider 凭证;导入的 Trigger 默认停用并携带脚本。来源采集和覆盖要求操作者同时是 DaemonOwner 和对应 Agent 的协议 Owner。
10
50
 
11
51
  ```bash
12
52
  ec agent template inspect --input-file inspect.json --request-id <稳定ID>
13
- ec agent template build --input-file build.json --request-id <稳定ID>
53
+ ec agent template collect --input-file collect.json --request-id <稳定ID>
54
+ ec agent template pack --input-file pack.json --request-id <稳定ID>
14
55
  ec agent template push --input-file push.json --request-id <稳定ID>
15
- ec agent template pull --input-file pull.json --request-id <稳定ID>
16
- ec agent template preview --input-file preview.json --request-id <稳定ID>
56
+ ec agent template list --store <仓库AID>
57
+ ec agent template detail <releaseId> --store <仓库AID>
58
+ ec agent template publish <packageId> --store <仓库AID> --request-id <稳定ID> --wait 60
59
+ ec agent template download <releaseId> --store <仓库AID> --path '<下载落点绝对路径>' --wait 60
60
+ ec agent template pull --input-file pull.json --path '<下载落点绝对路径>' --request-id <稳定ID>
61
+ ec agent template preview --path '<包的绝对路径>' --install-mode create \
62
+ --default-aid-domain agentid.cn --member writer --aid auto --request-id <稳定ID>
17
63
  ec agent template deploy --preview-id <previewId> --plan-digest sha256:<摘要> --request-id <稳定ID>
18
64
  ec agent template status <jobId>
19
65
  ec agent template status --request-id <原请求ID>
@@ -22,19 +68,47 @@ ec agent template cancel <jobId> --request-id <本次取消ID>
22
68
  ec agent template capabilities
23
69
  ```
24
70
 
25
- `inspect/build/push/pull/preview` 的业务参数通过 JSON 文件传入。`capabilities` 返回动作输入 schema、状态及平台能力;文件模板沿用原 v1 的 `agents[]/key`、PACKAGE/MANIFEST 和资源结构。Core 作业以成员 key 关联,不按数组位置配对。Menu 使用进程级 `name: "template"`,动作与 CLI 一致;查询使用 `args.view: "job"` 或 `"capabilities"`。
71
+ `capabilities` 返回支持模块、模块 include schema、动作输入 schema、状态及平台能力;CLI 将安装参数转换成同一份业务结构再校验,不提供独立 modules 命令。文件模板沿用 v1 的 `agents[]/key`、PACKAGE/MANIFEST 和资源结构。Core 作业以成员 key 关联,不按数组位置配对。Menu 使用进程级 `name: "template"`,动作与 CLI 一致;查询使用 `args.view: "job"` 或 `"capabilities"`。
72
+
73
+ 模板仅安装 `agents[]` 声明的实际成员,不支持可选成员、后装票据或独立 Team 实例登记/发现。`memberReferences` 只接受 `{external:[{aid,name?}]}`;外部联系人保持未知归属,不变为实际成员。主助理和 `open_pa_context` 继续由现有名录机制管理。历史作业、交付和备份不在线迁移或删除。
74
+
75
+ 来源 Agent 的 access 访问设置不进入采集副本或新包;旧包中的 access 在安装计划中忽略。新建沿用目标 Host 默认访问设置,覆盖与升级保留目标 Agent 当前访问设置。
26
76
 
27
77
  模板声明 `team.json` 使用 `id` 作稳定标识、`title` 作显示名;旧顶层 `name` 只兼容输入,归一化、导入保存及打包导出均移除该字段。旧 name-only 转为 id;id/name 并存须同值,否则拒绝。旧表单 schema 的 name 约束与 required 迁到 id,不再生成 name 控件,title 保留。`PACKAGE.name` 和请求 `metadata.name` 继续表示显示名,对应 `team.title`;Agent 的 `profile.name`、成员 key 与身份 AID 保持既有语义。示例:`{"name":"demo","title":"演示团队",...}` 读入后为 `{"id":"demo","title":"演示团队",...}`,格式版本仍为 v1。
28
78
 
29
- inspect 输入示例:`{"members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}`。全组必须空闲,任一忙碌立即返回 AGENT_BUSY;成功后冻结任务启动与 Trigger,无确认操作 15 分钟自动释放,查询不续期。build 承接 inspectionJobId、inventoryDigest、metadata 和各成员 include;接管后由构建作业持有冻结直到结束,取消统一使用 jobId。
79
+ build 指整个制作过程,采集动作为 collect。制作流程:按模块 `inspect → collect → Agent直接阅读分析并修改工作副本 → pack → push`;Menu 页面可直接 collect → pack,不依赖中途调用 Agent。模块为 config/profile/soul/skill/trigger/event/service/project。头像随 profile 的 agent.md 原 URL 保留,welcome 并入 profile;soul 独立,不导出记忆正文。collect 成功只表示采集完成,不表示已经脱敏或封包。工作副本位于 `.template-work/<collectJobId>/`,member.json 是可编辑声明,files/ 是该成员可编辑文件;status 返回副本位置和清单,不在事件里传输正文。
80
+
81
+ inspect 示例:`{"module":"soul","members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}`,成功直接 succeeded,不持有采集冻结。collect 示例:`{"module":"soul","inspectionJobId":"job_<uuid>","inventoryDigest":"sha256:<摘要>","freeze":false,"members":{"writer":{"include":{"files":["01-identity.md"]}}}}`。freeze 可省略且默认 false;true 仅采集期间冻结,来源忙碌返回 AGENT_BUSY,失败或取消释放已取得的门,采集完成即释放。默认模式可在活跃会话自打包;显式冻结自己仍会忙碌。
30
82
 
31
- 2026-11-17 项目文件容忍:build 仍按原 `inventoryDigest` 和候选清单验证 `include.files`,但项目增删改不再使整次快照校验失败;删除选中项跳过,修改读取当前内容,新文件不会自动加入旧文件选择。某成员选择非空而最终无可打包项目文件时报 `PROJECT_FILES_EMPTY`;原本空选择正常。成功结果 `projectFiles[key]` 返回 selected/copied/skippedMissing 数量。路径、大小及内容安全校验、非项目资源严格快照和原失败清理/冻结释放继续保留。现有完整候选清单仍可能触发响应超限;第二阶段目录选择及选择索引协议尚未实现,见[Core/App集成开发文档](../../../docs/agent-template/project-file-selection-integration.md)。
83
+ config 的 include 为 `{baseagents:[默认基座]}`,采集和封包仅保留 active_baseagent 对应的 Provider/模型/推理强度配置,其他基座不进入新包;profile/project 的 include 为 `{}`;soul 为 `{files:[分册名...]}`;skill/trigger/event/service 分别为 `{skills:[...]}`、`{triggers:[...]}`、`{events:[...]}`、`{services:[...]}`。skill 只采集选中项的开关与资源,不自动附带内置或继承开关;pack 按最终 member.skills 筛选技能资源,preview 安装忽略旧包未声明的多余技能文件。无关字段拒绝。每次只读取本模块所选资源,未选资源变化不让整次制作失败。
32
84
 
33
- 完整选项用 `ec agent template --help` 查看。上传前由 App 以 Owner 身份授予来源 Host 目录读写权限,SDK 上传需读取元数据;普通私有下载使用 `storage.create_share_link.allowed_aids` 指定目标 Host,pull 的 source 带 location、分享短码和摘要。Owner/subaid 动态授权等待新 SDK;daemon 不代设权限,模板签名延期。
85
+ project 模块 inspect 不返回 resources.files;仅 project 的 collect 必填 selectionIndex 文件引用并拒绝 include.files。目录浏览复用原 file.list。整选目录递归包含新增,部分选择不纳入新增同层文件;删除跳过,修改读取当前内容,非空选择最终无文件报 PROJECT_FILES_EMPTY。索引绑定 inspectionJobId/inventoryDigest/projectRevision,引用含 location/download.shareId/digest/size;允许当前 Owner 或可信执行 Agent 的索引,分享须授权实际来源 Host 读取。统计仍返回 selected/copied/skippedMissing。
34
86
 
35
- preview 传 packageId、installMode 和成员 key → target/providers/externalAids。新建目标示例:`{"members":{"writer":{"target":{"aid":"auto"},"providers":{"ecagent":{"provider":"provider-12345678","model":"model-a"}}}}}`;aid=auto 时另传 issuer。新建可省略 target.project,由目标 Host 按默认项目根目录和最终 AID 分配不重名目录;显式 project 须为目标 Host 绝对路径。实际目录在 result.members[key].target.project 返回并持久保存,deploy/resume 不重新分配。覆盖仍须传目标当前默认项目目录。预览不注册身份;deploy 只引用可执行 previewId 和 planDigest。多成员必须全部新建,不提供已有成员配对。旧版 0.0.49 仍要求 project,以所选 Host 的 capabilities 输入 schema 为准,不能按开发机状态推定远端支持。参数错误保留具体字段及原因,不归类为模板不支持。
87
+ selectionIndex 引用为 `{location:{aid,path},download:{shareId},digest,size}`,path 为 Storage 绝对路径,size 是实际字节数,digest 为 `sha256:` 加 64 位小写十六进制。文件为 UTF-8 JSON:`{schemaVersion:1,inspectionJobId,inventoryDigest,members:{成员key:{projectRevision,entries:[{path,type}]}}}`;entries 的 path 为项目相对路径,type 为 file/directory。索引最多 8 MiB、每成员最多 20000 项;字段校验以 `capabilities` 的 `selectionIndexSchema` 为准。
36
88
 
37
- 异步命令默认 `--wait 0`,可设 0..300 秒,超时不取消作业。失败/取消退出码 1、参数错误 2、暂停或等待超时 3。先以原 requestId 或 jobId 查询,再恢复原作业,不用新部署请求重试未知结果。Menu 事件统一为 `template.job`,seq 单调递增;状态包括 queued/running/paused/failed/cancelling/cancelled/succeeded。
89
+ 脱敏由 Agent 阅读和编辑副本完成,没有 scan-report/review-scan、发现项决定或 artifact 管理命令。pack 输入示例:`{"metadata":{"id":"writer","name":"写作助理","version":"1.0.0","platforms":["linux"]},"members":{"writer":{"collections":[{"jobId":"job_<config>"},{"jobId":"job_<profile>"},{"jobId":"job_<soul>"}]}}}`。每个实际成员必须有 config/profile,其他模块可选;只能组合相同来源、相同成员 key 的成功 collect。pack 使用修改后的副本,重新计算摘要,不比对原采集摘要;验证模块路径边界、结构和依赖后持久保存封包快照,resume/replay 沿用该快照。push 仅接受最终 packageId/location,不再接受 releasedFindings。
90
+
91
+ 每次 inspect/collect/pack/push 各有独立 jobId:collect 引用 inspect 的 inspectionJobId;pack 的 members[key].collections 引用成功 collect 的 jobId;push 使用 pack 成功返回的 packageId。App 收到回执即保存 ID,通过 template.job/query 跟踪各模块状态、phase 和错误;选用模块未全部成功前不进入 pack,失败只重做相关模块。采集上报 loading_selection/validating_selection(project)、acquiring/releasing(可选冻结)、collecting、validating、collected;封包上报 assembling/validating/sealing/completed,不承诺百分比或快速阶段逐一送达。
92
+
93
+ pack 复用资源文本凭证检测,命中返回 SENSITIVE_CONTENT 及文件路径/行号,不返回正文。凭证、结构、大小、平台或完整性等校验错误 failed/resumable=false,修改副本或重采集后新 pack;未知执行故障仍可按原快照恢复。Owner Storage 原流程保持:App 使用 Owner SDK 授予 Host 目录 rw,push 指定 Owner AID,由 Host 按授权上传,再由 App 使用 Owner SDK 分享。
94
+
95
+ 托管 Agent 可将最终包 push 到自身 AID 的 Storage,由真实执行 Agent 连接上传;执行身份从委派上下文取得,不能自报 AID 借用他人连接。显式上传到 Owner 空间仍由 Host 上传并需要相应目录读写授权。私有分享使用 `ec storage share <当前AgentAID> --input-file FILE --format json`,JSON action=create/list/revoke/status,create 明确 allowedAids 为接收方实际 Host。pull 的 source 带 location、download.shareId 和 digest。模板签名仍未提供。
96
+
97
+ `publish PACKAGE_ID --store AID` 接收一个位置参数和仓库选项,不接受 `--input-file`;可选 `--request-id/--wait/--format json`。身份按可信执行入口自动确定;pack 顶层可选 `publisherIdentity=agent|host`,由 Core 写入相应 PACKAGE.publisher.aid,省略仍保留原操作者署名。publish 要求声明与真实 Caller 一致,不修改包字节。单 Agent metadata 仍明确填写,不在本功能内自动继承或接受空值。
98
+
99
+ publish 自动上传发布者自身 Storage、创建仅仓库可读的一小时授权、加密提交 `services.templates.publish` 并查询 status。仓库须准入实际发布者;succeeded 表示发行 ID、版本、摘要、大小及仓库位置已核实,结果含 serviceJobId/releaseId/location 和实际审核/升级状态。phase 为 validating/uploading/granting/submitting/waiting_registry/completed。未知结果 paused/resumable 后恢复原 jobId,保留原 operationId/source/仓库任务;提交仓库后禁止 cancel,提交前取消保留已上传对象和原期限授权。Menu 使用相同 action 与 `{packageId,storeAid}`,由真实 Host 调用;旧 Menu 参数与持久作业继续兼容。Owner Storage 原 push/分享流程保持。
100
+
101
+ `push.location.aid` 指定 Storage 所有者,不是分享接收方或模板仓库投稿目标。目标为非执行 Agent 自身的 AID 时,实际上传者是本机 Host;目标需对 Host 授予模板目录 `rw`,不能只给执行 Agent 授权。push 先权威读取已有对象再上传,拒绝时 error.details 标明 stage、uploaderAid、location 和可用的 upstreamCode。status 查到 failed 时退出码 1 表示原作业失败;权限修正后用新 requestId 和原 packageId 再 push,无需重做 collect/pack。
102
+
103
+ Agent 给接收方分享可沿“自身 push → storage share create 授权接收方 → 通用 fs setfacl 授权其直接 Host subaid → ecmsg 发送 v2 agent.template.share 卡片”。模板技能用通用 ACL JSON 表达 Ownership direct、card.type=[host]、perms=r,按 Storage 动态归属判权;无须枚举 Host。接收方短码放 recipient_download,Host 安装用条件 ACL 按 location/digest pull,不把接收方短码当作 Host 授权。两项都成功才发卡片,撤销也分别处理。Owner Storage 原流程及指定 Host 短码方式保留;卡片字段与发送命令见 agent-template-project 技能。
104
+
105
+ CLI preview 必填 `--path`、`--install-mode create|overwrite`,每成员用 `--member KEY --aid AID`。可重复 `--member`,其后的 `--aid`、`--project`、模型和冲突选项都归属当前成员;同成员同字段重复或成员选项出现在首个 `--member` 前会报错。模型选择用 `--provider 基座=ID --model 基座=MODEL`,可选 `--effort 基座=VALUE`;`--effort 基座=null` 清除显式强度。preview 根据 active_baseagent 匹配并校验对应 Provider/model,不使用 providers 首项;兼容旧包中存在的其他基座配置,不因其不可用阻断默认基座。外部映射用可重复的 `--external-aid 原AID=目标AID`。技能冲突用 `--skill-resolution 技能名=overwrite|skip`,随后必填本次技能的 `--current-digest sha256:... --incoming-digest sha256:...`;切换成员后须重新选择技能,不沿用前一个成员的选择。
106
+
107
+ 远程 Menu 传 path、installMode 和成员 key → target/providers/externalAids/skillResolutions。新建输入示例:`{"path":"/workspace/writer.ectpl","installMode":"create","defaultAidDomain":"agentid.cn","members":{"writer":{"target":{"aid":"auto"},"providers":{"ecagent":{"provider":"provider-12345678","model":"model-a"}}}}}`。历史 packageId 预览仍兼容。CLI 的 `--aid auto` 对应顶层 `--default-aid-domain`,不接受 `issuer`;模板 Host 配置的对应字段是 `host.config.aun.defaultAidDomain`。新建可省略 `--project`,由目标 Host 按默认项目根目录和最终 AID 分配不重名目录;显式目录须为目标 Host 绝对路径。实际目录在 result.members[key].target.project 返回并持久保存,deploy/resume 不重新分配。覆盖仅支持单个已有 AID,须传其当前默认项目目录,不允许 auto/defaultAidDomain。平台及 Provider/model/effort 不匹配仅提示,模型配置优先回退到本机可用值;缺少可用配置可继续安装,运行是否就绪以 readiness 为准。预览不注册身份;只有 executable=true 才能把同次 previewId 和非空 planDigest 交给 deploy,计划有效期 1 小时。预览保存源路径和摘要及冻结计划,不保存 source.ectpl 副本;应用前校验原包,丢失需重下相同文件,内容变化需重做预览。多成员必须全部新建,不提供已有成员配对。旧版 0.0.49 仍要求 project,以所选 Host 的 capabilities 输入 schema 为准,不能按开发机状态推定远端支持。参数错误保留具体字段及原因,不归类为模板不支持。
108
+
109
+ 异步命令默认 `--wait 0`,可设 0..300 秒,超时不取消作业。退出码 0 表示成功或未等待的已受理/进行中,不代表异步执行完成;失败/取消/通信或业务错误为 1、参数错误为 2、paused 或 `--wait>0` 返回时仍 queued/running/cancelling 为 3。作业型命令的 requestId 是请求关联与幂等键,同 ID 不可变更参数;jobId 是持久执行 ID。回执丢失先 `status --request-id ORIGINAL`,已知作业则 `status JOB_ID`;确认 resumable 后以 `resume JOB_ID` 恢复原作业,不用新部署请求重试未知结果。packageId 是封包句柄,previewId/planDigest 标识冻结安装计划,releaseId 是 64 位小写十六进制发行 ID;升级的 targetAid 是本机目标,update.key 则保留模板原始 Agent AID,两者不混用。Menu 事件统一为 `template.job`,seq 单调递增;状态包括 queued/running/paused/failed/cancelling/cancelled/succeeded。
110
+
111
+ 模板 Provider/模型/推理强度是建议值,显式选择优先。建议不可用时回退目标 Host 同基座的默认配置(覆盖优先目标 Agent 本地配置,升级保留可用的当前 Provider);默认强度也不可用则清除显式值,使用模型默认。预览的 `members[key].models` 返回 `suggested/selected/reasons`,`warnings` 解释替换原因。只有显式选择无效或本机仍缺可用配置才列入 `unresolved`。回退结果写入冻结计划,deploy 验证同一最终配置;配置改变须重新预览。
38
112
 
39
113
  成员注册和 Owner 绑定使用随包的 `scripts/aid-batch/identity-batch.mjs`,持久检查点保存原操作与收据;Owner 待确认时暂停,恢复不重复注册或绑定。全组准备并验证后才提交并开放任务;取消保留已创建身份。覆盖失败恢复本次实际写入的文件与名片,恢复未确认时保持目标暂停。
40
114
 
@@ -129,6 +203,9 @@ ec agent disable <aid>
129
203
  ec agent get <aid> <key>
130
204
  ec agent set <aid> <key> <val>
131
205
 
206
+ # 关闭激活欢迎(不影响设定引导)
207
+ ec agent set <aid> enableWelcome false
208
+
132
209
  # 读取或保存 Bootstrap 中 Agent 自主准备的 welcome 文案
133
210
  ec agent welcome show
134
211
  ec agent welcome --text '<完整 Markdown 文案>'
@@ -180,7 +257,7 @@ ec agent delete <aid> [--purge]
180
257
  - `ec agent welcome --text <text>` 用于保存 Bootstrap 中 Agent 自主准备的完整正式文案,不要求 Owner 起草、审稿或确认;命令固定写入当前 Agent 的 `$PERSONAL_DIR/welcome.md`,不接受自定义路径。`welcome show` 读取该文件。
181
258
  - welcome 托管写入要求当前 Agent 私聊 Owner;admin 仅可读。模板上限 4 KiB,渲染上限 8 KiB;变量为 `agentName`、`agentDescription`、`agentAid`、`agentTags`、`agentTagsText`、`ownerName`、`ownerAid`、`channel`,支持标签循环和真值条件。写入保留原始文本,投递不附加额外文案。
182
259
  - `agent show <target-aid>` 与 `agent get <target-aid> <key>` 的跨 Agent 读取对 owner/admin 开放,但普通 Agent 角色只获得安全摘要;敏感配置值和物理路径仅对 DaemonOwner 返回原值。跨 Agent 写入、启停、删除和 reload 仍遵循各自的目标与 DaemonOwner 权限边界。
183
- - Agent 配置可包含 `fullaccess.enabled`(默认关闭),作为全局开关;开启后对符合条件的私聊直接生效,局部 `/fa on|off` 不改变全局授权。Menu 写入全局开关要求请求者同时是目标 Agent Owner 与 daemon Owner。关闭全局开关时,私聊 `/fa on|off` 管理当前作用域:主会话写 relation 配置并跨 EC session/backend 续接保留,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。经 daemon 验证的 fullaccess 任务可进入原本由托管 CLI 顶层白名单拒绝的命令,并可通过受管文件入口访问 H-Class 路径;当前会话承载的 EvolCore 实例仍受生命周期保护。
260
+ - Agent 配置可包含 `fullaccess.enabled`(默认关闭),作为全局开关;开启后对符合条件的私聊直接生效,局部 `/fa on|off` 不改变全局授权。Menu 写入全局开关要求请求者同时是目标 Agent Owner 与 daemon Owner。关闭全局开关时,私聊 `/fa on|off` 管理当前作用域:主会话写 relation 配置并跨 EC session/backend 续接保留,话题会话写自身 session metadata;`/fa <任务信息>` 或 `/fullaccess <任务信息>` 则由 daemon Owner 发起一次性 fullaccess 任务,不改变会话开关。群聊不支持。实际运行时逐次复核相应 Owner 授权、会话绑定和 Runner fullaccess 能力;Trigger 不会因该开关自动提权。(这里指已存在的 Trigger 不会被自动升级;**该开关提供的是创建/修改 fullaccess Trigger 的资格**,在有效期内设置的 Trigger 会记录批准人,关闭开关后仍按批准链运行。详见 trigger.md「提权到 fullaccess」。)经 daemon 验证的 fullaccess 任务可进入原本由托管 CLI 顶层白名单拒绝的命令,并可通过受管文件入口访问 H-Class 路径;当前会话承载的 EvolCore 实例仍受生命周期保护。
184
261
 
185
262
  ## 创建 Agent
186
263
 
@@ -206,9 +283,19 @@ EC Web 有两个独立入口:`action: create` 沿用 Bootstrap 流程(与 `-
206
283
 
207
284
  ## Bootstrap 通知状态与重试
208
285
 
286
+ 设定引导与激活欢迎是两个阶段:
287
+
288
+ - 设定引导使用随包模板 `kits/templates/bootstrap-intro.md`,用于询问职责、名字等。
289
+ - 激活欢迎在设定完成后发送,正文使用 `personal/welcome.md` 或 `--initialize` 的内置文案。
290
+ Agent 配置 `enableWelcome` 控制是否发送,默认 `true`;设为 `false` 不影响设定引导。
291
+ - 模板仅在 `create` 新建安装整体提交后逐成员投递激活欢迎;覆盖安装和升级不投递。原作业的 `result.welcome` 返回各成员处理结果;欢迎投递失败不影响已提交的安装,待发消息沿用持久 outbox,准备失败可通过原作业 `status` 恢复。
292
+ - 旧字段 `bootstrapWelcome` 在读取时兼容为 `enableWelcome`,下次保存时只写新字段;
293
+ 显式布尔值保持不变,未配置时不补写默认值。新旧字段同时存在且值冲突时拒绝读取或保存。
294
+ 该开关不控制 IM 首次交互欢迎或好友申请通过后的欢迎。
295
+
209
296
  交互式 Bootstrap 的 `ready` 要求有效的 `personal/welcome.md`:缺失返回 `WELCOME_REQUIRED`,损坏返回 `WELCOME_INVALID`,均保持 Bootstrap 状态。已准备 completion outbox 后修改文案返回 `WELCOME_FROZEN`。
210
297
 
211
- `--initialize` 模式不产生也不需要 `welcome.md`:它的欢迎文案由 daemon 用内置模板按最终名片渲染,`ec agent welcome --text` 在这种目标上会返回 `INVALID_LIFECYCLE`。
298
+ `--initialize` 模式不产生也不需要 `welcome.md`:它的欢迎文案由 daemon 用内置模板按最终名片渲染,取名片 frontmatter 的 `name` 作为身份、`description` 作为职责,不写死能力清单;`ec agent welcome --text` 在这种目标上会返回 `INVALID_LIFECYCLE`。同一份默认模板也用于 IM 渠道的首次交互欢迎。
212
299
 
213
300
  `ready` 成功表示 Agent 已进入 `active`;欢迎消息单独返回在 `welcome.deliveries`,每位 Owner 一项:
214
301
 
@@ -43,7 +43,7 @@ ec aid transfer <subAid> <newOwnerAid> --subject <当前OwnerAID> [--format json
43
43
  ec aid bind accept <operationId> [--subject <本地AID>] [--format json]
44
44
  ec aid bind reject <operationId> [--reason '<原因>'] [--subject <本地AID>] [--format json]
45
45
  ec aid agentmd put <当前 self AID> [--format json]
46
- ec aid agentmd set <当前 self AID> <name|type|description|version|tags|exttype> <value> [--format json]
46
+ ec aid agentmd set <当前 self AID> <name|type|description|version|tags|exttype|visibility> <value> [--format json]
47
47
  ec aid avatar <当前 self AID> (--file <path> | --url <https-url>) [--format json]
48
48
  ```
49
49
 
@@ -184,7 +184,21 @@ Agent 展示通过 `knownOwner/knownOwners` 读取关系快照,详情另返回
184
184
 
185
185
  托管会话中的本地图片必须位于当前会话项目目录或本会话的托管 `$TMPDIR`;相对路径以会话项目目录为基准。不能读取受保护的 EvolCore 路径、符号链接,或托管临时目录中的硬链接。
186
186
 
187
- 当前对端在 AUN 里发来的图片不在消息正文中,而是落盘到 `$EVOLCORE_HOME/agents/<selfAid>/relations/aun#<对端AID>/attachments/`,每张图旁边有同名 `.json`(含 `createdAt`、`sha256`、`mimeType`)。要拿某张图当头像,先按 `createdAt` 定位文件并复制到当前项目目录或本会话 `$TMPDIR`,再把复制后的路径传给 `--file`;`--file` 只接受这两处路径。非正方形或超过 500 KiB 的图片会自动补白边、缩放并压缩成 JPEG。
187
+ 当前对端发来的图片和文件落盘在 agent 级附件目录,按月分目录:
188
+
189
+ ```
190
+ $AGENT_DIR/attachments/<YYYY-MM>/<原始文件名>
191
+ $AGENT_DIR/attachments/index/<peerKey>.jsonl ← 归属索引(谁是发送方、何时、sha256)
192
+ $AGENT_DIR/attachments/index/sha256/<前2位>.jsonl ← 内容反查索引
193
+ ```
194
+
195
+ - 一个月一个目录,本月收发的本体都在当月目录下。
196
+ - 同名不同内容会在同月目录里加 `-1`、`-2` 编号;不同名但内容相同的文件复用同一份本体。
197
+ - 归属信息在 `index/<peerKey>.jsonl`,**不再有同名 `.json` sidecar 文件**。要确认某张图是谁发的、什么时候发的,按文件名去对应的 peerKey 索引里查。
198
+
199
+ 要拿某张图当头像,先把文件复制到当前项目目录或本会话 `$TMPDIR`,再把复制后的路径传给 `--file`;`--file` 只接受这两处路径。非正方形或超过 500 KiB 的图片会自动补白边、缩放并压缩成 JPEG。
200
+
201
+ 历史消息里的路径是 `$AGENT_DIR/…` 别名,使用前先按 `[venue]` 段的 AGENT_DIR 值展开。
188
202
 
189
203
  上传复用 menu 的头像处理流程:校验图片、上传到 AUN storage、更新并发布 `agent.md` 的 `avatar` 字段,成功后发出 `agent:avatar_updated` 事件。无需手动修改名片或再次执行 `agentmd put`。托管 Agent 只能修改自身头像,仍需通过角色与命令授权检查。
190
204
 
@@ -209,7 +223,7 @@ ec aid lookup <aid>
209
223
  # agent.md 名片:签名上传 / 下载验签
210
224
  ec aid agentmd put <aid>
211
225
  ec aid agentmd get <aid>
212
- ec aid agentmd set <aid> <name|type|description|version|tags|exttype> <value>
226
+ ec aid agentmd set <aid> <name|type|description|version|tags|exttype|visibility> <value>
213
227
  ec aid avatar <aid> (--file <path> | --url <https-url>)
214
228
  ec aid bind <ownerAid> [--subject <subjectAid>] [--local-control]
215
229
  ec aid transfer <subAid> <newOwnerAid> --subject <currentOwnerAid> [--local-control]
@@ -223,6 +237,8 @@ ec aid delete <aid>
223
237
 
224
238
  ## 证书续期
225
239
 
240
+ `ec aid agentmd set <aid> visibility private` 会更新并签名发布名片的可见性字段。该字段接受 `public`、`unlisted` 或 `private`。
241
+
226
242
  在独立宿主终端执行 `ec aid cert renew <aid>`,复用 SDK 的 `AIDStore.renewCert()`,
227
243
  使用原私钥完成挑战签名,再将服务端签发的新证书保存到 `AIDs/<aid>/public/cert.pem`。
228
244
  不会生成新密钥、重新注册 AID、修改 Owner 或发布 `agent.md`。托管 Agent 会话不能执行;
@@ -192,6 +192,96 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
192
192
  - Agent 和 defaults 均未设置模型时,Claude/Codex 回落到本机 CLI 配置;再缺省时使用 runner 的内置默认模型。推理强度按同一层级逐字段回落。
193
193
  - 只有当前 Agent 的 owner / admin(或 DaemonOwner)可以写模型参数。
194
194
 
195
+ ### Agent 自动压缩阈值(Claude Code / Codex / DSH)
196
+
197
+ 每个 Agent 在自己的 `config.json` 配置 `baseagents.<baseagent>.autoCompactThresholdTokens`,
198
+ 单位 tokens,必须是正的安全整数。该字段只读
199
+ Agent 文件,不从 defaults 或 relation 继承,也没有 schema 默认值。
200
+
201
+ ```json
202
+ {
203
+ "baseagents": {
204
+ "claude": { "autoCompactThresholdTokens": 550000 },
205
+ "codex": { "autoCompactThresholdTokens": 1000000 }
206
+ }
207
+ }
208
+ ```
209
+
210
+ 字段不存在时,Claude 保留旧 `--autocompact` 参数及任务开始前的检查。Codex
211
+ 按真实 Provider 窗口传入模型容量,并用 258400 作为压缩窗口。设置的 `autoCompactThresholdTokens`
212
+ 只控制压缩窗口,不改变模型的真实上下文容量。
213
+ 删除字段后,Claude 后续任务重新走原生策略;Codex 后续 turn 使用代码默认压缩阈值 258400。
214
+ 读取新字段不会创建或自动补写配置。
215
+
216
+ 显式配置后,窗口优先使用当前 Provider 对当前模型返回的 `context_window`;缺失或无效时
217
+ Codex 采用 258400,Claude 使用原 runner 的保守窗口兜底。其他 Provider 的价格参考目录不参与
218
+ 窗口解析。Codex 在线程配置中同时下发真实的 `model_context_window` 与独立的
219
+ `model_auto_compact_token_limit`,
220
+ 涵盖新建、恢复、分叉和压缩前恢复,不修改 `~/.codex/config.toml`。容量按网关声明下发,不用
221
+ 本地模型表的较小值覆盖;运行时实际报告的窗口仍单独保留,原生预留可能使它小于下发值。
222
+
223
+ Claude 原生参数表示压缩窗口,并非精确触发点。当前适配按 Claude Code 2.1.300 的
224
+ `min(max_output_tokens, 20000) + 13000` 预留换算,受原生参数 100K–1M 和显式模型窗口后缀限制。
225
+ 例如最大输出不少于 20K 时,配置 550000 会下发 583000;百万模型可表达的最高触发估计为
226
+ 967000。工具结果、原生估算及 CLI 版本可能影响实际时点,不能作为严格请求 token 上限。
227
+ 显式配置会覆盖自动压缩窗口和百分比的环境变量覆盖;未配置时保留这些原生行为。
228
+ 配置超过能力范围会记录 `adjusted` 和实际采用值;正在执行的任务不被中途修改。
229
+
230
+ DSH 在恢复会话并取得写入权后、接收本轮输入前检查原生上下文用量,达到阈值便调用原生压缩。
231
+ 默认采用 EvolCore 的预压缩阈值,已知窗口时为 `min(550000, 窗口 - 预留)`,预留为窗口的 5%,最多 10000。
232
+ 执行时阈值受当前模型的实际窗口约束。DSH 原生会在运行中的模型步骤之间继续处理上下文压力及超限恢复,
233
+ 有可能先于上述阈值触发。
234
+
235
+ Owner 通过原生 Agent 级 Menu 读写配置,由服务端直接调用配置管理代码,不执行 CLI。
236
+ 先查询(也支持 `menu.query` 的 queries 批量和 catalog values 批量):
237
+
238
+ ```json
239
+ {
240
+ "type": "menu.query",
241
+ "id": "context-codex",
242
+ "name": "context-policy",
243
+ "args": { "scope": "agent", "baseagent": "codex" }
244
+ }
245
+ ```
246
+
247
+ 再把响应 `data.revision` 原样传入更新请求。`value` 是 tokens 整数,不是字符串;
248
+ `baseagent` 在写入时必填,可选择 `claude`、`codex` 或 `dsh`:
249
+
250
+ ```json
251
+ {
252
+ "type": "menu.update",
253
+ "id": "context-codex-set",
254
+ "name": "context-policy",
255
+ "args": {
256
+ "scope": "agent",
257
+ "baseagent": "codex",
258
+ "expectedRevision": "<查询返回的 revision>"
259
+ },
260
+ "value": 1000000
261
+ }
262
+ ```
263
+
264
+ 恢复默认时使用同一更新协议,将 `value` 设为 `null`,并使用最新的 `revision`。
265
+ 服务端会删除该字段,返回重新计算的代码默认值;不会把默认值写回配置。
266
+ 更新只修改目标 Agent 对应后端的阈值,保留其他配置;旧 revision 或查询期间模型切换返回
267
+ `CONFLICT`,调用方需重新查询。成功返回完整策略、新 `revision`、`changed` 和
268
+ `effectiveFrom: "next-turn"`。超出能力范围的正整数仍保存原值,并返回 `adjusted` 与实际采用值。
269
+
270
+ Menu catalog 提供 `contextPolicy.claude`、`contextPolicy.codex` 和 `contextPolicy.dsh`。缺少文件配置时仍返回
271
+ `autoCompactThresholdTokens` 的代码默认值及 `thresholdSource: "code-default"`,不返回空阈值;
272
+ Codex 未配置时默认展示 258400;这是压缩窗口,不是模型上下文窗口。
273
+ `mode: "legacy"` 表示 Agent 没有显式压缩阈值;Codex 仍会向线程下发真实模型窗口和 258400 默认压缩阈值。
274
+ 同时返回 `gatewayContextWindowTokens`、`contextWindowTokens`、`executionContextWindowTokens`、`contextWindowSource`、
275
+ `minConfigurableThresholdTokens`、`maxConfigurableThresholdTokens`、配置原值、实际采用阈值及原生参数。
276
+ 网关字段缺失返回 null,兜底窗口单列。CC 还返回 `estimatedNativeTriggerTokens`,区分旧窗口参数
277
+ 与原生触发估计。Codex 同时查询当前 Agent、模型、Provider 匹配的最近一次 turn 记录:
278
+ `runtimeAutoCompactTokens` 是运行记录里的 Codex 压缩阈值(旧记录缺少该字段时使用历史默认值),`runtimeAutoCompactRecordedAt` 是记录时间(Unix 毫秒),
279
+ `runtimeStatus: "last-model-call"` 表示历史记录,并非当前实时探测。该记录只作运行诊断,不覆盖网关返回的真实模型上下文窗口,
280
+ 也不把压缩窗口误当模型容量;无匹配记录时诊断字段返回 null,
281
+ 状态为 `not-observed-by-this-query`。历史运行窗口不限制显式配置时的网关容量,保存配置也不会
282
+ 把新容量伪装成已运行的窗口;恢复默认时不复用带显式阈值的历史运行记录。
283
+ 该 Menu 仅允许当前 Agent Owner 读写,不支持跨 Agent 自指、options 或 action。
284
+
195
285
  ### Codex 用户提问
196
286
 
197
287
  `baseagents.codex.enableRequestUserInput` 走 defaults → agent 覆盖,默认 `true`;relation 层不承载 `baseagents`。
@@ -307,6 +397,10 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
307
397
  - **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。经 daemon 验证的 fullaccess 任务可绕过托管 CLI 顶层白名单和 H-Class 文件入口限制,但当前会话承载的 EvolCore 生命周期保护、参数校验和文件完整性校验仍生效。
308
398
  - **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
309
399
  - **基座 skill 总开关**:`baseagentSkills` 默认关闭,设为 `true` 统一开放;仅 Agent 级、仅 owner 可写(`ec config set`,Menu 协议经 `name=cli action=exec` 传同一 argv,ECWeb 编辑 Agent 抽屉),对所有基座统一生效(Claude 的 Skill 工具、Codex 的 skills);关闭时 `/capability` 的 skill 策略不可修改。它不影响 EC 技能,EC 技能用 `ec skill enable/disable` 管理
400
+ `/capability` 查询同时返回 `baseagentSkillsEnabled`,各类型的 `support` 为 `supported / unsupported / unavailable`,
401
+ 表示基座原生扩展管理的支持状态;`supportReason` 保留该层原因,`canUpdate` 表示当前开关条件下能否修改策略。
402
+ ECWeb 将关闭的 Skill 显示为“已关闭”;开启后继续依据基座支持状态显示“可配置”“不支持配置”或“未接入管理”。
403
+ “可配置”指设置继承、全部启用/关闭及单项启用策略,不表示升级版本。未保存的开关修改只展示预览。
310
404
  - **仅人可写**:channels / admins / 凭证 / aid / enabled / projects / aun
311
405
  - Agent 托管环境写仅人字段被拒
312
406
 
@@ -26,7 +26,8 @@ H 类拒绝保留 `policyCode=h_class_protection`、`executed=false` 和原始
26
26
 
27
27
  - `/loop`:查看持久开关及待执行的单次提示词;回显为单行,不显示会话 ID。
28
28
  - `/loop on [seconds]`:开启持久闲置触发,默认 300 秒,可设 30–86400 秒;每次普通任务结束后重新计时。
29
- - `/loop <提示词>`:当前会话连续闲置 300 秒后执行提示词一次,不立即提交模型,也不修改持久开关。
29
+ - 空闲时,`/loop <提示词>` 先提交提示词,入队成功后执行 `/loop on`。任务结束后按默认 300 秒开始计算闲置时间。
30
+ - 忙碌时,`/loop <提示词>` 安排在会话连续闲置 300 秒后执行该提示词一次。
30
31
  - 新的单次提示词替换上一条待执行提示词;已有任务运行或新任务到达时,从任务结束后重新计时。
31
32
  - `/loop off`:关闭持久触发并取消尚未入队的单次提示词;已经开始的任务不受影响。
32
33
  - 持久开关按主会话 `relation-main` / 独立话题 `topic-session` 存储;单次请求始终只绑定发起时的确切会话。
@@ -163,22 +163,19 @@ $AGENT_DIR/skills/.index-local.md 本机技能索引
163
163
 
164
164
  ---
165
165
 
166
- ## 5. 路径:模型自己拼绝对路径
166
+ ## 5. 路径:技能目录写成 `{{skillDir}}`
167
167
 
168
168
  EC **不会把 cwd 设到技能目录**(runner 拉起 base agent 时 cwd 固定为项目目录,且 Claude Code 的
169
- Bash 工具没有 cwd 参数),所以三家的「裸相对路径直接可用」在 EC 复现不了。
169
+ Bash 工具没有 cwd 参数),所以正文里的脚本路径必须是绝对路径。
170
170
 
171
- EC 的解法:**索引里给根目录 + 拼路径规则,模型自己拼成绝对路径**。
171
+ 技能目录要引用的地方,一律写成 `{{skillDir}}`,`ec skill load` 输出时替换成本机技能目录的
172
+ 绝对路径(统一正斜杠;旧写法 `<技能目录>` 同样处理):
172
173
 
173
- ```
174
- 路径规则:
175
- 根目录: <该组的真实绝对路径>
176
- 技能目录 = 根目录 + 路径分隔符 + 技能名
177
- SKILL.md = 技能目录 + 路径分隔符 + "SKILL.md"
178
- 执行脚本时必须写完整绝对路径。
174
+ ```bash
175
+ node "{{skillDir}}/scripts/foo.mjs"
179
176
  ```
180
177
 
181
- 好处是**社区技能不用改**——正文里照写裸相对路径,模型知道技能目录在哪,自己就能拼。
178
+ 正文因此不含任何本机路径,换机器、换安装位置都不用改。
182
179
 
183
180
  配套硬要求:**脚本内部必须用自身位置定位资源,不能依赖 cwd**。
184
181
 
@@ -2,7 +2,11 @@
2
2
 
3
3
  ## 源码归属
4
4
 
5
- 宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils/`;独立 Web 服务自身代码留在 `ecweb/src/`。
5
+ 宿主侧 ECWeb 集成集中在 `src/ecweb/`:`runtime/supervisor.ts` 负责守护与恢复调度,`runtime/lifecycle.ts` 负责退出确认和重启就绪校验,`runtime/launch.ts` 负责启动入口及版本兼容检查,`pairing.ts` 负责配对 IPC、访问链接和提示文案。通用跨平台进程工具仍留在 `src/utils/`。
6
+
7
+ 仓库根目录的 `ecweb/` 是独立 npm 包 `ec-web`,包含 HTTP 服务、静态页面和 IPC 客户端,拥有独立的依赖和构建配置。EvolCore 依赖该包,仓库的 `npm run build` 会分别构建宿主与 Web 包。
8
+
9
+ `src/ecweb/contracts/` 存放宿主侧的实例登记和握手契约。`ecweb/src/` 声明客户端的最低协议要求,并校验宿主的握手响应。两端通过协议兼容,Web 包无需导入宿主源码。
6
10
 
7
11
  新建 ECWeb 代理默认使用 `visibility: public`,初始化与设置页面保持一致。显式配置的 `private`、`aun-auth` 以及关闭设置均保留;迁移旧版配置时继续保留原有访问策略。此字段用于 AUN 代理注册,ECWeb 的配对与 token 鉴权独立生效。
8
12
 
@@ -1,7 +1,7 @@
1
1
  # Trigger Event Catalog
2
2
 
3
3
  本目录用于编写 `source.type = "event"` 的 trigger 时按需查阅。最终事实源是
4
- `$PACKAGE_ROOT/src/core/event-bus.ts` 的 `GatewayEvent` 类型;本文只做面向 trigger
4
+ `$PACKAGE_ROOT/src/core/event/event-bus.ts` 的 `GatewayEvent` 类型;本文只做面向 trigger
5
5
  作者的事件索引和使用约定。
6
6
 
7
7
  ## Event Source 规则
@@ -10,6 +10,8 @@
10
10
 
11
11
  无 `:` 的路径是本地路径。操作者身份用 `--as <aid>`,agent 会话内通常由 `EVOLCORE_SELF_AID` 注入,可省略。
12
12
 
13
+ 托管会话同样支持 `cp` 上传、单文件下载和同目标远程复制。下载目标限当前项目或当前会话 `$TMPDIR`,相对路径按会话项目解析;传入已有目录时使用远端路径的文件名。默认不覆盖,显式 `--overwrite` 才覆盖普通文件;拒绝越界路径、符号链接文件和硬链接文件。下载会重新读取并校验 SHA-256,无需先生成下载链接。个人空间仍限当前 Agent(当前私聊对端仅可 `cat`),群空间仍限当前群,远端权限不变。
14
+
13
15
  ## 已实现命令
14
16
 
15
17
  ```bash
@@ -55,11 +57,11 @@ ec fs umount <AID>:<path> # 卸载挂载点
55
57
  - `--head-bytes <n>`:`cat` 二进制头部字节数,默认 256
56
58
  - `--visibility public|private`:`chmod` 可见性
57
59
  - `--allow-roles <roles>`:`chmod` 角色约束,写法固定为单引号包住、逗号分隔,如 `--allow-roles 'owner,admin'`
58
- - `-m aid:<aid>:<perms>` / `-x aid:<aid>`:`setfacl` 增删 ACL
60
+ - `-m aid:<aid>:<perms>` / `-x aid:<aid>`:`setfacl` 增删单个 AID 的 ACL;也支持下述通用 ACL JSON
59
61
  - `--source <AID>:<path>` / `--volume <id>`:`mount` 来源
60
62
  - `--expires <time>`:`mount/token/ACL` 过期时间,Unix 秒或 ISO 日期
61
63
  - `--require-approval`:挂载需要来源 owner 审批
62
- - `--max-uses <n>`:ACL 最大使用次数
64
+ - `--max-uses <n>`:ACL 最大使用次数,0表示不限;ACL 的 `--expires 0` 表示不过期
63
65
  - `--max-reads <n>`:访问 token 最大读取次数
64
66
  - `--readonly` / `--readwrite`:挂载为只读或读写
65
67
  - `--name <glob>` / `--type <f|d|l>`:`find` 名称或类型过滤
@@ -90,6 +92,50 @@ ec fs ls g-team.agentid.pub:/archive/
90
92
  ec fs cp ./weekly.md g-team.agentid.pub:/archive/weekly.md
91
93
  ```
92
94
 
95
+ ## 通用 ACL
96
+
97
+ 个人空间的 `setfacl -m` 接受与 Storage RPC 同形的 JSON;`-x` 接受相同主体选择器。
98
+ 本地 CLI 与托管 Agent 共用解析和执行逻辑,原 `aid:<aid>[:<perms>]` 写法保留。
99
+
100
+ | 字段 | 说明 |
101
+ |---|---|
102
+ | `grantee_aid` | 单个指定 AID |
103
+ | `grantee_aids` | 非空 AID 数组,去重并保留首次顺序 |
104
+ | `subject` | 条件主体;与上面两项必须且只能选一种 |
105
+ | `subject.ownership.owner_aid` | 按该 Owner 当前声明匹配 sub;Owner 本身不属于 sub |
106
+ | `subject.ownership.scope` | `direct`(默认)或 `descendants` |
107
+ | `subject.card.type` / `exttype` | 可选的非空字符串数组;同属性内 OR,属性之间及 Ownership 与名片之间 AND |
108
+ | `perms` | 设置时必填,`r/w/x` 可组合;删除时不能传 |
109
+ | `expires_at` | Unix 秒,0不过期;也可用 `--expires <Unix秒或ISO日期>` |
110
+ | `max_uses` | 非负整数,0不限;也可用 `--max-uses`。条件规则共享计数,具体 AID 分别计数 |
111
+
112
+ JSON 与命令行不能重复指定同一有效期或次数字段;删除不接受权限、有效期或次数。
113
+ 省略限制字段沿用 Storage 的默认及更新语义,需要清除旧限制时显式传0。
114
+ 目标所有者和路径始终来自 `<AID>:<path>`,JSON 不接受 owner_aid/path/bucket 等路由字段。
115
+
116
+ ```bash
117
+ # 批量授权
118
+ ec fs setfacl sender.agentid.cn:/reports -m '{"grantee_aids":["reader.agentid.cn","worker.agentid.cn"],"perms":"rw","expires_at":0,"max_uses":0}' --format json
119
+
120
+ # 条件授权:接收方名下的直接 Host subaid 可读取此模板文件
121
+ ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -m '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}},"perms":"r","expires_at":0,"max_uses":0}' --format json
122
+
123
+ # 查询、撤销同一条件规则
124
+ ec fs getfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl --format json
125
+ ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -x '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}}}' --format json
126
+ ```
127
+
128
+ 设置与删除分别调用 `storage.set_acl/remove_acl`,查询沿用 `storage.list_acl`。
129
+ Storage 动态核验 Owner 声明及可信名片,客户端不能自报名片属性。路径是前缀授权,作用于该路径及子路径;
130
+ 模板分享选完整包文件路径,其他场景可选目录。普通私有对象的指定 AID 下载分享继续使用 `ec storage share create`,
131
+ 不要把具体 AID ACL 的 authoritative 读取权限与分享短码下载混为一谈。
132
+
133
+ 仅在回执的目标、路径、主体及已指定的权限/限制匹配后返回成功,批量操作必须有完整且不重复的逐项回执。
134
+ `ACL_RESULT_UNKNOWN` 或通信中断不表示写入未发生,先 `getfacl` 核实再决定下一步,CLI 不自动重试写入;
135
+ 批量存储异常可能已完成部分项目。删除回执中的 removed=false 表示对应规则原本不存在。
136
+ 托管 Agent 只可用当前任务身份管理自身个人空间;授权内容进入权限判断和审计,不能用 `--as` 切换身份。
137
+ 群空间继续使用 `-m role:member:rw`、`-m role:admin:<perms>` 或 `-x role:<role>`,不接受个人空间 JSON 和限制字段。
138
+
93
139
  ## 路由规则
94
140
 
95
141
  CLI 读取目标 AID 的 `agent.md`:
@@ -137,7 +183,7 @@ ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authori
137
183
 
138
184
  - `ln -s` 只在 personal storage 创建软链;group fs facade 暂无 symlink 接口。
139
185
  - `chmod` 只映射到 personal storage 的 `setVisibility`;group fs facade 暂无 chmod/setVisibility 接口。
140
- - `setfacl/getfacl/token/approve/reject` 只接 personal storage;group fs facade 暂无对应接口。
186
+ - `setfacl/getfacl` 同时支持个人空间和群空间;群空间使用既有角色 ACL。`token/approve/reject` 仅接 personal storage。
141
187
  - personal storage 的 `mv` 仅支持同 owner;跨 owner 请先 `cp` 再 `rm`。
142
188
  - personal/group 混合远程 `cp/mv` 不支持;请先下载到本地再上传。
143
189