插件管理器

概述

插件管理器是 ToolBank 的核心管理界面，用于安装、更新、启用和卸载插件。

访问方式

• 主界面菜单 → 插件管理
• 工具栏 "插件管理器" 按钮
• 快捷键 Ctrl+Shift+P

界面布局

┌─────────────────────────────────────────────────────────────────────────┐
│  🔧 插件管理                                                            │
├─────────────────────────────────────────────────────────────────────────┤
│  [📦安装] [🔄重载] [🗑️删除版本] [🔍刷新]  [发布] [🌐打开市场]          │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│  ┌─ 在线插件市场 ─┬─ 本地插件列表 ─┬─ 版本详情 ──────────────────────┐ │
│  │ 🔍 搜索插件    │ 插件名│ ID    │ 版本 │ 启用 │ 兼容 │ 厂商 │ 说明  │ │
│  │                │─────────│──────│────────┼──────┼──────┼──────┼──────│ │
│  │ Plugin.CV      │ CV      │ CV   │ 1.0.6  │ ✓    │ ✓    │ TB   │ 图像  │ │
│  │ Plugin.DL      │ DL      │ DL   │ 2.0.0  │ ✓    │ ✓    │ TB   │ 深度  │ │
│  │ Plugin.Finance │ Finance │ Fin  │ 1.0.0  │ ✗    │ ✓    │ TB   │ 金融  │ │
│  │                │         │      │        │      │      │      │      │ │
│  │ 共 3 个插件    │         │      │        │      │      │      │      │ │
│  └────────────────┴─────────┴──────────────────────────────────────────┘ │
│                                                                         │
│  [ 进度条: 下载中... 50% ]                                             │
│                                                                         │
│  [ 启用所选版本 ]                                          [ 关闭 ]    │
└─────────────────────────────────────────────────────────────────────────┘

在线插件市场

搜索插件

1. 在搜索框输入关键词
2. 按 Enter 或点击搜索按钮
3. 列表显示匹配的插件

查看插件详情

点击插件卡片，查看：

• 插件描述
• 所有版本列表
• 版本发布说明
• 下载量和评分

安装在线插件

1. 从市场列表选择插件
2. 在右侧版本详情中选择版本
3. 点击 "在线安装"
4. 等待下载和安装完成

本地插件管理

查看已安装插件

本地插件列表显示：

• 插件名：显示名称
• ID：插件唯一标识
• 已启用版本：当前使用的版本
• 版本数：已安装的版本数量

启用/禁用版本

1. 在本地列表选择插件
2. 在版本详情中勾选/取消 "启用" 列
3. 每个插件只能启用一个版本

删除版本

1. 选中要删除的版本
2. 点击 "删除所选版本"
3. 确认删除操作

重载插件

• 点击 "重载插件" 按钮
• 重新扫描插件目录
• 加载所有已启用的插件版本

发布插件

发布到市场

1. 点击 "发布插件"
2. 登录市场账号
3. 选择 ZIP 包
4. 填写发布说明
5. 点击发布

发布窗口

┌─ 发布插件包 ──────────────────────────────┐
│                                            │
│  插件包路径: [/path/to/package.zip] [浏览] │
│  版本说明:   [新增功能...]                  │
│                                            │
│  [进度: 上传中 30%]                        │
│                                            │
│                    [发布] [取消]            │
└────────────────────────────────────────────┘

发布要求

• 已注册市场账号
• 拥有有效的 API Key
• 插件包已正确打包
• 版本号符合规范

插件包构建

构建工具

使用 "制作插件包" 工具将编译产物打包。

构建步骤

1. 点击 "发布插件" → 选择 "制作插件包"
2. 填写插件信息
3. 选择 DLL 文件
4. 点击 "导出"

构建窗口

┌─ 制作插件包 ──────────────────────────────────────┐
│                                                    │
│  插件输出目录: [D:\Build\...]              [浏览] │
│  入口 DLL:    [Plugin.Example.dll ▼]       [刷新] │
│  插件 ID:     [Plugin.Example        ]            │
│  显示名:      [示例插件               ]            │
│  版本:        [1.0.0                  ]            │
│  厂商:        [YourCompany            ]            │
│  说明:        [描述信息               ]            │
│                                                    │
│  提示: 导出时会把该目录下所有文件打包，             │
│        并自动生成 manifest.json。                  │
│                                                    │
│  [准备就绪]                                       │
│  [════════════════░░] 0%                           │
│                                                    │
│                       [导出] [取消]                │
└────────────────────────────────────────────────────┘

manifest.json 内容

构建时自动生成：

{
  "plugin_id": "Plugin.Example",
  "display_name": "示例插件",
  "version": "1.0.0",
  "vendor": "YourCompany",
  "description": "描述信息",
  "entry_dll": "Plugin.Example.dll",
  "author": "Developer",
  "created_at": "2026-07-28T12:00:00"
}

市场账号

注册账号

1. 在发布窗口点击 "注册"
2. 填写用户名、邮箱、密码
3. 邮箱验证后即可发布

登录

1. 输入邮箱和密码
2. 点击登录
3. 登录成功后显示 API Key

账号信息

登录后可查看：

• 用户名
• 邮箱
• API Key（用于发布）
• 管理员权限

版本兼容

兼容性检查

安装时自动检查：

• 主程序版本 ≥ min_host_version
• ToolBase 版本 ≥ min_toolbase_version

版本标记

标记	说明
✓ 兼容	可正常安装使用
✗ 不兼容	需要升级主程序

安装目录

默认路径

{ToolBank}/Plugins/{PluginId}/{version}/

示例

ToolBank/
└── Plugins/
    ├── Plugin.CV/
    │   ├── 1.0.0/
    │   │   └── Plugin.CV.dll
    │   └── 1.0.6/
    │       └── Plugin.CV.dll
    └── Plugin.DL/
        └── 2.0.0/
            └── Plugin.DL.dll

版本锁定

plugins.lock.json 记录每个插件的启用版本：

{
  "Plugin.CV": "1.0.6",
  "Plugin.DL": "2.0.0",
  "Plugin.Finance": null
}

故障排除

问题	原因	解决方案
安装失败	ZIP 格式错误	重新打包
版本不兼容	版本过低	升级主程序
DLL 冲突	依赖版本不同	使用依赖检查工具
加载失败	权限不足	以管理员身份运行
网络错误	连接超时	检查网络连接

最佳实践

版本管理

• 保持最新版本启用
• 旧版本保留用于回退
• 定期清理过期版本

插件组织

• 按功能分类（CV/DL/Finance 等）
• 使用语义化的插件 ID
• 保持版本号规范

发布流程

1. 本地测试通过
2. 打包并验证
3. 发布到市场
4. 通知用户更新