@ranger1/dx 0.1.81 → 0.1.82

package/README.md

@@ -362,6 +362,49 @@ dx deploy backend --prod --skip-migration
 
 - 生成的 release `package.json` 默认只保留运行时依赖；如果应用把 `prisma` 放在 `devDependencies`，dx 会自动把它提升进 release 依赖，保证远端 `prisma generate` / `prisma migrate deploy` 可执行。
 - 打包前会递归扫描整个 staged payload；任意层级出现 `.env*` 文件都会直接失败，避免把环境文件误打进制品。
+- 所有本地路径字段都会被解析为相对项目根目录，并且必须留在项目根目录内；例如 `build.distDir`、`runtime.prismaSchemaDir`、`artifact.outputDir` 不能通过 `../` 逃逸到仓库外。
+- `remote.baseDir` 必须是绝对路径，并且只能包含 `/`、字母、数字、`.`、`_`、`-`；不要使用空格或 shell 特殊字符。
+
+SSH 认证说明：
+
+- `dx deploy backend` 当前直接调用系统 `ssh` / `scp`，不会单独解析 `sshKey`、`identityFile` 之类的 dx 配置项。
+- 因此，发布使用哪把私钥，取决于本机 OpenSSH 的默认认证行为，例如 `ssh-agent`、`~/.ssh/config`、默认私钥文件等。
+- 如果你已经在 `~/.ssh/config` 中配置了主机别名（例如 `Host ai-staging`），推荐直接把 `backendDeploy.remote.host` 写成这个别名，让 OpenSSH 自动匹配对应的 `HostName`、`User`、`Port`、`IdentityFile`。
+
+例如本机 `~/.ssh/config`：
+
+```sshconfig
+Host ai-staging
+  HostName 1.2.3.4
+  User deploy
+  Port 22
+  IdentityFile ~/.ssh/your_staging_key
+```
+
+对应的 `dx/config/commands.json`：
+
+```json
+{
+  "deploy": {
+    "backend": {
+      "internal": "backend-artifact-deploy",
+      "backendDeploy": {
+        "remote": {
+          "host": "ai-staging",
+          "port": 22,
+          "user": "deploy",
+          "baseDir": "/srv/example-app"
+        }
+      }
+    }
+  }
+}
+```
+
+注意：
+
+- `remote.host` 写成别名后，dx 仍会显式传入 `remote.user` 和 `remote.port`；如果这两个值与 `~/.ssh/config` 中的 `User` / `Port` 不一致，命令行参数会覆盖 SSH config。
+- 最稳妥的做法是让 `remote.user`、`remote.port` 与 `~/.ssh/config` 保持一致，或者都统一以 SSH config 中的值为准后再同步到 dx 配置。
 
 ## 依赖关系约定
 

package/lib/backend-artifact-deploy/artifact-builder.js

@@ -32,12 +32,25 @@ async function defaultReadVersion(versionFile) {
   return String(pkg.version || '').trim()
 }
 
-async function defaultRunBuild(build) {
+export function buildFlagsForEnvironment(environment) {
+  switch (environment || 'development') {
+    case 'production':
+      return { prod: true }
+    case 'staging':
+      return { staging: true }
+    case 'development':
+    default:
+      return { dev: true }
+  }
+}
+
+async function defaultRunBuild(build, environment = 'development') {
   if (!build?.command) {
     throw new Error('缺少构建命令: build.command')
   }
   await execManager.executeCommand(build.command, {
     app: build.app || undefined,
+    flags: buildFlagsForEnvironment(environment),
   })
 }
 
@@ -217,7 +230,7 @@ export async function buildBackendArtifact(config, deps = {}) {
   const checksumPath = resolveWithinBase(outputDir, names.checksumName, 'checksumPath')
   const bundlePath = resolveWithinBase(outputDir, names.bundleName, 'bundlePath')
 
-  await runBuild(config.build)
+  await runBuild(config.build, config.environment)
   await prepareOutputDir(outputDir)
   await stageFiles({
     config,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranger1/dx",
-  "version": "0.1.81",
+  "version": "0.1.82",
   "type": "module",
   "license": "MIT",
   "repository": {