create-ax-trusted-plugin 1.0.1 → 1.0.3

package/README.md

@@ -1,22 +1,27 @@
-# @ax-npm/create-trusted-plugin
+# create-ax-trusted-plugin
 
 可信(internal)插件**脚手架**:一条命令生成一个基于 `@ax-npm/host-trusted-sdk-v4` 的可信插件骨架
 (Module Federation remote + 共享 Vue + `activate(ctx)` + 自定义元素面板 + 调 `map.flyTo` + 遥测订阅)。
 
+> 脚手架本身已发**公网 npm**,生成这步**零配置**;生成出的工程才走私有源(`192.168.1.209` GitLab)拉
+> `@ax-npm/*` 依赖,届时只需一个 `GITLAB_TOKEN`(无需手建任何 `.npmrc`,工程自带)。
+
 ## 用法
 ```bash
 # 交互式(缺参数会提示输入 id/标题/锚点)
-npm create @ax-npm/trusted-plugin@latest my-panel
+npm create ax-trusted-plugin@latest my-panel
 
 # 非交互(传参)
-npm create @ax-npm/trusted-plugin@latest my-panel -- --title "我的面板" --anchor top-right
+npm create ax-trusted-plugin@latest my-panel -- --title "我的面板" --anchor top-right
 ```
 等价于直接跑 bin:`node bin/index.mjs my-panel --title "我的面板" --anchor top-right`。
 
-生成 `my-panel/` 后:
+生成 `my-panel/` 后(把 `GITLAB_TOKEN` 换成你的只读 PAT,按所用 shell 选一行):
 ```bash
 cd my-panel
-export GITLAB_TOKEN=<读权限 PAT>
+export GITLAB_TOKEN=<读权限 PAT>           # bash / git-bash
+# $env:GITLAB_TOKEN="<读权限 PAT>"        # PowerShell
+# set GITLAB_TOKEN=<读权限 PAT>           # cmd
 npm install
 npm run dev
 ```
@@ -36,8 +41,15 @@ npm run dev
 `tsconfig.json`、`.npmrc`、`.gitignore`、`README.md`。
 
 ## 发布(维护者)
+脚手架包发**公网 npm**(`publishConfig` 已指向 `registry.npmjs.org`、`access: public`):
 ```bash
-export GITLAB_TOKEN=<写权限 PAT>
-npm publish   # publishConfig → GitLab 项目 1243
+npm login --registry https://registry.npmjs.org/   # 首次
+npm publish --otp=<6位验证码>                       # npm 强制 2FA,验证码来自验证器 App
 ```
+- 若提示包名被占,改 `package.json` 的 `name`(及随之的 `npm create <name>` 用法)。
+- 自动化/CI 免输码:在 npm 生成「可绕过 2FA 的 Granular Access Token」,
+  以 `//registry.npmjs.org/:_authToken=<token>` 注入后 `npm publish`。
+
+> 注意:`template/` 内仍引用私网地址 `192.168.1.209`(RFC1918 不可路由,非机密),发公网后会公开可见。
+
 源码仓:GitLab 项目 1244。

package/bin/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// @ax-npm/create-trusted-plugin —— 可信(internal)插件脚手架。
+// create-ax-trusted-plugin —— 可信(internal)插件脚手架(发布于公网 npm)。
 // 用法:
-//   npm create @ax-npm/trusted-plugin <id> [-- --title "标题" --anchor top-right]
+//   npm create ax-trusted-plugin <id> [-- --title "标题" --anchor top-right]
 //   node bin/index.mjs <id> --title "标题" --anchor top-right
 // 把 template/ 复制到 <id>/,按 id/title/anchor 做占位替换(dotfile 以 _ 前缀存放,生成时改名)。
 import { readdir, readFile, writeFile, mkdir, stat } from 'node:fs/promises';
@@ -95,7 +95,10 @@ async function main() {
     console.log(`\n✓ 已生成可信插件:${rel}`);
     console.log('\n下一步:');
     console.log(`  cd ${rel}`);
-    console.log('  export GITLAB_TOKEN=<读权限 PAT>');
+    console.log('  # 设只读 PAT(按所用 shell 选一行):');
+    console.log('  export GITLAB_TOKEN=<读权限 PAT>      # bash / git-bash');
+    console.log('  $env:GITLAB_TOKEN="<读权限 PAT>"     # PowerShell');
+    console.log('  set GITLAB_TOKEN=<读权限 PAT>        # cmd');
     console.log('  npm install');
     console.log('  npm run dev   # build:watch + 静态托管 + host-dev,浏览器调试\n');
   } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ax-trusted-plugin",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "可信(internal)插件脚手架:一条命令生成一个基于 @ax-npm/host-trusted-sdk-v4 的可信插件骨架(Module Federation remote + 共享 Vue + activate(ctx))。用法:npm create ax-trusted-plugin <id>。生成器本身无机密,公网可装;生成出的工程仍走私有源拉 @ax-npm/* 依赖。",
   "type": "module",
   "license": "MIT",

package/template/README.md

@@ -1,11 +1,13 @@
 # __ID__
 
 可信(internal)插件:经 Module Federation 融入宿主进程、共享宿主 Vue、拿完整 `ctx`。
-由 `@ax-npm/create-trusted-plugin` 脚手架生成。
+由 `create-ax-trusted-plugin` 脚手架生成。
 
 ## 开发
 ```bash
-export GITLAB_TOKEN=<读权限 PAT>
+export GITLAB_TOKEN=<读权限 PAT>           # bash / git-bash
+# $env:GITLAB_TOKEN="<读权限 PAT>"        # PowerShell(别用 set / %VAR%)
+# set GITLAB_TOKEN=<读权限 PAT>           # cmd
 npm install
 npm run dev   # build:watch + serve(:5174) + host-dev(:5173)
 ```

package/template/package.json

@@ -9,17 +9,19 @@
     "build:watch": "vite build --watch",
     "serve": "node serve.mjs",
     "dev": "vite build && concurrently -k -n build,serve,host -c blue,magenta,green \"vite build --watch\" \"node serve.mjs\" \"host-dev --plugin http://localhost:5174\"",
+    "dev:electron": "vite build && concurrently -k -n build,serve,host -c blue,magenta,green \"vite build --watch\" \"node serve.mjs\" \"host-dev --electron --plugin http://localhost:5174\"",
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@ax-npm/host-trusted-sdk-v4": "^1.0.0",
+    "@ax-npm/host-trusted-sdk-v4": "^1.0.1",
     "vue": "^3.4.0"
   },
   "devDependencies": {
-    "@ax-npm/host-dev-v4": "^1.0.4",
+    "@ax-npm/host-dev-v4": "^1.0.7",
     "@originjs/vite-plugin-federation": "^1.3.5",
     "@vitejs/plugin-vue": "^5.0.0",
     "concurrently": "^9.0.0",
+    "electron": "^39.0.0",
     "pinia": "^2.1.7",
     "typescript": "^5.4.0",
     "vite": "^5.2.0",