常见问题

本文档收集了 VidGlyph 使用中的常见问题和解决方案。

安装问题

Q: 下载的安装包无法运行

A: 请尝试以下步骤：

确认操作系统版本符合要求（Windows 10+ / macOS 11+ / Ubuntu 20.04+）
Windows 用户：右键安装包 → 「以管理员身份运行」
macOS 用户：系统偏好设置 → 安全性与隐私 → 仍要打开

Q: 开发环境启动失败

A: 检查依赖：

bash

node --version    # >= 18
npm --version     # >= 9
rustc --version   # >= 1.82

使用问题

Q: 视频导入失败

A: 可能原因：

视频格式不支持 — 请使用 MP4/MKV/AVI/MOV/WebM/M4V/WMV/FLV/3GP
视频文件损坏 — 尝试用 FFmpeg 转码：
bash
```
ffmpeg -i input.mkv -c copy output.mp4
```
1

Q: OCR 识别准确率低

A: 优化建议：

精确调整 ROI：使用 8 点手柄拉伸字幕框，排除画面噪声
切换云端 API 模式：在设置中配置 Gemini 或 OpenAI Vision API Key 获取最高准确率
在离线模式下调节模式：适配多语言包识别

密钥与安全

Q: API Key 存储安全吗？

A: 当前版本会将 API Key 可逆混淆后保存在本机 LocalStorage 中，主要用于避免直接明文展示，并不等同于系统密钥链或安全加密。云端 OCR 识别时，密钥和视频帧会发送给你配置的 API 服务商；请确认服务商隐私政策，不要在共享设备保存长期密钥，并可随时在设置中清除本地凭据。

获取帮助