topmind Memory

默认记忆模型（产品真理）：

层	路径	用途
主 memory	memory/profile.md	「我的情况」— 偏好 / 目标 / 关系 / 进行中
周期子 memory	memory/periodic/{YYYY}/{period}.md	周期反思（stream_digest / ai_summary 确认后）

建立/归入专题（内容大类夹）→ organize / topic_classify，路径 {大类}/{YYYY-主题}/topic.md。
不是默认写入 memory/topics/。

用户意图	写哪里
关于我	memory/profile.md
周期反思	memory/periodic/{YYYY}/
开/并专题（长期主题夹）	内容大类下专题（organize 建议 · 确认后 create_topic）
明确说「把结论写进专题记忆层」	可选 memory/topics/{slug}.md（语义平面 · 非默认）

Activation checklist

1. 判目标：关于我 → profile；周期反思 → periodic；开专题 → 交 organize / 内容大类（勿默认 memory/topics）
2. 筛 confirmed · stable · reusable · scoped
3. Core：memory.append-profile；周期反思：digest 路径；仅用户明说专题语义记忆时才 memory.append-topic
4. 整文替换需可逆备份

核心画像（Core Profile）

• 路径：memory/profile.md（语义平面；原 我的情况.md）
• topmind.yaml → memory.layers.global.file（默认 profile.md）
• 推荐段落：## 偏好 · ## 当前目标 · ## 关键的人与协作 · ## 进行中的事；完成/过期条目归档到 ## 历史记录（加 （YYYY-MM-DD 归档） 前缀，不删内容）
• 缺失时创建模板后追加

UTR: memory.append-profile --content "…"
Desktop: append_core_memory · update_core_memory · retire_core_memory
Host: 读 profile（活跃段）→ ADD / UPDATE 原位 / RETIRE 到 ## 历史记录 → 写回

事实生命周期（确认式，无自动遗忘，不是只追加）：

• 追加（ADD）：新稳定事实 → append_core_memory / memory.append-profile（跨活跃段落去重，禁止第二条活事实）
• 更新（UPDATE）：含义变了 → update_core_memory（原位改写并刷新日期，不要再 append 一行）
• 归档（RETIRE）：已完成/过期 → retire_core_memory（活跃段 → ## 历史记录，加 （YYYY-MM-DD 归档） 前缀，不删内容）

用户说「这件事做完了 / 这条过时了」→ 归档，不要删除；「这条改成…」→ 原位更新。memory_organize 产出 append_profile / update_profile / retire_profile 建议（须确认）。AI 上下文只注入活跃事实（历史段折叠为计数）。

周期反思（Periodic）

• 路径：memory/periodic/{YYYY}/{YYYY-Www}.md 等
• 来源：活动窗口 AI 建议（stream_digest / ai_summary）确认后写入
• 反思非摘要：不是「本周发生了什么」，而是「本周揭示了什么」——关注焦点、知识与见解、行为信号、偏好变化、线索
• 与 profile 同属记忆平面；不是专题目录

可选：专题语义记忆（非默认）

仅当用户明确要求「写到专题记忆 / memory topics」时，才写入 memory/topics/{topic-slug}.md。
日常「这个值得开个专题」→ 内容大类下 {YYYY-主题}/，不是 memory 平面。

When NOT to use

• 存材料 → capture
• 理顺本周流水 / 建议开专题 → organize「整理本周」（活动窗口）
• 分析/整理笔记（不写记忆）→ organize
• 起草/交付 → write
• 体检/巡检 → maintain / loop

守门

• 禁止因 capture / 剪藏 / 导入 自动改 profile 或 memory/topics/
• 禁止整理过程中顺手狂写（organize 只可建议候选；topic 建议进内容大类）
• 仅用户明确「记住 / 更新我的情况 / 写进专题记忆」或当轮确认

Role-aware density

• 日常事实 → 周期本或「我的情况」
• 反复主题 → 建议内容大类专题，不默认 memory/topics
• buffer / delivery / system 通常不适用

Capability Degradation

`../shared/capability-degradation.md`。
memory.append-profile · memory.append-topic · inspect-topic。

保存设置

• 自动保存 (auto)：默认；写回执
• 需要审阅 (confirm)：先预览
• 见 `../shared/writeback-receipt.md`。