编程记忆库 10110me/dsh-memory

dsh-memory

为 DeepSeek Harness（DSH）提供持久化编程记忆。存储陷阱、经验教训、知识和笔记；快速搜索它们（关键词 + 嵌入）；浏览交互式实体关系图；让当前编程模型帮助你整理记忆。

功能特性

- 记忆存储 —— 保存 pitfall / knowledge / note 记忆，持久化到工作区根目录下的 .dsh-memory-store.json。
- 模型辅助整理 —— 保存时，当前模型会提取摘要、标签和命名实体。
- 语义搜索选项 —— 配置兼容 OpenAI 的嵌入 API 以进行向量检索。
- 快速关键词搜索 —— 内置倒排索引；每次按键都进行防抖搜索，无需按钮，毫秒级响应。
- 实体关系图 —— 以实体图的形式浏览记忆，支持缩放、平移、拖拽、点击高亮相连链条、可调节边宽，以及将连通分量分组并保持清晰间距的力导向布局。
- 4 个面向模型的工具 —— memory_save、memory_search、memory_list、memory_delete。
- 系统提示引导 —— 告诉 DSH 在非平凡工作之前搜索记忆，并在陷阱发生时保存它们。
- DSH Web 设置面板 —— 一个「记忆 / Memory」区域，包含 Config / Memory / Graph 标签页。

项目结构

这是一个使用 TypeScript + tsdown 构建的标准 DSH 插件包。

dsh-memory/
├── src/
│ ├── index.ts # 宿主插件：工具、HTTP API、关键词搜索、系统提示（严格 TS） │ └── client/ │ └── index.tsx # 客户端打包：设置 UI + 图画布（由 tsdown 构建） ├── client/client.js # 构建后的 __ModuleLoader__ 打包 ├── lib/index.js # 构建后的 ESM 宿主打包 ├── cordis.patch.yml # 在启动时注入插件行 ├── tsconfig.json # 宿主类型检查 ├── tsconfig.client.json# 客户端类型检查 ├── tsdown.config.ts # 构建流水线（宿主 ESM + 客户端 __ModuleLoader__ 工厂） ├── vitest.config.ts # 测试运行器 └── tests/ # 针对构建产物的 vitest 冒烟测试

构建

pnpm install
pnpm build # tsc 类型检查（宿主）+ tsdown（宿主 + 客户端打包）
pnpm test # 针对构建输出的 vitest 冒烟测试
pnpm check # 类型检查 + 构建 + 重启冒烟测试（需要运行中的 DSH）

安装到 DSH 配置档

将构建好的包复制到配置档并注册打包：

1. 将此目录复制到 /node_modules/dsh-memory/。
2. 编辑 /package.json：
- 将 "dsh-memory": "file:./dsh-memory" 添加到 dependencies
- 将 "dsh-memory" 追加到 dsh.profile.bundles
3. 确保 /cordis.patch.yml 为 []（打包自带的补丁会注入插件）。
4. 重启 dsh web。

配置

DSH Web 设置 → 「记忆 / Memory」→ Config 标签页提供：

| 字段 | 描述 |
| API Base | 兼容 OpenAI 的端点，例如 https://api.openai.com/v1 |
| API Key | 嵌入服务的密钥 |
| Model | 例如 text-embedding-3-small、qwen3-embedding-8b |
| Embedding dimensions | 0 = 使用模型默认值 |
| Max graph nodes | 3–200，默认 50 |
| Enable vector search | 关闭 = 仅关键词（无 API，最快） |
| Organize with model | 保存时提取摘要/标签/实体 |

API 密钥以明文形式存储在工作区根目录的 .dsh-memory-config.json 中——请勿提交。

数据文件

- .dsh-memory-store.json — 所有记忆数据
- .dsh-memory-config.json — 配置

卸载

1. 从 dependencies 和 dsh.profile.bundles 中移除 dsh-memory。
2. 删除 /node_modules/dsh-memory。
3. 可选：从工作区中删除 .dsh-memory-*.json。

许可证

MIT