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