@luxkit/cli 1.1.43 → 1.1.45

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.1.45
+
+- Added global package manager override: `lux set lux_package_manager=pnpm` forces a specific package manager across all projects
+- Supports `auto`, `bun`, `pnpm`, `yarn`, `npm` values — `auto` (default) uses lockfile detection as before
+- Warns when global config conflicts with a project's existing lockfile
+
+## 1.1.44
+
+- Merged English and Chinese README into a single file with in-page anchor switching
+- Removed standalone `README_ZH.md` — no longer need to maintain two separate documents
+
 ## 1.1.43
 
 - Fixed language switcher links in README pointing to npm 404 — now uses GitHub absolute URLs

package/README.md

@@ -10,7 +10,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178C6.svg)](https://www.typescriptlang.org/)
 [![ESM Only](https://img.shields.io/badge/ESM-only-F7DF1E.svg)](https://nodejs.org/api/esm.html)
 
-**English** | [中文](https://github.com/TTT1231/lux/blob/main/README_ZH.md)
+**English** | [中文](#中文)
 
 </div>
 
@@ -95,22 +95,22 @@ lux fmt list
 
 ### 📖CLI Commands
 
-| Command                     | Description                                                       |
-| :-------------------------- | :---------------------------------------------------------------- |
-| `lux fmt <preset>`          | Generate lint configs                                             |
-| `lux fmt list`              | List available lint presets                                       |
-| `lux vscode <preset>`       | Generate VSCode config (per-project)                              |
-| `lux vscode list`           | List available VSCode presets                                     |
-| `lux init`                  | Initialize Skill files to AI Agent                                |
-| `lux init --preset`         | Initialize all built-in presets to `~/.lux/preset/`               |
-| `lux set <key=value> [...]` | Persist proxy env vars (e.g. `https_proxy=http://127.0.0.1:7890`) |
-| `lux unset`                 | Clear all stored proxy configuration                              |
-| `lux show env`              | Display stored proxy environment variables                        |
-| `lux vpn cmd`               | Copy CMD proxy commands to clipboard                              |
-| `lux vpn pw`                | Copy PowerShell proxy commands to clipboard                       |
-| `lux vpn bash`              | Copy Bash proxy commands to clipboard                             |
-| `lux update`                | Update `@luxkit/cli` to the latest version                        |
-| `lux update --check`        | Check for available updates without installing                    |
+| Command                     | Description                                                                        |
+| :-------------------------- | :--------------------------------------------------------------------------------- |
+| `lux fmt <preset>`          | Generate lint configs                                                              |
+| `lux fmt list`              | List available lint presets                                                        |
+| `lux vscode <preset>`       | Generate VSCode config (per-project)                                               |
+| `lux vscode list`           | List available VSCode presets                                                      |
+| `lux init`                  | Initialize Skill files to AI Agent                                                 |
+| `lux init --preset`         | Initialize all built-in presets to `~/.lux/preset/`                                |
+| `lux set <key=value> [...]` | Set config values (proxy, global lux package management`lux_package_manager=pnpm`) |
+| `lux unset`                 | Clear all stored configuration                                                     |
+| `lux show env`              | Display stored configuration                                                       |
+| `lux vpn cmd`               | Copy CMD proxy commands to clipboard                                               |
+| `lux vpn pw`                | Copy PowerShell proxy commands to clipboard                                        |
+| `lux vpn bash`              | Copy Bash proxy commands to clipboard                                              |
+| `lux update`                | Update `@luxkit/cli` to the latest version                                         |
+| `lux update --check`        | Check for available updates without installing                                     |
 
 <br />
 
@@ -216,7 +216,7 @@ npm uninstall -g @luxkit/cli
 | :----------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `package.json` errors          | Ensure a valid `package.json` exists in the project root                                                                                            |
 | Preset not found               | Run `lux fmt list` to see all available presets — lux auto-suggests via fuzzy matching                                                              |
-| Wrong package manager detected | Ensure the lockfile exists (`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`)                                                                    |
+| Wrong package manager detected | Ensure the lockfile exists (`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`), or set globally: `lux set lux_package_manager=pnpm`               |
 | Skip dependency install        | Use `--no-install` to only write to `package.json`, install manually                                                                                |
 | Preview before applying        | Use `--dry-run` to see all operations without writing                                                                                               |
 | Flags have no effect           | Custom presets must include the corresponding config files and deps for `--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` to work |
@@ -237,6 +237,249 @@ Bug reports, feature suggestions, and code contributions are welcome!
 
 [ISC](https://opensource.org/licenses/ISC) — Free to use, modify, and distribute.
 
+<p align="right"><a href="#中文">切换到中文 →</a></p>
+
+---
+
+<br />
+
+## 中文
+
+<div align="center">
+
+**一键项目格式化 & VSCode 配置 CLI**
+
+[![npm version](https://img.shields.io/npm/v/@luxkit/cli.svg)](https://www.npmjs.com/package/@luxkit/cli)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
+[![License: ISC](https://img.shields.io/badge/license-ISC-purple.svg)](https://opensource.org/licenses/ISC)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178C6.svg)](https://www.typescriptlang.org/)
+[![ESM Only](https://img.shields.io/badge/ESM-only-F7DF1E.svg)](https://nodejs.org/api/esm.html)
+
+[English](#lux) | **中文**
+
+</div>
+
+---
+
+### 📌 为什么选择 lux？
+
+`lux` 是一款专为现代化开发与 **AI 时代** 打造的工程化配置 CLI 工具，一条命令完成项目代码规范配置。
+
+- 🚀 **一键配置**：ESLint、Prettier、CSpell、Stylelint、EditorConfig 及 VSCode 工作区配置，一条命令搞定。
+- 🤖 **AI Agent 拍档**：为 Claude、Opencode 等提供技能（Skill）支持，可直接用自然语言（如*"/lux 帮我配一套适合团队的 react 代码规范"*）让 AI 自动构建和调整预设。
+- 📦 **框架预设开箱即用**：内置 `web-vue`、`web-react`、`node` 等场景预设。
+- 🎨 **高度可定制**：支持提取和微调内置预设，也支持**完全自定义私有预设**，兼顾开箱即用与团队定制化需求。
+- 🧠 **安全接入已有项目**：智能冲突解决与合并机制，自动检测 `bun`、`pnpm`、`npm`、`yarn` 依赖树。
+
+<div align="center">
+  <img src="https://github.com/TTT1231/lux/blob/main/demo.gif?raw=true" alt="lux 演示" width="640" />
+</div>
+
+## ⚡快速开始
+
+```bash
+# 全局安装（选择你的包管理器）
+npm install -g @luxkit/cli
+
+# 初始化 skill 和 preset
+lux init && lux init --preset
+
+# 初始化你的项目 — lux 需要项目中有 package.json 来注入依赖和脚本
+# 可使用 pnpm create vite、claude 等方式创建项目
+# lux 通过锁文件检测包管理器（bun.lock / package-lock.json / pnpm-lock.yaml）
+# 也可使用 --no-install 跳过依赖安装
+
+# Lint 配置
+lux fmt web-vue                # 配置 ESLint + Prettier
+lux fmt web-vue --stylelint    # + Stylelint
+lux fmt web-vue --editorconfig # + EditorConfig
+lux fmt web-vue --cspell       # + CSpell
+lux fmt web-vue --lint-staged  # + lint-staged（自动启用 --husky）
+lux fmt web-vue --husky        # + 仅 husky（不包含 lint-staged）
+
+# VSCode 配置（可选，全局已配置可跳过）
+lux vscode web-vue             # 生成 .vscode/settings.json + extensions.json
+
+# 查看可用预设
+lux fmt list
+lux vscode list
+
+# 下一步：
+# 🎨 自定义内置fmt lint预设，例如web-vue（可选）
+# 🧩 自定义你自己的预设，例如fmt <your-lint-preset-name>（可选）
+```
+
+<br />
+
+## 🎨 自定义内置预设
+
+> 前置条件：已完成 `lux init && lux init --preset`（见快速开始）
+
+```bash
+# 使用 AI Agent 自定义（推荐）
+# 在 Claude 等 AI Agent 中直接执行：
+/lux 配置内置预设 web-react 模板，符合我的开发项目风格
+
+# 也可手动编辑 ~/.lux/preset/ 下的预设文件
+# 例如给 web-react 添加 cspell 脚本：
+# 在 ~/.lux/preset/fmt/web-react/package.json 的 scripts 中添加 "cspell":"cspell \"src/**/*\""
+```
+
+## 🧩 完全自定义预设
+
+> 前置条件：已完成 `lux init && lux init --preset`（见快速开始）
+
+```bash
+# 使用 AI Agent 创建自定义预设（推荐）
+# 在 Claude 等 AI Agent 中直接执行：
+/lux 配置我的格式化模板 <your-custom-fmt-preset-name>，符合我的开发项目风格
+
+# 验证预设是否注册成功
+lux fmt list
+```
+
+## 📖命令参考
+
+| 命令                        | 说明                                                        |
+| :-------------------------- | :---------------------------------------------------------- |
+| `lux fmt <preset>`          | 生成 Lint 配置                                              |
+| `lux fmt list`              | 列出可用的 Lint 预设                                        |
+| `lux vscode <preset>`       | 生成 VSCode 配置（项目内）                                  |
+| `lux vscode list`           | 列出可用的 VSCode 预设                                      |
+| `lux init`                  | 初始化 Skill 文件到 AI Agent                                |
+| `lux init --preset`         | 初始化所有内置预设到 `~/.lux/preset/`                       |
+| `lux set <key=value> [...]` | 设置配置值（代理、全局lux包管理`lux_package_manager=pnpm`） |
+| `lux unset`                 | 清除所有已存储的配置                                        |
+| `lux show env`              | 显示已存储的配置                                            |
+| `lux vpn cmd`               | 复制 CMD 代理命令到剪贴板                                   |
+| `lux vpn pw`                | 复制 PowerShell 代理命令到剪贴板                            |
+| `lux vpn bash`              | 复制 Bash 代理命令到剪贴板                                  |
+| `lux update`                | 更新 `@luxkit/cli` 到最新版本                               |
+| `lux update --check`        | 检查可用更新，不执行安装                                    |
+
 <br />
 
-<p align="right"><a href="https://github.com/TTT1231/lux/blob/main/README_ZH.md">切换到中文 →</a></p>
+### ⚙️命令选项
+
+```bash
+lux fmt <preset> [options]
+
+  --force         覆盖已有文件和脚本
+  --no-install    写入依赖到 package.json 但跳过安装
+  --dry-run       预览模式，不写入任何文件
+  --stylelint     包含 Stylelint 配置（按需启用）
+  --editorconfig  包含 EditorConfig 配置（按需启用）
+  --husky        初始化 husky Git hooks（按需启用）
+  --lint-staged   配置 lint-staged（自动启用 --husky，按需启用）
+  --cspell        包含 CSpell 配置（按需启用）
+  --reset         重置本地预设，从内置默认值重新创建
+
+lux vscode <preset> [options]
+
+  --force         覆盖已有的 VSCode 配置文件
+  --dry-run       预览模式，不写入任何文件
+  --stylelint     包含 Stylelint 设置和扩展（按需启用）
+  --reset         重置本地预设，从内置默认值重新创建
+```
+
+<br />
+
+## 🔧工作原理
+
+```
+lux fmt <preset> [options]
+       │
+       ▼
+  解析 CLI 参数，校验项目 package.json
+       │
+       ▼
+  预设类型判断
+       │
+       ├── 内置预设 ──► --reset？ ──► 重置本地副本
+       │              │
+       │              ├── 本地副本存在 (~/.lux/preset/)？ ──► 从本地副本应用
+       │              └── 不存在 ──► 从内置生成 ──► 保存到 ~/.lux/preset/ ──► 应用
+       │
+       ├── 自定义预设 (~/.lux/preset/fmt/<name>/) ──► 直接从本地目录应用
+       │
+       └── 未找到 ──► 模糊匹配所有可用预设（内置 + 自定义）并报错
+       │
+       ▼
+  --stylelint / --editorconfig / --cspell / --husky / --lint-staged 过滤（自定义预设无对应配置时 warning）
+       │
+       ▼
+  遍历每个配置文件：
+       │
+       ├── 文件不存在？ ──► 创建
+       ├── 已存在 + --force？ ──► 覆盖
+       └── 已存在？ ──► 跳过
+       │
+       ▼
+  注入脚本到 package.json（自动检测 bun / pnpm / npm / yarn）
+       │
+       ▼
+  安装 devDependencies（检测 lockfile 判断包管理器）
+```
+
+<br />
+
+## 🔄重置与卸载
+
+### 重置预设
+
+```bash
+# 重置内置预设（删除本地副本并从内置模板重新生成）
+lux fmt web-vue --reset
+lux vscode web-vue --reset
+
+# 重新初始化所有内置预设（覆盖已有本地副本）
+lux init --preset
+
+# 重置自定义预设：手动删除对应目录
+# rm -rf ~/.lux/preset/fmt/<your-custom-preset-name>
+```
+
+> 自定义预设使用 `--reset` 会提示警告并中止，因为不存在内置源可供恢复。
+
+### 卸载
+
+```bash
+# 卸载 CLI
+npm uninstall -g @luxkit/cli
+
+# 清理配置目录（可选）
+# rm -rf ~/.lux
+
+# 清理skill，claude/opencode
+# rm -rf ~/.claude/skill/lux
+# rm -rf ~/.opencode/skill/lux
+```
+
+## 🔍故障排查
+
+| 问题                    | 解决方案                                                                                                                  |
+| :---------------------- | :------------------------------------------------------------------------------------------------------------------------ |
+| `package.json` 相关错误 | 确保项目根目录存在合法的 `package.json`                                                                                   |
+| 预设未找到              | 运行 `lux fmt list` 查看所有可用预设，lux 会自动模糊匹配建议                                                              |
+| 包管理器检测不正确      | 确保 lockfile 存在（`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`），或全局指定：`lux set lux_package_manager=pnpm` |
+| 跳过依赖安装            | 使用 `--no-install` 仅写入 `package.json`，手动安装                                                                       |
+| 预览操作结果            | 使用 `--dry-run` 查看将执行的所有操作                                                                                     |
+| flag 无效果             | 自定义预设需包含对应的配置文件和依赖，`--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` 才能生效        |
+
+<br />
+
+## 🤝 参与贡献
+
+欢迎提交 Bug、功能建议或代码贡献！
+
+- 🐛 **提交 Issue**：[GitHub Issues](https://github.com/TTT1231/lux/issues)
+- 🛠 **提交 PR**：[GitHub Pull Requests](https://github.com/TTT1231/lux/pulls)
+- ⭐️ **Star 支持**：如果 lux 对你有帮助，欢迎 [Star](https://github.com/TTT1231/lux)！
+
+<br />
+
+## 📄 许可证
+
+[ISC](https://opensource.org/licenses/ISC) — 可自由使用、修改和分发。
+
+<p align="right"><a href="#lux">← Switch to English</a></p>

package/dist/index.js

@@ -4,8 +4,8 @@
 import { program } from "commander";
 
 // src/commands/fmt.ts
-import fs3 from "fs";
-import path5 from "path";
+import fs4 from "fs";
+import path6 from "path";
 import chalk2 from "chalk";
 
 // src/presets/fmt/electron-vue.ts
@@ -875,7 +875,7 @@ function generateAllFmt(preset, opts) {
 }
 
 // src/utils/deps.ts
-import path3 from "path";
+import path4 from "path";
 import { spawn } from "child_process";
 
 // src/utils/execFileNoThrow.ts
@@ -899,13 +899,76 @@ async function execFileNoThrow(command, args, options) {
   }
 }
 
+// src/utils/config.ts
+import fs2 from "fs";
+import os from "os";
+import path3 from "path";
+var CONFIG_DIR = ".lux";
+var ENV_FILE = "env.txt";
+function getEnvConfigPath() {
+  return path3.join(os.homedir(), CONFIG_DIR, ENV_FILE);
+}
+function getEnvConfig() {
+  let content;
+  try {
+    content = fs2.readFileSync(getEnvConfigPath(), "utf-8");
+  } catch {
+    return {};
+  }
+  const result = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    const raw = trimmed.slice(eqIndex + 1).trim();
+    const value = raw.replace(/^["']|["']$/g, "");
+    if (key) result[key] = value;
+  }
+  return result;
+}
+function setEnvConfig(data) {
+  const lines = Object.entries(data).filter(([, v]) => v !== "").map(([k, v]) => `${k}="${v}"`);
+  writeFile(getEnvConfigPath(), lines.join("\n") + "\n");
+}
+function clearEnvConfig() {
+  try {
+    fs2.unlinkSync(getEnvConfigPath());
+  } catch {
+  }
+}
+
 // src/utils/deps.ts
-function detectPackageManager(cwd) {
+var PM_LOCKFILE_MAP = {
+  bun: ["bun.lockb", "bun.lock"],
+  pnpm: ["pnpm-lock.yaml"],
+  yarn: ["yarn.lock"],
+  npm: ["package-lock.json"]
+};
+function detectFromLockfile(cwd) {
   if (fileExists(`${cwd}/bun.lockb`) || fileExists(`${cwd}/bun.lock`)) return "bun";
   if (fileExists(`${cwd}/pnpm-lock.yaml`)) return "pnpm";
   if (fileExists(`${cwd}/yarn.lock`)) return "yarn";
   return "npm";
 }
+function detectPackageManager(cwd) {
+  const env = getEnvConfig();
+  const configured = env.lux_package_manager;
+  if (configured && configured !== "auto") {
+    const pm = configured;
+    const lockfiles = PM_LOCKFILE_MAP[pm] ?? [];
+    const hasMatch = lockfiles.some((f) => fileExists(`${cwd}/${f}`));
+    if (!hasMatch) {
+      const detected = detectFromLockfile(cwd);
+      if (detected !== "npm") {
+        logger.warn(`Global config is ${pm} but detected ${detected} lockfile`);
+      }
+    }
+    return pm;
+  }
+  return detectFromLockfile(cwd);
+}
 function getLockfileName(pm) {
   switch (pm) {
     case "bun":
@@ -939,7 +1002,7 @@ async function fetchPackageVersion(pkg) {
   return lines[lines.length - 1].trim();
 }
 async function addDepsToManifest(packages, cwd) {
-  const pkgPath = path3.join(cwd, "package.json");
+  const pkgPath = path4.join(cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     throw new Error("package.json not found");
@@ -963,7 +1026,7 @@ async function addDepsToManifest(packages, cwd) {
 }
 async function installDevDeps(packages, cwd, pm) {
   const manager = pm ?? detectPackageManager(cwd);
-  const pkg = readJson(path3.join(cwd, "package.json"));
+  const pkg = readJson(path4.join(cwd, "package.json"));
   if (!pkg) {
     throw new Error("package.json not found");
   }
@@ -999,9 +1062,9 @@ async function installDevDeps(packages, cwd, pm) {
 }
 
 // src/core/local-preset.ts
-import fs2 from "fs";
-import os from "os";
-import path4 from "path";
+import fs3 from "fs";
+import os2 from "os";
+import path5 from "path";
 
 // src/core/merge-settings.ts
 var USER_PRIORITY_KEYS = /* @__PURE__ */ new Set([
@@ -1082,27 +1145,27 @@ var STYLELINT_EXTENSION = "stylelint.vscode-stylelint";
 var HUSKY_DEPS = /* @__PURE__ */ new Set(["husky"]);
 var LINTSTAGED_DEPS = /* @__PURE__ */ new Set(["lint-staged"]);
 function getLuxDir() {
-  return process.env.LUX_HOME || path4.join(os.homedir(), ".lux");
+  return process.env.LUX_HOME || path5.join(os2.homedir(), ".lux");
 }
 function getLocalPresetDir(type, presetName) {
   if (!isValidPresetName(presetName)) {
     throw new Error(`Invalid preset name: "${presetName}"`);
   }
-  return path4.join(getLuxDir(), "preset", type, presetName);
+  return path5.join(getLuxDir(), "preset", type, presetName);
 }
 function isValidPresetName(name) {
   return name.length > 0 && !name.includes("/") && !name.includes("\\") && !name.includes("..");
 }
 function listCustomPresets() {
-  const fmtDir = path4.join(getLuxDir(), "preset", "fmt");
-  if (!fs2.existsSync(fmtDir)) return [];
-  const entries = fs2.readdirSync(fmtDir, { withFileTypes: true });
+  const fmtDir = path5.join(getLuxDir(), "preset", "fmt");
+  if (!fs3.existsSync(fmtDir)) return [];
+  const entries = fs3.readdirSync(fmtDir, { withFileTypes: true });
   const result = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
     if (!isValidPresetName(entry.name)) continue;
-    const pkgPath = path4.join(fmtDir, entry.name, "package.json");
-    if (fs2.existsSync(pkgPath)) {
+    const pkgPath = path5.join(fmtDir, entry.name, "package.json");
+    if (fs3.existsSync(pkgPath)) {
       result.push(entry.name);
     }
   }
@@ -1110,19 +1173,19 @@ function listCustomPresets() {
 }
 function isValidCustomPreset(name) {
   if (!isValidPresetName(name)) return false;
-  const presetDir = path4.join(getLuxDir(), "preset", "fmt", name);
-  if (!fs2.existsSync(presetDir)) return false;
-  const pkgPath = path4.join(presetDir, "package.json");
-  return fs2.existsSync(pkgPath);
+  const presetDir = path5.join(getLuxDir(), "preset", "fmt", name);
+  if (!fs3.existsSync(presetDir)) return false;
+  const pkgPath = path5.join(presetDir, "package.json");
+  return fs3.existsSync(pkgPath);
 }
 function localPresetExists(type, presetName) {
   const dir = getLocalPresetDir(type, presetName);
-  return fs2.existsSync(dir);
+  return fs3.existsSync(dir);
 }
 function resetLocalPreset(type, presetName) {
   const dir = getLocalPresetDir(type, presetName);
-  if (fs2.existsSync(dir)) {
-    fs2.rmSync(dir, { recursive: true, force: true });
+  if (fs3.existsSync(dir)) {
+    fs3.rmSync(dir, { recursive: true, force: true });
     logger.log(`Reset local preset: ${dir}`);
   }
 }
@@ -1137,24 +1200,24 @@ function materializeFmtPreset(presetName, preset, opts) {
     const content = getContent(preset);
     if (content === void 0) continue;
     const resolved = opts.lockfile ? content.replace(/<lockfile>/g, opts.lockfile) : content.replace(/<lockfile>\n?/g, "");
-    writeFile(path4.join(presetDir, filename), resolved);
+    writeFile(path5.join(presetDir, filename), resolved);
   }
   const templatePkg = buildTemplatePackageJson(preset);
-  writeJson(path4.join(presetDir, "package.json"), templatePkg);
+  writeJson(path5.join(presetDir, "package.json"), templatePkg);
   logger.log(`Local preset created at ${presetDir}`);
 }
 function materializeVscodePreset(cwd, presetName) {
   const presetDir = getLocalPresetDir("vscode", presetName);
   ensureDir(presetDir);
-  const settingsSrc = path4.join(cwd, ".vscode", "settings.json");
+  const settingsSrc = path5.join(cwd, ".vscode", "settings.json");
   if (fileExists(settingsSrc)) {
-    const content = fs2.readFileSync(settingsSrc, "utf-8");
-    writeFile(path4.join(presetDir, "settings.json"), content);
+    const content = fs3.readFileSync(settingsSrc, "utf-8");
+    writeFile(path5.join(presetDir, "settings.json"), content);
   }
-  const extensionsSrc = path4.join(cwd, ".vscode", "extensions.json");
+  const extensionsSrc = path5.join(cwd, ".vscode", "extensions.json");
   if (fileExists(extensionsSrc)) {
-    const content = fs2.readFileSync(extensionsSrc, "utf-8");
-    writeFile(path4.join(presetDir, "extensions.json"), content);
+    const content = fs3.readFileSync(extensionsSrc, "utf-8");
+    writeFile(path5.join(presetDir, "extensions.json"), content);
   }
   logger.log(`Local preset created at ${presetDir}`);
 }
@@ -1162,9 +1225,9 @@ function materializeVscodePresetFromBuiltin(presetName, preset) {
   const presetDir = getLocalPresetDir("vscode", presetName);
   ensureDir(presetDir);
   const settings = preset.settings();
-  writeJson(path4.join(presetDir, "settings.json"), settings);
+  writeJson(path5.join(presetDir, "settings.json"), settings);
   const extensions = preset.extensions();
-  writeJson(path4.join(presetDir, "extensions.json"), { recommendations: extensions });
+  writeJson(path5.join(presetDir, "extensions.json"), { recommendations: extensions });
   logger.log(`Local preset created at ${presetDir}`);
 }
 var InvalidPackageJsonError = class extends Error {
@@ -1183,25 +1246,25 @@ function applyLocalFmtPreset(cwd, presetName, opts) {
     scriptsSkipped: 0
   };
   const presetDir = getLocalPresetDir("fmt", presetName);
-  if (!fs2.existsSync(presetDir)) {
+  if (!fs3.existsSync(presetDir)) {
     logger.warn(`Local preset not found at ${presetDir}`);
     return result;
   }
-  const projectPkgPath = path4.join(cwd, "package.json");
+  const projectPkgPath = path5.join(cwd, "package.json");
   if (fileExists(projectPkgPath)) {
     try {
-      JSON.parse(fs2.readFileSync(projectPkgPath, "utf-8"));
+      JSON.parse(fs3.readFileSync(projectPkgPath, "utf-8"));
     } catch {
       throw new InvalidPackageJsonError(projectPkgPath);
     }
   }
-  const entries = fs2.readdirSync(presetDir).filter((name) => name !== "package.json" && fs2.statSync(path4.join(presetDir, name)).isFile());
+  const entries = fs3.readdirSync(presetDir).filter((name) => name !== "package.json" && fs3.statSync(path5.join(presetDir, name)).isFile());
   for (const filename of entries) {
     if (opts.noStylelint && STYLELINT_FILES.has(filename)) continue;
     if (opts.noEditorconfig && filename === EDITORCONFIG_FILE) continue;
     if (opts.noCspell && filename === CSPELL_FILE) continue;
     if (opts.noLintStaged && filename === LINTSTAGED_FILE) continue;
-    const destPath = path4.join(cwd, filename);
+    const destPath = path5.join(cwd, filename);
     const exists = fileExists(destPath);
     if (exists && !opts.force) {
       result.skipped.push(filename);
@@ -1215,14 +1278,14 @@ function applyLocalFmtPreset(cwd, presetName, opts) {
       logger.log(`[dry-run] Would copy ${filename} from local preset`);
       continue;
     }
-    const content = fs2.readFileSync(path4.join(presetDir, filename), "utf-8");
+    const content = fs3.readFileSync(path5.join(presetDir, filename), "utf-8");
     writeFile(destPath, content);
     (exists ? result.overwritten : result.created).push(filename);
   }
-  const templatePkg = readJson(path4.join(presetDir, "package.json"));
+  const templatePkg = readJson(path5.join(presetDir, "package.json"));
   const projectPkg = readJson(projectPkgPath);
   if (templatePkg && projectPkg) {
-    const pm = fileExists(path4.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+    const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
     const merged = mergeTemplateIntoProject(templatePkg, projectPkg, pm, opts, result);
     if (!opts.dryRun) {
       writeJson(projectPkgPath, merged);
@@ -1239,16 +1302,16 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
     scriptsSkipped: 0
   };
   const presetDir = getLocalPresetDir("vscode", presetName);
-  if (!fs2.existsSync(presetDir)) {
+  if (!fs3.existsSync(presetDir)) {
     logger.warn(`Local preset not found at ${presetDir}`);
     return result;
   }
-  const settingsSrc = path4.join(presetDir, "settings.json");
+  const settingsSrc = path5.join(presetDir, "settings.json");
   if (fileExists(settingsSrc)) {
     const presetSettings = readJson(settingsSrc);
     const filteredSettings = opts.noStylelint ? filterStylelintSettings(presetSettings ?? {}) : presetSettings;
     if (filteredSettings) {
-      const settingsDest = path4.join(cwd, ".vscode", "settings.json");
+      const settingsDest = path5.join(cwd, ".vscode", "settings.json");
       const existingSettings = readJson(settingsDest);
       if (existingSettings) {
         if (opts.dryRun) {
@@ -1270,7 +1333,7 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
       }
     }
   }
-  const extensionsSrc = path4.join(presetDir, "extensions.json");
+  const extensionsSrc = path5.join(presetDir, "extensions.json");
   if (fileExists(extensionsSrc)) {
     const extensionsData = readJson(extensionsSrc);
     if (extensionsData) {
@@ -1284,7 +1347,7 @@ function applyLocalVscodePreset(cwd, presetName, opts) {
         result.created.push(".vscode/extensions.json");
         logger.log("[dry-run] Would create .vscode/extensions.json from local preset");
       } else {
-        const extensionsDest = path4.join(cwd, ".vscode", "extensions.json");
+        const extensionsDest = path5.join(cwd, ".vscode", "extensions.json");
         const existingExtensions = readJson(extensionsDest);
         const existingRecommendations = existingExtensions?.recommendations ?? [];
         const merged = [.../* @__PURE__ */ new Set([...existingRecommendations, ...presetRecommendations])];
@@ -1396,11 +1459,11 @@ function filterScripts(scripts, noStylelint, noEditorconfig, noCspell, noLintSta
   return filtered;
 }
 function detectPresetCapabilities(presetName) {
-  const presetDir = path4.join(getLuxDir(), "preset", "fmt", presetName);
-  const entries = fs2.readdirSync(presetDir);
+  const presetDir = path5.join(getLuxDir(), "preset", "fmt", presetName);
+  const entries = fs3.readdirSync(presetDir);
   const hasStylelintFile = entries.some((f) => STYLELINT_FILES.has(f));
   const pkg = readJson(
-    path4.join(presetDir, "package.json")
+    path5.join(presetDir, "package.json")
   );
   const hasStylelintDep = pkg?.devDependencies ? Object.keys(pkg.devDependencies).some((d) => isNotStylelintDep(d) === false) : false;
   const hasEditorconfigFile = entries.includes(EDITORCONFIG_FILE);
@@ -1468,10 +1531,10 @@ function registerFmtCommand(program2) {
         return;
       }
       const cwd = process.cwd();
-      const pkgPath = path5.join(cwd, "package.json");
+      const pkgPath = path6.join(cwd, "package.json");
       if (fileExists(pkgPath)) {
         try {
-          JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+          JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
         } catch {
           logger.error(
             "package.json exists but is not valid JSON. Fix it first, then re-run this command."
@@ -1568,9 +1631,9 @@ async function executeLocalPath(cwd, presetName, options) {
       `Added ${result.scriptsAdded} script${result.scriptsAdded > 1 ? "s" : ""} to package.json${result.scriptsSkipped > 0 ? ` (${result.scriptsSkipped} skipped)` : ""}`
     );
   }
-  const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+  const pm = fileExists(path6.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
   if (!pm) return;
-  const templatePkgPath = path5.join(getLocalPresetDir("fmt", presetName), "package.json");
+  const templatePkgPath = path6.join(getLocalPresetDir("fmt", presetName), "package.json");
   const templatePkg = readJson(templatePkgPath);
   if (!templatePkg?.devDependencies) return;
   const depsToInstall = filterDeps(
@@ -1581,7 +1644,7 @@ async function executeLocalPath(cwd, presetName, options) {
     opts.noHusky,
     opts.noLintStaged
   );
-  const projectPkgPath = path5.join(cwd, "package.json");
+  const projectPkgPath = path6.join(cwd, "package.json");
   const projectPkg = readJson(projectPkgPath);
   if (!projectPkg) return;
   const existingDeps = projectPkg.devDependencies ?? {};
@@ -1633,7 +1696,7 @@ async function executeLocalPath(cwd, presetName, options) {
   }
 }
 async function executeBuiltinPath(cwd, presetName, preset, options) {
-  const pm = fileExists(path5.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
+  const pm = fileExists(path6.join(cwd, "package.json")) ? detectPackageManager(cwd) : void 0;
   const noHusky = options.husky !== true && options.lintStaged !== true;
   const noLintStaged = options.lintStaged !== true;
   const opts = {
@@ -1788,7 +1851,7 @@ function summarizeFiles(filenames) {
   return [...categories].join(", ");
 }
 async function injectScripts(scripts, opts, pm) {
-  const pkgPath = path5.join(opts.cwd, "package.json");
+  const pkgPath = path6.join(opts.cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     logger.warn("package.json not found, skipping script injection");
@@ -1823,7 +1886,7 @@ async function injectScripts(scripts, opts, pm) {
   }
 }
 async function initHusky(cwd, pm, opts) {
-  const pkgPath = path5.join(cwd, "package.json");
+  const pkgPath = path6.join(cwd, "package.json");
   const pkg = readJson(pkgPath);
   if (!pkg) {
     logger.warn("package.json not found, skipping husky setup");
@@ -1833,8 +1896,8 @@ async function initHusky(cwd, pm, opts) {
   const isYarn = pm === "yarn";
   const initScriptName = isYarn ? "postinstall" : "prepare";
   const hookCommand = opts.noLintStaged ? `${prefix} lint` : `${prefix} lint-staged`;
-  const huskyDir = path5.join(cwd, ".husky");
-  const preCommitPath = path5.join(huskyDir, "pre-commit");
+  const huskyDir = path6.join(cwd, ".husky");
+  const preCommitPath = path6.join(huskyDir, "pre-commit");
   if (opts.dryRun) {
     logger.log(`[dry-run] Would create .husky/pre-commit with: ${hookCommand}`);
     logger.log(`[dry-run] Would inject "${initScriptName}": "husky" script`);
@@ -1847,7 +1910,7 @@ async function initHusky(cwd, pm, opts) {
     ensureDir(huskyDir);
     writeFile(preCommitPath, `${hookCommand}
 `);
-    fs3.chmodSync(preCommitPath, 493);
+    fs4.chmodSync(preCommitPath, 493);
   }
   const scripts = pkg.scripts ?? {};
   if (scripts[initScriptName] !== void 0 && !opts.force) {
@@ -2651,18 +2714,18 @@ var VSCODE_PRESETS = [
 ];
 
 // src/generators/init.ts
-import fs4 from "fs";
-import path6 from "path";
+import fs5 from "fs";
+import path7 from "path";
 function resolveSkillsDir() {
-  const entryDir = path6.dirname(process.argv[1] ?? "");
-  return path6.resolve(entryDir, "skills");
+  const entryDir = path7.dirname(process.argv[1] ?? "");
+  return path7.resolve(entryDir, "skills");
 }
 function listFilesRecursive(dir, base) {
-  const entries = fs4.readdirSync(dir, { withFileTypes: true });
+  const entries = fs5.readdirSync(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
     const childBase = `${base}/${entry.name}`;
-    const fullPath = path6.join(dir, entry.name);
+    const fullPath = path7.join(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...listFilesRecursive(fullPath, childBase));
     } else {
@@ -2673,20 +2736,20 @@ function listFilesRecursive(dir, base) {
 }
 function generateInitSkills(targetBaseDir, cwd) {
   const skillsDir = resolveSkillsDir();
-  if (!fs4.existsSync(skillsDir)) {
+  if (!fs5.existsSync(skillsDir)) {
     logger.error(`Bundled skills directory not found: ${skillsDir}`);
     logger.error('Please run "lux build" or reinstall lux.');
     return { copiedFiles: [], targetDir: targetBaseDir };
   }
-  const targetPath = path6.resolve(cwd, targetBaseDir);
+  const targetPath = path7.resolve(cwd, targetBaseDir);
   try {
-    fs4.cpSync(skillsDir, targetPath, { recursive: true, force: true });
+    fs5.cpSync(skillsDir, targetPath, { recursive: true, force: true });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     logger.error(`Failed to copy skills to ${targetPath}: ${message}`);
     return { copiedFiles: [], targetDir: targetBaseDir };
   }
-  const copiedFiles = fs4.existsSync(targetPath) ? listFilesRecursive(targetPath, targetBaseDir) : [];
+  const copiedFiles = fs5.existsSync(targetPath) ? listFilesRecursive(targetPath, targetBaseDir) : [];
   return { copiedFiles, targetDir: targetBaseDir };
 }
 
@@ -2746,46 +2809,6 @@ function materializeAllPresets() {
   logger.success("All presets materialized to ~/.lux/preset/");
 }
 
-// src/utils/config.ts
-import fs5 from "fs";
-import os2 from "os";
-import path7 from "path";
-var CONFIG_DIR = ".lux";
-var ENV_FILE = "env.txt";
-function getEnvConfigPath() {
-  return path7.join(os2.homedir(), CONFIG_DIR, ENV_FILE);
-}
-function getEnvConfig() {
-  let content;
-  try {
-    content = fs5.readFileSync(getEnvConfigPath(), "utf-8");
-  } catch {
-    return {};
-  }
-  const result = {};
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const eqIndex = trimmed.indexOf("=");
-    if (eqIndex === -1) continue;
-    const key = trimmed.slice(0, eqIndex).trim();
-    const raw = trimmed.slice(eqIndex + 1).trim();
-    const value = raw.replace(/^["']|["']$/g, "");
-    if (key) result[key] = value;
-  }
-  return result;
-}
-function setEnvConfig(data) {
-  const lines = Object.entries(data).filter(([, v]) => v !== "").map(([k, v]) => `${k}="${v}"`);
-  writeFile(getEnvConfigPath(), lines.join("\n") + "\n");
-}
-function clearEnvConfig() {
-  try {
-    fs5.unlinkSync(getEnvConfigPath());
-  } catch {
-  }
-}
-
 // src/commands/show.ts
 function handleShowEnv() {
   const config = getEnvConfig();
@@ -3041,7 +3064,8 @@ function executeVscodeBuiltinPath(cwd, presetName, preset, options) {
 
 // src/commands/vpn.ts
 import { spawnSync } from "child_process";
-var ALLOWED_KEYS = ["https_proxy", "http_proxy", "all_proxy"];
+var ALLOWED_KEYS = ["https_proxy", "http_proxy", "all_proxy", "lux_package_manager"];
+var VALID_PM_VALUES = ["auto", "bun", "pnpm", "yarn", "npm"];
 function buildCommands(shell, env) {
   const entries = Object.entries(env);
   if (shell === "cmd") {
@@ -3099,6 +3123,12 @@ function handleSet(args) {
       logger.error(`Invalid key: "${key}". Allowed keys: ${ALLOWED_KEYS.join(", ")}`);
       return;
     }
+    if (key === "lux_package_manager" && !VALID_PM_VALUES.includes(value)) {
+      logger.error(
+        `Invalid package manager: "${value}". Allowed values: ${VALID_PM_VALUES.join(", ")}`
+      );
+      return;
+    }
     merged[key] = value;
   }
   setEnvConfig(merged);
@@ -3123,6 +3153,9 @@ registerVscodeCommand(program);
 registerVpnCommand(program);
 registerShowCommand(program);
 registerUpdateCommand(program);
-program.command("set").description("Set proxy env vars using key=value pairs").argument("[args...]", "key=value pairs (e.g. https_proxy=http://127.0.0.1:7890)").action((args) => handleSet(args));
-program.command("unset").description("Clear stored proxy configuration").action(() => handleUnset());
+program.command("set").description("Set config values using key=value pairs (proxy, lux_package_manager)").argument(
+  "[args...]",
+  "key=value pairs (e.g. https_proxy=http://127.0.0.1:7890, lux_package_manager=pnpm)"
+).action((args) => handleSet(args));
+program.command("unset").description("Clear stored configuration").action(() => handleUnset());
 program.parse();

package/dist/skills/lux/skill.md

@@ -1,6 +1,6 @@
 ---
 name: lux
-description: Use when setting up ESLint, Prettier, CSpell, Stylelint, EditorConfig, VSCode workspace settings, proxy env
+description: Use it only when users want to configure lint, ESLint, Prettier,Husky etc, and VSCode with lux.
 ---
 
 ## fmt — generate lint/format configs
@@ -73,10 +73,20 @@ lux vpn bash      # copy Bash proxy commands
 
 ```bash
 lux set https_proxy=http://127.0.0.1:7890
-lux unset         # clear all proxy config
-lux show env      # show stored proxy env
+lux unset         # clear all config
+lux show env      # show stored config
 ```
 
+## package manager — global override
+
+```bash
+lux set lux_package_manager=pnpm    # force pnpm globally (auto, bun, pnpm, yarn, npm)
+lux set lux_package_manager=auto     # revert to lockfile detection
+lux unset                            # clear all config (reverts to auto)
+```
+
+By default lux detects the package manager from lockfile (`bun.lock`, `pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`). Setting `lux_package_manager` overrides this globally — lux will use the configured PM for all projects, with a warning if the project's lockfile doesn't match.
+
 ## update — self-update
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.1.43",
+   "version": "1.1.45",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
@@ -8,7 +8,7 @@
    },
    "files": [
       "dist",
-      "README_ZH.md",
+      "README.md",
       "CHANGELOG.md"
    ],
    "publishConfig": {

package/README_ZH.md

@@ -1,242 +0,0 @@
-<div align="center">
-
-# lux
-
-**一键项目格式化 & VSCode 配置 CLI**
-
-[![npm version](https://img.shields.io/npm/v/@luxkit/cli.svg)](https://www.npmjs.com/package/@luxkit/cli)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
-[![License: ISC](https://img.shields.io/badge/license-ISC-purple.svg)](https://opensource.org/licenses/ISC)
-[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178C6.svg)](https://www.typescriptlang.org/)
-[![ESM Only](https://img.shields.io/badge/ESM-only-F7DF1E.svg)](https://nodejs.org/api/esm.html)
-
-[English](https://github.com/TTT1231/lux/blob/main/README.md) | **中文**
-
-</div>
-
----
-
-### 📌 为什么选择 lux？
-
-`lux` 是一款专为现代化开发与 **AI 时代** 打造的工程化配置 CLI 工具，一条命令完成项目代码规范配置。
-
-- 🚀 **一键配置**：ESLint、Prettier、CSpell、Stylelint、EditorConfig 及 VSCode 工作区配置，一条命令搞定。
-- 🤖 **AI Agent 拍档**：为 Claude、Opencode 等提供技能（Skill）支持，可直接用自然语言（如*"/lux 帮我配一套适合团队的 react 代码规范"*）让 AI 自动构建和调整预设。
-- 📦 **框架预设开箱即用**：内置 `web-vue`、`web-react`、`node` 等场景预设。
-- 🎨 **高度可定制**：支持提取和微调内置预设，也支持**完全自定义私有预设**，兼顾开箱即用与团队定制化需求。
-- 🧠 **安全接入已有项目**：智能冲突解决与合并机制，自动检测 `bun`、`pnpm`、`npm`、`yarn` 依赖树。
-
-<div align="center">
-  <img src="https://github.com/TTT1231/lux/blob/main/demo.gif?raw=true" alt="lux 演示" width="640" />
-</div>
-
-## ⚡快速开始
-
-```bash
-# 全局安装（选择你的包管理器）
-npm install -g @luxkit/cli
-
-# 初始化 skill 和 preset
-lux init && lux init --preset
-
-# 初始化你的项目 — lux 需要项目中有 package.json 来注入依赖和脚本
-# 可使用 pnpm create vite、claude 等方式创建项目
-# lux 通过锁文件检测包管理器（bun.lock / package-lock.json / pnpm-lock.yaml）
-# 也可使用 --no-install 跳过依赖安装
-
-# Lint 配置
-lux fmt web-vue                # 配置 ESLint + Prettier
-lux fmt web-vue --stylelint    # + Stylelint
-lux fmt web-vue --editorconfig # + EditorConfig
-lux fmt web-vue --cspell       # + CSpell
-lux fmt web-vue --lint-staged  # + lint-staged（自动启用 --husky）
-lux fmt web-vue --husky        # + 仅 husky（不包含 lint-staged）
-
-# VSCode 配置（可选，全局已配置可跳过）
-lux vscode web-vue             # 生成 .vscode/settings.json + extensions.json
-
-# 查看可用预设
-lux fmt list
-lux vscode list
-
-# 下一步：
-# 🎨 自定义内置fmt lint预设，例如web-vue（可选）
-# 🧩 自定义你自己的预设，例如fmt <your-lint-preset-name>（可选）
-```
-
-<br />
-
-## 🎨 自定义内置预设
-
-> 前置条件：已完成 `lux init && lux init --preset`（见快速开始）
-
-```bash
-# 使用 AI Agent 自定义（推荐）
-# 在 Claude 等 AI Agent 中直接执行：
-/lux 配置内置预设 web-react 模板，符合我的开发项目风格
-
-# 也可手动编辑 ~/.lux/preset/ 下的预设文件
-# 例如给 web-react 添加 cspell 脚本：
-# 在 ~/.lux/preset/fmt/web-react/package.json 的 scripts 中添加 "cspell":"cspell \"src/**/*\""
-```
-
-## 🧩 完全自定义预设
-
-> 前置条件：已完成 `lux init && lux init --preset`（见快速开始）
-
-```bash
-# 使用 AI Agent 创建自定义预设（推荐）
-# 在 Claude 等 AI Agent 中直接执行：
-/lux 配置我的格式化模板 <your-custom-fmt-preset-name>，符合我的开发项目风格
-
-# 验证预设是否注册成功
-lux fmt list
-```
-
-## 📖命令参考
-
-| 命令                        | 说明                                                         |
-| :-------------------------- | :----------------------------------------------------------- |
-| `lux fmt <preset>`          | 生成 Lint 配置                                               |
-| `lux fmt list`              | 列出可用的 Lint 预设                                         |
-| `lux vscode <preset>`       | 生成 VSCode 配置（项目内）                                   |
-| `lux vscode list`           | 列出可用的 VSCode 预设                                       |
-| `lux init`                  | 初始化 Skill 文件到 AI Agent                                 |
-| `lux init --preset`         | 初始化所有内置预设到 `~/.lux/preset/`                        |
-| `lux set <key=value> [...]` | 设置代理环境变量（如 `https_proxy="http://127.0.0.1:7890"`） |
-| `lux unset`                 | 清除所有代理配置                                             |
-| `lux show env`              | 显示已配置的代理环境变量                                     |
-| `lux vpn cmd`               | 复制 CMD 代理命令到剪贴板                                    |
-| `lux vpn pw`                | 复制 PowerShell 代理命令到剪贴板                             |
-| `lux vpn bash`              | 复制 Bash 代理命令到剪贴板                                   |
-| `lux update`                | 更新 `@luxkit/cli` 到最新版本                                |
-| `lux update --check`        | 检查可用更新，不执行安装                                     |
-
-<br />
-
-### ⚙️命令选项
-
-```bash
-lux fmt <preset> [options]
-
-  --force         覆盖已有文件和脚本
-  --no-install    写入依赖到 package.json 但跳过安装
-  --dry-run       预览模式，不写入任何文件
-  --stylelint     包含 Stylelint 配置（按需启用）
-  --editorconfig  包含 EditorConfig 配置（按需启用）
-  --husky        初始化 husky Git hooks（按需启用）
-  --lint-staged   配置 lint-staged（自动启用 --husky，按需启用）
-  --cspell        包含 CSpell 配置（按需启用）
-  --reset         重置本地预设，从内置默认值重新创建
-
-lux vscode <preset> [options]
-
-  --force         覆盖已有的 VSCode 配置文件
-  --dry-run       预览模式，不写入任何文件
-  --stylelint     包含 Stylelint 设置和扩展（按需启用）
-  --reset         重置本地预设，从内置默认值重新创建
-```
-
-<br />
-
-## 🔧工作原理
-
-```
-lux fmt <preset> [options]
-       │
-       ▼
-  解析 CLI 参数，校验项目 package.json
-       │
-       ▼
-  预设类型判断
-       │
-       ├── 内置预设 ──► --reset？ ──► 重置本地副本
-       │              │
-       │              ├── 本地副本存在 (~/.lux/preset/)？ ──► 从本地副本应用
-       │              └── 不存在 ──► 从内置生成 ──► 保存到 ~/.lux/preset/ ──► 应用
-       │
-       ├── 自定义预设 (~/.lux/preset/fmt/<name>/) ──► 直接从本地目录应用
-       │
-       └── 未找到 ──► 模糊匹配所有可用预设（内置 + 自定义）并报错
-       │
-       ▼
-  --stylelint / --editorconfig / --cspell / --husky / --lint-staged 过滤（自定义预设无对应配置时 warning）
-       │
-       ▼
-  遍历每个配置文件：
-       │
-       ├── 文件不存在？ ──► 创建
-       ├── 已存在 + --force？ ──► 覆盖
-       └── 已存在？ ──► 跳过
-       │
-       ▼
-  注入脚本到 package.json（自动检测 bun / pnpm / npm / yarn）
-       │
-       ▼
-  安装 devDependencies（检测 lockfile 判断包管理器）
-```
-
-<br />
-
-## 🔄重置与卸载
-
-### 重置预设
-
-```bash
-# 重置内置预设（删除本地副本并从内置模板重新生成）
-lux fmt web-vue --reset
-lux vscode web-vue --reset
-
-# 重新初始化所有内置预设（覆盖已有本地副本）
-lux init --preset
-
-# 重置自定义预设：手动删除对应目录
-# rm -rf ~/.lux/preset/fmt/<your-custom-preset-name>
-```
-
-> 自定义预设使用 `--reset` 会提示警告并中止，因为不存在内置源可供恢复。
-
-### 卸载
-
-```bash
-# 卸载 CLI
-npm uninstall -g @luxkit/cli
-
-# 清理配置目录（可选）
-# rm -rf ~/.lux
-
-# 清理skill，claude/opencode
-# rm rum ~/.claude/skill/lux
-# rm rum ~/.opencode/skill/lux
-```
-
-## 🔍故障排查
-
-| 问题                    | 解决方案                                                                                                           |
-| :---------------------- | :----------------------------------------------------------------------------------------------------------------- |
-| `package.json` 相关错误 | 确保项目根目录存在合法的 `package.json`                                                                            |
-| 预设未找到              | 运行 `lux fmt list` 查看所有可用预设，lux 会自动模糊匹配建议                                                       |
-| 包管理器检测不正确      | 确保 lockfile 存在（`bun.lock` / `package-lock.json` / `pnpm-lock.yaml`）                                          |
-| 跳过依赖安装            | 使用 `--no-install` 仅写入 `package.json`，手动安装                                                                |
-| 预览操作结果            | 使用 `--dry-run` 查看将执行的所有操作                                                                              |
-| flag 无效果             | 自定义预设需包含对应的配置文件和依赖，`--stylelint`/`--cspell`/`--editorconfig`/`--husky`/`--lint-staged` 才能生效 |
-
-<br />
-
-## 🤝 参与贡献
-
-欢迎提交 Bug、功能建议或代码贡献！
-
-- 🐛 **提交 Issue**：[GitHub Issues](https://github.com/TTT1231/lux/issues)
-- 🛠 **提交 PR**：[GitHub Pull Requests](https://github.com/TTT1231/lux/pulls)
-- ⭐️ **Star 支持**：如果 lux 对你有帮助，欢迎 [Star](https://github.com/TTT1231/lux)！
-
-<br />
-
-## 📄 许可证
-
-[ISC](https://opensource.org/licenses/ISC) — 可自由使用、修改和分发。
-
-<br />
-
-<p align="right"><a href="https://github.com/TTT1231/lux/blob/main/README.md">← Switch to English</a></p>