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
@@ -0,0 +1,62 @@
1
+ # 发布到平台仓库
2
+
3
+ 入口:[SKILL.md](../SKILL.md)。使用 `ec agent template publish` 将最终包发布到兼容 `services.templates.publish/status` 的仓库。默认目标为 `evolai.agentid.cn`,已有明确仓库选择时直接沿用。仅要求制作或设计方案时,不执行发布。
4
+
5
+ ## 1. 确定包与真实发布身份
6
+
7
+ - 沿用用户确认的模板、版本、仓库和发布身份,仅补问缺项或变化。保存到第一册的打包确认清单,下次直接沿用。
8
+ - 托管会话自动使用当前执行 Agent 的真实 AUN 连接;宿主终端和 Control Menu 自动使用当前 daemon 的真实 Host Control 连接。无需传 agent/host 参数,不能指定任意 AID,也不借用 Owner 身份。
9
+ - 发布者须通过仓库 Core 服务准入及业务 publishers 授权,readers 权限不足以发布。Host 路线需要仓库明确准入该 Host。
10
+ - 包未完成时先走[采集和打包](01-collect-and-pack.md),在 pack 顶层明确 `publisherIdentity: "agent"` 或 `"host"`,使 PACKAGE.publisher.aid 与后续真实 Caller 一致。省略时保留原操作者署名;已有包署名不符须重新 pack,publish 不修改包字节。
11
+ - 单 Agent 的原始 AID key、成员版本及 PACKAGE/team 版本继续遵守现有契约;metadata 仍需明确填写,不自动继承或放宽空值。
12
+
13
+ 先查看目标 Host 的 capabilities,确认 `actions` 含 publish,`features.templatePublish.identities` 含所需身份。旧 Host 不支持时提示升级,不自动改用其他身份或仓库。
14
+
15
+ ## 2. 提交最终包
16
+
17
+ ```bash
18
+ ec agent template publish '<最终packageId>' --store 'evolai.agentid.cn' --request-id '<本次稳定请求ID>' --wait 60 --format json
19
+ ```
20
+
21
+ 业务参数为一个 packageId 和必填 `--store AID`,不接受 `--input-file`;`--request-id`、`--wait 0..300`、`--format json` 是可选作业控制参数。替换示例中的占位内容,保存原命令和本地 jobId。
22
+
23
+ Core 在同一个持久作业内完成:
24
+
25
+ 1. 核验真实连接、来源权限、最终包摘要和 publisher 声明。
26
+ 2. 上传到发布者自身 Storage 的 `/templates/<id>/<id>-<version>.ectpl`,不覆盖同版本不同内容。
27
+ 3. 创建仅仓库 AID 可读、有效一小时的私有下载授权。短码保存在内部检查点,不放入公开作业结果。
28
+ 4. 以所选真实身份加密调用仓库 publish,保存稳定 operationId 和仓库 serviceJobId。
29
+ 5. 查询仓库 status,核对 releaseId、发布者、模板 ID、版本、摘要、大小和仓库位置后才标记 succeeded。
30
+
31
+ 无需再手工 push、创建短码或拼服务请求。给个人发送分享卡片继续走[上传和分享](02-upload-and-share.md),Owner App 的原 Storage 流程保持。
32
+
33
+ ## 3. 进度、失败与恢复
34
+
35
+ ```bash
36
+ ec agent template status '<本地jobId>' --format json
37
+ ```
38
+
39
+ - `queued/running`:已受理或正在执行,phase 为 validating/uploading/granting/submitting/waiting_registry,尚未发行。
40
+ - `succeeded`:仓库业务成功且发行结果已核实。读取 result.releaseId、serviceJobId、digest、size 和 location。
41
+ - `paused` 且 `resumable=true`:结果未知或连接中断,保存原 jobId 后恢复,不换 requestId 重新 publish。
42
+ - `failed`:报告 error.code/message。署名不匹配报 PUBLISHER_MISMATCH,仓库拒绝保留原业务错误。修复包或明确失败的权限后,按实际原因重新封包/发起新作业;未知结果先恢复原作业。
43
+
44
+ ```bash
45
+ ec agent template resume '<原本地jobId>' --request-id '<本次恢复请求ID>' --wait 60 --format json
46
+ ```
47
+
48
+ agent 作业须从原执行 Agent 恢复。已知仓库 jobId 时只查询原任务;提交回执丢失时沿用原 operationId 和完全相同 source 补取任务。未知的授权创建不重复写入,需要核实原授权请求。提交仓库之后不支持 cancel,避免将可能已发行的作业当作取消成功;提交前可取消,已上传对象保留,下载授权按原期限过期。
49
+
50
+ 本地回执丢失时先 `status --request-id '<原请求ID>'`。退出码 0 可能只表示受理,退出码 3 表示暂停或等待结束仍未完成,均不能代替成功终态。同发布者、同 ID/版本、同内容由仓库复用;同版异内容按仓库 VERSION_CONTENT_CONFLICT 处理,不自动增号。
51
+
52
+ ## 4. Menu 与交付
53
+
54
+ 受鉴权的 Host Control Menu 共用同一 publish 作业:
55
+
56
+ ```json
57
+ {"type":"menu.action","id":"publish-001","name":"template","action":"publish","args":{"packageId":"<最终packageId>","storeAid":"evolai.agentid.cn"}}
58
+ ```
59
+
60
+ Menu 没有托管 Agent 执行上下文,只能使用 host,不接受自报执行 Agent AID。进度继续用 template.job 事件和 job query。包须在 pack 时选 host 署名,App 原 Owner Storage 上传分享不必改走 publish。
61
+
62
+ 交付仓库 AID、真实 publisher、模板 ID/版本、releaseId、本地 jobId、serviceJobId、SHA-256、大小和发行 location,并说明实际 reviewStatus/upgradeStatus。发行完成不等于审核通过、启用升级、安装或预构建。
@@ -39,9 +39,9 @@ license: MIT
39
39
  命令语法只在此处完整写一遍,别处引用本节:
40
40
 
41
41
  ```bash
42
- # 群会话里直接发;不在群会话里时用 --to 指定群 AID
42
+ # 群会话里直接发;不在群会话里时用 --thread 指定该群的话题
43
43
  ecmsg send '<text>' [选项]
44
- ecmsg send --to <groupId> '<text>' [选项]
44
+ ecmsg send '<text>' --thread main:<selfAid>:<groupId> [选项]
45
45
  ```
46
46
 
47
47
  | 选项 | 说明 |
@@ -220,7 +220,7 @@ ec group rules <selfAid> <groupId> get [--format json]
220
220
 
221
221
  ```bash
222
222
  # 发消息(唯一完整语法在第二节)
223
- ecmsg send --to <groupId> '<text>' [--encrypt yes|no|auto] [--mention '<aid1>,<aid2>']
223
+ ecmsg send '<text>' [--thread <群话题id>] [--encrypt yes|no|auto] [--mention '<aid1>,<aid2>']
224
224
 
225
225
  # 查上下文
226
226
  ec group history <selfAid> <groupId> --limit 50 --format json
@@ -132,10 +132,10 @@ ec group rules <selfAid> <groupId> get --format json
132
132
 
133
133
  ### 当前就在目标群
134
134
 
135
- 使用完整发送者与群 AID,在当前话题发送:
135
+ 在当前群话题发送(省略 `--thread`):
136
136
 
137
137
  ```bash
138
- ecmsg send --to <groupId> '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --mention '<implementerAid>,<reviewerAid>' --encrypt yes
138
+ ecmsg send '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --mention '<implementerAid>,<reviewerAid>' --encrypt yes
139
139
  ```
140
140
 
141
141
  ### 从私聊或其它群发起
@@ -148,10 +148,10 @@ ec thread create <groupId> --name 'Project Alpha 协作'
148
148
  ```
149
149
 
150
150
  使用返回的裸话题 ID;已有合适话题就复用,不为每条消息重复创建。
151
- 发送时由话题推断身份和目标,`--check-every` 必填:
151
+ 发送时由话题推断身份和目标,跨话题默认委托给该群;`--check-every` 省略时默认 20m:
152
152
 
153
153
  ```bash
154
- ecmsg send --to <groupId> '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --thread <threadId> --check-every 10m --mention '<implementerAid>,<reviewerAid>' --encrypt yes
154
+ ecmsg send '[A-001] 负责人:<implementerAid>;复核:<reviewerAid>。输入:<任务输入>。交付:/collab/A-001/。验收:<可验证的通过条件>。截止:<时间与时区>。请先回复 ACK,再按群规则汇报。' --thread <threadId> --check-every 10m --mention '<implementerAid>,<reviewerAid>' --encrypt yes
155
155
  ```
156
156
 
157
157
  示例使用密文;实际发送按 `[reply]` 和已核实的目标加密要求选择 `--encrypt yes` 或 `--encrypt no`,
@@ -51,21 +51,24 @@ ec aid avatar <selfAid> --file <本地图片>
51
51
 
52
52
  ### 用对端发来的图片换头像
53
53
 
54
- 对端在聊天里发来的图片不进消息正文,也不出现在任何命令输出里;它落盘在:
54
+ 对端在聊天里发来的图片落盘在 agent 级附件目录,按月分目录:
55
55
 
56
56
  ```
57
- $EVOLCORE_HOME/agents/<selfAid>/relations/aun#<对端AID>/attachments/
58
- 0123abcd...ef.jpg ← 图片本体,文件名是 32 位十六进制附件 ID
59
- 0123abcd...ef.json ← 元数据:attachmentId / mimeType / size / sha256 / createdAt
57
+ $AGENT_DIR/attachments/<YYYY-MM>/<原始文件名> ← 图片本体,用对端给的原始文件名
58
+ $AGENT_DIR/attachments/index/<peerKey>.jsonl ← 归属索引:filename / storage / sha256 / createdAt / month
60
59
  ```
61
60
 
61
+ - 归属信息在 `index/<peerKey>.jsonl`,**不再有同名 `.json` sidecar**。`<peerKey>` 形如 `aun#<对端AID>`,群聊是 `aun#<群AID>`。
62
+ - 本月的图在当月目录,更早的图在各自月份目录。找某张图时按文件名去索引里查,索引记录里的 `storage` 是实际落盘名,可能带 `-1` 这类编号。
63
+ - 同名不同内容会在同月目录里带编号;不同名同内容复用同一份本体。
64
+
62
65
  用户说“用刚才那张图当头像”时:
63
66
 
64
- 1. 列这个目录,按同名 `.json` 里的 `createdAt` 排序,取最新那张。用户指的是更早的某张时,按对话时间挑。
67
+ 1. 按对话时间确定是哪一轮收到的,在索引里按 `createdAt` 找对应记录,拿到 `storage` 和 `month`,拼出 `$AGENT_DIR/attachments/<month>/<storage>`。
65
68
  2. 把图片复制到当前项目目录或本会话 `$TMPDIR`——`ec aid avatar --file` 只接受这两处路径,直接传附件目录里的绝对路径会被拒。
66
69
  3. `ec aid avatar <selfAid> --file '<复制后的路径>'`。
67
70
 
68
- 群聊里的图片存到 `relations/aun#<群AID>/attachments/`。多个对端都发过图时,先按对话确定是谁发的,再到对应目录找。图片尺寸和体积不用自己处理,命令会补白边、缩放并压缩成 JPEG。
71
+ 多个对端都发过图时,先按对话确定是谁发的,再去对应的 peerKey 索引里找。历史消息里的 `$AGENT_DIR/…` 是别名,使用前按 `[venue]` 段的 AGENT_DIR 值展开。图片尺寸和体积不用自己处理,命令会补白边、缩放并压缩成 JPEG。
69
72
 
70
73
  如果用户给的是 HTTPS 图片地址,直接用 `--url <地址>`,跳过上面第 1、2 步。
71
74
 
@@ -1,69 +1,162 @@
1
1
  ---
2
2
  name: ec-pay
3
3
  description: >-
4
- 网站订单扫码付款:从网页提取商品、金额、微信或支付宝渠道和二维码,发送标准付款 Action Card,
5
- 处理切换渠道、刷新二维码、订单核验和付款后继续任务。遇到付款页、支付二维码、等待用户付款,
6
- 或收到付款任务事件时使用。不用于个人转账、退款或自动扣款。
4
+ 遇到网页付款页、付款二维码、等待用户付款或付款任务事件,必须使用 ec-pay。
5
+ 网页付款二维码严禁以截图或普通图片附件转发。必须调用 ec pay 发送或更新标准付款卡片,
6
+ 通过卡片交付商品、金额和微信或支付宝付款码,并处理渠道切换、二维码刷新、订单核验和付款后续任务。
7
+ 不用于个人转账、退款或自动扣款。
7
8
  license: MIT
8
9
  ---
9
10
 
10
11
  # 网站扫码付款
11
12
 
12
- 仅支持 Owner 的 AUN 私聊托管任务。命令面:
13
+ 仅支持 Owner 的 AUN 私聊托管任务。全程只用一条命令入口,输出统一为 JSON:
13
14
 
14
15
  ```bash
15
- ec pay request --spec-file <JSON> # 发起:上传码图并发送付款卡
16
- ec pay status <request-id> # 读状态与 state_version
17
- ec pay update <request-id> --spec-file <JSON> # 提交核验结果与可选新码
16
+ ec pay request --spec-file <JSON> # 发起:上传码图并发付款卡
17
+ ec pay status <request-id> # 读状态、state_version、pending_events
18
+ ec pay update <request-id> --spec-file <JSON> # 提交核验结果与可选新码
18
19
  ec pay complete <request-id> --event-id <event-id>
19
- ec pay verify|refresh|cancel <request-id>
20
+ ec pay verify <request-id> # 以下三个各自独立成条
21
+ ec pay refresh <request-id>
22
+ ec pay cancel <request-id>
20
23
  ```
21
24
 
22
25
  `request-id` = `pay_` + 32 位十六进制,`event-id` = `payjob_` + 32 位十六进制。
23
- 字段全表、错误码与持久性限额见 [pay-cli.md](references/pay-cli.md),**只在字段拿不准或命令报错时读**;
24
- 日常按下面两段写 spec 即可。
26
+ 托管命令保留当前委托环境,不能指定 self、付款人、另一话题或其它 AID。
27
+
28
+ `status` 返回 `ok`、`request_id`、`state_version`、`payment`(完整请求)、`card_message_id`、
29
+ `delivery`、`pending_events`。`delivery` 是字符串:`sent` 表示卡片已获传输消息 ID,`queued` 表示待可靠发送——
30
+ **二者都不是已付款**,卡片可能还没被用户看到。`pending_events` 每项含 `event_id`、`kind`、`state_version`。
31
+
32
+ `kind` 只有五种:`verify`、`refresh`、`select.wechat`、`select.alipay`、`continue`。
33
+
34
+ `payment` 里三组状态决定下一步该做什么,别只看 `ok`:
35
+
36
+ | 字段 | 取值 | 含义 |
37
+ |---|---|---|
38
+ | `request_state` | `active` / `expired` / `cancelled` / `superseded` | 请求本身是否还能推进 |
39
+ | `order_state` | `pending` / `verification_pending` / `paid` / `failed` / `unknown` | 订单事实 |
40
+ | `verification.status` | `not_checked` / `checking` / `verified_paid` / `verified_pending` / `verified_failed` / `inconclusive` | 核验进展 |
41
+
42
+ `request_state` 不是 `active` 就不能换码;`order_state` 为 `paid` 时只能走 `continue`,不能再改码。
43
+
44
+ `verify` / `refresh` 只安排持久任务,命令返回不代表网站操作已完成;`status` 读状态,不代替原网站核验。
45
+
46
+ ## 怎么调用才不被安全层拦
47
+
48
+ `ec pay` 输出本就是格式化 JSON,**不需要任何后处理**。以下写法实测可用:
49
+
50
+ ```bash
51
+ cat > $TMPDIR/pay.json <<'EOF'
52
+ {"source": {...}}
53
+ EOF
54
+ ec pay request --spec-file $TMPDIR/pay.json
55
+ ```
56
+
57
+ **可接的过滤器只有这八个**:`head` `tail` `grep` `wc` `sort` `cut` `uniq` `tr`。接 `cat`、`jq`、
58
+ `sed`、`awk`、`python`、`node` 一律被拒。`$TMPDIR` 可以出现在参数里,也能同时接过滤管道。
59
+
60
+ **重定向只能落 `$TMPDIR` 或项目目录内**(`> /tmp/x.json` 会被拒)。要看长 JSON 就先存盘,
61
+ 再另起一次调用读该文件,不要在 `ec` 后面塞解析器。
62
+
63
+ **spec 与二维码图也必须位于项目目录或 `$TMPDIR` 内**,否则报 `Attachment source must be inside
64
+ the current project or session TMPDIR`。图片原来在桌面或下载目录的,先 `cp` 进 `$TMPDIR`。
65
+
66
+ 一次调用只放一条 `ec pay`,不要串联 `&&`、`;`。
25
67
 
26
68
  ## 发起
27
69
 
28
70
  1. 确认当前任务确实需要该商品,读网站付款页;保持原订单,不另建。
29
- 2. 分清网站支持的渠道和当前每张码的适用渠道。微信码只绑微信、支付宝码只绑支付宝;页面支持双渠道但当前只有微信码时,支付宝标 `requires_site_switch`。无法确定的保留 `unknown`,不猜成聚合码。
30
- 3. 提取商品、用途、网站 origin、订单号、页面金额与币种、码有效期、订单有效期。看不到的用 `null`,不补零、不虚构「十分钟」——请求自身缺省十分钟,由系统标明为请求时限。
31
- 4. 优先取原始图片,必要时截图裁剪,保留二维码白边。图片和 JSON 放当前项目或当前会话 `$TMPDIR`。命令会验证图片、实际解码二维码并上传;不要把本地路径写进发送 payload,不手抄二维码内容。
32
- 5. `ec pay request --spec-file <文件>`;同笔请求用稳定的 `idempotency_key`。
33
- 6. 告知等待用户付款后结束本 turn。付款协调器会持久安排后续事件,不要阻塞 sleep、反复发二维码或另建巡检 Trigger。
71
+ 2. 分清网站支持的渠道和每张码的适用渠道。微信码只绑微信、支付宝码只绑支付宝;页面支持双渠道但当前只有微信码时,支付宝标 `requires_site_switch`。无法确定保留 `unknown`,不猜成聚合码。
72
+ 3. 提取商品、用途、网站 origin、订单号、页面金额与币种、码有效期、订单有效期。金额与期限看不到用 `null`,不补零、不虚构「十分钟」——请求自身缺省十分钟,由系统标明为请求时限。**订单号从页面 API 响应或 URL 里取;取不到就整个省略 `order_id`,绝不写 `null` 或 `""`。**
73
+ 4. 优先取原始码图。仅在无法提取原图时,可裁剪截图并保留二维码白边,裁剪图仅作为 `ec pay` 的本地输入。命令会验证、解码并上传码图;不要把本地路径写进发送 payload,也不要手抄二维码内容。禁止将付款页截图、二维码裁剪图或原始码图作为普通消息或附件转发,必须通过标准付款卡片交付。
74
+ 5. 写完 spec 先过一遍下面的「提交前自检」,再一次执行 `ec pay request`。
75
+ 6. 告知等待用户付款后结束本 turn。协调器会持久安排后续事件,不要阻塞 sleep、反复发码或另建巡检 Trigger。
34
76
 
35
- ### request spec 骨架
77
+ ### request spec
78
+
79
+ 下面这份是**最小可用集**,每个键都必填,照抄即可跑通。双渠道支持时再加一条 `method_options`
80
+ (`alipay` + `requires_site_switch`)。
36
81
 
37
82
  ```json
38
83
  {
39
- "idempotency_key": "example-order-001",
40
- "source": {"origin": "https://example.com", "order_id": "EX-001", "purpose": "开通用户指定的月度会员"},
41
- "product": {"title": "Pro 月度会员", "quantity": 1},
84
+ "source": {"origin": "https://example.com", "order_id": "EX-001"},
85
+ "product": {"title": "Pro 月度会员"},
42
86
  "amount": {"value_minor": 2900, "currency": "CNY", "source": "page_text"},
43
- "attachments": [{"file_path": "<绝对路径>/wechat-qr.png"}],
87
+ "attachments": [{"file_path": "/绝对路径/wechat-qr.png"}],
44
88
  "method_options": [
45
- {"provider": "wechat", "availability": "ready", "qr_ids": ["wechat-1"], "evidence": {"source": "page_text", "text": "当前微信支付标签"}},
46
- {"provider": "alipay", "availability": "requires_site_switch", "qr_ids": [], "evidence": {"source": "page_text", "text": "页面有支付宝标签"}}
89
+ {"provider": "wechat", "availability": "ready", "qr_ids": ["q1"], "evidence": {"source": "page_text"}}
47
90
  ],
48
- "qr_codes": [{"id": "wechat-1", "attachment_index": 0, "providers": ["wechat"], "expires_at_ms": null}],
49
- "order_expires_at_ms": null
91
+ "qr_codes": [
92
+ {"id": "q1", "attachment_index": 0, "providers": ["wechat"], "source": "page_screenshot"}
93
+ ]
50
94
  }
51
95
  ```
52
96
 
53
- 硬约束:`availability` ∈ `ready|requires_site_switch|unavailable|unknown`,`ready` 必须给显式页面/码证据并关联码;
54
- `amount.value_minor` 是最小币种单位的**整数**;`source.origin` 是不带凭据、路径、查询的 HTTPS origin;
55
- `source`(金额来源)∈ `page_text|page_dom|qr_payload|inferred|unknown`。
97
+ 补其他键时按三类处理——**这三类的行为完全不同,混用就是失败重试的来源**:
98
+
99
+ | 类别 | 字段 | 规则 |
100
+ |---|---|---|
101
+ | 必填 | 骨架全部;`qr_codes[].source` 最常漏 | 少一个即 `INVALID_ARGUMENT` |
102
+ | 可省略,但**不能**写 `null` / `""` | `source.order_id` `source.purpose` `product.description` `product.quantity` `merchant` `idempotency_key` | 没有就**整个键不写**;空值报 `expected string` 或 `Too small` |
103
+ | **可以** `null` | `amount.value_minor` `amount.currency` `qr_codes[].expires_at_ms` `order_expires_at_ms` | 只有"未知"才写,也可直接省略 |
104
+
105
+ 拿不准就**整个键省略**——省略永远合法,`null` 不一定。
106
+
107
+ 字段明细(骨架里没有的那几个):
108
+
109
+ | 字段 | 说明 |
110
+ |---|---|
111
+ | `source.purpose` | 用途,一句话 |
112
+ | `product.description` / `quantity` | 描述;数量是正整数 |
113
+ | `product.image_attachment_index` | 商品图在 `attachments` 里的下标;更新 `media` 时必须保留 |
114
+ | `merchant` | `{name, source}` |
115
+ | `method_options[].qr_ids` | 数组可空;仅 `ready` 时可非空,且必须指向 `qr_codes` 里真实存在的 `id` |
116
+ | `method_options[].evidence` | `{source, text}`,`text` 可省;`ready` 不接受 `inferred` / `unknown` 证据 |
117
+ | `qr_codes[].id` | `[A-Za-z0-9_-]{1,100}`,与 `qr_ids` 对应 |
118
+ | `qr_codes[].attachment_index` | 0–3,指向 `attachments` 下标 |
119
+ | `qr_codes[].providers` | 数组,1–2 项 |
120
+ | `qr_codes[].expires_at_ms` | 网站给出的码过期时间;未知写 `null` 或省略 |
121
+ | `qr_codes[].raw_payload` | 可选;给了就必须与图片实际解码内容一致 |
122
+ | `idempotency_key` | 同 session 同 key 重试返回同一请求;同 key 换参数报 `IDEMPOTENCY_CONFLICT` |
123
+ | `expires_at_ms` | 请求级期限,省略默认十分钟;显式值须在当前至未来 24 小时内 |
124
+
125
+ 枚举:`qr_codes[].source` 只有 `page_image`(原始图)/`page_screenshot`(截图)/`page_dom`(DOM 提取)
126
+ 三选一,**没有第四个值,也不能省略**。`availability` ∈ `ready|requires_site_switch|unavailable|unknown`。
127
+ `amount.source`(金额来源)∈ `page_text|page_dom|qr_payload|inferred|unknown`。
128
+
129
+ 其余硬约束:所有对象都 `.strict()`,**加 schema 以外的键会让整次请求失败**。`amount.value_minor`
130
+ 是最小币种单位的**整数**;`amount.currency` 是三位大写字母;`source.origin` 是不带凭据、路径、
131
+ 查询的 HTTPS origin。`idempotency_key` 只允许 `[A-Za-z0-9_-]`,最长 128 字符——不要用订单描述或中文。
132
+
133
+ 数量上限:`attachments` 最多 4 张 PNG/JPEG/WebP,每张 ≤ 4 MiB、≤ 1600 万像素;`qr_codes` 最多 4 条;
134
+ `method_options` 最多 2 条;`method_options[].qr_ids` 最多 4 个。spec 文件本身 ≤ 64 KiB。
135
+
136
+ 全部输出为 JSON,可显式加 `--format json`(只接受 `json` 这一个值)。
137
+
138
+ ### 提交前自检
139
+
140
+ 执行前扫一遍,比失败重试便宜:
141
+
142
+ 1. 没有该省略却写成 `null`/`""` 的字符串字段。
143
+ 2. `attachments` 每个 `file_path` 真实存在,且是 PNG/JPEG/WebP。
144
+ 3. `method_options` 里 `ready` 的 `qr_ids` 都能在 `qr_codes` 找到同名 `id`,且该码 `providers` 含此渠道。
145
+ 4. `source.origin` 只是 origin,没有路径和查询串。
146
+
147
+ 报错形如 `{"ok":false,"code":"INVALID_ARGUMENT","error":"qr_codes.0.source | Invalid option: ..."}`,
148
+ `|` 前就是字段路径,按它定位;同一次会返回多条。
56
149
 
57
150
  ## 处理付款任务事件
58
151
 
59
- 1. 读事件 request-id / event-id / kind,`ec pay status <request-id>` 取最新状态与版本。
152
+ 1. 读事件 request-id / event-id / kind,`ec pay status` 取最新状态与版本。
60
153
  2. `verify`:检查原网站订单。不能把用户「已付款」、返回 App、点了按钮当成成功证据。
61
- 3. `refresh` / `select.wechat` / `select.alipay`:先核验原订单;已付直接提交 `paid`,结果不明提交 `unknown`。确认未付后才刷新码或切原网站渠道,不重新下单。新码绑定对应渠道,不只改按钮名称。
62
- 4. 写 update JSON(骨架见下),含当前 `expected_state_version`、事件 `event_id`、原订单核验;切渠道或刷新成功可同时提交 `media`。`ec pay update <request-id> --spec-file <文件>`。
63
- 5. 版本冲突重新 `status` 并核对是否取消/到期;不要覆盖新状态。已取消或到期仍可提交真实原订单核验,但不能继续替换付款码。
64
- 6. `continue`:原订单已核验付款。先检查后续步骤此前是否已完成,再继续原任务,避免重复购买或开通;完成后 `ec pay complete <request-id> --event-id <event-id>`。
154
+ 3. `refresh` / `select.wechat` / `select.alipay`:先核验原订单;已付直接提交 `paid`,不明提交 `unknown`。确认未付后才刷新码或切原网站渠道,不重新下单。新码绑定对应渠道,不只改按钮名称。
155
+ 4. 写 update JSON,含当前 `expected_state_version`、事件 `event_id`、原订单核验;切渠道或刷新成功可同时提交 `media`。`ec pay update <request-id> --spec-file <文件>`。
156
+ 5. 版本冲突重新 `status` 并核对是否取消/到期,不要覆盖新状态。已取消或到期仍可提交真实核验,但不能替换付款码。
157
+ 6. `continue`:原订单已核验付款。先检查后续步骤此前是否已完成,再继续原任务,避免重复购买或开通;完成后 `ec pay complete`。
65
158
 
66
- ### update spec 骨架
159
+ ### update spec
67
160
 
68
161
  ```json
69
162
  {
@@ -79,23 +172,52 @@ ec pay verify|refresh|cancel <request-id>
79
172
  }
80
173
  ```
81
174
 
82
- `order_state` ∈ `pending|paid|failed|unknown`,`source` ∈ `website_order|website_success_page|payment_api`。
175
+ `expected_state_version` 与 `event_id` 都来自最近一次 `status`。`order_state` ∈
176
+ `pending|paid|failed|unknown`,`verification.source` ∈ `website_order|website_success_page|payment_api`。
83
177
  原请求有订单号时核验必须返回相同 `order_id`;`checked_at_ms` 不得早于本事件,也不得比当前时间晚 30 秒以上。
84
- 需要换码时加 `media`:`{attachments, method_options, qr_codes}`,结构与 request 一致,必须保留商品图下标。
85
178
 
86
- ### 常见报错
179
+ 换码时加 `media`:`{attachments, method_options, qr_codes}`,结构与 request 相同,必须保留商品图下标。
180
+ **`verify` 事件不能替换码**;切渠道或 `refresh` 仅在核验为 `pending` 且请求 `active` 时可换。
181
+ 切指定渠道成功后该渠道必须 `ready`。已取消 / 到期不能换码,但仍可提交已发生的付款核验。
182
+
183
+ 客户端动作不能直接写 `paid`。只有当前 Owner 原会话中有效委托的 update 才能提交网站观察证据——
184
+ 这表示 Agent 对原网站的核验结果,不是支付平台签名证明。
185
+
186
+ ### 错误码
187
+
188
+ 前六个会实际遇到,按「动作」改;其余只在特定状态出现,一般重新 `status` 就能定位。
87
189
 
88
190
  | 码 | 含义 | 动作 |
89
191
  |---|---|---|
90
- | `QR_INVALID` | 码没解出来,或与 `raw_payload` 不符 | 重新裁剪,保留白边,整张码图完整;不手抄码内容 |
192
+ | `INVALID_ARGUMENT` | 参数形态不对 | 按 `error` 里的字段路径改,竖线前即字段名 |
193
+ | `QR_INVALID` | 码解码失败、与 `raw_payload` 不符或已过期 | 重新裁剪,保留白边,整张码图完整;不手抄码内容 |
91
194
  | `ORDER_EXISTS` | 同网站同订单号已有请求 | 用原请求 `status`/`verify`/`refresh`,不新建 |
92
195
  | `STALE_VERSION` | `expected_state_version` 过期 | 重新 `status` 取版本,不覆盖 |
93
- | `INVALID_EVENT` | 事件已消费,或当前状态不允许该动作 | 重新 `status`,按 `pending_events` 选事件 |
94
- | `VERIFICATION_REQUIRED` | 缺原订单核验 | 回网站查订单后再提交 |
196
+ | `INVALID_EVENT` | 事件不存在、已消费,或状态不允许该动作 | 重新 `status`,按 `pending_events` 选 |
95
197
  | `IDEMPOTENCY_CONFLICT` | 同 key 换了参数 | 参数变了就换 key,否则改正参数 |
198
+ | `VERIFICATION_REQUIRED` | 缺原订单核验 | 回网站查订单后再提交 |
199
+ | `INVALID_VERIFICATION` | 核验与原订单或待办事件不匹配 | 核对 `order_id` 与事件 |
200
+ | `ORDER_PAID` | 订单已付,不能再改码 | 停止改码,走 `continue` |
201
+ | `METHOD_NOT_READY` | 所选渠道仍无可用码 | 先拿到可用码再标 `ready` |
202
+ | `ACTION_IN_PROGRESS` | 已有未完成的付款操作 | 等 `status` 显示完成再动 |
203
+ | `REQUEST_EXPIRED` | 请求超期 | 说明情况,按需重新发起 |
204
+ | `CAPACITY_REACHED` | 达到每 Agent 1000 份请求上限 | 告知用户需清理历史 |
205
+ | `NOT_AUTHORIZED` | Ownership 已变,或请求属于另一会话 | 停止,不改路由重试 |
206
+ | `RECORD_UNAVAILABLE` | 请求记录不可读 | 报告,不猜测 |
207
+ | `INVALID_ACTION` | 卡片动作在当前状态不可用 | 重新 `status` 取可用动作 |
208
+ | `CHANNEL_UNAVAILABLE` | Agent 的 AUN 渠道不可用 | 报告,属环境问题 |
209
+ | `DELEGATION_REQUIRED` | 当前不是有效委托的 Owner 会话 | 回到 Owner AUN 私聊发起,不在别处重试 |
210
+ | `DELIVERY_FAILED` | 可靠投递永久失败 | 报告;`status` 看 `delivery` 定位 |
211
+ | `PAYMENT_FAILED` | 未归类的 CLI 失败 | 读 `error` 原文报告,不猜测原因 |
96
212
 
97
213
  ## 边界
98
214
 
99
- 付款由用户在钱包确认,Agent 不请求、保存或填写钱包密码。微信 / 支付宝能否直接唤起取决于具体码和平台,客户端可能提供保存、相册识码或另一设备扫码。
215
+ 付款由用户在钱包确认,Agent 不请求、保存或填写钱包密码。微信 / 支付宝能否直接唤起取决于具体码和平台,
216
+ 客户端可能提供保存、相册识码或另一设备扫码。
217
+
218
+ 取消本次请求不等于撤销网站订单或退款。**结果未知时不发起第二笔付款。** 不要用 `ecmsg --payload`
219
+ 手工拼付款卡绕过协调器——用 `ec pay`,底层复用受鉴权发送通道。页面不可访问或订单不匹配时提交
220
+ `unknown` 并说明,不宣称成功。
100
221
 
101
- 取消本次请求不等于撤销网站订单或退款。结果未知时不发起第二笔付款。不要用 `ecmsg --payload` 手工拼付款卡绕过协调器——用 `ec pay`,底层复用受鉴权发送通道。页面不可访问或订单不匹配时提交 `unknown` 并说明,不宣称成功。
222
+ `data/payments/` 是 daemon 保护状态,不能直接编辑。队列去重不等于外部网站支持 exactly-once——
223
+ 网站侧副作用仍需核对是否已执行。不提供退款、个人转账或自动扣款。
@@ -124,7 +124,7 @@ baseagents = {"claude":{"provider":"provider-1","model":"deepseek-v4.1-flash","e
124
124
  ## 三、验证(配置或换 key 后必做,一次调用)
125
125
 
126
126
  ```bash
127
- node "<技能目录>/scripts/check-model.mjs" --base-url <协议基础地址> --api-key <key> \
127
+ node "{{skillDir}}/scripts/check-model.mjs" --base-url <协议基础地址> --api-key <key> \
128
128
  --style <claude|codex|gemini|openai-compatible> --model <模型ID> [--timeout 30]
129
129
  ```
130
130
 
@@ -161,10 +161,10 @@ ec model list [--format json] # 可选模型
161
161
 
162
162
  ```bash
163
163
  # Provider 已注册:用注册表里的密钥实测
164
- node "<技能目录>/scripts/check-model.mjs" --provider <id> --service <服务类型> --list-models
164
+ node "{{skillDir}}/scripts/check-model.mjs" --provider <id> --service <服务类型> --list-models
165
165
 
166
166
  # Provider 还没注册:用外部传入的地址和密钥
167
- node "<技能目录>/scripts/check-model.mjs" --base-url <url> --api-key <key> --style openai-compatible --list-models
167
+ node "{{skillDir}}/scripts/check-model.mjs" --base-url <url> --api-key <key> --style openai-compatible --list-models
168
168
  ```
169
169
 
170
170
  **一次只测一个服务。** 不写 `--service` 时按 `claude` → `text` → 模板声明顺序的第一个回落,
@@ -180,7 +180,7 @@ node "<技能目录>/scripts/check-model.mjs" --base-url <url> --api-key <key> -
180
180
  **任何切换动作之前,必须先实测目标模型可用。** 顺序不能反——先切换再发现不通,就是一次线上故障。
181
181
 
182
182
  ```bash
183
- node "<技能目录>/scripts/check-model.mjs" --provider <provider-id> --service <服务类型> --model <model-id>
183
+ node "{{skillDir}}/scripts/check-model.mjs" --provider <provider-id> --service <服务类型> --model <model-id>
184
184
  ```
185
185
 
186
186
  判定:`"ok": true` 且 HTTP 成功才算通过;HTTP 200 的空响应或错误对象仍失败。失败时看返回里的 `code` / `status`:
@@ -214,7 +214,7 @@ node "<技能目录>/scripts/check-model.mjs" --provider <provider-id> --service
214
214
 
215
215
  ```bash
216
216
  # 1. 先测通
217
- node "<技能目录>/scripts/check-model.mjs" --provider provider-91036436 --model deepseek-flash
217
+ node "{{skillDir}}/scripts/check-model.mjs" --provider provider-91036436 --model deepseek-flash
218
218
 
219
219
  # 2. 再切换(先绑 provider,再改 model;反过来会留下 model 不属于 provider 的窗口)
220
220
  ec config set baseagents.claude.provider provider-91036436 --self <AID>
@@ -94,6 +94,9 @@ ec services call --aid alice.agentid.cn --type services.order.create --data '{"s
94
94
  - 业务失败:同 type、`ok:false`、`error.code` + `error.message`。
95
95
  - `data` 是**纯调用方正文**,不含 `chatmode` / `client_signature` / `thread_id` / `topicName`
96
96
  ——服务调用没有话题概念。
97
+ - **`data` 里禁止出现 `type`**:那是信封字段,决定请求路由到哪个处理器。写了会被拒
98
+ (`INVALID_ARGV`),不是被忽略——旧的静默行为会把请求投给另一个 type,而调用方
99
+ 拿到一个看起来合理的回包。业务字段叫 `type` 的,改用 `aid_type` / `service_type` 之类。
97
100
 
98
101
  ## 五、失败码怎么读
99
102
 
@@ -91,10 +91,22 @@ EC 的技能系统:**一组可加载的能力单元**,每个技能是一个
91
91
  `disable` 之后,或手改了 `.switches.json`、SKILL.md 的 description,都要再执行一次
92
92
  `refresh <当前 AID>` 让 daemon 重建索引,否则模型看到的仍是旧列表。
93
93
 
94
- ### 路径:模型自己拼绝对路径
94
+ ### 路径:技能目录写成 `{{skillDir}}`
95
95
 
96
- EC 不会把 cwd 设到技能目录,所以 `SKILL.md` 里写裸相对路径(`scripts/foo.mjs`)时,
97
- **必须由模型自己拼成绝对路径再执行**。索引文件里给了根目录和拼法。
96
+ EC 不会把 cwd 设到技能目录,所以 `SKILL.md` 里的脚本路径必须是绝对路径。
97
+ 技能目录要引用的地方,一律写成 `{{skillDir}}`,`ec skill load` 输出时替换成本机绝对路径
98
+ (统一正斜杠,Windows 直接可用):
99
+
100
+ ```bash
101
+ node "{{skillDir}}/scripts/foo.mjs"
102
+ ```
103
+
104
+ 正文因此不含任何本机路径,换机器、换用户名、改安装位置都不用改。旧写法 `<技能目录>` 同样处理;
105
+ 占位符后面不跟路径分隔符时原样保留,所以正文里可以正常提到它。直接 `Read` / `cat` 读到的是
106
+ 未渲染的占位符——要执行就用加载输出,或照页脚的 `skillDir:` 自己替换。
107
+
108
+ **不要用 `$EVOLCORE_HOME` 拼**——内置技能根是安装目录下的 `kits/skills`;`$EVOLCORE_HOME` 是运行时
109
+ 数据根(local 级技能在 `$EVOLCORE_HOME/skills`),装在内置级时两边不是一个目录。
98
110
 
99
111
  配套硬要求:**脚本内部要用自身位置定位资源**,不能依赖 cwd:
100
112
 
@@ -131,12 +143,14 @@ description: >- # 最关键:写清做什么 + 触发场景 +
131
143
  正文建议结构:**目标 → 步骤(编号、祈使句)→ 输出契约 → 边界情况 → 参考资料指引**。
132
144
  超过 500 行就把细节挪到 `references/`。
133
145
 
146
+ 正文里引用脚本时,技能目录按上面「路径」那节写:用 `{{skillDir}}`,不要写死本机绝对路径。
147
+
134
148
  ## 工具
135
149
 
136
150
  脚本自定位,**执行时必须写完整绝对路径**(不要依赖 cwd):
137
151
 
138
152
  ```bash
139
- node "<技能目录>/scripts/cli.mjs" <子命令>
153
+ node "{{skillDir}}/scripts/cli.mjs" <子命令>
140
154
  ```
141
155
 
142
156
  | 子命令 | 作用 |
@@ -155,7 +169,7 @@ node "<技能目录>/scripts/cli.mjs" <子命令>
155
169
  改动技能后执行一次 `refresh`,`<aid>` 填当前 Agent 自己的 AID(上下文里的 `selfAid`):
156
170
 
157
171
  ```bash
158
- node "<技能目录>/scripts/cli.mjs" refresh <selfAid>
172
+ node "{{skillDir}}/scripts/cli.mjs" refresh <selfAid>
159
173
  ```
160
174
 
161
175
  ### 常见任务
@@ -163,7 +177,7 @@ node "<技能目录>/scripts/cli.mjs" refresh <selfAid>
163
177
  **新建一个技能**:
164
178
 
165
179
  ```bash
166
- node "<技能目录>/scripts/cli.mjs" create my-analyzer --desc "分析日志并汇总。当用户要求分析日志时使用。"
180
+ node "{{skillDir}}/scripts/cli.mjs" create my-analyzer --desc "分析日志并汇总。当用户要求分析日志时使用。"
167
181
  ```
168
182
 
169
183
  生成后**必须补全 description**——它是技能被选中的唯一依据。
@@ -175,7 +189,7 @@ node "<技能目录>/scripts/cli.mjs" create my-analyzer --desc "分析日志并
175
189
  就等于禁用,技能不进索引、不会被模型选中。确认要用之后显式启用:
176
190
 
177
191
  ```bash
178
- node "<技能目录>/scripts/cli.mjs" enable <name>
192
+ node "{{skillDir}}/scripts/cli.mjs" enable <name>
179
193
  ```
180
194
 
181
195
  需要装完即启用时加 `--enable`(此时才写入 `{"enabled": true}`):
@@ -197,14 +211,16 @@ node "<技能目录>/scripts/cli.mjs" enable <name>
197
211
  | 情形 | 结果 |
198
212
  |------|------|
199
213
  | 群聊里(**含 owner 本人**) | 一律拒绝 |
200
- | 私聊 + Agent 级写(`--level agent`,默认) | 需本 Agent 的 **owner** |
201
- | 私聊 + 本机级写(`install` / `remove` / `create` / `--level local`) | 需 **daemonowner** |
214
+ | 私聊 + Agent 级写(`--level agent`,默认) | 需本 Agent 的 **owner 或 admin** |
215
+ | 私聊 + 本机级写(`install` / `remove` / `create` / `--level local`) | 需 Control AID 当前 Ownership 协议共识确认的 **DaemonOwner** |
202
216
  | 宿主终端直连(无会话上下文) | 放行 |
203
217
 
204
218
  **在群里被拒时不要重试、不要换参数绕过**:这是设计使然——技能开关是 agent 自身配置,
205
219
  不该被群里的对话推动。直接把结论告诉对方,请其私聊提出或由管理员在终端执行。
206
220
 
207
221
  本机级目录是**整机所有 agent 共享**的,所以装/删/建和本机级开关同档,都要 daemonowner。
222
+ CLI 和直接运行技能脚本均通过 daemon 验证任务委托及写入权限;不读取旧 `daemon.json.owners` 授权。
223
+ 只读任务禁止写入;协议归属不可核验时拒绝本机级写入。daemon 验证的本轮 fullaccess 授权按其权限执行。
208
224
 
209
225
  只读子命令(`list` / `info` / `where` / `validate`)不受限制。
210
226
 
@@ -15,7 +15,7 @@ const USAGE = `用法: ec skill <command> [options]
15
15
  ec skill —— EC 技能管理
16
16
 
17
17
  ec skill load <name> [--source builtin|local] [--with-frontmatter]
18
- 加载技能正文(输出 SKILL.md 内容 + skillDir)
18
+ 加载技能正文(输出 SKILL.md 内容 + skillDir + 字符数)
19
19
  ec skill path <name> [--json] 查看技能 SKILL.md 完整路径(含状态和时间戳)
20
20
  ec skill list [--all] [--filter '<kw1,kw2>']... [--page <n>] [--limit <n>] [--json]
21
21
  列出技能(默认仅启用;--all 全部;--filter 匹配名称+描述,组内逗号分隔为 OR,多组之间为 AND;超过 limit 条自动分页)
@@ -33,7 +33,7 @@ ec skill —— EC 技能管理
33
33
  ec skill refresh <aid> [--json] 重建该 Agent 的技能索引(经 daemon)
34
34
 
35
35
  说明:
36
- - 加载技能用 load,输出正文末尾附带 skillDir 绝对路径,脚本路径以此为根
36
+ - 加载技能用 load,输出正文末尾附带 skillDir 绝对路径与正文字符数 chars,脚本路径以 skillDir 为根
37
37
  - 安装目标只能是本机级(Agent 级只放开关,不放 SKILL.md)
38
38
  - create / install 装完默认禁用,确认后再用 enable 启用(--enable 可一步到位)
39
39
  - 内置级(随包发布)不可写、不可删
@@ -127,23 +127,23 @@ async function main() {
127
127
  return 0;
128
128
 
129
129
  case 'create':
130
- emit(S.cmdCreate(positional[0], { desc: flags.desc || '', force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
130
+ emit(await S.cmdCreate(positional[0], { desc: flags.desc || '', force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson, argv }));
131
131
  return 0;
132
132
 
133
133
  case 'install':
134
- emit(S.cmdInstall(positional[0], { force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
134
+ emit(await S.cmdInstall(positional[0], { force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson, argv }));
135
135
  return 0;
136
136
 
137
137
  case 'remove':
138
- emit(S.cmdRemove(positional[0], { json: asJson }));
138
+ emit(await S.cmdRemove(positional[0], { json: asJson, argv }));
139
139
  return 0;
140
140
 
141
141
  case 'enable':
142
- emit(S.cmdEnableDisable(positional[0], true, { level: flags.level || 'agent', json: asJson }));
142
+ emit(await S.cmdEnableDisable(positional[0], true, { level: flags.level || 'agent', json: asJson, argv }));
143
143
  return 0;
144
144
 
145
145
  case 'disable':
146
- emit(S.cmdEnableDisable(positional[0], false, { level: flags.level || 'agent', json: asJson }));
146
+ emit(await S.cmdEnableDisable(positional[0], false, { level: flags.level || 'agent', json: asJson, argv }));
147
147
  return 0;
148
148
 
149
149
  case 'validate': {