ofttold-memory · 拾光

中文 | English

记忆注入插件 — 把记忆带进每一个会话。

_{一条笔记只在被摆到眼前时才有用 · 一次注入，全程在场 · 不用再依赖「记得去看」 · 开箱即用}

_{DSH 插件 · 其他 harness：规划中}

dsh plugin --profile web add ofttold-memory@latest

       

---

一眼看清： 你的笔记读一次、注入一次，之后每一轮都在上下文里，第一轮之后成本为 0。600 字符约 400 token，一个会话只算一次。装完基本不用再动配置。

flowchart LR
    A[你的笔记<br/>MEMORY.md] -->|按小节名取| B[读取 + 截断]
    B --> C[注入一次<br/>作为用户消息]
    C --> D[会话上下文]
    D -->|留在历史里| E[之后每一轮]
    D -.->|可选<br/>refreshAfterMessages| C

一次读取，一次注入。没有索引、没有向量、没有数据库，也没有第二次检索。

---

快速开始

dsh plugin --profile web add ofttold-memory@latest

这就是全部安装步骤。 装的是 npm 上的预构建产物，没有构建步骤，不需要额外授权；想跟仓库最新代码走，把包名换成 github:IcyDate/ofttold-memory 即可。 第一次运行会创建 ~/.dsh/ofttold-memory/，并铺一份四文件骨架：MEMORY.md（注入源）、INDEX.md（日记索引）、relationship.md（我是谁 + 情绪缓存区）、diary/（一天一个文件）。全是空壳加注释，一条记忆都不预填——写什么只能由你决定。把 memoryDir 指向你已有的文件夹——日记、索引、规则文件都算——插件只补缺的那几个文件，已有文件一个字都不动：它会补上 relationship.md（情绪词表与缓存区住在那里）和 diary/（块尾那句提醒靠它），否则写的那一半会缺一块。

然后打开 设置 → 拾光 用鼠标调整，或者直接改 profile 的 cordis.patch.yml。

---

文件长什么样

# 我的记忆

## 常被提起

> 建议上限 8 条。满了按权重沉底——挤掉这个动作本身就是一次排序，
> 比「想起就随手加一条」可靠。

- **项目在哪** → `~/work/my-project`｜省掉每次都要问
- **什么不能动** → 不要改 `config/prod.yml`

## 我是谁

- （怎么称呼我、说话习惯、脾气、在意什么）

## 硬约定

- （不写就会干错活的：谁归谁管、哪些命令不能跑）

判断什么该进来，只有一个标准： 不看见它会不会干错活？不是「重要」，不是「经常提到」，而是**「不看见就会出错」**。按这个标准写，八条足够；按「重要」写，永远不够。

清单满了不会越写越长

写满 8 条之后，插件按权重挑谁沉底，而不是靠谁记得去删一条：常被翻出来的留下，久没被提过的沉下去。沉底不是删除——还在文件里，日记里再提一次就浮回来。

公式和推导在 设计说明 § 沉底机制。

一天的摘要在顶部

一天的文件开头是 ## 今天（17:40 更新）——两三句：这天是什么日子、什么感觉，吐槽就写这儿。细节在下面，想翻再翻。

摘要是随写随新的：写一节的同时顺手改它，不是晚上补。插件会把 （HH:mm 更新） 和正文最后一个 ## HH:mm 比一比，正文跑过摘要就点名——所以「加班到 21:00 又写了一节」这件事不会让摘要悄悄过期。

summaryFrom（默认 17:30）之前不催摘要：上午写的那半截本来还不是一天。

日记体检

同一行还管三件事，都是只报不改：

看到什么	会说什么
一天超过 diarySections 节（默认 8）	9 sections, over the 8-per-day bar
有节没写 情绪： 行	2 without an \情绪：` line`
标签的词不在词表里	烦躁 not in the vocabulary
用了标签但没有词表节	tags used, but relationship.md has no \情绪词表` section`
过了 summaryFrom 还没有摘要	no \## 今天` summary at the top`
摘要落后于正文	summary stopped at 17:40, body runs to 21:10

整句长这样：Diary check — 9 sections, over the 8-per-day bar; …

「标签必须来自词表」不是口味，是结构：值只能取词表里的词，所以表外的标签永远匹配不上——不报错，只是那天从此不能被情绪找到。

只报不改：整理必然压缩，而压缩会删掉权重赖以计算的「被想起」的证据。推导在 设计说明 § 一条结构性的规矩。

记一个情绪

relationship.md 里的 **现在** 那一行是活值：只放此刻的情绪，不放原因。改它用工具，不靠记格式：

remember_emotion(word: "定")
→ 现在：`定`（2026-10-30 11:20 更新）（原来是 `心虚`）

• 词必须在同一份文件的 ## 情绪词表 节里，否则拒绝并列出可用的词
• 词表节不存在时也拒绝——不在这里造一份默认词表，那就又多一份会漂的拷贝
• 只改反引号里的词和时间戳，那一行的标点、前后文字一个字节不动

为什么是工具不是文档：这一行一天要改好几次，而两种错法都不出声——词不在表里，之后和日记标签永远对不上；时间戳忘了写，缓存看着像新的。

块尾那一行

如果笔记文件夹里有 diary/，注入的末尾会多一行状态：

- no diary entry for 2026-10-30 yet (`diary/2026-10-30.md`)

它刻意写成一行状态，不是一句指令——没有「快写」，也不点 skill 的名字。因为同一个块尾还装着上面的体检报告，那是真的会坏事的消息；提醒要是也一副催的口气，两行都会被跳过。它只花一次 stat，作用是让「今天写不写」不靠想起来的。

多久写一次由 diaryCadence 决定：daily（默认）每天催；weekly 只在最近 7 天一个字都没写时才开口；off 永不提醒。两种情况下它都会闭嘴：没有 diary/ 目录（这说明这个文件夹不走日记这套），或者 cadence 是 off（那是想停写又不想删历史）。

---

真正要调的只有这几个

配置项	默认值	含义
memoryDir	~/.dsh/ofttold-memory	记忆文件夹。第一次运行自动补齐缺失的文件。
sections	["Oft-told", "常被提起"]	取哪几节。直接写小节名。
maxChars	600	每节字符上限。600 字符约 400 token。
anchorCap	8	一节的粗体列表最多留几条，超出的沉底但不删。0 关掉。
summaryFrom	"17:30"	从几点开始要求顶部有 ## 今天 摘要。
diaryCadence	"daily"	多久写一次：daily / weekly（最近 7 天有写过就不催）/ off（永不提醒）。
diarySections	8	一天最多几节，超了体检会点名。
diaryCheck	true	日记体检开关。

这 9 项在设置页里都能改（面板把布尔项画成勾选框，不用手打 true/false）。剩下的 header、workspaceRelative、refreshIntervalMs、refreshAfterMessages 也有面板入口，只是平时不用动。完整字段表、sections 的对象写法、小节名精确匹配、跨平台行为在 配置说明。

---

名字从哪来

这个插件是从一个人和一个 AI 之间真实跑通的一套办法里长出来的，名字也是那套办法给的。

拾光 —— 也是时光的谐音。意思落在「拾」这个字上：把散落的东西，一件一件捡回来。

那套办法是：一个日记文件夹、一份索引（顶上列着几条常被提起的事）、还有一条写在 AI 指令最前面的要求——每次开工先读这两个文件。这条要求一直管用，直到它不再管用；而它失效的位置，恰恰是它本该守住的地方——会话开头，新消息最要紧的那一刻。

于是要求换成了机制。那份清单从「模型得记得去读的东西」变成了「它不可能错过的上下文」。 整个改动就这一句话。

---

为什么不用写进 AGENTS.md？

因为一条指令和一条注入的消息，付钱的方式不一样。

	每轮成本	会不会被跳过
AGENTS.md 里一条规矩	每轮都付，整条规矩的长度	会——而且是不声不响地
这个插件	第一轮之后是 0	不会——已经在历史里了

系统指令跟着每一个请求走；注入的消息只付一次——第一轮之后它就是历史，后面的轮次当已有上下文读。实测一次注入是 735 字符 ≈ 660 token，每会话一次；一条规矩则是每轮、永远，付它整条的长度。只要规矩比注入块长，规矩就输了，而它几乎立刻就输了。

所以：内容放进记忆文件，别把指令塞进 AGENTS.md。

---

它做什么，不做什么

会做的都是「每次都应该发生、但靠自觉一定漏」的那类：

• 把清单摆到眼前（每会话一次）
• 清单满了，按 exp(-t / 2^n) 算谁该沉底
• 没有日期的锚点，就地补上「从哪天起算」
• 文件夹缺东西时补上（缺哪个补哪个），提醒今天日记没写，读不到时说明试过什么
• 今天那篇日记的体检：节数超了、缺 情绪： 行、标签不在词表里、摘要落后于正文

不做的恰好是需要判断的那一半：

• 不替你决定记什么。 清单里写什么、允许它沉谁，都是写的人的事——插件只负责算。
• 不替你判断现在是什么情绪。 值由写的人定；但写这一下插件管——remember_emotion 工具会校验词表、带上时间戳，词不在表里就拒绝并列出有哪些。
• 不自动写日记。 没写就提醒一句，不会替你补。

分界线是「失败了看不看得见」：看不见的必须交给代码，看得见的留给写的人。 上限、权重、词表的推导在 设计说明。

---

什么都没注入时

文件不存在、小节名改了，都不会抛错。一节都没读到时，注入块会照实说它试过什么：

Could not load any section. Tried: INDEX.md → 常被提起 (heading_not_found)

heading_not_found 只差一个字也算没找到（常被提起 匹配不上 常被提起（手动维护））。空文件夹则是另一种说法：这是第一天，不是坏了。

完整记录仍然在：

cat ~/.dsh/ofttold-memory/diagnostics.json

每一次注入决策都在里面：文件夹、读到几节、哪几节失败以及为什么。它从不记录你笔记的正文，所以可以直接贴进 issue。设置页里有「复制问题摘要」按钮，取的是同一份信息。

event	意思
injected	成功。loaded 是节数，chars 是注入块大小。
nothing-loaded	文件夹找到了，但没有配置的小节名对上——通常是改了标题。读到这一条时，会话里也会出现一段说明，写明找过哪个文件、哪个标题。
tail	块尾那句：nudged＝提醒了今天没写，checked＝体检说了话，issue 是它说了什么。

文件不存在，说明插件根本没走到决策那一步，问题在安装而不在内容。

---

其他 harness

规划中。 插件绑死 DSH；同样的办法打算做成 skill 分发，让别的 harness 也能读。还没在第二个 harness 上跑通过，所以这里不写用法。

---

License

MIT。