Superpowers Marketplace插件安装与使用指南

1. Superpowers Marketplace插件概述

Superpowers Marketplace是一款专为Superpowers游戏引擎设计的插件市场系统。作为一款开源的HTML5游戏开发工具，Superpowers本身提供了基础的2D/3D游戏开发功能，而通过Marketplace插件，开发者能够轻松扩展引擎能力。

这个插件本质上是一个集成在Superpowers IDE内的应用商店，允许用户：

• 浏览社区贡献的各类插件
• 一键安装/卸载功能扩展
• 管理已安装的插件版本
• 直接提交自己的插件作品

2. 安装前的环境准备

2.1 系统要求检查

在开始安装前，请确保满足以下条件：

• 已安装Node.js 12.x或更高版本（推荐LTS版本）
• 已正确安装Superpowers核心程序（v1.0+）
• 网络连接正常（需要访问GitHub和NPM仓库）
• 系统PATH环境变量已配置Node.js和npm

可以通过以下命令验证环境：

bash复制node -v
npm -v
superpowers --version

2.2 必要依赖安装

Marketplace插件需要以下依赖包：

• socket.io-client@2.x
• request-promise@4.x
• semver@5.x

这些依赖会在插件安装时自动获取，但如果遇到网络问题，可以手动预先安装：

bash复制npm install socket.io-client@2.4.0 request-promise@4.2.6 semver@5.7.1 --save

3. 详细安装步骤

3.1 通过GitHub仓库安装（推荐）

1. 打开Superpowers客户端
2. 进入"Settings" → "Plugins"
3. 点击"Install from GitHub"按钮
4. 输入仓库地址：superpowers/superpowers-marketplace
5. 等待下载和编译完成（约2-5分钟）
6. 重启Superpowers客户端

3.2 手动安装方式

如果网络访问GitHub受限，可以采用离线安装：

1. 从发布页面下载最新zip包：

   code复制https://github.com/superpowers/superpowers-marketplace/releases
   

2. 解压到Superpowers的插件目录：
   • Windows: %APPDATA%/Superpowers/plugins/
   • macOS: ~/Library/Application Support/Superpowers/plugins/
   • Linux: ~/.config/Superpowers/plugins/
3. 重命名文件夹为marketplace
4. 在插件目录下执行：

   bash复制npm install
   

4. 安装后配置

4.1 首次运行设置

安装完成后首次启动时：

1. 系统会提示授权插件市场访问权限
2. 需要同意数据收集条款（仅匿名使用统计）
3. 选择更新频道（稳定版/测试版）

4.2 代理配置（如需要）

如果处于特殊网络环境，可能需要配置代理：

1. 打开插件配置文件：

   code复制plugins/marketplace/config.json
   

2. 添加代理设置：

   json复制{
     "proxy": {
       "host": "your.proxy.com",
       "port": 8080,
       "auth": {
         "username": "optional",
         "password": "optional"
       }
     }
   }
   

5. 常见问题排查

5.1 安装失败处理

5.2 运行时问题

• 插件市场空白：检查控制台是否有CORS错误，可能需要禁用浏览器安全扩展
• 搜索功能失效：确认已登录GitHub账号（部分功能需要基础认证）
• 更新失败：检查plugins目录的写入权限

6. 进阶使用技巧

6.1 开发者模式

在config.json中添加：

json复制{
  "developerMode": true
}

将开启：

• 本地插件调试功能
• 详细的网络请求日志
• 未审核插件显示

6.2 插件开发集成

Marketplace插件安装后，会自动在项目中添加：

• 示例插件模板（在templates/目录）
• 本地测试服务器（端口3001）
• 实时重载功能

可以通过以下命令快速创建新插件：

bash复制npm run create-plugin --name=my-plugin --type=library

7. 插件生态管理

7.1 常用插件推荐

7.2 插件更新策略

建议的维护方式：

1. 每月检查一次核心插件更新
2. 非必要不更新辅助插件
3. 重大版本更新前：
   • 备份项目
   • 在测试分支验证
   • 阅读变更日志

重要提示：避免同时更新多个插件，容易引发兼容性问题。建议按"核心功能→辅助工具→视觉效果"的顺序分批更新。