用途：在浏览器/Web 前端应用中通过 @cloudbase/js-sdk 调用 AI 模型，适用于页面、H5、React/Vue/Next/Nuxt、仪表盘 UI 等场景。默认走前端直连，不先建议 Node.js、云函数或 CloudRun 代理；仅当用户明确要求后端调用、图片生成或需服务端密钥/长任务时才改用 ai-model-nodejs。微信小程序用 ai-model-wechat，无 CloudBase SDK 的运行时用 http-api-cloudbase。
主要能力：文本生成、流式响应，可从浏览器调用 Hunyuan、DeepSeek、GLM、Kimi、MiniMax 等模型。
关键用法：ai.createModel(...) 只接受三种合法参数——"cloudbase"（主托管组，推荐）、"hunyuan-exp"（旧内置组，仅当环境明确返回时）、"custom-<名称>"（自定义组，须以 custom- 开头）。厂商名或模型名不能作为参数，模型 id 放入 generateText/streamText 的 model 字段。
必要前置检查：先通过 MCP 工具 queryEnv 获取 EnvId；再检查 Token Credits 资源包（DescribeEnvPostpayPackage，postpayPackageId 以 pkg_tcb_tokencredits_ 开头且状态非 3/4）；然后检查组就绪（DescribeAIModels），确认目标模型已启用，缺失时用 DescribeManagedAIModelList 查权威目录与价格，再用 UpdateAIModel（Status:1，Models 为全量替换）启用。
安装与初始化：npm install @cloudbase/js-sdk；用 cloudbase.init({ env, accessKey }) 初始化，通过 auth.getSession() 判断登录（不要用已废弃的 getLoginState()）。匿名用户默认无 AI 调用权限，需真实登录，登录流程交由 auth-tool-cloudbase 与 auth-web-cloudbase 技能处理。
限制：匿名登录不可用于 AI；自定义模型计费由第三方提供方承担，不消耗 Token Credits；内置组不可删除；模型清单会变化，不应在代码中硬编码具体 SKU。