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

dsh-memory-with-soul

Installation

README