U-Illll/dsh-memory

dsh-memory

用于 DeepSeek Harness（dsh）的记忆检索插件：一个 wiki 双链记忆图谱，包含 9 个工具——混合检索、读取、列表、链接扫描、记忆、遗忘、知识编译、图谱健康检查，以及一个驻留检索员子代理。

记忆系统插件：为 dsh 提供「wiki 双链记忆图谱」——混合检索（向量+全文）、读写删、知识编译、图谱健康检查、驻留检索员子代理。

功能特性

| 工具 | 作用 |
|---|---|
| memory_list | 列出记忆索引（项目 + 全局 slug） |
| memory_search | 混合检索：语义向量（memory_vector.py hybrid）+ 全文 grep（当 grep 缺失时自动回退到 JS 原生扫描） |
| memory_read | 按 slug 读取记忆页面 |
| memory_link_scan | 双链遍历：入边（引用该 slug 的页面）+ 出边 |
| memory_remember | 将新记忆写入 dsh 写入区（绝不触碰你的读取源） |
| memory_forget | 仅从写入区删除（先进行引用扫描） |
| memory_retrieve | 启动一个驻留检索员子代理（可继续的 spawn + toolFilter 允许列表 + 三阶段报告）；通过 send_message 跟进，可在 dsh 重启后存活 |
| memory_compile | 知识编译器：suggest-links / compile（五段式 wiki 页面或更新差异预览）/ validate / slug-list——仅生成候选，提交前由你确认 |
| memory_health | 图谱健康检查：graph-stats（密度 ≥1.5，孤儿 /
├── projects/
│   └── /        # auto-discovered, no hard-coded names
│       └── memory/.md       # project memories (wiki pages)
└── memory/
└── global/.md           # global memories

- readHome 默认为 ~/.reasonix-local；所有路径都支持 ~ 展开和 ${VAR} 环境变量引用。
- 如果你没有 Reasonix 记忆布局，空的记忆主目录只会报告「空/不可读」——你可以立即用 memory_remember 开始写入。

3. 支持矩阵

| 平台 | 无 python | python3/python/py | + 向量索引（bge 已缓存） |
|---|---|---|---|
| Linux | ✅ 全文（JS 原生扫描） | ✅ TF-IDF + 二元组混合 | ✅ 语义混合（bge-small-zh） |
| macOS | ✅ 全文（grep 或 JS 回退） | ✅ | ✅ |
| Windows（无 grep） | ✅ JS 原生扫描 | ✅ | ✅ |

- 无 python：memory_search 跳过向量分支，并将结果标记为 （向量不可用，仅全文） —— 功能仍可使用（TF-IDF 向量是可选的）。
- 无 grep（原生 Windows）：全文搜索、入边扫描和遗忘引用扫描全部回退到 JS 原生子串扫描（等价于 grep -rnF 语义）。
- bge 模型 / pylibs：可选。memory_vector.py 零依赖（Python 标准库），带有可插拔的 embed_text()；语义模型路径仅在你的流水线构建缓存时使用。

4. 运行时前置条件

| 功能 | 前置条件 |
|---|---|
| memory_retrieve（retriever 子代理） | dsh-subagent 插件系列 + 支持 prepareContinuable 的子代理提供者（默认预设中的 spawn 支持）+ 会话持久化 —— 这些在 dsh 的标准 web 部署中均已具备。没有 agent-presets/subagents 的无头配置会优雅降级（工具返回指引而非抛出异常）。 |
| memory_search 向量分支 | PATH 中存在 python3 / python / py 中的任意一个 |
| codegraph 集成 | 可选；下方预设片段通过 --graph-only 屏蔽 codegraph_memory_ |

配置
yaml
config:
readHome: ~/.reasonix-local      # 读取源（对 dsh 只读）
writeDir: ~/.dsh/memory/         # dsh 写入区（memory_remember/forget）
scriptsDir: ""                   # 覆盖 memory-map 脚本目录；空 = 使用内置
extraReadDirs: []                # 自动发现之后追加的额外 memory 目录
retrieverProvider: spawn         # memory_retrieve 的子代理提供者

信任边界：

- 读取工具直接作用于 readHome；插件从不写入该处。
- memory_remember/memory_forget 仅触及 writeDir。
- memory_compile 仅生成候选项；你通过 memory_remember 提交它们。

完整预设示例
yaml
agent.cordis.yml（标准预设 + dsh-memory + codegraph）
- id: dsh-memory
name: /path/to/dsh-memory-plugin/lib/index.js
config:
readHome: ~/.reasonix-local

- id: mcp-codegraph
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: codegraph
transport: stdio
args: ["--graph-only"]   # 屏蔽 codegraph 自带的 memory- 工具

Memory 页面格式

五段式 wiki 页面（memory_compile 生成、validate 校验的内容）：
markdown
Title
结论（一句话）
关键事实
路径与方法论
关联（双链）
元数据（类型/来源/更新/空检索记录）

双链是页面之间的 [[slug]] 引用；memory_health 衡量图密度（目标 ≥1.5 条边/页，孤儿页 <20%）和多跳可达性。

生态系统

这是面向 DeepSeek Harness 插件生态的 dsh-plugin —— 为仓库添加 dsh-plugin 主题即可被社区目录发现（例如 awesome-dsh-plugins、awesome-deepseek-harness）。

许可证

MIT