evolcore 0.0.43-test.5 → 0.0.43-test.7

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 (259) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/bin/ecmsg.js +281 -81
  3. package/dist/agents/baseagent-availability.js +20 -5
  4. package/dist/agents/baseagent.js +2 -2
  5. package/dist/agents/claude-runner.js +19 -4
  6. package/dist/agents/codex/app-server-client.js +36 -3
  7. package/dist/agents/codex-runner.js +75 -8
  8. package/dist/aun/group/invite-service.js +3 -2
  9. package/dist/aun/msg/p2p.js +6 -1
  10. package/dist/aun/service-proxy.js +18 -6
  11. package/dist/channels/aun.js +306 -30
  12. package/dist/cli/agent-create.js +18 -8
  13. package/dist/cli/aun-commands.js +9 -1
  14. package/dist/cli/daemon-commands.js +34 -65
  15. package/dist/cli/daemon-lifecycle-client.js +61 -0
  16. package/dist/cli/ecmsg-gateway.js +38 -3
  17. package/dist/cli/events-command.js +73 -0
  18. package/dist/cli/index.js +31 -14
  19. package/dist/cli/init.js +75 -0
  20. package/dist/cli/invoke-command.js +182 -0
  21. package/dist/cli/managed-command-guard.js +6 -1
  22. package/dist/cli/provider-command.js +1 -1
  23. package/dist/cli/restart-monitor.js +67 -50
  24. package/dist/cli/services-command.js +111 -0
  25. package/dist/cli/task-context.js +38 -1
  26. package/dist/cli/team-workspace-command.js +134 -0
  27. package/dist/cli/thread-command.js +6 -2
  28. package/dist/cli/watch-logs.js +6 -4
  29. package/dist/cli/watch-msg.js +1 -1
  30. package/dist/config/boot-log.js +6 -4
  31. package/dist/config/builtin-roles.js +2 -2
  32. package/dist/config/config-field-policy.js +2 -2
  33. package/dist/config/config-manager.js +1 -8
  34. package/dist/config/invoke-ipc-service.js +118 -0
  35. package/dist/config/peer-role-resolver.js +1 -1
  36. package/dist/config/provider-identity-migration.js +92 -17
  37. package/dist/config/provider-local-sync.js +2 -0
  38. package/dist/config/providers-config.js +13 -0
  39. package/dist/config/providers-management.js +100 -10
  40. package/dist/config/role-service.js +8 -8
  41. package/dist/config/role-store.js +22 -22
  42. package/dist/config/schema-migration.js +86 -88
  43. package/dist/config/snapshot.js +70 -41
  44. package/dist/config-store.js +2 -1
  45. package/dist/core/agent-reload-coordinator.js +6 -4
  46. package/dist/core/agent-runtime.js +146 -15
  47. package/dist/core/auth/delegation-authorization.js +66 -0
  48. package/dist/core/auth/operation-catalog.js +20 -0
  49. package/dist/core/baseagent-loader.js +75 -42
  50. package/dist/core/channel-loader.js +45 -13
  51. package/dist/core/channel-runtime.js +116 -45
  52. package/dist/core/command/agent-control.js +1 -1
  53. package/dist/core/command/agent-storage-menu.js +1 -1
  54. package/dist/core/command/chatmode-config.js +2 -36
  55. package/dist/core/command/command-handler.js +58 -16
  56. package/dist/core/command/data-root-resolver.js +32 -23
  57. package/dist/core/command/eventcenter-menu.js +338 -0
  58. package/dist/core/command/menu-catalog.js +8 -0
  59. package/dist/core/command/menu-handler.js +206 -87
  60. package/dist/core/command/menu-protocol.js +142 -22
  61. package/dist/core/command/menu-query-batch.js +194 -0
  62. package/dist/core/command/role-menu.js +27 -15
  63. package/dist/core/command/slash-gate.js +1 -1
  64. package/dist/core/command/slash-handler.js +34 -42
  65. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  66. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  67. package/dist/core/command/team-workspace-initializer.js +2 -0
  68. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  69. package/dist/core/command/team-workspace-job-store.js +88 -0
  70. package/dist/core/command/team-workspace-management-service.js +2 -0
  71. package/dist/core/command/team-workspace-management-store.js +96 -0
  72. package/dist/core/command/team-workspace-management.js +265 -0
  73. package/dist/core/command/team-workspace-members-menu.js +88 -0
  74. package/dist/core/command/team-workspace-store.js +612 -0
  75. package/dist/core/command/team-workspace-team.js +193 -0
  76. package/dist/core/daemon-control.js +45 -15
  77. package/dist/core/daemon-lifecycle.js +478 -75
  78. package/dist/core/handoff/dispatcher.js +9 -3
  79. package/dist/core/handoff/runtime.js +130 -42
  80. package/dist/core/handoff/store.js +190 -2
  81. package/dist/core/handoff/types.js +5 -0
  82. package/dist/core/initialization/service.js +4 -4
  83. package/dist/core/invoke/executors/index.js +13 -0
  84. package/dist/core/invoke/executors/media.js +283 -0
  85. package/dist/core/invoke/executors/text.js +198 -0
  86. package/dist/core/invoke/invoke-service.js +157 -0
  87. package/dist/core/invoke/style-router.js +48 -0
  88. package/dist/core/invoke/types.js +19 -0
  89. package/dist/core/ipc-registration.js +51 -11
  90. package/dist/core/lifecycle-notice.js +10 -4
  91. package/dist/core/memory/consolidation.js +7 -5
  92. package/dist/core/message/aun-ipc-sender.js +149 -19
  93. package/dist/core/message/im-renderer.js +28 -84
  94. package/dist/core/message/message-bridge.js +57 -4
  95. package/dist/core/message/message-queue.js +46 -4
  96. package/dist/core/message/message-utils.js +10 -2
  97. package/dist/core/message/peer-mode.js +7 -34
  98. package/dist/core/message/pending-hints.js +4 -10
  99. package/dist/core/message/response-engine.js +163 -52
  100. package/dist/core/message/send-options.js +7 -4
  101. package/dist/core/message/send-routing.js +55 -7
  102. package/dist/core/ownership/owner-resolver.js +8 -0
  103. package/dist/core/permission/ec-command-parser.js +14 -3
  104. package/dist/core/permission/protected-paths.js +12 -2
  105. package/dist/core/permission/shell-environment.js +9 -0
  106. package/dist/core/session/adapters/claude-session-file-adapter.js +24 -0
  107. package/dist/core/session/adapters/codex-session-file-adapter.js +80 -0
  108. package/dist/core/session/adapters/ecagent-session-file-adapter.js +22 -0
  109. package/dist/core/session/adapters/gemini-session-file-adapter.js +39 -0
  110. package/dist/core/session/session-file-health.js +243 -0
  111. package/dist/core/session/session-fs-store.js +163 -3
  112. package/dist/core/session/session-idle-monitor.js +9 -1
  113. package/dist/core/session/session-manager.js +36 -2
  114. package/dist/core/task/task-recovery-service.js +13 -2
  115. package/dist/core/thread/command-parser.js +9 -2
  116. package/dist/core/thread/thread-operation.js +21 -2
  117. package/dist/core/thread/thread-route.js +13 -2
  118. package/dist/directory/owner-directory-admission.js +42 -30
  119. package/dist/directory/owner-directory-cache.js +143 -126
  120. package/dist/directory/owner-directory-query-operation.js +9 -8
  121. package/dist/eck/kit-renderer.js +7 -5
  122. package/dist/ecweb/basic-settings-service.js +1 -1
  123. package/dist/ecweb/message-context-service.js +0 -4
  124. package/dist/ecweb/runtime/lifecycle.js +14 -8
  125. package/dist/ecweb/runtime/supervisor.js +62 -30
  126. package/dist/event-center/admission-materializer.js +114 -0
  127. package/dist/event-center/bus-gate.js +136 -0
  128. package/dist/event-center/bus-host.js +290 -0
  129. package/dist/event-center/bus-resolver.js +120 -0
  130. package/dist/event-center/center-config.js +100 -0
  131. package/dist/event-center/client-factory.js +50 -0
  132. package/dist/event-center/daemon.js +45 -0
  133. package/dist/event-center/directory-source.js +53 -0
  134. package/dist/event-center/dispatcher.js +157 -0
  135. package/dist/event-center/event-log.js +110 -0
  136. package/dist/event-center/index-generator.js +63 -0
  137. package/dist/event-center/ipc-operation.js +308 -0
  138. package/dist/event-center/ledger.js +52 -0
  139. package/dist/event-center/pack-loader.js +202 -0
  140. package/dist/event-center/pack-manager.js +85 -0
  141. package/dist/event-center/registry.js +238 -0
  142. package/dist/event-center/runtime.js +641 -0
  143. package/dist/event-center/script-runner.js +356 -0
  144. package/dist/event-center/types.js +35 -0
  145. package/dist/event-center/validation.js +413 -0
  146. package/dist/index.js +751 -268
  147. package/dist/ipc.js +66 -12
  148. package/dist/paths.js +20 -0
  149. package/dist/product.js +14 -0
  150. package/dist/proxy/manager.js +43 -18
  151. package/dist/proxy/service-supervisor.js +78 -35
  152. package/dist/response-system/engines/v1/index.js +0 -1
  153. package/dist/response-system/modes/single-session/index.js +1 -1
  154. package/dist/services/dispatcher.js +100 -0
  155. package/dist/services/idempotency.js +90 -0
  156. package/dist/services/identity.js +52 -0
  157. package/dist/services/index-generator.js +70 -0
  158. package/dist/services/index.js +449 -0
  159. package/dist/services/ipc-operation.js +458 -0
  160. package/dist/services/ledger.js +52 -0
  161. package/dist/services/message-log.js +112 -0
  162. package/dist/services/pack-manager.js +204 -0
  163. package/dist/services/reply.js +55 -0
  164. package/dist/services/router.js +95 -0
  165. package/dist/services/script-runner.js +422 -0
  166. package/dist/services/service-payload.js +70 -0
  167. package/dist/services/types.js +18 -0
  168. package/dist/services/validation.js +297 -0
  169. package/dist/trigger/application-service.js +21 -1
  170. package/dist/trigger/audit.js +19 -4
  171. package/dist/trigger/authorization.js +14 -5
  172. package/dist/trigger/event-source.js +1 -1
  173. package/dist/trigger/history.js +176 -7
  174. package/dist/trigger/ipc-service.js +3 -1
  175. package/dist/trigger/manager.js +1 -3
  176. package/dist/trigger/scheduler.js +78 -5
  177. package/dist/trigger/script-sandbox.js +118 -22
  178. package/dist/utils/cross-platform.js +175 -13
  179. package/dist/utils/evolcore-version.js +69 -27
  180. package/dist/utils/host-info.js +11 -8
  181. package/dist/utils/instance-registry.js +19 -13
  182. package/dist/utils/npm-ops.js +48 -0
  183. package/dist/utils/process-introspect.js +109 -10
  184. package/dist/utils/startup-trace.js +222 -44
  185. package/dist/utils/windows-shell-trust.js +80 -6
  186. package/kits/docs/INDEX.md +2 -2
  187. package/kits/docs/aun/ABILITY_CALLING.md +10 -17
  188. package/kits/docs/context-assembly.md +1 -1
  189. package/kits/docs/evolcore/INDEX.md +5 -2
  190. package/kits/docs/evolcore/ability.md +4 -0
  191. package/kits/docs/evolcore/aid.md +1 -1
  192. package/kits/docs/evolcore/ctl.md +2 -1
  193. package/kits/docs/evolcore/event-center.md +207 -0
  194. package/kits/docs/evolcore/file-navigation.md +10 -264
  195. package/kits/docs/evolcore/fs.md +3 -2
  196. package/kits/docs/evolcore/group.md +2 -2
  197. package/kits/docs/evolcore/memory-architecture.md +2 -0
  198. package/kits/docs/evolcore/menu-exec-schema-commands.md +1 -1
  199. package/kits/docs/evolcore/menu-protocol.md +21 -0
  200. package/kits/docs/evolcore/msg.md +27 -8
  201. package/kits/docs/evolcore/provider.md +23 -3
  202. package/kits/docs/evolcore/response.md +5 -5
  203. package/kits/docs/evolcore/services.md +277 -0
  204. package/kits/docs/evolcore/task.md +2 -0
  205. package/kits/docs/evolcore/team-workspace.md +41 -0
  206. package/kits/eck_manifest.json +45 -7
  207. package/kits/eck_message_manifest.json +3 -3
  208. package/kits/rules/02-navigation.md +10 -1
  209. package/kits/rules/06-channel.md +5 -6
  210. package/kits/schemas/_meta.json +17 -6
  211. package/kits/schemas/agent-config.schema.19.json +5 -7
  212. package/kits/schemas/agent-config.schema.20.json +936 -0
  213. package/kits/schemas/daemon.schema.1.json +5 -0
  214. package/kits/schemas/daemon.schema.2.json +5 -0
  215. package/kits/schemas/daemon.schema.3.json +2 -1
  216. package/kits/schemas/daemon.schema.4.json +2 -1
  217. package/kits/schemas/daemon.schema.5.json +2 -1
  218. package/kits/schemas/daemon.schema.6.json +1 -1
  219. package/kits/schemas/daemon.schema.7.json +1 -1
  220. package/kits/schemas/daemon.schema.8.json +2 -1
  221. package/kits/schemas/daemon.schema.9.json +2 -1
  222. package/kits/schemas/relation-config.schema.12.json +2 -3
  223. package/kits/schemas/role-config.schema.2.json +4 -4
  224. package/kits/schemas/role-registry.schema.1.json +2 -2
  225. package/kits/schemas/single-session.schema.1.json +1 -1
  226. package/kits/schemas/single-session.schema.2.json +1 -1
  227. package/kits/schemas/single-session.schema.3.json +1 -1
  228. package/kits/skills/.switches.json +1 -5
  229. package/kits/skills/ability/SKILL.md +56 -0
  230. package/kits/skills/ability/references/calling.md +56 -0
  231. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  232. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  233. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  234. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  235. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  236. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  237. package/kits/skills/ec-group/SKILL.md +8 -5
  238. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  239. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  240. package/kits/skills/ec-trigger/SKILL.md +4 -4
  241. package/kits/skills/personal-assistant/SKILL.md +6 -6
  242. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  243. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  244. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  245. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  246. package/kits/skills/thread-ops/SKILL.md +10 -10
  247. package/kits/templates/system-fragments/channel.md +3 -3
  248. package/kits/templates/system-fragments/commands.md +9 -7
  249. package/kits/templates/system-fragments/reply.md +2 -6
  250. package/kits/templates/system-fragments/session.md +1 -1
  251. package/kits/templates/system-fragments/thread.md +11 -9
  252. package/package.json +5 -6
  253. package/dist/cli/pa-workspace-command.js +0 -225
  254. package/dist/core/command/pa-workspace-store.js +0 -468
  255. package/dist/core/relation/pa-team.js +0 -132
  256. package/kits/docs/evolcore/pa-workspace.md +0 -51
  257. package/kits/skills/aid-ability/SKILL.md +0 -244
  258. package/kits/skills/ec-ability/SKILL.md +0 -67
  259. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -39,7 +39,22 @@ license: MIT
39
39
  ec proxy status <service-name> --format json
40
40
  ~~~
41
41
 
42
- status 包含 runtime.state、健康状态、失败次数和 configRev。ServiceProxy 的 Gateway 登记与
42
+ `list` 返回全部服务;`status` 必须指定服务名,并只返回该服务(仍使用 `services` 数组)。
43
+ runtime 的健康字段统一为:
44
+
45
+ | 字段 | 含义 |
46
+ | --- | --- |
47
+ | `healthy: true / false / null` | 最近检查成功 / 失败 / 无结果(含未检查、停用或无探针) |
48
+ | `hasProbe` | 是否具备端点健康探针;用于区分无探针与暂未取得结果 |
49
+ | `endpointHealth` | `healthy` / `unhealthy` / `unknown`,与上述结果对应 |
50
+ | `checkedAt` | 最近检查时间;没有结果时可省略 |
51
+
52
+ ECWeb managed 模式内置 `/api/health` 探针,不配置 `health` 也会检查;其它服务有 `port` 时
53
+ 默认使用 TCP 探针,配置 HTTP 探针则检查对应路径。没有端口的 managed 服务只确认进程存活,
54
+ 即使 `state=ready`,端点健康仍为 `null`,`hasProbe=false`。`proxy.source=instance` 仅表示
55
+ 代理端点从实例登记获取,与 `runtime.mode` 和是否具备探针是不同概念。
56
+
57
+ ServiceProxy 的 Gateway 登记与
43
58
  本地代理隧道是分开的;proxy.proxyServer=unconfirmed 表示当前 SDK 没有向管理器暴露
44
59
  ProxyServer 的发布确认,不能把它说成已完全验证。
45
60
 
@@ -52,7 +67,19 @@ license: MIT
52
67
  `url` 按 ServiceProxy 路由规则生成:`https://<daemon-aid>.<issuer>/proxy/<service>/`。
53
68
  `accessState=available` 表示本机服务根路径 `/` 探测成功,`unavailable` 表示服务未发布、根路径
54
69
  不可用或探测失败,`unresolved` 仅表示无法构造代理地址或无法解析本地回连端点。代理入口不代表
55
- 已获被代理应用的登录权限。
70
+ 已获被代理应用的登录权限,`available` 也不代表公网代理整条链路已通过验证。
71
+
72
+ ## 子路径部署
73
+
74
+ 标准入口为 `https://<daemon-aid>/proxy/<service>/`。代理转发时剥离服务前缀,本地服务看到 `/`
75
+ 是正常行为;外部前缀通过 `X-Forwarded-Prefix` 提供,SDK 会保留此头。服务应验证前缀格式,
76
+ 据此配置应用的 base URL,例如在 HTML 中使用 `<base href="/proxy/reports/">` 并引用
77
+ `app.js`、`style.css` 等相对资源。API 和 WebSocket 也需要使用相同前缀。
78
+
79
+ `/app.js`、`/api` 这类从域名根开始的绝对路径会跳出服务前缀;补一个尾斜杠不能解决所有问题,
80
+ 也无需把全部资源内联。返回重定向时,`Location` 同样需要保留外部前缀;SDK 会透传 3xx 和
81
+ `Location`,不会自动替应用改写。若行为不符,分别检查浏览器响应、远端代理转发头和本地响应,
82
+ 不要仅凭本地 pathname 判断前缀丢失或重定向被吞掉。
56
83
 
57
84
  ## 配置
58
85
 
@@ -68,6 +95,11 @@ runtime.command.file;参数使用 args 数组,不要写 shell 命令字符
68
95
  managed 服务配置了 `port` 时,daemon 会把该端口作为子进程的 `PORT` 环境变量传入,覆盖 daemon
69
96
  自身 shell 继承的 `PORT`,避免服务监听端口与健康检查端口不一致。
70
97
 
98
+ 普通 managed 服务与 ECWeb 都会清理继承环境中的会话身份、任务上下文、委托凭据、Codex 会话和
99
+ 请求头凭据等任务变量;保留 `EVOLCORE_HOME`、`TMPDIR`、`PATH` 和业务环境变量。
100
+ 服务不继承发起任务的 Agent 身份或授权。服务内调用需要 Agent 目标的 CLI 时,仍须显式指定目标,
101
+ 例如 `ec trigger list --agent <agent-aid>`,并满足命令本身的鉴权要求。
102
+
71
103
  定义中 command 使用 executable 和 argv,不经 shell。创建定义示例:
72
104
 
73
105
  ~~~bash
@@ -114,9 +146,6 @@ restart / reload 按 runtime.mode 执行:managed 经其 supervisor 或内部
114
146
 
115
147
  ## 监听与守护
116
148
 
117
- - EvolCore 核心就绪与服务健康分开判定;ECWeb 尚未就绪或恢复失败不会使已就绪的 daemon 启动失败。正常启动、重启与核心 IPC 超时兜底不等待 ECWeb 协议握手。
118
- - 服务启动等待由 `health.startupTimeoutMs` 决定,默认 45 秒,不沿用 CLI 的 30 秒核心启动等待。ECWeb 同样采用此预算,并读取 `health.failureThreshold` 和 `health.timeoutMs`;为核验实例身份,其存活探针固定使用 `/api/health`,不使用自定义路径。
119
- - ECWeb 存活与其连接 daemon 的协议就绪分开:身份匹配的存活实例不会仅因 daemon 握手尚未完成而被反复重启。核心确实启动失败时,重启监控仍会安全清理遗留的 ECWeb,避免回滚后重复启动。
120
149
  - 运行状态周期检查进程和配置的 HTTP/TCP 健康探针,默认连续失败 3 次才触发恢复,成功一次清零连续失败数。
121
150
  - TCP 启动中每 500 ms、运行中每 10 秒检查;HTTP 启动中每 1 秒、运行中每 15 秒检查,频率固定。
122
151
  - managed 服务在 15 分钟内最多自动重试 3 次,默认等待 5、10、20 秒;仅 backoffMs 可调整初始等待。
@@ -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 |
@@ -91,7 +91,7 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
91
91
  - **投递失败只重发结果,不重跑任务**:`effects` 里才是真实投递记录;状态 `failed` 不代表
92
92
  用户没收到。排查时看 `history` 里的 `effects`。
93
93
  - **你被 trigger 唤醒时**:信封里的 `触发于:` 是排定时刻(firedAt),不是唤醒时刻;
94
- proactive 模式下正文流式输出会被丢弃,**回复必须走 `ec ctl send`**;`[[NOOP]]` 仍适用,
94
+ proactive 模式下正文流式输出会被丢弃,**回复必须走 `ecmsg send`**;`[[NOOP]]` 仍适用,
95
95
  只用它、别在它前后多说一句。
96
96
  - **提示词里能用的变量**:`{{trigger.name}}`、`{{run.number}}`(第几次)、`{{run.elapsed}}`、
97
97
  `{{date}}`、`{{time}}`,事件触发另有 `{{event.<字段>}}`。提示词正文走同一套渲染。
@@ -138,13 +138,13 @@ ec trigger create --event 'task:error' \
138
138
  1. 不用 trigger 代替当前会话里立刻能做的事。
139
139
  2. **默认**不给无上限的周期任务;用户明说长期跑,或任务本身长期有效(如每日简报)才可省略,
140
140
  并在建之前说明"这条会一直跑到被删"。
141
- 3. 不在提示词里写主动发消息的命令(`ec msg send` / `ec ctl send`)——结果会被**再投递一次**,
141
+ 3. 不在提示词里写主动发消息的命令(`ecmsg send`)——结果会被**再投递一次**,
142
142
  用户收到两遍。让模型只产出正文。
143
143
  4. 不用 `--agent` 去操作别的 agent 的 trigger(托管会话里很容易被拒)。
144
144
  5. 不直接读 `trigger.json`、`scripts/*`、`data/`、`AIDs/` 这类受保护路径——沙箱按 H 类拦截,
145
145
  脚本会直接启动失败。
146
146
  6. 提示词超过 4096 字符用 `--prompt-file`,不要硬塞。
147
- 7. 群聊里不要用 `--mention` 去 @ 人做提醒——`ec group send` 和 trigger 提示词不共享参数;
147
+ 7. 群聊里不要用 `--mention` 去 @ 人做提醒——`ecmsg send` 和 trigger 提示词不共享参数;
148
148
  要在群里点名,写进目标会话的提示词里,或让 target-session 在群里自己 @。
149
149
 
150
150
  ## 九、排查手册
@@ -73,7 +73,7 @@ node "<技能目录>/scripts/pa.mjs" update --workspace <路径> --self <AID>
73
73
  | `update` | 结构升到当前版本 + 按新模板刷新 persona 入口 | 保留 | 技能升级后 |
74
74
 
75
75
  **Core 绑定不是可选项,是初始化的一部分。** 少了它:App 里没有「个人助理」入口,
76
- `ec pa-workspace navigation show` 报 `NOT_CONFIGURED`。绑的是**同一次初始化**,
76
+ `ec team navigation show` 报 `NOT_CONFIGURED`。绑定由同一次初始化登记,
77
77
  不是事后补一步——所以它写在 `init` 里,不是单独命令。
78
78
 
79
79
  **`clean` 和 `uninstall` 只差一个词,破坏力差一个量级**:
@@ -151,7 +151,7 @@ node "<技能目录>/scripts/index-rebuild.mjs" --workspace "<工作区绝对路
151
151
  | `DRIFT` | 版本落后 | 走 §五 升级 |
152
152
 
153
153
  > 实测教训:曾跳过体检直接 init,结果 4 个触发器早就存在(比工作区早 20 分钟,
154
- > 是 Core 的 `pa-workspace init` 建的),脚本报了一屏"已存在",agent 又跑去翻源码
154
+ > 是 Core 的 Team Workspace 初始化建的),脚本报了一屏"已存在",agent 又跑去翻源码
155
155
  > 才搞清状况,多花了几十次调用。
156
156
 
157
157
  #### 3.2.2 别读源码
@@ -386,7 +386,7 @@ node "<技能目录>/scripts/check.mjs" --workspace "<路径>"
386
386
  |---|---|---|
387
387
  | 4 个 `pa-*` 触发器 | EvolCore 的系统目录 | 每天半夜按时醒来,对着不存在的路径报错 |
388
388
  | soul/04-working-style.md 的「## 数据位置」小节 | `$PERSONAL_DIR/soul/04-working-style.md` | 新会话每轮都被告知去读一个已经没了的路径 |
389
- | Core 的工作区绑定登记 | `agents/<aid>/data/pa-workspace-state.json` | 导航面板还挂着一个不存在的路径 |
389
+ | Core 的工作区绑定登记 | `agents/<aid>/data/team-workspace-state.json` | 导航面板还挂着一个不存在的路径 |
390
390
 
391
391
  `clean.mjs` 四样一起清(含工作区目录本身):
392
392
 
@@ -400,8 +400,8 @@ node "<技能目录>/scripts/clean.mjs" --workspace "<路径>" --self "<AID>" --
400
400
 
401
401
  **清理是不可逆的,所以默认只预览。** 这不是多余的谨慎——工作区里可能有用户几个月的数据。
402
402
 
403
- **Core 登记为什么要删文件而不是调命令**:`ec pa-workspace` 只有 `init` / `bind` / `navigation`,
404
- **没有 `unbind`**。所以脚本直接删 `pa-workspace-state.json`。
403
+ **Core 登记为什么要删文件而不是调命令**:`ec team` 目前没有单独的 `unbind` 命令,
404
+ 所以 `clean.mjs` 在确认 `rootPath` 与当前工作区完全一致后,直接删除 `team-workspace-state.json`。
405
405
 
406
406
  **删之前必须核对 `rootPath`**:这个文件同时存着 `ownerAid` 和导航条目,
407
407
  只有 `rootPath` 精确等于当前要清理的工作区时才删。指向别的工作区就跳过,
@@ -463,4 +463,4 @@ node "<技能目录>/scripts/pa.mjs" clean --workspace "<路径>" --self "<AID>"
463
463
  每一轮都应该是干净的:没有残留触发器、没有残留 persona 小节、没有残留 Core 登记、没有半截目录。
464
464
  如果第 2 步发现上一轮的残留,那是 bug,不是正常现象。
465
465
 
466
- **测试阶段不要锁定。** 锁上了就只能手动删 LOCK 文件,会打断这个循环。
466
+ **测试阶段不要锁定。** 锁上了就只能手动删 LOCK 文件,会打断这个循环。
@@ -210,8 +210,8 @@ Windows 下忽略大小写。
210
210
 
211
211
  **由 `pa.mjs` 自动完成,不单独调命令。**
212
212
 
213
- `ec pa-workspace bind --workspace <路径>` 把工作区登记进 Core,App 的「个人助理」入口靠它。
214
- 不绑定的话 `ec pa-workspace navigation show` 报 `NOT_CONFIGURED`,App 里看不到任何入口。
213
+ `ec team workspace init --workspace <路径>` 把工作区登记进 Core,App 的工作区入口靠它。
214
+ 不绑定的话 `ec team navigation show` 报 `NOT_CONFIGURED`,App 里看不到任何入口。
215
215
 
216
216
  | 操作 | 绑定行为 |
217
217
  |---|---|
@@ -220,7 +220,7 @@ Windows 下忽略大小写。
220
220
  | `uninstall` | 解绑(工作区档案保留);已绑到别的工作区则拒绝 |
221
221
  | `clean` | **只有真正删掉工作区(带 `--yes`)才解绑**;预览模式不动 |
222
222
 
223
- 登记文件:`$EVOLCORE_HOME/agents/<selfAid>/data/pa-workspace-state.json`。
223
+ 登记文件:`$EVOLCORE_HOME/agents/<selfAid>/data/team-workspace-state.json`。
224
224
  `clean` 解绑前会核对 `rootPath` 指向的是本工作区,指向别处就拒绝删除——
225
225
  这个文件同时存着 ownerAid 和导航条目,误删会影响别的 Agent。
226
226
 
@@ -256,7 +256,7 @@ Windows 下忽略大小写。
256
256
  5. **`soul/04-working-style.md` 里有「数据位置」一节**:工作区路径 + "什么时候该进来读"的入口清单
257
257
  6. **原 persona 已备份**(原本存在时):`04-working-style.before-personal-assistant.md` 内容与原文一致,
258
258
  且撤销命令能原样恢复
259
- 7. **Core 绑定生效**:`ec pa-workspace navigation show` 返回 `ok: true`,不是 `NOT_CONFIGURED`
259
+ 7. **Core 绑定生效**:`ec team navigation show` 返回 `ok: true`,不是 `NOT_CONFIGURED`
260
260
  8. 已报告的能力缺口,用户知情
261
261
 
262
262
  > 第 5 条是硬性的。工作区路径只落在 `.assistant/` 和 Core 导航状态里,两者都不进上下文;
@@ -21,8 +21,8 @@
21
21
  * 不清掉的话,新会话每轮都被告知"去读这个工作区的 INDEX.md",而那个路径已经没了。
22
22
  *
23
23
  * 工作区外(第二块,Core 的登记):
24
- * · Core 的工作区绑定登记 pa-workspace-state.json
25
- * `ec pa-workspace` 只有 init / bind / navigation,没有 unbind,
24
+ * · Core 的 Team Workspace 绑定登记 team-workspace-state.json
25
+ * `ec team` 没有单独 unbind 命令,
26
26
  * 所以这里直接删文件。**删之前必须核对 rootPath 指向的就是本工作区**——
27
27
  * 这个文件里同时存着 ownerAid 和导航条目,误删会影响别的 Agent 的工作区。
28
28
  *
@@ -223,13 +223,13 @@ function resolveCoreBinding() {
223
223
  const candidates = [];
224
224
 
225
225
  if (args.self) {
226
- candidates.push(join(home, 'agents', args.self, 'data', 'pa-workspace-state.json'));
226
+ candidates.push(join(home, 'agents', args.self, 'data', 'team-workspace-state.json'));
227
227
  } else {
228
228
  // 没给 --self:扫所有 agent 找指向本工作区的那个
229
229
  const agentsDir = join(home, 'agents');
230
230
  if (existsSync(agentsDir)) {
231
231
  for (const aid of readdirSync(agentsDir)) {
232
- candidates.push(join(agentsDir, aid, 'data', 'pa-workspace-state.json'));
232
+ candidates.push(join(agentsDir, aid, 'data', 'team-workspace-state.json'));
233
233
  }
234
234
  }
235
235
  }
@@ -300,7 +300,7 @@ function installTriggers(ws, selfAid) {
300
300
  ok.push(triggerIdOf(name));
301
301
  } catch (e) {
302
302
  const detail = String(e.stderr || e.message);
303
- // 已存在不是失败:说明之前装过(可能是别的会话或 Core 的 pa-workspace init)。
303
+ // 已存在不是失败:说明之前装过(可能是别的会话或 Team Workspace 初始化)。
304
304
  // 按幂等原则跳过,不重复创建,也不推翻它。
305
305
  if (/already exists/i.test(detail)) {
306
306
  skipped.push(triggerIdOf(name));
@@ -394,4 +394,4 @@ if (exitCode !== 0) console.log('⚠️ 部分完成,见上面失败项');
394
394
  else if (noop) console.log('✅ 已是最新,无需改动');
395
395
  else console.log('✅ 完成');
396
396
 
397
- process.exit(exitCode);
397
+ process.exit(exitCode);
@@ -86,9 +86,9 @@ function argValue(name) {
86
86
  }
87
87
 
88
88
  /**
89
- * Core 的 PA 工作区绑定。
89
+ * Core 的 Team Workspace 绑定。
90
90
  *
91
- * 少了它,App 里就没有「个人助理」入口,`ec pa-workspace navigation show` 报
91
+ * 少了它,App 里就没有工作区入口,`ec team navigation show` 报
92
92
  * NOT_CONFIGURED。绑定属于初始化的一部分,不是事后补的独立动作。
93
93
  */
94
94
  function coreBinding() {
@@ -100,7 +100,7 @@ function coreBinding() {
100
100
  }
101
101
 
102
102
  const statePath = join(process.env.EVOLCORE_HOME || join(homedir(), '.evolcore'),
103
- 'agents', self, 'data', 'pa-workspace-state.json');
103
+ 'agents', self, 'data', 'team-workspace-state.json');
104
104
 
105
105
  if (op === 'clean') {
106
106
  // 预览模式(没有 --yes)绝不能动登记:clean.mjs 预览时也返回 0,
@@ -135,7 +135,7 @@ function coreBinding() {
135
135
  }
136
136
  if (dryRun) return { ok: true, action: 'bind' };
137
137
  try {
138
- execFileSync('ec', ['pa-workspace', 'bind', '--workspace', workspace], {
138
+ execFileSync('ec', ['team', 'workspace', 'init', '--workspace', workspace], {
139
139
  stdio: 'pipe', encoding: 'utf8', shell: process.platform === 'win32',
140
140
  });
141
141
  return { ok: true, action: 'bound' };
@@ -30,7 +30,7 @@ license: MIT
30
30
 
31
31
  ### 四条反直觉的语义
32
32
 
33
- - **发出即结束**:`ec msg send --thread T2` 返回后当前 turn 立刻终止,不阻塞等回复。
33
+ - **发出即结束**:`ecmsg send --thread T2` 返回后当前 turn 立刻终止,不阻塞等回复。
34
34
  - **复查是唤醒信号,不是执行脚本**:到期只投递一条通知,不保证对端已回,不携带操作命令。
35
35
  - **决策权在自己**:要不要回、何时回、回什么,全自主。
36
36
  - **无"等齐"原语**:想等多方回复,就在各自 turn 里用 `ec thread history` 主动读另一话题。
@@ -61,10 +61,10 @@ license: MIT
61
61
  ```bash
62
62
  # 1. 找或建与 C 的话题
63
63
  ec thread list <C的AID>
64
- ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回裸 threadId
64
+ ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回 thread-… 形式的 threadId
65
65
 
66
- # 2. 发消息,--check-every 一步搞定复查(跨话题必填:5m / 30m / 2h / 1d)
67
- ec msg send '项目当前进度如何?' --thread <裸threadId> --check-every 5m
66
+ # 2. 发消息,--check-every 一步搞定复查(跨话题可自定义:5m / 30m / 2h / 1d,省略即 20m)
67
+ ecmsg send '项目当前进度如何?' --thread <threadId> --check-every 5m
68
68
 
69
69
  # 3. 本 turn 结束,不阻塞
70
70
  ```
@@ -78,7 +78,7 @@ ec msg send '项目当前进度如何?' --thread <裸threadId> --check-every 5
78
78
  你收到的是**普通消息**,不带话题链注入(上下文只注入在发送方的目标话题里)。处理完自行决定回不回:
79
79
 
80
80
  ```bash
81
- ec msg send '进度 70%,预计下周完成' # 不带 --thread,发在当前话题
81
+ ecmsg send '进度 70%,预计下周完成' # 不带 --thread,发在当前话题
82
82
  ```
83
83
 
84
84
  同话题追问也不带 `--thread`,同样不建复查。
@@ -104,7 +104,7 @@ ec thread history <来源话题id> --after <发送于的时间戳>
104
104
  ```bash
105
105
  ec trigger delete <trig_id> # 完成:删除,不留残留
106
106
  ec trigger update <trig_id> --every 30m # 放宽
107
- ec msg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m # 汇报(跨话题,复查必填)
107
+ ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m # 汇报(跨话题,省略即默认 20m)
108
108
  ```
109
109
 
110
110
  **关键点**:
@@ -117,10 +117,10 @@ ec msg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m
117
117
  ### D. 并发委托多方
118
118
 
119
119
  ```bash
120
- ec msg send '技术评估' --thread <T2> --check-every 10m
121
- ec msg send '产品评估' --thread <T3> --check-every 10m
120
+ ecmsg send '技术评估' --thread <T2> --check-every 10m
121
+ ecmsg send '产品评估' --thread <T3> --check-every 10m
122
122
  # 之后在每个先到的 turn 里,用 ec thread history 读另一话题,齐了再合并回 T1
123
- ec msg send '综合评估:……' --thread <T1> --check-every 30m
123
+ ecmsg send '综合评估:……' --thread <T1> --check-every 30m
124
124
  ```
125
125
 
126
126
  ### E. 查询与维护命令
@@ -178,7 +178,7 @@ ec thread summary show <threadId>
178
178
 
179
179
  **不要**:
180
180
  1. 发完阻塞等回复——turn 已结束,回复会触发新 turn。
181
- 2. 漏掉 `--check-every`——跨话题不发复查,对端不回你永远不会知道。
181
+ 2. 以为省略 `--check-every` 就不建复查——跨话题一律自动建复查(缺省 20m),不需要时用回执里的 `trigger_id` 执行 `ec trigger delete`。
182
182
  3. 托管会话里手写 `from/to`。
183
183
  4. 把复查通知当"强制回复"或执行脚本。
184
184
  5. 在复查 turn 里再 `--check-every`(会套娃)。
@@ -19,9 +19,9 @@ ecmsg send '<text>' [--file <path> --as image|video|voice|file] [--payload '<jso
19
19
  {{/}}
20
20
  {{?peerId}}
21
21
  ecmsg send '<text>' [--text-from-file <path>] [--encrypt yes|no|auto] [--file <path> --as image|video|voice|file] [--link <url> --title '<title>'] [--payload '<json>' --return none|required --timeout <duration> --format json]
22
- `ecmsg send` 在 proactive/paactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。paactive 的普通模型文本由框架投影为 activity。
23
- 当用户想获取、读取、查询或汇总属于某个主体的数据时,无论主体通过“我/你”、姓名、关系称谓还是 AID 指代,都先依据当前关系层、明确 AID 或可靠身份/联系人信息确认主体是谁并解析到准确 AID;姓名不明或有歧义时才询问。必要时加载 `ec-identity` 解析姓名。随后加载内置技能 `aid-ability`,检查该主体 AID 是否发布了匹配的数据能力;数据类型和来源不设限。若数据由关联设备或服务提供,只能依据能力索引或可信身份信息确认对应 Provider AID,不得猜测。
24
- 用户要求发现或调用其他 AID 的能力时使用 `aid-ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时使用 `ec-ability`。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `ecmsg send --to <AID> --return required`;它会按 `--timeout`(默认 60s,最大 3600s)使用 AUN volatile 非持久消息。等待超时后用 `ec msg request get` 查询,不要自动重发。`message_id` 只表示传输 ACK,不表示能力执行完成。
22
+ `ecmsg send` 在 proactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。
23
+ 当用户想获取、读取、查询或汇总属于某个主体的数据时,无论主体通过“我/你”、姓名、关系称谓还是 AID 指代,都先依据当前关系层、明确 AID 或可靠身份/联系人信息确认主体是谁并解析到准确 AID;姓名不明或有歧义时才询问。必要时加载 `ec-identity` 解析姓名。随后加载通用内置技能 `ability`(`ec skill load ability`),按其中的远端调用流程检查该主体 AID 是否发布了匹配的数据能力;数据类型和来源不设限。L1 能力索引使用 `ec fs cat <provider-aid>:/ability/index.json` 读取。若数据由关联设备或服务提供,只能依据能力索引或可信身份信息确认对应 Provider AID,不得猜测。
24
+ 用户要求发现或调用其他 AID 的能力时使用通用技能 `ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时,也使用该技能中的 EvolCore 插件流程和 `ec ability` 命令。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `ecmsg send --to <AID> --return required`;它会按 `--timeout`(默认 60s,最大 3600s)使用 AUN volatile 非持久消息。等待超时后用 `ec msg request get` 查询,不要自动重发。`message_id` 只表示传输 ACK,不表示能力执行完成。
25
25
  {{/}}
26
26
  每次调用仍须遵守 `[reply]` 的单条命令及加密要求。
27
27
  {{/}}
@@ -1,20 +1,23 @@
1
- [commands] 当前场景可用命令集(前缀 ec,以自己 AID 为发送者;完整用法 Read 对应文档)
2
- 遇到明确触发词(费用/用量/统计/创建agent/建群/查群/群聊协作/任务分派等)优先查 INDEX.md 或直接试对应 ec 命令
1
+ [commands] 当前场景可用命令集(完整用法 Read 对应文档)
2
+ **发送消息只有 `ecmsg` 一个入口**,写法见 `[reply]` 段与 `$KITS_DOCS/evolcore/msg.md`。
3
+ 遇到明确触发词(费用/用量/统计/创建agent/建群/查群/群聊协作/任务分派等)优先查 INDEX.md
3
4
 
4
5
  生命周期保护仅针对承载当前会话的 EvolCore 实例;其他实例按用户授权和目标端权限处理,不限管理通道。完整规则见 `$KITS_RULES/06-channel.md`。
5
6
 
6
7
  ecmsg 发送消息(统一入口:当前会话 / --thread 跨话题 / --to 指定对端;文件、链接、payload、加密) $KITS_DOCS/evolcore/msg.md
7
8
  ec memory 记忆写入与整理(note 写入/修改/撤销/查看;consolidate 触发整理;何时写见 [memory] 段) $KITS_DOCS/evolcore/memory.md
8
- ec ctl 当前会话工具(发文件、重命名、队列、项目路径、会话状态) $KITS_DOCS/evolcore/ctl.md
9
+ ec ctl 当前会话工具(重命名、队列、项目路径、会话状态) $KITS_DOCS/evolcore/ctl.md
9
10
  ec model 模型与推理强度管理(切模型/列模型/当前模型/模型详情/改强度/诊断网关) $KITS_DOCS/evolcore/model.md
10
11
  ec response 响应模式管理(切换响应模式/列响应模式/看当前模式/改响应配置) $KITS_DOCS/evolcore/response.md
11
12
  ec stats Token 用量与费用统计(用量/费用/统计/预算/token/cost) $KITS_DOCS/evolcore/stats.md
12
13
  ec config 读配置/查字段/看生效值(get/show/list/effective/fields/history/diff/current/boots/validate);set/unset 权限由 API 层控制 $KITS_DOCS/evolcore/config.md
13
14
  ec trigger 定时与事件触发器管理(create/update/list/run/enable/disable/delete;set 仅为 create 兼容别名)。需要写操作的无人值守任务用 --permission bypass;单个 trigger 可用 --model/--effort 覆盖执行模型/强度 $KITS_DOCS/evolcore/trigger.md
15
+ ec events 事件中心运维(status/ledger/tail/doctor/reload/allowlist/publish;事件是 TTL 内的在线通知,不落库不重放,不能丢的用普通消息) $KITS_DOCS/evolcore/event-center.md
16
+ ec services 服务路由运维与对端调用(status/types/ledger/tail/doctor/reload/enable/disable;describe/schema/call 调对端服务;服务调用是点对点、要结果、不丢) $KITS_DOCS/evolcore/services.md
14
17
  {{?channel=aun}}
15
18
  {{?chatType=private}}
16
19
  {{?peerRole=owner}}
17
- ec pa-workspace 个人助理工作区初始化与入口导航(init/bind/navigation show/navigation update;初始化会先运行 personal-assistant Skill,再登记工作区) $KITS_DOCS/evolcore/pa-workspace.md
20
+ ec team 初始化当前 Agent 的 Team Workspace、发布/删除/替换导航入口、管理团队成员 $KITS_DOCS/evolcore/team-workspace.md
18
21
  {{/}}
19
22
  {{/}}
20
23
  {{/}}
@@ -25,17 +28,16 @@ ec task 恢复暂停或异常中断的会话任务(resume <sessionId>;
25
28
  ec task 恢复暂停或异常中断的本 Agent 会话任务(resume <sessionId>;复用原 baseagent 会话,缺失时失败关闭) $KITS_DOCS/evolcore/task.md
26
29
  {{/}}
27
30
  ec skill 技能加载与管理(load 加载正文/path 查路径/list 列技能/info 详情/where 根目录/enable/disable/install/remove) $KITS_DOCS/evolcore/skill.md
28
- ec ability 按 AID 管理和开发能力插件(context/--self、dev 构建打包、发布下架、状态诊断与作业等待;写操作仍按目标授权) $KITS_DOCS/evolcore/ability.md
31
+ ec ability 按 AID 开发、管理与本地调用能力插件(dev 构建打包、context/--self、invoke、发布下架、状态诊断与作业等待;Ability 规范模型、任务分流及远端调用流程见 ability 技能;写操作仍按目标授权) $KITS_DOCS/evolcore/ability.md
29
32
  ec aid 身份/证书/名片/换头像(avatar --file/--url)/探测对端 $KITS_DOCS/evolcore/aid.md
30
33
  ec directory 联系人名录(list 列举+--filter 关键词过滤+分页/info 按名字或 AID 看详情/refresh 重算注入/blocked 拉黑总览/request 发加好友申请);备注直接读写 directory/remarks/<AID>.md 再 refresh $KITS_DOCS/evolcore/directory.md
31
34
  ec fs AUN 文件系统统一入口(ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/setfacl/getfacl/token/find/df/mount/approve/reject/umount;个人/群空间同一入口;没有 ec group fs) $KITS_DOCS/evolcore/fs.md
32
35
  ec storage 文件上传/下载/配额(底层调试入口,日常优先 ec fs) $KITS_DOCS/evolcore/storage.md
33
36
  {{?peerId}}
34
- ec msg 私聊收发消息(原始 JSON / 请求等待 / 结果查询 / 拉取 / 撤回) $KITS_DOCS/evolcore/msg.md
35
37
  ec thread 话题管理与话题链(peers 列对端 / list 列话题 / history 读历史 / show / summary / rename / label / status / delete / create)。peer 为对端裸 AID(如 alice.agentid.cn),不是 peerKey 那种 aun# 形态;本端身份自动注入,不写 --self。示例: ec thread peers → ec thread list <对端裸AID> → ec thread history <threadId> $KITS_DOCS/evolcore/thread-chain.md
36
38
  {{/}}
37
39
  {{?selfAid}}
38
- ec group 群聊收发与群管理(群发/建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则;完整协作使用 ec-group-collaboration 技能) $KITS_DOCS/evolcore/group.md
40
+ ec group 群管理(建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则;发送群消息用 ecmsg,完整协作使用 ec-group-collaboration 技能) $KITS_DOCS/evolcore/group.md
39
41
  {{/}}
40
42
  {{?peerRole=owner}}
41
43
  ec agent EvolAgent 生命周期与主机信息(创建/启停/热重载/改配置/查主机信息;创建流程使用 ec-agent-create 技能)。ec agent reload 仅对配置/soul/memory 生效,改源码无效 $KITS_DOCS/evolcore/agent.md
@@ -16,9 +16,6 @@ Bootstrap 只允许向当前 owner 提问、回显最终值、请求确认或说
16
16
  {{?chatMode=interactive}}
17
17
  interactive:直接输出文本就是回复,由框架自动投递。当前会话的普通文本回复无需调用发送命令;不要先手动发送同一正文,再输出“已发送”等重复说明。
18
18
  {{/}}
19
- {{?chatMode=paactive}}
20
- paactive:模型自动产生的普通文本由框架转为 activity 展示,不构成正式回复;需要正式回复时使用托管发送命令。工具、文件、图片、审批/提问卡片和 notify 沿用 interactive 行为。
21
- {{/}}
22
19
  {{?chatMode=proactive}}
23
20
  proactive:普通输出作为思考过程展示,不作为正式回复、不触发对端的消息接收。要正式回复,必须使用下面的托管发送命令。
24
21
  首轮工具调用里要包含一次托管发送命令,说明当前情况和下一步意图。连续多轮没有成功发送时,框架只放行发送命令,其他工具会被拒绝。
@@ -34,7 +31,7 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
34
31
  | 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
35
32
  | 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
36
33
 
37
- - `--thread` 只接受两种形态:`thread-…`(独立话题)与 `main:<aidA>:<aidB>`(主话题)。话题必须存在于本端索引,先用 `ec thread list <对端AID>` 查看。
34
+ - `--thread` 只接受两种形态:`thread-…`(独立话题)与 `main:<aidA>:<aidB>`(主话题)。话题必须存在于本端索引,先用 `ec thread list <对端AID>` 查看。群的主话题同样写成 `main:<本端AID>:<群AID>`(两种顺序等价);在群的子话题里要回群主话题,必须写 `--thread main:<本端AID>:<群AID>`,`--to <群AID>` 只会留在当前子话题。
38
35
  - 本端恒为当前会话本端,无需也无法指定;`--from` 仅作协议兼容。
39
36
  - 正文是位置参数;附件、链接、payload 用选项表达(见下)。
40
37
 
@@ -62,6 +59,7 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
62
59
  | 读文件作正文 | `ecmsg send --text-from-file <path>` |
63
60
  | 链接卡片 | `ecmsg send --link <url> [--title '<标题>']` |
64
61
  | 自定义 payload | `ecmsg send --payload '<json>'` |
62
+ | @提及(仅群聊) | `ecmsg send '<text>' --mention '<aid1>,<aid2>'` 或 `--mention-all`;私聊带 `--mention` 会被拒绝 |
65
63
 
66
64
  ## 回执
67
65
 
@@ -70,11 +68,9 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
70
68
  发送成功后继续本轮必要步骤,不重复发送同一正文或补发“已发送”回执。
71
69
  {{?chatMode!=interactive}}
72
70
  {{?chatMode!=proactive}}
73
- {{?chatMode!=paactive}}
74
71
  当前 chatMode 缺失或无效;说明运行时上下文不完整,不根据 peerType 或 chatType 猜测回复模式。
75
72
  {{/}}
76
73
  {{/}}
77
- {{/}}
78
74
 
79
75
  发送约束:
80
76
  - 只能使用当前会话的 delegated sender,经 daemon IPC 发送;保留托管环境,不另建 SDK 连接。不为绕过限制改写身份、对端或 thread 路由。
@@ -39,7 +39,7 @@ readonly: true — 禁止写入项目目录及临时目录;如需生成文件
39
39
  {{/}}
40
40
  # 决定响应后:
41
41
  # 命令速查:
42
- # 每次工具调用只执行一条完整的 ec 命令;禁止 command -v。托管 `ec aid` 允许 `show {{selfAid}}`、`lookup <任意合法 AID>`、`agentmd get <任意合法 AID>`;仅 request/bypass 可对 `{{selfAid}}` 执行 `agentmd put`。可选后缀仅限 --format json;禁止 &&、||、;、子 shell、bash -lc/sh -c 或其它脚本与其串联。Bash 下输出过长时,可在 ec 后接只读 stdin 的过滤管道收窄输出,或用 `> $TMPDIR/<新文件>` 存盘后另行处理;PowerShell/cmd 下两者都不支持。
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 下输出过长时,可在命令后接只读 stdin 的过滤管道收窄输出,或用 `> $TMPDIR/<新文件>` 存盘后另行处理;PowerShell/cmd 下两者都不支持。
43
43
  # 审批拒绝时原样报告并停止;必须收到包含 message_id/status 的成功回执后才能声称已发送。
44
44
  # 正式回复统一用 ecmsg send '<text>';指定话题加 --thread,指定对端加 --to。
45
45
  # 本端恒为当前会话本端,无需指定;文件/链接/跨话题/完整选项见 $KITS_DOCS/evolcore/msg.md
@@ -14,36 +14,38 @@
14
14
  ec agent list
15
15
 
16
16
  # 2. 列出某 agent 有话题记录的所有对端
17
- ec thread peers --self <selfAid>
17
+ ec thread peers
18
18
 
19
19
  # 3. 列出与某对端的所有话题(默认10条/页,含消息统计和摘要)
20
- ec thread list <peer> --self <selfAid>
20
+ ec thread list <peer>
21
21
 
22
- # 4. 翻页(页脚自动给出完整翻页命令,含真实 peer 和 selfAid)
23
- ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
22
+ # 4. 翻页(页脚自动给出完整翻页命令,含真实 peer)
23
+ ec thread list <peer> --page 2 --limit 10 --sort recent
24
24
 
25
25
  # 5. 查看某话题的历史消息
26
- ec thread history <peer>/<threadId> --self <selfAid> --limit 20
26
+ ec thread history <peer>/<threadId> --limit 20
27
27
 
28
28
  # 6. 查看话题摘要(写摘要见下文「话题摘要维护」)
29
- ec thread summary show <peer>/<threadId> --self <selfAid>
29
+ ec thread summary show <peer>/<threadId>
30
30
  ```
31
31
 
32
+ > 本端身份由运行时注入,托管会话一律不写 `--self`;`--self` 只用于宿主终端(见下方改名示例)。
33
+
32
34
  ## 跨话题发送(联系当前对端以外的对象)
33
35
 
34
36
  一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端;要联系**其他**对象,必须换到与该对象的话题上发送:
35
37
 
36
38
  ```bash
37
39
  # 1. 选中目标话题(没有就新建)
38
- ec thread list <对方AID> --self <selfAid>
39
- ec thread create <对方AID> --name '问题跟踪' --self <selfAid> # 返回 threadId
40
+ ec thread list <对方AID>
41
+ ec thread create <对方AID> --name '问题跟踪' # 返回 threadId
40
42
 
41
43
  # 2. 带上话题发送;本端/对端由话题推断
42
44
  ecmsg send '<text>' --thread <threadId> --check-every 5m
43
45
  ```
44
46
 
45
47
  - 目标与会话不一致即为跨话题,`ecmsg` 会自动建复查;缺省 20m,要改周期才写 `--check-every`
46
- - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>` 两种形态,且必须已存在于本端索引,否则报 `TOPIC_NOT_FOUND`
48
+ - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>` 两种形态,形态不对报 `INVALID_THREAD_REF`;话题必须已存在于本端索引,否则报 `TOPIC_NOT_FOUND`。群的主话题同样写成 `main:<本端AID>:<群AID>`,在群子话题里回群主话题必须写它(`--to <群AID>` 只会留在当前子话题)
47
49
  - 跨话题需要从 AUN 会话发起;其它渠道的会话只能回复本会话对端
48
50
  - 发送成功后本端写入 thread-inbox:目标话题下次被唤醒时注入一次来源话题上下文,然后删除
49
51
  - `--check-every` 会创建周期复查 Trigger(每次发送各新建一个,名称 `check-<目标>-from-<来源>-<唯一后缀>`),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evolcore",
3
- "version": "0.0.43-test.5",
3
+ "version": "0.0.43-test.7",
4
4
  "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -39,6 +39,7 @@
39
39
  "!ONBOARDING.md",
40
40
  "!TODO.md",
41
41
  "!SKILLS.md",
42
+ "!THIRD_PARTY_NOTICES.md",
42
43
  "!echo-rtt-fix-handoff.md",
43
44
  "!proxy-setup.md",
44
45
  "!evolcore-install-aun.md"
@@ -57,14 +58,11 @@
57
58
  "test:owner-directory-authorization": "npm run test:owner-directory-cache && npm run test:owner-directory-admission",
58
59
  "test:owner-directory-admission": "node --import tsx --test tests/owner-directory-admission.node.ts",
59
60
  "test:contact-admission": "node --import tsx --test tests/contact-admission.node.ts",
60
- "test:ownership-startup": "node --import tsx --test tests/ownership-startup.node.ts tests/ownership-refresh-memory.node.ts",
61
- "test:initialization-diagnostics": "node --import tsx --test tests/initialization-diagnostics.node.ts",
62
- "test:hooks": "vitest run tests/unit/codex-hook-diagnostics.test.ts",
63
61
  "verify:request-identity": "npm run build && node scripts/verify-request-identity.mjs",
64
62
  "prepublishOnly": "npm test"
65
63
  },
66
64
  "dependencies": {
67
- "@agentunion/fastaun": "^0.5.32",
65
+ "@agentunion/fastaun": "^0.5.33",
68
66
  "@anthropic-ai/claude-agent-sdk": "0.3.300",
69
67
  "@modelcontextprotocol/sdk": "^1.32.2",
70
68
  "ajv": "^8.20.0",
@@ -72,7 +70,7 @@
72
70
  "chokidar": "^5.0.0",
73
71
  "cron-parser": "^5.5.0",
74
72
  "dotenv": "^17.4.2",
75
- "ec-web": "0.0.43-test.5",
73
+ "ec-web": "0.0.43-test.7",
76
74
  "ignore": "7.0.5",
77
75
  "image-type": "^6.0.0",
78
76
  "partial-json": "0.1.7",
@@ -93,6 +91,7 @@
93
91
  "pure-qqbot": "^2.0.0"
94
92
  },
95
93
  "overrides": {
94
+ "@agentunion/fastaun": "$@agentunion/fastaun",
96
95
  "qs": "6.16.1",
97
96
  "smol-toml": "$smol-toml"
98
97
  },