前言¶
DeepSeek Harness（DSH）里换工作区或新开一轮会话后，模型默认只能依赖当前上下文。偏好、项目进度、技术栈约定和上一段对话里的结论，往往要用户重复说明，或靠手工粘贴笔记。社区里也有让主模型每 N 轮停下来写「记忆卡」的做法，会打断主对话、重复消耗 Token，还容易把最近几句流水账当成「记忆」。
下面介绍 dsh-supermemory（维护者 fish9988，分类：记忆）。它是 DSH 的跨会话长期记忆插件，底层由 Supermemory 提供存储与检索；实现为纯 JavaScript，无额外子进程依赖，并自带可视化记忆库管理页。DSH 生态主张「一切皆插件」；插件目录站点 skillhub.cn 为社区独立收录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-supermemory 在 DSH 中为各模型提供跨会话、跨工作区的长期记忆：按需语义召回、后台自动从对话中提炼事实、写入前双层去重，以及左侧栏内的配置与浏览界面。使用前需配置 Supermemory API Key（Supermemory 免费账户每月提供 5 美元 API 额度，按月重置；README 中说明日常高强度使用一个月量级消耗约 1 美元，具体以官方计费为准）。
当前 package 版本为 0.1.4，许可证 MIT。
核心功能¶
按需语义召回¶
在 agent/pre-step 阶段，用本轮用户提问做向量语义检索，并与历史对话切片混合检索。README 说明仅对主 Agent 生效，子代理（Subagent）不召回、不写入，避免污染主会话记忆。
为省 Token 并尽量保持 KV Cache，插件会过滤「好的 / 继续 / 谢谢 / 你好」等短寒暄，不对无意义短句发起检索；用户画像中的永久核心条目（static）在每个会话首轮召回时注入一次，同会话内已注入条目会去重。
后台自动蒸馏¶
用户停止对话 90 秒（可调）后，后台用配置的模型从增量对话中提炼 add / update / delete 类事实，无需主模型每轮手工整理。若退出前未完成整理，下次启动会补齐。这与 README 中「Mem0 式」无感整理描述一致。
双层去重¶
写入前先进行中文字符二元组（Bigram）比对，再按 Supermemory 向量相似度比对（阈值 0.83）。同一事实换说法尽量不重复入库；新说法更具体时（例如截止日期变更）可原地更新旧记忆。
中文与时间检索¶
自动为条目附加中英双语释义（| EN: …，展示时剥离）；带「最近 / 上周」等时间词的查询会走「原句 + 剥离时间词」双路并行检索并合并，缓解纯 CJK 检索与时间词导致结果被空滤的问题。
可视化记忆管理页¶
集成在 DSH 左侧栏 「插件 → Supermemory 长期记忆」：在线保存 API Key（写入 DSH 凭据库）、浏览 / 搜索 / 增删改记忆、查看用户画像、「试一试」预览召回、查看最近活动与耗时。
模型工具与自然语言控制¶
配置完成后，日常以自动召回与后台整理为主。模型还可通过三个工具主动操作：
memory_save：例如要求记住截止日期或技术栈偏好；memory_search：针对历史事实做精确检索；memory_forget：查 ID 后软删除指定记忆。
召回结果在轨迹（Trajectory）中以折叠块形式展示，例如 Supermemory：召回画像 X 条、记忆 Y 条，不挤占主聊天区排版。
安装与启用¶
安装前建议阅读 GitHub 仓库 源码与 LICENSE。插件以当前 DSH 进程权限运行，API Key 与对话片段会发往 Supermemory 云服务，请自行评估隐私与合规需求。
图形界面（推荐）¶
- 打开 DSH 左侧栏 「插件 (Plugins)」 → 右上角 「添加插件 (Add plugin)」。
- 在输入框粘贴以下任一地址并安装：
github:fish9988/dsh-supermemory
或 Release 压缩包：
https://github.com/fish9988/dsh-supermemory/releases/download/v0.1.4/dsh-supermemory-0.1.4.tgz
命令行¶
桌面端（desktop profile）：
dsh plugin --profile desktop add github:fish9988/dsh-supermemory
网页端（web profile）：
dsh plugin --profile web add github:fish9988/dsh-supermemory
API Key¶
- 在 Supermemory 控制台 注册并创建 API Key（格式以
sm_开头）。 - 在 DSH 「插件 → Supermemory 长期记忆」 顶部粘贴 Key，点击 「保存 Key」。
- 状态栏显示已连接即表示验证通过。Key 保存在 DSH 凭据服务（
SUPERMEMORY_API_KEY），README 说明不会写入普通配置文件或日志。
典型用法与设置要点¶
配置 Key 后，发送有实质内容的新消息时会按设置自动召回；停止对话满静默间隔后会自动整理。若需省 Supermemory 额度，可在设置中关闭 「保存对话原文」（captureConversations），仅保留提炼后的单句记忆与画像；README 称此举可显著降低以 superrag 切片上传为主的消耗。
常用配置项（默认值见 README 表格）包括：
| 方向 | 配置项 | 说明摘要 |
|---|---|---|
| 召回 | autoRecall |
有意义新消息时自动检索并注入 |
| 召回 | recallProfile / recallChunks |
是否附带静态画像、历史会话片段 |
| 召回 | recallLimit / recallThreshold |
默认 6 条 / 60% 相关度门槛 |
| 整理 | captureConversations |
轮次结束后防抖上传对话片段 |
| 整理 | modelExtraction |
静默后用模型提炼事实 |
| 整理 | extractProvider / extractModel |
指定后台提炼模型 |
| 范围 | scope |
global 或按工作区 workspace |
| 隐私 | excludeWorkspaces |
匹配路径的工作区不召回、不上传、不整理 |
上传、提取、工具保存及注入上下文前，README 说明会对 sk-、sm_、ghp_ 等敏感模式做脱敏；召回内容包在 <supermemory> 参考块内并做注入边界防护。网络或额度异常时采用 fail-open，主对话仍可继续。
适用场景与注意¶
适合需要 跨会话记住偏好与项目事实、又不想每轮手工维护记忆卡的 DSH 用户。依赖 Supermemory 在线服务，需自行保管 API Key 并关注额度与数据出境策略。
不适合希望在完全离线、零第三方云存储下运行的场景；也不应在未审阅源码的情况下 blindly 安装到处理高度敏感代码或凭据的环境。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/fish9988/dsh-supermemory
- 源码与完整说明：https://github.com/fish9988/dsh-supermemory
