evolcore 0.0.43-test.3 → 0.0.43-test.5

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 (192) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/bin/ecmsg.js +492 -0
  3. package/bin/install-codex-managed-hooks.mjs +130 -8
  4. package/dist/ability/application-service.js +37 -0
  5. package/dist/ability/resources.js +28 -0
  6. package/dist/ability/runtime.js +6 -1
  7. package/dist/agents/claude-runner.js +7 -5
  8. package/dist/agents/codex/app-server-client.js +0 -12
  9. package/dist/agents/codex-runner.js +12 -54
  10. package/dist/agents/ecagent-runner.js +130 -35
  11. package/dist/aun/aid/agentmd.js +56 -12
  12. package/dist/aun/aid/control-aid.js +15 -0
  13. package/dist/aun/aid/identity.js +8 -0
  14. package/dist/aun/aid/ownership-operation.js +12 -3
  15. package/dist/aun/menu/client.js +8 -7
  16. package/dist/aun/menu/index.js +1 -1
  17. package/dist/aun/menu/transport.js +8 -5
  18. package/dist/aun/service-proxy.js +3 -0
  19. package/dist/channels/aun.js +56 -22
  20. package/dist/channels/daemon.js +12 -4
  21. package/dist/cli/agent-command.js +5 -0
  22. package/dist/cli/agent-create.js +32 -8
  23. package/dist/cli/agent.js +9 -3
  24. package/dist/cli/aid-bind-command.js +3 -0
  25. package/dist/cli/aun-commands.js +12 -5
  26. package/dist/cli/code-stats.js +451 -213
  27. package/dist/cli/ctl-command.js +1 -3
  28. package/dist/cli/daemon-commands.js +42 -21
  29. package/dist/cli/directory.js +7 -8
  30. package/dist/cli/ecmsg-gateway.js +204 -0
  31. package/dist/cli/getmeta-command.js +2 -1
  32. package/dist/cli/index.js +6 -0
  33. package/dist/cli/init.js +58 -18
  34. package/dist/cli/provider-command.js +82 -5
  35. package/dist/cli/restart-monitor.js +11 -19
  36. package/dist/cli/stats.js +8 -1
  37. package/dist/cli/task-context.js +3 -0
  38. package/dist/cli/trigger-command.js +20 -14
  39. package/dist/config/boot-log.js +23 -2
  40. package/dist/config/config-field-policy.js +2 -0
  41. package/dist/config/config-manager.js +13 -17
  42. package/dist/config/daemon-services.js +1 -0
  43. package/dist/config/peer-role-resolver.js +6 -6
  44. package/dist/config/provider-identity-migration.js +202 -0
  45. package/dist/config/provider-identity.js +37 -0
  46. package/dist/config/provider-ipc-service.js +40 -3
  47. package/dist/config/provider-local-sync.js +153 -0
  48. package/dist/config/providers-config.js +32 -4
  49. package/dist/config/providers-management.js +144 -68
  50. package/dist/config/providers.js +4 -1
  51. package/dist/config/role-schema.js +3 -3
  52. package/dist/config/schema-migration.js +188 -3
  53. package/dist/core/agent-application-service.js +11 -0
  54. package/dist/core/agent-ipc-registration.js +2 -0
  55. package/dist/core/agent-runtime.js +45 -11
  56. package/dist/core/auth/auth-gateway.js +8 -6
  57. package/dist/core/auth/delegation-diagnostics.js +6 -2
  58. package/dist/core/auth/operation-authorizer.js +5 -2
  59. package/dist/core/auth/operation-catalog.js +6 -4
  60. package/dist/core/baseagent-loader.js +11 -3
  61. package/dist/core/bootstrap-service.js +8 -0
  62. package/dist/core/channel-loader.js +61 -23
  63. package/dist/core/command/agent-control.js +4 -1
  64. package/dist/core/command/chatmode-config.js +46 -0
  65. package/dist/core/command/cli-intent-parser.js +2 -1
  66. package/dist/core/command/command-handler.js +16 -20
  67. package/dist/core/command/daemon-diagnostics.js +2 -1
  68. package/dist/core/command/menu-catalog.js +1 -1
  69. package/dist/core/command/menu-handler.js +16 -16
  70. package/dist/core/command/menu-protocol.js +4 -2
  71. package/dist/core/command/provider-menu.js +4 -2
  72. package/dist/core/command/role-menu.js +2 -2
  73. package/dist/core/command/slash-handler.js +56 -42
  74. package/dist/core/daemon-lifecycle.js +35 -17
  75. package/dist/core/event-catalog.js +19 -0
  76. package/dist/core/evolagent-registry.js +3 -0
  77. package/dist/core/handoff/runtime.js +9 -3
  78. package/dist/core/initialization/service.js +4 -3
  79. package/dist/core/ipc-registration.js +6 -0
  80. package/dist/core/message/aun-ipc-sender.js +81 -3
  81. package/dist/core/message/im-renderer.js +24 -19
  82. package/dist/core/message/message-admission.js +13 -2
  83. package/dist/core/message/response-engine.js +40 -41
  84. package/dist/core/message/send-options.js +40 -0
  85. package/dist/core/message/send-routing.js +310 -0
  86. package/dist/core/model/model-capabilities.js +37 -0
  87. package/dist/core/model/model-catalog.js +6 -2
  88. package/dist/core/ownership/owner-resolver.js +117 -14
  89. package/dist/core/permission/ec-command-parser.js +195 -27
  90. package/dist/core/permission/readonly-shell-query.js +66 -7
  91. package/dist/core/permission/tool-error-code.js +13 -1
  92. package/dist/core/permission/tool-policy.js +74 -20
  93. package/dist/core/plugin-lifecycle.js +6 -2
  94. package/dist/core/relation/pa-team.js +7 -2
  95. package/dist/core/relation/same-owner-proof.js +131 -0
  96. package/dist/core/session/session-idle-monitor.js +94 -16
  97. package/dist/core/session/session-manager.js +69 -16
  98. package/dist/core/thread/thread-route.js +5 -2
  99. package/dist/directory/owner-directory-cache.js +690 -99
  100. package/dist/directory/owner-directory-markdown.js +146 -36
  101. package/dist/directory/owner-directory-query-operation.js +7 -9
  102. package/dist/directory/owner-directory-scope.js +12 -0
  103. package/dist/directory/owner-directory-search.js +5 -1
  104. package/dist/directory/owner-directory-store.js +28 -0
  105. package/dist/ecweb/basic-settings-service.js +15 -1
  106. package/dist/ecweb/message-context-service.js +2 -2
  107. package/dist/ecweb/providers-service.js +3 -1
  108. package/dist/ecweb/runtime/lifecycle.js +38 -5
  109. package/dist/ecweb/runtime/supervisor.js +157 -49
  110. package/dist/index.js +202 -38
  111. package/dist/paths.js +2 -1
  112. package/dist/proxy/manager.js +2 -0
  113. package/dist/proxy/service-supervisor.js +379 -143
  114. package/dist/response-system/engines/v1/proactive-flow.js +4 -0
  115. package/dist/trigger/application-service.js +1 -0
  116. package/dist/trigger/audit.js +3 -2
  117. package/dist/trigger/authorization.js +2 -3
  118. package/dist/trigger/event-source.js +4 -0
  119. package/dist/trigger/feedback.js +26 -2
  120. package/dist/trigger/history.js +4 -3
  121. package/dist/trigger/ipc-service.js +24 -19
  122. package/dist/trigger/manager.js +3 -5
  123. package/dist/trigger/parser.js +4 -21
  124. package/dist/trigger/patch.js +3 -15
  125. package/dist/trigger/scheduler.js +48 -13
  126. package/dist/trigger/system-definitions.js +2 -2
  127. package/dist/trigger/validation.js +4 -13
  128. package/dist/utils/autostart.js +2 -2
  129. package/dist/utils/cross-platform.js +36 -8
  130. package/dist/utils/error-utils.js +8 -0
  131. package/dist/utils/macos-autostart.js +31 -0
  132. package/dist/utils/model-prices.jsonl +15 -8
  133. package/dist/utils/process-introspect.js +21 -1
  134. package/dist/utils/public-suffix.js +5811 -0
  135. package/dist/utils/startup-trace.js +7 -1
  136. package/dist/utils/windows-autostart.js +42 -7
  137. package/ecagent/dist/harness/compaction/branch-summarization.js +1 -1
  138. package/ecagent/dist/harness/compaction/compaction.js +4 -4
  139. package/ecagent/dist/harness/env/nodejs.js +46 -2
  140. package/kits/docs/aun/ABILITY_CALLING.md +3 -3
  141. package/kits/docs/channels/aun.md +1 -1
  142. package/kits/docs/channels/feishu.md +2 -2
  143. package/kits/docs/context-assembly.md +20 -4
  144. package/kits/docs/evolcore/INDEX.md +3 -2
  145. package/kits/docs/evolcore/agent.md +2 -2
  146. package/kits/docs/evolcore/aid.md +8 -2
  147. package/kits/docs/evolcore/ctl.md +13 -4
  148. package/kits/docs/evolcore/directory.md +48 -15
  149. package/kits/docs/evolcore/file-navigation.md +63 -49
  150. package/kits/docs/evolcore/group.md +6 -6
  151. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  152. package/kits/docs/evolcore/menu-protocol.md +33 -3
  153. package/kits/docs/evolcore/model.md +5 -3
  154. package/kits/docs/evolcore/msg.md +28 -27
  155. package/kits/docs/evolcore/provider.md +39 -5
  156. package/kits/docs/evolcore/response.md +3 -1
  157. package/kits/docs/evolcore/thread-chain.md +12 -14
  158. package/kits/docs/evolcore/tool-authorization.md +21 -1
  159. package/kits/docs/evolcore/trigger.md +12 -9
  160. package/kits/docs/identity/ROLE_DETAIL.md +1 -1
  161. package/kits/docs/prompt-loading-architecture.md +30 -20
  162. package/kits/eck_manifest.auxiliary.json +5 -5
  163. package/kits/eck_manifest.json +28 -49
  164. package/kits/eck_manifest.memory.json +18 -18
  165. package/kits/rules/01-overview.md +43 -45
  166. package/kits/rules/02-navigation.md +44 -53
  167. package/kits/rules/03-identity.md +21 -25
  168. package/kits/rules/04-relation.md +23 -33
  169. package/kits/rules/05-venue.md +24 -25
  170. package/kits/rules/06-channel.md +3 -3
  171. package/kits/schemas/_meta.json +20 -27
  172. package/kits/schemas/agent-config.schema.19.json +10 -6
  173. package/kits/schemas/providers.schema.2.json +74 -0
  174. package/kits/schemas/relation-config.schema.12.json +2 -2
  175. package/kits/schemas/role-config.schema.2.json +5 -5
  176. package/kits/schemas/role-registry.schema.1.json +1 -1
  177. package/kits/skills/ec-agent-create/SKILL.md +1 -0
  178. package/kits/skills/ec-service-proxy/SKILL.md +3 -0
  179. package/kits/skills/ec-trigger/SKILL.md +4 -4
  180. package/kits/skills/ec-trigger/references/examples.md +1 -1
  181. package/kits/templates/system-fragments/channel.md +5 -5
  182. package/kits/templates/system-fragments/commands.md +3 -2
  183. package/kits/templates/system-fragments/directory-contacts.md +10 -3
  184. package/kits/templates/system-fragments/identity.md +0 -1
  185. package/kits/templates/system-fragments/personal-assistant.md +22 -3
  186. package/kits/templates/system-fragments/reply.md +47 -28
  187. package/kits/templates/system-fragments/session.md +2 -9
  188. package/kits/templates/system-fragments/thread.md +5 -5
  189. package/package.json +17 -13
  190. package/kits/schemas/agent-config.schema.20.json +0 -925
  191. package/kits/schemas/relation-config.schema.13.json +0 -289
  192. package/kits/schemas/role-config.schema.3.json +0 -1038
@@ -1,36 +1,38 @@
1
1
  # PA 工作区入口导航:agent 操作手册
2
2
 
3
- 个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
3
+ 个人助理(PA)自己的工作区产物,通过一份**入口导航**暴露给 Evol App 的头像入口。
4
4
  新增一个产物目录要给用户看到,改导航即可,不需要 App 发版。
5
5
 
6
- 本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
6
+ 本文是给 agent 读的完整操作手册:文件在哪、格式是什么、怎么安全地改。
7
7
  **本文自包含**,按本文即可完成导航的增删改,不需要读其他文档。
8
8
 
9
9
  ## 1. 文件在哪
10
10
 
11
11
  ```text
12
- $AGENT_DATA_DIR/<自己的 AID>/pa-workspace-state.json
12
+ $AGENT_DATA_DIR/pa-workspace-state.json
13
+
13
14
  ```
14
15
 
15
- 其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
16
+ 其中 `rootPath` 是本机绝对路径,**永远不会发给 App**。
16
17
  被导航指向的真实文件在 PA 工作区里(`capture/`、`output/` 等),导航只存"指向哪里",不存内容。
17
18
 
18
19
  ### 1.1 三个名字指同一份数据
19
20
 
20
21
  | 名字 | 指什么 |
21
22
  | --- | --- |
22
- | `pa-workspace-state.json` | 磁盘上的完整状态:绑定信息(`workspaceId`/`ownerAid`/`rootPath`)+ `navigationRevision` + `entries` |
23
- | `file-navigation.json` | **导航内容本身**,即 `{version, entries}` 这部分。协议与设计文档里的叫法 |
24
- | `--entries-json` | 命令参数,取值就是 `file-navigation.json` 的 `entries` 数组 |
23
+ | pa-workspace-state.json | 磁盘上的完整状态:绑定信息(workspaceId/ownerAid/rootPath)+ navigationRevision + entries |
24
+ | file-navigation.json | 导航内容本身,即 {version, entries} 这部分。协议与设计文档里的叫法 |
25
+ | --entries-json | 命令参数,取值就是 file-navigation.json 的 entries 数组 |
25
26
 
26
- **改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
27
- 递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
27
+ **改导航一律用命令**,把 `entries` 数组整体传给 `--entries-json`。命令会校验、
28
+ 递增 `navigationRevision`、做并发保护,并对每个入口做真实路径检查。
28
29
  手工编辑 `pa-workspace-state.json` 会跳过全部这些保护。
29
30
 
30
31
  导出当前导航为 `file-navigation.json`:
31
32
 
32
33
  ```bash
33
34
  ec pa-workspace navigation show
35
+
34
36
  ```
35
37
 
36
38
  该命令**只输出 JSON**,`--format json` / `--json` 可加但无区别。
@@ -44,13 +46,14 @@ ec pa-workspace navigation show
44
46
  "version": 1,
45
47
  "entries": []
46
48
  }
49
+
47
50
  ```
48
51
 
49
52
  `--entries-json` 只接收 `entries` 数组,`version` 由命令维护。
50
53
 
51
54
  ### 2.1 完整 Schema
52
55
 
53
- Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
56
+ Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读取下列字段,
54
57
  其余字段被静默丢弃 —— 写错字段名不会报错,只会无声失效。
55
58
 
56
59
  ```json
@@ -123,32 +126,33 @@ Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读
123
126
  }
124
127
  }
125
128
  }
129
+
126
130
  ```
127
131
 
128
132
  ### 2.2 字段行为细节
129
133
 
130
134
  | 字段 | 省略时 | 校验失败时 |
131
135
  | --- | --- | --- |
132
- | `id` | 由 `path` 自动生成 `pa-<sha256前16位>` | 重复 ID → `INVALID_ARGUMENT` |
133
- | `title` | 回落 `path` 最后一段 | 超 200 字符 → `INVALID_ARGUMENT` |
134
- | `path` | **不可省略** | 绝对路径/冒号/`..`/隐藏段 → `INVALID_ROOT_PATH` |
135
- | `kind` | **不可省略** | 与真实目标不一致 → `INVALID_ARGUMENT` |
136
- | `order` | 回落数组下标 | 非 `0..1000000` 整数 → `INVALID_ARGUMENT` |
137
- | `icon` | 无图标 | 超 100 字符截断,不报错 |
138
- | `availability` | `available` | 非法值 → `INVALID_ARGUMENT` |
139
- | `reason` | — | `unavailable` 却没给 → `INVALID_ARGUMENT` |
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 |
140
144
 
141
145
  额外规则:
142
146
 
143
- - `entries` 最多 200 项。
144
- - `id` 不能重复,`path` 也不能重复,两者分别查重。
145
- - 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
146
- - 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
147
- - `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
147
+ - `entries` 最多 200 项。
148
+ - `id` 不能重复,`path` 也不能重复,两者分别查重。
149
+ - 排序是 `order` 升序 → `title` 本地化字典序 → `path` 字典序,不只是 `order`。
150
+ - 目标不存在时,必须显式 `availability: "unavailable"` + `reason`,否则返回 `NOT_FOUND`。
151
+ - `path` 的反斜杠会被**替换**成 `/` 并归一化,不是报错;但归一化后不能命中隐藏路径。
148
152
 
149
153
  ### 2.3 隐藏路径的判据
150
154
 
151
- 任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
155
+ 任何一个路径段以 `.` 开头即被拒绝,`capture/_manifest` 也拒绝。
152
156
  所以 `output/reports` 可以,`output/.cache/reports` 和 `.assistant/state` 不行。
153
157
 
154
158
  ## 3. 怎么改
@@ -157,6 +161,7 @@ Draft 2020-12。`additionalProperties: false` 是**实质约束**:Core 只读
157
161
 
158
162
  ```bash
159
163
  ec pa-workspace navigation show
164
+
160
165
  ```
161
166
 
162
167
  拿到当前的 `navigationRevision`。
@@ -167,12 +172,13 @@ ec pa-workspace navigation show
167
172
  ec pa-workspace navigation update \
168
173
  --expected-revision 3 \
169
174
  --entries-json '[{"id":"reports","title":"报告","path":"output/reports","kind":"directory","order":10},{"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20}]'
175
+
170
176
  ```
171
177
 
172
- - `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
173
- - `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
174
- 重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
175
- - 成功后 `navigationRevision` 加 1,返回新状态。
178
+ - `--entries-json` 必须是**完整数组**。要保留的入口必须一并传回,否则等于删除。
179
+ - `--expected-revision` 是数值并发校验。revision 已变则返回 `CONFLICT`:
180
+ 重新 `show`、合并用户仍要保留的入口、再提交。**不要**覆盖并发修改。
181
+ - 成功后 `navigationRevision` 加 1,返回新状态。
176
182
 
177
183
  ### 3.3 先发布入口、后创建目录
178
184
 
@@ -180,6 +186,7 @@ ec pa-workspace navigation update \
180
186
 
181
187
  ```json
182
188
  {"id":"travel","title":"旅行计划","path":"output/travel","kind":"directory","order":20,"availability":"unavailable","reason":"目录尚未创建"}
189
+
183
190
  ```
184
191
 
185
192
  目录建好后再次 update 改为 `available`。
@@ -192,46 +199,53 @@ ec pa-workspace navigation update \
192
199
 
193
200
  | 用户说 | 怎么做 |
194
201
  | --- | --- |
195
- | "加一个旅行计划入口" | 确认 `output/travel/` 存在(不存在则先建,或标 `unavailable`)→ 追加 entry → update |
196
- | "把报告放到最前面" | 把该 entry 的 `order` 调成比其他都小 → update |
197
- | "把'报告'改名叫'周报'" | 只改 `title`,**保留原 `id` 和 `path`** → update |
202
+ | "加一个旅行计划入口" | 确认 output/travel/ 存在(不存在则先建,或标 unavailable)→ 追加 entry → update |
203
+ | "把报告放到最前面" | 把该 entry 的 order 调成比其他都小 → update |
204
+ | "把'报告'改名叫'周报'" | 只改 title,保留原 id 和 path → update |
198
205
  | "把 X 入口藏起来" | 从数组移除 X → update |
199
- | "让 B 助理那边也显示我的报告" | 在 **B** 的工作区执行 update,指到 B 自己可见的路径 |
200
- | "把我另一个助理的周报放进来看" | **当前版本不支持**,见 §6 |
206
+ | "让 B 助理那边也显示我的报告" | 在 B 的工作区执行 update,指到 B 自己可见的路径 |
207
+ | "把我另一个助理的周报放进来看" | 当前版本不支持,见 §6 |
201
208
 
202
209
  ## 5. 自检清单
203
210
 
204
211
  改完逐条确认:
205
212
 
206
213
  - [ ] 保留的入口都在新数组里(完整替换语义)
214
+
207
215
  - [ ] `id` 没重复,改名时 ID 未变
216
+
208
217
  - [ ] `path` 没重复
218
+
209
219
  - [ ] `path` 不含冒号、绝对路径前缀、`..` 段
220
+
210
221
  - [ ] `path` 没有以 `.` 开头的段,也没命中 `capture/_manifest`
222
+
211
223
  - [ ] `kind` 与实际目标是目录还是文件一致
224
+
212
225
  - [ ] `unavailable` 的入口都带了 `reason`
226
+
213
227
  - [ ] 用 `ec pa-workspace navigation show` 复核结果
214
228
 
215
229
  ## 6. 当前版本不支持跨 Agent 入口
216
230
 
217
231
  一个 PA 的导航**只能指向自己工作区里的文件**。
218
232
 
219
- 不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
220
- Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
233
+ 不要尝试写 `source` / `uri` / `fs://` 之类的字段来指向别的 Agent:
234
+ Core 的入口校验只读取 §2.2 列出的字段,**未知字段会被静默丢弃**,
221
235
  既不报错也不生效 —— 你会以为配置成功了,实际入口指向的还是自己。
222
236
 
223
- 跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
237
+ 跨 Agent 聚合仍在设计中,落地后本文会同步更新。在此之前,跨 Agent 的产物
224
238
  由各自 PA 在自己的导航里发布。
225
239
 
226
240
  ## 7. 不能做的事
227
241
 
228
- - 不要把这份数据叫 `manifest` —— 会和 EvolCore 已有的 manifest 体系混淆。
229
- - 不要把主机绝对路径、IP、端口写进导航。
230
- - 不要在导航里放短期凭证。凭证由 Core 在读取时另行签发。
231
- - 不要指望 App 按入口 ID 写死专用页面。`id` 只用于稳定关联,不影响能否打开。
232
- - 不要修改 `pa-workspace-state.json` 的 `workspaceId`、`ownerAid`、`rootPath`。
233
- 改绑定用 `ec pa-workspace bind --workspace "<新路径>"`。
234
- - 本命令只在当前 Agent 与其 Owner 的 AUN 私聊托管会话中可用。
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 私聊托管会话中可用。
235
249
 
236
250
  ## 8. 点开后发生什么
237
251
 
@@ -250,16 +264,16 @@ App 按 `kind` 和实际文件格式决定展示方式:
250
264
 
251
265
  ## 9. 相关
252
266
 
253
- - `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
254
- - 文件读取协议:`menu-protocol.md` 的 file 段
255
- - 工作区目录规范:`personal-assistant` Skill
267
+ - `ec pa-workspace init` / `bind`:初始化与更换工作区,见本目录 `pa-workspace.md`
268
+ - 文件读取协议:`menu-protocol.md` 的 file 段
269
+ - 工作区目录规范:`personal-assistant` Skill
256
270
 
257
271
  ## 10. 设计背景(仅源码仓库)
258
272
 
259
- 以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
273
+ 以下文档**只在 EvolCore 源码仓库里**,不随 npm 包发布,安装后的机器上打不开。
260
274
  完成导航操作不需要读它们,仅在参与开发时参考:
261
275
 
262
276
  | 文档 | 内容 |
263
277
  | --- | --- |
264
- | `docs/personal-assistant/workspace-browser-v1/schema.json` | `evol.pa-workspace` 导航**响应**的正式 JSON Schema(与本文的写入格式不同) |
265
- | `docs/personal-assistant/13-cross-agent-artifact-navigation.md` | 跨 Agent 入口的设计、双端实施清单、权限边界 |
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 入口的设计、双端实施清单、权限边界 |
@@ -15,13 +15,13 @@
15
15
 
16
16
  ```bash
17
17
  # 文本(含空格/换行/特殊字符时用引号包起来;纯短词可不包,但多空格会被压成一个)
18
- ec group send <from> <group-id> '<text>' [--encrypt]
18
+ ecmsg send '<text>' [--encrypt yes|no|auto] # 在群会话里即群内公开发送
19
19
 
20
20
  # 文件(--as image|video|voice|file)
21
- ec group send <from> <group-id> --file <path> [--as <type>] [--text '<说明>']
21
+ ecmsg send --file <path> [--as <type>] [--text '<说明>']
22
22
 
23
23
  # 自定义 payload
24
- ec group send <from> <group-id> --payload '<json>'
24
+ ecmsg send --payload '<json>'
25
25
 
26
26
  # 查询本地群历史(只读,不调用 Gateway,不推进 group pull/ack 游标)
27
27
  ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format json]
@@ -38,13 +38,13 @@ ec group ack <from> <group-id> <seq> [--app <name>]
38
38
  - `--mention-all` — @ 所有人
39
39
 
40
40
  ```bash
41
- ec group send <from> <group-id> '@bob 看下 PR' --mention 'bob.agentid.pub'
42
- ec group send <from> <group-id> '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
41
+ ecmsg send '@bob 看下 PR' --mention 'bob.agentid.pub'
42
+ ecmsg send '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
43
43
  ```
44
44
 
45
45
  > 正文恰好以 `--` 开头:带空格的(如 `"--file 是正文"`)会被正确识别为正文;
46
46
  > 若正文**精确等于**某个 flag 名(如要发送文本 `--encrypt`),用 `--` 分隔:
47
- > `ec group send <from> <group-id> -- --encrypt`
47
+ > `ecmsg send -- --encrypt`
48
48
 
49
49
  发送选项还包括:
50
50
 
@@ -304,7 +304,7 @@ daemon 按整理会话的模式校验 `--scope`:
304
304
 
305
305
  ## 十、session.md 的注入
306
306
 
307
- 整理会话也加载 `$KITS_FRAGMENTS/session.md`,但其中的 proactive 行为约束(群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`ec group send` / `ec msg send` 语法速查)**不会渲染**。
307
+ 整理会话也加载 `$KITS_FRAGMENTS/session.md`,但其中的 proactive 行为约束(群聊要不要响应、首次调用工具前先发言、每 N 次调用汇报进展、`ecmsg send` 语法速查)**不会渲染**。
308
308
 
309
309
  原因:整理会话由触发器创建,`peerType` 是 `system`、`chatType` 是 `private`。`resolveChatModeForPeer` 对 system 对端有硬约束,返回 `interactive`,而 proactive 那段的条件是 `{{?chatMode=proactive}}`,所以整块跳过。已实测确认。
310
310
 
@@ -14,6 +14,7 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
14
14
  | 参数 | 值 | 说明 |
15
15
  |------|-----|------|
16
16
  | `to` | daemon control AID | 目标 daemon 的 AID |
17
+ | `message_class` | `control` | Menu 是应用控制协议,使用独立 control 消息流;不使用 SDK 内部的 `sdk_control` |
17
18
  | `encrypt` | `true` | 必须 E2EE 加密 |
18
19
  | `ttl` | `60` | 秒,短生命周期 |
19
20
  | `payload` | menu request 对象 | 见下方消息类型 |
@@ -235,9 +236,38 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
235
236
 
236
237
  主机 Agent 初始化通过 `menu.action`、`name="agent"`、`action="initialize"` 调用。参数可平铺在
237
238
  `args` 中,也可放入 `args.plan`;`aid` 必须与计划中的 AID 一致。`project` 可省略或为空,Core 会按普通
238
- Agent 创建规则解析主机默认项目;显式项目路径优先。可选的 `model` 必须存在于主机当前 baseagent 的可见模型
239
- 目录;指定非 `auto` 的 `effort` 时必须同时指定 `model`,且强度必须在当前模型目录支持的范围内。
240
- `effort="auto"` 不写入强度覆盖。远程调用沿用现有控制面权限校验。
239
+ Agent 创建规则解析主机默认项目;显式项目路径优先。可选的 `provider` 用于固定所选 `baseagent` 的 Provider,
240
+ 可放在 `args.provider` 或 `args.plan.provider`;同时提供时 `plan.provider` 优先。Provider 必须支持该 Base Agent,
241
+ 并会随冻结计划持久化。可选的 `model` 必须存在于所选 Provider(未指定 Provider 时为当前默认 Provider)的可见模型目录;
242
+ 指定非 `auto` 的 `effort` 时必须同时指定 `model`,且强度必须在当前模型目录支持的范围内。`effort="auto"`
243
+ 不写入强度覆盖。远程调用沿用现有控制面权限校验。
244
+
245
+ 示例:
246
+
247
+ ```json
248
+ {
249
+ "type": "menu.action",
250
+ "id": "<uuid>",
251
+ "name": "agent",
252
+ "action": "initialize",
253
+ "args": {
254
+ "plan": {
255
+ "aid": "helper.agentid.pub",
256
+ "project": "C:/agents/helper",
257
+ "baseagent": "codex",
258
+ "provider": "gateway",
259
+ "ownerAid": "owner.agentid.pub",
260
+ "name": "Helper",
261
+ "description": "协助处理项目开发任务",
262
+ "type": "agent",
263
+ "tags": ["coding"]
264
+ }
265
+ }
266
+ }
267
+ ```
268
+
269
+ `action="create"` 的旧式创建入口同样可在 `args.provider` 指定 Provider;`initialize: true` 一步初始化入口也接受
270
+ 该字段。Provider 必须支持 `args.baseagent`;未指定时沿用当前配置解析规则。
241
271
 
242
272
  失败后用同一 action 和 `{ aid, resume: true }` 恢复已保存计划。恢复不接受新计划字段,只使用原操作主体、AID
243
273
  和持久化计划;其他主体无法接管。
@@ -68,12 +68,14 @@ ec model check [--self <aid>]
68
68
 
69
69
  | Base agent | 执行与统计的处理方式 |
70
70
  |------------|--------------------|
71
- | Claude Code | 由参数表解析窗口,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
72
- | ecagent | 由参数表设置模型对象的 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
71
+ | Claude Code | 使用统一能力解析器读取模型目录与本地参数,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
72
+ | ecagent | 从本次请求的 Provider 模型目录解析 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
73
73
  | Codex | 优先使用 app-server 实时窗口;缺窗口时仅用参数表补齐统计,不修改 Codex 的执行窗口或压缩配置 |
74
74
  | Gemini | 执行窗口和压缩仍交给 Gemini CLI 管理,不从参数表注入执行参数 |
75
75
 
76
- Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 有效参数表记录 → runner 原有硬编码兜底。
76
+ Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 当前 Provider 模型目录 → 有效参数表记录 → runner 原有保守兜底。输出上限独立按目录 → 本地参数 → 兜底解析。统一解析器支持运行时报告窗口优先校正;没有实际报告时不猜测模型容量。
77
77
  ecagent 发给网关的模型 ID 不携带窗口后缀。Codex 没有实时窗口且参数表也无记录时,不虚构通用窗口。
78
78
 
79
+ ecagent 自动压缩阈值为 `min(650000, contextWindow - max(压缩预留, 输出上限, 安全预留))`,安全预留为窗口的 5%(最多 10000),阈值至少为 1。压缩预留使用 harness 的实际默认设置(16384)。统计中的 `autoCompactTokens` 与 harness 使用同一阈值,`contextWindowSource` 和运行日志区分目录、本地参数、显式后缀及保守兜底;没有参数的未知模型回退到 128k,不代表模型官方上限。
80
+
79
81
  模型理论窗口与网关、团队的请求额度是不同限制;查表得到 1M 窗口,不代表可以突破团队的 200K 请求上限。
@@ -9,42 +9,50 @@
9
9
  和 `ec msg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
10
10
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
11
11
 
12
- 以自己的 AID 为发送者(`<from>`),对端 AID 为 `<to>`。
12
+ 发送统一入口是 `ecmsg send`。本端恒为当前会话本端,不写 `<from>`;目标三种说法:
13
+
14
+ | 目标 | 写法 |
15
+ |---|---|
16
+ | 当前会话的对端/群(默认) | `ecmsg send '<text>'` |
17
+ | 指定话题 | `ecmsg send '<text>' --thread <话题id>` |
18
+ | 指定对端 | `ecmsg send '<text>' --to <对端ID>` |
19
+
20
+ `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。宿主终端没有会话上下文,使用 `ec msg send <from> <to> '<text>'`。
13
21
 
14
22
  ## 发送消息
15
23
 
16
24
  长文本内联参数统一约定:普通命令调用不变;将字面量 `\n`、`\r`、`\t`、`\\` 分别按一次解码为换行、回车、制表符、反斜杠。Shell 已传入的真实换行保持原样;不要使用 PowerShell 的反引号换行转义,它会在 CLI 之前改变 argv。Windows PowerShell 请调用命令名,不要显式调用批处理入口传物理多行。仅解码正文和文本选项(`--description`、`--text`、`--transcript`、`--handoff-context`);文件内容、路径、`--payload` JSON、标题均不解码。审批仍按 Shell 传入的原始 argv 校验。
17
25
 
18
26
  ```bash
19
- # 文本(明文)
20
- ec msg send <from> <to> '<text>'
27
+ # 文本
28
+ ecmsg send '<text>'
21
29
 
22
30
  # 从文件读取文本内容(用于超长消息或避免 Shell 转义)
23
- ec msg send <from> <to> --text-from-file <path>
31
+ ecmsg send --text-from-file <path>
24
32
 
25
- # 文本(密文 E2EE)
26
- ec msg send <from> <to> '<text>' --encrypt
33
+ # 端到端加密(三态:yes 密文 / no 明文 / auto 跟随,默认 auto)
34
+ ecmsg send '<text>' --encrypt yes
27
35
 
28
- # 强制明文(同时出现时优先于 --encrypt)
29
- ec msg send <from> <to> '<text>' --no-encrypt
36
+ # 强制明文
37
+ ecmsg send '<text>' --encrypt no
30
38
 
31
39
  # 文件:--as 可选 image|video|voice|file(默认按扩展名推断)
32
- ec msg send <from> <to> --file <path> [--as <type>]
40
+ ecmsg send --file <path> [--as <type>] [--text '<说明>']
33
41
 
34
42
  # 链接卡片
35
- ec msg send <from> <to> --link <url> [--title '<title>'] [--description '<desc>']
43
+ ecmsg send --link <url> [--title '<title>'] [--description '<desc>']
36
44
 
37
45
  # 自定义 payload(JSON)
38
- ec msg send <from> <to> --payload '<json>'
46
+ ecmsg send --payload '<json>'
39
47
 
40
48
  # 从 UTF-8 文件读取自定义 payload(避免 Windows Shell 破坏 JSON 引号)
41
- ec msg send <from> <to> --payload-file <path>
49
+ ecmsg send --payload-file <path>
42
50
 
43
51
  # 发送自定义 payload 并等待关联结果
44
- ec msg send <from> <to> --payload '<json>' --return required --timeout 60s --format json
52
+ ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s --format json
45
53
 
46
54
  # 单向发送,不建立结果关联
47
- ec msg send <from> <to> --payload '<json>' --return none
55
+ ecmsg send '<text>' --return none
48
56
  ```
49
57
 
50
58
  `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊 `msg send`,不能同时提供位置文本。
@@ -80,20 +88,20 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
80
88
 
81
89
  托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
82
90
 
83
- 托管会话主动执行 `ec msg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
91
+ 托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
84
92
  `declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
85
93
 
86
94
  ```bash
87
95
  ec peer unblock <target-aid> --self <self-aid>
88
96
  ```
89
97
 
90
- `ec group send` 走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
98
+ 发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
91
99
 
92
100
  非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
93
101
 
94
- 在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member` 默认只允许回复当前对端;要联系当前对端以外的对象,必须通过话题路由:先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用 `ec msg send '<text>' --thread <threadId> --check-every <时长>` 发送;from/to 由话题推断,无需手写。不带 `--thread` 直接改目标会被拒绝。`--check-every` 到期后,系统会向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 在自己的上下文里决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功 JSON 回执(含 `message_id`/`status`)不得声称已发送。
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`)不得声称已发送。
95
103
 
96
- 成功输出:`✓ 已发送 <message_id> seq=<n> status=<status>`
104
+ 成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
97
105
 
98
106
  ## 请求/响应等待与异步查询
99
107
 
@@ -232,13 +240,6 @@ ec msg history <self-aid> <target-aid> \
232
240
  加密策略:
233
241
  - 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
234
242
  - 对端发来明文消息时,默认明文回复
235
- - 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
236
-
237
- ## 在当前会话中快速回复(备选)
243
+ - 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
238
244
 
239
- 仅当无法使用 `ec msg send` 时(如拿不到自己的 AID),可用 `ec ctl send`,它自动继承当前会话的 AID 和对端:
240
-
241
- ```bash
242
- ec ctl send '<text>'
243
- ec ctl send --encrypt '<text>'
244
- ```
245
+ `ecmsg send` 默认等价于 `--encrypt auto`:被对端消息触发时沿用该消息的加密状态,主动发起时明文。
@@ -1,6 +1,6 @@
1
1
  # ec provider — 宿主 Provider 注册表
2
2
 
3
- 管理 daemon 级 providers.json;单数命令 provider,没有 providers 别名。宿主控制终端须经 daemon 控制凭据授权;托管任务只有通过 daemon 验证的 trusted fullaccess 执行身份可管理 Provider。普通 Agent owner/admin 或 Owner+bypass 不等于 DaemonOwner,也不能单凭这些身份管理进程级 Provider。daemon 必须在线;帮助无需 daemon 或配置。
3
+ 管理 daemon 级 providers.json;单数命令 provider,没有 providers 别名。宿主控制终端须经 daemon 控制凭据授权;经 daemon 验证为 DaemonOwner 的托管任务无需 fullaccess 即可执行 list/show,只读结果仍脱敏。托管写操作仍要求 daemon 验证的 trusted fullaccess 执行身份。普通 Agent owner/admin 或 Owner+bypass 不等于 DaemonOwner,也不能单凭这些身份管理进程级 Provider。daemon 必须在线;帮助无需 daemon 或配置。
4
4
 
5
5
  ## 命令集
6
6
 
@@ -11,22 +11,52 @@ ec provider create --file <path> [--format json]
11
11
  ec provider import --file <path> [--format json]
12
12
  ec provider update <provider-id> --file <path> [--format json]
13
13
  ec provider delete <provider-id> [--format json]
14
+ ec provider sync [--format json]
14
15
  ~~~
15
16
 
16
- - list/show 返回完整脱敏配置和 revision;API key、headers、queryParams 中的凭据不回显。
17
+ - 默认输出可读文本:list 为列表,show 为分层配置详情,create/import/update/delete 为操作结果,sync 为同步摘要(导入、别名、引用更新、默认选择、待处理项、告警和备份)。`--format json` 保留完整 `{ ok, data }` 或 `{ ok, code, error, data? }` 响应,供脚本使用。失败退出码非零。
18
+ - list 显示 ID、名称、域名和服务类型;show 展示脱敏配置,两者均显示 revision。API key、headers、queryParams 中的凭据不回显;完整脱敏注册表可用 `list --format json` 获取。
17
19
  - create/update 的文件必须是单个完整 Provider 对象;update 仅替换已存在的 ID,不是字段 patch 或 upsert。
18
- - import 还接受只有一项的 Provider ID 映射或 providers 包装。每次仅导入一个 Provider,忽略源 ID、始终生成新 provider-N;不自动覆盖或合并。
20
+ - import 还接受只有一项的 Provider ID 映射或 providers 包装。保存时按规范化完整 hostname 生成稳定的 `provider-` 八位数字 ID;同域配置进入冲突/合并流程,不会因当前环境重新编号。
19
21
  - 文件为 UTF-8(可带 BOM),不超过 1 MiB。CLI 将绝对路径交给 daemon 读取,不在 argv 传递 JSON 或凭据;无 --text 参数。
20
22
  - update 中的 <redacted> 保留对应旧凭据;省略字段表示清除。create/import 不接受脱敏占位符。
21
23
  - delete 遇到 defaults、Agent 或 relation 的 Provider/fallback 引用时拒绝,返回非敏感引用路径;没有 force/级联删除。配置损坏或引用目录不可读时也拒绝删除。
22
24
 
25
+ ## 托管查询的命令边界
26
+
27
+ 在托管 Codex 会话中,直接执行独立的 `ec provider list --format json` 或 `ec provider show <provider-id> --format json`。
28
+ 不要将查询嵌入 PowerShell 赋值、管道或多语句脚本,例如 `$result = ec provider list --format json | ConvertFrom-Json`。
29
+ 无法安全解析并绑定到实际 EC 参数的复合命令会在执行前拒绝,需拆成独立工具调用;Shell 审批通过不等于内部 EC 调用已获得单次审批。
30
+
31
+ 会话进入新任务后,同一命令仍需当前任务的审批。`approval_not_found` 表示当前命令缺少匹配审批;历史任务的同命令审批不会将新任务误报为 `task_revoked`,也不会被复用授权。
32
+
33
+ ## 本机扫描与统一配置
34
+
35
+ `ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
36
+
37
+ 1. 复用初始化界面的本机基座导入机制,扫描 Claude、Codex、Gemini 和 ecagent 的本机连接;只导入具有有效密钥的来源。同域沿用原有导入合并规则,保留已存在的凭据和服务设置,补充缺少的服务。
38
+ 2. 将可识别域名的 Provider ID 转为稳定八位格式,同步 defaults、Agent 和 relation 配置内的 Provider/fallback 引用;冻结初始化计划不修改,通过旧 ID aliases 兼容。
39
+ 3. 仅将全局 defaults 的 `active_baseagent` 改为 `ecagent`;不覆盖已有 Agent 的显式基座或模型选择。
40
+ 4. 若注册表存在 `provider-96659517`,从其适用于 ecagent 的实时模型目录选择已启用、已列出的 `deepseek…flash` 模型;多个版本按模型 ID 的数字版本降序选择,例如 `deepseek-v4.1-flash` 优先于 `deepseek-v4-flash`。写入全局 `baseagents.ecagent.provider/model`,不写入拼错的 `deekseek` 或通配符字面量。与新模型不兼容的全局 effort 会清除。
41
+
42
+ 若首选 Provider 不存在,保留原有 ecagent 选择并返回 `PREFERRED_PROVIDER_NOT_FOUND`;仍执行导入、ID 迁移及全局基座切换。首选 Provider 存在但没有 ecagent/text 服务、模型目录无法获取或没有符合条件的模型,则整次操作失败,不落盘。没有可导入来源时返回 `NO_LOCAL_PROVIDER_SOURCES`,仍处理已有注册表。
43
+
44
+ 同步时,已有和导入 Provider 的 `common.baseUrl` 若为 `$VAR` 或 `${VAR}`,读取 daemon 当前进程的环境变量,将完整实际 HTTP(S) URL(含协议、端口、路径)固化到 `common.baseUrl`,保存规范化完整域名,再计算稳定 ID。端口与路径不参与 ID 计算;密钥等其他环境变量引用保持原状。已有同域条目须先通过凭据和服务端点兼容检查,不兼容则整次失败,不覆盖。
45
+
46
+ 变量未设置或为空返回 `PROVIDER_ENV_BASE_URL_MISSING`;URL 无效、包含嵌套环境变量、认证信息、查询串或片段返回 `PROVIDER_ENV_BASE_URL_INVALID`,均不落盘。已声明 domain 与实际地址不匹配时也拒绝。固化后环境变量变化不会自动改动该 Provider;修改地址须显式更新配置。返回 `materializedBaseUrls` 表示本次解析的环境变量地址数量,不回显实际地址。普通启动迁移保持原有行为,不自动展开环境变量。
47
+
48
+ 提交前对受影响配置加锁、验证未被其他写入者改动,并备份。提交中写入失败会回滚,异常中断由启动迁移恢复。输出只包含导入来源、ID/aliases、待处理项、全局选择、变更数量和备份位置,不回显密钥。宿主控制终端或 trusted fullaccess 任务可执行;普通 DaemonOwner 托管只读授权不允许执行此命令。
49
+
50
+ 同域旧条目迁移冲突时,`PROVIDER_CONFLICT` 提示列出冲突 Provider ID、域名及字段,例如 `common.apiKey`、`services.text.path`、`services.text.models`;JSON 的 `data.kind=provider_migration_conflict`,并提供 `providerIds`、`domain`、`fields`。仅报告字段名,不返回密钥、请求头、查询参数、端点路径或模型设置的值。凭据按配置原文比较,环境变量引用与静态密钥不同不代表实际密钥一定不同。发生冲突不落盘,需核对这些字段后再同步,不自动选边覆盖。
51
+
23
52
  ## 完整对象示例
24
53
 
25
54
  ~~~json
26
55
  {
27
56
  "name": "Example",
57
+ "domain": "api.example.com",
28
58
  "common": {
29
- "baseUrl": "https://example.test/v1",
59
+ "baseUrl": "https://api.example.com/v1",
30
60
  "apiKey": "$EXAMPLE_API_KEY"
31
61
  },
32
62
  "services": { "text": {} }
@@ -35,11 +65,15 @@ ec provider delete <provider-id> [--format json]
35
65
 
36
66
  apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
37
67
 
68
+ Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。静态 `baseUrl` 自动推导 domain;若 `baseUrl` 是环境变量引用,必须显式填写 domain,且运行时地址必须匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
69
+
38
70
  ## 输出与并发
39
71
 
40
72
  文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
41
73
 
42
- 常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
74
+ 常见错误: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
+
76
+ 升级时在启动阶段备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过 aliases 兼容。旧环境变量地址未声明 domain、localhost 或 IP 地址暂保留旧 ID,并报告待处理;不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
43
77
 
44
78
  不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
45
79
 
@@ -39,12 +39,14 @@ ec response config set <key> <value> --mode <mode-id> --self <aid> [--peer <X>]
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`,正式回复须经托管 `ec msg send`。它不使用 proactive 的工具表态门禁或 thought.put,只在 active AUN 人类 Owner 私聊主会话与话题生效。群聊不支持 interactive/paactive,固定使用 proactive。
42
+ `paactive` 是 PA 私聊的展示分支:它复用 interactive 的执行流、ECK manifest/vars、工具、文件、审批/提问和 notify;模型公开文本(含最终文本)改为 AUN `activity.item.kind=text`,正式回复须经托管 `ecmsg send`。它不使用 proactive 的工具表态门禁或 thought.put,只在 active AUN 人类 Owner 私聊主会话与话题生效。群聊不支持 interactive/paactive,固定使用 proactive。
43
43
 
44
44
  可由目标私聊的 `/chatmode paactive`、Menu 或 Agent `chatmode.private` 配置选择。关系级写入要求已有 `targetKind=private` 的 AUN 关系;`chatmode.group` 只允许 proactive。旧 schema 保存的 group=interactive 读取时按 proactive 兼容,新写入会被拒绝。配置变更对下一任务生效,当前运行任务保持原模式。
45
45
 
46
46
  paactive 的 `show_activities=all/text/none` 保持原显示设置:`all` 展示过程文本和工具活动,`text` 展示过程文本,`none` 隐藏中间过程;最终模型文本均投影为 activity。activity 投递失败不会降级成普通回复。
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` 和任务状态通知不受此参数影响。
49
+
48
50
  ## 作用域(越具体越优先:关系 > agent > 全局)
49
51
 
50
52
  | 参数 | 作用域 | 落盘 |