zhouxiaoka--autoclip/docs/FAQ.md

❓ AutoClip Desktop 常见问题解答

🚀 安装和启动

Q: 应用无法启动怎么办？

A: 请按以下步骤排查：

1. 检查系统要求

   • macOS: 10.13+ (Intel/Apple Silicon)
   • Windows: Windows 10+ (64位)
   • Linux: Ubuntu 18.04+ 或其他主流发行版

2. 重新安装应用

   • 完全卸载旧版本
   • 重新下载最新安装包
   • 按照安装指南重新安装

3. 检查系统权限

   • macOS: 系统偏好设置 > 安全性与隐私 > 允许应用运行
   • Windows: 以管理员身份运行
   • Linux: 检查文件执行权限

4. 查看错误日志

   • 检查系统日志中的错误信息
   • 联系技术支持并提供错误详情

Q: 首次运行时提示"无法验证开发者"？

A: 这是macOS的安全机制，解决方法：

1. 打开 系统偏好设置 > 安全性与隐私
2. 在 通用 标签页中找到被阻止的应用
3. 点击 "仍要打开" 按钮
4. 确认允许应用运行

Q: 应用启动后显示空白页面？

A: 可能的原因和解决方案：

1. 网络连接问题

   • 检查网络连接
   • 尝试刷新页面 (F5)

2. 端口冲突

   • 重启应用
   • 检查8000端口是否被占用

3. 缓存问题

   • 清除应用缓存
   • 重启应用

📁 文件上传

Q: 支持哪些视频格式？

A: 支持的视频格式：

• MP4 (推荐)
• AVI
• MOV
• MKV
• WEBM
• FLV
• WMV

Q: 文件大小有限制吗？

A: 是的，根据性能设置：

• 低性能模式: 最大512MB
• 中等性能模式: 最大2GB (推荐)
• 高性能模式: 最大5GB

Q: 上传失败怎么办？

A: 请检查以下项目：

1. 文件格式

   • 确保使用支持的视频格式
   • 推荐使用MP4格式

2. 文件大小

   • 检查文件是否超过大小限制
   • 可以压缩视频文件

3. 网络连接

   • 检查网络连接是否稳定
   • 尝试重新上传

4. 磁盘空间

   • 确保有足够的磁盘空间
   • 至少需要文件大小的2倍空间

Q: 可以上传字幕文件吗？

A: 可以，支持的字幕格式：

• SRT (推荐)
• VTT
• ASS
• SSA

上传字幕文件可以：

• 提高语音识别的准确性
• 加快处理速度
• 提供更精确的时间轴

🤖 AI配置

Q: 如何配置语音识别？

A: 有两种方式：

本地Whisper模型

1. 进入 设置 > 语音转写配置
2. 选择 "本地Whisper模型"
3. 选择模型大小：
   • base: 平衡速度和准确性 (推荐)
   • small: 快速处理
   • medium: 高准确性
   • large: 最高准确性
4. 点击 "下载模型" (首次使用)

云端API服务

1. 选择 "云端API服务"
2. 选择服务提供商：
   • OpenAI Whisper API
   • Azure Speech Services
   • Google Cloud Speech-to-Text
   • 阿里云语音识别
3. 输入API密钥
4. 测试连接

Q: 如何获取API密钥？

A: 各服务商获取方式：

阿里通义千问

1. 访问 阿里云控制台
2. 注册/登录账号
3. 开通通义千问服务
4. 获取API密钥

OpenAI

1. 访问 OpenAI官网
2. 注册/登录账号
3. 创建API密钥
4. 充值账户余额

Google Gemini

1. 访问 Google AI Studio
2. 使用Google账号登录
3. 获取API密钥
4. 免费额度：每分钟15次请求

Q: API连接测试失败？

A: 请检查：

1. API密钥

   • 确保密钥正确
   • 检查是否过期
   • 确认有足够余额

2. 网络连接

   • 检查网络是否正常
   • 确认可以访问API服务

3. 服务状态

   • 检查API服务是否正常
   • 查看服务商状态页面

4. 配置信息

   • 确认所有配置项正确
   • 检查地区设置

⚙️ 性能设置

Q: 如何选择合适的性能级别？

A: 根据设备配置选择：

低性能模式

• 适用: 老旧设备、资源受限
• 限制: 文件512MB、1个并发任务
• 内存: 2GB

中等性能模式 (推荐)

• 适用: 普通用户、日常使用
• 限制: 文件2GB、2个并发任务
• 内存: 4GB

高性能模式

• 适用: 专业用户、高配置设备
• 限制: 文件5GB、4个并发任务
• 内存: 8GB

Q: 处理速度很慢怎么办？

A: 优化建议：

1. 提高性能设置

   • 升级到更高的性能级别
   • 增加并发任务数

2. 使用云端API

   • 本地处理较慢
   • 云端API速度更快

3. 选择合适模型

   • 使用较小的Whisper模型
   • 平衡速度和准确性

4. 关闭其他应用

   • 释放系统资源
   • 提高处理速度

Q: 内存不足怎么办？

A: 解决方案：

1. 调整性能设置

   • 降低到低性能模式
   • 减少并发任务数

2. 关闭其他应用

   • 释放内存资源
   • 重启应用

3. 清理系统缓存

   • 清理临时文件
   • 重启系统

🎬 视频处理

Q: 处理时间需要多久？

A: 处理时间取决于：

1. 视频长度

   • 1小时视频约需10-30分钟
   • 具体时间因设备而异

2. 视频质量

   • 高分辨率视频处理更慢
   • 音频质量影响语音识别

3. 设备性能

   • CPU性能影响处理速度
   • 内存大小影响并发能力

4. AI服务选择

   • 云端API通常更快
   • 本地处理需要更多时间

Q: 切片质量评分低怎么办？

A: 优化建议：

1. 视频质量

   • 提高视频分辨率
   • 改善音频质量
   • 减少背景噪音

2. 内容优化

   • 语速适中
   • 表达清晰
   • 避免长停顿

3. 调整设置

   • 降低评分阈值
   • 调整切片参数
   • 使用更准确的AI模型

Q: 可以手动调整切片吗？

A: 可以，支持以下操作：

1. 编辑切片信息

   • 修改标题和描述
   • 调整时间范围

2. 删除不需要的切片

   • 移除低质量切片
   • 清理重复内容

3. 合并相关切片

   • 将相关切片合并
   • 创建更完整的内容

📚 合集管理

Q: 如何创建合集？

A: 创建步骤：

1. 选择切片

   • 在项目详情页面选择切片
   • 可以按评分、时间等筛选

2. 创建合集

   • 点击"创建合集"按钮
   • 输入合集标题和描述

3. 选择类型

   • AI推荐：系统自动推荐
   • 手动创建：用户手动选择

4. 完成创建

   • 确认合集信息
   • 点击"创建合集"

Q: 合集可以导出吗？

A: 可以，支持多种导出方式：

1. 视频文件

   • 导出为MP4格式
   • 包含所有切片内容

2. 分享链接

   • 生成在线分享链接
   • 支持二维码分享

3. 数据导出

   • 导出合集信息为JSON
   • 导出切片列表为CSV

Q: 如何管理多个合集？

A: 管理建议：

1. 分类组织

   • 按主题分类
   • 按时间排序
   • 使用标签标记

2. 定期整理

   • 删除不需要的合集
   • 更新合集内容
   • 优化合集结构

3. 备份重要合集

   • 导出重要合集
   • 定期备份数据

🔧 故障排除

Q: 应用崩溃怎么办？

A: 处理步骤：

1. 重启应用

   • 完全关闭应用
   • 重新启动

2. 检查系统资源

   • 确保有足够内存
   • 检查磁盘空间

3. 查看错误日志

   • 记录错误信息
   • 联系技术支持

4. 重新安装

   • 如果问题持续
   • 重新下载安装

Q: 数据丢失怎么办？

A: 数据恢复：

1. 检查备份

   • 查看自动备份
   • 恢复最近版本

2. 数据目录

   • 检查数据存储位置
   • 恢复项目文件

3. 联系支持

   • 提供详细信息
   • 寻求技术支持

Q: 网络连接问题？

A: 解决方案：

1. 检查网络

   • 确认网络连接正常
   • 测试其他网络

2. 防火墙设置

   • 检查防火墙配置
   • 允许应用访问网络

3. 代理设置

   • 配置代理服务器
   • 检查代理设置

💰 费用相关

Q: 使用费用如何计算？

A: 费用说明：

1. 应用本身

   • 完全免费使用
   • 无订阅费用

2. AI服务费用

   • 阿里通义千问：按调用次数计费
   • OpenAI：按Token计费
   • Google Gemini：有免费额度

3. 存储费用

   • 本地存储免费
   • 云端存储可能收费

Q: 如何节省费用？

A: 节省建议：

1. 使用免费服务

   • Google Gemini有免费额度
   • 本地Whisper模型免费

2. 优化使用

   • 减少不必要的API调用
   • 使用本地处理

3. 批量处理

   • 集中处理多个项目
   • 提高处理效率

🔄 更新和维护

Q: 如何更新应用？

A: 更新方式：

1. 自动更新

   • 应用会自动检查更新
   • 点击"立即更新"安装

2. 手动更新

   • 访问GitHub Releases页面
   • 下载最新版本安装

3. 更新内容

   • 新功能特性
   • 性能优化
   • 问题修复

Q: 数据会丢失吗？

A: 数据安全：

1. 自动备份

   • 系统自动备份重要数据
   • 定期清理旧备份

2. 手动备份

   • 可以手动导出数据
   • 建议定期备份

3. 数据迁移

   • 更新时保留用户数据
   • 支持数据迁移

📞 技术支持

Q: 如何获取技术支持？

A: 支持渠道：

1. 在线帮助

   • 查看用户手册
   • 浏览常见问题

2. 社区支持

   • GitHub Issues
   • 用户社区论坛

3. 直接联系

   • 邮件技术支持
   • 在线客服

Q: 如何报告问题？

A: 报告步骤：

1. 收集信息

   • 错误截图
   • 错误日志
   • 操作步骤

2. 详细描述

   • 问题现象
   • 复现步骤
   • 期望结果

3. 提交报告

   • 通过GitHub Issues
   • 发送邮件给技术支持

---

💡 使用技巧

1. 首次使用：建议先处理短视频熟悉流程
2. 性能优化：根据设备选择合适的性能级别
3. API配置：建议配置多个API服务作为备选
4. 定期清理：定期清理不需要的项目和缓存
5. 数据备份：重要项目建议定期备份

如果这里没有找到您的问题答案，请：

• 查看完整的用户手册
• 访问GitHub Issues页面
• 联系技术支持团队

🎉 祝您使用愉快！