Laper“同步剧本”失败主因是客户端与api.laper.dev后端通信中断，需先访问https://api.laper.dev/health确认服务可用性，再关闭系统代理、排查防火墙拦截，并彻底删除~/Library/Application Support/Laper/network或%APPDATA%\Laper\network目录以重置网络凭证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Laper中点击“同步剧本”却弹出“网络错误”或“连接异常”提示，无法将本地修改上传至云端协作空间时，问题往往不出在互联网本身，而是Laper客户端与特定后端服务之间的通信链路中断——这包括代理拦截、域名解析失败、证书校验异常或服务端临时不可达。
确认Laper服务端当前是否可用
打开浏览器，访问 https://api.laper.dev/health（注意是 api.laper.dev，不是 www 或 app 子域）。如果页面返回 {"status":"ok","timestamp":...}，说明核心API服务在线；若显示连接超时、SSL错误或 404，则服务端已不可用，此时所有同步操作必然失败，无需继续排查本地。
该地址是Laper官方公开的健康检查端点，不需登录，响应快于客户端自身状态提示。
检查系统代理与网络策略干扰
方法一：关闭系统级代理
进入系统设置 → 网络 → 代理，将“自动代理配置”和“手动代理”全部关闭。Laper不支持通过PAC脚本或HTTP代理中转请求，启用后必触发连接异常。
方法二：验证是否被企业防火墙拦截
在终端执行：curl -v https://api.laper.dev/v1/sync/status 2>&1 | grep "Connected to"
若输出中无 Connected to api.laper.dev 字样，或卡在 Trying 8.148.71.123... 后超时，说明DNS解析或TCP建连已被阻断。
【关键前提】必须使用真实IP直连，Laper客户端硬编码了服务端IP（如8.148.71.123），绕过DNS更可靠——但若该IP被本地hosts屏蔽或防火墙丢包，同步必定失败。
重置Laper本地网络凭证与缓存
第一步：完全退出Laper客户端（macOS需右键菜单选「退出」，Windows需在任务栏右下角图标上右键→退出，不能仅关窗口）。
第二步：删除网络认证缓存目录：
macOS → 打开访达，按 Cmd+Shift+G 输入 ~/Library/Application Support/Laper/network/，删除整个 network 文件夹；
Windows → 进入 %APPDATA%\Laper\network\，彻底清空该目录。
第三步：重启Laper并立即尝试同步。此操作会强制重建TLS握手通道，清除因证书信任链损坏或token过期导致的静默连接拒绝。
这一步操作起来很简单，直接把文件夹拖进废纸篓就行。但注意：不要只删里面的json文件，必须整删目录——残留的旧凭据会阻止新会话建立。
