Skip to content

v1.0.1 - Initial Release

Latest
Latest

Choose a tag to compare

View all tags
@wang-jie-git wang-jie-git released this 16 Aug 02:13
· 5 commits to main since this release
v1.0.1
5254716

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 文件

🔗 相关项目

📞 支持

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

Assets 2
Loading