dsh-rag — DSH 跨会话项目记忆库

给 DeepSeek Harness 加一层按项目分类的长期记忆：会话变长归档、新开会话时， 不用再从头交接一遍。

形态：本地 MCP server（stdio / HTTP）+ 会话归档守护 + 面板插件。数据全部留在本机； 只有向量化默认要联网（智谱 embedding），可切本地模型或完全关闭。

快速开始（5 分钟）

git clone https://github.com/Fqh22/dsh-rag.git dsh-rag
cd dsh-rag
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
powershell -ExecutionPolicy Bypass -File scripts\install.ps1

Linux / macOS 把最后一行换成：

bash scripts/install.sh

脚本做三件事：把 MCP server 写进当前 profile 的 cordis.patch.yml（- insert: 包裹这个坑 已经替你处理）、把面板插件挂进 package.json、用 DSH 自带的 pnpm 装好。

• 幂等：重复跑不会重复添加；改动前自动备份成 *.bak-<时间戳>

• -DryRun / --dry-run 只看计划不动文件；-Uninstall / --uninstall 撤销

• -SkipPanel 只配 MCP；-Profile web 配 Web 端

然后重启 DSH，验证两件事：

1. 工具表里出现 mcp__rag__*

2. 界面右下角出现记忆面板按钮

手动安装、HTTP 模式、插件市场、面板用法 → docs/install.md

Related MCP server: ctxmem

它解决什么

它不是一个通用文档问答系统。 通用 RAG（切块 + 向量召回）回答的是"说过什么"， 而交接需要的是"现在是什么状态"——所以这里以结构化记忆为主，向量只做兜底召回。

数据结构一览

六张表，每张只做一件事（完整说明见 docs/design.md）：

status 四个值：active（生效）、superseded（被取代）、draft（待确认，不进检索）、 archived（可恢复）。删除永远不连带删记忆——目录没了只标孤儿。

文档

已知限制

• 中文检索用 bigram：对 1–2 字的词召回偏松，靠 project + kind 过滤收敛。

• 归档摘要不调 LLM（除非 DSH 压缩过）：规则抽取语义压缩有限；有 compact-checkpoint 时直接用它，质量最好。

• 项目归属是推断：会话没提到项目名时会落到「工作区」。

• pack 的缓存收益有条件：基线不变才能跨会话命中；交接卡每写一次，卡之后的内容就要重算。 预算不够时按 next → facts → card 收缩：先丢「下一步」，再从最旧的事实开始挤， 「当前状态」最后才动。

• 单机单用户：SQLite WAL，没有并发写优化，不适合多进程高频写。

• 向量化依赖网络：智谱是 HTTP API，断网时向量检索降级为纯关键词（不报错，只是召回变差）。 想彻底离线切 DSH_RAG_EMBED=local 或 off。

• 文本会出本机：走智谱意味着记忆正文会发给智谱。介意的话用 local 后端。

• 跨会话首步命中不总是满的：实测多数新会话能命中约 11 264 token（系统提示 + 工具表）， 但个别会话只有 512。原因未定位，cache_stats 会把它暴露出来。

• 开场自动注入依赖 DSH 内部 API（agent/created / session/event / agent.inject）。 这些不是公开契约，DSH 升级可能改；整条链路都是 try/catch + 失败即静默， 排查看 logs/auto-inject.log。

• 草稿质量取决于会话本身：自动草稿只写"有证据"的字段，它不会替你想清楚下一步。

• 接力度量需要样本：要比较"读过 pack / 没读过"，得两种会话都攒够几个。

• 清理只认时效和结构位置：use_count=0 只提醒不执行——"没人检索"不等于"没价值"。

License

MIT，见 LICENSE。