DeepSeek Harness plugin

dsh-memory-boomzika

DSH memory plugin: RRF multi-lane recall / confirm-based writes / Fernet vault / session harvest(DSH 记忆插件:五路 RRF 召回 / 确认制写入 / Fernet 加密库 / 会话转录)

Jump to install

Source facts

Repository
boomzikazita/dsh-memory
Latest update
Aug 20, 2026
Category
Memory
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/boomzikazita/dsh-memory
Plugin: dsh-memory-boomzika
Author: boomzikazita

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-memory

Persistent memory system for DeepSeek Harness (dsh). Provides multi-channel recall, confirmed writes, an encrypted secrets vault, session transcription, and maintenance tooling as a dsh plugin.

> 记忆系统插件:RRF 多路召回 / 确认制写入 / Fernet 加密库 / 会话转录 / 维护工具。

Features

  • RRF 五路召回 (five-way RRF recall) — fuse evidence from L1 rules (MEMORY.md / USER.md), L2 session FTS5, L3 semantic (optional Honcho/MCP), L4 wiki, and L5 time-window sources into a single ranked evidence ledger with per-item trust labels.
  • 确认制写入 (confirm-before-write) — nothing mutates your memory directly: memory_suggest enqueues a proposal, memory_confirm / memory_reject decide it. Budget checks, sensitive-pattern scanning, and automatic trigger: tags guard what lands in L1.
  • Fernet 加密库 (encrypted vault) — secrets live in a Fernet-authenticated encrypted store (VAULT.md.enc); plaintext appears only as → vault:<ref> references.
  • 会话转录 (session transcription) — incrementally indexes dsh session logs into an FTS5 store and extracts correction signals for skill distillation.
  • 维护工具 (maintenance) — health checks, git backups, hit auditing, and an asset de-duplication checker.

Tools

ToolDescription
memory_recallFive-way RRF recall with source labels and trust levels; date= for time-window queries, deep=true for deeper recall
memory_graphEntity graph walk (curated relation edges + automatic co-occurrence edges)
memory_suggestEnqueue a memory write proposal (track: memory / user / skill; lifecycle: rule / stable / situational / record)
memory_confirmAccept a pending proposal into MEMORY.md / USER.md / skill
memory_rejectReject a pending proposal
memory_vault_getRead an encrypted vault entry
memory_vault_setWrite an encrypted vault entry
memory_harvestTranscribe dsh session logs into the L2 FTS5 index and extract correction signals
memory_healthOne-line-per-layer health report (L1 budgets, vault decryptability, L2 index, graph freshness, pending queue)
memory_backupGit commit + push of the memory directory
memory_notifyPush a message to a Feishu/Lark chat (requires credentials, see below)
check_assetsDe-duplication check before creating new scripts/skills/plugins/automations

Installation

dsh plugin --profile web add github:boomzikazita/dsh-memory

The plugin registers its tools and hooks (primer recall injection, write guard, turn-end transcription) automatically. Python scripts under scripts/ are executed on demand by the Node host.

Configuration

The bundle patch (cordis.patch.yml) mounts the plugin with defaults; override per profile, e.g.:

- insert:
    - id: dsh-memory
      name: 'dsh-memory'
      config:
        memoryDir: '~/.dsh/memories'
        # scriptsDir: '~/.dsh/plugins/dsh-memory/scripts'
        # wikiRoot:  '~/wiki'            # env DSH_WIKI_ROOT also works
        # guardBlock: false
        # primerBudget: 800
        # primerTopK: 3

Key paths (all overridable):

SettingDefaultNotes
memoryDir~/.dsh/memoriesL1 files, FTS5 indexes, vault, outbox
scriptsDirplugin scripts/ dirPython helper scripts
wikiRoot / DSH_WIKI_ROOT~/wikiObsidian/wiki root used by the L4 channel (raw/, _meta/, entities/ live under it)

Dependencies

  • Node side: @deepseek-ai/dsh-tools and @deepseek-ai/dsh-llm (declared as peer dependencies, >=0.1.0-rc.6).
  • Python side (optional, for recall/graph/vault/harvest features): Python 3 with the standard library; SQLite 3. The vault additionally requires cryptography (Fernet). If Python is missing, tools degrade gracefully with an error message.
  • Feishu/Lark push (memory_notify / scripts/feishu_push.py): set LARK_APP_ID / LARK_APP_SECRET (env or ~/.env) and optionally LARK_DEFAULT_CHAT for the default chat target.
  • L3 semantic recall (optional): set DSH_HONCHO_MCP_URL / DSH_HONCHO_MCP_TOKEN to an MCP endpoint exposing honcho_search. Unset → L3 silently skipped.

License

MIT — see [LICENSE](LICENSE). Copyright (c) 2026 boomzikazita.