dsh-memory

Memory retrieval plugin for DeepSeek Harness (dsh): a wiki double-link memory graph with 9 tools — hybrid search, read, list, link-scan, remember, forget, knowledge compile, graph health-check, and a resident retriever subagent.

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

Features

Plus a system-prompt section with memory-collaboration rules (remember-three-steps, chain-reading, compile-then-review).

Installation

1. Add the plugin to an agent preset

In your preset agent.cordis.yml, register the plugin by absolute path (or package name after publishing):

- id: dsh-memory
  name: /path/to/dsh-memory-plugin/lib/index.js
  # optional overrides (defaults shown below are the built-ins):
  config:
    readHome: ~/.reasonix-local
    writeDir: ~/.dsh/memory/
    scriptsDir: ""        # empty = bundled lib/scripts
    extraReadDirs: []
    retrieverProvider: spawn

2. Layout conventions

The plugin reads a .reasonix-local-style memory home:

<readHome>/
├── projects/
│   └── <any-project>/        # auto-discovered, no hard-coded names
│       └── memory/*.md       # project memories (wiki pages)
└── memory/
    └── global/*.md           # global memories

• readHome default is ~/.reasonix-local; all paths support ~ expansion and ${VAR} environment references.
• If you don't have a Reasonix memory layout, an empty home just reports "empty/unreadable" — you can start writing with memory_remember immediately.

3. Support matrix

• No python: memory_search skips the vector leg and labels results （向量不可用，仅全文） — functionality stays usable (TF-IDF vectors are optional).
• No grep (native Windows): fulltext search, in-edge scan and forget reference scan all fall back to a JS-native substring scan (equivalent to grep -rnF semantics).
• bge model / pylibs: optional. memory_vector.py is zero-dependency (Python stdlib) with a pluggable embed_text(); the semantic model path is only used when the cache is built by your pipeline.

4. Runtime prerequisites

Configuration

config:
  readHome: ~/.reasonix-local      # read source (read-only for dsh)
  writeDir: ~/.dsh/memory/         # dsh write zone (memory_remember/forget)
  scriptsDir: ""                   # override memory-map scripts dir; empty = bundled
  extraReadDirs: []                # extra memory dirs appended after auto-discovery
  retrieverProvider: spawn         # subagent provider for memory_retrieve

Trust boundaries:

• Read tools work directly on readHome; the plugin never writes there.
• memory_remember/memory_forget only touch writeDir.
• memory_compile only produces candidates; you commit them via memory_remember.

Full preset example

# agent.cordis.yml (standard preset + 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"]   # masks codegraph's own memory-* tools

Memory page format

Five-section wiki page (what memory_compile generates and validate checks):

# Title
## 结论（一句话）
## 关键事实
## 路径与方法论
## 关联（双链）
## 元数据（类型/来源/更新/空检索记录）

Double links are [[slug]] references between pages; memory_health measures graph density (target ≥1.5 edges/page, orphans <20%) and multi-hop reachability.

Ecosystem

This is a dsh-plugin for the DeepSeek Harness plugin ecosystem — add the dsh-plugin topic to the repository to be discovered by community directories (e.g. awesome-dsh-plugins, awesome-deepseek-harness).

License

MIT