mesop-to-lit 用于评估并把 Mesop(Python)应用迁移为 FastAPI JSON 后端加 Lit 单页应用(由 Vite 构建),默认界面库为 Web Awesome;Material 3(@material/web)仅在用户明确要求时才作为可选方案。技能分两部分。
评估(assess):运行自带的确定性分析脚本,脚本仅依赖 Python 3 标准库,可处理较大应用,解析失败不会硬崩溃。脚本默认目标界面为 Web Awesome,可通过参数指定 Material Web,输出 JSON 与 Markdown 报告,涵盖服务模型(纯 WSGI 或 FastAPI 混合)、路由注册情况、状态字段分类、服务层与模型层是否已与 Mesop 解耦、重复组件、构造清单与难点(上传、IAP/认证、Firestore、Cloud Tasks 等)、逐页难度以及依赖漂移。评估还依据构造映射与组件决策流程判定每个组件采用现成库、组合还是自定义,并按 DRY 原则合并重复组件,同时给出状态与传输方案、端点面、部署差异和风险清单。
实施(assist):按评估结果逐切片推进。先搭建 FastAPI 主程序与 Vite/Lit 前端目录,复制应用原有的服务、模型和配置并确认其中没有导入 Mesop;用 pytest 验证后端,用 vite build 验证前端外壳。随后为每个真实服务方法派生一个路由,定义请求与响应模型和错误信封,薄路由只做校验、调用未改动的服务、适配返回。组件按叶子到组合顺序构建,包括强制使用 marked 与 DOMPurify 的 markdown 组件、原生 textarea 的提示输入、手风琴、结果清单、页头与导航、页面和根壳。测试阶段在客户端边界模拟 LLM 调用,后端使用 FastAPI TestClient,前端使用 Vitest 与 @open-wc/testing-helpers,可选 Playwright 端到端测试。完成标准是 pytest、vitest run 和 vite build 全部通过。部署方面提供多阶段 Dockerfile、WSGI 转 ASGI、保留超时与端口、CSP/frame-ancestors 等指引。
适用场景为需要把 Mesop 应用迁移到更快前端技术栈的工程任务;限制是流程包含较多手工构建与测试环节,并非全自动转换,且具体收费、平台支持等信息暂未提供。