潮汐记忆 · dsh-tide-memory
给 DeepSeek Harness 里的会话一份会淡忘、会过时、看得见的长期记忆。
别人的记忆插件多数是「存下来 + 全塞回去」；潮汐记忆的取舍是：
证据够不够决定它进不进上下文，鲜活度只决定它排多前。
它解决的三个具体问题
- 忘了该记的 —— 跨会话之后，你上次交代的边界、偏好、约定全没了。
- 记得太多反而更笨 —— 把一摞旧事全塞进提示词，模型开始在不相关的地方乱套用。
- 记忆是个黑盒 —— 你不知道它为什么想起那一条，也没法纠正。
三条设计取舍（跟别家不一样的地方）
| 取舍 | 潮汐记忆 | 常见做法 | 为什么 |
|---|---|---|---|
| 进不进 | 证据分 C = s/(s+2)，低于阈值（默认 0.35）根本不进 | 按相似度 top-k 全塞 | top-k 总会给你 k 条，哪怕一条都不相关 |
| 淡忘 | 事件半衰期 30 天，带情绪 7 天，事实类永不衰减 | 无衰减 / 全部按时间排 | 情绪浓的事该记得更久，画像和约定不该淡 |
| 过时 | 标 supersededBy，新旧都留，可回看 | 直接覆盖或删除 | 「他以前住哪」也是信息，删了就没了 |
再加一条工程上的：没有 900KB 的用户词典。分词靠二元组 + 单字（二元组权重 1、单字 0.5），
idf 用记忆库自己的 df 现算。少一份词典，换个领域也不会水土不服。
v0.2 改了什么
- 前后的说法对不上时，不再并排塞给你自己看：写入时如果跟库里某条同类记忆撞了关键词，会记一句「跟这条对不上」；两条都被想起来的场合，只留新的那条，旧的缩进括号里当注脚。传了
supersedes就明确挂成「改过的版本」。谁作废、谁算数，由当场说那句的人判断，插件不替你删。 - 多了一个「今天翻出来几次、用上几次」的计数（
pulse.json）。同机的迭代记忆会读它，把「旧事真被用上了」算成状态好一点——两个插件各写各的文件，谁都没装也不影响谁。
装上
从 GitHub 装（推荐，插件市场也是这么发命令的）：
dsh plugin --profile desktop add github:MingHuanYue/dsh-tide-memory # 桌面端
dsh plugin --profile web add github:MingHuanYue/dsh-tide-memory # 命令行 web 端
# 装完重启一次 DSH，设置页里才会出现「潮汐记忆」
从 npm 装（发布之后可用）：
dsh plugin --profile desktop add dsh-tide-memory
本地源码装（改代码调试用）：
dsh plugin --profile desktop add file:D:/path/to/dsh-tide-memory
用起来
给它工具（模型自己会调）：
tide_remember—— 记一条：text / kind（event 或 fact）/ imp 0~1 / emo 0~1 / keys / 可选 supersedes（取代哪条）tide_recall—— 按线索找：query / limittide_forget—— 标过时（不是删）tide_stats—— 库里现在多少条、多少还活着tide_recall和tide_remember的返回里会带conflicts/supersedes，撞车了当场就知道
给人看的界面：设置 → 潮汐记忆
- 记忆库下拉：每个工作区一个库，显示条数和最近一条的时间
- 手动记一条：选「事件／事实」和重要度
- 搜索 + 过滤：还在的／事实／事件／钉住的／已过时／全部
- 每条卡片：类型、鲜活度百分比与色条、被想起次数，按钮有 钉住 / 改 / 标过时 / 删
- 看它怎么想起来的：最近几轮注入的 trace，每条的 C（证据）、P（排序分）、act（鲜活度）
- 设置区：开关、事件半衰期、情绪半衰期、每轮最多几条、证据阈值、字数上限
记忆存在哪
$DSH_HOME/tide-memory/
├── config.json # 全局设置
├── trace.jsonl # 注入日志（「怎么想起来的」）
├── pulse.json # 今天翻了几次、用上几次（跨天自动归零）
├── stores/.jsonl # 每个库一行一条
└── cold/.jsonl # 冷宫：淡到快没了又没被想起的（没删，能翻回来）
一行长这样：
{"id":"ly3k9x","t":1761215000000,"last":1761215000000,"kind":"fact",
"text":"主人不喜欢别人替他做决定，什么事都要先问一句",
"keys":["决定","边界"],"imp":1,"emo":0.5,"hits":3,"pinned":false,"supersededBy":null}
纯 JSONL，随手 grep 就能翻，也能自己写脚本搬进搬出。
打分怎么算的
act = kind 是 fact ? 1 : 0.5 ^ (天数 / 半衰期)
C = s / (s + 2) // s = 命中词的 idf × 词权重 之和
P = C × (0.55 + 0.25·act + 0.15·imp + 0.05·emo)
- C 低于阈值 → 不进上下文（默认 0.35：一条明确命中就过半，两条更稳）
- 进的那几条按 P 排序，最多 6 条 / 800 字
- act 低于 0.05 且从未被想起的事件 → 挪进冷宫
调阈值是这套东西最有效的一个旋钮：觉得它乱想起来就调高，觉得它太健忘就调低。
排障
装完起不来：先看 profile 的 package.json 有没有被工具写成带 BOM 的 UTF-8。
$p = 'D:\nodejs-data\dsh-home\profiles\desktop\package.json'
[System.IO.File]::WriteAllText($p, [System.IO.File]::ReadAllText($p), (New-Object System.Text.UTF8Encoding($false)))
设置页没出现「潮汐记忆」：重启 DSH；还没出现就 dsh --profile desktop --dump-config 看 bundle 名单里有没有 dsh-tide-memory。
从 GitHub 装报 exit code 128：pnpm 把 github: 解析成 SSH 了。
git config --global url."https://github.com/".insteadOf "git+ssh://git@github.com/"
权限与隐私
- 只读写
$DSH_HOME/tide-memory/下的自己的 JSONL 文件，不碰别的目录。 - 不联网：没有云端、没有 embedding 服务、没有 key。分词和检索全在本地算，一次几十毫秒。
- 记忆只有两个来源：模型主动调
tide_remember，或者你在设置页手动记一条。 - 每轮注入了哪几句，会同时写进
trace.jsonl，设置页里能直接看（C / P / act 三个数）。 - 想清空：删掉
stores/下对应的*.jsonl，或者在设置页逐条删。卸载插件不会删数据，重装还在。
兼容性
- DSH >= 0.1.7-rc.1（见
package.json的engines.dsh），Node >= 22。 - 图形界面挂在设置页，桌面端和 web 端都能用（client 走
dsh.client声明，platform: web）。 - 记忆库按工作区分桶：同一个工作目录下的会话共用一个库，换项目不串味。
- 已知显示层小瑕疵：设置页的库下拉里偶尔会出现一行
ws-xxx__的重复名，
那是文件名把中文折成了下划线（同一份数据），不影响读写，重启后按safeKey归并就没了。
License
MIT
