---
url: /docs/getting-started.md
---
# 项目介绍

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` 为准。公开站不依赖登录状态才能返回正文，私有数据始终由服务端验证身份和权限。

## 先读哪些内容

先完成 [本地启动](../agentbuff-stack/quick-start.md)，再看 [网站配置](../agentbuff-stack/website.md)、[环境变量](../agentbuff-stack/env.md) 和 [模块总览](../agentbuff-stack/modules.md)。这些页面给出实际配置入口及完成状态。

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

## 许可证与来源

模板基于 Kriasoft 的开源项目迭代，保留原 MIT 许可证与版权声明。出售模板或复制新站时也要保留许可证，并分别遵守第三方依赖和外部服务的条款。