v1.0.1 - 初始版本

发布日期: 2026-08-16
项目: @wangjiezhong/dsh-memory
状态: ✅ 生产就绪

🎉 欢迎使用 DSH Memory 插件

DSH Memory 插件为 DeepSeek Harness（DSH）提供完整的 AI-memory 语义记忆系统集成，包括 14 个记忆管理工具和美观的设置页面 UI。

✨ 新功能

1. 14 个记忆管理工具

基础操作

memory_query - 语义检索记忆库（向量 + 图谱混合检索）
memory_write - 写入单条记忆
memory_write_batch - 批量写入记忆

智能整理

memory_dream - 梦境整理（合并冗余 + 聚类洞察）
memory_compress - 会话压缩（提取关键决策）
memory_nudge - 智能提醒（检测重复模式）

用户与系统

memory_profile - 用户画像分析
memory_health - 健康检查
memory_stats - 统计信息
memory_logs - 系统日志
memory_errors - 错题本（错误日志分析）

维护管理

memory_prune - 清理低价值记忆
memory_consistency - 图库与向量库一致性检查
memory_rebuild_index - 重建向量索引

2. 设置页面 UI 🎨

在 DSH 设置中添加了 🧠 Memory AI 标签页，提供：

✅ 当前配置概览
✅ CodeGraph 目录配置
✅ Embedder 类型选择（Simple / API）
✅ API 配置信息
✅ 快速操作指南

3. API 端点

GET /plugins/@wangjiezhong/dsh-memory/health - 健康检查

🚀 安装

从 npm 安装（推荐）

dsh plugin --profile web add @wangjiezhong/dsh-memory

从源码安装

# 克隆仓库
git clone https://github.com/wang-jie-git/dsh-memory.git
cd dsh-memory

# 安装依赖
npm install

# 构建
npm run build

# 打包
npm pack

# 安装到 DSH
dsh plugin --profile web add ./dsh-memory-1.0.1.tgz

⚙️ 配置

创建 ~/.dsh/memory-config.json：

{
  "codegraphDir": "~/.codegraph",
  "embedder": "simple"
}

Embedder 选项

类型	配置	说明
`simple`	无需额外配置	零依赖纯算法，128 维向量（推荐）
`api`	需配置 apiKey、apiModel、apiBaseUrl	外部 embedding 服务（OpenAI、Jina AI 等）

🎯 核心特性

向量 + 图谱混合检索

用户查询 → 向量粗召回（IVF 索引） → 图精排序 → 融合打分 → 返回结果

向量粗召回: 快速筛选 Top-K 候选（~10ms）
图精排序: 利用图关系优化排序
融合打分: 综合向量相似度 + 图结构权重

梦境整理（Dream）

自动执行熵减过程：

合并冗余记忆 → 聚类生成洞察 → 清理低价值条目 → 归档重要历史

会话压缩（Compress）

RFC-06 Phase A 实现：

将长会话压缩为结构化摘要
提取关键决策
识别未解决问题
保留重要上下文

智能提醒（Nudge）

基于模式检测的主动建议：

重复错误提醒
项目健康检查
最佳实践建议

📐 符合 DSH 官方规范

✅ execute 函数签名: (args, exec) 而不是 ({...})
✅ output 声明: 精确 schema 定义（properties + required）
✅ timeoutMs: 全覆盖配置（10s-120s）
✅ isConcurrencySafe: 并发安全声明
✅ exec.signal: 执行取消支持

详见 OFFICIAL_COMPLIANCE.md

📦 项目结构

dsh-memory/
├── src/
│   ├── plugin/
│   │   └── index.ts          # 插件主入口（643 行 TypeScript）
│   └── core/                 # One Memory 核心模块（17 个文件）
├── dist/plugin/
│   ├── index.js             # 编译输出（27KB）
│   └── index.js.map
├── package.json             # 项目配置
├── tsconfig.json            # TypeScript 配置
└── README.md                # 完整使用文档

🔧 技术栈

技术	版本	用途
TypeScript	5.4	类型安全
One Memory	v0.6.0	记忆系统核心
memory-orchestrator	0.2.1	混合查询编排
memory-vector	0.2.1	向量存储（IVF 索引）
memory-graph	0.2.1	图数据库（SQLite + WAL）
DeepSeek Harness	0.1.0-rc.6	DSH 插件系统
SimpleEmbedder	-	纯算法嵌入器（Mulberry32）

📝 使用示例

1. 写入记忆

使用 memory_write 工具：
- title: "项目约定"
- summary: "API Key 必须通过环境变量注入"
- body: "禁止硬编码密钥，使用 os.getenv() 或 dotenv"
- importance: 8
- tags: "安全,最佳实践"

2. 语义检索

使用 memory_query 工具：
- query: "如何安全处理 API Key？"
- limit: 5

返回相关记忆（按相似度排序）

3. 梦境整理

使用 memory_dream 工具：
- dryRun: true（预览模式）

查看预测的整理结果，确认后执行

⚠️ 已知问题

TypeScript 类型警告（非阻塞）

状态: 4 个类型检查警告

原因:

One Memory 的类型定义与 DSH 工具类型不兼容
defineTool 的类型签名过于严格

影响: ✅ 无影响，插件可正常运行

📚 文档

文档	说明
README.md	完整使用文档
PROJECT_SUMMARY.md	详细项目总结
OFFICIAL_COMPLIANCE.md	DSH 官方规范对比
构建完成报告.md	构建状态报告
项目说明.txt	快速参考

🔄 与旧插件对比

功能	dsh-memory-ai（旧）	dsh-memory（新）
项目位置	`~/Desktop/dsh-memory-ai`	`~/Desktop/dsh-memory-plugin`
工具数量	14 个	14 个 ✅
设置页面 UI	❌ 无	✅ 有
API 端点	❌ 无	✅ 有
配置文件	`~/.dsh/memory-ai-config.json`	`~/.dsh/memory-config.json`
TypeScript 源码	❌ 无（仅构建产物）	✅ 有
项目文档	❌ 简单 README	✅ 完整文档
符合官方规范	❌ 否	✅ 是

🤝 贡献

欢迎提交 Issue 和 Pull Request！

开发流程

# 1. Fork 仓库
# 2. 创建功能分支
git checkout -b feature/amazing-feature

# 3. 提交更改
git commit -m "feat: 添加新功能"

# 4. 推送到分支
git push origin feature/amazing-feature

# 5. 创建 Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

🔗 相关项目

One Memory - 持久记忆子系统（核心依赖）
Moat - 代码质量检查工具
DeepSeek Harness - DSH 插件系统

📞 支持

Issues: https://github.com/wang-jie-git/dsh-memory/issues
Discussions: https://github.com/wang-jie-git/dsh-memory/discussions

版本: 1.0.1
发布日期: 2026-08-16
状态: ✅ 生产就绪

Releases: wang-jie-git/dsh-memory

Release list

v1.0.1 - Initial Release