x7-code-line 0.2.0 → 0.3.0

package/README.md

@@ -18,6 +18,20 @@
 
 作为 npm 依赖安装时，`postinstall` 脚本使用 `INIT_CWD` 作为当前安装目录，也就是执行 `npm install` 时所在的项目目录。
 
+如果只是全局安装：
+
+```sh
+npm install -g x7-code-line
+```
+
+此时只安装 CLI，不会自动为任何项目写入 hooks。全局安装完成后，需要手动执行：
+
+```sh
+x7-code-line install --dir <absolute-path>
+```
+
+只有在 `X7_CODE_LINE_DIRS` 或 `X7_CODE_LINE_CONFIG` 明确提供目标目录时，`postinstall` 才会继续执行项目安装逻辑。
+
 当前安装目录会创建或覆盖：
 
 ```text
@@ -175,20 +189,20 @@ x7-ai-lines: 0
 默认要求传入绝对路径：
 
 ```sh
-npx --no-install x7-code-line install --dir /abs/path/repo-a --dir /abs/path/repo-b
+npm  install -g  x7-code-line --dir /abs/path/repo-a --dir /abs/path/repo-b
 ```
 
 例如，将 `x7-code-line` 安装在 C 盘目录，但指定 D 盘的 Git 项目：
 
 ```powershell
 cd C:\x7-tools\x7-code-line-host
-npx --no-install x7-code-line install --dir D:\work\repo-a --dir D:\work\repo-b
+npm  install -g  x7-code-line  --dir D:\work\repo-a --dir D:\work\repo-b
 ```
 
 如果确实需要解析相对路径，必须显式传 `--relative`：
 
 ```sh
-npx --no-install x7-code-line install --relative --dir ../repo-a --dir ../repo-b
+npm  install -g  x7-code-line  --relative --dir ../repo-a --dir ../repo-b
 ```
 
 此时相对路径基于当前执行 `install` 命令的目录解析。
@@ -200,7 +214,7 @@ npx --no-install x7-code-line install --relative --dir ../repo-a --dir ../repo-b
 macOS / Linux 示例：
 
 ```sh
-X7_CODE_LINE_RELATIVE_PATHS=1 X7_CODE_LINE_DIRS="../repo-a:../repo-b" npm install x7-code-line
+X7_CODE_LINE_RELATIVE_PATHS=1 X7_CODE_LINE_DIRS="../repo-a:../repo-b" npm install -g x7-code-line 
 ```
 
 Windows 使用 `;` 作为目录分隔符：
@@ -208,7 +222,7 @@ Windows 使用 `;` 作为目录分隔符：
 ```powershell
 $env:X7_CODE_LINE_RELATIVE_PATHS = "1"
 $env:X7_CODE_LINE_DIRS = "../repo-a;../repo-b"
-npm install x7-code-line
+npm install -g x7-code-line
 ```
 
 ## 配置文件
@@ -334,7 +348,7 @@ npm login
 确认 `package.json` 中的包名和版本号正确后，执行：
 
 ```sh
-npm publish
+npm publish --access public
 ```
 
 如果 npm 账号开启了 2FA，通常需要附带 OTP：
@@ -351,7 +365,7 @@ npm publish --access public --otp <6位验证码>
 
 ### 更新已发布版本
 
-每次发布新版本前，先提升版本号：
+每次发布新版本前，手动修改package.json版本号或命令提升版本号：
 
 ```sh
 npm version patch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x7-code-line",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install Cursor, Codex, and git hooks for x7 code line workflows.",
   "main": "src/index.js",
   "bin": {

package/src/install.js

@@ -27,9 +27,16 @@ function install(options = {}) {
 
 function installFromPostinstall() {
   const envDirs = splitList(process.env.X7_CODE_LINE_DIRS);
+  const configPath = process.env.X7_CODE_LINE_CONFIG;
+  const config = readConfig(configPath);
+  const configuredDirs = Array.isArray(config.dirs) ? config.dirs.map((dir) => String(dir || "").trim()).filter(Boolean) : [];
+
+  if (envDirs.length === 0 && configuredDirs.length === 0) {
+    return [];
+  }
 
   return install({
-    configPath: process.env.X7_CODE_LINE_CONFIG,
+    configPath,
     targetDirs: envDirs,
     relativePaths: process.env.X7_CODE_LINE_RELATIVE_PATHS === "1"
   });