台词向剪切素材-聚颜素材工作台 · 用户使用说明

时隔快6年了，当时还是自己手动通过软件剪切素材，在这6年间也陆陆续续分享过与剪切视频素材相关的软件，直到今天咱们这歀软件的出现，彻彻底底改变了台词向素材剪切的难题，虽然我知道现在做台词向剪辑视频的人很少，软件受众很小，但是既然做了，后面有时间还会继续完善，最重要的一点是软件免费！

其实现今软件算是一个半成品，目前已经完成台词搜索、画面场景搜索、批量提交剪切这三个功能。

未来计划完成功能：

1、微调AI模型，使其从现有台词数据库中根据用户提示词，组合有逻辑连贯的台词文段。

2、能够实现剪切并自动拼接为一个完整视频或者直接导出到剪映草稿。

3、其他功能有赖大家提供思路，欢迎群里交流

一个面向短视频创作者的本地化素材工作台：集「台词检索 + AI 台词生成 + 批量混剪 + 帧画面搜索」于一体，双击即用，数据本地保存。

视频演示如下：

目录

• 一、这是什么

• 二、安装与启动

• 三、账号与登录

• 四、功能模块详解

  • 4.1 台词搜索

  • 4.2 AI 台词生成

  • 4.3 帧画面搜索

  • 4.4 批量混剪

  • 4.5 任务中心

  • 4.6 积分与充值

• 五、常见问题 FAQ

• 六、故障排查

一、这是什么

聚颜素材工作台 是一款专为混剪作者打造的本地工作台，主要能力包括：

特点

• ✅ 绿色免安装：自带 Node 运行时，双击 start.bat 即可用

• ✅ 数据本地：账号、积分、配置全部保存在本机，不上传云端

• ✅ 亮暗双主题：生成参数区域已针对浅色主题优化可读性

• ✅ 自带 AI 接口：支持硅基流动 / OpenAI / Kimi 等 OpenAI 兼容接口

二、安装与启动

2.1 系统要求

• 操作系统：Windows 10 / 11（64 位）

• 磁盘空间：至少 500 MB 可用空间

• 网络：需能访问平台接口与你所配置的 AI 接口

• 浏览器：Chrome、Edge 等现代浏览器（启动后会自动打开）

2.2 启动步骤

1. 解压收到的 dist-release 压缩包到任意非中文路径目录（建议，防止个别依赖对中文路径敏感）

2. 双击 start.bat

3. 首次启动时会看到控制台窗口输出：

   JuYan App is running on http://localhost:3000

4. 浏览器会自动打开 http://localhost:3000；若未自动打开，请手动在浏览器输入该地址

⚠️ 控制台黑窗口请勿关闭，关闭即代表服务停止。使用完成后想退出，直接关闭该黑窗口即可。

2.3 端口说明

默认端口为 3000。如被其他程序占用：

• 方法 A：关闭占用 3000 端口的程序

• 方法 B：联系支持人员协助修改端口

三、账号与登录

3.1 账号类型

3.2 首次登录流程

1. 进入登录页

2. 选择「注册」或「游客体验」

3. 登录成功后自动进入首页工作台

💡 首次启动，系统会自动创建一个 admin 管理员账号与初始数据文件，无需手动建库。

四、功能模块详解

4.1 台词搜索

用途：从平台收录的台词库中检索匹配句子，用于混剪选段或二次创作灵感。

操作

1. 进入左侧菜单 → 台词搜索

2. 输入关键词（支持中文/英文）

3. 可选筛选条件：

   • 语言：中文 / 英文 / 日文等

   • 题材：爱情 / 悬疑 / 古装 等

4. 点击”搜索”查看结果

5. 点击单条结果可查看上下文字幕与视频定位

4.2 AI 台词生成

用途：基于台词类型和主题词，让 AI 输出一份可直接用于混剪口播的台词脚本（每行一句）。

步骤 1：配置 AI 接口（首次使用）

1. 进入 AI 台词生成 页

2. 在顶部「模型配置」区域选择接口预设：

   • 硅基流动（推荐，国内稳定）

   • OpenAI 官方

   • Kimi

   • 自定义 OpenAI 兼容接口

3. 填入你的 API Key

4. 点击「测试连接」确认可用

5. 点击「保存配置」——密钥会在本地加密保存，账户级持久化，下次打开自动回填。

步骤 2：填写生成参数

步骤 3：两步生成流程

1. 点击「检索平台台词」——系统先从平台台词库召回参考句

2. 检索完成后点击「基于检索结果生成台词」——AI 会基于召回结果输出脚本

3. 在下方「结果校验」区审阅，可对单行删除、调序、替换（仅能从原句池补选，不可自由改字）

4. 点击「复制结果」或「导出」供后续混剪使用

💡 「默认提示词预览」可展开查看当前台词类型对应的固定提示词；点击「复制默认提示词」可作为自定义提示词的起点。

4.3 帧画面搜索

用途：用关键词精确定位视频中某一帧/片段的出现位置，配合混剪使用。

操作

1. 进入 帧画面搜索

2. 输入视觉关键词（如”拥抱”、”下雨”、”夕阳”）

3. 选择范围筛选（可选）

4. 系统返回包含时间戳的命中列表

5. 点击命中项可预览截图或跳转到混剪模块

4.4 批量混剪

用途：基于一批字幕行（可来自 AI 生成或自行粘贴），自动拉取对应素材并完成裁剪烧字幕。

操作

1. 进入 批量混剪

2. 粘贴/导入台词（每行一句）

3. 设置输出参数：

   • 是否烧录字幕

   • 字幕样式

   • 输出分辨率

4. 点击「开始混剪」——任务提交后进入「任务中心」跟踪

5. 该功能按任务消耗积分，提交前会显示预计消耗

⚠️ 批量混剪为异步任务，请勿关闭程序；关闭会中断正在运行的任务。

4.5 任务中心

用途：统一查看所有混剪任务的进度与产物。

可操作项

• 查看任务状态：排队中 / 处理中 / 已完成 / 失败

• 下载成品视频

• 下载带字幕版本

• 下载字幕文件（VTT）

• 失败任务查看原因 / 重试

4.6 积分与充值

三种获取积分的方式

积分变动查询

• 进入「充值」页可查看：

  • 积分流水（所有变动明细）

  • 充值订单历史

  • 卡密兑换历史

五、常见问题 FAQ

Q1：启动后浏览器没有自动打开？

手动访问 http://localhost:3000 即可。若浏览器打不开，请先检查控制台是否有 running on http://localhost:3000 提示。

Q2：AI 测试连接总是失败？

依次检查：

1. API Key 是否正确（不要带多余空格）

2. 所选接口地址（Base URL）是否能联网访问

3. 所选模型名称（如 Qwen/Qwen2.5-7B-Instruct）是否在你的账户可用额度内

4. 本机是否开启了会拦截出站请求的防火墙/代理

Q3：卡密兑换提示”已被使用”或”已过期”？

• 每张卡密仅能被一个账户兑换一次

• 卡密有有效期，过期后无法使用

• 请联系卡密提供方更换

Q4：批量混剪积分不够怎么办？

• 通过卡密兑换补充积分

• 提交充值订单等待审核

• 联系管理员调整积分

Q5：我想换一台电脑继续用，怎么迁移数据？

复制整个 dist-release 文件夹到新电脑即可，所有账号/积分/配置都在 api/data/store.json 里。建议迁移前关闭程序，防止文件占用。

Q6：我之前保存过 API Key，现在想删除？

在「AI 台词生成」页面的「模型配置」区重新保存，可在保存时勾选「清除已有密钥」；或直接在界面里把 Key 清空后再保存。

六、故障排查

问题：双击 start.bat 没有反应 / 一闪而过

检查步骤

1. 右键 start.bat → “以管理员身份运行”

2. 确认 node/node.exe 文件存在

3. 打开 PowerShell 进入 dist-release 目录，手动执行：

   .\node\node.exe .\api\launcher.js

   查看具体错误信息

问题：端口 3000 已被占用

查看占用进程

netstat -ano | findstr :3000
taskkill /PID <上一步显示的 PID> /F

问题：页面空白 / 样式错乱

1. 按 Ctrl + F5 强制刷新浏览器（清缓存）

2. 确认 client/assets/ 目录下存在 index-xxxx.js 和 index-xxxx.css

3. 换一个浏览器试试

问题：提交的混剪任务长时间卡在”处理中”

1. 查看控制台黑窗口是否有报错

2. 确认网络能访问素材平台

3. 重启程序（关闭黑窗口再双击 start.bat）——任务数据会保留

使用建议

每次使用前简单操作：

1. 双击 start.bat 启动

2. 浏览器访问 http://localhost:3000

3. 使用完成后关闭控制台黑窗口

祝创作愉快！ 🎬