Skip to content
dsh-market Browse plugins GitHub 中文

ICCuse/dsh-file-memory

File-backed working memory: memorize/recall key premises verbatim in a session notes file so they survive context compaction losslessly.

Stars ★ 0 Category Memory Listed 2026-08-14

Install

Inside DeepSeek Harness, with dsh-market

dsh plugin --profile web add dshmarket

Or from the command line

dsh plugin --profile web add github:ICCuse/dsh-file-memory

Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.

README

中文 | English

File-backed working memory for long tasks. Two model-facing tools — memorize and recall — keep key premises as verbatim bytes in a session-scoped notes file inside the workspace, so they survive context compaction losslessly: a summarizer can blur or drop a fact, but a file round-trips it byte-exact.

Why

Compaction checkpoints are LLM-generated and LLM-rewritten generation after generation; the prompt-space "state document" proposals still re-summarize the previous state every pass. Files are the only lossless medium the agent already has: write once, read back exactly. This is the pragmatic complement to prompt-space compaction, usable today on the shipped compaction-basic backend.

Tools

Tool Behavior
memorize(entries) Appends verbatim deduplicated lines to <workspace>/.dsh-notes/<session>.md.
recall(query?) Reads the notes back, optionally filtered to lines containing query; caps output at maxRecallChars.

Both require an agent-backed session and a mounted fs service; they resolve the notes file relative to the session's workspace cwd (falling back to the backend default when the session has no cwd).

Config

Field Default Meaning
maxRecallChars 6000 Recall output cap.
notesDir .dsh-notes Notes directory name inside the workspace; must be a bare directory name.

maxRecallChars must be an integer >= 1; misconfiguration throws at plugin load.

Install

Not on npm yet - install from this repository:

npm install github:ICCuse/dsh-file-memory
# or: pnpm add github:ICCuse/dsh-file-memory

Then mount the bundle (declared in package.json 'dsh.bundle'):

- id: dsh-file-memory
  name: 'dsh-file-memory'

Or, once published, 'dsh plugin --profile web add dsh-file-memory'.

Content from the project README on GitHub ↗