dsh-relationship

Readme

# dsh-relationship 关系记忆工作台

一个 DeepSeek Harness（DSH）本地插件：帮你以最低成本沉淀、整理和取用人际关系记忆。

核心体验：

1. **录入即说话**——在 DSH 会话里随口说「记一下，小李女儿十月办婚礼」，AI 拆成结构化的待确认记忆实时上板。
2. **确认式入库**——AI 只提取和建议，所有 AI 写入都是 `待确认` 状态；你逐条确认后才是长期记忆。
3. **整理归 AI**——归类、去重、冲突标记由 AI 完成，你只做确认和删改。
4. **本地存储**——数据保存在本机，不上传任何服务。

## 功能

- 联系人管理：关系类型、标签、生日（支持只记月日）。
- 待确认队列：AI 提取的候选记忆逐条确认 / 编辑 / 驳回，支持一键全部确认。
- 智能整理：记一笔弹窗切到「智能整理」可粘贴长文本/聊天记录，存档为素材后在 DSH 会话说「整理素材」，AI 拆成多条待确认记忆（保留原文溯源）。
- 联系人时间线：已确认记忆按人聚合，按类型筛选。
- 手动记一笔：不经过 AI 的直接录入（即录即确认）。
- relationship preset：绑定 DSH 原生会话的「关系记忆」AI 行为。
- 双存储后端：默认零依赖 JSON 文件存储；可选 rust 实现的 SQLite 后端（`npm run build:relstore` 编译，无二进制时自动回退 JSON）。

## 使用方式

### 作为 DSH 插件

安装 dsh-relationship 插件包后，GUI 侧边栏出现「关系记忆」入口；数据存于 `~/.dsh/dsh-relationship`。DSH 会话中选择「关系记忆」preset（或经安装脚本安装）即可对话录入：

```sh
dsh plugin --profile web add tynr426/dsh-relationship   # 从 GitHub 安装插件
scripts/install-relationship-preset.sh                   # 安装 preset 到 ~/.dsh/.agent-presets/relationship
```

### 独立运行

```sh
npm start        # http://127.0.0.1:8901（数据存于 ./data）
```

独立模式下可浏览和手动录入；AI 对话录入请在 DSH 内使用。

## AI 接入（面向 agent）

工作台所有业务操作都是 REST API；DSH 会话内推荐统一走工具入口：

```sh
curl -X POST http://127.0.0.1:8901/api/tools -H 'content-type: application/json' \
  -d '{"name":"memory_add","args":{"contactId":"c_xxxx","type":"event","content":"女儿十月办婚礼"}}'
```

可用工具：`contact_search` / `contact_add` / `contact_update` / `memory_add` / `memory_batch_add` / `memory_confirm` / `memory_reject` / `memory_update` / `memory_search` / `timeline_get`。

纪律：AI 写入只产生待确认记忆；录入前先 `contact_search` 防止建重；生成祝福/礼物建议前先 `memory_search`。

## 开发

```sh
npm install          # 安装测试依赖（@playwright/test）
npm run test:unit    # 单元 + API 测试
npm run test:e2e     # 需先 npx playwright install chromium
npm test
```

详见 `AGENTS.md`。

## License

[Apache-2.0](LICENSE)