Skip to content

dsh-memory-with-soul

Verified

dsh-memory-with-soul · v0.7.0 · MIT · Web UI

Long-term memory library for DeepSeek Harness: injects <memory-context> at session start, records which memory files were read, and reminds you to extract conclusions. Markdown + git, role cards, settings UI. Requires Python 3.10+.

Install

dsh plugin add dsh-memory-with-soul

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-memory-with-soul

长期记忆库插件,给 DeepSeek Harness(DSH)用。

一句话:让 AI 记住你——会话开始时把记忆库注入上下文,读文件时记下它读过什么,回合结束时提醒它把结论写回文件。

  • 纯 Markdown + git,不依赖任何数据库或云服务
  • 记忆库放在 ~/.memory/,可以单独 git 版本化、手动编辑、换机器带走
  • 人格(角色卡)是一份 SOUL.md,写文件而不写配置
  • 设置页挂在 DSH 侧边栏「记忆库」,七个页签

装之前

依赖 版本 说明
DSH >=0.1.0-rc.1 <0.3.0 宿主,插件以 bundle 形式挂进 profile
Node.js >=22 适配器与内置设置页的路由
Python >=3.10 硬依赖:核心逻辑(core/memory.py)是 Python,不是可选项

Python 不在 PATH 里也能用:在 cordis.patch.yml 的 python 候选里写绝对路径(见下面的配置表)。

安装

# 1. 装插件(profile 名按你的实际写;默认叫 desktop)
dsh plugin --profile desktop add dsh-memory-with-soul

# 2. 第一次用:建记忆库(不建就只有空人格,插件本身照常工作)
python ~/.dsh/profiles/desktop/node_modules/dsh-memory-with-soul/core/memory.py init

装好、重启 DSH 后,侧边栏会多出「记忆库」入口;新会话开头会出现一段 <memory-context>(里面是记忆库内容)。

Windows 用户注意:上面第 2 步的路径用 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-memory-with-soul\core\memory.py,或直接用设置页里的路径提示。

它做了什么

插件挂在 DSH 的三个生命周期点上:

时机 动作 落到哪
会话开始 读 ~/.memory/config.json 的注入表,把记忆拼成 <memory-context> 注入 core/render.py 输出 → agent.inject()
读文件(read / ops_read_files) 记下被读的记忆库文件 core/memory.py track
回合结束 判断这一回合有没有「该提炼但没写日志」 core/memory.py digest

另外,插件加载时会把你装的 skills/ 复制进 ~/.dsh/skills/(复制,不是软链——版本升级后不会指向旧路径;内容变了下次加载自动刷新)。

记忆库长什么样

~/.memory/
├── config.json          # 注入表:哪些文件、多大预算、什么顺序
├── index.md             # 总览:东西在哪
├── README.md            # 给 AI 看的协议(保存/提炼/遗忘的规矩)
├── roles/<role>/SOUL.md # 角色卡:人格
├── playbooks/           # 跨项目方法论
├── topics/              # 单文件主题
├── user/                # 用户档案与偏好
├── agents/              # agent 注册表(每个 agent 一个目录)
├── archive/             # 归档(设置页只读)
└── .state/              # 运行时状态(gitignore)

项目级记忆在各工作区的 .memory/(log/<agent>/YYYY-MM-DD.md 就是每日日志),插件按 cwd 向上找 _meta.md 定位。

配置

装完后在 profile 的 cordis.patch.yml 里覆盖 memory-inject 那一行的 config(整行覆盖,不深合并):

键 默认 作用
enabled true false 关掉插件
python ["python","python3","py"] 候选解释器,按顺序试;含路径分隔符的按绝对路径检查
renderer 空 渲染器路径,留空自动找 core/render.py
harness dsh 环境变量 MEMORY_HARNESS 的值,只影响日志与注入头
agentName 空 直接指定 agent id,留空按 config.defaultAgent
timeoutMs 10000 渲染器超时(毫秒)
injectSubagents false 子 agent 也注入(每份记忆都是实付 token,默认省)
trackAccess true 记录读过哪些记忆文件
digest true 回合结束判断要不要提醒提炼
installSkills true 加载时把 skills/ 复制进 ~/.dsh/skills/
webUi true 挂内置设置页(/api/memory/ui)
cwd 包根 渲染器工作目录,只影响相对路径解析

自检

node adapters/dsh/smoke.mjs       # 清单与渲染器(19 项)
node adapters/dsh/test.mjs        # 三条接线(11 项)
node adapters/dsh/web.test.mjs    # 内置设置页路由(47 项)
python ui/serve.py --self-test    # 独立设置页与核心逻辑(68 项)
python core/memory.py checkup     # 真库体检

已知边界

  • 设置页只读写总册;项目册有自己的页签,日志落在项目册里。
  • archive/ 只读:归档要回答「当时为什么这么定」,改了就查不回去了。
  • 角色卡与 agent 是两件事:config.roles 决定「谁在跑」用哪张卡,defaultRole 只做兜底(兜底能读、不能写)。
  • DSH 是唯一支持的宿主。旧版 WorkBuddy 适配器已在 0.6.5 删除。

English

A long-term memory plugin for DeepSeek Harness (DSH).

What it does: injects a Markdown memory library at session start, records which memory files the agent reads, and reminds it at turn end to write conclusions back. Plain Markdown + git — no database, no cloud.

Requires: DSH >=0.1.0-rc.1 <0.3.0, Node.js >=22, and Python 3.10+ (the core is Python, not optional).

dsh plugin --profile desktop add dsh-memory-with-soul
python ~/.dsh/profiles/desktop/node_modules/dsh-memory-with-soul/core/memory.py init

Restart DSH afterwards: a "Memory" entry appears in the sidebar, and new sessions start with a <memory-context> block. The plugin also copies its skills into ~/.dsh/skills/ on load.

Configuration lives in the memory-inject row of your profile's cordis.patch.yml. See the Chinese section above for the full key table.

License

MIT