LumenZ产品系统

1、立项原因：微短剧与短视频需求爆发，但创作工具链高度割裂——剧本写在文档里、人物设定散落在聊天记录、分镜靠表格、出图与配音要分别登录不同平台、成片再进剪辑软件，一条 30 秒短片往往要跨越 5 个以上工具。素材版本与人物一致性极易失控，创作者大量时间花在搬运与返工上，而不是创作。本项目立项正是为解决"从主题到成片"缺少统一工作台这一产品问题：把剧本、分镜、角色、画面、配音、合成的生成过程收敛到一张可编排、可回溯、可恢复的桌面画布，让非专业用户也能按流水线稳定产出成片。
2、行业场景与业务背景：主要面向微短剧制作团队、品牌电商短视频运营、知识科普与自媒体剧情号创作者。行业工序为"主题立意→章节脚本→分镜表→角色设定→分镜图→配音→分镜视频→合成成片"，属上下游强依赖的串行生产：上游文案一改，下游画面与配音就要整体重算。普遍痛点是算力成本与成片质量难以兼顾、外包沟通成本高、周期长、协作时资产找不到版本。LumenZ 以节点图显式表达工序依赖，用算力路由按质量档自动选择本地模拟或外接大模型服务，用统一工程文件沉淀过程资产，切入"个人与中小团队需要低成本、可复用、可交付"的市场空档。

1、功能模块：首页与模板库、无限画布、节点参数面板、Skills 技能中心、算力中心、任务中心、工程文件与自动保存、撤销重做与命令面板、资产库、Agent 助手、设置与帮助，共十一个模块。
2、主要功能：
（1）首页与模板库：内置 AI 短剧八段流水线、30 秒科普、60 秒情感、15 秒电商四套模板，一键生成画布骨架；最近项目支持打开、重命名、复制、导出、删除与拖拽导入。
（2）无限画布：六类节点（文本/图片/视频/音频/脚本/分组）可增删改连与就地编辑；六种语义连线带合法性校验与中文标签；节点八态可视化；支持框选、对齐、打组、自动布局、小地图与 10%–400% 缩放。
（3）节点参数面板：编辑画面描述并插入上游引用芯片，实时预览拼装后的最终提示词，给出可提交/缺必填/上游未就绪三态，估算算力消耗。
（4）技能中心：查看说明、DAG 预览与默认参数，一键实例化为画布节点与语义边。
（5）算力中心：管理本地模拟与 OpenAI 兼容 Provider，配置能力、测试连接、录入密钥，按任务类型与质量档路由，统计用量与成本。
（6）任务中心：统一排队调度，按 CPU 自适应并发，支持暂停/恢复/取消/重试，展示进度与失败原因，取消后清理半成品。
（7）工程与可靠性：单文件容器内含清单、图数据、资产与日志，原子写入；内存态 + WAL 日志 + 定时快照三层自动保存，异常退出可恢复。
（8）其他：200 步撤销重做、Ctrl+K 命令面板、全局快捷键、七分组设置与深浅主题、新手引导。

1、我负责的具体任务：本项目由我独立完成研发。（1）需求与规格：编写需求与架构文档，拆解 16 个任务、15 条验收标准。（2）主进程：单实例锁、窗口状态持久化、托盘、CSP 与白名单 IPC。（3）核心算法：图操作纯函数库、语义连线校验矩阵、八态状态机、提示词拼装、200 步撤销栈。（4）工程容器：ZIP 打包解包与路径穿越、炸弹防护，原子写入、WAL 日志与 CRC32 校验重放、快照与崩溃恢复。（5）算力调度：Provider 适配层（本地模拟、OpenAI 兼容，含超时、取消、退避、熔断、半开探测）、路由热切换与任务队列。（6）渲染层：React Flow 画布与自定义节点边、Tiptap 富文本与引用芯片、Zustand 状态分层、七个页面。（7）质量交付：37 个测试文件 483 条用例、覆盖率与色值门禁、Playwright 冒烟、500 节点性能基线、NSIS 打包。
2、技术栈与架构：Electron 33 + React 18 + TypeScript strict + Vite + Zustand/Immer + React Flow 12 + Tiptap + Zod；按主进程、预加载、渲染层、共享层四层切分，UI 与重计算分离，跨进程数据经 Zod 校验。亮点与难点：① 500 节点 800 边 130fps、冷打开 533ms，靠视口虚拟化、节点 memo、身份缓存与缩放订阅拆分；② 崩溃率低于 1%，靠 WAL 行级 CRC32 校验、前缀重放与快照兜底，故障注入 5 次恢复零丢失；③ 单文件工程用 ZIP store 容器承载图数据与日志，做条目白名单与炸弹阈值校验；④ 模型接入不可靠，用适配器统一流式事件、取消信号、退避与熔断，热切换不影响运行中任务；⑤ 设计 token 白名单与门禁脚本保证视觉一致，状态机/