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