官网与独立项目改造验收
日期：2026-10-09。范围为改造计划的首轮四阶段：官网边界、案例与内容、独立演示及预览、新站生成器。真实产品选题、真实上线案例和商业售卖仍是后续工作。
架构与内容
- 官网在
apps/website，不导入产品配置或连接产品 API、数据库；现有产品架构保留。 - 导航、主题脚本、文章卡片与公共排版在
packages/ui/marketing，由应用传入展示数据。 - 官网首页、功能、案例、官方博客、定价与中文文档入口可访问。定价没有用户订阅套餐或虚构购买入口。
- 临时案例集成验收确认：已发布案例生成首页、列表、详情与 sitemap；案例草稿不生成公开详情或 sitemap；文章草稿不进入详情、列表、RSS 或 sitemap；缺截图构建失败。
- 验收发现并处理 Astro 空目录的旧记录缓存问题；删除全部案例后，构建恢复空状态，旧详情及链接消失。临时记录与素材已移除，没有作为真实产品发布。
- 案例路径由小写文件名确定；忽略额外 frontmatter slug，非法文件名构建失败，避免路径出现两个配置来源。
独立预览与生成
官网为 localhost:4400，产品演示为 localhost:4410，中文教程为 localhost:4406。产品入口与内部服务端口集中于 preview.config.json。
生成器采用明确目录，排除官网、案例、官网文章、私有环境、本地数据、依赖、缓存与 Git 历史。验证了目标目录保护、无效域名和端口、带引号品牌名、Worker 与绑定更新、从已生成站再生成第二站、来源 revision 保留。
另外从当前源生成两个独立验收项目 Alpha（4710）与 Beta（5710），其中 Beta 从安装后的 Alpha 再生成。两站分别完成：
- 首次干净安装，再执行锁文件固定安装。
- 离线配置诊断与产品构建。
- 在专门新建的本地空数据库执行初始化迁移；没有操作生产数据库。
- 独立注册、登录会话、保存结果历史、密码恢复邮件捕获。
- 混合两站 Cookie 后仍分别识别自己的用户；Alpha 的 Cookie 无法登录 Beta。
- 两站历史数据和邮件记录分别保存；停止 Alpha 后 Beta 接口仍可访问，Alpha 能重新启动。
每站使用独立本地数据库和新生成的认证 secret，没有复制原站私有环境。没有发送外部邮件或进行真实支付。这两个站是生成器验收样例，不是已验证需求或上线案例。
界面验收
桌面检查了哑光浅深主题、滚动导航、官网跳转独立演示、博客搜索与分类、文章详情和案例空状态。独立演示保留已有账号与历史，JSON 处理、预览和实际下载内容一致。
手机布局使用真实 390 与 320 像素 iframe 视口验收：没有横向溢出，导航切换到手机菜单，展开内容完整，键盘 Escape 可以关闭。浏览器视口覆盖接口未改变实际尺寸，因此没有把该接口调用当作手机验收依据。
自动检查
全仓库类型检查、两个 Astro 应用检查、lint、格式检查、产品与官网构建、中文文档构建均通过；19 个测试文件中的 133 项现有回归与新增行为测试通过。详细命令：
bun typecheck
bun web:check
bun website:check
bun run test -- --run
bun lint
bun format:check
bun preview:build
bun docs:build后续边界
首个真实产品仍需根据实际关键词、竞品与可交付性证据确定，再做独立业务与线上验收。Cloudflare、Neon、OAuth、Stripe 和真实发信不因本地验收而视为上线完成。R2、异步任务、积分包等按实际产品需求推进。