| 环境 | 建议方式 |
|---|---|
| macOS · Apple Silicon（M 系列） | 下载桌面版，选择名称含 aarch64 的 .dmg |
| Windows 10 / 11 · x64 | 下载桌面版，选择名称含 x64-setup.exe 的安装包 |
| Intel Mac / Linux / 自建服务 | Docker 或 CLI |
以 Release 页面实际提供的安装包和系统要求为准。不要把源码压缩包 Source code 当作安装包。桌面版内置 Python 和 FFmpeg；本地语言模型、语音转写组件和模型文件需要另外准备。
处理大文件和运行本地模型需要额外内存与磁盘空间。空间预算应包含原视频、转写模型、临时文件、切片与导出结果；不承诺固定处理速度或最低配置下的效果。
打开 .dmg，将 AutoClip Desktop 拖到“应用程序”，再从“应用程序”打开。若系统阻止未公证版本，先确认安装包来自本仓库的 Releases，再按该 Release 的首次启动说明操作。不要为此关闭系统全局安全检查。
运行 x64-setup.exe 并按向导安装。安装包按用户安装，无需常规使用管理员权限；缺少 WebView2 时，安装器可能需要联网下载。若系统拦截未签名版本，先确认下载来源，再参考 Release 中的提示。
- 先配置模型。 打开“设置”，选择通义千问、OpenAI 兼容接口、Gemini、硅基流动或本地模型。云端服务填写自己的 API Key 和模型名，点击测试连接，再保存。本地模型先在 Ollama / LM Studio 启动服务并加载模型。
- 准备字幕。 有时间轴准确的
.srt就与视频一起导入。没有字幕时，在设置中的语音识别区域完成本地 Whisper 组件与模型准备；首次安装和下载需要网络。 - 自备短样片。 准备一段你有权使用、对白清楚的 3–5 分钟视频，最好同时带上时间轴准确的
.srt。在首页用「文件导入」导入视频及可选 SRT，或用「链接导入」粘贴 B 站 / YouTube 链接。素材要求与示例见下方「自备短样片」。 - 查看处理结果。 在项目详情检查片段起止时间、标题和评分，预览内容是否完整。若失败，按页面提示定位字幕、分析或导出阶段，参见 FAQ。
- 导出成片。 使用详情页的导出入口，按发布平台选择预设。竖屏导出可加入字幕和标题卡；导出后先播放检查，再自行发布。
AI 分析主要依赖字幕文本。访谈、播客、课程等以语言表达为主的视频更容易评估；纯视觉动作、音乐或无对白内容不应期待同样的高光识别效果。
AutoClip 不托管官方样片。Release 里没有样片压缩包，也不提供成片下载。请使用自己的短视频，或你有权使用的公开平台链接。
- 时长约 3–5 分钟，对白清楚。
- 尽量带上时间轴准确的
.srt。没有字幕时，先在设置中准备本地 Whisper，或换一条已有字幕的视频。 - 来源可以是本地文件、B 站或 YouTube。请确认你有权使用该媒体。
第一次出片先试这条：Jackie Dowling | Stanford Energy Fellow（Stanford ENERGY）。示例·非托管·自担使用权。
下面是另外两条普通示例，不必都试。多为英语对白，可开官方字幕或自备 SRT/Whisper。我们不提供成片下载。
- The State of Startups in 2026（Y Combinator）。示例·非托管·自担使用权。
- Sam Altman on Astra, AGI, and the future of OpenAI。第三方访谈（Sources Podcast，非 OpenAI 官方频道）。示例·非托管·自担使用权。
也可改用你自己的短片。
第一次出片的常见卡点见 讨论 #128。
| 方式 | 准备事项 |
|---|---|
| 云端 API | 服务商账号、可用 API Key、对应的模型访问权限与网络；调用费用由服务商收取 |
| Ollama | 启动 Ollama，运行 ollama pull qwen2.5:7b，在 AutoClip 选择 Ollama |
| LM Studio | 下载并加载模型，启动 Local Server，再在 AutoClip 选择实际可用的模型 |
本地预设不需要云端 API Key；本地硬件仍需承担推理开销。Whisper 负责语音转文字，语言模型负责分析字幕，二者需要分别配置。
关闭正在处理的任务并退出应用，备份数据目录后，从 Releases 获取新版安装包。v1.3.0 及以前需先手动安装 v1.3.1。自 v1.3.1 起，可在「设置 → 应用 → 检查更新」获取后续版本；确认后下载安装并重启。自动检查最多每天一次，手动下载仍然可用。
默认桌面数据目录：
| 平台 | 目录 |
|---|---|
| macOS | ~/Library/Application Support/AutoClip |
| Windows | %APPDATA%\AutoClip |
| Linux / CLI | ~/.local/share/AutoClip |
使用 CLI 自定义 --data-dir / AUTOCLIP_DATA_DIR 时，以实际配置目录为准。日志通常在数据目录的 logs 中。备份应同时包含项目文件、数据库和配置；这些配置可能含 API Key，应妥善保存。不要把卸载、删除数据库或清空数据目录作为常规排错步骤，也不要假设已有自动备份。
先看 常见问题 和 已知问题。第一次出片卡住（模型、没有字幕、系统警告）请到 第一次出片问答。欢迎说明和分类见 欢迎与分类。仍无法解决时，邮件提供系统、应用版本、模型、失败阶段、复现步骤和已脱敏日志。
个人业余维护，回复时间不固定，不提供即时客服或一对一部署服务。