timem-dsh-memory

一键向 DeepSeek Harness 集成 TiMEM 主平台记忆：MCP 桥接 + 配套 skill + 连接验证 + 重启引导。

等价于其他平台（Cursor / Claude Code）的 mcpServers JSON：

{
  "mcpServers": {
    "TiMEM-MCP": {
      "url": "https://api.timem.cloud/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY",
        "X-TiMEM-User-Id": "usr_xxxx"
      }
    }
  }
}

本工具把配置以 @deepseek-ai/dsh-mcp-client 插件实例写入 DSH profile 的 cordis.yml，并自动安装配套 skill（timem-general-memory 等）。重启 DSH host 后：工具以 mcp__timem__* 命名注册，skill 提供"何时检索、何时写入"的钩子——MCP 工具 + skill 才是完整记忆链路。

前置条件

1. 注册 TiMEM 账号：https://docs.timem.cloud/
2. 登录后在控制台生成 API Key（sk- 开头）
3. 获取你的 用户 ID（usr_ 开头，控制台可查看）

运行脚本时按提示粘贴，或直接用 --key / --user-id 传入。

快速开始

# 自动查找 cordis.yml + 交互式输入 API Key 与用户 ID（粘贴不回显，用户 ID 可留空）
npx --yes github:aimaoge/timem-dsh-memory

# 指定配置文件 / 免交互（脚本、CI 用）
npx --yes github:aimaoge/timem-dsh-memory --file /path/to/cordis.yml --key sk-xxxx --user-id usr_xxx -y

# 只预览不落盘
npx --yes github:aimaoge/timem-dsh-memory --dry-run --key sk-xxxx

# 装完 TiMEM 后先验证 key/URL 是否可用（不修改配置）
npx --yes github:aimaoge/timem-dsh-memory --verify --key sk-xxxx --user-id usr_xxx

每次写入配置后脚本会自动验证连接（认证/工具清单），key 错、URL 错、服务未启动都会给出明确提示；--no-verify 可跳过。

验证通过后脚本会询问是否现在重启 DSH：输入 y 自动重启（查找监听端口的 DSH 进程 → 终止 → 重新拉起 npx -y @deepseek-ai/dsh --profile web）；输入 n 或自动重启失败时，打印重启命令供手动执行。--no-restart 跳过询问。

skill（记忆钩子）

general（timem-general-memory）默认必装：个人偏好/生活工作背景/主题回忆场景，prefer search + gated create。coding（timem-coding-memory）与 writing（timem-writing-memory）为备选：交互模式会逐一询问，或用 --skill 指定。writing 的官方文件暂未内置，选择后会提示（拿到官网文件后放入 skills/timem-writing-memory/SKILL.md 重新安装即可）。

选项

本机 HTTPS 拉取若报 UNABLE_TO_VERIFY_LEAF_SIGNATURE（TLS 被中间人拦截；SSH 通道同样会经 HTTPS 下载 tarball）：

• PowerShell：$env:npm_config_strict_ssl='false'; npx --yes github:aimaoge/timem-dsh-memory
• bash/zsh：npm_config_strict_ssl=false npx --yes github:aimaoge/timem-dsh-memory
• 永久方案：把中间人根证书导出为 .pem 并设 NODE_EXTRA_CA_CERTS=/path/to/ca.pem

本地开发

node dsh-add-timem-memory.mjs [选项]

• 自动查找范围：$DSH_HOME → ~/.dsh → npm npx 缓存目录；多个结果时优先 web profile
• 幂等：已存在条目时原地更新 key，不产生重复
• 跨平台：Windows 7/10/11、Linux、macOS，纯 Node 内置模块零依赖
• 保持原文件换行符（CRLF/LF）与 UTF-8 编码

维护

# 检查是否有新版本
npx --yes github:aimaoge/timem-dsh-memory --check-update

# 一键升级（发现新版自动清 npx 缓存并提示重跑）
npx --yes github:aimaoge/timem-dsh-memory --update

# 卸载：移除 MCP 条目 + 删除已装 skill
npx --yes github:aimaoge/timem-dsh-memory --uninstall

# 只移除 MCP 条目，保留 skill
npx --yes github:aimaoge/timem-dsh-memory --uninstall --keep-skill

版本

• 当前版本：v0.6.0，查看：npx --yes github:aimaoge/timem-dsh-memory --version
• 固定版本（可复现）：npx --yes github:aimaoge/timem-dsh-memory#v0.6.0
• 检查是否有新版本：npx --yes github:aimaoge/timem-dsh-memory --check-update

升级机制说明：npx github:... 不带 tag 时指向默认分支最新代码，但 npx 对同一 spec 有缓存，不会自动感知新版本——升级到最新请先 npm cache clean --force 再重跑；或直接用 #vX.Y.Z 固定到新 tag。

License

MIT