智剧通（ZJT）用户使用手册

本文档面向终端用户，介绍智剧通平台的功能和使用方法。
开发者请参考 README.md。

一、平台简介

智剧通是一个 AI 驱动的短剧制作平台，支持从剧本创作到视频生成的全流程自动化。

核心能力

适用场景

• 短剧创作者：从剧本到视频的全流程制作
• 营销团队：快速生成带货视频、广告素材
• 教培机构：分配独立算力，教学短视频创作
• 企业团队：多人协作制作品牌宣传视频

二、快速开始

2.1 启动平台

Windows 用户

1. 双击 点我启动.bat
2. 等待系统托盘图标出现
3. 浏览器自动打开本地服务（localhost）

macOS 用户

1. 双击 start.command
2. 浏览器自动打开本地服务（localhost）

Linux 用户

python3 scripts/running/run_prod.py

访问本地服务（localhost）

2.2 首次访问

1. 打开浏览器访问平台
2. 选择创作模式：短剧模式 或 营销模式
3. 注册账号（首个注册用户自动成为管理员）

三、功能模块

3.1 首页

首页是平台的入口，提供：

• 模式选择：短剧模式 / 营销模式
• 快速入口：视频工作流、剧本创作、营销智能体
• 算力余额：显示当前账户剩余算力
• 站点公告：右上角铃铛展示未读公告角标，点开通知面板查看；打开即标记已读，系统每隔一分钟自动刷新未读数
• 偏好设置：可设置各媒体生成场景的默认模型；当某模型暂不可用（驱动未配置或已停用）时，界面显示警示条并给出推荐替代，但实际仍以已保存值为准，需重新选择并保存后才会真正生效

3.2 剧本创作系统

路径：首页 → 剧本创作

功能说明

• 旁白解说（narration）：世界「故事类型」选择「旁白解说」时，若角色列表中缺少旁白角色，AI 智能体在读取世界 / 角色列表时会自动补建一张「旁白」角色卡（已存在则不覆盖）

创作流程

输入故事概念 → AI 生成剧本大纲 → 人工调整 → 生成完整剧本
     ↓
创建角色设定 → 生成角色参考图
     ↓
设计场景背景 → 生成场景参考图
     ↓
进入制作工坊 → 视频工作流

• 暂存提交：在剧本页进入制作工坊 / 故事板 / 画布时不会自动提交当前暂存；入库只由「提交」按钮或「自动」开关触发

3.3 视频工作流

路径：首页 → 视频工作流

核心概念

• 工作流：一个视频项目，包含多个分镜
• 画布：无限拖拽的编辑区域
• 节点：画布上的功能单元（视频、图片、音频等）
• 分镜：视频的基本单元，包含画面和配音

节点类型

操作指南

创建新工作流

1. 点击"新建工作流"
2. 输入项目名称
3. 进入画布编辑

添加节点

1. 点击画布左上角"+"按钮
2. 菜单按 视频 / 图片 / 音频 / 文本 / 画布 / 素材 分组展示，条目过多时在菜单内滚动
3. 选择节点类型，拖拽到合适位置

生成视频

1. 完成分镜编排
2. 点击"生成"按钮
3. 等待 AI 处理（实时显示进度）

导出视频

1. 生成完成后，点击"导出"
2. 选择导出格式
3. 下载到本地

保存冲突（多人协作）

1. 多个会话 / 浏览器标签页同时编辑同一工作流时，若本地修改与服务端最新版本不一致，保存会提示冲突（HTTP 409），保存按钮显示「⚠ 保存冲突」并弹出对话框
2. 对话框只给二选一（无关闭 / 取消入口）：「使用服务器版本」（加载对方最新内容，丢弃本地未保存修改）或「用本地版本覆盖」（以当前画布强制覆盖服务端，服务端最新更新将丢失）
3. 出现冲突后，自动保存会静默暂停，直到你做出选择；选择前你的本地修改已写入浏览器本地存储，不会丢失

画布操作

滚轮模式切换：进入画布时「快捷键」弹窗自动弹出，内有「滚轮上下平移」/「滚轮缩放画布」两个切换按钮——默认滚轮为上下平移、Ctrl+滚轮为缩放，点「滚轮缩放画布」后两者对调。选择保存在本机浏览器，Shift+滚轮左右平移与触控板捏合缩放不受切换影响。

节点编组与复制粘贴

• 编组：选中多个节点后「编组」（Ctrl+G）合并为一个分组框，拖入 / 拖出分组框会自动加入 / 移出；「解散编组」（Ctrl+Shift+G）还原；分组框支持手动拉伸调整宽高（拖过的框与空分组都保持尺寸）
• 拖放建节点：直接把图片 / 视频文件拖入画布即可创建对应节点；图片节点超限素材会自动压缩
• 反馈入口：工作流意见反馈默认收成问号按钮（点开展开）
• 复制 / 粘贴 / 再制：右键节点可「复制」（Ctrl+C）「粘贴」（Ctrl+V）「再制」（Ctrl+D）
• 不可复制：分镜、分镜组、剧本节点与后端数据绑定，不支持复制
• 黑夜模式：分镜等节点在深色主题下输入框 / 下拉 / 对话条目均自动适配

分镜助手

分镜助手的聊天面板提供多种创作模式（模式切换见面板左上角下拉）：

• 直填生图：不经过智能体润色，直接用该提示词生成首帧图，适合已想好提示词、想省算力的场景（社区版可用）
• 直填生图 / 视频生成反馈：二者为直连生成（不走智能体），提交后不再在聊天区出现气泡，改为 toast 提示（「生图任务已提交，右侧候选区生成中」/「视频生成任务已提交，右侧候选区生成中」），右侧候选区顶部立即插入「生成中」占位卡，成功后替换为真实结果、失败则移除
• 一键转视频 · 字幕：导出成片时是否烧录字幕跟随预览控制条「字幕」勾选（所见即所得）；显示方式（逐句 / 整段）与左右边距（0–18%）取自「字幕设置」（预览齿轮按钮打开，可实时预览，设置随界面保存）

视频生成方式（拆分幕时选择）

拆分幕 / 智能拆分弹窗中可选择视频生成方式：

• 参考生视频：拆完不自动补全首帧，适合已有稳定角色 / 场景参考图、想省算力的批量出片场景；候选区缺失分镜图时显示「参考生视频免分镜图」
• 参考生视频点名首尾帧：参考模式下分镜节点保留首 / 尾帧输入，视频提示词中可按 @（或 /、、）插入 @首帧图 / @尾帧图 或角色；被点名的首帧排参考图第 1 张、尾帧排最后一张，提交时自动改写为「图N」。未设图却点名时提示并中止提交，详见分镜组视频生成

成片对白 · 替换音色（Beta）

在分镜详情「配音 / 对白音频」区，可对已生成的成片对白点击「替换音色」：

• 将当前成片对白换成角色参考音色（口型保留不变）
• 运行中提示「正在抽音并替换角色音色，完成后会自动切到新视频」，完成后自动切换到新视频
• 未生成 / 未选中分镜视频时按钮置灰；对口型分镜无需替换

3.4 工作流列表

路径：首页 → 视频工作流 → 工作流列表

• 查看所有工作流项目
• 创建新工作流
• 编辑/删除工作流
• 查看工作流状态

3.5 营销智能体

路径：首页 → 营销智能体

三种创作模式

使用流程

1. 选择创作模式
2. 输入创作需求描述
3. AI 生成内容
4. 优化调整
5. 导出成果

会话管理

• 新建对话：点击"+ New Chat"
• 搜索对话：使用搜索框
• 重命名：右键对话 → 重命名
• 删除对话：右键对话 → 删除

3.6 管理后台

路径：首页 → 管理后台（需要管理员权限）

功能模块

用户管理

• 查看用户列表：管理后台 → 用户管理
• 调整算力：点击用户 → 调整算力
• 切换角色：点击用户 → 切换角色（普通用户/管理员）
• 禁用/启用：点击用户 → 状态切换

系统配置

• 模型配置：设置默认模型、API 密钥
• 价格设置：配置各模型的算力消耗
• 服务优先级：设置模型调用优先级

四、算力系统

4.1 什么是算力

算力是平台内的虚拟货币，用于消耗 AI 服务：

• 文本生成：消耗较少算力
• 图片生成：消耗中等算力
• 视频生成：消耗较多算力

4.2 查看算力

• 首页顶部显示当前余额
• 管理后台 → 用户管理 → 查看详细记录

4.3 获取算力

• 每日签到：签到获得免费算力
• 管理员调整：管理员可手动调整用户算力
• 充值：首页顶部「算力充值」按钮打开「充值中心」，支持直充（算力包）与月度订阅（微信自动续费、可随时取消），详见《充值中心与月度订阅》
• 渠道邀请：首页顶部点击手机号/邮箱打开「邀请中心」，邀请好友注册可获得算力奖励；商业版可进一步申请开通渠道现金佣金，详见《渠道推广与佣金（商业版）》

4.4 算力预估

• 分镜助手左下角提示行在提交前即显示预计消耗（「预计 X 消耗 N 算力」），提交成功后切换为实际消耗
• 视频按 分辨率 × 时长档 × 图模式 精确计价（与实际扣费同口径）；生图 / 改图为模型固定单价
• 切换分镜、模式、时长会重新预估；算力不足时无法提交生成任务

五、常见问题

5.1 启动问题

5.2 使用问题

5.3 账号问题

六、快捷键

七、最佳实践

7.1 短剧创作建议

1. 先写好剧本：剧本质量决定视频质量
2. 角色设定详细：详细的设定有助于 AI 生成一致的图像
3. 场景风格统一：保持美术风格一致性
4. 分镜合理：每个分镜时长控制在 3-5 秒

7.2 营销内容创作建议

1. 明确目标：清楚描述想要的效果
2. 提供参考：上传参考图片或视频
3. 多次迭代：AI 生成后多次优化调整
4. A/B 测试：生成多个版本进行测试

7.3 算力节省技巧

1. 先用小图测试：确认效果后再生成高清图
2. 复用素材：已生成的图片/视频可重复使用
3. 合理设置参数：避免不必要的高分辨率生成

八、技术支持

• 在线体验：<官方地址>

*最后更新：2026-09-17*