linshuangb347/dsh-memory-fortress

🏰 dsh-memory-fortress · DeepSeek Harness 本地记忆堡垒

让 AI 拥有跨会话的长期记忆、自我进化能力和知识图谱 —— 一套装齐，零核心修改，随装随用，卸载即净。

这是什么？（30 秒了解）

Memory Fortress 是 DeepSeek Harness 的本地记忆增强插件，把三块能力合成一个包：

| 能力 | 说明 |
|---|---|
| 🧠 五轨分层记忆 | 长期记忆 / 用户档案 / 项目关键记忆 / 项目日志 / 每日日志——AI 自动沉淀对话为长期记忆，跨会话不丢上下文 |
| 📊 知识图谱 | SQLite + FTS5 全文检索的本地图谱（实体/关系/任务/技能/事件），gm_record 写入、gm_search 语义查询 |
| 🔄 自我进化 | 回合末自审查沉淀经验、技能自动创建与隔离审核、待办四象限管理 |
| 🌐 外部 AI 调度 | COI 一键把任务派给 kimi / codex / grok / hermes 等外部 CLI，记忆注入、会话分层 |
| 💡 状态灯 | 对话输入框常驻记忆状态灯（绿/黄/红/灰），一键关闭/只读记忆写入 |
| 🛡️ 数据安全 | 写入前自动快照、对话结束自动提取实体入图谱、快照轮转上限 |

所有数据 100% 存在本地（Markdown + SQLite），不上传、不联网、可随时备份迁移。

安装

dsh plugin --profile  add dsh-memory-fortress

或从 npm：

cd ~/.dsh/profiles/
pnpm add dsh-memory-fortress

然后在 profile 的 package.json 的 dsh.profile.bundles 数组里加入 "dsh-memory-fortress"，重启 DSH 即可。

依赖说明：唯一运行时依赖是 better-sqlite3（知识图谱的存储引擎，含全平台预编译二进制，Windows/macOS/Linux 免编译）。

三大组件

1️⃣ dsh-memory-evolve —— 记忆与自我进化（核心）

五轨记忆体系：

| 轨道 | 用途 | 特性 |
|---|---|---|
| memory | 全局环境/项目事实 | 归档（archive）双向、UI 按钮 + 工具双入口 |
| user | 用户档案（偏好/习惯） | 跨项目生效 |
| key | 项目关键记忆 | 自动注入系统提示词，按 git 分支过滤 |
| project | 项目日志（按工作目录隔离） | 项目间互不可见 |
| daily | 今日日志 | 跨文件查历史 |

核心能力：
- 记忆工具（memory）：add / replace / remove / list / archive / expand，按轨道读写
- 回合末自审查：每 N 回合自动触发记忆审查，经验沉淀防遗忘
- 情绪反馈：识别用户正/负面情绪，自动附加【反馈】行到记忆
- 技能系统（skill_manage）：create → 隔离区 → approve → 技能库，防止低质技能污染
- 待办管理（dtodo）：四象限（重要×紧急）、每日待办、逾期提醒、跨项目查询
- COI 外部 AI 调度：de_coi_dispatch 把任务派给 kimi/codex/grok/hermes，支持会话恢复、记忆注入、完成唤醒
- WebUI 管理界面：记忆 / 技能 / 待办 / COI 调度 / 提示词管理，全部可视化操作
- 临时信息便签、会话广播/编排/搜索、模型设置

2️⃣ graph-memory —— 知识图谱

本地知识图谱（better-sqlite3 + FTS5 全文检索）：

| 工具 | 功能 |
|---|---|
| gm_record | 写入实体（TASK/SKILL/EVENT）和关系（SOLVED_BY/USED_SKILL/PATCHES/REQUIRES/CONFLICTS_WITH） |
| gm_search | 按 PageRank 排序的模糊检索 |
| gm_stats | 图谱统计（节点/边/类型分布） |
| gm_status | 健康状态 |

特性：FTS5 全文检索、WAL 模式、Schema 自动迁移、每回合对话结束自动提取实体入图谱。

数据位置：~/.dsh/graph-memory/graph-memory.db

3️⃣ memory-status-pill —— 状态灯

- 对话输入框常驻状态灯（绿=正常 / 黄=注意 / 红=错误 / 灰=关闭）
- 一键关闭/只读：ui_state 开关控制记忆写入（off 拒写 / readonly 拒写允读）
- 自动化钩子（代码强制）：
- AUTO-07 对话结束自动提取：回合结束自动提取实体入图谱
- AUTO-09 写入前快照：记忆写入前自动快照（节流 30s），防数据丢失
- 快照保留上限 20 个，自动轮转

快速上手

安装重启后，AI 自动获得这些工具，你可以直接对话：

"记住这个项目用 pnpm 不用 npm"           → AI 写入 key 轨记忆
"查一下之前怎么解决 better-sqlite3 编译问题"  → AI 调 gm_search 查图谱
"把这个任务派给 kimi 跑"                  → AI 调 de_coi_dispatch
"今天做完了什么"                          → AI 调 dtodo list
"输入框那个灯怎么关了"                     → 设置 → Memory Evolve → 状态灯开关

配置

所有配置在 DSH 设置 → Memory Evolve 可视化管理：
- 记忆审查开关与间隔
- 技能审核（隔离区）开关
- COI 调度默认适配器
- 状态灯样式

高级配置（cordis.patch.yml）：

- id: dsh-memory-evolve
config:
skillReviewEnabled: true   # 新技能先进隔离区，approve 后入库
- id: graph-memory
config:
dbPath: ~/.dsh/graph-memory/graph-memory.db   # 图谱数据位置

- id: memory-status-pill
config: {}

数据与隐私

- 全部本地存储：记忆是 Markdown 文件，图谱是 SQLite 文件
- 数据位置：~/.dsh/memories/（五轨记忆）、~/.dsh/graph-memory/（图谱）、~/.dsh/skills/（技能）
- 无遥测、无上传、无网络依赖（COI 调度为你显式派发外部 AI 时除外）
- 卸载即净：插件卸载不删除数据文件，随时备份迁移

系统要求

- DeepSeek Harness >= 0.1.1-rc.1
- Node.js >= 20
- better-sqlite3 支持的平台（Windows x64/arm64、macOS Intel/Apple Silicon、Linux x64/arm64/musl）

许可证

MIT — 版权归属：lib/graph-memory/、lib/status-pill/ 与打包层为本项目原创；lib/memory-evolve/ 为捆绑的第三方项目 [dsh-memory-evolve]（MIT © dsh-external，保留原许可）。详见 THIRD_PARTY_NOTICES.md。