863683348/dsh-memory-setup

dsh-memory-setup

解决 AI 的"金鱼脑"🐠 —— 为 DeepSeek Harness 打造的本地、可审计的个人记忆层。记住你的偏好、项目约定、工作流和错误教训，并在每次会话中重新注入。

解决 AI 的"金鱼脑"：本地、可审计的个人记忆层——偏好、项目约定、工作方式、纠错教训，会话间自动继承。

安装

dsh plugin --profile  add dsh-memory-setup

工具

| 工具 | 功能 |
|---|---|
| memory_setup | 一次性引导：语言、代码风格、工具、约定、工作流 |
| memory_status | 读取当前记忆 + 变更日志（启动时也会自动注入指引） |
| memory_update | 更新单个记忆路径（例如 preferences.codeStyle），并附带一条变更日志记录 |
| memory_project | 从工作区文件（README / package.json / 配置文件）自动提取项目约定，可预览或应用 |
| memory_lesson | 记录一条错误教训（错误 → 修复 → 证据），避免重复犯同样的错误 |
| memory_review | v0.2 —— 将一次事故形式化为带根因的教训；相似教训会自动合并（去重 + 命中计数） |
| memory_export | v0.2 —— 将完整记忆 + 变更日志导出为 Markdown 文件，便于审阅/备份 |
| knowledge_add | v0.3 —— 添加一条知识条目（标题/内容/标签/来源）；相似标题自动合并 |
| knowledge_search | v0.3 —— 关键词检索（标题 ×3 / 标签 ×2 / 内容 ×1 计分） |
| knowledge_list / knowledge_remove | v0.3 —— 浏览 / 删除知识条目 |
| memory_diff | v0.4 —— 将当前记忆与 memory.json.bak 进行差异对比，可选写入 memory-diff.md |
| memory_review_session | v0.5 —— 批量事故复盘：一次提交多个失败，逐项去重 |
| memory_snapshot / memory_list_snapshots / memory_restore | v0.6 —— 对记忆做快照（保留 N 个）、列出快照、恢复快照（并自动备份当前状态） |
| memory_troubleshoot | v0.6 —— 给定一个错误，在过往教训 + 知识库中搜索已知修复方案 |
| memory_stats | v0.7 —— 跨记忆、知识库和快照的聚合统计 |
| memory_promote | v0.7 —— 将反复出现的教训（命中数 ≥ 阈值）提升为长期约定；保存时自动运行 |
| memory_import / memory_merge | v0.8 —— 从 JSON 导入记忆（自动迁移）/ 合并两份记忆（取较新或两者兼取） |
| kb_export / kb_import | v0.8 —— 知识库 JSON 往返导入导出 |
| memory_focus | v0.9 —— 基于相关性的注入：仅注入与主题匹配的记忆 |
| memory_tier | v1.0 —— 热/温/冷分层（热层注入，冷层归档） |
| memory_audit | v1.0 —— sha256 完整性校验 + 变更日志审计报告 |
| memory_import_claude | v1.1 —— 从 CLAUDE.md 导入约定 |
| memory_export_all / memory_import_all | v1.2 —— 完整备份包（记忆 + 知识库 + 快照） |
| memory_annotate | v1.2 —— 为条目添加所有者/用途注释 |
| knowledge_embed | v0.5 —— 为知识库条目回填嵌入向量（需要 embeddingEndpoint）；启用语义搜索 |

存储与可审计性
- 位置：/.dsh-memory-setup/memory.json — 纯 JSON，易于阅读/备份
- 每次变更都会追加到 changelog（何时 / 什么 / 为什么）— 记忆在设计上可审计
- 经验教训带有可选的 evidence 字段（文件/命令/观察）— 无证据，无经验
- 本地优先：任何内容都不会离开你的机器

配置（可选）

| 字段 | 默认值 | 描述 |
|---|---|---|
| memoryDir | .dsh-memory-setup | 相对于会话工作区的记忆目录 |
| injectOnBoot | true | 将实时记忆注入系统提示（动态上下文，保存时刷新） |
| maxMemoryChars | 6000 | 渲染记忆文本的上限 |
| lessonTtlDays | 90 | 经验教训在此天数后过期（0 表示禁用） |
| changelogCap | 100 | 保留的变更日志条目上限 |
| backupOnSave | true | 每次保存前写入 memory.json.bak |
| reviewReminder | true | 将自我审查提醒追加到指导中 |
| embeddingEndpoint | （空） | OpenAI 兼容的嵌入端点（启用语义知识库搜索） |
| embeddingKey | （空） | 嵌入端点的 Bearer 密钥 |
| embeddingModel | text-embedding-3-small | 嵌入模型名称 |
| snapshotKeep | 10 | 保留的记忆快照上限 |
| troubleshootReminder | true | 将故障排查/快照提醒追加到指导中 |

路线图

- v0.2 ✅：带去重的事件审查（memory_review）、经验/约定过期 + 变更日志上限（保存时自动修剪）、每次保存时 memory.json.bak 备份、Markdown 导出（memory_export）
- v0.3 ✅：个人知识库（knowledge_*、关键词检索、标题合并去重）；通过实时 systemPrompt.context() 区段进行动态记忆注入 — 在启动时（从工作区路径）以及每次记忆保存后（限流 30 秒）刷新，并以静态指导作为回退
- v0.4 ✅：知识库的 BM25 检索（标题 ×3 / 标签 ×2 / 内容 ×1，按 IDF 缩放 — 无嵌入，无依赖）、记忆差异导出（memory_diff 对比备份）、注入指导中的自我审查提醒
- v0.5 ✅：可选的嵌入提供程序（OpenAI 兼容端点；knowledge_embed 回填 + 余弦检索，BM25 回退）、批量事件审查（memory_review_session）、自身工具文件系统故障跟踪并呈现到注入的上下文中
- v0.6 ✅：记忆快照与恢复（memory_snapshot / memory_list_snapshots / memory_restore，有上限，基于索引文件）、故障排查（memory_troubleshoot — 经验 + 知识查找）、指导中的故障排查提醒
- v0.7 ✅：快照中包含知识库（快照/恢复同时涵盖记忆 + 知识）、经验自动提升（命中次数 ≥ 阈值的重复经验成为常驻约定，保存时自动运行 — 记忆真正从重复的错误中学习）、记忆统计（memory_stats）
- v0.8 ✅：schema v2 迁移（加载时自动执行）、记忆导入/合并（memory_import/memory_merge，较新/两者冲突）、知识库 JSON 往返（kb_export/kb_import）
- v0.9 ✅：课程健康评估（失败/已解决/活跃——保存时自动执行，渲染时显示 ⚠️ 标记），聚焦相关性的注入（memory_focus）
- v1.0 ✅：分层（热/温/冷），完整性审计（memory_audit，sha256），导出中的隐私脱敏（sensitiveKeys）
- v1.1 ✅：乐观锁（基于修订的 CAS——多会话/多智能体安全），CLAUDE.md 导入（memory_import_claude）
- v1.2 ✅：完整备份包（memory_export_all/memory_import_all——记忆 + 知识库 + 快照），注释（memory_annotate，所有者/用途）——团队就绪
- v1.3+：课程自动检测（等待工具调用事件 API），网页统计视图

安全

记忆插件是信任级别最高的插件类型——有关审计态势，请参阅 SECURITY.md。