English · 简体中文
DeepSeek Harness 的三层、可插拔、Agent 驱动记忆系统。
三层记忆 · 九种长期记忆 Provider · 一套受监督工作流
先看能力地图 · 5 分钟开始 · v0.2.13 升级说明 · 观看宽屏实机演示
`dsh-mnemon` 为 DSH 提供统一的记忆控制面，但不要求所有知识进入同一种数据库。运行时记忆让紧凑上下文每轮可用；项目档案保留完整叙事；记忆体按需召回长期证据，底层可选择 **Mnemon、OpenViking、Honcho、Mem0、Hindsight、Holographic、RetainDB、ByteRover 或 Supermemory**。 Mnemon 仍是官方优先的原生引擎。可以替换的是第三层；无论选择哪个 Provider，前两层的存储、工作区和交互心智保持不变。 ## 30 秒理解能力边界 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 | |---|---|---|---| | **运行时** | 偏好、协作规则、项目约定、环境事实 | `USER.md` / `MEMORY.md` 每轮紧凑投影 | dsh-mnemon Host 确定性管理 | | **档案** | 设计、调查、流程、复盘、交接材料 | 先检索，再按需阅读全文 | dsh-mnemon Host 确定性管理 | | **记忆体** | 跨会话事实、决策、实体与关系 | 从已激活记忆体召回有界证据 | Mnemon Native 或三方 Provider | 三层不是同一内容的副本。简单判断规则是：**每轮都需要的放运行时，需要完整阅读的放档案，需要跨任务按需召回的放记忆体。**当前指令、仓库文件与实时工具结果始终高于历史记忆。 ## 点击之后，谁在工作 | 用户操作 | 实际执行方式 | 数据影响 | |---|---|---| | **检索** | 并发调用各 Provider 最快的原生召回路径 | 只读 | | **Agent 查询** | 新建独立顶层任务 Agent，只接收有界证据并组织答案 | 只读 | | **沉淀记忆** / **存入记忆** | 独立任务 Agent 判断、选路、查重、提炼；Host 控制写入 | 只有通过判断才写入 | | **智能选择** | 硬规则先筛选，只有真实歧义才交给任务 Agent | 保存路由回执 | | **AI 维护元信息** | 每个选中记忆体各自启动异步任务，并使用最快采样路径 | 只更新本地标题与说明 | | **归档档案** | 任务 Agent 先建立可检索冷引用，Host 验证后移动原文 | 受监督迁移 | | **本回合记忆** | 展开本轮召回、写入和档案检索；点击条目精确跳转 | 只读 | 这些任务不会复用或挤占主对话历史。默认跟随 DSH 新建会话时的模型路由；也可以在**设置 → 记忆系统 → 后台任务 Agent**单独指定 Provider 与模型。 ## 一套记忆体工作流，九种 Provider | Provider | 形态 | 适合场景 | |---|---|---| | **Mnemon** | 官方原生，本地 CLI + SQLite | 精确写入、实体、类型关系、本地优先共享 | | **OpenViking** | HTTP + `viking://` | 资源树与异步提炼 | | **Honcho** | HTTP workspace / peers | 团队与 Agent peer conclusions | | **Mem0** | Platform 或自托管 HTTP | 已有用户 / Agent 记忆 | | **Hindsight** | HTTP memory bank | bank、实体与 Provider 原生图谱 | | **Holographic** | 本地结构化事实文件 | 可审计事实、信任评分、本地实体 | | **RetainDB** | HTTP project / user | 项目与用户双作用域画像 | | **ByteRover** | 本地 `brv` CLI | 代码知识树与 curate 流程 | | **Supermemory** | HTTP container | 文档摄取与容器级共享 | Provider 能力差异会如实展示：引擎没有图谱边、删除语义或可枚举内容时，dsh-mnemon 不会伪造。**设置页管理可复用的 Provider 服务；记忆体页管理具体实例、激活、作用域与元信息。**三方 Provider 默认关闭。 完整差异见 [Provider 能力与部署矩阵](./docs/zh-CN/memory-providers.md)。 ## 真实 WebUI 演示 下面约 55 秒的素材来自真实的 1600×900 DSH WebUI：在完整上下滑动、页面切换、Provider 卡片、弹窗、按钮状态变化和 Agent 答案上都保留了更清晰的停留，并包含一次真正完成的只读 Agent 查询。可能改变数据的确认按钮都没有提交。  [观看 1600×900 MP4](https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4) · [按页面查看交互指南](./docs/zh-CN/ui-guide.md) ## 5 分钟开始使用 ### 1. 安装 Mnemon Native Mnemon 是默认引擎，也是最简单的本地优先起点： ```sh # macOS brew install --cask mnemon-dev/tap/mnemon # macOS / Linux，也可以通过 Go 安装 go install github.com/mnemon-dev/mnemon@latest mnemon --version ``` Windows 推荐安装 v0.2.3 或更高版本的官方 ZIP；标准安装目录与 checksum 步骤见[快速开始](./docs/zh-CN/getting-started.md#2-安装-mnemon)。 ### 2. 安装 DSH 插件 ```sh dsh plugin --profile web add dsh-mnemon dsh --profile web ``` DSH 各 profile 的插件清单彼此独立。一次性 Headless 任务需要单独安装： ```sh dsh plugin --profile headless add dsh-mnemon dsh --profile headless "回答前先检查持久化的项目上下文。" ``` 本地开发检出使用绝对路径： ```sh dsh plugin --profile web add "link:/absolute/path/to/dsh-mnemon" dsh plugin --profile headless add "link:/absolute/path/to/dsh-mnemon" ``` ### 3. 完成第一次验证 1. 打开**记忆系统 → 状态**，确认 dsh-mnemon、Mnemon Native、运行时、档案和已启用 Provider 正常； 2. 打开**记忆体 → 概览 → 创建记忆体**，人工选择一个已启用 Provider； 3. 通过**沉淀记忆**提交一条稳定、未来仍有用的候选； 4. 在**检索**先执行直接检索，再对同一个问题执行**Agent 查询**； 5. 回到对话，展开**本回合记忆**并点击一个具体工具条目。 一级页顺序刻意保持稳定：**状态、运行时、档案、记忆体**。 ## 沿用熟悉心智，扩展底层能力 ### Agent 驱动的记忆操作 | 受监督沉淀 | 有界 Agent 查询 | |---|---| | [](https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/screenshots/remember-dialog.png) | [](https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/screenshots/recall-agent-answer.png) | 工作台会在调度前明确展示任务边界，并把返回答案与本次证据范围放在一起。对话内的“本回合记忆”和“存入记忆”仍默认开启，可在**设置 → 记忆系统 → 对话界面**分别关闭。 ### 人工创建与策略选路 | 明确选择底层 | 智能路由后续沉淀 | |---|---| | [](https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/screenshots/memory-space-create-dialog.png) | [](https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/screenshots/distillation-strategy.png) | 手动创建记忆体始终由用户明确选择。智能选择属于“沉淀策略”：硬规则定义候选范围，策略 Prompt 只在多个候选都合格时帮助任务 Agent 决策。 ## 全局、工作区与自定义 | 范围 | 行为 | |---|---| | `global` | 使用 `~/.mnemon`，适合多个工作区和本机 Agent 共享控制面 | | `workspace` | 使用 `