网站 AI 功能
01MVP 模板内置的对话、生成、多模型路由、额度扣费和 AI 功能扩展方式。
为什么网站 AI 单独成章
在 01MVP 模板里，网站里的 AI 功能是产品能力，不只是一个可选脚本。它会影响 API 成本、用户额度、权限、限流、内容安全和后台管理，所以放在核心功能里。
这里讲的是面向用户的网站 AI 功能：对话、文本生成、图片生成、视频生成、多模型路由、额度扣费和运行时配置。
如果你要看开发时 AI 怎么读项目规则、怎么加载 Skills、怎么维护仓库，请看 AI 开发工作流。
模板里已经有什么
| 能力 | 位置 | 适合解决什么 |
|---|---|---|
| AI SDK 封装 | products/01mvp/packages/api/src/lib/ai | 文本生成、流式输出、模型配置、图片生成、视频生成 |
| 对话与生成接口 | products/01mvp/apps/web/src/server/ai.ts | 带模型白名单、限流、额度扣费和会话保存的 Hono API |
| 对话页面 | products/01mvp/apps/web/src/routes/{-$locale}/(root-layout)/(auth)/ai/chat/index.tsx | 登录后可用的基础聊天体验 |
| 聊天数据模型 | ChatSession、ChatMessage | 保存用户会话和消息历史 |
| 用量与额度 | products/01mvp/packages/api/src/lib/credits | 按功能、模型或固定额度扣费 |
| 模型配置 | products/01mvp/packages/config/.env | OpenAI-compatible API key、base URL、默认模型 |
| 安全边界 | 限流、验证码、权限和用量检查 | 防止 AI 接口被刷、额度被耗尽或高成本能力无门槛暴露 |
products/01mvp/packages/api/src/lib/ai 面向业务代码，.agents/skills 面向开发过程。不要把这两类 AI 混在一起：前者给用户提供功能，后者帮助 AI 编码工具理解项目。
运行时 AI 配置
常用环境变量在 products/01mvp/packages/config/.env 中配置，共享默认值可以放在 packages/config/.env：
OPENAI_API_KEY=sk-xxx
OPENAI_BASE_URL=https://api.example.com/v1
OPENAI_MODEL=deepseek-chat这套封装使用 OpenAI-compatible API。OpenAI、DeepSeek、通义千问、智谱、火山方舟等服务，只要兼容这个格式，通常都可以通过 OPENAI_BASE_URL 和 OPENAI_MODEL 切换。未配置时默认使用 DeepSeek。
你应该从哪里开始
AI 环境变量
配置 OpenAI-compatible API key、base URL 和默认模型。
接口限流
给 AI 对话、生成和高成本接口加频率边界。
人机验证
高风险动作被刷时，用 Local PoW 或 Cloudflare Turnstile 增加成本。
支付与积分
把高成本生成能力和 credits 账本、订单、会员权益连起来。
开发时 AI 工作流
开发时 AI 工作流不属于网站功能本身，但它是模板的重要使用方式。相关页面单独放在 sidebar 的「AI 开发工作流」里：
项目说明书
用 AGENTS.md 让 AI 编码工具理解目录边界和工程规范。
AI 文档系统
看 AGENTS、主题规范、Skills 和产品文档怎么分工。
AI 协作维护
看 01MVP 当前仓库如何用 AI 维护代码、文档、规则和提交。
预置 Skills
看当前模板内置了哪些专项技能，分别适合什么任务。
模板初始化 Skill
用一个专门的 Skill，把 01MVP 模板快速改成你自己的产品网站。
维护原则
- 网站 AI 能力优先放在
products/01mvp/packages/api/src/lib/ai和应用层 API 中，不散落到页面组件里。 - 业务要扣费时，先接入
products/01mvp/packages/api/src/lib/credits，再开放高成本模型或生成任务。 - 新增 AI 页面、对话框、生成器和管理后台时，继续遵守主题预设系统。
- 新增开发约定时，先判断它属于目录边界、主题规范、产品意图还是一次性变更：目录边界写进最近的
AGENTS.md，跨目录细则写进.agents/*.md，会影响模板使用者的内容再同步到人类文档。
这篇文档有问题？