跳到主要内容

小程序成长计划使用指南

使用生文模型​

成长计划赠送的 Token 可在小程序中直接调用生文大模型，根据运行环境选择对应的 SDK：

调用示例：

// 资源点套餐可用 cloudbase 或 hunyuan-v3；非资源点套餐仅可用 hunyuan-v3
const model = ai.createModel("cloudbase"); // 或 "hunyuan-v3"
const res = await model.invoke({
  model: "hy3", // 或 "hy3-preview"
  messages: [{ role: "user", content: "你好" }],
});

两个 provider 的区别如下：

对比项cloudbasehunyuan-v3
免费额度消耗来源允许时，优先消耗免费额度仅消耗免费额度
免费额度耗尽自动消耗套餐额度报错
来源不允许时自动消耗套餐额度报错
套餐额度支持不支持
适用套餐仅限资源点套餐资源点套餐、非资源点套餐均可使用
模型开关需在控制台手动开启 hy3、hy3-preview，也可关闭无需开启，也不支持关闭
使用说明

「小程序成长计划」赠送的免费额度仅限小程序和云开发服务端使用。在 AI 工具等场景中调用 hy3、hy3-preview 将从套餐中正常扣除，套餐充足即可正常使用。

在非小程序场景下，建议优先使用 deepseek-v4-flash、qwen3.5-flash、glm-5.2、kimi-k2.6、minimax-m3 等模型。详情请阅读 关于「小程序成长计划 AI 资源包」使用范围的专项治理公告。

使用生图模型​

小程序成长计划赠送的生图资源可调用混元生图模型，根据文本描述生成图片。图片生成功能仅支持在服务端（云函数/云托管）中调用。

好的 prompt 能显著提升生图效果：

  • 描述主体：「一只橘猫」→「一只圆润可爱的橘猫，大眼睛，短腿」
  • 指定风格：加入「水彩风格」「油画风格」「赛博朋克」「写实摄影」等描述
  • 描述场景与光线：「阳光充足的咖啡馆」「黄金时段柔和侧光」
  • 指定构图：「特写」「俯拍」「远景」「中心对称构图」

示例：

一只胖胖的橘猫，坐在阳光下的木质窗台上打盹，温暖的阳光照在毛茸茸的毛发上，水彩插画风格，柔和暖色调，画面温馨治愈

调用示例：

const imageModel = ai.createImageModel("hunyuan-image");

// 文生图
const res1 = await imageModel.generateImage({
  model: "HY-Image-3.0-Plus-4090-Tob-v1.0",
  prompt: "一只在草地上的猫",
  size: "1024x1024",
});

// 图生图（需传入垫图）
const res2 = await imageModel.generateImage({
  model: "HY-Image-v3.0-I2I-ToB-v1.0.1",
  prompt: "将这张照片转换为油画风格",
  image_urls: ["https://example.com/reference.jpg"],
  revise: { value: true },
});

用 AI 工具开发小程序​

通过 CloudBase MCP 把 Cursor、CodeBuddy、OpenClaw、Claude Code、VS Code、WorkBuddy 等各类 AI 编程工具连接到云开发平台，你可以用自然语言描述需求，由 AI 自动完成从代码生成到部署上线的完整流程，无需手动配置环境或在 IDE 与控制台之间切换。

MCP（Model Context Protocol）负责把 AI 工具与云开发环境安全地连接起来并提供操作技能，Skills（技能包）则把云开发的最佳实践与规范注入 AI。两者搭配使用，AI 既「有权限」操作云资源，又「懂规矩」按生产级方式写代码。

第 1 步：连接 CloudBase​

根据你的 AI 工具选择接入方式：

  • 一键安装插件（推荐）：Codex、Claude Code、WorkBuddy 等支持插件市场的 AI 编程助手，可一键安装 CloudBase 插件，插件同时捆绑了 MCP 与 Skills，一次安装即可使用。详见 CloudBase AI 插件。
  • 手动配置 MCP 连接：Cursor、VS Code 和其他不支持 marketplace 的 IDE，可手动添加 CloudBase MCP Server，支持本地模式（本机 npx 运行）与托管模式（HTTP 连接云端）。详见 连接 CloudBase MCP。

连接后，在 AI 对话中输入「登录云开发」，按提示完成登录与环境选择即可开始开发。

第 2 步：安装 CloudBase Skills（可选，但推荐）​

Skills 把云开发的领域知识打包成「技能包」，与 MCP 搭配效果最好。在项目根目录执行：

npx skills add tencentcloudbase/cloudbase-skills

安装完成后 Skills 会出现在当前项目中（如 .cursor/skills、.claude/skills 等，视工具而定）。你也可以直接对 AI 说「安装 CloudBase Skills」。详细说明见 如何使用 Skill。

开发小程序时，AI 会自动加载 miniprogram-development 这一专项技能，覆盖微信小程序项目结构、tabBar 配置、CloudBase 集成等最佳实践。如需单独安装它：

npx skills add https://github.com/tencentcloudbase/skills --skill miniprogram-development

第 3 步：用自然语言开发小程序​

完成连接后，直接对 AI 描述需求即可。例如：

帮我开发一个待办事项小程序，包含添加、删除、编辑待办事项，数据存到云数据库，支持标记完成状态，并部署到云端

AI 会自动完成：搭建小程序项目、创建云数据库集合、编写并部署云函数、配置静态托管，并返回预览或访问链接。你也可以在对话中分步操作，例如「创建用户表」「部署这个函数」「预览小程序」。

如果想让 AI 更稳定地使用小程序相关技能，可以在提问开头加一句路由约束，例如「先阅读 miniprogram-development 技能，再开始实现」。更多提示词场景与小程序的实战案例（如 WorkBuddy 开发微信小程序）见 视频及教程。

获取帮助​

遇到问题可前往 云开发社区 提问，也可加入交流群或提交工单，提供 1v1 专属客服。