yihefeikong-rgb/dsh-cc-haha-memory

一个面向 DeepSeek Harness（DSH） 的第三方持久记忆插件，参考并复刻 CC-HAHA 的项目记忆使用体验。

[!IMPORTANT] 本项目不是 CC-HAHA 官方组件，也不隶属于 CC-HAHA 或 DeepSeek。记忆理念与交互流程参考 CC-HAHA，插件代码使用 DSH 原生事件、工具、LLM 和 Web UI 接口独立实现。

能做什么

• 真实记住：用户明确说“记住”时，DSH 会先读取记忆索引，再显示 memory_remember 工具调用；只有返回 saved: true 后才确认已记住。
• 独立文件：每条记忆保存为单独的 Markdown 文件，并由 MEMORY.md 维护简洁索引。
• 项目隔离：每次只注入“通用 + 当前项目”，不会把所有项目记忆一次性塞进上下文。
• 逐轮召回 + 会话预算：每条提示词按当前问题选择最多 5 条相关记忆正文注入；同一会话内已注入过的记忆不重复注入，整会话累计超过 sessionMaxBytes（默认 60KB）后只保留索引——对齐 CC-HAHA 的 alreadySurfaced + MAX_SESSION_BYTES。
• 自动记录：按回合评审值得长期保存的信息，失败时保留缓冲，不把模型错误伪装成“没有记忆”。
• 安全更新：同主题通过明确记忆 ID 更新；禁止模糊标题猜测覆盖，更新和删除前保存历史版本。
• 管理界面：会话页上方提供“记忆”标签、项目文件夹、搜索、新建、编辑和删除。
• Claude 记忆导入：可非破坏地导入现有 Claude Code 记忆；重复启动只跳过，不覆盖 DSH 中已更新的内容。

DSH 插件标识

仓库根目录的 package.json 包含 DSH 原生插件声明：

{
  "dsh": {
    "bundle": { "patch": "./cordis.patch.yml" },
    "client": {
      "platform": "web",
      "inject": ["@deepseek-ai/dsh-client-runtime"]
    }
  }
}

cordis.patch.yml 负责挂载 host 插件，lib/client.js 负责加载会话页记忆 UI。

安装

要求：已经安装并能正常启动 DSH。

dsh plugin --profile web add github:yihefeikong-rgb/dsh-cc-haha-memory

安装后重启 DSH Web：

dsh web

进入任意会话后，顶部应出现“记忆”标签。首次验证可以发送：

请记住：这个项目使用 Rust 和 Tauri。

正常轨迹应包含：

Read MEMORY.md → memory_remember → saved: true

记忆文件默认位于：

~/.dsh/memory/
├── MEMORY.md
├── 通用/
└── <当前项目>/
    └── <主题>.md

配置

默认配置位于 cordis.patch.yml：

- insert:
    - id: dsh-memory
      name: dsh-memory
      config:
        reviewEnabled: true
        reviewInterval: 5

主要选项：

选项	默认值	说明
reviewEnabled	true	是否启用回合后自动评审
reviewInterval	1（schema）/ 5（本包 patch）	每多少回合评审一次
reviewTimeoutMs	120000	后台评审总超时
recallOrder	117	索引 context 的注入顺序
recallMaxBytes	25000	注入索引最大字节数（另有 200 行硬上限）
recallRelevantMaxBytes	16000	单次相关正文最大字节数
sessionMaxBytes	61440	本会话相关正文累计上限（0=不限）
dedupeRelevant	true	同一会话内已注入过的正文不再重复注入
relevantBodiesEnabled	true	是否按当前查询注入相关正文。设 false = 每会话只在开场注入一次：索引冻结 + 无正文 → 记忆块在会话内恒定，harness 不再逐轮追加注入；细节改用 memory_search/memory_read 取（这正是上游 cc-haha 的默认形态）
freezeIndexPerSession	true	索引片段每会话只渲染一次（对齐上游 getUserContext 的 memoize）。否则会话中途写记忆会让索引变化 → 多一次注入
selectEnabled	true	LLM 语义相关性选择（失败/关闭时回落关键词评分）
selectTimeoutMs	12000	相关性选择超时
guidanceEnabled	true	把「引用记忆前的核验」指南注册成系统提示词的静态 section（内容不变 → 走前缀缓存）
recentToolsEnabled	true	把「最近使用过的工具」交给选择器，避免注入正在使用的工具的参考类记忆
recentToolsWindow	8	「最近使用过的工具」保留个数
skipReviewAfterAgentWrite	true	本回合主 agent 自己写过记忆时跳过该回合的后台评审（对齐上游 hasMemoryWritesSince）

索引（MEMORY.md）每次被重写前会先备份上一版到 ~/.dsh/memory/.history/_index/，只保留最近 20 份。 「引用记忆前的核验」指南与「最近用过的工具」排除规则对齐上游 cc-haha 的 TRUSTING_RECALL_SECTION / MEMORY_DRIFT_CAVEAT（src/memdir/memoryTypes.ts）与 findRelevantMemories 的选择器提示词；上游选择器用 json_schema 强制结构化输出， DSH 的 llm.stream 无此能力，故改为把同一约束写进提示词。

记忆工具

插件注册 8 个工具：

• memory_remember：显式“记住”的单次可见入口。
• memory_write：新建记忆。
• memory_read：读取完整记忆。
• memory_update：按 ID 更新并保存历史版本。
• memory_delete：删除并保存历史版本。
• memory_search：当前作用域全文搜索。
• memory_list：列出当前作用域索引。
• memory_suggest_tags：推荐已有标签。

隐私与安全边界

• 仓库和安装包不包含任何用户记忆、会话、日志、API Key 或本机 profile。
• 项目写入无法确认当前工作区时会失败，不会静默写进“通用”。
• Web API 运行在 DSH 本地同源信任边界内，不应把 DSH Web 端口暴露到不可信网络。
• 当前实现是单 DSH 进程内串行写入；不建议多个 DSH 实例同时共享同一个记忆目录。

本地开发

pnpm install --frozen-lockfile
pnpm test
pnpm run build

构建输出：

• lib/index.js：DSH host 插件。
• lib/client.js：DSH Web UI 插件。

与 CC-HAHA 的关系

本项目重点参考了 CC-HAHA 的以下记忆设计：

• 每条记忆使用独立文件，MEMORY.md 只保存短索引。
• 用户明确要求记住时必须真实访问记忆系统。
• 写入前检查已有记忆，优先更新而不是制造重复项。
• 记忆只保存跨会话仍有价值的信息，计划和一次性任务不应写入长期记忆。
• 用户要求忽略记忆时，本轮按空记忆处理。

参考基线：NanmiCoder/cc-haha，本地审查提交 d52bbec707246f807416c2bc6b1cd67445cfe622，相关设计位于其 src/memdir/。

感谢 CC-HAHA 作者与贡献者提供优秀的记忆交互设计。完整署名与许可证见 THIRD_PARTY_NOTICES.md。

验证状态

• 自动化测试：50 项。
• 已验证：显式写入、真实文件路径、重复更新、新会话召回、跨项目隔离、后台评审终态、非破坏导入与连续重启幂等。
• 已验证平台：Windows + DSH Web。

License

MIT

---

English summary

An unofficial persistent-memory plugin for DeepSeek Harness, inspired by the project-memory workflow of CC-HAHA. It stores memories as project-scoped Markdown files, exposes visible memory tool calls, injects only global plus current-project context, and includes a Web UI memory tab.