evolcore 0.0.45 → 0.0.47

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 (228) hide show
  1. package/CHANGELOG.md +113 -0
  2. package/bin/ecmsg.js +33 -23
  3. package/dist/ability/application-service.js +1 -2
  4. package/dist/ability/package.js +28 -0
  5. package/dist/agent-template/jobs.js +158 -36
  6. package/dist/agent-template/runtime.js +401 -34
  7. package/dist/agent-template/service.js +764 -369
  8. package/dist/agent-template/tool-runner.js +35 -17
  9. package/dist/agent-template/types.js +7 -4
  10. package/dist/agents/baseagent.js +10 -9
  11. package/dist/agents/claude-runner.js +22 -6
  12. package/dist/agents/codex/app-server-client.js +34 -27
  13. package/dist/agents/codex/diagnostics.js +18 -1
  14. package/dist/agents/codex-runner.js +3 -1
  15. package/dist/agents/ecagent-runner.js +3 -1
  16. package/dist/agents/gemini-runner.js +2 -1
  17. package/dist/aun/group/fs-download.js +1 -1
  18. package/dist/aun/menu/client.js +142 -182
  19. package/dist/aun/rpc/client.js +33 -17
  20. package/dist/aun/service-proxy.js +6 -23
  21. package/dist/channels/aun.js +675 -120
  22. package/dist/channels/daemon.js +1 -1
  23. package/dist/cli/agent-create.js +37 -10
  24. package/dist/cli/agent-template.js +105 -84
  25. package/dist/cli/agent.js +31 -18
  26. package/dist/cli/daemon-commands.js +42 -56
  27. package/dist/cli/daemon-lifecycle-client.js +55 -19
  28. package/dist/cli/directory.js +12 -4
  29. package/dist/cli/ecmsg-gateway.js +5 -2
  30. package/dist/cli/events-command.js +2 -1
  31. package/dist/cli/init-channel.js +2 -2
  32. package/dist/cli/init.js +57 -21
  33. package/dist/cli/integrity-command.js +2 -0
  34. package/dist/cli/managed-command-guard.js +20 -1
  35. package/dist/cli/menu-client.js +7 -5
  36. package/dist/cli/restart-monitor.js +135 -46
  37. package/dist/cli/services-command.js +28 -5
  38. package/dist/cli/task-context.js +83 -15
  39. package/dist/cli/upgrade-command.js +4 -2
  40. package/dist/config/config-field-policy.js +24 -0
  41. package/dist/config/config-manager.js +49 -19
  42. package/dist/config/peer-book-store.js +167 -127
  43. package/dist/config/peer-role-resolver.js +24 -4
  44. package/dist/config/provider-identity-migration.js +158 -6
  45. package/dist/config/provider-identity.js +10 -4
  46. package/dist/config/provider-ipc-service.js +10 -2
  47. package/dist/config/provider-local-sync.js +2 -2
  48. package/dist/config/providers-config.js +95 -10
  49. package/dist/config/providers-import.js +4 -6
  50. package/dist/config/providers.js +14 -3
  51. package/dist/config/role-store.js +1 -1
  52. package/dist/config/schema-migration.js +123 -16
  53. package/dist/config/schema-registry.js +6 -2
  54. package/dist/config-store.js +9 -1
  55. package/dist/core/agent-application-service.js +56 -29
  56. package/dist/core/agent-create-status.js +3 -1
  57. package/dist/core/agent-creation-claim.js +1 -0
  58. package/dist/core/agent-ipc-registration.js +2 -2
  59. package/dist/core/agent-reload-coordinator.js +38 -1
  60. package/dist/core/agent-runtime.js +91 -43
  61. package/dist/core/auth/agent-delegation.js +13 -3
  62. package/dist/core/auth/delegation-diagnostics.js +56 -15
  63. package/dist/core/auth/operation-authorizer.js +2 -2
  64. package/dist/core/auth/operation-catalog.js +3 -3
  65. package/dist/core/bootstrap-service.js +3 -0
  66. package/dist/core/capability/capability-manager.js +3 -1
  67. package/dist/core/channel-loader.js +29 -3
  68. package/dist/core/channel-runtime.js +1 -1
  69. package/dist/core/command/agent-control.js +6 -5
  70. package/dist/core/command/agent-template-menu.js +32 -97
  71. package/dist/core/command/eventcenter-menu.js +61 -13
  72. package/dist/core/command/menu-catalog.js +11 -4
  73. package/dist/core/command/menu-handler.js +39 -12
  74. package/dist/core/command/menu-protocol.js +8 -16
  75. package/dist/core/command/skill-slash.js +6 -2
  76. package/dist/core/command/slash-handler.js +4 -6
  77. package/dist/core/command/team-workspace-bootstrap.js +1 -2
  78. package/dist/core/command/team-workspace-management-store.js +83 -0
  79. package/dist/core/command/team-workspace-management.js +1 -2
  80. package/dist/core/command/team-workspace-team.js +26 -3
  81. package/dist/core/daemon-bootstrap.js +11 -9
  82. package/dist/core/daemon-control.js +4 -7
  83. package/dist/core/daemon-lifecycle.js +189 -143
  84. package/dist/core/evolagent-registry.js +50 -2
  85. package/dist/core/evolagent.js +2 -1
  86. package/dist/core/file-integrity/read.js +9 -16
  87. package/dist/core/file-integrity/store.js +94 -34
  88. package/dist/core/handoff/dispatcher.js +33 -7
  89. package/dist/core/handoff/runtime.js +8 -0
  90. package/dist/core/host-snapshot.js +9 -4
  91. package/dist/core/inference/text-inference.js +12 -2
  92. package/dist/core/initialization/service.js +22 -4
  93. package/dist/core/invoke/invoke-service.js +24 -3
  94. package/dist/core/ipc-registration.js +7 -3
  95. package/dist/core/memory/consolidation.js +6 -6
  96. package/dist/core/message/aun-ipc-sender.js +109 -7
  97. package/dist/core/message/contact-admission.js +6 -2
  98. package/dist/core/message/message-bridge.js +13 -0
  99. package/dist/core/message/message-queue.js +131 -30
  100. package/dist/core/message/pending-hints.js +8 -0
  101. package/dist/core/message/response-engine.js +48 -2
  102. package/dist/core/message/send-routing.js +3 -12
  103. package/dist/core/model/catalog-service.js +13 -0
  104. package/dist/core/model/model-catalog.js +57 -18
  105. package/dist/core/ownership/owner-resolver.js +27 -10
  106. package/dist/core/pack-auth.js +163 -31
  107. package/dist/core/pack-install.js +42 -1
  108. package/dist/{services/ledger.js → core/pack-ledger.js} +17 -6
  109. package/dist/core/permission/ec-command-parser.js +3 -1
  110. package/dist/core/permission/shell-environment.js +23 -0
  111. package/dist/core/rate-window.js +6 -1
  112. package/dist/core/relation/peer-identity.js +5 -1
  113. package/dist/core/relation/same-owner-proof.js +2 -1
  114. package/dist/core/session/adapters/claude-session-file-adapter.js +1 -1
  115. package/dist/core/session/session-file-health.js +36 -7
  116. package/dist/core/session/session-idle-monitor.js +0 -1
  117. package/dist/core/session/session-manager.js +14 -0
  118. package/dist/core/session/session-title.js +26 -6
  119. package/dist/core/skill/index-generator.js +3 -4
  120. package/dist/core/task/task-image-resources.js +1 -1
  121. package/dist/core/thread/thread-service.js +0 -1
  122. package/dist/core/thread/topic-id.js +8 -0
  123. package/dist/directory/owner-directory-admission.js +17 -0
  124. package/dist/directory/owner-directory-cache.js +3 -1
  125. package/dist/directory/owner-directory-markdown.js +145 -23
  126. package/dist/directory/owner-directory-policy.js +23 -0
  127. package/dist/directory/owner-directory-query-operation.js +20 -6
  128. package/dist/directory/owner-directory-search.js +47 -0
  129. package/dist/eck/message-renderer.js +171 -32
  130. package/dist/ecweb/basic-settings-service.js +7 -3
  131. package/dist/ecweb/providers-service.js +17 -10
  132. package/dist/ecweb/runtime/lifecycle.js +65 -16
  133. package/dist/ecweb/runtime/supervisor.js +79 -50
  134. package/dist/event-center/admission-materializer.js +1 -1
  135. package/dist/event-center/bus-gate.js +48 -4
  136. package/dist/event-center/bus-host.js +3 -3
  137. package/dist/event-center/center-config.js +57 -28
  138. package/dist/event-center/dispatcher.js +8 -0
  139. package/dist/event-center/event-log.js +69 -27
  140. package/dist/event-center/index-generator.js +6 -1
  141. package/dist/event-center/ipc-operation.js +66 -25
  142. package/dist/event-center/pack-loader.js +12 -55
  143. package/dist/event-center/pack-manager.js +5 -3
  144. package/dist/event-center/registry.js +48 -52
  145. package/dist/event-center/runtime.js +219 -81
  146. package/dist/event-center/script-runner.js +18 -7
  147. package/dist/event-center/types.js +9 -1
  148. package/dist/event-center/validation.js +33 -4
  149. package/dist/index.js +132 -75
  150. package/dist/ipc.js +35 -8
  151. package/dist/product.js +1 -0
  152. package/dist/proxy/manager.js +52 -11
  153. package/dist/proxy/service-supervisor.js +265 -67
  154. package/dist/services/dispatcher.js +26 -3
  155. package/dist/services/idempotency.js +128 -0
  156. package/dist/services/identity.js +3 -27
  157. package/dist/services/index-generator.js +5 -1
  158. package/dist/services/index.js +244 -45
  159. package/dist/services/ipc-operation.js +164 -20
  160. package/dist/services/pack-manager.js +37 -9
  161. package/dist/services/router.js +100 -31
  162. package/dist/services/script-runner.js +15 -4
  163. package/dist/services/service-payload.js +50 -2
  164. package/dist/services/validation.js +107 -3
  165. package/dist/trigger/scheduler.js +18 -4
  166. package/dist/trigger/script-sandbox.js +39 -2
  167. package/dist/trigger/state.js +7 -0
  168. package/dist/utils/aid-bind.js +155 -18
  169. package/dist/utils/atomic-write.js +3 -3
  170. package/dist/utils/cross-platform.js +59 -16
  171. package/dist/utils/error-utils.js +26 -1
  172. package/dist/utils/instance-registry.js +94 -35
  173. package/dist/utils/process-introspect.js +187 -27
  174. package/dist/utils/project-path.js +47 -3
  175. package/dist/utils/upgrade-jobs.js +4 -4
  176. package/dist/utils/windows-shell-trust.js +174 -68
  177. package/kits/docs/context-assembly.md +3 -3
  178. package/kits/docs/evolcore/agent.md +28 -10
  179. package/kits/docs/evolcore/aid.md +3 -1
  180. package/kits/docs/evolcore/config.md +22 -0
  181. package/kits/docs/evolcore/directory.md +46 -12
  182. package/kits/docs/evolcore/event-center.md +6 -6
  183. package/kits/docs/evolcore/group-collaboration.md +1 -1
  184. package/kits/docs/evolcore/menu-client.md +7 -5
  185. package/kits/docs/evolcore/menu-protocol.md +5 -3
  186. package/kits/docs/evolcore/msg.md +10 -3
  187. package/kits/docs/evolcore/provider.md +17 -5
  188. package/kits/docs/evolcore/services.md +145 -12
  189. package/kits/docs/evolcore/thread-chain.md +17 -9
  190. package/kits/docs/prompt-loading-architecture.md +4 -4
  191. package/kits/eck_message_manifest.json +46 -3
  192. package/kits/rules/04-relation.md +10 -2
  193. package/kits/rules/06-channel.md +2 -1
  194. package/kits/schemas/providers.schema.2.json +1 -0
  195. package/kits/skills/ec-group/SKILL.md +4 -0
  196. package/kits/skills/ec-skill/scripts/cli.mjs +1 -1
  197. package/kits/skills/ec-skill/scripts/skill.mjs +13 -2
  198. package/kits/skills/thread-ops/SKILL.md +8 -5
  199. package/kits/templates/message-fragments/group-batch-item.md +3 -0
  200. package/kits/templates/message-fragments/group-batch.md +1 -0
  201. package/kits/templates/message-fragments/item-group.md +4 -0
  202. package/kits/templates/message-fragments/item-private.md +4 -0
  203. package/kits/templates/message-fragments/thread-context.md +1 -1
  204. package/kits/templates/system-fragments/commands.md +5 -5
  205. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  206. package/kits/templates/system-fragments/relation.md +11 -7
  207. package/package.json +3 -2
  208. package/scripts/agent-template/index.mjs +9 -4
  209. package/scripts/agent-template/inspect.mjs +16 -9
  210. package/scripts/agent-template/shared/plan.mjs +3 -33
  211. package/scripts/agent-template/shared/template-contract.mjs +186 -3
  212. package/scripts/agent-template/shared/template-package.mjs +119 -10
  213. package/scripts/agent-template/shared/template-runtime.mjs +49 -6
  214. package/scripts/agent-template/shared/template.mjs +5 -5
  215. package/scripts/agent-template/team-pack.mjs +245 -0
  216. package/scripts/agent-template/team-preview.mjs +111 -0
  217. package/scripts/aid-batch/identity-batch.mjs +143 -0
  218. package/dist/ability/versions.js +0 -32
  219. package/dist/aun/model-headers.js +0 -17
  220. package/dist/channels/builtin-plugins.js +0 -19
  221. package/dist/core/command/team-workspace-initializer.js +0 -2
  222. package/dist/core/command/team-workspace-job-store.js +0 -88
  223. package/dist/core/command/team-workspace-management-service.js +0 -2
  224. package/dist/core/contact-bind-registry.js +0 -27
  225. package/dist/event-center/ledger.js +0 -52
  226. package/dist/services/reply.js +0 -55
  227. package/kits/templates/message-fragments/item.md +0 -3
  228. package/scripts/agent-template/pack.mjs +0 -169
@@ -1,6 +1,6 @@
1
1
  # ec menu-client — 远程 Daemon Menu 客户端
2
2
 
3
- 向另一台主机的 EvolCore Control AID 发送标准 `menu.*` 请求。独立终端使用 AUN 短连接完成发送、拉取、匹配和 ACK;EvolCore 托管 Agent 自动通过当前 daemon 的委托入口与现有 AUN 连接完成调用。
3
+ 向另一台主机的 EvolCore Control AID 发送标准 `menu.*` 请求。独立终端在 AUN 短连接建立前注册消息订阅,通过 SDK 标准事件接收响应;EvolCore 托管 Agent 自动通过当前 daemon 的委托入口与现有 AUN 连接完成调用。分类能力协商、control 降级、游标、恢复和 ACK 均由 SDK 管理。
4
4
 
5
5
  > **本文只讲工具用法**(CLI 语法、参数、连接与输出行为)。
6
6
  > Menu 消息的格式、`protected_headers`、鉴权机制见 `menu-protocol.md`;通过 menu exec 取配置 schema 见 `menu-exec-schema-commands.md`。
@@ -17,9 +17,11 @@ ec menu-client request <from-aid> <daemon-aid> \
17
17
 
18
18
  - `--request-file` 与 `--request-json` 二选一,内容是**现有 Menu request**(结构见 `menu-protocol.md §三`);缺少 `id` 时自动生成 UUID。
19
19
  - 请求与响应的 `ttl`、volatile 游标、`to_device_id` 定向回复等传输细节由 CLI 与 daemon 自动处理,调用方无需关心。
20
- - 默认使用 E2EE,并发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`。
20
+ - 请求声明 `message_class=control`,发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`;接收端共用 SDK 标准事件,不按类别分设业务处理器。
21
+ - `--encrypt` / `--no-encrypt` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
21
22
  - 独立终端默认 slot 是 `evolcore-menu-client`;`--app <slot>` 可覆盖,但会切换消费游标,调用方须自行串行化。托管模式使用 daemon 的现有连接和 ACK 路径。
22
23
  - `menu.query` / `menu.options` 等待响应超时时自动重发一次相同 request id;写操作不自动重试。
24
+ - 默认收到 `menu.response` 即返回,作业受理响应中的 `jobId` 不代表作业完成。升级或模板作业可加 `--wait` 等待终态,`--timeout` 分别限制初始响应和受理后的终态等待。终态字段合并到响应 `data`,保留原响应 `id`;作业失败/取消退出码为 1。超时错误保留 `jobId`,可用已有作业查询接口恢复状态,客户端不重新执行 action。
23
25
 
24
26
  ## 鉴权入口
25
27
 
@@ -32,9 +34,9 @@ ec menu-client request <from-aid> <daemon-aid> \
32
34
 
33
35
  ## 托管会话边界
34
36
 
35
- 托管调用必须使用当前 self AID,并拥有 `ec.menu.request` 的 relation 权限。daemon 校验当前 session、委托和角色,按目标 AID 与 request ID 匹配加密响应;普通角色的聊天权限不自动授予远程 Menu 调用能力。
37
+ 托管调用必须使用当前 self AID,并拥有 `ec.menu.request` 的 relation 权限。daemon 校验当前 session、委托和角色,按 SDK 确认的目标 AID 与 request ID 匹配响应;普通角色的聊天权限不自动授予远程 Menu 调用能力。
36
38
 
37
- 托管模式不接受 `--app`、`--aun-path`、`--no-encrypt`,也不创建独立连接或清理 daemon 的消息。`--request-file` 由 daemon 校验后读取,须为当前项目或本会话 `$TMPDIR` 内不受保护的普通文件,最大 128 KiB;也可用 `--request-json`。目标是否允许具体操作,仍由远端 Control Menu 的 Token/Owner 鉴权决定。
39
+ 托管模式不接受 `--app`、`--aun-path`,也不创建独立连接或清理 daemon 的消息;加密选项与独立终端一致。`--request-file` 由 daemon 校验后读取,须为当前项目或本会话 `$TMPDIR` 内不受保护的普通文件,最大 128 KiB;也可用 `--request-json`。目标是否允许具体操作,仍由远端 Control Menu 的 Token/Owner 鉴权决定。
38
40
 
39
41
  ## 配对码与 token 生命周期
40
42
 
@@ -44,7 +46,7 @@ ec menu-client request <from-aid> <daemon-aid> \
44
46
 
45
47
  ## 输出与退出码
46
48
 
47
- - 成功时 stdout 是完整 `menu.response` JSON。远端业务错误仍在响应的 `error` 字段中;本地传输/超时错误退出码非 0。独立终端的 ACK 错误也以非零退出码返回;托管模式由 daemon 的正常消费路径处理 ACK。
49
+ - 成功时 stdout 是完整 `menu.response` JSON。远端业务错误仍在响应的 `error` 字段中,退出码为 1;本地传输/超时错误退出码非 0。SDK 管理消息确认与恢复,收到响应只表示业务结果已交付,不表示网关 ACK 已完成。
48
50
 
49
51
  ## 常用请求示例
50
52
 
@@ -30,19 +30,21 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
30
30
 
31
31
  ## 一、传输层约定
32
32
 
33
- 所有 Menu 请求通过 AUN `message.send` 点对点发送给 daemon 的 Control AID:
33
+ Menu 请求通过 AUN `message.send` 点对点发送给 daemon 的 Control AID 或目标 Agent AID:
34
34
 
35
35
  | 参数 | 值 | 说明 |
36
36
  |------|-----|------|
37
- | `to` | daemon control AID | 目标 daemon 的 AID |
37
+ | `to` | Control AID 或 Agent AID | 按操作所属范围选择目标 |
38
38
  | `message_class` | `control` | Menu 是应用控制协议,使用独立 control 消息流;不使用 SDK 内部的 `sdk_control` |
39
- | `encrypt` | `true` | 必须 E2EE 加密 |
39
+ | `encrypt` | boolean | 遵循 Menu/渠道加密策略;凭据授权及要求 E2EE 的操作仍须加密 |
40
40
  | `ttl` | `60` | 秒,短生命周期 |
41
41
  | `payload` | menu request 对象 | 见下方消息类型 |
42
42
  | `protected_headers` | 见下方 | 身份认证信息 |
43
43
 
44
44
  响应通过 daemon 向请求方 AID 发送 `menu.response` 消息,以 `id` 字段配对。
45
45
 
46
+ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处理。两类应用消息均从 SDK 标准消息事件交付,EvolCore 不按实际投递类别另建回包或消费分支。普通响应与 `menu.event` 沿用 daemon 的 `aun.defaultEncrypt`;特定敏感业务可以显式要求加密。加密与消息类别是独立维度,ec-menu-client 不额外要求所有请求或响应必须 E2EE。Token 申请/使用、远程 token 授权及其它敏感操作继续按各自规则校验。
47
+
46
48
  ---
47
49
 
48
50
  ## 二、protected_headers
@@ -11,12 +11,19 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
11
11
  和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
12
12
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
13
13
 
14
- 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。按目标分三种形态:
14
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。消息分三种概念:
15
+
16
+ | 概念 | 含义 |
17
+ |---|---|
18
+ | 普通消息 | 当前话题的会话对端发来;回复用 `ecmsg send '<text>'` |
19
+ | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
20
+ | 跨话题自派 | 本端从另一个话题把任务派给自己 |
21
+
22
+ 跨话题**发送**有两个动作:
15
23
 
16
24
  | 形态 | 写法 | 目标 |
17
25
  |---|---|---|
18
- | 普通回复 | `ecmsg send '<text>'` | 当前会话的对端/群 |
19
- | 跨话题委派 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
26
+ | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
20
27
  | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 |
21
28
 
22
29
  `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
@@ -34,7 +34,7 @@ ec provider sync [--format json]
34
34
 
35
35
  `ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
36
36
 
37
- 1. 复用初始化界面的本机基座导入机制,扫描 Claude、Codex、Gemini 和 ecagent 的本机连接;只导入具有有效密钥的来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
37
+ 1. 复用初始化界面的本机基座导入机制,只扫描 Claude、Codex、Gemini 的本机连接;只导入具有有效密钥的来源。ecagent 为内置基座,直接使用 EvolCore 内部 Provider 配置,不作为导入来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
38
38
  2. 将可识别域名的 Provider ID 转为稳定八位格式,同步 defaults、Agent 和 relation 配置内的 Provider/fallback 引用;冻结初始化计划及其请求指纹不修改,单独记录运行时 Provider 迁移绑定。在线同步暂留旧 ID aliases,到下次成功启动迁移后自动清除。
39
39
  3. 仅将全局 defaults 的 `active_baseagent` 改为 `ecagent`;不覆盖已有 Agent 的显式基座或模型选择。
40
40
  4. 若注册表存在 `provider-96659517`,从其适用于 ecagent 的实时模型目录选择已启用、已列出的 `deepseek…flash` 模型;多个版本按模型 ID 的数字版本降序选择,例如 `deepseek-v4.1-flash` 优先于 `deepseek-v4-flash`。写入全局 `baseagents.ecagent.provider/model`,不写入拼错的 `deekseek` 或通配符字面量。与新模型不兼容的全局 effort 会清除。
@@ -51,7 +51,11 @@ ec provider sync [--format json]
51
51
 
52
52
  ## 启动迁移收尾
53
53
 
54
- 纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,扫描检测到的基座并自动导入有效的本机 Provider 连接;同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
54
+ 历史连接字段迁入 Provider 时按 JSON 内容判断是否需要修改;仅 CRLF/LF、缩进、字段顺序或末尾换行不同不触发迁移,也不重写已迁好的 defaults、Agent 和注册表。事务恢复时,文件已与迁移前原文一致则跳过替换。必须写入时对 EPERM/EACCES/EBUSY 做有限重试,始终使用文件替换,不降级为截断原文件后写入;持续失败保留错误并走事务恢复。
55
+
56
+ Windows 只读配置在替换前临时解除只读,替换完成或失败后恢复原属性;临时文件始终保持可写,以便失败时清理。迁移日志记录原属性,中断后同时恢复内容和只读状态;旧日志继续兼容。属性恢复或事务回滚再次失败时同时报告原始写入错误和恢复错误,保留日志供后续恢复,不用恢复错误覆盖最初原因。
57
+
58
+ 纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,仅对检测到的 Claude、Codex、Gemini 自动导入有效的本机 Provider 连接;ecagent 直接校验并使用内部 Provider 配置,不搜索或导入外部来源。同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒,保留已知的具体错误码。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
55
59
 
56
60
  `ec init --web` 不执行终端侧 Baseagent 扫描或 Provider 自动导入;这些步骤由网页初始化流程负责。终端仍检查并准备启动所需的主机控制 AID,不停止或重启已运行的 daemon。
57
61
 
@@ -63,14 +67,20 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
63
67
 
64
68
  新快照记录扩展后的文件范围;恢复到尚未收录初始化状态的历史快照时,不因这些文件缺席而删除当前初始化状态。新快照则能够恢复这些文件的内容或原本不存在的状态。
65
69
 
66
- 引用更新与 aliases 清理作为同一事务提交,providers.json 最后写入。配置无法读取、迁移冲突或并发写入时拒绝提交;提交失败回滚,异常中断由下次启动恢复。成功后旧 ID 不再可用;重复启动无变更时不产生新备份。外部脚本应改用固定 ID,历史备份不重写。启动收尾不导入本机连接、不修改默认基座或模型,也不展开环境变量。
70
+ 引用更新与 aliases 清理作为同一事务提交,providers.json 最后写入。迁移先在内存生成完整计划,校验注册表和配置 schema、Provider 与服务引用、迁移前后服务地址与凭据及模型设置的一致性,并确认冻结初始化计划未被改写。提交时对受影响文件加锁并核对原始内容,再次校验最终计划;所有检查通过后才创建快照和事务日志、开始替换配置文件。任一规划或校验失败均不写入配置。同主机不同服务路径且服务类型相同的旧条目不会被强行合并。
71
+
72
+ 启动自动身份迁移的规划或校验失败时,输出具体错误码和原因,跳过本次迁移并继续使用原配置;冲突告警只列 ID、域名和字段,不输出凭据值。迁移锁、实际提交及事务恢复错误不按规划失败吞掉。提交失败仍尝试回滚,异常中断仍在下次启动时尝试恢复,恢复未完成时不继续使用半迁移状态。在线手动 `ec provider sync` 失败仍返回错误,不按启动跳过处理。
67
73
 
68
- 托管 Codex 使用解析后的固定 Provider ID 生成运行时 model_provider。Codex 会拒绝仅靠 thread/resume 参数切换旧 thread 的 Provider;EvolCore 在续聊、任务恢复和压缩前,持有 thread 操作锁,检查 rollout 元数据和 SQLite 索引中的 Provider。与当前配置不一致时,先确认已有运行时已释放,再备份并同步更新两处 Provider,保留原 thread ID、EC 会话绑定及历史字节,随后 resume 并核验返回的 thread ID 和 Provider。不会修改用户原生 Codex config.toml 的 model_provider/model_providers。模型目录查询与推理使用相同的运行时命名规则。
74
+ 迁移成功后旧 ID 不再可用;重复启动无变更时不产生新备份。外部脚本应改用固定 ID,历史备份不重写。启动收尾不导入本机连接、不修改默认基座或模型,也不展开环境变量。
75
+
76
+ 托管 Codex 使用解析后的固定 Provider ID 生成运行时 model_provider。不同 Codex 版本的 thread/resume 行为不同:0.164 可只更新 SQLite 索引而保留旧 rollout 文件头,较新版本会拒绝 Provider 不匹配的续接。EvolCore 在续聊、任务恢复和压缩前,持有 thread 操作锁,检查 rollout 元数据和 SQLite 索引中的 Provider。与当前配置不一致时,先确认已有运行时已释放,再备份并同步更新两处 Provider,保留原 thread ID、EC 会话绑定及历史字节,随后 resume 并核验返回的 thread ID 和 Provider。索引已等于当前 Provider、仅文件头过期时,沿用同一备份和中断恢复机制校准文件头,不重写索引;其他两处不一致的情况仍拒绝,并报告 thread、文件头、索引及目标 Provider。不会修改用户原生 Codex config.toml 的 model_provider/model_providers。模型目录查询与推理使用相同的运行时命名规则。
69
77
 
70
78
  修复的备份和中断恢复记录保存在 rollout 相邻的 `.provider-repair/` 目录(完整目录名为 `<rollout文件名>.provider-repair`)。文件替换与 SQLite 提交之间发生中断时,下次恢复会先核对记录并完成同步;检测到较新的文件或索引、无法释放的运行时、不匹配的身份或不支持的存储格式时停止并报告原因,不覆盖数据或更换 thread。这里只处理 EC 已绑定的会话;模型输入在修复及恢复校验完成后提交。
71
79
 
72
80
  ## 完整对象示例
73
81
 
82
+ 服务类型可选 `modelPolicy: allowlist | denylist | manual`,原 `models` 映射保留:白名单条目默认开启,黑名单条目默认关闭,手动白名单默认开启且无需 `manual:true`、不请求远端目录。白/黑名单的模型键支持 `*`、`?`;精确条目优先,通配冲突禁用优先。通配条目只接受 `enabled` 或空对象,名称和图片属性用精确 ID 配置。未填写策略保持旧配置行为,不自动补写。显式布尔值覆盖模式默认值;`null` 恢复默认。新功能代码需宿主加载后可用。
83
+
74
84
  ~~~json
75
85
  {
76
86
  "name": "Example",
@@ -87,13 +97,15 @@ apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据
87
97
 
88
98
  Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。静态 `baseUrl` 自动推导 domain;若 `baseUrl` 是环境变量引用,必须显式填写 domain,且运行时地址必须匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
89
99
 
100
+ hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一为 URL hostname 使用的压缩、带方括号形式(如 `[::1]`);显式 domain 也接受不带方括号的 IPv6。端口仍属于连接地址,不参与身份计算;同一主机的不同协议或端口不能合并。DNS 身份与已有固定 ID 的生成规则保持不变。
101
+
90
102
  ## 输出与并发
91
103
 
92
104
  文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
93
105
 
94
106
  常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、PROVIDER_CONFLICT(域名已存在)、PROVIDER_ID_COLLISION(八位哈希碰撞)、PROVIDER_DOMAIN_IMMUTABLE(不能修改已有域名)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
95
107
 
96
- 升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
108
+ 升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain 时暂保留旧 ID,并报告待处理;localhost 和 IP 地址按规范化主机名生成固定 ID。不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
97
109
 
98
110
  不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
99
111
 
@@ -126,6 +126,10 @@ ec aid agentmd set <本AID> exttype order
126
126
 
127
127
  装好后:`ec services reload` → `ec services status` 确认 `status=active`。
128
128
 
129
+ > **没有自动热重载**:改完 `pack.json` 或脚本都必须显式 `ec services reload`
130
+ > 才生效(事件中心同样如此,两边一致)。包目录没有 `fs.watch`,
131
+ > 改完不 reload 不会有任何提示,日志里也看不出异常。
132
+
129
133
  ## 六、`requires` 写什么
130
134
 
131
135
  **限制这个包能在什么名片的 AID 上生效。**
@@ -204,9 +208,9 @@ ec services call <aid> <type> --data '<json>' # 发起调用
204
208
  | 项 | 值 |
205
209
  | --- | --- |
206
210
  | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
207
- | 输出上限 | 1 MiB,超出截断 |
208
- | 环境变量 | `EC_SELF_AID` / `EC_PACK_DIR` / `EC_SERVICE_TYPE` / `EC_REQUEST_ID` |
209
- | 密钥清理 | 所有 `*_API_KEY` / `*_TOKEN` 被移除 |
211
+ | 输出上限 | stdout+stderr 合计 1 MiB;**超出即终止进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断 |
212
+ | 环境变量 | `EC_SELF_AID` / `EC_SELF_TYPE` / `EC_SELF_EXTTYPE` / `EC_PACK_DIR` / `EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` / `EC_ENCRYPTED` |
213
+ | 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
210
214
  | 沙箱 | 非 fullaccess 走 trigger 同款沙箱;Windows 上 `runtime` 必须是原生可执行文件 |
211
215
 
212
216
  最后一条容易踩,但**不是「`.mjs` 不能跑」**:要求的是 `runtime` 是可执行文件(`"node"` →
@@ -225,24 +229,153 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
225
229
 
226
230
  ## 九、准入与限流
227
231
 
228
- 服务调用**认联系人配置**,与普通消息一致。陌生人调用会收到:
232
+ 服务调用**认联系人配置**,与普通消息一致。准入判定在包匹配**之前**完成:未准入的
233
+ 调用不会触达包、不会进调度器、不会起脚本沙箱。
234
+
235
+ 陌生人第一次调用会收到一条**与请求内容无关**的拒绝:
229
236
 
230
237
  ```json
231
- { "ok": false, "error": { "code": "NOT_AUTHORIZED" }, "request_contact": "<你的Owner>" }
238
+ { "ok": false, "error": { "code": "NOT_AUTHORIZED", "message": "service call is not authorized" } }
232
239
  ```
233
240
 
241
+ - 不带 `request_contact`、不带包名/type/脚本路径——回包不能变成探测手段;
242
+ - 无论目标 type 是否存在,回包完全一样(否则"有没有回包"就是枚举信道);
243
+ - 同一个来源 **24 小时内只回这一次**,之后一律静默;全局另有 30 次/分、200 次/时
244
+ 的回复上限,换 AID 也放不大。
245
+
234
246
  **不会自动建联系人申请**,对方需自己 `ec directory request` 找你的 Owner。
235
247
 
236
- 内置查询(`ping`/`list`/`describe`/`schema`/`skill`)**免准入**,但受限流。
248
+ 内置查询按「返回体里有没有我方内部结构」分级:
249
+
250
+ | type | 未准入时 |
251
+ | --- | --- |
252
+ | `services.ping` | 正常返回 `{ok, ts, version}`,零信息,任何来源都答 |
253
+ | `services.list` | 降级为空壳:`{"services":[],"builtin":["services.ping"]}` |
254
+ | `services.describe`(不带 service) | 同上,降级为空壳 |
255
+ | `services.describe` / `schema` / `skill`(带 service) | 走统一拒绝,与业务调用一致 |
256
+
257
+ 限流(按来源 AID 独立计):
237
258
 
238
- | 类别 | 额度(按来源 AID 独立计) |
259
+ | 类别 | 额度 |
239
260
  | --- | --- |
240
261
  | 内置查询 | 20 次/分、200 次/时 |
241
262
  | 业务调用 | 50 次/分、1000 次/时 |
242
263
 
243
- 超限回 `RATE_LIMITED`,带 `retry_after` 秒数。
264
+ 超限回 `RATE_LIMITED`,带 `retry_after` 秒数;未准入来源超限时直接静默,不回限流细节。
265
+
266
+ ### 按服务类型细分的准入规则
267
+
268
+ 默认口径(上面那套)是 **agent 级**的:一个来源要么能调全部服务,要么一个都不能。
269
+ 需要放开个别服务时可以按 type 加规则,写在 `services-config.json`:
270
+
271
+ ```json
272
+ {
273
+ "v": 1,
274
+ "enabled": true,
275
+ "rateLimit": { "builtin": {...}, "service": {...} },
276
+ "rules": {
277
+ "services.order.create": {
278
+ "allow": ["buyer.agentid.cn"],
279
+ "deny": ["spam.agentid.cn"]
280
+ },
281
+ "services.order.*": { "allow": [], "deny": ["spam.agentid.cn"] }
282
+ }
283
+ }
284
+ ```
285
+
286
+ 语义与事件中心的 allowlist **完全一致**:
287
+
288
+ | 集合 | 作用 |
289
+ | --- | --- |
290
+ | 联系人快照(基础集合) | 不受 `rules` 影响,照常放行 |
291
+ | `allow` | 在基础集合**之上**额外放行——可以放行联系人之外的人 |
292
+ | `deny` | 命中即拒,**优先于** `allow` 与基础集合 |
293
+
294
+ 几条不变的约束:
295
+
296
+ - **临时授权不算数**。服务调用属长效口径,`temp-grant` 这类分钟级放行不影响调试结果;
297
+ 需要临时开就给 `rules.allow`。
298
+ - 同一个 AID 不能同时写在 `allow` 和 `deny` 里——校验期直接报错。`deny` 会赢,但
299
+ 写的人多半以为 `allow` 会赢。
300
+ - 规则按 type **精确匹配**优先,其次 `.*` 通配(只吃一整段,与 `listen` 同口径)。
301
+ - `deny` 的回包与"未准入"**完全相同**,否则"被拉黑"和"没这个服务"就成了可区分的探测信号。
302
+ - **内置保留字不接受 rules**(`services.ping` / `list` / `describe` / `schema` / `skill`)。
303
+ 它们的准入是固定分级的,写这类键会在校验期直接报错,而不是存下来却不生效。
304
+
305
+ 改规则:
306
+
307
+ ```bash
308
+ ec services rules show # 看全部规则
309
+ ec services rules show services.order.create # 看单个 type
310
+ ec services rules add services.order.create buyer.agentid.cn
311
+ ec services rules add services.order.create spam.agentid.cn --deny
312
+ ec services rules remove services.order.create spam.agentid.cn --deny
313
+ ```
314
+
315
+ ## 十、权限模型
316
+
317
+ `ec services` 的运维命令分**四档操作**,对着**两类目标**(自己的 AID / 本机的其他 AID):
318
+
319
+ | 操作 | 包含的命令 | 自己的 AID | 本机的其他 AID |
320
+ | --- | --- | --- | --- |
321
+ | **查看** | `status` `types` `ledger` `tail` `doctor` `reload` `rules show` `pack list` | member 及以上 | member 及以上 + 同 Owner |
322
+ | **管理** | `pack add` `pack remove` `pack enable` `pack disable` `rules add` `rules remove` | owner / admin | daemonOwner + fullaccess + 同 Owner |
323
+ | **总闸** | `enable` `disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
324
+ | **调用** | `describe` `schema` `call` | 准入决定(本机不判权) | 准入决定(本机不判权) |
325
+
326
+ ### 概念
327
+
328
+ **daemonOwner**:`getDaemonOwners()` 列出的身份。这是"这台机器的主人",与"某个
329
+ agent 的 owner"是两个层级——一台机器上可以挂着不同 Owner 的 agent。
330
+
331
+ **fullaccess**:本次执行通过 `isTrustedFullAccessRuntimeContext`——
332
+ `permissionMode === 'fullaccess'`、`processRole === 'fullaccess-run'`、
333
+ `dataScope === 'daemon'`、`authorizedBy` 非空,四条同时成立。由 daemon 按校验过的
334
+ `TaskRuntimeContext` 计算,**不能**由命令行参数或请求体自报。
335
+
336
+ **总闸的"两件不同的事"**:`services-config.json` 的 `enabled` 是 **AID 级总闸**
337
+ (这个 AID 是否对外提供全部服务);`pack.json` 的 `enabled` 是**单包开关**。前者
338
+ 要 daemonOwner + fullaccess,后者 owner / admin 即可。
339
+
340
+ ### 为什么这样分层
341
+
342
+ - **查看**不改变执行面。跨 AID 要求同 Owner,是因为台账与消息日志含真实调用记录,
343
+ 不该跨租户暴露。
344
+ - **管理**分两档:给自己装包是"自己装给自己",owner / admin 足够;给别人装包是
345
+ "用对方的身份执行以后会跑起来的代码",只有 daemonOwner + fullaccess 且双方同
346
+ Owner 才存在这种正当性。
347
+ - **总闸**是整机决策:开了这个 AID 就对外接活了,所以独立成一档。
348
+ - **调用**不判本机权限:发出去的消息由对端准入决定,本机这边无权干涉。
349
+
350
+ ### `pack add` 不自动开总闸
351
+
352
+ 装包时若不存在 `services-config.json`,会建一份 **`enabled: false`** 的。装包
353
+ (owner / admin)和开服务(daemonOwner + fullaccess)是两件事;自动开机等于让
354
+ 装包顺带绕过总闸那道闸。
355
+
356
+ 装完之后要显式开:
357
+
358
+ ```bash
359
+ ec services enable
360
+ ```
361
+
362
+ ### 主机终端
363
+
364
+ 持有 `control.token` 的终端(`local-control`)四档全部放行——人自己在操作,
365
+ OS 账户权限就是信任边界。托管会话则按上表判定。
366
+
367
+ ### 错误码
368
+
369
+ | 码 | 含义 |
370
+ | --- | --- |
371
+ | `NOT_ALLOWED` | 托管会话没有会话身份(缺 sessionId / delegationToken) |
372
+ | `ROLE_ACCESS_DENIED` | 同 AID 管理需要 owner 或 admin,当前角色不够 |
373
+ | `FULLACCESS_REQUIRED` | 该操作要求 fullaccess 执行,当前不是 |
374
+ | `DAEMON_OWNER_REQUIRED` | fullaccess 的授权者不在本机 daemonOwner 列表里 |
375
+ | `OWNERSHIP_UNAVAILABLE` | 查不到协议 owner 归属(数据尚未同步或归属不存在) |
376
+ | `CROSS_AGENT_DENIED` | 双方或本机 daemon 不属于同一个 Owner |
244
377
 
245
- ## 十、保留字
378
+ ## 十一、保留字
246
379
 
247
380
  保留字**只占两段形式** `services.<保留字>`:
248
381
 
@@ -255,7 +388,7 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
255
388
  `exttype` 可以设成这些名字,但 `services.<该名字>` 会被内置抢走,其余照常。
256
389
  `ec services doctor` 会告警这种部分遮蔽。
257
390
 
258
- ## 十一、排查
391
+ ## 十二、排查
259
392
 
260
393
  ```
261
394
  ec services status # 包状态:active / skipped / invalid
@@ -273,7 +406,7 @@ ec services tail <包名>
273
406
  | 收不到回复 | `reply.allowed` 是不是 `false`(默认就是) |
274
407
  | `RATE_LIMITED` | 超限,看 `retry_after` |
275
408
 
276
- ## 十二、不要做的事
409
+ ## 十三、不要做的事
277
410
 
278
411
  1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 去重 24 小时,
279
412
  超出窗口的重试会重新执行。
@@ -285,7 +418,7 @@ ec services tail <包名>
285
418
  5. **不要在一个包里给同一个 `type` 写两条 `listen`**。
286
419
  6. **不要在两个包里写同一个 `type`**。两个包都会 invalid。
287
420
 
288
- ## 十三、相关文档
421
+ ## 十四、相关文档
289
422
 
290
423
  | 文档 | 用途 |
291
424
  | --- | --- |
@@ -2,7 +2,7 @@
2
2
 
3
3
  话题(Thread)是在私聊或群聊关系里切出的独立对话分支。一组对话可以同时推进多个话题,每个话题有自己的上下文、历史和生命周期,互不干扰。话题链(Thread Chain)则是跨会话、跨 agent 的协作机制:A 可以把一条任务"分支"到 B 的某个话题,B 也可以在自己的话题里继续工作,两者通过 `ecmsg send --thread` 和 thread-inbox 上下文注入关联起来。
4
4
 
5
- 触发词:话题/thread/跨话题/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨话题上下文/跨话题复查。
5
+ 触发词:话题/thread/跨话题/委托/ec thread/话题链/summary/删除话题/thread-inbox/跨话题委托/跨话题复查。
6
6
 
7
7
  ## 标准工作流
8
8
 
@@ -135,11 +135,19 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
135
135
 
136
136
  ## 跨话题发送(话题链核心)
137
137
 
138
- 跨话题发送分两种:
138
+ 消息分三种概念:
139
+
140
+ | 概念 | 定义 |
141
+ |---|---|
142
+ | 普通消息 | 当前话题的会话对端发来 |
143
+ | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
144
+ | 跨话题自派 | 本端从另一个话题把任务派给自己 |
145
+
146
+ 跨话题**发送**有两个动作:
139
147
 
140
148
  | 形态 | 写法 | 目标 | 用途 |
141
149
  |---|---|---|---|
142
- | 跨话题委派 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
150
+ | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
143
151
  | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
144
152
 
145
153
  不带 `--thread` 的 `ecmsg send '<text>'` 是普通回复,只发当前会话对端/群。
@@ -147,7 +155,7 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
147
155
  跨话题自派的派活通知按话题对端类型送达:对端是人类时发普通 text,对端是 agent 时发 notice(`subtype=self_dispatch`),避免被当成一条要执行的聊天消息。
148
156
 
149
157
  ```bash
150
- # 跨话题委派(本端/对端由话题推断)
158
+ # 跨话题委托(本端/对端由话题推断)
151
159
  ecmsg send '<消息内容>' --thread <threadId>
152
160
 
153
161
  # 自定义复查周期(缺省 20m)
@@ -169,7 +177,7 @@ ecmsg send '<消息内容>' --thread <threadId> --to <本端AID>
169
177
  主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题)
170
178
  - **跨话题自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`)
171
179
  - 跨话题发送成功后,系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时,
172
- 这条记录会以「‹跨话题上下文 · 来源话题:xxx›」的形式注入一次,然后删除
180
+ 这条记录会以「‹提醒:跨话题委托 · 话题:xxx …›」的形式注入一次,然后删除
173
181
  - `--check-every` 会创建**跨话题复查**(名称 `check-<目标>-from-<来源>-<唯一后缀>`,
174
182
  `kind=cross-thread-review`,执行类型 `target_session`)。到期时**不新建会话**,
175
183
  而是向**目标话题**投递一条【跨话题复查】通知,由目标话题侧的 agent 在它自己的上下文里
@@ -194,10 +202,10 @@ ecmsg send '请处理项目A的数据清洗' --thread thread-T2-xxxx --check-eve
194
202
 
195
203
  **A 收到 B 的回复时感知来源上下文:**
196
204
 
197
- inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(通常是 B 回复),prompt 开头会注入一条跨话题上下文,格式如下:
205
+ inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(通常是 B 回复),prompt 开头会注入一条跨话题委托提醒,格式如下:
198
206
 
199
207
  ```
200
- ‹【跨话题上下文】来源话题:thread-T1-xxxx · 对端:alice.agentid.cn · 发送于:2026-10-10 10:00:00 +08:00 · 复查:trig_1791765199642_5371c8ff → self:bob.agentid.cn›
208
+ ‹提醒:跨话题委托 · 话题:thread-T1-xxxx(对端:alice.agentid.cn) · 发送于:2026-10-10 10:00:00 +08:00 · 原消息:m-… · 来源会话:meta_… · 复查:trig_1791765199642_5371c8ff · self:bob.agentid.cn›
201
209
  ⚠️ 来源话题在发送后已有 3 条新消息(2026-10-10 10:01:00 +08:00 - 2026-10-10 10:15:00 +08:00)—— 处理前建议先回查该话题的空洞期消息。
202
210
  【原消息内容】
203
211
  ```
@@ -206,7 +214,7 @@ inbox 记录在发送方 A 本端。A 的目标话题 T2 下次被唤醒时(
206
214
 
207
215
  注入只发生一次。之后 A 靠自身上下文记住"我从哪个话题跨过来的",可随时用
208
216
  `ec thread history <来源话题 id>` 回查空洞期消息(主话题的 id 是 `main:<a>:<b>`,
209
- 通知里的「来源话题 ID」字段可直接使用)。
217
+ 通知里的 `话题:` 字段可直接使用)。
210
218
 
211
219
  **复查通知到达时(目标话题内):**
212
220
 
@@ -289,7 +297,7 @@ CAS 说明:`--if-rev <n>` 指定当前已知的版本号;若实际版本不
289
297
  data/threads/
290
298
  ├── index.json 话题索引
291
299
  ├── summaries/ 话题摘要(<sessionId>.summary.jsonl)
292
- └── inbox/ 跨话题上下文收件箱
300
+ └── inbox/ 跨话题委托收件箱
293
301
  ```
294
302
 
295
303
  ```bash
@@ -183,7 +183,7 @@ join('\n\n') → { body: string, images: ImageData[] }
183
183
  ```
184
184
 
185
185
  对于 `kind: "handoff"` 的消息,普通 private/group section 仍会命中并渲染标准消息信封;
186
- `item.md` 通过 `{{?isHandoff!=true}}` 只在普通消息上输出正文,避免 handoff 当前回复重复。
186
+ `item-private.md` / `item-group.md` 通过 `{{?isHandoff!=true}}` 只在普通消息上输出正文,避免 handoff 当前回复重复。
187
187
  随后按 handoff 类型追加专用上下文 fragment(request、return=none 或 response-to-origin)。
188
188
  因此 handoff 消息与其它私聊、coding、群聊消息共享时间、发送者、角色、群、加密和 @ 等元数据格式,
189
189
  只在其后增加一次性跨会话上下文。
@@ -214,7 +214,7 @@ wrapper 的 {{@loop}} 处字面量填入 renderedParts.join(separator)
214
214
  ```json
215
215
  {
216
216
  "id": "msg-item",
217
- "file": "$KITS_MESSAGE_FRAGMENTS/item.md",
217
+ "file": "$KITS_MESSAGE_FRAGMENTS/item-private.md",
218
218
  "when": "always",
219
219
  "needsInjection": true
220
220
  }
@@ -241,7 +241,7 @@ wrapper 的 {{@loop}} 处字面量填入 renderedParts.join(separator)
241
241
  |------|------|
242
242
  | 静态(进程级) | `PACKAGE_ROOT` `KITS*` `evolcoreMode` `osInfo` `baseAgent` |
243
243
  | 会话稳定 | `selfAid` `sessionId` `sessionKey` `chatType` `channel` `timezone` `tzOffset` `capabilities` `CURRENT_PROJECT` |
244
- | 慢变(配置驱动) | `effectiveModel` `permissionMode` `peerRole` `readonly` `chatMode` `modelFallback*` |
244
+ | 慢变(配置驱动) | `effectiveModel` `permissionMode` `speakerRelation` `readonly` `chatMode` `modelFallback*` |
245
245
  | 新增(日期级) | `localDate`(YYYY-MM-DD)`weekday`(星期四),一天才变一次,缓存暖 ~24h |
246
246
 
247
247
  ### 进消息渲染层(每条独立,进 transcript 永久保真)
@@ -282,7 +282,7 @@ wrapper 的 {{@loop}} 处字面量填入 renderedParts.join(separator)
282
282
  | `kits/eck_manifest.json` | 系统提示词 manifest |
283
283
  | `kits/eck_message_manifest.json` | 消息渲染 manifest |
284
284
  | `kits/templates/system-fragments/session.md` | 含 localDate/weekday |
285
- | `kits/templates/message-fragments/item.md` | 消息渲染紧凑模板 |
285
+ | `kits/templates/message-fragments/item-private.md` / `item-group.md` / `group-batch-item.md` | 消息渲染模板(私聊 / 群聊单条 / 群聊批次逐行) |
286
286
  | `$EVOLCORE_HOME/eck/eck_manifest.json` | 系统提示词 manifest 用户覆盖(可选) |
287
287
  | `$EVOLCORE_HOME/eck/eck_message_manifest.json` | 消息渲染 manifest 用户覆盖(可选) |
288
288
  | `$EVOLCORE_HOME/data/eck-debug/` | 调试输出目录(保留 24h) |
@@ -162,7 +162,7 @@
162
162
  {
163
163
  "id": "msg-private-default",
164
164
  "type": "file",
165
- "file": "$KITS_MESSAGE_FRAGMENTS/item.md",
165
+ "file": "$KITS_MESSAGE_FRAGMENTS/item-private.md",
166
166
  "order": 10,
167
167
  "needsInjection": true,
168
168
  "modeType": "private",
@@ -197,7 +197,7 @@
197
197
  {
198
198
  "id": "msg-group-default",
199
199
  "type": "file",
200
- "file": "$KITS_MESSAGE_FRAGMENTS/item.md",
200
+ "file": "$KITS_MESSAGE_FRAGMENTS/item-group.md",
201
201
  "order": 10,
202
202
  "needsInjection": true,
203
203
  "modeType": "group",
@@ -221,13 +221,56 @@
221
221
  "var": "chatType",
222
222
  "eq": "group"
223
223
  },
224
+ {
225
+ "var": "batchItem",
226
+ "neq": true
227
+ },
228
+ {
229
+ "var": "renderMode_group",
230
+ "eq": "default"
231
+ }
232
+ ]
233
+ },
234
+ "description": "群聊单条消息渲染(完整信封;批次段内单条走这里)"
235
+ },
236
+ {
237
+ "id": "msg-group-batch-item",
238
+ "type": "file",
239
+ "file": "$KITS_MESSAGE_FRAGMENTS/group-batch-item.md",
240
+ "order": 11,
241
+ "needsInjection": true,
242
+ "modeType": "group",
243
+ "modeName": "default",
244
+ "isDefault": true,
245
+ "when": {
246
+ "and": [
247
+ {
248
+ "var": "isOwnerHint",
249
+ "neq": true
250
+ },
251
+ {
252
+ "var": "isThreadContext",
253
+ "neq": true
254
+ },
255
+ {
256
+ "var": "isTriggerMsg",
257
+ "neq": true
258
+ },
259
+ {
260
+ "var": "chatType",
261
+ "eq": "group"
262
+ },
263
+ {
264
+ "var": "batchItem",
265
+ "eq": true
266
+ },
224
267
  {
225
268
  "var": "renderMode_group",
226
269
  "eq": "default"
227
270
  }
228
271
  ]
229
272
  },
230
- "description": "群聊消息渲染(default 模式)"
273
+ "description": "群聊批次逐行渲染(批次头由 group-batch.md 在代码侧拼接)"
231
274
  }
232
275
  ]
233
276
  }
@@ -10,8 +10,16 @@
10
10
 
11
11
  > 为什么用 `peerId` 而非直接用 AID:非 AUN 渠道的对端(飞书群、微信)没有 AID,用 `<channel>#<peerId>` 才能统一覆盖所有渠道的对端。
12
12
 
13
- relation fragment 注入的全部变量:`peerKey`、`peerId`、`peerName`、`peerRole`、`peerType`,
14
- 群聊另有 `groupId`、`groupRulesStatus`、`groupRulesError`。`groupRulesStatus=ignored` 表示本轮由
13
+ relation fragment 注入的全部变量:`peerKey`、`peerId`、`peerName`、`与发言人`、`我的群角色`、`peerType`,
14
+ 群聊另有 `groupId`、`groupRulesStatus`、`groupRulesError`。
15
+
16
+ 群聊里有三个角色,互不替代:
17
+
18
+ - **我的群角色**:我在本群的成员角色(系统段 `我的群角色`);
19
+ - **发言人的群角色**:发言人在本群的成员角色(消息信封 `群角色:`);
20
+ - **发言人与我的关系**:发言人与我的关系角色(系统段与消息信封 `与发言人:`)。
21
+
22
+ 群角色从群成员表取,与发言人从关系记录取。不在联系人里一律 `visitor`,不回落 `member`。`groupRulesStatus=ignored` 表示本轮由
15
23
  本地 `groupRules.mode=ignore` 主动跳过,不是远端缺失、无权限或同步失败。
16
24
 
17
25
  ## 数据位置
@@ -24,7 +24,8 @@
24
24
  - interactive:直接输出即回复
25
25
  - proactive:用 `ecmsg send` 正式回复,见 `[reply]` 段
26
26
  - **发消息只有 `ecmsg` 一个入口**:文字、文件、图片、语音、链接、@某人、加密、联系第三方,全部用 `ecmsg send`。本端恒为当前会话本端,无需指定
27
- - **跨话题发送分两种**:`--thread <话题id>` 是**跨话题委派**,目标是该话题的对端;`--thread <话题id> --to <本端AID>` 是**跨话题自派**,目标是该话题下的本端自己,用于「对端是人、不会自己推进」的分叉场景
27
+ - **消息分三种**:**普通消息**(当前话题的会话对端发来)、**跨话题自派**(本端从另一个话题派给自己)、**跨话题委托**(本端从另一个话题委托给该话题的对端,对方回复后回流)
28
+ - **跨话题发送有两个动作**:`--thread <话题id>` 是**跨话题委托**,目标是该话题的对端;`--thread <话题id> --to <本端AID>` 是**跨话题自派**,目标是该话题下的本端自己,用于「对端是人、不会自己推进」的分叉场景
28
29
 
29
30
  ### 命令返回值
30
31
 
@@ -55,6 +55,7 @@
55
55
  "properties": {
56
56
  "path": { "type": "string" },
57
57
  "style": { "type": "string", "minLength": 1 },
58
+ "modelPolicy": { "type": "string", "enum": ["allowlist", "denylist", "manual"] },
58
59
  "models": {
59
60
  "type": "object",
60
61
  "propertyNames": { "not": { "enum": ["__proto__", "prototype", "constructor"] }, "pattern": "\\S" },
@@ -147,6 +147,10 @@ ec group history <selfAid> <groupId> --limit 50 --format json
147
147
  自己在群里的角色也从 members 里查自己的 AID 得到。`members` 里只有 `last_ack_*` 能反映活跃度,
148
148
  `last_pull_at` 恒为 0、`member_type` 恒为 `human`,两个都不能当判据。
149
149
 
150
+ 消息信封里的 `群角色:` 是发言人本人在群里的角色;`与发言人:` 是发言人与我的关系角色。
151
+ 两者来源不同、互不替代——要判断"我能不能做某件群操作"看 `我的群角色`(系统段),
152
+ 要判断"谁在跟我说话"看信封里的 `与发言人:`。
153
+
150
154
  **群文件**:统一走 `ec fs`,没有 `ec group fs`。
151
155
 
152
156
  ```bash
@@ -107,7 +107,7 @@ async function main() {
107
107
  case 'load': {
108
108
  const withFrontmatter = Boolean(flags['with-frontmatter']);
109
109
  const source = flags.source || null;
110
- emit(S.cmdLoad(positional[0], { source, withFrontmatter, json: asJson }));
110
+ emit(await S.cmdLoad(positional[0], { source, withFrontmatter, json: asJson }));
111
111
  return 0;
112
112
  }
113
113