@ranger1/dx 0.1.0 → 0.1.1

package/README.md

@@ -4,25 +4,24 @@
 
 ## 安装
 
-项目内安装（推荐）：
+全局安装（推荐）：
 
 ```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`）：

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

@@ -610,17 +610,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/package.json

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