帮助中心
本系统只负责「口播文案 → 一键成片」的生产编排，不包含文案创作。视频、声音、数字人模型与素材全部保存在你自己的电脑，云端不接收成片。
一、安装与首次启动
1. 下载与安装
- 从官网下载
JushaCreator-Setup-版本号.exe，双击安装，一路下一步即可。 - 安装程序只放「程序本体」，不含音频/数字人整合包，所以体积只有几十 MB；大模型首次使用时按需下载。
- 安装会自动注册
koubo://协议，网页点「连接」时浏览器会问一次「是否打开 Jusha Creator」，勾选允许。 - 不会写入开机启动。只有你在网页创作时执行器才启动，空闲 10 分钟自动退出。
2. 目录都是自动创建的
首次运行自动在 %LOCALAPPDATA%\JushaCreator\ 下建立：models（模型/整合包，永久保留）、cache（临时帧）、work（半成品）、outputs（成片，用户资产）、logs（排错日志）、updates（更新包）、assets、credentials（设备凭证，Windows DPAPI 加密）。你不需要手动建任何文件夹。
3. 硬件预检不是「判死刑」
最低建议：Windows 10/11 64 位、NVIDIA 独显 ≥6GB 显存、16GB 内存、四核 i5、50GB 可用空间；推荐 8GB 显存 + 32GB 内存 + 100GB SSD。检测不达标会给出提示，但不会阻止你浏览网页或准备环境；实际能否出片以真实运行为准。
二、出第一条片（4 步）
- 先注册账号，再登录：点右上角「登录 / 注册」，切到「注册」标签，用邮箱或手机号获取验证码完成注册；注册之后登录只需账号和密码，不用再收验证码。本系统不提供免注册登录，未注册账号不能登录，登录接口也不会自动建号。可用哪种方式由管理员在后台「登录注册」里配置，页面上只会出现已启用的方式；三档套餐与价格只有注册登录后才看得到。
- 连接本机执行器：点「连接 / 唤起执行器」，浏览器确认后本机执行器启动并绑定设备。一个账号可绑定的设备数由套餐决定。
- 准备本地生产环境：按页面指引下载模型、音频与数字人整合包，写好
production.json。生产整合包没配好时，系统会明确报错，绝不会用演示视频冒充成片。 - 粘贴一条完整口播文案 → 提交：网页显示真实八阶段进度（语音、数字人、粗剪、抠像、配画、去字幕、去重、配字幕）。成片留在你本机
outputs。
任务严格串行：一次只跑一个 GPU 生产进程，加多条也是一条做完自动接下一条，避免爆显存。
三、失败决策与常见报错
任一阶段失败（模型缺失、API 超时、额度不足、解析失败），任务会进入「等待决策」并在网页弹卡片，由你选择重试 / 用原稿继续 / 中止。系统不会静默降级——比如悄悄回退到原文或跳过字幕。
本机未启动
点网页「连接 / 唤起执行器」。若浏览器反复询问，检查是否允许了 koubo:// 协议；也可从开始菜单手动启动一次。
生产整合包尚未准备
说明模型或整合包路径未配置。检查 %LOCALAPPDATA%\JushaCreator\production.json 的 python 与 bundle 路径是否真实存在，详见 logs\worker.log。
额度不足
套餐按「视频条数 + 视频分钟数」双封顶。提交时先预留，完成按实际结算，失败或取消会释放预留。分钟数由云端按文案字数做下限校验，防止异常上报。
下载模型慢或失败
只接受 HTTPS 直链并校验 SHA256；网盘必须提供可直连下载的官方链接，网页分享页不算。支持断点续传，重开即可继续。
四、文件越积越多怎么办
cache中间产物：默认 7 天自动清；work半成品：默认 14 天。- 任务正在跑时跳过清理，避免删掉跑一半的中间文件。
outputs成片默认永不自动删除，可在网页「查看可清理文件」预览，或在执行器本地界面明确设置保留天数后才清。models模型与数字人包不进缓存清理，程序升级也不重复下载。- 清理前会告知可释放空间，卸载程序也不会删除你的模型、成片与设置。
五、更新
网页：云端统一发布，刷新浏览器就是新版，无需操作。执行器：连上云端时自动检查版本，按设备灰度推送。建议更新会在工作台提示，可等当前任务做完再点；强制更新会暂停派单，升级后任务自动恢复。
更新包会依次校验 HTTPS、SHA256、Ed25519 清单签名、Windows Authenticode 代码签名，任一项不通过就明确拒绝并保留旧版本，绝不会安装来路不明的 EXE。
六、账号、密钥与隐私
- 第三方 API 密钥只保存在云端后台「API 设置」，AES-256-GCM 加密，管理员修改需密码二次确认并记审计日志，用户前端看不到任何密钥。
- 设备凭证用 Windows 当前用户 DPAPI 加密，只下发一次；云端只存哈希。
- 本地结果只上传逻辑文件名、大小、时长等元数据，不上传本机绝对路径，也不上传成片。
- 注册方式（邮箱 / 手机）由管理员在后台「登录注册」配置，密钥加密保存、用户端看不到；正式环境由 QQ 邮箱 SMTP 或短信网关发送注册验证码（登录不需要验证码），开发模式写入本地 outbox，网页一律不回显验证码。未配置对应服务时系统会明确报错，不会静默改用另一种方式。
七、仍然解决不了
把 %LOCALAPPDATA%\JushaCreator\logs\worker.log 中报错前后 20 行发给客服。日志里包含真实失败原因（哪个阶段、什么触发），不要只截网页上的一句提示。