SuperAPI AI 工具集

miniprogram-development

编程与开发

查看项目

更新于 10-16 05:45

技能介绍

用途:面向微信小程序开发,适用于开发小程序页面与组件、集成 CloudBase 能力(数据库、云函数、存储)、部署与预览项目、处理认证与用户身份、在小程序中调用 AI 模型、获取微信步数数据。不适用于 Web 前端开发、后端服务开发,以及仅做 UI 设计(后者可用 ui-design 技能,也可与本技能组合)。

主要能力与规范:项目结构上,小程序代码一般放在 miniprogram 目录,云函数放在 cloudfunctions 目录,project.config.json 需指定 miniprogramRoot 等配置;生成页面时必须包含 index.json 等页面配置文件,基础库使用最新版本。认证方面,带 CloudBase 的小程序天然免登录,禁止生成登录页或登录流程,云函数中通过 cloud.getWXContext().OPENID 获取用户身份。资源方面,图标推荐 Icons8,URL 形如 https://img.icons8.com/{style}/{size}/{color}/{icon-name}.png,style 取 ios 或 ios-filled,size 推荐 100,color 为不带 # 的十六进制色值,并用 downloadRemoteFile 工具下载,确保引用资源存在以避免构建错误。

使用方式:检测到小程序项目后,建议用微信开发者工具预览、调试与发布;打开前确认 project.config.json 已配置 appid,否则需向用户索取。CLI 打开命令:Windows 为 "C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat" open --project "项目根目录路径",macOS 为 /Applications/wechatwebdevtools.app/Contents/MacOS/cli open --project "/path/to/project/root",路径指向含 project.config.json 的目录。使用 wx.cloud 时需指定环境 ID,可通过 envQuery 工具查询。

AI 与步数:基础库 3.7.1+ 支持直接调用 AI 模型,用 wx.cloud.extend.AI.createModel("deepseek") 创建实例,通过 model.streamText 传入 system 与 user 消息并循环读取 textStream。微信步数须用 CloudID 方式(基础库 2.7.0+):前端 wx.getWeRunData() 取 cloudID,经 wx.cloud.CloudID(cloudID) 传给云函数,云函数用 weRunData.data 取解密数据并检查 errCode;禁止 session_key 手动解密,且必须实现模拟数据兜底。

限制与注意:AI 自动部署云函数后可能缺少云调用等权限,建议在开发者工具中右键云函数选择“云端安装依赖”,需要云调用权限的功能建议手动部署一次;遇权限问题提示检查服务授权与 API 权限配置。完成后主动建议真机预览、调试与发布。其余细节资料暂未提供。