fasthtml-desktop

业务系统常常既要现代 Web 界面，又要以原生桌面应用交付，而不是让用户在浏览器里打开一个网址。从零搭 FastHTML、套 pywebview 壳、再走到可发布的 EXE，步骤多、文档杂，Agent 也容易在 FastAPI 与 FastHTML 语法之间踩坑。fasthtml-desktop 把这条链路收成一套可复现的 Agent Skill，让助手按固定工作流从需求澄清一路做到打包交付。

技能以 FastHTML（Starlette + HTMX）写界面，用 pywebview 提供原生窗口与 WebView2 渲染，本地 HTTP 服务承载应用逻辑。写码前有权威文档 HARD-GATE（官方 FastHTML 上下文），examples 里提供 FastOffice 套件 25 个参考实现，覆盖 ERP、财务、HRM、BI 等真实业务场景。质量侧包含路由联动检查、引用检查、无头 UI 验证与 release gate，降低「能跑但发不出去」的风险。

打包以 PyInstaller 产出含原生窗口的 Windows EXE 为主，并配套 Windows / macOS / Linux 构建脚本。适合需要在 Harness 或支持 Agent Skills 标准的助手里，用一句话触发「做带 Web 界面的桌面程序并打包」的团队与个人；若你更倾向纯 Tkinter 原生方案，可对比同系列的 tkinter-desktop。