dsh-native-memory
v0.2.0
Published
Native, per-workspace long-term memory for DeepSeek Harness: facts and profiles on DSH's own storage-domain, cross-session recall through session-query FTS, approval-gated writes, and cited provenance — no external server, no extra runtime dependency.
Downloads
912
Maintainers
Readme
dsh-native-memory
Native, per-workspace long-term memory for DeepSeek Harness (dsh): facts and profiles stored on the harness's own storage-domain, cross-session recall through session-query FTS, approval-gated writes, and cited provenance — no external server, no extra runtime dependency.
⚠️ Installing a plugin runs third-party code on your machine with your own permissions. Review the source (
src/) and the security model before installing.
Why this one
| | dsh-hermes-memory | dsh-native-memory |
|---|---|---|
| Storage | ~/.dsh/settings.yaml namespace | dedicated storage-domain unit (~/.dsh/storages/dsh_memory.json) |
| Scope | user-global, all projects | per workspace (exact-cwd authorization) |
| Write safety | silent, model-only | human approval gate + session-log audit |
| Recall | everything always injected (hard caps) | bounded always-on profile plus on-demand recall + FTS over past sessions |
| Dependencies | vendored imports into the harness checkout | none beyond zod + the harness itself |
See docs/design.md for the full architecture and the competitive landscape analysis.
Install
dsh plugin --profile web add dsh-native-memory # npm after release
dsh plugin --profile web add /path/to/this/repo # from a checkoutRestart dsh web. The bundle enables session-query full-text search and adds
the memory tools to every session. Details and configuration:
docs/install.md.
Tools
| Tool | Kind | Gate |
|---|---|---|
| memory_remember | add/update a fact in this workspace | approval |
| memory_edit | replace a fact | approval |
| memory_forget | archive a fact (soft delete) | approval |
| memory_recall | deterministic three-tier keyword scan (tags > text > fuzzy) | none |
| memory_search | FTS over this workspace's past sessions (caller excluded) | none |
| memory_consolidate | near-duplicate merge suggestions + cap budget | none |
| memory_import | import candidate facts from a past session's log | approval (per fact) |
| memory_profile | read the always-injected workspace profile | none |
Every fact records its origin (sessionId, seq) — memory stays
reconstructable from the lossless session log.
Development
pnpm install
pnpm build && pnpm typecheck && pnpm testNew contributors start at docs/handoff.md and docs/contributing.md. Chinese docs: README.zh.md.
