evolcore 0.0.40 → 0.0.41-test.1

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 (226) hide show
  1. package/CHANGELOG.md +94 -1
  2. package/bin/codex-managed-hook.mjs +11 -0
  3. package/bin/ec-safe-output.js +11 -1
  4. package/dist/agents/baseagent-availability.js +1 -1
  5. package/dist/agents/baseagent.js +20 -43
  6. package/dist/agents/claude-runner.js +197 -197
  7. package/dist/agents/codex-runner.js +535 -259
  8. package/dist/agents/ecagent-runner.js +31 -12
  9. package/dist/agents/gemini-runner.js +27 -7
  10. package/dist/agents/runner-types.js +11 -3
  11. package/dist/aun/ability-device-routing.js +26 -0
  12. package/dist/aun/aid/client.js +1 -1
  13. package/dist/aun/group/fs-download.js +39 -0
  14. package/dist/aun/group/identity.js +36 -13
  15. package/dist/aun/group/operations.js +5 -0
  16. package/dist/aun/msg/managed-operation.js +72 -11
  17. package/dist/aun/msg/p2p.js +32 -7
  18. package/dist/aun/service-proxy.js +36 -12
  19. package/dist/aun/storage/download.js +30 -0
  20. package/dist/aun/storage/index.js +14 -6
  21. package/dist/channels/aun.js +367 -24
  22. package/dist/channels/daemon.js +39 -5
  23. package/dist/cli/agent-command.js +2 -0
  24. package/dist/cli/agent-create.js +98 -19
  25. package/dist/cli/agent.js +10 -3
  26. package/dist/cli/aun-commands.js +85 -41
  27. package/dist/cli/daemon-commands.js +678 -688
  28. package/dist/cli/fs-command.js +64 -2
  29. package/dist/cli/index.js +48 -4
  30. package/dist/cli/managed-command-guard.js +4 -0
  31. package/dist/cli/model.js +40 -40
  32. package/dist/cli/proxy-command.js +92 -0
  33. package/dist/cli/restart-monitor.js +17 -0
  34. package/dist/cli/role.js +85 -0
  35. package/dist/cli/session-command.js +128 -13
  36. package/dist/cli/stats.js +60 -4
  37. package/dist/cli/trigger-command.js +2 -2
  38. package/dist/config/access-policy.js +8 -1
  39. package/dist/config/boot-log.js +38 -1
  40. package/dist/config/config-field-policy.js +5 -32
  41. package/dist/config/config-manager.js +46 -39
  42. package/dist/config/config-operation-service.js +8 -11
  43. package/dist/config/contact-book-store.js +47 -21
  44. package/dist/config/contact-book.js +18 -12
  45. package/dist/config/contact-operation-service.js +3 -4
  46. package/dist/config/contact-request-service.js +11 -0
  47. package/dist/config/daemon-services.js +11 -0
  48. package/dist/config/gateway-config.js +89 -595
  49. package/dist/config/peer-role-resolver.js +15 -11
  50. package/dist/config/providers-config.js +12 -7
  51. package/dist/config/providers-import.js +3 -21
  52. package/dist/config/resolved-config-op.js +3 -0
  53. package/dist/config/role-command-service.js +166 -0
  54. package/dist/config/role-request-service.js +193 -0
  55. package/dist/config/schema-migration.js +686 -25
  56. package/dist/config-store.js +79 -3
  57. package/dist/contracts/ecweb-instance.js +41 -0
  58. package/dist/contracts/ecweb-service-protocol.js +3 -1
  59. package/dist/core/agent-application-service.js +11 -1
  60. package/dist/core/agent-ipc-registration.js +4 -0
  61. package/dist/core/agent-runtime.js +1 -1
  62. package/dist/core/auth/agent-delegation.js +82 -6
  63. package/dist/core/auth/auth-gateway.js +1 -1
  64. package/dist/core/auth/authorization-audit.js +37 -9
  65. package/dist/core/auth/delegation-authorization.js +3 -1
  66. package/dist/core/auth/operation-authorizer.js +15 -0
  67. package/dist/core/auth/operation-catalog.js +39 -6
  68. package/dist/core/command/agent-control.js +94 -19
  69. package/dist/core/command/agent-storage-menu.js +5 -3
  70. package/dist/core/command/cli-intent-parser.js +2 -1
  71. package/dist/core/command/command-handler.js +105 -145
  72. package/dist/core/command/connect-menu.js +31 -2
  73. package/dist/core/command/data-root-resolver.js +5 -4
  74. package/dist/core/command/memory-slash.js +16 -8
  75. package/dist/core/command/menu-catalog.js +6 -6
  76. package/dist/core/command/menu-handler.js +87 -163
  77. package/dist/core/command/menu-protocol.js +9 -2
  78. package/dist/core/command/role-menu.js +148 -30
  79. package/dist/core/command/slash-gate.js +13 -10
  80. package/dist/core/command/slash-handler.js +157 -352
  81. package/dist/core/daemon-control.js +8 -14
  82. package/dist/core/event-catalog.js +15 -0
  83. package/dist/core/evolagent-registry.js +4 -4
  84. package/dist/core/evolagent.js +2 -2
  85. package/dist/core/inference/text-inference.js +31 -40
  86. package/dist/core/ipc-registration.js +24 -3
  87. package/dist/core/memory/consolidation-context.js +51 -5
  88. package/dist/core/memory/consolidation-ops-records.js +1 -1
  89. package/dist/core/memory/consolidation-trigger.js +190 -190
  90. package/dist/core/memory/consolidation.js +316 -29
  91. package/dist/core/memory/forget-log.js +96 -0
  92. package/dist/core/memory/index-manager.js +27 -5
  93. package/dist/core/memory/memory-admin.js +45 -5
  94. package/dist/core/memory/memory-writer.js +163 -18
  95. package/dist/core/memory/relation-idle-monitor.js +119 -58
  96. package/dist/core/memory/relation-sweep.js +44 -39
  97. package/dist/core/message/aun-ipc-sender.js +34 -7
  98. package/dist/core/message/aun-request-registry.js +97 -3
  99. package/dist/core/message/im-renderer.js +11 -4
  100. package/dist/core/message/message-admission.js +97 -8
  101. package/dist/core/message/message-bridge.js +71 -24
  102. package/dist/core/message/message-log.js +55 -0
  103. package/dist/core/message/message-queue.js +5 -5
  104. package/dist/core/message/response-engine.js +387 -144
  105. package/dist/core/model/catalog-service.js +4 -2
  106. package/dist/core/model/config-scope.js +24 -64
  107. package/dist/core/model/field-scope.js +1 -1
  108. package/dist/core/model/model-catalog.js +37 -47
  109. package/dist/core/model/model-diagnostics.js +4 -3
  110. package/dist/core/model/model-fallback.js +10 -7
  111. package/dist/core/model/model-permission.js +3 -2
  112. package/dist/core/ownership/owner-resolver.js +25 -23
  113. package/dist/core/permission/ec-command-parser.js +138 -5
  114. package/dist/core/permission/sandbox-runtime.js +18 -1
  115. package/dist/core/permission/tool-policy.js +42 -10
  116. package/dist/core/relation/peer-identity.js +64 -1
  117. package/dist/core/role/runtime-policy.js +72 -13
  118. package/dist/core/session/session-capsule.js +197 -0
  119. package/dist/core/session/session-idle-monitor.js +1 -1
  120. package/dist/core/session/session-manager.js +168 -14
  121. package/dist/core/session/session-mapper.js +2 -0
  122. package/dist/core/session/session-renew.js +3 -3
  123. package/dist/core/skill/index-generator.js +15 -5
  124. package/dist/core/system-session/memory.js +6 -1
  125. package/dist/core/thread/thread-service.js +19 -6
  126. package/dist/directory/owner-directory-admission.js +95 -0
  127. package/dist/directory/owner-directory-authorization.js +309 -0
  128. package/dist/directory/owner-directory-cache.js +635 -0
  129. package/dist/eck/kit-renderer.js +2 -2
  130. package/dist/ecweb/basic-settings-service.js +33 -40
  131. package/dist/ecweb/message-context-service.js +110 -0
  132. package/dist/index.js +79 -17
  133. package/dist/ipc.js +189 -17
  134. package/dist/paths.js +4 -0
  135. package/dist/proxy/command.js +122 -0
  136. package/dist/proxy/ipc-service.js +68 -0
  137. package/dist/proxy/manager.js +485 -0
  138. package/dist/proxy/service-supervisor.js +603 -0
  139. package/dist/response-system/engines/v1/proactive-flow.js +16 -6
  140. package/dist/stats/budget.js +1 -1
  141. package/dist/stats/db.js +15 -0
  142. package/dist/stats/index.js +2 -2
  143. package/dist/stats/price-resolver.js +304 -5
  144. package/dist/stats/query.js +82 -3
  145. package/dist/stats/writer.js +38 -5
  146. package/dist/trigger/feedback.js +18 -7
  147. package/dist/trigger/manager.js +20 -3
  148. package/dist/trigger/parser.js +6 -3
  149. package/dist/trigger/patch.js +1 -1
  150. package/dist/trigger/system-definitions.js +43 -7
  151. package/dist/trigger/validation.js +13 -5
  152. package/dist/utils/cross-platform.js +14 -0
  153. package/dist/utils/ecweb-supervisor.js +258 -83
  154. package/dist/utils/error-utils.js +16 -2
  155. package/dist/utils/logger.js +24 -5
  156. package/dist/utils/npm-ops.js +2 -1
  157. package/dist/utils/package-version-info.js +5 -3
  158. package/dist/utils/upgrade-jobs.js +45 -5
  159. package/kits/docs/INDEX.md +1 -1
  160. package/kits/docs/aun/ABILITY_CALLING.md +20 -2
  161. package/kits/docs/channels/aun.md +9 -0
  162. package/kits/docs/evolcore/INDEX.md +2 -1
  163. package/kits/docs/evolcore/agent-create.md +3 -2
  164. package/kits/docs/evolcore/agent.md +1 -1
  165. package/kits/docs/evolcore/config.md +18 -7
  166. package/kits/docs/evolcore/contact.md +3 -0
  167. package/kits/docs/evolcore/event.md +1 -0
  168. package/kits/docs/evolcore/fs.md +16 -0
  169. package/kits/docs/evolcore/memory-architecture.md +2 -2
  170. package/kits/docs/evolcore/memory-consolidation.md +32 -8
  171. package/kits/docs/evolcore/memory.md +1 -1
  172. package/kits/docs/evolcore/menu-protocol.md +36 -0
  173. package/kits/docs/evolcore/model.md +23 -20
  174. package/kits/docs/evolcore/msg.md +21 -8
  175. package/kits/docs/evolcore/session.md +14 -0
  176. package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
  177. package/kits/schemas/_meta.json +37 -4
  178. package/kits/schemas/agent-config.schema.13.json +23 -3
  179. package/kits/schemas/agent-config.schema.16.json +891 -0
  180. package/kits/schemas/daemon.schema.9.json +366 -0
  181. package/kits/schemas/defaults.schema.5.json +406 -127
  182. package/kits/schemas/relation-config.schema.11.json +260 -0
  183. package/kits/schemas/role-config.schema.1.json +7 -7
  184. package/kits/skills/.switches.json +3 -7
  185. package/kits/skills/aid-ability/SKILL.md +35 -6
  186. package/kits/skills/ec-service-proxy/SKILL.md +118 -0
  187. package/kits/skills/ec-trigger/SKILL.md +13 -5
  188. package/kits/skills/personal-assistant/SKILL.md +176 -0
  189. package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
  190. package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
  191. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
  192. package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
  193. package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
  194. package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
  195. package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
  196. package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
  197. package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
  198. package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
  199. package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
  200. package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
  201. package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
  202. package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
  203. package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
  204. package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
  205. package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
  206. package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
  207. package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
  208. package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
  209. package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
  210. package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
  211. package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
  212. package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
  213. package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
  214. package/kits/templates/memory-consolidation/forget.md +19 -6
  215. package/kits/templates/memory-consolidation/notes.md +1 -1
  216. package/kits/templates/memory-consolidation/profile.md +2 -2
  217. package/kits/templates/memory-consolidation/promote.md +20 -3
  218. package/kits/templates/roles/member.json +8 -1
  219. package/kits/templates/session-capsule/recovery.md +5 -0
  220. package/kits/templates/session-capsule/renew.md +5 -0
  221. package/kits/templates/system-fragments/baseagent.md +2 -2
  222. package/kits/templates/system-fragments/bootstrap.md +6 -6
  223. package/kits/templates/system-fragments/channel.md +1 -1
  224. package/kits/templates/system-fragments/memory.md +4 -4
  225. package/package.json +7 -3
  226. package/dist/stats/billing.js +0 -215
@@ -0,0 +1,205 @@
1
+ # 初始化与落地机制
2
+
3
+ > 版本:0.1(草案,待评审)
4
+ > 对应:`01-workspace-spec.md` 定义的目标结构
5
+ > 范围:从"装上技能"到"一台能自己跑的助理"
6
+
7
+ ---
8
+
9
+ ## 1. 这份文档解决什么
10
+
11
+ 技能本身只是说明书和脚本。**真正让助理活起来的,是初始化**——它要一次性把目录、索引、触发器、状态全部建对,之后才能无人值守地运转。
12
+
13
+ 初始化做错一次,后面每天都在错的地方跑。
14
+
15
+ ---
16
+
17
+ ## 2. 怎么触发初始化
18
+
19
+ ### 2.1 标准话术
20
+
21
+ 用户说以下任意一句,即视为初始化意图:
22
+
23
+ | 说法 | 说明 |
24
+ |---|---|
25
+ | **「初始化个人助理」** | 标准触发词,推荐 |
26
+ | 「初始化个人助手技能」 | 等价 |
27
+ | 「给我建个助理工作区」 | 等价 |
28
+ | 「安装个人助理」 | 等价 |
29
+
30
+ ### 2.2 技能自己怎么判断
31
+
32
+ SKILL.md 的 `description` 里要写明触发条件:
33
+
34
+ ```yaml
35
+ ---
36
+ name: personal-assistant
37
+ description: 个人助理工作区。当用户要求"初始化个人助理/个人助手""建助理工作区""安装个人助理",
38
+ 或要求归档对话、生成日报周报月报、整理记忆、管理任务时使用。
39
+ ---
40
+ ```
41
+
42
+ 宿主靠 `name` + `description` 决定何时加载。加载后按本文档执行。
43
+
44
+ ### 2.3 用户不需要知道的事
45
+
46
+ 用户只要说一句话。**目录怎么建、触发器怎么装、索引怎么生成,全部由技能自己完成**,不要求用户理解内部结构。
47
+
48
+ 这是做成技能的核心价值:**把复杂度锁在技能里。**
49
+
50
+ ---
51
+
52
+ ## 3. 初始化流程
53
+
54
+ ### 阶段 0:前置检查(只读,不改任何东西)
55
+
56
+ | 检查项 | 不通过时 |
57
+ |---|---|
58
+ | 目标路径是否可写 | 报告具体路径和权限错误,停止 |
59
+ | 是否已存在工作区 | 存在 → 走「升级/修复」模式(见 §4) |
60
+ | `node` 是否可用(`node -v`) | 不可用 → 报告,说明哪些功能会降级 |
61
+ | `ec` 命令是否可用 | 不可用 → 报告,只有目录功能可用,触发器装不了 |
62
+ | 磁盘剩余空间 | < 1 GB → 警告但不阻塞 |
63
+
64
+ **阶段性输出**:检查结果一张表,明确"哪些能做、哪些不能做"。
65
+
66
+ ### 阶段 1:建目录骨架
67
+
68
+ 按 `01-workspace-spec.md` 建全部目录。
69
+
70
+ ```
71
+ README.md
72
+ INDEX.md
73
+ capture/{conversation,notes,links,files,scene,listening,meeting,track,_manifest,_inbox,_archive}
74
+ output/{reports/{daily,weekly,monthly,quarterly,yearly},meetings,tasks,knowledge/{memory/{rules,facts,entities/{people,org},episodes},profile/{people,org},topics},_archive}
75
+ .assistant/{index,logs,tmp,locks,cache}
76
+ ```
77
+
78
+ **空目录不放 `.gitkeep`**:目录树由 `scripts/init` 每次校验重建,不靠占位文件。
79
+
80
+ ### 阶段 2:写 README 与 INDEX
81
+
82
+ 两份模板由 `templates/` 提供,变量只有三个:工作区名、创建时间、技能版本。
83
+
84
+ **硬性约束:README 与 INDEX 只描述本规范定义的目录。**
85
+
86
+ 不得出现、不得引用任何历史遗留结构(旧的 `vault/` 之类)。旧数据如果要保留,就地封存并在 README 外单独记录,**不进入索引**。
87
+
88
+ ### 阶段 3:写 `.assistant/state.json`
89
+
90
+ ```json
91
+ {
92
+ "workspace_version": 1,
93
+ "skill_version": "0.1.0",
94
+ "created_at": "2026-10-27T15:00:00+08:00",
95
+ "updated_at": "2026-10-27T15:00:00+08:00",
96
+ "triggers": ["ingest-daily", "report-daily", "..."],
97
+ "capabilities": {
98
+ "conversation_ingest": true,
99
+ "observation_ingest": false,
100
+ "script_trigger": false
101
+ }
102
+ }
103
+ ```
104
+
105
+ `capabilities` 记录**这台机器实际能做什么**——初始化时检测到的结果。后续脚本据此决定跳过还是降级,而不是硬跑然后报错。
106
+
107
+ ### 阶段 4:安装触发器
108
+
109
+ **必须用 `--file` 导入 Trigger V3 JSON**,不能用 CLI flag 模式——flag 模式强制 `feedback.strategy=target`,而我们的定时任务大多是 `silent`。
110
+
111
+ ```bash
112
+ ec trigger create --exec trigger-session --file triggers/ingest-daily.json --enable
113
+ ```
114
+
115
+ 默认安装的触发器:
116
+
117
+ | 名称 | 调度 | 类型 | 作用 | 反馈 |
118
+ |---|---|---|---|---|
119
+ | `ingest-daily` | `50 23 * * *` | trigger-session | 落当天对话与观察数据 | silent |
120
+ | `ingest-on-idle` | 事件 `session:idle` | trigger-session | 会话结束增量落地 | silent |
121
+ | `report-daily` | `30 22 * * *` | trigger-session | 生成日报 | silent |
122
+ | `report-weekly` | `0 21 * * 0` | trigger-session | 生成周报 | silent |
123
+ | `report-monthly` | `0 9 1 * *` | trigger-session | 生成月报 + 归档巡检 | silent |
124
+ | `memory-consolidate` | `0 2 * * *` | trigger-session | 记忆整理与演进 | silent |
125
+
126
+ **每个触发器装完要验证**:`ec trigger list --json` 里能看到、`nextFireAt` 正常。
127
+
128
+ 装失败的单独报告,不因为一个失败就整体回滚——助理有 80% 功能可用,胜过一次都不跑。
129
+
130
+ ### 阶段 5:验收
131
+
132
+ 输出一份清单,让用户一眼知道"成了没有":
133
+
134
+ ```
135
+ ✅ 工作区已创建:/evolcore-projects/xxx
136
+ ✅ 目录:4 个根项 + 29 个子目录
137
+ ✅ README / INDEX 已生成
138
+ ✅ state.json 已写入(技能版本 0.1.0)
139
+ ✅ 触发器:5 个已启用
140
+ ├─ ingest-daily 下次 23:50
141
+ ├─ ingest-on-idle 事件驱动
142
+ ├─ report-daily 下次 22:30
143
+ ├─ report-weekly 下次 周日 21:00
144
+ └─ memory-consolidate 下次 02:00
145
+ ⚠️ 观察数据落地不可用(当前环境限制,见 03-data-flow-and-gaps.md)
146
+ ⚠️ 脚本触发器不可用,已全部改用会话型触发器
147
+ ```
148
+
149
+ **验收标准(全部满足才算成功):**
150
+ 1. 四个根项 + `.assistant/` 存在
151
+ 2. `INDEX.md` 可被 `scripts/index-rebuild` 重建且内容一致
152
+ 3. `state.json` 可读,版本号正确
153
+ 4. 至少 `ingest-daily` 和 `report-daily` 两个触发器处于 enabled
154
+ 5. 已报告的能力缺口,用户知情
155
+
156
+ ---
157
+
158
+ ## 4. 幂等与升级
159
+
160
+ ### 4.1 重复初始化
161
+
162
+ 检测到已有工作区时**不推倒重来**,走修复模式:
163
+
164
+ | 情况 | 处理 |
165
+ |---|---|
166
+ | 目录缺失 | 补建 |
167
+ | `state.json` 缺失 | 重建,标记 `recovered: true` |
168
+ | 技能版本升级 | 保留全部数据,只更新 `state.json` 和触发器定义 |
169
+ | 触发器丢失或被禁用 | 重新安装,不重复创建(按 `name` 去重) |
170
+
171
+ **永远不删用户数据。** 修复模式只做加法。
172
+
173
+ ### 4.2 版本迁移
174
+
175
+ `workspace_version` 变更时,按 `migrations/` 下的脚本逐步迁移,每一步可回滚。迁移前自动把 `state.json` 和目录结构快照到 `.assistant/logs/migrate-<ts>.json`。
176
+
177
+ ---
178
+
179
+ ## 5. 未来的内置化(本版不实现,只留位置)
180
+
181
+ 目标形态有两种,都不在本次范围内:
182
+
183
+ **A. 检测式自动初始化**
184
+ EvolCore 检测到新对端是"个人"类型时,自动创建工作区。
185
+
186
+ **B. 创建式初始化**
187
+ 创建 EvolAgent 时,若声明的身份是个人助理,则在初始化阶段直接调用本技能的 `init`。
188
+
189
+ 这两种都需要 EvolCore 侧配合(注册默认技能、决定触发时机、保证幂等)。**当前只做手动触发**,把机制跑通,再谈自动化。
190
+
191
+ 留给未来的接口约定:
192
+
193
+ - `scripts/init --auto --owner <aid>` 必须支持静默执行(无交互)
194
+ - 退出码语义固定:`0` 成功、`10` 已存在无需操作、`20` 部分成功、`30` 前置条件不满足
195
+
196
+ 这样将来 EvolCore 直接调用即可,不需要改脚本。
197
+
198
+ ---
199
+
200
+ ## 6. 失败处理原则
201
+
202
+ 1. **不静默失败**:任何一步失败都要在验收清单里出现
203
+ 2. **不整体回滚**:部分可用好过全部不可用
204
+ 3. **不改用户数据**:修复模式只做加法
205
+ 4. **不留半成品**:创建到一半失败时,把已建的部分列清楚,下次可续建
@@ -0,0 +1,177 @@
1
+ # 数据流转机制与能力缺口
2
+
3
+ > 版本:0.1(草案,待评审)
4
+ > 记录时间:2026-10-27
5
+ > 性质:**实测记录 + 缺口清单**,不是设计文档。所有"不可行"都有原始报错为据。
6
+
7
+ ---
8
+
9
+ ## 1. 三种驱动力
10
+
11
+ 整个系统只用三种驱动力,没有第四种:
12
+
13
+ | 驱动力 | 管什么 | 特征 | 失败表现 |
14
+ |---|---|---|---|
15
+ | **触发器**(EvolCore) | 什么时候做 | 定时 cron、事件订阅 | 不触发 / 触发但空跑 |
16
+ | **模型**(会话) | 这次该做什么 | 判断、取舍、生成内容 | 判断错、漏做、做多 |
17
+ | **脚本**(技能) | 具体怎么做 | 确定性、可测试、幂等 | 报错、写坏、重复写 |
18
+
19
+ **裁决原则**:能用脚本做的,不交给模型(模型不确定、贵、慢);需要判断的,不交给脚本(规则写不全);只在需要调度时才用触发器。
20
+
21
+ ---
22
+
23
+ ## 2. 每条数据流由谁驱动
24
+
25
+ | # | 数据流 | 触发器 | 模型 | 脚本 |
26
+ |---|---|---|---|---|
27
+ | 1 | 对话正文落地 | ✅ 每日 cron + `session:idle` | 判断落地范围、补漏 | 写文件、算摘要、写 manifest |
28
+ | 2 | 记忆导出与演进 | ✅ 每日 cron | 判断哪条该合并、该废弃 | 写文件、标记 superseded |
29
+ | 3 | 手机观察落地 | ✅ 每日 cron | 判断哪些数据类型值得取 | 申请授权、下载、解包 |
30
+ | 4 | 用户投喂(口述/链接/文件) | ❌ 不需要(消息到达即触发) | 判断归类、写摘要 | 写文件、更新索引 |
31
+ | 5 | 会议落地 | ✅ 聆听结束事件 | 判断是否值得提炼 | 写转写、生成 meta |
32
+ | 6 | 日报/周报/月报 | ✅ cron | 生成正文(**必须模型**) | 汇总数据、渲染模板 |
33
+ | 7 | 索引重建 | ✅ 每日 cron | 不需要 | 全量扫描 frontmatter |
34
+ | 8 | 冷热归档 | ✅ 每月 cron | 不需要 | 移动文件、更新索引 |
35
+ | 9 | 完整性校验 | ✅ 每周 cron | 不需要 | 比对 sha256 |
36
+
37
+ **结论:模型只负责"第 6 项"这类必须生成文本的地方,以及归类的判断;其余全部交给脚本。**
38
+
39
+ 这是成本和稳定性的关键——如果每条流都过一遍模型,一天几十次调用,既贵又漂移。
40
+
41
+ ---
42
+
43
+ ## 3. 实测记录(2026-10-27)
44
+
45
+ ### 3.1 已验证可用
46
+
47
+ | 机制 | 验证方式 | 结果 |
48
+ |---|---|---|
49
+ | cron 定时触发 | 查看现有 3 个触发器运行记录 | ✅ 正常(8:30 / 10-18 点每 2 小时 / 21:30) |
50
+ | `target-session` 拉起会话 | 日历巡检实际执行 | ✅ 12:00、14:00 均正常返回 |
51
+ | `--file` 导入 Trigger V3 JSON | 实建一个 `probe-script-feasibility` 后删除 | ✅ 导入成功,字段完整 |
52
+ | `ec thread history` 读对话 | 实读主话题 527 条、跨对端 259 条 | ✅ **推荐用法**;按话题切分,字段齐全 |
53
+ | `ec thread peers / list` | 实测 | ✅ 19 个对端、30 个话题,JSON 结构完整 |
54
+ | `ec thread history --after/--before` | 实测 | ✅ 时间过滤有效,返回升序 |
55
+ | 位置能力 `location/current` | 实际调用 4 次 | ✅ 成功,但返回缓存值(见 G5) |
56
+ | 日历能力 `calendar/manage` | 多次调用 | ✅ 成功(注意:`list` 不接受 `calendar_id`) |
57
+
58
+ ### 3.2 实测失败
59
+
60
+ **G1|Windows 上脚本触发器被沙箱拒绝**
61
+
62
+ ```json
63
+ {
64
+ "type": "run.failed",
65
+ "error": {
66
+ "message": "Windows sandbox cannot prove scoped read isolation;
67
+ Trigger script execution is refused: read isolation is not enforced"
68
+ }
69
+ }
70
+ ```
71
+
72
+ - **复现**:创建 `--exec script` 的触发器并触发,约 8 秒内失败
73
+ - **原因**:Windows 需要「支持受限读取策略的原生 Codex CLI + 宿主已准备好的 elevated sandbox」,当前环境无法证明读隔离
74
+ - **注意**:系统自带的 `__memory-consolidation-check` 也是 script 类型却能跑,因为它是 **daemon 自有**触发器(走宿主执行路径),不受此限制
75
+
76
+ **G2|观察数据在托管会话中读不到**
77
+
78
+ ```bash
79
+ ec rpc --as toleiliang8.agentid.pub --params '{"method":"storage.get_by_share",...}'
80
+ # ❌ [NOT_ALLOWED] Command rpc is not available in a managed Agent task
81
+
82
+ ec fs cat leiliang.agentid.cn:/.evol/observation-access/v1/snapshots/.../manifest-0001.json
83
+ # ❌ forbidden
84
+ ```
85
+
86
+ - 授权本身能拿到(`personal/observations` 返回 `status: active`、`grant_id`、`share_id`)
87
+ - **但拿到授权也读不了内容**——读取路径被托管会话策略挡住了
88
+
89
+ **G3|跨对端历史导出受限 —— 已解除(2026-10-28)**
90
+
91
+ 原判断基于 `ec msg history`。改用 `ec thread history <peer> --self <selfAid>` 后可跨对端读取,
92
+ 实测成功读到其他对端的 259 条历史。
93
+
94
+ > 注意:不带 `--self` 会报 `✗ peer is required`。
95
+
96
+ ### 3.3 有效但需注意
97
+
98
+ | 现象 | 说明 |
99
+ |---|---|
100
+ | `ec trigger show <id>` 报错 | `Cannot find module dist/cli/trigger-command.js`。`list`/`create`/`delete` 正常,只有 `show` 坏 |
101
+ | `calendar/manage` 的 `list` 不接受 `calendar_id` | 带上就返回 `params_invalid`,去掉即可 |
102
+ | 能力调用需要 `--device-id` | 不带报 `ABILITY_DEVICE_REQUIRED`;两台设备中只有一台在线 |
103
+ | `--return required` 可能返回 `message_expired` | 设备不在线时的表现,不是参数错误 |
104
+
105
+ ---
106
+
107
+ ## 4. 缺口清单
108
+
109
+ | 编号 | 缺口 | 影响 | 临时方案 | 正式方案 |
110
+ |---|---|---|---|---|
111
+ | **G1** | 脚本触发器在 Windows 不可用 | 定时任务只能走会话,成本高一个量级 | 全部改用 `trigger-session`,由会话执行脚本 | EvolCore 提供可用沙箱,或提供 daemon 级"受信脚本触发器"注册 |
112
+ | **G2** | 观察数据读不到 | 位置/聆听/照片三类最有价值的原料只能存不能取 | 落空目录占位,保留接口 | EvolCore 开放托管会话读取观察数据的命令或 API |
113
+ | ~~**G3**~~ | ~~跨对端历史受限~~ | **已解除**:`ec thread history <peer> --self` 可读 | — | — |
114
+ | **G4** | 事件 `session:idle` 未实测 | "会话结束落地"可能不成立 | 退回每日全量 | 实测并调参(idle 阈值、过滤条件) |
115
+ | **G5** | 位置能力返回缓存值 | 位置轨迹精度不可信 | 明确标注 `cached: true` | 能力侧支持强制刷新定位 |
116
+ | **G6** | `trigger-session` 类型未实测 | 全部触发器依赖它,是单点风险 | 先小范围试 | 实测 + 准备 `target-session` 兜底 |
117
+ | **G7** | 记忆导出路径未验证 | 记忆落地可能做不了 | 从会话上下文重建 | 确认 `agents/<aid>/personal/memory` 可读,或提供导出命令 |
118
+ | ~~**G8**~~ | ~~幂等键不确定~~ | **已解除**:`msgId` 稳定唯一,作为幂等键 | — | — |
119
+ | **G9** | 大文件/录音的引用如何取回未验证 | 引用存了但可能取不回 | 只存元数据 | 验证 `storage download` 对引用路径的可用性 |
120
+ | **G10** | 并发写同一天的锁机制未验证 | cron 与事件撞车可能写脏 | 单写者串行 | 实测文件锁在 Windows 的行为 |
121
+ | **G12** | 话题历史没有文本搜索 | 只能按时间翻,找一句话要翻几百条 | `search.mjs` 落地后本地检索 | EvolCore 给 `history` 加 `--search` |
122
+
123
+ ### 4.1 `ec thread history` 的三个坑(实测)
124
+
125
+ | 坑 | 表现 | 正确用法 |
126
+ |---|---|---|
127
+ | `--limit N` 是「最近 N 条」 | `--after 0 --limit 3` 返回的是最新 3 条,不是最早 3 条 | 回填必须用 `--before <ts>` 往前翻 |
128
+ | 跨对端必须带 `--self` | 不带报 `✗ peer is required` | `ec thread history <peer> --self <selfAid>` |
129
+ | 非主话题必须用 `peer/threadId` | 只传 `thread-xxx` 报 `peer is required` | `ec thread history <peer>/<thread-xxx> --self <aid>` |
130
+
131
+ ---
132
+
133
+ ## 5. 三份文档各自的问题
134
+
135
+ | 文档 | 已知问题 | 优先级 |
136
+ |---|---|---|
137
+ | `01-workspace-spec.md` | ① `track/` 四类数据的字段定义还没定;② `_archive/` 的索引分片规则没写细;③ 没有定义 `capture/files/` 里大文件的引用格式 | 中 |
138
+ | `02-bootstrap.md` | ① 触发器清单是"理想清单",受 G1/G4/G6 影响,实际能装的更少;② 升级迁移只给了原则,没有具体迁移脚本设计 | 高 |
139
+ | `03-data-flow-and-gaps.md`(本文) | ① G5–G10 尚未实测,结论可能变;② 没有给出每条的验证步骤脚本 | 高 |
140
+
141
+ ---
142
+
143
+ ## 6. 待验证清单(按优先级)
144
+
145
+ - [ ] **G6**:`trigger-session` 能否正常拉起并 silent 返回 → 影响全部触发器
146
+ - [ ] **G4**:`session:idle` 事件的 payload 是否含 `sessionId`,过滤能否生效
147
+ - [ ] **G8**:`ec msg history --format json` 是否返回可作幂等键的字段
148
+ - [ ] **G7**:`.evolcore/agents/<aid>/personal/memory/` 是否可读
149
+ - [ ] **G10**:Windows 下文件锁的行为
150
+ - [ ] **G5**:位置能力是否有强制刷新参数
151
+ - [ ] **G9**:存储引用的可下载性
152
+
153
+ ---
154
+
155
+ ## 7. 最低可行版本(MVP)的边界
156
+
157
+ 先跑起来,跑的是这个范围:
158
+
159
+ **做:**
160
+ - 目录骨架 + README + INDEX
161
+ - 对话正文落地(当前对端)
162
+ - 用户投喂的笔记、链接、文件
163
+ - 日报 / 周报 / 月报
164
+ - 记忆整理(从会话上下文重建,不依赖导出)
165
+ - 索引重建、归档、清单校验
166
+
167
+ **不做(占位等 G1/G2/G3 解决):**
168
+ - 手机观察数据(位置、聆听、照片)
169
+ - 全量跨对端历史
170
+ - 脚本型触发器
171
+
172
+ **MVP 的验收标准**:连续跑 7 天,每天三件事成立——
173
+ 1. 当天对话在 `capture/conversation/` 里能查到
174
+ 2. 每天晚上有日报
175
+ 3. `_manifest/` 连续无缺失
176
+
177
+ 七天后带着真实问题回来迭代,比纸面设计再完美都值钱。