素材管理
素材不仅是文件，还包含权利、来源、AIGC 和 revision 绑定信息。
上传前检查
- 确认文件来源与可使用范围。
- 涉及人物时确认肖像或出镜授权。
- 涉及音乐时确认授权期限和平台范围。
- 由生成式工具产生或明显修改时填写 AIGC 声明。
AI 生成封面图
平台编辑器的“AI 生成封面图”在 Web、Windows 和 macOS 共用同一图像合同，但它是后台任务：按下按钮只把请求交出去，出图和存图都在后台完成，界面立刻回到可操作状态。你可以继续编辑其他内容、切换平台，甚至离开这一页，已经提交的任务不会因此中断。
- 任务在“生成任务”面板里只有五种状态：排队中、生成中、已完成、失败、已取消。
- 上游不返回预计完成时间，所以面板只给排队位置，并写明“排队位置不是进度”，没有百分比进度条。
- 只有已完成的作业才写入素材库；排队中和生成中的内容不会出现在素材里。
- 页面切到后台或离开本页时面板会暂停自动刷新并写明“已暂停自动刷新”，回到本页立即补一次；暂停刷新不等于任务停了。
同一个提示词、同一角色、同一来源、同一候选序号，在任务未完成前重复提交回到的是同一个任务：不会重复出图，也不会重复计费。
一次多张候选
需要挑图时可以把一次提交变成多张候选：在按钮旁选择候选张数（1 到 8，默认 3）。同一批是同一提示词的重复抽样，不是 8 个不同方案；面板按“同一批候选 · 共 N 张”把它们分成一组，同时逐张显示各自状态。
- 某一张失败不影响同批其余图片，重试只重跑失败的那几张。
- 候选图入库时权利状态是待确认，AIGC 标记由系统写入；选中哪一张仍需人工补齐来源与授权，再进入审核。
- 批量提交受与单张提交相同的提交前检查约束，面板会指出具体是哪一条挡住了提交，而不是笼统报错。
取消、重试与失败原因
| 情况 | 界面显示 | 实际发生 |
|---|---|---|
| 排队中取消 | “取消” | 任务直接结束，不会开始上游调用，也不会留下素材 |
| 上游调用已开始后取消 | “取消” | 该次调用已经发生，但结果被丢弃，不写入素材库 |
| 生成失败 | “生成请求被拒绝 · PROVIDER_REJECTED”这类中文说明加固定错误码 | 按服务端错误码逐因解释，可以只重试这一张 |
| 队列已满 | “队列已满，N 秒后可再试” | 本次提交没有入队，现有内容保持不变；等待秒数来自服务端 |
| 生图凭据未配置（多为桌面版） | “上游不可用” | 提交当场失败，不会先落一条作业再空耗额度；这是配置缺失，不是出图失败 |
| 按钮被挡住 | 悬停显示挡住提交的具体原因 | 母稿或平台版本有未保存改动、版本已过期、素材绑定正在读写、宿主正在读写内容等，每种原因各有各的文案 |
面板显示的是固定错误码与中文说明，不显示内部方法名或上游原始响应，也不显示 key、Cookie 和本地路径。
网页版与桌面版
- 网页版：任务记录在服务端作业表里，由服务端跑完并存进当前 SSOS 工作区的素材库；关掉标签页不影响它跑完。
- Windows 与 macOS：同一条队列由本机主进程驱动，任务与素材写本机 SQLite；渲染端只读状态，不持有 API key、本地绝对路径或上游原始响应。
- 应用或服务重启后，未完成的排队任务继续跑；正在跑的那一张最多再试一次，不会留下无人认领的任务。
- 两端都要求生图凭据与素材存储同时具备才启用队列，缺任何一项时提交明确失败。
三端版本通过 rendererCommit 对齐；桌面端保存到本机 SQLite，Web 保存到当前 SSOS 工作区，内容数据不会因为安装同一版本而自动跨设备合并。正文信息卡仍由确定性模板渲染，不走模型出图。
生成图与上传素材走同一套权利、AIGC、审核与人工确认流程：出图成功不等于已审核，更不等于已发布。
上传与登记
- 进入“素材”，选择文件。
- 填写权利类型、来源和必要的到期时间。
- 等待服务端完成 hash、大小和媒体信息核对。
- 只有登记成功的 managed asset 才能参与后续绑定。
绑定到版本
素材绑定到具体平台版本 revision，而不是只绑定到“这篇内容”。当版本变化或素材替换时，重新审核当前绑定集合。
| 状态 | 含义 | 处理 |
|---|---|---|
| 可用 | 文件与声明可验证 | 可以进入审核 |
| 待确认 | 权利或同意信息不完整 | 补齐证据 |
| 过期 | 授权期限已过 | 替换素材或更新授权 |
| 不可用 | 文件丢失或校验失败 | 重新上传 |
安全边界
浏览器只接收公开素材投影，不接收本地绝对路径、Cookie、平台 token 或 keychain 内容。
下一步
素材绑定完成后，进入 审核与发布安全。