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,439 @@
1
+ # 前端数据契约
2
+
3
+ > 版本:v1(对应工作区 schema v1)
4
+ > 读者:前端设计师 / 前端工程师
5
+ > 用途:照着这份文档就能把数据读出来并渲染
6
+
7
+ ---
8
+
9
+ ## 1. 只有一种数据形态:Markdown
10
+
11
+ **前端读的就是 md 文件本身,没有第二份数据。**
12
+
13
+ ```
14
+ 文件 = YAML frontmatter(元数据) + Markdown 正文(内容)
15
+ ```
16
+
17
+ - **frontmatter 是契约**:列表页需要的所有字段都在这里,前端解析 YAML 拿到结构
18
+ - **正文是内容**:详情页直接渲染 markdown
19
+ - **目录是路由**:路径决定分组和导航,不需要额外的索引文件
20
+
21
+ **没有 JSON 视图层,也不会有。** 原因是设计上的硬约束:
22
+
23
+ | 如果另做一份 JSON | 后果 |
24
+ |---|---|
25
+ | 大模型要输出两份 | 同一份内容写两遍,token 翻倍 |
26
+ | 要让模型保证 JSON 合法 | 得配 Schema 校验、重试、兜底——把不确定性引进来 |
27
+ | 两份会漂移 | 正文改了 JSON 没改,前端和实际不一致 |
28
+ | 多一层同步 | 每次写入都要跑一次转换,多一个会坏的部件 |
29
+
30
+ **结论:frontmatter 就是数据库,markdown 就是内容,一物一份。**
31
+
32
+ ---
33
+
34
+ ## 2. 目录即路由
35
+
36
+ ```
37
+ <workspace>/
38
+ ├── README.md 工作区说明(前端可做「关于」页)
39
+ ├── INDEX.md 全量条目索引(人读,前端不用)
40
+ ├── capture/ 原料层
41
+ │ ├── conversation/ 对话正文
42
+ │ ├── notes/ 随笔
43
+ │ ├── links/ 链接与文章
44
+ │ ├── files/ 收到的文件
45
+ │ ├── scene/ 看现场(照片+位置)
46
+ │ ├── listening/ 持续聆听
47
+ │ ├── meeting/ 会议原料
48
+ │ └── track/ 行为轨迹
49
+ ├── output/ 产出层 ← **前端主要读这里**
50
+ │ ├── reports/ 日/周/月/季/年报
51
+ │ ├── meetings/ 会议总结
52
+ │ ├── tasks/ 任务
53
+ │ └── knowledge/ 画像 / 记忆 / 主题
54
+ └── .assistant/ 运行时状态(前端不读)
55
+ ```
56
+
57
+ ### 2.1 目录渲染配置
58
+
59
+ **前端不为每个目录单独写页面。** 所有目录共用一套「列表 / 详情」渲染器,渲染差异由每个目录里的 `render.yaml` 声明。
60
+
61
+ ```
62
+ 目录 + render.yaml → 标准渲染器 → 列表页 / 详情页
63
+ ```
64
+
65
+ 渲染器从 `render.yaml` 读取:展示名(`title`)、布局(`layout`)、卡片显示哪几个字段(`fields`)、默认排序(`sort`)、默认过滤(`filter`)、详情正文渲染方式(`detail.body`)。没有 `render.yaml` 的目录用内置默认值,同样能跑。
66
+
67
+ **完整规范、五种 layout(`list` / `board` / `cards` / `gallery` / `chat`)的示意、各目录的建议配置及示例文件,见 `06-render-config.md`。**
68
+
69
+ 此处只需知道:所有目录的扫描方式都一样——`<dir>/**/*.md`,取 frontmatter 里的 `type` 和其他字段,再按 `render.yaml` 决定怎么画。
70
+
71
+ ### 2.2 时间层级
72
+
73
+ ```
74
+ output/reports/daily/2026/2026-10-27.md ← 报告按 年/
75
+ capture/conversation/2026/10/27/<threadId>/ ← 对话按 年/月/日/
76
+ output/knowledge/memory/facts/2026/10/*.md ← 记忆按 年/月/
77
+ ```
78
+
79
+ **规则**:条目多、按天查的用 `年/月/日/`;条目少、按主题查的用 `年/` 或 `年/月/`。
80
+ 前端做导航时,**目录层级就是面包屑**,不要自己造层级。
81
+
82
+ ---
83
+
84
+ ## 3. 文件命名
85
+
86
+ ```
87
+ <日期>-<时分>-<标题>.md
88
+ 2026-10-27-1200-会议模式界面.md
89
+ ```
90
+
91
+ - 日期 `YYYY-MM-DD`,时分 24 小时制 `HHmm`
92
+ - 标题 ≤ 20 字,无空格、无标点
93
+ - **日期+时分来自文件名,不一定要再放进 frontmatter**——但 `date` 字段必须有(见下)
94
+
95
+ ---
96
+
97
+ ## 4. frontmatter 是唯一的元数据契约
98
+
99
+ ### 4.1 通用字段(所有 md 必带)
100
+
101
+ ```yaml
102
+ ---
103
+ id: 2026-10-27-1200-会议模式界面
104
+ date: 2026-10-27T12:00:00+08:00
105
+ type: note
106
+ tags: [标签1, 标签2]
107
+ source: 自己
108
+ ---
109
+ ```
110
+
111
+ | 字段 | 类型 | 必填 | 说明 |
112
+ |---|---|---|---|
113
+ | `id` | string | ✅ | 全局唯一。前端用作列表 key |
114
+ | `date` | ISO8601 字符串 | ✅ | **带时区偏移**,如 `+08:00` |
115
+ | `type` | enum | ✅ | 见 §5,决定渲染模板 |
116
+ | `tags` | string[] | ✅ | 可为空数组 |
117
+ | `source` | string | ✅ | 来源。`自己` / 人名 / `ec-thread:<id>` / 相对路径 |
118
+
119
+ ### 4.2 解析要点(前端必读)
120
+
121
+ | 事项 | 说明 |
122
+ |---|---|
123
+ | **YAML 解析器** | 用标准 YAML 库,不要自己写正则。`tags` 可能是 `[a, b]` 行内数组,也可能是多行 `- a` 列表 |
124
+ | **时间** | `date` 是**带时区的字符串**。前端自行转 Date 对象;比较/排序前统一转 epoch |
125
+ | **缺字段** | 不要崩。缺失按「无」处理,`tags` 缺失当空数组 |
126
+ | **正文起点** | 第二个 `---` 之后的全部内容 |
127
+ | **不可信内容** | frontmatter 和正文都是助理/AI 生成的,**渲染前必须转义**,不要当 HTML 插入 |
128
+
129
+ ### 4.3 每个 type 的专属字段
130
+
131
+ #### `type: task`
132
+
133
+ ```yaml
134
+ ---
135
+ id: task-2026-10-28-001
136
+ date: 2026-10-28T08:00:00+08:00
137
+ type: task
138
+ tags: [开发]
139
+ source: capture/conversation/2026/10/28/xxx
140
+ status: in_progress
141
+ horizon: short
142
+ priority: P1
143
+ due_at: 2026-10-29T00:00:00+08:00
144
+ completed_at: null
145
+ owner_note: null
146
+ stale_checks: 0
147
+ ---
148
+
149
+ # 补充历史回填
150
+
151
+ 正文:为什么做、做到哪一步。
152
+ ```
153
+
154
+ | 字段 | 取值 | 渲染 |
155
+ |---|---|---|
156
+ | `status` | `pending` / `in_progress` / `blocked` / `done` / `dropped` | 看板分列 |
157
+ | `horizon` | `today` / `short` / `long` / `queue` | 分组标签 |
158
+ | `priority` | `P0` / `P1` / `P2` / null | 排序与着色 |
159
+ | `due_at` | ISO8601 / null | 逾期判断 |
160
+ | `completed_at` | ISO8601 / null | 完成时间 |
161
+ | `owner_note` | string / null | 非空时显示「主人在处理」,弱化提醒 |
162
+ | `stale_checks` | number | `>=2` 且未完成 → 提示「建议拆分」 |
163
+
164
+ **逾期由前端算**:`due_at < now && status !== 'done'`。
165
+
166
+ #### `type: report`
167
+
168
+ ```yaml
169
+ ---
170
+ id: report-daily-2026-10-27
171
+ date: 2026-10-27T23:50:00+08:00
172
+ type: report
173
+ tags: [日报]
174
+ source: capture/conversation/2026/10/27/
175
+ period: 2026-10-27
176
+ report_type: daily
177
+ summary: 完成技能骨架;落地对话 168 条。
178
+ ---
179
+ ```
180
+
181
+ | 字段 | 说明 |
182
+ |---|---|
183
+ | `period` | **覆盖的周期**,不是生成时间。`2026-10-27` / `2026-W43` / `2026-10` / `2026-Q4` / `2026` |
184
+ | `report_type` | `daily` / `weekly` / `monthly` / `quarterly` / `yearly` |
185
+ | `summary` | 一两句话,列表页直接显示,**不用前端去正文里抓** |
186
+
187
+ **排序用 `period`,不是 `date`**。10-28 写的 10-27 日报,`period` 是 `2026-10-27`。
188
+
189
+ #### `type: meeting`
190
+
191
+ ```yaml
192
+ ---
193
+ id: meeting-2026-10-26-001
194
+ date: 2026-10-26T14:00:00+08:00
195
+ type: meeting
196
+ tags: [产品评审]
197
+ source: capture/meeting/2026/10/26-产品评审会/
198
+ duration_min: 68
199
+ participants: [leiliang, 李文江, 蒋先福]
200
+ summary: 确定 Q4 三个方向。
201
+ transcript: capture/meeting/2026/10/26-产品评审会/transcript.jsonl
202
+ action_items: 4
203
+ ---
204
+ ```
205
+
206
+ | 字段 | 说明 |
207
+ |---|---|
208
+ | `duration_min` | 时长(分钟),整数 |
209
+ | `participants` | 显示名数组 |
210
+ | `transcript` | 原始转写路径,可能为 null |
211
+ | `action_items` | 待办条数,可做角标 |
212
+
213
+ #### `type: profile` / `memory` / `topic`
214
+
215
+ ```yaml
216
+ ---
217
+ id: fact-2026-10-27-常驻上海
218
+ date: 2026-10-27T12:00:00+08:00
219
+ type: memory
220
+ tags: [位置]
221
+ source: capture/conversation/2026/10/27/
222
+ memory_kind: fact
223
+ status: active
224
+ supersedes: null
225
+ superseded_by: null
226
+ summary: 手机定位稳定在闵行马桥一带。
227
+ ---
228
+ ```
229
+
230
+ | 字段 | 说明 |
231
+ |---|---|
232
+ | `memory_kind` | `rule` / `fact` / `entity` / `episode`(仅 memory) |
233
+ | `status` | `active` / `superseded` |
234
+ | `supersedes` | 本条目取代了哪个旧条目 id |
235
+ | `superseded_by` | 本条目被哪个新条目取代 |
236
+
237
+ **前端默认只显示 `status: active`。**`superseded` 的放进「历史版本」折叠区——**这是本系统的特色:旧记忆不删除,能看演变过程**。
238
+
239
+ #### `type: conversation`
240
+
241
+ ```yaml
242
+ ---
243
+ id: main:leiliang.agentid.cn:toleiliang8.agentid.pub-2026-10-27
244
+ date: 2026-10-27T00:00:00+08:00
245
+ type: conversation
246
+ tags: [对话]
247
+ source: ec-thread:main:leiliang.agentid.cn:toleiliang8.agentid.pub
248
+ thread_id: main:leiliang.agentid.cn:toleiliang8.agentid.pub
249
+ peer: leiliang.agentid.cn
250
+ count: 94
251
+ ---
252
+ ```
253
+
254
+ #### `type: scene`(看现场)
255
+
256
+ ```yaml
257
+ ---
258
+ id: 2026-10-27-0919-现场
259
+ date: 2026-10-27T09:19:03+08:00
260
+ type: scene
261
+ tags: [现场]
262
+ source: 设备
263
+ photo: media/scene/2026-10-27-0919.jpg
264
+ location:
265
+ lat: 31.047711
266
+ lon: 121.348993
267
+ accuracy_m: 25
268
+ address: 上海市闵行区马桥镇森林溪谷别墅
269
+ summary: 阳台外是别墅区,桌上一台笔记本。
270
+ ---
271
+ ```
272
+
273
+ ⚠️ `photo` 指向的媒体本体当前**取不到**(见 §8)。
274
+
275
+ ---
276
+
277
+ ## 5. type 一览
278
+
279
+ | type | 目录 | 渲染模板 |
280
+ |---|---|---|
281
+ | `task` | `output/tasks/` | 看板卡片 / 列表行 |
282
+ | `report` | `output/reports/{level}/` | 列表行 + 详情正文 |
283
+ | `meeting` | `output/meetings/` | 列表行 + 详情正文 |
284
+ | `profile` | `output/knowledge/profile/` | 卡片 + 详情正文 |
285
+ | `memory` | `output/knowledge/memory/` | 列表行(按 memory_kind 分组) |
286
+ | `topic` | `output/knowledge/topics/` | 卡片 + 详情正文 |
287
+ | `conversation` | `capture/conversation/` | 会话流(左右分栏) |
288
+ | `scene` | `capture/scene/` | 图文卡 |
289
+ | `note` | `capture/notes/` | 纯文本卡 |
290
+ | `link` | `capture/links/` | 链接卡(含摘要) |
291
+ | `listening` | `capture/listening/` | 音频卡(媒体不可用) |
292
+
293
+ ---
294
+
295
+ ## 6. 正文渲染
296
+
297
+ ### 6.1 标准 markdown
298
+
299
+ 用任意 markdown 渲染器,支持:标题、列表、有序列表、表格、引用、代码块、行内代码、粗体斜体、链接、分隔线。
300
+
301
+ **必须做 HTML 转义**:正文是 AI 生成的,可能含 `<script>` 之类的内容,绝不能直接 `innerHTML`。
302
+
303
+ ### 6.2 内部链接
304
+
305
+ 正文里的相对路径链接(如 `../../capture/...`),前端需要:
306
+
307
+ 1. 解析为工作区相对路径
308
+ 2. 映射到前端路由(如果目标在工作区内)
309
+ 3. 不可达的链接渲染成纯文本,不要做成死链
310
+
311
+ ### 6.3 图片
312
+
313
+ ```markdown
314
+ ![现场](../../media/scene/2026-10-27-0919.jpg)
315
+ ```
316
+
317
+ 相对路径 → 需要映射到静态资源服务。当前**媒体服务未开放**,图片会加载失败,需要占位图。
318
+
319
+ ### 6.4 对话类正文的特殊结构
320
+
321
+ `capture/conversation/**/transcript.md` 的正文是固定的消息流格式:
322
+
323
+ ```markdown
324
+ **2026-10-27 09:19:27** ← `leiliang.agentid.cn`
325
+
326
+ 以下是我对你的直接提问或指令……
327
+
328
+ **2026-10-27 09:19:49** → `toleiliang8.agentid.pub`
329
+
330
+ 上海宋庆龄故居纪念馆,具体如下……
331
+ ```
332
+
333
+ 规则:每段以 `**时间** 箭头 \`发送方\`` 开头,`←` 是收到的,`→` 是发出的。
334
+
335
+ **如果要做成聊天气泡**,可以按这个模式切分;**如果只是展示**,直接渲染即可。
336
+
337
+ 同一目录下还有 `transcript.jsonl`,一行一条消息,字段:
338
+ ```json
339
+ {"msgId":"...","dir":"in|out","from":"...","to":"...","ts":1793000000000,"time":"2026/10/27 09:19:27","type":"text","text":"..."}
340
+ ```
341
+ **需要精确做气泡流时才读它**;普通展示用 md 就够。
342
+
343
+ ---
344
+
345
+ ## 7. 列表页怎么拿数据
346
+
347
+ 前端需要「列出所有任务」「列出所有报告」,做法是**扫目录 + 解析 frontmatter**:
348
+
349
+ ```
350
+ 1. 列出 output/tasks/**/*.md
351
+ 2. 逐个读文件开头(读到第二个 --- 就停,不用读全文)
352
+ 3. 解析 YAML 拿元数据
353
+ 4. 按规则排序渲染
354
+ 5. 点进去再读全文
355
+ ```
356
+
357
+ **性能建议**:
358
+
359
+ | 手段 | 说明 |
360
+ |---|---|
361
+ | 只读头部 | frontmatter 后面的正文不用读,读 2KB 通常够 |
362
+ | 缓存 | 用「路径 + mtime + size」做缓存 key,变了才重解析 |
363
+ | 懒加载 | 列表只解析 frontmatter,正文进详情页才读 |
364
+ | 目录分片 | 按 `年/月` 分目录,只加载当前视图需要的月份 |
365
+
366
+ ---
367
+
368
+ ## 8. 当前不可用的部分
369
+
370
+ **前端要据此隐藏或置灰入口,不要让用户点进去看到空白。**
371
+
372
+ | 功能 | 状态 | 原因 |
373
+ |---|---|---|
374
+ | 现场照片查看 | ❌ | 媒体本体在存储层,托管会话读不到 |
375
+ | 聆听音频 / 转写 | ❌ | 同上 |
376
+ | 位置轨迹地图 | ❌ | 同上 |
377
+ | 手机使用统计 | ❌ | 同上 |
378
+
379
+ 判断依据:`capture/scene/`、`capture/listening/`、`capture/track/` 目录存在但**没有内容**。
380
+ 前端可以做兜底:目录为空时显示「当前环境未开放此数据」。
381
+
382
+ ---
383
+
384
+ ## 9. 交互 → 写操作
385
+
386
+ 前端**不直接写文件**。
387
+
388
+ | 用户动作 | 做法 |
389
+ |---|---|
390
+ | 新建任务 | 发一句话给助理:「记一条任务:xxx」 |
391
+ | 标记完成 | 「把 xxx 标记完成」 |
392
+ | 改优先级 | 「xxx 提到 P0」 |
393
+
394
+ **为什么**:直接改文件和助理的下一次写入会打架,且绕过 id 生成与索引更新。
395
+
396
+ 前端可以做乐观 UI:点击后立即打勾,等下一次扫描文件时确认。
397
+
398
+ ---
399
+
400
+ ## 10. 版本与兼容
401
+
402
+ | 变化 | 处理 |
403
+ |---|---|
404
+ | **新增 frontmatter 字段** | 前端忽略未知字段即可,无需改动 |
405
+ | **字段改名或语义变更** | 工作区 `workspace_version` 递增,前端按版本适配 |
406
+ | **目录结构调整** | 同上;由 migrate 脚本自动修正旧工作区 |
407
+
408
+ **前端自查清单**:
409
+
410
+ 1. 所有列表项都用 `id` 做 key
411
+ 2. `date` / `due_at` 等按 ISO8601 带时区解析,不假设固定格式
412
+ 3. 缺字段不崩
413
+ 4. 正文渲染做了 HTML 转义
414
+ 5. `status: superseded` 的知识条目默认隐藏
415
+ 6. 空目录显示「暂无数据」而不是空白页
416
+
417
+ ---
418
+
419
+ ## 11. 一页速查
420
+
421
+ ```
422
+ 列表页 → 扫目录 **/*.md → 读头部 → 解析 YAML → 按 date/period 排序
423
+ 详情页 → 同一个文件,渲染第二个 --- 之后的正文
424
+ 对话流 → capture/conversation/年/月/日/<threadId>/transcript.md
425
+ 精确消息 → 同目录 transcript.jsonl
426
+ 写操作 → 一律走对话
427
+ 媒体 → 当前不可用,显示占位
428
+ ```
429
+
430
+ ---
431
+
432
+ ## 12. 未定项(需要产品确认)
433
+
434
+ 1. **文件读取通道**:本地文件系统直读,还是起一个只读服务?未定。
435
+ 2. **媒体服务**:照片与音频需要独立通道,受当前能力限制。
436
+ 3. **搜索**:`scripts/search.mjs` 是命令行工具。前端做搜索框需要包一层,或前端自己在内存里过滤。
437
+ 4. **实时更新**:当前是「重新扫描文件」。要即时感需要文件监听或事件推送。
438
+
439
+ 以上都不影响 v1 契约,先按「扫目录 + 解析 frontmatter」实现即可。