---
url: /docs/agentbuff-stack/refactor-validation-2026-10-09.md
---
# 官网与独立项目改造验收

日期：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 再生成。两站分别完成：

1. 首次干净安装，再执行锁文件固定安装。
2. 离线配置诊断与产品构建。
3. 在专门新建的本地空数据库执行初始化迁移；没有操作生产数据库。
4. 独立注册、登录会话、保存结果历史、密码恢复邮件捕获。
5. 混合两站 Cookie 后仍分别识别自己的用户；Alpha 的 Cookie 无法登录 Beta。
6. 两站历史数据和邮件记录分别保存；停止 Alpha 后 Beta 接口仍可访问，Alpha 能重新启动。

每站使用独立本地数据库和新生成的认证 secret，没有复制原站私有环境。没有发送外部邮件或进行真实支付。这两个站是生成器验收样例，不是已验证需求或上线案例。

## 界面验收

桌面检查了哑光浅深主题、滚动导航、官网跳转独立演示、博客搜索与分类、文章详情和案例空状态。独立演示保留已有账号与历史，JSON 处理、预览和实际下载内容一致。

手机布局使用真实 390 与 320 像素 iframe 视口验收：没有横向溢出，导航切换到手机菜单，展开内容完整，键盘 Escape 可以关闭。浏览器视口覆盖接口未改变实际尺寸，因此没有把该接口调用当作手机验收依据。

## 自动检查

全仓库类型检查、两个 Astro 应用检查、lint、格式检查、产品与官网构建、中文文档构建均通过；19 个测试文件中的 133 项现有回归与新增行为测试通过。详细命令：

```sh
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、异步任务、积分包等按实际产品需求推进。