AI 核心能力
01MVP 模板内置的运行时 AI 能力和 AI 协作体系
为什么 AI 放在核心里
在 01MVP 模板里，AI 不是一个可有可无的插件。它同时承担两件事：
- 产品运行时能力：给网站提供对话、文本生成、结构化生成、图片生成、视频生成、模型切换、限流、验证码和用量计费的基础。
- 开发协作能力：让 AI 编码工具理解项目结构、主题规范、文档规则和常见技术栈，减少从零解释项目背景的成本。
这两层能力都影响产品能不能快速上线，所以放在 core/ai，不再放在 extensions。
模板里已经有什么
| 能力 | 位置 | 适合解决什么 |
|---|---|---|
| AI SDK 封装 | packages/ai | 文本生成、流式输出、结构化对象、Embedding、图片生成、视频生成 |
| 对话接口 | apps/01mvp-web/src/server/routes/chat.ts | 带模型白名单、限流、验证码和会话保存的 Hono API |
| 对话页面 | apps/01mvp-web/src/app/(app)/chat | 登录后可用的基础聊天体验 |
| 聊天数据模型 | ChatSession、ChatMessage | 保存用户会话和消息历史 |
| 用量与额度 | packages/credits | 按模型、Token 或固定额度扣费 |
| 项目说明书 | AGENTS.md / CLAUDE.md | 给 AI 编码工具读取的项目规则 |
| 按需规则库 | .agents/references | 把文档、UI、数据库、API 等细则拆成按需读取的 reference |
| 预置 Skills | .agents/skills | 给 AI 编码工具加载的专项工作流 |
packages/ai 面向业务代码，.agents/skills 面向开发过程。前者帮你做 AI 产品功能，后者帮 AI 更懂这个项目。
运行时 AI 配置
常用环境变量在 apps/01mvp-web/.env.local 中配置：
AI_API_KEY=sk-xxx
AI_BASE_URL=https://api.example.com/v1
AI_MODEL=deepseek-chat这套封装优先使用 OpenAI-compatible API。OpenAI、DeepSeek、通义千问、智谱、火山方舟等服务，只要兼容这个格式，通常都可以通过 AI_BASE_URL 和 AI_MODEL 切换。
你应该从哪里开始
项目说明书
让 AI 编码工具理解项目规范、主题系统和协作边界。
AI 协作维护
看 01MVP 当前仓库如何用 AI 维护代码、文档、规范和提交。
预置 Skills
看当前模板内置了哪些专项技能，分别适合什么任务。
模板初始化 Skill
用一个专门的 Skill，把 01MVP 模板快速改成你自己的产品网站。
维护原则
- 产品 AI 能力优先放在
packages/ai和应用层 API 中，不散落到页面组件里。 - 业务要扣费时，先接入
packages/credits，再开放高成本模型或生成任务。 - 新增 AI 页面、对话框、生成器和管理后台时，继续遵守主题预设系统。
- 新增开发约定时，先判断它是全局硬规则还是按需细则：全局规则放进
AGENTS.md，任务细则放进.agents/references，再同步必要的人类文档。