AutoClip 本身仍然免费、开源（MIT）。云端模型调用由你选择的服务商计费，价格、额度和可用模型以服务商为准。Ollama / LM Studio 本地预设无需云端 API Key，但需要下载模型并具备相应硬件；本地 Whisper 也需要单独安装组件和语音模型。
自 v1.3.2 起，海外发布需要你自己的 Upload-Post 账号。免费档、付费档，以及 TikTok、YouTube、Instagram 等平台的每日额度，以 Upload-Post 自己的页面为准，不是 AutoClip 的承诺。
剪辑与渲染留在你的设备上，视频也保存在本机。字幕路线会把相关字幕或文案发给所选云端服务商。启用云端视觉模型时，会发送抽样画面及必要文字，费用取决于该服务商。成片只有在你点「发布」之后才会离开这台机器，发到你已经连接的平台。也可以只下载、不发布。匿名使用统计和错误报告取决于版本、构建配置和设置，详见 隐私说明。发布页自 v1.3.2 起可用。
准备好本地视频、语言模型及语音模型后，核心本地处理无需云端模型服务。视频下载、组件安装、模型下载和更新仍需要网络。不要把“本地处理”理解为所有功能都不联网。
默认路线是字幕分析，对白清楚的访谈、播客、课程、口播和直播回放比较合适。游戏录屏可以按画面剪辑：在「设置 → 服务商与模型」换一个能看图的模型。抽样画面会发给该模型，按服务商计费。单一样本不代表所有游戏；输出仍需人工检查边界、裁切和文案，不承诺广告投放效果。音乐或其他主要依赖画面、又没有换成能看图模型的内容，单靠字幕可能无法识别精彩点。没有固定出片数量或效果保证。
第一次想先看效果：首页还没有项目时，点「用示例项目看看效果」。示例随安装包附带（source.mp4 与 source.srt），不需要 API Key，也不是单独的样片压缩包。
之后再用自己有权使用的短片：3–5 分钟、对白清楚，最好带时间轴准确的 .srt。来源用本地文件或 B 站。
准备步骤见 安装指南 · 先看示例，再用自己的短片，卡点见 讨论 #128。
Releases 中，Apple Silicon Mac 选 aarch64.dmg，Windows x64 选 x64-setup.exe。Intel Mac 目前没有桌面安装包，与 Linux 一样使用 Docker 或 CLI。以每次 Release 的实际资产为准，Source code 不是桌面安装包。第一次出片用应用里的「用示例项目看看效果」，示例在安装包内。
macOS 15 及以上首次打开：双击一次，若被拦截则到「系统设置 → 隐私与安全性 → 仍要打开」（Apple 说明）。较旧的 macOS 可右键应用 →「打开」。Windows 若出现 SmartScreen，点「更多信息 → 仍要运行」。日常运行不需要管理员权限。详见 安装指南。
- 完全退出后重新启动一次，保留数据目录。
- 检查磁盘空间，记录界面上的具体错误和发生阶段。
- 桌面后端端口由启动器管理，查看实际启动日志，不要假设一直是 8000。Docker 默认 Web 端口为 3000、API 端口为 8000。
- Web 模式下若开启了浏览器网页翻译，先关闭翻译再刷新。
- Docker 用户执行
docker compose ps和docker compose logs --tail=100 autoclip celery-worker，参见 Docker 指南。
确认提供商、模型名、API Key、Base URL 与区域设置一致，账号拥有该模型权限。Ollama / LM Studio 要先启动服务并加载模型。本地服务默认地址分别是 http://localhost:11434/v1 和 http://localhost:1234/v1。
Docker 中的 localhost 是容器自己。宿主机模型服务的访问方式见 Docker 指南。若出现代理、TLS 或超时错误，检查具体连接目标和网络配置；不要在反馈中粘贴完整 API Key。
自 v1.4.0 起有两条路线。字幕分析仍是默认，旧配置也默认字幕模式。按画面剪辑时，在「设置 → 服务商与模型」选用能看图的模型。确认后，视觉路线识别录屏中的独立事件，生成可编辑高光与推广草稿，再在共用编辑器里修改。未确认的导入可恢复；确认后才正式理解和剪辑。
单一样本不代表所有游戏质量。输出仍需人工检查边界、裁切和文案，不承诺广告投放效果。v1.4.0 不含 CTA 动效、生成式品牌尾卡、卡拉 OK / 逐词字幕。
剪辑与渲染在本机完成。字幕路线发送相关字幕或文案。使用云端视觉模型会发送抽样画面及必要文字。费用取决于所选服务商，没有统一标价。本地 Ollama / LM Studio 不经过云端计费，但仍需要你自己的模型和硬件。未确认导入不会开始正式理解和剪辑。
首页的本地上传入口支持可选 .srt。没有可用字幕、本地 Whisper 装不上或太慢时，可以改用百炼云端转写（qwen-audio-3.1-asr-flash，大约 0.1 元/小时音频，具体以阿里云账单为准）。音频会上传到云端。
打开「设置 → 默认模型 → 语音转字幕」，选择这个云端模型。导入被拦住时，点「改用云端转写」。
百炼 API Key 分两步：
- 先用作者推荐链接注册或领优惠：https://www.aliyun.com/benefit?userCode=qmyj6jch
- 再到 https://bailian.console.aliyun.com/ 创建 API Key，回到设置里填写。
也可以继续用本机 Whisper。没有字幕的视频，第一次要下载本地转写组件（约 220 MB，国内网络约 15 分钟）。不想等可以改用云端转写。CLI 环境可安装 faster-whisper。其他字幕格式建议先转换为带正确时间轴的 SRT，不假设上传入口支持所有格式。
在「设置 → 默认模型 → 语音转字幕」安装本机 Whisper 时，若 Windows 或其他非 Mac 仍出现红色错误「mlx-whisper 仅支持 Apple Silicon (macOS)」，请更新到 v1.3.3 或更新（含 #145）。桌面版用「设置 → 应用 → 检查更新」，或到 Releases 下载。旧版会误报并拦住安装；更新后再安装即可。见 #141。
先看项目错误提示，再按失败阶段排查：
| 阶段 | 优先检查 |
|---|---|
| 字幕 / SUBTITLE | 字幕是否为空、时间轴是否与视频对应、Whisper 是否就绪 |
| 分析 / ANALYZE | 模型连接是否成功、返回是否可解析、字幕是否有足够内容。时间线为空时，仍需检查字幕内容和模型返回；自 v1.3.5 起，这种情况不再只提示去改模型设置 |
| 评分 | 是否有候选片段、阈值是否过高；可尝试从 0.7 降到 0.5 后重新处理 |
| 导出 / EXPORT | FFmpeg 是否可用、磁盘是否充足、输出目录是否可写 |
CLI 可先检查环境，再用较低阈值验证：
autoclip doctor --provider ollama
autoclip run talk.mp4 --provider ollama --srt talk.srt --min-score 0.5 --json把示例文件名和模型选项换成实际配置；没有 SRT 时去掉 --srt talk.srt 并确保转写已就绪。降低阈值只影响筛选，不保证一定有片段。第一次验证用首页的「用示例项目看看效果」，或用自己的短片。用法上仍不清楚时，到 第一次出片问答 讨论。能复现的故障仍开 Issue。
先区分视频下载、转写、模型分析和 FFmpeg 导出哪个阶段慢。用短视频验证；关闭不必要的并发任务，尝试更小的本地模型，并检查可用内存与磁盘。转写模型首次下载可能耗时较长；重试前确认旧任务是否仍在运行。处理时间随硬件、时长、模型和导出设置变化，没有统一的“每小时视频几分钟”承诺。
先确认链接可在浏览器打开、当前账号有权访问，必要时配置该平台的登录凭据。CLI / 源码环境可检查 yt-dlp 版本，桌面用户先检查新版本。也可以使用有权获取的本地文件继续处理。不要在 Issue 或邮件中发送 Cookies。
切片是根据时间范围从原视频生成的片段；发布导出会按预设进一步渲染，例如竖屏布局、烧录字幕和标题卡。生成切片后仍需执行导出，并播放检查结果。
autoclip export PROJECT_ID --preset shortsPROJECT_ID 替换为真实项目 ID。其他预设包括 douyin、xiaohongshu、bilibili 和 original，详见 CLI / MCP 指南。
自 v1.3.2 起可用。
切片就绪后，在切片上打开发布。海外和 B 站在同一页：
- 海外平台走你自己的 Upload-Post 账号，以及你在那里连接的平台。范围是 TikTok、Instagram、YouTube、Facebook、LinkedIn、X、Threads、Pinterest、Bluesky、Discord、Telegram、Google Business，以该账号实际连接的为准。
- B 站在设置里粘贴一次 Cookie。Cookie 须包含
SESSDATA、bili_jct、DedeUserID。一个 B 站账号。
可以现在发，也可以定时。B 站的定时须晚于现在两小时。标题和描述可以不填，默认用切片标题。字幕烧录默认打开。片头约 4 秒的标题卡默认打开。可见范围在平台支持时默认「仅自己」。AutoClip 对外只对 TikTok、YouTube、B 站承诺仅自己 / private。也可以只下载成片、不发布。
项目页可以查看发布记录和月历，并取消尚未发出的排期。「排这一周」只排海外平台，把还没发的切片填进周一、周三、周五的 09:00，不包含 B 站。
画幅跟着要发的账号：有竖屏账号时渲成 9:16，不按 60 秒截断。只发 B 站时用横屏。只有 LinkedIn、X 这类横屏账号时用原画。竖屏和 B 站放在同一次时，各自单独渲染。
发布时可自动生成封面，避免 B 站空封面被拒。默认封面和标题卡的细节随本版安装包说明。自 v1.3.2 起可用。
桌面默认目录见 安装指南。Docker 使用仓库下的 data/、logs/、uploads/ 绑定目录。退出应用或停止服务后，备份数据库、项目文件与配置，避免运行中只复制 SQLite 主文件。不要依赖未经确认的自动备份，也不要为了排错删除原始数据。
桌面端和 Docker 的项目状态、类型存在 SQLite 的文本列里。服务按枚举名字读取（PENDING、KNOWLEDGE）。库里若还有当前版本对不上的值，整页列表会加载失败。已知的一类旧值是已经从代码移除的 cancelled / CANCELLED；写成小写 value（pending）时也会对不上。
自 v1.3.3 起，服务启动时自动改写这两个字段。项目记录保留：
- 能对上的 value 改成枚举名，例如
pending→PENDING - 无法识别的状态（含
cancelled）改为FAILED - 无法识别的项目类型改为
DEFAULT
升级后重新打开应用，项目列表应能打开。被改写的项目会显示为失败或默认类型。升级前若要自己看一眼：
SELECT status, COUNT(*) FROM projects GROUP BY status;
SELECT project_type, COUNT(*) FROM projects GROUP BY project_type;先查 已知问题 和 版本记录。希望增加的能力、用法和模型发到 Discussions：欢迎与分类、第一次出片问答、想法。能复现的故障开 Issue。规则见 社区看板。仍需联系时，将以下信息一次性发到 christine_zhouye@163.com：
- 系统和 CPU 架构、AutoClip 版本、桌面 / Docker / CLI 使用方式。
- 模型提供商、模型名、视频来源与大致时长、是否提供字幕。
- 复现步骤、失败阶段、错误截图或最近的相关日志。
- 日志中移除 API Key、Cookies、私人路径和不希望公开的字幕内容。
个人业余维护，回复时间不固定，不提供即时客服或一对一部署服务。