会议室与访客登记小助手

你是一名擅长本地桌面小工具的资深工程师。请帮我做一个本地运行的桌面小工具，用户是公司行政 / 前台同事，关注业务结果和操作体验。

【目标】

把"会议室预订 / 访客登记 / 快递签收"三件高频小事集中到一个台账，减少行政被打断的次数。

【平台与技术】

- Windows 10/11 桌面应用
- Electron + React + TypeScript
- 本地 SQLite
- 完全离线，打包成 Windows .exe 安装包

【核心功能】

左侧三个标签页：会议室 / 访客 / 快递。右侧主内容区按标签切换。

【会议室页】
1. 顶部日期选择（默认今天）+ 会议室筛选器。
2. 主区是横向时间轴（8:00 - 20:00），每间会议室一行。空闲格浅灰；占用格有色块，显示主题 + 组织人 + 时段。
3. 点空闲格弹出"新建预订"表单：主题、组织人、起止时间、人数、备注。
4. 支持拖拽改动时段；冲突时高亮提示。
5. 列表视图可切换，方便打印。

【访客页】
1. 今日到访表：访客姓名、来自公司、被访人、预计时间、实际到达时间、离开时间、备注。
2. "新增访客"表单；到访时点一下切成已到；离开时点一下切成已离。
3. 快速搜索（姓名 / 公司）。

【快递页】
1. 今日签收表：收件人、快递公司、单号、签收时间、领取状态。
2. 新增 / 快速勾选"已领取"。
3. 未领超过 3 天的快递高亮提示。

【通用功能】
- "打印今日日程"按钮：一键生成 A4 PDF（含三块今日汇总），方便前台贴墙。
- "导出今日到 Excel"按钮，存档用。
- 所有数据本地保存。

【界面风格】

- 简洁商务，柔和色块；色不刺眼。
- 时间轴密度适中，点击区域足够大。
- 深浅模式跟随系统。

【稳健性】

- 时间冲突友好提示而不是冷冰冰报错。
- 空状态引导："今日暂无 XX"。
- 数据库损坏自动恢复。

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

【项目结构】
├── src/main/          # Electron 主进程（main.ts, preload.ts）
├── src/renderer/      # React UI（pages, components, hooks）
├── src/core/          # 纯业务逻辑（可独立测试，不依赖 Electron）
├── src/types/         # TypeScript 类型定义
├── sample-data/       # 脱敏示例数据（启动即可跑通主流程）
├── scripts/           # dev / build / package 脚本
├── docs/              # 使用说明 + 已知限制
└── package.json       # 入口、脚本、依赖

【错误自救】
遇到问题时按以下策略处理，不要反复尝试同一方法：
- 依赖安装失败 → 检查包名拼写，尝试降一个大版本，或换 --legacy-peer-deps
- TypeScript 报错过多 → 先用 any 跑通主流程，再逐步补类型
- Electron 白屏 → 检查 preload 路径、CSP 策略、console 报错
- 打包失败 → 先确认 dev 模式完全正常，再排查打包配置
- 样式错乱 → 检查 CSS 加载顺序和选择器优先级
- 同一错误 3 次 → 换方案或降级该功能，不要死磕

【交付】
1. 摘要需包含三个标签页安排。
2. 分三步：会议室 -> 访客 -> 快递（每一步都能独立跑）。
3. 打包 Windows .exe，附 500 字中文使用说明。

验收清单（全部通过才算完成）：
□ 双击 .exe 启动，左侧三个标签：会议室 / 访客 / 快递
□ 会议室页：时间轴显示今日预订 → 点空闲格新建 → 拖拽改时段
□ 访客页：新增访客 → 一键标记已到/已离 → 搜索
□ 快递页：新增 → 勾选已领取 → 超3天未领高亮
□ "打印今日日程" → 生成 A4 PDF
□ 时间冲突、空数据 → 友好提示，不闪退

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

【快速启动协议】
收到提示词后立即按以下顺序执行，不要先输出方案等确认：
1. 创建项目目录，初始化 package.json + tsconfig.json
2. 安装核心依赖：electron, react, react-dom, typescript, @types/react
3. 写最小 main.ts（创建窗口）+ index.html + renderer 入口，确认窗口能弹出
4. 创建 sample-data/ 目录，放入贴近业务的脱敏示例数据
5. 按功能逐个实现，每完成一个功能立即运行验证
6. 最后补文档、打包脚本、使用说明

【桌面交付契约】
- 交付本地可运行应用，不是方案；第一屏就是主工作台。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、空函数、未用大组件或假数据当完成。

【反模式清单 — 以下行为禁止】
- 写空函数体或 TODO 注释当完成
- 用假数据渲染 UI 却不接通真实逻辑
- 不安装依赖就开始写 import
- 一次性写完所有代码再运行（应逐功能验证）
- 报错后反复尝试同一方案超过 3 次
- 用 console.log 代替真实的错误处理 UI
- 忽略空状态和加载状态

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