uni-halo/.agents/skills/uniapp-project/UPDATE_PLAN.md

uni-app 技能更新计划

更新目标

确保所有 uni-app 相关技能与官方文档一一对应，每个组件和 API 都有独立的示例文件，包含原文档地址和官网全部示例。

当前进度

✅ 已完成

1. 核对清单创建: 已创建 CHECKLIST.md，列出所有需要核对的内容
2. 目录结构创建: 已创建 examples/api/ 和 examples/components/built-in/ 目录结构
3. 示例文件创建:
   • ✅ examples/api/network/request.md - uni.request 完整示例
   • ✅ examples/api/storage/set-storage.md - uni.setStorage 完整示例
   • ✅ examples/api/ui/show-toast.md - uni.showToast 完整示例
   • ✅ examples/components/built-in/view.md - view 组件完整示例
4. SKILL.md 更新: 已更新 SKILL.md，添加对示例文件的引用说明

🔄 进行中

1. API 示例文件创建: 已创建3个，剩余约50+个待创建
2. 组件示例文件创建: 已创建1个，剩余39个待创建

⏳ 待完成

1. 完成所有 API 示例文件 (约50+个文件)
2. 完成所有内置组件示例文件 (39个文件)
3. 创建 uni-app-x 完整文档 (组件 + API)
4. 验证所有文档链接
5. 补充缺失的 API

下一步行动

立即执行

1. 批量创建 API 示例文件

   • 优先创建常用 API: navigation, media, location, device
   • 每个文件包含：官方文档链接、概述、基础用法、完整示例（官网全部示例）、平台差异、注意事项

2. 批量创建组件示例文件

   • 优先创建常用组件: button, input, image, scroll-view, swiper
   • 每个文件包含：官方文档链接、概述、基础用法、完整示例（官网全部示例）、属性说明、平台兼容性

3. 创建示例文件模板

   • 为 API 和组件分别创建模板文件，便于批量生成

后续计划

1. uni-app-x 文档创建

   • 创建 uniappx-project 的完整组件和 API 文档
   • 参考 uni-app 的结构，但针对 uni-app-x 的特性

2. 文档链接验证

   • 检查所有文档中的官方链接是否正确
   • 确保所有链接可访问

3. 完整性检查

   • 对照官方文档，确保没有遗漏任何组件或 API
   • 检查每个示例文件是否包含官网全部示例

文件创建优先级

高优先级（立即创建）

API 示例:

• navigation: navigateTo, redirectTo, switchTab, navigateBack
• media: chooseImage, previewImage, chooseVideo
• location: getLocation, openLocation, chooseLocation
• device: getSystemInfo, getNetworkType

组件示例:

• button, input, image, scroll-view, swiper, text, icon

中优先级（后续创建）

API 示例:

• 其他网络 API: uploadFile, downloadFile, WebSocket
• 其他存储 API: getStorage, removeStorage, clearStorage
• 其他 UI API: showModal, showActionSheet, showLoading
• 文件 API: saveFile, getFileInfo
• 支付和分享 API

组件示例:

• 表单组件: checkbox, radio, picker, switch, textarea
• 媒体组件: video, audio, camera
• 其他组件: map, canvas, web-view

低优先级（最后创建）

• 不常用的 API 和组件
• 平台特定的 API 和组件

示例文件格式标准

每个示例文件应包含：

1. 标题和官方文档链接

   # [组件/API名称] - [描述]
   
   ## 官方文档
   参考官方文档：[链接]
   

2. 概述

   ## 概述
   [简要说明组件/API的用途]
   

3. 基础用法

   ## 基础用法
   [最简单的使用示例]
   

4. 完整示例

   ## 完整示例
   ### 示例 1: [场景描述]
   [代码示例]
   
   ### 示例 2: [场景描述]
   [代码示例]
   ...
   

5. 属性/参数说明（如适用）

   ## 属性说明
   | 属性名 | 类型 | 默认值 | 说明 |
   ...
   

6. 平台兼容性

   ## 平台兼容性
   | 平台 | 支持情况 |
   ...
   

7. 注意事项

   ## 注意事项
   1. ...
   2. ...
   

8. 参考资源

   ## 参考资源
   - **官方文档**: [链接]
   - **相关文档**: [链接]
   

质量检查清单

每个示例文件创建后，需要检查：

• 是否包含官方文档链接
• 是否包含基础用法示例
• 是否包含官网全部示例场景
• 代码示例是否可以直接运行
• 是否包含平台兼容性说明
• 是否包含注意事项
• 格式是否统一规范

预计工作量

• API 示例文件: 约50+个文件，每个文件约200-500行
• 组件示例文件: 39个文件，每个文件约200-500行
• uni-app-x 文档: 组件 + API，约100+个文件

总计约200+个文件需要创建或更新。