dsh-memory

dsh-memory — DSH 长期记忆插件

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

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

功能

• 多 provider 档案：可保存多套云端服务商配置并随时切换激活项，不再绑定硅基流动。 内置预设：硅基流动、OpenAI、阿里云百炼（DashScope 兼容模式）、智谱 BigModel、火山方舟 Ark、 Jina AI、Voyage AI、自定义 OpenAI 兼容服务。 每个 provider 独立配置：Base URL、嵌入模型、向量维度、Key 引用名、是否发送 dimensions、 视觉模型（用于图片概览）、视觉接口 Base URL / Key 引用名。

• 设置页直接填 API Key：Key 写入 DSH 凭据库（~/.dsh/.credentials.yaml）， 不写进插件配置文件，也不会回传到浏览器；支持按 provider 设置/清除、状态徽标。

• 自动记录：每轮对话结束后，把「用户要点 + 助手回答要点」写入 Qdrant（不额外调用大模型）； 可按 captureMinChars 过滤“好的/谢谢”之类噪音。

• 图片记忆：用户发图时调用 provider 的视觉模型生成一句话概览，只存这句话 + 向量， 永不保存原图；也支持只记占位或完全忽略图片。

• 自动召回：每轮第一步检索相关历史记忆，以 source=long-term-memory 的上下文行注入 （DSH 会渲染为“上下文注入”，不是用户气泡）；可配置条数、最低相关度、字符上限、超时，并默认跳过最近 10 分钟自动记录的对话（避免重复注入）。

• 记忆片段与整理队列（v0.8）：会话是一次经历，不是记忆的容器；同一次会话在同一天留下的小片段会挂上临时编号，睡觉时合并成事件片段； 一周后合并成周片段，一个月后合并成长期片段。编号只在“等待整理”期间存在，固化后回收；记忆里不再保留会话 id / 工作目录。

• 记忆管理：设置页里语义搜索、按时间浏览、手动添加、删除、导出 JSON、重建集合，以及查看整理队列。

• 定期维护：按间隔自动执行（也可点「立即维护」）： 清理超过保留天数的记忆、淘汰超出条数上限的最旧记忆、合并高度相似的重复记忆、重建 payload 索引。

• 睡眠整理 / 记忆巩固（可开关）：默认每天 00:00（按所选时区）检查，最近 1 小时无人类消息且无运行中会话才“睡觉”； 按会话把当天的片段合并成事件片段，周末后第 7 天把一周的事件片段合并成周片段，月末后第 30 天再合并成长期片段（后两层为多对一合并）； 默认不限制每级保留条数，由整理模型按内容重要性决定（可选开关启用内部上限 40/20/10）。失败按批重试，不阻塞其他批； 睡眠期间用户发消息会收到 zzzZZ，醒后自动继续处理；支持手动立即整理与整理历史。

• 直接复用 DSH 模型（v0.6，推荐）：独立「模型列表」页直接读取 DSH「设置 → 模型」里已配置的供应商与模型， 为「记忆整理」「图片概览」等功能选择模型即可（Key 由 DSH 统一管理，无需重复填写）；也可切到自定义 provider 作为回退。 嵌入模型 DSH 未提供 embedding 接口，仍由插件自己的 provider 配置（用于 Qdrant 向量维度）。

• 实验功能（默认关闭）：①跨天相似事件合并（只把相关小簇交给模型，不塞整库）；②增强记忆（1 级产物保留若干天，仅事件/按需召回，到期删除）。

• 动态相关度召回（v0.7，实验，可一键回退）：仿人脑回忆——记忆越久，要求的相关度越高（分层遗忘 τ：原始 7 天/事件片段 30 天/周片段 180 天/长期片段 365 天）； 重要性、有效复述、置信度可以抵消时间惩罚；被召回的记忆带时间/相对年龄/置信度注入。默认开启，设置页可关闭回退旧公式。

• 复述分类（v0.7）：被动曝光只记录、不强化；主动检索/自然复述/用户确认/纠正分别按权重计入有效复述；纠正会降低置信度并标记待再巩固。

• 时间与时区（v0.3）：时间戳按 epoch 存储，显示时使用你选择的时区（默认跟随服务器本地）。 自动召回上下文会附带「当前时间（含时区）」与每条记忆的相对时间（如“3 天前”），方便模型判断新旧； 记忆管理页支持按「今天 / 近 7 天 / 近 30 天」筛选。

• 模型工具：memory_search / memory_save / memory_forget，可在设置页一键禁用； 写入前自动脱敏（sk-…、Bearer …、api_key: …、password: … 等）。

安装

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

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

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

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

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

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

配置说明

设置页分为五个 Tab：

概览

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

模型与向量库

记忆行为

自动记录/召回开关、召回条数/相关度/字符上限/超时、跳过最近多少分钟的自动对话、图片记忆方式与提示词、工具开关与默认条数。

时间与时区

模型列表与功能模型分配

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

睡眠整理与清理维护

• 整理队列：事件批次 = 会话 × 日期，同一天不同会话得到不同编号；队列保存在 $DSH_HOME/storages/dsh-memory/queue.json， 显示编号、状态（收集中/待整理/整理中/等待合并/失败）、来源→产出条数、到期时间和失败原因。编号顺序分配、固化后回收，可长期运行。
• 合并链：事件批次 → 事件片段（睡觉时）→ 周片段（周末结束后 7 天）→ 长期片段（月末结束后 30 天，多对一合并）； 默认不限制每级保留条数（由整理模型按内容重要性决定，可选开关启用 40/20/10 上限），旧片段在合并成功后删除（失败保留，下次重试）。
• 编号生命周期：编号只在片段等待/执行整理期间存在；合并完成后编号作废回收，长期片段不再带编号。
• 睡眠状态：设置页与记忆管理页可查看“待机中/睡觉整理中”、整理队列、最近整理与历史；支持手动「立即整理」。
• 旧数据迁移：旧版 consolidation.json 会自动迁移成新队列（旧文件保留），旧记忆里的 sessionId/cwd 与过期编号会被清理。
• 整理模型：在「模型列表 → 功能模型分配」里选择 provider 与模型（默认 Qwen/Qwen2.5-7B-Instruct），模型不可用时自动回退纯规则压缩。

记忆管理

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

高级

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

数据与安全

• Qdrant 中每条记忆只包含：脱敏后的文本要点、类型、时间、重要性/置信度、层级、待整理编号（仅未固化时）、provider、向量。 不保存会话 id、工作目录与图片字节；图片只保留一句概览与宽高/格式。
• 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 接口（设置页同源，仅供排查/扩展）

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

测试连接

已知限制

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

开发与构建

# Host 半：src/ → 单文件 index.js（拓扑排序）
node build.mjs
# 浏览器半：src/ui/*.js → 单文件 client.js
node client-build.mjs
# 或一起
node build.mjs && node client-build.mjs

• 分层/依赖规则见 docs/ARCHITECTURE.md；记忆流程与召回模型见 docs/MEMORY-FLOW.md；整理队列/编号/迁移见 docs/QUEUE.md。
• 纯领域测试：node tests/fragments.mjs、node tests/recall-policy.mjs（无需 API）。
• Host 测试：SF_KEY=... node tests/host-selftest.mjs（真实嵌入+Qdrant，测试集合 dsh_memory_test）。
• 整理测试：SF_KEY=... node tests/consolidation.mjs（与 Host 测试使用同一集合，不要并行运行）。

更新记录

• v0.8.0（记忆片段 + 整理队列）：①把“会话 × 日期”作为事件批次：编号只在待整理期间存在，固化后回收； ②合并链改为事件片段 → 周片段（周末后 7 天）→ 长期片段（月末后 30 天），后两层为多对一合并； ③记忆不再保存 sessionId/cwd 与记忆范围，改用“跳过最近 N 分钟自动对话”避免重复召回； ④新增整理队列视图（编号/状态/到期/失败重试/来源→产出），失败按批重试、重启可续； ⑤旧任务列表与旧 payload 自动迁移/清理，设置页术语改为“片段/事件/周/长期”。

• v0.7.0（结构重构 + 动态召回）：①按 docs/ARCHITECTURE.md 完成 R1–R5 分层重构（shared/domain/ports/app/adapters/entry + client 模块化，行为不变）； ②动态相关度召回：内容时间锚点、importance/confidence/anchorTs、分层 τ、动态门槛、排序与置信度注入； ③复述分类 A–E：被动曝光不强化，主动检索/自然复述/确认/纠正按权重计入，纠正降置信度并标记再巩固； ④设置页「动态召回（实验）」与高级参数、可一键关闭回退；旧记忆自动补齐新字段。

• 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，自动记录/召回与记忆工具）。