dsh-soul

DSH Soul 2.1.0 — 图记忆修复与可选动力学重做

为 DSH 保存会话中的约束、决策、产物与进度，用本地记忆图和原文索引找回细节，并提供独立的图压缩后端与受控演化流程。

记忆默认开启，记忆动力学与演化默认关闭。抽取和检索在本地执行，不修改模型权重；投影进入主模型上下文仍有 token 成本。演化中的候选编辑与探测会使用显式配置的模型路由。 2.1 相比 2.0 改了什么 减少误作废。 去掉「决定、改成、必须」等指令词后，按对象实体判断是否为同一件事；不同实例不会仅因句式相似互相作废。 对齐宿主坐标。 节点保存会话与事件 seq；压缩加权改按实体匹配，目录无法对齐时明确标注不可直接用于 soul_expand。 修正召回排序。 按联想强度和扩散可达度排列邻居；同次回捞命中的有效节点可以建立关联，被取代或被纠正的节点不参与关联扩散。 退役记录仍可回捞。 不再按 30 天固定删除；总行数超过容量上限四倍时才清理最旧的非活动记录。恢复操作不会复活已经作废的约束。 校验已记录的产物。 检查文件内容指纹，外部修改后标记过时；后续重写同一文件时取代旧产物节点。真实工具参数解析仍有已知缺口，见下文。 减少自我污染。 卡片的 runtime-context 快照不再重新编译进记忆图或原文索引；普通报错不再被误判为用户纠正。 重做可选动力学。 统一使用历史、工作记忆、当前线索、图上下文与纠正惩罚，按「本轮可能需要」排序；支持侧抑制、时间边与学习边整理。memory.dynamics 仍默认关闭。 新增回放评估。 支持合成负载与 JSONL 回放、工具路径评分和线索消融；真实日志适配限制见「验证与已知问题」。数据库升级为 Schema 9。

完整说明见 2.1 发布说明 和 CHANGELOG。 安装与升级

需要 Node.js 24+，DSH 支持范围为 >=0.2.1-rc.2 /evolve.sqlite；未配置 DSH_HOME 时使用 ~/.dsh。不同 profile 不共享默认库，记忆另按项目作用域区分。无法确定 profile 且未指定 database 时会明确报错。 项目结构与工作流

一轮任务怎样变成记忆

1. 入口收集用户消息、工具调用与结果，保留宿主 session 与事件 seq。 2. 每轮结束后，规范化与规则抽取生成约束、决策、产物和进度节点，写入本地 SQLite。 3. derived、supersedes、related、coactivated、precedes、contradicts 等边记录来源、替换、关联与纠正。原文片段另行索引。 4. 下一轮选择预算内的信息作为提示上下文。投影来自持久化的记忆图；宿主可能将它记录为运行时快照，Soul 会排除这些快照，避免再次入图。 5. 需要细节时，soul_recall 查询记忆和原文，soul_expand 按事件坐标展开。退役、取代与纠正状态会影响当前选择，原文与索引仍受保留上限约束。

可选记忆动力学

默认卡片按置顶、类型与新旧排序。开启 memory.dynamics 后，使用历史、工作记忆、当前任务线索、图上下文、意外度与纠正惩罚共同影响排序：

激活来自用户提及、工具读写、回复引用与回捞等使用证据，不来自展示。侧抑制避免同一对象重复占满卡片；动力学模式下置顶约束最多占 60% 预算。学习边可以衰减与缩放，结构和相似度边不随空闲整理衰减。

动力学改变卡片内容，可能增加运行时快照变动与上下文成本，因此保持默认关闭。/mem dynamics 可查看排序依据；它不是模型权重训练或生物神经元仿真。 独立图压缩后端

普通插件安装不会自动替换宿主压缩器。需要使用图压缩时，在实际 profile 中将原后端替换为：