@aubo/wcaps-builder

Webscope 插件的脚手架与构建工具。

安装

npm install @aubo/wcaps-builder --save-dev

使用

创建插件项目

交互式创建一个标准化的 Webscope 插件模板：

wcaps-builder create

# 指定名称和强制覆盖
wcaps-builder create -n my-plugin -f

构建插件

在插件项目根目录执行：

# 完整构建（前端 + 后端）
wcaps-builder build

# 仅构建前端
wcaps-builder build:frontend

# 仅构建后端
wcaps-builder build:backend

# 测试模式（保留 source-map 和 console）
wcaps-builder build --mode test

在 package.json 中配置脚本

{
  "scripts": {
    "build:frontend": "wcaps-builder build:frontend",
    "build:backend": "wcaps-builder build:backend",
    "build": "wcaps-builder build"
  }
}

编程式 API

import { WcapsBuilder } from '@aubo/wcaps-builder';

const builder = new WcapsBuilder({
  cwd: process.cwd(),
  mode: 'production',   // 'production' | 'test'
});

await builder.build();         // 完整构建
await builder.buildFrontend(); // 仅前端
await builder.buildBackend();  // 仅后端

前置依赖

本包将 @vue/cli-service 作为 peerDependency，请在插件的 devDependencies 中安装：

npm install @vue/cli-service --save-dev

构建产物

dist/
├── plugin.json              # 插件汇总元信息
├── frontend/
│   ├── plugin.umd.min.js    # 前端 UMD 库
│   ├── assets/
│   └── frontend.json        # 前端元信息
└── backend/
    ├── main.js              # 后端入口
    └── ...

CLI 命令参考

用法: wcaps-builder <command> [options]

命令:
  create                    创建新的插件项目（交互式）
  create -n <name>          创建并指定名称
  build                     构建前后端（完整构建）
  build:frontend            仅构建前端
  build:backend             仅构建后端

Create 选项:
  -n, --name <name>         插件名称 (kebab-case)
  -f, --force               强制覆盖已存在的目录
  --no-git                  不初始化 Git 仓库
  --no-install              不自动安装依赖

Build 选项:
  -m, --mode <mode>         构建模式 (production|test, 默认 production)
  --skip-warn               跳过 vue.config.js 校验警告

其他:
  -h, --help                显示帮助信息
  -v, --version             显示版本号

License

MIT