# AgentBuff Stack

> 从一个需求，到下一个站。

用 Astro 静态页面获取搜索流量，用 React 工作台交付结果，用 Cloudflare 与 PostgreSQL 承载服务。配置有明确入口，模块有真实状态。

## Table of Contents

### AgentBuff Stack

- [AgentBuff Stack](/docs/agentbuff-stack.md)
- [快速开始](/docs/agentbuff-stack/quick-start.md)
- [网站配置](/docs/agentbuff-stack/website.md)
- [环境变量](/docs/agentbuff-stack/env.md)
- [模块总览](/docs/agentbuff-stack/modules.md)
- [功能扩展路线：对照 MkSaaS](/docs/agentbuff-stack/feature-roadmap.md)
- [AgentBuff Stack 开发迭代计划](/docs/agentbuff-stack/development-plan.md)
- [持续迭代记录](/docs/agentbuff-stack/iteration-progress.md)
- [账号与邮件](/docs/agentbuff-stack/auth-mail.md)
- [站点管理员与操作审计](/docs/agentbuff-stack/admin-audit.md)
- [用户 API 密钥与外部接口](/docs/agentbuff-stack/api-keys.md)
- [邮件订阅与候补名单](/docs/agentbuff-stack/marketing-subscriptions.md)
- [私有文件存储](/docs/agentbuff-stack/files-storage.md)
- [执行限制与验证](/docs/agentbuff-stack/execution-security.md)
- [支付、积分与任务](/docs/agentbuff-stack/billing-tasks.md)
- [任务生命周期](/docs/agentbuff-stack/task-lifecycle.md)
- [图片转矢量：候选接口与接入核对](/docs/agentbuff-stack/image-to-svg-contract.md)
- [任务邮件通知](/docs/agentbuff-stack/task-notifications.md)
- [站主运营通知](/docs/agentbuff-stack/operator-notifications.md)
- [工具使用事件](/docs/agentbuff-stack/tool-usage-events.md)
- [可选客服聊天](/docs/agentbuff-stack/support-chat.md)
- [联盟营销：推荐绑定与后台核查](/docs/agentbuff-stack/affiliates.md)
- [工作台使用与购买事件](/docs/agentbuff-stack/server-activity-events.md)
- [内容、搜索优化与统计](/docs/agentbuff-stack/content-seo.md)
- [部署与验收](/docs/agentbuff-stack/deployment.md)
- [数据库备份与恢复](/docs/agentbuff-stack/backup-restore.md)
- [认证密钥轮换](/docs/agentbuff-stack/auth-key-rotation.md)
- [数据库角色与凭据变更](/docs/agentbuff-stack/database-roles.md)
- [用这套模板建立下一个英文工具站](/docs/agentbuff-stack/new-site.md)
- [开发交付包](/docs/agentbuff-stack/distribution.md)
- [模板官网、案例与独立演示](/docs/agentbuff-stack/website-showcase.md)
- [模板版本与升级](/docs/agentbuff-stack/template-upgrades.md)
- [AgentBuff Stack 界面复用指南](/docs/agentbuff-stack/design-system.md)
- [品牌名称与素材](/docs/agentbuff-stack/brand-assets.md)
- [全站语言与翻译](/docs/agentbuff-stack/languages.md)
- [AgentBuff Stack 能力清单 · 2026-10-11](/docs/agentbuff-stack/capabilities.md)
- [I0—I16 当前验收核对 · 2026-10-11](/docs/agentbuff-stack/completion-audit-2026-10-11.md)

### 入门指南

- [项目介绍](/docs/getting-started.md)
- [启动项目](/docs/getting-started/quick-start.md)
- [目录结构](/docs/getting-started/project-structure.md)
- [环境变量说明](/docs/getting-started/environment-variables.md)

### 系统架构

- [系统架构概览](/docs/architecture.md)
- [边缘路由与绑定](/docs/architecture/edge.md)

### 前端开发

- [页面路由](/docs/frontend/routing.md)
- [状态与数据查询](/docs/frontend/state.md)
- [组件与主题](/docs/frontend/ui.md)
- [表单与校验](/docs/frontend/forms.md)

### 接口开发

- [接口概览](/docs/api.md)
- [查询与变更接口](/docs/api/procedures.md)
- [输入校验与错误处理](/docs/api/validation-errors.md)
- [请求上下文与中间件](/docs/api/context.md)

### 账号认证

- [账号认证概览](/docs/auth.md)
- [邮箱与验证码](/docs/auth/email-otp.md)
- [第三方登录](/docs/auth/social-providers.md)
- [通行密钥](/docs/auth/passkeys.md)
- [组织与角色](/docs/auth/organizations.md)
- [会话与访问控制](/docs/auth/sessions.md)

### 数据库

- [数据库概览](/docs/database.md)
- [数据模型](/docs/database/schema.md)
- [数据库迁移](/docs/database/migrations.md)
- [初始化数据](/docs/database/seeding.md)
- [查询写法](/docs/database/queries.md)

### 订阅与账单

- [订阅与账单概览](/docs/billing.md)
- [套餐与定价](/docs/billing/plans.md)
- [结账与账单管理](/docs/billing/checkout.md)
- [支付事件回调](/docs/billing/webhooks.md)

### 部署上线

- [部署上线](/docs/deployment.md)
- [部署边缘服务](/docs/deployment/cloudflare.md)
- [生产数据库](/docs/deployment/production-database.md)
- [自动检查与发布](/docs/deployment/ci-cd.md)
- [日志与监控](/docs/deployment/monitoring.md)

### 扩展教程

- [新增页面](/docs/recipes/new-page.md)
- [新增接口](/docs/recipes/new-procedure.md)
- [新增数据表](/docs/recipes/new-table.md)
- [扩展组织分组](/docs/recipes/teams.md)
- [实时连接](/docs/recipes/websockets.md)
- [文件上传](/docs/recipes/file-uploads.md)

### 安全维护

- [上线检查](/docs/security/checklist.md)
- [故障与安全事件处理](/docs/security/incident-playbook.md)
- [安全政策模板](/docs/security/policy-template.md)

### Other

- [0.1 本地验收 · 2026-10-09](/docs/agentbuff-stack/validation-2026-10-09.md)
- [Accounts, teams and email](/docs/en/agentbuff-stack/auth-mail.md)
- [Administration and audit](/docs/en/agentbuff-stack/admin-audit.md)
- [AgentBuff Stack](/docs/en/agentbuff-stack.md)
- [Background task workflow](/docs/en/agentbuff-stack/task-lifecycle.md)
- [Content and search metadata](/docs/en/agentbuff-stack/content-seo.md)
- [Create an independent site](/docs/en/agentbuff-stack/new-site.md)
- [Deployment preparation](/docs/en/agentbuff-stack/deployment.md)
- [Design system](/docs/en/agentbuff-stack/design-system.md)
- [Email lists and waitlists](/docs/en/agentbuff-stack/marketing-subscriptions.md)
- [Environment variables](/docs/en/agentbuff-stack/env.md)
- [Languages and translation](/docs/en/agentbuff-stack/languages.md)
- [Module boundaries](/docs/en/agentbuff-stack/modules.md)
- [Official website, showcase and demo](/docs/en/agentbuff-stack/website-showcase.md)
- [Payments, credits and tasks](/docs/en/agentbuff-stack/billing-tasks.md)
- [Private files](/docs/en/agentbuff-stack/files-storage.md)
- [Product configuration](/docs/en/agentbuff-stack/website.md)
- [Quick start](/docs/en/agentbuff-stack/quick-start.md)
- [Task email preferences](/docs/en/agentbuff-stack/task-notifications.md)
- [Template versions and upgrades](/docs/en/agentbuff-stack/template-upgrades.md)
- [Untitled](/docs/en.md)
- [User API keys](/docs/en/agentbuff-stack/api-keys.md)
- [决策 001：认证提示 Cookie](/docs/adr/001-auth-hint-cookie.md)
- [决策 002：基础设施与应用发布分工](/docs/adr/002-terraform-wrangler-boundary.md)
- [决策 003：远程基础设施状态](/docs/adr/003-hcp-terraform-state.md)
- [决策 004：类型检查工具链](/docs/adr/004-typescript-7-native-compiler.md)
- [决策 005：静态检查与格式化](/docs/adr/005-oxlint-oxfmt.md)
- [决策 006：包内导入约定](/docs/adr/006-subpath-imports.md)
- [决策 007：统一导入顺序](/docs/adr/007-oxfmt-sorts-imports.md)
- [基础设施规格](/docs/specs/infra-terraform.md)
- [官网与独立项目改造验收](/docs/agentbuff-stack/refactor-validation-2026-10-09.md)
- [带前缀的数据库标识](/docs/specs/prefixed-ids.md)
- [架构决策记录模板](/docs/adr/000-template.md)
- [测试与排查](/docs/testing.md)
- [订阅集成规格](/docs/specs/billing.md)
- [设计系统验收记录 · 2026-10-09](/docs/agentbuff-stack/design-validation-2026-10-09.md)
- [账号表单规格](/docs/specs/auth-form.md)
- [邮件发送](/docs/email.md)
- [配置与模块文档验收 · 2026-10-09](/docs/agentbuff-stack/configuration-validation-2026-10-09.md)