MuseMVP

MuseMVP 内置了开箱即用的 AI 对话功能，基于 Vercel AI SDK 实现流式输出，会话与消息持久化至 PostgreSQL。本文介绍模块结构、API 接口与配置要点。

AI 对话模块

必需运行时配置

配置项	说明
`GOOGLE_GENERATIVE_AI_API_KEY`	Google AI Studio 的 API Key，用于调用 Gemini 模型
`config.ai.enabled`	AI Chat 总开关。为 `false` 时会隐藏后台 AI Chat 入口，`/app/aichat` 重定向到 `/app`，`/api/aichat/**` 返回 `404`
`config.ai.chatModel`	默认 `gemini-3-pro-preview`，可在 `src/config/index.ts` 中修改

未配置 AI Key

未配置 GOOGLE_GENERATIVE_AI_API_KEY 时，流式响应前会直接报错，前端会收到错误提示。

需要关闭 AI Chat 时

在 src/config/index.ts 中设置 config.ai.enabled=false 即可。这样会关闭账号后台侧的 AI Chat 页面与接口入口，但无需删除模块代码或数据库表。

关闭功能：设置 config.ai.enabled=false，即可关闭 AI Chat 路由与导航入口，同时保留代码，后续可随时重新开启。

更换模型：修改 config.ai.chatModel 或调整 aichat 路由中的模型调用逻辑。

接入其他 AI 提供商：在 src/modules/aichat 或 API 路由中替换 Vercel AI SDK 的 generateText 调用。

扩展消息类型：在数据库 schema 与前端组件中支持图片、文件等富媒体。