mcpField
A
auth-wechat-miniprogram

auth-wechat-miniprogram

github.com/tencentcloudbase安全792.2k 次安装今天更新
代码仓库

关于 auth-wechat-miniprogram

auth-wechat-miniprogram 是面向编码 Agent 的 CloudBase 技能，用于处理微信小程序身份与认证，说明云函数如何获得原生身份，并区分此流程与网页登录或服务商配置。

主要功能

  1. 01说明小程序自动认证机制
  2. 02介绍 OPENID、APPID 和 UNIONID
  3. 03指导在云函数中读取身份
  4. 04明确技能适用范围
  5. 05指向相关 CloudBase 技能

适用场景

  1. 01实现需要身份信息的小程序流程
  2. 02在云函数中读取用户身份
  3. 03使用 CloudBase 初始化小程序
  4. 04测试小程序认证

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tencentcloudbase/skills --skill auth-wechat-miniprogram

安装后在 Claude Code 中输入/auth-wechat-miniprogram确认已加载。

附带文件LICENSE.mdreferences/extended-guide.md

详细介绍

同级技能（仅本地）

同级 CloudBase 技能与此技能一同发布。使用 ../auth-tool-cloudbase/SKILL.md 等本地相对路径。

如果当前环境中缺少引用的同级技能文件，请让用户安装完整的 CloudBase 插件（或缺失的技能）。不要通过 HTTP 将远程技能或协议 Markdown 获取到 Agent 上下文中。

激活约定

以下情况优先使用此技能
  • 任务涉及微信小程序身份验证行为、wx.cloud 身份、OPENID / UNIONID，或小程序调用方在 CloudBase 中的身份识别方式。
  • 项目是 CloudBase 小程序，且身份验证问题涉及原生小程序身份，而非服务提供方配置。
编写代码前阅读（如果）
  • 请求提到了小程序登录、云函数中的用户身份，或 wx.cloud 身份验证假设。
  • 用户期望小程序使用 Web 风格的登录页面或显式令牌交换；应引导用户了解原生小程序身份验证行为。
接下来也要阅读
  • 小程序项目实现 -> ../miniprogram-development/SKILL.md
  • 云函数实现 -> ../cloud-functions/SKILL.md
以下情况不要使用
  • 基于 Web 的微信登录或 Web 身份验证界面。
  • 服务提供方启用/停用或身份验证控制台设置。
  • 小程序身份处理之外的通用 Node 端身份验证流程。
常见错误 / 注意事项
  • 为 wx.cloud 小程序生成 Web 风格的登录页面。
  • 将小程序身份验证当作服务提供方配置问题处理。
  • 忘记调用方身份会自动注入云函数。

何时使用此技能

在 CloudBase 项目中进行微信小程序身份验证时使用此技能。

以下情况适用：

  • 使用 CloudBase 实现能够识别身份的微信小程序流程
  • 在云函数中访问用户身份（openid、unionid）
  • 了解微信身份验证如何与 CloudBase 集成
  • 构建需要识别用户身份的小程序功能

主要优势：CloudBase 的微信小程序身份验证无缝且自动，无需复杂的 OAuth 流程。小程序调用云函数时，用户的 openid 会自动注入，并由微信验证。

不要用于：

  • 基于 Web 的微信登录（使用 auth-web 技能）
  • 使用 Node SDK 进行服务端身份验证（使用 auth-nodejs 技能）
  • 非微信身份验证方式（使用相应的身份验证技能）

如何使用此技能（面向编码 Agent）

  1. 确认 CloudBase 环境

    • 向用户询问：
      • env – CloudBase 环境 ID
      • 确认小程序已关联到 CloudBase 环境

  2. 了解身份验证流程

    • 微信小程序身份验证是原生且自动的
    • 大多数情况下无需显式调用登录 API
    • 云函数中可自动获取用户身份
    • CloudBase 会处理所有身份验证

  3. 从此文件中选择一个场景

    • 若要在云函数中获取基本用户身份，请使用场景 2
    • 若要初始化小程序，请使用场景 1
    • 若要从小程序调用云函数并获取用户身份，请使用场景 3
    • 若要测试身份验证，请使用场景 4

  4. 严格遵循 CloudBase API 格式

    • 在云函数中使用 wx-server-sdk
    • 在小程序客户端代码中使用 wx.cloud
    • 将此文件中的方法名称和参数格式视为标准

  5. 如果不确定某个 API

    • 查阅 CloudBase 官方小程序文档
    • 仅使用官方文档中列出的方法

核心概念

微信小程序如何通过 CloudBase 进行身份验证

  1. 自动身份验证：

    • 小程序用户调用云函数时，微信会自动注入用户身份信息
    • 无需复杂的 OAuth 流程或令牌管理
    • CloudBase 会验证身份信息的真实性

  2. 用户标识符：

    • OPENID – 用户在此小程序中的唯一标识符
    • APPID – 小程序的 App ID
    • UNIONID – （可选）同一微信开放平台账号下所有应用中的唯一标识符
      • 仅当小程序绑定了微信开放平台账号时才可用
      • 可用于在多个小程序或公众号中识别同一用户

  3. 安全性：

    • openid、appid 和 unionid 均经过验证且可信
    • 微信已完成身份验证
    • 开发者无需额外验证即可直接使用这些标识符

  4. 无需显式登录：

    • 用户使用小程序时会自动通过身份验证
    • 多数情况下无需调用登录 API
    • 云函数可立即获取用户身份信息

扩展指南

如需了解详细场景、示例和模式，请阅读 extended-guide.md。

参考索引

所有已打包的参考文件（技能 lint 可达性所必需）：

评论

支持 Markdown