DSH 原生记忆 · @zhou05/dsh-memory

版本：1.0.0-dsh021.1。npm 包名为 @zhou05/dsh-memory，数据格式仍为 v2，目标为 DSH Desktop 0.2.0-rc.2 和 0.2.1-rc.2 / Node.js 24+。本次更新修正宿主兼容声明，保留既有记忆实现、数据路径及配置 ID，不新增迁移。这是 zhou05 维护的定制记忆重写版，不是上游作者或 DeepSeek 官方发布的版本；不代表已验证其他 DSH 版本。

安装前先知道

首次启用默认开启自动整理和记忆召回。 对话完成后会使用该会话的模型整理脱敏后的新增片段及相关记忆，产生额外模型用量。需要时在侧栏“记忆 → 记忆设置”暂停；已有 v2 数据库的设置保持原样，不会被包中的默认值覆盖。详见 PRIVACY.md。

这个包只含插件程序和说明，不含任何人的记忆、聊天、账号、API Key、profile 或数据库。不读取启用前的全部聊天历史，不需要外部向量数据库，也不附带模型。

安装 / 升级

1. 在 DSH“插件 → 添加插件”中填写 @zhou05/[email protected]；是否公开可安装以 npm 注册表为准。离线分发时，可填写 zhou05-dsh-memory-1.0.0-dsh021.1.tgz 的完整绝对路径，或 file: 加完整绝对路径。
2. 已安装同名包时更新同一项；若宿主拒绝覆盖安装，备份数据和配置后卸载旧版，再安装新版。如果已装旧名 dsh-auto-memory，先备份数据和配置，再停用或移除旧包；不要同时启用两者。新包名不会自动替换旧包。 具体顺序见 UPGRADE.md。若宿主提示重启，先让对话结束，再正常退出并打开 DSH。
3. 侧栏“记忆”中可以查看内容、来源、修订历史和整理状态。

当前 SQLite v2 用户升级前请先关闭 DSH 并备份记忆目录；继续使用同一个 DSH_HOME 和 memoryDir。更早的 Markdown 版不自动迁移，不能把非空旧库视作已升级。具体见 UPGRADE.md。

本包无安装生命周期脚本，不修改 DSH 主程序，不绑定外观、人设、桌宠或其他记忆系统。

可以做什么

• 自动提炼稳定偏好、项目决定、参考资料与近期进展；整理后直接生效。
• 区分通用记忆与项目记忆，后者只用于对应项目；项目身份使用规范化目录路径。
• 中文关键词检索、相关性召回和有字节上限的上下文注入。
• 查看来源和版本；人工修订、归档、撤回、恢复旧版都保留历史。
• 人工修订不会被后台结果覆盖；过时版本的并发修改会被拒绝。
• 助手自述只形成标明“助手报告”的近期记录，不冒充用户确认或独立执行证据。
• 查看整理失败、重试及最近提供给模型的记忆。提供给上下文不等于模型一定使用了它。

默认值

项目	新库默认值
自动整理 / 自动召回	开启 / 开启
每日整理调用上限	24 次
每日整理 Token 预算	100,000，含在途保守预留
单次注入预算	6,000 UTF-8 字节，不是 Token 数
新生成近期经历有效期	从来源发生时间起 30 天

预算只限制后台整理，不是整个 DSH 账号的消费限额。供应方未返回完整用量时采用保守估计。达到预算时排队等待；单条输入已超预算时显示失败并等待调整/重试。

数据位置和备份

默认位于宿主的 DSH_HOME/memory/memory-v2.sqlite，而不是插件安装目录。可用 profile 的 auto-memory 配置项 memoryDir 指向自选目录；改变路径需要正常重启。改变目录不会自动迁移数据。

备份请正常关闭所有使用该目录的 DSH 实例后，复制整个记忆目录，包括存在的 -wal、-shm 文件。不要在运行时只复制主数据库。数据库、完整目录备份与手动导出都可能含敏感个人内容。

“导出”包含每条记忆当前保存状态（也可能含归档/撤回项），不包含来源原文和完整修订历史。它不是完整备份，本版也没有 JSON 导入功能。

暂停 / 撤回 / 卸载

暂停自动整理会停止后台提炼，但显式的记忆工具写入仍可能发生；如要让某个会话既不记录也不使用记忆，请关闭“本次会话参与记忆”。关闭自动召回保留数据，仍可在界面查看。

归档、撤回和过期项不参与普通召回。“撤回”不是物理删除，原文、版本和撤回保护仍留在本机。卸载插件也不清空数据库，不删除原聊天。若需要物理擦除，请先另行确认范围；本包不提供自动清库或跨目录删除脚本。

已验证与限制

本次重新验证打包、隔离数据库、原生工具/提示词/API 路径与保留已有 v2 数据的升级加载；详见完整 ZIP 中的 VERIFICATION.md。真实模型长期整理质量仍未完成完整验收，来源匹配也不等于语义判断必然正确。

只对上述两个 DSH 版本作已测试说明；不宣称已通过其他版本、macOS/Linux 桌面或不同模型供应方的验收。上游改动和许可证说明见 NOTICE.md、LICENSE。