使用说明

从直播录像到可发布的剪映草稿，一条龙自动完成：字幕识别 → AI 选片 → 画面优化 → 生成剪映草稿 + 发布文案。 本手册按"从零到出片"的顺序编写，照着一步步做即可完成配置并跑通第一个任务。

目录

1. 认识软件
2. 安装与激活
3. 配置前的准备清单
4. 配置第 1 步：AI 大模型（LLM）
5. 配置第 2 步：火山引擎字幕识别
6. 配置第 3 步：TOS 对象存储
7. 配置第 4 步：商品锚点识别
8. 配置第 5 步：导出目录与剪映
9. 配置第 6 步：分句规则与风控词（可选）
10. 验收：诊断页全绿
11. 开始使用：跑通第一个草稿任务
12. 任务中心：看懂 11 个步骤
13. 拿到成果：剪映草稿 + 发布文案
14. 进阶：切片工作台
15. 进阶：模板管理
16. 进阶：资产中心
17. 进阶：素材拉取（抖老板）
18. 进阶：直播录制
19. 进阶：Claude Code Skill 模式（年卡/永久）
20. 常见问题 FAQ
21. 附录：常用地址速查

1. 认识软件

打开软件后看到的首页（工作台）：

• 左侧导航：首页 / 新建草稿 / 切片工作台 / 任务中心 / 直播录制 / 模板管理 / 设置。
• 右上角两个胶囊：授权状态、系统配置——点击可直达激活对话框和设置页。
• 日常使用 90% 的操作只在两个页面：新建草稿（发起任务）和任务中心（看进度、拿结果）。

软件的核心流程：

选视频(可多段) → 火山识别字幕 → 极限词处理 → AI 分句 → 商品识别(可选)
→ AI 分析选片 → 方案评分筛选 → 画面优化 → 生成剪映草稿 → 打开剪映微调 → 发布

2. 安装与激活

2.1 安装

1. 下载安装包 video-clipper-pro-setup-x.x.x.exe（约 320MB）。
2. 双击安装，一路"下一步"即可；安装完成后桌面会出现 Video Clipper Pro 图标。
3. 如果软件正在运行时收到更新提示，点"立即更新"会自动下载并安装新版本。

2.2 试用与激活

• 未激活可免费试用 3 个任务（任务成功完成才计 1 次，失败/重跑不重复扣）。首页授权胶囊会显示"试用中（剩 N 次）"。
• 试用用完后，点击首页右上角的授权状态胶囊打开激活对话框：

1. 把购买时获得的激活码粘贴进输入框；
2. 点击激活，提示成功后授权状态变为"正常"。

2.3 套餐额度

• 每月额度自然月 1 日自动重置；首页授权卡片会显示"本月任务 X/Y"。
• 一个任务 = 一次完整的草稿生成（不论方案数量）；只有成功完成的任务才扣额度。

3. 配置前的准备清单

正式使用前需要准备以下账号/凭据。建议先照单收集齐，再回软件里逐项填写：

4. 配置第 1 步：AI 大模型（LLM）

软件支持 OpenAI 兼容协议与 Claude 原生协议，任何提供这两类接口的服务都能用。下面以推荐的 FoxCode 中转站为例，从注册到拿到三样东西（Base URL、API Key、模型名）手把手走一遍；已有其他服务商 API 的可以直接跳到 4.6 在软件里填写。

4.1 注册账号

打开注册地址 https://foxcode.rjj.cc/auth/register?aff=XBQ0，填用户名、邮箱、密码创建账户（也可以用 Linux.do 第三方登录）：

4.2 购买额度

打开购买地址 https://fk.hshwk.org/，选择一档额度商品（首次建议先买 1 亿额度试用）：

进入商品页后：填写你的邮箱（用于接收兑换码）→ 选择购买数量 → 点击支付宝支付通道付款，付款后自动发货兑换码：

4.3 兑换额度

打开兑换地址 https://foxcode.rjj.cc/redeem，把上一步收到的兑换码粘贴进输入框，点立即兑换：

兑换成功后，回到仪表板可以看到剩余配额（额度按量扣减，用完再买再兑换即可）。

4.4 创建 API Key

打开 API Key 管理页 https://foxcode.rjj.cc/api-keys：

1. 点右上角「创建新密钥」；
2. 密钥名称随便起一个（如 video-clipper）；
3. 点「创建密钥」，复制并保存生成的 Key（sk- 开头）。

4.5 获取 Base URL

进入模型广场，可以看到多条渠道（不同折扣线路）；选一条支持 claude 系列模型的渠道（如 Ultra 特价 CC），点它右侧的「查看教程」：

教程页顶部「当前渠道」后面显示的就是这条渠道的 Base URL，复制保存：

如果教程页给的地址连不通，可以使用备用 Base URL：https://dm-fox.rjj.cc/claude/ultra

4.6 在软件里填写

打开 设置 → LLM 策略，这里是一个配置列表（可以保存多套配置随时切换）。点击「+ 新建配置」或某条配置的「编辑」进入表单：

先选服务商与协议（以 FoxCode 为例）：

1. 配置名称：随便取一个名字；
2. 服务商：选「自定义 / 其他」；
3. 协议：选「Claude 原生 /messages」（FoxCode 的 claude 渠道用原生协议；若你用的是 OpenAI 系服务商则选「OpenAI 兼容 /chat/completions」）。

再往下填连接凭证：

按截图标注顺序：填完 ①②③ 后点 ④「测试 LLM」验证连通，再点 ⑤「保存预设」，最后右下角 ⑥「保存并应用」。

模型选择建议：选片分析需要较强的长文本理解能力，推荐 claude/gpt/deepseek 系列的旗舰或次旗舰模型。 其他服务商（OpenAI / DeepSeek / 通义等官方 API 或其他中转站）同样支持：在对应开放平台创建 Key，Base URL 一般以 /v1 结尾，协议选「OpenAI 兼容」。

5. 配置第 2 步：火山引擎字幕识别

5.1 开通服务并获取凭据

1. 打开 火山引擎官网，注册/登录账号（需要实名认证）：

1. 进入语音技术控制台的「录音文件识别大模型」页面：https://console.volcengine.com/speech/service/10012（也可在控制台顶部搜索"语音技术"，左侧选 语音识别大模型 → 录音文件识别大模型）；
2. 如果还没有应用，先在 应用管理 → 创建应用：应用名随意填（如"切片工具"），勾选大模型录音文件识别能力；
3. 在页面下方「服务接口认证信息」区域，逐一复制保存三个值：
4. APP ID（一串数字）
5. Access Token / Access Key
6. Secret Key

1. 确认"录音文件识别大模型"服务已开通付费或购买了时长包（新账号一般有免费额度，用完需在控制台开通后付费）。

5.2 在软件里填写

打开 设置 → 字幕识别：

1. 勾选「启用火山识别」；
2. 识别类型保持默认（File 文件识别）；
3. 把上一步拿到的 App ID / Access Key / Secret Key 分别粘贴进去；
4. 点击「检查配置」做连接测试。

6. 配置第 3 步：TOS 对象存储

字幕识别与商品识别需要把音视频临时上传到你自己的 TOS 存储桶（识别完自动清理），这是必须配置的一步。

6.1 开通并创建桶

1. 打开 TOS 桶列表：https://console.volcengine.com/tos/bucket?projectName=default（首次进入会引导开通对象存储服务），点击「创建桶」：

1. 创建存储桶：桶名随意（全小写，如 my-clipper），区域选择华北 2（北京）（cn-beijing），权限保持私有即可。

6.2 获取账号级 AK/SK

1. 打开密钥管理页：https://console.volcengine.com/iam/keymanage（或点控制台右上角头像 → API 访问密钥），点击右侧「创建 Access Key」：

1. 弹出安全风险提示，点「继续」（个人使用直接用主账号密钥即可）：

1. 创建成功后点「下载凭证」保存好，凭证里就是 Access Key ID 和 Secret Access Key（Secret 只在创建时能看到/下载，务必保存）：

注意：这一对 AK/SK 是火山引擎账号级密钥，与第 5 节语音应用的 Key 不是同一套。

6.3 在软件里填写

同样在 设置 → 字幕识别 页向下滚动到「TOS 临时存储」：

填完点「检查配置」验证。

7. 配置第 4 步：商品锚点识别

解决什么问题：直播里主播经常穿着 A 品讲 B 品（上衣是目标品、裤子是别的品）。开启后软件用火山方舟视频大模型看画面+听讲解，自动剔除"他品专属讲解"、替换"非本品画面"，保证成片只讲目标商品。

7.1 开通视觉大模型

打开火山方舟开通管理页：https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=model（也可在方舟控制台左侧菜单点开通管理），在语言模型列表里找到 Doubao-Seed-2.0-lite（视频理解模型，按 token 计费，一条 15 分钟录像约几毛钱），点右侧「开通服务」：

7.2 创建 Ark API Key

打开方舟 API Key 管理页：https://ark.volcengine.com/region:cn-beijing/apiKey?apikey=%7B%7D，点击「创建 API Key」：

弹窗里保持默认项目与权限，点「创建」，然后复制保存生成的 API Key：

7.3 在软件里填写

设置 → 字幕识别 页最底部的「视频大模型识别（商品锚点）」卡片：

1. 勾选「启用视频大模型识别（商品锚点）」；
2. 粘贴 Ark API Key；
3. 视频模型留空即用默认 doubao-seed-2-0-lite-260428。

开启后，新建草稿时必须填写商品名称并提供一张商品参考图（判定"什么是本品"的依据；同款不同色也算本品）。

8. 配置第 5 步：导出目录与剪映

8.1 安装剪映专业版

到 剪映官网 capcut.cn 下载剪映专业版（电脑版）并安装，首次打开登录一次（让它生成草稿目录）。

8.2 找到剪映草稿目录

打开剪映专业版，点右上角齿轮图标 → 全局设置，「草稿」标签页里的「草稿位置」就是草稿目录，复制这个路径：

没改过位置的话，默认通常在（把 你的用户名 换成实际用户名）：

C:\Users\你的用户名\AppData\Local\JianyingPro\User Data\Projects\com.lveditor.draft

如果你改过草稿位置（如 F:\jianying\JianyingPro Drafts），以剪映里显示的为准。

8.3 在软件里填写

打开 设置 → 导出与剪映：

9. 配置第 6 步：分句规则与风控词（可选）

这一页的默认值已经调好，新手可以整页跳过；想微调分句效果或极限词处理时再来。

打开 设置 → 分句规则与词库：

• AI 字幕分句：把识别出的长字幕切成"语义完整的超短意群"，是后续 AI 选片的最小单元。启用分句 / 仅处理长字幕 / 自动补齐字幕空隙三个开关建议保持默认开启。
• 分句提示词：控制分句风格的 System / User Prompt，内置规则已按直播口播调好，一般不用改。

向下滚动还有两块：

• 极限词处理（实验）：火山识别时检测《广告法》绝对化用语（"最、超、极致、第一"等），交给 LLM 判定后自动从成片里去掉；极限词表可自行增删，每行一个词。默认关，需要规避违禁词时再开。
• 分析预清洗：AI 分析选片前先用大模型剔除报尺码、催单、流程闲聊等口水字幕，让候选更干净、选片更连贯（每次分析多 1 次 LLM 调用）。默认开。
• 成片内容去重：主播同一个卖点常会反复讲，方案生成后软件自动剔除意思重复的复读句（本地相似度判定，不额外调用大模型），时长不够会让 AI 换别的句子补上。默认开，觉得剔多了可以关。

10. 验收：诊断页全绿

全部填完后，打开 设置 → 关于诊断，逐项检查：

• ✓ 绿色 = 已配置好；
• ✗ 红色 = 缺配置或依赖不完整（按前面章节补齐）；
• ○ 灰色 = 功能未启用（如果你不需要该功能，灰色是正常的）。

必须为绿色的项：AI 大模型、火山字幕识别、TOS、FFmpeg、剪映草稿目录。

11. 开始使用：跑通第一个草稿任务

点击左侧「新建草稿」：

从上到下依次填写：

1. 视频素材：点「选择视频」挑直播录像；支持一次选多个（同一商品的多段素材会自动拼接混剪）。
2. 字幕：两选一——
3. 开启「火山识别同步」（推荐）：字幕留空，任务自动识别；
4. 或点「选择字幕」导入已有 SRT 文件。
5. 草稿名称：可留空；填了商品名时自动按"日期+商品名"命名。
6. 商品锚点（若已开启第 7 节功能，则为必填）：
7. 商品名称：写具体，如"真丝烧花连衣裙"；
8. 商品参考图：一张能看清商品的图（详情页主图即可）。
9. 成片主/副标题（可选）：填了就显示在成片画面上三分之一处；留空时优先用模板值，仍为空则由 AI 从商品名提炼短名做主标题。
10. 模板设置：点选一个已保存模板（时长区间、水印、画中画等跟随模板，详见第 15 节）。
11. 方案数量：AI 生成几个备选成片方案，新手填 1 即可。
12. 完成后（五选一）：
13. 生成剪映草稿：进剪映精修（默认）；
14. 直接导出成片视频：不进剪映，直接出 mp4（带字幕/水印/角标、呼吸变焦与关键词轻推、字幕入场动画）；
15. 最佳进草稿·其余出视频：分值最高的进草稿，其余直接成片；
16. 对标直出：按对标账号的包装效果直接成片——AI 出编排（关键词双色高亮、卖点徽章、贴纸、音效、轻推句），字体/配色/贴纸/音效从「资产中心」抽样且每条自动错开，另有巡游水印与三层去重。需先在资产中心备好资产；编排风格可在「设置 → 导出 → 对标直出」调整；「设置 → 导出 → 成片复核」可让软件把成片再识别一遍核对口播完整性（有识别费用，默认关）；
17. 仅分析不导出：只要方案和文案。
18. 点右下角「立即开始执行」。

任务提交后自动跳转任务中心并开始执行，等待即可（15 分钟素材一般几分钟内跑完，首次因无缓存会稍慢）。

12. 任务中心：看懂 11 个步骤

每个草稿任务分 11 步执行，点任务可看每一步的进度、耗时与说明：

• 任意一步失败：修好配置后点该任务的 ↻ 从某步重跑，前面已完成的步骤结果会复用（识别、商品识别都有缓存，不会重复扣费）。
• 底部日志区可以看到每一步的详细输出与产物文件。

13. 拿到成果：剪映草稿 + 发布文案

任务完成后，在任务详情的产物区：

1. 打开剪映：草稿已出现在剪映专业版首页（名字即方案名/日期+商品名），点开即是切好的成片——包含主画面轨、画面替换轨、字幕轨、主副标题轨、水印等；
2. ⚠️ 建议在剪映里重新识别一遍字幕（字幕 → 智能字幕），让字幕样式和断句更适合发布；
3. 检查满意后直接在剪映里导出成片。
4. 一键复制发布文案：产物区每个方案都带 AI 生成的抖音风格正文（40~80 字）+ 5 个话题标签，点「复制文案」即可整段粘贴到发布框。

14. 进阶：切片工作台

任务跑完后 AI 其实生成了多个候选方案（默认导出得分最高的）。想手动挑选：

1. 任务中心 → 任务详情 → 点「载入工作台」；
2. 工作台里能看到全部候选方案的时间线、文案、得分，勾选心仪的方案；
3. 点「导出方案」→ 选择"剪映草稿"→ 加入队列，即可导出你挑中的方案（画面替换、呼吸缩放等效果与自动导出一致）。

15. 进阶：模板管理

模板 = 一套可复用的成片参数。常用项：

建议为每类商品/账号建一个模板，新建草稿时一键套用。

16. 进阶：资产中心

字体、音效、贴纸、背景音乐统一入库，供后续「对标直出」编排抽样（每条成片自动换字体/花字配色/贴纸/音效组合）。软件只提供入库机制，不分发第三方素材。

三种来源：

音效入库时自动按谱特征打标签（ding / pop / whoosh / hit），≤3 秒归音效、更长归背景音乐；同一文件重复导入会按哈希跳过。 页面下方的「去重素材目录」放一批与商品无关的空镜视频，对标直出时随机抽取做画面去重；留空则跳过该层。

爆款开头库：把你收集的爆款开场话术（视频/音频都行，软件只取声音）批量导入，导入时自动转写出文字、测出语速；出片时开头几秒用这条声音配当前商品的画面，语速自动加减速到和正片一致。表格里可以直接改转写文本（转写不准就手动订正，文本准了 AI 选择和品类匹配才准）、设强制倍速（留 0 为自动对齐）、看每条的使用次数。导入后到「模板管理」或新建草稿页选择使用方式（自动轮换 / AI 智能选择 / 指定某条）。 小提示：优先收集自己直播间的高光开场句，用别人视频里的声音有被平台判搬运的风险。

17. 进阶：素材拉取（抖老板）

用你自己的抖老板账号在软件内登录（凭据只留在本机，不经过我们的服务器），进入「商品素材」列表后，每行「下载素材」旁会多出两样东西：

• 「拉取并导入素材」按钮：一键出片。软件自动切出该商品的讲解片段（前后各扩 3 分钟、合并重叠、单次上限 20 分钟）、下载商品主图，填好「新建草稿」的视频、商品名、商品图和主副标题（HELA AOMI "款名"… → 主品牌/副款名；【品牌】大码 款名 … → 主款名；其他留给 AI 提炼），然后按当前选中的模版直接加入任务中心执行。顶部「拉取后自动开始执行」取消勾选则只填好草稿等你确认。
• 拉哪几场：最新一场必拉；扩边后不足 15 分钟，再从这个商品讲过的历史场次里按「出片评分」从高到低补，凑够 15 分钟就停，硬顶 20 分钟，不限场数。出片评分是每次任务完成后软件按出片结果自动给各场素材打的分（讲解密度、清洗保留率、方案采用率、方案均分），同一场取历史最高；还没评分的场次排在有评分的后面，首讲场优先、再按讲解时长。跨场拼接按时间倒序（新的在前）。
• 素材状态标签：按上面的组合算出的讲解合计时长——无讲解片段 / 太短（<2 分钟，不建议）/ 偏短（<5 分钟）/ 充足；会跨场时写明各场来源，如「最新 08-29 1 分 30 秒 + 08-20(92分) 6 分 + 08-10(首讲) 3 分」。

多个抖老板账号：顶部「添加账号」，每个账号独立登录态，下拉切换。

素材拉取需要内嵌浏览器组件，请下载官网的「含素材拉取」安装包；普通安装包里该页只显示说明。

18. 进阶：直播录制

内置直播录制（无需激活即可使用）：

1. 粘贴直播间链接（支持抖音等 40+ 平台）；
2. 点开始录制，录像保存为 .ts/.flv 文件；
3. 录完的文件可直接作为"新建草稿"的视频素材。

19. 进阶：Claude Code Skill 模式（年卡/永久）

这是什么：把"分句、选片、写方案、发布文案、封面挑帧、特效编排"这些判断交给你自己的 AI Agent（Claude Code），软件只负责机械环节（火山字幕识别、倍速烘焙、画面优化、渲染、剪映草稿）。Agent 在对话里一步步给你看方案、随时能改，还能直出带花字/贴纸/音效/呼吸变焦的"对标风格"成片。

谁能用：年卡与永久版用户（口径与 CLI/MCP 一致）。每完成一个任务按套餐月度额度扣 1 次，同一任务只扣一次。AI Agent 本身的费用（Claude 订阅或 API）由你自己承担，软件不代付。

前提： 1. 软件已安装并激活年卡/永久，火山字幕识别、剪映目录等已配置好（第 5–8 节）； 2. 已安装 Claude Code； 3. （可选，直出特效线需要）本机 NVIDIA 显卡 + 按 skill 包内说明搭建 .venv-asr（faster-whisper / rembg）。

安装：

0.5.0 起 skill 的 export --mode fx 可走软件的「对标直出」渲染（资产来自资产中心），其余模式不变；skill 包需与软件版本一致。

1. 获取 skill 包：不提供公开下载，年卡/永久用户请通过官网联系方式联系我们获取（版本需与软件一致）；
2. 解压到 %USERPROFILE%\.claude\skillsideo-clip\；
3. 编辑 config.json：software_cli 填软件安装目录下的 video-clipper-cli.exe，workspace_root 填你的任务工作区；
4. 编辑 accounts.json：每个主播一条（软件里的模板名、商品名前缀、水印、模特信息卡、封面样式、抖老板账号）；
5. 打开 Claude Code，说一句"帮我切一下 xx 这个品"即可开工。

说明： - 花字/贴纸/音效等素材包不随 skill 分发，按包内 assets/README.md 自行准备（可从本机剪映缓存扫描）； - 命令行直接调用同样可用：video-clipper-cli skill env|config|prepare|visual|export|quota，所有子命令只输出 JSON； - 未激活或月卡用户调用会返回 PLAN_NOT_ALLOWED。

20. 常见问题 FAQ

Q：任务被拦截，提示"试用次数已用完"？ 未激活试用共 3 个任务。点首页授权胶囊输入激活码激活即可不受试用限制（按套餐月度额度计）。

Q：提示"本月任务额度已用完"？ 当月套餐额度用尽，下月 1 日自动重置；需要更多额度可升级套餐（年卡 150/月、永久卡 300/月）。

Q：字幕识别失败 / 一直卡在火山识别？ 按顺序检查：① 设置里火山 App ID/Key 是否填对（点"检查配置"）；② TOS 桶配置是否完整；③ 火山控制台里"录音文件识别大模型"是否开通、额度是否用完。

Q：AI 分析失败，提示接口错误？ 检查 LLM 配置的 Base URL 是否填对（FoxCode 渠道地址连不通时换备用地址 https://dm-fox.rjj.cc/claude/ultra）、Key 是否有效、中转站剩余配额是否充足；点配置行的"测试"按钮定位。

Q：生成的草稿在剪映里找不到？ 设置 → 导出与剪映 → "剪映草稿目录"必须与剪映实际草稿位置一致（剪映 全局设置 → 草稿位置 里可查，见 8.2）。填对后重跑"生成剪映草稿"一步即可。

Q：成片里出现了别的商品的讲解？ 开启"商品锚点识别"（第 7 节），并确保商品名称写具体、参考图清晰。

Q：换电脑了怎么办？ 先在旧电脑联系管理员解绑设备，再在新电脑用原激活码激活（年卡可绑 2 台、永久卡 3 台）。

Q：软件更新？ 启动时自动检查更新（可在"关于诊断"里开关）；有新版会弹窗提示，一键更新。

21. 附录：常用地址速查

AI 大模型（FoxCode 中转站）

火山引擎

其他