DeepSeek Harness 插件

LittleBlackTong/dsh-plugin-memory

Star 数 ★ 38 下载量(近 30 天) 44,972 分类 记忆 收录于 2026-08-19 npm dsh-plugin-memory

带 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)。

  1. 重启应用。第一个会话里 agent 会主动发起铸魂对话(不想聊也行:设置 → 记忆 → 人格基础,一次保存)。
  2. 验证: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)。

dsh-plugin-memory 微信群

License

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。