投放 ROI 每日速查

你是一名擅长 Windows 桌面软件的资深工程师。请帮我做一个本地运行的 Windows 小工具，使用者是电商公司市场部负责投放的同事，关注业务结果和操作体验。

【目标】

每天把各渠道的投放数据（花费、成单、销售额）录入一次，自动计算 ROI / CPA / 趋势，并生成可分享的每周日报。

【平台与技术】

- Windows 10/11 桌面应用
- Electron + React + TypeScript
- 本地 SQLite 存历史数据
- SheetJS 处理 Excel
- PDF 输出用成熟的本地库（如 pdf-lib）
- 完全离线，打包成 Windows .exe 安装包

【核心功能】

1. 首页三张大卡片：今日整体花费 / 销售额 / ROI，并显示较昨日的涨跌。
2. 第二区：今日各渠道详情（表格）。列：渠道、花费、曝光、点击、成单、销售额、ROI、CPA、与昨日对比（百分比，红涨绿跌）。
3. 数据录入：
   - 表单方式快速录入当日数据（日期 + 渠道 + 指标）。
   - Excel 批量导入。导入模板包含：日期 / 渠道 / 花费 / 曝光 / 点击 / 成单 / 销售额。
4. 周报生成：选择本周范围，一键生成 PDF 或 PNG 日报。内容包括：
   - 本周整体 ROI / 总花费 / 总销售额
   - 按渠道分布的横条图
   - 每日 ROI 走势折线图
   - 前三强渠道 / 后三弱渠道（文字点评位由 Codex 生成，但避免夸张）
5. 数据全部本地 SQLite。支持按日期 / 渠道筛选。

【界面风格】

- 简洁商务：白底、大数字、分块卡片。
- 强调排版节奏：大标题、次级标题、数字三个层级清晰。
- 图表使用细线、低饱和色，避免花哨。
- 中英字体跟随系统（Segoe UI / 微软雅黑）。

【稳健性】

- 空数据给空状态图和引导。
- PDF 导出失败给友好提示并回退到 PNG。
- 数据异常（如 ROI 为空）不应导致白屏，显示"暂无数据"。

【约束】
- 全部本地处理，数据不上传外部服务。
- 缺真实数据时先造脱敏 sample-data，不等用户提供文件才开工。
- 不引入不存在的 npm 包；不确定时先查 npm view。
- 不写死 API Key、绝对路径、个人邮箱或内网地址。
- 输出不覆盖原文件，冲突加时间后缀。
- 同一问题 3 次失败 → 降级边缘功能，先交付主流程。

【交付】
1. 摘要需包含首页、录入页、周报页安排。
2. 分三步：首页 + 录入 -> Excel 导入 -> 周报导出。
3. 打包 Windows .exe，写 500 字内使用说明。

验收清单（全部通过才算完成）：
□ 双击 .exe 启动，首页三张大卡片：花费 / 销售额 / ROI
□ 录入当日数据 → 表格显示各渠道详情 → 自动算 ROI/CPA
□ Excel 批量导入 → 按日期汇总显示
□ 生成周报 PDF/PNG → 可直接发群
□ 空数据、PDF 失败 → 友好提示，不闪退

【高质量交付补充】
若上文要求等待确认，改为：≤8 行摘要后直接实现、运行、修复、验证；只因真实文件、账号、证书或不可逆操作停下。

【桌面交付契约】
- 交付本地可运行应用，不是方案；第一屏就是主工作台。M1≤15 分钟先出可启动窗口+示例数据/试用模式，M2 接通真实主流程，M3 补异常/UI/隐私，M4 测试+打包+文档。
- 没有用户真实文件时，先创建贴近业务的脱敏 sample-data 并继续推进。
- 每个里程碑卡住时的降级策略：M1 卡住 → 换更简单的实现方式先出窗口；M2 卡住 → 先跑通核心 3 步，边缘路径后面补；同一问题 3 次失败 → 降级或禁用边缘功能，先交付主流程。
- 每次汇报≤6行：完成、验证、跳过原因、下一步+预计时间，让进度清楚。
- 用业务语言写按钮、错误和说明；支持拖拽+系统打开/保存；空/错格式/取消/无权限/大文件/重名冲突都友好处理，不暴露堆栈。
- 路径兼容中文、空格、括号、长路径和 Windows/macOS 分隔差异；Windows 快捷键用 Ctrl/Alt，macOS 用 Command/Option。
- 默认离线、本地处理；不覆盖原文件；不写死密钥、绝对路径、个人邮箱或内网地址。
- 项目分层：desktop shell / controlled API / UI / core / tests / sample-data / docs；IPC 白名单化，UI 不直接执行本地命令。
- 真实接线：导入、预览、生成/保存、导出、错误状态都可用；不把 TODO、空函数、未用大组件或假数据当完成。

【DoD / 停止 Vibe Coding】
完成标准（逐条检查，全部通过才停手）：
□ 能启动；示例数据跑通真实主流程并产生产物
□ 异常路径友好（空数据、错格式、取消、重名冲突 → 不闪退）
□ lint/typecheck/test/build 通过
□ 已用 sample-data 完成 启动 → 主流程 → 导出/保存 烟测，并记录结果
□ 有 setup/dev/package 脚本、README、使用说明、已知限制、示例数据
满足即停，新想法写 v2；同一 bug 3 次失败就降级或禁用边缘功能，先交付主流程。