uniapp-dev-guide

uniapp-dev-guide 是一个面向 AI 开发工具、Agent 工具链和技能系统的 uni-app 开发指南，目标是把商业级多端开发里最常见的规范、坑点和工程实践整理成可直接调用的知识包与技能包。

它覆盖的主题包括：

• 样式规范与跨端适配
• 组件与页面生命周期
• 网络请求、存储与设备能力
• Pinia/Vuex 状态管理
• TypeScript 项目实践
• renderjs、WXS、自定义导航栏
• 登录、支付、分享
• 性能优化、调试部署、平台差异
• nvue、uni-app x、uniCloud 相关能力

目录结构

.
├── SKILL.md
├── references/
└── scripts/

• SKILL.md：技能入口与主文档
• references/：按专题拆分的详细参考资料
• scripts/：可复用的模板和工程脚手架片段

安装方式

将本仓库克隆到本地后，可按你的 AI 开发工具或 Agent 框架的技能目录约定进行安装。下面以兼容 Codex 的目录结构为例：

git clone https://github.com/shangyankeji/uniapp-dev-guide.git
cp -R uniapp-dev-guide ~/.codex/skills/uniapp-dev-guide

如果你使用的是自定义技能目录，请改成你的实际路径。

使用方式

在支持技能调用的 AI 开发环境中，当你在开发 uni-app 项目，或遇到以下问题时使用该技能：

• 组件写法、页面路由、生命周期
• 跨平台适配和样式兼容
• 请求封装、状态管理、TypeScript
• 性能优化、原生能力、调试部署

技能主入口见 SKILL.md。如果你使用的是 Codex，也可以直接按其技能目录规范接入。

适用范围

• 微信/支付宝/百度/抖音等小程序
• H5
• App（iOS/Android）
• 鸿蒙应用

开源说明

本仓库以 MIT 许可证开源，欢迎 Fork、改进和补充案例。

免责声明

本项目是面向工程实践的社区技能整理，不代表 uni-app 官方立场。涉及平台政策、支付能力、审核规则等事项时，请以各平台最新官方文档为准。