create-swdg-frontend 0.2.0 → 0.2.1

package/README.md

@@ -1,15 +1,15 @@
 # create-swdg-frontend
 
-从 SWDG 模板生成新项目。CLI 仅负责拷贝与 **feature flags** 裁剪；业务约定在 `template/` 内维护。
-
-## 使用
+从 SWDG 模板生成新项目。npm 包名 **`create-swdg-frontend`**，对应命令：
 
 ```bash
-pnpm create swdg my-app
+pnpm create swdg-frontend my-app
 # 或
 pnpm dlx create-swdg-frontend my-app
 ```
 
+> `pnpm create swdg` 会去找包 `create-swdg`（与本包无关），请使用上面的 `swdg-frontend`。
+
 ### 常用参数
 
 | 参数 | 说明 |

package/lib/constants.js

@@ -6,7 +6,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 export const PACKAGE_ROOT = path.resolve(__dirname, '..');
 export const TEMPLATE_DIR = path.join(PACKAGE_ROOT, 'template');
 export const STUBS_DIR = path.join(PACKAGE_ROOT, 'stubs');
-export const SCAFFOLD_VERSION = '0.2.0';
+export const SCAFFOLD_VERSION = '0.2.1';
 
 /** 可选特性：重型依赖默认关闭，创建时 opt-in */
 export const FEATURES = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-swdg-frontend",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Scaffold a new SWDG frontend project",
   "type": "module",
   "bin": {

package/template/README.md

@@ -33,7 +33,7 @@ pnpm dev               # http://localhost:3000 ，改 .env 后需重启
 ## 创建新项目（脚手架）
 
 ```bash
-pnpm create swdg my-app
+pnpm create swdg-frontend my-app
 # 或
 npx create-swdg-frontend my-app
 ```
@@ -42,10 +42,10 @@ npx create-swdg-frontend my-app
 
 ```bash
 # 非 GIS 项目（推荐多数后台类应用）
-pnpm create swdg my-app --no-gis --install
+pnpm create swdg-frontend my-app --no-gis --install
 
 # GIS 项目
-pnpm create swdg my-app --gis --install
+pnpm create swdg-frontend my-app --gis --install
 ```
 
 ## 目录结构

package/template/docs/MAINTAINER.md

@@ -6,7 +6,7 @@
 
 ```
 frontend-framework/     # 模板源仓库（本仓库）
-├── create-swdg/        # npm 包 create-swdg-frontend
+├── create-swdg/        # npm 包 create-swdg-frontend（pnpm create swdg-frontend）
 │   ├── bin/index.js    # CLI 入口
 │   ├── lib/            # 提示、特性剥离、manifest
 │   ├── stubs/          # 无 GIS 时的配置替身
@@ -23,22 +23,20 @@ frontend-framework/     # 模板源仓库（本仓库）
 1. 登录 [npmjs.com](https://www.npmjs.com/)，确认账号已验证邮箱  
 2. 确认包名 **`create-swdg-frontend`**、**`swdg`** 在你账号下（首次需未被占用）  
 3. npm → Access Tokens → **Generate New Token**  
-   - 类型：**Granular**（Publish 权限）或 **Classic**（Automation）  
-4. GitHub 仓库 [Inupedia/swdg-frontend](https://github.com/Inupedia/swdg-frontend) → **Settings → Secrets and variables → Actions**  
-5. 新建 Secret：`NPM_TOKEN` = 上一步的 token  
+   - **必须** 选 **Granular Access Token**（Packages: Read and write）并勾选 **Bypass 2FA**，  
+     或 **Classic Token → Automation**（专为 CI 设计，不需要 OTP）  
+   - ⚠️ 不要用 Classic **Publish** token，CI 会报 `EOTP`  
+4. GitHub → **Settings → Secrets → Actions** → 更新 **`NPM_TOKEN`**
 
 **每次发版**
 
 ```bash
-# 1. 本地确认测试通过
-pnpm test:ci
-
-# 2. 提交并推到 GitHub（如有未 push 的改动）
+# 1. 提交并推到 GitHub（main 上 CI 会跑 test:ci）
 git push github main
 
-# 3. 打 tag 并推送（版本号与 tag 一致，格式 vX.Y.Z）
-git tag v0.2.0
-git push github v0.2.0
+# 2. 打 tag 并推送（版本号与 tag 一致，格式 vX.Y.Z；Release workflow 会再跑 test:ci 后 publish）
+git tag v0.2.1
+git push github v0.2.1
 ```
 
 4. 打开 **Actions → Release to npm**，等待 workflow 完成  
@@ -50,7 +48,7 @@ CI 会：从 tag 解析版本 → `test:ci` → 发布 `create-swdg-frontend`
 
 ```bash
 pnpm test:ci
-pnpm release 0.2.0
+pnpm release 0.2.1
 ```
 
 详见 [TESTING.md](./TESTING.md)。

package/template/docs/ONBOARDING.md

@@ -9,7 +9,7 @@
 | 方式               | 适合谁                           | 第一步                                                       |
 | ------------------ | -------------------------------- | ------------------------------------------------------------ |
 | **直接使用本仓库** | 团队统一模板、在 monorepo 上迭代 | `git clone` → `pnpm install`                                 |
-| **脚手架新建项目** | 每个业务一条独立仓库             | `pnpm create swdg my-app`（见根目录 [README](../README.md)） |
+| **脚手架新建项目** | 每个业务一条独立仓库             | `pnpm create swdg-frontend my-app`（见根目录 [README](../README.md)） |
 
 两种方式的项目结构、命令、路由约定 **一致**；脚手架可通过 `--gis` / `--no-gis` 裁剪 Cesium 相关文件。
 
@@ -259,7 +259,7 @@ pnpm preview
 ## 十三、脚手架创建新项目（摘要）
 
 ```bash
-pnpm create swdg my-app
+pnpm create swdg-frontend my-app
 cd my-app
 pnpm dev
 ```
@@ -267,7 +267,7 @@ pnpm dev
 - 交互默认 **不启用 GIS**；三维项目请选 Y 或加 `--gis`
 - 生成目录含 `docs/ONBOARDING.md`（与本文同步）和 `.swdg/manifest.json`（记录创建选项）
 
-更多参数：`create-swdg` 包内 `pnpm create swdg --help` 或根 [README](../README.md)。
+更多参数：`pnpm create swdg-frontend --help` 或根 [README](../README.md)。
 
 ---
 

package/template/docs/TESTING.md

@@ -1,6 +1,6 @@
 # 测试与发布门禁
 
-发布 `create-swdg-frontend` / `swdg` 到 npmjs **前必须** 通过完整测试管道。本地与 CI 使用同一套命令。
+发布 `create-swdg-frontend` / `swdg` 到 npmjs **前必须** 通过完整测试管道（tag 触发 Release 时由 GitHub Actions 执行；本地 `pnpm test:ci` 可选）。
 
 ## 命令一览