---
url: /docs/agentbuff-stack/configuration-validation-2026-10-09.md
---
# 配置与模块文档验收 · 2026-10-09

本轮对照 MkSaaS 的公开模板介绍、网站配置和环境配置文档，未使用商业源码。

## 完成内容

* 类型化 `websiteConfig`：品牌、主题、登录、博客、公开统计、订阅、积分、历史与计划；`site` 保持兼容读取。
* Google / GitHub 共用 OAuth 组件，完整服务端凭据决定可用 provider。
* API 三入口通过 `parseEnv` 校验；错误只包含变量名及问题，不打印值。
* `config:check` 离线诊断、目标环境、变量组合、域名、范围及 `.env.example` 覆盖。
* 自有 VitePress 文档首页、技术栈、网站配置、环境变量、完整模块总览和模块指南。
* 新站工厂同时更新网站配置、manifest、Worker 名和品牌环境示例。

## 验证结果

类型检查、代码检查、Astro 检查、构建与 VitePress 构建通过。Vitest：13 个文件，115 项通过。

配置诊断正例通过；生产 / 开发不匹配与半组 GitHub 凭据返回非零，错误不包含测试 secret。用独立临时目录复制第二个站，验证品牌 ID、名称、Worker、manifest、环境示例与凭据 / 数据排除；复制后诊断通过，临时副本已删除。

构建独立配置变体，关闭博客和主题切换、默认暗色、启用带测试 token 的统计。检查真实静态 HTML：无博客链接与文章路径、sitemap 无博客、RSS 无条目、博客索引 noindex、无主题按钮、默认暗色字段及 beacon 存在。变体只写 `.local/qa/`；配置已恢复默认，公共预览未加载测试 beacon。

真实 Better Auth handler 测试：禁用密码拒绝注册且不写用户；禁用 OTP、Passkey 与订阅后对应端点返回 404。

## 未验收

Google / GitHub 真实授权、Passkey 真实设备注册、生产邮件、Stripe 沙箱、统计数据、Cloudflare / Neon 部署。R2、队列、AI、管理员、newsletter、Turnstile、聊天、联盟和多语言仍按模块总览列为待开发。