Repository navigation
Releases
dsh-chain 3.0.0
3.0.0 — 2.x 收官版
从私有版移植 3.0 的全部功能:
UI
- 池图例、详情阅读层级、分组设置
- 开屏动画(点了「思维链」不再黑屏 2 秒)
- 回执条与最近注入列表(明确区分「候选」与「实际注入」)
情绪
- 多状态并存:每条带强度、时间、来源事件与倾向
- 来源面板、重置、表达影响开关
- 语气分类按「基调」而非「动作」:纠正 ≠ 挫败,催促 ≠ 警觉
其它
- 可配置情绪词库(
moodLexicon),另附 457 条扩展词库示例(不自动启用) /chain-shared/api/receipts只读接口tools/verify.mjs:临时 HOME 自检(语法 / 加载 / 隔离 / 冒烟 / 私人串扫描)
保留的 2.4.1 能力
chain_import 批量落链、跨进程锁、Android 进程身份分支、写入校验、共享作用域(.chain-shared / DSH_CHAIN_TARGET_SESSION_IDS)。
升级注意
- 无损升级:数据目录仍是
~/.dsh/memories/.chain-shared/ - 3.0.0 之后只修 bug,不再加功能
已知限制
- 夜巡仍是 O(n²):1000 条记忆时配对约 50 万次,未测耗时
- 跨语义召回(换说法只字不沾边)未解决,约一半换说法查询会漏
- 只在 Windows + DSH 0.2.0-rc 上验证过;macOS / Linux 未测
v2.4.1 — Android 平台锁崩溃修复 + 批量写入行校验
修掉 2.4.0 带进来的一个致命平台缺陷,外加一处写入侧断言。不新增功能。
修复
-
2.4.0 在 Android 上会让所有写入失败。 跨进程锁的进程身份查询只写了
win32和linux两个分支,Android 落到最后一行直接抛LOCK_IDENTITY_UNAVAILABLE: unsupported platform android—— 手机端每条写入都失败,记忆库等于被锁死。Android 同样提供/proc(/proc/<pid>/stat与/proc/sys/kernel/random/boot_id都可读),现在与 Linux 走同一分支。 -
appendChainBatch补行校验。 它是内部函数,只接受调用方构造完整的行(必须带id)。此前不做校验,缺id的行会被照常写进文件,而读取侧会把它们当坏行静默跳过 —— 现象是「写了 N 行、读回 0 条」。现在在任何 IO 之前失败,外层折成{ written: 0, error: 'BATCH_ROW_INVALID: ...' },零写入。
验证
| 项 | 结果 |
|---|---|
| 回归 | 10/10 |
| 三处前缀一致 | 挂载 / 路由 / 前端均 /chain-shared |
| Android 分支 | 伪造 process.platform = 'android' 后不再抛平台错误,改为走 /proc 路径 |
| 批量断言 | 缺 id 的行被拒且零写入;非对象被拒;正常行写 1 条、读回 1 条、skipped: 0 |
说明
- 改动面只有
lib/store.js与版本号,没有新增功能,也没有改任何工具签名。 - 手机端装过 2.4.0 的请升级到 2.4.1;桌面端行为不变。
- 这一版是从公开版 v2.4.0 基线复制后只打这一处差异补丁,没有整包覆盖私有版(两版作用域语义相反,覆盖会互相破坏)。
v2.4.0 — 可靠性修复:跨进程锁 + 11 处静默缺陷
一次可靠性更新,没有新功能:把 11 处「坏的时候看不出来」的缺陷修掉,并给写入加了一把跨进程锁。
最重要的一条
两个 DSH 实例共用同一个 chains.jsonl 时,以前会丢数据。
实例 A 写入失败会按自己记下的原长截断,把实例 B 刚写成功的记录一起删掉,而 B 仍以为成功。
现在所有追加入口共享一把票据文件锁(PID + 进程启动时间 + 随机令牌),
读状态 → 校验 → 追加 → 回滚全在同一临界区。拿不到锁返回 LOCK_TIMEOUT,不会静默降级成无锁写。
其余 10 处
| 编号 | 问题 | 症状 |
|---|---|---|
| P0-2 | 单条追加不补前置换行 | 两条 JSON 粘成一行,旧记录和新记录一起失效 |
| P0-3 | 读取失败伪装成空库 | 导入可在已有损坏时返回 ok:true |
| P0-4 | 铁律没有优先预算 | 预算压到 2000 时铁律 0 条、语义补位 3 条照进 |
| P0-5 | 被截掉的仍记为「已想起」 | 统计虚高,该淡忘的被续命 |
| P0-6 | 联想不足三条不真回退 | 联想段不输出、其他池又被清空,两头空 |
| P0-7 | 夜巡正则写成字符集合 | today 我想吃饭 被误排除 |
| P1-8 | 超大 merge 组参数展开 | 栈溢出 |
| P2-9 | schema 与 handler 契约不一致 | 工具说明与实现对不上 |
| P2-10 | 经验先占预算再裁三条 | 预算不释放,挤掉其他池 |
| P2-11 | 夜巡轮次按文件天数算 | 同一天三轮只算一天 |
新增配置
storeLockTimeoutMs:锁等待上限,默认 2000ms,范围 100–60000ms,非法值回落默认。
性能
| 场景 | 改前 | 改后 |
|---|---|---|
| 单次 append(热) | 7.11 ms | 8.73 ms |
| 双进程竞争(热) | 7.37 ms | 31.23 ms |
| 新进程首次调用 | 10.41 ms | 177.21 ms |
冷启动那 177ms 是一次性的(首次查进程身份),热路径每次多约 1.6ms。
升级提示
互斥保护要求所有 DSH 实例都加载新版。
v2.3.0 — 批量落链 chain_import
新增 chain_import 工具
一次调用完成夜巡落链的全部写入动作:批量写判断 + 定池 + 退役 + 合并。
dryRun: true只校验不写- 逐项校验:pool 合法 / evidence 非空 / retire 只许 hippocampus / merge 的 id 必须存在
- 不合格的项跳过并写进
errors,合格的照常执行 - 新建 id 立即可被
chain_recall查到
为什么
原先一次夜巡落链要 20+N 以上次工具调用,每次重发整份上下文。现在压成 1 次。
附件
v2.2.1 — 夜巡一直在报告,但从来没叫醒过你
2026-10-31。小修:一处 bug 修复 + 三个新文件(都可选,不影响现有行为)。
修复
夜巡的自动唤醒从未真正生效。
lib/wake.mjs 拿 sessions.list 返回的完整 session-<uuid> 去和配置里的裸 uuid(不带 session- 前缀)做严格相等比较,永远不相等。结果是每次夜巡只往 wake.log 记一条 跳过:explicit-not-found —— 报告照写、人却从不被叫醒。
现在两边都归一化(去掉前导 session-),带不带前缀都能命中。
影响面:只在显式配置了目标会话时出现。没配置时走「最近活跃会话」,不经过这段比较,本来就是好的。
新增
lib/triage.js—— 把海马体碎片整理成「四分支(append / merge / retire / keep)+ 提炼草稿」的批量分类 prompt,并对模型返回做结构校验(id 只能来自输入、每个 id 恰好覆盖一次、append必须带draft、reason≤60 字、pool合法)。只产出建议,不写任何记忆。tools/triage-dryrun.mjs—— 读当前海马体碎片 → 调一次 LLM → 输出分组建议与校验报告,同时打印chains.jsonl的 SHA-256 前后值,证明没写库。skills/memory-triage-dispatch/—— 写给 AI 读者的手册:用 subagent 当外接分类器完成同一件事,不占主会话上下文、不需要 API key。
说明
- 外接接口需要
TRIAGE_BASE_URL/TRIAGE_API_KEY/TRIAGE_MODEL,缺任何一个直接退出并指出缺哪个,不猜测、不使用默认值。 - 不想给 key 就走 skill 里那条子代理路,效果相同。
升级
覆盖 lib/ 与 tools/,重启 DSH 一次(插件代码不热加载)。
v2.2.0 — 它开始会自己纠正
2026-10-31。公开版从 2.0.0 对齐至 2.2.0;2.1 未单独发布,其间小更新已合入。历史见 CHANGELOG.md。
本版变化
- 新增第 8 个工具
chain_conflict:指定两个 id 直接比较,或检索同池候选;过滤泛词,按 strong 具体锚点数优先排序,只提供审查线索。 chain_append可选传eventId;检索与元记忆查询最多补带 2 条同事件记录,标记sameEvent: true,方便读到决策前后文。- 带 eventId 的新判断在前段出现推翻词时,可自动追加同组旧条的 supersede 事件;不动核心池,单次最多 2 条,相同载荷重试复用新条,不改历史正文。
- 夜巡增加「矛盾候选」与「半写断裂 / 同事件对账」审查,并提供历史 eventId 粗回填建议。报告含 10 个检查小节(不计概览),有关系边时另附「联想网络」。新增检查只报告,不自动回填或退役。
- 合入 2.1 期间的感知面板、真实事件动画、检索与片段处理更新。自动夜巡只审查;手动工具可用
apply: true显式执行权重归整。
公开版配置与升级
默认全会话共享,数据目录为 ~/.dsh/memories/.chain-shared,Web API 前缀为 /chain-shared。可选环境变量 DSH_CHAIN_TARGET_SESSION_IDS 接受逗号分隔的会话 id,缺省空字符串不按会话过滤;画布标签读取服务端配置。
只同步正式 .js 实现,不分发备份;私人标识和示例已中性化。依赖清单不变,语义检索仍为可选功能。
在插件目录更新代码,确认已安装依赖,然后重启 DSH:
cd ~/.dsh/plugins/dsh-chain-shared
git pull
npm install
# 重启 DSH升级本身不改写已有记忆正文。自动退役只在满足上述条件的新写入发生时追加生命周期事件。
已知限制
矛盾候选基于词面线索,最终判断仍需人工审核;同事件推翻词检测也是词面规则。夜巡配对比较仍是 O(n²)。可选语义检索缺失时会降级;跨语义召回不保证完整。macOS / Linux 未做真机验收。
v2.0.0 — 它开始知道自己记得什么
v2.0.0 — 它开始知道自己记得什么
这一版是结构级的:记忆不再只是一个库,而是一整套 感知 → 联想 → 决策 → 元记忆 的闭环。
1.6.x 解决「记下来、别丢」;2.0 解决「知道自己记了什么、为什么会想起它、为什么会忘」。
新增工具
chain_about —— 元记忆的出口
以前只能问「我说过什么」(chain_recall 给正文);现在可以问「关于 X 我知道什么、多可信、变过几次」:
- 被想起次数 / 人工确认次数 / 生命周期状态 / 是否被取代 / 依据条数
- 只读:调它不算"想起"(想起靠注入命中或人确认,这两件事在事件层是分开的)
新增能力
注入里多了「这次联想到的」
从本轮原话出发,在链上走 1–2 跳,把走出来的判断贴回提示词。走线是「分层挑选」——
名额先留给走出来的那一跳,种子不会把预算吃光(修的正是"决策层只做截断"那类问题)。
语义补位(可选)
关键词路先跑;宿主的 system-prompt/assemble 是异步 waterfall,用它在组装阶段再补一次语义检索,
把「字面没挂上、但意思接近」的补进来。失败一律原样返回 —— 不让"更聪明"变成"可能挂掉"。
装了 @huggingface/transformers 才有;不装自动退回关键词路,不报错。总开关:DSH_CHAIN_SEMANTIC=0。
感知层
把用户原话分成 chat / task / question / daily / emotion / decision / mixed,并给情绪极性。
本版只记录、不改变行为。
夜巡可见
之前它只写报告、界面上一片空白 —— 跑了和没跑在用户眼里完全一样。
新增 GET /chain-shared/api/patrol 与画布状态行「夜巡 16:51 · 428 条」。
修掉的病
| # | 症状 | 根因 |
|---|---|---|
| 1 | 夜巡后的自动唤醒每次都丢 | 唤醒由压缩触发,而压缩发生在回合中途 → 那一轮必然还在跑 → wake.mjs 里「显式目标 + 正忙 → 跳过」把它吃掉了。投递本来就是 mode:'queue'(排队不打断),这条跳过是多余的。已删除;子进程输出改写入 wake.log |
| 2 | 一个会话卡住,全群跟着卡 | 组装钩子取不到会话 id 时"放行",等于给所有会话都跑语义检索,而模型首次加载约 10 秒。改为 fail-closed:拿不到 id / 不是注入目标 → 直接跳过 |
| 3 | 注入与画布同时变空 | 一个变量声明放错作用域 → section 回调 ReferenceError → 注入返回空串 → 脉冲也不发布。已在 apply 顶层声明,并补了冒烟脚本同时检查「注入非空」与「脉冲递增」 |
| 4 | Windows 下 sharp 冲突 | 语义依赖带 sharp 0.34,宿主用 0.35,两个原生 DLL 撞在同一进程:先加载谁,另一个就 ERR_DLOPEN_FAILED。不靠调整加载顺序 —— 模型推理跑在 fork 子进程里(lib/embed-worker.js),宿主进程一份都不加载 |
| 5 | 元记忆节点显示的像是假数据 | 汇总节点 weight 恒 0.5、ageDays 恒 0。改为取来源真实值 |
| 6 | 年龄一直显示「0 天」 | 0.2 天也显示 0 天。改为不到 1 天按小时 |
| 7 | 亲昵 / 关心的话读不出情绪 | 「摸摸」「顺毛」「辛苦了」「早点睡」「晚安」全读成 0;补近义类后为 +0.33。词典 441 → 473 词,技术句仍是 0 |
怎么升
cd ~/.dsh/plugins/dsh-chain-shared
git pull # 或解压新包覆盖
npm install --registry=https://registry.npmmirror.com # 这一步别省(依赖没变,但缺了会静默降级)
# 重启一次 DSH(lib/ 的改动不热加载)升级不会动你的记忆:chains.jsonl 是追加式的,升级只读它、不改它。
想开语义检索(可选,约 400 MB):
npm install @huggingface/transformers --registry=https://registry.npmmirror.com已知限制
- 感知只记录、没接判断 —— 它还不改变行为(比如"说累时少塞技术细节")。
- 夜巡没有「现在跑一次」按钮 —— 想立刻验只能等压缩,或等 18:00 后到点。
- 跨语义召回仍不完整 —— 换个说法、字面一点不沾边的查询,语义路能补一部分,不是全部。
上一版:v1.6.1(用户说过的话能进注入)。完整历史见 CHANGELOG.md。
v1.6.1 — 你说过的话能进注入了
一个中间版本,只做两件事:让用户说过的话能进注入,以及清掉几处会把它弄丢的毛病。
新增
注入段多了「最近用户说过的话」
海马体是原始片段的缓冲区,设计上永不注入;但它装的正是用户的原话 —— 一点不给,记忆就只剩技能型判断,对话越久越像机器。
现在开一扇很小的窗:最近 2 天内 4 条原文,每条截 80 字,放在情绪之后、核心之前。
不摘要 —— 摘要会把用户的话改写成模型的措辞,那就又丢了。
夜巡会把用户说的日常转进日常池
纯词面判据(不调用模型):谈到「我们 / 相处」→ 核心日常;生活细节与语气 → 片面日常。
转池用 retag 事件原地改池,正文一个字不动 —— 用户的话本身就是价值,加工成判断反而是替人改写。每次最多 12 条。
日常层活得更久(默认参数)
| 池 | 宽限 / 半衰期 / 归档 |
|---|---|
| 核心日常 | 10/10/20 → 20/60/180 |
| 片面日常 | 2/5/7 → 5/20/45 |
| 海马体归档 | 3 天 → 14 天 |
原有配置仍可在画布右上角的设置面板里覆盖。
修复
这五条都属于「看起来在工作、实际没生效」那一类,所以每条都写清症状 / 根因 / 修法。
① 工作记忆没有隔离守卫 —— 任何会话都会写同一份 working.json
- 症状:另一条会话聊完,本会话的「还没做完的事」里冒出别人的句子
- 根因:写缓冲前的会话判断只加在海马体那一条路径上,工作记忆那段没有
- 修法:写之前先判目标会话;每一条写入路径都要守卫
② chain_touch 的 set-pool 每次都报 returned invalid output
- 症状:手动给记忆定池,工具报错,看着像失败
- 根因:写入其实成功了,但输出结构的必填字段
retired只在弃用分支返回 - 修法:定池分支也返回
retired: 0
③ chain_touch 的 id 是必填的,导致批量退役用不了
- 症状:想一次退役 N 条,必须先传一个空
id才能走ids分支 - 修法:
id改为可选,只留outcome必填
④ 手动跑夜巡被标成「定时」
- 症状:报告小节和旁车文件里,手动触发与定时触发长得一样
- 修法:手动入口显式传
trigger: '手动'
⑤ 「最近用户说过的话」可能「header 说 4 条、实际只打出 1 行」
- 症状:这一节标题写着 4 条,下面只有 1 行
- 根因:头部计数与正文渲染用了两把尺子 —— 计数只看"过滤后剩几条",循环体里还有一条"空正文就跳过"
- 修法:把"必须有字可打"这条判据挪进过滤器本身
打包方式也换了
这一版起改用 git archive 打 zip:包内路径是正斜杠。
v1.6.0 的包用的是 Compress-Archive,条目是 lib\index.js 这种反斜杠写法 —— macOS / Linux 解包会散成一层平铺文件,package.json 的 main 找不到,整包加载失败。这一版没有这个问题(实测 32 个条目,含反斜杠 0 个)。
升级方式
cd ~/.dsh/plugins/dsh-chain-shared
git pull依赖没变,不用重新 npm install;但 要重启一次 DSH,lib/ 的改动不热加载。
已知限制(没变)
- 换个说法仍有约一半检索不到(关键词 + 字符二元组,没有语义向量)
- 转池判据是词面正则,可能把「说到吃的」的技术讨论也转进日常(可手动改池)
- 夜巡本身仍是 O(n²)
完整历史见 CHANGELOG.md。
v1.6.0 — 注入量不再随记忆增长
这一版全在「记忆怎么进 prompt」这一层。记忆结构没变,变的是它怎么被装进每一轮请求。
新增
注入预算:按字数装箱
以前撞上 injectMaxChars 是"整段停"——后面的池直接消失,而且没有任何痕迹。现在:
- 四个池的候选合成一个池,按权重全局排序逐条装
- 装不下就跳过这条、继续试下一条(不是整段停)
- 装不下的条数写在段标题里:
另有 N 条未展开(chain_recall 可查)
实测:1000 条记忆时注入稳定封顶 24000 字符,四个池都有配额;137 条时约 9100 字符。
检索:两路融合(RRF)
关键词打分只看"有没有命中罕见词",换个说法就零命中。现在融合两路排序 —— IDF 罕见词命中 + 字符二元组重合,按名次融合(1/(60+rank))。
两条硬规矩:没有词面证据的条目不进候选;新鲜度与权重只做平局裁决。
实测(14 条评估查询,含 6 条换说法):Recall@5 从 29% → 64%,原话查询 100%。
工作记忆块
注入段最前面多一块「还没做完的事」:从你的话里认待办和承诺,最多注 3 条,3 天没提起自动过期,说"做好了/发过去了"就删相关那条。纯正则,不调用模型,存在 working.json 不进记忆链。
检索评估工具
cp tools/eval-queries.example.json tools/eval-queries.json # 改成你自己的查询
node tools/eval-retrieval.mjs输出 Recall@3 / Recall@5 / MRR 与零命中清单。换检索实现之前先跑它。
修复
chain_recall原本把整句话当子串搜 —— 实测 Recall@5 = 0%,只要不是原话就永远搜不到。现在走 RRF。- 夜巡 ③ 的碎片噪声:滑窗切出的「的每句话」「后她说」会被当成"共享稀有词"。加词形过滤(首尾不能是虚字)后从 25 对降到 13 对。
- 注入里检索命中的分数显示:融合分是 0.03 量级,旧写法显示成全
(0.0),看着像没命中。现在只显示命中词。
升级方式
cd ~/.dsh/plugins/dsh-chain-shared
git pull不需要重新 npm install(依赖没变),但要重启一次 DSH —— lib/ 的改动不热加载。
完整更新日志
见仓库里的 CHANGELOG.md(含 1.5.9 / 1.5.10 / 1.5.11 / 1.5.12 的历史)。
已知限制
- 换个说法仍有约一半搜不到(两路融合补不了真正的语义)。要跨过这一档需要本地 embedding,放在后续版本评估。
- 工作记忆只认显式说法("可能""也许"抓不到);泛化收尾(只说了"搞定了")可能一条都清不掉。
- 夜巡本身仍是 O(n²),1000 条时的耗时没测过 —— 只有注入那条压测过。
v1.5.9 — 第一个能用的版本
思维链记忆插件(全会话通用版)。让 DSH 记住「为什么这么决定」,而不只是结论。
这个版本有什么
- 6 个工具:
chain_append/chain_recall/chain_graph/chain_touch/chain_patrol/chain_mood - 7 个池:核心(永不衰减)/ 事实 / 技能 / 核心日常 / 片面日常 / 情绪 / 海马体(原料缓冲区)
- 3D 星云画布:行星轨道运动、点击聚焦看全文、设置面板直接调池寿命
- 夜巡:每天 18:00 后自动出报告 + 跑完自动唤醒最近说话的会话
- 人工定池:
chain_touch({ action: 'set-pool', ... })—— 「需人工定池」这一步终于有按钮了
安装
cd ~/.dsh/plugins
git clone https://github.com/canglight/dsh-chain.git dsh-chain-shared
cd dsh-chain-shared
npm install --registry=https://registry.npmmirror.com # 必须:link 方式不会替你装依赖
cd ~/.dsh/profiles/web
pnpm add link:~/.dsh/plugins/dsh-chain-shared然后重启一次 DSH。
这个版本修了什么
- 唤醒在全会话版里是死代码(空列表 → 直接 return)→ 现在不传会话 id,自己挑最近的
- 夜巡时间改了不生效(闭包常量)→ 现在现读,最多 10 分钟生效
- 报告残缺也当「今天跑过了」→ 现在比覆盖率,差太多就补跑
chain_patrol直接崩(output schema 少一个字段)→ 已补- ④ 只列最新 10 条、老判断永远排不上 → 拆成「判断 / 片段」两组
- ⑥ 只认新标签、老条目进不来 → 改成「标签没命中任何池规则」
- 「累计三次」数的是记录条数(同一条永远算 1)→ 改成按报告期数
- 检索把海马体原料也翻出来 → 按标签排除,待归类判断仍可检索
- 落盘去重前缀不匹配(私有版写「她说」、对外版写「用户说」)→ 两种都认
- core 满了会把所有写入都拒掉 → 只有真的落 core 时才拦
已知限制
- 只在 Windows + DSH 0.2.0-rc 上跑过;macOS / Linux 未测
- 检索是关键词 + 通用 IDF,换个说法就可能零命中(语义检索在计划里)
- 上千条记忆后的检索与夜巡性能未测(夜巡是 O(n²))
完整的包
点上面的 Source code (zip) 就够了;chain-shared-v1.5.9.zip 是同一份内容的预打包版(含 docs/ 截图,省得自己 clone)。