evolcore 0.0.49 → 0.0.50

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 (250) hide show
  1. package/CHANGELOG.md +64 -1
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +280 -6
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +4 -1
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +29 -1
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +537 -189
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/ecmsg-gateway.js +11 -9
  54. package/dist/cli/index.js +23 -4
  55. package/dist/cli/init.js +39 -63
  56. package/dist/cli/managed-command-guard.js +1 -0
  57. package/dist/cli/menu-client.js +32 -7
  58. package/dist/cli/pay-command.js +30 -0
  59. package/dist/cli/provider-command.js +6 -2
  60. package/dist/cli/restart-monitor.js +2 -2
  61. package/dist/cli/services-command.js +11 -9
  62. package/dist/cli/thread-command.js +78 -12
  63. package/dist/config/access-policy.js +16 -3
  64. package/dist/config/config-field-policy.js +17 -8
  65. package/dist/config/config-manager.js +86 -46
  66. package/dist/config/config-operation-service.js +22 -1
  67. package/dist/config/gateway-config.js +9 -8
  68. package/dist/config/owner-config.js +0 -16
  69. package/dist/config/peer-role-resolver.js +1 -7
  70. package/dist/config/providers-config.js +99 -16
  71. package/dist/config/providers-management.js +35 -19
  72. package/dist/config/resolved-config-op.js +1 -42
  73. package/dist/config/schema-migration.js +78 -5
  74. package/dist/config/schema-registry.js +52 -7
  75. package/dist/config-store.js +1309 -17
  76. package/dist/core/agent-application-service.js +220 -1
  77. package/dist/core/agent-ipc-registration.js +19 -2
  78. package/dist/core/agent-reload-coordinator.js +5 -0
  79. package/dist/core/agent-runtime.js +198 -54
  80. package/dist/core/auth/agent-delegation.js +14 -0
  81. package/dist/core/auth/operation-authorizer.js +16 -1
  82. package/dist/core/auth/operation-catalog.js +50 -7
  83. package/dist/core/baseagent-loader.js +30 -3
  84. package/dist/core/capability/capability-manager.js +16 -7
  85. package/dist/core/channel-runtime.js +4 -2
  86. package/dist/core/command/agent-control.js +20 -2
  87. package/dist/core/command/agent-template-menu.js +4 -3
  88. package/dist/core/command/cli-intent-parser.js +15 -0
  89. package/dist/core/command/menu-catalog.js +20 -4
  90. package/dist/core/command/menu-file-path.js +70 -0
  91. package/dist/core/command/menu-handler.js +91 -72
  92. package/dist/core/command/menu-protocol.js +5 -0
  93. package/dist/core/command/menu-query-batch.js +2 -2
  94. package/dist/core/command/private-mention-menu.js +71 -0
  95. package/dist/core/command/slash-handler.js +17 -26
  96. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  97. package/dist/core/command/topic-slash.js +7 -1
  98. package/dist/core/daemon-bootstrap.js +0 -4
  99. package/dist/core/daemon-control.js +2 -1
  100. package/dist/core/daemon-lifecycle.js +13 -5
  101. package/dist/core/evolagent-registry.js +12 -7
  102. package/dist/core/handoff/runtime.js +1 -1
  103. package/dist/core/host-snapshot.js +8 -3
  104. package/dist/core/initialization/service.js +3 -0
  105. package/dist/core/interaction-router.js +130 -0
  106. package/dist/core/ipc-registration.js +4 -0
  107. package/dist/core/memory/consolidation-context.js +2 -1
  108. package/dist/core/memory/consolidation.js +35 -64
  109. package/dist/core/message/aun-ipc-sender.js +98 -21
  110. package/dist/core/message/aun-request-registry.js +31 -0
  111. package/dist/core/message/message-bridge.js +105 -6
  112. package/dist/core/message/message-log.js +8 -0
  113. package/dist/core/message/message-queue.js +5 -3
  114. package/dist/core/message/peer-mode.js +15 -4
  115. package/dist/core/message/response-engine.js +23 -8
  116. package/dist/core/message/send-options.js +37 -3
  117. package/dist/core/message/send-routing.js +11 -7
  118. package/dist/core/model/model-catalog.js +5 -5
  119. package/dist/core/ownership/owner-resolver.js +12 -86
  120. package/dist/core/pack-auth.js +4 -0
  121. package/dist/core/permission/ec-command-parser.js +182 -58
  122. package/dist/core/permission/protected-paths.js +64 -9
  123. package/dist/core/permission/services-path-acl.js +9 -2
  124. package/dist/core/permission/tool-policy.js +21 -9
  125. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  126. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  127. package/dist/core/session/session-manager.js +47 -10
  128. package/dist/core/session/session-mapper.js +16 -0
  129. package/dist/core/skill/index-generator.js +2 -3
  130. package/dist/core/skill/switch-resolver.js +3 -0
  131. package/dist/core/thread/command-parser.js +4 -1
  132. package/dist/core/thread/ipc-operation.js +4 -2
  133. package/dist/core/thread/thread-operation.js +25 -10
  134. package/dist/core/thread/thread-service.js +294 -55
  135. package/dist/core/thread/topic-id.js +52 -2
  136. package/dist/core/thread/types.js +15 -1
  137. package/dist/eck/kit-renderer.js +2 -1
  138. package/dist/ecweb/basic-settings-service.js +5 -9
  139. package/dist/ecweb/providers-service.js +4 -2
  140. package/dist/index.js +116 -41
  141. package/dist/ipc.js +58 -2
  142. package/dist/paths.js +48 -1
  143. package/dist/pay/command.js +38 -0
  144. package/dist/pay/protocol.js +136 -0
  145. package/dist/pay/runtime.js +188 -0
  146. package/dist/pay/service.js +384 -0
  147. package/dist/pay/store.js +81 -0
  148. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  149. package/dist/services/dispatcher.js +23 -5
  150. package/dist/services/host/main.js +388 -0
  151. package/dist/services/host/protocol.js +118 -0
  152. package/dist/services/host/resident.js +310 -0
  153. package/dist/services/host-client.js +386 -0
  154. package/dist/services/host-deploy.js +180 -0
  155. package/dist/services/host-launch.js +117 -0
  156. package/dist/services/host-recycle.js +203 -0
  157. package/dist/services/host-runtime.js +802 -0
  158. package/dist/services/idempotency.js +44 -86
  159. package/dist/services/index-generator.js +4 -3
  160. package/dist/services/index.js +176 -18
  161. package/dist/services/ipc-operation.js +204 -44
  162. package/dist/services/script-runner.js +515 -83
  163. package/dist/services/validation.js +109 -4
  164. package/dist/trigger/application-service.js +6 -4
  165. package/dist/trigger/local-files.js +19 -9
  166. package/dist/trigger/scheduler.js +22 -12
  167. package/dist/trigger/script-sandbox.js +51 -20
  168. package/dist/utils/aid-bind.js +3 -0
  169. package/dist/utils/evolcore-version.js +2 -2
  170. package/dist/utils/host-info.js +73 -0
  171. package/dist/utils/logger.js +2 -2
  172. package/dist/utils/media-cache.js +190 -43
  173. package/dist/utils/restart-safety.js +14 -1
  174. package/dist/utils/system-memory.js +113 -25
  175. package/dist/utils/systemd-lifecycle.js +154 -0
  176. package/dist/utils/windows-shell-trust.js +7 -3
  177. package/kits/docs/INDEX.md +3 -2
  178. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  179. package/kits/docs/channels/aun.md +1 -1
  180. package/kits/docs/evolcore/INDEX.md +7 -6
  181. package/kits/docs/evolcore/agent.md +36 -1
  182. package/kits/docs/evolcore/aid.md +20 -3
  183. package/kits/docs/evolcore/config.md +1 -1
  184. package/kits/docs/evolcore/group.md +2 -1
  185. package/kits/docs/evolcore/memory-tags.md +2 -0
  186. package/kits/docs/evolcore/menu-client.md +3 -3
  187. package/kits/docs/evolcore/menu-protocol.md +7 -0
  188. package/kits/docs/evolcore/model.md +3 -0
  189. package/kits/docs/evolcore/msg.md +68 -10
  190. package/kits/docs/evolcore/pay.md +34 -0
  191. package/kits/docs/evolcore/provider.md +21 -0
  192. package/kits/docs/evolcore/services.md +46 -18
  193. package/kits/docs/evolcore/thread-chain.md +2 -0
  194. package/kits/docs/evolcore/tool-authorization.md +10 -0
  195. package/kits/rules/01-overview.md +11 -32
  196. package/kits/rules/02-navigation.md +7 -0
  197. package/kits/rules/06-channel.md +3 -3
  198. package/kits/schemas/_meta.json +38 -5
  199. package/kits/schemas/agent-config.schema.21.json +974 -0
  200. package/kits/schemas/agent-config.schema.22.json +977 -0
  201. package/kits/schemas/agent-config.schema.23.json +958 -0
  202. package/kits/schemas/daemon.schema.10.json +373 -0
  203. package/kits/schemas/daemon.schema.9.json +12 -0
  204. package/kits/schemas/defaults.schema.7.json +472 -0
  205. package/kits/schemas/providers.schema.3.json +18 -2
  206. package/kits/schemas/relation-config.schema.13.json +289 -0
  207. package/kits/skills/.switches.json +13 -1
  208. package/kits/skills/ability/SKILL.md +229 -34
  209. package/kits/skills/ability/STRUCTURE.md +333 -0
  210. package/kits/skills/ability/references/cli.md +208 -0
  211. package/kits/skills/ability/references/development.md +107 -37
  212. package/kits/skills/ability/references/management.md +106 -46
  213. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  214. package/kits/skills/agent-output-cards/SKILL.md +12 -5
  215. package/kits/skills/ec-group/SKILL.md +8 -6
  216. package/kits/skills/ec-group/TASK.md +186 -0
  217. package/kits/skills/ec-group/WORKLOG.md +180 -0
  218. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  219. package/kits/skills/ec-pay/SKILL.md +101 -0
  220. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  221. package/kits/skills/ec-provider/SKILL.md +1 -1
  222. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  223. package/kits/skills/ec-service-call/SKILL.md +135 -0
  224. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  225. package/kits/skills/ec-trigger/SKILL.md +1 -1
  226. package/kits/templates/memory-consolidation/notes.md +2 -2
  227. package/kits/templates/memory-consolidation/workflow.md +46 -0
  228. package/kits/templates/system-fragments/channel.md +13 -4
  229. package/kits/templates/system-fragments/commands.md +4 -3
  230. package/kits/templates/system-fragments/reply.md +1 -0
  231. package/kits/templates/system-fragments/session.md +1 -1
  232. package/kits/templates/system-fragments/thread.md +27 -129
  233. package/kits/templates/system-fragments/venue.md +16 -0
  234. package/package.json +4 -5
  235. package/scripts/agent-template/inspect.mjs +37 -23
  236. package/scripts/agent-template/overlay.mjs +20 -2
  237. package/scripts/agent-template/shared/common.mjs +16 -4
  238. package/scripts/agent-template/shared/team-schema.json +20 -4
  239. package/scripts/agent-template/shared/template-contract.mjs +53 -13
  240. package/scripts/agent-template/shared/template-package.mjs +90 -26
  241. package/scripts/agent-template/shared/template-runtime.mjs +111 -1
  242. package/scripts/agent-template/shared/template.mjs +65 -7
  243. package/scripts/agent-template/team-pack.mjs +89 -33
  244. package/scripts/agent-template/team-preview.mjs +249 -5
  245. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  246. package/kits/docs/evolcore/ability.md +0 -185
  247. package/kits/skills/ability/references/calling.md +0 -56
  248. package/kits/skills/ability/references/contract-checklist.md +0 -37
  249. package/kits/skills/ability/references/recovery.md +0 -27
  250. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -18,9 +18,9 @@
18
18
  | 速查表 | `aun/CHEATSHEET.md` | AUN 协议命名空间与常用操作速查 |
19
19
  | SDK 文档指引 | `aun/SDK.md` | AUN SDK 文档位置(`$AUN_SDK_DOCS`)、结构与常用入口;四语言版本共用同一份协议文档 |
20
20
  | 同步协议 | `aun/SYNC_PROTOCOL.md` | 上游协议同步 SOP |
21
- | Ability 调用 | `aun/ABILITY_CALLING.md` | AID 能力发现、payload、设备状态收集和请求关联的协议参考;实际流程用 `ability` 技能 |
21
+ | Ability 调用 | 内置 `ability` 技能 | AID 能力发现、payload、设备状态收集和请求关联;协议与调用流程都在该技能的 `SKILL.md` |
22
22
 
23
- AUN Ability 规范与按任务选择提供、发现、管理和调用流程,统一从 `ability` 技能进入(`ec skill load ability`)。EvolCore 能力插件的现行命令语法见 `evolcore/ability.md`;源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md` 提供实施设计与交付状态,不代替随包命令手册。
23
+ AUN Ability 规范与按任务选择提供、发现、管理和调用流程,统一从 `ability` 技能进入(`ec skill load ability`)。命令行语法、协议与各阶段流程全部收在该技能内;源码仓库 `$PACKAGE_ROOT/docs/ability/plugin-system/README.md` 提供实施设计与交付状态,不代替技能内说明。
24
24
 
25
25
  ## EvolCore 命令
26
26
 
@@ -30,6 +30,7 @@ AUN Ability 规范与按任务选择提供、发现、管理和调用流程,
30
30
  | 文档 | 路径 | 说明 |
31
31
  |------|------|------|
32
32
  | 命令集目录 | `evolcore/INDEX.md` | msg/group/agent/aid/storage/ctl/rpc/bench 全集索引 |
33
+ | 网站订单付款 | `evolcore/pay.md` | ec pay、扫码付款卡片、订单核验与原任务恢复;流程使用 ec-pay 技能 |
33
34
  | Provider 注册表 | `evolcore/provider.md` | 宿主进程级 Provider CRUD、JSON 导入及 CLI/Menu 边界 |
34
35
  | 对端命令 | `evolcore/peer.md` | 对端身份表、拉黑与托管会话权限边界 |
35
36
  | Owner 名录命令 | `evolcore/directory.md` | 名录查询、强制刷新、拉黑总览与本地备注(仅 PA 可写) |
@@ -63,6 +63,7 @@
63
63
  | `voice`、`image`、`video`、`file` | 语音、图片、视频和文件引用 |
64
64
  | `location`、`link` | 位置、链接卡片 |
65
65
  | `action_card`、`action_card_reply` | 交互卡片及回复 |
66
+ | `widget_card`、`widget_card_reply` | HTML 附件交互卡片及 JSON 回复;Core 工作区实现,需 EvolApp 接入内置浏览器消息桥,不能据此认定客户端或线上已支持 |
66
67
  | `merge`、`personal_card` | 合并转发、个人或 Agent 名片 |
67
68
  | `status`、`event` | 应用状态、业务事件;这里的 `event` 是消息内容,不等同于在线 notify 或服务端协议事件 |
68
69
  | `json`、`custom` | 结构化数据或应用自定义内容;投票可使用 `json` 加 `kind=poll` |
@@ -57,7 +57,7 @@ AUN keystore seed 由 EvolCore 使用固定应用值管理,不再提供配置
57
57
  - **身份与信任**:每条入站消息携带发送者 AID,经四级 X.509 证书链(Root CA → Registry CA → Issuer CA → Agent)验签。
58
58
  - **agent.md 缓存**:对端名片 `https://<aid>/agent.md` 由 **AUN SDK 自动拉取并缓存**(`AgentMdManager`,带 ETag/TTL,默认 1 天内不重复探测)。缓存落在 **`$EVOLCORE_HOME/AIDs/<aid>/`**,每个 AID 两个文件:`agent.md`(带签名正文)+ `agentmd.json`(元数据:etag/last_modified/checked_at/verify_status)。本端与对端的 agent.md 都缓存于此。
59
59
  - 关系层另存一份**派生**的精简身份 `relations/<peerKey>/peer-identity.json`(type/isAgent/name),由 evolcore 从 agent.md 提取,不是 agent.md 本体。
60
- - **E2EE 加密**:可选端到端加密,回复默认跟随对端消息加密状态(密文回密文,明文回明文);主动发起默认明文,只有显式 `--encrypt` 或 `aun.defaultEncrypt: true` 才加密;keystore seed 由 EvolCore 固定管理。
60
+ - **E2EE 加密**:可选端到端加密,回复默认跟随对端消息加密状态(密文回密文,明文回明文);主动发起默认明文,只有显式 `--encrypt yes` 或 `aun.defaultEncrypt: true` 才加密;keystore seed 由 EvolCore 固定管理。
61
61
  - **断线重连**:SDK 内置退避策略自动重连。实时连接状态用 `ec watch aid` 查看(`ec aid` 是身份/证书管理,不显示连接状态)。
62
62
  - **群 ID 格式**:使用 `{base}.{issuer}`,如 `ontology.agentid.cn` 或 `g-12345.agentid.cn`。EvolCore 默认创建 `g-` 加五位数字(10000–99999)的名称,issuer 以群服务返回为准。群命令支持 base 简写;不再支持或转换 `group.{issuer}/{base}`,也不支持 `base@issuer`。`g-` 是名称的一部分,不应剥离,也不能仅凭群 AID 的格式判断主体类型。
63
63
  - **群 @ 处理策略**:`mention_mode=disabled|mention-only` 是群级配置,只决定哪些群消息进入 Agent LLM 上下文,不影响 AUN 协议层投递;被过滤消息仍应本地存档。
@@ -37,8 +37,8 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
37
37
 
38
38
  | 命令集 | 用途 | 触发词 | 适用场景 | 文档 |
39
39
  |--------|------|--------|----------|------|
40
- | `ecmsg` | **发送消息的统一入口**(当前会话 / `--thread` 跨话题 / `--to` 指定对端) | 回复/发消息/发文件/发链接/payload/加密/跨话题 | 有对端(peerId) | `msg.md` |
41
- | `ec msg` | 私聊消息底层命令(宿主终端与历史兼容);托管会话内的发送用 `ecmsg` | 回复/发消息/拉取/撤回/查在线/payload-file/请求等待/结果查询/request_id/call_id | 有对端(peerId) | `msg.md` |
40
+ | `ecmsg` | **发送消息的统一入口**(当前会话 / `--thread` 跨话题 / `--to` 指定对端) | 回复/发消息/发文件/发链接/payload/加密/跨话题/WidgetCard/HTML表单 | 有对端(peerId) | `msg.md` |
41
+ | `ec msg` | 私聊消息查询命令(拉取/撤回/查在线/请求状态/本地历史);发送一律用 `ecmsg` | 拉取/撤回/查在线/请求等待/结果查询/request_id/call_id | 有对端(peerId) | `msg.md` |
42
42
  | `ec thread` | 话题管理与话题链 | 话题/thread/跨会话/委托/话题链/ThreadOrigin/summary/删除话题 | 有对端(私聊或群聊) | `thread-chain.md` |
43
43
  | `ec group` | 群聊收发与群管理 | 群发/建群/本地群历史/邀请/踢人/退群/群成员/角色/封禁/屏蔽/成员状态/规则/@提及模式/协作 | AUN 群;可从私聊发起协作 | `group.md`;协作流程用 `ec-group-collaboration` 技能 |
44
44
  | `/invites` / `ec group invites` | 收到群邀请、Owner 卡片审核与恢复 | 入群邀请/接受邀请/拒绝邀请/审核卡片/待处理邀请 | 当前 Agent Owner 的 AUN 私聊 | `group.md` |
@@ -47,7 +47,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
47
47
  | `ec aid` | AID 身份、名片与头像管理 | 身份/证书/名片/头像/换头像/探测对端 | 任意有渠道场景 | `aid.md` |
48
48
  | `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
49
49
  | `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
50
- | `ec agent` | EvolAgent 生命周期、主机信息与模板 | 创建/启停/热重载/改配置/查主机信息/打包模板/安装模板 | 管理操作按目标与角色鉴权;template 要求双 Owner | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
50
+ | `ec agent` | EvolAgent 生命周期、主机信息、模板及项目地址变更 | 创建/启停/热重载/改配置/查主机信息/打包模板/安装模板/项目路径迁移 | 管理操作按目标与角色鉴权;template/project 要求双 Owner | `agent.md`;创建流程用 `ec-agent-create` 技能,Bootstrap 参考见 `agent-create.md` |
51
51
  | `ec directory` | Owner 名录查询、入录申请与本地备注 | 联系人/通讯录/名录/找人的 AID/申请添加联系人/这个人是谁/内外联系人/拉黑名单/记备注 | 查询需 Owner 名录授权;申请通过 `request` 发给本端 Owner | `directory.md` |
52
52
  | `ec rpc` | 底层 AUN RPC(逃生通道) | 直接调协议方法 | 仅宿主终端;托管会话仅可查看帮助 | `rpc.md` |
53
53
  | `ec menu-client` | 远程 Daemon Menu 请求 | 远程诊断/远程 daemon 操作/daemon 日志/监控/原始配置/跨主机 | 运维主机或具备 `ec.menu.request` 权限的托管 Agent | `menu-client.md` |
@@ -74,7 +74,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
74
74
 
75
75
  | 命令集 | 用途 | 触发词 | 文档 |
76
76
  |--------|------|--------|------|
77
- | `ec ability` | 按 AID 管理、开发和打包能力插件;管理走 daemon,dev/schema 可离线 | 能力插件/开发插件/ability/上架/下架/插件打包/插件诊断 | `ability.md` |
77
+ | `ec ability` | remote 发现、契约、设备、调用和结果查询;本地插件开发、管理与打包 | 手机能力/远端能力/remote/ability/能力插件/上架/下架/插件打包/插件诊断 | 内置 `ability` 技能(`ec skill load ability`) |
78
78
  | `ec provider` | 宿主 Provider 模板、注册表 CRUD 与单项 JSON 导入(宿主 DaemonOwner 控制入口或 trusted fullaccess 托管任务) | Provider/服务商/供应商/内置模板/套餐/导入服务商/注册表 | `provider.md` |
79
79
  | `ec model` | 模型与推理强度管理(按作用域持久化) | 切模型/列模型/当前模型/模型详情/改强度/诊断网关 | `model.md` |
80
80
  | `ec response` | 响应模式管理(按作用域持久化) | 切换响应模式/列响应模式/看当前模式/改响应配置 | `response.md` |
@@ -85,8 +85,9 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
85
85
  | `ec trigger` | 定时与事件触发器管理(创建用 `create`,`set` 为兼容别名) | 触发器/定时任务/cron/提醒/定时检查/自动执行/巡检/禁用 trigger/删除 trigger | `trigger.md` |
86
86
  | `ec trigger event` | EventBus 事件目录 | 事件触发/事件目录/EventBus/source.type=event/filter.match | `event.md` |
87
87
  | `ec events` | AUN 事件中心:注册/发布/订阅事件,事件到达跑脚本 | 事件中心/注册事件/发布事件/订阅事件/事件包/pack.json/events-config.json/scripts/AUN 事件 | `event-center.md` |
88
- | `ec services` | 服务路由:服务包状态/诊断/重载,对端 describe/schema/call | 服务路由/服务包/提供接口/被对端调用/pack.json/services.call/服务节点 | `services.md` |
88
+ | `ec services` | 服务路由:服务包状态/诊断/重载、宿主模式开关、ACL 收口;对端 describe/schema/call | 服务路由/服务包/提供接口/被对端调用/pack.json/services.call/服务节点/宿主模式/常驻/repair-acl/建服务包/调对端服务 | `services.md` |
89
89
  | `ec task` | 恢复暂停或异常中断的会话任务 | 任务恢复/异常中断/继续任务/resume | `task.md` |
90
+ | `ec pay` | 网站付款卡片、二维码、渠道切换与订单核验 | 付款/支付/微信支付/支付宝/付款二维码/订单核验 | `pay.md`;先加载 `ec-pay` 技能 |
90
91
  | `ec skill` | EC 技能管理(新建/安装/删除/启用/禁用/校验/查路径) | 创建技能/新建 skill/安装技能/装个 skill/删除技能/禁用技能/启用技能/看看有哪些技能/技能为什么没生效 | `ec-capabilities.md` |
91
92
  | `ec pa-workspace` | 在 Owner 的 AUN 私聊中查看和维护 PA 工作区入口导航 | 个人助理工作区/工作区入口调整/产物入口/报告入口/任务入口/隐藏入口/改名入口/排序入口 | `pa-workspace.md` |
92
93
  | `ec pa-workspace` | 入口导航文件的位置、格式、schema 与安全改法;含跨 Agent 入口 | 导航格式/入口格式/加个入口/产物给用户看/加个报告入口/入口指向别的助理/file-navigation/导航文件在哪 | `file-navigation.md` |
@@ -108,7 +109,7 @@ Windows 上 Codex 托管任务出现 `helper_sandbox_lock_failed`、`SetNamedSec
108
109
  | `menu-exec-schema-commands.md` | 通过 `menu.action name=cli action=exec` 取配置 schema 的命令手册 | 配置 schema 版本/schema 内容/远程取 schema |
109
110
  | [`aid.md`](aid.md#daemonowner-远程单命令) | DaemonOwner 在 Control AID 的 E2EE 私聊以 /exec on 进入终端后直接发命令,/stop 取消,/exec off 退出,进出使用 notice;最长 30 分钟、空闲 6 分钟 | 虚拟SSH/remote-shell/daemon执行命令/exec on/exec stop/终端状态 |
110
111
  | `ec-capabilities.md` | EC Skill 系统机制概要(三级目录、开关覆盖链、渐进式披露、编写规范、权限) | 技能系统怎么工作/技能放在哪里/SKILL.md 怎么写/技能为什么没生效/description 怎么写 |
111
- | `$KITS_DOCS/aun/ABILITY_CALLING.md` | AUN Ability 的发现、原始 payload、请求关联与结果查询 | 能力调用/Ability/protocol/discover/ability_path/request_id/call_id/超时查询 |
112
+ | 内置 `ability` 技能的 `SKILL.md` | AUN Ability 的发现、原始 payload、请求关联与结果查询 | 能力调用/Ability/protocol/discover/ability_path/request_id/call_id/超时查询 |
112
113
 
113
114
  ## 其他
114
115
 
@@ -4,6 +4,8 @@
4
4
 
5
5
  ## Agent 模板
6
6
 
7
+ 单 Agent 可信来源绑定、周期提醒及 Owner 手动升级已加入 template Menu/CLI:`update-status`、`check-update`、`bind-update-source`、`confirm-update-source`、`preview-update`、`read-update-notice`。执行沿原 `deploy/status/resume/cancel` 作业;disabled 禁止检查/覆盖,auto 仅检查提醒。旧无来源明确未绑定,不根据 config.version 或 update.publisher 猜测。实际契约、私有目录配置、锁/提醒/恢复语义与 App 待办见[单 Agent 更新接入](../../../docs/agent-template/single-agent-manual-update-core-20261117.md)。
8
+
7
9
  单成员、多成员共用 `ec agent template`。新建支持一个或多个成员,只创建成员 AID,沿用本机 Host 和经鉴权的 Owner;覆盖仅支持一个已有 Agent,保留其 AID、Owner、角色和默认项目目录。打包不带记忆、消息、私钥或 Provider 凭证;导入的 Trigger 默认停用并携带脚本。来源采集和覆盖要求操作者同时是 DaemonOwner 和对应 Agent 的协议 Owner。
8
10
 
9
11
  ```bash
@@ -22,11 +24,15 @@ ec agent template capabilities
22
24
 
23
25
  `inspect/build/push/pull/preview` 的业务参数通过 JSON 文件传入。`capabilities` 返回动作输入 schema、状态及平台能力;文件模板沿用原 v1 的 `agents[]/key`、PACKAGE/MANIFEST 和资源结构。Core 作业以成员 key 关联,不按数组位置配对。Menu 使用进程级 `name: "template"`,动作与 CLI 一致;查询使用 `args.view: "job"` 或 `"capabilities"`。
24
26
 
27
+ 模板声明 `team.json` 使用 `id` 作稳定标识、`title` 作显示名;旧顶层 `name` 只兼容输入,归一化、导入保存及打包导出均移除该字段。旧 name-only 转为 id;id/name 并存须同值,否则拒绝。旧表单 schema 的 name 约束与 required 迁到 id,不再生成 name 控件,title 保留。`PACKAGE.name` 和请求 `metadata.name` 继续表示显示名,对应 `team.title`;Agent 的 `profile.name`、成员 key 与身份 AID 保持既有语义。示例:`{"name":"demo","title":"演示团队",...}` 读入后为 `{"id":"demo","title":"演示团队",...}`,格式版本仍为 v1。
28
+
25
29
  inspect 输入示例:`{"members":{"writer":{"source":{"kind":"agent","aid":"writer.agentid.cn"}}}}`。全组必须空闲,任一忙碌立即返回 AGENT_BUSY;成功后冻结任务启动与 Trigger,无确认操作 15 分钟自动释放,查询不续期。build 承接 inspectionJobId、inventoryDigest、metadata 和各成员 include;接管后由构建作业持有冻结直到结束,取消统一使用 jobId。
26
30
 
31
+ 2026-11-17 项目文件容忍:build 仍按原 `inventoryDigest` 和候选清单验证 `include.files`,但项目增删改不再使整次快照校验失败;删除选中项跳过,修改读取当前内容,新文件不会自动加入旧文件选择。某成员选择非空而最终无可打包项目文件时报 `PROJECT_FILES_EMPTY`;原本空选择正常。成功结果 `projectFiles[key]` 返回 selected/copied/skippedMissing 数量。路径、大小及内容安全校验、非项目资源严格快照和原失败清理/冻结释放继续保留。现有完整候选清单仍可能触发响应超限;第二阶段目录选择及选择索引协议尚未实现,见[Core/App集成开发文档](../../../docs/agent-template/project-file-selection-integration.md)。
32
+
27
33
  完整选项用 `ec agent template --help` 查看。上传前由 App 以 Owner 身份授予来源 Host 目录读写权限,SDK 上传需读取元数据;普通私有下载使用 `storage.create_share_link.allowed_aids` 指定目标 Host,pull 的 source 带 location、分享短码和摘要。Owner/subaid 动态授权等待新 SDK;daemon 不代设权限,模板签名延期。
28
34
 
29
- preview 传 packageId、installMode 和成员 key → target/providers/externalAids。新建目标示例:`{"members":{"writer":{"target":{"aid":"auto","project":"/work/writer"},"providers":{"ecagent":{"provider":"provider-12345678","model":"model-a"}}}}}`;aid=auto 时另传 issuer。预览不注册身份;deploy 只引用可执行 previewId 和 planDigest。多成员必须全部新建,不提供已有成员配对。
35
+ preview 传 packageId、installMode 和成员 key → target/providers/externalAids。新建目标示例:`{"members":{"writer":{"target":{"aid":"auto"},"providers":{"ecagent":{"provider":"provider-12345678","model":"model-a"}}}}}`;aid=auto 时另传 issuer。新建可省略 target.project,由目标 Host 按默认项目根目录和最终 AID 分配不重名目录;显式 project 须为目标 Host 绝对路径。实际目录在 result.members[key].target.project 返回并持久保存,deploy/resume 不重新分配。覆盖仍须传目标当前默认项目目录。预览不注册身份;deploy 只引用可执行 previewId 和 planDigest。多成员必须全部新建,不提供已有成员配对。旧版 0.0.49 仍要求 project,以所选 Host 的 capabilities 输入 schema 为准,不能按开发机状态推定远端支持。参数错误保留具体字段及原因,不归类为模板不支持。
30
36
 
31
37
  异步命令默认 `--wait 0`,可设 0..300 秒,超时不取消作业。失败/取消退出码 1、参数错误 2、暂停或等待超时 3。先以原 requestId 或 jobId 查询,再恢复原作业,不用新部署请求重试未知结果。Menu 事件统一为 `template.job`,seq 单调递增;状态包括 queued/running/paused/failed/cancelling/cancelled/succeeded。
32
38
 
@@ -34,6 +40,35 @@ preview 传 packageId、installMode 和成员 key → target/providers/externalA
34
40
 
35
41
  工具随包位于 `scripts/agent-template/`;本机 CLI 经控制令牌 IPC,托管 CLI 经原委派通道,Menu 发往 Host Control AID。远端 Menu 不读取任意本机路径。Provider 模型通过进程级 model Menu 的 catalog 查询;作业 readiness 分别表示运行、名录和团队就绪,不以本地成员表代替 Owner 名录授权。接口细节及当前验收边界见 `docs/agent-template/agent-template-app-integration.md`。真实容器已验证注册/绑定/Storage/恢复及覆盖;App 界面、真实模型推理和名录互聊待验收。
36
42
 
43
+ ## 本机项目地址变更
44
+
45
+ 项目文件单次复制并保留源目录,迁移原基座会话、保留原 AID、话题和 session/thread ID。关联 Agent 由用户多选,默认仅当前 Agent;未选中者继续使用旧目录。Core、CLI、Menu 和 ECWeb 共用 Agent 应用服务。
46
+
47
+ ```bash
48
+ ec agent project <aid> preview --target '<新绝对目录>' [--agents '<aid1>,<aid2>'] [--format json]
49
+ ec agent stop <aid> [--format json]
50
+ ec agent project <aid> move --target '<新绝对目录>' [--agents '<aid1>,<aid2>'] [--format json]
51
+ ec agent project <aid> status [--format json]
52
+ ec agent project <aid> resolve --conflict '<status返回的conflict.id>' --decision skip|abort [--format json]
53
+ ec agent start <aid> [--format json]
54
+ ```
55
+
56
+ 只有 preview/move 接受 --target 和 --agents;不传 --agents 为仅入口 aid。所选 Agent 须逐个显式停止。preview 不持久化计划;move 重新检查并在所选 Agent 独占门内执行。普通项目增删改不触发追平;同一实际原生文件到同一目标只复制一次。连接超时不取消操作,按 Agent 查询 status。
57
+
58
+ status 返回 currentStep、totalSteps=7、currentPhase、steps、updatedAt;阶段依次为 checking/freezing/preparing/copying/sessions/committing/finalizing。冲突为 awaiting_decision,说明原因、资源和依赖范围,用户选择 skip 或 abort。skip 不会跳过必需原生文件后继续更新其绑定;abort 恢复本次核心修改,保留源目录和普通项目副本。异常中断或恢复未完成时使用:
59
+
60
+ ```bash
61
+ ec agent project <aid> recover [--format json]
62
+ ```
63
+
64
+ recover 只继续恢复旧绑定,不执行用户任务;独立修改无法撤销时保持 paused 并阻止启动。成功迁移或恢复后仍保持停止,由用户显式启动。跳过整个 Agent 且恢复完成后解除它的迁移限制。停止/启动复用原生命周期入口。
65
+
66
+ Menu 使用 name=agent、action=project,args 为 aid、operation;preview/move 另传 target 和可选 aids 数组;resolve 传 conflictId、decision=skip|abort。远端请求须加密,并核验 DaemonOwner、入口 Agent 和每个所选 Agent 的新鲜 Owner 共识;托管 CLI 保留原委派 IPC。
67
+
68
+ ECWeb:Agent 列表 → 编辑 → 变更项目地址。显示新地址、Agent 多选、预览、步骤 x/7、阶段及结果。冲突显示“跳过”“终止迁移”;paused 显示“恢复旧绑定”。关闭页面不代答,重开恢复选择与冲突。停止/启动在原操作菜单完成;Evol App 原生页面按相同接口接入。
69
+
70
+ 配置仅修改有关字段,索引按对应记录更新,第三种值或分叉历史不覆盖。目标冲突、核心文件变化、共享记录不能同时表达新旧路径等均明确提示跳过范围。完整流程、参数、Menu 示例与验证见[实施与用法](../../../docs/agent-template/agent-project-path-implementation.md),十类不能自动合并的情况见[修订说明](../../../docs/agent-template/agent-project-path-revision.md)。跨操作系统/跨 Host 实机续接另行验收。
71
+
37
72
  ## 子命令
38
73
 
39
74
  ```bash
@@ -1,5 +1,19 @@
1
1
  # ec aid — AID 身份管理
2
2
 
3
+ ## 本机 Claude Code 网关
4
+
5
+ Claude 网关是将 AUN 消息投递到本机终端会话的入口,不是新的 baseagent。消息在
6
+ MessageBridge 分流,不进入普通 message-queue 或 ResponseEngine,也不加载模型 runner。
7
+ 本机终端自身的授权及执行环境继续生效。
8
+
9
+ 默认关闭。宿主 Owner 可显式设置 `ec config set ccAgent.enabled true --process`,
10
+ 由宿主重新启动 EvolCore 后初始化网关身份。未启用时不自动注册 AID;已有网关身份也不自动删除。
11
+ 初始化必须确认网关与 daemon 的协议 Owner 一致,不能把“已提交绑定请求”视为已就绪。
12
+
13
+ 仅接受同时拥有本机与网关的 Owner 在加密设备私聊中操作。绑定按本端、Owner、设备、
14
+ Ownership 版本和话题隔离。主话题先选本机会话,之后的消息投递给该会话;发送“列表”可重新查看。
15
+ 网关只回传新出现的 assistant 文本,不重放历史或工具输入;Owner 变化、关闭开关或会话解绑后停止回传。
16
+
3
17
  管理本地 AID 身份(证书、私钥、agent.md 名片与头像),以及远程探测对端 AID。触发词:身份/证书/名片/头像/换头像/探测对端/创建身份。
4
18
 
5
19
  ## 运行边界
@@ -43,7 +57,7 @@ ec aid avatar <当前 self AID> (--file <path> | --url <https-url>) [--format js
43
57
 
44
58
  `ec init --non-interactive --owner <aid> --format json` 首先按普通 host 类型注册控制 AID,
45
59
  完成主机名片和配置落盘后,通过独立 `ownership-UUID` slot 的短连接调用 SDK `bindOwneraid` 发起邀约。
46
- 该注册调用不等待人工审批、不启动 daemon,也不把目标写入 `daemon.json.owner/owners`。
60
+ 该注册调用不等待人工审批、不启动 daemon;`--owner` 只作为本次邀约目标,不写入 `daemon.json`——控制 Owner 只由 ownership 协议授予。
47
61
  SDK 不持久化 Ownership task/WAL;`OwnershipTaskResult` 只是本次调用结果。
48
62
  提交后应以当前 NS 状态和 `checkOwnershipConsensus` 为准,不依赖重启后恢复相同 operation ID。
49
63
 
@@ -121,9 +135,12 @@ SDK 的 `transferLocalSubaid` 完成本地三身份编排;否则调用 `transf
121
135
 
122
136
  ## Ownership 共识缓存
123
137
 
124
- Agent 的首个配置 Owner 可在该 Agent 的 AUN 私聊中发送纯 `/bind`,由 Agent
138
+ Agent 的 Owner 只由 ownership 协议授予,配置中的 owner 字段不作为授权来源。
139
+
140
+ 本机 Daemon Owner 可在该 Agent 的 AUN 私聊中发送纯 `/bind`,由 Agent
125
141
  以发送者 AID 发起协议 ownership 绑定。带参数的 `/bind feishu [实例名]` 等仍是外部渠道联系人绑定,
126
- 不会修改 ownership;其它配置 Owner 不能使用纯 `/bind` 代替手动绑定。
142
+ 不会修改 ownership;非 Daemon Owner 不能使用纯 `/bind` 代替手动绑定,须由 Daemon Owner 在宿主端
143
+ 为该 Agent 指定绑定目标。
127
144
 
128
145
  Ownership 共识不再每 15 秒轮询。普通消息、控制消息、查询和路由读取复用最长 30 分钟的共识结果;敏感授权、审批授权兑现、初始化激活及高权限执行使用同一结果,但要求核验时间不超过 5 分钟。读取不会延长缓存有效期,到期本身不会发请求;需要结果的异步调用在过期后等待刷新。控制通道的配对和诊断命令按敏感操作使用 5 分钟窗口。
129
146
 
@@ -307,7 +307,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
307
307
  - **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。经 daemon 验证的 fullaccess 任务可绕过托管 CLI 顶层白名单和 H-Class 文件入口限制,但当前会话承载的 EvolCore 生命周期保护、参数校验和文件完整性校验仍生效。
308
308
  - **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
309
309
  - **基座 skill 总开关**:`baseagentSkills` 默认关闭,设为 `true` 统一开放;仅 Agent 级、仅 owner 可写(`ec config set`,Menu 协议经 `name=cli action=exec` 传同一 argv,ECWeb 编辑 Agent 抽屉),对所有基座统一生效(Claude 的 Skill 工具、Codex 的 skills);关闭时 `/capability` 的 skill 策略不可修改。它不影响 EC 技能,EC 技能用 `ec skill enable/disable` 管理
310
- - **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun
310
+ - **仅人可写**:channels / admins / 凭证 / aid / enabled / projects / aun
311
311
  - Agent 托管环境写仅人字段被拒
312
312
 
313
313
  **操作权限**:
@@ -22,6 +22,8 @@ ecmsg send --file <path> [--as <type>] [--text '<说明>']
22
22
 
23
23
  # 自定义 payload
24
24
  ecmsg send --payload '<json>'
25
+ # 注意:--payload-file 只支持私聊发送,群会话里会报「--payload-file is supported for
26
+ # private msg sends only」。群里要发复杂 JSON,用私聊发给对本项目有权限的 agent,或改用 --payload。
25
27
 
26
28
  # 查询本地群历史(只读,不调用 Gateway,不推进 group pull/ack 游标)
27
29
  ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format json]
@@ -48,7 +50,6 @@ ecmsg send '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
48
50
 
49
51
  发送选项还包括:
50
52
 
51
- - `--no-encrypt`:强制明文,优先于 `--encrypt`
52
53
  - `--thread <id>`:指定话题 ID
53
54
  - `--content-type <mime>`:覆盖文件 MIME
54
55
  - `--transcript <text>`:语音转写,仅 `--as voice`
@@ -2,6 +2,8 @@
2
2
 
3
3
  记忆系统的标签值全集。写入记忆时从本表选值,同一条记忆可以贴多个标签。
4
4
 
5
+ 整理会话读不到本文件——它的可读范围不含 `kits/docs`。整理会话用的精简表在注入的 `$KITS_TEMPLATES/memory-consolidation/workflow.md` 里,增删标签时两处同步。
6
+
5
7
  标签值直接放在 frontmatter 的 `tags` 数组里:
6
8
 
7
9
  ```yaml
@@ -11,21 +11,21 @@
11
11
  ec menu-client request <from-aid> <daemon-aid> \
12
12
  --request-file "$TMPDIR/menu-request.json" \
13
13
  --timeout 15s \
14
- --encrypt \
14
+ --encrypt yes \
15
15
  --format json
16
16
  ```
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
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
+ - `--encrypt yes|no|auto` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。必须带取值,裸写是参数错误。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
22
22
  - 独立终端默认 slot 是 `evolcore-menu-client`;`--app <slot>` 可覆盖,但会切换消费游标,调用方须自行串行化。托管模式使用 daemon 的现有连接和 ACK 路径。
23
23
  - `menu.query` / `menu.options` 等待响应超时时自动重发一次相同 request id;写操作不自动重试。
24
24
  - 默认收到 `menu.response` 即返回,作业受理响应中的 `jobId` 不代表作业完成。升级或模板作业可加 `--wait` 等待终态,`--timeout` 分别限制初始响应和受理后的终态等待。终态字段合并到响应 `data`,保留原响应 `id`;作业失败/取消退出码为 1。超时错误保留 `jobId`,可用已有作业查询接口恢复状态,客户端不重新执行 action。
25
25
 
26
26
  ## 鉴权入口
27
27
 
28
- - 默认授权是远端 `daemon.json.owner` 对发送 AID 的校验。
28
+ - 默认授权是对发送 AID 的 ownership 协议 Owner 校验(控制 AID 的协议共识,不再读 `daemon.json`)。
29
29
  - `--remote-token <token>` 使用 daemon 签发的远程访问 token,权限与 daemon-owner 一致。CLI 审计日志不会记录 token 明文。
30
30
  - `--ecweb-token <token>` 是 `--remote-token` 的兼容别名。
31
31
  - `system/paircode` 例外:仅接受加密的 daemon-owner 请求,已有 remote token 不能换取新配对码。
@@ -26,6 +26,13 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
26
26
 
27
27
  响应 `data.kind="menu.query_batch"`,`data.items` 按输入顺序逐项给出 `itemId/name/ok/data` 或 `itemId/name/ok/error`。`agent` 项可共用其 `fullaccessStatus`、`config.baseagent`、`safeConfig.baseagentSkills`,不必重复请求。Control AID / ECWeb 还需顶层 `agent` 指定目标;members 在这些入口返回该项权限错误。已有 `view="values"` 的 entryId 查询保持不变。
28
28
 
29
+ 私聊提及模式使用专用 `name="private-mention-mode"`,支持 `menu.query/options/update`。
30
+ 查询返回 `mode`(`disabled` 或 `mention-only`)、`override`、`source`、`revision`;缺省为 `disabled`。
31
+ 混合批量查询可加入 `{ "itemId": "privateMentionMode", "name": "private-mention-mode" }`;
32
+ Agent Catalog 的 `privateMentionMode.agent` 同时支持 `view="values"` 批量读取。
33
+ 修改传 `value` 和 `args.expectedRevision`,仅 Agent Owner 可写,版本过期返回 `CONFLICT`。
34
+ 配置仅作用于 Agent 级;不用 CLI,也不复用群聊的 `name="group"`。
35
+
29
36
  ---
30
37
 
31
38
  ## 一、传输层约定
@@ -22,6 +22,9 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
22
22
  跳过主动压缩。手动 `/compact` 和基座自身的默认压缩仍可使用。
23
23
  Claude 的 `--autocompact` 参数与返回给界面的压缩刻度使用同一份目录窗口计算;
24
24
  没有接口窗口时不下发 EvolCore 估算的阈值。该逻辑修改需要宿主重新加载源码后生效。
25
+ Claude 所选模型的有效窗口达到 1,000,000 tokens 时,传给 SDK 的裸模型 ID 会补上 `[1m]`,
26
+ 即使 Provider 同时列出了裸 ID 和 `[1m]` 变体;以所选条目的窗口为准。
27
+ 显式选择的 `[1m]`、`[200k]` 后缀保持原样。普通查询与手动压缩共用此处理。
25
28
 
26
29
  ## 命令
27
30
 
@@ -1,8 +1,10 @@
1
1
  # ec msg — 私聊消息命令
2
2
 
3
- 私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询。
3
+ 私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询/WidgetCard/HTML 表单。
4
4
 
5
- AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`);协议语义见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。本文维护消息命令参数和请求查询行为。
5
+ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`),协议语义在该技能的 `SKILL.md` 里。本文维护消息命令参数和请求查询行为。
6
+
7
+ 常规远端能力任务使用 `ec ability remote list/discover/info/devices/call/result`,命令见该技能的 `references/cli.md`;remote 复用本文的 delegated sender 与请求索引。以下原始消息参数用于通用消息和协议诊断,不作为 remote 权限拒绝后的替代路径。remote 的 call/result 会进一步按原契约核验业务结果,不能把底层 CLI ok 与业务成功混用。
6
8
 
7
9
  ## Agent 会话中的 Shell 调用边界
8
10
 
@@ -28,7 +30,9 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
28
30
 
29
31
  `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
30
32
 
31
- **跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self`。
33
+ **跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self topicPeer=<话题对端>`。
34
+
35
+ **回执怎么核对**:自派的两个字段 `recipient=self` 与 `topicPeer=<话题对端>` 成对出现,`topicPeer` 一定是真实对端而不是本端。如果回执里只有 `to=<本端AID>(会话|传入)` 而没有 `recipient=self`,说明这个话题的对端被写成了本端自己——结构残缺,消息不会有人接收。这类话题建不出来(创建时即 `SELF_PEER_NOT_ALLOWED`),历史遗留的用 `ec thread delete <本端AID>/<threadId>` 清掉。
32
36
 
33
37
  宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
34
38
 
@@ -55,9 +59,12 @@ ecmsg send '<text>' --encrypt yes
55
59
  # 强制明文
56
60
  ecmsg send '<text>' --encrypt no
57
61
 
58
- # 文件:--as 可选 image|video|voice|file(默认按扩展名推断)
62
+ # 文件:--as 可选 image|video|voice|file|widget_card(默认按扩展名推断为普通媒体或文件)
59
63
  ecmsg send --file <path> [--as <type>] [--text '<说明>']
60
64
 
65
+ # WidgetCard:HTML 上传为 AUN Storage 附件,App 点击填写,以 widget_card_reply 返回 JSON
66
+ ecmsg send --file ./meeting.html --as widget_card --title '会议安排' --text '请补充会议需求'
67
+
61
68
  # 链接卡片
62
69
  ecmsg send --link <url> [--title '<title>'] [--description '<desc>']
63
70
 
@@ -75,7 +82,7 @@ ecmsg send '<text>' --return none
75
82
  ```
76
83
 
77
84
  `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊发送(`ecmsg send`),不能同时提供位置文本。
78
- Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
85
+ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。文件必须是普通文件,上限 1 MiB,符号链接、硬链接和路径穿越一律拒绝。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
79
86
  最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
80
87
  在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
81
88
  双引号前加一个反斜杠,例如 `--payload '{\"type\":\"query\"}'`。反斜杠只用于命令行参数传递,
@@ -88,10 +95,9 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
88
95
  - `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
89
96
  - `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
90
97
  - `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
91
- - `--text-from-file <path>` — 从文件读取文本(UTF-8),用于超长消息或避免 Shell 转义
98
+ - `--text-from-file <path>` — 从文件读取文本(UTF-8),文件上限 1 MiB
92
99
  - `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
93
- - `--encrypt` — 端到端加密
94
- - `--no-encrypt` — 强制明文发送,优先于 `--encrypt`
100
+ - `--encrypt yes|no|auto` — 加密三态:`yes` 强制端到端加密,`no` 强制明文,`auto`(默认)被对端消息触发时沿用该消息的加密状态、主动发起时明文;必须带取值,裸写是参数错误,不写该参数才是默认 `auto`
95
101
  - `--thread <id>` — 指定话题 ID(多话题路由)
96
102
  - `--content-type <mime>` — 显式覆盖 MIME(仅 `--file`)
97
103
  - `--text <说>` — 附件说明文字(仅 `--file`)
@@ -109,6 +115,14 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
109
115
  未指定 `--content-type` 时,附件 MIME 由 SDK 按实际字节识别、后缀回退,附件描述沿用上传后的类型。
110
116
  `--as` 控制消息展示类型,与 MIME 独立。
111
117
 
118
+ `--as widget_card` 是 HTML 表单专用入口,要求托管 daemon 发送、UTF-8 `.html`/`.htm` 文件,原始 HTML 最大 1 MiB;不能与 `--return required`、设备定向或跨话题自派组合。普通 `.html` 文件未显式指定该类型时仍按 `file` 发送。`--title` 设置卡片标题,缺省使用文件名;`--text` 为摘要。`--as action_card` 不存在,简单按钮卡片仍使用现有交互接口或 `--payload`。
119
+
120
+ WidgetCard 复用标准附件上传、持久 outbox 和原卡片关联,上传时注入统一表单运行脚本。基础 HTML 只需一个 `<form>`,多表单页面用唯一的 `form[data-widget-form]` 指定入口;控件使用标准 `name`/`value`。数值输入自动转换,独立复选框转布尔值,多选转数组;可用 `data-widget-type="string|number|boolean|array"`、`data-widget-item-type="string|number"` 明确类型。文件选择暂不支持。`widget_card_reply.values` 为对象,最大 64 KiB,按原话题交给 Agent 继续处理;关闭浏览器不等于取消。
121
+
122
+ 原生 EvolApp 需接入受控浏览器和 `EvolWidgetBridge.postMessage(json)`,返回发送结果的 Promise;Core 代码与 HTML 脚本就绪不代表 App 已完成集成。完整流程和桥接契约见仓库 `docs/widget-card-design.md`。
123
+
124
+ 当 Agent 已经生成了要交付的报告、截图、补丁或其它文件时,应使用上面的 `--file` 发送标准附件消息,并用 `--text` 写简短说明;不要只把本地路径写进普通正文。普通正文里的路径仍表示“请在对端工作区读取”,由接收方按需通过 Menu 查询。
125
+
112
126
  托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
113
127
 
114
128
  托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
@@ -253,6 +267,50 @@ ec msg history <self-aid> <target-aid> \
253
267
 
254
268
  `sessionId` 是 EvolCore 本地逻辑会话 ID,不是 Claude/Codex 等后端的会话 ID。
255
269
 
270
+ ## 私聊提及模式
271
+
272
+ 私聊的 `@` 处理策略由 Agent 级字段 `privateMentionMode` 控制,与群聊的 `mentionMode` 相互独立。
273
+
274
+ | 值 | 行为 |
275
+ |---|---|
276
+ | `disabled`(默认) | 所有私聊消息都进入模型回合 |
277
+ | `mention-only` | 只有被 `@` 的私聊消息进入模型回合 |
278
+
279
+ 未被 `@` 的消息不会消失:仍然落在本地 `messages.jsonl`,带 `privateAttention: "filtered-mention-only"` 标记。
280
+ 它们没有进入任何会话(无 `sessionId`),因此读取时必须带 `--session all`:
281
+
282
+ ```bash
283
+ ec msg history <self-aid> <peer-aid> --session all
284
+ ```
285
+
286
+ 不带参数等价于 `--session latest`,只返回最近一次会话里的消息,读不到这些被过滤的记录。
287
+ 开启该模式后,被 `@` 时才进入模型,模型需要了解前文就用上面的命令自己读历史。
288
+
289
+ ```bash
290
+ # 开启(仅 Owner 可写)
291
+ ec config set privateMentionMode mention-only
292
+
293
+ # 关闭
294
+ ec config set privateMentionMode disabled
295
+
296
+ # 查看生效值
297
+ ec config get privateMentionMode
298
+ ```
299
+
300
+ 约束:
301
+
302
+ - **只能配置在 Agent 级**。写入关系级会被拒绝(`SCOPE_MISMATCH`),`--default` 同样拒绝。
303
+ - **只有 Owner 可以修改**。其他角色写入会得到 `can only be changed by an owner`。
304
+ - 取值只有 `disabled` 和 `mention-only`,没有 `auto`:私聊下没有「自动判断是否被提及」这回事,
305
+ 未显式 `@` 就是不触发。
306
+ - 切换立即生效,不需要重启或新建会话。
307
+
308
+ 判定只看**结构化 `mentions`**(`payload.mentions` 命中自己的 AID,或 `{scope:"all"}`),不扫正文。
309
+ 客户端不发送结构化 `mentions` 时,`@` 不会被识别为提及。
310
+
311
+ 以下消息不受该模式影响,仍按原路径处理:slash 命令、`menu.*` / `bind.*` / `observer.*` 等控制类 payload、
312
+ echo 探针、联系人待收补投。
313
+
256
314
  ## 共享选项
257
315
 
258
316
  - `--format json` — 对支持结构化结果的子命令输出 JSON
@@ -264,8 +322,8 @@ ec msg history <self-aid> <target-aid> \
264
322
  收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
265
323
 
266
324
  加密策略:
267
- - 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
268
- - 对端发来明文消息时,默认明文回复
325
+ - 对端发来密文消息时,回复也应使用 `--encrypt yes`(保持对话加密一致性)
326
+ - 对端发来明文消息时,用 `--encrypt no` 或省略参数(默认 `auto` 即明文回复)
269
327
  - 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
270
328
 
271
329
  `ecmsg send` 默认等价于 `--encrypt auto`:被对端消息触发时沿用该消息的加密状态,主动发起时明文。
@@ -0,0 +1,34 @@
1
+ # ec pay — 网站订单付款
2
+
3
+ 当前 Owner AUN 私聊托管会话中的标准扫码付款。底层复用 AUN 标准附件及可靠消息投递,
4
+ 不建立独立 SDK 连接。遇到付款先加载 `ec-pay` 技能;字段全表、错误码与 Persistence
5
+ 细节在技能内 `references/pay-cli.md`,此处不重复。
6
+
7
+ ## 命令
8
+
9
+ ```bash
10
+ ec pay request --spec-file "$TMPDIR/payment-request.json"
11
+ ec pay status <request-id>
12
+ ec pay verify <request-id>
13
+ ec pay refresh <request-id>
14
+ ec pay cancel <request-id>
15
+ ec pay update <request-id> --spec-file "$TMPDIR/payment-update.json"
16
+ ec pay complete <request-id> --event-id <event-id>
17
+ ```
18
+
19
+ 全部输出 JSON,可显式 `--format json`。托管命令保留当前委托环境,不能指定 self、付款人、
20
+ 另一话题或其它 AID。`request-id` = `pay_` + 32 位十六进制;`event-id` = `payjob_` + 32 位十六进制。
21
+
22
+ ## 语义要点
23
+
24
+ - `status` 返回 `payment`、`state_version`、`card_message_id`、`delivery`、`pending_events`。
25
+ `sent` 表示已获传输消息 ID,`queued` 表示待可靠发送;**二者都不是已付款**。
26
+ - `verify` / `refresh` 只安排持久任务,命令返回不代表网站操作已完成。
27
+ - `update` 必须关联未完成事件及原订单核验;有效请求确认付款后安排一次 `continue` 事件,
28
+ 后续步骤完成后再 `complete`。已取消 / 过期请求迟到确认付款时保留已付事实,不自动继续任务。
29
+ - `status` 用于读取状态,不代替原网站核验。
30
+
31
+ 输入格式见 `ec skill load ec-pay` 的正文骨架;字段语义与上限见该技能 `references/pay-cli.md`。
32
+
33
+ App 对接见仓库 `docs/evo-app-pay-integration-v1.md`;Core 已提供对应命令与消息处理,
34
+ App 需另行实现并进行真实平台联调。
@@ -131,6 +131,20 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
131
131
 
132
132
  apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
133
133
 
134
+ 同一服务方的多把 Key 写进同一个 Provider 的 `apiKey` 数组,不必为每把 Key 另建 Provider:
135
+
136
+ ~~~json
137
+ {
138
+ "name": "Example",
139
+ "domain": "api.example.com",
140
+ "common": {
141
+ "baseUrl": "https://api.example.com/v1",
142
+ "apiKey": ["$EXAMPLE_API_KEY", "$EXAMPLE_BACKUP_KEY"]
143
+ },
144
+ "services": { "text": {} }
145
+ }
146
+ ~~~
147
+
134
148
  Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。domain 由程序获取并保存,ECWeb 不提供独立输入或展示字段,JSON 预览也隐藏该内部字段。静态 `baseUrl` 自动提取 hostname;管理入口收到未带 domain 的环境变量地址时,从宿主进程环境解析 URL 并提取,配置中的 baseUrl 仍保留变量引用。变量缺失、为空或解析结果不是有效 HTTP(S) URL 时拒绝新建,已有 domain 的配置读取不依赖变量是否存在。配置文件仍可显式声明 domain,运行时实际地址必须与保存的身份匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
135
149
 
136
150
  hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一为 URL hostname 使用的压缩、带方括号形式(如 `[::1]`);显式 domain 也接受不带方括号的 IPv6。端口仍属于连接地址,不参与身份计算;同一主机的不同协议或端口不能合并。DNS 身份与已有固定 ID 的生成规则保持不变。
@@ -154,6 +168,13 @@ Provider schema v3 增加 `services.<type>.catalogPath`、`apiKey`、`headers`
154
168
 
155
169
  服务级 Key 未声明时继承 `common.apiKey`,声明后独立使用,支持整字段环境变量引用。
156
170
  显式空 Key 不回退公共 Key,缺失/空环境变量直接报错。服务级 headers/queryParams 整组覆盖,
171
+ `apiKey` 可写单值或有序数组(Key 池):第 0 位是主力,`apiKeys` 解析结果按原顺序给出整池,
172
+ `apiKey` 仍是主力。第一版只存储不自动切换——备用 Key 存进去后仍由主力承担全部请求,
173
+ 换用备用需要后续版本的故障切换。单元素数组按单值写回,老配置读写后字节不变。
174
+ 池上限 16 把,重复 Key 与逐元素的环境变量语法会被拒绝;主力 Key 的环境变量未设置仍严格报错,
175
+ 备用位的环境变量未设置只丢弃该位并记警告,避免一把过期备用拖垮可用主力。
176
+ `<redacted>` 按位保留,第 i 位的掩码还原旧池第 i 把,新增位置必须带真实 Key。
177
+ 服务级 headers/queryParams 整组覆盖,
157
178
  省略表示继承,`{}` 表示清空。独立 Key 与公共认证头/认证查询参数可能冲突时,要求显式覆盖对应组。
158
179
  旧配置没有覆盖字段时保持原语义。导入导出、脱敏、模型目录与推理均使用目标服务的有效连接。
159
180
  单服务带密钥导出只包含该服务的有效凭据;不带密钥导出移除公共和服务级 Key、headers、queryParams。