@wagq/wa-cli 0.6.33 → 0.6.36

package/README.md

@@ -20,35 +20,45 @@ wa --help
 
 ### init
 
-- **作用**：项目初始化工具
-- **用法**：`wa init <name>`
-- **别名**：`wa i <name>`
+- **作用**：项目初始化工具，交互式选择模板创建项目
+- **用法**：`wa init`
+- **别名**：`wa i`
+- **可选模板**
+  - `vue单页面后台` — 从 GitHub 仓库 `sdmu-gaoqi/vite-vue` 克隆
+  - `vue多页面项目` — 从 GitHub 仓库 `sdmu-gaoqi/vite-vue-multiple` 克隆
+  - `React` — 支持 SPA / 微前端基座 / 微前端子应用
+  - `vite` — 调用 `npm create vite@latest`
+  - `uniapp(unibest)` — 调用 `npm create unibest`
+  - `vscode插件-vue版` / `vscode插件-react版`
+  - `umi` — 调用 `npx create-umi@latest`
+  - `react-native` — 调用 `npx create-expo-app --template`
 
 ```bash
-wa init my-app
+wa init
+wa i
 ```
 
 ### server
 
-- **作用**：启动本地静态服务
+- **作用**：启动本地静态服务（基于 `http-server`）
 - **用法**：`wa server [path]`
 - **别名**：`wa s [path]`
 - **位置参数**
   - `path`：文件路径，默认 `dist`
 - **选项**
-  - `-P, --port <port>`：端口
-  - `-S, --https <boolean>`：是否开启 https
+  - `-P, --port <port>`：端口（默认 `3000`）
+  - `-S, --https <boolean>`：是否开启 https，开启后会提示输入证书/私钥路径（也可使用 CLI 自带证书）
 
 ```bash
 wa server
-wa server dist -P 3000 -S true
+wa s dist -P 3000 -S true
 ```
 
 ### xlsx2Config
 
 - **作用**：xlsx 文件转多语言配置
-- **用法**：`wa xlsx2Config <path> <name> <ext>`
-- **别名**：`wa l <path> <name> <ext>`
+- **用法**：`wa xlsx2Config [path] [name] [ext]`
+- **别名**：`wa l [path] [name] [ext]`
 - **位置参数**
   - `path`：文件路径
   - `name`：xlsx 文件名称
@@ -60,12 +70,16 @@ wa xlsx2Config ./locale excel.xlsx json
 
 ### daml
 
-- **作用**：同步低代码逻辑器文件
+- **作用**：交互式同步低代码逻辑器文件（需在项目根目录提供 `scripts/asyncDamlFetch.js`）
 - **用法**：`wa daml`
 - **别名**：`wa d`
+- **交互选项**
+  - 备注信息（文件夹名称，默认 `asyncData`）
+  - 同步数据类型：`逻辑编辑器` / `变量编辑器` / `变量与逻辑`
 
 ```bash
 wa daml
+wa d
 ```
 
 ### damls
@@ -73,39 +87,45 @@ wa daml
 - **作用**：从应用同步所有页面的逻辑器与变量值
 - **用法**：`wa damls`
 - **别名**：`wa da`
-- **配置**：可将 `appId`、`branchid`、`token` 写入 `~/.damlrc`（数组形式）
+- **配置**：在项目根目录创建 `.damlrc.json`（数组形式），初次执行会自动生成模板文件
 
-`~/.damlrc` 示例（JSON）：
+`.damlrc.json` 示例：
 
 ```json
 [
   {
+    "appName": "my-app",
     "origin": "https://example.com",
     "appId": "xxx",
     "branchid": "yyy",
-    "token": "zzz",
-    "appName": "my-app"
+    "token": "zzz"
   }
 ]
 ```
 
 - **字段说明**
-  - `origin`：请求域名（`/api/assembler/page/list` 页面列表接口域名）
-  - `appId` / `branchid` / `token`：请求参数
-  - `appName`：应用名称（区分不同应用的标识）；生成的文件会放在以 `appName` 命名的文件夹下
+  - `origin`：低代码平台域名
+  - `appId` / `branchid` / `token`：接口鉴权参数
+  - `appName`：应用名称（生成的文件会放在以 `appName` 命名的文件夹下）
+- **交互选项**
+  - 是否将目录加入 `.gitignore`
+  - 是否使用 prettier 格式化代码
 
 ```bash
 wa damls
+wa da
 ```
 
 ### batchUpdate
 
-- **作用**：批量升级依赖包（可指定组织，只更新组织下的依赖）
+- **作用**：批量升级依赖包，可指定组织范围
 - **用法**：`wa batchUpdate`
 - **别名**：`wa bu`
+- **交互**：输入需要更新的包组织前缀（如 `@wagq`），会自动更新 `dependencies` 中匹配该前缀的依赖
 
 ```bash
 wa batchUpdate
+wa bu
 ```
 
 ### web2exe
@@ -115,7 +135,7 @@ wa batchUpdate
 - **别名**：`wa we <name> <path> [icon]`
 - **参数说明**
   - `name`：应用名称
-  - `path`：网页地址或本地 `html` 文件路径（会透传给 `nativefier`）
+  - `path`：网页地址或本地 `html` 文件路径（透传给 `nativefier`）
   - `icon`：图标路径（可选）
 
 ```bash
@@ -124,13 +144,32 @@ wa web2exe MyApp https://example.com ./icon.ico
 
 ### skills
 
-- **作用**：交互选择并执行与 `openskills` 相关的常用命令（需本机可执行 `npx`）
+- **作用**：交互选择并执行 `openskills` 相关命令
 - **用法**：`wa skills`
 - **别名**：`wa sk`
 - **交互选项**
-  - `getList`：执行 `npx openskills install anthropics/skills`
-  - `sync`：执行 `npx openskills sync`
+  - `getList` — 执行 `npx openskills install anthropics/skills`
+  - `sync` — 执行 `npx openskills sync`
 
 ```bash
 wa skills
+wa sk
+```
+
+### generateIcon2Tsx
+
+- **作用**：将 SVG 图标文件批量生成 TSX React 组件与配置文件
+- **用法**：`wa generateIcon2Tsx <svgPath>`
+- **别名**：`wa gitsx <svgPath>`
+- **参数说明**
+  - `svgPath`：SVG 文件夹地址（需包含 `outline/`、`fill/`、`multipleTone/` 子目录）
+- **输出**
+  - `svgConfig/` — SVG 数据配置文件
+  - `icons/` — 生成的 TSX 组件
+  - `index.ts` — 所有图标统一导出入口
+- **命名规范**：SVG 文件需按 `outline`、`multipleTone`、`fill` 风格分类存放，并规范后缀命名，如 `AuctionMenuMultipleTone.svg`、`AddCircleOutlined.svg`
+
+```bash
+wa generateIcon2Tsx ./svgs
+wa gitsx ./svgs
 ```

package/config/command.js

@@ -7,6 +7,8 @@ const batchUpdate = require("../lib/batchUpdate");
 const web2exe = require("../lib/exe");
 const skill = require("../lib/skill");
 const { generateIcon2Tsx } = require("../lib/generateIcon/tsx");
+const changesetDoc = require("../lib/changesetDoc");
+const vsSetting = require("../lib/vsSetting");
 
 const command = [
   {
@@ -144,6 +146,18 @@ const command = [
     ],
     action: generateIcon2Tsx,
   },
+  {
+    name: "changesetDoc [mode]",
+    alias: "chd",
+    description: "包版本管理",
+    action: changesetDoc,
+  },
+  {
+    name: "vsSetting",
+    alias: "vs",
+    description: "生成vscode配置文件",
+    action: vsSetting,
+  }
 ];
 
 module.exports = command;

package/lib/changesetDoc/index.js

@@ -0,0 +1,44 @@
+const { execSync } = require("child_process");
+
+const changesetDoc = (mode) => {
+  let bins = [];
+  switch (mode) {
+    case "dev":
+      bins.push('echo "准备启动文档预览  `n@author: wa 1224362143@qq.com"');
+      bins.push("dumi dev");
+      break;
+    case "doc":
+      bins.push('echo "准备构建文档  `n@author: wa 1224362143@qq.com"');
+      bins.push("dumi build");
+      break;
+    case "changeset":
+      bins.push("changeset");
+      break;
+    case "ver":
+      bins.push("changeset version");
+      break;
+    case "turboBuild":
+      bins.push('echo "准备打包  `n@author: wa 1224362143@qq.com"');
+      bins.push("turbo build");
+      break;
+    case "enterBeta":
+      bins.push('echo "进入beta模式  `n@author: wa 1224362143@qq.com"');
+      bins.push("changeset pre enter beta");
+      break;
+    case "exitBeta":
+      bins.push('echo "退出beta模式  `n@author: wa 1224362143@qq.com"');
+      bins.push("changeset pre exit");
+      break;
+  }
+
+  if (bins.length > 0) {
+    bins.forEach((bin) => {
+      execSync(bin, {
+        stdio: "inherit",
+        cwd: process.cwd(),
+      });
+    });
+  }
+};
+
+module.exports = changesetDoc;

package/lib/generateIcon/tsx.js

@@ -25,24 +25,19 @@ const generateIcon2Tsx = async (svgPath) => {
     shell: true,
   });
 
-  const createIconDir = async () => {
+  const createDir = async (path) => {
     try {
-      await promisify(fs.access)(reactIconDir);
+      await promisify(fs.access)(path);
     } catch (err) {
-      await promisify(fs.mkdir)(reactIconDir);
+      await promisify(fs.mkdir)(path);
     }
   };
 
-  const createConfigDir = async () => {
-    try {
-      await promisify(fs.access)(configPath);
-    } catch (err) {
-      await promisify(fs.mkdir)(configPath);
-    }
-  };
-
-  await createIconDir();
-  await createConfigDir();
+  await createDir(reactIconDir);
+  await createDir(configPath);
+  await createDir(outlineIconDir);
+  await createDir(outlineIconDir);
+  await createDir(fillIconDir);
 
   const outlineFiles = fs.readdirSync(outlineIconDir);
   const fillFiles = fs.readdirSync(fillIconDir);

package/lib/vsSetting/index.js

@@ -0,0 +1,42 @@
+const fs = require("fs");
+const path = require("path");
+const log = require("../../utils/log.js");
+
+const settingsContent = {
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "always",
+    "source.fixAll.eslint": "always",
+  },
+  "eslint.validate": ["typescript", "typescriptreact"],
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+  },
+};
+
+const initVsSetting = (targetDir = process.cwd()) => {
+  try {
+    const vscodeDir = path.join(targetDir, ".vscode");
+    const settingsPath = path.join(vscodeDir, "settings.json");
+
+    if (!fs.existsSync(vscodeDir)) {
+      fs.mkdirSync(vscodeDir, { recursive: true });
+      log.info(".vscode 目录已创建");
+    }
+
+    fs.writeFileSync(
+      settingsPath,
+      JSON.stringify(settingsContent, null, 2),
+      "utf-8",
+    );
+    log.info(".vscode/settings.json 已写入");
+  } catch (error) {
+    log.error(error);
+  }
+};
+
+module.exports = initVsSetting;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wagq/wa-cli",
-  "version": "0.6.33",
+  "version": "0.6.36",
   "description": "wa的脚手架",
   "main": "index.js",
   "scripts": {