三层记忆系统omdsh-dev/dsh-mnemon

dsh-mnemon

English · 简体中文

DeepSeek Harness 的可组合记忆系统。
默认三层记忆 · 来源与策略可组合 · 每回合一个上下文视图

快速开始 ·
观看 v0.5.4 浅色演示（中文界面） ·
制作插件 ·
文档中心

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

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

三层记忆，三种用途

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

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

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

从默认组合开始

先准备兼容的 DSH 宿主（Host）。Mnemon Native 还需要单独安装 mnemon CLI；npm 默认安装包不包含这个二进制，也不会安装三方后端服务。参见各平台安装步骤和已验证的兼容基线。

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

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

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

从 v0.4 升级保留熟悉的配置、数据与工作流。三个可选增强仅在设置 → 记忆系统中透出，不增加 View 页或通用记忆插件管理器。升级清单。

锁定的开发基线为 DSH 0.1.5-rc.1；其他经过验证的版本记录在兼容性矩阵。现有会话若报 source summary requires notice form，需要显式执行 dsh-mnemon-repair-session --input FILE --output NEW_FILE 生成修复副本；替换任何文件前请阅读旧会话恢复流程。

Source + Strategy → View

来源事实经策略组合与核心校验，形成交给 DSH 宿主的唯一上下文视图

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

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

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

官方插件

Starter 随附 3 个 Source、1 个默认 Strategy、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-auto-capture | 当前回合中主动记录有用事实的指引 | 关闭 |
| dsh-mnemon-strategy-light-context | 所有选中 Source 共享的常驻投影上限 | 关闭 |
| dsh-mnemon-strategy-scoped | 有序选择 Source，并限定可写子集 | 关闭 |

三个增强使用默认 Strategy 的不同槽，可以共存，最终仍输出一个 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 一致性验证。开发指南 · 素材来源。