trending/autoclip
1
0
Fork 0
mirror of https://github.com/zhouxiaoka/autoclip.git synced 2026-10-02 02:34:34 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
autoclip/docs/USER_INSTALLATION_GUIDE.md
T
Kris KCursor AgentKris K
 e8eb4ed2f8 docs: sync user-facing copy with v1.4.0 dual analysis (#219) 
Subtitle analysis stays the default. Optional game visual analysis,
confirm-before-cut, and sampled-frame privacy wording now match the
v1.4.0 release without claiming ad results or a fully verified Windows install.

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Kris K <zhouxiaoka@users.noreply.github.com>
2026-09-27 17:20:11 +08:00

7.0 KiB
Raw Permalink Blame History

安装与第一次出片

English · 返回首页 · 排错指南

选择使用方式

环境 建议方式
macOS · Apple Silicon（M 系列） 下载桌面版，选择名称含 aarch64 的 .dmg
Windows 10 / 11 · x64 下载桌面版，选择名称含 x64-setup.exe 的安装包
Intel Mac / Linux / 自建服务 Docker 或 CLI

以 Release 页面实际提供的安装包和系统要求为准。不要把源码压缩包 Source code 当作安装包。桌面版内置 Python 和 FFmpeg；本地语言模型、语音转写组件和模型文件需要另外准备。

处理大文件和运行本地模型需要额外内存与磁盘空间。空间预算应包含原视频、转写模型、临时文件、切片与导出结果；不承诺固定处理速度或最低配置下的效果。

安装桌面版

macOS

打开 .dmg，将 AutoClip Desktop 拖到“应用程序”，再从“应用程序”打开。若系统阻止未公证版本，先确认安装包来自本仓库的 Releases，再按该 Release 的首次启动说明操作。不要为此关闭系统全局安全检查。

Windows

运行 x64-setup.exe 并按向导安装。安装包按用户安装，无需常规使用管理员权限；缺少 WebView2 时，安装器可能需要联网下载。若系统拦截未签名版本，先确认下载来源，再参考 Release 中的提示。v1.4.0 提供 Windows 安装包；实际安装、导入与保存尚待实机验收，以该版本 Release 为准。

第一次使用

  1. 先配置模型。 打开“设置”，选择 Qwen、OpenAI、Gemini、DeepSeek、Doubao Seed、Kimi、GLM、Grok 或本地模型。云端服务填写自己的 API Key 和模型名，点击测试连接，再保存；兼容接口可配置 Base URL。本地模型先在 Ollama / LM Studio 启动服务并加载模型。默认路线是字幕分析。游戏视觉分析自 v1.4.0 起可选：需要多模态模型，并显式启用付费视觉初筛。配好模型不等于已经允许每次视觉调用。
  2. 准备字幕（默认路线）。 有时间轴准确的 .srt 就与视频一起导入。没有字幕时，在设置中的语音识别区域完成本地 Whisper 组件与模型准备；首次安装和下载需要网络。
  3. 导入并确认。 准备一段你有权使用的短视频。在首页用「文件导入」导入视频及可选 SRT，或用「链接导入」粘贴 B 站 / YouTube 链接。先确认制作类型，也可手动校正。未确认的导入可恢复；确认后才正式理解和剪辑。素材要求与示例见下方「自备短样片」。
  4. 在共用编辑器里检查。 查看片段起止、标题和文案。输出仍需人工检查边界、裁切和文案。若失败，按页面提示定位字幕、分析或导出阶段，参见 FAQ。
  5. 导出成片。 使用导出入口，按发布平台选择预设。竖屏导出可加入字幕和标题卡；导出后先播放检查，再自行发布。

默认路线是字幕分析，适合访谈、播客、课程等以语言为主的视频。自 v1.4.0 起，游戏录屏可另行启用视觉分析，需要多模态模型并显式启用付费视觉初筛。单一样本不代表所有游戏；输出仍需人工检查，不承诺广告投放效果。v1.4.0 不含 CTA 动效、生成式品牌尾卡、卡拉 OK / 逐词字幕。

自备短样片

AutoClip 不托管官方样片。Release 里没有样片压缩包，也不提供成片下载。请使用自己的短视频，或你有权使用的公开平台链接。

  • 时长约 3–5 分钟，对白清楚。
  • 尽量带上时间轴准确的 .srt。没有字幕时，先在设置中准备本地 Whisper，或换一条已有字幕的视频。
  • 来源可以是本地文件、B 站或 YouTube。请确认你有权使用该媒体。

第一次出片先试这条：Jackie Dowling | Stanford Energy Fellow（Stanford ENERGY）。示例·非托管·自担使用权。

下面是另外两条普通示例，不必都试。多为英语对白，可开官方字幕或自备 SRT/Whisper。我们不提供成片下载。

也可改用你自己的短片。

第一次出片的常见卡点见 讨论 #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，应妥善保存。不要把卸载、删除数据库或清空数据目录作为常规排错步骤，也不要假设已有自动备份。

获取帮助

先看 常见问题 和 已知问题。第一次出片卡住（模型、没有字幕、系统警告）请到 第一次出片问答。欢迎说明和分类见 欢迎与分类。仍无法解决时，邮件提供系统、应用版本、模型、失败阶段、复现步骤和已脱敏日志。

个人业余维护，回复时间不固定，不提供即时客服或一对一部署服务。

邮箱：christine_zhouye@163.com

Reference in New Issue View Git Blame Copy Permalink