dsh-mnemon Documentation
September 4, 2026 · View on GitHub
简体中文 | English | Project home
This hub is organized by what you need to accomplish. New users should follow Getting Started, then use the visual guide for the interface. Existing v0.2.x users can go directly to the v0.3.0 release notes; reference documents are for deployment, integration, and development work.
New-user path
- Capability map: understand the three tiers, nine Providers, and which clicks start independent task Agents in 30 seconds.
- Roughly 55-second widescreen live demo: see paced full-page scrolling, Provider and dialog interactions, and a completed read-only Agent Query.
- Getting Started: install Mnemon and the plugin, choose storage, and complete first-run verification.
- Sidebar and conversation UI guide: learn Status, Runtime, Documents, Memory Spaces, and in-conversation entry points.
- Project overview: understand the three-tier model, cross-agent sharing boundary, read/write boundaries, and complete flow.
Find a task
| I want to… | Document |
|---|---|
| Grasp the current product scope and composable architecture | Capability map · Architecture |
| Decide which tier should retain something | Storage and the three-tier model |
| Choose, configure, or compare a Memory Space provider | Long-term memory providers |
| Share durable memory between DSH and other Mnemon-enabled agents | Project overview: Cross-agent sharing · Configuration: Sharing scope |
| Learn when injection, recall, remembering, and archiving happen | Lifecycle and workflows |
| Configure global / workspace / custom storage, entry placement and visibility | Configuration reference |
| Understand workspace inspection versus the Agent's effective directory | UI guide: Workspace mode |
| Check or update Mnemon and dsh-mnemon | Operations: Version checks and updates |
| Back up, restore, or migrate the complete memory root | Operations: Backup and recovery |
| Publish the WebUI behind a cloud hostname | Operations: Cloud-hosted WebUI |
| Troubleshoot empty recall, misalignment, CLI, or provider errors | Operations and troubleshooting |
Use model tools, /mnemon commands, or internal RPC | Interface reference |
| Understand Host, workers, control plane, and data plane | Architecture |
| Build a Source, Strategy or Memory Spaces Provider plugin | Building Memory Extensions |
| Modify code, screenshots, tests, or releases | Development and verification |
| Upgrade to the current stable release | v0.5.1 release notes |
| Review the preceding release candidate | v0.5.0-rc.1 scope and upgrade notes |
| See planned work | Roadmap |
Core terms
| Term | Code / alternate name | Meaning |
|---|---|---|
| Memory System | 记忆系统 | The complete dsh-mnemon entry in DSH |
| Runtime Memory | USER / MEMORY | Hot memory projected into every turn |
| Project Documents | Documents / 档案 | Managed, searchable project knowledge that keeps full Markdown structure |
| Memory Space | 记忆体 | An independent, activatable, on-demand long-term-memory instance backed by Mnemon or an external Provider |
| Cross-agent memory sharing | 跨 Agent 共享 | Mnemon-enabled agents use the same root and Store to share durable memory, not the complete DSH context |
| Remember | Distill / 沉淀 | Start an independent task Agent for qualification, dedupe, and writing |
| Recall | 召回 | Retrieve bounded evidence from active Memory Spaces |
| Archive | 归档 | Create a cold reference before moving an infrequently used Document out of active storage |
Documentation boundaries
- User documentation targets the Sidebar-first experience, optional shared Builtin placement and composable View architecture; legacy
buildinpreferences are normalized without manual cleanup. - Architecture diagrams describe stable execution boundaries, not live monitoring. Use Status for current counts and versions.
- RPC is an internal Host-to-client protocol, not a promised stable external API.
- There is no formal fixed DSH / Mnemon version matrix yet. Back up and validate in an isolated root before upgrading.