AI 助手
门户右下角已经接入 AI 助手，入口复用了主题自带的右下角评论按钮位。它适合用来快速理解当前页面内容、区分 starter / server / demo 的职责，或者追问 e 签宝接入路线。
当前能力
- 支持多轮对话
- 支持流式输出
- 自动带上当前页面标题、路径和正文摘录
- 会先在门户文档中做本地检索，再结合检索结果回答
- 默认按中文回答
- 支持在对话框内选择模型提供商和模型，目前内置
OpenAI / DeepSeek / Gemini - 支持填写你自己的
API_KEY - 会通过服务端接口转发模型请求，默认不会把门户自己的模型密钥暴露到前端
用户自带模型配置
如果你不希望门户统一提供模型服务，可以直接在聊天面板里选择：
bash
PROVIDER=OpenAI / DeepSeek / Gemini
MODEL=根据所选提供商下拉选择
API_KEY=你的模型服务密钥这些配置会保存在当前浏览器本地，便于下次继续使用。
目前默认支持：
- OpenAI：适合直接接入 OpenAI 官方模型
- DeepSeek：通过 DeepSeek 官方兼容接口调用
- Gemini：通过 Google Gemini 官方
generateContent / streamGenerateContent接口调用
不同提供商会自动切换对应的模型列表，不需要手动填写 BASE_URL 或模型名。
服务端环境变量
如果你仍然希望门户作为默认模型代理，也可以在部署平台配置：
bash
OPENAI_API_KEY=服务端统一使用的模型服务密钥
DEEPSEEK_API_KEY=DeepSeek 的服务端默认密钥
GEMINI_API_KEY=Gemini 的服务端默认密钥当前实现会优先使用用户在对话框里选择的提供商配置；如果用户没有填写，则服务端仍可回退到默认环境变量。
接口说明
门户前端调用同域接口：
text
POST /api/ai/chat请求体会携带最近几轮消息，以及当前页面上下文。服务端会先从门户 Markdown 文档里做一次本地检索，再把命中的知识片段和上下文一起发给上游模型服务，并以流式方式回传回答。
使用建议
- 适合问“我应该先看哪一页”“这个模块解决什么问题”“当前页面有哪些关键能力”
- 如果你想让回答更贴近业务，可以继续在系统提示词里补充团队术语和约束
- 如果后续需要接更强的知识库检索，可以继续在
/api/ai/knowledge.js里扩展召回逻辑