Weapp docs

WeApp Docs

微信小程序官方文档的本地、AI 友好镜像。正文位于 references/docs/；不要一次性读取整套文档，应先检索，再按需读取最少的相关页面。

检索流程

1. 判断问题类型：具体 API、组件、开发主题，或自由关键词。
2. 在 Skill 根目录运行最精确的检索：

python scripts/search.py --api wx.login
python scripts/search.py --component scroll-view
python scripts/search.py --topic login-auth
python scripts/search.py "分包 预下载"

3. 使用 read 打开结果中的 references/docs/... 文件。
4. 如果问题跨主题，最多先读 2–5 篇最相关文档，再根据文内本地链接继续。
5. 实现或修复代码时，以查到的版本要求、参数、返回值、限制和错误码为依据；不要仅凭记忆补全微信 API。

精确查找

wx.* API

python scripts/search.py --api wx.request

映射数据：references/meta/api-map.json。

组件

python scripts/search.py --component swiper

映射数据：references/meta/component-map.json。

开发主题

python scripts/search.py --list-topics
python scripts/search.py --topic performance

主题包括登录授权、网络、支付、订阅消息、分包与性能、隐私、Skyline、云开发等。人类可读导航见 references/TOPICS.md。

自由关键词

python scripts/search.py "手机号 授权"
python scripts/search.py "setData 性能" --limit 10
python scripts/search.py "蓝牙 BLE" --json

检索标题、路径、摘要与 API 名。需要更宽泛的全文搜索时，再使用：

rg -n "关键词" references/docs

文档分区

需求	目录
指南、生命周期、路由、视图层、分包、性能	references/docs/framework/
WXML 组件属性与事件	references/docs/component/
客户端 wx.* API	references/docs/api/
app.json、Page/App/Component、WXML/WXS 参考	references/docs/reference/
开发者工具、调试、CI	references/docs/devtools/
服务端 API	references/docs/server/
云开发与云托管	references/docs/wxcloudservice/
行业、商业、多端、扩展能力	references/docs/platform-capabilities/
小程序 AI 开发模式	references/docs/ai/

各分区先看 TOC.md。更完整的检索说明见 references/RETRIEVAL.md，全量分区目录见 references/CATALOG.md。

常见入口

• 起步：references/docs/framework/quickstart/getstart.md
• 框架总览：references/docs/framework/MINA.md
• 全局配置：references/docs/reference/configuration/app.md
• Page：references/docs/reference/api/Page.md
• 自定义组件：references/docs/framework/custom-component/
• 登录：references/docs/framework/open-ability/login.md
• wx.login：references/docs/api/open-api/login/wx.login.md
• 网络：references/docs/framework/ability/network.md
• wx.request：references/docs/api/network/request/wx.request.md
• 开发者工具：references/docs/devtools/devtools.md

使用约束

• 优先引用本地文档路径，并说明对应官方来源；每篇正文顶部保留了来源 URL。
• 区分客户端 API、服务端 API、组件与框架配置，不要把同名能力混用。
• 检查“最低基础库版本”、平台支持、权限申请、类目限制、收费与隐私要求。
• 文档镜像是抓取时快照。涉及当前版本分布、下载链接、价格、配额、开放范围或近期变更时，应明确日期，并在必要时重新核对官网。
• references/docs/devtools/log.md 是动态版本壳页；完整开发者工具更新日志使用 references/docs/devtools/uplog.md。
• 图片仍可能引用官网 CDN；正文和代码无需联网即可查阅。

校验 Skill 包

python scripts/verify.py

该命令检查必需文件、索引条目、API/组件/主题映射与文档正文是否完整。