@bams-app/work-cli 0.0.1 → 0.0.3

package/README.md

@@ -165,12 +165,12 @@ cd work/configs && npm publish --registry=https://registry.npmjs.org/
 统一声明，发布后随 `npm install` 自动安装到用户项目，无需逐包注入。
 
 发布后 work-cli 的 `dependencies` 应从 `file:../work/cli/...` 改为对应 registry 版本号
-（`^0.1.0` 等），`create` 生成的项目则声明 `"@bams-app/ui-dev-server": "^0.1.0"`。
+（`^0.0.1` 等），`create` 生成的项目则声明 `"@bams-app/ui-dev-server": "^0.0.1"`。
 
 ## 用户项目升级
 
 用户项目依赖 `@bams-app/*` 的方式决定升级方式：本地验证模式为 `file:` 引用 work 本地包，
-发布后模式仅直接依赖 `@bams-app/ui-dev-server`（`^0.1.0`），能力包由 ui-dev-server 的
+发布后模式仅直接依赖 `@bams-app/ui-dev-server`（`^0.0.1`），能力包由 ui-dev-server 的
 dependencies（`"*"`）传递安装。
 
 ### 一键升级（推荐）

package/bin/work-cli.js

@@ -65,7 +65,10 @@ async function main() {
     }
 
     const handler = require(commandPath);
-    await handler(args);
+    const code = await handler(args);
+    if (typeof code === 'number' && code !== 0) {
+        process.exit(code);
+    }
 }
 
 main().catch((err) => {

package/commands/add.js

@@ -101,11 +101,13 @@ async function main(args) {
         process.exit(1);
     }
 
+    // 先校验组件类型并解析 create-ui-* 入口，校验不通过时不应留下任何副作用
+    const createBin = resolveCreateBin(type);
+
     // 将 scope 目录注册到项目 workspaces
     ensureWorkspaceScope(projectRoot, scopeDir);
 
     // 委托对应 create-ui-* 包（复用 work 的模板与命令）
-    const createBin = resolveCreateBin(type);
 
     const binArgs = [
         '--dir', path.resolve(projectRoot, scopeDir),

package/commands/create.js

@@ -43,7 +43,7 @@ function buildUiDevServerDep() {
             return `"@bams-app/ui-dev-server": "file:${pkgDir}"`;
         }
     }
-    return `"@bams-app/ui-dev-server": "^0.1.0"`;
+    return `"@bams-app/ui-dev-server": "^0.0.1"`;
 }
 
 /**
@@ -140,9 +140,15 @@ async function main(args) {
     // 1. 拷贝项目模板
     copyDir(PROJECT_TEMPLATE_DIR, targetDir);
 
-    const gitignoreTpl = path.join(targetDir, 'gitignore.tpl');
-    if (fs.existsSync(gitignoreTpl)) {
-        fs.renameSync(gitignoreTpl, path.join(targetDir, '.gitignore'));
+    const tplRenames = [
+        ['gitignore.tpl', '.gitignore'],
+        ['.npmrc.tpl', '.npmrc']
+    ];
+    for (const [from, to] of tplRenames) {
+        const tplPath = path.join(targetDir, from);
+        if (fs.existsSync(tplPath)) {
+            fs.renameSync(tplPath, path.join(targetDir, to));
+        }
     }
 
     // 2. 生成 .bams-work 标记目录（findProjectRoot 定位项目根）

package/package.json

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

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

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

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

@@ -9,16 +9,23 @@
 
 ## 关键变量
 
-| 变量名                    | 说明                                     |
-| ------------------------- | ---------------------------------------- |
-| `PROXY_TARGET`            | 开发代理目标地址（后端服务）             |
-| `PORT`                    | 开发服务器端口，需与代理目标端口一致     |
-| `BASE_URL`                | 应用基础路径                             |
-| `VUE_APP_TITLE`           | 浏览器标签页标题                         |
-| `VUE_APP_SYS_CODE`        | 系统编码                                 |
-| `COMPONENT_LOGIN`         | 登录组件包名（可配置插槽）               |
-| `COMPONENT_STARTR_LAYOUT` | 布局组件包名（可配置插槽）               |
-| `VUE_APP_*`               | 注入前端代码的编译变量（勿存放敏感信息） |
+| 变量名                    | 说明                                                 |
+| ------------------------- | ---------------------------------------------------- |
+| `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`。
 
 ## 创建新环境
 

package/templates/project/.npmrc.tpl

@@ -0,0 +1,2 @@
+@bams-app:registry=https://npm.hedpy.cn/
+install-links=true