[Feature] heat 热度衰减（D 批次）：访问频率调制的记忆升权与自然降温（opt-in）

[modusensus]

背景

#164 的论文调研（六篇）给 A1/C1/C2 提供了理论锚点，其中遗忘三篇（2604.00131 / 2601.18642 / 2604.02280）共同指向同一件事：记忆系统需要一层「受访问频率与时间调制的热度衰减」，否则要么无限膨胀（长程性能 0.45→0.05 的反面教材），要么一刀切硬删（丢掉本可复活的低频高价值记忆）。

本 issue 立项 D 批次：heat 热度衰减，按刻意保守的路径落地：opt-in → 真实数据 → 对照论文找偏差。

理论依据（三篇）

1. Oblivion（2604.00131，EMNLP 2026）：遗忘 = 降低可及性而非删除——经验随时间变得不易获取，但可被强化或情境线索重新激活；且「帮过忙的记忆应被强化」。与本项目 archived/forgotten 两列的既有设计同构，本 issue 是它的量化延伸。
2. FadeMem（2601.18642）：不同记忆应有不同衰减率，由语义相关性、访问频率、时间模式三者调制；存储可缩减 45%。幂律 vs 指数的对比结论在正文（待全文核对后补充引用）。
3. 2604.02280：容量「预算化」——按新近性 + 频率 + 语义对齐评分，有界淘汰；反面教材：不管理记忆时长程性能从 0.45 跌至 0.05。

现状与依赖

• last_accessed_at 列与 touch 路径已在 store 存活（历史遗留的现成数据地基）；
• [Feature] 记忆复用率仪表盘：召回 Top-N / 僵尸记忆率 / 注入命中率可见化 #217 记忆复用率仪表盘是本特性的频率信号源（上游 issue，已发）；
• updated_at ⊥ last_accessed_at 契约必须保持：heat 是运行时投影，不写镜像、不碰 updated_at。

v1 范围（刻意保守）

• 🔴 发布阻塞项：
  • heatEnabled 默认 false（opt-in），进 feature_flags 白名单，面板可启停；
  • 与 lightMode 联动（回滚开关）；
  • 降级/归档路径照常走 receipt / llm-audit 审计（不因 heat 引入无审计的静默行为）。
• 🟡 核心语义：
  • 幂律衰减：heat = 1 / (1 + λΔt)^α（λ、α 可配，含按类型的差分衰减位 heatTypeDecay）；
  • 访问即回温：touch 路径刷新 last_accessed_at；
  • 只影响注入排序：order=chrono 分页/月份树所依赖的稳定序不动；heat 不写镜像、不改 updated_at；
  • 编码记忆门控与 fix(inject): 首轮注入同步兜底改用 BM25 词法召回——旧偏好不再占满槽位（#198） #199 的优先级链不受影响（heat 作为同级内的乘数）。
• 🟢 后补（不阻塞）：order=heat 排序、状态页热度分布卡、徽章。

验收

1. 默认关闭时行为与改动前逐字节一致（既有注入排序测试零变化）；
2. 开启后：合成数据集上衰减/回温曲线符合幂律预期（测试内断言）；
3. feature flags 白名单 + lightMode 联动 + 双语文档；
4. 真实负载观察一周期后，在 聊几个我觉得值得做的方向 #164 回帖记录「论文假设 → 实测 → 偏差」研究笔记（幂律是否成立、访问频率调制的实际权重）。

明确不做（v1）

• 容量硬裁剪与自动归档（A1 另行，heat 曲线成熟后再议）；
• heat 参与检索打分（先只做注入排序，避免同时动两条链路）；
• 任何形式的硬删除。

参考

• 讨论：聊几个我觉得值得做的方向 #164（论文调研与采纳排期）
• 数据源：[Feature] 记忆复用率仪表盘：召回 Top-N / 僵尸记忆率 / 注入命中率可见化 #217（复用率仪表盘）
• 论文：arXiv 2604.00131 / 2601.18642 / 2604.02280（遗忘），2603.07670（综述框架），2608.19652（状态演化评测，后续 C1 用）

[heptaspirit]

认领（heptaspirit）。补一个设计出处：heat 这套「访问频率调制升权 + 自然降温」的方向，最早是我们 8 月 20 日在讨论 #21（兴趣漂移方向调研）里提的——当时列了 FSRS 遗忘曲线、差分衰减分层（那时就点了 FadeMem 的长期层慢衰减 / 短期层快衰减）、多信号加权召回、Weibull 衰减 + 低热度归档这些候选形态，后来被吸收进了 heat 的设计方向。这次的三篇遗忘论文（2604.00131 / 2601.18642 / 2604.02280）恰好把当初的直觉补成了有依据的立论，2601.18642 就是当年表里那篇 FadeMem。

对「opt-in → 真实数据 → 对照论文找偏差」的保守路径没有异议。我们库里有 1800+ 条真实记忆、dream_runs 全量决策与 recall 留痕，真实负载数据这步可以就地取材；第一步的拆解（opt-in 开关层、访问频率信号源与 #217 的衔接）会先在这里把方案贴出来再动手。

[modusensus]

出处补记（回应 #164 设计对齐里的溯源）：heat 的设计方向最早来自讨论 #21（2026-08-20，兴趣漂移方向调研）中提出的候选形态——FSRS 遗忘曲线、差分衰减分层（当时已点到 FadeMem 的长期层慢衰减/短期层快衰减）、多信号加权召回、Weibull 衰减 + 低热度归档。#218 立项时引用的三篇遗忘论文（2604.00131 / 2601.18642 / 2604.02280）与 #21 的候选形态高度收敛，本 issue 的 opt-in 幂律实现路径即为两条线的合流。感谢 @heptaspirit 的溯源——设计源流已理清：#21 提出方向 → 三篇论文提供理论锚点 → 本 issue 定 v1 范围。

[modusensus]

@heptaspirit FadeMem 全文核对更正：立项公式需复核

#218 原文将 FadeMem（arXiv 2601.18642）列为幂律衰减的依据。经逐式核对 v2 全文确认：FadeMem 的衰减函数是广义指数（stretched exponential），不是幂律——power law 在原文中出现 0 次，此前「幂律 vs 指数的对比在正文」的说法系转述失真，特此更正。

FadeMem v2 正文中可直接复用的设计件：

• Eq 4 衰减函数：v(t) = v(0) · exp(-λ·Δt^β)
• Eq 5 重要性调制：λ = λ_base · exp(-μ·I)——越重要衰减越慢，对应本 issue 的访问频率/重要性调制位
• Eq 6 分层形状：长期层 β=0.8（亚线性长尾）/ 短期层 β=1.2（超线性）——对应 heatTypeDecay 的按类型差分
• Eq 7 访问强化：v(t+) = v(t) + Δv·(1 - v(t))·exp(-n/N)——递减收益（spacing 效应），对应 touch 回温路径

落地前须拍板衰减函数（本 issue 第一个阻塞项）：

• (a) 改采广义指数 exp(-λΔt^β)——有 FadeMem 背书；β=1 退化为纯指数，β<1 时长尾行为接近幂律；
• (b) 保留幂律 1/(1+λΔt)^α——需另找文献依据（幂律遗忘在心理学/间隔重复文献有支持，但不在 聊几个我觉得值得做的方向 #164 已收集论文之列）。

现状补充：heat 模型是 v0.7.0 存量代码（heat.js，heatEnabled 默认关闭、feature flags 白名单可启停），公式变更影响面 = heat.js 衰减式 + heatGlobalAlpha/heatTypeDecay 配置位 + 验收第 2 条的曲线断言。默认关闭期间变更零迁移成本。

倾向 (a)：背书干净、参数族更丰富（速率 λ 与形状 β 可正交配置）、实现成本相同。选型定了就同步更新本 issue 的核心语义与验收条目。

[heptaspirit]

公式选型跟进 + 一阶段拆解（认领跟进）。

选型：同意 (a)，广义指数 H = exp(-λ·Δt^β)

• FadeMem v2 Eq 4–7 四个设计件与现有代码面一一对应，背书干净；β 管形状、per-type λ 管速率，两者正交，β=1 退化为纯指数，<1 亚线性长尾。
• (b) 的文献现状补一条留痕：幂律在心理学遗忘文献（Wixted & Ebbesen 1991；Rubin & Wenzel 1996 的 210 组数据拟合）与间隔重复工程（FSRS 默认曲线 (1+t/9S)^-0.5）有支持，但确实不在 聊几个我觉得值得做的方向 #164 已收集论文集里。按你的倾向走 (a)；验收第 4 条真实负载回放时拿本机数据对两个曲线族做拟合 A/B，若幂律显著更贴合再带数据回来讨论。
• 配置位：heatGlobalAlpha → heatGlobalBeta（形状 0.5–2，默认 1.0 中性起步）。FadeMem 的分层形状（长期 0.8 / 短期 1.2）若真实数据显示需要，再议 per-type β，v1 不预先建。λ 语义不变：λ=0 免疫位在指数式下同样恒 1；默认 λ 值沿存量数值，回放步骤重新校准。

现状盘点（存量比 issue 正文写的多，改动面收窄）

v0.7.0 存量已存活：heat.js 纯函数（幂律 + per-type λ 免疫位）、heatEnabled 默认关 + settings 白名单、lightMode 联动（config.js LIGHT_MODE_OFF）、touch 回温（touchRecalled：检索与注入双触发、heatEnabled 门控、best-effort）、sleep 降级联合判定（dream_runs 回执照走）、/list 逐条热度投影 + 状态页热度分布卡（自门控）。

• 🔴 三项阻塞里「默认 false / 白名单 / lightMode 联动 / 降级走审计」已满足；缺口是面板启停：heatEnabled 不在 client.js 的 FEATURE_GROUPS / 高级折叠组里，补进面板。
• 🟡 核心缺口是注入排序乘数：现状 heat 完全不参与注入排序（配置注释明确「不改变召回排序」）。落法：injectCandidates 规则路 comparator 的层内权重 importance×quality 乘 heat；priority 分层（summary / preference / coding）不动，store 的 order=chrono 分页序不碰；heat 关闭时乘数恒 1，排序与改动前一致。一个口径请你确认：selectiveInject 相似度重排开启且向量可用时，相似度优先于热度（话题信号是既有设计）——heat 生效面 = 规则路排序与语义路回填序。
• 🟡 曲线断言（验收 2）：合成数据集断言衰减单调、touch 回温重置、免疫类型恒 1、β=1 纯指数边界；heatEnabled=false 时注入排序与改动前逐字节一致（既有测试零变化）。

顺序：面板开关位 + 公式替换 + 曲线测试先行（默认关全绿）；注入乘数同 PR 落（v1 范围本就一件事，压一个 commit）；order=heat 排序、热度分布增强等 🟢 项不动。注入留痕若按 #217 的 mode='inject' 方案定了，频率信号接入作为后续增量。

[heptaspirit]

顺着你在 #218 里引的 FadeMem Eq7（访问强化递减收益），接一个旧话头：Discussion #21 里我曾给 heat 提过一版「间隔效应 / spike boost」的方向性提案（评论），当时 v0.7.0 采纳了 TYPE_DECAY、连续 heat 等五点，spike 部分没有落地。这轮做 #234/#233 的过程中我们把当年的提案重新过了一遍，三个关键观察在 5bd2dab 上逐一确认仍然成立，加上 heat 线本身重新激活（#234 换广义指数 + β 配置位），所以值得重新排期：

1. 数据面前置正在补齐。 spike / 访问强化需要「访问事件序列」（次数 × 间隔 × 来源），touchRecalled 只留 last_accessed_at 一个时刻。feat(stats): 记忆复用统计端点与面板卡（#217） #233（[Feature] 记忆复用率仪表盘：召回 Top-N / 僵尸记忆率 / 注入命中率可见化 #217）里提的 mode='inject' 复用 recordRecall 若被采纳，注入事件就有账了——这正是当年提案「落地路径 2」的数据前提。

2. 衰减层已定型，boost 需要重新推导。 feat(heat): 广义指数衰减 exp(-λΔt^β) + 注入排序热度乘数（#218） #234 把公式换成 exp(-λ·Δt^β) 后，旧提案的加性 spike（decay + boost 冲 1.0）未必还是最优形；在新式子上更自然的可能是 FSRS 式「稳定化」——成功访问降低有效 λ 或抬 v0，而不是加性尖峰。这个选型和验收 4 的 λ 重校准 / 幂律-广义指数两族 A/B 可以共用同一批回放数据。

3. 口径已对齐。 dsh-mneme 兴趣漂移（Interest Drift）方向调研与思路分享 #21 里你采纳的第 2 点「recall_runs 隐式反馈接入排序（默认关）」在 v0.7.0 没有落地（recall_runs 在 5bd2dab 上仍无消费端，feat(stats): 记忆复用统计端点与面板卡（#217） #233 的统计是第一个读者但只读不反馈）；Eq7 正好是它的论文表述。

建议的排期切法：heat 线第三步 = 访问频率 / 间隔效应，前置两步——①λ 重校准 + 两族 A/B（本 issue 验收 4）→ ②注入留痕 mode='inject'（#217 提案）。是否单独立项、以及加性 spike vs 稳定化乘性的选型，等回放数据出来再定比较稳。

（补充一个这轮开发里重新确认过的遗留观察，锚 5bd2dab 仍成立：touchRecalled 对所有命中无差别 touch，低分候选也刷时钟——无论最终走不走 spike，这个分档都值得单独看一眼。）

[modusensus]

口径确认：selectiveInject 相似度重排开启且向量可用时，相似度优先于热度——确认。

理由与生效面就按你 11:42 拆解的口径执行：

• 话题信号是既有设计（selectiveInjectEnabled 默认开）：注入槽位优先给当前话题相关的记忆，heat 是「这条记忆长期可及性还剩多少」的正交信号，把 heat 插进相似度序会混淆两个维度；
• heat 生效面 = 规则路排序（层内 importance×quality 乘 heat）+ 语义路回填序（索引未返回行的回填次序），相似度序本身不动。这样 heatEnabled=false 与向量可用两条路径的行为都最干净，不会出现双重加权；
• priority 分层与 order=chrono 分页序照旧不碰。

关于昨天那条 spike / 间隔效应的重新排期：同意这个切法。heat 线第三步 = 访问频率/间隔效应，前置两步——①λ 重校准 + 幂律/广义指数两族 A/B（本 issue 验收 4）→ ②注入留痕 mode='inject'（#217 口径已确认接受）。是否单独立项、加性 spike vs 稳定化乘性的选型，都等回放数据出来再定——同意，不预支结论。届时选型优先对照 FadeMem Eq 7 的形态：exp(-n/N) 的递减收益天然是「稳定化」一族的形状，加性尖峰要有数据优势才值得翻案。

touchRecalled 无差别 touch 的遗留观察：成立。分档（阈值/Top-K 才刷时钟）作为第三步的设计输入，不在 #234 范围内动——#234 保持「面板启停位 + 公式替换 + 曲线测试先行（默认关全绿）+ 注入乘数」一个 commit 的范围，order=heat 排序与热度分布增强等 🟢 项不动。

按 #234 的口径开工吧，验收时按老规矩过。