# dsh-project-memory

面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的“证据驱动、人工审批”项目记忆插件。

模型只能提出候选；只有人类执行 `/memory approve` 后，候选才会成为正式项目记忆。记忆类型包括决策、约束、约定、经验和事实。

> DeepSeek Harness 当前仍是开发者预览版。本插件适配 `0.1.0-rc.6`，Harness API 更新后可能需要同步调整。

## 核心差异

- 人工审批是硬边界：模型工具无法批准或归档记忆。
- 证据采用项目相对路径、精确行号和 SHA-256 校验，不复制源码片段。
- 新旧记忆冲突时，必须声明 `supersedes`，或由人明确选择 `--keep-both`。
- 正式记忆是适合 Git 管理的 JSON；候选项进入独立待审队列。
- 完全本地、确定性搜索，不依赖向量库或云服务。

## 安装

```bash
dsh plugin --profile web add dsh-project-memory
```

安装后重启对应 Harness profile。

## 命令

```text
/memory capture [备注]
/memory candidates
/memory approve <候选ID> [--keep-both]
/memory reject <候选ID> [原因]
/memory search <关键词>
/memory show <记忆ID>
/memory validate [记忆ID]
/memory archive <记忆ID>
/memory timeline
```

## 数据位置

```text
.dsh/project.json
.dsh/memory/index.json
.dsh/memory/entries/memory_*.json
.dsh/memory/candidates/candidate_*.json
```

团队共享时可提交项目标识、索引和正式记忆；候选项可以留在本地，审批后再纳入版本控制。

## 本地开发

```bash
npm install
npm run check
npm pack --dry-run
```

MIT © 2026