dsh-timem-memory

TiMEM 长期记忆的 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 依赖它）。

# 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

配置凭证

凭证存在凭证存储（~/.dsh/.credentials.yaml，权限 0600，可在 DSH 网页端凭证页管理）， 或环境变量 / ~/.dsh/.env（启动时加载）。以 .credentials.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