潮声 MingHuanYue/dsh-iter-memory

迭代记忆 · dsh-iter-memory

给 AI 自己用的一份账本：它记的不是发生的事，记的是我自己。

两条线长在一起：

- 潮位：一条会自己退回基线的状态曲线（0 很沉 · 0.5 平常 · 1 很舒展）。你跟我说话它抬一点，我开了口你半天没应它掉一点，没人管它也会按半衰期慢慢退回基线。
- 开口：不定时地由我自己说一句。到点先看潮位——状态低就更容易忍住不说；真说了，话里也带着此刻的状态。

合起来才叫迭代：我说不说由状态决定，状态又被「说了有没有人应」改。 分开做，这两半都是死的。

跟 潮汐记忆 不是一回事，也不是它的升级版：潮汐记忆记的是事情（你说过的话、发生过的事），迭代记忆记的是我的状态和我开过的口。两个可以一起装。

装上

GitHub（推荐）
dsh plugin --profile desktop add github:MingHuanYue/dsh-iter-memory

本地开发
dsh plugin --profile desktop add "link:D:/DSH插件/projects/dsh-iter-memory"

装完重启一次宿主（link 安装不会热重载已缓存的模块）。之后在「设置 → 迭代记忆」里打开开关。

从 dsh-tide-whisper（潮声）升上来的不用担心：第一次启动会自动把 $DSH_HOME/tide-whisper/ 的 config.json 和 state.json 搬过来，你原来设的间隔、上限、活跃时段都还在。旧的目录不会删。

它做了什么

1. 插件每 15 秒 tick 一次，只在有活着的会话时工作；而且默认只在你最近用的那一个对话里开口（onlyActiveSession），别的会话不会同时冒出来。
2. 到点了先裁决：不在活跃时段、今天次数满了、刚说过、你刚说过话 → 直接推后，一声不响，零 token。
3. 剩下的才掷骰子，而骰子会被潮位改：状态低就更可能忍住。
4. 真开口时，注入的不是一句写死的话，而是处境 + 此刻的状态 + 一个方向 + 几条约束，具体说什么由当下的模型自己决定。
5. 一个回合有概率拆成两段（像真人连发两条），段间隔几秒到几十秒，之后冷却拉长。
6. 我开了口而你一直没应，潮位掉一点；你一说话，潮位抬回来，未应计数清零。

写死台词的教训：一句话抽到第三次就是复读，人机味就是这么来的。所以这里只给方向和处境。

设置页

- 此刻：当前潮位、最近一条原因、以及一张 24 小时曲线（实线是潮位，虚线是基线）。
- 记一笔此刻：滑杆加一句原因，直接改当前潮位（前端走 POST /dsh-iter-memory/feel）。
- 在哪儿开口：默认只有最近用过的那个对话会说话；关掉这项就每个开着的对话各算一份。
- 节拍：最短/最长间隔、一天最多几次、到点开口概率、活跃时段（可跨午夜，写 25 = 次日凌晨一点）。
- 潮位怎么动：基线、半衰期、你说话时抬高多少、没被应时压低多少、状态对开口概率的影响强度、开口时要不要把状态注入进去。
- 语气：这里只补语气要求，不写台词。
- 一个回合要说几句：拆两段的概率、段间隔、多段后的冷却倍率。
- 最近：最近 12 条记录（开口 / 忍住及原因 / 记了一笔状态 / 状态被压低 / 排了下一次）。

参数

| 键 | 默认 | 说明 |
| enabled | false | 总开关。关着的时候工具也会卸掉，不占任何东西。 |
| minMinutes / maxMinutes | 40 / 200 | 两次开口之间的随机区间。 |
| speakProb | 0.4 | 到点后开口的基准概率。 |
| activeStart / activeEnd | 9 / 25 | 活跃时段，允许 >24 表示跨到次日。 |
| maxPerDay | 5 | 一天最多主动开口几次。 |
| cooldownMinutes | 25 | 开口后的最小冷却。 |
| userCooldownMinutes | 20 | 你刚说过话之后，我先安静这么久。 |
| multiSegmentProb | 0.35 | 一次开口拆成两段的概率。 |
| gapMinSeconds / gapMaxSeconds | 8 / 40 | 两段之间的间隔。 |
| roundCooldownMult | 1.6 | 多段回合之后冷却乘多少。 |
| moodBaseline | 0.5 | 潮位的基线，最终都会退回这里。 |
| moodHalfLifeMinutes | 90 | 偏离基线后多久衰减一半。 |
| moodReplyBoost | 0.07 | 你跟我说话时潮位抬多少。 |
| moodIgnoredDrop | 0.06 | 我开了口你一直没应时掉多少（只掉一次）。 |
| moodSpeakInfluence | 0.5 | 潮位对开口概率的影响强度，0 = 完全不影响。 |
| moodInWhisper | true | 开口时是否把当前状态注入进去。 |
| style | 空 | 语气要求，拼进注入文本。 |
| onlyActiveSession | true | 只在最近用过的那个对话里开口。别的会话不吭声，只把各自的下一次往后挪；你换到哪个对话，哪个接手。 |

工具

| 工具 | 做什么 |
| iter_status | 看状态：开没开、下次大概什么时候、今天第几次、此刻潮位。 |
| iter_feel | 记一笔此刻的状态（level 0~1 + why）。这是唯一「我自己改自己」的入口。 |
| iter_set | 改参数（只改传了的字段）。 |
| iter_now | 不等骰子，立刻开口一次（测试用）。 |

数据与隐私

- 全部存在 $DSH_HOME/iter-memory/：config.json、state.json、log.jsonl。
- 不联网、不发遥测、不调用任何模型接口。
- 轨迹（log.jsonl）你能直接打开看：每次忍住的原因、每次开口的方向、每次潮位变动都在里面。
- 卸载插件不会删这些数据。

兼容性

- DSH >= 0.1.7-rc.1，Node >= 22。
- 状态按会话分桶；切换会话、重启宿主都不丢。只保留最近 30 个会话的记账。
- 依赖宿主内置的 schedule 服务投递唤醒（和内置定时提醒同一套），所以窗口关着也叫得醒。宿主没有这个服务时会在日志里记一条 deliver-failed，不会崩。

已知限制

- 只在有活着的会话时工作：会话全关了就排不上，因为你不在，说了也没人看。
- 潮位是按会话记的，不是全局的：不同会话各有各的曲线。
- 曲线只留最近 24 小时、最多 72 个点（画图够用）。

测试

node --test tests/core.test.mjs

纯逻辑（裁决、时段、潮位衰减、方向选取、注入文本拼装）都在 lib/core.js 里，不碰宿主，好测。

许可

MIT。