常见问题

安装与启动

macOS 提示「已损坏，无法打开」/「无法验证开发者」

未签名应用的正常放行流程：右键 → 打开；仍不行时在终端执行后重开：

sudo xattr -cr "/Applications/SekaiText Next.app"

Windows SmartScreen 拦截

点「更多信息」→「仍要运行」。

下载与更新

下载 / 更新速度慢？

剧情目录元数据和 Live2D 资源走国内 CDN 加速；应用更新和插件凭更新密钥从对象存储直接下载，正常无需代理。如仍异常缓慢，检查本地网络或稍后重试。

启动时「拉取元数据」卡住不动？

元数据走 CDN 镜像并实时校验一致性，全量拉取一般在 10 秒内完成。长时间卡住时先确认应用是最新版，再检查本地网络或稍后重试。

自动更新失败

先看提示原因：“需要更新密钥”请到「设置 → 网络与调试 → 更新密钥」填写；“已在另一台设备上激活”或“密钥无效”请联系作者。也可以向作者获取最新安装包覆盖安装，数据不会丢失。

功能

语音点了没声音？

在设置中切换语音源后重试——部分数据源不托管语音文件。

Live2D 同步总提示有资源缺失

先重试一次同步（会自动回退到备用源）。若固定提示同样的失败数，通常是个别资源上游缺失，不影响其他剧情正常播放；请保持应用为最新版本。

打轴匹配结果为 0？

基本都是视频和剧情选错对应关系——确认录屏与所选剧情是同一期活动/同一话（注意脚本编号与活动实装编号可能有偏移）。

压制进度一直显示 0%？

先确认主程序是最新版。若日志显示「启动 25 秒无任何进度输出且输出文件无增长」，通常是显卡驱动的硬解管线起步挂起：程序会自动关闭硬解重试，也可以在压制前手动关闭「硬解」。反馈问题时请附上自动导出的压制日志，其中包含系统、显卡驱动与 FFmpeg 版本。

其他

并行压制概率性失败（ffmpeg 退出码 -19 等）？

多个压制任务并发时，硬件编码会话可能超出显卡驱动的额度（AMD/AMF 表现为退出码 -19，NVIDIA 表现为 -12）。硬件编码器启动失败会自动降级 x264 软编重跑；压制报错时日志会自动导出到数据目录 logs/，反馈问题时附上即可。

译文保存在哪里？会丢吗？

点「保存」时写入译文文件（默认 ~/文稿/SekaiText/故事类型/索引/ 下按规范命名，可在 设置 → 文稿保存路径 更换位置，已有文稿自动迁移）。编辑过程中应用每 30 秒在数据目录另存一份恢复文件，崩溃断电后启动会提示恢复；恢复文件不会改动译文文件，记得及时点「保存」。卸载重装不清除数据；重要项目仍建议定期备份。

更新插件后提示加载失败？

应用会自动恢复上一个可用版本；如果恢复也失败，该插件会被禁用。回到插件市场重试更新，仍失败时请附调试日志反馈。

遇到 bug 怎么反馈？

在设置中打开 调试日志，复现问题后带着导出的日志发给作者反馈。