Guide
使用说明
界面左右两个侧栏、中间一个播放器、底部一条时间轴。下面按实际操作的先后顺序走一遍，第一次用照着做即可。
00
先登录织影云账号
顶栏最右侧是账号胶囊。语义筛选、智能选段、标题生成与文生图都由云端代跑，按实际 token 消耗扣积分；本地转写、剪辑、导出不扣积分。
- 没有账号就在弹窗里切到「注册」，填邮箱、密码与确认密码，收到 6 位验证码填回来即激活，并赠送体验积分；两个密码框右侧的小眼睛可以切明文核对。
- 充值使用兑换码：在账号弹窗里粘贴卡密点「兑换」立刻到账，下方可以看到积分流水（充值、预扣、结算、退还逐条记录）。
- 余额显示在胶囊上，形如「邮箱 · N 积分」，每两分钟自动对一次，不需要手动刷新。
- 连不上云端时界面会标注离线，本地功能照常可用，只是 AI 类操作会提示先恢复连接。本地调试时可以在弹窗里改「服务器地址」并测试连通性。
01
新建项目，选定画面比例
首次启动显示项目选择页。填项目名，选视频比例，新建项目。比例决定成片画面。
- 默认 9:16 竖屏，另有 3:4 / 1:1 / 4:3 / 16:9，也可以填自定义宽高。
- 素材比例与项目比例不一致时，以画面中心为基准裁掉两侧多余部分，不拉伸、不加黑边。
- 预览区就按该比例显示，所见即导出；建好之后还能在顶栏的「比例」处随时改。
02
导入直播录像，拖进工作区排序
在左栏「素材」页点「+ 素材」选择直播录像，可以一次多选。素材会逐个上传，期间弹出导入进度条。
- 进度条显示当前是第几个、已传输百分比与文件大小；传完写盘阶段进度条转为滚动形态。
- 每传完一个就立刻出现在素材库里；中途失败的文件会单独提示，不影响其余文件。
- 把素材拖到下方工作区形成顺序，也可以点击素材直接加入。工作区条目支持内部重排，右上角有移除按钮。
- 工作区每张卡片显示该素材按项目比例裁切的封面帧，点击卡片可在播放器里整段预览该视频。
03
填关键词与产品类型，开始分析
顶栏有两个输入框：关键词与产品类型。填好之后点「开始分析」。
- 任务启动前先校验登录状态与积分余额。不通过就直接弹登录或充值提示，本地转写也不会白跑。
- 第一步是本机语音识别，进度里会标明模型来自本地还是在线；识别结果缓存在项目里，重复分析不重跑。
- 第二步是云端语义筛选，按产品类型与关键词保留卖点句、剔除闲聊与引导关注。进度里先报本次预计消耗，跑完报实际消耗。
- 分析完成后自动切到下方「时间轴」页，按段落展示帧画面。
任务可以中途取消。分析、智能选段、导出的进度遮罩右下角都有「取消」。
导出取消后不会在目标目录留下半个 mp4，临时分片也会清掉；分析取消时，已经识别完的视频会保留在缓存里，下次分析不用重跑。
注意本地语音识别一旦开始推理就无法中断，取消分析会等当前这个视频识别完才生效。
04
在保留列表里微调
中间偏右是「保留句子」列表，再往右是「已剔除句子」。所有调整都在这两个列表里做。
- 剔除：保留列表每一行的叉号，句子移入已剔除列表。
- 恢复：已剔除列表的回箭头，句子按原始序号插回正确位置，不会打乱你后来排好的顺序。
- 重排：拖动行首的手柄调整先后顺序，松手即生效。
- 智能选段：让模型按语义自动把连续句子分成段落。
- 标记段落：进入标记模式后在列表上拉框，套住两个以上连续句子松手即成段。
- 段落有彩色外框，可以整体拖动，也可以点「解散」或右键取消归段。
- 点击任意句子，播放器立刻定位到该句并预览。
05
用时间轴检查成片结构
底部「时间轴」把句子列表的结构摊开：一个块就是一个段落，没有归段的句子各自占一块。
- 块宽按时长比例分配，块内嵌该段的帧画面缩略图。
- 左右拖动块可以调整成片顺序，与右侧句子列表双向同步。
- 块右上角可以「解散」段落，点击块则从该段开始播放。
06
贴纸
左栏切到「贴纸」页。贴纸是全局共用的，一次导入，所有项目都能用。
- 支持 PNG / JPG / WebP / GIF / APNG，以及 WebM / MOV / MP4 视频贴纸，会动的左上角标「动」；单个上限 60MB，最多同屏 12 张。
- 把贴纸卡片拖到预览画面上即可投放，落点就是贴上去的位置；点卡片则投到默认位置。
- 画面上的贴纸可以直接拖动、拖四角手柄等比缩放、拖顶部手柄旋转，按住 Shift 按 15 度吸附；右上角叉号或 Delete 键删除。
- 贴纸是全程显示的：导出时对每个片段都做一次叠加，所见即所得。
- 视频贴纸若因编码问题在预览里放不出来，后端会自动转一份可播的预览副本并缓存；导出始终使用原文件，画质与透明通道不受影响。
07
封面
顶栏「封面」按钮，或素材库里每张卡片右侧的「封」按钮都能打开封面编辑器。
- 底图：预览画面下方那条滑轨上拖竖线挑项目内任意一帧；滑轨上按左右方向键微调 0.5 秒，按住 Shift 步进 5 秒，也可以点「取播放器当前画面」。也可以改用封面库里的任意一张或纯色背景。
- 文字：字体、字号、颜色、描边颜色与粗细都能调；文字对象同样可拖动、缩放、旋转，缩放即改字号。
- 贴纸：直接从贴纸库点选贴上去，同样可拖拽缩放旋转。
- 尺寸：跟随项目比例，或 9:16 / 3:4 / 1:1 / 16:9；切换尺寸时画面元素按比例搬动。
- AI 文字效果图：填一句提示词由云端按积分生成，结果会同时收进贴纸库并自动贴到封面上。
- 「保存到封面库」会把编辑结果合成成 PNG 存进全局封面库，下次任何项目都能直接选用，同时设为当前项目的导出封面。封面库支持下载到本地与删除。
08
导出成片
点顶栏「导出」，先弹「导出成片」确认保存位置，再按当前顺序切片拼接。
- 默认目录是项目内的 export 目录，可以点「选择位置…」调系统目录选择框另选目录、改文件名；另选的目录会记在项目里，下次导出默认用它。
- 处理流程：按当前顺序切片，统一到项目比例（短边 1080，比例不符的素材居中裁切）与帧率，叠加贴纸，烧录字幕，最后无损拼接。
- 弹窗里可以挑一个导出封面：不配、项目当前封面、封面库里的任意一张，也可以点「做封面…」现做一张。选了封面会在成片旁边多出一个同名图片文件。
- 同一个弹窗里还有「封面做片头」，默认勾选，会在成片最前面加一段封面静止画面，时长可填 0.4 到 10 秒，成片第一帧就是封面；不想要就取消勾选。
- 完成后弹窗显示成片路径，可以复制路径或在系统文件管理器里定位文件。目标重名时自动加后缀，不会覆盖已有成片。
FAQ
常见问题
按使用过程中最容易卡住的环节整理。
窗口一直显示「后端启动中…」
说明本地服务没能起来。可以手动运行后端脚本查看报错，确认后端端口（默认 8756）没有被别的程序占用。macOS 上需要注意让程序指向正确的 Python 解释器。
点「开始分析」提示请先登录
点顶栏右侧的账号胶囊登录即可。如果连不上，检查账号弹窗里「服务器地址」填得对不对，可以点「测试」验证连通性。
注册后收不到验证码
先看垃圾邮件；弹窗里可以点「重新发送」，有 60 秒冷却。本地自测环境下云端若没配邮件服务，验证码会直接显示在账号弹窗的提示里；正式环境不会回显。
登录提示「该邮箱还没验证」
注册只完成了一半，弹窗会自动回到验证码步骤，补上验证码即可。想换邮箱就点「换个邮箱重新注册」。
提示「登录已过期，请重新登录」
这是登录凭证过期或被吊销，重新登录即可。密码输错只会提示「邮箱或密码不正确」，两句话不会串。
分析报「积分不足」
在账号弹窗里粘贴兑换码充值，或联系发卡方。余额不够时任务不会启动，本地转写也不会白跑。
首次加载模型慢，想确认是不是离线
看进度文案里模型的来源标注：都显示本地即为离线运行；若显示在线，说明本机没找到对应模型目录，会联网下载，第一次会明显变慢。
识别速度很慢
可以在配置里把推理设备指定为 GPU，或减少一次放进工作区的视频数量，分批处理。已经识别过的视频会命中缓存，不会重复耗时。
某一批筛选失败怎么办
任务结束后会以警告提示。该批句子默认全部保留，可以手动剔除；重新分析时已识别过的视频不用重跑。
导出没看到封面文件
导出弹窗里的「封面」需要选一张，不配封面就不产出图片。产物与成片同目录同名，形如「成片名_封面.png」。
视频贴纸拖上去只有调整框，看不到画面
这类素材多是浏览器内核解不开的编码（如 QuickTime Animation、ProRes）。后端会在第一次用到时自动转一份能播的预览副本并缓存，转好前先显示一帧缩略图，所以第一次会稍慢。导出始终用原文件，画质与透明通道不受影响。
视频贴纸看上去是整块黑底
说明这台机器没能编出带透明通道的预览副本，退回了黑底版本。这种情况需要检查预览区贴纸层的混合模式是否生效——贴纸层上一旦叠加了层级或滤镜类样式，就无法与下层画面混合。
成片开头多了一秒静止画面
这是「封面做片头」的效果。导出弹窗里取消勾选即可，时长也能在 0.4 到 10 秒之间调整；不选封面时不会生成片头。
贴纸位置和预览不一致
项目里存的是归一化坐标（中心点位置与宽度按画面比例、角度为旋转角），预览叠加层与导出用的是同一套口径，正常情况下所见即所得。中途改过项目比例会改变画面范围，贴纸会按新画面重新计算，导出前扫一眼预览确认即可。
- 当前版本
- v0.1.0
- 系统
- macOS 11 及以上
- 架构
- Apple 芯片 arm64
- 安装包
- 445 MB