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,292 @@
1
+ # 个人助理目录结构总表
2
+
3
+ > 版本:v1 对应 `schema/workspace.v1.json`
4
+ > 性质:**查询表**。每个目录做什么、谁写、何时写、什么格式、怎么流转,一表看完。
5
+ > 设计动机见 `01-workspace-spec.md`,初始化流程见 `02-bootstrap.md`,前端读法见 `04-frontend-contract.md`。
6
+
7
+ ---
8
+
9
+ ## 0. 速读
10
+
11
+ ```
12
+ <工作区>/
13
+ ├── README.md 人读说明
14
+ ├── INDEX.md 全量索引(脚本生成)
15
+ ├── capture/ 原料层:外部给的 + 系统采集的,只增不改
16
+ ├── output/ 产出层:提炼的 + 长期沉淀的,可覆盖可重建
17
+ └── .assistant/ 运行时状态:可删可重建
18
+ ```
19
+
20
+ **三层两种规矩**:
21
+
22
+ | 层 | 规矩 | 坏了会怎样 |
23
+ |---|---|---|
24
+ | `capture/` | **只增不改**,永不覆盖 | 内容坏了就是真丢了,只能靠 `_manifest` 发现 |
25
+ | `output/` | **可覆盖、可重建** | 删掉能重新生成(`knowledge/` 除外,那是累积的) |
26
+ | `.assistant/` | **可随时删** | 删了重跑索引脚本即恢复 |
27
+
28
+ ---
29
+
30
+ ## 1. 主表:每个目录的全貌
31
+
32
+ **列含义**
33
+
34
+ - **谁生成**:`脚本`=确定性脚本写;`模型`=会话里的 AI 判断后写;`脚本+模型`=脚本搬运、模型填内容
35
+ - **何时生成**:触发方式与时点
36
+ - **格式**:目录里装的文件类型
37
+
38
+ ### 1.1 根与总控
39
+
40
+ | 路径 | 干嘛的 | 谁生成 | 何时生成 | 格式 | 流转 |
41
+ |---|---|---|---|---|---|
42
+ | `README.md` | 工作区说明:这是什么、有哪些目录、怎么用 | 脚本(`init.mjs`) | 初始化时一次;升级时更新版本号 | Markdown(无 frontmatter,纯人读) | 静态。不进索引 |
43
+ | `INDEX.md` | 全量条目索引,最近 90 天 | 脚本(`index-rebuild.mjs`) | 每次落地/写作后,或每日定时 | Markdown 表格 | **每次全量重建**,不手工编辑 |
44
+ | `.assistant/` | 运行时状态根 | 脚本 | 初始化时建 | 目录 | 可整体删除 |
45
+ | `.assistant/state.json` | 工作区版本、技能版本、owner、落地游标、能力标志 | 脚本(`init` / `ingest` 更新) | 初始化;每次落地后更新游标 | JSON | **唯一不可随意删的运行时文件**——删了要重新初始化 |
46
+ | `.assistant/index/` | 分片索引:`tags.md`、`by-source.md`、`archive/YYYY-MM.md` | 脚本(`index-rebuild.mjs`) | 与 INDEX.md 同步 | Markdown | 每次全量重建 |
47
+ | `.assistant/logs/` | 运行日志、迁移快照 | 脚本 | 每次运行 | JSON / 文本,按天滚动 | 30 天后可删 |
48
+ | `.assistant/tmp/` | 临时文件(触发器定义渲染等) | 脚本 | 即时 | 任意 | 7 天后可删 |
49
+ | `.assistant/locks/` | 写操作互斥锁 | 脚本 | 每次写操作前后 | 锁文件 | 防 cron 与事件撞车 |
50
+ | `.assistant/cache/` | 解析缓存 | 脚本 | 按需 | JSON | 可随时删 |
51
+
52
+ ### 1.2 `capture/` —— 原料层
53
+
54
+ | 路径 | 干嘛的 | 谁生成 | 何时生成 | 格式 | 流转 |
55
+ |---|---|---|---|---|---|
56
+ | `capture/conversation/` | 对话正文,按话题+日期归档 | 脚本(`ingest.mjs`) | 每日 23:50 cron;会话结束时事件触发 | `meta.json` + `transcript.md` + `transcript.jsonl` | 从 `ec thread history` 取 → 写盘 → 更新游标 → 写清单 |
57
+ | `capture/notes/` | 用户口述的想法、随笔 | 模型 | 用户说「记一下」时即时 | Markdown + frontmatter | 即时写 → 索引重建 |
58
+ | `capture/links/` | 转发的链接与文章,含摘要 | 模型 | 消息到达时即时 | Markdown + frontmatter(正文含原链+摘要) | 即时写。**摘要必填**,因为链接会失效 |
59
+ | `capture/files/` | 收到的文件原件 | 脚本(搬运)+ 模型(说明) | 收到文件时 | 原件 + 同名 `.md` 说明 | 原件不解析,只登记 |
60
+ | `capture/scene/` | 看现场:照片引用 + 位置 + 描述 | 模型 (⚠️ 照片本体取不到) | 收到现场照片时 | Markdown + frontmatter(`photo` / `location`) | 照片存引用不落地 → 写描述 md |
61
+ | `capture/listening/` | 非会议的持续聆听(转写+音频引用) | 脚本 (⚠️ 当前不可用) | 聆听结束事件 | `transcript.md` + `transcript.jsonl` + `audio.ref` | 受 G2 限制,目录空置 |
62
+ | `capture/meeting/` | 会议原料:转写、参与人 | 脚本 (⚠️ 依赖聆听授权) | 会议结束事件 | `meta.md` + `transcript.jsonl` + `audio.ref` | 同一份聆听能力,**有 `meeting_id` 归这里,没有归 `listening/`** |
63
+ | `capture/track/` | 行为轨迹:位置、应用、设备、通讯 | 脚本 (⚠️ 当前不可用) | 每日快照 | 按天分目录,`location.jsonl` / `app-usage.jsonl` / `device.jsonl` / `comms.md` | 受 G2 限制,目录空置 |
64
+ | `capture/_manifest/` | 落地清单:文件数、字节数、sha256 | 脚本(`ingest.mjs`) | **每次落地都写** | JSON(`YYYY-MM-DD.json`) | **这是数据不是缓存**。`verify.mjs` 用它证明"没丢"。永不删除 |
65
+ | `capture/_inbox/` | 兜底暂存,归不了类的先丢这 | 模型 | 拿不准归类时 | Markdown | 48 小时内必须归位;归位后清空 |
66
+ | `capture/_archive/` | 原料冷归档(超过 3 个月) | 脚本(`archive.mjs`) | 每月 1 号巡检 | 保留原相对路径 | 只移动不改内容;移动后重跑索引 |
67
+
68
+ ### 1.3 `output/` —— 产出层
69
+
70
+ | 路径 | 干嘛的 | 谁生成 | 何时生成 | 格式 | 流转 |
71
+ |---|---|---|---|---|---|
72
+ | `output/reports/daily/` | 日报 | **模型**(正文)+ 脚本(汇总数据) | 每日 22:30 cron | Markdown + frontmatter(`period` / `report_type` / `summary`) | 读当天 `capture/` → 写 → 索引。**每条结论带 `source`** |
73
+ | `output/reports/weekly/` | 周报 | 模型 | 每周日 21:00 | 同上,`period` 形如 `2026-W43` | 汇总本周日报 + 任务状态 |
74
+ | `output/reports/monthly/` | 月报 | 模型 | 每月 1 号 | 同上,`period` 形如 `2026-10` | 汇总本月周报,写趋势不写流水 |
75
+ | `output/reports/quarterly/` | 季报 | 模型 | 每季末 | 同上,`period` 形如 `2026-Q4` | 1 年后才归档 |
76
+ | `output/reports/yearly/` | 年报 | 模型 | 年末 | 同上 | **永不归档** |
77
+ | `output/meetings/` | 会议总结(成品) | 模型 | 会议结束后 | Markdown + frontmatter(`participants` / `duration_min` / `transcript`) | 对应 `capture/meeting/` 提炼而来 |
78
+ | `output/tasks/` | 任务:**唯一事实源** | 模型 | 用户提到任务时即时 | 单条任务一个 md,或 `QUEUE.md` 表格 | 所有提醒/巡检/汇报都从这里读 |
79
+ | `output/tasks/done/` | 已完成任务,按月归档 | 脚本(`archive.mjs`) | 每月 | 同上 | 完成后移动,不删除 |
80
+ | `output/knowledge/memory/rules/` | 规则与偏好,最高优先级 | 模型 | 发现规则时 | Markdown + frontmatter(`status`) | **永不过期、永不归档** |
81
+ | `output/knowledge/memory/facts/` | 事实条目,一条一文件 | 模型 | 记忆整理任务 | 同上 | 改主意不删旧的,标 `superseded` 指向新的 |
82
+ | `output/knowledge/memory/entities/` | 实体记忆(按人 / 组织) | 模型 | 记忆整理任务 | 同上 | 同 facts |
83
+ | `output/knowledge/memory/episodes/` | 事件记忆,按天 | 模型 | 记忆整理任务 | 同上 | 同 facts |
84
+ | `output/knowledge/profile/` | 画像:主人 / 他人 / 组织 | 模型 | 周期性更新 | Markdown + frontmatter | **累积型,永不归档** |
85
+ | `output/knowledge/topics/` | 主题梳理(把素材织成网) | 模型 | 按需 | Markdown | **累积型,永不归档** |
86
+ | `output/_archive/` | 产物冷归档(超过 3 个月) | 脚本 | 每月 1 号 | 保留原路径 | 只移动不改内容 |
87
+
88
+ ### 1.4 时间层级怎么排
89
+
90
+ | 目录 | 层级 | 例子 |
91
+ |---|---|---|
92
+ | `capture/conversation/` | 年 / 月 / 日 / 话题 | `2026/10/27/main-leiliang.agentid.cn-toleiliang8.agentid.pub/` |
93
+ | `capture/track/` | 年 / 月 / 日 | `2026/10/27/location.jsonl` |
94
+ | `capture/notes/` `links/` `files/` `scene/` `listening/` | 年 / 月 | `2026/10/2026-10-27-0919-现场.md` |
95
+ | `capture/meeting/` | 年 / 月 / 会议名 | `2026/10/26-产品评审会/` |
96
+ | `output/reports/daily/` | 年 | `2026/2026-10-27.md` |
97
+ | `output/reports/weekly/` `monthly/` `quarterly/` `yearly/` | 年 | `2026/2026-W43.md` |
98
+ | `output/meetings/` | 年 / 月 | `2026/10/2026-10-26-产品评审会.md` |
99
+ | `output/knowledge/memory/facts/` `episodes/` | 年 / 月 | `2026/10/2026-10-27-常驻上海.md` |
100
+ | `output/knowledge/profile/` `topics/` | **不分层** | `owner.md` |
101
+
102
+ **理由**:条目多、按天查的用「年/月/日」;条目少、按主题查的直接放。
103
+
104
+ ---
105
+
106
+ ## 2. 五个流转机制
107
+
108
+ ### 2.1 落地流(外部 → `capture/`)
109
+
110
+ ```
111
+ 触发器(cron 23:50 / session:idle)
112
+ ↓
113
+ 模型(判断今天落哪些、有无缺口)
114
+ ↓
115
+ 脚本 ingest.mjs
116
+ ├─ ec thread peers → thread list → thread history(增量,--after lastTs)
117
+ ├─ 写 conversation/年/月/日/<threadId>/{meta.json, transcript.md, transcript.jsonl}
118
+ ├─ 更新 state.json 的 cursors
119
+ └─ 写 _manifest/<date>.json(大小 + sha256)
120
+ ```
121
+
122
+ **幂等键**:`threadId + msgId`。重复跑不写第二遍。
123
+ **失败处理**:清单里记 `missing`,下次补。不静默跳过。
124
+
125
+ ### 2.2 产出流(`capture/` → `output/`)
126
+
127
+ ```
128
+ 定时触发器(22:30 日报 / 周日 周报 / 每月 月报)
129
+ ↓
130
+ 模型读 capture/ 下当期的原料 + output/tasks/ 的任务状态
131
+ ↓
132
+ 写 output/reports/<level>/<period>.md
133
+ ├─ frontmatter 带 period / report_type / summary
134
+ └─ 每条结论带 source 指回原料路径
135
+ ↓
136
+ 脚本 index-rebuild.mjs
137
+ ```
138
+
139
+ **关键约束**:`period` 是**覆盖的周期**,不是生成时间。10-28 写的 10-27 日报,归 `period: 2026-10-27`。
140
+
141
+ ### 2.3 提炼流(`capture/` → `output/knowledge/`)
142
+
143
+ ```
144
+ 每日 02:00 记忆整理触发器
145
+ ↓
146
+ 模型读昨天的 conversation/ 与 notes/
147
+ ↓
148
+ 按四类落盘:
149
+ rules/ 规则与偏好(发现即写,不过期)
150
+ facts/ 事实条目
151
+ entities/ 人物 / 组织
152
+ episodes/ 事件
153
+ ↓
154
+ 改主意时:不删旧条目,写新条目 + 把旧的标 status: superseded
155
+ ```
156
+
157
+ **这是与运行时记忆的根本区别**:运行时记忆会遗忘,这里**永不遗忘**,新旧并存可追溯。
158
+
159
+ ### 2.4 索引流(全量重建)
160
+
161
+ ```
162
+ 任一写入(落地 / 写作 / 归档)
163
+ ↓
164
+ index-rebuild.mjs
165
+ ├─ 扫描 capture/ 与 output/ 下所有 md
166
+ ├─ 解析 frontmatter(type / date / tags / source)
167
+ ├─ 生成 INDEX.md(最近 90 天)
168
+ ├─ 生成 .assistant/index/{tags.md, by-source.md}
169
+ └─ 生成 .assistant/index/archive/YYYY-MM.md(按月分片)
170
+ ```
171
+
172
+ **索引永远是生成物**,不手工维护。删掉重跑即可恢复。
173
+
174
+ ### 2.5 归档流(冷热分层)
175
+
176
+ ```
177
+ 每月 1 号 03:00
178
+ ↓
179
+ archive.mjs(默认 dry-run,--apply 才移动)
180
+ ├─ 读 schema 的 archive_after_months
181
+ ├─ capture/X → capture/_archive/X/...(保留原相对路径)
182
+ ├─ output/X → output/_archive/X/...
183
+ └─ knowledge/ 一律跳过(永不归档)
184
+ ↓
185
+ 重跑 index-rebuild.mjs
186
+ ```
187
+
188
+ ---
189
+
190
+ ## 3. 三条硬规则
191
+
192
+ **规则一:任何结论都能追回原料。**
193
+ `output/` 下每条记录都带 `source:`,指向 `capture/` 的具体路径。顺着它:报告 → 记忆 → 对话原文,一路能走到底。
194
+
195
+ **规则二:`.assistant/` 整个删掉能恢复。**
196
+ 只要 `capture/` 和 `output/` 在,索引、日志、缓存全部能重建。
197
+ **唯一例外是 `state.json`**——删了不丢数据,但丢失落地游标(会导致重复落地,靠幂等键兜住)。
198
+
199
+ **规则三:`capture/` 只增不改。**
200
+ 写错了再写一条,旧的不动。这样才能回看「当时是怎么想的」。
201
+
202
+ ---
203
+
204
+ ## 4. 哪些目录当前是空的,为什么
205
+
206
+ | 目录 | 状态 | 原因 |
207
+ |---|---|---|
208
+ | `capture/listening/` | 空 | 聆听转写在存储层,托管会话读不到(G2) |
209
+ | `capture/meeting/` | 空 | 同上 |
210
+ | `capture/scene/` | 空 | 照片本体同上 |
211
+ | `capture/track/` | 空 | 位置/应用/健康数据同上 |
212
+
213
+ **这些目录仍然要建**——建了才说明结构完整,等能力开放时直接往里落,不用改 schema。
214
+
215
+ ---
216
+
217
+ ## 5. 文件格式规范
218
+
219
+ ### 5.1 md 的通用结构
220
+
221
+ ```markdown
222
+ ---
223
+ id: 2026-10-27-1200-标题
224
+ date: 2026-10-27T12:00:00+08:00
225
+ type: note
226
+ tags: [标签1, 标签2]
227
+ source: 自己
228
+ ---
229
+
230
+ 正文
231
+ ```
232
+
233
+ | 字段 | 必填 | 说明 |
234
+ |---|---|---|
235
+ | `id` | ✅ | 全局唯一,格式 `<日期>-<时分>-<标题>` 或 `<类型>-<日期>-<序号>` |
236
+ | `date` | ✅ | **带时区偏移**的 ISO8601 |
237
+ | `type` | ✅ | 决定渲染模板与索引分类 |
238
+ | `tags` | ✅ | 可为空数组 |
239
+ | `source` | ✅ | `自己` / 人名 / `ec-thread:<id>` / `capture/` 相对路径 |
240
+
241
+ ### 5.2 各 type 的专属字段
242
+
243
+ | type | 专属字段 |
244
+ |---|---|
245
+ | `task` | `status` / `horizon` / `priority` / `due_at` / `completed_at` / `owner_note` / `stale_checks` |
246
+ | `report` | `period` / `report_type` / `summary` |
247
+ | `meeting` | `duration_min` / `participants` / `transcript` / `action_items` |
248
+ | `profile` `memory` `topic` | `memory_kind` / `status` / `supersedes` / `superseded_by` |
249
+ | `conversation` | `thread_id` / `peer` / `count` |
250
+ | `scene` | `photo` / `location` |
251
+
252
+ ### 5.3 jsonl
253
+
254
+ 只用于逐条机读(对话、轨迹)。一行一个 JSON 对象,UTF-8,无缩进。
255
+ `capture/conversation/**/transcript.jsonl` 的字段:`msgId / dir / from / to / ts / time / type / text`
256
+
257
+ ### 5.4 文件命名
258
+
259
+ ```
260
+ <日期>-<时分>-<标题>.md 例:2026-10-27-1200-会议模式界面.md
261
+ ```
262
+
263
+ 日期 `YYYY-MM-DD`,时分 24 小时制 `HHmm`,标题 ≤ 20 字,**无空格、无标点**。
264
+
265
+ ---
266
+
267
+ ## 6. 目录与脚本的对应关系
268
+
269
+ | 目录 | 负责脚本 |
270
+ |---|---|
271
+ | 全部目录结构 | `init.mjs`(建)、`check.mjs`(查)、`migrate.mjs`(修) |
272
+ | `capture/conversation/` | `ingest.mjs` |
273
+ | `capture/_manifest/` | `ingest.mjs` |
274
+ | `INDEX.md` `.assistant/index/` | `index-rebuild.mjs` |
275
+ | `capture/_archive/` `output/_archive/` `output/tasks/done/` | `archive.mjs` |
276
+ | 全库检索 | `search.mjs` |
277
+ | 完整性校验 | `verify.mjs` |
278
+ | 触发器定义 | `init.mjs --with-triggers` |
279
+
280
+ **其余目录由模型(会话)直接写**:`notes/` `links/` `files/` `scene/` `output/reports/` `output/meetings/` `output/tasks/` `output/knowledge/`。
281
+
282
+ ---
283
+
284
+ ## 7. 一句话总结
285
+
286
+ | 问题 | 答案 |
287
+ |---|---|
288
+ | 目录干嘛的 | 原料进 `capture/`,产物出 `output/`,运行时在 `.assistant/` |
289
+ | 谁生成 | 能确定的交给脚本,需要判断的交给模型 |
290
+ | 何时生成 | 定时(cron)/ 事件(聆听结束、会话空闲)/ 即时(用户说话)|
291
+ | 什么格式 | md + frontmatter 是唯一形态;jsonl 只用于逐条机读;json 只用于清单与状态 |
292
+ | 怎么流转 | 落地 → 产出 → 提炼 → 索引 → 归档,五条单向链,每条都可重跑 |
@@ -0,0 +1,350 @@
1
+ # 渲染配置
2
+
3
+ > 版本:v1(对应工作区 schema v1)
4
+ > 读者:前端设计师 / 前端工程师
5
+ > 前置:先读 `04-frontend-contract.md` 了解数据形态(markdown + frontmatter)
6
+ > 用途:照着这份文档,一套渲染器就能画完所有目录,不用每个目录写专页
7
+
8
+ ---
9
+
10
+ ## 1. 问题
11
+
12
+ 工作区有十几个目录、11 种 type。如果每个目录都做一个专门的前端页面,前端会碎成十几份特设实现,维护成本随目录数线性增长。
13
+
14
+ **收敛为:一套标准渲染器 + 每个目录最多一份渲染配置。**
15
+
16
+ 渲染器只有一份,读配置决定怎么画。配置是 YAML,不是代码,也不引入第二份数据——它只描述「这个目录的 md 怎么被呈现」,本身不复制任何内容。
17
+
18
+ ---
19
+
20
+ ## 2. 统一渲染模型
21
+
22
+ ```
23
+ ┌─────────────────────────────────────────┐
24
+ │ 标准渲染器(唯一) │
25
+ │ 读 render.yaml → 决定 layout 和字段 │
26
+ │ 扫目录 → 解析 frontmatter → 排序分组 │
27
+ │ 点开 → 渲染正文 markdown │
28
+ └─────────────────────────────────────────┘
29
+ ↑ ↑
30
+ 目录的 render.yaml 目录里的 md 文件
31
+ (声明怎么画) (数据本体,见 04)
32
+ ```
33
+
34
+ - **列表页**:渲染器按 `render.yaml` 扫该目录下的 md,取 frontmatter 组装卡片/行/列
35
+ - **详情页**:点进去读同一文件的正文,按 markdown 渲染
36
+ - **没有第二份数据**:配置只引用 frontmatter 的字段名,不复制字段值
37
+
38
+ ---
39
+
40
+ ## 3. 渲染配置规范
41
+
42
+ ### 3.1 文件
43
+
44
+ | 项 | 值 |
45
+ |---|---|
46
+ | 文件名 | `render.yaml` |
47
+ | 位置 | 放在被它描述的目录里(如 `output/tasks/render.yaml`) |
48
+ | 是否必须 | 否。没有 `render.yaml` 的目录用默认配置(见 §5.6) |
49
+ | 谁写 | 助理在初始化或升级时写入;用户也可手改 |
50
+
51
+ 一个目录最多一份 `render.yaml`。子目录可以有自己的,覆盖父目录的(就近原则)。
52
+
53
+ ### 3.2 字段
54
+
55
+ ```yaml
56
+ title: 任务 # 目录的展示名(导航和页头用)
57
+ icon: ✓ # 图标,一个字符或 emoji,可选
58
+ layout: board # 见 §4:list | board | cards | gallery | chat
59
+ group_by: status # 按某字段分组,可选;board 强制按它分列
60
+ sort: # 排序规则数组,前面的优先
61
+ - {field: priority, order: asc}
62
+ - {field: date, order: desc}
63
+ fields: # 列表卡片显示哪些 frontmatter 字段,按顺序
64
+ - {key: id, show: false}
65
+ - {key: title, from: filename, label: 标题}
66
+ - {key: priority, label: 优先级, format: tag}
67
+ - {key: due_at, label: 截止, format: date, empty: 无}
68
+ - {key: tags, label: 标签, format: chips}
69
+ filter: # 默认过滤,frontmatter 字段值匹配才显示
70
+ status: {$ne: dropped} # 不等于
71
+ # status: active # 等于
72
+ # memory_kind: [fact, rule] # 在集合内
73
+ detail: # 详情页正文怎么渲染
74
+ body: markdown # markdown 渲染(默认)
75
+ # body: transcript # 对话流(见 04 §6.4)
76
+ ```
77
+
78
+ ### 3.3 `fields` 的 `format` 取值
79
+
80
+ | format | 渲染 | 适用字段 |
81
+ |---|---|---|
82
+ | `text` | 纯文本 | 任意字符串 |
83
+ | `date` | 本地化日期时间 | ISO8601 字段 |
84
+ | `tag` | 小标签着色 | 枚举值(priority、status) |
85
+ | `chips` | 多个小标签 | 数组(tags) |
86
+ | `bool` | 勾/叉 | 布尔 |
87
+ | `count` | 数字,可做角标 | 整数 |
88
+ | `omit` | 不显示 | 显式隐藏 |
89
+
90
+ ### 3.4 `from` 取值
91
+
92
+ | from | 含义 |
93
+ |---|---|
94
+ | `frontmatter` | 默认,取 frontmatter 里 `key` 同名字段 |
95
+ | `filename` | 取文件名(去掉扩展名),用于没有 `title` 字段时 |
96
+
97
+
98
+ ---
99
+
100
+ ## 4. layout 一览
101
+
102
+ **只有五种 layout,覆盖全部目录。** 新增目录若不适合任意一种,先回头质疑这个目录该不该存在。
103
+
104
+ ### 4.1 `list` — 列表
105
+
106
+ ```
107
+ ┌───────────────────────────────────────┐
108
+ │ 标题 日期 摘要 标签 │
109
+ ├───────────────────────────────────────┤
110
+ │ xxx 10-27 14:30 …… [开发] │
111
+ │ yyy 10-27 09:19 …… [现场] │
112
+ └───────────────────────────────────────┘
113
+ ```
114
+
115
+ - 一行一条,字段按 `fields` 声明的顺序排
116
+ - 适合条目多、以「扫一眼找到某条」为主的目录
117
+ - 默认按 `date` 倒序
118
+
119
+ ### 4.2 `board` — 看板
120
+
121
+ ```
122
+ ┌───────┬──────────┬──────────┬─────────┐
123
+ │ 待办 │ 进行中 │ 已完成 │ 已放弃 │
124
+ ├───────┼──────────┼──────────┼─────────┤
125
+ │ [卡] │ [卡片] │ [卡片] │ [卡片] │
126
+ │ [卡] │ [卡片] │ │ │
127
+ └───────┴──────────┴──────────┴─────────┘
128
+ ```
129
+
130
+ - 按 `group_by` 字段分列,每列一张卡片
131
+ - 卡片是缩小版列表项,字段同样来自 `fields`,但通常只显示前 3 个
132
+ - 适合有明确状态流转的目录
133
+
134
+ ### 4.3 `cards` — 卡片网格
135
+
136
+ ```
137
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
138
+ │ 标题 │ │ 标题 │ │ 标题 │
139
+ │ 摘要 │ │ 摘要 │ │ 摘要 │
140
+ │ [标签] │ │ [标签] │ │ [标签] │
141
+ └──────────┘ └──────────┘ └──────────┘
142
+ ```
143
+
144
+ - 等宽卡片,自动换行
145
+ - 适合条目少、每条信息量大、适合「翻看」的目录
146
+ - 默认按 `date` 倒序
147
+
148
+ ### 4.4 `gallery` — 图文画廊
149
+
150
+ ```
151
+ ┌──────────┐ ┌──────────┐ ┌──────────┐
152
+ │ [图] │ │ [图] │ │ [图] │
153
+ │ 标题 │ │ 标题 │ │ 标题 │
154
+ │ 位置 │ │ 位置 │ │ 位置 │
155
+ └──────────┘ └──────────┘ └──────────┘
156
+ ```
157
+
158
+ - 每张卡顶部是图(来自 frontmatter 的 `photo` 字段),下方是文字
159
+ - 图取不到时显示占位(见 04 §8)
160
+ - 适合有视觉主体的条目
161
+
162
+ ### 4.5 `chat` — 对话流
163
+
164
+ ```
165
+ ┌───────────────────────────────────────┐
166
+ │ ← leiliang 09:19 │
167
+ │ 以下是我对你的直接提问…… │
168
+ │ │
169
+ │ 09:19:49 to leiliang → │
170
+ │ 上海宋庆龄故居纪念馆…… │
171
+ └───────────────────────────────────────┘
172
+ ```
173
+
174
+ - 按消息时间线渲染,左右分栏表示方向
175
+ - 正文按 04 §6.4 的消息流格式切分
176
+ - 只适合 `capture/conversation/`
177
+
178
+ ---
179
+
180
+ ## 5. 各目录的 render.yaml
181
+
182
+ 下表是每个目录的建议配置,助理在 `init` 时按这份写入。`default` 表示不写 `render.yaml`,用默认。
183
+
184
+ | 目录 | layout | group_by | 关键 fields | 说明 |
185
+ |---|---|---|---|---|
186
+ | `output/tasks/` | board | `status` | priority, due_at, tags | 任务看板 |
187
+ | `output/reports/daily/` | list | — | period, summary, tags | 按 period 倒序 |
188
+ | `output/reports/weekly/` | list | — | period, summary, tags | 同上 |
189
+ | `output/reports/monthly/` | cards | — | period, summary, tags | 月报条目少,用卡片 |
190
+ | `output/reports/quarterly/` | cards | — | period, summary, tags | 同上 |
191
+ | `output/reports/yearly/` | cards | — | period, summary, tags | 同上 |
192
+ | `output/meetings/` | list | — | duration_min, participants, action_items | 按 date 倒序 |
193
+ | `output/knowledge/profile/` | cards | — | tags, summary | 人物画像 |
194
+ | `output/knowledge/memory/` | list | `memory_kind` | status, summary | 按 memory_kind 分组,默认隐藏 superseded |
195
+ | `output/knowledge/topics/` | cards | — | tags, summary | 主题卡片 |
196
+ | `capture/conversation/` | chat | — | peer, count | 对话流 |
197
+ | `capture/scene/` | gallery | — | location, summary | 看现场 |
198
+ | `capture/notes/` | list | — | tags | 随笔 |
199
+ | `capture/links/` | list | — | url, summary | 链接 |
200
+ | `capture/listening/` | list | — | duration, summary | 聆听(媒体不可用时只显示摘要) |
201
+ | `capture/meeting/` | list | — | duration_min, participants | 会议原料 |
202
+ | `capture/track/` | list | — | location, tags | 行为轨迹 |
203
+ | `capture/files/` | list | — | size, mime | 收到的文件 |
204
+
205
+ ### 5.1 示例:`output/tasks/render.yaml`
206
+
207
+ ```yaml
208
+ title: 任务
209
+ icon: ✓
210
+ layout: board
211
+ group_by: status
212
+ sort:
213
+ - {field: priority, order: asc}
214
+ - {field: date, order: desc}
215
+ fields:
216
+ - {key: id, show: false}
217
+ - {key: title, from: filename, label: 标题}
218
+ - {key: priority, label: 优先级, format: tag}
219
+ - {key: due_at, label: 截止, format: date, empty: 无}
220
+ - {key: tags, label: 标签, format: chips}
221
+ filter:
222
+ status: {$ne: dropped}
223
+ ```
224
+
225
+ ### 5.2 示例:`output/knowledge/memory/render.yaml`
226
+
227
+ ```yaml
228
+ title: 记忆
229
+ icon: ◆
230
+ layout: list
231
+ group_by: memory_kind
232
+ sort:
233
+ - {field: date, order: desc}
234
+ fields:
235
+ - {key: id, show: false}
236
+ - {key: summary, label: 摘要}
237
+ - {key: memory_kind, label: 类型, format: tag}
238
+ - {key: status, label: 状态, format: tag}
239
+ - {key: date, label: 时间, format: date}
240
+ - {key: tags, label: 标签, format: chips}
241
+ filter:
242
+ status: active
243
+ ```
244
+
245
+ ### 5.3 示例:`capture/scene/render.yaml`
246
+
247
+ ```yaml
248
+ title: 看现场
249
+ icon: ◉
250
+ layout: gallery
251
+ sort:
252
+ - {field: date, order: desc}
253
+ fields:
254
+ - {key: id, show: false}
255
+ - {key: photo, label: 现场图, format: image}
256
+ - {key: summary, label: 摘要}
257
+ - {key: location, label: 位置, format: text}
258
+ - {key: date, label: 时间, format: date}
259
+ - {key: tags, label: 标签, format: chips}
260
+ ```
261
+
262
+ `format: image` 是 gallery 专用,渲染为卡片顶部的图。取不到时(见 04 §8)显示占位。
263
+
264
+ ### 5.4 示例:`capture/conversation/render.yaml`
265
+
266
+ ```yaml
267
+ title: 对话
268
+ icon: ⌂
269
+ layout: chat
270
+ sort:
271
+ - {field: date, order: desc}
272
+ fields:
273
+ - {key: id, show: false}
274
+ - {key: peer, label: 对端}
275
+ - {key: count, label: 条数, format: count}
276
+ - {key: date, label: 日期, format: date}
277
+ detail:
278
+ body: transcript
279
+ ```
280
+
281
+ `detail.body: transcript` 让渲染器按 04 §6.4 的消息流切分正文,而不是当成普通 markdown。
282
+
283
+ ### 5.5 示例:`output/reports/daily/render.yaml`
284
+
285
+ ```yaml
286
+ title: 日报
287
+ icon: ☰
288
+ layout: list
289
+ sort:
290
+ - {field: period, order: desc}
291
+ fields:
292
+ - {key: id, show: false}
293
+ - {key: period, label: 日期, format: text}
294
+ - {key: summary, label: 摘要}
295
+ - {key: tags, label: 标签, format: chips}
296
+ ```
297
+
298
+ ### 5.6 默认配置
299
+
300
+ 目录没有 `render.yaml` 时,渲染器用默认值:
301
+
302
+ ```yaml
303
+ title: <目录名首字母大写>
304
+ layout: list
305
+ sort:
306
+ - {field: date, order: desc}
307
+ fields:
308
+ - {key: id, show: false}
309
+ - {key: title, from: filename, label: 标题}
310
+ - {key: date, label: 日期, format: date}
311
+ - {key: tags, label: 标签, format: chips}
312
+ ```
313
+
314
+ 也就是说,任何没特别声明的目录都能用列表展示出来,不会空着。
315
+
316
+ ---
317
+
318
+ ## 6. 命名哲学
319
+
320
+ 用户对命名的要求:**舒服、优雅**。以下是各 layout 的展示名建议(`render.yaml` 里的 `title`)。
321
+
322
+ | layout | 展示名建议 | 理由 |
323
+ |---|---|---|
324
+ | board | 「任务」 | 看板自带状态分列,名字越短越稳 |
325
+ | list | 「日报」「周报」「随笔」「链接」 | 列表适合名词单字 |
326
+ | cards | 「画像」「主题」「月报」 | 卡片适合翻看,名字略厚 |
327
+ | gallery | 「现场」 | 图文,名字指向场景 |
328
+ | chat | 「对话」 | 流式,名字指向行为 |
329
+
330
+ 避免:
331
+ - 「XX管理」「XX中心」「XX系统」——后缀官僚气
332
+ - 「我的XX」——第一人称多余
333
+ - 复合词「任务看板」「会议列表」——看板/列表已经是 layout,不用再进名字
334
+
335
+ **目录名本身(`tasks`/`reports`/`memory` 等)是技术标识,展示名走 `render.yaml` 的 `title` 字段,两者解耦**。用户觉得哪个目录的名字不顺眼,改 `title` 一行就行,不用动目录结构。
336
+
337
+ ---
338
+
339
+ ## 7. 与 04 的关系
340
+
341
+ 这份文档只描述「怎么画」,不重新定义数据契约。所有关于 frontmatter 字段、解析规则、不可信内容转义、媒体不可用等内容,**以 04 为准**。
342
+
343
+ | 这份管什么 | 04 管什么 |
344
+ |---|---|
345
+ | 列表卡片显示哪几个字段 | 字段叫什么、类型是什么 |
346
+ | 用哪种 layout | type 有哪些 |
347
+ | 按什么排序分组 | frontmatter 怎么解析 |
348
+ | 展示名叫什么 | 文件命名规则 |
349
+
350
+ 两份文档独立维护。这份新增 layout 或字段格式不影响 04;04 新增 type 时,这里需要补一行 §5 的映射表。