深入浅出 dsh-mnemon 架构:Source、Strategy 与每回合不可变 View 全景指南
深入浅出 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 的有界上下文与交互形态。
整个数据流是一条清晰的单向流水线,如下图所示:
一句话概括: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 实例可以使用同名子节点、各自持有独立目录与凭据。这正是"来源拥有数据"的边界体现。
Strategy 详解:纯函数式的组合提案
Strategy 决定"哪些来源参与本回合、谁常驻、谁可检索、预算与工具如何分配"。它自己不存任何记忆——默认的分层策略(default-three-tier)只是消费 Source 事实、提出 View 提案的普通插件。
它的核心是一个纯函数:
compose(request + facts + 槽贡献) → ViewSpec
Core 会重复执行两次并用规范化 JSON 对比,两次结果不一致就直接拒绝——策略扩展同理(见 composition.ts 中的确定性回放校验)。
- 分层策略(默认):运行时记忆常驻,项目档案与记忆空间按需读取。其检索预算为:一次档案查询共享 4 个结果 / 6000 个内容字符,两次不同的召回查询共享 6 个结果 / 4800 个字符。
- 通用策略(
dsh-mnemon-strategy-general):把全部可用 Source 放进同一份预算,由模型自行路由。
每回合一个不可变 View:它如何被组装
每个回合开始时,Host 向 Core 发起组合请求。compose 的流程大致是:
- 并发收集事实:向每个已安装 Source 询问
facts,得到可用能力、路由与操作(composition.ts); - Strategy 提案:基于 facts 产出
ViewSpec,声明要选哪些 Source、投影模式与字符预算、路由与操作; - Core 校验:实例身份、声明能力、路由/操作是否越权、预算是否超限,逐项核对(normalizeViewSpec);
- 投影与装配:调用被选中 Source 的
project拿到片段与 ReadGrant,最终组装出完整的ComposableMemoryView。
View 的结构包含投影片段、路由、行动提议、留在 Host 侧的 ReadGrant 与一致性信息(view.ts)。组装完成后被 deepFreeze 深度冻结,并带有内容摘要与 viewId——Host 把这份 View 固定(pin)给当前回合:回合内的所有工具调用都走这份 View,新回合并不是"更新"它,而是组合一份新的。
这对用户意味着什么?你在回答下方的回合记忆栏里看到的"本回合读了什么",就是这份 View 的投影;点开任一文档,跳转的就是 View 中路由所指向的 Source。
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,永不导出。从"一次点击"到"可验证的数据与回执"的完整路径见下图,也是官方参考路径的可视化:
如何扩展:标准槽位与独立插件
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"长什么样。




