谷雨开源 SaaS 平台（G2rain）
本文档由 g2rain-app-cli 的 docs/development/local-development.md 自动同步生成。
# 本地开发

本文只服务 本仓库（g2rain-app-cli）开发者。普通用户创建项目请全局安装已发布包，见 使用手册：

npm install -g create-g2rain-app@1.0.0
g2rain-app app ...

# 安装和构建

npm ci
npm run build

构建使用 tsc -p tsconfig.json，ESM 输出到 dist。dist/index.js 必须保留 Node shebang，两个 bin 才能直接执行。

# 安全验证 CLI

npm run dev 会立即运行 CLI 并可能在当前目录创建项目。推荐先创建临时父目录并使用本地模板：

$env:G2RAIN_TEMPLATE_PATH = 'D:\github\g2rain-app-template'
New-Item -ItemType Directory -Force -Path "$env:TEMP\g2rain-cli-smoke" | Out-Null
Set-Location "$env:TEMP\g2rain-cli-smoke"
node D:\github\g2rain-app-cli\dist\index.js smoke-app --context-path smoke

检查完成后只清理明确的临时目录，不在仓库根运行递归删除。普通冒烟优先 node dist/index.js，不要默认 npm link。

开发中需要在任意目录以 g2rain-app 命令验证未发布改动时：

npm run build
npm link
g2rain-app smoke-app --context-path smoke

npm link 会覆盖本机全局同名 bin，用完后按团队环境处理（例如改回 npm install -g create-g2rain-app@1.0.0）。不要把它写进面向业务开发者的安装说明。

# 调试

npm run dev -- smoke-app --context-path smoke

npm 会把 -- 后参数传给 tsx src/index.ts。务必在临时工作目录运行。

# 修改前检查

  • 参数变化是否同时影响两个 bin。
  • 交互默认值与非交互规范化是否一致。
  • 模板路径是目录、包含必需文件且 Profile 版本兼容。
  • 复制/替换失败是否会留下目标目录。
  • 模板新增占位符是否同步 CLI 清单。
  • README、docs/project.yaml、发布包元数据是否一致。