潮汐记忆 · 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,
  "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 全局那份，加工作目录那份），所以这段一放进去，接手的模型在新会话第一次请求时就会看见。

规矩说清楚：

• 用 <!-- dsh-memory-tide:begin --> / <!-- dsh-memory-tide:end --> 圈起来，块外一个字都不改。
• 文件不存在就建一个（带 # 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