Progressive Disclosure
渐进式披露，和我们的记忆系统
一句话：需要的时候才看，别一上来全摊开。
一、渐进式披露是个啥？
「渐进式披露」(Progressive Disclosure) 是个产品设计老概念：先只给你看最关键的一层，想深入了，再点开下一层。
就像看餐厅菜单 🍱
你先看到的是「热菜 / 凉菜 / 主食 / 饮料」这几个大类（一页纸）。
想吃热菜，才翻到热菜那一页，看到几十道具体的菜。
—— 没人会把后厨 200 道菜的做法、克数、成本全印在第一页糊你脸上。
对 AI（也就是我）来说道理一样：我的「注意力 / 上下文」是有限的。一次性把所有记忆塞进来，反而会抓不住重点、还慢还贵。所以我们把记忆设计成一层一层、用到才展开。
二、我们的记忆就是这么搭的
Akke 项目的记忆（docs/claude-memory/）刚好是个标准的三层渐进式披露：
1
MEMORY.md ——「总目录」（每次开工自动加载）
只放分组指针，比如「抖音抓取 → 看 _index_douyin_scraping.md」。它就是那张菜单首页，薄薄一张，一眼看完。
2
_index_*.md ——「分组目录」(sidecar，按需 Read)
比如聊到 Cookie 登录，我才去翻 douyin 那本分册，看到这组下面有哪些具体知识点。相当于翻到「热菜」那一页。
3
末端明细文件 ——「具体那道菜」(再按需 Read)
真要动手了，才打开那一条完整记忆看细节。一道菜的完整做法，吃这道才看。
触发的过程长这样：
你提到「Cookie 登录」
→
我从 MEMORY.md 找到对应指针
→
Read 那本 _index 分册
→
再 Read 末端那条明细
关键词没出现，我就不往下翻 —— 这就是「progressive disclosure：看到触发词才展开」。
三、为什么非这么干不可？
✗ 如果不分层（全摊开）
把所有记忆细节全堆进 MEMORY.md：文件越来越大 → 超过系统的加载上限被截断（我们设了 8KB / 120 行的红线）→ 重要的反而被挤掉 → 我每次还得读一堆当下用不上的东西，又慢又容易跑偏。
✓ 分层之后
首页永远轻巧、稳定加载；细节沉到分册里，要用才取。容量可以无限长，但每次只「付」我真正需要那部分的成本。
省脑容量不占着上下文窗口，重点不被淹没。
更快更省不读无关内容，响应快、token 花得少。
不超载截断首页始终在系统加载上限内，不丢信息。
好维护知识各归各位，新记忆并进对应分册即可。
一句话记住 👉 渐进式披露 = 「目录薄、分册厚、按需翻」。
MEMORY.md 是目录，_index 是分册，末端文件是内页 —— 我永远从目录进，顺着指针往下挖，不一上来全读。