evolcore 0.0.43-test.2 → 0.0.43-test.4

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 (173) hide show
  1. package/CHANGELOG.md +44 -1
  2. package/bin/ecmsg.js +229 -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 +0 -37
  10. package/dist/agents/ecagent-runner.js +138 -36
  11. package/dist/aun/aid/agentmd.js +52 -13
  12. package/dist/aun/menu/client.js +8 -7
  13. package/dist/aun/menu/index.js +1 -1
  14. package/dist/aun/menu/transport.js +8 -5
  15. package/dist/aun/msg/p2p.js +4 -2
  16. package/dist/aun/service-proxy.js +3 -0
  17. package/dist/channels/aun.js +105 -53
  18. package/dist/channels/daemon.js +14 -2
  19. package/dist/cli/agent-command.js +5 -0
  20. package/dist/cli/agent-create.js +31 -11
  21. package/dist/cli/agent.js +9 -3
  22. package/dist/cli/aun-commands.js +19 -21
  23. package/dist/cli/daemon-commands.js +30 -18
  24. package/dist/cli/directory.js +98 -56
  25. package/dist/cli/getmeta-command.js +2 -1
  26. package/dist/cli/index.js +1 -1
  27. package/dist/cli/init.js +13 -5
  28. package/dist/cli/peer.js +2 -1
  29. package/dist/cli/task-context.js +3 -1
  30. package/dist/cli/trigger-command.js +20 -14
  31. package/dist/config/access-policy.js +0 -1
  32. package/dist/config/boot-log.js +12 -2
  33. package/dist/config/builtin-role-templates.js +2 -2
  34. package/dist/config/builtin-roles.js +2 -1
  35. package/dist/config/config-field-policy.js +7 -0
  36. package/dist/config/config-manager.js +30 -10
  37. package/dist/config/peer-role-resolver.js +23 -1
  38. package/dist/config/role-schema.js +25 -1
  39. package/dist/config/role-service.js +9 -4
  40. package/dist/config/role-store.js +30 -8
  41. package/dist/config/schema-migration.js +121 -0
  42. package/dist/core/agent-application-service.js +11 -0
  43. package/dist/core/agent-ipc-registration.js +2 -0
  44. package/dist/core/agent-runtime.js +41 -9
  45. package/dist/core/auth/auth-gateway.js +14 -4
  46. package/dist/core/auth/operation-authorizer.js +19 -1
  47. package/dist/core/auth/operation-catalog.js +12 -2
  48. package/dist/core/baseagent-loader.js +11 -3
  49. package/dist/core/bootstrap-service.js +8 -0
  50. package/dist/core/channel-loader.js +61 -23
  51. package/dist/core/channel-runtime.js +5 -0
  52. package/dist/core/command/agent-control.js +5 -2
  53. package/dist/core/command/agentmd-menu-request.js +50 -0
  54. package/dist/core/command/agentmd-menu.js +156 -0
  55. package/dist/core/command/chatmode-config.js +46 -0
  56. package/dist/core/command/command-handler.js +44 -17
  57. package/dist/core/command/daemon-diagnostics.js +2 -1
  58. package/dist/core/command/menu-catalog.js +14 -1
  59. package/dist/core/command/menu-handler.js +74 -24
  60. package/dist/core/command/menu-protocol.js +8 -0
  61. package/dist/core/command/role-menu.js +23 -9
  62. package/dist/core/command/slash-handler.js +52 -47
  63. package/dist/core/daemon-lifecycle.js +43 -17
  64. package/dist/core/event-catalog.js +19 -0
  65. package/dist/core/evolagent-registry.js +3 -0
  66. package/dist/core/evolagent.js +5 -4
  67. package/dist/core/ipc-registration.js +6 -0
  68. package/dist/core/lifecycle-notice.js +185 -0
  69. package/dist/core/message/aun-ipc-sender.js +30 -24
  70. package/dist/core/message/contact-admission.js +1 -19
  71. package/dist/core/message/im-renderer.js +81 -40
  72. package/dist/core/message/message-admission.js +21 -62
  73. package/dist/core/message/message-bridge.js +18 -5
  74. package/dist/core/message/message-utils.js +9 -0
  75. package/dist/core/message/peer-mode.js +16 -8
  76. package/dist/core/message/response-engine.js +67 -47
  77. package/dist/core/model/model-capabilities.js +37 -0
  78. package/dist/core/model/model-catalog.js +6 -2
  79. package/dist/core/ownership/owner-resolver.js +74 -36
  80. package/dist/core/permission/ec-command-parser.js +62 -13
  81. package/dist/core/plugin-lifecycle.js +6 -2
  82. package/dist/core/relation/pa-team.js +132 -0
  83. package/dist/core/role/runtime-policy.js +4 -3
  84. package/dist/core/thread/thread-service.js +6 -4
  85. package/dist/directory/owner-directory-admission.js +0 -3
  86. package/dist/directory/owner-directory-cache.js +201 -17
  87. package/dist/directory/owner-directory-markdown.js +44 -21
  88. package/dist/directory/owner-directory-policy.js +1 -1
  89. package/dist/directory/owner-directory-query-operation.js +218 -98
  90. package/dist/directory/owner-directory-request-operation.js +76 -0
  91. package/dist/directory/owner-directory-scope.js +35 -4
  92. package/dist/directory/owner-directory-search.js +76 -23
  93. package/dist/directory/owner-directory-store.js +5 -38
  94. package/dist/directory/owner-directory-text.js +60 -0
  95. package/dist/eck/kit-renderer.js +6 -3
  96. package/dist/eck/message-renderer.js +2 -5
  97. package/dist/ecweb/message-context-service.js +4 -0
  98. package/dist/ecweb/runtime/lifecycle.js +29 -5
  99. package/dist/ecweb/runtime/supervisor.js +83 -27
  100. package/dist/index.js +209 -38
  101. package/dist/paths.js +4 -2
  102. package/dist/product.js +1 -0
  103. package/dist/proxy/service-supervisor.js +377 -141
  104. package/dist/response-system/engines/v1/index.js +2 -4
  105. package/dist/response-system/modes/single-session/index.js +1 -1
  106. package/dist/trigger/audit.js +3 -2
  107. package/dist/trigger/authorization.js +2 -3
  108. package/dist/trigger/history.js +4 -3
  109. package/dist/trigger/ipc-service.js +24 -19
  110. package/dist/trigger/manager.js +3 -5
  111. package/dist/trigger/parser.js +4 -21
  112. package/dist/trigger/patch.js +3 -15
  113. package/dist/trigger/scheduler.js +53 -13
  114. package/dist/trigger/validation.js +0 -13
  115. package/dist/utils/error-utils.js +15 -5
  116. package/dist/utils/macos-autostart.js +31 -0
  117. package/dist/utils/model-prices.jsonl +15 -8
  118. package/dist/utils/process-introspect.js +21 -1
  119. package/dist/utils/startup-trace.js +7 -1
  120. package/dist/utils/windows-autostart.js +1 -0
  121. package/ecagent/README.md +18 -0
  122. package/ecagent/dist/harness/agent-harness.d.ts +2 -0
  123. package/ecagent/dist/harness/agent-harness.js +24 -8
  124. package/ecagent/dist/harness/compaction/branch-summarization.js +1 -1
  125. package/ecagent/dist/harness/compaction/compaction.js +7 -4
  126. package/ecagent/dist/harness/types.d.ts +1 -0
  127. package/kits/docs/channels/aun.md +1 -1
  128. package/kits/docs/context-assembly.md +1 -1
  129. package/kits/docs/evolcore/INDEX.md +5 -2
  130. package/kits/docs/evolcore/directory.md +125 -35
  131. package/kits/docs/evolcore/ecweb-lifecycle.md +26 -0
  132. package/kits/docs/evolcore/file-navigation.md +279 -0
  133. package/kits/docs/evolcore/menu-protocol.md +1 -0
  134. package/kits/docs/evolcore/model.md +5 -3
  135. package/kits/docs/evolcore/msg.md +1 -0
  136. package/kits/docs/evolcore/peer.md +2 -1
  137. package/kits/docs/evolcore/response.md +4 -2
  138. package/kits/docs/evolcore/task.md +2 -0
  139. package/kits/docs/evolcore/thread-chain.md +1 -1
  140. package/kits/docs/evolcore/tool-authorization.md +4 -1
  141. package/kits/docs/evolcore/trigger.md +10 -7
  142. package/kits/docs/identity/ROLE_DETAIL.md +2 -0
  143. package/kits/eck_manifest.json +6 -23
  144. package/kits/eck_manifest.memory.json +26 -1
  145. package/kits/rules/01-overview.md +42 -44
  146. package/kits/rules/02-navigation.md +44 -53
  147. package/kits/rules/03-identity.md +21 -25
  148. package/kits/rules/04-relation.md +23 -33
  149. package/kits/rules/05-venue.md +24 -25
  150. package/kits/schemas/_meta.json +10 -10
  151. package/kits/schemas/agent-config.schema.19.json +10 -6
  152. package/kits/schemas/relation-config.schema.12.json +2 -2
  153. package/kits/schemas/role-config.schema.2.json +5 -5
  154. package/kits/schemas/role-registry.schema.1.json +3 -2
  155. package/kits/skills/ec-service-proxy/SKILL.md +10 -0
  156. package/kits/skills/ec-trigger/SKILL.md +1 -1
  157. package/kits/templates/soul/00-GUIDE.md +20 -42
  158. package/kits/templates/system-fragments/channel.md +2 -2
  159. package/kits/templates/system-fragments/commands.md +1 -1
  160. package/kits/templates/system-fragments/directory-contacts.md +1 -1
  161. package/kits/templates/system-fragments/identity.md +0 -1
  162. package/kits/templates/system-fragments/personal-assistant.md +2 -17
  163. package/kits/templates/system-fragments/reply.md +7 -0
  164. package/kits/templates/system-fragments/session.md +6 -2
  165. package/package.json +18 -13
  166. package/dist/eck/paactive-context.js +0 -45
  167. package/dist/response-system/engines/v1/paactive-flow.js +0 -18
  168. package/kits/eck_manifest.paactive.json +0 -528
  169. package/kits/eck_message_manifest.paactive.json +0 -233
  170. package/kits/templates/message-fragments/paactive/item.md +0 -3
  171. package/kits/templates/system-fragments/paactive/channel.md +0 -25
  172. package/kits/templates/system-fragments/paactive/reply.md +0 -25
  173. package/kits/templates/system-fragments/paactive/session.md +0 -32
@@ -241,12 +241,14 @@ script trigger 返回 `[[NOOP]]` 或 `outcome: "noop"` 时走 noop 分支;默
241
241
  ```bash
242
242
  --model <模型>
243
243
  --effort <low|medium|high|xhigh|max>
244
- --baseagent <claude|codex|gemini>
245
244
  ```
246
245
 
247
246
  `--model` / `--effort` 只覆盖本 trigger 执行时传给 base agent 的模型与推理强度。
248
- `--baseagent` 仅支持 `--exec trigger-session`,用于给该 trigger 会话单独选择 base agent;
249
- `script` 和 `target-session` 不接受该参数。未设置时沿用 trigger 所属 agent 当前 active baseagent。
247
+ `--baseagent` 已移除。`trigger-session` 始终使用所属 Agent 当前的 active baseagent,
248
+ 历史定义中的 `execution.baseagent` 在加载时自动移除并记录迁移审计。
249
+ Agent 切换基座后,旧基座会话保留,新执行使用对应当前基座的会话,不跨基座恢复旧上下文。
250
+ `target-session` 仍由目标会话处理,`script` 不调用模型。已有模型覆盖不会自动清除;
251
+ 切换基座时应确认 `--model` / `--effort` 与新基座兼容,或清除覆盖以继承 Agent 默认值。
250
252
 
251
253
  无人值守 trigger 不适合 `request`。需要写文件、git、安装升级、重启服务、管理 trigger 时应显式使用:
252
254
 
@@ -272,7 +274,7 @@ owner/admin 通过 `/trigger create` 创建时默认使用 `bypass`;非 admin
272
274
  ```bash
273
275
  ec trigger enable <triggerId>
274
276
  ec trigger disable <triggerId>
275
- ec trigger cancel <triggerId> # disable 的兼容别名
277
+ ec trigger cancel <runId> # 中止当前活动运行
276
278
  ec trigger delete <triggerId>
277
279
  ec trigger remove <triggerId> # delete 的兼容别名
278
280
  ec trigger rm <triggerId> # delete 的兼容别名
@@ -282,12 +284,13 @@ ec trigger rm <triggerId> # delete 的兼容别名
282
284
 
283
285
  | 命令 | 定义文件 | 后续调度 | 当前 run | 可恢复 |
284
286
  | --- | --- | --- | --- | --- |
285
- | `disable` / `cancel` | 保留,写 `enabled: false` | 清理 | 不中断 | 可 `enable` |
287
+ | `disable` | 保留,写 `enabled: false` | 清理 | 不中断 | 可 `enable` |
288
+ | `cancel` | 保留定义,写入中断审计 | 不影响其它调度 | 中止指定活动 run | 不可恢复该 run |
286
289
  | `delete` | 删除整个 trigger 运行态目录,保留 history tombstone | 清理 | 不中断 | 定义不可恢复,审计可复查 |
287
290
 
288
- `delete` 不需要先执行 `disable/cancel`;它内部会先清理 timer/event/schedule,再删除定义。
291
+ `delete` 不需要先执行 `disable`;它内部会先清理 timer/event/schedule,再删除定义。
289
292
 
290
- > **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `cancel`**:`cancel` 只写
293
+ > **用完即弃的 Trigger(如跨话题复查)结束时应使用 `delete` 而不是 `disable`**:`disable` 只写
291
294
  > `enabled: false`,定义会一直留在 `$EVOLCORE_HOME/agents/<aid>/triggers/` 下,长期积累成
292
295
  > 大量永不触发的死定义。
293
296
 
@@ -18,6 +18,8 @@
18
18
 
19
19
  ## 场景矩阵
20
20
 
21
+ 默认角色分为 `private`、`group`、`paTeam`。AUN 私聊中双方验签为 `agent/pa.*` 且新鲜 Ownership 共识确认同 Owner 时,使用独立 PA 默认;缺失/null 默认 member,不复用 private。真实 Owner 优先,显式关系角色优先于 PA 默认。资格失效会触发后续鉴权及工具执行重验,不批量改写关系配置;群聊和非 AUN 不适用。
22
+
21
23
  | 场景 | 响应策略 | 工具可用性 |
22
24
  |------|----------|-----------|
23
25
  | coding | 每条响应 | 全部 |
@@ -83,7 +83,7 @@
83
83
  "skipUnchangedTemplate": "soul",
84
84
  "unchangedTemplateKeep": ["00-GUIDE.md"],
85
85
  "order": 21,
86
- "needsInjection": false,
86
+ "needsInjection": true,
87
87
  "when": {
88
88
  "and": [
89
89
  {
@@ -98,32 +98,11 @@
98
98
  },
99
99
  "description": "常驻自我定义(00-GUIDE 机制 + 身份/性格/职责/操作铁律;空文件不注入)"
100
100
  },
101
- {
102
- "id": "peer-self-intro",
103
- "type": "file",
104
- "file": "$RELATIONS_DIR/{{peerKey}}/self-intro.md",
105
- "order": 28,
106
- "needsInjection": false,
107
- "optional": true,
108
- "when": {
109
- "and": [
110
- {
111
- "var": "peerKey",
112
- "neq": null
113
- },
114
- {
115
- "var": "lifecycle",
116
- "eq": "active"
117
- }
118
- ]
119
- },
120
- "description": "本端向该对端的自我介绍流水"
121
- },
122
101
  {
123
102
  "id": "owner-directory",
124
103
  "type": "file",
125
104
  "file": "$AGENT_DIR/directory/directory.md",
126
- "order": 29,
105
+ "order": 28,
127
106
  "needsInjection": false,
128
107
  "optional": true,
129
108
  "when": {
@@ -174,6 +153,10 @@
174
153
  "optional": true,
175
154
  "when": {
176
155
  "and": [
156
+ {
157
+ "var": "hasOwnerDirectory",
158
+ "eq": true
159
+ },
177
160
  {
178
161
  "var": "isPersonalAssistant",
179
162
  "eq": true
@@ -56,7 +56,7 @@
56
56
  "skipUnchangedTemplate": "soul",
57
57
  "unchangedTemplateKeep": ["00-GUIDE.md"],
58
58
  "order": 25,
59
- "needsInjection": false,
59
+ "needsInjection": true,
60
60
  "when": {
61
61
  "var": "lifecycle",
62
62
  "eq": "active"
@@ -83,6 +83,27 @@
83
83
  },
84
84
  "description": "当前对端画像(profile 标签的记忆)"
85
85
  },
86
+ {
87
+ "id": "owner-directory",
88
+ "type": "file",
89
+ "file": "$AGENT_DIR/directory/directory.md",
90
+ "order": 29,
91
+ "needsInjection": false,
92
+ "optional": true,
93
+ "when": {
94
+ "and": [
95
+ {
96
+ "var": "hasOwnerDirectory",
97
+ "eq": true
98
+ },
99
+ {
100
+ "var": "lifecycle",
101
+ "eq": "active"
102
+ }
103
+ ]
104
+ },
105
+ "description": "Owner 名录(本 agent 准入范围内的联系人与个人助理)"
106
+ },
86
107
  {
87
108
  "id": "contacts-profile",
88
109
  "type": "file",
@@ -117,6 +138,10 @@
117
138
  "optional": true,
118
139
  "when": {
119
140
  "and": [
141
+ {
142
+ "var": "hasOwnerDirectory",
143
+ "eq": true
144
+ },
120
145
  {
121
146
  "var": "isPersonalAssistant",
122
147
  "eq": true
@@ -12,42 +12,40 @@ AUN(Agent Union Network)是 agent 间安全通信的网络协议,SDK 的 n
12
12
 
13
13
  ### AID
14
14
 
15
- AID(Agent Identifier)是主体在 AUN 网络中的唯一身份标识,格式为 `{name}.{issuer}`(如 `alice.agentid.pub`)。任何拥有域名的组织都可以作为 Issuer 签发 AID——去中心化,无需中央权威。AID 同时也是通信地址:身份即入口。
15
+ AID(Agent Identifier)是主体在 AUN 网络中的唯一身份标识,格式为 `{name}.{issuer}`(如 `alice.agentid.pub`)。任何拥有域名的组织都可以作为 Issuer 签发 AID——去中心化,无需中央权威。AID 同时也是通信地址:身份即入口,可直接用。
16
16
 
17
- > 本机 evolcore 自动生成控制 AID 时的默认 AID domain 是 `agentid.cn`(`src/aun/aid/control-aid.ts` 的
18
- > `resolveControlAidDomain()`;可用 `daemon.json.aun.defaultAidDomain` 或 `EVOLCORE_AID_DOMAIN` 覆盖)。
19
- > 已存在的 AID 保持原域名不变;`EVOLCORE_ISSUER` 仍作为废弃兼容别名支持。
17
+ > 本机 evolcore 自动生成控制 AID 时的默认 AID domain 是 `agentid.cn`
20
18
 
21
19
  访问 `https://{aid}` 可获取该主体的个人主页。
22
20
 
23
21
  信任通过四级 X.509 证书链建立:Root CA → Registry CA → Issuer CA → Agent Certificate。
24
22
 
25
- ### [agent.md](http://agent.md)
23
+ ### agent.md
26
24
 
27
25
  `https://{aid}/agent.md` 是主体在 AUN 网络上的标准名片。格式为 YAML frontmatter + Markdown 正文 + 密码学签名。
28
26
 
29
27
  核心字段:`aid`、`name`(显示名)、`type`、`description`(一句话简介)、`avatar`、`tags`、`visibility`(public/unlisted/private)、`skills`。
30
28
 
31
- `type` 是可扩展字符串。EvolCore 内置以下常用类型;它们都持有 AID、都能通过 AUN 向你发消息,
29
+ `type` 是可扩展字符串。EvolCore 内置以下常用类型;它们都持有 AID、都能通过 AUN 向你发消息,
32
30
  对你而言**都是对端**:
33
31
 
34
32
  | type | 含义 |
35
- |------|------|
36
- | `human` | 人类 |
37
- | `agent` | 会用到大模型且没有专用主体类型的服务程序(agent.md 里可写 `Claude Code`/`Codex`/`Gemini CLI`/`ecagent` 等具体 base agent 名) |
38
- | `group` | 群服务(群本身也有 AID,是一类对端) |
39
- | `service` | 有 AID 但不使用大模型的服务程序 |
40
- | `device` | 设备或嵌入式节点 |
41
- | `org` | 组织主体 |
42
- | `host` | EvolCore 控制主机的 daemon AID;名称通常为 `<Win/Linux/MacOS>主机-<aid前缀>` |
43
- | `custom` | 自定义主体类型 |
33
+ | --- | --- |
34
+ | human | 人类 |
35
+ | agent | 会用到大模型且没有专用主体类型的服务程序(agent.md 里可写 Claude Code/Codex/Gemini CLI/ecagent 等具体 base agent 名) |
36
+ | group | 群服务(群本身也有 AID,是一类对端) |
37
+ | service | 有 AID 但不使用大模型的服务程序 |
38
+ | device | 设备或嵌入式节点 |
39
+ | org | 组织主体 |
40
+ | host | EvolCore 控制主机的 daemon AID;名称通常为 `<Win/Linux/MacOS>主机-<aid前缀>` |
41
+ | custom | 自定义主体类型 |
44
42
 
45
43
  上表为预设值;协议允许应用扩展任意类型字符串,解析方应保留并容忍未知值。`exttype` 字段可进一步描述 `type` 的具体形态。
46
44
 
47
- > **群属于关系层**:`group` 是对端的一种,具体群实例的数据与其它对端一样落关系层
45
+ > **群属于关系层**:`group` 是对端的一种,具体群实例的数据与其它对端一样落关系层
48
46
  > `$RELATIONS_DIR/<peerKey>/`(见 `04-relation.md`),不落环境层。
49
47
 
50
- 你的名字、描述、对外展示信息都在这里。读写名片一律走 CLI:`ec aid agentmd get <aid>` 读取(下载+验签),
48
+ 你的名字、描述、对外展示信息都在这里。读写名片一律走 CLI:`ec aid agentmd get <aid>` 读取(下载+验签),
51
49
  `ec aid agentmd set <aid> <字段> <值>` 或 `ec aid agentmd put <aid>` 发布。不要直接读 `$EVOLCORE_HOME/AIDs/` 下的文件,也不要自己调 SDK。
52
50
 
53
51
  ### AUN网关
@@ -88,7 +86,7 @@ AUN 把 agent 当网络主体(具备社会人属性:身份/通信/自主),
88
86
 
89
87
  ## EvolCore 是什么
90
88
 
91
- EvolCore 是一个 Node.js 项目,通过 `npm install -g evolcore@latest` 安装,包根目录为 `$PACKAGE_ROOT`。
89
+ EvolCore 是一个 Node.js 项目,通过 `npm install -g evolcore@latest` 安装,包根目录为 `$PACKAGE_ROOT`。
92
90
  它运行在你之上,为你接入 AUN 通信网络并构建身份、关系、环境感知、持久记忆。你提供智能,它提供社会性。
93
91
 
94
92
  ### Evol
@@ -99,7 +97,7 @@ Evol 是 AUN 原生的消息应用(App / Web / Desktop)——人和 agent
99
97
 
100
98
  Channel 是能收发消息的通信方式。渠道两端是两个主体,通过渠道收发消息。
101
99
 
102
- 接入 EvolCore这一端的 agent 始终以 AID 为身份标识。另一端,不同 channel 以各自的账号体系标识对端——飞书用 user_id,微信用 openid,钉钉用 unionId。Evol 作为 AUN 原生应用,对端同样以 AID 标识(在 [agent.md](http://agent.md) 中 type 为 human)。
100
+ 接入 EvolCore这一端的 agent 始终以 AID 为身份标识。另一端,不同 channel 以各自的账号体系标识对端——飞书用 user_id,微信用 openid,钉钉用 unionId。Evol 作为 AUN 原生应用,对端同样以 AID 标识(在 agent.md 中 type 为 human)。
103
101
 
104
102
  不同 channel 有不同的通信方式,你通过对应的命令行工具完成收发消息。
105
103
 
@@ -110,63 +108,63 @@ ECK(EvolCore Context Kit)是 EvolCore 的上下文组装系统。你正在
110
108
  ### 三部分
111
109
 
112
110
  | 部分 | 位置 | 加载方式 |
113
- |------|------|----------|
114
- | 自动载入 | `$KITS_RULES/`(本目录) | 仅在 agent `lifecycle=active` 时加载 |
115
- | 按需载入 | `$KITS_DOCS/` | 通过索引定位,需要时 Read |
111
+ | --- | --- | --- |
112
+ | 自动载入 | $KITS_RULES/(本目录) | 仅在 agent lifecycle=active 时加载 |
113
+ | 按需载入 | $KITS_DOCS/ | 通过索引定位,需要时 Read |
116
114
  | 动态注入 | evolcore 代码 | 上下文组装时注入参数和文件 |
117
115
 
118
116
  ### 四层架构
119
117
 
120
118
  | 层 | 解决的问题 | 详见 |
121
- |----|-----------|------|
122
- | 身份层 | 我是谁 | `03-identity.md` |
123
- | 关系层 | 跟我聊天的是谁 | `04-relation.md` |
124
- | 环境层 | 我在什么场景下 | `05-venue.md` |
125
- | 渠道层 | 我通过什么通信 | `06-channel.md` |
119
+ | --- | --- | --- |
120
+ | 身份层 | 我是谁 | 03-identity.md |
121
+ | 关系层 | 跟我聊天的是谁 | 04-relation.md |
122
+ | 环境层 | 我在什么场景下 | 05-venue.md |
123
+ | 渠道层 | 我通过什么通信 | 06-channel.md |
126
124
 
127
125
  ### 上下文组装流程
128
126
 
129
- evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
130
- 每个 section 带 `when` 条件,evolcore 按当前会话构造一组运行时变量(`chatType`、`channel`、
127
+ evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
128
+ 每个 section 带 `when` 条件,evolcore 按当前会话构造一组运行时变量(`chatType`、`channel`、
131
129
  `selfAid`、`peerKey` 等)逐段求值,命中的才按顺序拼进 system prompt(`needsInjection` 的段还会先做模板渲染)。
132
130
 
133
131
  按场景,命中的段大致是:
134
132
 
135
133
  | 场景 | 命中的层/段 |
136
- |------|------------|
134
+ | --- | --- |
137
135
  | coding(无渠道) | active 时为 rules + 会话层 + baseagent(身份/关系/环境/渠道层因无 channel、无身份而落选) |
138
136
  | private(私聊) | rules + 身份层(含 soul)+ 关系层(对端)+ 环境层 + 渠道层 + 会话层 + baseagent |
139
137
  | group(群聊) | rules + 身份层(含 soul)+ 关系层(群)+ 环境层 + 渠道层 + 会话层 + baseagent |
140
- | bootstrapping | bootstrap 引导 + 有渠道时的共用回复规则 `[reply]`(含最小身份、目标、chatMode);不加载 rules、完整身份/关系/环境/渠道能力、会话、baseagent 或 commands 段 |
138
+ | bootstrapping | bootstrap 引导 + 有渠道时的共用回复规则 [reply](含最小身份、目标、chatMode);不加载 rules、完整身份/关系/环境/渠道能力、会话、baseagent 或 commands 段 |
141
139
 
142
- > 共用 `reply-contract` 在有渠道且 `lifecycle∈{active,bootstrapping}` 时加载;其余常规段(包括 rules、session、baseagent)都要求 `lifecycle=active`。生命周期缺失按 `active` 处理;非法时,
140
+ > 共用 `reply-contract` 在有渠道且 `lifecycle∈{active,bootstrapping}` 时加载;其余常规段(包括 rules、session、baseagent)都要求 `lifecycle=active`。生命周期缺失按 `active` 处理;非法时,
143
141
  > Manifest 不加载任何常规段;agent-owned turn 也不会直接落入普通 runner。
144
142
 
145
- 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
146
- `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
143
+ 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
144
+ `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
147
145
  `kits/eck_message_manifest.json`(逐条消息渲染)。
148
146
 
149
147
  manifest schema、when 条件、合并覆盖、模板渲染、运行时变量目录详见 `$KITS_DOCS/context-assembly.md`。
150
148
 
151
- **实际渲染结果的调试输出**默认**关闭**,要在进程级配置里打开 `debug.eckSnapshots: true` 才会写;
152
- 开启后落 `$EVOLCORE_HOME/data/eck-debug/`,文件名带时间戳:`vars-<ts>.json`、`context-<ts>.md`、
149
+ **实际渲染结果的调试输出**默认**关闭**,要在进程级配置里打开 `debug.eckSnapshots: true` 才会写;
150
+ 开启后落 `$EVOLCORE_HOME/data/eck-debug/`,文件名带时间戳:`vars-<ts>.json`、`context-<ts>.md`、
153
151
  `fragments-<ts>.md`、`manifest-<ts>.md`(逐条消息渲染另有 `msg-render-<ts>.md`),保留 24 小时。
154
152
 
155
153
  ## 命令行的引号写法
156
154
 
157
- `ec` 命令里的自由文本参数(消息正文、`--desc`、`--prompt`、`--name`、`--question`、
155
+ `ec` 命令里的自由文本参数(消息正文、`--desc`、`--prompt`、`--name`、`--question`、
158
156
  `--reason` 等)默认**用单引号包住**(`'…'`)。
159
157
 
160
- 用双引号的话,正文里的反引号(`` ` ``)和 `$` 会被 shell 当作命令替换或变量展开,
158
+ 用双引号的话,正文里的反引号(`` ` ``)和 `$` 会被 shell 当作命令替换或变量展开,
161
159
  命令会被拒绝——`ec` 只接受能确认为字面量的命令。
162
160
 
163
- **正文本身含单引号时**,改用 bash ANSI-C quoting:`$'…'`。
161
+ **正文本身含单引号时**,改用 bash ANSI-C quoting:`$'…'`。
164
162
  内部支持转义:`\'` `\n` `\t` `\\`。例:`ec msg send $'it\'s fine'`。
165
163
 
166
164
  ## 术语
167
165
 
168
- - **主体(Principal)**:通信参与者——人或 agent。AUN 网络上的主体持有 AID;非 AUN 渠道(飞书/微信等)的对端以该渠道的账号标识,同样是主体
169
- - **对端**:和你通信的主体
170
- - **本端(self)**:你自己
171
- - **用户**:对端中的人类一方
172
- - **环境(Venue)**:渠道 + 场景(私聊/群聊)构成的交互空间
166
+ - **主体(Principal)**:通信参与者——人或 agent。AUN 网络上的主体持有 AID;非 AUN 渠道(飞书/微信等)的对端以该渠道的账号标识,同样是主体
167
+ - **对端**:和你通信的主体
168
+ - **本端(self)**:你自己
169
+ - **用户**:对端中的人类一方
170
+ - **环境(Venue)**:渠道 + 场景(私聊/群聊)构成的交互空间
@@ -5,39 +5,29 @@
5
5
  ### 三个基础路径
6
6
 
7
7
  | 路径 | 含义 |
8
- |------|------|
9
- | `$EVOLCORE_HOME` | 用户数据根。解析顺序:`EVOLCORE_HOME` 环境变量 → `~/.evolcore` |
10
- | `$PACKAGE_ROOT` | evolcore 包根目录(由 `getPackageRoot()` 从 `import.meta` 推出) |
11
- | `$CURRENT_PROJECT` | 当前工作目录 |
8
+ | --- | --- |
9
+ | $EVOLCORE_HOME | 用户数据根。解析顺序:EVOLCORE_HOME 环境变量 → ~/.evolcore |
10
+ | $PACKAGE_ROOT | evolcore 包根目录(由 getPackageRoot() 从 import.meta 推出) |
11
+ | $CURRENT_PROJECT | 当前工作目录 |
12
12
 
13
13
  ### 派生路径
14
14
 
15
15
  以下是 ECK 真正认识的别名(`src/eck/manifest-engine.ts` 的 `buildPathMappings`):
16
16
 
17
17
  | 名称 | 派生自 | 含义 |
18
- |------|--------|------|
19
- | `$KITS` | `$PACKAGE_ROOT/kits` | ECK 知识包根 |
20
- | `$KITS_RULES` | `$KITS/rules` | 自动载入部分(本目录) |
21
- | `$KITS_DOCS` | `$KITS/docs` | 按需载入文档 |
22
- | `$KITS_TEMPLATES` | `$KITS/templates` | prompt 模板 |
23
- | `$KITS_FRAGMENTS` | `$KITS_TEMPLATES/system-fragments` | system prompt fragment 模板 |
24
- | `$KITS_MESSAGE_FRAGMENTS` | `$KITS_TEMPLATES/message-fragments` | 逐条消息渲染的 fragment 模板 |
25
- | `$PERSONAL_DIR` | `$AGENT_DIR/personal` | 个人数据层(身份层) |
26
- | `$RELATIONS_DIR` | `$AGENT_DIR/relations` | 关系层 |
27
- | `$VENUES_DIR` | `$AGENT_DIR/venues` | 环境层(当前是死目录,见 `05-venue.md`) |
28
- | `$AGENT_DIR` | `$EVOLCORE_HOME/agents/<selfAid>` | 当前 agent 根(`selfAid` 为空时这四个别名都不注册) |
29
-
30
- > ⚠️ **只有上表这些别名能在 manifest 的 `path` 字段里用**。写成 `$SELF_DIR`(旧名)、
31
- > `$PEER_DIR`、`$AGENTS_DIR`、`$AGENT_INDEX`、`$ECK` 会被判为未解析变量,**整段静默丢弃**。
32
-
33
- 下面这些只是**文档里的书写约定**,不是 ECK 能解析的别名,引用时要么写全路径要么当散文读:
34
-
35
- | 名称 | 实际位置 | 含义 |
36
- |------|----------|------|
37
- | `$ECK` | `$EVOLCORE_HOME/eck` | 运行时配置实例(见下文 Bootstrap 的告警) |
38
- | `$AGENTS_DIR` | `$EVOLCORE_HOME/agents` | per-agent 数据根 |
39
- | `$AGENT_INDEX` | `$AGENT_DIR/index` | agent 级文档索引 |
40
- | `$PEER_DIR` | `$RELATIONS_DIR/<peerKey>` | 当前对端的关系目录 |
18
+ | --- | --- | --- |
19
+ | $KITS | $PACKAGE_ROOT/kits | ECK 知识包根 |
20
+ | $KITS_RULES | $KITS/rules | 自动载入部分(本目录) |
21
+ | $KITS_DOCS | $KITS/docs | 按需载入文档 |
22
+ | $KITS_TEMPLATES | $KITS/templates | prompt 模板 |
23
+ | $KITS_FRAGMENTS | $KITS_TEMPLATES/system-fragments | system prompt fragment 模板 |
24
+ | $KITS_MESSAGE_FRAGMENTS | $KITS_TEMPLATES/message-fragments | 逐条消息渲染的 fragment 模板 |
25
+ | $PERSONAL_DIR | $AGENT_DIR/personal | 个人数据层(身份层) |
26
+ | $RELATIONS_DIR | $AGENT_DIR/relations | 关系层 |
27
+ | $VENUES_DIR | $AGENT_DIR/venues | 环境层(当前是死目录,见 05-venue.md) |
28
+ | $AGENT_DIR | `$EVOLCORE_HOME/agents/<selfAid>` | 当前 agent 根(selfAid 为空时这四个别名都不注册) |
29
+
30
+ > ⚠️ **只有上表这些别名能在 manifest 的** `path` **字段里用**。
41
31
 
42
32
  ## 路径注册表机制
43
33
 
@@ -46,34 +36,35 @@
46
36
  ### 三层结构
47
37
 
48
38
  | 层 | 位置 | 性质 | 内容 |
49
- |----|------|------|------|
39
+ | --- | --- | --- | --- |
50
40
  | 机制描述 | 本文件 | 只读 | 语法、规则 |
51
- | 路径定义 | `$KITS_DOCS/path-registry.md` | 只读,按需加载 | 所有路径的派生规则或寻找规则 |
52
- | 路径实例 | `$ECK/path-registry.md` | 可变,按需加载 | 已解析的真实值 + 用户自定义路径 |
41
+ | 路径定义 | $KITS_DOCS/path-registry.md | 只读,按需加载 | 所有路径的派生规则或寻找规则 |
42
+ | 路径实例 | $EVOLCORE_HOME/eck/path-registry.md | 可变,按需加载 | 已解析的真实值 + 用户自定义路径 |
53
43
 
54
44
  ### 两类路径
55
45
 
56
- - **可直接派生**:从基础路径按固定规则算出(如 `$KITS = $PACKAGE_ROOT/kits`)
57
- - **不可直接派生**:需按寻找规则搜索。例如:
58
- - `$AUN_SDK`:`node -e "console.log(require.resolve('@agentunion/fastaun/package.json'))"`
59
- —— 本机是**本地依赖** `$PACKAGE_ROOT/node_modules/@agentunion/fastaun`,不是全局包,
60
- `npm ls -g` 查不到
61
- - `$AUN_PROTOCOL_DOCS`:`$AUN_SDK/_packed_docs/protocol`
62
- —— 注意是 `_packed_docs/`,**该包没有 `docs/` 目录**
46
+ - **可直接派生**:从基础路径按固定规则算出(如 `$KITS = $PACKAGE_ROOT/kits`)
47
+ - **不可直接派生**:需按寻找规则搜索。例如:
48
+ - `$AUN_SDK`:`node -e "console.log(require.resolve('@agentunion/fastaun/package.json'))"`
49
+ —— 本机是**本地依赖** `$PACKAGE_ROOT/node_modules/@agentunion/fastaun`,不是全局包,
50
+ `npm ls -g` 查不到
51
+ - `$AUN_PROTOCOL_DOCS`:`$AUN_SDK/_packed_docs/protocol`
52
+ —— 注意是 `_packed_docs/`,**该包没有** `docs/` **目录**
63
53
 
64
54
  ### 按需加载时机
65
55
 
66
56
  路径定义和实例文件**不自动加载**,仅在以下场景 Read:
67
- - 需要访问某个 `$名称` 但当前上下文中没有真实值
68
- - 需要寻找外部依赖位置
69
- - 用户要求注册或查看路径
57
+
58
+ - 需要访问某个 `$名称` 但当前上下文中没有真实值
59
+ - 需要寻找外部依赖位置
60
+ - 用户要求注册或查看路径
70
61
 
71
62
  ## 索引机制
72
63
 
73
64
  | 层 | 位置 | 维护者 | 写入权限 |
74
- |----|------|--------|----------|
75
- | evolcore 级 | `$KITS_DOCS/INDEX.md` | 开发时维护 | 只读,过时时呈报用户 |
76
- | agent 级 | `$AGENT_INDEX/INDEX.md` | agent 会话 | 可写,直接更新 |
65
+ | --- | --- | --- | --- |
66
+ | evolcore 级 | $KITS_DOCS/INDEX.md | 开发时维护 | 只读,过时时呈报用户 |
67
+ | agent 级 | $AGENT_DIR/index/INDEX.md | agent 会话 | 可写,直接更新 |
77
68
 
78
69
  agent 级索引范围:`$CURRENT_PROJECT` + `$AGENT_DIR`。
79
70
 
@@ -82,15 +73,15 @@ agent 级索引范围:`$CURRENT_PROJECT` + `$AGENT_DIR`。
82
73
  ## Bootstrap(独立使用 ECK 时)
83
74
 
84
75
  无 evolcore 动态注入时,路径确定顺序:
85
- 1. `$EVOLCORE_HOME`:环境变量 → `~/.evolcore`
86
- 2. `$PACKAGE_ROOT`:evolcore 安装目录(dev 模式下可能与上一步同一个目录)
87
- 3. 按上面的派生规则构造其余路径
88
-
89
- > ⚠️ **不要指望 `$ECK/runtime.md` 和 `$ECK/path-registry.md`**。这两个文件由
90
- > `src/eck/init.ts` **写一次就不再更新**(`if (fs.existsSync(file)) return`),而且只渲染
91
- > `EVOLCORE_HOME` / `PACKAGE_ROOT` 两个变量,其余 `{{...}}` 占位符会原样留在文件里;
92
- > 源码中也**没有任何地方读回它们**。本机这两个文件仍是 evolclaw 时代生成的,
93
- > 里面写着 `$EVOLCLAW_HOME | /home/evolclaw`。要真实路径就按上面 1-3 步自己算,
76
+
77
+ 1. `$EVOLCORE_HOME`:环境变量 → `~/.evolcore`
78
+ 2. `$PACKAGE_ROOT`:evolcore 安装目录(dev 模式下可能与上一步同一个目录)
79
+ 3. 按上面的派生规则构造其余路径
80
+
81
+ > ⚠️ **不要指望** `$EVOLCORE_HOME/eck/runtime.md` **和** `$EVOLCORE_HOME/eck/path-registry.md`。这两个文件由
82
+ > `src/eck/init.ts` **写一次就不再更新**(`if (fs.existsSync(file)) return`),而且只渲染
83
+ > `EVOLCORE_HOME` / `PACKAGE_ROOT` 两个变量,其余 `{{...}}` 占位符会原样留在文件里;
84
+ > 源码中也**没有任何地方读回它们**。要真实路径就按上面 1-3 步自己算,
94
85
  > 或直接读 `src/paths.ts`。
95
86
 
96
- 参数加载优先级:evolcore 动态注入 > 环境变量 > 硬编码默认值。
87
+ 参数加载优先级:evolcore 动态注入 > 环境变量 > 硬编码默认值。
@@ -1,7 +1,7 @@
1
1
  # 身份层:我是谁
2
2
 
3
- 身份层是当前 agent 的自我认知。ECK 在 identity fragment 注入 `selfAid`(当前 AID),
4
- 并把名片 `$EVOLCORE_HOME/AIDs/<aid>/agent.md` frontmatter 的 `name` 投影为 `selfName`。
3
+ 身份层是当前 agent 的自我认知。ECK 在 identity fragment 注入 `selfAid`(当前 AID),
4
+ 并把名片 `$EVOLCORE_HOME/AIDs/<aid>/agent.md` frontmatter 的 `name` 投影为 `selfName`。
5
5
  `selfName` 仅用于展示,名片缺失或尚未拉取完成时可能为空;身份与授权判断必须使用 `selfAid`。
6
6
 
7
7
  查看名片用 `ec aid agentmd get <aid>`(下载+验签)。该目录是受保护路径,直读会被拒绝。
@@ -9,38 +9,34 @@
9
9
  ## 数据位置
10
10
 
11
11
  | 位置 | 内容 |
12
- |------|------|
13
- | `$PERSONAL_DIR`(`$AGENT_DIR/personal/`) | 个人数据(可写) |
14
- | `$KITS_DOCS/identity/` | 身份层详细规则(只读,按需加载) |
12
+ | --- | --- |
13
+ | $PERSONAL_DIR($AGENT_DIR/personal/) | 个人数据(可写) |
14
+ | $KITS_DOCS/identity/ | 身份层详细规则(只读,按需加载) |
15
15
 
16
16
  > manifest 模板里只认 `$PERSONAL_DIR` / `$RELATIONS_DIR` / `$VENUES_DIR` / `$AGENT_DIR` 这几个路径别名。
17
17
 
18
18
  ## 数据结构(以源码实际读写为准)
19
19
 
20
20
  | 路径 | 用途 | 实际状态 |
21
- |------|------|----------|
22
- | `soul/` 目录 | 常驻自我定义:身份、性格、职责边界、操作铁律 | 每个**非空** `.md` 都注入 system prompt(order 21),由 agent 用文件工具维护;`00-GUIDE.md` 是机制指南 |
23
- | `memory/MEMORY.md` | agent 级 consolidated 记忆索引 | manifest order 36 注入(受 `memory.enableAgent` 开关控制) |
24
- | `memory/pending/` | 待整理记忆(note) | 主会话写入,不注入 |
25
- | `memory/consolidated/` | 正式记忆文件(签名) | 整理会话产出,通过 MEMORY.md 索引按需读取 |
26
- | `$RELATIONS_DIR/<peerKey>/memory/MEMORY.md` | relation 级 consolidated 记忆索引 | manifest order 38 注入(relation 是基础,恒开) |
27
- | `$EVOLCORE_HOME/memory/owner/<ownerAid>/MEMORY.md` | owner 级 consolidated 记忆索引 | manifest order 37 注入(受 `memory.enableOwner` 开关控制) |
28
- | `skills/` 目录 | 预留 | 会被创建,但目前无人读写 |
29
-
30
- > `soul/` 是**唯一**的常驻自我定义载体(`personal.md`、`persona.md` 均已废弃并入)。
31
- > 它没有命令行入口,一律用文件工具直接编辑。每个文件的用途与写入时机见
21
+ | --- | --- | --- |
22
+ | soul/ 目录 | 常驻自我定义:身份、性格、职责边界、操作铁律 | 每个非空 .md 都注入 system prompt(order 21),由 agent 用文件工具维护;00-GUIDE.md 是机制指南 |
23
+ | memory/MEMORY.md | agent 级 consolidated 记忆索引 | manifest 注入(受 memory.enableAgent 开关控制) |
24
+ | memory/pending/ | 待整理记忆(note) | 主会话写入,不注入 |
25
+ | memory/consolidated/ | 正式记忆文件(签名) | 整理会话产出,通过 MEMORY.md 索引按需读取 |
26
+ | `$RELATIONS_DIR/<peerKey>/memory/MEMORY.md` | relation 级 consolidated 记忆索引 | manifest 注入(relation 是基础,恒开) |
27
+ | `$EVOLCORE_HOME/memory/owner/<ownerAid>/MEMORY.md` | owner 级 consolidated 记忆索引 | manifest order 37 注入(受 memory.enableOwner 开关控制) |
28
+
29
+ > `soul/` 是**唯一**的常驻自我定义载体。
30
+ > 它没有命令行入口,一律用文件工具直接编辑。每个文件的用途与写入时机见
32
31
  > `$PERSONAL_DIR/soul/00-GUIDE.md`;只改需要改的段落,不要整体重写。
33
32
 
34
- `memory/episodic.jsonl`、`memory/semantic.md`、`style.md`、`goals.md`、`journal.jsonl`
35
- 是早期设计稿里的约定,**源码尚未实现读写**——不要假设写了就会生效。
36
-
37
33
  ## 人格与行为规范怎么生效
38
34
 
39
- - **注入条件**是 `chatType ≠ null` 且 `lifecycle = active`(即处于正常运行阶段的渠道会话),不是"有没有注入 AID"。生命周期变量缺失时按 `active` 处理;非法生命周期仍失败关闭。本地 coding 模式也不注入。
40
- - soul 目录整段由 evolcore **自动前置**进 system prompt,你不需要主动 Read。
41
- - 目录恒存在:创建 agent 时铺好 `00-GUIDE.md`(机制说明)和 4 个空分册。**空文件不注入**,
42
- 所以未写内容的分册等于不存在。
43
- - 文件位于 `$PERSONAL_DIR/soul/`,直接改文件即可,按 mtime 自动刷新,**改完下一轮系统提示词就重组**,不需要 `ec agent reload`。
44
- - 没有默认人格兜底;分册全空时这一段只剩下指南,行为约束由 `kits/rules/` + `roles/` 权限定义承担。
35
+ - **注入条件**是 `chatType ≠ null` 且 `lifecycle = active`(即处于正常运行阶段的渠道会话),不是"有没有注入 AID"。生命周期变量缺失时按 `active` 处理;非法生命周期仍失败关闭。本地 coding 模式也不注入。
36
+ - soul 目录整段由 evolcore **自动前置**进 system prompt,你不需要主动 Read。
37
+ - 目录恒存在:创建 agent 时铺好 `00-GUIDE.md`(机制说明)和 4 个空分册。**空文件不注入**,
38
+ 所以未写内容的分册等于不存在。
39
+ - 文件位于 `$PERSONAL_DIR/soul/`,直接改文件即可,按 mtime 自动刷新,**改完下一轮系统提示词就重组**,不需要 `ec agent reload`。
40
+ - 没有默认人格兜底;分册全空时这一段只剩下指南,行为约束由 `kits/rules/` + `roles/` 权限定义承担。
45
41
 
46
42
  不同 AID 可以有不同 soul——切换身份即切换设定。
@@ -2,15 +2,16 @@
2
2
 
3
3
  关系层管理你对所有对端的认知。动态注入的 `peerKey`(`<channel>#<urlEncode(peerId)>`)是对端在所有渠道中的稳定标识。`peerId` 是对端在当前渠道的原生 ID(AUN 是 AID,飞书是 user_id 等),`channel` 是当前渠道类型。
4
4
 
5
- **对端包括群**:AID 类型(human/agent/group/service/device/org/host,见 `01-overview.md`)
5
+ **对端包括群**:AID 类型(human/agent/group/service/device/org/host,见 `01-overview.md`)
6
6
  对你而言都是对端,数据都在关系层。
7
- - 私聊:`peerId` = 对端 ID,`peerKey` = `<channel>#<对端ID>`。
8
- - 群聊:`peerId` = **群 ID**(群本身的 AID / 渠道群 ID),群内所有发言者共用同一个 `peerKey`(群的键)。群规则、群 profile 等**具体群实例数据**落 `$RELATIONS_DIR/<peerKey>/`(如群规则物化到 `relations/<peerKey>/rules.md`)。
7
+
8
+ - 私聊:`peerId` = 对端 ID,`peerKey` = `<channel>#<对端ID>`。
9
+ - 群聊:`peerId` = **群 ID**(群本身的 AID / 渠道群 ID),群内所有发言者共用同一个 `peerKey`(群的键)。群规则、群 profile 等**具体群实例数据**落 `$RELATIONS_DIR/<peerKey>/`(如群规则物化到 `relations/<peerKey>/rules.md`)。
9
10
 
10
11
  > 为什么用 `peerId` 而非直接用 AID:非 AUN 渠道的对端(飞书群、微信)没有 AID,用 `<channel>#<peerId>` 才能统一覆盖所有渠道的对端。
11
12
 
12
- relation fragment 注入的全部变量:`peerKey`、`peerId`、`peerName`、`peerRole`、`peerType`,
13
- 群聊另有 `groupId`、`groupRulesStatus`、`groupRulesError`。`groupRulesStatus=ignored` 表示本轮由
13
+ relation fragment 注入的全部变量:`peerKey`、`peerId`、`peerName`、`peerRole`、`peerType`,
14
+ 群聊另有 `groupId`、`groupRulesStatus`、`groupRulesError`。`groupRulesStatus=ignored` 表示本轮由
14
15
  本地 `groupRules.mode=ignore` 主动跳过,不是远端缺失、无权限或同步失败。
15
16
 
16
17
  ## 数据位置
@@ -27,29 +28,19 @@ relations/
27
28
  └── rules.md 仅群目录:校验通过后物化的群规则字节
28
29
  ```
29
30
 
30
- 群规则加载策略按 Agent `config.json` → 当前群 relation `config.json` 覆盖,缺省为 `load`。当有效值为
31
- `ignore` 时,本轮不访问远端规则、不读取本地 `rules.md`、不暴露 `groupRulesPath`;旧文件保留但不
31
+ 群规则加载策略按 Agent `config.json` → 当前群 relation `config.json` 覆盖,缺省为 `load`。当有效值为
32
+ `ignore` 时,本轮不访问远端规则、不读取本地 `rules.md`、不暴露 `groupRulesPath`;旧文件保留但不
32
33
  作为回退来源。该字段仅当前 Agent 的实际 `owner` 关系角色可修改,其他角色可读取当前 relation 的有效值。
33
34
 
34
35
  **例子**:
35
- - AUN 对端:`relations/aun#alice.agentid.pub/`
36
- - 飞书对端:`relations/feishu#ou_xxx/`
37
- - 微信对端:`relations/wechat#wxid_xxx/`
38
-
39
- **下列条目只是设计稿,源码尚未实现——不要假设读了/写了会生效**:
40
36
 
41
- | 条目 | 真实状态 |
42
- |------|----------|
43
- | `<peerKey>/profile.md` | manifest 通过统一的 `peer-profile` 槽加载(缺失即跳过),群聊和私聊不再重复声明;目前**没有任何代码写它**,可以手写一份供上下文加载 |
44
- | `_index/name_<name>.json` 名字反查索引 | 目录会被创建,但**无任何读写代码**,磁盘上全是空目录。"已知 name 反查 peerKey" 这条路走不通 |
45
- | `<peerKey>/history.jsonl` | 关系层无此实现(同名文件都属于 handoff / trigger / CC 自己的历史) |
46
- | `_trash/` | 只创建目录,没有 merge/split 重定向逻辑 |
47
- | `relations/contacts/`、`relations/_observed/` | 目录骨架仍在创建这两个旧结构(`ensureAgentDirSkeleton`),但已不再使用,都是空的 |
48
- | `<peerKey>/behavior.json` | 旧配置残留,已并入 `config.json` |
37
+ - AUN 对端:`relations/aun#alice.agentid.pub/`
38
+ - 飞书对端:`relations/feishu#ou_xxx/`
39
+ - 微信对端:`relations/wechat#wxid_xxx/`
49
40
 
50
41
  ## 查找逻辑
51
42
 
52
- 已知 channel + peerId → 直接拼 `relations/<channel>#<urlEncode(peerId)>/`。这是**唯一可用的查找路径**;
43
+ 已知 channel + peerId → 直接拼 `relations/<channel>#<urlEncode(peerId)>/`。这是**唯一可用的查找路径**;
53
44
  只知道名字("给王老板发消息")时**没有反查索引**(`_index/name_*.json` 是空壳,无实现),直接问用户要 AID。
54
45
 
55
46
  ## 对端身份与权限
@@ -57,21 +48,20 @@ relations/
57
48
  四个内置角色(rank 从高到低)+ 自定义角色 + `none`:
58
49
 
59
50
  | 身份 | rank | 默认 permissionMode | 权限 |
60
- |------|------|--------------------|------|
61
- | owner | 900 | `bypass` | agent 级最高关系权限,可执行 agent 管理和 owner 审批 |
62
- | admin | 700 | `request` | agent 管理权限,不能修改 owner,危险操作向 owner 申请审批 |
63
- | member | 300 | `auto` | 任务型普通成员 |
64
- | visitor | 100 | `readonly` | 只读角色,且是**强制保留角色**(兜底用) |
65
- | 自定义角色 | 按配置 | 缺失/非法时安全兜底 **`readonly`** | 按 agent 角色模板定义 |
51
+ | --- | --- | --- | --- |
52
+ | owner | 900 | bypass | agent 级最高关系权限,可执行 agent 管理和 owner 审批 |
53
+ | admin | 700 | request | agent 管理权限,不能修改 owner,危险操作向 owner 申请审批 |
54
+ | member | 300 | auto | 任务型普通成员 |
55
+ | visitor | 100 | readonly | 只读角色,且是强制保留角色(兜底用) |
56
+ | 自定义角色 | 按配置 | 缺失/非法时安全兜底 readonly | 按 agent 角色模板定义 |
66
57
  | none | — | — | 无有效关系角色,拒绝访问 |
67
58
 
68
- 角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。Agent 级 `owner` 角色只由当前有效的 Ownership 2.1 协议共识确定;进程级 `daemon-owner` 与这里的
69
- Agent/relation 角色正交,不会在 auth 层提升为 `owner`;AUN 的 Owner 只能由当前 Agent AID 的
70
- Ownership 2.1 新鲜共识确认,daemon/Agent 根配置和手写 relation.role 都不授予 Owner。
59
+ 角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。Agent 级 `owner` 角色只由当前有效的 Ownership 2.1 协议共识确定;进程级 `daemon-owner` 与这里的
60
+ Agent/relation 角色正交,不会在 auth 层提升为 `owner`;AUN 的 Owner 只能由当前 Agent AID 的
61
+ Ownership 2.1 新鲜共识确认,daemon/Agent 根配置和手写 relation.role 都不授予 Owner。
71
62
  DaemonOwner 仅获得明确列入进程控制面的操作权限。共识未知时不回退旧配置;非 AUN 渠道保持现有规则。
72
63
 
73
- **兜底链**:无匹配角色 → 回落内置 `visitor`(即 `readonly`);只有角色注册表本身缺失、
64
+ **兜底链**:无匹配角色 → 回落内置 `visitor`(即 `readonly`);只有角色注册表本身缺失、
74
65
  或 `visitor` 未注册时才落到 `none` 拒绝访问。所以正常配置下几乎总是降权到只读,而不是拒绝。
75
66
 
76
- > permissionMode 的合法取值只有 `readonly` / `auto` / `request` / `bypass` 四个。
77
- > "coding" 是**场景**名(无渠道的本地会话,见 `05-venue.md`),**不是** permissionMode。
67
+ > permissionMode 的合法取值只有 `readonly` / `auto` / `request` / `bypass` 四个。