omdsh-dev/dsh-mnemon

运行时上下文、可检索档案和长期证据，使用同一个熟悉的侧栏（Sidebar）。默认安装包（Starter）安装经过验证的插件组合；贡献者可以独立替换或扩展其中的部分。

自动空闲审查默认使用有界 spawn 检查点、至少五分钟间隔与每个加载会话最多 20 次尝试，并提供独立开关。已发布的 Agent Teams 工具冲突会在创建子 Agent 前暂停审查；失败运行保留已提交回执元数据且不自动重放。详见审查配置与兼容性。

三层记忆，三种用途

记忆	适合保存	如何进入 Agent 上下文
运行时	偏好、协作约定、下一轮就需要的事实	紧凑的 USER / MEMORY 投影
档案	设计、调查、流程和交接材料	先检索，再阅读相关叙事
记忆空间	长期事实、决策、实体与关系	从已启用后端按需召回证据

记忆空间（memory space） 是由 Provider 承载、可以独立命名和激活的长期证据范围，其中包含多条具体记忆。

Sidebar、对话工具与 Headless 使用同一套数据。全局、工作区、集中工作区与自定义范围明确可选。直接检索不创建 Mnemon 任务 Agent；Agent 查询、语义写入和整理可能使用已配置的模型。流程与调用开销。

从默认组合开始

先准备兼容的 DSH 宿主（Host）。运行时记忆与项目档案开箱即用。记忆空间使用你设置好的任一 Provider：Mnemon Native 使用单独安装的 mnemon CLI，其他 Provider 连接各自的服务。npm 默认安装包两者都不包含。参见各平台安装步骤和已验证的兼容基线。

dsh plugin --profile web add dsh-mnemon
dsh web

如需使用 Mnemon Native，用 npm install --global @mnemon-dev/mnemon 安装它的 CLI，并用 mnemon --version 确认。

Headless 使用同一个包：dsh plugin --profile headless add dsh-mnemon。

打开记忆系统 → 状态，然后添加一条运行时记忆。创建档案前先选择 DSH 工作区，全局存储也需要工作区身份。需要长期沉淀时，人工选择 Provider 并创建记忆空间。默认以 Sidebar 展示，可选 Builtin 使用同一组页面。

从 v0.4 升级保留熟悉的配置、数据与工作流。配置位于插件 → 可组合记忆页面，DSH 0.1.7 把插件设置统一放在“插件”中；主策略与三个可选增强也在这里选择，不增加 View 页或通用记忆插件管理器。升级清单。

dsh-mnemon 支持 DSH 0.1.7-rc.2，即锁定的开发基线；更早的宿主请继续使用 v0.5.16。参见兼容性矩阵。现有会话若报 source summary requires notice form，需要显式执行 dsh-mnemon-repair-session --input FILE --output NEW_FILE 生成修复副本；替换任何文件前请阅读旧会话恢复流程。

Source + Strategy → View

• Source（记忆来源） 拥有记忆、投影、读写操作，以及可选的 DSH 页面。
• Strategy（组合策略） 决定可用 Source 如何参与：选择范围、常驻内容、检索与使用指引。纯组合不写入记忆。
• Core（核心） 校验提案，调用 Source 生成有界投影，编译为不可变 View（上下文视图）；DSH Host 将它固定到执行回合，并控制工具访问。

View 不仅包含上下文，也包含 LLM 接下来可以使用的限定范围读取路由与写入操作。它不是另一种数据库，也不是前端页面。记忆空间（Memory Spaces）自行管理后端（Provider）子 Fiber；Core 只提供小型的 ctx.mnemonMemory 贡献服务。

默认插件和外部仓库使用同一套公开契约。Source 作者保留数据与后端选择，Strategy 作者复用这些能力、回合生命周期、预算与测试夹具。完整架构与时序图。

官方插件

Starter 随附 3 个 Source、2 个主策略（同一时间选中一个）、3 个可选增强、9 个 Provider。各包独立版本、独立发布；Starter 固定经过测试的精确组合。

包	职责	默认状态
dsh-mnemon-source-runtime	USER / MEMORY、修订与本地热记忆	启用
dsh-mnemon-source-documents	Markdown、搜索、修订与归档	启用
dsh-mnemon-source-memory-spaces	长期证据及 Source 自有 Provider 子模块	启用
dsh-mnemon-strategy-default-three-tier	分层策略：默认的 View 与回合检索策略	选中
dsh-mnemon-strategy-general	全部可用 Source 共享一份预算，由模型决定如何使用	关闭
dsh-mnemon-strategy-auto-capture	当前回合中主动记录有用事实的指引	关闭
dsh-mnemon-strategy-light-context	所有选中 Source 共享的常驻投影上限	关闭
dsh-mnemon-strategy-scoped	有序选择 Source，并限定可写子集	关闭

在插件 → 可组合记忆页面选择一个主策略及任意增强。增强使用 Core 的标准 selection、projection 与 capture 槽，因此适用于任一主策略并可共存，最终仍输出一个 View。主动记录是指引，不是自主记录器；投影上限不是 token 计费或增量注入；范围组合不创建存储。

Memory Spaces 可使用以下 Provider 插件：

Mnemon Native · OpenViking · Honcho · Mem0 · Hindsight · Holographic · RetainDB · ByteRover · Supermemory。

Native 是默认后端，三方服务需要显式配置和启用。图谱、删除、精确写入与枚举能力保留各后端的真实差异。Provider 能力与部署。

制作自己的组合

通过 dsh-mnemon/extension-sdk 定义 Source 或 Strategy，并注册到所属 Cordis Fiber。可叠加贡献使用目标 Strategy 的 SDK；Memory Spaces 驱动使用 dsh-mnemon-source-memory-spaces/provider-sdk。

个人仓库拥有自己的包清单、公开依赖、实现、测试与构建。DSH Profile/Loader 负责安装和挂载；Mnemon 不扫描任意已安装插件。安装代码、激活贡献、选择完整 Strategy，是不同的决定。

从插件开发指南和外部消费者示例开始，验证独立包、双实例、卸载、限定读取与授权写入。Git 或 Notion 集成可以做成新的 Source；这不代表现有所有 DSH 记忆插件都已无缝支持。

欢迎维护独立插件仓库。向本仓库贡献时遵循贡献规范，新能力与 Provider 请先通过 Issue 讨论。

数据与信任边界

• Runtime 与 Documents 保存在本地，Native 默认本地；外部 Provider 使用各自配置的服务与范围。
• 停用参与不擦除记忆，切换存储范围不迁移数据。停用 Provider 可能清理本地目录元信息，但不删除远端数据。
• 已保存的 Provider 凭据留在 Host，不进入 Mnemon Pack；Pack 仍包含私有记忆，需要妥善保护。
• Source 与 Strategy 是受信任的同进程 JavaScript，不是沙箱代码。历史记忆不能覆盖当前指令，模型生成的插件不会自动安装。

备份与恢复 · 安全策略 · 发布历史 · 路线图

开发与验证

pnpm install --frozen-lockfile
pnpm verify
pnpm verify:plugins

使用 Node.js ^22.19.0 || >=24.0.0 与 pnpm 10.13.1。各包可以独立验证；WebUI 素材来自临时数据和真实 DSH Host。机制测试不等于 LLM 准确度或真实云 Provider 一致性验证。开发指南 · 素材来源。