用途:为 context-mode 插件提供交互式云端连接向导,把本地配置与 Context Mode Cloud 打通,使事件可同步到云端仪表盘。
主要能力:读取并检查已有配置;若检测到非空 api_token,会提示已配置,并仅以掩码形式展示令牌末四位(如 ctx_****abcd),不泄露完整令牌;询问是重新配置还是保留当前设置;依次采集 API URL、API Token 和 Organization ID,其中 URL 默认 https://api.context-mode.com,Token 须以 ctx_ 开头且至少 20 个字符,两个字段均必填;将配置写入 ~/.context-mode/sync.json,包含 enabled、api_url、api_token、organization_id、batch_size(50)和 flush_interval_ms(30000),并把文件权限设为 600;最后用 curl 请求 <API_URL>/api/health 进行健康检查,200 视为成功,其他结果视为连接错误,结果以 Markdown 形式在对话中展示。
必要用法:读取配置可用 cat ~/.context-mode/sync.json 2>/dev/null || echo "NOT_FOUND";保存时先 mkdir -p ~/.context-mode,再写入 sync.json 并执行 chmod 600 ~/.context-mode/sync.json;测试连接使用 curl -sf -o /dev/null -w "%{http_code}" -H "Authorization: Bearer <API_TOKEN>" "<API_URL>/api/health"。失败时可运行 /ctx-cloud-setup 重新配置,成功后可用 /ctx-cloud-status 查看同步状态。
安全与限制:不得记录或显示完整 API Token,始终掩码;令牌仅通过 HTTPS 的 Authorization 头传输。该技能本身不涉及收费、价格或平台支持范围的说明,相关资料暂未提供。