@bams-app/work-cli 0.0.7 → 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,7 +38,7 @@ 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}"`;
         }
@@ -62,13 +62,13 @@ function buildCapabilityDeps() {
                 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.7",
+  "version": "0.0.8",
   "description": "BAMS-Work 全局开发工具：复用 work 已发布的包（ui-dev-server / shared-env / create-ui-*）提供项目初始化与组件开发能力（类似 vue-cli）",
   "main": "index.js",
   "bin": {