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
@@ -61,41 +61,27 @@ function refreshHint() {
61
61
  // 群聊一律拒绝——包括 owner 亲自下指令。技能开关是 agent 的自身配置,
62
62
  // 不该被群里的对话推动(owner 要改就私聊说)。
63
63
  //
64
- // 判据取自 daemon 注入的运行时上下文(EVOLCORE_TASK_RUNTIME_CONTEXT)。
65
- // peerRole 是关系层角色,peerId 是 daemon 自己填的对端原生 ID,会话内伪造不了。
64
+ // 托管写操作通过 daemon IPC 验证任务委托及当前 Ownership 协议共识,
65
+ // 不将环境变量副本或旧 daemon.json.owners 当作授权依据。
66
66
  // 无上下文(宿主终端直连、daemon 自己的调度脚本、CI)视为本机管理员在操作,放行。
67
67
  //
68
- // 门禁只在本文件实现:CLI(ec skill)和模型侧(node skill.mjs)共用同一份实现,
69
- // 放 CLI 层挡不住模型直接跑脚本那条路径。
68
+ // CLI(ec skill)和模型侧脚本共用本文件的 IPC 校验入口,
69
+ // daemon 根据实际命令作用域决定写权限。
70
70
 
71
71
  const RUNTIME_CONTEXT_ENV = 'EVOLCORE_TASK_RUNTIME_CONTEXT';
72
72
 
73
- /** 读取 daemonowner 名单(daemon.json 的 owners[]);读不到返回空数组 */
74
- function daemonOwners() {
75
- const file = path.join(evolcoreHome(), 'daemon.json');
76
- try {
77
- const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
78
- if (!Array.isArray(data?.owners)) return [];
79
- return data.owners.map(v => String(v || '').trim()).filter(Boolean);
80
- } catch {
81
- return [];
82
- }
83
- }
84
-
85
73
  /**
86
74
  * 校验当前调用方对某一级的写权限。
87
75
  * @param {'agent'|'local'} scope
88
76
  */
89
- function assertPermission(scope) {
90
- const raw = process.env[RUNTIME_CONTEXT_ENV];
91
- if (!raw) return; // 无上下文:终端直连,放行
92
-
93
- let ctx;
94
- try {
95
- ctx = JSON.parse(raw);
96
- } catch {
97
- return; // 上下文损坏按无上下文处理,与本目录既有的「读不到就退回默认」一致
98
- }
77
+ async function assertPermission(scope, argv) {
78
+ const managed = process.env[RUNTIME_CONTEXT_ENV] !== undefined
79
+ || process.env.EVOLCORE_SESSION_ID !== undefined
80
+ || process.env.EVOLCORE_DELEGATION_TOKEN !== undefined
81
+ || process.env.EVOLCORE_CODEX_SESSION_TOKEN !== undefined;
82
+ if (!managed) return; // 宿主终端直连
83
+ const { authorizeLocalCommand } = await import(pathToFileURL(path.join(packageRoot(), 'dist', 'cli', 'task-context.js')).href);
84
+ const ctx = await authorizeLocalCommand(['skill', ...argv]);
99
85
 
100
86
  const chatType = ctx?.chatType;
101
87
  const target = scope === 'local' ? '本机级' : 'Agent 级';
@@ -104,7 +90,12 @@ function assertPermission(scope) {
104
90
  // Do not trust the environment marker by itself; it is only present here
105
91
  // after the managed command context was validated through IPC.
106
92
  if (ctx?.processRole === 'fullaccess-run' && ctx?.dataScope === 'daemon'
107
- && ctx?.permissionMode === 'fullaccess' && ctx?.authorizedBy) return;
93
+ && ctx?.permissionMode === 'fullaccess' && ctx?.authorizedBy) {
94
+ setAgentContext(ctx);
95
+ return;
96
+ }
97
+
98
+ if (ctx?.permissionMode === 'readonly') throw new Error('拒绝:只读任务不能修改技能。');
108
99
 
109
100
  if (chatType === 'group') {
110
101
  throw new Error(
@@ -118,17 +109,24 @@ function assertPermission(scope) {
118
109
  `拒绝:Agent 级技能开关仅限本 Agent 的 owner 或 admin(当前角色:${ctx?.peerRole || '未知'})。`
119
110
  );
120
111
  }
112
+ setAgentContext(ctx);
121
113
  return;
122
114
  }
123
115
 
124
116
  // 本机级:所有 agent 共享,仅 daemonowner 可改
125
117
  const peerId = String(ctx?.peerId || '').trim();
126
- if (!peerId || !daemonOwners().includes(peerId)) {
118
+ if (!peerId || ctx?.processRole !== 'daemon-owner' || ctx?.dataScope !== 'daemon') {
127
119
  throw new Error(
128
120
  `拒绝:本机级技能为整机所有 agent 共享,仅限 daemonowner 安装、删除、创建与开关。`
129
121
  + `\n 当前身份:${peerId || '未知'}(可用 ec skill where 查看本机级目录)`
130
122
  );
131
123
  }
124
+ setAgentContext(ctx);
125
+ }
126
+
127
+ function setAgentContext(ctx) {
128
+ process.env.EVOLCORE_SELF_AID = ctx.selfAid;
129
+ process.env.EVOLCORE_AGENT_DIR = path.join(evolcoreHome(), 'agents', ctx.selfAid);
132
130
  }
133
131
 
134
132
  // ── 开关读写 ──────────────────────────────────────────────────────────
@@ -466,8 +464,8 @@ export function resolveSkillDirArg(target) {
466
464
  throw new Error(`找不到技能: ${target}`);
467
465
  }
468
466
 
469
- export function cmdCreate(name, { desc = '', force = false, enable = false, json = false } = {}) {
470
- assertPermission('local'); // 骨架固定建在本机级,与 install 同档
467
+ export async function cmdCreate(name, { desc = '', force = false, enable = false, json = false, argv } = {}) {
468
+ await assertPermission('local', argv ?? ['create', name, '--desc', desc, ...(force ? ['--force'] : []), ...(enable ? ['--enable'] : [])]);
471
469
  if (!name) throw new Error(`缺少技能名。用法:ec skill create <name> --desc '...'`);
472
470
  if (!NAME_RE.test(name)) {
473
471
  throw new Error(`技能名「${name}」不符合 kebab-case(小写字母/数字/连字符,如 my-skill)`);
@@ -505,14 +503,14 @@ export function cmdCreate(name, { desc = '', force = false, enable = false, json
505
503
  '下一步:',
506
504
  ' 1. 补全 SKILL.md 的 description(决定技能会不会被选中,务必写清触发场景)',
507
505
  ' 2. 正文写清步骤;需要时把大块资料放 references/',
508
- ' 3. 需要脚本就放 scripts/,脚本内用 import.meta.dirname 自定位,不要依赖 cwd',
506
+ ' 3. 脚本放 scripts/,内部用 import.meta.dirname 自定位;正文里写 node "{{skillDir}}/scripts/xxx"',
509
507
  enable ? ` 4. 如需停用: ec skill disable ${name}` : ` 4. 完成后启用: ec skill enable ${name}`,
510
508
  ...(enable ? ['', refreshHint()] : []),
511
509
  ].join('\n');
512
510
  }
513
511
 
514
- export function cmdInstall(src, { force = false, enable = false, json = false } = {}) {
515
- assertPermission('local'); // 目标恒为本机级
512
+ export async function cmdInstall(src, { force = false, enable = false, json = false, argv } = {}) {
513
+ await assertPermission('local', argv ?? ['install', src, ...(force ? ['--force'] : []), ...(enable ? ['--enable'] : [])]);
516
514
  if (!src) throw new Error('缺少源。用法:ec skill install <目录|zip文件|SKILL.md>');
517
515
  if (!fs.existsSync(src)) throw new Error(`源不存在: ${src}`);
518
516
 
@@ -584,8 +582,8 @@ export function cmdInstall(src, { force = false, enable = false, json = false }
584
582
  }
585
583
  }
586
584
 
587
- export function cmdRemove(name, { json = false } = {}) {
588
- assertPermission('local'); // 只删本机级
585
+ export async function cmdRemove(name, { json = false, argv } = {}) {
586
+ await assertPermission('local', argv ?? ['remove', name]);
589
587
  if (!name) throw new Error('缺少技能名。用法:ec skill remove <name>');
590
588
  const roots = skillRoots();
591
589
  const target = path.join(roots.local, name);
@@ -617,13 +615,13 @@ export function cmdRemove(name, { json = false } = {}) {
617
615
  return [`✅ 已删除本机技能 ${name}`, refreshHint()].join('\n');
618
616
  }
619
617
 
620
- export function cmdEnableDisable(name, enabled, { level = 'agent', json = false } = {}) {
618
+ export async function cmdEnableDisable(name, enabled, { level = 'agent', json = false, argv } = {}) {
621
619
  if (!name) throw new Error(`缺少技能名。用法:ec skill ${enabled ? 'enable' : 'disable'} <name>`);
622
620
  if (!['agent', 'local'].includes(level)) {
623
621
  throw new Error(`--level 只能是 agent 或 local(内置级不可写)`);
624
622
  }
625
623
  // 级别校验通过后再判权限,避免非法 --level 先撞权限门禁而掩盖真实错因
626
- assertPermission(level === 'local' ? 'local' : 'agent');
624
+ await assertPermission(level === 'local' ? 'local' : 'agent', argv ?? [enabled ? 'enable' : 'disable', name, '--level', level]);
627
625
 
628
626
  const roots = skillRoots();
629
627
  const dir = roots[level];
@@ -746,10 +744,26 @@ export async function cmdLoad(name, { source = null, withFrontmatter = false, js
746
744
  if (!withFrontmatter) {
747
745
  content = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
748
746
  }
749
- const footer = `\n---\nskillDir: ${skillDir}\n`;
750
- const output = content.trimStart() + footer;
751
-
752
- if (json) return { name, skillDir, content: output };
747
+ // {{skillDir}} 是技能自带的路径占位符:正文里只写相对结构({{skillDir}}/scripts/x.mjs),
748
+ // 加载时渲染成本机绝对路径。这样换机器、换安装位置都不用改正文,
749
+ // 也不会把用户名之类的本机信息写死在技能里。
750
+ // 旧写法 `<技能目录>` 一并兼容。
751
+ const raw = content.trimStart();
752
+ // 字符数按码点算,中文一字算 1;用 body.length 会把 emoji 算成 2。
753
+ // 先算再渲染占位符,chars 才反映技能正文本身,不受安装路径长度影响。
754
+ const chars = Array.from(raw).length;
755
+ // 只替换后面紧跟路径分隔符的占位符。正文里讲占位符本身的句子(「写成 {{skillDir}}」)
756
+ // 不该被替换,否则说明文字会变成一句实际路径,读起来自相矛盾。
757
+ // Windows 绝对路径是反斜杠,正文里占位符后面写的是 /,混拼会出 `...\ec-skill/scripts`;
758
+ // 统一渲染成正斜杠,Windows 的 node 也认。
759
+ const dirForBody = skillDir.replace(/\\/g, '/');
760
+ const body = raw
761
+ .replace(/\{\{skillDir\}\}(?=[\\/])/g, dirForBody)
762
+ .replace(/<技能目录>(?=[\\/])/g, dirForBody);
763
+ const footer = `\n---\nskillDir: ${skillDir}\nchars: ${chars}\n`;
764
+ const output = body + footer;
765
+
766
+ if (json) return { name, skillDir, chars, content: output };
753
767
  return output;
754
768
  }
755
769
 
@@ -25,6 +25,15 @@ description: >-
25
25
  - 输入缺失时如何处理
26
26
  - 遇到不适用场景时如何退出
27
27
 
28
+ ## 脚本
29
+
30
+ 需要脚本就放 `scripts/`,脚本内部用 `import.meta.dirname` 自定位,不要依赖 cwd。
31
+ 正文里引用脚本时,技能目录写 `{{skillDir}}`:
32
+
33
+ ```bash
34
+ node "{{skillDir}}/scripts/foo.mjs"
35
+ ```
36
+
28
37
  ## 参考资料
29
38
 
30
39
  (大块资料放 `references/`,在这里指出文件名。不要把它塞进本文件。)
@@ -21,7 +21,7 @@ license: MIT
21
21
  |---|---|
22
22
  | "明天早上 9 点提醒我带合同" | 一次 `--at` 或单次 cron,**trigger-session**,投递到用户的会话 |
23
23
  | "以后每天 9 点给我出昨日总结" | `--cron '0 9 * * *' --tz Asia/Shanghai`,**trigger-session**,投递用户会话 |
24
- | "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `msg send --check-every`,**不要自建 trigger**(见 thread-ops) |
24
+ | "帮我把这个任务跟到底,对方回了我马上告诉我" | 跨话题委托时用 `ecmsg send --thread <话题id> --check-every`,**不要自建 trigger**(见 thread-ops) |
25
25
  | "每 30 分钟看一眼升级有没有新版本" | `--every 30m`,**trigger-session**,提示词写"无变化只输出 `[[NOOP]]`",加 `--max-runs` |
26
26
  | "任务失败就自动继续 / 出错误告诉我" | `--event 'task:error'` 或 `--event 'message:received' --event-filter ...` |
27
27
  | "帮我盯着这个会话,闲下来时看看有没有漏掉的事" | 这是会话 loop,`/loop 300`(事件 `session:idle`),**不是**普通 trigger |
@@ -93,7 +93,7 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
93
93
  - **你被 trigger 唤醒时**:信封里的 `触发于:` 是排定时刻(firedAt),不是唤醒时刻;
94
94
  proactive 模式下正文流式输出会被丢弃,**回复必须走 `ec ctl send`**;`[[NOOP]]` 仍适用,
95
95
  只用它、别在它前后多说一句。
96
- - **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}`、
96
+ - **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}`、`{{run.every}}`(当前周期,仅 interval),
97
97
  `{{date}}`、`{{time}}`,事件触发另有 `{{event.<字段>}}`。提示词正文走同一套渲染。
98
98
  - **每次创建都是新 trigger**:重复建同一个提醒会得到多个 trigger,各自都会触发。先 `list` 查。
99
99
  - **列表默认只显示 enabled**:排查"怎么没有"要 `ec trigger list --all`。
@@ -47,7 +47,7 @@ license: MIT
47
47
  **规则**:
48
48
  - 能用脚本做的,不要你用语言"手工"做——不确定、贵、会漂移
49
49
  - 需要判断的,不要硬塞给脚本——规则写不全
50
- - 脚本一律用**绝对路径**调用:`node "<技能目录>/scripts/xxx.mjs"`
50
+ - 脚本一律用**绝对路径**调用:`node "{{skillDir}}/scripts/xxx.mjs"`
51
51
 
52
52
  ---
53
53
 
@@ -59,10 +59,10 @@ license: MIT
59
59
  传工作区路径和 AID,剩下全部由脚本完成。**
60
60
 
61
61
  ```bash
62
- node "<技能目录>/scripts/pa.mjs" init --workspace <路径> --self <AID> [--owner <AID>]
63
- node "<技能目录>/scripts/pa.mjs" clean --workspace <路径> --self <AID> [--yes]
64
- node "<技能目录>/scripts/pa.mjs" uninstall --workspace <路径> --self <AID> [--remove-triggers]
65
- node "<技能目录>/scripts/pa.mjs" update --workspace <路径> --self <AID>
62
+ node "{{skillDir}}/scripts/pa.mjs" init --workspace <路径> --self <AID> [--owner <AID>]
63
+ node "{{skillDir}}/scripts/pa.mjs" clean --workspace <路径> --self <AID> [--yes]
64
+ node "{{skillDir}}/scripts/pa.mjs" uninstall --workspace <路径> --self <AID> [--remove-triggers]
65
+ node "{{skillDir}}/scripts/pa.mjs" update --workspace <路径> --self <AID>
66
66
  ```
67
67
 
68
68
  | 操作 | 做什么 | 工作区档案 | 什么时候用 |
@@ -112,14 +112,14 @@ node "<技能目录>/scripts/pa.mjs" update --workspace <路径> --self <AID>
112
112
 
113
113
  ```bash
114
114
  # 1. 体检(先看是不是已经初始化过——见 3.2.1)
115
- node "<技能目录>/scripts/check.mjs" --workspace "<工作区绝对路径>"
115
+ node "{{skillDir}}/scripts/check.mjs" --workspace "<工作区绝对路径>"
116
116
 
117
117
  # 2. 初始化(参数一次给全,尤其 --self 和 --with-triggers)
118
- node "<技能目录>/scripts/pa.mjs" init --workspace "<工作区绝对路径>" \
118
+ node "{{skillDir}}/scripts/pa.mjs" init --workspace "<工作区绝对路径>" \
119
119
  --owner "<owner AID>" --self "<本 Agent AID>" --with-triggers
120
120
 
121
121
  # 3. 重建索引(init 已写 README/INDEX,这一步确保与现有文件一致)
122
- node "<技能目录>/scripts/index-rebuild.mjs" --workspace "<工作区绝对路径>"
122
+ node "{{skillDir}}/scripts/index-rebuild.mjs" --workspace "<工作区绝对路径>"
123
123
  ```
124
124
 
125
125
  最后再跑一次 `check.mjs` 验收。**共 4 步。**
@@ -228,11 +228,11 @@ node "<技能目录>/scripts/index-rebuild.mjs" --workspace "<工作区绝对路
228
228
 
229
229
  ```bash
230
230
  # 清空重来(先不带 --yes 预览)
231
- node "<技能目录>/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>"
232
- node "<技能目录>/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --yes
231
+ node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>"
232
+ node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --yes
233
233
 
234
234
  # 撤装保档
235
- node "<技能目录>/scripts/pa.mjs" uninstall --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --remove-triggers
235
+ node "{{skillDir}}/scripts/pa.mjs" uninstall --workspace "<工作区绝对路径>" --self "<本 Agent AID>" --remove-triggers
236
236
  ```
237
237
 
238
238
  **`--workspace` 必传,不是摆设。** 脚本会读出 persona 标记块里登记的路径做比对:
@@ -252,7 +252,7 @@ node "<技能目录>/scripts/pa.mjs" uninstall --workspace "<工作区绝对路
252
252
  ## 四、体检(只读)
253
253
 
254
254
  ```bash
255
- node "<技能目录>/scripts/check.mjs" --workspace "<工作区绝对路径>"
255
+ node "{{skillDir}}/scripts/check.mjs" --workspace "<工作区绝对路径>"
256
256
  ```
257
257
 
258
258
  输出四类结论:
@@ -271,9 +271,9 @@ node "<技能目录>/scripts/check.mjs" --workspace "<工作区绝对路径>"
271
271
  ## 五、升级
272
272
 
273
273
  ```bash
274
- node "<技能目录>/scripts/check.mjs" --workspace "<路径>" # 1. 先看差什么
275
- node "<技能目录>/scripts/pa.mjs" update --workspace "<路径>" --self "<本 Agent AID>" # 2. 迁移 + 刷新 persona
276
- node "<技能目录>/scripts/check.mjs" --workspace "<路径>" # 3. 复查
274
+ node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>" # 1. 先看差什么
275
+ node "{{skillDir}}/scripts/pa.mjs" update --workspace "<路径>" --self "<本 Agent AID>" # 2. 迁移 + 刷新 persona
276
+ node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>" # 3. 复查
277
277
  ```
278
278
 
279
279
  `--self` 不是必须,但给了就会顺带按新模板刷新 `soul/04-working-style.md` 里的工作区入口——
@@ -392,10 +392,10 @@ node "<技能目录>/scripts/check.mjs" --workspace "<路径>"
392
392
 
393
393
  ```bash
394
394
  # 1. 先预览(默认就是预览,不加 --yes 什么都不删)
395
- node "<技能目录>/scripts/clean.mjs" --workspace "<路径>" --self "<AID>"
395
+ node "{{skillDir}}/scripts/clean.mjs" --workspace "<路径>" --self "<AID>"
396
396
 
397
397
  # 2. 确认后执行
398
- node "<技能目录>/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --yes
398
+ node "{{skillDir}}/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --yes
399
399
  ```
400
400
 
401
401
  **清理是不可逆的,所以默认只预览。** 这不是多余的谨慎——工作区里可能有用户几个月的数据。
@@ -416,8 +416,8 @@ node "<技能目录>/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --
416
416
  工作区确认无误、数据已经定稿时锁定:
417
417
 
418
418
  ```bash
419
- node "<技能目录>/scripts/lock.mjs" --workspace "<路径>" --reason "定稿,2026 年度档案" --yes
420
- node "<技能目录>/scripts/lock.mjs" --workspace "<路径>" --show # 查状态
419
+ node "{{skillDir}}/scripts/lock.mjs" --workspace "<路径>" --reason "定稿,2026 年度档案" --yes
420
+ node "{{skillDir}}/scripts/lock.mjs" --workspace "<路径>" --show # 查状态
421
421
  ```
422
422
 
423
423
  **锁定是单向的,没有 unlock。**
@@ -452,11 +452,11 @@ node "<技能目录>/scripts/lock.mjs" --workspace "<路径>" --show # 查
452
452
 
453
453
  ```bash
454
454
  # 1. 建
455
- node "<技能目录>/scripts/pa.mjs" init --workspace "<路径>" --owner "<AID>" --self "<AID>" --with-triggers
455
+ node "{{skillDir}}/scripts/pa.mjs" init --workspace "<路径>" --owner "<AID>" --self "<AID>" --with-triggers
456
456
  # 2. 验
457
- node "<技能目录>/scripts/check.mjs" --workspace "<路径>"
457
+ node "{{skillDir}}/scripts/check.mjs" --workspace "<路径>"
458
458
  # 3. 清空(连触发器、persona 入口一起)
459
- node "<技能目录>/scripts/pa.mjs" clean --workspace "<路径>" --self "<AID>" --yes
459
+ node "{{skillDir}}/scripts/pa.mjs" clean --workspace "<路径>" --self "<AID>" --yes
460
460
  # 4. 回到第 1 步
461
461
  ```
462
462
 
@@ -99,7 +99,7 @@ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifes
99
99
  |---|---|
100
100
  | `ec trigger show <id>` 报错 | `Cannot find module dist/cli/trigger-command.js`。`list`/`create`/`delete` 正常,只有 `show` 坏 |
101
101
  | `calendar/manage` 的 `list` 不接受 `calendar_id` | 带上就返回 `params_invalid`,去掉即可 |
102
- | 能力调用需要 `--device-id` | 不带报 `ABILITY_DEVICE_REQUIRED`;两台设备中只有一台在线 |
102
+ | 能力调用可省略 `--device-id` | 不带即广播,Provider 路由到在线设备、按设备逐条收结果;要限定单台才指定 |
103
103
  | `--return required` 可能返回 `message_expired` | 设备不在线时的表现,不是参数错误 |
104
104
 
105
105
  ---
@@ -41,11 +41,11 @@ description: 使用 html2text 从 URL 抓取可读正文(含图片),按优
41
41
  2. 已安装 `uv`(依赖走 uv 全局缓存,不需要 venv)。
42
42
  3. 机器可访问目标 URL。
43
43
 
44
- 脚本位置不固定,执行前先确定 `<技能目录>`(即本技能所在目录,由技能索引注入)。约定写法见下方「路径约定」。
44
+ 脚本位置不固定,路径一律写成 `{{skillDir}}`(即本技能所在目录,加载时替换成本机绝对路径)。约定写法见下方「路径约定」。
45
45
 
46
46
  ## 路径约定
47
47
 
48
- EC 不会把 cwd 设到技能目录,所以命令里的脚本路径**必须写成绝对路径**。`<技能目录>` 由上下文注入的技能索引给出(索引里有「根目录 + 技能名」的拼法)。不要依赖 cwd 或 `~`。
48
+ EC 不会把 cwd 设到技能目录,所以命令里的脚本路径**必须写成绝对路径**,技能目录用 `{{skillDir}}`。不要依赖 cwd 或 `~`。
49
49
 
50
50
  脚本内部也不依赖 cwd:`run_pipeline.sh` 用自身位置定位同目录的其它脚本。
51
51
 
@@ -54,7 +54,7 @@ EC 不会把 cwd 设到技能目录,所以命令里的脚本路径**必须写
54
54
  不要假设系统一定有 `python` 别名,统一先跑 wrapper:
55
55
 
56
56
  ```bash
57
- bash "<技能目录>/scripts/run_pipeline.sh"
57
+ bash "{{skillDir}}/scripts/run_pipeline.sh"
58
58
  ```
59
59
 
60
60
  该 wrapper 会优先选 `python3`,其次 `python`,避免「环境有 Python,但入口命令写死导致误判」。
@@ -69,7 +69,7 @@ bash "<技能目录>/scripts/run_pipeline.sh"
69
69
  用 `uv` 的全局缓存装依赖,使用 `--no-project` 避免在当前目录建 `.venv`:
70
70
 
71
71
  ```bash
72
- uv run --no-project --with lxml --with cssselect --with html2text python "<技能目录>/scripts/scrapling_fetch.py" <url> [max_chars]
72
+ uv run --no-project --with lxml --with cssselect --with html2text python "{{skillDir}}/scripts/scrapling_fetch.py" <url> [max_chars]
73
73
  ```
74
74
 
75
75
  依赖只进 uv 全局缓存(`uv cache dir`),跨技能共享、装一次后秒级启动,不落任何项目目录。
@@ -103,7 +103,7 @@ uv run --no-project --with lxml --with cssselect --with html2text python "<技
103
103
  3. 用 `render_markdown_reply.py` 生成固定格式的回复:
104
104
 
105
105
  ```bash
106
- python3 "<技能目录>/scripts/render_markdown_reply.py" <title> <url> <markdown_file>
106
+ python3 "{{skillDir}}/scripts/render_markdown_reply.py" <title> <url> <markdown_file>
107
107
  ```
108
108
 
109
109
  无 `python3` 时改用 `python`,优先复用 wrapper 选出的解释器。
@@ -5,7 +5,7 @@ description: >-
5
5
  **以下两种消息必须先加载本 skill 再处理**:① 消息开头是
6
6
  「‹提醒:跨话题委托 · 原话题:…›」(你跨话题委托出去的消息,对端回复了);
7
7
  ② 消息开头是「‹【跨话题复查】原话题:…›」(复查通知)。
8
- 也用于:要联系当前对端/当前群以外的对象("帮我问一下 X"、"转告 Y"、"去查 Z")、
8
+ 也用于:要联系当前会话以外的对象("帮我问一下 X"、"转告 Y"、"去查 Z")、
9
9
  处理收到的委托、汇报回来源话题。
10
10
  用户说"总结一下话题""总结话题""更新一下摘要""summarize this topic"时同样加载。
11
11
  license: MIT
@@ -65,17 +65,20 @@ license: MIT
65
65
  # 1. 找或建与 C 的话题
66
66
  ec thread list <C的AID>
67
67
  ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回裸 threadId
68
+ # 首次联系也可以直接写主话题 main:<本端AID>:<C的AID>,会话随首条消息建立
68
69
 
69
70
  # 2. 发消息,--check-every 一步搞定复查
70
- # 必填,取时长(5m / 30m / 2h / 1d)即建周期复查;
71
+ # 省略时默认 20m;取时长(5m / 30m / 2h / 1d)即建周期复查;
71
72
  # 取 none 则只写 thread-inbox、不建复查(收尾汇报等不需要被叫醒的场景)
72
73
  ecmsg send '项目当前进度如何?' --thread <裸threadId> --check-every 5m
73
74
 
74
75
  # 3. 本 turn 结束,不阻塞
75
76
  ```
76
77
 
77
- - 不手写 `from/to`,由话题推断。
78
+ - 不写 `--to` / `--from`:接收方由话题和模式推出,跨话题默认就是委托给该话题的对端。
79
+ - `--thread` 不能是当前话题;话题的本端必须是当前会话本端。
78
80
  - 副作用:本端写 thread-inbox +(非 none 时)创建复查。回执里 `trigger_id` 要记住,后面靠它取消。
81
+ - 创建复查 Trigger 时,必须按任务设置最长有效期(`--max-duration`)或最多运行轮数(`--max-runs`);由 `--check-every` 自动创建的,拿到回执中的 `trigger_id` 后用 `ec trigger update` 补设。
79
82
  - 每 5 分钟向 T2 投递一条复查通知;C 若已回复,通知到达时 T2 上下文里就有 C 的回复。
80
83
 
81
84
  ### B. 处理收到的委托
@@ -109,7 +112,7 @@ ec thread history <来源话题id> --after <发送于的时间戳>
109
112
  ```bash
110
113
  ec trigger delete <trig_id> # 完成:删除,不留残留
111
114
  ec trigger update <trig_id> --every 30m # 放宽
112
- ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every none # 汇报(跨话题,收尾不再复查)
115
+ ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every none # 汇报(跨话题委托,收尾不再复查)
113
116
  ```
114
117
 
115
118
  **关键点**:
@@ -156,7 +159,7 @@ ec thread status current closed # 状态:active|clos
156
159
  核心:**先拿覆盖游标 → 读增量 → 再写**。`summary set` 会把游标推进到当时最新一条,所以**必须先读完增量**,否则被跳过的消息下次不会再返回。
157
160
 
158
161
  ```bash
159
- # 当前话题内总结(增量就是本轮对话,不用读历史)
162
+ # 当前话题内总结(上次摘要后的对话都在上下文时,不用读历史;缺失则补读增量)
160
163
  ec thread summary show current
161
164
  ec thread summary set current '<100字以内摘要>' --name '动词短语描述的核心动作'
162
165
  # --name 必填;不想改名显式传 --name -
@@ -170,9 +173,14 @@ ec thread summary set <threadId> '<摘要>' --name '新名称'
170
173
  ```
171
174
 
172
175
  **摘要规范**:100 字以内,`[谁]做了[什么],结果[什么],遗留[什么]`;写给下次的自己看,不是给对端。
176
+ 更新时合并旧摘要仍有效的目标、关键结果与待办/阻塞,删去已失效信息;不要只写最后一轮操作,丢掉恢复所需的任务背景。
173
177
  **命名规范**:≤30 字(与客户端输入框同口径)、动词短语,别用"你好""话题会话";话题方向变了就顺手改名。
174
178
 
175
- **主动做(不等用户开口)**:阶段完成 → 写摘要;方向重大转向 → 改名 + 摘要;即将跨去别处 → 先写摘要;转 `closed` 前 → 写最终摘要。
179
+ **主动做(不等用户开口)**:完整任务线收尾且有新成果 → 写摘要;方向重大转向 → 按需改名并更新摘要;跨话题交接缺少恢复信息 → 补齐摘要;转 `closed` 前 → 写最终摘要。单步操作不单独触发。
180
+
181
+ **主动更新限制**:成功写入后,接下来 3 轮对话不主动更新;用户明确要求总结、独立话题转 `closed` 前除外。
182
+
183
+ **语义判重**:更新前先对照旧摘要,没有新增恢复信息就不主动写。
176
184
 
177
185
  ### G. 生成工作报告
178
186
 
@@ -189,13 +197,15 @@ ec thread summary show <threadId>
189
197
  | 错误码 | 处理 |
190
198
  |---|---|
191
199
  | `TOPIC_NOT_FOUND` | 用 `ec thread list <peer>` 核对 id;没有合适话题就 `ec thread create` |
192
- | `TOPIC_CONFLICT` | 换名字,或直接用已有话题 |
200
+ | `TOPIC_IS_CURRENT` | `--thread` 写成了当前话题:当前话题消息直接省略 `--thread` |
201
+ | `SELFMODE_REQUIRES_THREAD` | `--selfmode` 必须与 `--thread` 同用 |
202
+ | `FROM_NOT_ALLOWED` / `TO_REMOVED` | 托管会话不写 `--from` / `--to` |
193
203
  | `TOPIC_BUSY` | 有任务在跑,等完成再删 |
194
204
 
195
205
  **不要**:
196
206
  1. 发完阻塞等回复——turn 已结束,回复会触发新 turn。
197
- 2. 漏掉 `--check-every`——跨话题必须显式给时长或 `none`;忘了对端不回你永远不会知道。
198
- 3. 托管会话里手写 `from/to`。
207
+ 2. 漏掉 `--check-every`——跨话题委托省略时默认 20m;不想被叫醒就显式 `none`,否则对端不回也会持续复查。
208
+ 3. 托管会话里写 `--from` / `--to`:本端恒为会话本端,接收方由话题和模式推出。
199
209
  4. 把复查通知当"强制回复"或执行脚本。
200
210
  5. 在复查 turn 里再 `--check-every <时长>`(会套娃)。
201
211
  6. 期望"等齐"原语,或期望话题名两端一致。
@@ -24,13 +24,13 @@ license: MIT
24
24
  ## 用法
25
25
 
26
26
  ```bash
27
- python3 "<技能目录>/scripts/download.py" "<文章URL>" "<输出目录>"
27
+ python3 "{{skillDir}}/scripts/download.py" "<文章URL>" "<输出目录>"
28
28
  ```
29
29
 
30
30
  **示例:**
31
31
 
32
32
  ```bash
33
- python3 "<技能目录>/scripts/download.py" \
33
+ python3 "{{skillDir}}/scripts/download.py" \
34
34
  "https://mp.weixin.qq.com/s/xxxxxx" \
35
35
  "./wechat-output"
36
36
  ```
@@ -30,13 +30,13 @@ license: MIT
30
30
  ## 用法
31
31
 
32
32
  ```bash
33
- node "<技能目录>/scripts/fetch.mjs" "<文章URL>" [输出目录]
33
+ node "{{skillDir}}/scripts/fetch.mjs" "<文章URL>" [输出目录]
34
34
  ```
35
35
 
36
36
  **示例:**
37
37
 
38
38
  ```bash
39
- node "<技能目录>/scripts/fetch.mjs" \
39
+ node "{{skillDir}}/scripts/fetch.mjs" \
40
40
  "https://mp.weixin.qq.com/s/xxxxxx"
41
41
  ```
42
42
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  生命周期保护仅针对承载当前会话的 EvolCore 实例;其他实例按用户授权和目标端权限处理,不限管理通道。完整规则见 `$KITS_RULES/06-channel.md`。
6
6
 
7
- ecmsg 发送消息(统一入口:当前会话 / --thread 跨话题 / --to 指定对端;文件、链接、payload、加密) $KITS_DOCS/evolcore/msg.md
7
+ ecmsg 发送消息(统一入口:当前会话 / --thread 跨话题(默认委托,--selfmode 自派);文件、链接、payload、加密) $KITS_DOCS/evolcore/msg.md
8
8
  ec memory 记忆写入与整理(note 写入/修改/撤销/查看;consolidate 触发整理;何时写见 [memory] 段) $KITS_DOCS/evolcore/memory.md
9
9
  ec ctl 当前会话工具(重命名、队列、项目路径、会话状态) $KITS_DOCS/evolcore/ctl.md
10
10
  ec model 模型与推理强度管理(切模型/列模型/当前模型/模型详情/改强度/诊断网关) $KITS_DOCS/evolcore/model.md
@@ -13,8 +13,8 @@
13
13
  - 团队名单由 Owner 在 Evol App 里维护,你看得到但改不了。哪些人在团队里、为什么,
14
14
  不是你要判断的事。
15
15
 
16
- 派活就一句话说清,不寒暄:`ecmsg send --to <对方AID> '<text>'`。要跟进就在正文里
17
- 写明「做完回我」。**你不替成员做技术判断**,只提需求和验收标准。
16
+ 派活就一句话说清,不寒暄:`ecmsg send '<text>' --thread main:<自己AID>:<对方AID>`
17
+ (主话题可直接发,首次联系也会随消息建立会话)。要跟进就在正文里写明「做完回我」。**你不替成员做技术判断**,只提需求和验收标准。
18
18
 
19
19
  成员之间平级,没有层级;但你可以安排它们互相联系。成员不主动给 Owner 发消息,
20
20
  只在办完事时汇报。
@@ -24,24 +24,29 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
24
24
  {{?activePush}}
25
25
  正式回复只有一个入口:`ecmsg send`。
26
26
 
27
- ## 发给谁(三选一,优先级从高到低)
27
+ ## 发给谁(只有三种形态,接收方由话题和模式推出)
28
28
 
29
29
  | 目标 | 写法 |
30
30
  |---|---|
31
31
  | 当前会话的对端/群(默认) | `ecmsg send '<text>'` |
32
- | 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
33
- | 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
32
+ | 跨话题委托:发给该话题的对端 | `ecmsg send '<text>' --thread <话题id>` |
33
+ | 跨话题自派:发给自己 | `ecmsg send '<text>' --thread <话题id> --selfmode` |
34
34
 
35
- - `--thread` 只接受两种形态:`thread-…`(独立话题)与 `main:<aidA>:<aidB>`(主话题)。话题必须存在于本端索引,先用 `ec thread list <对端AID>` 查看。群的主话题同样写成 `main:<本端AID>:<群AID>`(两种顺序等价);在群的子话题里要回群主话题,必须写 `--thread main:<本端AID>:<群AID>`,`--to <群AID>` 只会留在当前子话题。
36
- - 本端恒为当前会话本端,无需也无法指定;`--from` 仅作协议兼容。
35
+ - `--thread` 只接受两种形态:`thread-…`(独立话题)与 `main:<aidA>:<aidB>`(主话题)。
36
+ - `--thread` 不能是当前话题;回复当前会话直接省略它。话题的本端必须等于当前会话本端。
37
+ - 独立话题必须已存在于本端索引(`ec thread list <对端AID>` 查看)。主话题由两端 AID 直接拼出,首次联系可直接使用,会话随首条消息建立。
38
+ - 群与私聊同构:群主话题同样写成 `main:<本端AID>:<群AID>`(两种顺序等价);群话题也可以自派。
39
+ - 接收方不再用 `--to`,`--from` 在托管会话中禁止使用。
37
40
  - 正文是位置参数;附件、链接、payload 用选项表达(见下)。
38
41
 
39
42
  ## 跨话题与复查
40
43
 
41
- 目标与会话不一致(对端不同,或话题不同)即**跨话题**:
44
+ 带 `--thread` 即跨话题:
42
45
 
43
- - 跨话题**自动创建复查**,缺省 20m;要改周期用 `--check-every 30m`。
44
- - 同话题永不创建复查;此时传 `--check-every` 只在回执里提示,不报错。
46
+ - **委托**(默认)**自动创建复查**,缺省 20m;要改周期用 `--check-every 30m`,`--check-every none` 表示不建复查(只写 inbox,适合把结果带回原话题的收尾汇报)。
47
+ - **自派**(`--selfmode`)不建复查:消息直接进入目标话题会话,不能与 `--check-every` 同用。
48
+ - 首次联系(主话题的会话尚未建立)不建复查,会话随本条消息建立。
49
+ - 当前话题永不创建复查;此时传 `--check-every` 只在回执里提示,不报错。
45
50
  - 跨话题需要从 AUN 会话发起。其它渠道的会话只能回复本会话对端。
46
51
 
47
52
  ## 加密
@@ -64,7 +69,7 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
64
69
 
65
70
  ## 回执
66
71
 
67
- 回执会回显**实际生效**的路由:`from=… to=…(来源) thread=…(来源) chatType=…`。来源标为「会话/传入/推导」——系统补全的值在这里确认,发错了当轮就能发现。
72
+ 回执会回显**实际生效**的路由:`from=… to=…(来源) thread=…(来源) chatType=…`。来源标为「会话/传入」;自派额外标 `recipient=self topicPeer=<话题对端>`。发错了当轮就能发现。
68
73
  {{/}}
69
74
  发送成功后继续本轮必要步骤,不重复发送同一正文或补发“已发送”回执。
70
75
  {{?chatMode!=interactive}}
@@ -41,7 +41,7 @@ readonly: true — 禁止写入项目目录及临时目录;如需生成文件
41
41
  # 命令速查:
42
42
  # 每次工具调用只执行一条完整的命令;禁止 command -v。托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`;仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json;禁止 &&、||、;、子 shell、bash -lc/sh -c 或其它脚本与其串联。先用命令自身的过滤和分页参数收窄输出。Bash 的受控过滤管道只支持 head/tail/grep/wc/sort/cut/uniq/tr 读取 stdin 的限定参数,不接受文件操作数;不要在 ec 后接 python/python3/node/jq。仍需处理较大查询结果时,可用 `> $TMPDIR/<新文件>` 存盘,再在独立工具调用中读取;发送命令仍遵守 [reply] 的独立执行规则。PowerShell/cmd 下不支持上述管道或重定向。
43
43
  # 审批拒绝时原样报告并停止;必须收到包含 message_id/status 的成功回执后才能声称已发送。
44
- # 正式回复统一用 ecmsg send '<text>';指定话题加 --thread,指定对端加 --to。
44
+ # 正式回复统一用 ecmsg send '<text>';跨话题加 --thread(默认委托),自派再加 --selfmode。
45
45
  # 本端恒为当前会话本端,无需指定;文件/链接/跨话题/完整选项见 $KITS_DOCS/evolcore/msg.md
46
46
  {{/}}
47
47
  {{/}}
@@ -8,15 +8,19 @@
8
8
  | 时机 | 操作 |
9
9
  |---|---|
10
10
  | 用户说"总结一下""总结话题""更新摘要" | 写摘要 |
11
- | 一个明确的阶段或任务完成 | 写入/更新摘要 |
12
- | 即将跨话题路由(去问另一个 agent)之前 | 写入当前状态 |
11
+ | 话题的完整任务线收尾,且有新的实质成果 | 写入/更新摘要 |
12
+ | 跨话题交接前,已有摘要不足以恢复当前任务 | 补齐当前状态 |
13
13
  | 独立话题改为 `closed` 之前 | 写入最终成果 |
14
14
 
15
- `ec thread list` 里显示"未总结"就是行动信号。不要每条消息后都更新,只在阶段完成时。
15
+ `ec thread list` 里显示"未总结"不要求立即补写,按上表判断。提交、推送、重试等单步操作不单独触发摘要;同一任务线优先在收尾时合并更新一次。
16
+
17
+ **主动更新限制**:成功写入后,接下来 3 轮对话不主动更新;用户明确要求总结、独立话题转 `closed` 前除外。
18
+
19
+ **语义判重**:更新前先对照旧摘要,没有新增恢复信息就不主动写。
16
20
 
17
21
  ## 写摘要(两条路径)
18
22
 
19
- **当前话题里总结**(对话就在上下文,增量即本轮对话,不用读历史):
23
+ **当前话题里总结**(上次摘要后的对话都在上下文时,不用读历史;缺失则补读增量):
20
24
 
21
25
  ```bash
22
26
  ec thread summary show current # 看上次摘要 + coveredThroughTs
@@ -29,6 +33,7 @@ ec thread summary set current '<摘要>' --name '<新标题>' # 写摘要 +
29
33
  读增量 → **读完再写**。`summary set` 把游标设为当时最新一条,没读完就写会让未读消息下次不再返回。
30
34
 
31
35
  摘要 100 字以内,写给自己下次看,不是给对端展示。格式:`[谁]做了[什么],结果是[什么],遗留[什么]`。
36
+ 更新时合并旧摘要仍有效的目标、关键结果与待办/阻塞,删去已失效信息;不要只写最后一轮操作,丢掉恢复所需的任务背景。
32
37
 
33
38
  ## 话题命名
34
39
 
@@ -47,7 +52,7 @@ ec thread show current --format json
47
52
  ```
48
53
 
49
54
  - 返回 `thread-...`:可用 `ec thread status current closed`(讨论结束)/ `archived`(归档)。
50
- - 返回 `main:...`(主话题):**没有业务状态**,不能执行 status;完成信息写进 summary 即可。
55
+ - 返回 `main:...`(主话题):**没有业务状态**,不能执行 status;摘要按上表维护,不按每轮任务更新。
51
56
  - `active | closed | archived`;收到新消息会自动回退 active。
52
57
  - 不要自行归档,`archived` 仅在用户明确要求或前端操作时设置。进展写 summary,不用状态表达任务进度。
53
58