SuperAPI AI 工具集

mem-setup

智能体与模型

查看项目

更新于 10-15 14:55

技能介绍

用途

mem-setup 用于将 claude-mem 插件与用户自己的 cmem.ai 凭据配对,使插件的 hooks 能够捕获并注入记忆。任何人都可以配对——凭据是每用户配置,从不硬编码在插件逻辑中。

需要收集的信息

从 cmem.ai → Connect 页面,用户会获得三个值:

  • sync token(以 cm_ 开头)——用作 bearer API key
  • user id(UUID)
  • SyncHub URL(https://sync.cmem.ai)

如果用户粘贴了整段 Connect 文本,从中提取这三个值。如果缺少任何值,至少询问 sync token——另外两个是可选的。

密钥处理(不可妥协)

  • 绝不在对话中回显 token
  • 不将 token 放入 shell argv
  • 不记录 token 日志
  • 仅通过文件写入(Write/Edit 工具)和文件读取来移动 token

使用方式

  1. 定位已安装插件的根目录(即本技能所属插件)。更新其 config.json:将 apiKey 设为 sync token,并设置 userId 和 syncHubUrl。除非用户要求,否则保留其他设置(注入开关)。项目命名是自动的(cmem_work_*),不可配置。

  2. Cowork 容器是临时的:对已安装副本的编辑仅对当前会话有效。要使配对永久生效,需重新打包——将插件目录压缩为 <plugin-name>.plugin 并发送给用户重新安装(cowork-plugin 技能的打包流程)。需告知用户这一原因。

  3. 如果本机同时存在本地 claude-mem 安装(存在 ~/.claude-mem/ 目录),将相同的值写入 ~/.claude-mem/settings.json,权限设为 0600(键为 CLAUDE_MEM_CLOUD_SYNC_TOKEN、CLAUDE_MEM_CLOUD_SYNC_USER_ID、CLAUDE_MEM_CLOUD_SYNC_HUB_URL——与本地 claude-mem 云同步配对写入的键相同)。在本地安装了 claude-mem 的地方,本插件的 hooks 保持关闭,因此是该配对将本机的工作带到 cmem.ai。worker 仅在启动时读取这些键:重启它并运行 claude-mem cloud-sync 技能的 Verify 步骤,该步骤必须报告 configured: true 和 hub.reachable: true。在它报告之前不要报告成功;如果始终不报告,则改用该技能的安装流程进行配对。

  4. 在不暴露密钥的情况下验证:

node "${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs" status

报告脱敏后的输出。MISSING key 表示写入未生效;在 Pro 端点部署之前,/api/hooks/context 返回 404 是预期行为(搜索/注入仍可通过 /api/mcp 工作)。

备用来源

环境变量覆盖一切且无需编辑文件:CMEM_API_KEY、CMEM_USER_ID、CMEM_SYNC_HUB_URL、CMEM_API_BASE。

适用场景

当用户要求“set up claude-mem”“pair claude-mem”“connect cmem”“add my cmem key”“set up cloud sync in Cowork”等时使用本技能。

限制

  • 凭据为每用户配置,需用户自行从 cmem.ai 获取。
  • Cowork 容器临时性导致编辑不持久,需重新打包。
  • 本地安装存在时本插件 hooks 关闭,依赖本地配对。
  • worker 仅在启动时读取键,需重启并验证。
  • Pro 端点部署前 /api/hooks/context 返回 404 属预期。