@zhou05/dsh-memory 1.0.0-dsh020.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AskTheWay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,9 @@
+# 来源与版本说明
+
+本包基于 AskTheWay/dsh-auto-memory 的既有插件结构和后续的记忆 v2 重写实现，由 zhou05 维护本定制分发包。保留上游 MIT License 与 `Copyright (c) 2026 AskTheWay` 声明。原上游仓库：https://github.com/AskTheWay/dsh-auto-memory
+
+本地重写改为 SQLite 来源/版本存储、自动整理队列、项目隔离、受预算约束的召回和原生管理界面。此次整理只将当前有效实现独立成包，去掉未使用的旧版实现和失效的开发/声明入口，整理构建流程与说明；没有把旧版 Markdown 数据自动转换为 v2。
+
+`@zhou05/dsh-memory@1.0.0-dsh020.1` 是**独立命名空间下的定制分发版本**，不是上游作者或 DeepSeek 官方发布的版本，不代表官方背书。相较旧本地包，本次对齐 npm 包名、插件解析入口与前端模块 ID；保留配置项 ID、数据位置及 v2 格式。实际是否已公开发布以 npm 注册表为准，生成本地安装包本身不会上传。
+
+宿主提供 React、Cordis、Schemastery 与 DSH SDK；本包不附带 DSH 程序或 Node.js，也不附带账号、记忆或聊天数据。依赖各自遵循其许可证。

package/PRIVACY.md

@@ -0,0 +1,37 @@
+# 数据、模型调用与权限边界
+
+## 安装包里没有用户数据
+
+安装包采用固定文件白名单：两份程序产物、插件声明、包元数据、许可证与说明。不包括数据库、数据库 WAL/SHM、聊天、来源片段、使用记录、账号凭据、实际 profile、备份或验收数据。
+
+## 启用后会保存什么
+
+插件在本地 SQLite 中保存启用后的用户消息/可见助手正文片段、提炼的记忆、来源关系、修订快照、撤回保护、整理队列、预算用量，以及最近召回记录。片段长度有上限，不能把它当成完整聊天备份。
+
+不会批量导入原有聊天，也不采集隐藏推理、工具输出或子代理对话。原有 DSH 聊天文件与本插件数据库是两套独立存储。
+
+## 什么会发给模型
+
+默认的后台整理会调用该会话所选的模型。输入含脱敏后的新增对话片段、关联已有记忆和来源元数据。后续聊天也会向模型提供被召回的记忆背景，因此“保存在本地”**不等于“内容从不发送给模型服务”**。
+
+整理使用既有 DSH 模型连接，没有独立 API Key 字段，也不把账号配置复制到插件中。模型用量会产生费用。只给后台整理设置预算，不会限制普通聊天成本。
+
+## 脱敏的限度
+
+采集会隐藏常见 API Key、令牌、密码字段和私钥模式；这不是完整的个人信息检测。没有匹配到这些模式的姓名、项目内容、敏感业务信息仍可能保存在片段中并被发送给模型。敏感会话应关闭参与记忆，不能依赖自动脱敏兜底。
+
+SQLite 文件不是加密保险库。能够读取该文件、其备份或导出的本地用户/进程可能看到内容；请使用操作系统权限保护和自己认可的备份方式。本插件不改变系统安全设置。
+
+## 控制方式
+
+- 关闭“自动整理”：停止后台提炼，保留已有记录；明确请求记忆工具写入仍可生效。
+- 关闭“在对话中使用记忆”：停止自动上下文注入，保留内容；不等于停用全部显式工具读取。
+- 关闭“本次会话参与记忆”：本次会话不采集、不召回，也不能使用记忆工具。
+- 归档 / 撤回：停止普通召回，但保留历史、证据和保护信息；不是物理删除。
+- 卸载：停止插件服务与自动整理，但保留数据目录和原聊天。
+
+本版不提供一键物理清库。数据库中历史来源不会仅因对应记忆过期自动擦除。如果需要彻底删除，需正常退出相关 DSH 并明确处理数据库、备份、导出及原聊天的各自范围。
+
+## 信任范围
+
+记忆只是背景数据，不代表新的执行、发布、付费、跨项目访问或提权授权。来源 ID 和逐字引文核验只能证明内容有所引据，不能证明归纳准确或事件客观发生。助手报告与用户陈述均会注明类别，不应被当成独立事实核验结果。

package/README.md

@@ -0,0 +1,61 @@
+# DSH 原生记忆 · @zhou05/dsh-memory
+
+版本：`1.0.0-dsh020.1`。npm 包名为 `@zhou05/dsh-memory`，数据格式仍为 v2，目标为 **DSH Desktop 0.2.0-rc.2 / Node.js 24+**。这是 zhou05 维护的定制记忆重写版，不是上游作者或 DeepSeek 官方发布的版本。版本后缀标识当前兼容目标，不代表已验证其他 DSH 版本。
+
+## 安装前先知道
+
+**首次启用默认开启自动整理和记忆召回。** 对话完成后会使用该会话的模型整理脱敏后的新增片段及相关记忆，产生额外模型用量。需要时在侧栏“记忆 → 记忆设置”暂停；已有 v2 数据库的设置保持原样，不会被包中的默认值覆盖。详见 [PRIVACY.md](PRIVACY.md)。
+
+这个包只含插件程序和说明，**不含任何人的记忆、聊天、账号、API Key、profile 或数据库**。不读取启用前的全部聊天历史，不需要外部向量数据库，也不附带模型。
+
+## 安装 / 升级
+
+1. npm 正式发布后，在 DSH“插件 → 添加插件”中填写 `@zhou05/dsh-memory` 并安装。发布前或离线分发时，可填写 `zhou05-dsh-memory-1.0.0-dsh020.1.tgz` 的完整绝对路径，或 `file:` 加完整绝对路径。
+2. 已安装同名包时更新同一项。**如果已装旧名 `dsh-auto-memory`，先备份数据和配置，再停用或移除旧包；不要同时启用两者。新包名不会自动替换旧包。** 具体顺序见 [UPGRADE.md](UPGRADE.md)。若宿主提示重启，先让对话结束，再正常退出并打开 DSH。
+3. 侧栏“记忆”中可以查看内容、来源、修订历史和整理状态。
+
+当前 SQLite v2 用户升级前请先关闭 DSH 并备份记忆目录；继续使用同一个 `DSH_HOME` 和 `memoryDir`。更早的 Markdown 版不自动迁移，**不能把非空旧库视作已升级**。具体见 [UPGRADE.md](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](NOTICE.md)、[LICENSE](LICENSE)。

package/UPGRADE.md

@@ -0,0 +1,38 @@
+# 升级、保留数据与回滚
+
+本包的 npm 包名改为 `@zhou05/dsh-memory`，保留 `auto-memory` 配置项 ID、侧栏入口、API 路径及 v2 数据库格式。它没有随包数据库，也没有安装脚本、后台迁移器或清理用户数据的卸载钩子。
+
+**包名变更不是同名更新。** `dsh-auto-memory` 和 `@zhou05/dsh-memory` 不应同时启用：它们提供相同的工具、接口和界面，可能重复写入同一个数据库。不要依赖安装顺序解决冲突。
+
+## 已在使用 SQLite v2（当前本地重写版）
+
+1. 确认实际 `DSH_HOME`，以及 profile 是否覆盖了 `auto-memory.config.memoryDir`；不要猜路径。
+2. 完成本轮对话并正常退出所有共享该记忆目录的 DSH。备份整个记忆目录，同时保留旧插件包及 profile 配置备份。
+3. 若旧包名是 `dsh-auto-memory`，重新打开 DSH，先在插件管理器停用或移除旧包；按提示完成重启，确认旧包不再启用。卸载本插件程序不会主动清理记忆目录，但仍应先完成备份。
+4. 安装 `@zhou05/dsh-memory`（尚未发布时用新 `.tgz`），确认启用列表中只剩一个记忆实现。若本来就使用 `@zhou05/dsh-memory`，只更新该项。
+5. 保持原 `DSH_HOME` 与 `memoryDir` 不变；对照备份核对自定义配置未丢失。新版继续打开原 `memory-v2.sqlite`，已有设置、来源、版本和撤回记录保留。
+6. 按提示重开 DSH，在记忆页面核对几项已有内容、来源与版本及原有开关，再恢复使用。
+
+更换插件安装目录不应影响记忆路径。若看到空库，先检查实际数据目录，不要马上导入、清库或覆盖备份。插件不会因为新包的默认设置开启了某个选项，就覆盖已有库的关闭设置。
+
+## 旧 Markdown 版（如上游 0.3.x）
+
+**本包不自动导入旧 Markdown 记忆，也不扫描全部历史聊天。** 旧文件不会被删除，但不能把“文件还在”当成“已在新版里生效”。
+
+如果旧库非空，先备份并单独制定迁移/核对方案，不要直接把该版本当成无缝替换。旧版仍能使用的资料可以继续在旧版查看；本次整理包不附送未经确认的批量导入功能。
+
+## 换电脑 / 数据目录
+
+关闭相关 DSH 后复制整个记忆目录到新位置，再配置目标 `memoryDir`，最后核对。不要在运行时同步 SQLite 主文件或把不同机器的文件直接覆盖合并。
+
+项目记忆按规范化项目路径绑定。若另一台机器盘符/路径不同，原项目记忆不会自动绑定到新目录；通用记忆与项目记忆也不会自动转换。本版不提供项目路径重映射或多库合并工具。
+
+## 回滚
+
+关闭 DSH，保留升级后产生的数据副本，再通过插件管理恢复之前的插件包与对应配置。只有确认数据格式相容时才复用数据库；不能用旧版程序强行打开更新格式。本版拒绝已标记为更高 schema 版本的数据库。
+
+若决定恢复升级前的数据备份，应清楚这会回到那个时间点；先另存升级后的完整目录，避免丢失新增内容。不要在应用运行中覆盖数据库，也不要将插件目录和数据目录混为一谈。
+
+## 验证口径
+
+本地打包验收使用独立的合成数据，核对旧 v2 实现写入后由解包的新版本加载时，记忆正文、修订历史、撤回和设置保持不变。这不代表任意来源/任意旧版本的数据都已经迁移成功。真实数据仍需要你在自己的页面中核对。

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# @zhou05/dsh-memory 组合包贡献的配置层。
+# insert 行的 name 在已安装形态必须是 npm 包名(Node 模块解析);
+# config 省略,全部走插件 schema 默认值(用户经 profile patch 按 id 整表覆盖)。
+- insert:
+    - id: auto-memory
+      name: '@zhou05/dsh-memory'