黑洞（dsh-blackhole）· 压缩即归档
给长会话做「压缩即归档」的 DSH 插件：上下文涨到事件视界时自动压缩，被压掉的原文逐字落到本地归档区，同时生成可按会话 / 日期检索的索引；需要时能把原文找回来。
解决的问题很具体：长任务里压缩上下文一定会丢东西，丢了就再也找不回。大多数方案只保证「摘要还在」，黑洞还要保证「原文也在」。
它怎么工作
- 阈值三段
-eventHorizon（默认 0.6）：上下文占比到这里，开始压缩并归档。
-solidifyLine（默认 0.75）：固化线，过了就不再指望还能压回去。
-hardCap（默认 0.9）：硬上限。 - 窄段门槛：
minCompactEvents/minCompactTokens（默认 2 条事件或 2000 token）。前缀太窄时摘要压不小，白烧一次调用还留一份废件，所以先跳过，等它自然变宽。 - 归档：被压掉的原文按会话、日期分段写进
archiveRoot，文件名带段号与摘要，正文是逐字原文，不是再压缩过的版本。 - 索引：同目录下
index.md（人读）与index.jsonl（机器读）一行一段，记录：哪个会话、哪天、压了哪几段、原文在哪个文件。 - 找回：需要旧内容时，从索引查到原文路径，直接读文件。
- 事件流：压缩生命周期里追加
compact.archived/compact.skipped/archive.failed三类事件，别的插件可以按 offset 增量读，接进自己的账本。
0.3.0 加了什么
- 冷库读端（
bh_restore_span）：按「会话 + seq 区间」从原文库取回，返回digest（逐字校验用）和latencyMs；每次取回写一条recall.hit事件，谁在什么时候取了哪一段都可查。 - 块仓（
bh_compress/bh_restore/bh_search）：任意文本可逆存取，带source/tags，不依赖模型；适合作业中间产物、日志片段。 - 按天轮换视界（
dailyHorizon）：{start, ratios}按天数取档位，跨零点自动切换，不用重启。 - 按会话覆盖档位（
sessionRatios）：给特别忙的会话单独设线（例如单步协议会话设 0.5，别人仍是全局档）。 - 折叠冷却（
foldCooldownMs/foldCooldownMax）：同会话在窗口内最多折 N 次，治「折一段、几分钟长回来」的追尾；计数落盘跨重启。配两条放行（连续被拦 8 次、或 tokens 到硬顶 95%），宁可多折一次也不把会话憋爆。 - 采样（
sampleFile）：每轮记一行表面大小、折叠耗时、剪枝收益，用来算「一次折叠省了多少 surface、花了多少」。 - 卡片补「为什么」：每张索引卡除了「起点/收尾/工具」，加一行
rationale（从原文抽出带因果/取舍的原话，不改写）和pointer（回取指针），解决「压缩后只剩骨架、决策依据没了」。
配置
- insert:
- id: blackhole
name: dsh-blackhole
config:
eventHorizon: 0.6 # 事件视界
solidifyLine: 0.75 # 固化线
hardCap: 0.9 # 硬上限
thresholdRatio: 0.6
retainRatio: 0.16 # 保留近期内容不压
archiveRoot: "D:\\archive\\context" # 原文真源（改成你自己的目录）
stateRoot: "D:\\archive\\state" # 插件状态/缓存（可重建）
pendingTtlMs: 600000
minCompactEvents: 2
minCompactTokens: 2000
archiveRoot 是原文的家，建议放在你不想丢的盘上；stateRoot 丢了可以重建。
安装
- 把本目录放到你的 dsh profile 能加载的位置（
node_modules/dsh-blackhole，或插件目录后在 cordis 层里引用）。 - 在 profile 的层配置里加上面那段
insert。 - 重启 dsh，日志里应出现插件激活。
目录结构（archiveRoot 下）
archiveRoot/
├── 索引.md 人读索引：会话 / 日期 / 段 / 原文路径
├── index.jsonl 机器读索引：一行一段
├── README.md 归档区规则
└── originals/ 原文分段文件（逐字）
状态与边界
- 0.3.0，自用中；Windows 上跑得最多，其他平台没验证过。
- 只在「压缩」发生时归档，不会主动扫描历史会话。
- 写盘是同步的：宁可慢一点，也不接受「摘要写了、原文没写」。
- 测试：
npm test（archive / blocks / cards / coldstore / events / fade / fold-cooldown / gate / heartbeat / logic / pipeline / region / rotation / rotation-refresh / session-ratio / tools，共 16 组，全绿）。
想找人帮忙的地方
- 怎么把它做成「别人也能装」的版本：发布流程、跨平台路径处理、以及跟宿主版本升级的兼容策略。
- 归档检索还只有文件索引，想听听有没有更省事的做法。
