前言¶

在 DSH 中处理多轮任务、项目协作或长周期工作时，常见的问题是会话结束后上下文容易丢失：用户偏好、项目约定、已确认决策、踩坑经验没有稳定的跨会话入口。dsh-biomemory 提供一套跨会话记忆能力，把记忆从单条日志扩展为分层存储、审批门控、语义检索、记忆代谢和审计快照的组合流程。

DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍 dsh-biomemory 的定位、核心能力、安装方式和典型用法。

这是什么¶

dsh-biomemory 是 DeepSeek Harness（DSH）的跨会话生物仿生记忆插件。它提供分层记忆、审批门控、记忆代谢、透明快照注入，以及基于 SQLite 与本地嵌入模型的记忆检索。

已核实的基本信息如下：

• 插件名：dsh-biomemory
• 许可证：MIT
• 运行环境：engines.node: >=22.19.0
• 仓库地址：https://github.com/KLRSL/dsh-biomemory
• 社区目录页：https://www.skillhub.cn/plugins/KLRSL/dsh-biomemory
• 当前版本信息：0.5.2

插件依赖与 DSH 相关包的兼容关系如下：

{
  "engines": {
    "node": ">=22.19.0"
  },
  "peerDependencies": {
    "@deepseek-ai/cordis": "^4.0.1",
    "@deepseek-ai/dsh-session": ">=0.1.0-rc.5",
    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.5"
  },
  "dependencies": {
    "@huggingface/transformers": "^4.2.0"
  }
}

在 web 平台启用时，DSH client 会注入以下包：

@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-ui-settings
@deepseek-ai/dsh-client-ui-slots

核心能力¶

分层记忆布局¶

dsh-biomemory 使用 ~/.dsh/memory/ 下的分层结构保存不同优先级的记忆。已核实的布局包括：

~/.dsh/memory/
├── preferences.md
├── hot/
├── projects/<name>/
├── longterm/
├── archive/
├── backups/
├── audit.log
└── audit.jsonl

对应能力包括：

• 用户与项目偏好：preferences.md
• 热点知识与行为：hot/
• 项目上下文：projects/<name>/
• 长期记忆：longterm/
• 代谢归档：archive/
• 备份目录：backups/
• 审计日志：audit.log 与 audit.jsonl

在 SQLite 数据层中，数据库文件位于：

~/.dsh/biomemory/biomemory.db

本地嵌入模型位于：

~/.dsh/models/

冻结快照注入¶

会话启动时，dsh-biomemory 会注入冻结快照。已核实的优先级逻辑是：

1、置顶记忆（pinned memories）和用户偏好优先。
2、随后注入近期知识或行为记忆。

这样可以减少模型在每次会话中反复猜测用户偏好的成本。

审批门控¶

重要记忆会经过审批门控。已核实的策略包括：

• 重要记忆通常需要人工审批。
• 普通事实可以自动保存。
• 审批通道不可用时，行为由 approvalFallback 控制。
• approvalFallback 默认为 auto。
• 可切换为 deny，以保持 fail-closed 行为。

如果审批不可用时使用默认 auto，重要记忆可能按降级策略自动保存，并记录降级审计。

记忆工具与命令¶

插件提供 memory 工具，支持以下动作：

add / query / update / remove / list / pin / unpin / dream / audit

也提供 /memory 命令，支持：

list / query / add / edit / remove / pin / unpin / dream / audit

跨会话回忆可以使用 memory_recall 工具，适合“你记得之前怎么约定的吗”这类场景。

去重使用内容指纹（content fingerprint），避免重复条目。

SQLite 数据层与检索¶

dsh-biomemory 的 SQLite 数据层使用 Node 内置 node:sqlite，并启用 WAL 模式。已核实的信息是：该 SQLite 数据层不引入外部运行时依赖。

本地嵌入模型为：

bge-small-zh-v1.5

该模型为 512 维量化 ONNX 模型，通过 transformers.js 调用。

已核实的检索模式包括：

exact keyword
semantic vector
hybrid RRF fusion

如果嵌入模型不可用，检索会退化为 keyword-only；记忆功能本身不受影响。

Markdown 自动迁移¶

插件支持从既有 Markdown 记忆自动迁移到 SQLite。已核实的迁移行为是：

• 首次启动时一次性导入既有 ~/.dsh/memory 条目。
• Markdown 保留为只读备份。

记忆代谢（Dream）¶

记忆代谢通过 /memory dream 或 memory action=dream 触发。已核实的代谢能力包括：

• 半衰期衰减
• 引用巩固
• 冲突浮出
• 冷归档

代谢过程支持断点续跑（checkpointing），可在中断后从最后检查点继续。

实际运行前，插件会自动备份整个记忆存储到 backups/<timestamp>/。启动自检如果发现主记忆文件损坏，会从最新备份自动恢复。回滚事件会记录为 ROLLBACK 审计事件。

审计与回滚¶

审计日志使用结构化 JSON Lines。已核实的审计能力包括：

• 按动作聚合
• 按日期聚合
• 按条目聚合
• 记录回滚事件
• 记录恢复事件

单条回滚支持以下方式：

memory action=restore fp="..."
/memory undo <fp>
POST /entries/restore

冲突浮出与深度反思¶

当行为记忆与用户偏好冲突时，插件会把冲突条目置顶展示，而不是静默处理。已核实的展示位置包括：

• memory action=list
• Knowledge tab
• 冻结会话快照

在 Reflect 视图中，冲突条目支持：

• Edit
• Delete
• Undo

深度反思通过以下入口触发：

/memory reflect
memory action=reflect

已核实的本地反思能力包括：

• 本地主题聚类
• 趋势统计
• 冲突提醒
• 遗忘候选项

Knowledge tab¶

设置页提供 Knowledge tab。已核实的操作包括：

• 搜索
• 层级过滤
• 按条目查看权重、命中次数、时间、pin 状态
• 一键 pin / unpin
• 内联编辑
• 安全删除

安装与启用¶

先确认 DSH 环境满足以下要求：

engines.node: >=22.19.0
peerDependencies:
  @deepseek-ai/cordis: ^4.0.1
  @deepseek-ai/dsh-session: >=0.1.0-rc.5
  @deepseek-ai/dsh-tools: >=0.1.0-rc.5

然后安装插件。已核实的安装命令如下：

dsh plugin add dsh-biomemory

如果使用本地链接方式：

pnpm add link:./dsh-biomemory

安装后，需要把 dsh-biomemory 添加到 profile 的 dsh.profile.bundles 中。

典型用法¶

编辑记忆条目¶

工具方式：

memory action=update fp="..." text="..."

命令方式：

/memory edit <fp> <new text>

这两种方式都用于修改已有记忆条目的文本。已核实的行为是：metadata（pin / weight / layer）会被保留，旧向量会被清除，并记录 UPDATE 审计事件；重复内容会被拒绝。

回滚单条记忆¶

如果删除后需要恢复单条记忆，可以使用：

memory action=restore fp="..."

或：

/memory undo <fp>

API 方式为：

POST /entries/restore

恢复来源是最新的备份数据库，并会记录 RESTORE 审计事件。

触发记忆代谢¶

直接运行：

/memory dream

仅预览、不修改：

/memory dream --dry-run

通过 memory 工具执行 dry-run：

memory action=dream dryRun=true

触发深度反思¶

命令方式：

/memory reflect

工具方式：

memory action=reflect

适用场景与注意¶

dsh-biomemory 适合以下 DSH 使用场景：

• 需要跨会话保留用户偏好和项目上下文
• 需要对重要记忆设置审批或降级策略
• 需要结构化审计、备份与回滚
• 需要本地语义检索与关键词检索结合
• 需要对记忆进行衰减、巩固、归档和冲突处理

使用前需要注意：

1、插件以当前 DSH 进程权限运行。安装前应检查源码、许可证和依赖关系。

2、审批降级策略默认 auto。如果要求审批通道不可用时保持 fail-closed，可把 approvalFallback 切换为 deny。

3、嵌入模型不可用时，检索会退化为 keyword-only；记忆功能仍可继续使用。

4、桌面宠物桥接（DSH↔desktop-pet bridge）已被抽离到 dsh-whale-pet-bridge；dsh-biomemory 仅保留 memory save notifications。

5、本文依据已核实的 README 与 package.json 信息整理；原始 README 在 Knowledge page 后续内容处被截断，因此部分页面细节未展开。

相关地址¶

社区目录：

https://www.skillhub.cn/plugins/KLRSL/dsh-biomemory

GitHub：

https://github.com/KLRSL/dsh-biomemory

dsh-biomemory 的价值在于把跨会话记忆做成可审批、可检索、可代谢、可审计的插件能力，而不是只追加一段文本。对于需要在 DSH 中长期保留上下文的开发者来说，它提供了一套相对完整的记忆管理入口。