feat.新增了插件开发文档

docs/Plugins develop/01-快速开始/01-开发环境准备.md

@@ -0,0 +1,220 @@
+# 01-开发环境准备
+
+在开始开发阑山桌面插件之前，你需要准备好开发环境。本指南将带你完成所有必要的安装和配置。
+
+---
+
+## ✅ 系统要求
+
+### 支持的操作系统
+
+| 操作系统 | 版本要求 | 备注 |
+|---------|---------|------|
+| **Windows** | Windows 10 版本 1809 或更高 | 推荐开发平台 |
+| **Windows** | Windows 11 | 最佳体验 |
+| **Linux** | Ubuntu 20.04+ / Debian 10+ | 支持开发和运行 |
+| **macOS** | macOS 12+ | 支持开发和运行 |
+
+### 硬件要求
+
+- **处理器**：x64 或 ARM64 架构
+- **内存**：至少 4GB RAM（推荐 8GB）
+- **磁盘空间**：至少 2GB 可用空间
+
+---
+
+## 🛠️ 安装 .NET SDK
+
+阑山桌面插件基于 **.NET 10** 开发，你需要安装对应版本的 SDK。
+
+### 下载安装
+
+1. 访问 [.NET 10 下载页面](https://dotnet.microsoft.com/download/dotnet/10.0)
+2. 下载适合你操作系统的 SDK 安装包
+3. 运行安装程序，按提示完成安装
+
+### 验证安装
+
+打开终端（PowerShell、CMD 或 Bash），运行以下命令：
+
+```powershell
+# 检查 .NET SDK 版本
+dotnet --version
+```
+
+✅ **预期输出示例：**
+```
+10.0.100
+```
+
+⚠️ **如果版本低于 10.0**，请重新下载安装最新版 .NET 10 SDK。
+
+---
+
+## 💻 安装 IDE（集成开发环境）
+
+你可以选择以下任一 IDE 进行开发：
+
+### 选项 1：Visual Studio 2022（推荐 Windows 用户）
+
+**优点：** 功能最全，调试体验最佳
+
+1. 下载 [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
+2. 安装时选择以下工作负载：
+   - ✅ **.NET 桌面开发**
+   - ✅ **Avalonia UI 开发**（可选，如需 Avalonia 设计器）
+
+### 选项 2：JetBrains Rider（跨平台推荐）
+
+**优点：** 跨平台，智能提示强大，Avalonia 支持好
+
+1. 下载 [Rider](https://www.jetbrains.com/rider/)
+2. 安装后打开，会自动检测 .NET SDK
+
+### 选项 3：Visual Studio Code（轻量级）
+
+**优点：** 免费，轻量，插件丰富
+
+1. 下载 [VS Code](https://code.visualstudio.com/)
+2. 安装以下扩展：
+   - **C# Dev Kit**（Microsoft 官方）
+   - **Avalonia for VS Code**（可选）
+
+---
+
+## 📦 安装插件模板
+
+阑山桌面提供了官方的 `dotnet new` 模板，帮助你快速创建插件项目。
+
+### 安装模板
+
+```powershell
+# 安装最新版插件模板
+dotnet new install LanMountainDesktop.PluginTemplate
+```
+
+✅ **成功提示：**
+```
+模板名                                 短名称      语言  标签
+-------------------------------------  ----------  ----  ------------
+LanMountainDesktop Plugin              lmd-plugin  C#    LanMountainDesktop/Plugin
+```
+
+### 验证安装
+
+```powershell
+# 列出已安装的模板，查找 lmd-plugin
+dotnet new list | findstr lmd
+```
+
+或（Linux/macOS）：
+```bash
+dotnet new list | grep lmd
+```
+
+---
+
+## 🎮 获取宿主应用
+
+插件需要在阑山桌面宿主中运行，你需要获取宿主应用：
+
+### 方式 1：下载 Release 版本（推荐）
+
+1. 访问 GitHub Releases 页面
+2. 下载最新版本的安装包（.exe / .deb / .dmg）
+3. 安装并运行阑山桌面
+
+### 方式 2：从源码构建
+
+如果你想调试宿主或了解内部机制：
+
+```powershell
+# 克隆仓库
+git clone https://github.com/your-org/LanMountainDesktop.git
+cd LanMountainDesktop
+
+# 还原依赖
+dotnet restore
+
+# 构建项目
+dotnet build LanMountainDesktop.slnx -c Debug
+
+# 运行宿主
+dotnet run --project LanMountainDesktop/LanMountainDesktop.csproj
+```
+
+---
+
+## 🔍 环境验证清单
+
+在继续之前，请确认以下检查项都已完成：
+
+| 检查项 | 验证命令 | 预期结果 |
+|-------|---------|---------|
+| ✅ .NET SDK 版本 | `dotnet --version` | 10.0.xxx |
+| ✅ 模板已安装 | `dotnet new list \| findstr lmd` | 显示 lmd-plugin |
+| ✅ IDE 可创建项目 | 在 IDE 中新建项目 | 能看到 C# 项目模板 |
+| ✅ 宿主可运行 | 双击 LanMountainDesktop.exe | 应用正常启动 |
+
+---
+
+## ⚠️ 常见问题
+
+### 问题 1：dotnet 命令找不到
+
+**现象：** 运行 `dotnet` 提示不是内部或外部命令
+
+**解决：**
+1. 确认 .NET SDK 已正确安装
+2. 重启终端或 IDE
+3. 检查环境变量 PATH 是否包含 `C:\Program Files\dotnet\`
+
+### 问题 2：模板安装失败
+
+**现象：** `dotnet new install` 报错或卡住
+
+**解决：**
+1. 检查网络连接（需要访问 nuget.org）
+2. 尝试指定版本号：
+   ```powershell
+   dotnet new install LanMountainDesktop.PluginTemplate::1.0.0
+   ```
+3. 清除模板缓存后重试：
+   ```powershell
+   dotnet new uninstall LanMountainDesktop.PluginTemplate
+   dotnet new install LanMountainDesktop.PluginTemplate
+   ```
+
+### 问题 3：SDK 版本不匹配
+
+**现象：** 构建时提示 SDK 版本不符合 global.json 要求
+
+**解决：**
+1. 检查项目根目录的 `global.json` 文件
+2. 安装对应版本的 .NET SDK
+3. 或使用以下命令使用已安装的版本：
+   ```powershell
+   dotnet new globaljson --sdk-version 10.0.100 --roll-forward latestFeature
+   ```
+
+---
+
+## 🎯 下一步
+
+环境准备完成！接下来：
+
+👉 **[02-三分钟创建第一个插件](02-三分钟创建第一个插件.md)** - 立即开始创建你的第一个插件！
+
+---
+
+## 📚 参考资源
+
+- [.NET 10 下载](https://dotnet.microsoft.com/download/dotnet/10.0)
+- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
+- [JetBrains Rider](https://www.jetbrains.com/rider/)
+- [VS Code](https://code.visualstudio.com/)
+- [Avalonia UI 文档](https://docs.avaloniaui.net/)
+
+---
+
+*最后更新：2026年4月*