@ranger1/dx 0.1.0 → 0.1.2

package/README.md

@@ -1,28 +1,27 @@
 # dx
 
-一个可安装的 Node.js CLI，用于管理 ai-monorepo 类项目的构建/启动/数据库/部署等流程。
+一个可安装的 Node.js CLI，用于管理符合约定的 pnpm + nx monorepo 项目的构建/启动/数据库/部署等流程。
 
 ## 安装
 
-项目内安装（推荐）：
+全局安装（推荐）：
 
 ```bash
-pnpm add -D dx
+pnpm add -g @ranger1/dx
 ```
 
-使用：
+安装后即可在任意目录使用：
 
 ```bash
-pnpm exec dx --help
-pnpm exec dx status
-pnpm exec dx build sdk --dev
+dx --help
+dx status
 ```
 
-也可以全局安装：
+项目内安装（可选，如果你更希望锁定版本）：
 
 ```bash
-pnpm add -g dx
-dx --help
+pnpm add -D @ranger1/dx
+pnpm exec dx --help
 ```
 
 ## 项目配置（必须）
@@ -46,6 +45,8 @@ dx/
 - 环境变量：`DX_CONFIG_DIR=/abs/path/to/config`
 - 参数：`dx --config-dir /abs/path/to/config ...`
 
+全局安装场景下，如果你不在项目目录内执行，也可以通过 `DX_CONFIG_DIR` / `--config-dir` 显式指定配置目录（目录下需要存在 `commands.json`）。
+
 ## 命令
 
 dx 的命令由 `dx/config/commands.json` 驱动，并且内置了一些 internal runner（避免项目侧依赖任何 `scripts/lib/*.js`）：
@@ -75,7 +76,7 @@ dx test e2e backend
 
 ```json
 {
-  "command": "../../node_modules/.bin/dx-with-version-env --app front -- next build"
+  "command": "dx-with-version-env --app front -- next build"
 }
 ```
 
@@ -83,10 +84,11 @@ dx test e2e backend
 
 ## 约束与假设
 
-当前版本面向 ai-monorepo 类结构，默认假设：
+当前版本面向 pnpm + nx 的 monorepo，默认假设：
 
 - 使用 pnpm + nx
-- 项目布局包含 `apps/backend`、`apps/front`、`apps/admin-front`、`apps/sdk`
+- 项目布局包含 `apps/backend`、`apps/front`、`apps/admin-front`、`apps/sdk`（如果你的命令配置不依赖这些目录，可自行调整）
+- 版本注入脚本 `dx-with-version-env` 默认支持 app: `backend` / `front` / `admin`
 
 ## 发布到 npm（准备工作）
 
@@ -100,4 +102,3 @@ dx test e2e backend
 npm publish --access public --registry=https://registry.npmjs.org
 ```
 
-提示：当前仓库包含一个 `.npmrc`，用于确保 publish 走 npm 官方 registry（避免镜像源导致发布失败）。

package/bin/dx.js

@@ -43,24 +43,60 @@ function findProjectRootFrom(startDir) {
   }
 }
 
+function findRepoRootFrom(startDir) {
+  let current = resolve(startDir)
+  while (true) {
+    // ai-monorepo style marker
+    if (existsSync(join(current, 'pnpm-workspace.yaml'))) return current
+    // fallback marker
+    if (existsSync(join(current, 'package.json'))) return current
+
+    const parent = dirname(current)
+    if (parent === current) return null
+    current = parent
+  }
+}
+
+function inferProjectRootFromConfigDir(configDir, startDir) {
+  const normalized = String(configDir).replace(/\\/g, '/')
+  if (normalized.endsWith('/dx/config')) return resolve(configDir, '..', '..')
+  if (normalized.endsWith('/scripts/config')) return resolve(configDir, '..', '..')
+
+  return findRepoRootFrom(configDir) || findRepoRootFrom(startDir) || resolve(startDir)
+}
+
 async function main() {
   const rawArgs = process.argv.slice(2)
   const overrideConfigDir = parseConfigDir(rawArgs)
   const filteredArgs = stripConfigDirArgs(rawArgs)
 
   const startDir = process.cwd()
-  const projectRoot = findProjectRootFrom(startDir)
-  if (!projectRoot) {
-    console.error('dx: 未找到项目配置目录: dx/config/commands.json')
-    console.error('dx: 请在项目目录内执行 dx，或先创建 dx/config 并放置 commands.json')
-    console.error('dx: 也可通过 DX_CONFIG_DIR 或 --config-dir 指定配置目录')
-    process.exit(1)
+  let projectRoot
+  let configDir
+
+  if (overrideConfigDir) {
+    // When dx is installed globally, users may prefer providing DX_CONFIG_DIR/--config-dir.
+    // In that case, do not require dx/config marker discovery.
+    configDir = resolve(startDir, overrideConfigDir)
+    if (!existsSync(join(configDir, 'commands.json'))) {
+      console.error(`dx: 配置目录无效: ${configDir}`)
+      console.error('dx: 期望存在 commands.json')
+      process.exit(1)
+    }
+    projectRoot = inferProjectRootFromConfigDir(configDir, startDir)
+  } else {
+    projectRoot = findProjectRootFrom(startDir)
+    if (!projectRoot) {
+      console.error('dx: 未找到项目配置目录: dx/config/commands.json')
+      console.error('dx: 请在项目目录内执行 dx，或先创建 dx/config 并放置 commands.json')
+      console.error('dx: 也可通过 DX_CONFIG_DIR 或 --config-dir 指定配置目录')
+      process.exit(1)
+    }
+    configDir = join(projectRoot, 'dx', 'config')
   }
 
   process.env.DX_PROJECT_ROOT = projectRoot
-
-  const defaultConfigDir = join(projectRoot, 'dx', 'config')
-  process.env.DX_CONFIG_DIR = overrideConfigDir ? resolve(projectRoot, overrideConfigDir) : defaultConfigDir
+  process.env.DX_CONFIG_DIR = configDir
 
   process.chdir(projectRoot)
 

package/lib/cli/dx-cli.js

@@ -8,6 +8,7 @@ import { validateEnvironment } from '../validate-env.js'
 import { FLAG_DEFINITIONS, parseFlags } from './flags.js'
 import { getCleanArgs } from './args.js'
 import { showHelp, showCommandHelp } from './help.js'
+import { getPackageVersion } from '../version.js'
 import {
   handleHelp,
   handleDev,
@@ -261,6 +262,11 @@ class DxCli {
   // 主执行方法
   async run() {
     try {
+      if (this.flags.version) {
+        console.log(getPackageVersion())
+        return
+      }
+
       // 显示帮助
       if (this.flags.help || !this.command) {
         if (this.flags.help && this.command && this.command !== 'help') {
@@ -610,17 +616,19 @@ class DxCli {
   // 校验是否在仓库根目录执行
   ensureRepoRoot() {
     const cwd = process.cwd()
-    const markers = [
-      'pnpm-workspace.yaml',
-      'package.json',
-      'apps',
-      'dx/config/commands.json',
-    ]
+
+    const markers = ['pnpm-workspace.yaml', 'package.json', 'apps']
     const missing = markers.filter(p => !existsSync(join(cwd, p)))
     if (missing.length) {
       logger.error(`请从仓库根目录运行此命令。缺少标识文件/目录: ${missing.join(', ')}`)
       process.exit(1)
     }
+
+    const commandsPath = join(this.configDir, 'commands.json')
+    if (!existsSync(commandsPath)) {
+      logger.error(`未找到命令配置文件: ${commandsPath}`)
+      process.exit(1)
+    }
   }
 
   async getWorktreeManager() {

package/lib/cli/flags.js

@@ -15,6 +15,8 @@ export const FLAG_DEFINITIONS = {
     { flag: '--verbose' },
     { flag: '-h' },
     { flag: '--help' },
+    { flag: '-V' },
+    { flag: '--version' },
     { flag: '--parallel' },
     { flag: '-P' },
   ],
@@ -74,6 +76,10 @@ export function parseFlags(args = []) {
       case '--help':
         flags.help = true
         break
+      case '-V':
+      case '--version':
+        flags.version = true
+        break
       case '--no-env-check':
         flags.noEnvCheck = true
         break

package/lib/cli/help.js

@@ -1,6 +1,9 @@
+import { getPackageVersion } from '../version.js'
+
 export function showHelp() {
+  const version = getPackageVersion()
   console.log(`
-DX CLI - 统一开发环境管理工具
+DX CLI v${version} - 统一开发环境管理工具
 
 用法:
   dx <命令> [选项] [参数...]
@@ -67,8 +70,9 @@ DX CLI - 统一开发环境管理工具
   --test                 使用测试环境
   --e2e                  使用E2E测试环境
   -Y, --yes              跳过所有确认提示
-  -v, --verbose          详细输出
-  -h, --help             显示此帮助信息
+   -v, --verbose          详细输出
+   -h, --help             显示此帮助信息
+  -V, --version          显示版本号
 
 示例:
   dx start stack            # PM2 交互式服务栈（推荐）- 同时管理三个服务

package/lib/version.js

@@ -0,0 +1,14 @@
+import { readFileSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+export function getPackageVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url))
+    const pkgPath = join(here, '..', 'package.json')
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0'
+  } catch {
+    return '0.0.0'
+  }
+}

package/package.json

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