Genesis Desktop Complete User Guide

1. 你将学会什么（覆盖清单）

1. 顶栏菜单：文件/查看/视图/帮助 的每个可点入口。
2. 工作区切换：生成/资产/影视/任务/项目管理/回收站/空间清理 的入口与快捷键。
3. 资产库：导入文件/文件夹、文件夹管理、拖拽移动/复制、剪贴板剪切/复制/粘贴、回收站/永久删除。
4. 生成工作区（Genesis）：图片/视频/聊天三条主线，参考图导入、右键菜单、下载/入库/导出副本/复制链接等。
5. 任务中心：筛选、查看详情、复制ID、重试、重新入库（以及哪些按钮当前为占位）。
6. 影视工作区：从“项目”维度进入影视流程（项目切换、入口约定、与生成/任务的跳转关系）。
7. 项目管理：系统级项目入口与常用动作（以 UI 实现为准）。
8. 统一回收站：按范围/类型筛选、还原/清空/永久删除。
9. 空间清理：扫描、执行清理、保守清理缓存/临时、计划任务、快速打开目录、内部暂存区(.gc_trash)清理。
10. 设置：通用/AI 能力/外观/网络代理/更新与诊断/资产与存储/媒体处理/高级。
11. 故障排查：登录、代理、下载/入库、缩略图、更新失败、反馈包。

2. 界面总览（先认清“你在哪”）

Genesis Desktop 主窗口由三块组成：

1. 顶栏（TopCommandBar）：菜单 + 工作区快捷按钮 + 项目切换 + 搜索 + 登录/设置等。
2. 三栏工作区布局：左侧面板（导航/输入）+ 中栏列表（任务/资产/项目等）+ 右侧详情（Inspector）。
3. 贴边 Rail：部分工作区右侧有“贴边按钮”用于切换右侧详情页（例如任务中心显示 详情/日志/操作）。

你要先学会一条规则：

1. “功能在哪”：优先看顶栏的工作区按钮和下拉菜单。
2. “对象在哪”：对象通常在中栏列表（资产条目、任务条目、回收站记录）。
3. “操作在哪”：对象的操作通常在右侧详情按钮区或对象右键菜单里。

3. 工作区与快捷键（必须记住）

3.1 已注册工作区（桌面端完整列表）

当前主窗口会注册并提供以下工作区：

1. generation：生成（AI 生成工作区，包含图片/视频/聊天）。
2. assets：资产（文件/资产库工作区）。
3. film_studio：影视（影视工作区）。
4. tasks：任务中心（全局任务管理）。
5. project_manager：项目管理（系统级项目入口）。
6. trash_center：统一回收站（跨模块聚合）。
7. gc_management：空间清理（GC 管理）。

3.2 快捷键（工作区切换）

工作区快捷键固定为：

1. Ctrl+1：资产
2. Ctrl+2：生成
3. Ctrl+3：影视
4. Ctrl+4：任务中心
5. Ctrl+Tab：按 MRU（最近使用顺序）切换到下一个工作区
6. Ctrl+Shift+Tab：按 MRU 反向切换

3.3 启动时进入哪个工作区

默认策略是“尽量恢复上次关闭时所在工作区”，可在设置里控制：

1. 打开顶栏 设置（齿轮）。
2. 左侧选择 通用。
3. 找到 启动时恢复上次工作区，按需勾选/取消。

4. 顶栏菜单完整说明（每一项都可照做）

4.1 文件菜单：导入到资产库

入口：顶栏 文件 -> 导入 -> 文件… 或 文件夹…

#### 4.1.1 导入文件…（支持的格式 + 完整步骤）

支持格式：

1. 图片：.jpg/.jpeg/.png/.webp/.gif/.bmp/.tiff/.heic/.heif
2. 视频：.mp4/.mov/.webm/.mkv/.avi

操作步骤：

1. 点击顶栏 文件。
2. 鼠标悬停/点击 导入。
3. 点击 文件…。
4. 在系统文件选择器里选择 1 个或多个媒体文件。
5. 点击 打开/确定。
6. 导入完成后切到 资产 工作区，在资产库中查看导入结果（通常会自动创建一个“未命名文件夹(n)”并把导入的内容放进去）。

你应当看到的结果：

1. 资产库里新增条目（图像/视频）。
2. 若导入视频，系统会尝试生成缩略图（失败时不影响导入，只影响显示）。

#### 4.1.2 导入文件夹…（递归导入 + 空文件夹提示）

操作步骤：

1. 点击顶栏 文件 -> 导入 -> 文件夹…。
2. 在系统目录选择器里选择一个文件夹。
3. 确认后，系统会递归扫描其下所有文件，只导入“支持格式”的图片/视频。

你应当看到的结果：

1. 若文件夹内无支持格式，会在状态栏提示：该文件夹内没有支持的图片或视频文件。
2. 若有可导入文件，会批量写入资产库并创建目标文件夹关系。

4.2 查看菜单：资产库管理器 / 空间清理器 / 轮询诊断

入口：顶栏 查看

菜单项与用途：

1. 资产库管理器：打开资产库管理窗口（库维护、迁移、导出等入口）。
2. 空间清理器：直接切换到 空间清理 工作区。
3. 轮询诊断：默认隐藏且不可用（仅在特定运行态下启用，用于诊断轮询/刷新链路）。

4.3 视图菜单：重置布局 / 悬浮生成按钮

入口：顶栏 视图

#### 4.3.1 重置当前工作区布局

当你出现“面板不见了/拖乱了”的情况：

1. 点击顶栏 视图。
2. 点击 重置当前工作区布局。
3. 观察三栏与右侧 Rail 是否恢复默认。

#### 4.3.2 重置全部布局

当多个工作区都被拖乱：

1. 点击顶栏 视图。
2. 点击 重置全部布局。

#### 4.3.3 显示悬浮生成按钮

这会在桌面上显示一个“悬浮生成按钮”（用于更快触发生成入口）。

1. 点击顶栏 视图。
2. 勾选 显示悬浮生成按钮（再次点击可取消勾选）。

4.4 帮助菜单：更新/教程/排障/反馈/关于

入口：顶栏 帮助

菜单项与操作步骤：

1. 检查更新…
2. 使用教程：打开在线教程页（浏览器）。
3. 故障排查：打开在线排障页（浏览器）。
4. 问题反馈：打开本地反馈对话框（见 §14）。
5. 官网：打开官网。
6. 联系方式：弹出联系方式或打开页面（以实现为准）。
7. 软件协议：打开软件协议。
8. 关于…：显示版本、渠道、平台等信息。

5. 登录与账号（远程生成端）

Genesis 的“远程生成”依赖远端认证；不同环境可能强制登录。

5.1 打开登录窗口

常见入口：

1. 顶栏右侧点击 登录（或账号头像/邮箱入口，视 UI 状态而定）。
2. 若当前环境“必须登录”，启动后会自动弹出登录窗口；你取消可能会被要求重新登录或关闭应用（以当前环境策略为准）。

5.2 登录窗口字段与按钮（每一步怎么填）

登录窗口标题：登录远程生成端

操作步骤：

1. 在 账号/邮箱 输入框填入你的账号标识。
2. 在 密码 输入框填入密码。
3. 需要记住登录态：勾选 记住我。
4. 需要记住邮箱但不记住 token：按 UI 是否提供“记住邮箱”选项操作（实现会保存 remembered email）。
5. 点击 登录。
6. 登录中按钮会显示 登录中…，成功后窗口自动关闭，顶栏显示已登录态。

失败时你会看到：

1. 通用提示：登录失败，请稍后重试
2. 或更具体的错误（以服务端返回为准）。

5.3 退出登录

操作步骤：

1. 点击顶栏账号入口（已登录态）。
2. 选择 退出登录（若提供）。
3. 系统会尝试先调用远端 logout，再清除本地 token；若远端失败也会继续清本地 token。

6. 设置（SettingsWindow）完整说明

入口：顶栏右侧 设置（齿轮）。

设置窗口结构：

1. 左侧导航：通用/AI 能力/编辑器/外观/工作区/网络 / 代理/更新与诊断/资产与存储/媒体处理/高级
2. 右侧内容：每个分区可滚动；部分分区包含子页面（媒体处理）。

6.1 通用

包含：

1. 语言（当前仅显示“简体中文”）。
2. 启动时恢复上次工作区：控制启动进入哪个工作区（见 §3.3）。
3. 开发环境可能额外提供“登录门禁”开关（生产环境隐藏且锁死为必须登录）。

6.2 AI 能力（重要：决定模型/线路可用性）

当前版本的 AI 能力 分区是“运行状态 + 全局提交参数”，不再在此页面提供“凭证/渠道/服务商/路由策略”的可视化管理入口（若你看到旧教程提到这些配置项，请以本段为准）。

本分区包含两块：

1. 运行状态（只读）：用于确认当前编排与远端环境是否正确。
2. 生成提交（全局）：用于控制图片/视频提交的超时与重试。

#### 6.2.1 运行状态（只读）

你会看到并用于排查的字段：

1. 编排模式：例如 服务端统一编排（Core-only） 或 本地编排。
2. 远程 API：当前远端 API Base URL（只读展示）。
3. 本地回退：当前固定显示 禁用。
4. 本地 Worker：显示 禁用/启用（按运行配置）。
5. 登录状态：显示 未登录/已登录（邮箱或用户ID），并可能显示 Token 到期时间。

标准检查步骤：

1. 打开 设置 -> AI 能力。
2. 先看 远程 API 是否为你期望的环境。
3. 再看 登录状态 是否为已登录；若未登录，先去顶栏完成登录（见 §5）。

#### 6.2.2 生成提交（全局）

本区会说明一条关键语义：

1. 重试次数是“额外重试次数”
2. 总尝试次数 = 1 + 重试次数

可配置项：

1. 请求超时（秒）：范围 1～600 秒。
2. 图片重试次数：范围 0～10。
3. 视频重试次数：范围 0～10。

保存步骤：

1. 按需调整 请求超时（秒）/图片重试次数/视频重试次数。
2. 点击右下 保存。
3. 看到提示：已保存 AI 能力配置。

影响范围与边界（避免误解）：

1. 这里保存的是“全局提交层”的超时与重试参数，会影响生成任务提交时的请求行为。
2. 模型/线路 的选择不在这里配置，而是在 生成工作区/影视工作区 的具体提交时按任务配置生效。

6.3 外观

包含：

1. 主题
2. 字号
3. 密度

保存后会触发样式热重载（无需重启）。

6.4 网络 / 代理（非常关键）

代理模式三选一：

1. 直连（默认）：不读取系统代理。
2. 使用系统代理（不推荐，仅调试）
3. 自定义代理

自定义代理字段：

1. 自定义代理主机
2. 自定义代理端口
3. 代理用户名
4. 代理密码

保存步骤：

1. 选择代理模式。
2. 若选自定义，填写主机/端口（按需填用户名密码）。
3. 点击保存（保存到 network_settings.json）。
4. 回到生成区做一次“刷新任务状态/提交任务/拉取详情”验证网络可用。

6.5 更新与诊断

更新模式：

1. 自动检查更新（默认开启）
2. 自动下载更新（默认关闭）
3. 自动安装更新（默认关闭；仅在更新执行器就绪时生效）

诊断与反馈：

1. 遇到错误时自动发送匿名诊断事件
2. 发送反馈时默认附带最近日志

6.6 资产与存储（导出副本）

核心开关：

1. 生成后自动导出副本

你需要知道的行为：

1. 这是“生成完成后”的异步导出，不影响任务本身成功与否。
2. 导出副本会影响“在资源管理器中打开（导出副本）/重新导出副本”等菜单可见性（见 §8.8）。

6.7 媒体处理（子页面）

包含子页面：

1. 自动视频配乐
2. AI 标题生成
3. 提取视频帧
4. 视频裁剪
5. 视频分割

说明：

1. 这些工具通常与 资产 工作区的中栏 Tab 对应（例如“自动视频配乐/AI 标题生成/提取视频帧”）。
2. 若你在资产工作区看不到对应 Tab，优先检查是否被隐藏、或当前版本是否启用。

6.8 高级

你能看到并常用的内容：

1. 数据根目录
2. 默认存储根名称
3. 默认存储根目录
4. 缓存与性能策略只读展示（例如缓存上限、tmp 保留时长）
5. 管理资产库 ->：跳转到资产工作区/资产库管理入口（以实现为准）

7. 资产工作区（Assets）完整使用教程

入口：

1. 顶栏快捷按钮 资产。
2. 快捷键 Ctrl+1。
3. 其他工作区内的“管理资产库/导入到资产库”等跳转。

资产工作区由“左侧导航 + 中栏内容 + 右侧详情”组成；中栏通常有多个 Tab（例如文件、资产库、AI 标题生成、自动视频配乐）。

7.1 左侧：本地文件 / 资产库

左侧有两个一级入口：

1. 本地文件：浏览电脑上的文件与目录（不等于入库）。
2. 资产库：浏览已入库资产（支持文件夹树/快速访问/回收站）。

你需要牢记：

1. “本地文件”只是查看本地，不代表写入资产库。
2. 真正入库的入口是：文件 -> 导入（见 §4.1）或资产库内的导入/拖拽（视实现而定）。

7.2 中栏：资产库列表（打开/预览/右键）

中栏资产库列表支持两种典型交互：

1. 单击选中条目：右侧详情更新到该条目。
2. 双击条目：打开（图片用内置预览器；视频用系统默认播放器）。

#### 7.2.1 打开条目（图片/视频）

操作步骤：

1. 在资产库列表中找到条目。
2. 双击条目，或右键选择 打开。
3. 图片：打开内置预览器。
4. 视频：用系统默认播放器打开（如果系统未配置默认播放器，会提示无法打开）。

#### 7.2.2 条目右键菜单（普通范围）

非回收站范围时，常见右键项为：

1. 打开
2. 重命名 F2（仅单选时可用）
3. 复制 Ctrl+C（复制链接/URI 到剪贴板）
4. 剪切 Ctrl+X（用于在资产库文件夹间移动关系）
5. 粘贴 Ctrl+V（粘贴到当前文件夹；要求你当前正处在“自定义文件夹”视图）
6. 删除（丢到回收站，非永久删除）

操作要点（一定要按下面做，不然会觉得“粘贴没反应”）：

1. 如果你要 Ctrl+V 粘贴：先在左侧进入某个“自定义文件夹”视图，再执行粘贴。
2. 如果当前不是文件夹视图，系统会提示：请先进入一个“自定义文件夹”视图，再执行粘贴。

#### 7.2.3 条目右键菜单（回收站范围）

当你在左侧进入“回收站”后，右键会切换为回收站语义：

1. 还原
2. 永久删除
3. 清空回收站（通常在空白处或列表菜单里）

键盘 Delete 行为：

1. 非回收站：Delete = 丢到回收站
2. 回收站：Delete = 永久删除

7.3 左侧：回收站右键（还原全部/清空回收站）

在资产库左侧“回收站”入口上右键，会出现：

1. 还原全部项目
2. 清空回收站

操作步骤：还原全部项目

1. 在左侧选择 资产库。
2. 点击 回收站。
3. 在左侧 回收站 上右键。
4. 点击 还原全部项目。
5. 等待完成提示（会显示还原数量与失败信息）。

操作步骤：清空回收站（高风险，不可恢复）

1. 在左侧 回收站 上右键。
2. 点击 清空回收站。
3. 阅读确认弹窗：将永久删除回收站中的所有资产，且无法恢复。
4. 确认后执行永久删除。

7.4 资产库管理器（查看 -> 资产库管理器）

入口：

1. 顶栏 查看 -> 资产库管理器

窗口包含三个区域（左/中/右）：

1. 左侧：库列表
2. 中间：当前库详情与维护
3. 右侧：迁移与导出

注意：当前实现中部分按钮会提示“开发中/敬请期待”，属于“UI 已有、功能未交付”：

1. 迁移到其他位置…：可能提示开发中。
2. 导出库…：可能提示开发中。
3. 项目包导出…：可能提示开发中。

7.5 拖拽移动/复制（资产库内部）

资产库列表支持拖拽到左侧文件夹树：

1. 默认拖拽：移动（move）
2. 按住 Ctrl 再拖拽：复制关系（copy）

操作步骤（移动到某个文件夹）：

1. 在中栏选中 1 个或多个条目。
2. 鼠标拖拽到左侧目标文件夹上。
3. 释放鼠标，观察提示：移动 n 项。
4. 进入目标文件夹验证条目出现；原文件夹对应关系应被移除。

操作步骤（复制到某个文件夹）：

1. 选中条目。
2. 按住 Ctrl。
3. 拖拽到目标文件夹并释放。
4. 观察提示：复制 n 项。

7.6 重命名（F2）

操作步骤：

1. 在资产库列表单选一个条目。
2. 按 F2，或右键选择 重命名 F2。
3. 在弹窗输入新名称。
4. 确认后，若失败会提示 重命名失败。

8. 生成工作区（Generation / Genesis）完整使用教程

入口：

1. 顶栏快捷按钮 生成
2. 快捷键 Ctrl+2

生成工作区包含三条功能主线：

1. 图片生成
2. 视频生成
3. 聊天（含可上传图片/视频附件的对话式入口）

8.1 通用规则：先选“模型”，再看“线路”

你会在顶栏或面板顶部看到：

1. 模型： 下拉
2. 线路 下拉

规则：

1. 线路下拉只显示“当前模型可用的线路”（与设置中的可用通道取交集）。
2. 若你切换模型导致当前线路不支持，会提示：该线路不支持当前模型，已切回自动。

8.2 聊天栏目（复制/修改/重做/附件）

聊天栏主要用于“对话式 AI 能力”，具备：

1. 助手/用户消息气泡
2. 用户消息支持“内联编辑后重新发送”
3. 助手消息支持“重做/复制”
4. 支持上传图片/视频附件（具体能力取决于模型）

常用操作步骤：

1. 切到 聊天 栏目（如果 UI 提供该栏目）。
2. 选择 模型，再选择 线路（或保持自动）。
3. 在底部输入框输入你的问题/指令。
4. 若模型支持附件，点击上传按钮选择图片/视频；若超过限制会提示“图片数量上限”等。
5. 点击发送，等待回复。

复制文本：

1. 在消息气泡内选中文本后 Ctrl+C。
2. 或右键选择 复制（无选中时复制全文）。
3. 或点击气泡上的“复制”图标，提示 已复制。

重做 AI 回复：

1. 在助手消息气泡底部点击 重做。
2. 系统会删除当前回复并重新请求。

8.3 图片生成（从 0 到交付的标准步骤）

你每次做图片生成，严格按这个顺序：

1. 切到 图片生成 模式（左侧导航通常含 图片生成/视频生成）。
2. 选择 模型。
3. 确认/选择 线路（自动或指定）。
4. 选择 模式（文生图/图生图/多图/组图，按模型能力显示）。
5. 按需添加 参考图。
6. 填写提示词（主提示词 + 可选前置提示词/参考提示词）。
7. 设置规格与数量。
8. 点击 生成。
9. 在中栏任务列表追踪状态，完成后在右侧/右键下载、入库、复制链接等。

8.4 视频生成（首尾帧/多参考图）

视频生成的关键差异：

1. 部分模式需要参考图（例如首尾帧）。
2. 生成前会做校验：例如 图生视频需要至少一张参考图（首帧/尾帧）。

建议操作步骤（首尾帧为例）：

1. 切到 视频生成。
2. 选择支持视频的模型与线路。
3. 选择 首尾帧（若可见）。
4. 在参考图区添加首帧/尾帧（见 §8.5）。
5. 填提示词与参数（时长、数量等以 UI 可见项为准）。
6. 点击生成。

8.5 参考图（Reference）完整操作（添加/右键/粘贴/语义标签）

参考图区支持：

1. 直接添加本地图片
2. 拖拽图片文件到参考区
3. Ctrl+V 粘贴剪贴板中的图片或图片路径
4. 右键菜单替换/导入/删除
5. 从资产库导入、从项目分镜导入
6. 语义标签（semantic label）辅助多图语义归类（由菜单构建）

#### 8.5.1 卡片右键菜单（单张参考图）

对参考图卡片右键，菜单包含：

1. 复制：复制该参考图路径到剪贴板
2. 粘贴：用剪贴板图片/路径替换该卡片
3. 替换图片…：选择本地文件替换
4. 导入 子菜单
5. 删除

导入子菜单包含：

1. 本地导入…
2. 从资产库导入…
3. 从项目分镜导入…

操作步骤：用资产库替换某张参考图

1. 在参考图卡片上右键。
2. 选择 导入 -> 从资产库导入…。
3. 在弹窗里选择目标图片。
4. 确认后该卡片替换为新图片。

操作步骤：Ctrl+V 粘贴替换

1. 把图片复制到剪贴板（截图、复制图片文件、或复制图片路径）。
2. 回到 Genesis 参考图区，对目标卡片右键 -> 粘贴。
3. 若剪贴板无可用图片，会提示：剪贴板中没有可用图片。

#### 8.5.2 清空参考图

若 UI 提供“清空/移除全部”按钮：

1. 点击清空按钮。
2. 或逐个卡片右键 删除。

8.6 任务列表与右键菜单（最常用的“交付动作”都在这里）

任务列表右键菜单会随状态变化；你需要掌握 3 类状态：

1. 运行中/排队中：以刷新、查看详情为主。
2. 成功（outputs ready）：下载、复制链接、打开文件、导出副本等。
3. 失败/已取消：重试工作流/节点、复制诊断、跳过节点等。

#### 8.6.1 通用项（任何任务都应该有）

1. 🔄 刷新任务状态：从服务端拉最新状态
2. 复制工作流运行ID
3. 🖼 更新缩略图：尝试基于当前可用源重建缩略图
4. 显示详情

#### 8.6.2 成功后（outputs ready）常用项

当任务产物就绪且至少 1 个输出时，常见菜单项包括：

1. 复制入库后链接（需要先“重新入库”成功，未入库会灰态并提示“需先重新入库”）
2. 📷 复制图片（仅图片产物）
3. 复制文件路径（入库后内部路径，未入库会提示暂无可复制路径）
4. 使用默认查看器打开
5. 在资源管理器中打开（内部）
6. 若启用“生成后自动导出副本”：
7. 在资源管理器中打开（导出副本）（未导出会灰态提示“未导出/导出失败”）
8. 重新导出副本（失败或未导出时出现）
9. 下载原始文件
10. 下载全部（多输出时出现）
11. 🔄 重新入库（从云端重拉产物并更新内部链接）

你交付给同事/客户时，最稳的动作顺序：

1. 先右键 🔄 重新入库（确保内部链接与内部路径就绪）。
2. 再 复制入库后链接 或 复制文件路径（更稳定）。
3. 需要落地文件就 下载原始文件。
4. 若你启用了导出副本，就用 在资源管理器中打开（导出副本） 找到交付目录。

#### 8.6.3 失败/已取消后的重试项

当任务状态为 failed/cancelled 时会出现：

1. 重试工作流运行
2. 重试失败的节点运行
3. 跳过失败的节点运行

建议步骤（先诊断再重试）：

1. 先 显示详情，查看失败原因。
2. 若右侧失败原因可点击，点击可直接复制完整错误信息（会提示“失败原因已复制”）。
3. 再决定是“重试工作流”还是“重试节点/跳过节点”。

8.7 右侧详情面板：输出列表右键菜单

在右侧详情里，输出列表支持右键菜单：

1. 下载
2. 复制内部链接
3. 在资源管理器中打开
4. 使用默认查看器打开
5. 更新缩略图

操作步骤：

1. 在右侧输出列表中单击选中某个输出。
2. 右键该输出行。
3. 选择所需动作。

8.8 导出副本（与“资产与存储”联动）

如果你开启了设置 生成后自动导出副本：

1. 任务成功后会异步导出一份可交付副本到指定目录。
2. 右键菜单里会多出“打开导出副本/重新导出副本”等入口。

你排查“为什么找不到导出副本”的标准步骤：

1. 打开 设置 -> 资产与存储，确认已勾选 生成后自动导出副本。
2. 回到任务列表右键该任务，查看 在资源管理器中打开（导出副本） 是否可用。
3. 若灰态且提示“导出失败”，点 重新导出副本。

9. 任务中心（Tasks Center）完整使用教程

入口：

1. 顶栏快捷按钮 任务
2. 快捷键 Ctrl+4

任务中心是“全局任务管理”，三栏结构为：

1. 左侧：任务类型导航（默认 全部，包含 图片生成/视频生成 等分类）
2. 中栏：任务列表（表格形式，支持刷新与分页）
3. 右侧：任务详情（含下载/复制ID/重试/重新入库等按钮）

9.1 左侧筛选（全部/图片生成/视频生成）

操作步骤：

1. 进入任务中心。
2. 在左侧点击 全部 或 图片生成 或 视频生成。
3. 中栏列表会应用对应筛选。

9.2 中栏刷新

操作步骤：

1. 点击中栏上方 刷新 按钮。
2. 等待列表刷新。

补充：任务中心会每 15 秒自动 tick 并刷新一次列表（无需你手动刷新）。

9.3 右侧详情与操作按钮（哪些可用，哪些是占位）

右侧详情常见按钮：

1. 下载
2. 复制ID
3. 重试（会二次确认）
4. 重新入库

当前实现提示（重要，避免误会）：

1. 复制ID：可用，成功会提示 已复制到剪贴板。
2. 重试：可用，会弹窗 确认重试。
3. 重新入库：可用，会提示成功数量或失败原因。
4. 下载：当前代码标记为 TODO（按钮存在但下载逻辑可能未实现或受版本限制）；若你点了无效果，请以任务列表右键菜单的“下载原始文件”为准。

9.4 失败详情（复制失败信息）

当任务失败：

1. 右侧会出现 失败详情 区块。
2. 失败原因/错误码/步骤会按实现展示。
3. 产物链接区域提示：点击链接可复制。

10. 影视工作区（Film Studio）完整使用教程

入口：

1. 顶栏快捷按钮 影视
2. 快捷键 Ctrl+3

影视工作区职责与布局（认清这三栏你才能找到按钮）：

1. 左侧：四段导航树（项目区/创作区/生产区/协作区，具体分组以 UI 为准）
2. 中央：主画布（项目总览/分镜列表/分镜详情/时间线/生成/渲染等）
3. 右侧：固定四 Tab 详情/图片/视频/配置，默认仅展开 详情
4. 贴边 Rail：控制右侧四 Tab 的显隐与切换

10.1 选择项目（影视是 Project Consumer）

影视工作区本身不负责“管理项目”（创建/删除/归档等），项目管理统一在 项目管理 工作区完成（见 §11）。

你在影视里常见的项目入口：

1. 从左侧项目区选择一个项目（如左侧提供项目列表）。
2. 从项目管理工作区双击项目进入影视（见 §11.6）。

10.2 分镜（Shot）列表页：全选/绑定生成/图片生成/视频生成

在分镜列表页底部会出现操作条（Action Bar），包含：

1. 全选（复选框）
2. 绑定生成
3. 图片生成
4. 视频生成

操作步骤：勾选分镜

1. 在中栏分镜列表中找到目标分镜（Shot）。
2. 勾选每行的复选框，或点底部 全选。

操作步骤：绑定生成（把选中的 Shot 绑定到 Quick Dock）

1. 先勾选一个或多个分镜（Shot）。
2. 点击底部 绑定生成。
3. 若你未勾选，会提示：请先勾选要绑定的分镜（Shot）。

操作步骤：单个/批量图片生成

1. 先确保右侧 配置 Tab 已选择 模型与线路（否则会提示你先选）。
2. 勾选分镜（一个或多个）。
3. 点击底部 图片生成。
4. 如果是多选，会弹出 批量生成确认，里面会列出：
5. 将提交的分镜列表
6. 提示词缺失的分镜列表
7. ContentNode 缺失的分镜列表
8. 已在提交中的分镜列表
9. 点击 继续提交 执行，或点 取消 放弃。

操作步骤：单个/批量视频生成

1. 流程与图片生成相同，只是点击底部 视频生成。

10.3 分镜详情页：打开/重命名/生成…

进入分镜详情页（打开/编辑）：

1. 在分镜列表中双击某个节点（Shot）。
2. 中栏会进入详情页，顶部标题类似：分镜详情 · {分镜名}。

重命名分镜（F2/右键）：

1. 选中分镜节点。
2. 按 F2 或在右键菜单选择 重命名。
3. 输入新名称并确认。
4. 失败会提示：重命名失败。

从分镜详情跳到 Genesis 生成工作区（生成…）：

1. 在分镜详情页点击 生成…（按钮文案以实际 UI 为准）。
2. 系统会跳转到 生成 工作区，并注入该分镜的 context_ref（用于任务中心/生成回跳定位）。
3. 若未选择项目或分镜，会提示：请先选择项目与分镜。
4. 若当前节点不是 Shot，会提示：当前仅分镜（Shot）支持生成。

10.4 从分镜导入素材（供生成参考图使用）

在 Genesis 生成工作区的参考图右键菜单里，你会看到：

1. 导入 -> 从项目分镜导入…

当你点击该入口：

1. 会弹出 选择分镜 或 选择分镜产物 对话框（含搜索框 搜索分镜名… / 搜索文件名/路径/分镜名…）。
2. 先点 选择分镜… 选定一个分镜。
3. 再从列表里选一个或多个产物，确认后导入为参考图。

11. 项目管理（Project Manager）完整使用教程

入口：

1. 顶栏按钮 项目（提示“点击进入项目管理”）
2. 或从其他工作区的“管理项目”入口跳转

项目管理工作区是“系统级唯一项目管理入口”，包含三栏：

1. 左侧：导航树（最近项目/项目文件夹/回收站 等）
2. 中栏：项目列表（网格/列表，支持封面缩略图 + 右键 + 拖拽）
3. 右侧：项目检查器（v1 最小实现为只读信息展示）

11.1 新建项目（中栏工具栏）

操作步骤：

1. 进入 项目管理 工作区。
2. 点击中栏顶部 ＋ 新建项目。
3. 在弹窗 新建项目 输入 项目名称（默认 未命名项目）。
4. 确认后，成功会提示：项目「xxx」已创建。
5. 刚创建的项目会被自动定位并选中。

11.2 打开项目（双击/右键）

操作步骤（双击）：

1. 在中栏找到目标项目卡片/行。
2. 双击项目。
3. 系统会进入该项目的 Consumer 工作区（通常是影视工作区）并切换到该项目上下文。

操作步骤（右键）：

1. 右键项目。
2. 点击 打开项目。

注意：

1. 在 回收站 视图中，被软删的项目禁止打开，需要先还原。

11.3 项目右键：重命名/删除（软删）/永久删除/还原

重命名：

1. 右键项目 -> 重命名
2. 输入新名称确认。

删除（软删除，可恢复）：

1. 右键项目 -> 删除
2. 阅读确认：删除为软删除（可恢复），默认不做不可逆硬删除。
3. 确认后项目进入回收站视图。

还原（从回收站）：

1. 左侧进入 回收站。
2. 选中一个或多个项目。
3. 右键选择 还原（或“还原所选”一类入口，文案以实际为准）。

永久删除（不可恢复）：

1. 左侧进入 回收站。
2. 选中一个或多个项目。
3. 右键选择 永久删除。
4. 会展示预览并再次确认，确认后执行不可逆删除。

11.4 左侧：项目文件夹（分组）与拖拽归类

项目文件夹是“分组”，不等于删除项目本身。

操作步骤：新建文件夹

1. 在左侧 项目文件夹 分组上右键（或在空白处右键）。
2. 选择 ＋ 新建文件夹（或 ＋ 新建子文件夹，视当前是否点在某个文件夹上）。
3. 输入名称（默认 未命名文件夹）并确认。

操作步骤：重命名/删除文件夹

1. 右键某个文件夹。
2. 选择 重命名 或 删除。
3. 删除文件夹通常只移除分组，不删除项目（会有确认提示）。

操作步骤：把项目拖进文件夹（归类）

1. 在中栏选中一个或多个项目。
2. 拖拽到左侧目标文件夹上。
3. 状态栏会提示类似：移动到: {文件夹名}（归类）
4. 释放鼠标完成归类。

操作步骤：文件夹树内拖拽重排（文件夹上下级/顺序）

1. 在左侧拖拽文件夹到新的位置（父子级或同级排序）。
2. 松开后会自动回写存储并刷新。

11.5 最近项目

左侧 最近项目 的行为：

1. 打开过的项目会进入最近列表（用于快速进入）。
2. 若某项目不在最近列表但仍存在，系统也可能允许显示但不会强行追加，避免污染“最近”视图。

11.6 项目管理与影视/生成/任务的关系（你需要的最短路径）

最短路径建议：

1. 先在 项目管理 创建项目。
2. 双击项目进入 影视，在分镜里组织内容与提示词。
3. 在影视里用 图片生成/视频生成 批量提交，或点 生成… 跳到 Genesis 生成区继续精调。
4. 去 任务中心 做全局追踪与失败处理。

12. 统一回收站（Trash Center）完整使用教程

入口：

1. 顶栏回收站按钮（若提供独立按钮）。
2. 或通过工作区切换进入 回收站 工作区。

统一回收站是“跨工作区聚合”的软删记录中心，支持：

1. 按范围筛选（scope）
2. 按实体类型筛选（entity_type）
3. 还原/永久删除/清空当前范围

10.1 基础概念：范围与恢复目标

回收站表格列包含：

1. 删除时间
2. 工作区
3. 类型
4. 名称
5. 实体ID
6. 项目ID
7. 恢复目标

你恢复前要确认两点：

1. 你当前筛选范围是否正确（避免误恢复/误清空）。
2. 恢复目标 是否符合预期（例如恢复到哪个项目/文件夹）。

10.2 还原（当前范围）

操作步骤：

1. 在左侧选择需要的筛选（例如 全部 或其他范围）。
2. 在列表中勾选/选择要还原的记录（或使用“当前筛选范围还原”）。
3. 右键菜单选择 还原所选 n 条，或选择 还原当前筛选范围。
4. 阅读确认弹窗：将还原 n 条回收站记录。
5. 确认执行。

10.3 永久删除/清空（高风险）

永久删除所选：

1. 选择若干记录。
2. 右键选择 永久删除所选 n 条。
3. 确认后不可恢复。

清空当前筛选范围：

1. 右键选择 清空当前筛选范围 或左侧菜单项 清空回收站（当前范围）。
2. 阅读弹窗：将清空 xxx 回收站，且无法恢复。
3. 确认后执行。

13. 空间清理（GC Management）完整使用教程

入口：

1. 顶栏 查看 -> 空间清理器
2. 或工作区切换到 空间清理

该工作区用于“扫描/清理磁盘占用”，包含：

1. 空间概览（metrics）
2. 一键动作按钮（仅扫描/立即执行/保守清理缓存/保守清理临时/清理内部暂存区）
3. 快速打开目录
4. 计划任务管理

11.1 建议流程（官方推荐）

1. 先点 仅扫描：只生成候选清理清单，不做真实删除。
2. 观察扫描结果与空间概览。
3. 再点 立即执行（扫描+清理）：执行 scan -> sweep。

11.2 仅扫描

操作步骤：

1. 进入 空间清理 工作区。
2. 点击 仅扫描。
3. 等待完成提示（会显示 run_id）。
4. 若失败会弹窗：空间回收扫描失败。

11.3 立即执行（扫描+清理）（有确认弹窗）

操作步骤：

1. 点击 立即执行（扫描+清理）。
2. 阅读确认弹窗，确认你理解这是“真实清理”（非 dry-run）。
3. 确认后执行。
4. 观察完成提示或失败弹窗。

11.4 保守清理缓存 / 保守清理临时

这两项是“直接清指定目录，不生成 run”：

1. 保守清理缓存：范围 cache/derived
2. 保守清理临时：范围 tmp/exports + tmp/outputs_legacy

操作步骤（以缓存为例）：

1. 点击 保守清理缓存。
2. 阅读确认弹窗（会提示范围）。
3. 确认后执行。
4. 完成后会提示 deleted/failed/bytes。

11.5 一键清理内部暂存区(.gc_trash)

这是“直接清理内部暂存区”的入口，属于高风险动作：

1. 点击 一键清理内部暂存区(.gc_trash)。
2. 阅读确认弹窗并确认。
3. 成功会提示 count/bytes；失败会提示原因。

11.6 快速打开目录

按钮包括：

1. 打开存储根目录
2. 打开 CAS
3. 打开缓存
4. 打开临时
5. 打开内部暂存区(.gc_trash)

操作步骤：

1. 点击对应按钮。
2. 若目录不存在，会尝试创建或打开上级目录，并在状态栏提示。

11.7 计划任务管理（创建/启用/禁用/删除）

按钮包括：

1. 刷新任务状态
2. 创建默认计划任务
3. 启用全部任务
4. 禁用全部任务
5. 删除全部任务

操作步骤：创建默认计划任务

1. 点击 创建默认计划任务。
2. 阅读确认：会创建 3 个默认 GC 计划任务（每日、低空间、每周 CAS）。
3. 确认后创建。

删除计划任务是高风险：

1. 点击 删除全部任务。
2. 会二次确认：删除后不会自动执行周期 GC。
3. 确认后删除。

14. 问题反馈（本地反馈包 + 可选远端提交）

入口：顶栏 帮助 -> 问题反馈

反馈窗口字段：

1. 问题类型：启动问题/登录问题/更新问题/生成问题/积分/账单问题/其他
2. 标题
3. 详细描述
4. 联系方式（可选）
5. 截图（可选，多图）
6. 附带最近日志（推荐）

提交步骤（建议按这个写，支持人员最快能定位）：

1. 选择 问题类型。
2. 标题里写“现象 + 错误码/关键字”，例如：更新检查一直失败，提示 DIST_001。
3. 详细描述按 3 段写：
4. 复现步骤（1,2,3…）
5. 期望结果
6. 实际结果（含错误提示原文）
7. 需要的话点 选择截图… 选 1~多张截图。
8. 勾选 附带最近日志（推荐）。
9. 点击 提交反馈。

提交后你会得到：

1. 若远端发送成功：提示“反馈已发送成功”，并给出 本地备份目录。
2. 若远端不可用：提示“远端反馈暂不可用，已保存本地反馈包”，并要求你把该目录发送给支持人员。

版本与渠道来源（你排查环境时用得到）：

1. 版本优先从环境变量 MC_GENESIS_VERSION/GENESIS_VERSION/MC_DESKTOP_VERSION 读取。
2. 渠道从 MC_RELEASE_CHANNEL 读取，默认 beta。

15. 常见问题与排障（按症状查）

13.1 我看不到模型/线路下拉没有可选项

按顺序排查：

1. 打开 设置 -> AI 能力，确认已配置有效密钥或可用渠道。
2. 打开 设置 -> 网络 / 代理，确认网络可访问远端 API（直连优先）。
3. 回到生成区切换模型；若提示“该线路不支持当前模型”，说明你手动锁定了不兼容线路，切回自动或换线路。

13.2 任务成功了但无法复制链接/路径/打不开资源管理器

典型原因是“尚未重新入库”：

1. 对任务右键，先点 🔄 重新入库。
2. 等入库成功后再点 复制入库后链接/复制文件路径/在资源管理器中打开（内部）。

13.3 导出副本找不到/菜单灰掉

1. 设置里确认开启 生成后自动导出副本。
2. 在任务右键菜单查看“导出副本”项是否出现。
3. 若显示“导出失败”，点 重新导出副本。

8.9 全局 Quick Dock（悬浮生成按钮 + 快速提交）

Quick Dock 是覆盖在主窗口之上的“全局悬浮生成入口”，核心能力：

1. 在任意工作区快速打开生成面板（图片/视频 Tab）。
2. 支持绑定目标（例如影视的 Shot），让生成任务自动带上来源上下文。
3. 支持“最近绑定”列表与一键清空。

#### 8.9.1 打开/关闭悬浮生成按钮

操作步骤：

1. 点击顶栏 视图。
2. 勾选 显示悬浮生成按钮。
3. 此时主窗口中心区域会出现一个小的悬浮按钮（文案通常为 生成）。
4. 再次取消勾选可隐藏悬浮按钮与 Dock。

#### 8.9.2 打开 Quick Dock 面板

操作步骤：

1. 点击悬浮按钮 生成。
2. 弹出 Quick Dock 面板。
3. 面板包含两个 Tab：图片、视频（左侧面板复用生成工作区的输入 UI，尽量一致）。

#### 8.9.3 Target（绑定目标）与最近绑定

面板顶部会显示 Target 行：

1. 未绑定时显示：未绑定
2. 已绑定时显示：绑定对象名称（例如某个 Shot 名称）

右侧边栏为 最近绑定：

1. 若没有绑定，会显示：暂无绑定
2. 在绑定条目上右键，可执行：
3. 移除绑定
4. 清空全部绑定

右侧边栏可折叠：

1. 点击 收起侧栏 可折叠
2. 折叠后按钮会变为 展开侧栏

#### 8.9.4 从影视绑定到 Quick Dock（最常用）

操作步骤：

1. 进入 影视 工作区。
2. 在分镜列表中勾选一个或多个 Shot。
3. 点击底部 绑定生成。
4. Quick Dock 会出现绑定，并可直接在 Dock 内切换 图片/视频 提交。

#### 8.9.5 载入绑定参数（覆盖提示）

当你的 Dock 面板里已经改过参数，再尝试“加载绑定参数”时，会提示：

1. 当前 Dock 参数已修改，加载绑定参数将覆盖现有内容。是否继续？

建议操作：

1. 你已精调过参数：选“取消”，避免覆盖。
2. 你想以绑定对象为准：选“继续”，让参数回到绑定对象的推荐输入。

#### 8.9.6 不绑定目标直接提交（会二次确认）

当你在 Dock 里没有任何绑定却尝试提交时，会提示：

1. 未绑定目标
2. 本次生成不绑定任何目标（不会进入任何工作区未分类桶）。是否继续？

建议：

1. 能绑定就先绑定（尤其影视 Shot 流程）。
2. 确实是全局临时任务再继续提交。

#### 8.9.7 目标失效（必须重新绑定）

如果绑定的目标被删除/移入回收站/不在当前项目或无权限，会提示 目标失效，并阻止提交：

1. 目标节点不存在或已被删除，请重新绑定。
2. 目标节点已移入回收站，请重新绑定。
3. 目标不在当前项目或无权限访问，请重新绑定。

#### 8.9.8 提交后跳转任务中心

提交成功后可能会弹窗：

1. 已提交
2. 任务已创建。是否打开 Task Center？

操作建议：

1. 需要立即追踪状态：点“是/确定”进入任务中心。
2. 继续批量提交：点“否/取消”，留在 Dock。

13.4 资产库里粘贴提示“请先进入一个自定义文件夹视图”

你当前不是“自定义文件夹”视图：

1. 在左侧资产库树中点进某个自定义文件夹。
2. 再执行 Ctrl+V 粘贴。

13.5 空间清理会不会删掉我需要的文件

结论：会，取决于你点的是哪一个按钮。

1. 仅扫描：不会删，只生成候选清单。
2. 立即执行（扫描+清理）：会按策略删除/移动文件（真实清理）。
3. 保守清理缓存/临时：会直接清指定目录。
4. 一键清理内部暂存区(.gc_trash)：会直接清理内部暂存区。

如果你不确定：

1. 先只点 仅扫描。
2. 需要清理时，从 保守清理缓存/临时 开始，不要直接做全量清空。

16. 附录：菜单速查表

文件：

1. 文件 -> 导入 -> 文件…
2. 文件 -> 导入 -> 文件夹…

查看：

1. 查看 -> 资产库管理器
2. 查看 -> 空间清理器
3. 查看 -> 轮询诊断（默认隐藏）

视图：

1. 视图 -> 重置当前工作区布局
2. 视图 -> 重置全部布局
3. 视图 -> 显示悬浮生成按钮

帮助：

1. 帮助 -> 检查更新…
2. 帮助 -> 使用教程
3. 帮助 -> 故障排查
4. 帮助 -> 问题反馈
5. 帮助 -> 关于…