evolcore 0.0.41-test.0 → 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 (177) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/dist/agents/baseagent-availability.js +1 -1
  3. package/dist/agents/baseagent.js +20 -43
  4. package/dist/agents/claude-runner.js +177 -92
  5. package/dist/agents/codex-runner.js +84 -28
  6. package/dist/agents/ecagent-runner.js +1 -1
  7. package/dist/agents/gemini-runner.js +1 -1
  8. package/dist/aun/group/fs-download.js +39 -0
  9. package/dist/aun/group/identity.js +36 -21
  10. package/dist/aun/group/operations.js +5 -0
  11. package/dist/aun/msg/managed-operation.js +68 -7
  12. package/dist/aun/msg/p2p.js +5 -0
  13. package/dist/aun/service-proxy.js +36 -12
  14. package/dist/channels/aun.js +334 -20
  15. package/dist/channels/daemon.js +15 -1
  16. package/dist/cli/aun-commands.js +4 -20
  17. package/dist/cli/daemon-commands.js +678 -697
  18. package/dist/cli/fs-command.js +64 -2
  19. package/dist/cli/index.js +48 -4
  20. package/dist/cli/managed-command-guard.js +4 -0
  21. package/dist/cli/model.js +40 -40
  22. package/dist/cli/proxy-command.js +92 -0
  23. package/dist/cli/role.js +85 -0
  24. package/dist/config/access-policy.js +7 -2
  25. package/dist/config/boot-log.js +38 -1
  26. package/dist/config/config-field-policy.js +5 -32
  27. package/dist/config/config-manager.js +46 -39
  28. package/dist/config/config-operation-service.js +5 -19
  29. package/dist/config/contact-book-store.js +47 -21
  30. package/dist/config/contact-book.js +18 -12
  31. package/dist/config/contact-operation-service.js +3 -4
  32. package/dist/config/contact-request-service.js +11 -0
  33. package/dist/config/daemon-services.js +11 -0
  34. package/dist/config/gateway-config.js +88 -594
  35. package/dist/config/peer-role-resolver.js +13 -11
  36. package/dist/config/providers-config.js +12 -7
  37. package/dist/config/providers-import.js +3 -21
  38. package/dist/config/resolved-config-op.js +3 -0
  39. package/dist/config/role-command-service.js +166 -0
  40. package/dist/config/role-request-service.js +193 -0
  41. package/dist/config/schema-migration.js +686 -25
  42. package/dist/config-store.js +79 -3
  43. package/dist/contracts/ecweb-instance.js +41 -0
  44. package/dist/contracts/ecweb-service-protocol.js +3 -1
  45. package/dist/core/agent-runtime.js +1 -1
  46. package/dist/core/auth/agent-delegation.js +2 -1
  47. package/dist/core/auth/auth-gateway.js +1 -1
  48. package/dist/core/auth/authorization-audit.js +17 -6
  49. package/dist/core/auth/delegation-authorization.js +3 -1
  50. package/dist/core/auth/operation-authorizer.js +15 -0
  51. package/dist/core/auth/operation-catalog.js +31 -6
  52. package/dist/core/command/agent-control.js +3 -7
  53. package/dist/core/command/agent-storage-menu.js +5 -3
  54. package/dist/core/command/cli-intent-parser.js +2 -1
  55. package/dist/core/command/command-handler.js +48 -99
  56. package/dist/core/command/connect-menu.js +11 -3
  57. package/dist/core/command/data-root-resolver.js +5 -4
  58. package/dist/core/command/memory-slash.js +16 -8
  59. package/dist/core/command/menu-catalog.js +5 -6
  60. package/dist/core/command/menu-handler.js +49 -62
  61. package/dist/core/command/role-menu.js +147 -30
  62. package/dist/core/command/slash-handler.js +123 -254
  63. package/dist/core/daemon-control.js +8 -14
  64. package/dist/core/evolagent-registry.js +4 -4
  65. package/dist/core/evolagent.js +2 -2
  66. package/dist/core/inference/text-inference.js +31 -40
  67. package/dist/core/ipc-registration.js +6 -2
  68. package/dist/core/memory/consolidation-context.js +51 -5
  69. package/dist/core/memory/consolidation-ops-records.js +1 -1
  70. package/dist/core/memory/consolidation-trigger.js +189 -189
  71. package/dist/core/memory/consolidation.js +316 -29
  72. package/dist/core/memory/forget-log.js +96 -0
  73. package/dist/core/memory/index-manager.js +27 -5
  74. package/dist/core/memory/memory-admin.js +45 -5
  75. package/dist/core/memory/memory-writer.js +163 -18
  76. package/dist/core/memory/relation-idle-monitor.js +119 -58
  77. package/dist/core/memory/relation-sweep.js +44 -39
  78. package/dist/core/message/aun-ipc-sender.js +8 -2
  79. package/dist/core/message/im-renderer.js +7 -4
  80. package/dist/core/message/message-admission.js +89 -4
  81. package/dist/core/message/message-bridge.js +31 -18
  82. package/dist/core/message/response-engine.js +77 -8
  83. package/dist/core/model/catalog-service.js +4 -2
  84. package/dist/core/model/config-scope.js +24 -64
  85. package/dist/core/model/field-scope.js +1 -1
  86. package/dist/core/model/model-catalog.js +30 -41
  87. package/dist/core/model/model-diagnostics.js +4 -3
  88. package/dist/core/model/model-fallback.js +10 -7
  89. package/dist/core/model/model-permission.js +3 -2
  90. package/dist/core/ownership/owner-resolver.js +23 -21
  91. package/dist/core/permission/ec-command-parser.js +30 -2
  92. package/dist/core/permission/sandbox-runtime.js +18 -1
  93. package/dist/core/permission/tool-policy.js +14 -3
  94. package/dist/core/relation/peer-identity.js +64 -1
  95. package/dist/core/role/runtime-policy.js +72 -13
  96. package/dist/core/session/session-capsule.js +1 -1
  97. package/dist/core/session/session-idle-monitor.js +1 -1
  98. package/dist/core/session/session-manager.js +20 -0
  99. package/dist/core/session/session-renew.js +3 -3
  100. package/dist/core/skill/index-generator.js +15 -5
  101. package/dist/core/system-session/memory.js +6 -1
  102. package/dist/core/thread/thread-service.js +19 -6
  103. package/dist/directory/owner-directory-admission.js +95 -0
  104. package/dist/directory/owner-directory-authorization.js +309 -0
  105. package/dist/directory/owner-directory-cache.js +635 -0
  106. package/dist/eck/kit-renderer.js +2 -2
  107. package/dist/ecweb/basic-settings-service.js +33 -40
  108. package/dist/ecweb/message-context-service.js +110 -0
  109. package/dist/index.js +76 -14
  110. package/dist/ipc.js +170 -12
  111. package/dist/paths.js +4 -0
  112. package/dist/proxy/command.js +122 -0
  113. package/dist/proxy/ipc-service.js +68 -0
  114. package/dist/proxy/manager.js +485 -0
  115. package/dist/proxy/service-supervisor.js +603 -0
  116. package/dist/response-system/engines/v1/proactive-flow.js +16 -6
  117. package/dist/utils/cross-platform.js +14 -0
  118. package/dist/utils/ecweb-supervisor.js +258 -83
  119. package/dist/utils/error-utils.js +2 -2
  120. package/dist/utils/logger.js +24 -5
  121. package/dist/utils/package-version-info.js +4 -2
  122. package/kits/docs/channels/aun.md +9 -0
  123. package/kits/docs/evolcore/agent.md +1 -1
  124. package/kits/docs/evolcore/config.md +17 -6
  125. package/kits/docs/evolcore/contact.md +3 -0
  126. package/kits/docs/evolcore/fs.md +11 -0
  127. package/kits/docs/evolcore/memory-architecture.md +2 -2
  128. package/kits/docs/evolcore/memory-consolidation.md +32 -8
  129. package/kits/docs/evolcore/memory.md +1 -1
  130. package/kits/docs/evolcore/menu-protocol.md +4 -0
  131. package/kits/docs/evolcore/model.md +23 -20
  132. package/kits/docs/evolcore/msg.md +4 -7
  133. package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
  134. package/kits/schemas/_meta.json +37 -4
  135. package/kits/schemas/agent-config.schema.13.json +8 -3
  136. package/kits/schemas/agent-config.schema.16.json +891 -0
  137. package/kits/schemas/daemon.schema.9.json +366 -0
  138. package/kits/schemas/defaults.schema.5.json +406 -127
  139. package/kits/schemas/relation-config.schema.11.json +260 -0
  140. package/kits/schemas/role-config.schema.1.json +7 -7
  141. package/kits/skills/.switches.json +3 -7
  142. package/kits/skills/ec-service-proxy/SKILL.md +118 -0
  143. package/kits/skills/ec-trigger/SKILL.md +13 -5
  144. package/kits/skills/personal-assistant/SKILL.md +176 -0
  145. package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
  146. package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
  147. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
  148. package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
  149. package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
  150. package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
  151. package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
  152. package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
  153. package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
  154. package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
  155. package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
  156. package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
  157. package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
  158. package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
  159. package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
  160. package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
  161. package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
  162. package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
  163. package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
  164. package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
  165. package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
  166. package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
  167. package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
  168. package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
  169. package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
  170. package/kits/templates/memory-consolidation/forget.md +19 -6
  171. package/kits/templates/memory-consolidation/notes.md +1 -1
  172. package/kits/templates/memory-consolidation/profile.md +2 -2
  173. package/kits/templates/memory-consolidation/promote.md +20 -3
  174. package/kits/templates/roles/member.json +8 -1
  175. package/kits/templates/system-fragments/baseagent.md +2 -2
  176. package/kits/templates/system-fragments/memory.md +4 -4
  177. package/package.json +6 -2
@@ -0,0 +1,333 @@
1
+ # 个人助理工作区规范
2
+
3
+ > 版本:0.1(草案,待评审)
4
+ > 状态:设计定稿中,尚未落地到真实数据
5
+ > 适用:任何按本规范创建的个人助理工作区
6
+
7
+ ---
8
+
9
+ ## 1. 设计理念
10
+
11
+ ### 1.1 数据主权高于一切
12
+
13
+ 所有数据属于使用者本人,**不依赖任何软件的内部格式**。
14
+
15
+ EvolCore 会升级、会重构、会改存储格式。任何寄生在系统内部的数据,都会在一次不兼容升级后变得不可读。"落地"不是备份,是把所有权拿回来。
16
+
17
+ 判据:**把这个 Skill 卸掉、把 EvolCore 换掉,数据还能用文本编辑器直接打开、还能被 grep 搜到。**做不到的,就是设计错了。
18
+
19
+ ### 1.2 代码与数据分家
20
+
21
+ | 类别 | 位置 | 特征 |
22
+ |---|---|---|
23
+ | 数据 | 工作区 `capture/` `output/` | 唯一、不可重建、必须保管 |
24
+ | 技能代码 | 技能包(工作区之外) | 可升级、可替换、可复制给别人 |
25
+ | 运行时状态 | 工作区 `.assistant/` | 可重建、可随时删除 |
26
+
27
+ 升级技能不动一个字节的数据;换工作区不用重装技能。这条界线一旦模糊,两边都会烂。
28
+
29
+ ### 1.3 原料与产物分离
30
+
31
+ - **原料**(`capture/`):外部给的、系统采集的。**只增不改。**
32
+ - **产物**(`output/`):提炼的、生成的、演进的。**可覆盖、可重建。**
33
+
34
+ 分开的意义:原料永远在,产物坏了能重做。混在一起,就分不清"这是事实还是我的判断"。
35
+
36
+ ### 1.4 机器产物必须可重建
37
+
38
+ 索引、缓存、日志、临时文件——**全删掉,一条命令恢复**。
39
+
40
+ 判据:删掉 `.assistant/` 之后,数据零损失。
41
+
42
+ ### 1.5 结论必须可追溯
43
+
44
+ 任何产物、任何记忆条目,都带 `source:` 指向原料的具体路径。
45
+
46
+ 判据:从一份月报,能一路点到支撑它的那条对话原文。
47
+
48
+ ---
49
+
50
+ ## 2. 根目录
51
+
52
+ ```
53
+ toleiliang8/ ← 工作区根
54
+ ├── README.md 这是什么、怎么用
55
+ ├── INDEX.md 总索引(脚本生成)
56
+ ├── capture/ 原料层
57
+ ├── output/ 产出层
58
+ └── .assistant/ 运行时状态(隐藏,可删可重建)
59
+ ```
60
+
61
+ **看得见四个。** 第五条是隐藏目录,符合 `.git` 这类工程惯例——它不属于"内容",属于"机器的内脏"。
62
+
63
+ ---
64
+
65
+ ## 3. 目录详解
66
+
67
+ ### 3.1 `capture/` —— 原料层
68
+
69
+ **统一规则**:只增不改,永不覆盖。写错就写新的一条,旧的不动。
70
+
71
+ | 子目录 | 装什么 | 写入者 | 生命周期 |
72
+ |---|---|---|---|
73
+ | `conversation/` | 对话正文(md + jsonl 双份) | 每日落地 / 会话结束落地 | 3 个月后归档 |
74
+ | `notes/` | 用户口述的想法、随笔 | 会话内即时 | 3 个月后归档 |
75
+ | `links/` | 转发的链接与文章(含摘要) | 会话内即时 | 3 个月后归档 |
76
+ | `files/` | 收到的文件原件 | 会话内即时 | 3 个月后归档 |
77
+ | `scene/` | 看现场:照片引用 + 位置 + 描述 | 消息到达时 | 3 个月后归档 |
78
+ | `listening/` | 非会议的持续聆听(转写 + 音频引用) | 聆听结束事件 | 3 个月后归档 |
79
+ | `meeting/` | 会议原料(转写、参与人、音频引用) | 会议结束事件 | 3 个月后归档 |
80
+ | `track/` | 行为轨迹:位置、应用使用、设备、通讯 | 每日快照 | 3 个月后归档 |
81
+ | `_manifest/` | 落地清单:文件数、字节数、sha256 | 每次落地 | **永不删除** |
82
+ | `_inbox/` | 兜底暂存(48 小时内必须归位) | 任意 | 归位后清空 |
83
+ | `_archive/` | 冷归档 | 每月巡检 | 永久 |
84
+
85
+ #### conversation/
86
+
87
+ ```
88
+ capture/conversation/2026/10/27/
89
+ └── main:leiliang.agentid.cn:toleiliang8.agentid.pub/
90
+ ├── meta.json threadId / peer / 话题名 / 起止时间 / 消息条数
91
+ ├── transcript.md 正文,人读,带时间戳
92
+ └── transcript.jsonl 逐条机读:{msgId, dir, from, to, ts, type, text}
93
+ ```
94
+
95
+ **为什么 md + jsonl 双份**:md 给人看、给全文搜;jsonl 给脚本算(统计、抽取任务、生成摘要)。只有 md 则脚本要写脆弱的正则解析;只有 jsonl 则人读不了。
96
+
97
+ **幂等键**:`threadId + msgId`。同一话题下 msgId 稳定唯一,重复落地不产生第二条。
98
+
99
+ **增量游标**:每个话题在 `.assistant/state.json` 里记一个 `lastTs`,下次用 `--after lastTs` 接着取。
100
+ 首次回填用 `--before <now>` 往前翻页——注意 `--limit N` 取的是**区间内最近 N 条**,不是最早 N 条。
101
+
102
+ #### meeting/ 与 listening/ 的分界
103
+
104
+ **有 `meeting_id` → `meeting/`;没有 → `listening/`。**
105
+
106
+ 同一份能力(持续聆听),按有没有会议载体分两处。会议有参与人、有议题、有产出总结;口述只是一个人的独白,两者下游完全不同。
107
+
108
+ #### track/
109
+
110
+ 按天一个目录,一天内按数据类型分文件:
111
+
112
+ ```
113
+ capture/track/2026/10/27/
114
+ ├── location.jsonl 位置点(含精度)
115
+ ├── app-usage.jsonl 前台应用切换
116
+ ├── device.jsonl 电量、屏幕、健康
117
+ └── comms.md 通话与短信摘要(人读)
118
+ ```
119
+
120
+ **原件不落地**:录音、原始照片本体留在存储层,这里只存引用和元数据。理由是体积和隐私——引用可以随时重新取,复制一份反而增加泄露面。
121
+
122
+ #### _manifest/
123
+
124
+ **这是数据,不是缓存。** 它证明"某天该落的东西都落了"。
125
+
126
+ ```json
127
+ {
128
+ "date": "2026-10-27",
129
+ "ingested_at": "2026-10-27T23:52:11+08:00",
130
+ "sources": [
131
+ {"type": "conversation", "objects": 3, "bytes": 18234, "sha256": "..."},
132
+ {"type": "track", "objects": 4, "bytes": 9810, "sha256": "..."}
133
+ ],
134
+ "missing": []
135
+ }
136
+ ```
137
+
138
+ 没有清单,"防丢失"就是一句空话——系统升级后你无法证明"没丢"。
139
+
140
+ ---
141
+
142
+ ### 3.2 `output/` —— 产出层
143
+
144
+ **统一规则**:可覆盖、可重建。每份产物都带 `source:` 指回原料。
145
+
146
+ | 子目录 | 装什么 | 生成方式 | 生命周期 |
147
+ |---|---|---|---|
148
+ | `reports/daily/` | 日报 | 每日定时 | 3 个月后归档 |
149
+ | `reports/weekly/` | 周报 | 每周定时 | 3 个月后归档 |
150
+ | `reports/monthly/` | 月报 | 每月定时 | 3 个月后归档 |
151
+ | `reports/quarterly/` | 季报 | 每季定时 | 1 年后归档 |
152
+ | `reports/yearly/` | 年报 | 每年定时 | 永久 |
153
+ | `meetings/` | 会议总结(对应 capture/meeting) | 会议结束后提炼 | 3 个月后归档 |
154
+ | `tasks/` | 任务:唯一事实源 | 会话内维护 | 完成后归档 |
155
+ | `knowledge/memory/` | 记忆条目 | 记忆整理任务 | **永不归档** |
156
+ | `knowledge/profile/` | 主人/他人/组织画像 | 周期性更新 | **永不归档** |
157
+ | `knowledge/topics/` | 主题梳理 | 按需 | **永不归档** |
158
+ | `_archive/` | 产物冷归档 | 每月巡检 | 永久 |
159
+
160
+ #### reports/
161
+
162
+ 命名即时间:`2026-10-27.md`、`2026-W43.md`、`2026-10.md`、`2026-Q4.md`、`2026.md`。
163
+
164
+ **周期报告的归档时间以"报告覆盖的周期"为准**,不以生成时间为准。10 月 27 日总结 26 号的事,归到 26 号所属的周和月。
165
+
166
+ #### tasks/
167
+
168
+ ```
169
+ tasks/
170
+ ├── QUEUE.md 第三方事务队列(pending → reported → done/dropped)
171
+ ├── today.md 当天任务
172
+ ├── short.md 短期(周级)
173
+ ├── long.md 长期(月级+)
174
+ └── done/2026-10.md 已完成,按月归档
175
+ ```
176
+
177
+ **唯一事实源的意义**:所有提醒、巡检、汇报都从这里读,不各自维护一份。两处都记,就一定有一处是错的。
178
+
179
+ #### knowledge/
180
+
181
+ 这是整个工作区里**唯一永不归档**的部分。记忆、画像、主题是累积物,不是流水——越用越准,越放越值钱。
182
+
183
+ **记忆的"不遗忘"是字面意义的:**
184
+
185
+ ```yaml
186
+ status: active | superseded
187
+ supersedes: <旧条目 id>
188
+ superseded_by: <新条目 id>
189
+ ```
190
+
191
+ 改主意了不改老条目,而是写一条新的、把老的标 `superseded`。**旧版本永久保留**,于是你能查到"九月我以为 A,十月改成了 B,因为当时出了什么事"。这是运行时记忆系统**故意做不到**的事。
192
+
193
+ ---
194
+
195
+ ### 3.3 `.assistant/` —— 运行时状态
196
+
197
+ | 路径 | 内容 | 可删性 |
198
+ |---|---|---|
199
+ | `state.json` | 工作区版本、技能版本、初始化时间、已装触发器清单 | 删了要重新初始化 |
200
+ | `index/` | 分片索引(tags、by-source、by-date、翻月归档) | 可删,重建索引恢复 |
201
+ | `logs/` | 运行日志,按天滚动,30 天自动清 | 可删 |
202
+ | `tmp/` | 临时文件,7 天自动清 | 可删 |
203
+ | `locks/` | 脚本互斥锁 | 可删 |
204
+ | `cache/` | 解析缓存 | 可删 |
205
+
206
+ **唯一例外是 `state.json`**:删了不会丢数据,但会丢失"这个工作区装过哪版技能、装过哪些触发器"的记录,需要重新初始化才能恢复自动运转。
207
+
208
+ ---
209
+
210
+ ## 4. 命名与格式规范
211
+
212
+ ### 4.1 文件命名
213
+
214
+ ```
215
+ <日期>-<时分>-<简短标题>.md 例:2026-10-27-1200-会议模式界面.md
216
+ ```
217
+
218
+ - 日期一律 `YYYY-MM-DD`
219
+ - 时分 24 小时制 `HHmm`
220
+ - 标题 ≤ 20 字,不加书名号、不加标点
221
+ - **文件名里不出现空格**,需要分隔用 `-`
222
+
223
+ ### 4.2 目录时间层级
224
+
225
+ ```
226
+ <年>/<月>/ 例:2026/10/
227
+ <年>/<月>/<日>/ 例:2026/10/27/ (仅 track 和 conversation 用日级)
228
+ ```
229
+
230
+ ### 4.3 frontmatter(所有 md 通用)
231
+
232
+ ```yaml
233
+ ---
234
+ id: 2026-10-27-1200-会议模式界面
235
+ date: 2026-10-27T12:00:00+08:00
236
+ type: note | link | scene | meeting | listening | report | task | profile | memory | topic
237
+ tags: [标签1, 标签2]
238
+ source: 自己 | 网友名 | 设备名 | <capture/ 下的相对路径>
239
+ ref: capture/meeting/2026/10/26-xxx # 可选,指向原料
240
+ status: active | superseded # 仅 knowledge/ 使用
241
+ ---
242
+ ```
243
+
244
+ **`source` 是硬性要求。** 没有来源的结论,等于没有结论。
245
+
246
+ ---
247
+
248
+ ## 5. 数据流转机制
249
+
250
+ ### 5.1 总图
251
+
252
+ ```
253
+ ┌─────────────── 触发器(何时)───────────────┐
254
+ │ cron 定时 事件(session:idle 等) │
255
+ └───────────────────┬────────────────────────┘
256
+ ▼
257
+ ┌──────────── 会话(判断)────────────┐
258
+ │ 模型读上下文,决定这次该做什么 │
259
+ └───────────────────┬────────────────┘
260
+ ▼
261
+ ┌──────────── 脚本(执行)────────────┐
262
+ │ 确定性操作:写文件、建目录、算摘要 │
263
+ └───────────────────┬────────────────┘
264
+ ▼
265
+ capture/ ──▶ output/
266
+ ```
267
+
268
+ **三种驱动力各司其职**:触发器管"什么时候",模型管"做什么",脚本管"怎么做"。
269
+
270
+ ### 5.2 五条数据流
271
+
272
+ | # | 数据 | 源 | 触发 | 落点 | 幂等键 |
273
+ |---|---|---|---|---|---|
274
+ | 1 | 对话正文 | 话题历史(`ec thread history`) | 每日 cron + `session:idle` | `capture/conversation/` | threadId + msgId |
275
+ | 2 | 记忆 | EvolCore 记忆文件 | 每日 cron | `output/knowledge/memory/` | 条目 slug + 版本 |
276
+ | 3 | 手机观察 | `personal/observations` 快照 | 每日 cron | `capture/track/` `listening/` `scene/` | 对象 id |
277
+ | 4 | 用户直接投喂 | 消息到达 | 即时(会话内) | `capture/notes/` `links/` `files/` | 消息 id |
278
+ | 5 | 会议 | 带 meeting_id 的聆听 | 聆听结束事件 | `capture/meeting/` | meeting_id |
279
+
280
+ 产物流:
281
+
282
+ ```
283
+ capture/* ──每日/周/月──▶ output/reports/*
284
+ capture/meeting ──会议结束──▶ output/meetings/*
285
+ capture/* + output/* ──每日──▶ output/knowledge/memory/
286
+ 所有写入 ──增量──▶ .assistant/index/ ;每日全量重建 ──▶ INDEX.md
287
+ ```
288
+
289
+ ### 5.3 每项数据的管理机制
290
+
291
+ | 机制 | 作用对象 | 频率 | 说明 |
292
+ |---|---|---|---|
293
+ | **落地清单** | capture 全部 | 每次落地 | 记录落了什么、多少、摘要,用于证明没丢 |
294
+ | **增量索引** | 所有 md | 每次写入 | 追加到 `.assistant/index/` |
295
+ | **全量重建** | INDEX.md + 分片 | 每日 | 从 frontmatter 汇总,覆盖生成 |
296
+ | **冷热分层** | capture + output | 每月 1 号 | 超过 3 个月搬进 `_archive/` |
297
+ | **互斥锁** | 所有写操作 | 每次 | 防止 cron 与事件触发同时写同一天 |
298
+ | **完整性校验** | capture | 每周 | 比对 `_manifest/` 的 sha256,发现损坏 |
299
+ | **记忆演进** | knowledge/memory | 每次变更 | 旧的标 superseded,不删除 |
300
+
301
+ ### 5.4 归档规则
302
+
303
+ | 区域 | 归档阈值 | 去向 |
304
+ |---|---|---|
305
+ | `capture/conversation` `notes` `links` `files` `scene` `listening` `meeting` `track` | 3 个月 | `capture/_archive/年/月/` |
306
+ | `output/reports`(日/周/月) | 3 个月 | `output/_archive/年/月/` |
307
+ | `output/meetings` | 3 个月 | `output/_archive/年/月/` |
308
+ | `output/reports/quarterly` | 1 年 | `output/_archive/年/` |
309
+ | `output/reports/yearly` | 永不 | — |
310
+ | `output/knowledge/**` | **永不归档** | — |
311
+
312
+ **归档不改变内容,只改变位置**,并同步更新索引的归档分片。
313
+
314
+ ---
315
+
316
+ ## 6. 检索机制
317
+
318
+ 三路,从快到兜底:
319
+
320
+ 1. **索引**:`INDEX.md` → 分片 → 直达。用于"我知道要什么"
321
+ 2. **元数据过滤**:按 `date/type/tags/source` 筛。用于"10 月的所有会议"
322
+ 3. **全文搜索**:grep 全库。用于"我记得好像说过某某"
323
+
324
+ 三路都建立在同一件事上:**frontmatter 字段统一**。字段一乱,三路全废。
325
+
326
+ ---
327
+
328
+ ## 7. 边界:这个工作区不做什么
329
+
330
+ - **不做全文数据库**:不需要 SQLite、不建向量库。文本 + 目录 + grep 够了,多一层依赖就多一个会坏的部件。
331
+ - **不做实时同步**:落地是批处理,不是实时镜像。实时同步意味着强一致,强一致意味着停摆。
332
+ - **不存原件**:录音、大图只存引用。原件在存储层,引用随时可重新取。
333
+ - **不替代运行时记忆**:EvolCore 的记忆继续为上下文服务;工作区的记忆为持久服务。两套并存,各管一段。
@@ -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. **不留半成品**:创建到一半失败时,把已建的部分列清楚,下次可续建