claude-mem 云同步
为 Clode Code 配置记忆云同步,备份到 cmem.ai Pro。
技能明确规定了安全规则:不打印或记录同步令牌,仅在设置文件中以0600权限保存,且要求保留其他设置。使用本地HTTP端点和环境变量,未请求全局文件权限。但存在风险:静态读取无法验证实际执行,且作为付费云同步功能,用户数据(观察记录和提示文本)显式上传至cmem.ai账户,虽然文档有告知,但外部依赖的隐私影响仍需用户自行权衡。扣分原因:数据流向透明但依赖于外部商业服务,且无回滚或撤销机制;权限最小化较好,但云同步的外部数据流是核心功能,需用户明确同意。
技能步骤详细,包括明确的状态检查、错误处理和验证路径。但静态审查无法验证脚本正确性,也未看到针对此技能路径的测试。扣分原因:缺乏针对本技能执行测试和边缘情况覆盖;错误信息有提示,但整体可靠性证据不足。
适用场景明确(用户明确要求设置云同步或检查状态),触发语义清晰。但云同步依赖cmem.ai Pro账户和可能无法从中国大陆访问的海外服务,适应性受限。扣分原因:功能依赖外部商业服务且可能受网络限制,未声明对大陆用户的适配性;边界条件有部分说明,但环境适配证据不足。
SKILL.md结构清晰,有分节、安全规则、明确的脚本和输出格式。但缺少版本控制、变更日志、FAQ和已知限制的详细说明。扣分原因:缺乏版本历史、故障排除和限制披露;维护责任虽通过README可见,但对于技能本身更新路径不明确。
技能目标明确,能够完成设置或检查状态的核心任务,并输出结构化报告。但有效性证据不足,未提供实际输出示例或测试验证。扣分原因:静态审查无法验证实际执行的有效性,输出格式虽清晰,但直接可用性证据有限。
仓库有CI和测试,但未覆盖此技能路径。技能本身声称的操作无法独立验证。扣分原因:缺乏针对本技能的可追溯证据,如CI运行结果或测试覆盖;第三方执行证据不足。
- 该技能会向cmem.ai账户上传观察记录和完整提示文本,用户应明确了解数据上传的隐私影响。
- 云同步依赖cmem.ai Pro付费服务,功能可能受网络环境影响,中国大陆用户可能无法正常使用或需要额外网络配置。
- 设置文件包含同步令牌等敏感信息,虽然技能要求以0600权限保存,但用户应确保本地环境安全。
- 静态审查无法验证脚本实际运行效果,建议在实际部署前仔细检查脚本中的占位符替换和路径假设。
这个 Skill 能做什么,适合哪些场景?
此技能用于设置或检查 claude-mem 的云同步功能。它指导用户从 cmem.ai 网站获取同步令牌、用户 ID 和 SyncHub URL,然后将这些值写入本地的 settings.json 文件。技能会验证连接状态,并在出现问题时提供诊断信息。核心功能是备份记忆数据库,确保数据安全。
该技能执行以下操作:1. 查询本地 worker 的 /api/sync/status 路由,检查同步配置状态和 SyncHub 可达性。2. 向用户请求三个连接值(同步令牌、用户 ID、SyncHub URL)。3. 使用 Node.js 脚本将这些值写入 ~/.claude-mem/settings.json,并确保文件权限为 0600。4. 通过 /api/admin/restart 重启 worker,并轮询状态直到确认配置成功。5. 报告设备 ID、待处理计数、上次同步时间、Hub 可达性及错误信息。
- 当用户说“设置云同步”或“同步我的记忆”时,用于初始化云同步。
- 当用户说“同步状态”或“云备份状态”时,检查同步是否正常工作。
- 当用户需要备份记忆数据库到 cmem.ai 账户时,提供配置步骤。
- 当同步失败时,技能会指示用户检查连接值。
这个 Skill 有哪些优点和局限?
- 自动化配置流程,减少手动编辑配置文件。
- 安全处理令牌,遵循不打印、不记录的安全规则。
- 提供详细的诊断信息,帮助排查问题。
- 仅支持 cmem.ai Pro 用户,普通用户无法使用。
- 需要用户从网站手动复制三个值,流程稍显繁琐。
- 文档未提及测试覆盖情况,可能存在未验证的场景。
如何安装这个 Skill?
此技能是 claude-mem 插件的一部分。安装整个集合:npx claude-mem install 或 /plugin marketplace add thedotmack/claude-mem 然后 /plugin install claude-mem。技能位于 plugin/skills/cloud-sync/SKILL.md。
如何使用这个 Skill?
在 Claude Code 会话中,直接说出触发词,例如“设置云同步”或“同步状态”。技能会引导你完成获取连接值并写入设置的步骤。