Skip to content
Back to search

dsh-chain

神经元记忆网络 让 DSH 记住「为什么这么决定」,而不只是结论。思维链记忆插件:8 个池分级遗忘、每轮注入、神经元 3D 星云浏览、夜巡自动整理。

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/canglight--dsh-chain/badge.svg)](/listings/canglight--dsh-chain)

HTML

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

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 方式一:放进 DSH 的插件目录
cd ~/.dsh/plugins
git clone <repo> dsh-chain-shared

# ⚠️ 必须在插件目录里装一次依赖 —— 见下面「为什么这一步不能省」
cd dsh-chain-shared
npm install --registry=https://registry.npmmirror.com

# 再挂进 profile
cd ~/.dsh/profiles/web
pnpm add link:~/.dsh/plugins/dsh-chain-shared     # 或用 dsh plugin add

然后**重启一次 DSH**(插件清单变更不热加载)。

默认不按会话过滤。如需限定会话,可在启动 DSH 前设置环境变量 `DSH_CHAIN_TARGET_SESSION_IDS`(逗号分隔会话 id);缺省空字符串表示全会话共享。画布标签从服务端读取该配置。

首次装上时记忆是**空的** —— 需要你在对话里让它记东西,或者用 `chain_append` 工具写第一条。

依赖

- Node ≥ 20 - 运行中的 DSH(任意 profile) - `@node-rs/jieba`(预编译二进制,不需要 C++ 编译器) - `@deepseek-ai/schemastery`(**可选**:装了才有设置页,没装插件照常跑) - `@huggingface/transformers`(**可选,约 400 MB**:装了才有语义检索;没装所有语义路径自动退回关键词路,不报错)

为什么那一步 npm install 不能省

`pnpm add link:` 只是把 profile 指向这个目录,**不会替你装插件自己的依赖**。 漏装的表现很安静,两条都对不上人会以为是版本问题:

| 没装的包 | 症状 | |---|---| | `@node-rs/jieba` | 检索层静默降级(不报错、只是召回变差)| | `@deepseek-ai/schemastery` | 「思维链」画布右上角的**设置按钮点了没反应** |

刻意做成可选依赖,是为了"装漏了也还能用";但**装一遍最省事**。

---

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 · 377 lines
  1. # dsh-chain-shared · 思维链记忆(全会话通用版)
  2. 当前版本:**3.0.0**。
  3. ![封面](docs/cover.png)
  4. > 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 用的记忆插件。
  5. >
  6. > **它记的不是"发生了什么",而是"当时为什么这么定"。**
  7. > 每条记忆是一句判断 + 依据 + 犹豫 + 结论;它按时间衰减,只有被重新想起才会留住。
  8. 这个包是**全会话通用版**:你在哪个会话里说话,看到的都是同一套记忆。
  9. ("每条会话各一套、互不串味"的隔离版不在这个包里。)
  10. ## 它长什么样
  11. ![星云](docs/nebula.png)
  12. 八个池各成一簇(另有「元记忆」汇总簇),点与点之间是「依据」和「相关」的连线。整团在缓慢自转(可关),
  13. 每颗记忆球绕自己的池心走固定轨道 —— 不会互相追、也不会飞出去。
  14. | 标签模式 | 聚焦一条 | 设置面板 |
  15. |---|---|---|
  16. | ![标签](docs/labels.png) | ![聚焦](docs/focus.png) | ![设置](docs/settings.png) |
  17. > 截图来自开发机(约 240 条记忆 / 8 池)。观感会随记忆条数增长而变化。
  18. ---
  19. ## 它解决的四个问题
  20. | 问题 | 这个插件的做法 |
  21. |---|---|
  22. | 上下文一压缩,为什么这么定的理由就丢了 | 判断存成 JSONL,**每轮从磁盘重新渲染进系统提示**,跟对话历史无关,压不掉 |
  23. | 记了一堆,真正用的时候一条也想不起来 | 用**你的这句话**去检索记忆(jieba 分词 + 通用 IDF),命中几条就把那几条的判断行贴回提示词 |
  24. | 越攒越多,最后全是噪声 | 按池分半衰期自动淡出;从没被想起过的条目会先淡、再走归档 |
  25. | 记了一堆,却不知道自己记得什么、哪条还可信 | **元记忆**:`chain_about` 回答「关于 X 我知道什么 / 多可信 / 变过几次」—— 被想起几次、有没有人确认过、是否被取代、依据还在不在 |
  26. ---
  27. ## 安装
  28. ```bash
  29. # 方式一:放进 DSH 的插件目录
  30. cd ~/.dsh/plugins
  31. git clone <repo> dsh-chain-shared
  32. # ⚠️ 必须在插件目录里装一次依赖 —— 见下面「为什么这一步不能省」
  33. cd dsh-chain-shared
  34. npm install --registry=https://registry.npmmirror.com
  35. # 再挂进 profile
  36. cd ~/.dsh/profiles/web
  37. pnpm add link:~/.dsh/plugins/dsh-chain-shared # 或用 dsh plugin add
  38. ```
  39. 然后**重启一次 DSH**(插件清单变更不热加载)。
  40. 默认不按会话过滤。如需限定会话,可在启动 DSH 前设置环境变量 `DSH_CHAIN_TARGET_SESSION_IDS`(逗号分隔会话 id);缺省空字符串表示全会话共享。画布标签从服务端读取该配置。
  41. 首次装上时记忆是**空的** —— 需要你在对话里让它记东西,或者用 `chain_append` 工具写第一条。
  42. ### 依赖
  43. - Node ≥ 20
  44. - 运行中的 DSH(任意 profile)
  45. - `@node-rs/jieba`(预编译二进制,不需要 C++ 编译器)
  46. - `@deepseek-ai/schemastery`(**可选**:装了才有设置页,没装插件照常跑)
  47. - `@huggingface/transformers`(**可选,约 400 MB**:装了才有语义检索;没装所有语义路径自动退回关键词路,不报错)
  48. ### 为什么那一步 npm install 不能省
  49. `pnpm add link:` 只是把 profile 指向这个目录,**不会替你装插件自己的依赖**。
  50. 漏装的表现很安静,两条都对不上人会以为是版本问题:
  51. | 没装的包 | 症状 |
  52. |---|---|
  53. | `@node-rs/jieba` | 检索层静默降级(不报错、只是召回变差)|
  54. | `@deepseek-ai/schemastery` | 「思维链」画布右上角的**设置按钮点了没反应** |
  55. 刻意做成可选依赖,是为了"装漏了也还能用";但**装一遍最省事**。
  56. ---
  57. ## 它提供什么
  58. 2.2.0 新增矛盾候选工具、eventId 分组、受限自动退役,以及夜巡的矛盾 / 同事件审查;2.1 的小更新已合入,详见 [CHANGELOG.md](./CHANGELOG.md)。
  59. > **2.0 起多了什么**:注入里会出现「这次联想到的」(在链上走 1–2 跳)与可选的「语义补位」;
  60. > 多了 `chain_about` 这个元记忆出口;画布上多了感知 / 元记忆两块面板和一行「夜巡 16:51 · N 条」状态。
  61. > 感知层目前**只记录、不改变行为** —— 这点写在 CHANGELOG 的「已知限制」里。
  62. ### 8 个工具
  63. | 工具 | 干什么 |
  64. |---|---|
  65. | `chain_append` | 写一条判断(judgement / evidence / hesitation / conclusion / tags / weight,可选 eventId) |
  66. | `chain_recall` | 按关键词 / 日期 / 权重查;最多补带 2 条 sameEvent 同组记录 |
  67. | `chain_graph` | 导出图谱(Mermaid) |
  68. | `chain_touch` | 给一条已有记录标「确认」或「被推翻」(确认 +0.05,推翻降到存档线) |
  69. | `chain_mood` | 写**当前情绪**(单一状态牌,会自己过期) |
  70. | `chain_patrol` | 手动跑一次夜巡,出报告 |
  71. | `chain_about` | **问「关于 X 我知道什么」**:返回被想起次数 / 人工确认次数 / 生命周期状态 / 是否被取代 / 依据条数。只读 —— 调它不算"想起" |
  72. | `chain_conflict` | 指定 ids: [a, b] 直接比较,或查同池候选;泛词过滤与 strong 排序,只报告线索 |
  73. 同一次决策可用可选 `eventId` 串起前后判断;`chain_recall` / `chain_about` 最多补带 2 条同组记录并标记 `sameEvent: true`。带 eventId 的新判断在前段出现推翻词时,可自动退役同组未退役旧条,核心池受保护,单次最多 2 条,相同载荷重试复用新条;历史正文不变。
  74. 生命周期事件共 5 种:`touch`(人工确认)、`recall`(自动命中)、`supersede`(退役)、`rebalance`(调权重)、`retag`(定池);eventId 是记录字段,不是新增事件类型。
  75. ### 1 个注入段
  76. 每轮往系统提示里注入一段 `## 我的思维链`:
  77. ```
  78. ## 我的思维链(只对我可见)
  79. 我现在:踏实(20 分钟前·强度 0.80)
  80. 因为:……
  81. 核心(32 条 · 不随时间淡):
  82. - ……
  83. 事实(16 条):
  84. - ……
  85. 技能(50 条):
  86. - ……
  87. 你这句话让我想起来(检索词(分数)):
  88. - ……
  89. ```
  90. ### 1 个可视化 tab
  91. 会话视图里的「思维链」tab:3D 星云图,八个记忆池各成一簇(另有决策 / 元记忆虚拟区),可拖拽旋转 / 滚轮缩放 / 点节点看详情;新记忆会在 9 秒内自己长出来。
  92. ---
  93. ## 注入预算:按字数装箱
  94. 注入不是"取最近 N 条",而是**拿字符预算往里装**:
  95. - 四个常驻候选池(事实 / 铁律 / 核心日常 / 片面日常;经验按需)的候选合成一个池,**按权重全局排序**逐条装;
  96. - 装不下就跳过这条、继续试下一条(不是整段停);
  97. - 装不下的条数写在段标题里:`另有 N 条未展开(chain_recall 可查)` —— **不静默丢**;
  98. - 核心段永不参与装箱(它本来就该全量在)。
  99. 这样**注入量恒定**:库里 100 条还是 1000 条,占用的 prompt 都一样。
  100. 实测:1000 条记忆时封顶 24000 字符;137 条时约 9100 字符。
  101. 预算是 `injectMaxChars`(默认 24000 字符 ≈ 8k token),在画布右上角的设置面板里可改。
  102. ---
  103. ## 记忆怎么分层(这是它的核心设计)
  104. | 池 | 半衰期 | 归档 | 说明 |
  105. |---|---|---|---|
  106. | **核心**(原则 / 人格) | **永不衰减** | 永不 | 你自己定的规矩,不该随时间变淡 |
  107. | 事实(关于用户的) | 365 天 | 3 年 | 15 天宽限 |
  108. | **铁律**(必须 / 不许 / 红线) | 730 天 | 10 年 | 120 天宽限 —— 「规矩」和「经验」不是同一种东西 |
  109. | 经验(教训 / 工具 / 排障) | 60 天 | 1 年 | 15 天宽限;按需注入,不常驻 |
  110. | 核心日常 | 60 天 | 180 天 | 20 天宽限;多次被提起的日常会升级到这里 |
  111. | 片面日常 | 20 天 | 45 天 | 5 天宽限;一次性的东西,留着也没用 |
  112. | 情绪 | 1 天 | 3 天 | 3 小时宽限;一块**可覆盖的状态牌**,不是日志 |
  113. | 海马体 | 1 天 | 14 天 | 原始片段缓冲区,**永不注入**,等夜巡整理 |
  114. **权重衰减不是只看时间**:被检索命中的次数会拉长半衰期(`1 + 0.6·log2(1+次数)`,封顶 4 倍)。
  115. 所以"被想起的东西活得更久,没人提的慢慢淡出去"是这套系统真正的遗忘机制。
  116. ### 核心层有上限(不是锁死)
  117. **核心池最多 32 条**(`CORE_MAX`)。刚装时是 0 条 —— 它会随着你立规矩慢慢长,
  118. **满了之后 `chain_append` 再想写「原则/人格」就会被拒绝**,并提示改去写 `AGENTS.md`。
  119. 为什么要有这条上限:核心是不可衰减的那一层,代表「我是谁」。
  120. 它一旦能被随手追加,就会越写越厚,最后变成一份谁都不读的清单。
  121. ### 标签没命中任何池怎么办
  122. **不猜。** 池子决定的是"这条活多久",猜错的代价不对称 —— 猜成 7 天的片面日常,那条就真没了。
  123. ```
  124. 标签没命中任何池
  125. → 落「海马体」(原料缓冲区:14 天归档、永不注入)+ 打「未归类」标注
  126. → 夜巡第 ⑥ 节单独列出来审
  127. → 同一句重复写满 3 次 → 升级「需人工定池」
  128. ```
  129. 反复出现说明它确实值得留,只是标签体系还认不出它 —— 那就该由人给它一个池,而不是让系统猜。
  130. ### 海马体怎么清空
  131. **不用逐条点。** 把同类片段**合并成一条判断**写进去(`chain_append`)——
  132. 被它覆盖的原料会**自动退役**(判据:双向包含,或二元组相似 ≥0.55)。
  133. 所以「重复提交」不会让海马体膨胀:写完判断,原料自己让位。
  134. 剩下的纯噪声(「重启了」这类)按海马体寿命衰减,默认 14 天归档。
  135. ---
  136. ## 检索:两路融合
  137. `chain_recall` 和每轮的"这句话让我想起来"都走同一套检索:
  138. 1. **IDF 罕见词命中**(jieba 分词 + 通用 IDF,阈值 9)—— 专有名词很准,换个说法就零命中;
  139. 2. **字符二元组重合** —— 补"说法变了但字面沾边"的那部分;
  140. 3. 两路各自排名,按 **RRF**(`1/(60+名次)`)融合,**只看名次、不看分数**——避免某一路的尺度把结果带偏。
  141. 两条硬规矩:**没有词面证据的条目不进候选**(否则新鲜度会把无关项顶上来);
  142. **新鲜度与权重只做平局裁决**,不参与主导排序。
  143. 实测(`tools/eval-queries.json`,14 条查询含 6 条换说法):
  144. | 路径 | Recall@3 | Recall@5 | MRR |
  145. |---|---|---|---|
  146. | 只用 IDF | 21% | 29% | 0.15 |
  147. | 整句子串(旧 chain_recall) | 0% | 0% | 0.00 |
  148. | **两路融合** | **50%** | **64%** | **0.48** |
  149. 自己验:`node tools/eval-retrieval.mjs`。
  150. ---
  151. ## 夜巡(每天 18:00 后自动跑一次)
  152. - 起一个检查:每 10 分钟看一次「**现在 ≥ 18:00** 且**今天的报告还不存在**」
  153. - 满足就跑:生成审查报告,自动夜巡不写归整或退役事件;手动 `chain_patrol({ apply: true })` 可显式执行权重归整
  154. - 报告落在 `~/.dsh/memories/.chain-shared/patrol/YYYY-MM-DD.md`
  155. 报告正文含 10 个检查小节(不计概览):久未命中 / 疑似重复 / 共享关键词但没连线 / 矛盾候选 / 同事件对账 / 半写断裂 / 历史 eventId 粗回填建议 / 海马体待整理 / 自动归整 / 未归类待审。有关系边时另附第 11 节「联想网络」。
  156. 矛盾与同事件检查只报告,不自动回填或退役;同事件自动退役发生在满足条件的 `chain_append` 新写入时。
  157. > 开机时如果已过 18:00,60 秒后会补跑一次,一天只跑一次(用报告文件做幂等锁)。
  158. ### 自动唤醒(默认开:唤醒「最近说话的那个会话」)
  159. 夜巡只写报告的话,那一环会断在「报告躺在磁盘里没人读」。所以包里有 `lib/wake.mjs`:
  160. 它会走 DSH 自己的 HTTP 接口,投递一条「请审核报告」的消息。
  161. **默认唤醒谁**:**最近说话的那个会话**。
  162. 理由就是这个包的前提——「整个 DSH 共用同一条记忆链」,报告属于所有会话,
  163. 所以最近还在说话的人,最该看到它。
  164. 想固定唤醒某一条(或关掉),在数据目录写 `settings.json`:
  165. ```jsonc
  166. // ~/.dsh/memories/.chain-shared/settings.json
  167. {
  168. "wakeSessionId": "session-xxxxxxxx-....", // 可选:固定叫醒这一条
  169. "wakeEnabled": true // 设 false 一键关掉
  170. }
  171. ```
  172. 行为边界:
  173. | 情况 | 行为 |
  174. |---|---|
  175. | 什么都没配 | 唤醒**最近说话**的会话 |
  176. | 配了 `wakeSessionId` | 叫醒它 |
  177. | 目标会话正在运行 | **排队**(`mode=queue`,不打断)|
  178. | `wakeEnabled: false` | 一律不叫 |
  179. 自检(不会发消息):
  180. ```bash
  181. node lib/wake.mjs check # 能否发现宿主 / 认证 / 会选中哪个会话
  182. node lib/wake.mjs prompt --dry # 只打印要投递什么
  183. ```
  184. ---
  185. ## 设置(就在「思维链」画布右上角)
  186. 打开「思维链」tab → 工具栏右边点 **「设置」** → 画布右上角浮出面板:
  187. | 设置项 | 说明 |
  188. |---|---|
  189. | **池 × (宽限 / 半衰期 / 归档)** | 8 个池各三个数字 —— **最常调的就是这个** |
  190. | `injectMaxChars` | 注入段最多多少字符(越大越贵,但记得越全;默认 24000 ≈ 8k token)|
  191. | `coreMax` | 核心池上限(满了拒绝新增「原则/人格」;默认 32)|
  192. | `patrolHour` | 夜巡每天几点之后开始(默认 18)|
  193. 池的 key:`core` / `fact` / `skillRule` / `skillExp` / `dailyCore` / `dailyPartial` / `emotion` / `hippocampus`。
  194. **改完立刻生效,不用重启**:面板调的是插件自己的接口 `/chain-shared/api/settings`,
  195. 宿主侧收到就直接换掉运行时配置,同时把值写进
  196. `~/.dsh/memories/.chain-shared/settings.json`(下次启动自动读回)。
  197. > 为什么不塞进 DSH 自己的设置页:那套要走 `plugins.item` 槽位 + `configForms` 的
  198. > 内部约定,接起来脆弱(而且旧版槽位名一换就静默失效)。放在自己的画布里更直接,
  199. > 也不依赖宿主版本。
  200. 留空的输入框 = 用代码里的默认值(Host 只回传"你改过的")。
  201. ---
  202. ### 工作记忆块
  203. 注入段最前面可能有一块「还没做完的事」:
  204. ```
  205. 【还没做完的事】
  206. - 待办:记得问对方吃没吃饭
  207. - 答应过:明天把方案发你
  208. ```
  209. 它从你的话里认待办和承诺(`记得 / 待会 / 明天 / 答应过 / 我准备`),**纯正则,不调用模型**。
  210. 三条规矩:**最多 3 条**、**3 天没提起自动过期**、**说"做好了/发过去了"就删相关那条**。
  211. 它存在 `working.json`,**不进记忆链** —— 待办不该参与衰减统计,也不该出现在星云图里。
  212. ---
  213. ## 数据在哪、隐私如何
  214. ```
  215. ~/.dsh/memories/.chain-shared/
  216. ├─ chains.jsonl ← 全部判断(追加写,一行一条)
  217. ├─ mood.json ← 当前情绪(单槽,会被覆盖)
  218. └─ patrol/ ← 夜巡报告
  219. ```
  220. - **记忆与情绪数据留在本地**,不发遥测。更新检查默认关闭;开启后仅在启动时查询公开仓库最新 Release,不上传记忆、不自动安装。
  221. - 注入内容进的是**你自己的模型请求**,跟任何第三方无关。
  222. - 「会话隔离」不在这个包里:**所有会话共享同一份记忆**。如果你在多条人格线之间切换、怕串味,用隔离版。
  223. ---
  224. ## 它不适合谁
  225. - **想要"全自动记住一切"的**:这套的写入靠模型判断,不是无脑记录。它会漏,也会记错。
  226. - **不想让模型看到自己旧判断的**:注入就是把旧判断塞回提示词,这点要想清楚。
  227. - **多会话强隔离需求**:见上,这版是共享的。
  228. ---
  229. ## 已验证 / 未验证
  230. **验证过**(作者本机):
  231. - 注入每轮现渲染,**上下文压缩后仍在**(实测 32 核心 + 17 事实 + 54 技能一条没少)
  232. - 检索:两路融合(IDF + 二元组),14 条评估查询 Recall@5 **64%**(原话 100%);单用 IDF 时 29%
  233. - **注入预算压测**:合成 1000 条记忆时注入封顶 24000 字符,四个池都有配额、都标注了未展开条数;137 条时约 9100 字符
  234. - 衰减曲线:同为 98 天前最后接触,被想起 0 次衰减 25.7%、3 次 12.6%、10 次 9.2%
  235. - 夜巡:启动后 53 秒补跑成功,自动归整写入 3 条降权,报告 8.2 KB
  236. - 可视化:真 3D 每帧投影(194 颗记忆球 + 依据微粒),30fps 上限,零 SVG filter
  237. **没验证**:
  238. - 只在 Windows + DSH 0.2.0-rc 上跑过;macOS / Linux 未测
  239. - **夜巡本身仍是 O(n²)**:1000 条时配对比较约 50 万次,**没测过耗时**(注入那条已经压过,夜巡这条没有)
  240. - 跨语义的召回(换个说法只字不沾边)没解决:约一半换说法查询仍会漏
  241. ---
  242. ## 3.0.0:功能移植(基于 2.4.1)
  243. 新增可折叠池图例、节点高亮、分层详情、读中动画、情绪事件卡和注入回执。回执显示的是候选集,非最终注入文本条数;输出条目行也包含情绪与细节。
  244. 设置提供分组开关、时间感预设、使用指南及只读词库。陪伴预设沿用原池参数;切换预设会提示覆盖手动池参数。语义检索仍优先服从 `DSH_CHAIN_SEMANTIC`。注入扫描和更新检查默认关闭;扫描只记警告,不修改注入。
  245. 情绪支持正负状态并存、来源查询和重置;`chain_mood` 的 `why` 查看来源,`reset` 可通过 `keep` 保留指定状态。新变化写 `moods.jsonl`,旧 `mood.json` 保留可读。关闭情绪影响仍记录状态,只省略倾向描述,不改变记忆选取、权重或工具执行。
  246. 词库在 `~/.dsh/memories/.chain-shared/settings.json` 的 `moodLexicon` 中配置,整个对象覆盖默认,编辑后重新加载插件。[扩展词库示例](examples/mood-lexicon.rich.json)不会自动启用。
  247. 运行 `node tools/verify.mjs` 可执行语法、加载、临时 HOME 冒烟和隐私扫描。`CHAIN_BANNED_WORDS` 接受 JSON 字符串数组,或逗号、竖线、换行分隔的字面词表;私人词表仅放在本机环境变量,勿提交到仓库。UUID 扫描始终运行;未设置词表时脚本会明确说明未检查私人词语。正常作者署名保留,命中日志只显示文件与行号。
  248. 保留 2.4.1 的批量导入、跨进程锁、Android 进程身份分支、写入校验及共享作用域;版本仍为 2.4.1,正式发布另行决定。
  249. ---
  250. ## 许可
  251. MIT,见 [LICENSE](./LICENSE)。
  252. 署名:**末苍和她的大肥鱼**。
  253. > 这名字是这么来的:插件是一起做出来的,不是谁给谁写的。

Ratings and comments

Sign in to rate this skill.

Sign in

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