Genesis 使用教程

基于 MooncastarGenesis 实际代码实现整理(工作区、任务中心、资产生命周期)。

文档版本:v1.0最后更新:2026-02-22Product: Genesis Desktop

1. 快速启动

按代码入口启动桌面应用,自动拉起本地后端与 worker。

  • 桌面端入口为 run_desktop.py,执行后会进入 desktop.pyqt_app.app.run_desktop。
  • 启动阶段会执行 bootstrap_on_startup、自动检查/创建数据目录,并在需要时拉起本地后端。
  • 后台 worker 以 detached 方式启动,UI 退出不会中断已提交任务。
  • 当服务端不可达时会进入受限离线模式,远程登录/积分等能力可能不可用。

2. 工作区导航

顶部快捷区默认提供资产、生成、影视、任务,以及独立回收站入口。

  • 默认进入生成工作区(workspace_id=generation)。
  • 内置工作区注册顺序包含:生成、任务中心、GC 管理、资产、影视、项目管理、回收站。
  • 快捷键:Ctrl+1/2/3/4 对应顶部快捷工作区;Ctrl+Tab / Ctrl+Shift+Tab 支持 MRU 切换。
  • 帮助菜单内置“使用教程”“故障排查”入口,可直接跳转官方 Help Center。

3. 生成工作区

生成工作区采用左中右结构,支持聊天、图片生成、视频生成、任务中心跳转。

  • 左侧贴边导航项:聊天、图片、视频、任务中心。
  • 图片模式支持:文生图、图生图、多图、组图;视频模式支持:文生视频、图生视频。
  • 模型与渠道可独立选择,支持“自动模式/实惠模式/指定线路”。
  • 点击“生成”后任务写入统一 TaskStore,并在中栏任务列表实时刷新。

4. 任务中心

任务中心提供左侧筛选、中栏列表、右侧详情,并支持回跳来源工作区。

  • 左栏可按“全部/最近任务/生成工作区任务/影视工作区任务/产品工作区任务”筛选。
  • 生成工作区任务支持继续细分为图片生成和视频生成。
  • 中栏支持“返回工作区”,从任务可单向跳回来源上下文。
  • 任务右键菜单支持刷新、复制 ID、打开/下载产物、重试工作流或失败节点等操作。

5. 资产生命周期与入库

生成成功即写入 CAS,入库按钮语义为“确认为正式资产”。

  • worker 成功后会将产物写入 CAS,并创建 asset_status=generated 的输出记录。
  • “入库(确认为正式资产)”仅在 generated/shortlisted 状态显示,执行后迁移为 committed。
  • outputs_legacy 仅作为可选中间态或导出副本,不作为资产事实源。
  • 系统会根据 workspace_id 将产物归入对应未分类桶,便于后续资产整理。

6. 故障排查与帮助入口

桌面端会带 app/ver/module/code 深链参数跳转帮助中心。

  • “帮助 -> 使用教程”跳转 /help,并携带 app=genesis、ver、module、code 参数。
  • “帮助 -> 故障排查”跳转 /help/troubleshooting,并附带错误上下文参数。
  • 建议排障时记录 workflow_run_id、错误码、模块名,再进入排障页检索。
  • 若涉及账号、会话、服务可用性问题,先检查 /status 与登录状态。