@nanmicoder/dsh-memory
DeepSeek Harness 的长期记忆系统：基于会话日志的两阶段提取/整合流程，支持摘要注入和记忆工具
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yan5236/dsh-memory#a05ca71a1caa073d88aee55ec6be1e55a93eaa3eMemory 以 @nanmicoder/dsh-memory 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 简体中文
dsh-memory · Long-term memory plugin for DeepSeek Harness
A two-phase memory pipeline (per-session extraction → global consolidation), a summary that is always injected into new sessions, and four on-demand retrieval tools.
Without memory, every session restates user preferences and re-steps known landmines.
dsh-memory extracts durable knowledge from finished sessions and periodically consolidates it
into a dense navigation summary (injected into every session) plus a grep-friendly handbook, so
future sessions need fewer repeated instructions, waste fewer tool calls, and avoid known
failure modes.
The design is adapted from the Codex memories system (two-phase extraction/consolidation, three-layer artifact layout, job claims, cooldown, redaction) and re-composed for DSH: no SQLite, no git baseline, no resident consolidation subagent.
raw_memory + rollout_summary + slug). Low-signal sessions produce an empty no-op.MEMORY.md (handbook) and memory_summary.md (dense index, exact v1 first
line); raw input is rotated into an archive and never consolidated twice.memory_summary.md (hard size cap) is injected through the
system prompt of every session — zero effort for the model to see the index.memory_list / memory_read / memory_search / memory_add
(writes only on explicit user request).turn end ──► Phase 1 (per session) ──► rollout_summaries/<slug>.md + raw_memories.md
│
(cooldown elapsed / new memories)
▼
Phase 2 (global)
│
┌─────────────────────────────┴────────────────────────────┐
▼ ▼
memory_summary.md (injected into every session) MEMORY.md (searched on demand)
[!NOTE] Requires DeepSeek Harness.
Naming:
@nanmicoder/dsh-memoryis the package identifier (@nanmicoderis the npm-style scope,dsh-memorythe name). This plugin is distributed via GitHub (not npm):
dsh plugin --profile web add 'git+https://github.com/yan5236/dsh-memory.git#main'
Then verify the composition and start:
dsh --profile web --dump-config
dsh web
Open Settings → Long-term memory. Memory files live in $DSH_HOME/memories/ by default.
[!TIP] If
dump-configdoes not contain the- id: dsh-memoryrow, the package is missing from the profile'sdsh.profile.bundlesarray (the bundle patch layer is not applied) — add"@nanmicoder/dsh-memory"to that array.
Copy the whole block and paste it into a DSH conversation; the agent installs, registers, and verifies the plugin for you:
Please install the DSH long-term memory plugin `dsh-memory` into the `web` profile.
GitHub repo: https://github.com/yan5236/dsh-memory
Requirements:
1. Run: dsh plugin --profile web add 'git+https://github.com/yan5236/dsh-memory.git#main'
2. Check $DSH_HOME/profiles/web/package.json: dependencies should include
"@nanmicoder/dsh-memory", and the dsh.profile.bundles array should contain
"@nanmicoder/dsh-memory" (add it if missing — without it the plugin's patch layer
is not applied).
3. Run: dsh --profile web --dump-config — confirm the output contains "- id: dsh-memory"
with no errors.
4. Restart DSH: stop the running `dsh web` process, then run `dsh web` again.
5. Verify: the settings page shows "Long-term memory", and the session tool list contains
memory_list / memory_read / memory_search / memory_add.
6. If any step that writes into the DSH profile directory ($DSH_HOME/profiles) is blocked
by a permission policy, ask the user to switch to Full access or approve the operation —
do not bypass it or fail silently.
The composition config provides the base layer (the bundled config: {} uses all defaults);
the settings page overrides common entries and persists them to DSH storage:
- id: dsh-memory
config:
memoryRoot: C:/path/to/memories # default $DSH_HOME/memories
provider: deepseek-official # optional: pin the pipeline model route
model: deepseek-v4-flash # paired with provider
consolidationCooldownMs: 21600000 # consolidation cooldown (6 h default)
idleDebounceMs: 180000 # post-turn idle window (3 min default)
maxRolloutsPerRun: 3 # sessions extracted per run
maxSummaryChars: 8000 # injected-summary character cap
See README_ZH.md for the full option table.
<memoryRoot>/
├── memory_summary.md # injected navigation summary (first line `v1`)
├── MEMORY.md # handbook: preferences, procedures, failure shields
├── raw_memories.md # Phase 1 output awaiting consolidation
├── raw_memories.archive.md # rotated history of consolidated raw blocks
├── rollout_summaries/ # per-session recaps (evidence layer)
├── skills/ # reusable procedures promoted by consolidation
└── extensions/ad_hoc/notes/ # user-requested ad hoc notes
pnpm install
pnpm verify
git diff --check
Design and decisions: DESIGN.md.