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
@@ -1,279 +1,25 @@
1
- # PA 工作区入口导航:agent 操作手册
1
+ # Team Workspace 文件入口
2
2
 
3
- 个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
4
- 新增一个产物目录要给用户看到,改导航即可,不需要 App 发版。
3
+ 状态只保存在 `$EVOLCORE_HOME/agents/<aid>/data/team-workspace-state.json`;不要手工编辑状态文件,也不要在工作区内创建导航副本。
5
4
 
6
- 本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
7
- **本文自包含**,按本文即可完成导航的增删改,不需要读其他文档。
8
-
9
- ## 1. 文件在哪
10
-
11
- ```text
12
- $AGENT_DATA_DIR/pa-workspace-state.json
13
-
14
- ```
15
-
16
- 其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
17
- 被导航指向的真实文件在 PA 工作区里(`capture/`、`output/` 等),导航只存"指向哪里",不存内容。
18
-
19
- ### 1.1 三个名字指同一份数据
20
-
21
- | 名字 | 指什么 |
22
- | --- | --- |
23
- | pa-workspace-state.json | 磁盘上的完整状态:绑定信息(workspaceId/ownerAid/rootPath)+ navigationRevision + entries |
24
- | file-navigation.json | 导航内容本身,即 {version, entries} 这部分。协议与设计文档里的叫法 |
25
- | --entries-json | 命令参数,取值就是 file-navigation.json 的 entries 数组 |
26
-
27
- **改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
28
- 递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
29
- 手工编辑 `pa-workspace-state.json` 会跳过全部这些保护。
30
-
31
- 导出当前导航为 `file-navigation.json`:
5
+ Agent 发布自己的产物:
32
6
 
33
7
  ```bash
34
- ec pa-workspace navigation show
35
-
36
- ```
37
-
38
- 该命令**只输出 JSON**,`--format json` / `--json` 可加但无区别。
39
-
40
- ## 2. 格式
41
-
42
- `file-navigation.json` 顶层:
43
-
44
- ```json
45
- {
46
- "version": 1,
47
- "entries": []
48
- }
49
-
8
+ ec team navigation update --upsert-json '[{"id":"report","title":"报告","path":"output/report.md","kind":"file","order":30}]'
50
9
  ```
51
10
 
52
- `--entries-json` 只接收 `entries` 数组,`version` 由命令维护。
53
-
54
- ### 2.1 完整 Schema
55
-
56
- Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
57
- 其余字段被静默丢弃 —— 写错字段名不会报错,只会无声失效。
58
-
59
- ```json
60
- {
61
- "$schema": "https://json-schema.org/draft/2020-12/schema",
62
- "$id": "urn:evol:schema:file-navigation:v1",
63
- "title": "PA workspace file navigation v1",
64
- "type": "object",
65
- "additionalProperties": false,
66
- "required": ["version", "entries"],
67
- "properties": {
68
- "version": { "const": 1 },
69
- "entries": {
70
- "type": "array",
71
- "maxItems": 200,
72
- "items": { "$ref": "#/$defs/entry" }
73
- }
74
- },
75
- "$defs": {
76
- "entry": {
77
- "type": "object",
78
- "additionalProperties": false,
79
- "required": ["path", "kind"],
80
- "properties": {
81
- "id": {
82
- "type": "string",
83
- "minLength": 1,
84
- "maxLength": 200,
85
- "description": "稳定标识。省略时由 path 的 sha256 前缀自动生成。改名必须保留原 id。"
86
- },
87
- "title": {
88
- "type": "string",
89
- "minLength": 1,
90
- "maxLength": 200,
91
- "description": "展示名。省略时回落为 path 的最后一段。"
92
- },
93
- "path": {
94
- "type": "string",
95
- "minLength": 1,
96
- "maxLength": 2048,
97
- "description": "工作区根下的相对路径。反斜杠会被归一化为 /。拒绝绝对路径、冒号、NUL、.. 段,以及任何以 . 开头的路径段和 capture/_manifest。"
98
- },
99
- "kind": {
100
- "enum": ["file", "directory"],
101
- "description": "必须与真实目标类型一致;目标不存在且 availability=unavailable 时按声明值保留。"
102
- },
103
- "order": {
104
- "type": "integer",
105
- "minimum": 0,
106
- "maximum": 1000000,
107
- "description": "升序展示。省略时回落为数组下标。"
108
- },
109
- "icon": {
110
- "type": "string",
111
- "minLength": 1,
112
- "maxLength": 100,
113
- "description": "语义图标名。超长截断而非报错;不认识的图标 App 用默认图标。"
114
- },
115
- "availability": {
116
- "enum": ["available", "unavailable"],
117
- "default": "available"
118
- },
119
- "reason": {
120
- "type": "string",
121
- "minLength": 1,
122
- "maxLength": 500,
123
- "description": "availability=unavailable 时必填。超长截断。"
124
- }
125
- }
126
- }
127
- }
128
- }
129
-
130
- ```
131
-
132
- ### 2.2 字段行为细节
133
-
134
- | 字段 | 省略时 | 校验失败时 |
135
- | --- | --- | --- |
136
- | id | 由 path 自动生成 pa-<sha256前16位> | 重复 ID → INVALID_ARGUMENT |
137
- | title | 回落 path 最后一段 | 超 200 字符 → INVALID_ARGUMENT |
138
- | path | 不可省略 | 绝对路径/冒号/../隐藏段 → INVALID_ROOT_PATH |
139
- | kind | 不可省略 | 与真实目标不一致 → INVALID_ARGUMENT |
140
- | order | 回落数组下标 | 非 0..1000000 整数 → INVALID_ARGUMENT |
141
- | icon | 无图标 | 超 100 字符截断,不报错 |
142
- | availability | available | 非法值 → INVALID_ARGUMENT |
143
- | reason | — | unavailable 却没给 → INVALID_ARGUMENT |
144
-
145
- 额外规则:
146
-
147
- - `entries` 最多 200 项。
148
- - `id` 不能重复,`path` 也不能重复,两者分别查重。
149
- - 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
150
- - 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
151
- - `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
152
-
153
- ### 2.3 隐藏路径的判据
154
-
155
- 任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
156
- 所以 `output/reports` 可以,`output/.cache/reports` 和 `.assistant/state` 不行。
157
-
158
- ## 3. 怎么改
159
-
160
- ### 3.1 先读,再写
11
+ Agent 删除入口:
161
12
 
162
13
  ```bash
163
- ec pa-workspace navigation show
164
-
14
+ ec team navigation update --remove-ids-json '["report"]'
165
15
  ```
166
16
 
167
- 拿到当前的 `navigationRevision`。
168
-
169
- ### 3.2 完整替换,不是局部 patch
17
+ 完整替换只用于有意重建导航:
170
18
 
171
19
  ```bash
172
- ec pa-workspace navigation update \
173
- --expected-revision 3 \
174
- --entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10},{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20}]'
175
-
176
- ```
177
-
178
- - `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
179
- - `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
180
- 重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
181
- - 成功后 `navigationRevision` 加 1,返回新状态。
182
-
183
- ### 3.3 先发布入口、后创建目录
184
-
185
- 目标还没建好时,用 `unavailable` 占位:
186
-
187
- ```json
188
- {"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20,"availability":"unavailable","reason":"目录尚未创建"}
189
-
20
+ ec team navigation update --replace-json '[{"id":"output","title":"团队产物","path":"output","kind":"directory","order":20}]'
190
21
  ```
191
22
 
192
- 目录建好后再次 update 改为 `available`。
193
-
194
- ### 3.4 隐藏入口
195
-
196
- 从 `entries` 数组里**移除**即可。不要用 `unavailable` 假装隐藏 —— 那会留一个带原因的可见入口。
197
-
198
- ## 4. 常见任务
199
-
200
- | 用户说 | 怎么做 |
201
- | --- | --- |
202
- | "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
203
- | "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
204
- | "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
205
- | "把 X 入口藏起来" | 从数组移除 X → update |
206
- | "让 B 助理那边也显示我的报告" | 在 B 的工作区执行 update,指到 B 自己可见的路径 |
207
- | "把我另一个助理的周报放进来看" | 当前版本不支持,见 §6 |
208
-
209
- ## 5. 自检清单
210
-
211
- 改完逐条确认:
212
-
213
- - [ ] 保留的入口都在新数组里(完整替换语义)
214
-
215
- - [ ] `id` 没重复,改名时 ID 未变
216
-
217
- - [ ] `path` 没重复
218
-
219
- - [ ] `path` 不含冒号、绝对路径前缀、`..` 段
220
-
221
- - [ ] `path` 没有以 `.` 开头的段,也没命中 `capture/_manifest`
222
-
223
- - [ ] `kind` 与实际目标是目录还是文件一致
224
-
225
- - [ ] `unavailable` 的入口都带了 `reason`
226
-
227
- - [ ] 用 `ec pa-workspace navigation show` 复核结果
228
-
229
- ## 6. 当前版本不支持跨 Agent 入口
230
-
231
- 一个 PA 的导航**只能指向自己工作区里的文件**。
232
-
233
- 不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
234
- Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
235
- 既不报错也不生效 —— 你会以为配置成功了,实际入口指向的还是自己。
236
-
237
- 跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
238
- 由各自 PA 在自己的导航里发布。
239
-
240
- ## 7. 不能做的事
241
-
242
- - 不要把这份数据叫 `manifest` —— 会和 EvolCore 已有的 manifest 体系混淆。
243
- - 不要把主机绝对路径、IP、端口写进导航。
244
- - 不要在导航里放短期凭证。凭证由 Core 在读取时另行签发。
245
- - 不要指望 App 按入口 ID 写死专用页面。`id` 只用于稳定关联,不影响能否打开。
246
- - 不要修改 `pa-workspace-state.json` 的 `workspaceId`、`ownerAid`、`rootPath`。
247
- 改绑定用 `ec pa-workspace bind --workspace "<新路径>"`。
248
- - 本命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用。
249
-
250
- ## 8. 点开后发生什么
251
-
252
- App 按 `kind` 和实际文件格式决定展示方式:
253
-
254
- | 格式 | 展示 |
255
- | --- | --- |
256
- | Markdown | Markdown 阅读页,相对链接和图片可解析 |
257
- | 静态 HTML | 静态文档阅读,保留版式与相对 CSS/图片,脚本被移除 |
258
- | 纯文本 | 等宽文本 |
259
- | JSON / JSONL / YAML | 按文本展示 |
260
- | 图片 / 音频 / 视频 / PDF | 有预览能力则预览,否则显示"不支持预览" |
261
- | 未知二进制 | 文件信息 |
262
-
263
- **新增产物只要落在通用阅读能力内,就不需要 App 发版。**
264
-
265
- ## 9. 相关
266
-
267
- - `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
268
- - 文件读取协议:`menu-protocol.md` 的 file 段
269
- - 工作区目录规范:`personal-assistant` Skill
270
-
271
- ## 10. 设计背景(仅源码仓库)
272
-
273
- 以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
274
- 完成导航操作不需要读它们,仅在参与开发时参考:
23
+ 命令默认读取 `navigationRevision`,也可以用 `--expected-revision` 做 compare-and-swap。冲突时重新执行 `ec team navigation show`,合并后再提交。入口路径只能是绑定工作区内的相对路径,Core 会验证真实路径、类型、符号链接和隐藏运行时目录。
275
24
 
276
- | 文档 | 内容 |
277
- | --- | --- |
278
- | docs/personal-assistant/workspace-browser-v1/schema.json | evol.pa-workspace 导航响应的正式 JSON Schema(与本文的写入格式不同) |
279
- | docs/personal-assistant/13-cross-agent-artifact-navigation.md | 跨 Agent 入口的设计、双端实施清单、权限边界 |
25
+ `team-workspace` Menu 仅限当前 Agent Owner 的 AUN 私聊。App 使用返回的短期 `fileRoot.rootId` 读取已发布路径;Root 不返回宿主绝对路径,成员列表也不授予其他 Agent 的读取权限。
@@ -1,4 +1,4 @@
1
- # ec fs — AUN 文件系统
1
+ # ec fs — AUN 文件系统
2
2
 
3
3
  `ec fs` 是个人空间和群空间的统一文件入口。群空间也用 `ec fs`,没有 `ec group fs`。
4
4
 
@@ -124,7 +124,8 @@ ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authori
124
124
  个人存储内联读取携带预算加一字节的探测范围;HTTP 下载逐块计数,超限立即中止,
125
125
  单次 HTTP 读取最多等待 30 秒。文件大小元数据不能替代实际读取校验;非文本内容只返回有界摘要。
126
126
  需要更大文件时使用 `ec fs cp` 下载,不将大文件直接塞入会话上下文。
127
- 它适合 Ability 的 L1/L3 契约读取;不满足这些条件时使用 `ec storage download` 回退。
127
+ 此命令读取 AUN storage 对象路径。Ability 的 L1 索引固定读取 `/ability/index.json`;
128
+ L3 契约则按 Ability 索引中的精确 `detail_ref` 读取。
128
129
 
129
130
  托管 `ec fs` 对非 self 目标先读取并验证远端 `agent.md`,再按 `type` 选择 personal 或 group 后端:只有
130
131
  `type: group` 使用 group fs,而且普通托管任务只能访问当前 AUN 群;其它类型使用 personal storage,
@@ -2,7 +2,7 @@
2
2
 
3
3
  群聊场景下收发消息、管理群与成员。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
4
4
 
5
- 以自己的 AID 为发送者(`<from>`),群 AID 为 `<group-id>`。
5
+ **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`;宿主终端用 `--from <本端AID>`)。本页其余 `ec group` 命令只用于群管理,不用于发消息。
6
6
 
7
7
  本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
8
8
 
@@ -266,7 +266,7 @@ ec group mention <from> <group-id> --clear
266
266
  - `--format json` — 对支持结构化结果的子命令输出 JSON
267
267
  - `--app <name>` — 仅 `pull` / `ack` 指定独立消费 slot
268
268
  - `--aun-path <path>` — 指定 AUN keystore 根
269
- - `--encrypt` — 仅 send,启用端到端加密(群聊默认明文)
269
+ - `--encrypt yes|no|auto` — 仅 send(`ecmsg send`),默认 `auto`:被对端消息触发时沿用该消息的状态,主动发起时明文
270
270
  - `create` 会通过 SDK 自动生成并导入群 `group_aid` 身份。
271
271
  - 默认群名遇到明确的身份占用错误时最多尝试 5 次;显式指定的名称不会自动更换,超时或身份导入失败也不会换名重建。
272
272
  - 创建结果以服务端返回的 `group_aid` 为准;与请求不一致时输出提示,JSON 结果包含 `warning` 和 `requested_group_aid`。
@@ -21,6 +21,8 @@
21
21
 
22
22
  relation 是所有记忆的唯一出生地,agent 级和 owner 级都由它升格而来。
23
23
 
24
+ `ownerAid` 只有一个来源:归属协议共识(`ownerResolver.primaryOwner`)。`promote` / `forget` 写入的目录、整理会话的可写根、上下文里 owner 索引注入的路径都按同一个 AID 解析;名录快照里的 Owner 只做交叉核对,两边不一致时会在守护进程日志里告警,避免记忆写进一个 owner 的目录、读的时候去另一个 owner 的目录找。
25
+
24
26
  ## 整理什么时候启动
25
27
 
26
28
  | 触发 | 说明 |
@@ -176,7 +176,7 @@
176
176
 
177
177
  | 字段 | 类型 | 默认 | 作用 |
178
178
  |---|---|---|---|
179
- | `pre_tool_1stmsgchk` | boolean | `true` | 意图表达门禁:每条新消息计数重置为 15,每轮结束后有意图表达成功则清零否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ec msg/group send |
179
+ | `pre_tool_1stmsgchk` | boolean | `true` | 意图表达门禁:每条新消息计数重置为 15,每轮结束后有意图表达成功则清零否则 +1。计数 = 15 时全部放行并提示下一轮要先表达意图,≥ 16 时只放行 ecmsg send |
180
180
  | `tool_use_reminder` | boolean | `true` | 意图表达门禁与队列提醒:开启意图表达门禁(规则同 pre_tool_1stmsgchk),同时保留队列未读提醒 |
181
181
 
182
182
  - schema 里的 `default` 即**运行时出厂默认**——宿主组装 `modeConfig` 时先铺这层默认(`coordinator.schemaDefaults`),再叠用户显式桶值;flow 层不再硬编码默认。
@@ -5,6 +5,27 @@
5
5
 
6
6
  Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协议**,与 AUN SDK 本身无关。任何能发送 AUN 消息的客户端,只要按照本文约定的 payload 格式发送,都可以与 EvolCore daemon 交互。对应实现:`src/core/command/menu-protocol.ts`、`src/aun/menu/`。
7
7
 
8
+ > 2026-11-08:设置页混合批量查询使用 `menu.query name="menu" args.view="queries"`。单批 1~32 项,每项使用 `itemId/name/args`,可用 `argsFrom` 引用前项结果;最多 6 个并发,逐项鉴权、逐项返回。支持 role(capabilities/target/role/requester)、agent、baseagent、activity、effort、model、chatmode、team-workspace members。`agent.data.safeConfig.baseagentSkills === true` 可替代查询该字段的 CLI action。members 仍仅允许当前 Agent Owner 的 AUN 私聊。以下示例发送到目标 Agent AID 的 AUN 私聊。
9
+
10
+ ```json
11
+ {
12
+ "type": "menu.query",
13
+ "id": "settings-batch-001",
14
+ "name": "menu",
15
+ "args": {
16
+ "view": "queries",
17
+ "schemaVersion": 1,
18
+ "items": [
19
+ { "itemId": "agent", "name": "agent" },
20
+ { "itemId": "model", "name": "model", "args": { "scope": "agent" } },
21
+ { "itemId": "members", "name": "team-workspace", "args": { "view": "members", "managementVersion": 1 } }
22
+ ]
23
+ }
24
+ }
25
+ ```
26
+
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
+
8
29
  ---
9
30
 
10
31
  ## 一、传输层约定
@@ -2,14 +2,16 @@
2
2
 
3
3
  私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询。
4
4
 
5
+ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`);协议语义见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。本文维护消息命令参数和请求查询行为。
6
+
5
7
  ## Agent 会话中的 Shell 调用边界
6
8
 
7
- 在 EvolCore 托管会话中,每次工具调用只能执行一条完整的 `ec` 命令。禁止把
9
+ 在 EvolCore 托管会话中,每次工具调用只能执行一条完整的命令。禁止把
8
10
  `command -v`、`ec aid`、`&&`、`||`、`;`、`|`、重定向、子 shell、`bash -lc` 或其它脚本
9
- 和 `ec msg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
11
+ 和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
10
12
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
11
13
 
12
- 发送统一入口是 `ecmsg send`。本端恒为当前会话本端,不写 `<from>`;目标三种说法:
14
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端;目标三种说法:
13
15
 
14
16
  | 目标 | 写法 |
15
17
  |---|---|
@@ -17,7 +19,17 @@
17
19
  | 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
18
20
  | 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
19
21
 
20
- `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。宿主终端没有会话上下文,使用 `ec msg send <from> <to> '<text>'`。
22
+ `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
23
+
24
+ **话题内投给自己**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。回执会标 `to=<本端AID>(自发) recipient=self`。
25
+
26
+ 宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
27
+
28
+ ```bash
29
+ ecmsg send '<text>' --from <本端AID> --thread <话题id> --to <对端或本端AID>
30
+ ```
31
+
32
+ `--self` 已不再被接受(本端只由 `--from` 表达)。
21
33
 
22
34
  ## 发送消息
23
35
 
@@ -55,7 +67,7 @@ ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s -
55
67
  ecmsg send '<text>' --return none
56
68
  ```
57
69
 
58
- `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊 `msg send`,不能同时提供位置文本。
70
+ `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊发送(`ecmsg send`),不能同时提供位置文本。
59
71
  Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
60
72
  最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
61
73
  在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
@@ -65,6 +77,10 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
65
77
  每一行都必须单独执行,且是该次 shell 调用中的唯一命令。
66
78
 
67
79
  发送相关选项:
80
+ - `--to <对端ID>` — 指定对端(群 AID 或对方 AID,按关系判定类型);省略表示当前会话对端/群
81
+ - `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
82
+ - `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
83
+ - `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
68
84
  - `--text-from-file <path>` — 从文件读取文本(UTF-8),用于超长消息或避免 Shell 转义
69
85
  - `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
70
86
  - `--encrypt` — 端到端加密
@@ -97,9 +113,12 @@ ec peer unblock <target-aid> --self <self-aid>
97
113
 
98
114
  发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
99
115
 
100
- 非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
116
+ 非托管环境的 `ecmsg send`(带 `--from`)不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断;自发消息也不进联系人准入。
101
117
 
102
- 在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认只允许回复当前对端;要联系当前对端以外的对象,必须通过话题路由:先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用 `ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
118
+ 在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
119
+ 要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),
120
+ 或先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用
121
+ `ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送(`--check-every` 可省略)。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
103
122
 
104
123
  成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
105
124
 
@@ -157,7 +176,7 @@ ec msg request get <self-aid> <request-id> --format json
157
176
  > 正文写法:含空格/换行/特殊字符时用引号包起来;纯短词可不包,但多空格会被压成一个。
158
177
  > 正文恰好以 `--` 开头:带空格的(如 `"--file 是正文"`)会被正确识别为正文;
159
178
  > 若正文**精确等于**某个 flag 名(如要发送文本 `--encrypt`),用 `--` 分隔:
160
- > `ec msg send <from> <to> -- --encrypt`
179
+ > `ecmsg send -- --encrypt`
161
180
 
162
181
  ## 拉取消息
163
182
 
@@ -35,7 +35,7 @@ ec provider sync [--format json]
35
35
  `ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
36
36
 
37
37
  1. 复用初始化界面的本机基座导入机制,扫描 Claude、Codex、Gemini 和 ecagent 的本机连接;只导入具有有效密钥的来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
38
- 2. 将可识别域名的 Provider ID 转为稳定八位格式,同步 defaults、Agent 和 relation 配置内的 Provider/fallback 引用;冻结初始化计划不修改,通过旧 ID aliases 兼容。
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 会清除。
41
41
 
@@ -45,10 +45,30 @@ ec provider sync [--format json]
45
45
 
46
46
  变量未设置或为空返回 `PROVIDER_ENV_BASE_URL_MISSING`;URL 无效、包含嵌套环境变量、认证信息、查询串或片段返回 `PROVIDER_ENV_BASE_URL_INVALID`,均不落盘。已声明 domain 与实际地址不匹配时也拒绝。固化后环境变量变化不会自动改动该 Provider;修改地址须显式更新配置。返回 `materializedBaseUrls` 表示本次解析的环境变量地址数量,不回显实际地址。普通启动迁移保持原有行为,不自动展开环境变量。
47
47
 
48
- 提交前对受影响配置加锁、验证未被其他写入者改动,并备份。提交中写入失败会回滚,异常中断由启动迁移恢复。输出只包含导入来源、ID/aliases、待处理项、全局选择、变更数量和备份位置,不回显密钥。宿主控制终端或 trusted fullaccess 任务可执行;普通 DaemonOwner 托管只读授权不允许执行此命令。
48
+ 提交前对受影响配置加锁、验证未被其他写入者改动,并通过统一配置快照保存迁移前版本。提交中写入失败会回滚,异常中断由启动迁移恢复。输出只包含导入来源、ID/aliases、待处理项、全局选择、变更数量和备份版本号,不回显密钥。JSON 的 backup 现为统一快照版本(如 v100),不再是独立迁移备份目录。宿主控制终端或 trusted fullaccess 任务可执行;普通 DaemonOwner 托管只读授权不允许执行此命令。
49
49
 
50
50
  同域旧条目迁移冲突时,`PROVIDER_CONFLICT` 提示列出冲突 Provider ID、域名及字段,例如 `common.apiKey`、`services.text.path`、`services.text.models`;JSON 的 `data.kind=provider_migration_conflict`,并提供 `providerIds`、`domain`、`fields`。仅报告字段名,不返回密钥、请求头、查询参数、端点路径或模型设置的值。凭据按配置原文比较,环境变量引用与静态密钥不同不代表实际密钥一定不同。发生冲突不落盘,需核对这些字段后再同步,不自动选边覆盖。
51
51
 
52
+ ## 启动迁移收尾
53
+
54
+ 纯 CLI `ec init` 在完成 Baseagent 选择与默认配置保存后,扫描检测到的基座并自动导入有效的本机 Provider 连接;同域沿用服务合并规则,不覆盖已有凭据和模型设置。已有可用选择优先保留,否则绑定本次导入或注册表中适用的 Provider;来源缺失、导入冲突或最终仍无可用连接时输出脱敏提醒。非交互 JSON 输出在 `providers.imported` / `providers.warnings` 提供结果,不输出密钥。此步骤不等同于 `ec provider sync`,不强制切换默认基座或模型。
55
+
56
+ `ec init --web` 不执行终端侧 Baseagent 扫描或 Provider 自动导入;这些步骤由网页初始化流程负责。终端仍检查并准备启动所需的主机控制 AID,不停止或重启已运行的 daemon。
57
+
58
+ 本机 Provider 合并导入和 ECWEB 草稿导入合并旧条目时,立即升级为域名稳定 ID,并在同一快照及事务中迁移配置引用;冻结初始化计划保持不变,通过运行时绑定迁移。在线暂留旧 ID 别名,到下次成功启动后清理。哈希碰撞、重复域名无法安全归并或并发修改时拒绝提交,不覆盖其他条目。历史内嵌连接迁移新增 Provider 时也直接生成稳定 ID;同域不兼容的凭据不再通过递增编号绕过冲突。
59
+
60
+ 启动时,在加载 Agent 前恢复未完成的迁移事务,再更新全局默认、Agent、关系配置和 fallback,以及初始化记录和 ECWeb 创建工作流中的运行时 Provider 绑定。初始化原始 plan、fingerprint、创建凭据和请求 ID 保持不变,避免破坏重试与恢复的一致性。统一配置快照已覆盖初始化记录和 ECWeb 创建状态,迁移前版本包含全部受影响文件,而非仅 providers.json。
61
+
62
+ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保留清理由现有 ec config 快照机制统一管理;既有历史迁移备份保留不动。短期事务日志仅用于本次操作的失败回滚和中断恢复,成功提交后删除。若 configSnapshots=false,不创建版本备份,在线 sync 返回 CONFIG_SNAPSHOTS_DISABLED 告警,启动迁移也记录告警,但事务日志回滚仍启用;快照开启但写入失败则在修改配置前中止。
63
+
64
+ 新快照记录扩展后的文件范围;恢复到尚未收录初始化状态的历史快照时,不因这些文件缺席而删除当前初始化状态。新快照则能够恢复这些文件的内容或原本不存在的状态。
65
+
66
+ 引用更新与 aliases 清理作为同一事务提交,providers.json 最后写入。配置无法读取、迁移冲突或并发写入时拒绝提交;提交失败回滚,异常中断由下次启动恢复。成功后旧 ID 不再可用;重复启动无变更时不产生新备份。外部脚本应改用固定 ID,历史备份不重写。启动收尾不导入本机连接、不修改默认基座或模型,也不展开环境变量。
67
+
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。模型目录查询与推理使用相同的运行时命名规则。
69
+
70
+ 修复的备份和中断恢复记录保存在 rollout 相邻的 `.provider-repair/` 目录(完整目录名为 `<rollout文件名>.provider-repair`)。文件替换与 SQLite 提交之间发生中断时,下次恢复会先核对记录并完成同步;检测到较新的文件或索引、无法释放的运行时、不匹配的身份或不支持的存储格式时停止并报告原因,不覆盖数据或更换 thread。这里只处理 EC 已绑定的会话;模型输入在修复及恢复校验完成后提交。
71
+
52
72
  ## 完整对象示例
53
73
 
54
74
  ~~~json
@@ -73,7 +93,7 @@ Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去
73
93
 
74
94
  常见错误: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 不在线)。
75
95
 
76
- 升级时在启动阶段备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过 aliases 兼容。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
96
+ 升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
77
97
 
78
98
  不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
79
99
 
@@ -34,18 +34,18 @@ ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
34
34
 
35
35
  | 模式 id | 显示名 | 场景 | 用途 |
36
36
  |---------|--------|------|------|
37
- | `single-session` | 单会话模式 | 私聊/群聊 | 单会话直接处理;具体投递方式由 `chatmode` 的 `interactive` / `proactive` / `paactive` 决定 |
37
+ | `single-session` | 单会话模式 | 私聊/群聊 | 单会话直接处理;具体投递方式由 `chatmode` 的 `interactive` / `proactive` 决定 |
38
38
 
39
39
  当前注册表只内置 `single-session`。历史的 `interactive` / `proactive` 已合并为该模式下的
40
40
  `chatmode` 流程,不再是可传给 `ec response set` 的 mode id。
41
41
 
42
- `paactive` 是 PA 私聊的展示分支:它复用 interactive 的执行流、ECK manifest/vars、工具、文件、审批/提问和 notify;模型公开文本(含最终文本)改为 AUN `activity.item.kind=text`,正式回复须经托管 `ecmsg send`。它不使用 proactive 的工具表态门禁或 thought.put,只在 active AUN 人类 Owner 私聊主会话与话题生效。群聊不支持 interactive/paactive,固定使用 proactive。
42
+ 聊天模式仅有 interactive/proactive。PA 与其他 Agent 共用 proactive 的执行流、工具门禁、ECK manifest/vars、文件、审批/提问及现有 notify,不增加专用模式或配置选项。
43
43
 
44
- 可由目标私聊的 `/chatmode paactive`、Menu 或 Agent `chatmode.private` 配置选择。关系级写入要求已有 `targetKind=private` 的 AUN 关系;`chatmode.group` 只允许 proactive。旧 schema 保存的 group=interactive 读取时按 proactive 兼容,新写入会被拒绝。配置变更对下一任务生效,当前运行任务保持原模式。
44
+ 在 active AUN 人类 Owner 私聊主会话及话题中,若当前 Agent 是名录指定的个人助理,且名录 Owner 与当前 Ownership 共识一致,则该轮 proactive activity 通过可靠 activity outbox 使用 message.send 投递,payload.type=activity,普通模型文本位于 item 中。其他 proactive 场景继续使用 thought.put,包括非 PA、群聊、第三方私聊、辅助会话及 PA 身份无法确认的情况。PA Team 普通成员不等于个人助理。投递方式在任务开始时确定,身份变化对下一任务生效。
45
45
 
46
- paactive 的 `show_activities=all/text/none` 保持原显示设置:`all` 展示过程文本和工具活动,`text` 展示过程文本,`none` 隐藏中间过程;最终模型文本均投影为 activity。activity 投递失败不会降级成普通回复。
46
+ 正式回复始终由托管 ecmsg send 显式发送;activity 发送失败不会降级为普通文本消息。群聊固定 proactive;当前 schema 拒绝写入 interactive 群聊配置,已发布旧 schema 的 group=interactive 仅在读取时归一为 proactive。
47
47
 
48
- proactive 也遵守 `show_activities`:`all` 投递全部 thought,`text` 只投递模型文本,`none` 不投递 thought(含最终模型文本)。未显式配置时,群聊默认 `none`,私聊默认 `all`;显式配置仍按关系 > Agent > defaults 覆盖。群聊通过 Menu 或 `ec config` 调整,私聊也可使用 `/activity all|text|none`。本地任务活动记录、正式 `ec msg/group send` 和任务状态通知不受此参数影响。
48
+ proactive 遵守 `show_activities`:`all` 投递全部活动,`text` 只投递模型文本,`none` 不投递活动(含最终模型文本);这些活动根据上述条件走 message.send 或 thought.put。未显式配置时,群聊默认 `none`,私聊默认 `all`;显式配置仍按关系 > Agent > defaults 覆盖。群聊通过 Menu 或 `ec config` 调整,私聊也可使用 `/activity all|text|none`。本地任务活动记录、正式 `ecmsg send` 和任务状态通知不受此参数影响。
49
49
 
50
50
  ## 作用域(越具体越优先:关系 > agent > 全局)
51
51