v0.5.21:大型 Native 记忆空间与更精简的热记忆
本补丁版本包含 v0.5.20 之后合并的三个 PR:
- 大型 Native 空间恢复可用(#321,issue #320)。
- Mnemon Native 在三处读取整个记忆空间:内容列表、图谱,以及运行时记忆满容量归档前的逐字比对。此前每条 Mnemon 命令的输出上限都是 2 MiB,而约 1,000 条记忆的空间会返回 3–9 MB。
- 在 900 条记忆的空间上,内容页显示 0 条记忆,图谱显示“连接不可用”;满容量时添加工作记忆会失败并提示安装 Mnemon,工作记忆因此无法腾出空间。
- 现在这几次整库读取的上限为 128 MiB,其余命令仍为 2 MiB。失败时会写明原因:只有启动失败才提示安装 Mnemon。
- 空闲审查每轮只写一层(#322,issue #319)。
- 空闲审查是唯一无人值守的写入者,此前会把稳定的项目事实和决定写入每轮都会加载的 MEMORY.md,同一轮审查可能把同一知识同时写成项目档案和工作记忆。
- 现在审查先考虑项目档案。MEMORY.md 只收用户明确说过、且项目档案和已有条目都未涵盖的简短规则,例如约定、纠正、环境事实或工具特性;设计、实现细节、路径、端口等项目记录不会进入。
- 审查 guard 让每轮只写一层:建了项目档案后,修改工作记忆会被拒绝;修改工作记忆后,新建项目档案会被拒绝。USER.md 的修改不受影响。
- 分层策略页面的空闲审查中新增写入运行时记忆开关(
idleReview.runtimeMemory,默认开启),关闭后审查只创建项目档案。
- 兜底侧栏入口与 DSH 原生行一致(#323,issue #318)。
- 在没有 DSH 原生面板席位的布局中,Mnemon 会自行插入“记忆系统”入口,而它沿用了旧样式:与 DSH 的行并排时字更小、偏灰,并向右缩进 8px。
- 现在它沿用 DSH 面板行的数值:继承的 14px 主要文字色、相同的内边距、外边距与圆角、16px 图标(折叠时 18px)以及 DSH 的高亮;打开时还会标记
aria-current="page"。有原生席位的布局不受影响。
升级与兼容性
支持的宿主:DSH 0.2.0-rc.2(npm latest 与 next)和 DSH 0.1.7-rc.2。完整 profile 需要 Node ^22.19.0 || >=24.0.0。更早的宿主请继续使用 v0.5.16。
在插件 → 添加插件中安装 dsh-mnemon@0.5.21,然后选择立即启用。也可以使用命令行:
sh
dsh plugin --profile web add dsh-mnemon@0.5.21发布后 24 小时内请带上版本号。pnpm 11 不会选用发布不足一天的版本,在此之前普通安装或更新会得到 0.5.20,两个宿主都接受它。带版本号安装会固定版本,之后可用 dsh plugin --profile web update --latest dsh-mnemon 升级。
- **已有安装:**发布后 24 小时内运行
dsh plugin --profile web add dsh-mnemon@0.5.21,之后dsh plugin --profile web update dsh-mnemon即可(带版本号安装的用update --latest),然后重启 DSH。桌面版在应用的插件页中更新后完全退出并重新打开。 - 空闲审查:已有 profile 在新规则下继续写入运行时记忆;关闭写入运行时记忆可让审查只写项目档案。本版本之前审查写入的 MEMORY.md 条目会保留,直到手动删除。
- **大型空间:**新上限需要新的记忆空间 Source 与 Mnemon Native 同时生效,Starter 已锁定两者;在旧版记忆空间宿主上,Mnemon Native 0.5.8 仍使用 2 MiB 上限。
无需迁移记忆数据或配置。
变更的包
| 包 | 原版本 | 新版本 |
|---|---|---|
dsh-mnemon |
0.5.20 | 0.5.21 |
dsh-mnemon-source-memory-spaces |
0.5.13 | 0.5.14 |
dsh-mnemon-provider-mnemon-native |
0.5.7 | 0.5.8 |
Starter 锁定 17 个组件包,其余 15 个不变。
验证
版本化发布验收在两个受支持的宿主上通过“添加插件”安装发布包。每项修复另有修复前后记录:
发布流程会在创建 GitHub Release 前验证完整的锁定组合、Registry 安装与真实升级。
上一版本:v0.5.20。