深入浅出 dsh-mnemon 架构:Source、Strategy 与每回合不可变 View 全景指南

原创2026-10-30 17:23:471,950 阅读
文章标签:dsh-plugin人工智能AI 应用Agent 记忆AI Agent插件系统

深入浅出 dsh-mnemon 架构:Source、Strategy 与每回合不可变 View 全景指南

dsh-mnemon 是 DeepSeek Harness(DSH)的可组合视图记忆系统:它用 Source(记忆来源)拥有记忆、用 Strategy(组合策略)决定每回合如何取用、再把结果编译成一份不可变 View 交给模型。这套设计让 Agent 的记忆分层、可见、可组合,开箱即用还提供分层记忆与自进化技能——不再每次会话从零开始,也不再把全部记忆一次性灌进上下文。

架构全景:Source、Strategy、Core 与 View 四步流水线

dsh-mnemon 的可组合视图记忆只有三个主要业务概念:

  • Source(记忆来源):拥有记忆及其操作;
  • Strategy(组合策略):提议可用的 Source 如何参与一个回合;
  • View(上下文视图):特定范围和场景下交给 LLM 的有界上下文与交互形态。

整个数据流是一条清晰的单向流水线,如下图所示:

dsh-mnemon 可组合视图记忆架构:Source 来源的事实经 Strategy 策略提案、Core 核心校验后,生成每回合唯一的不可变 View 交给 DSH 宿主

一句话概括:Source 出事实,Strategy 出提案,Core 做校验,View 定生死。官方完整说明见 docs/zh-CN/development/architecture.md。

Source 详解:记忆的权威持有者

Source 负责记忆的格式、事务、存储与读写。谁的数据、怎么存、怎么查,只有它说了算。默认 Starter 装有四个 Source:

Source 角色 默认 View 贡献
dsh-mnemon-source-runtime 运行时记忆:USER.md / MEMORY.md 偏好与工作约定 每回合常驻注入(eager 精确上下文)
dsh-mnemon-source-documents 项目档案:Markdown 文档、索引、搜索、修订与归档 有界封面 + 按需搜索路由
dsh-mnemon-source-memory-spaces 记忆空间:Provider 支撑的长期证据与实体关系 有界封面 + recall / related 路由
dsh-mnemon-source-skills 技能管理:版本、自进化、回测与市场 无:只供管理,不进入 View

每个 Source 在自己的 manifest 中声明 typeId、role、capabilities 与一致性模式(exact-snapshot 精确快照,或 namespace-pinned-live-read 命名空间固定的活读),运行时则实现 facts 与 project 两个核心方法:facts 返回当前可用能力、路由与操作;project 按预算投影出投影片段和不透明 ReadGrant。接口定义见 view.ts。

值得强调的一点:Memory Spaces 的 Provider(如 Mnemon Native、Mem0、Honcho 等九个插件)运行在记忆空间 Source 内部,由 Source 自己定义子模块协议——不存在全局 Provider 注册表,两个 Source 实例可以使用同名子节点、各自持有独立目录与凭据。这正是"来源拥有数据"的边界体现。

dsh-mnemon 记忆空间页面:由 Provider 承载的长期证据以实体关系图谱呈现,可按内容检索并围绕实体展开

Strategy 详解:纯函数式的组合提案

Strategy 决定"哪些来源参与本回合、谁常驻、谁可检索、预算与工具如何分配"。它自己不存任何记忆——默认的分层策略(default-three-tier)只是消费 Source 事实、提出 View 提案的普通插件。

它的核心是一个纯函数:

compose(request + facts + 槽贡献) → ViewSpec

Core 会重复执行两次并用规范化 JSON 对比,两次结果不一致就直接拒绝——策略扩展同理(见 composition.ts 中的确定性回放校验)。

  • 分层策略(默认):运行时记忆常驻,项目档案与记忆空间按需读取。其检索预算为:一次档案查询共享 4 个结果 / 6000 个内容字符,两次不同的召回查询共享 6 个结果 / 4800 个字符。
  • 通用策略(dsh-mnemon-strategy-general):把全部可用 Source 放进同一份预算,由模型自行路由。

dsh-mnemon 插件页的记忆组合面板:主策略选择器、运行时记忆/项目档案/记忆空间三个来源的开关,以及主动记录、轻量上下文等增强项

每回合一个不可变 View:它如何被组装

每个回合开始时,Host 向 Core 发起组合请求。compose 的流程大致是:

  1. 并发收集事实:向每个已安装 Source 询问 facts,得到可用能力、路由与操作(composition.ts);
  2. Strategy 提案:基于 facts 产出 ViewSpec,声明要选哪些 Source、投影模式与字符预算、路由与操作;
  3. Core 校验:实例身份、声明能力、路由/操作是否越权、预算是否超限,逐项核对(normalizeViewSpec);
  4. 投影与装配:调用被选中 Source 的 project 拿到片段与 ReadGrant,最终组装出完整的 ComposableMemoryView。

View 的结构包含投影片段、路由、行动提议、留在 Host 侧的 ReadGrant 与一致性信息(view.ts)。组装完成后被 deepFreeze 深度冻结,并带有内容摘要与 viewId——Host 把这份 View 固定(pin)给当前回合:回合内的所有工具调用都走这份 View,新回合并不是"更新"它,而是组合一份新的。

这对用户意味着什么?你在回答下方的回合记忆栏里看到的"本回合读了什么",就是这份 View 的投影;点开任一文档,跳转的就是 View 中路由所指向的 Source。

dsh-mnemon 对话界面:回合记忆栏逐条列出本回合读取的运行时记忆、项目档案检索与记忆空间召回结果,与不可变 View 的投影一一对应

View 的有界预算与安全边界

"有界"是 View 的一等公民。默认预算如下:

预算字段 默认值 含义
maxProjectionCharacters 64 KiB 常驻投影的字符上限
maxRoutes / maxActions 16 / 16 路由与行动提议数量上限
maxEvidenceResults 16 单次读取返回的证据条数
maxEvidenceCharacters 16 KiB 单次读取证据的字符上限

定义见 DEFAULT_MEMORY_VIEW_BUDGET。每次路由执行都绑定"哪个 View 的哪条路由"并按次计数,预算耗尽即拒绝;并发回合各持独立台账,父子 Agent 不能互相借用读取授权(grant)。

写入同样受控:必须走 View 提供的 ActionOffer 并经 Host 授权回调,成功后 Source 返回回执(Receipt),明确区分 succeeded / partial / failed / cancelled,绝不混为一谈。ReadGrant 是不透明令牌,只留在 Host 侧,模型永远看不到其载荷;Provider 凭据只保存在 Host,永不导出。从"一次点击"到"可验证的数据与回执"的完整路径见下图,也是官方参考路径的可视化:

dsh-mnemon 从一次点击到可验证的数据与回执:确定性只读、Agent 查询取证、受监督写入与维护归档四条路径均经过 Host 权限边界与 revision 栅栏

如何扩展:标准槽位与独立插件

Source、Strategy、Provider 与增强全部是普通 DSH 插件,基于公开的 SDK(dsh-mnemon/extension-sdk)定义,各自独立开发、测试与发布。分层策略还开放了三个标准扩展槽,增强插件挂在槽位上即可生效,无需更换主策略:

标准槽 作用 官方插件
selection 显式排序多个 Source 实例并指定可写子集 strategy-scoped
projection 在 Host 预算内为常驻投影加天花板 strategy-light-context
capture 回合内记录指导,提示模型保存值得留存的事实 strategy-auto-capture

Core 只传递有界贡献并执行原有预算/权限校验,不理解这些槽的业务语义——槽的名字与取值结构属于 Strategy,这正是"可组合"的工程含义。

总结与延伸阅读

dsh-mnemon 的架构可以浓缩成三句话:

  • Source 拥有记忆:数据权威永远在来源一侧,Core 不替它做任何存储决策;
  • Strategy 只做提案:确定性纯函数,两次执行结果不一致即被拒绝;
  • View 每回合不可变:有界、可审计、深度冻结,读写授权回合间互不借用。

模型每回合只拿到"必要且有界"的记忆,所有操作都可回放审计,组件还能热插拔——这就是"可组合视图记忆"名字的全部含义。想继续深入,可以从 docs/zh-CN/development/architecture.md 与 扩展开发指南 入手;动手验证可用仓库根目录的 pnpm verify 一键跑完全部机械校验,或运行 node scripts/serve-e2e.mjs --docs-demo 启动带种子项目的本地 WebUI,亲眼看看"每回合一个 View"长什么样。

登录后查看全文
dsh-mnemon