Starry0214/dsh-memory

DeepSeek Harness (DSH) 全局自动记忆插件:会话开始注入记忆、memory_search 检索工具、压缩检查点归档提醒(零写入提醒制)。Global auto-memory plugin for DSH.

项目介绍Project Overview

dsh-memory 是 DeepSeek Harness 的跨会话持久化记忆插件。它在每个新会话自动注入用户画像、偏好与历史,支持 memory_search 实时检索,并在会话压缩时落盘,防止记忆丢失;同时提供重复错误主动提醒与用量统计。适合需要长期上下文连续性的开发者首次安装即用。需注意:旧版安装脚本可能写坏 cordis.patch.yml 导致启动报错,可运行附带的修复脚本处理;宿主插件改动后必须重启 DSH,新会话才生效。

dsh-memory is a persistence plugin for DeepSeek Harness that automatically injects user profile, preferences, and history into every new session. It supports real-time memory_search retrieval, auto-saves memory on session compression to prevent loss, and proactively reminds users about known patterns or repeated errors. Ideal for developers needing long-term context continuity. Setup a simple onedshell. Note: older install scripts may corrupt cordis.patch.yml and break startup; run the provided fix script. DSH must be restarted after installation, and changes only take effect in new sessions, not the current one.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

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

Starry0214/dsh-memory 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-memory

让 DeepSeek Harness(DSH)真正记住你:跨会话、跨项目、零配置。装好后每个新会话自动带上你的画像、偏好和最近进展,AI 不用每次都从零开始。

设计灵感来自 MiMo-Code 的开源持久化记忆(MIT 许可),针对 DSH 生态独立实现。 面向开发者/维护者的技术细节见 docs/设计文档.md

它能做什么

功能 一句话说明
🧠 自动记 会话开始自动注入你的记忆,跨会话衔接,不用重复交代背景
🔍 随时查 会话里说"查一下 OA 日志 / 查 global",AI 会用 memory_search 实时检索记忆库
🪶 不丢记忆 会话压缩时自动落盘,即使会话立刻结束也不丢;另有备份与轮转兜底
⚡ 主动提醒 遇到已知领域/重复错误/连续失败时,AI 会自动提醒"先查记忆",越用越准
📊 用量可见 设置界面可看提醒次数、检索次数、token 消耗等统计
💰 更省钱 记忆注入做前缀缓存优化,命中率高、成本低

安装(一行命令)

Windows(PowerShell)

irm https://raw.githubusercontent.com/Starry0214/dsh-memory/main/install.ps1 | iex

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/Starry0214/dsh-memory/main/install.sh | bash

装完重启 DSH。重启后启动日志出现下面几行即安装成功(没有则以"遇到问题"一节排查):

[dsh-memory] 就绪 v2.3.0:...
[dsh-memory] memory_search ...

首次使用(约 1 分钟)

重启后的第一个会话,插件会引导你做一次「记忆初始化」:AI 会一次性问几件事(怎么称呼你、在做什么项目、日常干什么、协作人、偏好),记下来后写入记忆库。之后每个新会话都自动生效。

  • 想补内容:随时说「初始化记忆」或输入 /memory-init
  • 暂时不想弄:直接说"回头再说",24 小时内不再打扰
  • 状态查看:设置 → 通用设置 → 记忆

日常使用

装好后基本什么都不用做,记忆自动沉淀。偶尔想起来可以用:

动作 效果
普通对话 记忆已自动注入,正常聊即可
说"查一下 XX" AI 实时检索记忆库里的相关历史
输入 /dream 手动触发一次记忆整合(把散落经验提炼进全局记忆,后台执行)
输入 /memory-update 手动检查插件是否有新版本

遇到问题

装完 DSH 启动报错(cordis.patch.yml 解析失败)——旧版安装脚本可能把配置文件写坏,一条命令修复:

irm https://raw.githubusercontent.com/Starry0214/dsh-memory/main/fix-cordis-patch.ps1 | iex

怎么看有没有装好:重启后控制台搜 [dsh-memory],看到 就绪 vmemory_search 即正常;命令行输入 /memory-update 应回复当前版本。

感觉没生效:确认是重启后的新会话(宿主插件改动需重启才加载),且记忆库目录 ~/.dsh/memory/ 下能看到 global.mdindex.md

公司内网装不了(GitHub 不通):让能联网的同事把 index.jsinstall.ps1version.txt 拷到内网,设置环境变量 DSH_MEMORY_RAW 指向内网地址再运行安装命令;或直接用 DSH_MEMORY_LOCAL 指定本地 index.js 文件离线安装(见下方环境变量表)。

升级

插件自带每日一次的新版本检查(离线/内网失败不打扰)。发现新版本时直接重新运行安装命令即可覆盖升级(安全幂等,不会写坏配置),升级后重启 DSH。

也可以随时输 /memory-update 手动检查。

高级设置(一般不用动)

默认值即可直接用;想调整去 设置 → 通用设置 → 记忆,或改 cordis.patch.ymldsh-memory 插件的 config:

配置项 默认 说明
staleSessionDays 5 超过 N 天没交互的会话提醒归档
staleAction remind 漏网会话处理方式:仅提醒 / 后台自动归档 / 需确认后归档
integrateEnabled false 是否开启定期自动记忆整合(默认手动 /dream
monitorEnabled true 使用监控(提醒/检索统计)开关

安装脚本可配置环境变量:

变量 默认 说明
DSH_HOME ~/.dsh DSH 主目录
DSH_PROFILE web 安装到哪个 profile
DSH_MEMORY_RAW GitHub raw 插件文件下载源(内网可指镜像)
DSH_MEMORY_LOCAL 本地 index.js 路径,设置后不联网直接安装

记忆库放在哪

~/.dsh/memory/
├── global.md     # 全局记忆:画像、偏好、跨项目经验
├── index.md      # 记忆索引
├── knowledge/    # 知识库(按主题分文件)
├── projects/     # 项目层记忆
├── sessions/     # 会话摘要(自动落盘)
└── tools/        # 自研工具/脚本登记

面向开发者

  • 变更日志 / 版本历史 → docs/CHANGELOG.md
  • 架构与设计决策 → docs/设计文档.md
  • 测试:powershell -NoProfile -ExecutionPolicy Bypass -File test/patch-merge.tests.ps1node test/onboard.unit.test.mjsnode test/plugin.smoke.test.mjs

许可证

MIT License

上一个 Prev dock 下一个 Next dsh-kafka-ui