3SAX V3 User Guide / 使用说明

1. 快速开始 Quick Start

How to create your first video in about 5 minutes

1. 注册 / 登录：点击右上角 Login 或 Sign up，账号与 3sax 主站互通。注册后获得初始积分。
   Sign up / log in — the account is shared with the 3sax main site.
2. 进入创作台：导航栏点击 创作 Create（/studio/），进入编辑器。
   Open the Create page (studio).
3. 上传素材：工程栏点击 上传素材 Upload，选择透明背景 PNG（建议已按部位拆分的人物部件或整图）。系统自动压缩，素材进入画布。
   Upload transparent PNG materials; they are auto-compressed and added to the canvas.
4. 自动编排（可选）：上传后系统自动创建默认动作与调度，画布中即可看到角色。你也可以在渲染面板使用 一句话出片 One-Shot：输入一句描述（如 "a girl dancing on the moon"），一键生成全套编码。
   Auto-binding creates default actions and a schedule; One-Shot generates a full coded scene from one sentence.
5. 提交渲染：渲染面板设置规格（竖屏 720×1280 或横屏 1280×720），点击 提交渲染 Render。等待进度完成，成片出现在结果区，可下载（保留 14 天）。
   Set size, submit render, wait for progress, then download the video (kept for 14 days).

2. 界面与工作区 Studio Overview

Layout of the studio editor

2.1 顶部导航 Top Navigation

首页 Home ｜ 创作 Create（编辑器）｜ 作品 Works ｜ 比赛 Contest ｜ 画廊 Gallery ｜ 作品展示 Showcase ｜ 教程 Guides ｜ 帮助 Help。右上角显示当前登录用户。

2.2 工程栏 Project Bar

2.3 面板标签 Panel Tabs

编辑器底部/上方有一排面板标签，每个面板管理一类编码数据：

2.4 编辑方式 Edit Pattern

每个编码面板的结构一致：左侧是条目列表（显示已创建的条目，点条目可编辑，可删除）；右侧是表单（填写字段，实时显示编码行预览和校验提示）；底部是操作按钮（保存 / 存库 / 重置 / 取消，部分面板有自动工具）。

Each panel follows the same pattern: item list on the left, form + live code preview + validation hints on the right.

3. 素材准备与上传 Materials

What PNGs to prepare and how uploading works

3.1 PNG 要求 PNG Requirements

• 格式：透明背景 PNG（RGBA）。仅支持 PNG。
• 体积与尺寸：单文件建议 ≤300KB 且最长边 ≤1024px。超出会自动等比缩放并重编码；压缩后仍大于 300KB 会进一步缩到最长边 512px。
• 建议：按部位拆分的人物部件（脸、上身、四肢…）或整图均可。透明边缘不要留过多空白，避免裁切异常。

3.2 部位编号 Body Part Codes（join 1-16）

上传后可给每张素材指定部位（join），编码时动作按部位（tgt）引用素材。常用编号：

场景/背景层使用 join=0（或 00）不参与动作绑定，走调度 L3 场景渲染。

3.3 上传与编码 Upload Flow

1. 选择图片：工程栏 上传素材 Upload，可多选 PNG。系统自动压缩，图片以「本地素材」形式加入画布（临时编码 LOC…）。
2. 画布调整：本地素材列表中可设置：部位 join、图层 layer、z 轴（zs/zx/zy）、缩放 scale%。在画布中拖拽调整位置。
3. 上传生成编码：点单张 上传 或 全部上传 Upload All。上传后生成 64 位编码文件名，动作引用自动切换为服务器素材（同一素材组 gid 下）。

3.4 素材库 LIB Library

LIB 面板用于复用服务器端资源：素材组（含缩略图）、动作、音乐、调度、事件。公开素材面向所有用户，私有素材仅自己可见（按 owner 过滤）。选中条目即填入编辑器，画布实时可用。

4. 编码系统 Coding System

SG / AG / CAM / MG / AC / EVT / BONE — each panel produces a code line consumed by the renderer

3SAX V3 用「编码行」描述一切：素材组、动作、镜头、音乐、调度、事件、骨骼都是结构化编码。编辑器帮你生成与校验这些编码，渲染引擎（main_v3）按编码驱动渲染。以下按面板逐一说明字段。

4.1 素材组 SG（Material Group）

示例：

[group]
id=g_lily
unit=1000
fps=24
[items]
A1B2C3D4E5F6G7H8|1|1|face_smile
A1B2C3D4E5F6G7H9|1|2|face_neutral

「状态 state」是一组换图帧的编号（如脸的第 1 帧、第 2 帧表情），动作通过 (tgt, state) 引用具体帧。

4.2 动作 AG（Action）

编码行示例：

ACT|id:a12001|type:char|tgt:1|seq:01:0-4,02:4-8,03:8-12|frames:0-12|rot:0|scale:100|dx:0|dy:0

自动建议序列：按素材组中该部位实际可用的 state 自动生成匹配的换图序列，避免引用不存在的帧。

4.3 镜头 CAM（Camera）

编码行示例：

CAM|id:00000001|seq:0-24|zoom:1000|pan:0,0|cut:off

4.4 音乐 MG（Music）

编码行示例（音符 / 片段）：

NT|id:m12001|seq:0-480|tone:C4 D4 E4 F4 G4 A4 B4 R|beat:8|vol:80|track:melody
CLIP|id:m12002|name:piano_loop|dur:120|bpm:0|gain:60|track:sfx

一键生成旋律：输入旋律简码（如 1 3 5 6 5 3），系统校验字符、按 seq 容量自动补足休止符并生成 tone 与 seq。

5. 画布 Canvas

Visual preview with drag-and-drop editing

• 实时预览：画布按当前编码渲染静态画面（含材质、位置、缩放、图层与 z 轴）。
• 拖拽调整：可直接拖动素材调整位置；本地素材列表支持设置部位、图层、z 轴与缩放，画布与编码实时双向同步。
• 规格联动：选择渲染规格（竖屏 720×1280 / 横屏 1280×720）时画布自动切换比例，素材与调度坐标自动等比。
• 双模式：画布提供简易 / 专业两种模式（同一份数据，不同操作视图）。

6. 渲染 Render 与一句话出片 One-Shot

Turn your codes into a video

6.1 渲染配置 Render Config

6.2 编码拼接 Join（多段串联）

把两段调度按 段A(AC1+MUS1) → 段B(AC2+MUS2) 顺序串联成一段完整事件：选择段 A/B 的调度与音乐（音乐可空 = 静音），点 生成拼接编码，可 保存拼接事件 或直接 快测预览（段 A 头 24 帧 + 段 B 头 24 帧）。

6.3 提交渲染 Submit Render

1. 确认调度 AC（可逗号分隔多段）、事件 EVT（可选）、渲染配置。
2. 点 提交渲染 Render，等待进度（状态区显示进度，页面可轮询）。
3. 完成后成片出现在结果区，可预览/下载。成片保留 14 天，请及时保存。

6.4 一句话出片 One-Shot

在输入框写一句画面描述（如「少女在月光下欢快地独奏」），点 生成全套编码 Generate，系统自动编排动作 / 镜头 / 音乐 / 调度 / 事件 / 骨骼全套编码，随后可直接提交渲染。适用于快速出片与灵感验证。

7. 作品 Works（保存 / 加载 / 管理）

Save, load and manage your projects

• 保存：编辑器中点 保存到服务器 Save，把当前编码工程保存到云端（需登录）。
• 加载：从 云端工程列表 选择工程即可恢复继续编辑。
• 作品页：导航 作品 Works（/works/）展示你的作品列表，可管理（游客模式不关联账号，登录后管理个人作品）。
• 本地草稿：未保存时编码自动存在浏览器 localStorage，刷新不丢；换设备或清缓存前记得保存到服务器。

8. 画廊与比赛 Gallery & Contest

Share your works and join the contest

8.1 画廊 Gallery

• 画廊展示用 3SAX V3 创作的作品（/gallery/）。
• 提交的作品进入审核流：pending（待审）→ approved（通过并生成公开副本）/ rejected（驳回，附原因）。
• 通过后作品在画廊公开展示；长期未过审或用户删除的作品按规则清理（30 天）。

8.2 比赛 Contest

• 3SAX 不定期举办创作比赛（如全球 AI 萨克斯创作大赛），规则、截止时间与奖励见 比赛 Contest 页与 比赛条款。
• 投稿入口与要求以当期比赛页为准。

9. 账号与积分 Account & Points

Profile, points and password

• 资料：昵称、邮箱、积分、注册时间在账号页（/account/）查看。
• 积分：注册获得初始积分；积分用于站内权益（具体获取/消耗规则见站点说明）。
• 修改密码：账号页输入当前密码与新密码（6-64 位）更新。
• 忘记密码：使用恢复码（注册时系统生成，只显示一次）重置；恢复码每次使用后自动轮换，请妥善保存。若同时遗失恢复码，走页面提供的人工通道联系站长。
• 站内信：站内通知与消息在消息页查看（登录后右上角红点提示）。

10. 校验与错误对照 Validation Reference

Common validation messages and what to do

11. 已知限制与建议 Limits

• 素材格式：仅 PNG；超限自动压缩（≤1024px / 300KB，必要时再缩到 512px）。
• 成片保留：渲染成片保留 14 天，请及时下载到本地。
• 帧区间：音乐 seq 建议 0-480 内；调度时长建议 ≤9999 帧。
• 浏览器数据：工程草稿在浏览器本地，清理浏览器数据会丢失未保存内容。
• 画布规格：自定义宽高仅影响成片渲染，画布预览仍按当前规格（720×1280 或 1280×720）。
• 建议工作流：素材 → 画布对齐 → 动作/音乐 → 调度 → 事件 → 渲染。先小段快测（快测预览），确认效果再全长渲染。