dsh-memoir：DeepSeek Harness 的本地优先项目记忆插件

它是做什么的？

dsh-memoir 是 DeepSeek Harness（DSH）的本地优先、跨会话项目记忆插件，把 Agent 已确认的工作结论、经验教训和后续行动持久化，在新会话中注入有界且缓存友好的 Hot Memory，并通过本地 BM25 排序召回长尾历史。它解决 Agent 在会话结束后丢失上下文、新会话需要重新理解项目的问题，让你无需 embedding、向量数据库或云端记忆服务即可获得可追溯、可治理的记忆。核心能力包括自动蒸馏提醒、有界 Hot Memory、BM25 排序召回、显式重复/冲突治理、完整 Web GUI 和来源追踪，适合需要“新 Agent 接手时继续理解项目”的个人或本地开发工作流。

核心功能

• 本地优先存储：JSON 单一事实源与项目内 PROJECT_MEMORY.md，不上传记忆，不依赖外部服务。
• 自动蒸馏提醒：顶层 Agent 完成有效工作回合时提醒归纳，由 memoir_record 透明落盘，跳过 idle、aborted、subagent 和已记录回合。
• 有界 Hot Memory：只把高价值记忆放进 system prompt，受 token 预算硬限制，同一会话冻结前缀以提高 prompt-prefix cache 命中。
• BM25 排序召回：中文短语、英文关键词、代码标识符和路径都可检索，跨项目 Top-K 与查询 LRU 缓存共用同一引擎。
• 可治理的记忆：重要度、置顶、标签、归档、恢复和 supersede 生命周期，相似写入必须显式更新、替代或并存。
• 完整 Web GUI：中英双语项目/全局浏览、排序搜索、编辑、Hot Memory 预览、诊断和实时设置。

怎么使用这个插件？

在 DSH 中启用后，重启 dsh web，侧边栏会出现“记忆”入口。Agent 在有效工作回合后收到自动蒸馏提醒，通过 memoir_record 写入 work / lessons / actions / note，写前返回可解释的相似或冲突候选；调用者必须选择 update、supersede 或 force-record 来治理重复或冲突。需要召回历史时，使用 memoir_read 在 project（默认）/ global / all 范围内进行 compact 或 full 的本地排序召回。所有频率参数和记忆条目都可在 GUI 中即时修改，记忆保存在本机，不会随插件升级或卸载自动删除。