evolcore 0.0.43-test.6 → 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 (197) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/bin/ecmsg.js +171 -54
  3. package/dist/agents/baseagent-availability.js +1 -1
  4. package/dist/agents/codex/app-server-client.js +22 -0
  5. package/dist/agents/codex-runner.js +69 -2
  6. package/dist/aun/msg/p2p.js +6 -1
  7. package/dist/channels/aun.js +234 -21
  8. package/dist/cli/agent-create.js +2 -2
  9. package/dist/cli/daemon-commands.js +6 -66
  10. package/dist/cli/daemon-lifecycle-client.js +61 -0
  11. package/dist/cli/ecmsg-gateway.js +35 -2
  12. package/dist/cli/events-command.js +73 -0
  13. package/dist/cli/index.js +31 -14
  14. package/dist/cli/invoke-command.js +182 -0
  15. package/dist/cli/managed-command-guard.js +6 -1
  16. package/dist/cli/restart-monitor.js +45 -47
  17. package/dist/cli/services-command.js +111 -0
  18. package/dist/cli/team-workspace-command.js +134 -0
  19. package/dist/cli/thread-command.js +6 -2
  20. package/dist/cli/watch-msg.js +1 -1
  21. package/dist/config/config-field-policy.js +2 -2
  22. package/dist/config/config-manager.js +0 -7
  23. package/dist/config/invoke-ipc-service.js +118 -0
  24. package/dist/config/schema-migration.js +6 -1
  25. package/dist/config-store.js +2 -1
  26. package/dist/core/agent-reload-coordinator.js +6 -4
  27. package/dist/core/agent-runtime.js +104 -10
  28. package/dist/core/auth/delegation-authorization.js +66 -0
  29. package/dist/core/auth/operation-catalog.js +20 -0
  30. package/dist/core/baseagent-loader.js +60 -130
  31. package/dist/core/channel-loader.js +10 -1
  32. package/dist/core/channel-runtime.js +4 -3
  33. package/dist/core/command/agent-control.js +1 -1
  34. package/dist/core/command/agent-storage-menu.js +1 -1
  35. package/dist/core/command/chatmode-config.js +2 -36
  36. package/dist/core/command/command-handler.js +53 -11
  37. package/dist/core/command/data-root-resolver.js +32 -23
  38. package/dist/core/command/eventcenter-menu.js +338 -0
  39. package/dist/core/command/menu-catalog.js +8 -0
  40. package/dist/core/command/menu-handler.js +198 -84
  41. package/dist/core/command/menu-protocol.js +60 -11
  42. package/dist/core/command/menu-query-batch.js +194 -0
  43. package/dist/core/command/slash-gate.js +1 -1
  44. package/dist/core/command/slash-handler.js +34 -42
  45. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  46. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  47. package/dist/core/command/team-workspace-initializer.js +2 -0
  48. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  49. package/dist/core/command/team-workspace-job-store.js +88 -0
  50. package/dist/core/command/team-workspace-management-service.js +2 -0
  51. package/dist/core/command/team-workspace-management-store.js +96 -0
  52. package/dist/core/command/team-workspace-management.js +265 -0
  53. package/dist/core/command/team-workspace-members-menu.js +88 -0
  54. package/dist/core/command/team-workspace-store.js +612 -0
  55. package/dist/core/command/team-workspace-team.js +193 -0
  56. package/dist/core/daemon-control.js +8 -5
  57. package/dist/core/daemon-lifecycle.js +132 -73
  58. package/dist/core/handoff/runtime.js +3 -3
  59. package/dist/core/invoke/executors/index.js +13 -0
  60. package/dist/core/invoke/executors/media.js +283 -0
  61. package/dist/core/invoke/executors/text.js +198 -0
  62. package/dist/core/invoke/invoke-service.js +157 -0
  63. package/dist/core/invoke/style-router.js +48 -0
  64. package/dist/core/invoke/types.js +19 -0
  65. package/dist/core/ipc-registration.js +46 -7
  66. package/dist/core/memory/consolidation.js +7 -5
  67. package/dist/core/message/aun-ipc-sender.js +147 -17
  68. package/dist/core/message/im-renderer.js +28 -84
  69. package/dist/core/message/message-bridge.js +4 -0
  70. package/dist/core/message/message-utils.js +10 -2
  71. package/dist/core/message/peer-mode.js +7 -34
  72. package/dist/core/message/response-engine.js +157 -54
  73. package/dist/core/message/send-options.js +7 -4
  74. package/dist/core/message/send-routing.js +43 -5
  75. package/dist/core/ownership/owner-resolver.js +7 -0
  76. package/dist/core/permission/ec-command-parser.js +3 -2
  77. package/dist/core/permission/protected-paths.js +12 -2
  78. package/dist/core/permission/shell-environment.js +9 -0
  79. package/dist/core/session/session-file-health.js +243 -0
  80. package/dist/core/session/session-fs-store.js +2 -3
  81. package/dist/core/task/task-recovery-service.js +13 -2
  82. package/dist/core/thread/command-parser.js +9 -2
  83. package/dist/core/thread/thread-operation.js +21 -2
  84. package/dist/core/thread/thread-route.js +13 -2
  85. package/dist/directory/owner-directory-admission.js +40 -53
  86. package/dist/directory/owner-directory-cache.js +89 -113
  87. package/dist/directory/owner-directory-query-operation.js +8 -10
  88. package/dist/eck/kit-renderer.js +7 -5
  89. package/dist/ecweb/basic-settings-service.js +1 -1
  90. package/dist/ecweb/message-context-service.js +0 -4
  91. package/dist/ecweb/runtime/lifecycle.js +6 -2
  92. package/dist/ecweb/runtime/supervisor.js +19 -4
  93. package/dist/event-center/admission-materializer.js +114 -0
  94. package/dist/event-center/bus-gate.js +136 -0
  95. package/dist/event-center/bus-host.js +290 -0
  96. package/dist/event-center/bus-resolver.js +120 -0
  97. package/dist/event-center/center-config.js +100 -0
  98. package/dist/event-center/client-factory.js +50 -0
  99. package/dist/event-center/daemon.js +45 -0
  100. package/dist/event-center/directory-source.js +53 -0
  101. package/dist/event-center/dispatcher.js +157 -0
  102. package/dist/event-center/event-log.js +110 -0
  103. package/dist/event-center/index-generator.js +63 -0
  104. package/dist/event-center/ipc-operation.js +308 -0
  105. package/dist/event-center/ledger.js +52 -0
  106. package/dist/event-center/pack-loader.js +202 -0
  107. package/dist/event-center/pack-manager.js +85 -0
  108. package/dist/event-center/registry.js +238 -0
  109. package/dist/event-center/runtime.js +641 -0
  110. package/dist/event-center/script-runner.js +356 -0
  111. package/dist/event-center/types.js +35 -0
  112. package/dist/event-center/validation.js +413 -0
  113. package/dist/index.js +285 -99
  114. package/dist/ipc.js +66 -12
  115. package/dist/paths.js +20 -0
  116. package/dist/product.js +14 -0
  117. package/dist/proxy/manager.js +5 -1
  118. package/dist/proxy/service-supervisor.js +13 -4
  119. package/dist/response-system/engines/v1/index.js +0 -1
  120. package/dist/response-system/modes/single-session/index.js +1 -1
  121. package/dist/services/dispatcher.js +100 -0
  122. package/dist/services/idempotency.js +90 -0
  123. package/dist/services/identity.js +52 -0
  124. package/dist/services/index-generator.js +70 -0
  125. package/dist/services/index.js +449 -0
  126. package/dist/services/ipc-operation.js +458 -0
  127. package/dist/services/ledger.js +52 -0
  128. package/dist/services/message-log.js +112 -0
  129. package/dist/services/pack-manager.js +204 -0
  130. package/dist/services/reply.js +55 -0
  131. package/dist/services/router.js +95 -0
  132. package/dist/services/script-runner.js +422 -0
  133. package/dist/services/service-payload.js +70 -0
  134. package/dist/services/types.js +18 -0
  135. package/dist/services/validation.js +297 -0
  136. package/dist/trigger/application-service.js +18 -0
  137. package/dist/trigger/event-source.js +1 -1
  138. package/dist/trigger/ipc-service.js +3 -1
  139. package/dist/trigger/script-sandbox.js +118 -22
  140. package/dist/utils/cross-platform.js +24 -10
  141. package/dist/utils/evolcore-version.js +69 -27
  142. package/dist/utils/instance-registry.js +19 -13
  143. package/dist/utils/process-introspect.js +45 -9
  144. package/dist/utils/startup-trace.js +74 -37
  145. package/dist/utils/windows-shell-trust.js +80 -6
  146. package/kits/docs/INDEX.md +2 -2
  147. package/kits/docs/aun/ABILITY_CALLING.md +7 -14
  148. package/kits/docs/context-assembly.md +1 -1
  149. package/kits/docs/evolcore/INDEX.md +2 -0
  150. package/kits/docs/evolcore/ability.md +4 -0
  151. package/kits/docs/evolcore/aid.md +1 -1
  152. package/kits/docs/evolcore/event-center.md +207 -0
  153. package/kits/docs/evolcore/file-navigation.md +10 -264
  154. package/kits/docs/evolcore/fs.md +3 -2
  155. package/kits/docs/evolcore/group.md +1 -1
  156. package/kits/docs/evolcore/memory-architecture.md +2 -0
  157. package/kits/docs/evolcore/menu-protocol.md +21 -0
  158. package/kits/docs/evolcore/msg.md +15 -3
  159. package/kits/docs/evolcore/provider.md +3 -1
  160. package/kits/docs/evolcore/response.md +5 -5
  161. package/kits/docs/evolcore/services.md +277 -0
  162. package/kits/docs/evolcore/task.md +2 -0
  163. package/kits/docs/evolcore/team-workspace.md +41 -0
  164. package/kits/eck_manifest.json +26 -0
  165. package/kits/rules/02-navigation.md +10 -1
  166. package/kits/schemas/_meta.json +17 -6
  167. package/kits/schemas/agent-config.schema.19.json +5 -7
  168. package/kits/schemas/agent-config.schema.20.json +936 -0
  169. package/kits/schemas/relation-config.schema.12.json +2 -3
  170. package/kits/schemas/role-config.schema.2.json +4 -4
  171. package/kits/skills/.switches.json +1 -5
  172. package/kits/skills/ability/SKILL.md +56 -0
  173. package/kits/skills/ability/references/calling.md +56 -0
  174. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  175. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  176. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  177. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  178. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  179. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  180. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  181. package/kits/skills/personal-assistant/SKILL.md +6 -6
  182. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  183. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  184. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  185. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  186. package/kits/templates/system-fragments/channel.md +3 -3
  187. package/kits/templates/system-fragments/commands.md +5 -3
  188. package/kits/templates/system-fragments/reply.md +0 -5
  189. package/kits/templates/system-fragments/thread.md +10 -8
  190. package/package.json +3 -5
  191. package/dist/cli/pa-workspace-command.js +0 -225
  192. package/dist/core/command/pa-workspace-store.js +0 -468
  193. package/dist/core/relation/pa-team.js +0 -132
  194. package/kits/docs/evolcore/pa-workspace.md +0 -51
  195. package/kits/skills/aid-ability/SKILL.md +0 -244
  196. package/kits/skills/ec-ability/SKILL.md +0 -67
  197. 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
- **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`)。本页其余 `ec group` 命令用于群管理;宿主终端场景下它们也承担发送。
5
+ **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`;宿主终端用 `--from <本端AID>`)。本页其余 `ec group` 命令只用于群管理,不用于发消息。
6
6
 
7
7
  本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
8
8
 
@@ -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
  | 触发 | 说明 |
@@ -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,6 +2,8 @@
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
9
  在 EvolCore 托管会话中,每次工具调用只能执行一条完整的命令。禁止把
@@ -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 内每个
@@ -101,7 +113,7 @@ ec peer unblock <target-aid> --self <self-aid>
101
113
 
102
114
  发到群走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
103
115
 
104
- 非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
116
+ 非托管环境的 `ecmsg send`(带 `--from`)不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断;自发消息也不进联系人准入。
105
117
 
106
118
  在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
107
119
  要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),
@@ -65,7 +65,9 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
65
65
 
66
66
  引用更新与 aliases 清理作为同一事务提交,providers.json 最后写入。配置无法读取、迁移冲突或并发写入时拒绝提交;提交失败回滚,异常中断由下次启动恢复。成功后旧 ID 不再可用;重复启动无变更时不产生新备份。外部脚本应改用固定 ID,历史备份不重写。启动收尾不导入本机连接、不修改默认基座或模型,也不展开环境变量。
67
67
 
68
- 托管 Codex 使用解析后的固定 Provider ID 生成运行时 model_provider,并在 thread/start、thread/resume、thread/fork 显式指定当前 Provider,覆盖历史会话中的旧 Provider 选择;原 thread ID 和历史不修改,不以新建会话代替恢复。不会修改用户原生 Codex config.toml 的 model_provider/model_providers。模型目录查询与推理使用相同的运行时命名规则。
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 已绑定的会话;模型输入在修复及恢复校验完成后提交。
69
71
 
70
72
  ## 完整对象示例
71
73
 
@@ -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`。本地任务活动记录、正式 `ecmsg 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