命名记忆库 win10ogod/dsh-fount-memory

dsh-fount-memory

参考 Fount 角色的长短期记忆设计，为 DeepSeek Harness 提供持久记忆。已针对 DSH 0.1.7-rc.2 的插件与 format v4 消息接口开发。

记忆在原本的对话中运作：模型请求前带入符合条件的命名事实记忆。默认不自动注入过往对话轨迹。插件不建立反思或 dream 轮次，不调用 agent.followup()、agent.steer()，也不在空闲时恢复会话。存储与检索都在本机进行，不额外调用模型。

长期记忆以名称管理。再次使用相同名称会更新现有内容，旧版与来源上下文留在修订历史；删除时连历史一起删除。触发条件支持任一关键词、全部关键词与指定月日。例如：

{
"name": "使用者生日", "content": "使用者生日为 7 月 17 日。",
"trigger": { "any": ["生日", "birthday"], "onDates": ["07-17"] }
}

短期封存保留最近十则非空白文字消息及其来源、会话 ID、轮次与记录时间。DSH 的 completed 只代表回合结束，并不证明工作完成，因此这些封存是未验证的历史数据，不是成功任务示范。空白结尾、未完成待办、中止与失败的回合不会新增封存。

recallCount 默认为 0，封存片段只供 fount_memory_search 搭配 includeEpisodes: true 明确检查历史；一般搜索默认也只返回命名事实。套件升级本身不删除既有数据。命名事实记忆的自动召回不受此值影响。若使用者明确把 recallCount 设为正整数，会启用旧式原始对话召回：按词汇、时间线索与衰减选取片段，略过同会话 20 分钟内的片段。原始轨迹可能包含未完成操作，会成为模型模仿的上下文；不能只靠「不是新指令」的前言消除这项影响。一般开发 Agent 应保持为 0。

提供四个模型工具：fount_memory_remember、fount_memory_search、fount_memory_context、fount_memory_forget。需要记下经确认的事实时用 remember；更正同一事项时沿用名称；要查来源与旧版时用 context；使用者要求遗忘主题时先用 search 检查范围，再用 forget 的 kind: all 同时删除命名记忆、历史版本与包含该字符串的对话片段。DSH 原始会话日志仍由 DSH 自行管理。工具不替使用者猜测事实，子代理轮次不自动封存。

安装

在 DSH 主机环境安装至所需 profile，例如 web：

dsh plugin --profile web add github:win10ogod/dsh-fount-memory
dsh --profile web --dump-config

dsh plugin 会安装套件并把 bundle 加进 profile；--dump-config 应显示 fount-memory 条目。重新启动已在执行的 DSH 后使用。插件默认按工作区分开 SQLite 数据库，位置为 $DSH_HOME/storages/fount-memory；DSH_HOME 未设置时使用使用者家目录下的 .dsh/storages/fount-memory。

配置示例：

- id: fount-memory
name: dsh-fount-memory
config:
namespace: default
scope: workspace
recallCount: 0
relevanceThreshold: 5
sameSessionCooldownMinutes: 20

scope: global 可让同一个 namespace 跨工作区共用数据。dataDir 可指定数据库目录。停用插件不删除数据库；要删除特定记忆，用 fount_memory_forget。

此实现参考了 理华角色包 的命名长期记忆、修订追溯、短期片段与相关性回忆。Fount 的任意 JavaScript 触发器在此改为结构化条件，以便在 DSH 插件中验证与管理；这不是 Fount 原角色记忆数据的直接导入。对话片段目前记录文字内容，非文字附件仍留在 DSH 原始会话中。

执行 npm run check 会检查语法并测试数据库重启、修订删除、时间线索、format v4 来源、事实召回，以及失败轨迹不自动回灌与空白消息排除。