create-g2rain-app v1.0.2

发布日期：2026-11-01
对比版本：v1.0.1
许可证：Apache-2.0

发布内容

本版本的 CLI 命令、参数和项目族行为保持兼容。主要变化是将 App 与 Shell 官方模板的 v1.0.2 快照纳入 npm 包，使新生成项目获得配套的宿主跳转、SSO 回跳隔离、主题和生产构建更新。

Frontend App 模板

• 支持 g2shell 指定同域宿主壳；缺失或非法时使用默认宿主 Origin 与 redirect 前缀。
• 独立模式 SSO 回跳键改为 return_url:${VITE_CONTEXT_PATH}，隔离同域不同应用。
• production 模式裁剪 console.log、console.info、console.debug，保留 warn/error。
• dict Mock 的状态用途码修正为 SUBJECT_STATUS。

Frontend Shell 模板

• 子应用地址统一附加 g2shell，Gateway 恢复前移除该宿主参数。
• SSO 回跳键改为 return_url:${getContextPath()}，按壳隔离。
• single-spa bootstrap/mount 超时保持 10 秒，8 秒开始告警。
• Passport 与 TenantProvision 页面采用 --g2-* 主题变量；production 模式裁剪 log/info/debug。
• 默认 Shell 保持 AppKit 单协议；legacy 能力继续通过 --with-legacy 覆盖层提供。

版本组合

组成	版本
create-g2rain-app	1.0.2
g2rain-app-template	v1.0.2
g2rain-shell-template	v1.0.2
Frontend App Profile	1.0.0（中央仓库 Tag v1.0.2）
Frontend Shell Profile	1.0.0（中央仓库 Tag v1.0.2）
@g2rain/http / platform / theme / ui	1.0.1

模板快照元数据必须记录源 Tag、完整提交和内容 Hash。正式内容由 sync-templates 工作流从两个模板的 v1.0.2 Tag 同步，默认 Shell 与 legacy overlay 分别保存。

升级影响

• 该版本影响新生成项目，不会自动修改已有 App 或 Shell；已有项目按各模板 v1.0.2 Release 评估迁移。
• App 与 Shell 的 g2shell 约定应配套使用。壳 Context Path 应为子应用接受的单段名称。
• 旧 return_url 不迁移，升级过程中未完成的登录回跳需要重新发起。
• 生成 frontend-app 时，CLI 会把模板中的 create-g2rain-app 开发依赖改写为 ^1.0.2。
• CLI 命令形状、默认 family、参数校验和 --with-legacy 语义没有破坏性变化。

发布验证

发布前执行：

1. npm run verify:template-snapshots，确认三份快照的 sourceRef 为 v1.0.2 且 Hash 有效。
2. npm test，覆盖 CLI 构建、命令分发、生成器、资源生成、身份改写和模板快照。
3. 在临时目录生成 app、默认 shell、shell --with-legacy，检查身份、占位符、排除项和模板来源。
4. npm pack --dry-run，确认 tarball 包含 dist 与三份快照，不包含 node_modules 或本地文件。
5. 发布工作流使用候选 tarball 构建三个生成项目，再通过 Trusted Publishing 发布。

相关文档：模板快照治理 · 发布流程 · 使用手册

G2rain App CLI v1.0.1

更新内容

项目创建

• 同步 App Template、Shell Template 及可选 Legacy Overlay 至 v1.0.1。
• 模板统一使用 Appkit 1.0.1。
• 完善项目名、Context Path 和生成表名校验。
• 非交互模式使用默认 Context Path。
• 修正项目身份信息替换，创建失败时清理本次生成的目录。
• 生成项目的 CLI 依赖使用 Registry 版本，避免依赖本地仓库路径。
• 修复模板 .gitignore、.npmrc 的打包与生成还原。

代码与权限资源生成

• SQL 中不存在目标表时，在写入文件前报错。
• 权限扫描限定于 Vue 模板，支持静态 v-permission 和组件 permission 属性。
• 完善嵌套模板中的权限提取，避免将脚本赋值误识别为权限声明。
• 生成列表页统一使用 HTTP 错误处理，查询重置保留排序条件。

文档

• 重构 README，优先推荐 g2rain-app。
• 补齐命令、参数、工作原理和 FAQ。

使用

npm install -g create-g2rain-app@1.0.1

g2rain-app app g2rain-order-app --context-path order
g2rain-app shell g2rain-admin-shell --context-path admin --port 3000

已有业务项目可使用 generate 生成 CRUD 骨架，使用 build-config 生成页面及页面元素权限资源。

v1.0.0

chore(templates): sync managed template snapshots (#12)