refactor: 架构升级

2026-09-12 16:40:40 +08:00 · 2026-08-31 07:58:23 +08:00
commit ba5b77568b
693 changed files with 118430 additions and 0 deletions
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 partme-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,105 @@
+---
+name: uniapp-native-plugin
+description: A comprehensive skill for developing native plugins for uni-app. Use this skill when building Android/iOS native plugins, integrating native capabilities, or publishing plugins based on official native plugin docs.
+license: Complete terms in LICENSE.txt
+---
+
+## When to use this skill
+
+Use this skill whenever the user wants to:
+- Develop native Android plugins
+- Develop native iOS plugins
+- Integrate native functionality into uni-app
+- Create custom native modules
+- Extend uni-app with native capabilities
+- Handle native plugin communication
+- Package and distribute native plugins
+
+## How to use this skill
+
+To develop native plugins:
+
+1. **Identify the platform** from the user's request:
+   - Android → Use Android plugin examples
+   - iOS → Use iOS plugin examples
+
+2. **Load the appropriate example file** from the `examples/` directory:
+   - `examples/guide/` - Native plugin development guide
+   - `examples/android-plugin/` - Android plugin examples
+   - `examples/ios-plugin/` - iOS plugin examples
+
+3. **Load the appropriate template** from the `templates/` directory:
+   - `templates/plugin-template.md` - Plugin development templates
+
+4. **Follow the specific instructions** in those files for development
+
+## Examples and Templates
+
+### Examples
+
+Located in `examples/`:
+
+- **guide/** - Native plugin development guide
+- **android-plugin/** - Android plugin development examples
+- **ios-plugin/** - iOS plugin development examples
+
+### Templates
+
+Located in `templates/`:
+
+- **plugin-template.md** - Plugin development templates
+
+## Best Practices
+
+1. **Follow platform guidelines**: Adhere to Android and iOS development standards
+2. **Error handling**: Implement proper error handling and logging
+3. **Documentation**: Provide clear documentation for plugin usage
+4. **Testing**: Test plugins thoroughly on real devices
+
+## Resources
+
+- **Official Documentation**: https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## Keywords
+
+native plugin, 原生插件, Android插件, iOS插件, plugin development, native module
+
+## 能力边界
+
+### ✅ 适用场景
+- 当你需要使用此技能对应的技术栈时
+- 当项目需要遵循最佳实践时
+- 当需要快速上手或深入理解核心概念时
+
+### ⚠️ 需要注意
+- 复杂业务逻辑需要结合具体场景调整
+- 性能优化需要根据实际数据量评估
+
+### ❌ 不适用场景
+- 不相关的技术栈或框架
+- 需要完全自定义的特殊场景
+
+## 常见陷阱 (Gotchas)
+
+1. **版本兼容性**：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
+2. **配置文件格式**：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
+3. **环境变量**：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
+4. **依赖冲突**：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
+5. **性能陷阱**：大数据量场景下注意性能优化，避免 N+1 查询等常见问题
+
+## 使用流程
+
+### Step 1: 环境准备
+确保开发环境已安装必要的依赖和工具。
+
+### Step 2: 配置初始化
+根据项目需求进行基础配置。
+
+### Step 3: 核心功能使用
+按照示例代码实现核心功能。
+
+### Step 4: 测试验证
+运行测试确保功能正常。
+
+### Step 5: 部署上线
+完成开发后进行部署和监控。
@@ -0,0 +1,14 @@
+# Android 原生能力封装
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 示例
+
+- 封装系统能力（定位、蓝牙、推送等）
+- 暴露 JS 调用接口
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,15 @@
+# Android 插件工程初始化
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 步骤
+
+1. 创建 Android 原生模块
+2. 接入 uni-app 插件接口
+3. 编写插件入口与配置
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,14 @@
+# JS Bridge 通信
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 说明
+
+- 使用 JSBridge 在 JS 与原生层之间通信
+- 设计统一的接口规范与参数结构
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,31 @@
+# uni-app 原生插件开发指南
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 什么是原生插件
+
+原生插件是用原生代码（Android Java/Kotlin 或 iOS Objective-C/Swift）开发的插件，可以扩展 uni-app 的功能。
+
+## 开发流程
+
+### Android 插件
+
+1. 创建 Android 插件项目
+2. 实现插件功能
+3. 配置插件信息
+4. 打包插件
+5. 集成到 uni-app 项目
+
+### iOS 插件
+
+1. 创建 iOS 插件项目
+2. 实现插件功能
+3. 配置插件信息
+4. 打包插件
+5. 集成到 uni-app 项目
+
+## 参考资源
+
+- 原生插件开发文档：https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,20 @@
+# 原生插件结构与发布
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 目录结构
+
+- plugin 代码
+- JS Bridge 接口
+- 配置与说明文档
+
+## 发布要点
+
+- 完善插件描述与使用说明
+- 提供平台支持与版本兼容说明
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,14 @@
+# iOS 原生能力封装
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 示例
+
+- 封装系统能力（摄像头、文件、推送等）
+- 暴露 JS 调用接口
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,15 @@
+# iOS 插件工程初始化
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 步骤
+
+1. 创建 iOS 原生模块
+2. 接入 uni-app 插件接口
+3. 编写插件入口与配置
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/
@@ -0,0 +1,15 @@
+# 原生插件模板
+
+## 官方文档
+
+参考官方文档：https://nativesupport.dcloud.net.cn/NativePlugin/
+
+## 模板清单
+
+- 插件描述与版本信息
+- JS 接口定义
+- Android/iOS 实现说明
+
+## 参考资源
+
+- https://nativesupport.dcloud.net.cn/NativePlugin/