潮汐记忆 XHszDHM/dsh-memory-tide

潮汐记忆 · dsh-memory-tide

给 DeepSeek Harness 用的记忆插件：近的记忆常驻、远的沉下去、用得多的自己浮上来。

上下文是稀缺资源。日记一天一天写下去，早晚会把上下文撑爆——可真正被反复用到的，永远是最近那几天，加上少数几件旧事。

潮汐记忆做的就是这件事：把记忆分成热档和冷档两层，每天归纳一次，自动升降。

新的一天 → 热档（每次都读） │ 7 天以后，没人查 ▼ 冷档（用到才翻） │ 被查得多了 └──────────→ 升回热档，钉住

它长什么样

memory/
├── MEMORY.md 长期要点（永不沉档，人的脾气、规矩、坑都在这） ├── TODO.md 待办 ├── archive/ │ ├── hot/ │ │ ├── INDEX.md 热档索引 —— 短，每次必读 │ │ └── 2026-10-29.md │ └── cold/ │ ├── INDEX.md 冷档索引 —— 翻旧账时才读 │ └── 2026-09-30.md ├── .tide.json 配置（全部可调） └── .usage.json 每份记忆被查了几次

索引也是分开的，这一点是重点：热档索引每次都在上下文里，所以它必须短；冷档索引你不翻就永远不读。MEMORY.md 里只写一句「冷档在 archive\cold\」，不给日期、不给目录。

升降规则

| 情况 | 结果 |
| 距今 ≤ hotKeepDays（默认 7）天 | 一定留在热档 |
| 更早，但被查过 ≥ promoteHits（默认 3）次 | 留在热档，并钉住 |
| 更早，也没人查 | 沉到冷档 |
| 冷档里被查过 ≥ coldPromoteHits（默认 5）次 | 升回热档，钉住 |
| 钉住之后 pinMaxDays（默认 90）天没再被查 | 解钉，重新参与流转 |
| 冷档超过 coldMaxFiles（默认 120）个 | 按日期从早到晚删 |
| 热档超过 hotMaxFiles（默认 0 = 不限） | 最老的沉到冷档（钉住的不动） |

「被查」按天算，不按条算——一天里被搜到五次，只记一次。这样热闹的那几天自己会浮起来。

搬档是移动，不是删除。 内容一个字不改，只是换个目录。

装

从 npm（上架后）
dsh plugin --profile desktop add dsh-memory-tide

从 GitHub
dsh plugin --profile desktop add github:XHszDHM/dsh-memory-tide

本地开发
dsh plugin --profile desktop add link:D:/path/to/dsh-memory-tide

桌面版没有 dsh CLI 的话，手改 profiles/<档名>/package.json 的 dependencies，把插件目录放进 profiles/<档名>/node_modules/ 也一样。

装完重启 DSH。

插件本身不依赖任何 @deepseek-ai/* 包——只用到宿主的 ctx.tools.register() 公开契约，参数 schema 是插件自己转出来的 JSON Schema。所以不管你是 link: 挂开发目录、还是 npm/github: 装进 profiles/<档名>/node_modules/，跑起来是同一份代码，不会因为宿主内部包解析不到而加载失败。

第一次在某个工作空间调用任意工具时，会在 <工作空间>/memory/ 下自动铺好目录、默认配置、MEMORY.md 和 TODO.md 的骨架。MEMORY.md 的骨架是带说明的——每一节装什么、为什么越短越好、哪些东西不该放这儿，打开就能照着填。已有的文件一个字都不动。

装在哪儿

记忆跟着工作空间走，不跟插件走：工具默认写当前会话的工作目录，所以同一个插件在不同工作空间里各有一份 memory/。要指别处，每个工具都有 root 参数。

七个工具

| 工具 | 干什么 |
| memory_search | 找东西。默认只翻热档，scope=all 连冷档一起 |
| memory_read | 把某一天整份读出来（不传就今天） |
| memory_add | 往某一天追加一段 |
| memory_index | 重建热/冷两层索引 |
| memory_lint | 体检：标题没带时间、重复小节、空小节、死指针、索引过期 |
| memory_tend | 冷热档归纳（dryRun=true 只出报告） |
| memory_stats | 看一眼现在几天、各被查过几次 |

每天跑一次

不用你记着，插件自己带了个定时器。

- 每半小时醒一次，看今天跑过没有；每个用过记忆的工作空间，一天自动归纳一次。
- 状态记在 $DSH_HOME/integrations/dsh-memory-tide/tend-state.json，重启不会重跑同一天，也不会漏掉当天。
- 只归纳已经有 memory/ 目录的工作空间 —— 没记忆的地方不会被凭空造出目录。
- 单个工作空间出错不影响别人，定时器也不会因为一次异常就死掉。

想关掉，把那个工作空间 memory/.tide.json 里的 autoTend 改成 false，之后只认手动调用 memory_tend。

手动调也行：memory_tend 就是归纳工具，dryRun: true 只看报告、不动文件。

配置

第一次用会在 memory/.tide.json 写一份默认的，改哪个都行：

{
"hotKeepDays": 7,
"promoteHits": 3,
"coldPromoteHits": 5,
"pinMaxDays": 90,
"coldMaxFiles": 120,
"hotMaxFiles": 0,
"sectionWarn": 30,
"searchLimit": 8,json
"searchContext": 3,
"autoTend": true,
"agentsHint": true
}

在设置页里改

装好后打开「设置 → 潮汐记忆」，顶部选一个工作空间，下面九个旋钮直接改，点「保存」写回那个工作空间的 .tide.json。

- 工作空间是自动列出来的：一打开就去读 DSH 自己的 $DSH_HOME/storages/workspace.json，把你用过的工作空间全摆进下拉，带标题、最近动过的排前面。同时合并插件自己记的那份（$DSH_HOME/integrations/dsh-memory-tide/workspaces.json）和当前会话的默认工作空间。
- 下拉里没有的，往「其它路径」粘一个绝对路径也能读；没被 DSH 记录过的工作空间就靠这条路。
- 每个工作空间各改各的，互不影响；「恢复默认」只重置当前选中的那一个。
- 设置页要重启一次 DSH 才会出现——浏览器的 bundle 是启动时收集的。

给 AI 看的那份

不用自己抄。 插件启动时会用 ctx.get('skills').register() 把一份叫 tide-memory 的技能登记到宿主的技能目录里，模型在什么时候该读它写得清清楚楚——什么时候翻记忆、翻旧事的三步、日记小节带时间、每天收尾跑 memory_tend、七个工具各干什么。

想改这份说明就改 src/skill.js，改完重载插件即生效。

宿主没有 skills 服务（或者版本太老）时会安静跳过。那种情况下，把 SKILL.md 的内容贴进 AGENTS.md 或系统提示，效果一样。

会在你的 AGENTS.md 里留一小段

技能只说明「有这么一套东西」，不等于模型开局就会去翻。所以插件还会往工作空间的 AGENTS.md 里同步一段几行的提示——记忆在哪儿、开局先读 MEMORY.md 和最近两天、翻旧事用 memory_search、写回去用 memory_add，外加两条最容易忘的：日记小节标题带时间（## 【14:30 干了什么】），凭据永远不写进记忆。

DSH 的 dsh-agent-instructions 会自动把 AGENTS.md 注入上下文（$DSH_HOME/AGENTS.md 全局那份，加工作目录那份），所以这段一放进去，接手的模型在新会话第一次请求时就会看见。

规矩说清楚：

- 用 / 圈起来，块外一个字都不改。
- 文件不存在就建一个（带 # AGENTS.md 标题）；已经有内容就追加在末尾。
- 内容没变就不写盘。
- 不想要就在设置页把「往 AGENTS.md 写提示」关掉，或者把 .tide.json 里 agentsHint 改成 false：插件会把那段撤干净，块外原文留着；如果整个文件只剩它当初建的空壳，连文件一起删掉。

顺便说清楚这个机制的脾气：AGENTS.md 不是每次请求都重新读盘的，它是在会话第一次请求时加载一次，然后作为一条持久消息留在上下文里。会话中途改了它，当前会话不一定看得到（下次文件系统操作到那个目录、或者恢复会话时会重新对账），但每一次新会话都是最新的。对这份「一次性写、以后基本不动」的提示来说，够用。

已经在用旧结构的记忆怎么办

memory/ 下直接躺着 YYYY-MM-DD.md 的，第一次跑 memory_tend 会原样搬进 archive/hot/。不需要手动整理。

许可

MIT

English version: README.en.md