Skip to content
Back to search

dsh-familiar-memory

给 DeepSeek Harness 的本地记忆层:养大肥鱼的可以下载来玩,经过测试下载之后比单纯用RAG和外部记忆库更有人情味更自然了。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/elio896--dsh-familiar-memory/badge.svg)](/listings/elio896--dsh-familiar-memory)

HTML

<a href="/listings/elio896--dsh-familiar-memory"><img src="/api/listings/elio896--dsh-familiar-memory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 165 lines
  1. # dsh-neuron-memory
  2. **本地记忆抽屉**:字面命中 + 情绪桶 + 同日上下文 + 指数衰减。
  3. 给 DeepSeek Harness(cordis 插件)用。数据是一个本地 SQLite 文件,不联网、不上传、你能打开、能改、能删。
  4. 图记忆(激活扩散)已否决——实测 1 跳噪音 33% → 64%,增量 0%。见 [FINDINGS.md](FINDINGS.md)。
  5. ## Status:v0.2.0
  6. 这一版的定位是「修好 bug、说真话、装得上」,外加一件原计划留到 0.3.0 的事:**换会话之后,她还是同一个人。**
  7. - **修了三个 bug**:`grams()` 用 `\W` 会吞掉所有中文(「共享词建边」从上线起就没工作过);`/mode` 空 body 会静默切模式;HTTP 写操作原本是 GET(任意网页能触发)
  8. - **承认两件事**:排序以前其实是按重要度、不是按相关度(现在 `rel` 进了 score);文档里三条功能之前并不存在
  9. - **新增**:开场认人 `neuron_opening`、收尾交接 `neuron_handoff`、工作状态 `decided_at` / `supersedes`、自动录入
  10. - **图仍然是关的**:`hops=0`,扩散实测纯亏损
  11. ### breaking changes
  12. 1. **权重从线性衰减改成指数衰减**(`base × 0.5^(天/半衰期)`)——所有分数尺度变了,`sinkBelow` 从 1.0 调到 0.5。
  13. 2. **默认行为变了**:排序 = 相关度 × 权重(`warmBoost` 再加一点温度);零命中**默认返回空**(`noFallback: true`),不再拿 `top()` 充数。
  14. 3. **HTTP 写操作从 GET 改成 POST**(`/tidy` `/prune` `/replay` `/handoff`)——旧面板会收到 405,需同步升级 `client.js`。
  15. 4. **工具默认只暴露 7 个**:`sync / raw / consume / replay / prune` 收进 `config.advanced: true` 后面。
  16. ### 迁移
  17. 首次启动会把旧库自动复制成 `neuron.db.bak-v<旧版本>`,然后按 `user_version` 逐级迁移(**当前 schema v4**)。迁移幂等,连开两次不会重复改。
  18. ## 它现在真的在做什么
  19. 坦白说:**bm25 种子(IDF 加权)+ 情绪桶 + 同日窗口 + 指数衰减**。没有向量,也没有图。
  20. - **种子**:FTS5 倒排(unicode61 + 预切 2-gram)捞候选;`rel = Σidf(命中)/Σidf(全部)`,整词命中直接视为 1;`rel ≥ minRel(0.30)` 才算数
  21. - **排序**:`score = rel × 权重/3 × 温度系数`;权重 = `基础分 × 0.5^(天/半衰期)`,恒正、永不归零
  22. - **温度桶**:感受 / 原话 / 偏好 / 回味 3.0,教训 2.5,事件 1.6,档案 1.3;聊天时感受先亮
  23. - **同日上下文**:想起一件事,顺手带出那天前后各一条(只给最前两条)
  24. - **复习只回血一半**:被想起来时把「已流逝天数」折半,不是重置到现在(防口头禅记忆)
  25. - **沉底不删**:低于 0.5 沉进归档区,不参与普通召回;你精确问起(命中 ≥2 词)仍会被翻出来
  26. - **场景隔离**:`scope` 默认 `private`;`work` 不衰减、不沉底;群聊召回不到私聊
  27. ## 换会话,她还是同一个人
  28. 两个工具,把「会话」这个概念挡在插件外面——插件只负责存和交:
  29. ```
  30. 会话开始 → neuron_opening() 返回一段 ≤250 字,直接塞进 system prompt
  31. 会话结束 → neuron_handoff({topic, phase, nextAsk, mood, name}) 只写三行 + 一个情绪数
  32. ```
  33. `neuron_opening()` 的输出长这样:
  34. ```
  35. 你正在和周舟说话。
  36. 今天还见过面(有点闷)。
  37. 你们正聊到:换工作,卡在钱不够。
  38. 你上次想问她:面试结果出来没。
  39. 你记得:她说周三要交材料;她讨厌豆包腔。
  40. 开场先认出她——用对的称呼、接上上次的话题。不要重新自我介绍,不确定的事就问,不要编。
  41. ```
  42. 工作会话传 `includeWork: true`,会追加一段「项目状态(按拍板时间)」;**两个块互斥,不叠加**。
  43. ## 工作状态:要「最新」,不要「最像」
  44. 向量检索分不清「哪个方案是现在的」。所以工作记忆用两列解决:
  45. ```js
  46. neuron_learn("走方案 B,A 的迁移成本太高", "fact", "work", { supersedes: 12 })
  47. // → 12 号那条自动 status='sunk',不再被当成「现在的」
  48. ```
  49. - `decided_at`:什么时候拍板的(`scope=work` 时默认写入时间)
  50. - `supersedes`:覆盖了哪条旧决定;**跨 scope 或 id 不存在时只警告,不静默沉**
  51. ## 装
  52. 要求:Node ≥ 22.15(`node:sqlite` + zstd)、DSH ≥ 0.1.7
  53. ```bash
  54. node install.mjs # 复制进 profile、登记 bundle、跑自检
  55. dsh plugin add link:<本目录> # 或者走官方命令
  56. node test-all.mjs # 四层测试
  57. ```
  58. 装完重启一次 DSH,工具和设置页就出现了。首次运行自动建空库;想接已有记忆库,在 profile 的 `cordis.patch.yml` 里配:
  59. ```yaml
  60. - id: dsh-neuron-memory
  61. name: dsh-neuron-memory
  62. config:
  63. db: /path/to/neuron.db
  64. source_db: /path/to/memory.db # 可选:原文库(一张 memories(id,text) 表即可)
  65. halfLifeDays: 10
  66. sinkBelow: 0.5
  67. sinkLimit: 3
  68. hops: 0 # 默认 0 = 图未启用
  69. minRel: 0.30
  70. noFallback: true
  71. advanced: false # true 才放出 sync/raw/consume/replay/prune
  72. autoSync: true # 自动录入会话(见下,含代价说明)
  73. ```
  74. ## 工具(默认 7 个)
  75. | 工具 | 作用 |
  76. |---|---|
  77. | `neuron_opening(scope?, includeWork?)` | 会话开场:认人 + 上次聊到哪 + 下次问什么(≤250 字) |
  78. | `neuron_handoff(topic, phase, nextAsk, mood, name?)` | 会话交接:只写三行 + 情绪数 |
  79. | `neuron_recall(query, limit?, mode?, scope?)` | 相关性召回;`mode=lite` 只回文本,省约一半字符 |
  80. | `neuron_learn(text, kind?, scope?, supersedes?)` | 学一条;`supersedes` 会沉掉被覆盖的旧决定 |
  81. | `neuron_stats()` | 节点 / 连接 / 待沉 / 已沉 / 最老沉底日期 |
  82. | `neuron_story(day?)` | 按天串叙事线 |
  83. | `neuron_tidy()` | 沉掉最淡的几条(沉 ≠ 删) |
  84. `advanced: true` 时额外放出:`neuron_sync`(扫会话抓原文)、`neuron_raw`(读待提炼)、`neuron_consume`(标记已提炼)、`neuron_replay`、`neuron_prune`。
  85. ## 自动录入(0.2.0 新增)
  86. 插件每 10 分钟扫一次 DSH 的会话记录(`~/.dsh/sessions/` 下最近 2 天的文件,多帧 zstd),把**用户消息**抓进本地 `raw_log` 表。
  87. **只抓,不判断、不写记忆。** 哪句值得记仍由模型决定——插件不知道「好的」和「我明天要去面试」的区别。
  88. - `raw_log` 带 `scope` 列,群聊/私聊的原文不混池
  89. - 用 sha1(文本+时间) 去重,同一条不会重复入库
  90. - 提炼完后用 `neuron_consume` 标记,不重复处理
  91. - 关掉:`config.autoSync: false`;周期可调:`config.autoSyncMinutes`(默认 10)
  92. ⚠️ 数据全在本机 `neuron.db` 里,不上传。但**它会读你本地所有会话文件**——这是这个功能的代价,关掉就是纯手动。
  93. ## 评测:三条腿 + 诱捕题
  94. 18 题(作者自拟、样本小,只能看方向),预算 = neuron 腿实际用掉的字符数:
  95. | 腿 | 命中 | 条目 | 噪音率 | 字符 | 每千字符命中 |
  96. |---|---|---|---|---|---|
  97. | neuron(种子 + 同日上下文,0 跳) | 100% | 70 | 33% | 6137 | 2.93 |
  98. | bm25(同样 2-gram + IDF) | 94% | 66 | 26% | 5478 | 3.10 |
  99. | weight(完全不检索) | 22% | 90 | 96% | 4389 | 0.91 |
  100. 归因:neuron 比 bm25 多的那 6 个点里,**0 个来自扩散**——唯一差距是空查询走了 `top()` 兜底,而 bm25 那条腿没实现兜底。所以「图更准」不成立。
  101. **诱捕测试**(`eval/traps.json`,20 题 5 类):问「没发生过的事」,看它会不会顺着编。脚本只能查「库里有没有支撑」这一半;模型会不会编,要人判——所以这里不报通过率。
  102. ## 文档
  103. - [FEATURES.md](FEATURES.md):功能详单(写的是代码里实际在跑的;未实现的会明确标注)
  104. - [ARCHITECTURE.md](ARCHITECTURE.md):数据模型、读写路径、设计权衡、已知坑
  105. - [FINDINGS.md](FINDINGS.md):三条腿评测、跳数实验、归因方法、为什么砍图
  106. - `eval/`:实验脚本(仓库里是脱敏 fixtures,真实题放本地 `fixtures.local.json`)
  107. ## Roadmap
  108. - [x] 种子换成 IDF 加权(2-gram 预切 + FTS5 unicode61)——0.2.0 已做
  109. - [x] 1 跳实验:命中不变、噪音 33% → 64%,增量 0 —— 图退出主路径
  110. - [ ] 「+0.5 合并」(惊讶门控写入):先在 `write_log` 里记一周 jaccard 分布,再定阈值
  111. - [ ] `digest`:每天的碎记忆压成 3~5 行摘要,原条目折进去(复用 `sunk`)
  112. - [ ] 冷启动误命中(2-gram 拆太碎)单独处理
  113. - [ ] `stats` 加窗口:最近 7 天被点亮次数
  114. ## 许可
  115. MIT。详见 [LICENSE](LICENSE)。
  116. 本项目为第三方插件,与深度求索(DeepSeek)官方无关,未获其背书。
  117. 请不要用它储存别人的隐私;群聊场景必须开启 `scope` 隔离。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.