# dsh-timem-memory

TiMEM 长期记忆的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）插件。
一条 cordis 条目装好两件事：

1. **MCP 桥** —— 通过 `@deepseek-ai/dsh-mcp-client` 连接 TiMEM 云端 MCP
   （`https://api.timem.cloud/mcp`），把 17 个工具以 `mcp__timem__*` 命名注册给模型
   （记忆 4 个、规则 8 个、知识库 4 个、`ready` 1 个）；
2. **记忆 skill** —— 把 5 个内置 skill 注册进 DSH skill 体系（runtime 层，rank 250），
   让模型自动执行「每回合先搜记忆 → 干活 → 写记忆」的工作流，无需用户理解 S0–S6 分级。

凭证通过 **`ctx.credentials`** 解析（`TiMEM_API_KEY` / `TiMEM_USER_ID`），不在任何配置
文件里硬编码密钥；凭证变更会触发事件自动重挂 MCP 桥，无需重启。

## 安装

前置：DSH 已安装，`pnpm` 在 PATH 上（`dsh plugin` 依赖它）。

```bash
# 1. 把插件装进目标 profile（任意名字，web / headless / 自定义皆可）
#    GitHub 渠道（当前即可用）：
dsh plugin --profile web add git+https://github.com/auuduu/dsh-timem-memory.git
#    npm 官方商店渠道（发布后）：
# dsh plugin --profile web add dsh-timem-memory

# 2. 在 <DSH_HOME>/profiles/web/cordis.patch.yml 中插入一条目（保存即热生效）
- insert:
    - id: timem-memory
      name: 'dsh-timem-memory'
```

> 小白版原理讲解（包是什么、安装装到哪、DSH 怎么“叫醒”它）：
> [docs/principles.zh.md](docs/principles.zh.md)

## 配置凭证

凭证存在凭证存储（`~/.dsh/.credentials.yaml`，权限 0600，可在 DSH 网页端凭证页管理），
或环境变量 / `~/.dsh/.env`（启动时加载）。以 `.credentials.yaml` 为例：

```yaml
DEEPSEEK_API_KEY: sk-…
TiMEM_API_KEY: sk-…          # https://console.timem.cloud/settings/api-key
TiMEM_USER_ID: usr_…         # TiMEM 控制台个人资料页
```

写入后插件会自动重挂 MCP 桥（无需重启 DSH）。若 TiMEM 凭证缺失，插件只跳过桥接并
记录错误日志，skill 仍会注册。

## 配置项

| 字段 | 默认值 | 说明 |
|---|---|---|
| `serverName` | `timem` | MCP 命名空间，模型看到的工具名 `mcp__<serverName>__<tool>` |
| `url` | `https://api.timem.cloud/mcp` | TiMEM 云端 MCP 端点 |
| `apiKeyRef` | `TiMEM_API_KEY` | `ctx.credentials` 中的 API Key 引用名 |
| `userIdRef` | `TiMEM_USER_ID` | `ctx.credentials` 中的 User ID 引用名 |
| `enableSkills` | `true` | 是否注册内置 skill |
| `skillNames` | 5 个内置 skill | 要注册的 skill 列表 |
| `toolCallTimeoutMs` | 60000 | 透传给 MCP 客户端 |
| `failOnStartupError` | false | 透传给 MCP 客户端 |
| `reconnect.*` | 客户端默认 | 透传给 MCP 客户端 |

## 验证

重启/热生效后，在对话里问模型「TiMEM 接好了吗」——它会调用 `mcp__timem__ready`
并确认 17 个工具可见；或到 设置 → 插件 页面查看 `timem-memory` 条目状态。

## 工作原理

- `lib/index.js`：cordis 插件本体（`inject: ['credentials', 'skills']`）。
  激活时：① 解析凭证 → 用 `ctx.plugin(mcpClient, …)` 挂载 MCP 桥；
  ② 读取包内 `skills/*/SKILL.md` → `ctx.skills.register()` 注册（随上下文自动销毁）。
- `skills/`：5 个 skill 包（TiMEM 官方 skill 的 DSH 适配版，工具名按 `mcp__timem__*`
  重写，自带可用性检查与 S3/S0/S6 分级）。
- 凭证热更新：监听 `credentials/updated`，匹配 `apiKeyRef` / `userIdRef` 时
  释放旧桥并按新凭证重挂。

## License

MIT