前言¶
DeepSeek Harness 默认每次会话都是全新的。这意味着你需要反复解释身份、工作偏好、沟通风格以及已确认的决策。dsh-memory-migration 插件为原生 DSH 提供了长期记忆功能：一个存储“你是谁以及如何工作”的键值对仓库，并在后续对话中根据问题匹配进行召回。
插件定位¶
这是一个由 tieveto666-code 维护的 DeepSeek Harness 插件，旨在解决原生 DSH 无长期记忆的问题。它不修改 DSH 源代码，通过本地存储和 BM25 评分机制实现记忆的持久化与检索。
核心功能¶
- 键值对存储：在本地维护身份、偏好和工作方法的记录。
- 智能召回：基于 BM25 算法，在后续对话中检索与当前问题匹配的条目。匹配逻辑包括包含完整键名或基于内容的语义匹配（需满足特定阈值）。
- 记忆迁移：支持从 ChatGPT、Claude、Gemini 或 DeepSeek 的官方导出（ZIP 或 JSON）中提取核心记忆对。
- 设置界面：提供可视化的键值表、批量操作、搜索以及全局开关。
- 非侵入性：作为树外 Cordis 插件运行，不 fork 或打补丁 DSH 源码。
安装与启用¶
前置条件：需要运行在 Web profile 下，且 Node.js 版本为 22.19+ 或 24+。
安装命令：
dsh plugin --profile web add github:tieveto666-code/dsh-memory-migration
安装完成后，启动 dsh --profile web，在设置中找到 Long-term memory。
典型用法¶
- 保持一致性：在不同会话间保持身份、沟通风格和硬性偏好不变。
- 复用方法论：针对特定任务类别（如代码审查、SQL 撰写）复用既定方法和约束。
- 避免重复讨论：已确认的决策和理由会被记录，新对话中不再需要重复争论。
注意与限制¶
- 数据存储：数据存储在本地
$DSH_HOME/memory-migration/目录下。 - 迁移限制：迁移功能仅提取核心记忆对（最多 10 条），而非完整的对话记录。迁移会过滤掉单次任务结论、日程安排、秘密以及助手的个人观点。
- 隐私：解析、解压、提取和存储均在 DSH 主机上完成，不发送数据到第三方服务，不收集遥测数据。
- 依赖：若使用迁移功能，需确保 DSH 配置了 DeepSeek 模型（用于提取核心对）；若不配置，则仅导入文件中已存在的启用事实。
卸载¶
卸载时，只需移除插件层。删除本地数据目录需手动执行：
dsh plugin --profile web remove @tieveto666-code/dsh-memory-migration
rm -rf $DSH_HOME/memory-migration/
总结¶
该插件通过引入本地持久化记忆，解决了 DSH 每次会话重置的问题，适合需要长期保持人设或工作流一致性的场景。更多细节请参考插件目录或源码仓库。
