带 LLM Wiki 结构与 SOUL 人格文件的长期 markdown 记忆库:会话启动注入 boot 块(默认提问后才注入、且只注入当前激活会话),含 remember/recall/consolidate/forget 工作流、内嵌 memory 技能、pack/unpack 迁移工具,以及空闲时以第一人称主动追忆(recall nudge)的拟人化能力。同时补上记忆库原先缺的“可观测 + 可维护”:按文件分配 boot 预算(索引路由表不再被截断)、自动戳记 last_access(salience 衰减真正生效)、只读记忆健康看板(体量/新鲜度/与 lint 同源的体检)、声明式索引编译器(页面声明 summary:,一条命令重写索引行),可拖动、可滚轮缩放的记忆图谱(页间链接 + 共享 tag)、结构化检索(tag/type/salience/hot/stale 过滤)、针对「尚无内容关系」页面的补链建议,以及以「最该做的 N 件事」收尾的 `checkup` 体检报告。同时把操作细节移到按需加载的技能,boot 注入体量减少约 23%。设置区块现在还有专属侧栏图标(半脑 + 节点——因为设置 shell 不给插件留图标位)和直达本仓库的反馈入口。要求 DSH session format v4(官方 DeepSeek Harness 0.1.7+):注入消息使用 producer-owned source kind plugin:memory。 v0.11 起设置面板与侧栏 label 跟随 DSH 语言设置(中文「记忆」/英文 "Memory");v0.12 新增跨插件共享发言权、按语境微调的语气段与每周成长回顾;v0.13 用 engines.dsh 声明 DSH 兼容范围(官方 0.2.1-rc.5 系列,旧宿主会被闸门拒绝),新增「立即回顾」按钮(POST /api/memory/control,action growth-now,立即发一次成长回顾且仍尊重发言权)、面板可访问性(aria-label、status/alert role、focus-visible 焦点环)与公开的 PROACTIVE-PROTOCOL.md。v0.14 新增按会话记忆开关:输入框芯片(下拉可选本会话 / 此工作区默认)、/memory on|off|status 命令与设置面板开关共用同一判定——关闭后该会话不注入 boot 块、不发 digest/追忆提醒、不盖 last_access(记忆文件不删);disabledWorkspaces 可让整个项目默认关闭,会话选择持久化 7 天。v0.15 新增「人格基础(快速铸魂)」卡片:我的名字 / 你的称呼 / 基础人格描述,保存写入 SOUL.md 受管区块(其余内容一字不动)并把 BOOTSTRAP 标 complete;对话铸魂的老库会从 SOUL 文本回显,未铸魂时 boot 块会先提醒用户完成铸魂。v0.16 把记忆图谱升级为可交互 3D 球面(Canvas 手绘、零依赖):拖拽旋转、滚轮缩放、拖节点 3D 整理布局、双击空白重置、自动慢转(尊重减少动态效果);悬停或点击节点即时高亮邻居(位移+时长点击阈值),配色随浅色/深色面板自适应。v0.17 新增图谱搜索(排序匹配,镜头飞到命中的节点并点亮邻居)、节点的「在 Finder 中显示 / 复制路径」(等待命令结果,失败自动复制路径兜底)、Windows 兼容(路径变量展开、CRLF 读写保留换行风格、explorer 参数与退出码处理、工作区大小写匹配),README 精简并加入真实截图。v0.18(issue #8)新增 boot 快照模式:session 在本会话固化 boot 块,会话中途写记忆不再让前缀缓存失效(最近动态改走独立的靠后 context 段),默认仍是 live;双击记忆节点改为在 DSH 右侧栏打开该文件(打不开时回退系统文件管理器)。v0.19 兼容 DSH 0.2.2-rc.2:agent 注册表优先 agents.roots()、缺失时回退 agents.list(),所有 agent/created 监听器都做了异常保护——rc.2 下未保护的抛错会让 agent 注册被拒、无法新建会话,因此 rc.2 用户必须升级到 0.19.2 或更新版本(最新 0.19.5)。设置面板、看板与输入框 chip 在老宿主与 rc.2 上均可工作。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-plugin-memory
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:LittleBlackTong/dsh-plugin-memory
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 中文
给 DeepSeek Harness 的长期记忆 —— 一个可迁移的 markdown 记忆库,还带一份灵魂,每次会话启动自动注入。
macOS · Windows · Linux 全平台支持 · Node ≥ 18 · DSH ^0.2.1-rc.5 / 0.2.2-rc.2 · MIT
⚠️ 如果你在用 DSH 0.2.2-rc.2 或更高版本,请务必先把插件升级到 0.19.2+。 早期 0.19.x 调用了
ctx.agents.roots(),而 rc.2 已换成list();这次抛错发生在 serial 的agent/created监听器里,会拒绝 agent 注册——表现就是开启插件后无法新建会话。0.19.2 改为兼容读取(绝不抛错),升级后需要完全重启 DSH 才生效。
双向兼容。 0.19.2+ 读取 agent 注册表时优先
agents.roots()、失败回退agents.list()——同一份构建既支持老宿主(0.2.1-rc.5 … 0.2.2-rc.1),也支持 rc.2。老版本 DSH 用户升级插件不会坏,rc.2 支持也不会丢掉老版本。
它是干什么的
一个 Cordis 插件,给 DSH 的 agent 装上跨会话、可迁移的持久记忆:纯 markdown + git(LLM Wiki 模式)、一份 SOUL.md 人格,以及通过 runtime context 自动注入的 boot 块——硬保证,不靠模型自觉去调 skill。
快速开始
# 1. 安装
dsh plugin --profile <profile> add dsh-plugin-memory
也可以从插件索引安装:在 插件 → 实验性插件 里打开「自定义插件索引」,进 发现 → 添加索引源,粘贴
https://raw.githubusercontent.com/LittleBlackTong/dsh-plugin-memory/main/docs/market/index.json
然后在列表里安装 记忆(Memory)(索引是本仓库里的官方格式 JSON)。
- 重启应用。第一个会话里 agent 会主动发起铸魂对话(不想聊也行:设置 → 记忆 → 人格基础,一次保存)。
- 验证:
dsh-memory doctor,或打开 设置 → 记忆 看健康看板与热改配置。
功能
- 跨会话记得住 —— boot 块 = SOUL + MEMORY 协议 +
index.md+ 最近动态,按文件分配预算,index 尾部不会先被截断。 - 有灵魂,不只是存储 —— SOUL + BOOTSTRAP 铸魂;快速铸魂卡片写入受管区块;人格名从 SOUL 读取,绝无硬编码。
- 你说了算 —— 会话级开关(chip /
/memory on|off/ 面板)+disabledWorkspaces工作区默认。 - 像个搭子 —— digest 提醒、主动追忆、每周成长回顾、按语境调语气;与其它主动插件共享发言权仲裁。
- 可迁移 —— 纯 markdown + git,
pack/unpack搬家,可选自动提交。 - 记忆图谱 —— 可交互 3D 球面:旋转/缩放/拖节点整理、搜索定位、悬停或点击点亮邻居;选中节点可 在 Finder 中显示 或 复制路径;双击节点直接在 DSH 侧栏打开该文件(打不开时回退系统文件管理器)。
- 时间轴 —— 同一份记忆的时间投影:单线地铁式事件轨道,可拖动、滚轮缩放自动切换 日/周/月/年 刻度;节点不拥挤时显示事件描述,单击看详情、双击打开对应页面(匹配不到则打开
log.md);深浅主题自适应。 - 健康工具 —— 看板、
checkup、lint、doctor、自动last_access。 - 零构建、面板双语、配置热改。
界面预览
人格基础(快速铸魂) —— 一次保存我的名字 / 你怎么称呼我 / 基础人格,下次会话直接生效、不用重启;对话铸魂的老库也会从 SOUL.md 回显。

记忆图谱(3D) —— 记忆库的实时投影:旋转 / 滚轮缩放 / 拖节点整理,搜索即飞镜头定位,悬停或点击点亮邻居;选中节点可 在 Finder 中显示 或 复制路径,双击空白重置。

设置面板 —— 十六项设置即时生效(会话开关、注入闸门、追忆节奏、语气、工作区默认…),健康看板与图谱就在下面。

跨平台(含 Windows)
macOS、Windows、Linux 都支持。 路径配置里的 ~、~\、%USERPROFILE%、$HOME 会自动展开;CRLF 文件按 LF 解析、**写回保留文件自身换行风格**(不会被强行 LF 化);「在 Finder 中显示」在 macOS 是 open -R、Windows 是 explorer /select,(参数分开传,含空格路径安全)、Linux 是 xdg-open;disabledWorkspaces 在 Windows 上大小写不敏感。细节见 docs/CONFIGURATION.md。
配置
十七个热改项在 设置 → 记忆 里即时生效——含 bootSnapshot(默认 live;设为 session 会在本会话固化 boot 块,会话中途写记忆不再让前缀缓存失效)。完整配置表、boot 预算规则与组合层覆盖示例见 docs/CONFIGURATION.md。
CLI
dsh-memory init [dir] # 生成记忆库脚手架
dsh-memory search <query> # 全文搜索
dsh-memory checkup # 一份带优先级的健康报告
dsh-memory doctor # 环境体检 + 修复命令
dsh-memory graph --suggest # 谁该链接到谁(只报告)
dsh-memory pack / unpack # 记忆库打包 / 恢复
记忆库解析顺序:$MEMORY_DIR → ./.memory → ~/.memory。
文档
配置 · 设计说明 · 迁移 · 主动消息协议 · 贡献 · 安全 · 更新日志
FAQ
每次请求都烧 token 吗? 不会——runtime context 按投影去重,没变化只注入一次。
文件技能和插件的关系? 文件技能是软保证(只注入说明),本插件是硬保证;两者可共存(文件技能优先级更高),手写 persona 要删掉以免重复注入。
记忆库放哪? 默认 ~/.memory;按项目隔离就把 memoryDir 指进项目里。
开发
git clone https://github.com/LittleBlackTong/dsh-plugin-memory.git
cd dsh-plugin-memory
node scripts/memory.mjs --self-test # 冒烟测试,无需安装依赖
node --test # 全量测试
零构建:lib/ 直接就是运行时代码。CI 跑上面两条。
Roadmap
- Embedding / BM25 检索
- MCP server(让非 DSH 的 agent 共用记忆库)
- 记忆加密存储
- TypeScript 重写
反馈与交流
- 报 bug / 提需求 / 交 PR:提 issue——反馈与问题都走这里。
- 微信群「dsh-plugin-memory 插件沟通」:扫下面的码(二维码约 7 天过期;失效请提 issue)。

License
链接
同类插件
vectorize-io/hindsight#coding-agents★ 61444
Hindsight:会学习的 Agent 长期记忆系统,自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。
volcengine/OpenViking#examples/dsh-memory-plugin★ 42323
面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护,以及对接 OpenViking 服务端的 recall/write 记忆工具。
MemTensor/MemOS#memos-local-plugin★ 12418
DeepSeek Harness 本地记忆插件:分层 L1/L2/L3 记忆,自动沉淀与手动 memos_* 检索工具并存,内置记忆浏览器。
agentscope-ai/ReMe#dsh★ 3814
将 DeepSeek Harness 接入 ReMe 本地优先、自进化的个人知识库:自动把已完成的主 Agent 对话沉淀为用户掌控的 Markdown 记忆,通过 reme_search 结合 BM25、可选向量检索和 wikilink 展开搜索对话与资料,并按日整理长期记忆。
zilliztech/memsearch#MemSearch★ 2892
供 DSH 与其他编程 Agent 共享的 Markdown 记忆,支持自动捕获、步骤前上下文注入、搜索召回,以及通过审阅面板实现 memory-to-skill 自进化。
vshulcz/deja-vu#extensions/dsh★ 1578
跨会话长期记忆与上下文恢复:读取本机上其他四十五个(45+)编程智能体已经写下的会话文件,支持安装前历史找回与中断恢复(Claude Code、Codex、Cursor、Windsurf、Trae、Antigravity、VS Code Copilot Chat、opencode、OpenClaw、Hermes、Kimi、Qoder、Cline、Zed、Magpie 等):提供 deja_recall、deja_session、deja_blame、deja_fix、deja_how、deja_remember 六个工具与 /deja 命令,并可选地把召回结果加入运行时上下文。共享本地 BM25 CLI/MCP 索引,不用大模型,不用向量嵌入,不联网(dsh plugin --profile web add dsh-deja)。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。