@bams-app/work-cli 0.0.5 → 0.0.6

package/README.md

@@ -21,8 +21,9 @@ BAMS-Work 全局开发工具（类似 vue-cli 模式），提供**项目初始
 - `workspaces` 与仓库根 `package.json` 保持一致：`bams-components/*`、`apex-web/*` 等 glob 用于兼容
   用户克隆进项目的既有组件包仓库（目录不存在时不影响安装，`create` 也不会默认创建它们）。
 - 项目根 `package.json` 只声明 `@bams-app/ui-dev-server` 与能力包，**不声明任何外部运行时依赖**；
-  项目模板 `.npmrc` 配置 `install-links=true`，`npm install` 时以复制方式安装 `file:` 链接的包
-  并解析其全部传递依赖（vue、ant-design-vue 等随能力包自动安装）。
+  发布后模式下能力包的传递依赖（vue、ant-design-vue 等）由 npm 自动安装。`create` **不生成**
+  项目 `.npmrc`；仅本地验证模式（`file:` 引用 work 本地包）需手动在项目根创建 `.npmrc` 并写入
+  `install-links=true`，否则 npm 只对 `file:` 包建符号链接、不安装其传递依赖。
 - 能力包（`work/packages`、`work/ui`、`work/configs` 下的全部运行时包，含 ui 组件）声明
   **以 ui-dev-server 的 dependencies 为单一来源**：本地验证模式逐个 `file:` 注入 work 本地
   目录，发布后模式由 ui-dev-server 的 dependencies 随 npm 自动安装，业务组件与 runtime
@@ -41,11 +42,11 @@ flowchart LR
         C["@bams-app/*"]
     end
     subgraph CLI["@bams-app/work-cli（薄壳）"]
-        D["create / add / dev / build / umd<br/>env / pages-entry / pages-from-components"]
+        D["create / add / dev<br/>env / pages-entry / pages-from-components"]
     end
     subgraph PROJ["用户项目（Monorepo）"]
         E["package.json<br/>仅声明 @bams-app/*"]
-        F["npm install<br/>install-links=true · 复制安装并解析传递依赖"]
+        F["npm install<br/>能力包及传递依赖自动安装"]
     end
     A -->|"publish-all / 单包 npm publish"| C
     B -->|"发布 + 依赖声明"| C
@@ -86,12 +87,6 @@ npm install
 bams-work dev demo                 # 默认组件 ui-component-demo
 bams-work dev demo ui-order-list   # 指定组件
 
-# 构建宿主应用（production，输出 dist/）
-bams-work build ui-order-list
-
-# 构建组件 UMD 产物（输出 dist/umd/）
-bams-work umd ui-order-list
-
 # 在 scope 目录下创建新组件
 bams-work add --dir energy-ui --name ui-order-list
 bams-work add --dir energy-ui --name page-order-list --type page
@@ -108,13 +103,13 @@ bams-work update
 | `create <name>` | 初始化 Monorepo 项目模版（含示例组件与 `.bams-work/` 标记） |
 | `add --dir <scope> --name <name>` | 在 scope 目录下创建组件（component/page/base），并注册 workspace |
 | `dev <env> [component]` | 启动 work 开发环境（复用 ui-dev-server serve） |
-| `build [component]` | 构建宿主应用（复用 build-app，production） |
-| `umd [component]` | 构建组件 UMD 产物（复用 build-umd） |
-| `env [--force]` | 交互式创建开发环境配置 `.envs/.env.dev-<alias>`（复用 create-env） |
+| `env` | 交互式创建开发环境配置 `.envs/.env.dev-<alias>`（复用 create-env） |
 | `update [--skip-install]` | 升级 `@bams-app` 包：查询最新版本、更新 ui-dev-server 声明并重装依赖 |
 | `pages-entry --dir <dir> --type <page\|component>` | 扫描 page-*/ui-* 目录生成 webpack 动态入口（复用 create-pages-entry） |
 | `pages-from-components --dir <dir>` | 批量将 ui-* 组件转为 page-* 页面（复用 create-pages-from-components） |
 
+> `build`、`umd` 命令暂时下线（入口与示例均已移除），暂不可用。
+
 ### 组件目录规范
 
 业务组件（`<scope>/ui-xxx`）包含：`index.js`、`package.json`（`@<scope>/ui-xxx`）、
@@ -187,9 +182,10 @@ bams-work update
 
 ### 本地验证模式（file:）
 
-能力包以复制方式安装（`.npmrc` 的 `install-links=true`）。npm 对已安装的 file: 依赖会直接
-跳过（即使源码已变化），`bams-work update` 会先清除 node_modules 中全部 file: 依赖缓存
-再重装，强制重新复制 work 本地最新源码：
+需先在项目根创建 `.npmrc` 并写入 `install-links=true`（`create` 不再生成），使能力包以复制
+方式安装并解析其全部传递依赖。npm 对已安装的 file: 依赖会直接跳过（即使源码已变化），
+`bams-work update` 会先清除 node_modules 中全部 file: 依赖缓存再重装，强制重新复制 work
+本地最新源码：
 
 ```bash
 bams-work update
@@ -209,16 +205,16 @@ bams-work update
 ### 前提
 
 - 升级前确保对应版本已发布：`"*"` 只解析 registry 上已发布的版本。
-- registry 指向：`create` 生成的项目 `.npmrc` 只含 `install-links=true`，`@bams-app/*` 默认走
-  官方 npm（registry.npmjs.org）；仅在内网隔离、必须走私服时，才在项目 `.npmrc` 手动加
+- registry 指向：`create` 不生成项目 `.npmrc`，`@bams-app/*` 默认走官方 npm
+  （registry.npmjs.org）；仅在内网隔离、必须走私服时，才在项目 `.npmrc` 手动加
   `@bams-app:registry=https://npm.hedpy.cn/`（私服若存在同名旧版本，会遮蔽官方新版）。
 
 ## 本地验证（未发布时）
 
 未发布时通过 `file:` 引用本地 work 包完成端到端验证（`create` 会自动探测 work 仓库根，
 将 ui-dev-server 与能力包以 `file:` 注入项目依赖，无需手动设置环境变量）。
-注意：项目 `.npmrc` 的 `install-links=true` 使 `file:` 包以复制方式安装，
-修改 work 包源码后需重新执行 `npm install` 才会生效：
+注意：本地验证模式需自行在项目根创建 `.npmrc` 并写入 `install-links=true`，使 `file:` 包以
+复制方式安装并解析其全部传递依赖；修改 work 包源码后需重新执行 `npm install` 才会生效：
 
 ```bash
 cd work-cli && npm install      # 安装 file: 依赖（链接 work/cli 下的包）
@@ -228,8 +224,6 @@ cd /tmp && rm -rf demo-app
 bams-work create demo-app        # 自动以 file: 引用本地 ui-dev-server 与能力包
 cd demo-app && npm install
 bams-work dev demo               # 应返回 HTTP 200
-bams-work build ui-component-demo
-bams-work umd ui-component-demo
 bams-work add --dir energy-ui --name ui-order-list
 ```
 

package/bin/work-cli.js

@@ -10,14 +10,15 @@ const COMMANDS = {
     create: '初始化 Monorepo 项目模版',
     add: '在 scope 目录下创建组件（component/page/base）',
     dev: '启动 work 开发环境（serve，复用 ui-dev-server）',
-    build: '构建宿主应用（production，复用 ui-dev-server）',
-    umd: '构建组件 UMD 产物（复用 build-umd）',
     env: '创建开发环境配置（.envs/.env.dev-<alias>）',
     update: '升级 @bams-app 包（更新 ui-dev-server 并重装依赖）',
     'pages-entry': '扫描 page-*/ui-* 目录生成 webpack 动态入口',
     'pages-from-components': '批量将 ui-* 组件转为 page-* 页面'
 };
 
+// 暂时下线的命令：commands/ 下的实现文件保留，恢复时删除此处对应项即可
+const DISABLED_COMMANDS = ['build', 'umd'];
+
 function printUsage() {
     console.log('');
     console.log(colorize('BAMS-Work CLI', 'cyan'), colorize(`v${pkg.version}`, 'gray'));
@@ -35,9 +36,7 @@ function printUsage() {
     console.log('  bams-work create my-bams-project        # 初始化 Monorepo 项目');
     console.log('  bams-work add --dir energy-ui --name ui-order-list');
     console.log('  bams-work dev demo ui-component-demo    # 启动 work 开发环境');
-    console.log('  bams-work build ui-component-demo       # 构建宿主应用');
-    console.log('  bams-work umd ui-component-demo --out dist   # 构建 UMD 产物');
-    console.log('  bams-work env demo                          # 创建开发环境配置');
+    console.log('  bams-work env                               # 创建开发环境配置（交互式）');
     console.log('  bams-work update                            # 升级 @bams-app 包');
     console.log('  bams-work pages-entry --dir energy-ui --type page');
     console.log('  bams-work pages-from-components --dir energy-ui');
@@ -57,6 +56,11 @@ async function main() {
         process.exit(0);
     }
 
+    if (DISABLED_COMMANDS.includes(command)) {
+        console.error(colorize(`命令已暂时下线: ${command}`, 'red'));
+        process.exit(1);
+    }
+
     const commandPath = path.resolve(__dirname, '../commands', `${command}.js`);
     if (!fs.existsSync(commandPath)) {
         console.error(colorize(`未知命令: ${command}`, 'red'));

package/commands/add.js

@@ -132,7 +132,8 @@ async function main(args) {
 
     success(`组件创建成功: ${toKebabCase(params.name)}（scope: ${scopeDir}）`);
     info(`开发: bams-work dev <env> ${toKebabCase(params.name)}`);
-    info(`UMD: bams-work umd ${toKebabCase(params.name)}`);
+    // UMD 命令暂时下线，恢复后取消注释
+    // info(`UMD: bams-work umd ${toKebabCase(params.name)}`);
 }
 
 module.exports = main;

package/commands/create.js

@@ -141,8 +141,7 @@ async function main(args) {
     copyDir(PROJECT_TEMPLATE_DIR, targetDir);
 
     const tplRenames = [
-        ['gitignore.tpl', '.gitignore'],
-        ['.npmrc.tpl', '.npmrc']
+        ['gitignore.tpl', '.gitignore']
     ];
     for (const [from, to] of tplRenames) {
         const tplPath = path.join(targetDir, from);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bams-app/work-cli",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "BAMS-Work 全局开发工具：复用 work 已发布的包（ui-dev-server / shared-env / create-ui-*）提供项目初始化与组件开发能力（类似 vue-cli）",
   "main": "index.js",
   "bin": {
@@ -26,4 +26,4 @@
     "node": ">=16.7.0"
   },
   "license": "UNLICENSED"
-}
+}

package/templates/project/.envs/.env.dev-demo

@@ -1,9 +1,3 @@
-# 开发环境（示例），可复制为 .env.dev-<标识> 使用
-#
-# ⚠ PROXY_TARGET 必须填写真实的后端服务地址，禁止填写 127.0.0.1 / localhost。
-#   当 PROXY_TARGET 指向本机（即 dev server 自身端口）时会形成代理自环，
-#   /bams-assets、/admin-api 等前缀的请求会返回 431，Vue 等全局库加载失败导致页面白屏。
-#   端口约定：PORT 与 PROXY_TARGET 的端口保持一致，首次使用请按实际后端地址修改。
 NODE_ENV=development
 PORT=8700
 PROXY_TARGET=http://192.168.7.11:8700
@@ -12,7 +6,3 @@ BASE_URL=/
 VUE_APP_TITLE=BAMS组件开发环境
 VUE_APP_SYS_CODE=bams-demo
 VUE_APP_SYS_NAME=BAMS组件开发示例
-
-# 可配置插槽（可选，留空使用默认空组件）
-# COMPONENT_LOGIN=@bams-app/ui-login-component
-# COMPONENT_STARTR_LAYOUT=@bams-app/ui-startr-layout-component

package/templates/project/README.md

@@ -16,57 +16,127 @@
     └── ui-xxx
 ```
 
-## 常用命令
+## 快速开始
 
 ```bash
-# 开发（加载 .envs/.env.dev-<env>，默认组件 ui-component-demo）
-bams-work dev demo
-bams-work dev demo ui-order-list
+npm install            # 安装依赖到根 node_modules
+bams-work dev demo     # 启动开发环境（示例环境端口 8700）
+```
+
+> 所有 `bams-work` 命令都在**项目根目录**执行（即含 `.bams-work/` 的目录）。
+> 全局帮助 `bams-work --help`，查看版本 `bams-work --version`。
+
+## 命令一览
 
-# 构建宿主应用（production，输出 dist/）
-bams-work build ui-order-list
+| 命令                                                 | 作用                        |
+| ---------------------------------------------------- | --------------------------- |
+| `dev <env> [component]`                              | 启动开发服务（最常用）      |
+| `add --dir <scope> --name <name>`                    | 新建组件 / 页面 / 基础组件  |
+| `env`                                                | 交互式创建开发环境配置      |
+| `update`                                             | 升级 `@bams-app` 依赖       |
+| `pages-entry --dir <scope> --type <page\|component>` | 生成 webpack 动态入口       |
+| `pages-from-components --dir <scope>`                | 批量将 `ui-*` 转为 `page-*` |
 
-# 构建组件 UMD 产物（输出 dist/umd/）
-bams-work umd ui-order-list
+### 1. `bams-work dev` — 启动开发环境
 
-# 在 scope 目录下创建新组件
-bams-work add --dir energy-ui --name ui-order-list
-bams-work add --dir energy-ui --name page-order-list --type page
+```bash
+bams-work dev demo                              # 加载 .envs/.env.dev-demo，默认组件 ui-component-demo
+bams-work dev demo ui-order-list                # 指定要调试的组件
+bams-work dev demo ui-order-list --layout touch # 切换布局（默认 pc）
+bams-work dev demo ui-order-list -- --port 8080 # `--` 之后的参数透传给 vue-cli-service
 ```
 
-## 首次安装
+| 参数                | 必填 | 说明                                                                                   |
+| ------------------- | ---- | -------------------------------------------------------------------------------------- |
+| `<env>`             | 是   | 环境标识，对应 `.envs/.env.dev-<env>`；文件不存在会直接报错，先用 `bams-work env` 创建 |
+| `[component]`       | 否   | 组件目录名（如 `ui-order-list`），省略时默认 `ui-component-demo`                       |
+| `--layout`、`-l`    | 否   | 布局：`pc`（默认）/ `touch`                                                            |
+| `--component`、`-c` | 否   | 等价于位置参数 `[component]`                                                           |
+| `--` 之后的参数     | 否   | 原样透传给底层 `vue-cli-service`（如 `--port`、`--open`）                              |
+
+启动地址与接口代理取自环境文件：`PORT` 决定本地端口，`PROXY_TARGET` 决定后端代理目标。
+
+### 2. `bams-work add` — 新建组件
 
 ```bash
-npm install
-# 或
-yarn install
+bams-work add --dir energy-ui --name ui-order-list                # 业务组件（默认 type=component）
+bams-work add --dir energy-ui --name page-order-list --type page  # 页面
+bams-work add --dir demo-ui --name ui-base-btn --type base        # 基础组件
 ```
 
-`@bams-app/ui-dev-server` 及其依赖的能力包（`@bams-app/components` 等）会安装到根 node_modules，
-业务组件与 work 开发环境共用同一套能力实例。项目 `.npmrc` 配置了 `install-links=true`，
-`file:` 安装的能力包会以复制方式解析其全部传递依赖（vue、ant-design-vue 等自动安装），
-因此 `package.json` 无需声明任何外部运行时依赖。
+| 参数     | 必填 | 说明                                                                                                                    |
+| -------- | ---- | ----------------------------------------------------------------------------------------------------------------------- |
+| `--dir`  | 是   | scope 目录名（小写字母、数字、连字符，如 `energy-ui`）；不存在会自动创建，并自动注册到根 `package.json` 的 `workspaces` |
+| `--name` | 是   | 组件名，自动转为 kebab-case；`component`/`base` 建议 `ui-` 前缀，`page` 建议 `page-` 前缀                               |
+| `--type` | 否   | `component`（默认）/ `page` / `base`                                                                                    |
+| `--desc` | 否   | 组件描述                                                                                                                |
 
-## 更新升级
+创建完成后会提示用哪条 `dev` 命令调试。
 
-### 1. 升级 CLI（`bams-work` 与创建命令）
+### 3. `bams-work env` — 创建开发环境
+
+交互式向导，无需记参数，生成 `.envs/.env.dev-<标识>`：
 
 ```bash
-npm i -g @bams-app/work-cli@latest
+bams-work env
+```
+
+流程：列出已有环境与已占用端口 → 选择创建方式 → 输入环境标识 → 逐项填写配置 → 预览确认后写入。
+
+创建方式二选一：
+
+- **快速复制**：基于现有环境文件，或 `production` 空值模板，只改差异项（推荐）
+- **自定义配置**：从默认模板逐项填写
+
+环境标识即 `dev` 的第一个参数：`bams-work env` 创建了 `test`，就用 `bams-work dev test` 启动。
+
+常用字段（可直接编辑对应环境文件，`dev` 每次启动都会重新加载）：
+
+| 字段                                                                                        | 说明                                                 |
+| ------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| `NODE_ENV`                                                                                  | 运行环境，固定 `development`                         |
+| `PORT`                                                                                      | 开发服务器端口（创建时自动避开其他环境已占用的端口） |
+| `PROXY_TARGET`                                                                              | 接口代理目标（后端服务地址）                         |
+| `BASE_URL`                                                                                  | 应用基础路径，默认 `/`                               |
+| `COMPONENT_LOGIN`、`COMPONENT_STARTR_LAYOUT`                                                | 可配置组件插槽：登录页 / 布局组件包名                |
+| `VUE_APP_TITLE`、`VUE_APP_SYS_NAME`、`VUE_APP_SYS_CODE`                                     | 浏览器标签标题、系统名称、系统编码                   |
+| `VUE_APP_SHOW_HEADER`、`VUE_APP_ENABLE_THEME`、`VUE_APP_THEME_MODE`、`VUE_APP_THEME_PRESET` | 头部显示与主题（模式 / 预设色）                      |
+| `VUE_APP_ENABLE_I18N`、`VUE_APP_ENABLE_VERSION_LOG`、`VUE_APP_TABS_EXPAND_STATE`            | 国际化、版本日志、Tabs 展开/收起                     |
+| `VUE_APP_ENABLE_CAPTCHA`、`VUE_APP_ENABLE_MESSAGE_VOICE`、`VUE_APP_MESSAGE_WS_URL`          | 登录验证码、消息告警通知及其 WS 地址                 |
+| `VUE_APP_LOGIN_URL`、`VUE_APP_LOGIN_PUBLIC_KEY`、`VUE_APP_WEBSOCKET_URL`                    | 登录页地址、登录公钥、WebSocket 地址                 |
+| `VUE_APP_DEVEXTREME_LICENSE_KEY`                                                            | DevExtreme 许可证密钥（可留空）                      |
+
+### 4. `bams-work update` — 升级依赖
+
+```bash
+bams-work update                  # 升级并重装依赖
 ```
 
-### 2. 升级项目依赖
+### 5. 其他命令
+
+- `bams-work pages-entry --dir <scope> --type page|component`：扫描该 scope 下的 `page-*` / `ui-*` 目录，生成 webpack 动态入口 `build-components-entry.js`（构建流程内部使用，一般无需手动执行）
+- `bams-work pages-from-components --dir <scope>`：把该 scope 下的 `ui-*` 组件批量复制为 `page-*` 页面
 
-项目运行时依赖只有 `@bams-app/ui-dev-server`，其余能力包（`@bams-app/components` 等）由它传递安装。
+## 首次安装
 
 ```bash
-# 查询最新版、更新 package.json 中的 ui-dev-server 声明并重装依赖
-bams-work update
+npm install
+# 或
+yarn install
 ```
 
-## 环境变量
+`@bams-app/ui-dev-server` 及其依赖的能力包（`@bams-app/components` 等）会安装到根 node_modules，
+业务组件与 work 开发环境共用同一套能力实例；能力包的传递依赖（vue、ant-design-vue 等）由 npm
+自动安装，因此 `package.json` 无需声明任何外部运行时依赖。
+
+## 升级 CLI
+
+```bash
+npm i -g @bams-app/work-cli@latest
+```
 
-见 `.envs/README.md`。新增环境：`cp .envs/.env.dev-demo .envs/.env.dev-<标识>`。
+项目运行时依赖只有 `@bams-app/ui-dev-server`，其余能力包（`@bams-app/components` 等）由它传递安装，
+升级项目依赖用 `bams-work update`（见上文）。
 
 ## 自定义配置
 

package/templates/project/package.json

@@ -12,11 +12,25 @@
   ],
   "scripts": {
     "dev": "bams-work dev",
-    "build": "bams-work build",
-    "umd": "bams-work umd",
     "add": "bams-work add"
   },
   "dependencies": {
-    __UI_DEV_SERVER_DEP____CAPABILITY_DEPS__
+    __UI_DEV_SERVER_DEP____CAPABILITY_DEPS__,
+    "@ant-design/icons-vue": "^7.0.1",
+    "ant-design-vue": "4.2.6",
+    "axios": "^1.13.2",
+    "core-js": "^3.8.3",
+    "dayjs": "^1.11.20",
+    "devextreme": "25.2.3",
+    "devextreme-exceljs-fork": "^4.4.8",
+    "devextreme-vue": "25.2.3",
+    "file-saver": "^2.0.5",
+    "flex.css": "^1.1.7",
+    "jsencrypt": "^3.5.4",
+    "marked": "^17.0.4",
+    "pinia": "^3.0.4",
+    "pinia-plugin-persistedstate": "^4.7.1",
+    "vue": "^3.5.24",
+    "vue-router": "4"
   }
 }

package/templates/project/.envs/README.md

@@ -1,52 +0,0 @@
-# 项目环境配置
-
-本目录存放各业务系统环境变量，`bams-work dev <env>` 会加载 `.env.dev-<env>`。
-
-## 环境文件格式
-
-- `.env.dev-demo`：开发环境示例（跟随本模板生成）
-- `.env.production`：生产环境（构建时加载）
-
-## 关键变量
-
-| 变量名                    | 说明                                                 |
-| ------------------------- | ---------------------------------------------------- |
-| `PROXY_TARGET`            | 开发代理目标地址（真实后端服务主机，禁止写本机地址） |
-| `PORT`                    | 开发服务器端口，需与代理目标端口一致                 |
-| `BASE_URL`                | 应用基础路径                                         |
-| `VUE_APP_TITLE`           | 浏览器标签页标题                                     |
-| `VUE_APP_SYS_CODE`        | 系统编码                                             |
-| `COMPONENT_LOGIN`         | 登录组件包名（可配置插槽）                           |
-| `COMPONENT_STARTR_LAYOUT` | 布局组件包名（可配置插槽）                           |
-| `VUE_APP_*`               | 注入前端代码的编译变量（勿存放敏感信息）             |
-
-> ⚠️ **`PROXY_TARGET` 不要填写 `127.0.0.1` / `localhost`**
->
-> 当 `PROXY_TARGET` 与开发服务器自身同地址同端口时，代理会指向自己形成自环，
-> `/bams-assets`、`/bams-ui-umd`、`/bams-app`、`/admin-api`、`/preview` 等前缀的请求将返回
-> **431 Request Header Fields Too Large**，Vue / Vue Router / Pinia 等全局库无法加载，
-> 表现为**页面白屏且控制台无报错**。请填写真实后端主机，例如 `http://192.168.7.11:8700`。
-
-## 创建新环境
-
-```bash
-# 复制示例
-cd .envs
-cp .env.dev-demo .env.dev-<新标识>
-```
-
-> 命名规范：`.env.dev-<标识>`，标识仅允许小写字母、数字和连字符。
-
-## 代理配置
-
-默认内置代理前缀：`/bams-assets`、`/bams-ui-umd`、`/bams-app`、`/admin-api`、`/preview`。
-
-如需自定义代理，在项目根创建 `.proxy.js`：
-
-```js
-module.exports = {
-  proxy: {
-    '/my-api': { target: 'http://192.168.1.100:8080', changeOrigin: true }
-  }
-};
-```

package/templates/project/.npmrc.tpl

@@ -1 +0,0 @@
-install-links=true