dsh-soul-forging: Markdown long-term memory and soul forging process for AI

`dsh-soul-forging` is a DSH memory plugin maintained by Fqingwan. It provides long-term memory for agents using pure Markdown, along with a "soul forging" process. It is purely local, has zero dependencies, runs on a single Python 3 installation, and requires no server or database. Memory is divided into three layers: per-round injection (`SOUL`, `MEMORY`, `index`, `NOW`), on-demand retrieval of the "cerebellum" (`brain/entries.json`), and the `docs` directory (not injected into context). It performs time decay based on the `salience` field, distinguishing between "soul-forget" (soft delete, original content retained) and "soul-purge" (hard delete, re-generates git). Personality consists of only two layers: the essence written in `Soul.md` and a commentary layer recording "how I am now" in the first person; these are modified separately. Personality supports three initialization modes: `full`, `memory-only`, and `external`. Empty templates are never injected. Injection has a budget (`bootMaxChars`, default 20,000 characters); if exceeded, a list of truncated segments is appended to the end of the injection block, avoiding silent truncation. Multi-device synchronization relies on appending to `live.jsonl`, requiring no central server. It can also be integrated into other agents via `soul-boot` or used as a Python module. The plugin runs with the permissions of the current DSH process; source code and the license should be reviewed before installation.

Read More