Skip to content

Releases

dsh-chain 3.0.0

Choose a tag to compare

@canglight canglight released this 09 Nov 10:43

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 平台锁崩溃修复 + 批量写入行校验

Choose a tag to compare

@canglight canglight released this 03 Nov 13:38

修掉 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 处静默缺陷

Choose a tag to compare

@canglight canglight released this 03 Nov 13:20

一次可靠性更新,没有新功能:把 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

Choose a tag to compare

@canglight canglight released this 01 Nov 14:33

新增 chain_import 工具

一次调用完成夜巡落链的全部写入动作:批量写判断 + 定池 + 退役 + 合并。

  • dryRun: true 只校验不写
  • 逐项校验:pool 合法 / evidence 非空 / retire 只许 hippocampus / merge 的 id 必须存在
  • 不合格的项跳过并写进 errors,合格的照常执行
  • 新建 id 立即可被 chain_recall 查到

为什么

原先一次夜巡落链要 20+N 以上次工具调用,每次重发整份上下文。现在压成 1 次。

附件

v2.2.1 — 夜巡一直在报告,但从来没叫醒过你

Choose a tag to compare

@canglight canglight released this 31 Oct 12:03

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 — 它开始会自己纠正

Choose a tag to compare

@canglight canglight released this 31 Oct 08:59

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 — 它开始知道自己记得什么

Choose a tag to compare

@canglight canglight released this 30 Oct 09:35

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 — 你说过的话能进注入了

Choose a tag to compare

@canglight canglight released this 30 Oct 01:18

一个中间版本,只做两件事:让用户说过的话能进注入,以及清掉几处会把它弄丢的毛病。

新增

注入段多了「最近用户说过的话」

海马体是原始片段的缓冲区,设计上永不注入;但它装的正是用户的原话 —— 一点不给,记忆就只剩技能型判断,对话越久越像机器。

现在开一扇很小的窗:最近 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 — 注入量不再随记忆增长

Choose a tag to compare

@canglight canglight released this 29 Oct 11:34

这一版全在「记忆怎么进 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 — 第一个能用的版本

Choose a tag to compare

@canglight canglight released this 29 Oct 08:18

思维链记忆插件(全会话通用版)。让 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)。