系统架构

前端采用 React、TypeScript 与 Vite，Supabase 承载任务记录和文件，Python Worker 执行耗时的模型调用。提交、查询与生成分离，任务执行不依赖浏览器持续连接。

产品入口：统一组织赛事配置、赛题输入与任务流程。

输入解析与赛事路由

PDF 解析按需加载 pdfjs-dist 及其 Worker，逐页提取文字层，合并文本并归一化空白字符；扫描件识别不在此解析路径内。

contest 标识控制语言和章节模板。judgeTrack() 分别统计数据驱动与机理、优化信号，返回命中词、判断结果及依据；信号数量相同时，以数据附件线索判定。buildOutline() 接收赛事配置与判断结果，生成对应的论文骨架。

赛事配置：同一标识驱动语言、章节与界面提示。

任务协议与状态流

前端生成 UUID，将赛题 PDF 和附件上传至任务输入目录，成功后一次写入 jobs。任务行保存赛事、题目文本和文件路径；Storage 保存文件内容。上传前限制单文件大小并清洗文件名，任一上传失败即停止提交。

输入解析 → 文件上传 → jobs（pending）
                     → Worker（running）
                       ├─ 上传成果 → done
                       └─ 记录错误 → failed

status 记录生命周期，stage 记录当前阶段。任务 ID 存入 localStorage，用于刷新后的恢复查询；非终态任务定时轮询，完成或失败后停止。

演示工作区用于呈现输入与流程；真实任务状态读取 jobs 记录。

阶段编排与模型调用

Worker 按创建时间顺序读取待处理任务，将前一阶段输出传入下一阶段，逐步形成分析、推导与文稿。

统一的 chat() 封装模型请求，配置从运行环境读取，支持超时控制、最多三次尝试和递增等待。最终异常写入任务失败状态，供前端查询。

公开 Worker 的 P4 负责结构扫描，python-docx 将标题、列表和段落映射为 Word 样式。求解代码执行、图表生成与精细排版由配套建模 Skill 另行组织，结构扫描与数值验证分别处理。

阶段定义：明确输入、产物与推进条件。

交付与异常处理

Word 文件生成并上传成功后，Worker 才回写结果路径并将任务置为完成。前端按需申请有有效期的签名链接，任务查询仅返回状态与文件引用。

失败记录保留错误信息，重新提交创建新任务。公开实现采用顺序消费与请求级重试，通过任务 ID 关联输入、阶段、异常和成果。