1

2026-03-15 10:15:02 +08:00
parent 2dd217522c
commit 72bb11b34f
916 changed files with 65306 additions and 16102803 deletions
--- a/_DEL/wechat-miniprogram/POWER.md
+++ b/_DEL/wechat-miniprogram/POWER.md
@@ -0,0 +1,145 @@
+---
+name: "wechat-miniprogram"
+displayName: "微信小程序官方文档"
+description: "微信小程序开发官方文档查询工具，覆盖框架、组件、API、服务端、自定义组件等全部开发知识。当需要查阅小程序开发细节时，按需加载对应领域的 steering 文件获取权威参考。"
+keywords: ["微信小程序", "miniprogram", "wxml", "wxss", "wx.request", "小程序组件", "小程序API", "Page", "Component", "getApp", "小程序生命周期", "小程序登录", "小程序支付", "weixin", "wechat", "tdesign", "t-button", "t-cell", "t-dialog", "t-toast", "t-navbar", "t-tabs", "t-popup", "t-input", "t-picker", "t-tag", "t-search", "t-empty", "t-loading", "t-skeleton", "t-tab-bar", "t-avatar", "t-badge", "t-image"]
+author: "NeoZQYY"
+---
+
+# 微信小程序官方文档
+
+## Overview
+
+本 Power 是微信小程序官方开发文档的结构化知识库，覆盖框架核心概念、视图层、逻辑层、自定义组件、内置组件、前端 API、服务端 API 等全部开发领域。
+
+当 AI 需要回答小程序相关问题时，应根据问题领域加载对应的 steering 文件，获取官方文档的权威内容，而非依赖可能过时的训练数据。
+
+官方文档入口：https://developers.weixin.qq.com/miniprogram/dev/framework/
+
+## 文档结构与 Steering 文件索引
+
+以下 steering 文件按领域组织，按需加载：
+
+### framework-core.md — 框架核心
+- 小程序框架概述（MINA 架构：逻辑层 + 视图层）
+- 小程序配置（app.json / page.json / sitemap.json）
+- 目录结构与文件类型（.wxml / .wxss / .js / .json）
+- 场景值、兼容性、基础库版本
+
+### app-service.md — 逻辑层（App Service）
+- App() 注册程序、生命周期
+- Page() 注册页面、页面生命周期（onLoad/onShow/onReady/onHide/onUnload）
+- 页面路由（navigateTo/redirectTo/switchTab/reLaunch/navigateBack）
+- 模块化（require/module.exports）、文件作用域
+- API 调用方式（回调/Promise）
+- 页面间通信、EventChannel
+
+### view-layer.md — 视图层（WXML / WXSS / WXS）
+- WXML 语法：数据绑定、列表渲染(wx:for)、条件渲染(wx:if)、模板(template)、引用(import/include)
+- WXSS 样式：rpx 单位、样式导入(@import)、选择器支持范围、内联样式
+- WXS（WeiXin Script）：语法、模块、与 WXML 配合使用
+- 事件系统：冒泡/非冒泡事件、bind/catch/mut-bind、事件对象、dataset
+
+### custom-component.md — 自定义组件
+- 创建自定义组件（json/wxml/wxss/js 四文件）
+- Component() 构造器：properties / data / methods / lifetimes / pageLifetimes / observers
+- 组件模板和样式（slot、样式隔离 styleIsolation）
+- 组件间通信（properties 传值、triggerEvent 事件、selectComponent）
+- behaviors（代码复用，类似 mixins）
+- 数据监听器（observers）
+- 纯数据字段（pureDataPattern）
+- 组件间关系（relations）
+- 抽象节点（componentGenerics）
+- 用 Component 构造器构造页面
+
+### builtin-components.md — 内置组件
+- 视图容器：view / scroll-view / swiper / movable-view / cover-view
+- 基础内容：text / rich-text / progress / icon
+- 表单组件：button / input / textarea / picker / slider / switch / checkbox / radio / form
+- 导航：navigator
+- 媒体：image / video / camera / live-player / live-pusher
+- 地图：map
+- 画布：canvas
+- 开放能力：open-data / web-view / ad
+- 无障碍访问
+
+### frontend-api.md — 前端 API
+- 基础：wx.canIUse / wx.env / 系统信息
+- 路由：wx.navigateTo / wx.redirectTo / wx.switchTab / wx.reLaunch / wx.navigateBack
+- 界面：wx.showToast / wx.showModal / wx.showLoading / wx.showActionSheet / 导航栏 / TabBar / 下拉刷新
+- 网络：wx.request / wx.uploadFile / wx.downloadFile / WebSocket / TCP/UDP
+- 数据缓存：wx.setStorage / wx.getStorage / wx.removeStorage
+- 媒体：图片(wx.chooseImage/wx.previewImage) / 录音 / 音频 / 视频 / 相机
+- 位置：wx.getLocation / wx.openLocation / wx.chooseLocation
+- 文件：wx.saveFile / FileSystemManager
+- 开放接口：登录(wx.login) / 用户信息 / 支付(wx.requestPayment) / 授权 / 设置 / 收货地址 / 发票 / 生物认证 / 微信运动 / 订阅消息
+- 设备：蓝牙 / NFC / Wi-Fi / 电话 / 加速计 / 罗盘 / 陀螺仪 / 剪贴板 / 屏幕亮度 / 振动
+- Worker / 第三方平台 / WXML 节点查询(SelectorQuery / IntersectionObserver)
+- 画布 Canvas API
+
+### server-api.md — 服务端 API
+- 登录：code2Session（code 换 session_key + openid）
+- access_token 获取与管理
+- 用户信息解密（手机号、用户信息）
+- 消息推送（订阅消息、客服消息、模板消息）
+- 小程序码与二维码生成
+- 内容安全（文本/图片审核）
+- 数据分析
+- 物流助手
+- OCR / 直播 / 安全风控
+
+### login-auth.md — 登录与鉴权（重点）
+- wx.login() 获取 code 的完整流程
+- 服务端 code2Session 换取 openid / session_key / unionid
+- 自定义登录态设计（token 方案）
+- wx.checkSession() 检查 session_key 有效性
+- 手机号快速验证（getPhoneNumber）
+- 用户信息获取（getUserProfile 已废弃 → 头像昵称填写能力）
+- 授权流程（wx.authorize / wx.getSetting / wx.openSetting）
+- 常见登录架构与安全注意事项
+
+### best-practices.md — 开发最佳实践与常见坑
+- setData 性能优化（减少数据量、避免频繁调用）
+- 分包加载（subpackages / 独立分包 / 分包预下载）
+- 图片优化与懒加载
+- 页面栈管理（最多 10 层）
+- 小程序与 H5 差异（无 DOM/BOM、不支持 window/document）
+- TypeScript 支持
+- npm 支持与构建
+- 自定义 tabBar
+- 骨架屏
+- 常见审核被拒原因与规避
+
+### tdesign.md — TDesign 小程序组件库
+- TDesign 安装与配置（npm 构建、TS 配置、基础库要求）
+- 完整组件列表（60+ 组件，按基础/导航/输入/数据展示/反馈分类）
+- 常用组件用法示例（Button / Input / Cell / Dialog / Toast / Popup / Tabs / Navbar / TabBar / Search / Empty / Loading / Skeleton）
+- 样式覆盖 4 种方式（style 属性 / 解除隔离 / 外部样式类 / CSS 变量）
+- 自定义主题（全局 Design Token / CSS Variables）
+- 深色模式适配
+
+## 使用方式
+
+当遇到小程序相关问题时：
+
+1. 根据问题领域，使用 `readSteering` 加载对应的 steering 文件
+2. 如果不确定属于哪个领域，先加载 `framework-core.md` 了解整体架构
+3. 登录/鉴权问题优先加载 `login-auth.md`
+4. 组件用法问题加载 `builtin-components.md` 或 `custom-component.md`
+5. API 调用问题加载 `frontend-api.md` 或 `server-api.md`
+6. TDesign 组件用法/样式定制加载 `tdesign.md`
+
+## 在线查询
+
+如果 steering 文件中的信息不够详细，可以直接访问官方文档页面获取最新内容：
+
+- 框架：https://developers.weixin.qq.com/miniprogram/dev/framework/
+- 组件：https://developers.weixin.qq.com/miniprogram/dev/component/
+- API：https://developers.weixin.qq.com/miniprogram/dev/api/
+- 服务端 API：https://developers.weixin.qq.com/miniprogram/dev/api-backend/
+- 配置参考：https://developers.weixin.qq.com/miniprogram/dev/reference/
+- 开发者工具：https://developers.weixin.qq.com/miniprogram/dev/devtools/devtools.html
+- TDesign 组件总览：https://tdesign.tencent.com/miniprogram/overview
+- TDesign 具体组件：https://tdesign.tencent.com/miniprogram/components/{组件名}
+
+使用 `webFetch` 工具抓取对应页面即可获取最新文档内容。