dsh-memory-huixiang 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/NOTICE +17 -0
- package/README.md +192 -2
- package/cordis.patch.yml +8 -0
- package/index.js +971 -0
- package/lib/autodream.js +35 -0
- package/lib/dream.js +214 -0
- package/lib/gate-words-extra.txt +23 -0
- package/lib/gate-words.txt +30013 -0
- package/lib/heat.js +102 -0
- package/lib/parse.js +85 -0
- package/lib/prompt.js +234 -0
- package/lib/recall.js +709 -0
- package/lib/store.js +642 -0
- package/lib/stream.js +163 -0
- package/package.json +47 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-cyber-hippocampus contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/NOTICE
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
回响(dsh-huixiang)
|
|
2
|
+
|
|
3
|
+
本项目的词表文件 lib/gate-words.txt 由 jieba 的中文词频表生成,
|
|
4
|
+
jieba 以 MIT 许可证发布:https://github.com/fxsjy/jieba
|
|
5
|
+
|
|
6
|
+
本项目是 dsh-hippocampus(常被叫作「赛博海马体」)的改造版:
|
|
7
|
+
|
|
8
|
+
上游:https://github.com/kianajunjie/dsh-hippocampus
|
|
9
|
+
作者:kianajunjie
|
|
10
|
+
许可:MIT
|
|
11
|
+
|
|
12
|
+
保留:一条记忆一个 .md 文件的外文库做法。
|
|
13
|
+
重写:召回、注入结构、人格分层、整理与写入闸。
|
|
14
|
+
|
|
15
|
+
上游的 MIT 许可与版权声明适用于其原始作品;本项目的改动同样以 MIT 发布。
|
|
16
|
+
|
|
17
|
+
MIT License. 见 LICENSE。
|
package/README.md
CHANGED
|
@@ -1,3 +1,193 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 回响 HuiXiang(`dsh-memory-huixiang`)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> 你的 AI 是不是每次开新对话就忘了你是谁?回响给它一块记得住你的记忆——存在你自己电脑里,不经过任何云端。
|
|
4
|
+
|
|
5
|
+
0.1 预览版 · MIT · 零依赖 · 一条命令装上
|
|
6
|
+
|
|
7
|
+
## 它解决什么
|
|
8
|
+
|
|
9
|
+
AI 聊天助手有个通病:聊完就忘。
|
|
10
|
+
|
|
11
|
+
今天告诉它你住哪、爱吃什么、上个月为什么难过,明天开个新对话,它一句都不记得——因为大多数助手只记得「当前这段对话」。
|
|
12
|
+
|
|
13
|
+
回响是给它装一块**在外面的记性**:
|
|
14
|
+
|
|
15
|
+
- 它会慢慢记住你说过的话、经历过的事、在意的东西;
|
|
16
|
+
- 这些存在你自己电脑上的一个文件夹里,**不上传、不联网**,你随时能打开看,也能删;
|
|
17
|
+
- 用得越久记得越准——留下的不只是事实,还有「为什么」。
|
|
18
|
+
|
|
19
|
+
## 它不是什么
|
|
20
|
+
|
|
21
|
+
- **不是云端服务**:没有账号、没有服务器;全库零网络请求,也不调用任何模型(没有 API key 照样跑)。
|
|
22
|
+
- **不会偷记聊天**:要显式让它记,它才记。
|
|
23
|
+
- **不是向量库**:不做 embedding,一条记忆就是磁盘上一个纯文本 `.md`,出问题时你拿记事本就能翻。
|
|
24
|
+
- **不是多用户服务**:一份库给一个 agent 用。
|
|
25
|
+
|
|
26
|
+
## 它从哪来
|
|
27
|
+
|
|
28
|
+
回响不是从零长出来的。它的骨架来自 **dsh-hippocampus**(我们一直叫它「赛博海马体」)——[kianajunjie/dsh-hippocampus](https://github.com/kianajunjie/dsh-hippocampus),MIT 许可,原本是给「大肥鱼」这类养成型 QQ 伴侣机器人做的记忆层。
|
|
29
|
+
|
|
30
|
+
**留下的**:一条记忆一个 `.md` 文件的外文库、记忆会随时间变淡、被想起来会加重、记不清就承认。这些做法是它的。
|
|
31
|
+
|
|
32
|
+
**重写的**:召回(什么时候该翻哪张卡)、注入结构(每轮放多少、分几层)、人格分层(底色与当前状态分开)、整理与写入闸(什么值得记、跟旧说法打架怎么办)。
|
|
33
|
+
|
|
34
|
+
原作者那套「情绪加权遗忘」的实测数字挺好看(90 天里,有情绪权重的旧记忆召回率 27%,去掉只剩 9%),想追根就去看原仓库。
|
|
35
|
+
## 它好在哪
|
|
36
|
+
|
|
37
|
+
**换个窗口,它还认得你。**
|
|
38
|
+
DSH 里你可以开很多窗口、叫很多分身干活。普通对话的上下文各自独立,换个窗口就得重新自我介绍一遍。回响的库是**一份**——所有窗口、所有分身读写同一个文件夹,新窗口里它照样记得你叫什么、不吃什么、上次那件事后来怎样了。
|
|
39
|
+
|
|
40
|
+
**它会忘。**
|
|
41
|
+
大多数记忆方案只做加法:记得越多越好,最后一股脑塞进上下文,又贵又吵。回响里的记忆会自然变淡(21 天重量掉一半),被想起来就加重。所以留在前面的是你反复提的,淡下去的是无关紧要的——像人一样。
|
|
42
|
+
|
|
43
|
+
**它不乱编。**
|
|
44
|
+
问一件库里没有的事,它会说「我这边没记录」,而不是编一个听起来对的答案。宁可弃权也不猜,这条有单独的测试守着。
|
|
45
|
+
|
|
46
|
+
**它记得住「为什么」。**
|
|
47
|
+
不只记「你住在扬州」,还记这条是打哪来的(你亲口说的 / 它自己推的)、什么条件下会变、哪天失效。两条说法打架就并排放着,标一个冲突,不硬圆。
|
|
48
|
+
|
|
49
|
+
**换个聊天软件,它也认得你。**
|
|
50
|
+
同一份记忆库,飞书、QQ、B站私信、网页聊天、手机 App 都读它。你在飞书随口提过的事,换到 QQ 里再问,它照样答得上来——记忆只存一份,不在每个渠道各记一遍。
|
|
51
|
+
|
|
52
|
+
**数据是你自己的。**
|
|
53
|
+
记忆就是一堆纯文本 `.md` 文件。想备份、想搬走、想用 git 管起来都行,也可以扔进 Syncthing 之类的工具同步到别的设备。没有专门的「同步」开关,因为不需要。
|
|
54
|
+
|
|
55
|
+
**省 token。**
|
|
56
|
+
每轮只往上下文里放「热的」那几张卡(实测约 3 千 token),不是把整库喂给模型。库用到几百张卡,注入量也基本不变。
|
|
57
|
+
|
|
58
|
+
**装起来不折腾。**
|
|
59
|
+
一条 `dsh plugin add`,零第三方依赖,不需要 API key、不需要 Docker、不需要向量数据库。装完就能用,断网也能跑。
|
|
60
|
+
|
|
61
|
+
## 它是怎么做到的(想深究的看这节)
|
|
62
|
+
|
|
63
|
+
- 一条记忆 = 磁盘上一个纯文本 `.md`,带 frontmatter(来源、标签、重量、边界、有效期)。
|
|
64
|
+
- 每轮只往上下文里放「热的」:钉住的卡 + 热卡全文 + 「大概记得」便签 + 目录标题。冷的留在库里,给线索才翻。
|
|
65
|
+
- 记得住「为什么」:知识(明白了什么)/ 经历(碰上了什么)/ 归纳分开存;两条说法打架就并排放着,标冲突。
|
|
66
|
+
- 人格分两层:底色(不常动)+ 当前状态(会变,旧版本自动进历史)。
|
|
67
|
+
|
|
68
|
+
> 词表文件与上游署名见 `NOTICE`。
|
|
69
|
+
|
|
70
|
+
## 十分钟装上
|
|
71
|
+
|
|
72
|
+
前提:Node >= 22、DSH >= 0.2.1-rc.2,并且知道要装进哪个 profile(`dsh profile list`,常见的是 `web`)。
|
|
73
|
+
|
|
74
|
+
**方式一(推荐,npm)**
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
dsh plugin --profile web add dsh-memory-huixiang
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
**方式二(源码)**
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
git clone https://github.com/JqandCl/dsh-memory-huixiang.git ~/.dsh/plugin-src/dsh-memory-huixiang
|
|
84
|
+
dsh plugin --profile web add link:~/.dsh/plugin-src/dsh-memory-huixiang
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
两条路**二选一**(都做会让 `--dump-config` 里出现两条同名 id,行为未定义)。装完重启 dsh。
|
|
88
|
+
|
|
89
|
+
首次启动会建一个空库:`$DSH_HOME/huixiang`(没有 `DSH_HOME` 就是 `~/.dsh/huixiang`)。
|
|
90
|
+
如果你以前用过 cyber-hippocampus,旧库在 `$DSH_HOME/cyber-hippocampus/`:只要新目录还不存在、旧目录里有卡,它会**继续用旧目录**,不会因为改名「记忆消失」。想搬到新目录,自己 `mv` 过去即可。
|
|
91
|
+
|
|
92
|
+
## 第一次验收
|
|
93
|
+
|
|
94
|
+
1. 让 agent 调 `hc_status`:应看到 `{ ok: true, dataDir: "…/huixiang", cards: 0 }`。`cards` 是 0 才对——仓库和 npm 包都不带任何作者数据。
|
|
95
|
+
2. 让它记一条:`hc_remember(body: "用户在测试回响,喜欢喝乌龙茶")`。
|
|
96
|
+
3. 再问:`hc_recall(cue: "我喜欢喝什么茶")`,应能翻回刚才那条。
|
|
97
|
+
|
|
98
|
+
## 它怎么工作
|
|
99
|
+
|
|
100
|
+
| 环节 | 做什么 | 落在哪 |
|
|
101
|
+
| --- | --- | --- |
|
|
102
|
+
| 写 | `hc_remember` 落一条卡,补边界、来源、标签;7 天内同一件事只补字段不新建 | `notes/<id>.md` |
|
|
103
|
+
| 存 | 艾宾浩斯式衰减:21 天掉一半,被想起变重,封顶 4;`pinned` 不衰减 | 卡里的 `weight` / `last_hit` |
|
|
104
|
+
| 取 | `hc_recall` 按线索召回:触发词、分词权重、实体闸;没记过就 `not_found`,不硬凑 | 只读 |
|
|
105
|
+
| 注入 | 每轮:钉住卡 + 热卡全文 + 便签 20 条 + 目录 130 条标题 + 因果链末 12 行 | 上下文 |
|
|
106
|
+
| 整理 | `hc_dream` 把同主题几件事归成一条 insight,保留来源;冲突并排不圆 | `ins-*` 卡 |
|
|
107
|
+
| 回查 | 原话只增不改地落 `stream.jsonl`;摘要记不清时 `hc_evidence` 按行号捞原句 | `stream.jsonl` |
|
|
108
|
+
|
|
109
|
+
## 工具
|
|
110
|
+
|
|
111
|
+
| 工具 | 作用 | 必填 | 常用可选 |
|
|
112
|
+
| --- | --- | --- | --- |
|
|
113
|
+
| `hc_remember` | 写一条长期记忆 | `body` | `title` `kind` `tags` `source` `source_type` `condition` `valid_until` `quote` `pinned` `links` `aka` `supersedes` `conflict` |
|
|
114
|
+
| `hc_recall` | 按线索翻库 / 按 id 取全文 | `cue` 或 `ids` | `limit` |
|
|
115
|
+
| `hc_status` | 库有多少卡、热的哪几条、笔记几条、因果链多长 | — | — |
|
|
116
|
+
| `hc_evidence` | 按关键词回查原话流水,返回行号、时间、原句 | `cue` | `limit` |
|
|
117
|
+
| `hc_persona` | 读/改人格底色与当前状态 | — | `base` `state` `note` |
|
|
118
|
+
| `hc_selfnote` | 写/读只给自己看的短笔记(上限 40 条) | — | `write` `last` |
|
|
119
|
+
| `hc_dream` | 把最近同主题的几件事归成一条 insight | — | `dryRun` `lookbackDays` |
|
|
120
|
+
|
|
121
|
+
## 配置
|
|
122
|
+
|
|
123
|
+
插件默认通过 `cordis.patch.yml` 注入三个配置(`chainTailLines: 12`、`hotLimit: 3`、`heat.floorFromWeight: 2.5`)。其余都可以省略,省略时的真默认值如下:
|
|
124
|
+
|
|
125
|
+
| 键 | 默认 | 说明 |
|
|
126
|
+
| --- | --- | --- |
|
|
127
|
+
| `chainTailLines` | `12` | 每轮注入因果链最后几行 |
|
|
128
|
+
| `hotLimit` | `3` | 注入几条热卡全文 |
|
|
129
|
+
| `briefLimit` | `20` | 「大概记得」便签条数 |
|
|
130
|
+
| `catalogLimit` | `130` | 「记忆目录」标题条数上限 |
|
|
131
|
+
| `compressionLog` | 空 | 折叠日志路径;留空走 `$DSH_HOME/notes/compression.log` |
|
|
132
|
+
| `healthScript` | 空 | 每日体检脚本;留空走 `$DSH_HOME/tools/hc-health.sh`(不存在就跳过) |
|
|
133
|
+
| `autoDream.enabled` | `true` | 原话攒够行数就自动整理一次 |
|
|
134
|
+
| `autoDream.everyLines` | `20` | 攒多少行触发 |
|
|
135
|
+
| `autoDream.cooldownMs` | `3600000` | 两次整理的最小间隔 |
|
|
136
|
+
|
|
137
|
+
记忆重量(`heat`)的全部默认值——注意第二条:`cordis.patch.yml` 会把 `floorFromWeight` 覆盖成 `2.5`,所以**装好之后实际生效的是 2.5**:
|
|
138
|
+
|
|
139
|
+
| 键 | 默认 | 含义 |
|
|
140
|
+
| --- | --- | --- |
|
|
141
|
+
| `halfLifeDays` | `21` | 21 天掉一半 |
|
|
142
|
+
| `initialWeight` | `1` | 新卡的重量 |
|
|
143
|
+
| `rehearseBoost` | `0.6` | 被想起一次加多少 |
|
|
144
|
+
| `maxWeight` | `4` | 封顶 |
|
|
145
|
+
| `hotAt` | `0.55` | 到这个数算热(会被注入) |
|
|
146
|
+
| `warmAt` | `0.18` | 到这个数算温(只在召回时出现) |
|
|
147
|
+
| `coldAfterDays` | `120` | 这么久没想起就冷存(仍然可搜) |
|
|
148
|
+
| `pinWeight` | `4` | `pinned` 卡的常温重量:不衰减、不看闲置 |
|
|
149
|
+
| `dedupeWindowMs` | `604800000`(7 天) | 写侧去重窗口 |
|
|
150
|
+
| `floorFromWeight` | `3.2`(被覆盖成 `2.5`) | 原始重量到这条线算「底线级」 |
|
|
151
|
+
| `floorWeight` | `0.5` | 底线级卡片的衰减地板 |
|
|
152
|
+
|
|
153
|
+
## 验证
|
|
154
|
+
|
|
155
|
+
以下命令**只在源码树里跑**——npm 包不带 `test/`、`demo/`、`eval/`(包只含 `index.js`、`lib/`、`cordis.patch.yml`、`README.md`、`NOTICE`、`LICENSE`)。
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
node --test # 206 个测试全过
|
|
159
|
+
node demo/simulate.mjs # 10 项演示,用临时库,不碰真库
|
|
160
|
+
node eval/run.mjs --golden <你的题库.jsonl> --dir <你的库目录>
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
`eval/golden.jsonl` 里是**示例题库(假数据)**,直接跑对不上任何真库。要评测自己的库,照它的格式建一份:每行 `{ id, kind, query, expect }`,`kind` 取 `paraphrase` / `update` / `abstain`,`abstain` 题不写 `expect`。
|
|
164
|
+
|
|
165
|
+
## 三条设计取舍
|
|
166
|
+
|
|
167
|
+
1. **纯文本而不是数据库**:能 `tar` 走、能 `grep`、坏了一张卡能手改。代价是没有事务、没有并发保证(只有文件锁)。
|
|
168
|
+
2. **不做 embedding**:召回靠词面 + 标签 + 实体闸,确定、可解释、零依赖、零费用。代价是纯近义改写会漏。
|
|
169
|
+
3. **冷的绝不注入**:省 token 优先于「全知」。代价是它可能一时想不起来,除非你给线索。
|
|
170
|
+
|
|
171
|
+
## 已知短板
|
|
172
|
+
|
|
173
|
+
- 召回是词面驱动的:换个说法(「家在何方」对「住哪」)可能翻不到。
|
|
174
|
+
- 单机单进程假设:多进程靠 `O_EXCL` 文件锁,不是分布式锁。
|
|
175
|
+
- `stream.jsonl` 会存每一轮原话(单条截断 4000 字)。这是特性也是风险,见「隐私」。
|
|
176
|
+
- 206 个测试覆盖的是核心路径,不是全覆盖。
|
|
177
|
+
|
|
178
|
+
## 隐私
|
|
179
|
+
|
|
180
|
+
- 全部本地:`$DSH_HOME/huixiang`。全库零网络请求、不上传,也不调用模型。
|
|
181
|
+
- 建库时目录 `0700`、文件 `0600`(同机其他账户读不到)。
|
|
182
|
+
- `stream.jsonl` 是原话流水:只增不改。不想留就在关掉 agent 后删掉这个文件,库照常工作(只是没法回查原话)。
|
|
183
|
+
- 整个目录可以拷走换机器;`persona.json`、`notes/`、`chain.txt` 都在里面。
|
|
184
|
+
|
|
185
|
+
## 命名与版本
|
|
186
|
+
|
|
187
|
+
- 显示名:**回响**(HuiXiang);npm 包名:`dsh-memory-huixiang`。
|
|
188
|
+
- 插件 id 仍是 `cyber-hippocampus`:用户配置里写的是 id,改它会让已有配置全部失效,所以只改显示名与包名。
|
|
189
|
+
- 0.1 预览版,配置与工具参数还可能变。
|
|
190
|
+
|
|
191
|
+
## License
|
|
192
|
+
|
|
193
|
+
MIT,见 `LICENSE`。`lib/gate-words.txt` 由 jieba 词频表生成,来源与许可证见 `NOTICE`。
|