dsh-hippocampus

海马体——三方公共共享的记忆巩固层（2026-10-22 架构定案）。

dsh-linghun（收口者）、dsh-linghun-memory（记忆资源层）、dsh-linghun-assembler（装配器）三方通过同一实例访问的记忆巩固层，不归属任何一边：单独放哪边，另外两边缺；各带一份，合体出竞态 bug。抽出来三方共享，签名不变、调用方零改动。

零模型依赖，纯 node:fs / node:path 实现。

能力

• 暖态工作记忆（warm）：解析 / 渲染 / 触达（touch access）/ 去重（near-duplicate）/ 注入排序
• 冷储归档（cold）：摘要 / 截断，暖态沉淀为冷储
• 情景单元（episodic）：原文一 session 一文件，可激活为当前条目，可索引
• 检索原语：MMR 去冗余、BM25 关键词检索、token / Jaccard 相似度

导出速览

| 组 | 导出 | |---|---| | 常量 | WARM COLD EPISODIC_DIR JOURNAL_DIR KINDS | | warm 解析渲染 | kindOfBlock parseWarm renderWarmEntries | | 规范化与匹配 | normalizeForMatch normalizeText matchRef filterWarmByRef filterTextByRef | | 排序 | sortWarmNewestFirst sortWarmByAccess sortWarmForInject | | 检索 | tokenizeForSim jaccardSim mmrSelect buildBm25Stats bm25Score bm25Retrieve | | 编辑维护 | findWarmEntryRef replaceWarmEntryText markWrongWarmEntryText findNearDuplicateWarm touchWarmAccessText | | 冷储 | summarizeWarmForCold truncateKeepHead | | 情景单元 | slugifyTheme unitFileName renderEpisodicUnit parseEpisodicUnit renderWarmUnitBlock activateWarmUnit renderEpisodicIndex | | 工厂 | createHippocampus(root, readText) |

用法

import { createHippocampus } from "dsh-hippocampus";

const hc = createHippocampus("/path/to/memory-root", (f) => readFileSync(f, "utf8"));
// hc.warm / hc.cold / hc.episodic / hc.retrieval ...

测试

node --test tests/*.test.mjs   # 8 个等价性对照测试（与 memory.js 逐函数对照）

许可

AGPL-3.0