deepseekplugins

DeepSeek Harness plugin

dsh-plugin-memory

Long-term cross-session markdown memory with an LLM-Wiki structure and a SOUL.md persona, hard-injected at every session start, plus remember/recall/consolidate/forget workflows, an embedded memory skill and pack/unpack migration tooling.

Memory
Jump to install

Source facts

Repository
LittleBlackTong/dsh-plugin-memory
Latest update
Aug 19, 2026
Category
Memory
GitHub stars
0

Install

Start with a prompt that asks an agent to read the source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/LittleBlackTong/dsh-plugin-memory
GitHub: https://github.com/LittleBlackTong/dsh-plugin-memory
Plugin: dsh-plugin-memory
Author: LittleBlackTong
Install command: dsh plugin --profile web add github:LittleBlackTong/dsh-plugin-memory

Do not run the install command until I confirm.

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-plugin-memory

<p align="center"> <a href="https://github.com/LittleBlackTong/dsh-plugin-memory"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-LittleBlackTong%2Fdsh--plugin--memory-blue?logo=github"></a> <a href="https://www.npmjs.com/package/dsh-plugin-memory"><img alt="npm" src="https://img.shields.io/npm/v/dsh-plugin-memory?logo=npm"></a> <img alt="license" src="https://img.shields.io/badge/license-MIT-blue"> <img alt="node" src="https://img.shields.io/badge/node-%3E%3D18-green"> </p>

> DeepSeek Harness 长期记忆插件：跨会话、可迁移、带「灵魂」的 markdown 记忆库。

English TL;DR — A Cordis plugin for DeepSeek Harness that gives agents a persistent, cross-session, migratable long-term memory: a markdown + git store (inspired by Karpathy's LLM Wiki pattern) with a SOUL.md persona file, auto-injected at every session start via the system-prompt runtime context, plus remember / recall / consolidate / forget workflows and portable CLI tooling.

特性

  • 开机强制注入：插件通过 ctx.systemPrompt.context() 把记忆 boot 块（SOUL.md 人格 + MEMORY.md 协议 + index.md 目录 + 最近动态）注入每个会话开头。宿主按投影去重：记忆不变就不重复注入，变化时新快照自动取代旧的——这是"新会话必先加载记忆"的硬保障，不需要模型碰运气调技能。
  • SOUL.md 铸魂：安装后首要任务是和用户对话定义灵魂（名字、性格、价值观、语气、边界）、确认身份与关系（BOOTSTRAP.md 清单驱动，complete 前优先于常规任务）。
  • 铸魂自动引导：记忆库还没有灵魂（BOOTSTRAP.md 非 complete，或 SOUL.md 仍是占位模板）时，boot 块会自动前置一段第一人称引导词——「我的首要任务是确认我是谁，还有你是谁：我叫什么名字、怎么称呼你、你我是什么关系、我该是什么样的性格」——像 OpenClaw 初始化那样，由 agent 在对话里主动发起铸魂，逐项问、逐项写回，而不是等用户来喂。铸魂完成后引导词自动消失，零开销。
  • 复利记忆：遵循 Karpathy 的 LLM Wiki 约定——记忆是"一次编译、持续保鲜"的持久产物，不是每次查询重新 RAG。remember / recall / consolidate / forget 四操作 + salience 三级衰减。
  • 可迁移：记忆本体是纯 markdown + git + 自描述 schema，任何能读 markdown 的 agent 都能接手。dsh-memory pack/unpack 打包迁移。
  • 内嵌技能：通过 ctx.skills.register() 注册 memory 技能（操作协议随插件分发）；项目级 .dsh/skills/memory 文件技能仍可覆盖它。
  • 防懒 digest 唤醒：每轮结束后，若 agent 空闲且记忆库超过 digestNudgeAfterMinutes 未写入，插件注入一条 digest 提醒（合成消息，走 agent.followup），把"会话收尾沉淀"从靠自觉变成有机制兜底；带冷却与每会话限次，不骚扰。独立于 dsh-plugin-heartbeat，两插件各自可装、互不依赖。
  • git 自动提交：记忆库变更静默 autoCommitQuietSeconds 后自动 git add -A && git commit（无 .git 则跳过）——历史可回滚不再依赖 agent 记得 commit。
  • 设置面板：在 DSH 设置页提供「记忆 Memory」区块——总开关、记忆目录、开机注入、技能注册四项均可热改，立即生效，无需重启。
  • 零构建：纯 ESM JavaScript，无编译步骤，pnpm add 即用。

架构

插件只拥有工作流，不拥有数据格式：

dsh-plugin-memory（本插件）
├── lib/index.js        # Cordis 入口：boot 注入 + 运行时技能注册 + settings 热改
├── lib/boot.js         # boot 块渲染（SOUL/MEMORY/index + 最近 log，限额截断）
├── lib/scaffold.js     # 记忆库脚手架（模板只建不覆盖）
├── lib/client.js       # 客户端半：设置面板「记忆 Memory」区块
├── skills/memory.md    # 内嵌技能的操作协议正文
└── scripts/memory.mjs  # CLI：init/search/lint/status/pack/unpack

记忆库（用户数据，默认 ~/.memory）
├── SOUL.md       # 人格与灵魂（用户主导）
├── BOOTSTRAP.md  # 铸魂清单（complete 前优先）
├── MEMORY.md     # schema 与维护协议（自描述）
├── index.md      # 页面目录    log.md # 时间线（append-only）
├── identity/ user/ skills/ decisions/ projects/{active,archive}/ concepts/
└── raw/          # 不可变源材料

安装

dsh plugin --profile <profile> add dsh-plugin-memory

（包内置 dsh.bundle manifest，dsh plugin add 会把它自动挂进 profile 的 bundles 层；dsh-market 里的一键安装同此通道。）

重启 profile（DSH Desktop 重启应用）后生效。

> ⚠️ 不要再往 profile 的 cordis.patch.yml 里手写 - insert: {id: dsh-memory, ...}： > 那会与 bundle manifest 的自动挂载产生两条同名 entry，整个 profile 会以 > duplicate loader entry id "dsh-memory" 启动失败（2026-08-18 实机事故）。 > 运行期配置（enabled / memoryDir / autoInject / registerSkill）改走 > <dshHome>/memory.json（设置面板热改）；composition 配置见下表。 > 如需覆盖某个 composition 键，用不带 insert 的 id 覆盖条目（见配置一节）。

配置

键默认值含义
enabledtrue总开关：关闭后不注入 boot 块、不注册 memory 技能
memoryDir~/.memory记忆库绝对路径（~ 自动展开）
bootFiles[SOUL.md, MEMORY.md, index.md]开机注入的文件
bootMaxChars6000boot 块总字符预算（防止占用过多上下文）
autoInjecttrue会话开始时注入 boot 块
registerSkilltrue注册内嵌 memory 技能
scaffoldtrue记忆库缺失时自动创建模板（只建不覆盖）
configFile<dshHome>/memory.json用户可改配置的 JSON 文件路径（设置面板读写它）
digestNudgeEnabledtrue防懒 digest 提醒总开关（composition）
digestNudgeAfterMinutes120记忆库超过多久未写入就提醒
digestNudgeCooldownMinutes180两次提醒的最小间隔
digestNudgeMaxPerSession2每个会话最多提醒次数
autoCommittrue记忆库 git 自动提交开关（composition）
autoCommitQuietSeconds60变更静默多久后提交（防抖）
autoCommitIntervalSeconds60变更轮询间隔

设置面板（热改）

enabled / memoryDir / autoInject / registerSkill 四项在 DSH 设置页的「记忆 Memory」区块中可改，即时生效：boot 注入、技能注册随修改立即重建；记忆目录切换时自动为新目录初始化脚手架（scaffold: true 时）。其余键（bootFiles / bootMaxChars / scaffold / configFile / digestNudge* / autoCommit*）只在 composition 配置层生效，改完需重启。

覆盖 composition 键（例如把 boot 块预算调大），在 profile 的 cordis.patch.yml 里写不带 insert 的 id 覆盖条目：

- id: dsh-memory
  config:
    bootMaxChars: 12000

> 实现说明：DSH 的 settings wire 只服务硬编码的命名空间白名单，插件命名空间写不进去，因此本插件走自建通道——配置存 <dshHome>/memory.json（schema 校验 + 原子落盘），由插件自注册的 GET/POST /api/memory/config 路由服务，客户端区块 fetch 直连。

首次使用：铸魂

插件安装后，第一次会话里 agent 的首要任务不是干活，而是与你对话定义它的灵魂：名字、性格、价值观、语气、边界，以及你的身份与你们的关系。逐项确认并写回 SOUL.md / user/profile.md，直到 BOOTSTRAP.md 的 status 变为 complete。你可以随时跳过或暂缓。

四个操作

  • remember（记）：把值得持久化的内容蒸馏成页面，同步更新 index.md、追加 log.md。
  • recall（忆）：会话开始读 boot 块；查询时先查 index.md 再钻页；必要时 dsh-memory search。
  • consolidate（整理）：dsh-memory lint 查矛盾、孤儿页、该归档的冷页。
  • forget（忘）：显式遗忘立即执行；自动衰减按 salience + last_access（冷页优先归档）。

CLI

dsh-memory init [dir]                 # 创建记忆库脚手架
dsh-memory search <query>             # 全文检索
dsh-memory lint                       # 完整性体检
dsh-memory status                     # 健康概览
dsh-memory pack [out.tar.gz]          # 打包导出（含 manifest）
dsh-memory unpack <archive> [--force] # 从归档恢复

存储定位顺序：$MEMORY_DIR → ./.memory（存在时）→ ~/.memory。

迁移

记忆库是纯 markdown + git：拷贝即迁移。跨机器 / 跨 agent / 能力降级档位见 [docs/MIGRATION.md](docs/MIGRATION.md)。

常见问题

Q：和手写的 .dsh/skills/memory 文件技能（skill 版）什么关系？ skill 版是"软保障"（技能目录只注入简介，正文靠模型主动加载）；本插件是"硬保障"（boot 块随系统提示词运行时上下文自动注入）。两者可共存：文件技能（rank 100）会覆盖插件内嵌技能（rank 250）的协议。如果你之前为了软保障改过系统提示词 persona（如 profile 补丁里的开机指令），装上本插件后建议移除那段 persona，避免双份注入。

Q：boot 块会不会每次请求都重复注入、烧 token？ 不会。运行时上下文按投影去重：内容不变只注入一次；记忆更新后新快照取代旧快照。

Q：记忆库放在哪里最合适？ 默认 ~/.memory（全局、跨项目）。需要按项目隔离时，把 memoryDir 配到项目内，或让 agent 在项目里维护 .memory/。

Q：可以加密吗？ 记忆含敏感内容时，可把 memoryDir 放进加密卷 / 私有仓库。格式不变，插件无感知。

开发

git clone https://github.com/LittleBlackTong/dsh-plugin-memory.git
cd dsh-plugin-memory
node scripts/memory.mjs --self-test   # 冒烟测试（无需安装依赖）

零构建：lib/ 直接是运行时代码，lib/types/index.d.ts 供 TS 消费方使用。boot.js / scaffold.js 只依赖 node:* 内置模块，可独立复用。

路线图

  • [ ] TypeScript 重写（带完整类型与构建步骤）
  • [ ] embedding/BM25 检索（规模超过几百页后替代 index 先行）
  • [ ] MCP server（让非 DSH 的 agent 也能用同一套记忆库）
  • [ ] GitHub Actions CI（跑 --self-test 与 lint）
  • [ ] 记忆加密存储选项

欢迎在 Issues 里提需求、报 bug、交 PR。

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category