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
@@ -1,8 +1,8 @@
1
- # ec group — 群聊消息与群管理
1
+ # ec group — 群管理与群消息查询
2
2
 
3
- 群聊场景下收发消息、管理群与成员。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
3
+ 群聊场景下的群管理、成员管理、群消息拉取与本地群历史查询命令集(发消息见下行)。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
4
4
 
5
- **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`;宿主终端用 `--from <本端AID>`)。本页其余 `ec group` 命令只用于群管理,不用于发消息。
5
+ **发消息统一用 `ecmsg send`**(本端恒为当前会话本端;当前群会话直接发,跨群用 `--thread main:<本端AID>:<群AID>`)。本页其余 `ec group` 命令用于群管理、群消息拉取与本地历史查询,不用于发消息。
6
6
 
7
7
  本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
8
8
 
@@ -232,7 +232,7 @@ daemon 按整理会话的模式校验 `--scope`:
232
232
 
233
233
  - 逐一读取所有 consolidated 文件查重。先查 `MEMORY.md` 索引,只在发现高度相似的描述时才读那一条确认。
234
234
 
235
- 实现:`src/core/system-session/memory.ts`,由 response-engine 在 `sessionType=memory` 的会话上挂为最终判定(`systemSessionCheck`);同一份声明(`grants()`:可读根 + 唯一可写文件)同时交给 runner 的沙箱 / 工具执行器,Claude / Codex / ecagent 三个 runner 共用,与角色体系无关。整理 trigger 不带 `permissionMode`,不会进入 fullaccess,策略不会被跳过。
235
+ 实现:`src/core/session/system/memory.ts`,由 response-engine 在 `sessionType=memory` 的会话上挂为最终判定(`systemSessionCheck`);同一份声明(`grants()`:可读根 + 唯一可写文件)同时交给 runner 的沙箱 / 工具执行器,Claude / Codex / ecagent 三个 runner 共用,与角色体系无关。整理 trigger 不带 `permissionMode`,不会进入 fullaccess,策略不会被跳过。
236
236
 
237
237
  ---
238
238
 
@@ -33,6 +33,12 @@ Agent Catalog 的 `privateMentionMode.agent` 同时支持 `view="values"` 批量
33
33
  修改传 `value` 和 `args.expectedRevision`,仅 Agent Owner 可写,版本过期返回 `CONFLICT`。
34
34
  配置仅作用于 Agent 级;不用 CLI,也不复用群聊的 `name="group"`。
35
35
 
36
+ Agent 渠道开关使用 `menu.action name="agent" action="update"`,
37
+ 参数为 `args={aid,patch:{channelStates:[{type:"feishu",name:"work",enabled:false}]}}`。
38
+ 按 `type/name` 唯一匹配现有非 AUN 渠道,只更新布尔 `enabled`,保留凭据及其它配置。
39
+ 可与 `channelOwners` 一起提交,不可与替换整个数组的 `channels` 同时提交。
40
+ 返回 `data.saved=true`、`data.requiresReload=true`;保存本身不重载 Agent。
41
+
36
42
  ---
37
43
 
38
44
  ## 一、传输层约定
@@ -242,6 +248,22 @@ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处
242
248
 
243
249
  `args.argv`(数组,推荐)优先于 `args.command`(字符串,daemon 侧分词)。
244
250
 
251
+ #### 在本机终端打开 Base Agent 会话
252
+
253
+ `name="session"`、`action="open-terminal"` 接收 Base Agent 自己的 session ID(不是 EvolCore session ID),并在处理请求的 Agent 主机上打开对应 CLI 会话:Claude Code 使用 `claude --resume <sessionId>`,Codex 使用 `codex resume <sessionId>`。后端类型由当前 Agent 配置决定;调用方不能指定 baseagent 或工作目录。工作目录取当前可信 Menu 会话的项目路径,并要求该 session ID 绑定到同一项目且历史文件仍存在。仅限当前 Agent Owner 的 AUN 私聊,不支持 Control AID 或群聊。
254
+
255
+ Codex 使用 EvolCore Provider 注册表时,终端恢复会重建当前 Agent Provider 对应的 `evolcore_registry_…` 配置,携带该连接的 endpoint、headers 和 query 参数;使用 `--no-daemon` 防止复用缺少 Provider 配置的后台进程。凭据通过当前 `$TMPDIR` 内权限受限的临时启动脚本写入子进程环境,不进入终端命令行或 shell history。脚本在执行时删除,启动失败或五分钟未执行时也会清理;不会写入用户的 `~/.codex/config.toml`。
256
+
257
+ ```json
258
+ {
259
+ "type": "menu.action",
260
+ "id": "session-open-1",
261
+ "name": "session",
262
+ "action": "open-terminal",
263
+ "args": { "sessionId": "<base-agent-session-id>" }
264
+ }
265
+ ```
266
+
245
267
  常用 `name` + `action` 组合:
246
268
 
247
269
  | name | action | operation | 说明 |
@@ -264,9 +286,9 @@ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处
264
286
 
265
287
  ### Agent 模板与指定 Provider 模型目录
266
288
 
267
- 主机 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 事件格式保持兼容。
289
+ 主机 Control AID 上使用进程级 `name=template`,制作动作为 `inspect/collect/pack/push`,安装沿用 `pull/preview/deploy`。操作者须为 DaemonOwner,来源采集和覆盖还要求对应 Agent 当前协议 Owner。inspect/collect 必填 module,各自返回独立 jobId;pack 通过 members[key].collections 引用成功的 collect 作业,成功后返回 packageId。build 指整个制作过程,不再是采集动作名。进度事件统一为 `menu.event event=template.job`,携带 jobId/status/phase/seq/error;查询为 `menu.query name=template args={view:'job',jobId}`,也可用原 requestId 查询,二者互斥。collect 默认不冻结,Menu 可直接 collect → pack,不依赖 Agent 修改副本;pack 凭证检测命中直接失败,没有扫描审核接口。Owner Storage 原上传授权与 SDK 分享保持,Agent 自身 Storage 仅是新增路径。
268
290
 
269
- 指定连接的模型查询使用 `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`。
291
+ 指定连接的模型查询使用 `menu.query name=model args={scope:'process',view:'catalog',baseagent,providerId,serviceType?,refresh?}`,仅 DaemonOwner Control/受认证管理入口;返回 CatalogSnapshot,不要求先更改 Agent Provider。完整模板输入、分享短码、结果与错误码见仓库 `docs/agent-template/evol-app-template-integration-guide.md` 和 `project-file-selection-integration.md`。
270
292
 
271
293
  ### Agent 初始化参数
272
294
 
@@ -11,8 +11,12 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
11
11
 
12
12
  推理强度优先取 Agent、defaults 配置;Claude/Codex 还可分别读取 CLI 的 `effortLevel` / `model_reasoning_effort`,均未配置时使用模型或 SDK 默认值。
13
13
 
14
+ 档位优先采用目录的明确能力声明,并限制在基座可传递的范围内。网关的 `effort.supported_levels: []` 作为空元数据处理,与缺失声明一样回退到已知接口的档位;规范字段 `reasoningLevels: []` 仍表示明确无可选档位。DSH 的缺省档位为 `off / low / high / max`,其中 `off` 会显式关闭 thinking,与使用模型默认值不同。
15
+
14
16
  `ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
15
17
 
18
+ 目录式基座插件的 C/X 选配能力须声明并实际实现:未开放 C10 时拒绝模型目录查询,未开放 C11 时不提供推理强度选项,执行时也拒绝显式 effort;模型实际支持的 levels 仍是上限。C06(clear)与 `/clear` 已移除,`/new` 只释放旧运行资源并保留旧会话历史。压缩与恢复现归 B 类必需契约,不作为可选开关;必需能力有缺陷则拒绝接入。Host 直接注册的内置基座沿用既有判断。`ec status --format json` 的 `baseagents.items[].capabilities` 只列 C/X 选配声明,接入失败原因看 `plugin.reason`。Gemini 当前的已知 B 类缺口会拒绝注册,原配置保留。
19
+
16
20
  ## 自动压缩
17
21
 
18
22
  任务开始前的主动压缩依据当前有效 Provider 和模型目录接口返回的 `context_window`,
@@ -83,7 +87,7 @@ ec model check [--self <aid>]
83
87
  |------------|--------------------|
84
88
  | Claude Code | 使用统一能力解析器读取模型目录与本地参数,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
85
89
  | ecagent | 从本次请求的 Provider 模型目录解析 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
86
- | Codex | 优先使用 app-server 实时窗口;缺窗口时仅用参数表补齐统计,不修改 Codex 的执行窗口或压缩配置 |
90
+ | Codex | Provider 的真实模型窗口与自动压缩阈值分开下发;Agent 未配置时压缩阈值为 258400,显式配置只改变压缩阈值 |
87
91
  | Gemini | 执行窗口和压缩仍交给 Gemini CLI 管理,不从参数表注入执行参数 |
88
92
 
89
93
  Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 当前 Provider 模型目录 → 有效参数表记录 → runner 原有保守兜底。输出上限独立按目录 → 本地参数 → 兜底解析。统一解析器支持运行时报告窗口优先校正;没有实际报告时不猜测模型容量。
@@ -92,3 +96,7 @@ ecagent 发给网关的模型 ID 不携带窗口后缀。Codex 没有实时窗
92
96
  ecagent 自动压缩阈值为 `min(650000, contextWindow - max(压缩预留, 输出上限, 安全预留))`,安全预留为窗口的 5%(最多 10000),阈值至少为 1。压缩预留使用 harness 的实际默认设置(16384)。统计中的 `autoCompactTokens` 与 harness 使用同一阈值,`contextWindowSource` 和运行日志区分目录、本地参数、显式后缀及保守兜底;没有参数的未知模型回退到 128k,不代表模型官方上限。
93
97
 
94
98
  模型理论窗口与网关、团队的请求额度是不同限制;查表得到 1M 窗口,不代表可以突破团队的 200K 请求上限。
99
+
100
+ Claude/Codex 每个 Agent 可显式配置 `baseagents.<baseagent>.autoCompactThresholdTokens`,Owner
101
+ 通过原生 `context-policy` Menu 读取代码默认阈值、网关模型窗口、可配置范围和参数来源,并直接更新或恢复默认。配置、
102
+ 兼容规则及协议示例见 [config.md](config.md#agent-自动压缩阈值claude-code--codex)。
@@ -1,6 +1,6 @@
1
- # ec msg — 私聊消息命令
1
+ # ecmsg / ec msg — 私聊消息命令
2
2
 
3
- 私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询/WidgetCard/HTML 表单。
3
+ 私聊场景下的消息发送与查询命令集:发送统一用 `ecmsg send`,`ec msg` 负责其余子命令。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询/WidgetCard/HTML 表单。
4
4
 
5
5
  AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`),协议语义在该技能的 `SKILL.md` 里。本文维护消息命令参数和请求查询行为。
6
6
 
@@ -13,31 +13,27 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
13
13
  和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
14
14
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
15
15
 
16
- 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。消息分三种概念:
16
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。接收方由「话题 + 模式」推出,不使用 `--to`:
17
17
 
18
- | 概念 | 含义 |
19
- |---|---|
20
- | 普通消息 | 当前话题的会话对端发来;回复用 `ecmsg send '<text>'` |
21
- | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
22
- | 跨话题自派 | 本端从另一个话题把任务派给自己 |
23
-
24
- 跨话题**发送**有两个动作:
25
-
26
- | 形态 | 写法 | 目标 |
18
+ | 形态 | 写法 | 接收方 |
27
19
  |---|---|---|
20
+ | 当前话题消息 | `ecmsg send '<text>'` | 当前会话的对端/群 |
28
21
  | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
29
- | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 |
22
+ | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --selfmode` | 本端自己,落在该话题的会话 |
30
23
 
31
- `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
24
+ - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`;**不能是当前话题**;话题的本端必须等于当前会话本端。
25
+ - 独立话题必须已存在于本端索引;主话题 id 由两端 AID 直接拼出,首次联系可直接使用,会话随首条消息建立。
26
+ - 群与私聊同构:群主话题同样写成 `main:<本端AID>:<群AID>`(两种顺序等价),群话题也可以自派。
27
+ - `--selfmode` 无取值,必须与 `--thread` 同用;跨话题默认(不带它)就是委托。
32
28
 
33
- **跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self topicPeer=<话题对端>`。
29
+ **跨话题自派**(`--thread T --selfmode`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self topicPeer=<话题对端>`。
34
30
 
35
31
  **回执怎么核对**:自派的两个字段 `recipient=self` 与 `topicPeer=<话题对端>` 成对出现,`topicPeer` 一定是真实对端而不是本端。如果回执里只有 `to=<本端AID>(会话|传入)` 而没有 `recipient=self`,说明这个话题的对端被写成了本端自己——结构残缺,消息不会有人接收。这类话题建不出来(创建时即 `SELF_PEER_NOT_ALLOWED`),历史遗留的用 `ec thread delete <本端AID>/<threadId>` 清掉。
36
32
 
37
- 宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
33
+ 宿主终端没有会话上下文时,`ecmsg send` 只支持跨话题自派,本端由 `--from` 显式给出:
38
34
 
39
35
  ```bash
40
- ecmsg send '<text>' --from <本端AID> --thread <话题id> --to <对端或本端AID>
36
+ ecmsg send '<text>' --from <本端AID> --thread <话题id> --selfmode
41
37
  ```
42
38
 
43
39
  `--self` 已不再被接受(本端只由 `--from` 表达)。
@@ -75,7 +71,7 @@ ecmsg send --payload '<json>'
75
71
  ecmsg send --payload-file <path>
76
72
 
77
73
  # 发送自定义 payload 并等待关联结果
78
- ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s --format json
74
+ ecmsg send --thread main:<本端AID>:<接收方AID> --payload '<json>' --return required --timeout 60s --format json
79
75
 
80
76
  # 单向发送,不建立结果关联
81
77
  ecmsg send '<text>' --return none
@@ -91,26 +87,31 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
91
87
  每一行都必须单独执行,且是该次 shell 调用中的唯一命令。
92
88
 
93
89
  发送相关选项:
94
- - `--to <对端ID>` — 指定对端(群 AID 或对方 AID,按关系判定类型);省略表示当前会话对端/群
95
- - `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
90
+ - `--selfmode` — 跨话题自派:必须与 `--thread` 同用,无取值;收件人是本端自己
91
+ - `--from <本端AID>` — 仅宿主终端(非托管)必填;托管会话禁止使用
92
+ - `--check-every <时长|none>` — 跨话题复查周期(5m/30m/2h/1d)。**跨话题且非首次联系时可省略,省略按默认 20m 自动建复查**;`none` 表示不建复查、只写 thread-inbox(收尾场景);同话题忽略该参数,回执里标 `checkEveryIgnored`。注:这是 `ecmsg` 网关口径——直连 `ec msg send` 时带 `--thread` 必填,省略报 `CHECK_EVERY_REQUIRED`
96
93
  - `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
97
94
  - `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
98
95
  - `--text-from-file <path>` — 从文件读取文本(UTF-8),文件上限 1 MiB
99
96
  - `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
100
97
  - `--encrypt yes|no|auto` — 加密三态:`yes` 强制端到端加密,`no` 强制明文,`auto`(默认)被对端消息触发时沿用该消息的加密状态、主动发起时明文;必须带取值,裸写是参数错误,不写该参数才是默认 `auto`
101
- - `--thread <id>` — 指定话题 ID(多话题路由)
98
+ - `--thread <id>` — 跨话题目标;`thread-…` 或 `main:<aidA>:<aidB>`,不能是当前话题,本端必须一致
102
99
  - `--content-type <mime>` — 显式覆盖 MIME(仅 `--file`)
103
100
  - `--text <说>` — 附件说明文字(仅 `--file`)
104
101
  - `--transcript <text>` — 语音转写(仅 `--as voice`)
105
102
  - `--return none|required` — 是否建立通用请求/响应关联;`required` 会等待结果,默认不要求结果
106
103
  - `--timeout <duration>` — `--return required` 的本地等待时间及 AUN volatile TTL,如 `30s`、`60s`、`2m`;未指定时默认 60 秒,最大 3600 秒
107
- - `--device-id <id>` — 将私聊消息定向到指定 Provider 设备;业务 Ability `role=call` 必须使用从该 Provider 能力索引或 `protocol/discover` 结果中取得的设备 ID
104
+ - `--device-id <id>` — 可选,将私聊消息定向到一台 Provider 设备;指定时必须使用从该 Provider 能力索引或 `protocol/discover` 结果中取得的设备 ID
108
105
  - `--format json` — 输出结构化发送回执和响应
109
106
 
110
- 业务 Ability 调用必须指定能力发布设备,避免 Provider 的多台登录设备同时处理同一调用。设备 ID 是
111
- `message.send` 的传输路由参数,不属于 Ability payload;不要猜测它,也不要把它写入 JSON。
112
- `protocol/discover` 用于发现设备,可以不带 `--device-id`;之后从匹配能力的 `devices` 字段中选择目标设备。
113
- 缺少目标设备的业务调用会以 `ABILITY_DEVICE_REQUIRED` 在发送前失败。`--device-id` 只适用于私聊发送。
107
+ 业务 Ability 调用不带 `--device-id` 时,请求发送给该 AID,由 Provider 路由到在线设备,
108
+ 收到第一个有效最终回包即结束等待,结果携带实际作答设备 ID。成功和失败回包都可结束调用,
109
+ ACK 不结束等待。需要限定某一台时才指定 `--device-id`,它必须来自同一 Provider
110
+ 的发现结果。设备 ID 是 `message.send` 的传输路由参数,不属于 Ability payload;不要猜测它,也不要把它
111
+ 写入 JSON。`--device-id` 只适用于私聊发送。
112
+
113
+ 每次只支持一个设备 ID;要查多台就分别调用。`device/status` 使用相同的首个结果规则。
114
+ `protocol/discover` 按显式发现窗口收集设备证据,不接受 `--device-id`。
114
115
 
115
116
  未指定 `--content-type` 时,附件 MIME 由 SDK 按实际字节识别、后缀回退,附件描述沿用上传后的类型。
116
117
  `--as` 控制消息展示类型,与 MIME 独立。
@@ -137,9 +138,10 @@ ec peer unblock <target-aid> --self <self-aid>
137
138
  宿主终端(非托管,带 `--from`)不加载 `agents/<aid>/config.json`,且只放行跨话题自派,不经过这条联系人准入链。跨话题自派的收件人是本端自己,在任何环境下都跳过联系人准入。
138
139
 
139
140
  在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
140
- 要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),
141
+ 要联系当前对端以外的对象,用 `ecmsg send '<text>' --thread main:<本端AID>:<对方AID>`
142
+ (主话题可直接发,首次联系也会随消息建立会话),
141
143
  或先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用
142
- `ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送(`--check-every` 可省略)。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
144
+ `ecmsg send '<text>' --thread <threadId> --check-every <时长|none>` 发送(`--check-every` 可省略,跨话题默认 20m;`none` = 只写 inbox、不建复查)。**跨话题会自动创建复查**,到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
143
145
 
144
146
  成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
145
147
 
@@ -1,34 +1,22 @@
1
1
  # ec pay — 网站订单付款
2
2
 
3
- 当前 Owner AUN 私聊托管会话中的标准扫码付款。底层复用 AUN 标准附件及可靠消息投递,
4
- 不建立独立 SDK 连接。遇到付款先加载 `ec-pay` 技能;字段全表、错误码与 Persistence
5
- 细节在技能内 `references/pay-cli.md`,此处不重复。
3
+ 当前 Owner AUN 私聊托管会话中的标准扫码付款,底层复用 AUN 标准附件及可靠消息投递,
4
+ 不建立独立 SDK 连接。
5
+
6
+ **遇到付款先加载 `ec-pay` 技能**(`ec skill load ec-pay`)。命令面、spec 骨架、字段全表、
7
+ 错误码与调用边界全部收在该技能的 `SKILL.md` 里,本文只保留索引作用。
6
8
 
7
9
  ## 命令
8
10
 
9
11
  ```bash
10
- ec pay request --spec-file "$TMPDIR/payment-request.json"
11
- ec pay status <request-id>
12
- ec pay verify <request-id>
13
- ec pay refresh <request-id>
14
- ec pay cancel <request-id>
15
- ec pay update <request-id> --spec-file "$TMPDIR/payment-update.json"
12
+ ec pay request --spec-file <JSON>
13
+ ec pay update <request-id> --spec-file <JSON>
16
14
  ec pay complete <request-id> --event-id <event-id>
15
+ ec pay status <request-id> # verify / refresh / cancel 同样
17
16
  ```
18
17
 
19
18
  全部输出 JSON,可显式 `--format json`。托管命令保留当前委托环境,不能指定 self、付款人、
20
19
  另一话题或其它 AID。`request-id` = `pay_` + 32 位十六进制;`event-id` = `payjob_` + 32 位十六进制。
21
20
 
22
- ## 语义要点
23
-
24
- - `status` 返回 `payment`、`state_version`、`card_message_id`、`delivery`、`pending_events`。
25
- `sent` 表示已获传输消息 ID,`queued` 表示待可靠发送;**二者都不是已付款**。
26
- - `verify` / `refresh` 只安排持久任务,命令返回不代表网站操作已完成。
27
- - `update` 必须关联未完成事件及原订单核验;有效请求确认付款后安排一次 `continue` 事件,
28
- 后续步骤完成后再 `complete`。已取消 / 过期请求迟到确认付款时保留已付事实,不自动继续任务。
29
- - `status` 用于读取状态,不代替原网站核验。
30
-
31
- 输入格式见 `ec skill load ec-pay` 的正文骨架;字段语义与上限见该技能 `references/pay-cli.md`。
32
-
33
21
  App 对接见仓库 `docs/evo-app-pay-integration-v1.md`;Core 已提供对应命令与消息处理,
34
22
  App 需另行实现并进行真实平台联调。
@@ -0,0 +1,74 @@
1
+ # 随包插件管理(ec plugin)
2
+
3
+ > 状态:[done]
4
+ > 创建:2026-11-18
5
+
6
+ 用于查询、诊断及设置非 AUN Channel 和所有已声明 Baseagent(包括 Claude/Codex/ecagent/Gemini)的部署状态。核心 AUN 不提供此停用入口。插件代码仍随 EvolCore 构建和发布;此命令不安装、升级或热卸载代码。
7
+
8
+ Baseagent 与 Channel 是宿主基础扩展点,使用各自的加载和执行接口。内置基座继续优先支持及特定适配;共享管理入口不要求它们与外部实现采用相同 Runner、Provider 或初始化策略。
9
+
10
+ ## 命令与返回
11
+
12
+ ```bash
13
+ ec plugin list [--format json]
14
+ ec plugin show <channel|baseagent> <name> [--format json]
15
+ ec plugin doctor <channel|baseagent> <name> [--format json]
16
+ ec plugin enable <channel|baseagent> <name> [--format json]
17
+ ec plugin enable baseagent <name> --force [--format json]
18
+ ec plugin disable <channel|baseagent> <name> [--format json]
19
+ ec plugin --help
20
+ ```
21
+
22
+ name 为库存中的稳定名称,例如 feishu、codex、gemini 或显式声明的自定义基座。新基座需先加入 daemon.plugins 声明并部署对应入口。省略动作等于 list;目前文本和 json 模式都输出结构化 JSON。成功 `ok:true,data`;失败 `ok:false,code,error` 且非零退出码。daemon 不可达时失败,不改本地文件作为回退。
23
+
24
+ list 返回 hostApiVersion 与 items。每项包含 kind/name/displayName/apiVersion/version/hostApi/state,可选 reason,以及配置期望值 enabled、部署差异 restartRequired。state 为 discovered/disabled/unavailable/registered/failed;registered 仅说明轻量工厂已注册,不等于连接或模型已运行。实例状态另看 `ec status --format json`。未知或准入失败入口的版本可能为 0/unknown。
25
+
26
+ show 返回指定项;doctor 额外返回 probe.available/reason,仅检查本地描述及依赖,不导入运行实现、不启动模型或登录外部渠道。禁用/无效描述未导入时,基座诊断会说明描述不可用;历史失败证据保留在 reason 中。本地 probe 成功不代表 B 类行为验收通过。
27
+
28
+ 基座描述符校验失败时,reason.detail 包含实际入口 URL 和校验原文。CLI 安静元数据准备将重复的准入失败及 force 提示写入 DEBUG,状态、完整错误与 warnings 仍可通过 show/doctor 查询;daemon 正常启动发现仍输出 WARN,意外导入失败仍输出 ERROR。claude-gateway 属于宿主网关;当前加载器不扫描未声明目录,不应为该网关增加 baseagent 声明。
29
+
30
+ enable/disable 设置 `daemon.json.plugins['<kind>:<name>'].enabled`,返回新库存及顶层 restartRequired:true。当前实例继续使用已注册代码,宿主重启后部署才改变;操作不会切换 Agent 的基座,也不会删除渠道凭据。
31
+
32
+ 基座默认严格校验必选 B 类能力。`ec plugin enable baseagent gemini --force` 显式保存 `enabled:true,force:true`,允许 B 类能力未支持或未验证的插件及 runner 加载;每项缺口保留日志告警与库存 `warnings`。库存 `force` 是配置期望值,`forced` 是本次启动实际采用值;两者不同时需重启。普通 enable/disable 保留已存 force,避免启停意外改变部署策略;显式 Menu args.force=false 或 ECWeb“恢复严格加载”撤销 force。enabled=false 始终优先于 force。强制模式仍校验描述格式、Host API、操作系统、依赖、runner 身份与最小查询/释放接口,不改变工具权限,也不把缺失能力标成可用。`--force` 仅适用于 `enable baseagent`。
33
+
34
+ ECWeb 基础设置保留已发现插件的基座卡片,即使尚未配置模型或当前不可用。基座快照的 `plugin.force`、
35
+ `plugin.forced`、`plugin.restartRequired` 分别表示强制配置、本次启动采用的策略及部署差异;卡片区分待重启、
36
+ 准入失败、加载失败并展示具体原因。强制模式不代替 CLI/依赖探测,未通过依赖检查时仍不能选为可用默认基座。
37
+
38
+ 基础设置另外显示独立的本机安装扫描:未声明或禁用的已安装运行时显示“已安装,未启用”,版本、Node 或平台不满足时显示“已安装,依赖或平台不兼容”及具体原因。检测点未安装为灰色,已安装但未启用、待重启、准入/依赖失败或保留能力告警为橙色,通过检查且无告警为绿色。扫描本身不修改配置;点击“重新检测”发现未声明或禁用的已安装基座后,确认弹窗才通过进程级插件管理写入 daemon 的 `plugins["baseagent:<name>"].enabled=true`,保留已有 force 策略,待宿主重启后按该策略准入加载。取消不写配置,能力不足不会被误认为已卸载并提示删除。`ec plugin enable baseagent <name>` 同样可为扫描到的包内已安装基座补声明;未加载的声明在库存中标记待重启,不注册运行组件。默认选择仍以原可运行判据为准。此安装清单通过 `baseagent.snapshot.installation` 返回,与 `ec plugin` 的运行库存分别维护,不能用 `Plugin not found` 判断机器上没有安装 CLI。
39
+
40
+ ## 权限与三个层级
41
+
42
+ 宿主终端使用现有本地 control token 通过 daemon IPC 执行。托管 Agent 只能使用绑定当前 session、任务和原命令的 delegated 凭证,操作由统一进程授权器判断:普通路径遵循 DaemonOwner 控制面规则,trusted fullaccess 沿用通用授权。普通 Agent Owner 不因此取得 DaemonOwner 权限。
43
+
44
+ | 层级 | 配置/入口 | 效果 |
45
+ |---|---|---|
46
+ | 进程插件部署 | ec plugin enable/disable | 决定宿主是否注册插件,需重启 |
47
+ | Agent 基座选择 | Agent 的 active_baseagent 与 baseagents.<name>,现有 model/config/Menu | 选择该 Agent 使用的后端与模型,不安装插件 |
48
+ | 渠道实例 | Agent 的 channels[].enabled 与凭据 | 管理某 Agent 的渠道实例,不卸载共享渠道实现 |
49
+
50
+ 基座运行注册只识别 daemon.plugins 中的 baseagent:<name> 声明,不因安装扫描自动加载;源码对应 src/agents/<name>/index.ts,构建对应 dist/agents/<name>/index.js,入口缺失显示失败原因。daemon Schema v12、defaults v8 配套一次性迁移:原基座和已使用基座补入声明,显式 daemon 值优先,旧 defaults.enabled 移入后删除,原 Agent 配置与会话绑定保持;迁移完成后不再自动补声明。首次安装模板提供标准基座清单;已有 daemon 的空清单代表无运行基座,不代表本机未安装 CLI。渠道 Process 开关仍缺省 true。
51
+
52
+ CLI 与 Web 初始化也使用独立安装扫描。CLI 交互模式对未声明或禁用的已安装基座逐项询问,肯定回答才写 daemon 声明;非交互模式仅将显式 `--baseagent <name>` 视为该基座的添加确认,不自动启用其它扫描结果。CLI 当前无 daemon 运行,写入后重新进行轻量准入再供选择,不创建 Runner。Web 初始化及独立创建 Agent 页面在发现配置时弹出确认,经当前主机 Owner 核验后写声明;新声明需宿主重启后可选,不在页面自动重启宿主。取消不写声明,普通启用保留既有 force,不自动强制加载。Web 的 `POST /api/init/configuration/baseagents`(独立创建为 `/api/init/agent-creations/<workflowId>/configuration/baseagents`)接收 `{"baseagent":"dsh","confirmed":true}`,返回 `baseagents` 快照与 `restartRequired:true`;GET 仅返回安装事实,不写声明。
53
+
54
+ ## Menu 与 ECWeb
55
+
56
+ Menu name=plugins 与 CLI 使用同一库存和配置服务,仅接受 scope:'process'。控制请求需要当前有效 DaemonOwner;更新要求加密 Control Menu 或已认证 ECWeb 管理上下文。
57
+
58
+ ```json
59
+ {"type":"menu.query","id":"plugin-list","name":"plugins","args":{"scope":"process"}}
60
+ {"type":"menu.query","id":"plugin-show","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu"}}
61
+ {"type":"menu.query","id":"plugin-doctor","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu","view":"doctor"}}
62
+ {"type":"menu.update","id":"plugin-disable","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu"},"value":false}
63
+ {"type":"menu.update","id":"plugin-force","name":"plugins","args":{"scope":"process","kind":"baseagent","name":"gemini","force":true},"value":true}
64
+ ```
65
+
66
+ query 可按 kind、name 过滤,doctor 必须同时提供 kind/name;update 必须提供 kind/name 和 boolean value,禁止夹带 Agent/relation 选择器。`args.force` 只用于基座更新;省略保留已有值,true 强制、false 严格;停用仍保留该值。显式上下文只允许 context:{kind:'process'}。返回标准 menu.response 的 data/error;查询为库存,doctor 为指定项与 probe,更新为新库存与重启提示。Menu 目录按已发现插件生成带完整参数的更新与诊断条目。
67
+
68
+ ECWeb 进入“基本设置 → 运行时 → 运行时插件”:读取库存及当前失败原因,点击“诊断”执行本地探测,点击“启用/停用”立即保存部署期望值并展示重启提示。修改失败保留原值并展示服务端原因;不会自动重启 daemon。新基座名称和展示标签由 Host 快照提供,专用复杂参数继续通过 ec config 管理。
69
+
70
+ 基座插件另有“强制启用”按钮;保存后显示强制模式与能力告警,可点击“恢复严格加载”撤销 force。两种操作均使用上面的 Menu 参数,重启前展示待应用状态。
71
+
72
+ 接入开发接口见 [Baseagent 接入协议](../../../docs/baseagent-plugin-standard.md),渠道窄接口见同文第 8 节。加载 API 1/Host API 1.0.0 与执行契约 host-runner-1 独立;候选 v2 仍是设计稿。
73
+
74
+ 从接入选型、实现 Runner 到真实验收的开发流程见 [Baseagent 集成开发手册](../../../docs/baseagent-integration-handbook.md),其中分别说明 SDK、单次 CLI、ACP/常驻 RPC/HTTP 与各类进程所有权、中断、重建和沙箱边界。
@@ -99,6 +99,8 @@ Windows 只读配置在替换前临时解除只读,替换完成或失败后恢
99
99
 
100
100
  启动时,在加载 Agent 前恢复未完成的迁移事务,再更新全局默认、Agent、关系配置和 fallback,以及初始化记录和 ECWeb 创建工作流中的运行时 Provider 绑定。初始化原始 plan、fingerprint、创建凭据和请求 ID 保持不变,避免破坏重试与恢复的一致性。统一配置快照已覆盖初始化记录和 ECWeb 创建状态,迁移前版本包含全部受影响文件,而非仅 providers.json。
101
101
 
102
+ 启动和身份迁移即使没有 ID 变化或旧别名,也会扫描基座选择。`baseagents.<name>.provider` 指向不存在的 Provider 时,只清除该失效字段,保留模型、推理强度等独立配置,使 Agent 重新继承 defaults 的同基座 Provider。defaults 的失效引用同样清除;整条链都未填写时,沿用基座现有的本机配置或环境变量凭据,没有可用凭据则连接失败,不自动选择注册表中的其他 Provider。已有 Provider 的服务缺失、凭据错误及 fallback/Services 的失效引用仍按原规则报错。清理沿用同一快照、校验和事务机制,重复启动不重复写入。
103
+
102
104
  Provider 不再创建独立的长期迁移备份,版本查看、恢复和保留清理由现有 ec config 快照机制统一管理;既有历史迁移备份保留不动。短期事务日志仅用于本次操作的失败回滚和中断恢复,成功提交后删除。若 configSnapshots=false,不创建版本备份,在线 sync 返回 CONFIG_SNAPSHOTS_DISABLED 告警,启动迁移也记录告警,但事务日志回滚仍启用;快照开启但写入失败则在修改配置前中止。
103
105
 
104
106
  新快照记录扩展后的文件范围;恢复到尚未收录初始化状态的历史快照时,不因这些文件缺席而删除当前初始化状态。新快照则能够恢复这些文件的内容或原本不存在的状态。
@@ -153,7 +155,7 @@ hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一
153
155
 
154
156
  文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
155
157
 
156
- 常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、PROVIDER_CONFLICT(域名已存在)、PROVIDER_ID_COLLISION(八位哈希碰撞)、PROVIDER_DOMAIN_IMMUTABLE(不能修改已有域名)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
158
+ 新建 Provider 使用 name 作为稳定 ID;名称重复时返回 CONFLICT(kind 为 provider_name_exists),应更换名称。相同域名或 Base URL 可以创建多个 Provider。已有 Provider 保留原 ID;修改展示名称使用 displayName。常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(名称或 revision 冲突、仍有引用或引用无法校验)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
157
159
 
158
160
  升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain 时暂保留旧 ID,并报告待处理;localhost 和 IP 地址按规范化主机名生成固定 ID。不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
159
161
 
@@ -235,7 +237,11 @@ key/api_key/apikey/access_token 参数,避免旧值覆盖新密钥,也不改
235
237
 
236
238
  ## Menu 对应
237
239
 
238
- name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 支持 list/detail/templates,CLI show 对应 detail;普通 update 使用 args.resource=provider 和完整 JSON 字符串 value;action 支持 create/import/delete。全部写入要求 expectedRevision。
240
+ name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 支持 list/detail/templates;普通 update 使用 args.resource=provider 和完整 Provider 对象 `value`(同时兼容 JSON 字符串);action 支持 create/import/delete。全部写入要求 expectedRevision。Provider 的 `displayName`(展示名称)和 `description`(描述)是可选字符串,list/detail 会返回,完整对象 update 可修改。`services.<type>.style`、`path`、服务级凭据和模型策略也可在该对象中配置;Menu catalog 会发布对应对象 schema。
241
+
242
+ App 编辑页通过 Host Control Menu 查询 `detail`。通过现有鉴权后,明文和加密请求均在 `provider.common.apiKey` 和 `provider.services.<type>.apiKey` 返回配置保存值,包括单值、有序 Key 池或环境变量引用原文。`headers`、`queryParams`、列表、保存响应及 CLI `show` 继续脱敏。
243
+
244
+ Menu 客户端可以直接把 Provider 对象放在 `menu.update.value`;创建时也可以把对象放在 `menu.action` 的 `value`,不再必须先把对象序列化成字符串。旧版的 JSON 字符串写法继续兼容。创建请求也仍接受既有的 `args.provider` 形式。
239
245
 
240
246
  App 模板契约(均使用 name=provider、scope=process):
241
247
 
@@ -2,11 +2,11 @@
2
2
 
3
3
  直接调用 AUN 协议方法的逃生通道。触发词:直接调协议方法/批量 RPC。
4
4
 
5
- > 常规消息收发用 `ec msg` / `ec group`,文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
5
+ > 常规消息发送用 `ecmsg`,消息查询用 `ec msg`,群管理用 `ec group`,文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
6
6
 
7
7
  ## 运行边界
8
8
 
9
- 实际 RPC 调用仅供宿主终端使用;EvolCore 托管 Agent 会话只能查看 `ec rpc --help`,不能执行协议调用。此入口会直接使用指定本地 AID 建立 SDK 连接,没有托管会话的 delegated sender 和逐操作 daemon 鉴权,因此不能用于绕过 `ec msg`、`ec group` 或 `ec fs` 的权限限制。
9
+ 实际 RPC 调用仅供宿主终端使用;EvolCore 托管 Agent 会话只能查看 `ec rpc --help`,不能执行协议调用。此入口会直接使用指定本地 AID 建立 SDK 连接,没有托管会话的 delegated sender 和逐操作 daemon 鉴权,因此不能用于绕过 `ecmsg`、`ec msg`、`ec group` 或 `ec fs` 的权限限制。
10
10
 
11
11
  ## 用法
12
12
 
@@ -16,8 +16,24 @@ ec skill load <技能名> --source builtin # 指定来源(builtin|local)
16
16
  ```
17
17
  ---
18
18
  skillDir: <技能目录绝对路径>
19
+ chars: <正文字符数>
19
20
  ```
20
- 脚本路径、references/ 等资源均以此为根。
21
+ `skillDir` 是脚本路径、references/ 等资源的根;`chars` 是正文(不含页脚)的字符数,
22
+ 按 Unicode 码点计数,中文一个字算 1。`--json` 时同为 `chars` 字段。
23
+
24
+ ### 技能目录写成 `{{skillDir}}`
25
+
26
+ SKILL.md 正文里技能目录要引用的地方,一律写成 `{{skillDir}}`,加载时替换成本机技能目录的
27
+ 绝对路径(统一正斜杠):
28
+
29
+ ```bash
30
+ node "{{skillDir}}/scripts/foo.mjs"
31
+ ```
32
+
33
+ 正文因此不含任何本机路径,换机器、换安装位置都不用改。旧写法 `<技能目录>` 同样处理;
34
+ 占位符后面不跟路径分隔符时原样保留。`chars` 统计的是渲染前正文的字符数,不受安装路径
35
+ 长度影响。直接读取 SKILL.md 文件看到的仍是未渲染的占位符——执行脚本用加载输出,或照页脚的
36
+ `skillDir:` 自己替换。
21
37
 
22
38
  ## 查路径
23
39
 
@@ -4,6 +4,11 @@
4
4
 
5
5
  同时查看 Agent 预算和对端角色额度的实际已用、剩余,用 `ec quota status`,见 [quota.md](quota.md)。
6
6
 
7
+ 当前网关没有返回所用模型的官方价格 `pricing` 时,以
8
+ `https://mg-new.evolai.cn/claude-proxy/v1/models` 中该模型的 `pricing` 作为官方参考价。
9
+ 此时网关费用不计价,明细与完成回执保留空值;不使用参考端点的 `effective_pricing`,
10
+ 也不把官方费用当作网关费用。参考价按小时缓存;不可用且无成功缓存或找不到该模型时,费用保留未知。
11
+
7
12
  ## 查看今日概览
8
13
 
9
14
  ```bash
@@ -1,5 +1,27 @@
1
1
  # ec storage — 文件存储
2
2
 
3
+ ## 定向私有分享
4
+
5
+ `ec storage share <aid> --input-file FILE [--format json]` 使用 JSON 的 action 创建、查询或撤销分享。托管调用仅允许当前任务 Agent 自身 AID,并复用其真实连接;不借用 Owner、Host 或其他 Agent 身份。
6
+
7
+ ```json
8
+ {"action":"create","requestId":"share-001","path":"/templates/writer/writer-1.0.0.ectpl","allowedAids":["target-host.agentid.cn"],"expireInSeconds":259200,"maxUses":0}
9
+ ```
10
+
11
+ create 必填 requestId/path/非空 allowedAids;不接受 `*`。expireInSeconds 默认259200(72小时),0为不过期;显式期限优先,已有分享不因默认值变更而延长;maxUses默认0不限。list 输入 `{action:"list",path:"/完整对象路径"}`;revoke 输入 `{action:"revoke",requestId:"撤销请求ID",shareId:"十位短码"}`;status 输入 `{action:"status",requestId:"原请求ID"}`。以上简写在实际 JSON 中须为键加双引号。
12
+
13
+ 返回 state=succeeded 才表示已核实完成,create 的 result 带真实 share_id。通信失败或进程退出后的未知写操作保留原 requestId,不重放创建/撤销;status 查询持久回执,create 结果未知时辅助查询同对象分享候选,不能把候选误报为原请求成功。需要时结合 list 处理。未知结果退出码3,不能继续声称分享已完成。给人分享安装模板时,授权必须覆盖其实际安装 Host。
14
+
15
+ 给接收方及其动态 Host 下载模板时,分为两项独立授权:create 的 allowedAids 填接收方 AID;再通过通用 `ec fs setfacl` 给该接收方的直接 sub 中、可信名片 `type=host` 的 AID 授予文件只读权限。
16
+
17
+ ```bash
18
+ 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","max_uses":0}' --expires '<与接收方分享对齐的到期Unix秒>' --format json
19
+ ```
20
+
21
+ 通用 ACL 的 JSON 参数、回执及撤销见 [文件系统](fs.md)。Storage 动态检查 Owner 声明及可信名片,不枚举静态主机列表。短码和 ACL 分别核实、分别撤销;同对象同接收方的条件 ACL 由多张卡片共享。托管操作继续使用当前任务 Agent 身份。
22
+
23
+ Host 需要独立的文件读取授权,不能直接使用仅授权接收 Agent 的短码。Host 使用条件 ACL 下载时按 location 读取,不带仅授权接收方的短码;指定 Host 的原 allowedAids 分享方式仍保留。v2 `agent.template.share` 卡片发送流程见内置 agent-template-project 技能。
24
+
3
25
  AUN 网络上的文件存储:上传、下载、列举、删除、查配额。触发词:上传/下载/存文件/配额。
4
26
 
5
27
  以自己的 AID 为操作者(`<aid>`)。
@@ -90,7 +90,7 @@ ec thread create <peer> --name '项目A' --status active
90
90
 
91
91
  创建成功后返回 `threadId`,格式为 `thread-<ms>-<seq4>-<rand4>`(如 `thread-1791028341906-0000-136a`)。创建时会自动向对端发一条系统消息通知。
92
92
 
93
- `<peer>` 不能是本端自己的 AID(含大小写差异与 `@` 前缀),否则报 `SELF_PEER_NOT_ALLOWED`。话题是两端结构,对端写成本端会得到「我↔我」的残缺话题:消息投得进去,但实际没有接收方。要给自己派活,请先以真实对端建话题,再用 `ecmsg send --thread <该话题> --to <本端AID>`。
93
+ `<peer>` 不能是本端自己的 AID(含大小写差异与 `@` 前缀),否则报 `SELF_PEER_NOT_ALLOWED`。话题是两端结构,对端写成本端会得到「我↔我」的残缺话题:消息投得进去,但实际没有接收方。要给自己派活,请先以真实对端建话题,再用 `ecmsg send --thread <该话题> --selfmode`。
94
94
 
95
95
  ### 修改话题
96
96
 
@@ -142,39 +142,44 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
142
142
  | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
143
143
  | 跨话题自派 | 本端从另一个话题把任务派给自己 |
144
144
 
145
- 跨话题**发送**有两个动作:
145
+ 跨话题**发送**有两个动作(接收方由「话题 + 模式」推出,不使用 `--to`):
146
146
 
147
147
  | 形态 | 写法 | 目标 | 用途 |
148
148
  |---|---|---|---|
149
149
  | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
150
- | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
150
+ | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --selfmode` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
151
151
 
152
152
  不带 `--thread` 的 `ecmsg send '<text>'` 是普通回复,只发当前会话对端/群。
153
153
 
154
154
  跨话题自派的派活通知按话题对端类型送达:对端是人类时发普通 text,对端是 agent 时发 notice(`subtype=self_dispatch`),避免被当成一条要执行的聊天消息。
155
155
 
156
156
  ```bash
157
- # 跨话题委托(本端/对端由话题推断)
157
+ # 跨话题委托(本端/对端由话题推断);省略 --check-every 时默认 20m
158
158
  ecmsg send '<消息内容>' --thread <threadId>
159
159
 
160
- # 自定义复查周期(缺省 20m)
160
+ # 自定义复查周期
161
161
  ecmsg send '<消息内容>' --thread <threadId> --check-every 30m
162
162
 
163
+ # 收尾汇报:跨话题但不建复查(只写 thread-inbox)
164
+ ecmsg send '<消息内容>' --thread <threadId> --check-every none
165
+
163
166
  # 跨话题自派(投给该话题下的本端自己)
164
- ecmsg send '<消息内容>' --thread <threadId> --to <本端AID>
167
+ ecmsg send '<消息内容>' --thread <threadId> --selfmode
165
168
  ```
166
169
 
167
170
  注意事项:
168
171
 
169
- - `--thread` 必须是本端已存在的话题:独立话题查索引,主话题(`main:<selfAid>:<peerAid>`)查该关系的 active session。都不存在时返回 `TOPIC_NOT_FOUND`
172
+ - `--thread` 不能是当前话题;当前话题消息直接省略它(否则报 `TOPIC_IS_CURRENT`)
173
+ - 独立话题必须已存在于本端索引;主话题(`main:<selfAid>:<peerAid>`)由两端 AID 直接拼出,目标会话尚未建立时按首次联系处理,会话随首条消息建立
170
174
  - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>` 两种形态;裸对端 AID 不是话题 id
171
175
  - **主话题可以作为跨话题发送的目标**。例如:
172
176
  ```bash
173
177
  # A 向 B 的主会话发送消息(从 A 的某个话题跨过去)
174
- ecmsg send '请在主会话查看这个报告' --thread 'main:bob.aid:alice.aid'
178
+ ecmsg send '请在主会话查看这个报告' --thread 'main:bob.agentid.cn:alice.agentid.cn'
175
179
  ```
176
- 主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题)
177
- - **跨话题自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`)
180
+ 主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题),
181
+ 也可以按 `main:<本端AID>:<对方AID>` 直接拼出;还没聊过的对象也能用主话题首次联系。
182
+ - **跨话题委托自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`);`none` 表示只写 thread-inbox、不建复查(收尾场景)。首次联系不建复查;自派不建复查,也不能与 `--check-every` 同用
178
183
  - 跨话题发送成功后,系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时,
179
184
  这条记录会以「‹提醒:跨话题委托 · 话题:xxx …›」的形式注入一次,然后删除
180
185
  - `--check-every` 会创建**跨话题复查**(名称 `check-<目标>-from-<来源>-<唯一后缀>`,
@@ -239,6 +244,10 @@ Trigger:trig_1792369122624_aa1c9068
239
244
  摘要用于跨会话保留话题的核心信息,在下次激活或委托时快速恢复上下文。
240
245
  daemon 不自动总结,需要 agent 主动写入。
241
246
 
247
+ 更新时先合并旧摘要仍有效的目标、关键结果与待办/阻塞,不要只留下最后一轮操作。
248
+ 主动更新的 3 轮冷却和语义判重由提示词约束,不调用 embedding 或额外模型;具体规则见 thread fragment 与 thread-ops 技能。
249
+ 服务端只做精确去重:正文和覆盖游标都相同时返回 `updated: false`,不追加版本、不改变更新时间;任一变化仍写入。`--if-rev` 校验先于去重,改名仍独立执行。
250
+
242
251
  ```bash
243
252
  # 查看当前摘要(同时打印 coveredThroughTs 覆盖游标)
244
253
  ec thread summary show <threadId>
@@ -126,6 +126,10 @@ trusted fullaccess
126
126
 
127
127
  `bypass` 只免去符合策略的交互审批。单独要求管理者审批的操作,仍按该操作的审批范围处理,不能笼统理解成“危险操作全部免审”。
128
128
 
129
+ 管理审批需要跨会话转交时,只向目标 Agent 当前协议 Owner 的 AUN 私聊发送一张审批卡,不选择 admin。
130
+ 没有可用 Owner 或审批渠道时拒绝操作,不回退给 admin。审批响应和临时授权复用都会重新校验
131
+ Owner 资格;原 Owner 降为 admin 后,该审批及其临时授权失效。符合条件的原会话内管理审批仍可由 admin 处理。
132
+
129
133
  临时批准不是给工具发一张永久通行证:
130
134
 
131
135
  ```text