rainow/dsh-simple-wiki-memory

DSWM — DeepSeek Harness 简易 Wiki 记忆插件

超级简化版 llm-wiki 记忆插件：一个索引文档（自动加载）+ 每个 topic 一个单独 md 文件（需要时才 read），避免啥都往上下文里面塞浪费 token。简单轻量，安装卸载都没有压力，想怎么改就怎么改。

基于 DeepSeek Harness（DSH）原生 dsh-agent-instructions（AGENTS.md）机制的自维护持久记忆系统。无 RAG、无向量库、无运行时 LLM 调用——纯 Markdown + git。

English: README.en.md.

更新记录

v0.1.3（2026-09-10）— 兼容 DSH 0.1.5-rc（含 0.1.3）

- 适配 DSH 0.1.5-rc.2 / 0.1.5-rc.1 / 0.1.5-alpha.x / 0.1.3-alpha.x：peerDependencies 扩展为 ^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.1 || ^0.1.3-alpha.1 || ^0.1.5-alpha.1，覆盖五条发布线（老版本用户不受影响）；
- 逐项对照 dsh-v0.1.5-rc.2 源码验证：session/event + turn/end、agent/pre-step（agent 注入与决策形状不变）、createUserMessage、cordis 4.0.2 prepend、patch insert、dsh.bundle.patch —— 全部兼容；
- 已确认 DSWM 不受 0.1.3/0.1.5 的破坏性变更影响：0.1.3 的 Session persistence SessionHandle 重构、0.1.5 的「移除 ctx.agent」与 Web 插件面板 Slot 迁移，DSWM 均未使用（只用 session/event 与 agent/pre-step 两个钩子）；
- 安装/升级：dsh plugin --profile web add dsh-simple-wiki-memory。

v0.1.2（2026-08-28）— 兼容 DSH 0.1.2-alpha

- 适配 DSH 0.1.2-alpha.1 / 0.1.2-alpha.2：peerDependencies 扩展为 ^0.1.0-rc.7 || ^0.1.1-rc.2 || ^0.1.2-alpha.1，覆盖 0.1.0-rc.7+ / 0.1.1-rc.2+ / 0.1.2-alpha.1+ 三条发布线；
- 运行时 API（session/event、agent/pre-step、消息构造、cordis patch 等）已对照 dsh-v0.1.2-alpha.2 源码逐项验证，无破坏性变更；
- 安装/升级：dsh plugin --profile web add dsh-simple-wiki-memory（npm 源自动取最新版）。

v0.1.1（2026-08-25）— 首个 npm 发布

- 发布到 npm（dsh-simple-wiki-memory），支持 dsh-market 版本显示与自动更新；新增 GitHub Actions 自动发布（打 v* tag 即发布）；
- 适配 DSH 0.1.1-rc.2：peerDependencies 覆盖 0.1.0-rc.7+ 与 0.1.1-rc.2+；
- README 补充与 liangshen / Anchored Standard 锚定模式的兼容性说明。

v0.1.0（2026-08-18）— 初始版本

- 六分支记忆规则系统：索引自动注入 + 每主题一个 md 按需读取；pending → reference → archive 三区 + memory-log 审计 + git 自动备份；
- 运行时钩子：回合结束自动 commit、会话开始 pending 汇报；
- AGENTS.md 只合并不覆盖，卸载保留全部数据。

简介 — 解决什么问题？

长期记忆多但不费 token。 如果把所有记忆一股脑塞进提示词，记忆越多每个会话烧的 token 越贵。DSWM 默认只加载索引（小、每个会话自动注入），主题文件在任务需要时按需读取。

轻量，不上重型机制。 LLM-Wiki 那套系统功能强但重、维护困难，对大多数用户没必要。DSWM 的所有记忆就是简单的 .md 文件——手动改、或让 agent 改都行，所见即所得。

记忆跨 harness 共享。 长期记忆应该属于你，而不是属于某一个 harness。DSWM 的纯 md 记忆文件随时可以共享给其他 harness 使用——只需要把对应 harness 的 AGENTS.md（或等效文件）指向它即可。

功能

DSH 在每个会话第一个请求前自动注入 ~/.dsh/AGENTS.md（记忆索引 + 规则）。DSWM 维护该文件和一个小型 wiki 库：

~/.dsh/
├── AGENTS.md              # 索引 + 六条维护规则（自动注入每个会话）
└── workspace/             # 记忆库（git 仓库）
├── reference/         # 已确认记忆主题（进索引、参与检索）
├── pending/           # 待确认草稿（不参与检索，等你说"存档"）
├── archive/           # 过时主题（保留、不参与检索）
└── memory-log.md      # 追加式操作日志（审计 + 新鲜度）

reference/ 里就是按主题命名的 md 文件，一个主题一个文件，像这样：

reference 目录示例

每个文件是一个主题的完整细节（如 DOCKER-NAS.md、INFRA-SERVERS.md、HOME-ASSISTANT-CONTROL.md），由 AGENTS.md 索引条目指向；任务需要时才 read 对应文件，平时只加载索引，不占上下文。

六条规则（全在 AGENTS.md，注入每个会话）
1. 写入触发（实时捕捉） — 会话过程中产生值得记住的信息立即写入（不等待会话结束、不默默丢弃）。写入是实时的（直接进 pending/），确认是延迟的（下次会话开始时汇报）——/new 或关闭页面都不会丢失。
2. 准入流程 — 未确认 → pending/；说“存档/确认” → 晋升到 reference/ + 更新索引 + 记日志。TTL：交互 7 天 / 无人值守 30 天。
3. 无人值守会话（task-board 定时、后台 subagent）— 只写 pending/，不自动晋升。
4. 定期整理 — 说“整理记忆” → agent 输出重组方案（拆分/合并/改名/归档），你确认后执行，过时内容进 archive/。
5. 备份 — workspace/ 是 git 仓库；记忆变更后自动 commit。
6. 检索 — 先查索引；无匹配则扫 reference/ 目录兜底，绝不直接认定“没有记忆”。

兼容性

- 已用 DSH 0.1.5-rc.2（源码对照验证）与 0.1.1-rc.2（web profile 实测）验证；peerDependencies 覆盖 0.1.0-rc.7+ / 0.1.1-rc.2+ / 0.1.2-alpha.1+ / 0.1.3-alpha.1+ / 0.1.5-alpha.1+ 五条发布线。
- 最后验证日期：2026-09-10。
- 依赖 DSH 原生 dsh-agent-instructions 机制（dsh-base bundle 默认启用）；若你的部署禁用了它，记忆注入将不生效。

与锚定模式的已知冲突（liangshen / Anchored Standard）

liangshen 模式（梁神模式）和 Anchored Standard 模式会在会话首轮清空运行时上下文、只保留你的直接消息，从而屏蔽 dsh-agent-instructions 对 ~/.dsh/AGENTS.md 的自动注入。DSWM 的记忆索引与六条规则正是靠这个注入生效的，因此在上述模式下，会话开头不会自动加载记忆。

这不是 bug，而是锚定模式的刻意设计（用最小上下文锚定推理轨迹）。解决方式很简单：

- 需要读取/维护记忆时，手动让 agent 读 AGENTS.md 即可，例如说：
- 先读一下 ~/.dsh/AGENTS.md 再开始
- 或直接说 按 AGENTS.md 里的记忆规则处理
- liangshen 模式在首块锚定晋升（进入“we can”模式）后，也可以手动让 agent 读 AGENTS.md，之后记忆规则即按 DSWM 正常运作。
- 其余会话（非锚定模式）不受影响，记忆照常自动注入。

安装

方式一：npm（推荐，支持自动更新）

dsh plugin --profile web add dsh-simple-wiki-memory

本包已发布到 npm。dsh-market 插件市场会显示版本号并自动检测更新（新版本发布满一天后提示更新）；也可以随时手动 dsh plugin --profile web add dsh-simple-wiki-memory 拉最新版。

方式二：GitHub（源码安装）

dsh plugin --profile web add github:rainow/dsh-simple-wiki-memory

方式三：交给 agent 安装

直接把下面的链接丢给 DSH 会话里的 agent，让它帮你安装即可：

https://github.com/rainow/dsh-simple-wiki-memory

agent 会执行 dsh plugin --profile web add dsh-simple-wiki-memory，并完成首次同步。

首次启动自动：同步 AGENTS.md 骨架、创建 vault 目录、git init workspace/。幂等、只合并、绝不覆盖你已有的 ~/.dsh/AGENTS.md 索引条目。

卸载

dsh plugin --profile web remove dsh-simple-wiki-memory

移除插件会停止运行时钩子（自动 commit、pending 汇报），但保留你的数据：~/.dsh/AGENTS.md 和 ~/.dsh/workspace/ 不会被删除。六条规则仍留在 AGENTS.md（它是 agent 遵循的纯文本）；想彻底移除就手动删掉那段。

快速上手

1. 安装（见上）；首次启动自动创建 vault。
2. 任何会话里让 agent 记住某事——它会写入 pending/。
3. 说 “存档/确认” → 把 pending 草稿晋升为正式记忆。
4. 说 “整理记忆” → 触发重组流程（执行前需你确认）。
5. 自带 memory-query 技能处理检索（含目录扫描兜底）。

下次新会话开始时，agent 会自动提醒你待确认的记忆（写入是实时的，所以 /new 或关页面都不丢）：

pending 汇报示例

配置

v0.1 无用户可见配置项，默认值安全。计划（v0.2）：settings 段提供 TTL 天数、自动 commit 开关、记忆目录路径。

权限与数据

- 文件：读写 ~/.dsh/AGENTS.md 和 ~/.dsh/workspace/（创建 reference/、pending/、archive/、memory-log.md；把规则段合并进 AGENTS.md——绝不覆盖你的索引条目）。
- 命令：在 ~/.dsh/workspace/ 内执行 git init / add / commit（自动备份）。
- 无网络、无凭据、无遥测。
- 读取记忆在任何沙箱模式下都可行（DSH 的 read 从不被沙箱限制）。写入 ~/.dsh/workspace/ 需要 danger-full-access，或 workspace-write + 按需批准升级。

故障排查

- 自动 commit 不生效：检查 ~/.dsh/workspace/.git 是否存在；若 git 不可用，插件会优雅降级（记忆仍工作，只是没有备份）。
- 记忆未注入：确认你的 profile/preset 启用了 dsh-agent-instructions（它负责自动加载 AGENTS.md）。
- 回滚：vault 是 git 仓库——git -C ~/.dsh/workspace log / git -C ~/.dsh/workspace reset --hard 。

开发

node --check lib/index.js   # 语法检查

包结构：lib/index.js（同步 + 钩子）、assets/（AGENTS.md / memory-log 模板）、skills/memory-query/。采用 DSH bundle 分发模型（dsh.bundle.patch → cordis.patch.yml）。

License

MIT