尧图网页设计 
1. 为什么 uni-app 项目需要统一管理多模型 API Key做 uni-app 跨端开发的朋友大概率遇到过这个场景项目里要接 AI 能力H5 端调一个模型、小程序端调另一个模型、App 端又想换第三个。每个模型厂商一套 Key、一套计费、一套 SDK光是环境变量就维护了七八个文件。更麻烦的是VSCode 里写代码用一套配置HBuilderX 里打包又要同步一遍稍不留神就把测试 Key 提交到了仓库。我试过最原始的做法——在.env.local里堆十几个变量结果每次切换模型都要改代码重新编译跨端调试时 H5 能跑、小程序报 401排查半天发现是 Key 没同步。后来换成统一网关的思路所有模型请求走同一个入口用同一个 Key通过参数区分模型。这样 VSCode 和 HBuilderX 共享一份配置跨端编译时不用改任何代码。TaoToken 就是干这个的。它把多家模型的调用收敛成一个 OpenAI 兼容接口你只需要一个 API Key就能在 uni-app 项目里通过uni.request调用不同模型。对前端开发者来说最大的好处是不用为每个模型单独装 SDK也不用在manifest.json和settings.json之间来回倒腾配置。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 下面我会把 VSCode HBuilderX 双工具链的完整配置骨架拆开讲。这篇面向的是已经会用 Vue 3 写 uni-app、但被多模型 Key 管理搞烦的前端。如果你刚接触 uni-app建议先把官方模板跑起来再回来看配置部分。全文的配置都可以直接复制改掉 Key 就能用。2. TaoToken 前置准备拿 Key 与理解接口形态在动手改settings.json之前先把 Key 拿到手。访问 https://taotoken.net/api-keys 登录后创建一个新的 API Key。建议按项目命名比如uniapp-dev方便后面在多个项目间区分。创建完复制那串sk-开头的字符串它只会显示一次。TaoToken 的接口是 OpenAI 兼容格式这意味着你在 uni-app 里不需要引入任何厂商 SDK直接用uni.request发 POST 请求就行。请求地址是https://taotoken.net/api/v1/chat/completions请求体里用model字段指定要调用的模型。这种设计对跨端特别友好——H5 端、小程序端、App 端用的都是同一套uni.requestAPI不用为每个平台写不同的适配层。有一点要注意小程序端有域名白名单限制。你需要在微信开发者后台把taotoken.net加入 request 合法域名否则真机调试会报“不在以下 request 合法域名列表中”。H5 端没有这个限制但生产环境建议走自己的后端转发避免 Key 暴露在前端代码里。App 端相对宽松但同样建议用环境变量注入而不是硬编码。如果你还没决定用哪个模型可以先到 https://taotoken.net/models 看看支持的列表。配置阶段建议先用一个便宜的模型跑通链路验证成功后再换成正式模型。Key 的管理页面在 https://taotoken.net/console 可以随时查看用量和余额。3. VSCode 侧配置settings.json 与项目骨架VSCode 这边的核心任务是两件事让编辑器正确识别 uni-app 的特殊 JSON 文件以及配置好 AI 辅助编码的环境变量。先解决第一个——pages.json和manifest.json支持注释但 VSCode 默认按严格 JSON 解析会报错。打开设置搜索files.associations添加两条映射{ files.associations: { manifest.json: jsonc, pages.json: jsonc } }这样注释就不再飘红了。接下来是项目级的.vscode/settings.json我习惯把 AI 相关的配置放在这里方便团队共享{ files.associations: { manifest.json: jsonc, pages.json: jsonc }, typescript.tsdk: node_modules/typescript/lib, editor.formatOnSave: true, editor.codeActionsOnSave: { source.fixAll.eslint: explicit }, uni-app.ai.baseUrl: https://taotoken.net/api/v1, uni-app.ai.defaultModel: gpt-4o-mini }注意uni-app.ai.baseUrl和defaultModel这两个字段是我自定义的约定不是官方标准。你可以在项目里建一个src/config/ai.ts来读取它们或者直接用 Vite 的环境变量。更推荐后者因为 HBuilderX 打包时也能读到.env文件# .env.development VITE_AI_BASE_URLhttps://taotoken.net/api/v1 VITE_AI_API_KEYsk-你的开发Key VITE_AI_DEFAULT_MODELgpt-4o-mini # .env.production VITE_AI_BASE_URLhttps://taotoken.net/api/v1 VITE_AI_API_KEYsk-你的生产Key VITE_AI_DEFAULT_MODELgpt-4o然后在src/utils/ai.ts里封装一个跨端通用的请求函数// src/utils/ai.ts interface ChatMessage { role: system | user | assistant content: string } interface ChatOptions { model?: string messages: ChatMessage[] temperature?: number } export async function chatCompletion(options: ChatOptions) { const baseUrl import.meta.env.VITE_AI_BASE_URL const apiKey import.meta.env.VITE_AI_API_KEY const model options.model || import.meta.env.VITE_AI_DEFAULT_MODEL return new Promise((resolve, reject) { uni.request({ url: ${baseUrl}/chat/completions, method: POST, header: { Content-Type: application/json, Authorization: Bearer ${apiKey} }, data: { model, messages: options.messages, temperature: options.temperature ?? 0.7 }, success: (res) { if (res.statusCode 200) { resolve(res.data) } else { reject(new Error(请求失败: ${res.statusCode})) } }, fail: (err) reject(err) }) }) }这个封装的好处是H5、小程序、App 三端共用同一份代码uni.request会自动适配各平台的网络实现。Vite 在编译时会根据.env文件注入对应的值HBuilderX 打包时也会读取同样的环境变量。TypeScript 类型支持方面安装uni-helper/uni-app-types后在tsconfig.json的types数组里加上它.vue文件里的uni.request就有完整提示了。这一步和 AI 配置无关但能显著减少拼写错误。4. HBuilderX 侧配置config.toml 与打包链路HBuilderX 这边不直接读.env文件它有自己的环境变量机制。如果你用 HBuilderX 的 CLI 打包可以在项目根目录建一个config.toml来管理打包参数。这个文件不是 uni-app 官方标准而是 HBuilderX CLI 支持的配置格式# config.toml [app] name 我的跨端应用 appid __UNI__XXXXXXX [build] platform app mode release [env] VITE_AI_BASE_URL https://taotoken.net/api/v1 VITE_AI_DEFAULT_MODEL gpt-4o注意VITE_AI_API_KEY不要写进config.toml因为这个文件通常会提交到仓库。Key 应该通过 HBuilderX 的“运行配置”或系统环境变量注入。在 HBuilderX 里点击“运行” → “运行到手机或模拟器” → “运行配置”可以添加自定义环境变量。打包时同理在“发行” → “原生App-云打包”的配置页里注入。如果你习惯在 VSCode 里写代码、HBuilderX 里只做打包那流程是这样的VSCode 里执行pnpm build:app生成dist/build/app目录然后在 HBuilderX 里“文件” → “导入” → “从本地目录导入”选择这个dist/build/app文件夹。HBuilderX 会把它识别为一个可打包的 App 项目双击manifest.json配置 AppID 和图标然后“发行” → “原生App-云打包”。这里有个坑要避开不要直接把整个源码目录导入 HBuilderX 再让它编译。两个 IDE 的编译链路不同Vite 的产物和 HBuilderX 的编译器可能产生冲突表现为样式错乱或 API 调用失败。正确做法是 VSCode 负责编译HBuilderX 只负责打包职责分离。manifest.json里的 AppID 是云打包的必需项。如果显示__UNI__开头的临时 ID点击“重新获取”按钮登录 DCloud 账号后会分配一个唯一标识。这个 ID 和 TaoToken 的 Key 是两回事前者标识你的 App 应用后者标识你的 API 调用身份。5. 验证请求H5 与小程序端跑通 AI 调用配置写完了得验证链路是否通。先写一个最简单的测试页面放在src/pages/index/index.vuetemplate view classcontent button clicktestAI测试 AI 调用/button text{{ result }}/text /view /template script setup langts import { ref } from vue import { chatCompletion } from /utils/ai const result ref(等待测试...) async function testAI() { try { const res: any await chatCompletion({ messages: [ { role: user, content: 用一句话介绍 uni-app } ] }) result.value res.choices[0].message.content } catch (e: any) { result.value 出错: ${e.message} } } /script在 VSCode 终端执行pnpm dev:h5浏览器打开后点击按钮。如果返回了模型输出说明 H5 端链路通了。接着测小程序端执行pnpm dev:mp-weixin用微信开发者工具打开dist/dev/mp-weixin目录。点击按钮前确认微信开发者后台的 request 合法域名里加了https://taotoken.net。如果没加开发者工具里可以临时勾选“不校验合法域名”来测试但真机预览必须配置。App 端的验证稍微麻烦一点需要真机或模拟器。执行pnpm dev:app生成dist/dev/app用 HBuilderX 导入后运行到手机。App 端没有域名白名单限制但要注意 Android 9 以上默认禁止明文 HTTP而 TaoToken 是 HTTPS所以没问题。三端都跑通后你会看到同一个chatCompletion函数在不同平台返回一致的结果。这就是统一 Key 接入的价值——不用为每个端写不同的请求逻辑也不用担心某个端的 Key 过期导致整个项目挂掉。如果 H5 通了但小程序报 401先检查Authorization头有没有被小程序拦截。有些小程序基础库版本对自定义 header 有限制可以改成token字段放在 body 里TaoToken 也支持这种传法。具体参考 https://taotoken.net/doc 的鉴权章节。6. 本篇常见错排查报错一request:fail url not in domain list这是小程序端最常见的。原因就是taotoken.net没加到微信后台的 request 合法域名。解决方式登录微信公众平台 → 开发 → 开发管理 → 开发设置 → 服务器域名 → request 合法域名添加https://taotoken.net。注意必须是 HTTPS且不能带路径。开发阶段可以在开发者工具“详情” → “本地设置”里勾选“不校验合法域名”但上线前必须配好。报错二401 UnauthorizedKey 没传对或者过期了。检查.env文件里的VITE_AI_API_KEY是否以sk-开头有没有多余空格。如果用的是 HBuilderX 打包确认环境变量注入到了正确的构建阶段。还有一个容易忽略的点Vite 只会把VITE_开头的变量暴露给客户端代码如果你写成AI_API_KEY而不加前缀import.meta.env里读不到。报错三pages.json注释报红VSCode 没把pages.json识别为jsonc。回到第 3 节的files.associations配置确认键名是pages.json而不是**/pages.json。改完后重启 VSCode 生效。报错四HBuilderX 导入dist/build/app后无法打包检查manifest.json里的 AppID 是否已获取。如果还是__UNI__临时 ID云打包会拒绝。另外确认dist/build/app目录下有manifest.json和pages.json如果 Vite 编译时没生成这两个文件说明vite.config.ts里的 uni-app 插件配置有问题。报错五pnpm install时uni-helper类型包安装失败在用户目录的.npmrc里加一行shamefully-hoisttrue然后删掉node_modules重新安装。pnpm 的严格依赖隔离有时会导致类型包找不到 peer 依赖这个配置能解决大部分情况。报错六模型返回空内容检查请求体里的model字段是否拼写正确。TaoToken 的模型名和官方一致比如gpt-4o-mini、claude-3-5-sonnet等。如果模型名错了接口可能返回 200 但choices为空。到 https://taotoken.net/models 核对可用模型列表。7. 长期编码与 Agent 场景的 Key 管理建议如果你只是偶尔在项目里调一下 AI上面这套配置够用了。但如果你打算把 AI 辅助编码长期集成到工作流里——比如用 Cursor 或 Claude Code 做日常开发——那 Key 的管理方式需要升级。TaoToken 的 Coding Plan 就是为这种场景设计的它提供一个长期有效的 Key支持在多个 IDE 和 Agent 工具间共享不用每次换工具都重新配一遍。具体来说你可以在 https://taotoken.net/coding-plan 订阅后拿到一个专用 Key然后在 VSCode 的 AI 插件、HBuilderX 的辅助工具、以及命令行 Agent 里统一使用。这样跨端项目的 AI 能力就真正做到了“一处配置处处可用”。对于需要频繁切换模型对比效果的场景还可以在请求参数里动态指定model而不用改环境变量重新编译。回到 uni-app 项目本身建议把chatCompletion封装成 composable比如useAI()在多个页面间复用。同时给请求加上重试和降级逻辑——主模型超时后自动切到备用模型这在跨端网络不稳定的情况下特别有用。这些进阶用法我会在后续文章里展开先把今天的配置跑通再说。 【前端开发】VSCode + HBuilderX 一站式指南：用 Vue 3 高效开发 uni-app 跨端应用（TaoToken 配置篇）
1. 为什么 uni-app 项目需要统一管理多模型 API Key做 uni-app 跨端开发的朋友大概率遇到过这个场景项目里要接 AI 能力H5 端调一个模型、小程序端调另一个模型、App 端又想换第三个。每个模型厂商一套 Key、一套计费、一套 SDK光是环境变量就维护了七八个文件。更麻烦的是VSCode 里写代码用一套配置HBuilderX 里打包又要同步一遍稍不留神就把测试 Key 提交到了仓库。我试过最原始的做法——在.env.local里堆十几个变量结果每次切换模型都要改代码重新编译跨端调试时 H5 能跑、小程序报 401排查半天发现是 Key 没同步。后来换成统一网关的思路所有模型请求走同一个入口用同一个 Key通过参数区分模型。这样 VSCode 和 HBuilderX 共享一份配置跨端编译时不用改任何代码。TaoToken 就是干这个的。它把多家模型的调用收敛成一个 OpenAI 兼容接口你只需要一个 API Key就能在 uni-app 项目里通过uni.request调用不同模型。对前端开发者来说最大的好处是不用为每个模型单独装 SDK也不用在manifest.json和settings.json之间来回倒腾配置。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 下面我会把 VSCode HBuilderX 双工具链的完整配置骨架拆开讲。这篇面向的是已经会用 Vue 3 写 uni-app、但被多模型 Key 管理搞烦的前端。如果你刚接触 uni-app建议先把官方模板跑起来再回来看配置部分。全文的配置都可以直接复制改掉 Key 就能用。2. TaoToken 前置准备拿 Key 与理解接口形态在动手改settings.json之前先把 Key 拿到手。访问 https://taotoken.net/api-keys 登录后创建一个新的 API Key。建议按项目命名比如uniapp-dev方便后面在多个项目间区分。创建完复制那串sk-开头的字符串它只会显示一次。TaoToken 的接口是 OpenAI 兼容格式这意味着你在 uni-app 里不需要引入任何厂商 SDK直接用uni.request发 POST 请求就行。请求地址是https://taotoken.net/api/v1/chat/completions请求体里用model字段指定要调用的模型。这种设计对跨端特别友好——H5 端、小程序端、App 端用的都是同一套uni.requestAPI不用为每个平台写不同的适配层。有一点要注意小程序端有域名白名单限制。你需要在微信开发者后台把taotoken.net加入 request 合法域名否则真机调试会报“不在以下 request 合法域名列表中”。H5 端没有这个限制但生产环境建议走自己的后端转发避免 Key 暴露在前端代码里。App 端相对宽松但同样建议用环境变量注入而不是硬编码。如果你还没决定用哪个模型可以先到 https://taotoken.net/models 看看支持的列表。配置阶段建议先用一个便宜的模型跑通链路验证成功后再换成正式模型。Key 的管理页面在 https://taotoken.net/console 可以随时查看用量和余额。3. VSCode 侧配置settings.json 与项目骨架VSCode 这边的核心任务是两件事让编辑器正确识别 uni-app 的特殊 JSON 文件以及配置好 AI 辅助编码的环境变量。先解决第一个——pages.json和manifest.json支持注释但 VSCode 默认按严格 JSON 解析会报错。打开设置搜索files.associations添加两条映射{ files.associations: { manifest.json: jsonc, pages.json: jsonc } }这样注释就不再飘红了。接下来是项目级的.vscode/settings.json我习惯把 AI 相关的配置放在这里方便团队共享{ files.associations: { manifest.json: jsonc, pages.json: jsonc }, typescript.tsdk: node_modules/typescript/lib, editor.formatOnSave: true, editor.codeActionsOnSave: { source.fixAll.eslint: explicit }, uni-app.ai.baseUrl: https://taotoken.net/api/v1, uni-app.ai.defaultModel: gpt-4o-mini }注意uni-app.ai.baseUrl和defaultModel这两个字段是我自定义的约定不是官方标准。你可以在项目里建一个src/config/ai.ts来读取它们或者直接用 Vite 的环境变量。更推荐后者因为 HBuilderX 打包时也能读到.env文件# .env.development VITE_AI_BASE_URLhttps://taotoken.net/api/v1 VITE_AI_API_KEYsk-你的开发Key VITE_AI_DEFAULT_MODELgpt-4o-mini # .env.production VITE_AI_BASE_URLhttps://taotoken.net/api/v1 VITE_AI_API_KEYsk-你的生产Key VITE_AI_DEFAULT_MODELgpt-4o然后在src/utils/ai.ts里封装一个跨端通用的请求函数// src/utils/ai.ts interface ChatMessage { role: system | user | assistant content: string } interface ChatOptions { model?: string messages: ChatMessage[] temperature?: number } export async function chatCompletion(options: ChatOptions) { const baseUrl import.meta.env.VITE_AI_BASE_URL const apiKey import.meta.env.VITE_AI_API_KEY const model options.model || import.meta.env.VITE_AI_DEFAULT_MODEL return new Promise((resolve, reject) { uni.request({ url: ${baseUrl}/chat/completions, method: POST, header: { Content-Type: application/json, Authorization: Bearer ${apiKey} }, data: { model, messages: options.messages, temperature: options.temperature ?? 0.7 }, success: (res) { if (res.statusCode 200) { resolve(res.data) } else { reject(new Error(请求失败: ${res.statusCode})) } }, fail: (err) reject(err) }) }) }这个封装的好处是H5、小程序、App 三端共用同一份代码uni.request会自动适配各平台的网络实现。Vite 在编译时会根据.env文件注入对应的值HBuilderX 打包时也会读取同样的环境变量。TypeScript 类型支持方面安装uni-helper/uni-app-types后在tsconfig.json的types数组里加上它.vue文件里的uni.request就有完整提示了。这一步和 AI 配置无关但能显著减少拼写错误。4. HBuilderX 侧配置config.toml 与打包链路HBuilderX 这边不直接读.env文件它有自己的环境变量机制。如果你用 HBuilderX 的 CLI 打包可以在项目根目录建一个config.toml来管理打包参数。这个文件不是 uni-app 官方标准而是 HBuilderX CLI 支持的配置格式# config.toml [app] name 我的跨端应用 appid __UNI__XXXXXXX [build] platform app mode release [env] VITE_AI_BASE_URL https://taotoken.net/api/v1 VITE_AI_DEFAULT_MODEL gpt-4o注意VITE_AI_API_KEY不要写进config.toml因为这个文件通常会提交到仓库。Key 应该通过 HBuilderX 的“运行配置”或系统环境变量注入。在 HBuilderX 里点击“运行” → “运行到手机或模拟器” → “运行配置”可以添加自定义环境变量。打包时同理在“发行” → “原生App-云打包”的配置页里注入。如果你习惯在 VSCode 里写代码、HBuilderX 里只做打包那流程是这样的VSCode 里执行pnpm build:app生成dist/build/app目录然后在 HBuilderX 里“文件” → “导入” → “从本地目录导入”选择这个dist/build/app文件夹。HBuilderX 会把它识别为一个可打包的 App 项目双击manifest.json配置 AppID 和图标然后“发行” → “原生App-云打包”。这里有个坑要避开不要直接把整个源码目录导入 HBuilderX 再让它编译。两个 IDE 的编译链路不同Vite 的产物和 HBuilderX 的编译器可能产生冲突表现为样式错乱或 API 调用失败。正确做法是 VSCode 负责编译HBuilderX 只负责打包职责分离。manifest.json里的 AppID 是云打包的必需项。如果显示__UNI__开头的临时 ID点击“重新获取”按钮登录 DCloud 账号后会分配一个唯一标识。这个 ID 和 TaoToken 的 Key 是两回事前者标识你的 App 应用后者标识你的 API 调用身份。5. 验证请求H5 与小程序端跑通 AI 调用配置写完了得验证链路是否通。先写一个最简单的测试页面放在src/pages/index/index.vuetemplate view classcontent button clicktestAI测试 AI 调用/button text{{ result }}/text /view /template script setup langts import { ref } from vue import { chatCompletion } from /utils/ai const result ref(等待测试...) async function testAI() { try { const res: any await chatCompletion({ messages: [ { role: user, content: 用一句话介绍 uni-app } ] }) result.value res.choices[0].message.content } catch (e: any) { result.value 出错: ${e.message} } } /script在 VSCode 终端执行pnpm dev:h5浏览器打开后点击按钮。如果返回了模型输出说明 H5 端链路通了。接着测小程序端执行pnpm dev:mp-weixin用微信开发者工具打开dist/dev/mp-weixin目录。点击按钮前确认微信开发者后台的 request 合法域名里加了https://taotoken.net。如果没加开发者工具里可以临时勾选“不校验合法域名”来测试但真机预览必须配置。App 端的验证稍微麻烦一点需要真机或模拟器。执行pnpm dev:app生成dist/dev/app用 HBuilderX 导入后运行到手机。App 端没有域名白名单限制但要注意 Android 9 以上默认禁止明文 HTTP而 TaoToken 是 HTTPS所以没问题。三端都跑通后你会看到同一个chatCompletion函数在不同平台返回一致的结果。这就是统一 Key 接入的价值——不用为每个端写不同的请求逻辑也不用担心某个端的 Key 过期导致整个项目挂掉。如果 H5 通了但小程序报 401先检查Authorization头有没有被小程序拦截。有些小程序基础库版本对自定义 header 有限制可以改成token字段放在 body 里TaoToken 也支持这种传法。具体参考 https://taotoken.net/doc 的鉴权章节。6. 本篇常见错排查报错一request:fail url not in domain list这是小程序端最常见的。原因就是taotoken.net没加到微信后台的 request 合法域名。解决方式登录微信公众平台 → 开发 → 开发管理 → 开发设置 → 服务器域名 → request 合法域名添加https://taotoken.net。注意必须是 HTTPS且不能带路径。开发阶段可以在开发者工具“详情” → “本地设置”里勾选“不校验合法域名”但上线前必须配好。报错二401 UnauthorizedKey 没传对或者过期了。检查.env文件里的VITE_AI_API_KEY是否以sk-开头有没有多余空格。如果用的是 HBuilderX 打包确认环境变量注入到了正确的构建阶段。还有一个容易忽略的点Vite 只会把VITE_开头的变量暴露给客户端代码如果你写成AI_API_KEY而不加前缀import.meta.env里读不到。报错三pages.json注释报红VSCode 没把pages.json识别为jsonc。回到第 3 节的files.associations配置确认键名是pages.json而不是**/pages.json。改完后重启 VSCode 生效。报错四HBuilderX 导入dist/build/app后无法打包检查manifest.json里的 AppID 是否已获取。如果还是__UNI__临时 ID云打包会拒绝。另外确认dist/build/app目录下有manifest.json和pages.json如果 Vite 编译时没生成这两个文件说明vite.config.ts里的 uni-app 插件配置有问题。报错五pnpm install时uni-helper类型包安装失败在用户目录的.npmrc里加一行shamefully-hoisttrue然后删掉node_modules重新安装。pnpm 的严格依赖隔离有时会导致类型包找不到 peer 依赖这个配置能解决大部分情况。报错六模型返回空内容检查请求体里的model字段是否拼写正确。TaoToken 的模型名和官方一致比如gpt-4o-mini、claude-3-5-sonnet等。如果模型名错了接口可能返回 200 但choices为空。到 https://taotoken.net/models 核对可用模型列表。7. 长期编码与 Agent 场景的 Key 管理建议如果你只是偶尔在项目里调一下 AI上面这套配置够用了。但如果你打算把 AI 辅助编码长期集成到工作流里——比如用 Cursor 或 Claude Code 做日常开发——那 Key 的管理方式需要升级。TaoToken 的 Coding Plan 就是为这种场景设计的它提供一个长期有效的 Key支持在多个 IDE 和 Agent 工具间共享不用每次换工具都重新配一遍。具体来说你可以在 https://taotoken.net/coding-plan 订阅后拿到一个专用 Key然后在 VSCode 的 AI 插件、HBuilderX 的辅助工具、以及命令行 Agent 里统一使用。这样跨端项目的 AI 能力就真正做到了“一处配置处处可用”。对于需要频繁切换模型对比效果的场景还可以在请求参数里动态指定model而不用改环境变量重新编译。回到 uni-app 项目本身建议把chatCompletion封装成 composable比如useAI()在多个页面间复用。同时给请求加上重试和降级逻辑——主模型超时后自动切到备用模型这在跨端网络不稳定的情况下特别有用。这些进阶用法我会在后续文章里展开先把今天的配置跑通再说。