installerbuilder/tasks/task23-插件系统实现.md

# 任务23：插件系统实现

## 任务描述
实现插件系统，用于扩展系统功能，包括支持新的平台、包类型、脚本类型等。插件系统将允许第三方开发者为安装包构建工具添加新功能，而无需修改核心代码。

## 实现步骤

1. 定义插件接口：
   - 在`internal/plugin`包中创建`plugin.go`文件
   - 定义Plugin接口：
     ```go
     type Plugin interface {
         // Init 初始化插件
         Init(config map[string]interface{}) error
         
         // GetName 获取插件名称
         GetName() string
         
         // GetVersion 获取插件版本
         GetVersion() string
         
         // GetDescription 获取插件描述
         GetDescription() string
         
         // GetAuthor 获取插件作者
         GetAuthor() string
     }
     ```
   - 定义特定类型的插件接口：
     ```go
     // PlatformPlugin 平台插件
     type PlatformPlugin interface {
         Plugin
         // GetPlatformAdapter 获取平台适配器
         GetPlatformAdapter() platform.PlatformAdapter
     }
     
     // PackagePlugin 包类型插件
     type PackagePlugin interface {
         Plugin
         // GetPackageBuilder 获取包构建器
         GetPackageBuilder() package.PackageBuilder
     }
     
     // ScriptPlugin 脚本插件
     type ScriptPlugin interface {
         Plugin
         // GetScriptExecutor 获取脚本执行器
         GetScriptExecutor() scripts.ScriptExecutor
     }
     
     // HookPlugin 钩子插件
     type HookPlugin interface {
         Plugin
         // GetHooks 获取钩子函数
         GetHooks() map[string]HookFunc
     }
     ```
   - 定义HookFunc类型：
     ```go
     // HookFunc 钩子函数类型
     type HookFunc func(ctx context.Context, data interface{}) (interface{}, error)
     ```

2. 创建插件管理器：
   - 创建`manager.go`文件
   - 定义PluginManager接口：
     ```go
     type PluginManager interface {
         // LoadPlugin 加载插件
         LoadPlugin(path string) (Plugin, error)
         
         // GetPlugin 获取插件
         GetPlugin(name string) (Plugin, error)
         
         // GetAllPlugins 获取所有插件
         GetAllPlugins() []Plugin
         
         // GetPluginsByType 获取特定类型的插件
         GetPluginsByType(pluginType reflect.Type) []Plugin
         
         // RegisterHook 注册钩子
         RegisterHook(hookName string, hookFunc HookFunc) error
         
         // ExecuteHook 执行钩子
         ExecuteHook(ctx context.Context, hookName string, data interface{}) (interface{}, error)
     }
     ```
   - 定义DefaultPluginManager结构体，实现PluginManager接口：
     ```go
     type DefaultPluginManager struct {
         plugins     map[string]Plugin
         hooks       map[string][]HookFunc
         logger      log.Logger
         pluginPaths []string
     }
     ```
   - 实现构造函数：
     ```go
     func NewDefaultPluginManager(logger log.Logger, pluginPaths []string) *DefaultPluginManager {
         return &DefaultPluginManager{
             plugins:     make(map[string]Plugin),
             hooks:       make(map[string][]HookFunc),
             logger:      logger,
             pluginPaths: pluginPaths,
         }
     }
     ```

3. 实现插件加载：
   - 实现LoadPlugin方法，加载插件
   - 支持Go插件（.so/.dll文件）
   - 支持脚本插件（通过解释器执行）
   - 支持内置插件（直接注册）

4. 实现插件注册：
   - 创建registerPlugin方法，注册插件
   - 验证插件接口实现
   - 处理插件依赖
   - 处理插件冲突

5. 实现钩子系统：
   - 实现RegisterHook方法，注册钩子
   - 实现ExecuteHook方法，执行钩子
   - 定义标准钩子点
   - 支持钩子优先级

6. 实现插件配置：
   - 创建loadPluginConfig方法，加载插件配置
   - 支持全局配置
   - 支持插件特定配置
   - 支持配置验证

7. 实现插件隔离：
   - 创建插件沙箱环境
   - 限制插件资源访问
   - 处理插件崩溃
   - 支持插件超时

8. 实现插件发现：
   - 创建discoverPlugins方法，发现可用插件
   - 扫描插件目录
   - 加载插件清单
   - 处理插件版本

## 单元测试要求

1. 测试插件接口：
   - 验证接口定义
   - 测试接口实现
   - 测试类型转换
   - 测试错误处理

2. 测试插件管理器：
   - 验证构造函数
   - 测试插件加载
   - 测试插件获取
   - 测试类型过滤

3. 测试插件加载：
   - 验证LoadPlugin方法
   - 测试Go插件加载
   - 测试脚本插件加载
   - 测试内置插件加载

4. 测试插件注册：
   - 验证registerPlugin方法
   - 测试接口验证
   - 测试依赖处理
   - 测试冲突处理

5. 测试钩子系统：
   - 验证RegisterHook方法
   - 测试ExecuteHook方法
   - 测试钩子链执行
   - 测试钩子错误处理

6. 测试插件配置：
   - 验证loadPluginConfig方法
   - 测试配置加载
   - 测试配置验证
   - 测试配置覆盖

7. 测试插件隔离：
   - 验证沙箱环境
   - 测试资源限制
   - 测试崩溃处理
   - 测试超时处理

8. 测试插件发现：
   - 验证discoverPlugins方法
   - 测试目录扫描
   - 测试清单加载
   - 测试版本处理

## 依赖关系

- 依赖任务01（项目初始化）
- 依赖任务02（日志系统实现）
- 依赖任务03（错误处理框架）
- 依赖任务04（资源管理器实现）
- 依赖任务09（平台适配接口定义）
- 依赖任务19（默认构建协调器）

## 完成标准

1. 插件接口已定义并文档完善
2. PluginManager接口已定义并文档完善
3. DefaultPluginManager实现了所有接口方法
4. 插件加载功能正常工作
5. 插件注册功能正常工作
6. 钩子系统功能正常工作
7. 插件配置功能正常工作
8. 插件隔离功能正常工作
9. 插件发现功能正常工作
10. 所有单元测试通过
11. 代码符合项目的Go语言开发规范
12. 插件系统能够支持各种类型的插件
13. 支持所有需求文档中的插件相关功能

## 示例插件

### 平台插件示例

```go
package main

import (
    "github.com/yourusername/installerbuilder/internal/platform"
    "github.com/yourusername/installerbuilder/internal/plugin"
)

// MacOSPlugin 是一个支持macOS平台的插件
type MacOSPlugin struct {
    name        string
    version     string
    description string
    author      string
    adapter     *MacOSAdapter
}

// MacOSAdapter 实现了platform.PlatformAdapter接口
type MacOSAdapter struct {
    // macOS特定字段
}

// 实现PlatformAdapter接口的方法...

// Plugin 导出的插件实例
var Plugin plugin.Plugin = &MacOSPlugin{
    name:        "macos-platform",
    version:     "1.0.0",
    description: "macOS platform support",
    author:      "Your Name",
    adapter:     &MacOSAdapter{},
}

// Init 初始化插件
func (p *MacOSPlugin) Init(config map[string]interface{}) error {
    // 初始化代码
    return nil
}

// GetName 获取插件名称
func (p *MacOSPlugin) GetName() string {
    return p.name
}

// GetVersion 获取插件版本
func (p *MacOSPlugin) GetVersion() string {
    return p.version
}

// GetDescription 获取插件描述
func (p *MacOSPlugin) GetDescription() string {
    return p.description
}

// GetAuthor 获取插件作者
func (p *MacOSPlugin) GetAuthor() string {
    return p.author
}

// GetPlatformAdapter 获取平台适配器
func (p *MacOSPlugin) GetPlatformAdapter() platform.PlatformAdapter {
    return p.adapter
}
```

### 包类型插件示例

```go
package main

import (
    "github.com/yourusername/installerbuilder/internal/package"
    "github.com/yourusername/installerbuilder/internal/plugin"
)

// DMGPlugin 是一个支持DMG包格式的插件
type DMGPlugin struct {
    name        string
    version     string
    description string
    author      string
    builder     *DMGBuilder
}

// DMGBuilder 实现了package.PackageBuilder接口
type DMGBuilder struct {
    // DMG特定字段
}

// 实现PackageBuilder接口的方法...

// Plugin 导出的插件实例
var Plugin plugin.Plugin = &DMGPlugin{
    name:        "dmg-package",
    version:     "1.0.0",
    description: "DMG package format support",
    author:      "Your Name",
    builder:     &DMGBuilder{},
}

// Init 初始化插件
func (p *DMGPlugin) Init(config map[string]interface{}) error {
    // 初始化代码
    return nil
}

// GetName 获取插件名称
func (p *DMGPlugin) GetName() string {
    return p.name
}

// GetVersion 获取插件版本
func (p *DMGPlugin) GetVersion() string {
    return p.version
}

// GetDescription 获取插件描述
func (p *DMGPlugin) GetDescription() string {
    return p.description
}

// GetAuthor 获取插件作者
func (p *DMGPlugin) GetAuthor() string {
    return p.author
}

// GetPackageBuilder 获取包构建器
func (p *DMGPlugin) GetPackageBuilder() package.PackageBuilder {
    return p.builder
}
```