SuperAPI AI 工具集

cloud-sync

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:为 claude-mem 配置或检查 cmem.ai Pro 云同步。已安装的 worker 通过 SyncHub 同步,只有一个客户端、一份持久操作日志,没有独立的同步守护进程。本技能负责检查状态,并把用户引导到安装器的 cmem.ai 登录流程,由安装器写入连接信息。

主要能力与状态判断:解析 worker 端口后查询状态路由。configured 为 true 且 hub.reachable 为 true 表示 worker 已完成对 SyncHub 的带认证状态探测,此时报告 deviceId、pending 计数、lastFlushAt、lastError 以及 Hub 的 head/checkpoint,除非用户要求更换连接否则就此停止。configured 为 true 但 hub.reachable 为 false 时,报告 hub.error,说明 SyncHub 连接未经验证;pending 为零或 lastError 为空不算成功,因为空队列不会推送。configured 为 false 则继续设置。重启后立即出现连接被拒、404 或 503,应先每 3 秒重试约 30 秒,再诊断 worker。

使用方式:让用户在自己的终端运行 npx claude-mem install,并在安装器询问时选择 CMEM Pro。安装器通过浏览器登录(用户批准设备码),随后自行把同步 token、用户 id 和 SyncHub URL 写入 ~/.claude-mem/settings.json 并重启 worker。无法交互运行安装器时(CI、远程机器),引导用户查看无头设置指南 https://docs.claude-mem.ai/cmem-pro-headless,由用户自行在其终端或编辑器中应用手动步骤。验证时每 5 秒轮询状态路由,最多 30 秒;若 worker 未重启,先执行重启命令。成功标准为 configured: true、hub.reachable: true、lastError: null。

安全规则:绝不能让用户把同步 token 粘贴到对话中,也不得写入、打印、放入 argv 或记录到日志。token 由安装器以 0600 权限写入 settings.json。

限制:本地路由始终对 SyncHub 做带认证的只读状态探测,不使用旧版 cmem.ai Pro 状态路由,也不追加或推进同步状态。pending 计数只描述 SyncHub 上线基线之后的写入,设置不会迁移上线前的本地语料。云同步会把观测叙述和完整提示文本上传到用户的 cmem.ai 账户。若 hub.reachable 为 false 应报告 hub.error,lastError 非空也要报告,并可建议重新运行 npx claude-mem install 刷新连接。

收费、价格等其余细节暂未提供。