项目介绍

AgentBuff Stack 是面向英文工具站的全栈模板。公开页面用于介绍产品、承接搜索访问；工具提供输入、处理、预览和导出；工作台负责账号、历史记录、积分及订阅。维护教程先统一使用中文，客户网站仍按英文市场配置。

技术分工

部分	实现	主要目录
公开网站与博客	Astro，构建时输出静态页面	`apps/web`
登录与工作台	React、TanStack Router、TanStack Query	`apps/app`
服务端接口	Hono、tRPC、Better Auth	`apps/api`
数据库	PostgreSQL、Drizzle	`db`
共享样式	Astryx、StyleX、共享设计变量	`packages/ui`
邮件模板	React Email，Resend 发送	`apps/email`
部署目标	Cloudflare Workers，Neon 与 Hyperdrive	`infra`、各应用的 `wrangler.jsonc`

版本以各目录的 package.json 与根目录 bun.lock 为准。公开站不依赖登录状态才能返回正文，私有数据始终由服务端验证身份和权限。

先完成本地启动，再看网站配置、环境变量和模块总览。这些页面给出实际配置入口及完成状态。

深入改动时，按目录查看前端、接口、账号、数据库和支付教程。扩展教程会明确标注尚未接入的能力；示例存在不代表已经在客户网站启用。