dsh-file-memory

English | 中文

An installable DSH profile bundle for WorkBuddy-style layered memory: global persona and memory files, live explicitly bound workspace memory, skip-aware reminders and background consolidation, hybrid session recall, post-compaction flush, and a bundled usage skill. This repository is the standalone Git distribution of the implementation developed in DeepSeek Harness. Since v1.2.1 the package is published as dsh-file-memory.

Install or remove

The expected user already runs an official DeepSeek Harness source checkout and may already have chats, model/provider settings, workspaces, and a web profile. Stop the running DSH process, then run the install from that same checkout root and from an environment with the same DSH_HOME used to start DSH:

pnpm dsh plugin --profile web add github:aqsk-BLG/dsh-memory#v1.3.2
pnpm dsh --profile web --dump-config
pnpm dsh web

Use github:aqsk-BLG/dsh-memory to follow the repository head, or replace the v1.3.2 tag with an exact commit SHA for the strongest reproducibility. A globally installed CLI may use dsh ... instead of pnpm dsh ....

Once published to npm, the registry package name is dsh-file-memory:

pnpm dsh plugin --profile web add dsh-file-memory

Or install from a release tarball: download dsh-file-memory-1.3.2.tgz from the assets of the v1.3.2 release, then:

pnpm dsh plugin --profile web add ./dsh-file-memory-1.3.2.tgz

Naming note. Since v1.2.1 this package is published as dsh-file-memory. The npm name dsh-memory is a different, unrelated package — do not install that one by mistake.

dsh plugin updates only the existing profile's dependency metadata, lockfile, installed modules, and dsh.profile.bundles list. It does not modify the DSH source tree, create another agent or workspace, or reset existing sessions, models, settings, storage, or workspace registrations. The bundle also leaves dshHome unset, so the plugin uses the exact same single data root as the DSH instance: inherited $DSH_HOME, or DSH's own ~/.dsh default only when that variable is unset. It never opens both roots.

The bundle inserts the memory row and enables the session-query index at $DSH_HOME/session-query.sqlite; later profile and home patches may override either row. The repository commits its built lib/index.js and lib/client.js, so installation does not need a dependency lifecycle build. Remove both the dependency and layer, then restart DSH, with:

pnpm dsh plugin --profile web remove dsh-file-memory

The public repository is discoverable through GitHub's dsh-plugin topic.

Host version support

On load the facade checks the DeepSeek Harness release version against a floor. The version is read from the lockstep @deepseek-ai/* package manifests installed next to the plugin (the official releases all carry the same version string) or from an explicit DSH_VERSION environment variable.

…