@dsh-external/dsh-auto-memory

Readme

# dsh-auto-memory

> DeepSeek Harness (DSH) 的会话级记忆插件：自动收尾提醒、记忆索引维护。所有配置都在「设置 → 插件 → AutoMemory」，无需手改 YAML。

dsh-auto-memory 让 DSH 记住你真正关心的东西：会话结束时有条理地收尾，跨会话的决策和结论不再丢失。

> **2026-08-16**：原 remember 子模块（`.remember` 对话提取 / LLM 摘要 / NDC / consolidation）已整体剥离删除——摘要模型对 SKIP 判定反复出问题、修复成本高。本插件现仅保留无模型依赖的 autoMemory 核心功能。

## 特性

- **收尾提醒**：会话开始时把项目记忆索引注入给模型，超出行数/大小软上限时主动提醒整理
- **收尾标记**：会话未执行收尾即被销毁时落标记，下次会话开始提醒补收尾；已收尾则清除标记
- **记忆索引**：项目根 `MEMORY.md` 一行一个主题，配合笔记库（`memory/`）承载详细内容
- **脚手架**：会话开始时自动初始化 `MEMORY.md` 索引与 `memory/_TEMPLATE.md` 模板；用户级收尾 skill 自动装到 `~/.dsh/skills/auto-memory`
- **全图形化配置**：无需手改 YAML，面板开关/下拉/文本字段直接读写

## 安装

要求：DSH（DeepSeek Harness）、Node.js 20+。peer 依赖由 DSH 运行时提供（`@deepseek-ai/cordis`、`@deepseek-ai/schemastery`、`@deepseek-ai/dsh-settings`）。

```bash
dsh plugin --profile web add <仓库地址或本地目录>
```

安装后重启 DSH，在「设置 → 插件」找到 AutoMemory。

## 配置

| 分组 | 字段 | 默认 | 说明 |
|------|------|------|------|
| 会话记忆整理 | 启用会话提醒 | 开 | 注入记忆索引并做收尾提醒 |
| | 记忆索引文件 | `MEMORY.md` | 项目根索引文件名 |
| | 状态目录 | `.dsh` | 收尾标记存放目录 |
| | 索引行数上限 | 150 | 超过后提醒整理 |
| | 索引大小上限 | 20 KB | 超过后提醒整理 |

## 工作原理

```
会话开始 ── 注入 MEMORY.md 索引软上限检查 + 未收尾提醒
            └─ 初始化记忆脚手架（MEMORY.md + memory/_TEMPLATE.md）
会话进行 ── 无（仅事件监听保留给收尾标记）
会话结束 ── 未收尾 → 写 .dsh/auto-memory-flag；已收尾 → 清标记
```

- 收尾 skill 自动复制到 `~/.dsh/skills/auto-memory`，指导收尾时该提炼什么
- 标记文件：`<stateDir>/auto-memory-flag`（未收尾）、`<stateDir>/auto-memory-done`（已收尾），位于项目根的 `.dsh/`（默认）

## 源码目录

```
├── lib/index.js          Host 端（Cordis 插件）：记忆生命周期、HTTP 配置路由
├── lib/client.js         Client 端（浏览器 bundle）：设置面板，经 /auto-memory/api 读写配置
├── cordis.patch.yml      bundle patch：声明 Host 依赖（llm / settings / webServer）
├── scaffold/             项目记忆脚手架（MEMORY.md 索引 + 笔记模板）
└── skills/auto-memory    收尾 skill 模板
```

## 开发

```bash
# 验证配置加载与启动（Windows）
dsh --dump-config --profile web
dsh web
# 配置读写走插件自带路由
POST /auto-memory/api/settings.get
POST /auto-memory/api/settings.update   # body: { patch, expectedRevision }
```

## 常见问题

**面板不显示？** 浏览器硬刷新（Ctrl+Shift+R）；确认安装后已重启 DSH。

## 许可

[MIT](LICENSE)