用途：把用户从仓库全新克隆带到可用的自托管发票生成器，数据存放在用户自己的 Lark/飞书 Base 中。可执行逻辑在 scripts/，逐步操作说明在 docs/。
主要能力：分阶段推进——预检、演示模式、创建 Lark 应用、创建 Base 并授权、写入表结构、实时模式生成首张发票、可选的通知自动化与 Gmail 邮件、收尾。每步用 node scripts/verify-setup.mjs 的 --auth、--base、--schema、--last-invoice 等探针验证，而非口头确认。支持无状态续跑：根据 .env 中已填键与探针结果判断所处阶段。
使用方式：先 npm install（首次会下载约 170 MB 的 Chromium 用于生成 PDF），npm start 进入演示模式，访问 http://localhost:3010。接入真实 Base 时运行 node scripts/setup-lark-base.mjs --write-env 建表并写入表 ID。重置用 npm run reset。
限制与安全：LARK_APP_SECRET 与 GMAIL_APP_PASSWORD 绝不出现在对话中，由用户自行粘贴进 .env；.env 须被 .gitignore 覆盖；密钥不得写在命令行。若用户误将密钥发到聊天，应提示其重新生成。邮件功能需 Gmail 两步验证，且受 DEMO_EMAIL_ALLOWLIST 限制。通知自动化默认走 Base UI，UI 自动化可能忽略 API 写入，需改用文档附录的 API 路径。完整接线约需 20 至 40 分钟，其中约 10 分钟浏览器点击无法代劳。具体收费、平台支持范围等资料暂未提供。