SKILL.md
uni-app x
本 skill 基于 uni-app x 文档生成，生成日期 2026-01-29。
uni-app x 是下一代 uni-app，跨平台应用开发引擎。包含 UTS 语言、uvue 渲染引擎、uni 组件与 API 及扩展机制。适用于需要为 Agent 提供「如何用 uni-app x 写页面、组件、API、UTS、样式与工程配置」等能力说明的场景。
核心参考
| 主题 | 说明 | 参考 |
|---|---|---|
| 项目结构 | 新建项目、目录结构、运行与发行 | [core-project](references/core-project.md) |
| 页面与 uvue | 页面文件、构成、pages.json | [core-page](references/core-page.md) |
| 页面生命周期 | onLoad、onShow、onReady、onBackPress 等 | [core-lifecycle](references/core-lifecycle.md) |
| App.uvue | 应用入口、应用生命周期、globalData、全局样式 | [core-app](references/core-app.md) |
| manifest.json | 应用配置、appid、版本、图标、uni-app-x 标识 | [core-manifest](references/core-manifest.md) |
| 编译器与静态资源 | 条件编译、static、编译缓存 | [core-compiler](references/core-compiler.md) |
UTS 语言
| 主题 | 说明 | 参考 |
|---|---|---|
| UTS 概述 | 类型声明、变量/常量、与 TS 的差异 | [uts-overview](references/uts-overview.md) |
| 数据类型 | boolean、number、string、Array、UTSJSONObject、type | [uts-data-type](references/uts-data-type.md) |
| 与 JS 开发差别 | 强类型、data 类型、事件参数类型 | [features-codegap](references/features-codegap.md) |
| 条件编译 | #ifdef APP-ANDROID、平台与项目类型判断 | [uts-conditional](references/uts-conditional.md) |
| 函数与模块 | 函数定义、异常 try-catch、export/import | [uts-function-module](references/uts-function-module.md) |
Vue / uvue
| 主题 | 说明 | 参考 |
|---|---|---|
| uvue 概述 | SFC、template/script/style、组合式与选项式 | [vue-uvue](references/vue-uvue.md) |
| 组件 | 创建、easycom、手动引用、ref 与 defineExpose | [vue-component](references/vue-component.md) |
| 内置指令 | v-if、v-for、v-show、v-model、v-bind、v-html 等 | [features-vue-directives](references/features-vue-directives.md) |
| 组件标志 | id、ref、UniElement、getElementById、createXXXContext | [features-idref](references/features-idref.md) |
| 组合式 API | ref、computed、watch、reactive、readonly、watchEffect | [vue-composition-api](references/vue-composition-api.md) |
| 数据绑定与修饰符 | 响应式状态、事件修饰符、v-model 修饰符 | [vue-data-bind-modifier](references/vue-data-bind-modifier.md) |
样式 (CSS/ucss)
| 主题 | 说明 | 参考 |
|---|---|---|
| uvue CSS | flex 布局、样式不继承、选择器与优先级 | [css-ucss](references/css-ucss.md) |
组件与 API
| 主题 | 说明 | 参考 |
|---|---|---|
| 组件概述 | 内置组件、自定义组件、easycom、uts 组件 | [features-component-overview](references/features-component-overview.md) |
| API 概述 | uni API、全局 API、原生 API 调用 | [features-api-overview](references/features-api-overview.md) |
| 路由与跳转 | navigateTo、redirectTo、reLaunch、switchTab、navigateBack、参数传递 | [features-navigation](references/features-navigation.md) |
| 本地存储 | setStorageSync、getStorageSync、key-value、对象需 as UTSJSONObject | [features-storage](references/features-storage.md) |
| 页面栈与当前页 | getCurrentPages、UniPage、this.$page、getDialogPages | [features-get-current-pages](references/features-get-current-pages.md) |
| dialogPage | 弹窗页、openDialogPage、closeDialogPage、与主 page 区别 | [features-dialog-page](references/features-dialog-page.md) |
| 全局状态 | globalData、专用 store 模块（reactive） | [features-global-state](references/features-global-state.md) |
| 长列表与滚动 | scroll-view、list-view、吸顶、嵌套滚动、sticky-header | [features-list-scroll](references/features-list-scroll.md) |
| request 与网络 | 流式响应、cookie、拦截器、泛型与 Task 释放 | [features-api-request](references/features-api-request.md) |
| 事件与系统信息 | uni.$on/$emit、getLaunchOptionsSync、getSystemInfo | [features-api-event-system-info](references/features-api-event-system-info.md) |
| DOM 与 UniElement | getElementById、ref、样式与 draw API、跟手动效 | [features-dom](references/features-dom.md) |
| 表单 form | submit/reset、form-type、子组件与数据提交 | [features-form](references/features-form.md) |
| 宽屏适配 | leftWindow/rightWindow、页面作组件、窗体通信 | [features-adapt](references/features-adapt.md) |
| 国际化 | 多语言、lime-i18n、vue-i18n(Web)、uni.getLocale | [features-i18n](references/features-i18n.md) |
| 主题与暗黑 | theme.json、setAppTheme、onAppThemeChange、pages.json 样式 | [features-theme-dark](references/features-theme-dark.md) |
| 编译到 Web | SPA、与 App 差异、refs 类型、SSR 简述 | [features-web](references/features-web.md) |
教程与最佳实践
| 主题 | 说明 | 参考 |
|---|---|---|
| request 联网 | UTSJSONObject 与 type 泛型处理接口数据 | [best-practices-request](references/best-practices-request.md) |
| 选项式转组合式 | 改造要点、生命周期与 ref 类型 | [best-practices-options-to-composition](references/best-practices-options-to-composition.md) |
| 性能优化 | DOM 数量、动画用 transform、长列表与分批加载 | [best-practices-performance](references/best-practices-performance.md) |
| 语言服务与 AI | 语言服务插件、Cursor/VSCode、AI Rules、MCP、AI 修复 | [tutorial-ls-ai-rules](references/tutorial-ls-ai-rules.md) |
进阶
| 主题 | 说明 | 参考 |
|---|---|---|
| 原生 SDK 与混合开发 | 嵌入原生工程、导出应用原生资源、集成文档 | [advanced-native-sdk](references/advanced-native-sdk.md) |