长期记忆库 krutziy/dsh-memory

dsh-memory — DSH 长期记忆插件

DeepSeek Harness (DSH) 的持久化长期记忆插件： 多套 OpenAI 兼容云端嵌入服务商 + Qdrant 向量库，自动记录对话要点、自动召回相关记忆，并提供 memory_search / memory_save / memory_forget 工具与完整的设置页 GUI。

纯 JavaScript，无构建依赖（Host 半用 build.mjs 拼成单文件），唯一运行时依赖是 DSH 自带的 @deepseek-ai/schemastery。

概览

功能

- 多服务商配置档：可保存多套云端服务商配置并随时切换激活项，不再绑定硅基流动。
内置预设：硅基流动、OpenAI、阿里云百炼（DashScope 兼容模式）、智谱 BigModel、火山方舟 Ark、 Jina AI、Voyage AI、自定义 OpenAI 兼容服务。
每个服务商独立配置：Base URL、嵌入模型、向量维度、Key 引用名、是否发送 dimensions、视觉模型（用于图片概览）、视觉接口 Base URL / Key 引用名。
- 设置页直接填 API Key：Key 写入 DSH 凭据库（~/.dsh/.credentials.yaml），不写进插件配置文件，也不会回传到浏览器；支持按服务商设置/清除、状态徽标。
- 自动记录：每轮对话结束后，把「用户要点 + 助手回答要点」写入 Qdrant（不额外调用大模型）；可按 captureMinChars 过滤“好的/谢谢”之类噪音。
- 图片记忆：用户发图时调用服务商的视觉模型生成一句话概览，只存这句话 + 向量， 永不保存原图；也支持只记占位或完全忽略图片。
- 自动召回：每轮第一步检索相关历史记忆，以 source=long-term-memory 的上下文行注入（DSH 会渲染为“上下文注入”，不是用户气泡）；可配置条数、最低相关度、字符上限、超时、是否包含当前会话。
- 记忆范围：global 全局共享 / workspace 按工作目录隔离 / session 按会话隔离。
- 记忆管理：设置页里语义搜索、按时间浏览、手动添加、删除、导出 JSON、重建集合。
- 定期维护：按间隔自动执行（也可点「立即维护」）：清理超过保留天数的记忆、淘汰超出条数上限的最旧记忆、合并高度相似的重复记忆、重建 payload 索引。
- 睡眠整理 / 记忆巩固（可开关）：默认每天 00:00（按所选时区）检查，最近 1 小时无人类消息且无运行中会话才“睡觉”；原始记忆按天压缩成批次（随机 5 位编号 + 任务列表），之后按 7/30 天逐级继续压缩，默认不限制每级保留条数，由整理模型按内容重要性决定；可选开关才会启用内部上限（L1 40 / L2 20 / L3 10 条）。删除原文只保留整理产物；睡眠期间用户发消息会收到 zzzZZ，醒后自动继续处理；支持手动立即整理与整理历史。
- 直接复用 DSH 模型（v0.6，推荐）：独立「模型列表」页直接读取 DSH「设置 → 模型」里已配置的供应商与模型，为「记忆整理」「图片概览」等功能选择模型即可（Key 由 DSH 统一管理，无需重复填写）；也可切到自定义服务商作为回退。
嵌入模型 DSH 未提供 embedding 接口，仍由插件自己的服务商配置（用于 Qdrant 向量维度）。
- 实验功能（默认关闭）：①跨天相似事件合并（只把相关小簇交给模型，不塞整库）；②增强记忆（1 级产物保留若干天，仅事件/按需召回，到期删除）。
- 时间与时区（v0.3）：时间戳按 epoch 存储，显示时使用你选择的时区（默认跟随服务器本地）。
自动召回上下文会附带「当前时间（含时区）」与每条记忆的相对时间（如“3 天前”），方便模型判断新旧；记忆管理页支持按「今天 / 近 7 天 / 近 30 天」筛选。
- 模型工具：memory_search / memory_save / memory_forget，可在设置页一键禁用；写入前自动脱敏（sk-…、Bearer …、api_key: …、password: … 等）。

| 服务商配置档 | 记忆管理 |
| Provider | 记忆管理 |

安装

方式一：从 GitHub 安装（推荐）

dsh plugin --profile web add github:krutziy/dsh-memory

装好后刷新浏览器页面，进入 设置 → 长期记忆 配置服务商与 API Key。

方式二：本地目录安装（开发）

dsh plugin --profile web add /absolute/path/to/dsh-memory

新装插件通常由 DSH 的 HMR 直接激活；浏览器端设置页需要刷新一次页面。

配置说明

设置页分为五个 Tab：

概览

显示当前激活服务商、API Key 状态、Qdrant 连接与版本、集合条数/维度、记忆范围、工具开关、最近写入/召回、最近维护结果、后台队列。

模型与向量库

| 配置 | 说明 |
| 服务商配置档 | 多套服务商配置，选择一个「当前激活」。切换后新写入/检索立即使用新服务商 |
| Base URL | 需支持 OpenAI 兼容的 POST /embeddings（以及视觉概览用的 /chat/completions） |
| 嵌入模型 | 该服务商的 embedding 模型名 |
| 向量维度 | 必须与模型实际输出一致，并与 Qdrant 集合一致；改维度后需「重建集合」 |
| Key 引用名 | 凭据在 DSH 凭据库中的引用名，留空默认 <ID>_API_KEY；设置页下方直接填 Key |
| 视觉模型 | 图片概览使用的多模态模型；留空则图片只记占位 |
| 发送 dimensions | 部分服务不支持 dimensions 参数时关闭 |
| Qdrant 地址/集合 | 默认 http://127.0.0.1:6333 / dsh_memory；Qdrant 有鉴权时填 Key 引用名 |

记忆行为

记忆范围、自动记录/召回开关、召回条数/相关度/字符上限/超时、图片记忆方式与提示词、工具开关与默认条数。

时间与时区

| 配置 | 默认 | 说明 |
| 时区 | 跟随服务器本地 | 记忆显示时间、相对时间、召回上下文里的「当前时间」都按该时区；提供常见 IANA 时区下拉，也支持填自定义 IANA 名称 |
| 召回时附带当前时间 | 开 | 自动召回时在上下文里写明当前时间（含时区），便于模型判断记忆新旧 |
| 显示相对时间 | 开 | 在召回内容与记忆列表中显示「3 小时前 / 2 天前」 |

时间与时区

模型列表与功能模型分配

模型列表

- 「模型列表」页直接读取 DSH「设置 → 模型」 里已配置的服务商与模型（例如 deepseek-official / deepseek-flash），不需要在本插件里重复填 Key；DSH 默认模型会显示出来，留空即跟随默认模型。
- 「功能模型分配」为 记忆整理、图片概览 分别选择模型：
- 默认来源 DSH 模型：直接用 DSH 已配置的模型（图片概览需选择声明支持图片输入的模型）；
- 也可切换为 自定义 provider：使用本插件「模型与向量库」里的 provider 与 Key 作为回退。
- 嵌入模型 无法从 DSH 读取（DSH 只提供对话/图片 LLM，没有 embedding 接口），仍由插件自己的 provider 配置决定，并决定 Qdrant 集合维度。
- 「限制每级整理条数」开关默认关闭；关闭时保留条数由整理模型自行决定，开启后才套用内部上限 40/20/10。

睡眠整理与清理维护

睡眠整理设置

整理任务与睡眠状态

- 任务列表：每个整理批次随机分配一个 5 位编号，任务列表保存在 $DSH_HOME/storages/dsh-memory/consolidation.json；编号只要求「待处理/处理中」批次唯一，批次完成后编号可回收复用。
- 压缩链：原始记忆（L0）按天压缩为 L1 批次 → 7 天后压缩为 L2 → 30 天后压缩为 L3；默认不限制每级保留条数（由整理模型按内容重要性决定，可选开关启用 40/20/10 上限），原文在整理成功后删除（失败/超时会保留原文下次重试）。
- 睡眠状态：设置页与记忆管理页可查看「待机中/睡觉整理中」、待处理批次、最近整理与历史；支持手动「立即整理」。
- 整理模型：在「模型列表 → 功能模型分配」里选择 provider 与模型（默认 Qwen/Qwen2.5-7B-Instruct），模型不可用时自动回退纯规则压缩。

记忆管理

记忆列表（语义搜索/时间筛选/分页/删除）、手动添加、导出 JSON、定期维护与保留策略、重建集合。

高级

记录时的用户/助手内容截断字符、最短记录字符、是否记录子代理会话、调试日志。

数据与安全

- Qdrant 中每条记忆只包含：脱敏后的文本要点、类型、时间、会话 id、工作目录、provider、向量。
图片只保留概览与宽高/格式，不保存图片字节。
- API Key 保存在 ~/.dsh/.credentials.yaml（refs 映射），不进入插件配置/profile patch。
- DSH 自己的会话日志本来就会保存聊天图片附件，这与本插件无关。
- 建议 Qdrant 只监听 127.0.0.1；如需远程访问请配置 API Key 与安全组，不要直接暴露公网。
- 插件不会回填历史会话；从安装后开始记录。

开发与热重载

- 源码：src/index.js（Host 入口）、src/lib/*.js（各模块）；client.js 是浏览器设置页（单文件，无构建）。
- DSH 的 HMR 在 Node 26 下只刷新入口模块，因此 Host 半用构建脚本拼成无本地 import 的单文件 index.js：

node build.mjs

写回 index.js 后，若 profile 里开启了 HMR 模块监听，会自动重载插件，无需重启 dsh：在 ~/.dsh/profiles/web/cordis.patch.yml 里加入：

- id: hmr
name: "@deepseek-ai/dsh-hmr"
config:
base: "/"
root:
- home/ubuntu/mem/dsh-memory

修改 client.js 后刷新浏览器一次即可。

本地 HTTP 接口（设置页同源，仅供排查/扩展）

| 方法 | 路径 | 说明 |
| GET | /__dsh_memory__/status | 运行状态 |
| GET | /__dsh_memory__/memories?q=&limit=&offset=&kind= | 记忆列表/语义搜索 |
| GET | /__dsh_memory__/export | 导出全部记忆 JSON |
| POST | /__dsh_memory__/test | 测试激活 provider（可带 {providerId}） |
| POST | /__dsh_memory__/memories | 手动添加 {text,kind,tags} |
| POST | /__dsh_memory__/memories/delete | 删除 {ids:[...]} |
| POST | /__dsh_memory__/recreate | 重建集合 {confirm:"DELETE"} |
| POST | /__dsh_memory__/maintenance | 立即维护 |

POST 需要请求头 x-dsh-memory: 1。

测试连接

测试连接

已知限制

- 嵌入维度与 Qdrant 集合绑定：切换维度不同的 provider 前需要「重建集合」（会清空记忆）。
- 自动召回每轮会多发一次嵌入请求（约 100–300ms；超时可配置，超时自动跳过）。
- 召回内容会作为 source=long-term-memory 的上下文消息写入会话日志（DSH 要求模型可见内容可回放）。
- 图片概览依赖服务商的视觉模型；未配置时自动降级为占位记录。
- 受 DSH HMR 限制，Host 代码改动需先跑 node build.mjs 重新生成 index.js 才生效。
- 时间显示基于记录里的 epoch 时间戳。切换时区只影响显示，以及「今天/近 7 天」这类自然日边界，不改动已存数据。

更新记录

- v0.6.0：①「模型列表」直接读取 DSH 已配置的服务商与模型（ctx.llm），记忆整理/图片概览默认使用 DSH 模型（Key 由 DSH 管理），支持切自定义 provider 回退；嵌入模型仍由插件 provider 配置（DSH 无 embedding 接口）。
②整理输出条数上限改为可选开关（默认关，由模型决定；开启后 40/20/10）。
③Tab 布局重排：概览 / 模型列表 / 记忆行为 / 记忆管理 / 模型与向量库 / 高级，实验功能折叠显示；整理产物使用批次内唯一 ID，修复极端情况下「新摘要与原文同文被一起删除」的边界 bug。

- v0.5.0：①整理级别参数简化——不再暴露比例/条数等细节，保留多少条由整理模型按重要性决定（内部安全上限，7/30 天节奏固定）； ②新增独立「模型列表」页：各 provider 的 API Key、一键拉取模型列表、为图片概览/记忆整理分别选择 provider+模型； ③修复「设置版本冲突」——保存改用 ConfigForm 最新 revision，冲突时自动恢复重试，不再需要刷新页面。

- v0.4.0：睡眠整理/记忆巩固 —— 可开关；默认 00:00（时区可配）每 15 分钟重试直到空闲才睡；原始记忆按天压缩为 5 位随机编号批次，任务列表按 7/30 天调度后续压缩（100→约 20→约 5），删除原文；睡眠期间回 zzzZZ 并排队、醒后自动继续；整理模型 provider+模型名可配；手动立即整理、整理历史与层级筛选；实验：跨天事件合并、增强记忆（默认关闭）。适配 DSH 0.2.1（timer / api-session activity / agents / followup）。

- v0.3.1：修复自动召回失效 —— 插件 inject 名单缺少 sessions 服务，导致召回阶段读取会话上下文报错（cannot get property "sessions" without inject）而被静默跳过；已补上并热重载验证：新会话可正常召回、lastRecallError 为空、召回内容带当前时间与相对时间。
- v0.3.0：时区与时间感知（时区选择 / 相对时间 / 召回附带当前时间 / 时间范围筛选）。
- v0.2.0：多 provider 档案管理、记忆管理界面、记忆范围、定期维护。
- v0.1.0：首个可用版本（硅基流动 + Qdrant，自动记录/召回与记忆工具）。