zhouxiaoka--autoclip
wehub-resource-sync
162 行
6.1 KiB
Markdown
162 行
6.1 KiB
Markdown
# AutoClip 桌面版发布说明
|
||
|
||
## v1.1.0 - 2026年5月
|
||
|
||
> 这一版让 macOS 桌面客户端**真正可装、可用、能出片**。v1.0.0 的安装包此前存在打不出产物、
|
||
> 打开黑屏、处理卡死等问题，v1.1.0 把整条链路从头打通并端到端验证。
|
||
|
||
### 🚀 桌面客户端可用了
|
||
|
||
- **零依赖安装**：安装包内置便携 Python 运行时和静态 ffmpeg/ffprobe，用户机器**无需预装
|
||
Python 或 ffmpeg**，双击 DMG 即可使用。
|
||
- **端到端出片**：粘贴 B站/YouTube 链接 → 自动下载 → 字幕 → AI 大纲/时间线/评分/标题/聚类 →
|
||
ffmpeg 切割 → 生成切片与合集，整条流水线在本地直接跑通（桌面模式不再依赖 Redis）。
|
||
|
||
### 🐛 关键修复
|
||
|
||
- **修复启动黑屏**：前端打包的依赖加载顺序问题（antd 早于 React 初始化）导致页面空白，现已修正。
|
||
- **修复项目列表一直「加载中」**：补齐运行时缺失的依赖（`pytz` 等），接口恢复正常。
|
||
- **修复重试时疯狂弹窗**：导入/重试时的提示循环已根治，一次点击对应一次操作。
|
||
- **修复处理一直卡在 0%**：桌面模式下流水线改为本地执行，任务能真正跑起来。
|
||
- 内置 ffmpeg/ffprobe 改为静态自包含版本，解决换机后无法处理视频的问题。
|
||
|
||
### ✨ 新功能：本地字幕转写（按需）
|
||
|
||
- 对于**没有字幕的视频**，可在「设置 → 语音转写」里**一键安装 Whisper**（采用 faster-whisper，
|
||
约 200–400MB，不含 PyTorch），并自行选择/下载模型（tiny / base / small / medium / large-v3）。
|
||
- 装不装、装哪个模型完全由你决定；不需要时基础安装包保持精简。
|
||
|
||
### 🔧 其他
|
||
|
||
- AI 提供商 Gemini 迁移到官方新版 `google-genai` SDK。
|
||
- CI 桌面构建工作流统一为一条经过验证的流程；仓库清理（移除大量历史脚本与一次性文档）。
|
||
|
||
### 📦 安装说明（macOS, Apple Silicon）
|
||
|
||
1. 双击 DMG，将 `AutoClip Desktop` 拖入「应用程序」。
|
||
2. **首次打开请右键点应用 → 选「打开」**（ad-hoc 签名、未做 Apple 公证，用于绕过 Gatekeeper）。
|
||
3. 进入「设置」填入 AI 提供商的 API Key 即可开始使用。
|
||
|
||
> 当前仅提供 Apple Silicon (M 系列) 版本；Intel / Windows / Linux 包后续提供。
|
||
|
||
---
|
||
|
||
## v1.0.0 - 2024年12月
|
||
|
||
### 🎉 首次发布
|
||
|
||
AutoClip桌面版是基于AI的智能视频切片工具，支持自动识别精彩片段并生成合集。
|
||
|
||
### ✨ 主要功能
|
||
|
||
#### 🎬 视频处理
|
||
- **多平台支持**: YouTube、B站视频一键下载
|
||
- **本地文件**: 支持本地视频文件上传
|
||
- **智能切片**: AI自动识别精彩片段
|
||
- **合集生成**: 智能推荐和手动创建视频合集
|
||
|
||
#### 🤖 AI功能
|
||
- **内容分析**: 基于通义千问的视频内容理解
|
||
- **精彩评分**: 对每个片段进行AI评分
|
||
- **标题生成**: 自动生成吸引人的视频标题
|
||
- **时间点提取**: 智能识别话题时间区间
|
||
|
||
#### 🖥️ 桌面体验
|
||
- **原生应用**: 基于Tauri的跨平台桌面应用
|
||
- **系统托盘**: 支持最小化到系统托盘
|
||
- **开机自启**: 可设置开机自动启动
|
||
- **实时进度**: WebSocket实时进度推送
|
||
|
||
#### 🎨 用户界面
|
||
- **现代设计**: React + TypeScript + Ant Design
|
||
- **响应式布局**: 适配不同屏幕尺寸
|
||
- **拖拽排序**: 支持视频片段拖拽排序
|
||
- **实时监控**: 详细的任务状态显示
|
||
|
||
### 🛠️ 技术特性
|
||
|
||
- **后端**: FastAPI + Celery + Redis + SQLite
|
||
- **前端**: React 18 + TypeScript + Vite
|
||
- **桌面**: Tauri 2.0 (Rust)
|
||
- **AI**: 通义千问大语言模型
|
||
- **视频**: yt-dlp + FFmpeg
|
||
|
||
### 📦 系统要求
|
||
|
||
#### 最低配置
|
||
- **操作系统**: Windows 10+ / macOS 10.13+ / Linux
|
||
- **内存**: 4GB RAM
|
||
- **存储**: 10GB 可用空间
|
||
- **网络**: 稳定的互联网连接
|
||
|
||
#### 推荐配置
|
||
- **内存**: 8GB+ RAM
|
||
- **存储**: 20GB+ 可用空间
|
||
- **处理器**: 多核处理器
|
||
|
||
### 🚀 快速开始
|
||
|
||
1. **下载安装**: 从GitHub Releases下载对应平台的安装包
|
||
2. **首次启动**: 运行应用，系统会自动初始化
|
||
3. **配置API**: 在设置中配置通义千问API密钥
|
||
4. **开始使用**: 创建项目，添加视频链接或上传文件
|
||
|
||
### 📋 使用步骤
|
||
|
||
1. **创建项目**: 点击"新建项目"
|
||
2. **添加视频**: 选择YouTube/B站链接或上传本地文件
|
||
3. **AI处理**: 系统自动分析视频内容
|
||
4. **查看结果**: 浏览生成的视频片段
|
||
5. **创建合集**: 选择精彩片段创建合集
|
||
6. **导出下载**: 下载单个片段或完整合集
|
||
|
||
### ⚠️ 注意事项
|
||
|
||
- 需要配置通义千问API密钥才能使用AI功能
|
||
- 首次使用需要下载依赖，请确保网络连接稳定
|
||
- 视频处理需要一定时间，请耐心等待
|
||
- 建议定期清理临时文件以节省存储空间
|
||
|
||
### 🔧 故障排除
|
||
|
||
#### 常见问题
|
||
- **启动失败**: 检查系统权限和依赖安装
|
||
- **下载失败**: 检查网络连接和视频链接有效性
|
||
- **AI处理慢**: 检查API密钥配置和网络状况
|
||
- **存储不足**: 清理临时文件和不需要的项目
|
||
|
||
#### 获取帮助
|
||
- 查看 [用户指南](docs/USER_GUIDE.md)
|
||
- 阅读 [常见问题](docs/FAQ.md)
|
||
- 提交 [GitHub Issue](https://github.com/zhouxiaoka/autoclip/issues)
|
||
|
||
### 🛣️ 未来计划
|
||
|
||
- **B站上传**: 自动上传切片视频到B站
|
||
- **字幕编辑**: 可视化字幕编辑和同步
|
||
- **批量处理**: 支持批量视频处理
|
||
- **云端同步**: 项目数据云端同步
|
||
- **插件系统**: 支持第三方插件扩展
|
||
|
||
### 📄 许可证
|
||
|
||
本项目采用 [MIT License](LICENSE) 开源许可证。
|
||
|
||
### 🙏 致谢
|
||
|
||
感谢所有开源项目的支持，特别感谢：
|
||
- [Tauri](https://tauri.app/) - 桌面应用框架
|
||
- [FastAPI](https://fastapi.tiangolo.com/) - 后端框架
|
||
- [React](https://reactjs.org/) - 前端框架
|
||
- [通义千问](https://tongyi.aliyun.com/) - AI服务
|
||
- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - 视频下载工具
|
||
|
||
---
|
||
|
||
**下载地址**: [GitHub Releases](https://github.com/zhouxiaoka/autoclip/releases)
|
||
|
||
**项目主页**: [GitHub Repository](https://github.com/zhouxiaoka/autoclip)
|
||
|
||
**问题反馈**: [GitHub Issues](https://github.com/zhouxiaoka/autoclip/issues)
|
||
|