wehub/zhouxiaoka--autoclip
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
zhouxiaoka--autoclip/docs/USER_GUIDE.md
T
wehub-resource-sync 41b710f9c7
CI / Frontend checks (push) Failing after 0s
Details
CI / Backend tests (push) Failing after 1s
Details
I18n Documentation Sync / sync-docs (push) Failing after 0s
Details
chore: import upstream snapshot with attribution
2026-07-13 12:28:40 +08:00

9.2 KiB
Raw Permalink Blame History

📚 AutoClip Desktop 用户使用指南

🎯 快速开始

第一次使用

  1. 启动应用：双击桌面图标或从应用程序文件夹启动
  2. 首次配置向导：系统会自动引导您完成初始设置
  3. 配置AI服务：设置语音识别和AI模型API密钥
  4. 开始使用：上传视频文件，开始您的第一个项目

基本工作流程

上传视频 → 语音转写 → AI分析 → 生成切片 → 创建合集 → 导出分享

📁 项目管理

创建新项目

  1. 点击首页的 "新建项目" 按钮
  2. 选择视频文件（支持MP4、AVI、MOV、MKV、WEBM格式）
  3. 可选：上传字幕文件（SRT、VTT格式）
  4. 输入项目名称和描述
  5. 选择视频分类（如：教育、娱乐、商业等）
  6. 点击 "开始处理"

项目状态说明

  • 🔄 处理中：视频正在分析处理
  • ✅ 已完成：处理完成，可以查看结果
  • ❌ 失败：处理失败，请检查错误信息
  • ⏸️ 暂停：处理已暂停

项目操作

  • 查看详情：点击项目卡片查看详细信息
  • 重新处理：失败的项目可以重新开始处理
  • 删除项目：删除不需要的项目和文件
  • 导出项目：导出项目数据和结果

🎬 视频切片管理

查看切片

  1. 进入项目详情页面
  2. 在 "切片列表" 中查看所有生成的切片
  3. 每个切片显示：
    • 标题和描述
    • 时间范围
    • 质量评分
    • 预览缩略图

切片操作

  • 播放预览：点击切片卡片播放视频片段
  • 编辑信息：修改切片标题和描述
  • 调整时间：微调切片的开始和结束时间
  • 删除切片：移除不需要的切片

切片质量评分

系统会根据以下标准为每个切片评分：

  • 内容质量：信息密度、逻辑清晰度
  • 语言表达：语速适中、表达清晰
  • 视觉质量：画面稳定、光线充足
  • 时长合适：不会太短或太长

评分范围：0-100分，推荐使用70分以上的切片。

📚 合集管理

创建合集

  1. 在项目详情页面，点击 "创建合集"
  2. 选择要包含的切片
  3. 输入合集标题和描述
  4. 选择合集类型：
    • AI推荐：系统自动推荐的相关切片
    • 手动创建：用户手动选择的切片
  5. 点击 "创建合集"

合集操作

  • 查看合集：浏览合集内容和切片列表
  • 编辑合集：修改标题、描述和包含的切片
  • 重新排序：调整切片在合集中的顺序
  • 导出合集：生成完整的视频文件
  • 分享合集：获取分享链接或二维码

合集类型

  • 主题合集：围绕特定主题的切片集合
  • 时间合集：按时间顺序组织的切片
  • 质量合集：高质量切片的精选集合
  • 自定义合集：用户自定义的切片组合

⚙️ 系统设置

AI模型配置

语音识别设置

本地Whisper模型

  • 优点：免费、隐私安全、离线可用
  • 缺点：需要下载模型文件、处理速度较慢
  • 推荐模型：
    • base：平衡速度和准确性
    • small：较快速度，适合实时处理
    • medium：较高准确性，适合重要内容
    • large：最高准确性，适合专业用途

云端API服务

  • 优点：处理速度快、准确性高、无需本地资源
  • 缺点：需要网络连接、可能产生费用
  • 支持服务：
    • OpenAI Whisper API
    • Azure Speech Services
    • Google Cloud Speech-to-Text
    • 阿里云语音识别

大语言模型设置

推荐配置

  • 阿里通义千问：中文支持好，性价比高
  • OpenAI GPT：功能强大，支持多语言
  • Google Gemini：免费额度大，响应快速
  • 硅基流动：国内服务，访问稳定

性能设置

性能级别

  • 低性能模式：适合资源受限的设备

    • 文件大小限制：512MB
    • 并发处理：1个任务
    • 内存使用：2GB

  • 中等性能模式：平衡性能和资源使用（推荐）

    • 文件大小限制：2GB
    • 并发处理：2个任务
    • 内存使用：4GB

  • 高性能模式：适合资源充足的设备

    • 文件大小限制：5GB
    • 并发处理：4个任务
    • 内存使用：8GB

存储设置

  • 数据目录：设置项目文件存储位置
  • 缓存管理：清理临时文件和缓存
  • 自动清理：定期清理旧项目文件

应用设置

自动启动

  • 启用后，应用会在系统启动时自动运行
  • 可以通过系统托盘图标访问应用
  • 适合需要频繁使用的用户

通知设置

  • 处理完成通知
  • 错误提醒通知
  • 系统状态通知

🔧 高级功能

批量处理

  1. 选择多个项目
  2. 点击 "批量操作"
  3. 选择操作类型：
    • 批量重新处理
    • 批量导出
    • 批量删除

自定义提示词

在设置中可以自定义AI分析的提示词：

  • 切片提取提示词：定义什么样的内容应该被提取为切片
  • 标题生成提示词：定义标题的生成规则和风格
  • 合集推荐提示词：定义合集推荐的逻辑

API集成

Webhook通知

  • 设置处理完成后的Webhook通知
  • 支持自定义通知格式
  • 可用于与其他系统集成

数据导出

  • 导出项目数据为JSON格式
  • 导出切片信息为CSV格式
  • 支持自定义导出字段

🚨 故障排除

常见问题

应用无法启动

症状：双击应用图标后没有反应

解决方案：

  1. 检查系统要求是否满足
  2. 重新下载并安装应用
  3. 检查系统权限设置
  4. 查看系统日志中的错误信息

视频上传失败

症状：上传视频时提示错误

可能原因：

  • 文件格式不支持
  • 文件大小超过限制
  • 网络连接问题
  • 磁盘空间不足

解决方案：

  1. 检查文件格式和大小
  2. 检查网络连接
  3. 清理磁盘空间
  4. 尝试重新上传

处理速度慢

症状：视频处理时间过长

优化建议：

  1. 调整性能设置到更高级别
  2. 关闭其他占用资源的应用
  3. 使用云端API服务
  4. 选择较小的Whisper模型

API连接失败

症状：AI服务无法正常工作

检查步骤：

  1. 验证API密钥是否正确
  2. 检查网络连接
  3. 确认API服务状态
  4. 检查账户余额或配额

错误代码说明

错误代码 说明 解决方案
ERR_001 文件格式不支持 使用支持的视频格式
ERR_002 文件大小超限 压缩视频或使用分片上传
ERR_003 API密钥无效 检查并更新API密钥
ERR_004 网络连接失败 检查网络连接
ERR_005 磁盘空间不足 清理磁盘空间
ERR_006 内存不足 关闭其他应用或调整设置

获取帮助

在线帮助

  • 用户手册：查看完整的使用说明
  • 视频教程：观看操作演示视频
  • 常见问题：查看FAQ和解决方案

技术支持

  • GitHub Issues：报告bug和功能请求
  • 用户社区：与其他用户交流经验
  • 邮件支持：发送邮件获取技术支持

反馈建议

我们欢迎您的反馈和建议：

  • 功能建议：告诉我们您希望添加的功能
  • 使用体验：分享您的使用感受
  • 问题报告：详细描述遇到的问题

📊 最佳实践

视频准备建议

  1. 视频质量：

    • 分辨率：1080p或以上
    • 帧率：30fps或以上
    • 音频：清晰无杂音

  2. 内容结构：

    • 主题明确，逻辑清晰
    • 避免过长的停顿
    • 语速适中，表达清晰

  3. 文件格式：

    • 推荐使用MP4格式
    • 文件大小控制在2GB以内
    • 确保视频可以正常播放

切片优化技巧

  1. 标题优化：

    • 简洁明了，突出要点
    • 包含关键词，便于搜索
    • 长度控制在30字以内

  2. 描述完善：

    • 详细描述切片内容
    • 包含关键信息点
    • 便于后续查找和使用

  3. 质量筛选：

    • 优先使用高评分切片
    • 定期清理低质量内容
    • 建立质量评估标准

合集组织策略

  1. 主题分类：

    • 按内容主题组织
    • 建立清晰的分类体系
    • 便于内容管理和查找

  2. 时间管理：

    • 定期整理和更新合集
    • 标记重要和常用合集
    • 建立内容更新计划

  3. 分享优化：

    • 为合集添加吸引人的标题
    • 编写详细的合集描述
    • 选择合适的分享时机

🔄 版本更新

自动更新

应用会自动检查更新并提示用户：

  1. 点击 "立即更新" 下载新版本
  2. 安装完成后重启应用
  3. 新功能会自动生效

手动更新

  1. 访问 Releases页面
  2. 下载最新版本的安装包
  3. 按照安装步骤重新安装

更新日志

每次更新都会包含：

  • 新功能：新增的功能特性
  • 改进优化：性能提升和体验改进
  • 问题修复：修复的bug和问题
  • 兼容性：系统兼容性更新

📞 联系我们

感谢您使用 AutoClip Desktop！🎉

Reference in New Issue View Git Blame Copy Permalink