npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-memory-fish

v0.10.1

Published

Context-budgeted local memory for DeepSeek Harness: fixed ~600-token cache-friendly injection (session/daily snapshots), three-stage sleep consolidation, spaced repetition, temporal validity, subagent-driven L0 mental-model rewrite, typed memories (fact/s

Readme

小肥鱼记忆 · dsh-memory-fish

banner

npm CI license: MIT

上下文成本恒定的本地记忆插件。记忆可以无限长,注入永远只有 ~600 tokens。 它会睡觉、会复习,也记得住"上个月我们用的什么方案"。

English · 设计 · 调研 · 更新日志 · 安全

它解决什么

现有记忆插件的通病:记忆越多 → 索引越长 → 每次会话注入越多 → 又贵又慢。

小肥鱼记忆把「存储」和「注入」拆开:

| 层 | 内容 | 注入 | 预算 | |---|---|---|---| | L0 画像 | 你是谁、偏好、硬约束(v0.8 起自动重写) | 每次会话 | ≤200 tok | | L1 热索引 | 置顶 + 最近 10–20 条标题 | 每会话(v0.9 快照冻结) | ≤400 tok(有待办时让出最多 100) | | L2 温记忆 | 完整正文 | 按需工具读取 | 0 | | L3 冷档案 | 压缩前原文、被替代版本 | 从不注入 | 0 |

记住 10 条和记住 1000 条,注入成本一样。v0.9 起注入块还会冻结成缓存友好的快照(重启可复用),记忆也分成 事实 / 技能 / 待办 三类——另有一小块「待办」实时注入,最多 5 行,预算 taskTokens(默认 100,从 600 里扣)。v0.10 起技能还有专用技能库(memory_skill 检索 / 复用 / 修订),注入块里只多一行固定提示。

防膨胀机制

  • 写入即去重:字符 bigram Jaccard ≥ 0.75 判定同主题,原地更新,旧版本进冷档案
  • 规则压缩:memory_consolidate 合并近似条目(不调 LLM,零额外 token)
  • 衰减归档:60 天未更新、未置顶、低重要度 → 归档(可检索,不删除)
  • 硬预算:整块注入 ≤ budgetTokens(v0.9 起是整块硬守卫,正文固定开销不再把注入撑爆);待办块另受 taskTokens 约束
  • 缓存稳定(v0.8.1 起):注入文本只在语义事件时变化,不因时间流逝或每轮计数而变

v0.2 新功能

自动捕获(默认开)

每次会话的 user / assistant 消息自动追加到 journal/YYYY-MM-DD.jsonl(L3 原始层,永不注入,单条最多 4000 字符)。子代理会话默认跳过。捕获只是落盘,不产生任何上下文成本。

睡梦机制

每天 23:30 定时触发(也可手动 memory_dream):

  1. 回顾最近 N 天的全部对话 journal
  2. 按线索词(记住/我喜欢/统一用/以后都/约定…)提炼候选,相似候选自动去重
  3. 生成 dream/YYYY-MM-DD.md 报告
  4. Agent 逐条判断后 memory_save 值得留下的,再 memory_consolidate

可视化面板

宿主 webServer 上的本地页面:/memory-fish/panel

  • 注入 token 预算条(随 budgetTokens 配置)、活跃/归档/置顶/今日对话/候选线索卡片(v0.9 起还有待办卡与注入重建观测)
  • 画像编辑、记忆搜索、置顶/遗忘
  • 一键「现在做梦」「整理记忆」、查看最近睡梦报告
  • v0.9-B 起独立面板有「待办(open task)」区块,可完成 / 丢弃

同源校验:拒绝跨站请求(Origin/Host/Sec-Fetch-Site),只允许 localhost / 本机 IP。

v0.4 生理学调优(P0/P1/P2)

三阶段睡眠(P0)

memory_dream 现在按睡眠分期跑完整流程:

  1. SWS 慢波:重放 journal,合并相似记忆(原文进 archive)
  2. SHY 稳态:按显著性加权衰减,长期低分记忆降级归档
  3. REM:为共享标签/相似的记忆建立「相关链接」,不改内容

报告写到 dream/YYYY-MM-DD.md,包含三阶段明细 + 待复习清单 + 候选记忆。v0.8 起还有 Phase 4 · Mental model(见下)。

睡梦提醒(C1:不依赖宿主调度器)

插件不创建任何定时任务,也不写宿主的 session 事件日志。它只在注入块里按需提醒:

### 睡梦
- 欠梦(上次整理 2026-10-24)→ 建议先 memory_dream 做三阶段整理

文案是日粒度的(v0.8.1 起不写小时数/新增条数,避免欠梦期间每轮注入都变、把前缀缓存刷掉)。

判断条件:dreamReminder: true(默认)且(距上次做梦 ≥ dreamAfterHours(默认 24)或有到期复习),并且确实有新对话或复习项。没有就完全不出现,零 token 成本。

好处:新会话也有效、卸载后零残留、不依赖 dsh-schedule 的内部协议。

间隔重复(P1)

每条记忆维护 stability(能记多久)、nextReview(下次复习日)、reviews:

  • 新记忆按重要度给初始稳定性(约 8–13 天)
  • memory_search / memory_read 命中即加固(稳定性 ×1.3 / ×1.1),这就是提取练习效应
  • 到期条目由注入块里的一行阈值文案提示(v0.8.1 起不再逐条标 ⏰,睡眠报告里仍列成待复习清单)

显著性 + 新颖性门控(P2)

  • 写入时自动打分(0–10):明说「记住」+4、纠正 +2、绝对化措辞 +1、新颖度 +0~2、置顶 +1
  • 相似度 ≥0.92 → NOOP:完全重复不写,只记一次复习
  • 0.75–0.92 → 原地更新;<0.75 → 新增

v0.5 时间有效性(P3)

每条记忆带有效期:validFrom / validTo,同主题内容变化时:

  • 旧版本封存进 history(含自己的 validFrom → validTo),当前版本换新有效期
  • memory_search 默认只返回当前有效版本
  • memory_search({ asOf: "2026-09-15" }) 按时间点查当时有效的版本 —— 能回答"上个月我们用什么方案"
  • 历史版本不参与复习加固,避免旧事实被强化

v0.8 Mental model:L0 画像自动重写

L0 画像是决定"agent 怎么和你说话"的那 200 tokens。手写会过期,全自动又容易跑偏,所以 v0.8 把工作拆成三段:

  1. 插件判断到期:memory_dream 的 Phase 4 检查 stats.lastProfileRewrite,超过 mentalModelEveryDays(默认 7 天)或从未重写过,就算到期
  2. 插件准备材料:写 dream/YYYY-MM-DD-mental-model.md,内含当前画像、最近 20 条活跃记忆(id / 标题 / 标签 / 正文前 200 字)、最近 3 天睡梦摘要,以及给 subagent 的指令
  3. subagent 重写:主 agent 先 memory_profile_archive 归档旧画像,再用 subagent 读任务文件、写出 ≤200 tokens 的新画像并返回(独立上下文,主上下文几乎零成本),最后校验长度/密钥 → memory_profile_save 落盘,stats.lastProfileRewrite 自动更新

睡梦报告里会多一节:

## 🧠 Mental model(Phase 4 · L0 画像自动重写)
- 画像到期:是 → 任务文件:~/.dsh/memory-fish/dream/2026-10-25-mental-model.md

为什么不是插件自己调 LLM(插件没有 LLM 依赖,也不该引入 token 成本),也不是主会话自己写(要读大量记忆,主上下文太贵)—— 这是 DSH 的能力边界决定的:插件跑在 host 进程里不能 spawn subagent,只有 agent 轮次能调 subagent。

安全边界:

  • 只改 L0,绝不删除或覆盖 L1/L2 记忆
  • 旧画像先归档到 profile-history/,随时可回滚
  • memory_profile_save 内置密钥拦截 + clampToBudget 硬截断,画像永远不会撑爆 200 token 预算

v0.9 缓存友好注入与记忆类型

为什么在意「缓存」

system prompt 是每个请求的最前缀。它每变一个字节,服务商的 KV 前缀缓存就整段失效,长会话要重新 prefill 全部历史——一次 miss 可能比多注入几百 token 还贵。

所以 v0.8.1 先把注入块改成字节稳定:C1 欠梦提醒只到「天」粒度(不写小时数/新增条数)、去掉逐条 ⏰ 标记、到期改一行阈值文案。v0.9 在此基础上再进一步:把 L1 热索引冻结成显式的「注入快照」。

v0.9-A:注入快照 injectionMode

| 模式 | 行为 | 适合 | |---|---|---| | session(默认) | 每个会话构建一次,会话内不变;新会话 / 做梦 / 整理时失效重建 | 长会话,最大化缓存命中 | | daily | 每天第一次注入时重建 | 一天开很多会话,想每天看到新索引 | | live | 每次注入实时重建(= 0.8 的行为) | 测试、调试、短会话 |

  • 快照落盘在 <dir>/injection-cache.json,重启后可复用;即便因新会话事件触发一次重建,渲染出的文本也保持不变,前缀缓存仍然命中
  • 失效原因可见:init / session / day / dream / consolidate;非 live 模式跨本地日也会额外重建一次(reason=day)
  • 观测:memory_stats 的 injectionMode / injectionRebuilds / lastInjectionRebuild{at,reason,day} / injectionCacheDay;面板显示重建次数与最近原因
  • 冻结范围是 L1 热索引行 + 「有记忆到期」阈值;L0 画像和 C1 提醒仍实时(画像改动立即生效;C1 文案是日粒度、不含计数,只在事件/日界/跨过欠梦阈值时变化)
  • 整块硬预算守卫:estTokens(注入块) ≤ budgetTokens,超出从 L1 末尾逐行裁剪。caveat:极端配置(profileTokens 接近 budgetTokens,如 550/600)时固定文案开销仍可能略超,建议 profileTokens ≤ budgetTokens − 150(默认 600/200 实测成立)

v0.9-B:记忆类型与待办

kind 把记忆分三类:

| kind | 是什么 | 进热索引 | 参与间隔复习 | 参与合并/衰减 | 进待办块 | |---|---|---|---|---|---| | fact(默认) | 事实、偏好、决策、排障结论 | 是 | 是 | 是 | 否 | | skill | 从任务闭环里提炼的技能/套路 | 否 | 是(只读时加固) | 否(v0.9-C 起) | 否 | | task | 待办任务 | 否 | 否 | 否 | 是(open) |

新工具 memory_task(工具数 11 → 12):

| action | 作用 | |---|---| | add | 建任务:title / content / dueAt(YYYY-MM-DD 本地日)/ priority(1–5,默认 3)/ note;同主题 open 任务相似度 ≥0.75 会原地合并更新 | | done | 标记完成(只能对 open 操作),记录 doneAt;可附 note,追加到任务备注(旧 \| 新),会成为 Phase 6 技能提炼材料 | | drop | 丢弃(只能对 open 操作) | | list | 按 逾期 → dueAt → priority 排序,附 remaining(剩余 open 摘要) |

所有写操作都返回 remaining,形成「做完看还剩什么」的闭环。

注入块在画像之后、热索引之前新增「### 待办」(实时渲染,不走 L1 快照):

### 待办
- ⏰ 10-20 升级 Node 版本
- · 10-28 写 v0.9 验收报告
- · 清理桌面临时文件
- …另有 2 个(memory_task list)

规则:

  • 只列 open task,最多 5 行;超出显示 - …另有 N 个(memory_task list)
  • 逾期用 ⏰ MM-DD,有截止用 · MM-DD,无截止用 · 标题
  • 块本身受 taskTokens(默认 100)约束,超长标题会被裁;这部分预算从 L1 可用预算里扣
  • 有待办时 footer 多一行 > 完成待办后用 memory_task done 标记,并查看剩余。
  • task 不参与记忆去重(只和 open task 比)、不参与间隔复习、不参与衰减归档、不进热索引

其它配套:

  • memory_list 支持 kind: fact | skill | task 过滤(默认 all)
  • memory_search / memory_read / memory_list 结果带 kind / taskStatus / dueAt / sources
  • memory_stats 增加 tasksOpen / tasksOverdue / taskTokens / kindCounts / skillExtraction / lastSkillExtract
  • 独立面板新增「待办(open task)」区块,可一键完成 / 丢弃
  • frontmatter 增加 kind: / task_status: / due_at: / done_at: / priority: / note:;旧数据自动迁移成 fact

v0.9-C:技能提炼与轻量溯源

skill 类型:memory_save({ kind: 'skill' }) 落库。skill 不进热索引、不进待办块,也不参与 dream 的 SWS 合并 / SHY 衰减和 memory_consolidate 的合并归档——它是提炼产物,去留由显式操作决定。同主题更新时 kind 不降级:skill 不会被 fact 覆盖,fact → skill 可以升级。

sources 轻量溯源:memory_save 新增可选 sources(task / memory id 数组,自动去重,最多保留 5 个);更新已有条目时与旧值取并集、保留最近 5 个。落进 frontmatter sources:,memory_read / memory_search / memory_list 都会返回。它只是"这条记忆从哪来"的指针,不做图遍历。sources 里的疑似密钥值会被过滤;完全重复(NOOP)不写正文,但新 sources 仍会合并进旧条目(溯源不丢)。

dream Phase 6 · Skill 提炼:memory_dream 检查「自上次提炼(stats.lastSkillExtract)之后新完成的 task」(只看 status=active 的 done task):

  • 有 → 生成 dream/YYYY-MM-DD-skill-task.md,材料包括:
    • 最近完成的任务 ≤10 条(id / 标题 / 内容 / 备注 / 完成时间;备注 = add 的 note + done 追加的完成备注)
    • 相关活跃 fact 记忆 ≤15 条(任务标签共现优先,其次最近更新)
    • 最近 3 天睡梦摘要
    • 给 subagent 的提炼指令(提炼 1–3 条,TITLE: / SKILL: / TAGS: / SOURCES: 格式,≤200 tokens/条)
  • 报告增加 ## 🧠 Phase 6 · Skill 提炼:技能提炼:是 → 任务文件:… 或 技能提炼:否(无新完成的待办任务…)
  • 主 agent 用 subagent 按任务文件提炼,再逐条 memory_save(kind='skill', sources=[task id]) 落盘
  • 只有实际生成任务文件才更新 stats.lastSkillExtract,避免每晚重复生成;skillExtraction: false 关闭后报告整节不出现
  • dream 的其它材料(SWS 合并、SHY 衰减、Phase 4 画像)同样只看 fact,task / skill 不参与

设计细节见 DESIGN.md 的「v0.9 缓存契约与记忆类型」;尾部注入(append sourced user/message)可行性调研见 docs/DSH-APPEND-INJECTION.md(结论:v0.9 不搬,v0.10 可选)。

v0.10 技能库:检索、复用与修订

v0.9 把 skill 变成独立类型,但技能只能靠 memory_search 大海捞针,模型不会主动"想起"复用;也没有显式修订入口。v0.10 补上技能库闭环——专用工具 + 注入块一行固定提示 + 可追溯的修订,同时不破坏缓存契约。

第 13 个工具:memory_skill

| action | 作用 | |---|---| | list | 列出全部 active skill(按 updated 倒序,默认 20 条 / 最大 50):id / title / tags / updated / importance / hits | | search | 关键词命中标题(+3) / 标签(+2) / 正文(+1),大小写不敏感;返回 id / title / tags / updated / score / excerpt(≤200) / content(≤800,超长 truncated);命中即视为一次"复用"(记 hits,开启复习时 reinforce ×1.1) | | add | 新技能:复用 memory_save 的去重 / 新颖性 / NOOP / 版本 / 密钥检查逻辑(kind='skill' 固定),sources 指回来源 task | | update | 按 id 修订:content 替换(默认)或 append 追加到旧正文末尾(同时给时按 content 替换);title / tags 替换(≤3)、sources 并集(≤5);旧版本进 history(≤10)并把旧文件归档到 archive/,validFrom / updated 刷新 |

错误语义:非 skill id → invalid_kind;不存在 / 已归档 → not_found;空 query、content 与 append 都缺、非法 action → invalid_input;标题 / 正文命中密钥 → secret_refused(update 时 tags / sources 中疑似密钥值被过滤)。所有 action 都走写锁串行(search 会更新 hits / 复习状态)。

注入块里的固定复用提示(缓存安全)

只要存在 ≥1 条 active skill,注入块就多固定一行(无计数、无日期、无相对时间):

> 需要相关经验/历史做法时先用 memory_skill search 检索技能库;技能可用 memory_skill update 补充修订。
  • 这是缓存安全的"指针":search / update 都不重建注入快照;update 修改技能内容不会改变注入块字节(技能不在注入块内)
  • 提示行只随「active skill 从无到有 / 从有到无」出现或消失(语义事件,和待办块出现 / 消失同类)
  • 该行 token 计入预留预算(与提醒 / 待办一致),整块仍 ≤ budgetTokens

dream Phase 6 落盘方式更新

Phase 6 任务文件的指令从 memory_save(kind='skill') 改为 memory_skill add(仍兼容 memory_save(kind='skill', sources));报告的"下一步"同步更新。

设计细节见 DESIGN.md 的「v0.10 技能库与复用」。

工具(13 个)

插件注册 13 个模型工具(写操作串行加锁):

| 工具 | 作用 | |---|---| | memory_save | 保存/原地更新(自动去重、拒存密钥);kind 可选 fact(默认)/ skill;sources 溯源 id(≤5,更新取并集) | | memory_search | 本地关键词检索(含归档,可选);结果带 kind / taskStatus / dueAt / sources | | memory_read | 读全文(>4000 字符截断);带 kind / sources;task 不触发复习加固 | | memory_list | 最近记忆;kind 可按 fact / skill / task 过滤;带 sources | | memory_task | 待办:add / done / drop / list;done 可附完成备注(进入 Phase 6 材料) | | memory_skill | 技能库:list / search / add / update;search 返回可复用正文与 score,update 支持替换 / 追加并保留历史(v0.10) | | memory_pin | 置顶/取消(置顶不参与衰减) | | memory_forget | 软删除 + 墓碑 | | memory_profile_save | 写 L0 画像(超长硬截断、拒密钥,记录重写时间) | | memory_profile_archive | 归档当前画像到 profile-history/(重写前调用,可回滚) | | memory_dream | 睡梦:三阶段 + Phase 4 画像重写 + Phase 6 技能提炼任务 | | memory_stats | 注入 token / 条数 / 磁盘占用 / 注入重建 / 待办与类型构成 / skill 提炼观测 | | memory_consolidate | 手动整理(dry-run 可选;task / skill 不参与) |

数据位置

~/.dsh/memory-fish/
├── profile.md           # L0(≤200 tok,常驻注入)
├── profile-history/     # v0.8:每次重写前的旧画像快照,可回滚
├── index.json           # 元数据索引(可重建)
├── memories/            # L2:每条一个 Markdown(含 kind/task/skill frontmatter)
├── archive/             # L3:旧版本、被替代、被遗忘的原文(含 skill 修订前的旧版本)
├── journal/             # 自动捕获的原始对话(按天 jsonl,永不注入)
├── dream/               # 睡梦报告(按天 md)+ 画像重写任务(*-mental-model.md)+ 技能提炼任务(*-skill-task.md)
├── injection-cache.json # v0.9:L1 注入快照(重启复用;删掉只会重建一次)
└── stats.json           # 计数(含 lastProfileRewrite / injectionRebuilds / lastSkillExtract)

全部人类可读、可 git、可手改。索引丢失会从 memories/*.md 自动重建。

安装

从 npm(v0.10.0 已发布,latest):

dsh plugin --profile web add dsh-memory-fish

或注册本地开发目录:

  1. 把本目录复制到 <profile>/node_modules/dsh-memory-fish/
  2. 在 <profile>/package.json 的 dsh.profile.bundles 加入 "dsh-memory-fish", 并在 dependencies 加入 "dsh-memory-fish": "file:projects/memory-fish"
  3. 重启 DSH(或等待 profile 热加载)

配置

配置写在 profile 的 cordis.patch.yml:

- id: memory-fish
  config:
    budgetTokens: 600
    maxHotLines: 12
    injectionMode: session   # v0.9:session | daily | live
    taskTokens: 100          # v0.9:待办块预算(从 600 里扣)
    skillExtraction: true    # v0.9-C:dream Phase 6 技能提炼
    autoCapture: true

常用项:dir、budgetTokens、profileTokens、maxHotLines、injectionMode、taskTokens、skillExtraction、archiveAfterDays、dedupeThreshold、noopThreshold、reviewEnabled、autoCapture、captureMaxChars、journalKeepDays、dreamDays、dreamReminder、dreamAfterHours、mentalModel、mentalModelEveryDays、panelPath、apiBase、debug。非法 injectionMode 会回落 session。

代码结构

index.mjs        插件入口:配置、注入、自动捕获、会话纪元、装配
lib/config.mjs   默认值 + 配置校验(injectionMode 白名单)
lib/util.mjs     token 估算、bigram/Jaccard、显著性、间隔重复、脱敏
lib/store.mjs    Markdown/JSON 存储、journal、归档、迁移、注入快照、任务文件
lib/inject.mjs   画像 + 待办 + 技能提示 + 热索引注入块(快照 + 硬预算)
lib/core.mjs     saveMemoryCore(kind/sources)/ taskCore / skillCore:去重 / 门控 / 版本 / 待办 / 技能库
lib/dream.mjs    三阶段睡眠 + Phase 4 画像重写 + Phase 6 技能提炼
lib/tools.mjs    模型工具(写操作加锁串行)
lib/panel.mjs    本地 HTTP 面板 + API
lib/lock.mjs     跨进程写锁
lib/log.mjs      可选调试日志
client/client.js 设置页面板(浏览器半)

测试

npm test   # 205 项断言:捕获、脱敏、保存/去重/NOOP、检索、asOf 历史、
           # 睡眠三阶段 + Phase 4 画像重写 + Phase 6 技能提炼(到期判定/任务文件/
           # 材料上限/lastSkillExtract/关闭)、skill 类型与 kind 不降级、sources 溯源
           # 往返/并集/NOOP 合并/密钥过滤、note 密钥拦截、注入快照三模式
           # (session/daily/live、跨日重建、重启复用、重建原因与计数)、
           # 硬预算压力、kind/待办生命周期与注入、预算整合、注入块字节稳定(缓存友好)、
           # v0.10 技能库(list/search 评分与复用计数、excerpt/content 上限、
           # add 去重复用、update 替换/追加/history/archive/错误码、同秒连续归档不覆盖、
           # 复用提示的出现与字节稳定、含提示时的预算)、
           # 面板路由/预算随配置/待办按钮、锁释放

CI 在 Linux / Windows × Node 22 / 24 上跑。

安全

本地优先、无网络。journal 落盘前会脱敏密钥;memory_task 的备注(add / done 的 note)命中密钥检测会直接拒绝(secret_refused),memory_save 的 sources 中疑似密钥值会被过滤;memory_skill 的 title / content 同样过密钥检测(命中拒绝),sources(以及 update 的 tags)中疑似密钥值会被过滤。HTTP 面板仅限 localhost 且有同源校验,但没有鉴权——请只在可信机器上运行。详见 SECURITY.md。

设计

见 DESIGN.md。

License

MIT