@luxkit/cli 1.1.2 → 1.1.3

package/README.md

@@ -16,15 +16,21 @@
 
 ---
 
-### What is lux?
+### 📌 What is lux?
 
-`lux` is a CLI tool that sets up project lint configs and VSCode workspace settings with a single command — saving you from repetitive configuration overhead and wasted tokens. It generates ESLint, Prettier, CSpell, Stylelint，EditorConfig configs and VSCode settings from presets — with smart merge and conflict resolution. Configurations can be customized to your needs.
+`lux` is a CLI tool for modern development & the **AI era** that sets up project lint configs and VSCode workspace settings with a single command.
+
+- 🚀**One-click setup**: ESLint, Prettier, CSpell, Stylelint, EditorConfig, and VSCode workspace — all in one command.
+- 🤖**AI Agent companion**: Built for Claude, Opencode and more! Use natural language (e.g. _"/lux configure a react lint template for my team"_) to let AI build and adjust custom presets for you.
+- 📦**Framework presets**: Built-in presets for `web-vue`, `web-react`, `node`, and more.
+- 🎨**Ultimate Freedom for Customization**: Tired of rigid one-size-fits-all encapsulated configurations? lux allows you to extract and fine-tune built-in presets, and also supports **fully custom private presets**. It perfectly balances out-of-the-box usability with the strong customization demands of team collaboration.
+- 🧠**Safe project integration**: Smart conflict resolution and merge, auto-detects `bun`, `pnpm`, `npm`, `yarn` dependency trees.
 
 <div align="center">
   <img src="https://github.com/TTT1231/lux/blob/main/demo.gif?raw=true" alt="lux demo" width="640" />
 </div>
 
-### Quick Start
+### ⚡Quick Start
 
 ```bash
 # Install globally (pick your package manager)
@@ -45,21 +51,42 @@ lux vscode web-vue       # Generate .vscode/settings.json + extensions.json (per
 # List available presets
 lux fmt list
 lux vscode list
+
+# Next: customize your own lint preset (optional)
 ```
 
 <br />
 
-### Custom Configuration
+### 🎨Customize Built-in Presets
+
+```bash
+# Check if skill and presets are initialized (skip if already done)
+lux init && lux init --preset
+
+# Use an AI agent to customize a built-in preset (recommended)
+# In an AI agent like Claude, just run:
+/lux configure built-in preset web-react template to fit my development project style
+
+# Or manually edit files under ~/.lux/preset/
+# e.g. add a cspell script to web-react:
+# "cspell":"cspell \"src/**/*\"" to ~/.lux/preset/fmt/web-react/package.json
+```
+
+### 🧩Fully Custom Presets
 
 ```bash
 # Check if skill and presets are initialized (skip if already done)
 lux init && lux init --preset
 
-# Use an agent to customize a preset
-/lux help me configure my web react lint template to fit my development project style
+# Use an AI agent to create a fully custom preset (recommended)
+# In an AI agent like Claude, just run:
+/lux configure my formatting template <your-custom-fmt-preset-name> to fit my development project style
+
+# Verify the preset is registered
+lux fmt list
 ```
 
-### CLI Commands
+### 📖CLI Commands
 
 | Command                     | Description                                                       |
 | :-------------------------- | :---------------------------------------------------------------- |
@@ -80,7 +107,7 @@ lux init && lux init --preset
 
 <br />
 
-### Options
+### ⚙️Options
 
 ```bash
 lux fmt <preset> [options]
@@ -91,34 +118,49 @@ lux fmt <preset> [options]
   --stylelint     Include Stylelint config generation (opt-in)
   --editorconfig  Include EditorConfig config generation (opt-in)
   --reset         Reset local preset and re-create from built-in defaults
+
+lux vscode <preset> [options]
+
+  --force         Force overwrite existing files
+  --dry-run       Preview without writing files
+  --stylelint     Include Stylelint settings and extension (opt-in)
+  --reset         Reset local preset and re-create from built-in defaults
 ```
 
 <br />
 
-### How It Works
+###🔧 How It Works
 
 ```
-lux fmt web-vue
+lux fmt <preset> [options]
        │
        ▼
-  Parse CLI args ──► Resolve preset (fuzzy match on typo)
+  Parse CLI args, validate project package.json
        │
        ▼
-  Local preset exists in ~/.lux/preset/?
+  Resolve preset type
        │
-       ├── Yes ──► Copy files from local preset (editable, survives updates)
-       └── No  ──► Generate from built-in ──► Save to ~/.lux/preset/ for reuse
+       ├── Built-in preset ──► --reset? ──► Reset local copy
+       │              │
+       │              ├── Local copy exists (~/.lux/preset/)? ──► Apply from local
+       │              └── Not found ──► Generate from built-in ──► Save to ~/.lux/preset/ ──► Apply
+       │
+       ├── Custom preset (~/.lux/preset/fmt/<name>/) ──► Apply from local directory
+       │
+       └── Not found ──► Fuzzy match against all presets (built-in + custom), show error
+       │
+       ▼
+  --stylelint / --editorconfig filtering (warns if custom preset lacks matching config)
        │
        ▼
   For each config file:
        │
        ├── File not found? ──► Create
-       ├── In neverOverwrite? ──► Skip
-       ├── In forceOverwrite? ──► Overwrite
-       └── Exists + --force? ──► Overwrite / Skip
+       ├── Exists + --force? ──► Overwrite
+       └── Exists? ──► Skip
        │
        ▼
-  Inject scripts into package.json (<pm> → bun run / pnpm run / ...)
+  Inject scripts into package.json (auto-detect bun / pnpm / npm / yarn)
        │
        ▼
   Auto-install devDependencies (detects lockfile)
@@ -128,7 +170,11 @@ lux fmt web-vue
 
 ### 🤝 Support
 
-If you have any questions or run into issues, feel free to [open an issue](https://github.com/TTT1231/lux/issues) on GitHub.
+Found a bug, have a feature idea, or want to improve the code? Contributions are welcome!
+
+- **Report bugs or request features**: [Open an issue](https://github.com/TTT1231/lux/issues) on GitHub.
+- **Submit code**: [Pull Requests](https://github.com/TTT1231/lux/pulls) are very welcome!
+- **Star us**: If this tool saved you even 5 minutes of config time, please give us a [⭐️Star](https://github.com/TTT1231/lux)!
 
 <br />
 

package/README_Zh.md

@@ -0,0 +1,189 @@
+<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](./README.md) | **中文**
+
+</div>
+
+---
+
+### 📌 为什么选择 lux？
+
+每次新建项目都要花大量时间折腾代码规范配置？`lux` 让你彻底告别这一痛点！作为一款专为现代化开发与 **AI 时代** 打造的工程化配置工具，只需一条命令即可为您搭好绝佳的开发 lint 基建。
+
+- 🚀 **一键极速配置**：告别繁琐的手动依赖安装，一套命令自动为你搭好 ESLint、Prettier、CSpell、Stylelint、EditorConfig 以及完美的 VSCode 工作区体验。
+- 🤖 **AI Agent 最佳拍档**：专为 Claude、Opencode 打造生态！技能（Skill）体系，你可以直接用自然语言（如*"/lux 帮我配一套适合团队的 react 代码规范"*），让 AI 帮你全自动构建和调整自定义预设。
+- 📦 **框架开箱即用**：内置场景预设：`web-vue`, `web-react`, `node`等。
+- 🎨 **高度自由的专属定制**：厌倦了死板的“一刀切”封装配置？`lux` 支持提取和微调内置预设，更支持**完全自定义私有预设**，完美兼顾开箱即用体验与团队强定制化刚需。
+- 🧠 **项目安全无痛接入**：拥有智能冲突解决与合配机制，自动检测 `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
+
+# lint 使用
+lux fmt web-vue                # 配置web-vue lint，配置 ESLint、Prettier、CSpell
+lux fmt web-vue --stylelint    # 同时包含 Stylelint
+lux fmt web-vue --editorconfig # 同时包含 EditorConfig
+
+# vscode配置使用（option）
+# 如果你全局自定义配置了，可忽视
+lux vscode web-vue             #（项目内） 生成 .vscode/settings.json + extensions.json
+
+# 查看可用预设
+lux fmt list
+lux vscode list
+
+# 下一步：自定义你自己的lint预设（可选）
+```
+
+<br />
+
+## 🎨 自定义内置预设
+
+```bash
+# 检查skill和预设是否初始化（已初始化，请忽视）
+lux init && lux init --preset
+
+# 使用 ai agent 进行自定义内置预设（推荐）
+# 在ai agent例如claude，直接执行以下即可
+/lux 配置内置预设 web-react 模板，符合我的开发项目风格
+
+# 如果你不想使用 ai agent 可直接编辑 `~/.lux/preset/`下的内置预设文件
+# 例如修改 web-react 增加cspell script
+# "cspell":"cspell \"src/**/*\""  到 `~/.lux/preset/fmt/web-react/package.json` 即可
+```
+
+## 🧩 完全自定义预设
+
+如果你想完全自定义自己的 lint，按照以下方法进行即可：
+
+```bash
+# 检查skill和预设是否初始化（已初始化，请忽视）
+lux init && lux init --preset
+
+# 使用 ai agent 进行完全自定义预设（推荐）
+# 在ai agent例如claude，直接执行以下即可
+/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                                                 |
+| `lux init --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    跳过依赖安装
+  --dry-run       预览模式，不写入文件
+  --stylelint     包含 Stylelint 配置（按需启用）
+  --editorconfig  包含 EditorConfig 的配置（按需启用）
+  --reset         重置本地预设，从内置默认值重新创建
+
+lux vscode <preset> [options]
+
+  --force         强制覆盖已有文件
+  --dry-run       预览模式，不写入文件
+  --stylelint     包含 Stylelint 设置和扩展（按需启用）
+  --reset         重置本地预设，从内置默认值重新创建
+```
+
+<br />
+
+## 🔧工作原理
+
+```
+lux fmt <preset> [options]
+       │
+       ▼
+  解析 CLI 参数，校验项目 package.json
+       │
+       ▼
+  预设类型判断
+       │
+       ├── 内置预设 ──► --reset？ ──► 重置本地副本
+       │              │
+       │              ├── 本地副本存在 (~/.lux/preset/)？ ──► 从本地副本应用
+       │              └── 不存在 ──► 从内置生成 ──► 保存到 ~/.lux/preset/ ──► 应用
+       │
+       ├── 自定义预设 (~/.lux/preset/fmt/<name>/) ──► 直接从本地目录应用
+       │
+       └── 未找到 ──► 模糊匹配所有可用预设（内置 + 自定义）并报错
+       │
+       ▼
+  --stylelint / --editorconfig 过滤（自定义预设无对应配置时 warning）
+       │
+       ▼
+  遍历每个配置文件：
+       │
+       ├── 文件不存在？ ──► 创建
+       ├── 已存在 + --force？ ──► 覆盖
+       └── 已存在？ ──► 跳过
+       │
+       ▼
+  注入脚本到 package.json（自动检测 bun / pnpm / npm / yarn）
+       │
+       ▼
+  自动安装 devDependencies（检测 lockfile 判断包管理器）
+```
+
+<br />
+
+## 🤝 参与贡献与支持
+
+发现 Bug、有绝妙的新功能想法，或者想亲自下场优化代码？我们极其欢迎你的加入！
+
+- 🐛 **提交 Bug 或需求**：任何疑问或改进建议，欢迎随时在 GitHub [提交 Issue](https://github.com/TTT1231/lux/issues)。
+- 🛠 **提交代码 (PR)**：非常欢迎并且期待你提交 [PR](https://github.com/TTT1231/lux/pulls) 来一起完善这个项目！
+- ⭐️ **点赞支持**：如果这个工具帮你节省了哪怕 5 分钟的配置时间，请在 GitHub 上点亮一个 [⭐️Star](https://github.com/TTT1231/lux)！
+
+<br />
+
+## 📄 许可证
+
+[ISC](https://opensource.org/licenses/ISC) — 可自由使用、修改和分发。
+
+<br />
+
+<p align="right"><a href="./README.md">← Switch to English</a></p>

package/dist/index.js

@@ -6,6 +6,7 @@ import { program } from "commander";
 // src/commands/fmt.ts
 import fs3 from "fs";
 import path5 from "path";
+import chalk2 from "chalk";
 
 // src/presets/fmt/electron-vue.ts
 var electronVueFmt = {
@@ -668,7 +669,6 @@ var logger = {
 };
 
 // src/utils/errors.ts
-import chalk2 from "chalk";
 var CliError = class extends Error {
   code;
   suggestion;
@@ -714,14 +714,6 @@ function levenshtein(a, b) {
 }
 function resolvePreset(presets, name) {
   const found = presets.find((p) => p.name === name);
-  if (!found) {
-    const err = new PresetNotFoundError(
-      name,
-      presets.map((p) => p.name)
-    );
-    console.error(chalk2.red(err.message));
-    process.exit(1);
-  }
   return found;
 }
 
@@ -1031,6 +1023,28 @@ function getLocalPresetDir(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 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)) {
+      result.push(entry.name);
+    }
+  }
+  return result;
+}
+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);
+}
 function localPresetExists(type, presetName) {
   const dir = getLocalPresetDir(type, presetName);
   return fs2.existsSync(dir);
@@ -1244,11 +1258,13 @@ function mergeTemplateIntoProject(templatePkg, projectPkg, pm, opts, result) {
   if (templatePkg.scripts) {
     const existingScripts = merged.scripts ?? {};
     const newScripts = { ...existingScripts };
-    for (const [key, value] of Object.entries(templatePkg.scripts)) {
-      let resolved = value.replace(/<pm>/g, prefix);
-      if (opts.noStylelint) {
-        resolved = resolved.replace(/\s*&&\s*stylelint\s+"[^"]*".*/g, "");
-      }
+    const filteredScripts = filterScripts(
+      templatePkg.scripts,
+      opts.noStylelint,
+      opts.noEditorconfig
+    );
+    for (const [key, value] of Object.entries(filteredScripts)) {
+      const resolved = value.replace(/<pm>/g, prefix);
       if (existingScripts[key] !== void 0 && !opts.force) {
         result.scriptsSkipped++;
         if (opts.dryRun) {
@@ -1283,6 +1299,42 @@ function filterStylelintSettings(settings) {
   }
   return filtered;
 }
+function filterScripts(scripts, noStylelint, noEditorconfig) {
+  const filtered = {};
+  for (const [key, value] of Object.entries(scripts)) {
+    if (noStylelint && key.includes("stylelint")) continue;
+    if (noEditorconfig && key.includes("editorconfig")) continue;
+    let resolved = value;
+    if (noStylelint) {
+      resolved = resolved.replace(/\s*&&\s*stylelint\s+"[^"]*".*/g, "");
+    }
+    filtered[key] = resolved;
+  }
+  return filtered;
+}
+function detectPresetCapabilities(presetName) {
+  const presetDir = path4.join(getLuxDir(), "preset", "fmt", presetName);
+  const entries = fs2.readdirSync(presetDir);
+  const hasStylelintFile = entries.some((f) => STYLELINT_FILES.has(f));
+  const pkg = readJson(
+    path4.join(presetDir, "package.json")
+  );
+  const hasStylelintDep = pkg?.devDependencies ? Object.keys(pkg.devDependencies).some((d) => isNotStylelintDep(d) === false) : false;
+  const hasEditorconfigFile = entries.includes(EDITORCONFIG_FILE);
+  const hasEditorconfigDep = pkg?.devDependencies ? Object.keys(pkg.devDependencies).some((d) => !isNotEditorconfigDep(d)) : false;
+  return {
+    hasStylelint: hasStylelintFile || hasStylelintDep,
+    hasEditorconfig: hasEditorconfigFile || hasEditorconfigDep
+  };
+}
+function isNotStylelintDep(dep) {
+  if (dep.includes("stylelint")) return false;
+  if (dep === "postcss-html" || dep === "postcss-scss") return false;
+  return true;
+}
+function isNotEditorconfigDep(dep) {
+  return !dep.includes("editorconfig");
+}
 function resolveLocalDeps(deps) {
   const packages = [];
   for (const [name, version] of Object.entries(deps)) {
@@ -1296,27 +1348,24 @@ function resolveLocalDeps(deps) {
 }
 
 // src/commands/fmt.ts
-function filterStylelintScripts(scripts) {
-  const filtered = {};
-  for (const [key, value] of Object.entries(scripts)) {
-    filtered[key] = value.replace(/\s*&&\s*stylelint\s+"[^"]*".*/g, "");
-  }
-  return filtered;
-}
-function isNotStylelintDep(dep) {
+function isNotStylelintDep2(dep) {
   if (dep.includes("stylelint")) return false;
   if (dep === "postcss-html" || dep === "postcss-scss") return false;
   return true;
 }
-function isNotEditorconfigDep(dep) {
+function isNotEditorconfigDep2(dep) {
   return !dep.includes("editorconfig");
 }
 function registerFmtCommand(program2) {
   const fmt = program2.command("fmt").description("Initialize formatting config with preset");
   fmt.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--no-install", "Skip dependency installation").option("--dry-run", "Preview without writing files").option("--stylelint", "Include Stylelint config generation").option("--editorconfig", "Include EditorConfig config generation").option("--reset", "Reset local preset and re-materialize from built-in").action(
     async (presetName, options) => {
-      const preset = resolvePreset(FMT_PRESETS, presetName);
-      if (!preset) return;
+      const builtinPreset = FMT_PRESETS.find((p) => p.name === presetName);
+      const isBuiltin = builtinPreset !== void 0;
+      if (options.reset && !isBuiltin) {
+        logger.warn(`"${presetName}" is a custom preset, --reset has no builtin to restore`);
+        return;
+      }
       const cwd = process.cwd();
       const pkgPath = path5.join(cwd, "package.json");
       if (fileExists(pkgPath)) {
@@ -1329,25 +1378,52 @@ function registerFmtCommand(program2) {
           return;
         }
       }
-      if (options.reset) {
-        resetLocalPreset("fmt", presetName);
-      }
-      const useLocal = localPresetExists("fmt", presetName);
-      if (useLocal) {
+      if (isBuiltin) {
+        if (options.reset) {
+          resetLocalPreset("fmt", presetName);
+        }
+        const useLocal = localPresetExists("fmt", presetName);
+        if (useLocal) {
+          await executeLocalPath(cwd, presetName, options);
+        } else {
+          await executeBuiltinPath(cwd, presetName, builtinPreset, options);
+        }
+      } else if (isValidCustomPreset(presetName)) {
         await executeLocalPath(cwd, presetName, options);
       } else {
-        await executeBuiltinPath(cwd, presetName, preset, options);
+        const builtinNames = new Set(FMT_PRESETS.map((p) => p.name));
+        const customNames = listCustomPresets().filter((n) => !builtinNames.has(n));
+        const allNames = [...builtinNames, ...customNames];
+        const err = new PresetNotFoundError(presetName, allNames);
+        logger.error(err.message);
+        process.exitCode = 1;
       }
     }
   );
   fmt.command("list").description("List available fmt presets").action(() => {
+    const builtinNames = new Set(FMT_PRESETS.map((p) => p.name));
     for (const p of FMT_PRESETS) {
       console.log(`${p.name.padEnd(12)} ${p.description}`);
     }
+    const customs = listCustomPresets().filter((name) => !builtinNames.has(name));
+    for (const name of customs) {
+      console.log(`${name.padEnd(12)} ${chalk2.yellow("(custom)")}`);
+    }
   });
 }
 async function executeLocalPath(cwd, presetName, options) {
   logger.log("Using local custom preset");
+  const caps = detectPresetCapabilities(presetName);
+  if (options.stylelint && !caps.hasStylelint) {
+    logger.warn(
+      "--stylelint has no effect: this custom preset has no stylelint config or dependencies"
+    );
+  }
+  if (options.editorconfig && !caps.hasEditorconfig) {
+    logger.warn(
+      "--editorconfig has no effect: this custom preset has no editorconfig config or dependencies"
+    );
+  }
   const opts = {
     cwd,
     force: options.force ?? false,
@@ -1452,13 +1528,13 @@ async function executeBuiltinPath(cwd, presetName, preset, options) {
     warnMissingPackageJson(preset, options.install !== false);
     return;
   }
-  const scripts = opts.noStylelint && preset.scripts ? filterStylelintScripts(preset.scripts) : preset.scripts;
+  const scripts = preset.scripts ? filterScripts(preset.scripts, opts.noStylelint, opts.noEditorconfig) : void 0;
   if (scripts) {
     await injectScripts(scripts, opts, pm);
   }
   if (!preset.dependencies?.dev) return;
-  const devDeps = opts.noStylelint ? preset.dependencies.dev.filter(isNotStylelintDep) : preset.dependencies.dev;
-  const finalDeps = opts.noEditorconfig ? devDeps.filter(isNotEditorconfigDep) : devDeps;
+  const devDeps = opts.noStylelint ? preset.dependencies.dev.filter(isNotStylelintDep2) : preset.dependencies.dev;
+  const finalDeps = opts.noEditorconfig ? devDeps.filter(isNotEditorconfigDep2) : devDeps;
   if (opts.dryRun) {
     logger.log(`[dry-run] Would add to package.json: ${finalDeps.join(", ")}`);
     return;
@@ -1488,8 +1564,8 @@ async function executeBuiltinPath(cwd, presetName, preset, options) {
 }
 function filterDeps(deps, noStylelint, noEditorconfig) {
   let filtered = deps;
-  if (noStylelint) filtered = filtered.filter(isNotStylelintDep);
-  if (noEditorconfig) filtered = filtered.filter(isNotEditorconfigDep);
+  if (noStylelint) filtered = filtered.filter(isNotStylelintDep2);
+  if (noEditorconfig) filtered = filtered.filter(isNotEditorconfigDep2);
   return filtered;
 }
 function logGenerationResult(result, dryRun) {
@@ -2676,7 +2752,15 @@ function registerVscodeCommand(program2) {
   vscode.argument("<preset>").option("-F, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").option("--stylelint", "Include Stylelint settings and extension").option("--reset", "Reset local preset and re-materialize from built-in").action(
     async (presetName, options) => {
       const preset = resolvePreset(VSCODE_PRESETS, presetName);
-      if (!preset) return;
+      if (!preset) {
+        const err = new PresetNotFoundError(
+          presetName,
+          VSCODE_PRESETS.map((p) => p.name)
+        );
+        logger.error(err.message);
+        process.exitCode = 1;
+        return;
+      }
       const cwd = process.cwd();
       if (options.reset) {
         resetLocalPreset("vscode", presetName);

package/dist/skills/lux/references/custom-preset-setting.md

@@ -1,20 +1,6 @@
 # Custom Preset Configuration
 
-> ⚠️ **Always use `lux init --preset` to initialize presets.** Running `lux fmt` / `lux vscode` directly generates config files in cwd and requires `package.json` — only use in real project directories.
-
-## Quick Start
-
-```bash
-lux init --preset                # materialize all built-in presets to ~/.lux/preset/
-```
-
-After materialization, edit files under `~/.lux/preset/<type>/<preset-name>/` to customize. Changes take effect on the next `lux fmt` / `lux vscode` run.
-
-`lux init --preset` can be run repeatedly — each run overwrites with built-in defaults. To reset a single preset, use `lux fmt <name> --reset` or `lux vscode <name> --reset` (deletes local preset dir only; re-generated from built-in on next run).
-
-## Storage Location
-
-`~/.lux/preset/` (i.e. `os.homedir()/.lux/preset/`). Override with `LUX_HOME` env var.
+lux 预设存储在`~/.lux/preset/` (i.e. `os.homedir()/.lux/preset/`). Override with `LUX_HOME` env var。
 
 ```
 ~/.lux/preset/
@@ -22,46 +8,118 @@ After materialization, edit files under `~/.lux/preset/<type>/<preset-name>/` to
 └── vscode/               # vscode presets (same + go)
 ```
 
-## File Reference
+> ⚠️ **Always use `lux init --preset` to initialize all built-in presets.**。
+
+## Built-in presets File Reference
 
 ### fmt preset
 
-| File                   | Description                                    |
-| :--------------------- | :--------------------------------------------- |
-| `eslint.config.mjs`    | ESLint flat config                             |
-| `.prettierrc`          | Prettier JSON config                           |
-| `.prettierignore`      | Prettier ignore rules                          |
-| `stylelint.config.mjs` | Stylelint config                               |
-| `.stylelintignore`     | Stylelint ignore rules                         |
-| `cspell.json`          | CSpell dictionary config                       |
-| `.editorconfig`        | EditorConfig config                            |
-| `package.json`         | Template with `devDependencies` and `scripts`  |
+| File                   | Description                                   |
+| :--------------------- | :-------------------------------------------- |
+| `eslint.config.mjs`    | ESLint flat config                            |
+| `.prettierrc`          | Prettier JSON config                          |
+| `.prettierignore`      | Prettier ignore rules                         |
+| `stylelint.config.mjs` | Stylelint config                              |
+| `.stylelintignore`     | Stylelint ignore rules                        |
+| `cspell.json`          | CSpell dictionary config                      |
+| `.editorconfig`        | EditorConfig config                           |
+| `package.json`         | Template with `devDependencies` and `scripts` |
 
 ### vscode preset
 
-| File              | Description                 |
-| :---------------- | :-------------------------- |
-| `settings.json`   | VSCode workspace settings   |
+| File              | Description                      |
+| :---------------- | :------------------------------- |
+| `settings.json`   | VSCode workspace settings        |
 | `extensions.json` | VSCode extension recommendations |
 
-## Template Placeholders (fmt preset)
+## Customize built-in presets
+
+```bash
+lux init --preset                # init all built-in presets
+```
+
+After init, edit files under `~/.lux/preset/<type>/<preset-name>/` to customize，例如`package.json`、`eslint.config.mjs`等等，也可以增加你自己的 lint 文件例如`your-file-lint-config`. Changes take effect on the next `lux fmt` / `lux vscode` run.
+
+如果你自定义内置预设想重置的时候，可以重新执行`lux init --preset`去覆盖，或者使用`lux fmt <name> --reset` 、`lux vscode <name> --reset` (deletes local preset dir only; re-generated from built-in on next run).
 
-| Placeholder | Replaced with |
-| :---------- | :------------ |
-| `<pm>`      | Package manager prefix (`bun run` / `pnpm run` / `npm run`) |
-| `<lockfile>` | Project lockfile name (`bun.lock` / `pnpm-lock.yaml` etc.) |
-| `"<latest>"` | Resolved to latest version at install time, or pin like `"3.3.0"` |
+## Customize your own presets
 
-## Workflow
+### fmt
 
+Create a directory under `~/.lux/preset/fmt/<your-fmt-preset-name>/` with config files and a `package.json`:
+
+```bash
+# 1. Create the preset directory
+mkdir -p ~/.lux/preset/fmt/[your-custom-fmt-preset-name]
+
+# 2. Add config files (pick what you need)
+#    Required: package.json (with devDependencies/dependencies and/or scripts)
+#    Optional: eslint.config.mjs, .prettierrc, .prettierignore,
+#              stylelint.config.mjs, .stylelintignore,
+#              cspell.json, .editorconfig , etc....
+```
+
+Minimum `package.json` example:
+
+```json
+{
+   "devDependencies": {
+      "eslint": "<latest>",
+      "prettier": "<latest>"
+   },
+   "scripts": {
+      "lint": "<pm> eslint .",
+      "lint:fix": "<pm> eslint . --fix --cache --cache-location node_modules/.cache/.eslintcache",
+      "cspell": "<pm> cspell \"**\""
+   }
+}
+```
+
+Then 执行`lux fmt list`检查是否生效——这个`<your-fmt-preset-name>` 是否出现在其中。
+
+```bash
+lux fmt <your-fmt-preset-name>                            # applies your custom preset
+lux fmt <your-fmt-preset-name>  --force                   # overwrite existing config files
+lux fmt <your-fmt-preset-name> --dry-run                  # preview without writing
+lux fmt <your-fmt-preset-name> --stylelint                # applies your custom preset (includes stylelint config)
 ```
-lux init --preset
-  → materialize all built-in presets to ~/.lux/preset/ (no cwd writes)
 
-lux fmt web-vue (in target project)
-  → local preset exists → use local version (with custom edits)
-  → local preset missing → generate from built-in + materialize (also writes to cwd)
+Notes:
+
+- `lux fmt list` shows custom presets after built-in ones, marked with `(custom)`
+- `lux fmt <name> --reset` warns and aborts for custom presets — there is no built-in source to restore
+- Unknown preset names fuzzy-match against all available presets (builtin + custom combined)
+- `lux fmt` returns exit code **1** when a preset is not found (safe for CI/CD)
+- `lux fmt <name> --stylelint/--editorconfig` warns when the flag has no effect (preset has no matching config or dependencies)
+
+### vscode
+
+Custom vscode presets are not yet supported. To customize VSCode settings, use the built-in preset customization flow:
+
+```bash
+lux init --preset                                     # materialize built-in presets
+# Edit files under ~/.lux/preset/vscode/<preset-name>/
+#   - settings.json   (VSCode workspace settings)
+#   - extensions.json (extension recommendations)
+lux vscode web-vue                                    # applies your customized preset
+```
 
-lux vscode web-vue (in target project)
-  → same as above
+## Fmt presets · package.json rules
+
+`devDependencies` 和 `dependencies` 最新版本占位使用`<latest>`，特定版本除外。还有这个`scripts`如果不确定包管理器就用占位符`<pm>`让 lux 自动检测。
+
+```jsonc
+{
+   "devDependencies": {
+      // 最新版本
+      "prettier": "<latest>",
+      // 固定版本
+      "cspell": "10.0.0",
+   },
+   "scripts": {
+      "lint": "<pm> eslint .",
+      "lint:fix": "<pm> eslint . --fix --cache --cache-location node_modules/.cache/.eslintcache",
+      "cspell": "<pm> cspell \"**\"",
+   },
+}
 ```

package/dist/skills/lux/skill.md

@@ -15,25 +15,28 @@ lux fmt list
 - `--no-install` — write deps to package.json but skip install
 - `--reset` — reset local preset, re-materialize from built-in defaults
 
-Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest`
+`lux fmt list` Built-in presets first, custom presets last, marked with **custom**.
+
+built-in presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest`
 
 ## vscode — generate editor settings
 
 ```bash
-lux vscode <preset> [--dry-run]
+lux vscode <preset> [--dry-run] [--stylelint]
 lux vscode list
 ```
 
 - `--force` — overwrite existing settings (default: skip)
 - `--dry-run` — preview what would be generated, write nothing
+- `--stylelint` — Include Stylelint settings and extension
 - `--reset` — reset local preset, re-materialize from built-in defaults
 
-Presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest` `go`
+built-in presets: `web-vue` `web-react` `electron-vue` `uniapp` `node` `nest` `go`
 
 ## init — initialize skills or presets
 
 ```bash
-lux init                  # interactively select AI tool, copy skill files to project
+lux init                  # interactively select AI tool, copy skill files to AI Agent
 lux init --preset         # materialize all built-in presets to ~/.lux/preset/ (no cwd writes, no package.json required)
 ```
 

package/package.json

@@ -1,13 +1,14 @@
 {
    "name": "@luxkit/cli",
-   "version": "1.1.2",
+   "version": "1.1.3",
    "description": "One-click project formatting & VSCode config CLI",
    "type": "module",
    "bin": {
       "lux": "dist/index.js"
    },
    "files": [
-      "dist"
+      "dist",
+      "README_Zh.md"
    ],
    "publishConfig": {
       "access": "public"
@@ -21,7 +22,8 @@
       "prepublishOnly": "cross-env NODE_ENV=production bun run build",
       "test": "vitest run",
       "test:watch": "vitest",
-      "test:coverage": "vitest run --coverage"
+      "test:coverage": "vitest run --coverage",
+      "code:check": "bun run lint && bun run format:check"
    },
    "keywords": [
       "cli",