@bams-app/work-cli 0.0.6 → 0.0.8

package/README.md

@@ -4,7 +4,8 @@ BAMS-Work 全局开发工具（类似 vue-cli 模式），提供**项目初始
 
 ## 设计思路
 
-`work-cli` 是**薄壳**，不内嵌任何模板/服务/能力包代码，全部复用 work 仓库发布到 npm 的包：
+`work-cli` 是**薄壳**，不内嵌任何服务/能力包代码（仅内嵌脚手架项目模板 `templates/project/`），
+全部复用 work 仓库发布到 npm 的包：
 
 | 能力 | 来源包 |
 | --- | --- |
@@ -34,14 +35,14 @@ BAMS-Work 全局开发工具（类似 vue-cli 模式），提供**项目初始
 
 ```mermaid
 flowchart LR
-    subgraph WORK["work 仓库（52 个可发布包）"]
+    subgraph WORK["work 仓库（全部可发布包）"]
         A["能力包<br/>packages/ · ui/ · configs/"]
-        B["开发工具<br/>cli/（ui-dev-server · create-* · template）"]
+        B["开发工具与模板<br/>tooling/ · templates/"]
     end
     subgraph REG["私有 registry<br/>npm.hedpy.cn"]
         C["@bams-app/*"]
     end
-    subgraph CLI["@bams-app/work-cli（薄壳）"]
+    subgraph CLI["@bams-app/work-cli（全局 CLI）"]
         D["create / add / dev<br/>env / pages-entry / pages-from-components"]
     end
     subgraph PROJ["用户项目（Monorepo）"]
@@ -127,8 +128,8 @@ bams-work update
 
 所有 work 包统一发布到 npm registry，**默认官方 npm（registry.npmjs.org）**，通过环境变量
 `NPM_REGISTRY` 可随时切换到私有 registry（如 `https://npm.hedpy.cn/`）。work 下所有含
-`package.json` 的目录（`packages/`、`cli/`、`ui/`、`configs/` 等）都会被打包发布，
-`private` 包自动跳过：
+`package.json` 的目录（`packages/`、`ui/`、`tooling/`、`templates/`、`cli/`、`configs/` 等）
+都会被打包发布，`private` 包自动跳过：
 
 ```bash
 # 0. 登录对应 registry（每次切换目标后需重新登录）
@@ -136,11 +137,9 @@ npm login --registry=https://registry.npmjs.org/        # 发布官方
 npm login --registry=https://npm.hedpy.cn/             # 切到私服时
 
 # 1. 在仓库根目录一键发布全部 work 包（交互式选择版本，只升不降）
+#    包含 work-cli 本体（work/cli），无需单独发布
 yarn publish-all                                        # 默认发布官方 npm
 NPM_REGISTRY=https://npm.hedpy.cn/ yarn publish-all    # 发布到私服
-
-# 2. 发布 work-cli 本体（dependencies 改为 registry 版本号后）
-cd work-cli && npm publish
 ```
 
 ### 单包发布
@@ -151,7 +150,7 @@ cd work-cli && npm publish
 ```bash
 cd work/packages/utils && npm publish --registry=https://registry.npmjs.org/
 cd work/ui/ui-header-component && npm publish --registry=https://registry.npmjs.org/
-cd work/cli/create-ui-component && npm publish --registry=https://registry.npmjs.org/
+cd work/tooling/create-ui-component && npm publish --registry=https://registry.npmjs.org/
 cd work/configs && npm publish --registry=https://registry.npmjs.org/
 ```
 
@@ -161,8 +160,8 @@ cd work/configs && npm publish --registry=https://registry.npmjs.org/
 能力包（`@bams-app/*`，含 `work/ui` 下的 ui 组件包）由 `ui-dev-server` 的 dependencies
 统一声明，发布后随 `npm install` 自动安装到用户项目，无需逐包注入。
 
-发布后 work-cli 的 `dependencies` 应从 `file:../work/cli/...` 改为对应 registry 版本号
-（`^0.0.1` 等），`create` 生成的项目则声明 `"@bams-app/ui-dev-server": "^0.0.1"`。
+`work-cli` 与 `create` 生成的项目均以 `"*"` 声明 `@bams-app/*` 依赖：仓库内经 yarn
+workspaces 链接到本地包，发布后自动解析为 registry 上最新的已发布版本，无需手动改版本号。
 
 ## 用户项目升级
 
@@ -217,8 +216,8 @@ bams-work update
 复制方式安装并解析其全部传递依赖；修改 work 包源码后需重新执行 `npm install` 才会生效：
 
 ```bash
-cd work-cli && npm install      # 安装 file: 依赖（链接 work/cli 下的包）
-npm link                        # 全局链接 bams-work
+yarn install                    # 在仓库根安装（yarn workspaces 链接 work/ 下的本地包）
+cd work/cli && npm link         # 全局链接 bams-work
 
 cd /tmp && rm -rf demo-app
 bams-work create demo-app        # 自动以 file: 引用本地 ui-dev-server 与能力包

package/commands/build.js

@@ -43,7 +43,7 @@ async function main(args) {
         buildAppBin = require.resolve('@bams-app/ui-dev-server/bin/build-app.js');
         sharedEnvBin = require.resolve('@bams-app/shared-env/bin/shared-env.js');
     } catch (err) {
-        error('未安装 work 依赖包，请先在 work-cli 目录执行 npm install');
+        error('未安装 work 依赖包，请先在 work/cli 目录执行 npm install');
         process.exit(1);
     }
 

package/commands/create.js

@@ -10,7 +10,7 @@ const PROJECT_TEMPLATE_DIR = path.join(TEMPLATES_DIR, 'project');
 /**
  * 探测 work 仓库根目录（本地验证模式定位 file: 引用来源）
  * 1. WORK_PROJECT_ROOT 环境变量优先
- * 2. 通过 file: 安装的 @bams-app/ui-dev-server 包真实路径上溯（ui-dev-server -> cli -> work -> 仓库根）
+ * 2. 通过 file: 安装的 @bams-app/ui-dev-server 包真实路径上溯（ui-dev-server -> tooling -> work -> 仓库根）
  * 3. 均不可用（registry 安装）时返回空，走发布模式
  * @returns {string} work 仓库根目录或空字符串
  */
@@ -38,36 +38,37 @@ function detectWorkRoot() {
 function buildUiDevServerDep() {
     const workRoot = detectWorkRoot();
     if (workRoot) {
-        const pkgDir = path.join(workRoot, 'work', 'cli', 'ui-dev-server');
+        const pkgDir = path.join(workRoot, 'work', 'tooling', 'ui-dev-server');
         if (isDirectory(pkgDir)) {
             return `"@bams-app/ui-dev-server": "file:${pkgDir}"`;
         }
     }
-    return `"@bams-app/ui-dev-server": "^0.0.1"`;
+    return `"@bams-app/ui-dev-server": "*"`;
 }
 
 /**
  * 生成能力包依赖声明（单一来源：ui-dev-server 的 dependencies 中 @bams-app/*）
  * - 本地验证模式（探测到 work 仓库）使用 file: 引用 work 仓库本地包（覆盖未发布包）
- * - 否则返回空（发布后能力包由 ui-dev-server 的 dependencies 自动安装）
+ * - 发布后模式沿用 ui-dev-server 声明的版本范围，保证与 ui-dev-server 的传递依赖同源，
+ *   安装时解析为同一份，避免同一能力包出现两个版本
  */
 function buildCapabilityDeps() {
     const workRoot = detectWorkRoot();
-    if (!workRoot) {
-        return '';
-    }
     const uiDevServerPkg = require(require.resolve('@bams-app/ui-dev-server/package.json'));
     return Object.entries(uiDevServerPkg.dependencies || {})
         .filter(([name]) => name.startsWith('@bams-app/'))
-        .map(([name]) => {
+        .map(([name, range]) => {
+            if (!workRoot) {
+                return `,\n    "${name}": "${range}"`;
+            }
             const short = name.replace('@bams-app/', '');
-            // 在 work/configs、work/packages、work/ui、work/cli 多个位置依次查找包目录
+            // 在 work/configs、work/packages、work/ui、work/tooling 多个位置依次查找包目录
             const pkgDir = short === 'configs' && isDirectory(path.join(workRoot, 'work', 'configs'))
                 ? path.join(workRoot, 'work', 'configs')
                 : [
                     path.join(workRoot, 'work', 'packages', short),
                     path.join(workRoot, 'work', 'ui', short),
-                    path.join(workRoot, 'work', 'cli', short)
+                    path.join(workRoot, 'work', 'tooling', short)
                 ].find(dir => isDirectory(dir));
             return `,\n    "${name}": "file:${pkgDir}"`;
         })

package/commands/dev.js

@@ -62,7 +62,7 @@ async function main(args) {
         sharedEnvBin = require.resolve('@bams-app/shared-env/bin/shared-env.js');
         uiDevServerBin = require.resolve('@bams-app/ui-dev-server/bin/ui-dev-server.js');
     } catch (err) {
-        error('未安装 work 依赖包，请先在 work-cli 目录执行 npm install');
+        error('未安装 work 依赖包，请先在 work/cli 目录执行 npm install');
         process.exit(1);
     }
 

package/commands/umd.js

@@ -142,7 +142,7 @@ async function main(args) {
     try {
         buildUmdBin = require.resolve('@bams-app/ui-dev-server/bin/build-umd.js');
     } catch (err) {
-        error('未安装 work 依赖包，请先在 work-cli 目录执行 npm install');
+        error('未安装 work 依赖包，请先在 work/cli 目录执行 npm install');
         process.exit(1);
     }
 

package/package.json

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

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

@@ -4,5 +4,5 @@ PROXY_TARGET=http://192.168.7.11:8700
 BASE_URL=/
 
 VUE_APP_TITLE=BAMS组件开发环境
-VUE_APP_SYS_CODE=bams-demo
+VUE_APP_SYS_CODE=bams-apex
 VUE_APP_SYS_NAME=BAMS组件开发示例

package/templates/project/.envs/.env.production

@@ -0,0 +1,49 @@
+# Shared Production Environment (complete config)
+# APP_PATH, WEBSOCKET_URL, LOGIN_URL and LICENSE_KEY are injected externally.
+# ==================== 编译时变量（构建配置用，修改后需重新打包） ====================
+# 应用基础路径
+BASE_URL=
+# 可配置组件插槽：登录页使用的组件（完整包名），例如 @bams-app/ui-login-component
+COMPONENT_LOGIN=
+# 可配置组件插槽：应用布局使用的组件（完整包名），部署时外部注入
+COMPONENT_STARTR_LAYOUT=
+
+# ==================== 编译注入 / 运行时读取变量 ====================
+# 应用标题：用于浏览器标签页显示
+VUE_APP_TITLE=
+# WebSocket 服务地址（用于实时消息推送），配置后自动进行连接，示例：/energy-ws
+VUE_APP_WEBSOCKET_URL=
+# 登录页面地址，外部登录页面地址，必须支持回调参数，默认走路由/login
+VUE_APP_LOGIN_URL=
+# 登录公钥（用于登录密码加密）
+VUE_APP_LOGIN_PUBLIC_KEY=
+# 系统编码：用于标识不同的业务系统，登录时传给后台接口
+VUE_APP_SYS_CODE=
+# 系统名称：用于在界面上显示的系统名称
+VUE_APP_SYS_NAME=
+# 显示头部：设置为 true 显示startr应用头部，否则隐藏
+VUE_APP_SHOW_HEADER=
+# DevExtreme 组件库许可证密钥，用于在应用中使用DevExtreme组件库
+VUE_APP_DEVEXTREME_LICENSE_KEY=
+# 主题功能开关：设置为 true 启用，不设置或其他值禁用
+VUE_APP_ENABLE_THEME=
+# 默认主题模式：light | dark | auto，留空使用默认值 light
+VUE_APP_THEME_MODE=
+# 默认主题色：material.blue | material.teal | material.purple | material.lime | material.orange，留空使用默认值 material.blue
+VUE_APP_THEME_PRESET=
+# i18n 国际化功能开关：设置为 true 启用，不设置或其他值禁用
+VUE_APP_ENABLE_I18N=
+# 版本日志功能开关：显式设置 true/1/on/yes 启用，不设置或其他值禁用
+VUE_APP_ENABLE_VERSION_LOG=true
+# Tabs 标签页展开/收起功能：留空不开启（默认收起）；expanded 开启且默认展开；collapsed 开启且默认收起
+VUE_APP_TABS_EXPAND_STATE=
+# 版本变化检测功能开关：默认关闭，显式设置 true/1/on/yes 启用；调试模式由代码参数 debug 控制（仅在功能开启后有效）
+VUE_APP_ENABLE_VERSION_CHECK=true
+# 运行时环境变量功能开关：开启后应用启动时从后台接口加载当前系统的环境变量配置，运行时覆盖构建注入值，无需重新打包即可调整前端配置；显式设置 true/1/on/yes 启用，不设置或其他值禁用（默认关闭），部署时外部注入
+VUE_APP_ENABLE_RUNTIME_ENV=false
+# 登录验证码功能开关：设置为 true 启用，不设置或其他值禁用
+VUE_APP_ENABLE_CAPTCHA=
+# 消息告警通知开关：设置为 true 启用，不设置或其他值禁用（默认关闭）
+VUE_APP_ENABLE_MESSAGE_VOICE=
+# 消息告警通知 WS 地址：留空使用默认 /message（自动补全为当前 host），部署时外部注入
+VUE_APP_MESSAGE_WS_URL=