@bams-app/work-cli 0.0.3 → 0.0.4

package/README.md

@@ -16,8 +16,10 @@ BAMS-Work 全局开发工具（类似 vue-cli 模式），提供**项目初始
 | 批量页面创建 | `@bams-app/create-pages-from-components`（批量将 ui-* 转为 page-*，复用 create-ui-page） |
 | 公共配置 | `@bams-app/configs`（app-config.json、可配置组件插槽默认值，被 ui-dev-server 与 store 依赖） |
 
-- `create` 生成 **scope 目录模式** Monorepo：根 `workspaces: ["bams-components/*", "*-ui/*", "bams-ui"]`，
+- `create` 生成 **scope 目录模式** Monorepo：根 `workspaces: ["demo-ui/*", "bams-components/*", "*-ui/*", "apex-web/*", "bams-ui"]`，
   业务组件按 scope 目录存放（`energy-ui/ui-xxx`）。
+- `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 等随能力包自动安装）。
@@ -56,11 +58,11 @@ flowchart LR
 
 ```
 用户项目（Monorepo，scope 目录模式）
-├── package.json            # workspaces: bams-components/*、*-ui/*、bams-ui
+├── package.json            # workspaces: demo-ui/*、bams-components/*、*-ui/*、apex-web/*、bams-ui
 ├── .bams-work/             # BAMS-Work 项目标记目录（勿删除）
 ├── .envs/.env.dev-<env>    # 环境变量
 ├── .proxy.js               # 自定义代理（可选）
-├── bams-components/
+├── demo-ui/                # 默认组件 scope
 │   └── ui-component-demo   # 示例组件
 └── energy-ui/              # 业务 scope 目录
     └── ui-order-list
@@ -93,7 +95,7 @@ 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
-bams-work add --dir bams-components --name ui-base-btn --type base
+bams-work add --dir demo-ui --name ui-base-btn --type base
 
 # 升级 @bams-app 包（查询最新版并重装依赖）
 bams-work update

package/commands/create.js

@@ -85,7 +85,7 @@ function createDemoComponent(targetDir) {
             process.execPath,
             [
                 createComponentBin,
-                '--dir', path.join(targetDir, 'bams-components'),
+                '--dir', path.join(targetDir, 'demo-ui'),
                 '--name', 'ui-component-demo',
                 '--desc', 'componentDemo',
                 '--no-install'

package/package.json

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

package/templates/project/README.md

@@ -1,19 +1,18 @@
 # BAMS-Work Monorepo 项目
 
-基于 `@bams-app/work-cli` 初始化的组件开发项目（类似 vue-cli 模式）。
-work 开发环境（`@bams-app/ui-dev-server`）与创建命令（`@bams-app/create-ui-*`）直接复用 work 仓库发布的 npm 包。
+基于 `@bams-app/work-cli` 初始化的组件包开发项目
 
 ## 目录结构
 
 ```
 .
-├── package.json          # Monorepo 根（workspaces: bams-components/*、*-ui/*、bams-ui）
+├── package.json          # Monorepo 根（见 package.json 的 workspaces）
 ├── .bams-work/           # BAMS-Work 项目标记目录，勿删除
 ├── .envs/                # 环境配置（.env.dev-<env>）
 ├── .proxy.js             # 自定义开发代理（可选）
-├── bams-components/      # 默认组件 scope
+├── demo-ui/              # 默认组件 scope
 │   └── ui-component-demo # 示例组件
-└── <scope>-ui/           # 业务 scope 目录（如 energy-ui/，add 时创建）
+└── <scope>-ui/           # 其他业务 scope 目录（如 energy-ui/，add 时创建）
     └── ui-xxx
 ```
 
@@ -48,6 +47,23 @@ yarn install
 `file:` 安装的能力包会以复制方式解析其全部传递依赖（vue、ant-design-vue 等自动安装），
 因此 `package.json` 无需声明任何外部运行时依赖。
 
+## 更新升级
+
+### 1. 升级 CLI（`bams-work` 与创建命令）
+
+```bash
+npm i -g @bams-app/work-cli@latest
+```
+
+### 2. 升级项目依赖
+
+项目运行时依赖只有 `@bams-app/ui-dev-server`，其余能力包（`@bams-app/components` 等）由它传递安装。
+
+```bash
+# 查询最新版、更新 package.json 中的 ui-dev-server 声明并重装依赖
+bams-work update
+```
+
 ## 环境变量
 
 见 `.envs/README.md`。新增环境：`cp .envs/.env.dev-demo .envs/.env.dev-<标识>`。

package/templates/project/package.json

@@ -4,8 +4,10 @@
   "private": true,
   "description": "BAMS-Work Monorepo 项目",
   "workspaces": [
+    "demo-ui/*",
     "bams-components/*",
     "*-ui/*",
+    "apex-web/*",
     "bams-ui"
   ],
   "scripts": {