dsh-memory-vault

Readme

# dsh-memory-vault（外置记忆库插件）

一个为 DeepSeek Harness（DSH）提供长期记忆能力的插件。

## 功能

- 新增记忆、查看记忆、搜索记忆
- 修改记忆、删除记忆
- 归档 / 恢复记忆
- 分类管理、标签管理、统计信息
- 自动把每次完整对话保存成一条“对话记录”（只存用户和助手文本，不存工具细节）
- 专门搜索历史对话
- 分层记忆：短期（最近对话）→ 中期（压缩摘要）→ 长期（再压缩摘要）→ 永久（当前会话重要内容）
- 全局“预设/用户记忆”单独保存，每个对话开始时自动带上
- 永久记忆绑定当前会话，不会被自动丢弃；长期记忆满后会自动吸收重要内容再丢弃最旧一条
- 各层上限和压缩条数可通过插件配置修改
- 数据保存在 `~/.dsh/memory/memory.db`，与当前工作区无关

## 安装到桌面版（web-desktop）

```text
dsh plugin --profile web-desktop add <本插件源码目录>
```

装完后重启 dsh 桌面客户端生效。

重启后可以在「设置 → 插件 → 管理」的「全部」或「核心组件」分类里看到 `dsh-memory-vault`。

## 从 GitHub 安装（插件市场/远程仓库）

```text
dsh plugin --profile web-desktop add github:hjj588/dsh-memory-vault
```

装完后同样重启 dsh 桌面客户端生效。

## 使用

插件会向 dsh 注入以下工具，AI 在对话中会自动调用：

- `memory_add`
- `memory_list`
- `memory_search`
- `memory_show`
- `memory_update`
- `memory_archive`
- `memory_restore`
- `memory_delete`
- `memory_categories`
- `memory_stats`
- `memory_rename_category`
- `memory_search_history`
- `memory_list_conversations`
- `memory_list_permanent`
- `memory_promote_permanent`
- `memory_add_preset`
- `memory_list_preset`
- `memory_promote_preset`

你只需要对 AI 说“记住……”“查一下记忆……”“之前说过什么……”即可。

## 调整分层数字

默认值：

- 短期保留 20 条原始消息
- 每次压缩最早的 10 条
- 中期最多 20 条摘要
- 长期最多 20 条摘要

想修改时，在 `~/.dsh/profiles/web-desktop/cordis.patch.yml` 的 memory-vault 行下加配置：

```yaml
- insert:
    - id: memory-vault
      name: 'dsh-memory-vault'
      config:
        shortTermLimit: 20
        shortTermCompressCount: 10
        mediumTermLimit: 20
        mediumTermCompressCount: 10
        longTermLimit: 20
```