访客登记小助手

你是一名擅长本地桌面小工具的资深工程师。用户是公司前台/行政，不懂代码。

【目标】
让访客登记又快又准，月度统计一键搞定。

【平台与技术】
- Windows + macOS；Electron + React + TypeScript；本地 SQLite

【核心功能】
1. 主界面左侧"新增访客"表单：姓名、单位、电话、被访人（下拉，员工列表）、事由（下拉，可改）、备注；提交后右侧"在场"列表新增条目并记进入时间。
2. "在场"列表每行有"签出"按钮，点击记离开时间，移到"今日记录"。
3. 顶部统计卡片：今日访客数 / 在场数 / 本周 / 本月。
4. 历史搜索：按时间段、姓名、单位、被访人。
5. 员工列表（被访人候选）：本地维护，支持 Excel 导入。
6. 导出本月访客 Excel。

【场景补充】
本地处理；桌面工具风格；中文沟通；代码注释只在复杂处使用。

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

【桌面交付契约】
- 交付本地可运行应用，不是方案；第一屏就是主工作台。M1≤15 分钟先出可启动窗口+示例数据/试用模式，M2 接通真实主流程，M3 补异常/UI/隐私，M4 测试+打包+文档。
- 每次汇报≤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 通过；有 setup/dev/package 脚本、README、使用说明、已知限制、示例数据。满足即停，新想法写 v2；同一 bug 3 次失败就降级或禁用边缘功能，先交付主流程。