@mznjs/mbump 2.1.0 → 2.2.0

package/README.md

@@ -1,63 +1,42 @@
 # mbump
 
-企业级版本管理工具，支持单包和 monorepo 场景。
+企业级版本管理工具，支持单包和 Monorepo 场景，让版本更新变得简单高效。
 
 ## ✨ 功能特性
 
-- ✅ 基础版本递增 (major/minor/patch)
-- ✅ 预发布版本支持 (pre-patch/pre-minor/pre-major)
-- ✅ 自定义版本号输入
-- ✅ CHANGELOG 自动生成
-- ✅ Git Tag 管理（支持自定义前缀）
-- ✅ Git 自动提交和推送
-- ✅ 多包管理 (monorepo)
-- ✅ **交互式版本选择** - 可视化选择版本类型
-- ✅ 试运行模式 (dry-run)
-- ✅ NPM/PNPM 发布支持
-- ✅ **多格式配置文件支持** (TS/JS/JSON/YAML/TOML)
-- ✅ 智能配置加载（支持异步/同步）
-- ✅ 未提交更改检测与处理
-- ✅ 详细日志输出模式
-- ✅ **零配置启动** - 无需配置文件即可使用
+- **版本管理**：支持 major/minor/patch 递增，以及 pre-release 版本
+- **Monorepo 支持**：管理多个包的版本，支持批量更新
+- **交互式选择**：可视化选择版本类型，无需记忆命令参数
+- **Git 集成**：自动提交、打 Tag、推送到远程仓库
+- **CHANGELOG 生成**：根据 Git 提交自动生成更新日志
+- **路径模式**：直接指定项目目录，无需配置文件
+- **Rust 支持**：更新 Cargo.toml 中的版本号
+- **安全检查**：检测未提交更改，防止版本状态不一致
+- **Dry-run 模式**：预览将要执行的操作，避免误操作
+- **多格式配置**：支持 TS/JS/JSON/YAML/TOML 等多种配置格式
 
 ## 📦 安装
 
 ### 全局安装（推荐）
 
-适合在多个项目中使用，一次安装，全局可用：
-
 ```bash
 npm install -g @mznjs/mbump
 # 或
 pnpm add -g @mznjs/mbump
 ```
 
-**全局安装特性**：
-- ✅ 所有依赖（包括 `tsx`）已移至 `dependencies`，确保全局安装后正常工作
-- ✅ 支持 `.ts` 配置文件的自动编译
-- ✅ 可在任意项目目录下使用
-
 ### 本地安装
 
-适合在单个项目中使用，作为开发依赖：
-
 ```bash
 npm install @mznjs/mbump -D
 # 或
 pnpm add @mznjs/mbump -D
 ```
 
-**本地安装特性**：
-- ✅ 项目级依赖，不影响全局环境
-- ✅ 可在 `package.json` 的 `scripts` 中使用
-- ✅ 推荐在 CI/CD 流程中使用
-
 ## 🚀 快速开始
 
 ### 单包项目（零配置）
 
-无需任何配置文件，mbump 会自动使用默认配置 `{ default: 'package.json' }`：
-
 ```bash
 # 升级补丁版本
 mbump patch
@@ -72,349 +51,203 @@ mbump major
 mbump
 ```
 
-**零配置行为**：
-- ✅ 自动识别当前目录的 `package.json`
-- ✅ 使用 `default` 作为包名
-- ✅ 创建 Git Tag：`v{version}`（如 `v1.0.1`）
-- ✅ 生成 CHANGELOG.md
-
-### 路径模式（直接指定项目目录）
-
-无需配置文件，直接指定项目目录路径，mbump 会自动查找该目录下的 `package.json`：
+### 路径模式
 
 ```bash
-# 更新指定目录下的 package.json（默认 patch）
+# 更新指定目录下的项目（默认 patch）
 mbump ./packages/my-pkg
 
 # 指定版本类型
-mbump ./packages/my-pkg patch
 mbump ./packages/my-pkg minor
-mbump ./packages/my-pkg major
 
 # 使用上级目录
 mbump ../other-project
-
-# 使用绝对路径
-mbump /path/to/project
-mbump C:\projects\my-app
 ```
 
-**支持的路径格式**：
-
-| 格式类型 | 示例 | 说明 |
-|----------|------|------|
-| Unix 相对路径 | `./packages/theme` | 以 `./` 开头 |
-| Windows 相对路径 | `.\frontend` | 以 `.\` 开头 |
-| 当前目录 | `.` | 单个点 |
-| 上级目录 | `../other-project` | 以 `../` 或 `..\` 开头 |
-| 简单目录名 | `frontend` | 直接使用目录名（会自动检测） |
-| Unix 绝对路径 | `/usr/local/project` | 以 `/` 开头 |
-| Windows 绝对路径 | `\Windows\System32` | 以 `\` 开头 |
-| Windows 驱动器 | `C:\Projects\app` | 驱动器字母 + `:\` |
-| 用户主目录 | `~/projects/my-app` | 以 `~` 开头 |
-| UNC 网络路径 | `\\server\share\project` | 以 `\\` 开头 |
-
-**路径模式特性**：
-- ✅ 支持多种路径格式（相对路径、绝对路径、驱动器路径、UNC 路径等）
-- ✅ 自动检测路径下是否存在 `package.json`
-- ✅ 使用默认配置 `{ default: 'package.json' }`
-- ✅ 支持所有命令行选项（`--dry-run`, `--verbose`, `--npm` 等）
-- ✅ 适合快速更新独立的子包或临时项目
-- ✅ 智能回退：如果包名在配置中找不到，会自动检查是否为有效目录路径
-
 ### Monorepo 项目
 
-创建配置文件 `.mbump.config.json`（或其他支持的格式）：
+创建 `.mbump.config.ts` 配置文件：
+
+```typescript
+import type { Config } from '@mznjs/mbump'
 
-```json
-{
-  "packagePaths": {
-    "components": "packages/components/package.json",
-    "cli": "packages/cli/package.json",
-    "core": "packages/core/package.json"
-  }
-}
+export default {
+  packagePaths: {
+    components: 'packages/components/package.json',
+    cli: 'packages/cli/package.json',
+    core: 'packages/core/package.json',
+  },
+} satisfies Config
 ```
 
-**重要特性**：
-- ✅ **默认包始终保留**：即使配置了 `packagePaths`，`default` 键（指向根目录 `package.json`）仍然会被保留
-- ✅ **路径解析基准**：相对路径相对于配置文件所在目录解析，而非当前工作目录
-- ✅ **统一路径处理**：配置中的路径在加载时会自动解析为绝对路径
+使用命令：
 
 ```bash
-# 更新所有包（交互式选择每个包的版本）
-mbump all
-
 # 更新指定包
-mbump components minor
-
-# 更新根目录包
-mbump default patch
+mbump components patch
 
-# 试运行模式（不实际执行）
-mbump components minor --dry-run
+# 更新所有包
+mbump all
 
-# 更新版本并发布到 npm/pnpm
-mbump components patch --npm
+# 试运行模式
+mbump all minor --dry-run
 ```
 
-## 💻 命令行参数
+## 📖 使用方法
 
-```
-用法: mbump [package|path] [type] [options]
+### 1. 指定包名或路径
 
-参数:
-  [package]      要更新的包名称或 "all" 更新所有包
-  [path]         项目目录路径（支持 ./path, ../path, /path, C:\path），自动查找该目录下的 package.json
-  [type]         版本升级类型: major, minor, patch, pre-patch, pre-minor, pre-major
+```bash
+# 使用包名（需要配置文件）
+mbump <package-name> <type>
 
-选项:
-  --dry-run, -d          试运行模式，只显示将要执行的操作
-  --verbose, -v          详细输出模式，显示更多执行细节
-  --no-commit, -n        禁用自动git提交
-  --no-push, -p          禁用自动推送到远程仓库
-  --allow-uncommitted, -u  允许在有未提交更改的情况下继续操作
-  --npm, -N              启用npm/pnpm包发布功能（默认不发布）
-  --show-config, -c      显示当前加载的完整配置信息
-  --version, -V          显示当前版本号
-  --help, -h             显示此帮助信息
-
-示例:
-  mbump components patch              # 将components包升级一个补丁版本
-  mbump all minor                     # 将所有包升级一个小版本
-  mbump plugins major --dry-run       # 试运行升级plugins包主版本
-  mbump core patch --no-push          # 更新版本并提交到本地，但不推送到远程
-  mbump components patch --npm        # 更新版本并发布到npm/pnpm
-  mbump                               # 交互式选择包和版本类型
-  mbump --show-config                 # 查看当前配置
-  mbump --version                     # 查看当前版本号
-
-  # 路径模式
-  mbump ./packages/my-pkg             # 更新 ./packages/my-pkg 目录下的 package.json
-  mbump ./packages/my-pkg patch       # 指定版本类型
-  mbump ../other-project minor        # 更新上级目录的项目
-  mbump /path/to/project major        # 使用绝对路径
-  mbump ./packages/my-pkg --dry-run   # 试运行模式
-  mbump .\frontend\                   # Windows 风格路径（PowerShell）
-  mbump frontend                      # 直接使用目录名（自动检测）
-  mbump ~/projects/my-app             # 使用用户主目录路径
+# 使用路径（无需配置文件）
+mbump <path> <type>
 ```
 
-## ⚙️ 配置文件
-
-mbump 支持多种配置格式，并提供灵活的加载策略。
+### 2. 版本类型
 
-### 支持的配置文件格式
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `major` | 主版本号递增 | 1.0.0 → 2.0.0 |
+| `minor` | 次版本号递增 | 1.0.0 → 1.1.0 |
+| `patch` | 修订号递增 | 1.0.0 → 1.0.1 |
+| `pre-major` | 预发布主版本 | 1.0.0 → 2.0.0-beta.0 |
+| `pre-minor` | 预发布次版本 | 1.0.0 → 1.1.0-beta.0 |
+| `pre-patch` | 预发布修订版 | 1.0.0 → 1.0.1-beta.0 |
+| `as-is` | 使用自定义版本 | 指定 customVersion |
 
-| 格式 | 文件扩展名 | 异步加载 | 同步加载 | 说明 |
-|------|-----------|---------|---------|------|
-| TypeScript | `.ts` | ✅ | ❌ | 需要 tsx，提供类型安全 |
-| ES Module | `.mjs` | ✅ | ❌ | 使用 `export default` |
-| JavaScript | `.js` | ✅ | ⚠️ | 优先 ES Module，兼容 CommonJS |
-| CommonJS | `.cjs` | ✅ | ✅ | 使用 `module.exports` |
-| JSON | `.json`, `.jsonc` | ✅ | ✅ | 标准 JSON 或带注释 JSON |
-| YAML | `.yaml`, `.yml` | ✅ | ✅ | YAML 格式 |
-| TOML | `.toml` | ✅ | ✅ | TOML 格式 |
-| package.json | - | ✅ | ✅ | 在 `mbump` 字段中配置 |
+### 3. 常用命令示例
 
-**配置文件前缀**: 支持 `.mbump.config.*` 和 `.zbump.config.*`
+```bash
+# 更新补丁版本
+mbump patch
 
-### 配置文件优先级
+# 更新指定包的小版本
+mbump components minor
 
-配置加载器会按以下顺序查找配置文件（找到第一个即停止）：
+# 批量更新所有包
+mbump all
 
-1. TypeScript (`.ts`)
-2. ES Module (`.mjs`)
-3. JavaScript (`.js`)
-4. CommonJS (`.cjs`)
-5. JSON (`.json`, `.jsonc`)
-6. YAML (`.yaml`, `.yml`)
-7. TOML (`.toml`)
-8. package.json
+# 批量更新所有包到补丁版本
+mbump all patch
 
-### 配置示例
+# 预发布版本
+mbump pre-minor
 
-#### ES Module 格式（推荐）⭐
+# 试运行模式（预览操作）
+mbump components patch --dry-run
 
-```javascript
-// .mbump.config.mjs
-export default {
-  packagePaths: {
-    components: 'packages/components/package.json',
-    cli: 'packages/cli/package.json',
-  },
-  defaults: {
-    releaseType: 'patch',
-  },
-}
-```
+# 更新版本并发布到 NPM
+mbump components patch --npm
 
-#### TypeScript 格式
+# 更新版本但不推送到远程
+mbump components patch --no-push
 
-```typescript
-// .mbump.config.ts
-import type { Config } from '@mznjs/mbump'
+# 允许未提交更改的情况下继续
+mbump components patch --allow-uncommitted
 
-export default {
-  packagePaths: {
-    components: 'packages/components/package.json',
-  },
-  defaults: {
-    releaseType: 'minor',
-  },
-} satisfies Config
+# 详细输出模式
+mbump components patch --verbose
 ```
 
-#### CommonJS 格式
+### 4. 路径模式详解
 
-```javascript
-// .mbump.config.cjs
-module.exports = {
-  packagePaths: {
-    components: 'packages/components/package.json',
-  },
-}
-```
+路径模式允许直接指定项目目录，无需配置文件：
 
-#### JSON 格式
+```bash
+# 相对路径
+mbump ./packages/my-pkg
+mbump ../other-project
 
-```json
-{
-  "packagePaths": {
-    "components": "packages/components/package.json",
-    "cli": "packages/cli/package.json"
-  },
-  "defaults": {
-    "releaseType": "patch"
-  },
-  "git": {
-    "commitMessage": "chore: bump version to {{newVersion}}",
-    "push": true,
-    "autoCommit": true,
-    "tag": true,
-    "tagPrefix": "v",
-    "changelog": true
-  },
-  "publish": {
-    "command": "pnpm publish --access public --no-git-checks",
-    "skipChecks": true
-  }
-}
+# 绝对路径
+mbump /path/to/project
+mbump C:\Projects\my-app
+
+# 当前目录
+mbump .
 ```
 
-#### YAML 格式
+支持的路径格式：
+
+| 格式 | 示例 |
+|------|------|
+| 相对路径 | `./packages/my-pkg` |
+| 上级目录 | `../other-project` |
+| 绝对路径 | `/usr/local/project` |
+| Windows 路径 | `C:\Projects\app` |
+| 用户主目录 | `~/projects/my-app` |
+| UNC 路径 | `\\server\share\project` |
 
-```yaml
-# .mbump.config.yaml
-packagePaths:
-  components: packages/components/package.json
-  cli: packages/cli/package.json
+### 5. Rust 项目模式
 
-defaults:
-  releaseType: patch
+```bash
+# 更新当前目录 Rust 项目
+mbump --rust patch
 
-git:
-  commitMessage: "chore: bump version to {{newVersion}}"
-  push: true
-  autoCommit: true
-  tag: true
-  tagPrefix: v
-  changelog: true
+# 更新指定目录的 Rust 项目
+mbump ./backend -r minor
 
-publish:
-  command: "pnpm publish --access public --no-git-checks"
-  skipChecks: true
+# 试运行模式
+mbump -r major --dry-run
 ```
 
-#### TOML 格式
+## ⚙️ 配置文件
 
-```toml
-# .mbump.config.toml
-[packagePaths]
-components = "packages/components/package.json"
-cli = "packages/cli/package.json"
+### 配置文件格式
 
-[defaults]
-releaseType = "patch"
+支持多种格式，按以下顺序查找：
+`.ts` → `.mjs` → `.js` → `.cjs` → `.json` → `.yaml` → `.yml` → `.toml` → `package.json`
 
-[git]
-commitMessage = "chore: bump version to {{newVersion}}"
-push = true
-autoCommit = true
-tag = true
-tagPrefix = "v"
-changelog = true
+### 配置选项
 
-[publish]
-command = "pnpm publish --access public --no-git-checks"
-skipChecks = true
-```
+```typescript
+import type { Config } from '@mznjs/mbump'
 
-#### package.json 格式
-
-```json
-{
-  "name": "my-monorepo",
-  "version": "1.0.0",
-  "mbump": {
-    "packagePaths": {
-      "components": "packages/components/package.json",
-      "cli": "packages/cli/package.json"
-    }
-  }
-}
-```
+export default {
+  // 包路径配置
+  packagePaths: {
+    default: 'package.json',
+    components: 'packages/components/package.json',
+  },
 
-#### 函数导出
+  // 默认选项
+  defaults: {
+    releaseType: 'patch',
+    dryRun: false,
+    verbose: false,
+    allowUncommitted: false,
+    npm: false,
+  },
 
-配置文件也可以导出一个函数，该函数会被自动调用以获取配置：
+  // Git 选项
+  git: {
+    commitMessage: 'chore: bump version to {{newVersion}}',
+    push: true,
+    autoCommit: true,
+    tag: true,
+    tagPrefix: 'v',
+    changelog: true,
+  },
 
-```javascript
-// .mbump.config.js
-export default () => ({
-  packagePaths: {
-    components: 'packages/components/package.json',
+  // 发布选项
+  publish: {
+    command: 'pnpm publish --access public --no-git-checks',
+    skipChecks: true,
   },
-})
+} satisfies Config
 ```
 
-### 配置选项详解
+### 配置项说明
 
-#### 根选项
+#### packagePaths
 
-| 选项 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `packagePaths` | `Record<string, string>` | `{ default: 'package.json' }` | 包路径映射，相对路径相对于配置文件所在目录解析 |
-
-**packagePaths 配置说明**：
-
-1. **默认配置**：即使不配置 `packagePaths`，系统也会自动使用 `{ default: 'package.json' }`
-2. **默认包保留**：用户配置 `packagePaths` 时，`default` 键始终会被保留，指向根目录的 `package.json`
-3. **路径解析基准**：相对路径相对于配置文件所在目录解析，而非 `process.cwd()`
-4. **示例**：
-   ```typescript
-   // .mbump.config.ts（位于项目根目录）
-   export default {
-     packagePaths: {
-       theme: 'packages/theme/package.json',      // 解析为 /project/packages/theme/package.json
-       web: 'packages/web/package.json',          // 解析为 /project/packages/web/package.json
-       utils: 'plugins/utils/package.json',       // 解析为 /project/plugins/utils/package.json
-       core: 'plugins/core/package.json',         // 解析为 /project/plugins/core/package.json
-     },
-   } satisfies Config
-   ```
-   最终合并后的配置会包含：
-   ```typescript
-   {
-     default: '/project/package.json',           // 自动保留
-     theme: '/project/packages/theme/package.json',
-     web: '/project/packages/web/package.json',
-     utils: '/project/plugins/utils/package.json',
-     core: '/project/plugins/core/package.json',
-   }
-   ```
-
-#### defaults 选项
+包路径映射，键为包名，值为 `package.json` 的相对路径（相对于配置文件所在目录）。
+
+- `default` 键始终指向根目录的 `package.json`
+- 即使不配置，系统也会自动使用 `{ default: 'package.json' }`
+
+#### defaults
 
 | 选项 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -424,301 +257,164 @@ export default () => ({
 | `allowUncommitted` | `boolean` | `false` | 允许未提交更改 |
 | `npm` | `boolean` | `false` | 默认启用发布 |
 
-#### git 选项
+#### git
 
 | 选项 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `commitMessage` | `string` | `'chore: bump version to {{newVersion}}'` | Git 提交消息模板（支持 `{{newVersion}}` 占位符） |
-| `push` | `boolean` | `true` | 是否自动推送到远程仓库 |
-| `autoCommit` | `boolean` | `true` | 是否自动提交更改 |
-| `tag` | `boolean` | `true` | 是否创建 Git 标签 |
-| `tagPrefix` | `string` | `'v'` | 标签前缀（如 `v1.0.0`）。**注意**：仅主项目包使用此配置，子包使用 `{包名}@{版本号}` 格式 |
-| `changelog` | `boolean` | `true` | 是否生成 CHANGELOG。**注意**：在 `mbump all` 批量更新时，只有主项目包会生成 CHANGELOG，子包跳过此步骤 |
-
-**Git Tag 策略**：
-
-mbump 根据包的类型采用不同的 Tag 命名策略：
-
-#### 主项目包 (default / root package)
-- **Tag 格式**: `{tagPrefix}{version}`
-- **使用前缀**: 是（默认 `v`）
-- **识别条件**: 包名为 `default` 或包路径为 `package.json`（根目录）
-- **示例**:
-  ```bash
-  mbump default patch
-  # 假设 package.json 中 "name": "@my-org/monorepo"
-  # → 创建 Tag: v1.0.1
-
-  # 自定义前缀
-  mbump default minor
-  # 如果配置 git.tagPrefix = "release-"
-  # → 创建 Tag: release-1.1.0
-  ```
-
-#### 子包 (所有非主项目包)
-- **Tag 格式**: `{package-name}@{version}`
-- **不使用前缀**: 直接使用 package.json 中的 `name` 字段
-- **适用场景**:
-  - 单独更新子包：`mbump components patch`
-  - 批量更新所有包：`mbump all`
-- **示例**:
-  ```bash
-  mbump components patch
-  # 假设 components/package.json 中 "name": "@my-org/components"
-  # → 创建 Tag: @my-org/components@1.0.1
-
-  mbump cli minor
-  # 假设 cli/package.json 中 "name": "@my-org/cli"
-  # → 创建 Tag: @my-org/cli@2.3.0
-  ```
-
-#### 批量更新 (mbump all)
-当使用 `mbump all` 时，会为每个包创建相应的 Tag：
-```bash
-mbump all
-# → 主项目包: v1.0.1 (使用 tagPrefix)
-# → 子包们:
-#   - @my-org/components@1.0.1
-#   - @my-org/cli@2.3.0
-#   - @my-org/core@0.5.2
-```
-
-**优势**：
-- ✅ 主项目包保持简洁的 `v1.0.1` 格式，符合传统习惯
-- ✅ 子包使用清晰的 `{包名}@{版本号}` 格式，便于区分
-- ✅ 清晰区分主项目和子包的版本历史
-- ✅ 便于单独回滚某个包到特定版本
-- ✅ 符合 Monorepo 最佳实践（类似 pnpm、lerna）
-- ✅ 支持独立的 CI/CD 流程
-
-#### CHANGELOG 生成策略
-
-mbump 在不同场景下采用不同的 CHANGELOG 生成策略：
-
-**单包更新** (`mbump components patch`)：
-- ✅ 为该包生成 CHANGELOG.md
-- ✅ 记录从上一个 Tag 到当前的所有 commits
-- ✅ **标题格式**: `[package-name@version]`，例如 `[@mznjs/components@1.0.1]`
-
-**批量更新** (`mbump all`)：
-- ✅ **主项目包**：生成 CHANGELOG.md（如果 `git.changelog = true`）
-- ❌ **子包**：跳过 CHANGELOG 生成，避免重复和混乱
-
-**原因**：
-- Monorepo 项目中，所有包的 commits 通常都在同一个仓库中
-- 为每个子包单独生成 CHANGELOG 会导致内容重复
-- 只在主项目包生成一份完整的 CHANGELOG 更清晰、更易维护
-
-**CHANGELOG 标题格式**：
-- **主项目包**: `[v1.0.1]` (使用 tagPrefix)
-- **子包**: `[@mznjs/components@1.0.1]` (使用 package.json 的 name 字段)
-
-**示例**：
-```bash
-# 单包更新 - 会生成 CHANGELOG
-mbump components patch
-# → CHANGELOG.md 中添加: ## [@mznjs/components@1.0.1] - 2024-01-15 ✅
-
-# 主项目包单独更新
-mbump default patch
-# → CHANGELOG.md 中添加: ## [v1.0.1] - 2024-01-15 ✅
-
-# 批量更新 - 只有主项目包生成 CHANGELOG
-mbump all
-# → 主项目包: CHANGELOG.md 中添加: ## [v1.0.1] - 2024-01-15 ✅
-# → 子包 components: 子包 components 跳过 CHANGELOG 生成
-# → 子包 cli: 子包 cli 跳过 CHANGELOG 生成
-```
-
-如需为子包单独生成 CHANGELOG，可以单独更新该包：
-```bash
-mbump components patch --changelog
-```
+| `commitMessage` | `string` | `'chore: bump version...'` | 提交消息模板 |
+| `push` | `boolean` | `true` | 是否自动推送 |
+| `autoCommit` | `boolean` | `true` | 是否自动提交 |
+| `tag` | `boolean` | `true` | 是否创建 Tag |
+| `tagPrefix` | `string` | `'v'` | Tag 前缀（仅主项目） |
+| `changelog` | `boolean` | `true` | 是否生成 CHANGELOG |
 
-#### publish 选项
+#### publish
 
 | 选项 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `command` | `string` | `'pnpm publish --access public --no-git-checks'` | 发布命令 |
+| `command` | `string` | `'pnpm publish...'` | 发布命令 |
 | `skipChecks` | `boolean` | `true` | 跳过安全检查 |
 
-### 配置最佳实践
+## 📝 命令行选项
 
-#### 单包项目
-
-无需配置文件，直接使用默认配置：
-
-```bash
-# 直接使用，自动识别当前目录的 package.json
-mbump patch
 ```
+用法: mbump [package|path] [type] [options]
 
-如果需要自定义配置：
+参数:
+  [package]      要更新的包名称或 "all" 更新所有包
+  [path]         项目目录路径（支持 ./path, ../path, /path, C:\path）
+  [type]         版本升级类型: major, minor, patch, pre-patch, pre-minor, pre-major
 
-```json
-{
-  "packagePaths": {
-    "default": "package.json"
-  }
-}
+选项:
+  --dry-run, -d          试运行模式，只显示将要执行的操作
+  --verbose, -v          详细输出模式，显示更多执行细节
+  --no-commit, -n        禁用自动 Git 提交
+  --no-push, -p          禁用自动推送到远程仓库
+  --allow-uncommitted, -u 允许在有未提交更改的情况下继续操作
+  --npm, -N              启用 NPM/PNPM 包发布功能
+  --show-config, -c      显示当前加载的完整配置信息
+  --rust, -r             启用 Rust 项目模式
+  --version, -V          显示当前版本号
+  --help, -h             显示帮助信息
 ```
 
-#### Monorepo 项目
+## 🔌 API 使用
 
-```javascript
-// .mbump.config.mjs
-export default {
-  packagePaths: {
-    // 核心包
-    core: 'packages/core/package.json',
-    // UI 组件库
-    components: 'packages/components/package.json',
-    // CLI 工具
-    cli: 'packages/cli/package.json',
-    // 插件系统
-    plugins: 'packages/plugins/package.json',
-  },
-  defaults: {
-    releaseType: 'patch',
-    verbose: false,
-  },
-  git: {
-    commitMessage: 'chore(release): bump {{name}} to {{newVersion}}',
-    tagPrefix: '',
-  },
-  publish: {
-    command: 'pnpm publish --access public --no-git-checks',
-    skipChecks: true,
-  },
-}
+### 核心类
+
+```typescript
+import { VersionManager, RustManager, GitManager, ChangelogManager } from '@mznjs/mbump'
 ```
 
-## 🔌 API 使用
+### VersionManager
 
 ```typescript
-import { VersionManager, loadConfig, loadConfigAsync } from '@mznjs/mbump'
+import { VersionManager, loadConfigAsync } from '@mznjs/mbump'
 
-// 异步加载配置（推荐）
 const config = await loadConfigAsync(process.cwd())
 const manager = new VersionManager({ config, rootDir: process.cwd() })
 
-// 同步加载配置
-const config = loadConfig(process.cwd())
-const manager = new VersionManager({ config, rootDir: process.cwd() })
-
-// 更新单个包版本
+// 更新版本
 const result = await manager.updateVersion('my-package', 'minor', {
   dryRun: false,
   verbose: true,
   autoCommit: true,
   push: true,
-  npm: false,
 })
 
-console.log(result.updatedPackages)
-// [
-//   {
-//     name: 'my-package',
-//     oldVersion: '1.0.0',
-//     newVersion: '1.1.0'
-//   }
-// ]
+// 预览更新
+const preview = await manager.previewUpdate('my-package', 'patch')
 
-// 获取包当前版本
+// 获取包版本
 const version = manager.getPackageVersion('my-package')
-console.log(version) // '1.0.0'
+```
+
+### RustManager
+
+```typescript
+import { RustManager } from '@mznjs/mbump'
 
-// 手动提交和推送
-await manager.gitCommitAndPush(true) // true = 推送到远程
+const rustManager = new RustManager('/path/to/rust-project')
+
+// 更新版本
+const result = rustManager.updateVersion('patch', {
+  dryRun: false,
+})
 ```
 
-## 🛡️ 批量更新容错处理
+### GitManager
 
-`mbump all` 命令具有完善的容错处理机制，确保单个包更新失败不会影响其他包的正常更新。
+```typescript
+import { GitManager } from '@mznjs/mbump'
 
-### 工作原理
+const gitManager = new GitManager('/path/to/project')
 
-1. **错误收集**：每个包的更新操作都被 try-catch 包裹，失败时记录错误但继续处理下一个包
-2. **部分成功**：即使部分包失败，成功的包仍然可以完成版本更新、CHANGELOG 生成、Git 提交等操作
-3. **统一报告**：所有包处理完成后，统一报告失败的包及其错误信息
-4. **独立发布**：NPM 发布阶段也采用相同的容错机制，一个包发布失败不影响其他包
+// 检查未提交更改
+const hasChanges = gitManager.hasUncommittedChanges()
 
-### 使用示例
+// 创建 Tag
+await gitManager.createTag('1.0.0', 'v')
 
-```bash
-# 批量更新所有包
-mbump all patch
+// 提交并推送
+await gitManager.commitAndPush('chore: bump version', true, true, '1.0.0', 'v')
 ```
 
-**正常情况输出**：
-```bash
-✓ 包 components 更新完成
-✓ 包 cli 更新完成
-✓ 包 core 更新完成
-✓ 已提交 3 个包的更改到 Git
-✓ 已推送到远程仓库
-✅ 版本更新完成
-```
+### 工具函数
 
-**部分失败情况输出**：
-```bash
-✓ 包 components 更新完成
-⚠️ 包 cli 更新失败: Git conflict detected
-✓ 包 core 更新完成
-✓ 包 utils 更新完成
+```typescript
+import { pathUtils, semverUtils, securityUtils } from '@mznjs/mbump'
 
-❌ 批量更新完成，但有 1 个包更新失败:
-   - cli: Git conflict detected
+// 路径工具
+pathUtils.isPathLike('./packages/my-pkg') // true
 
-💡 提示: 可以单独重试失败的包，或检查错误信息后重新运行
+// Semver 工具
+semverUtils.incrementVersion('1.0.0', 'patch') // '1.0.1'
 
-✓ 已提交 3 个包的更改到 Git
-✓ 已推送到远程仓库
-✅ 版本更新完成
+// 安全工具
+securityUtils.validatePath('/project/src', '/project') // true
 ```
 
-### 失败后的处理
+## 🏷️ Git Tag 策略
+
+### 主项目包
 
-如果某个包更新失败，你可以：
+- **格式**: `{tagPrefix}{version}`
+- **示例**: `v1.0.1`, `release-2.0.0`
+- **识别条件**: 包名为 `default` 或包路径为 `package.json`
 
-1. **查看错误信息**：根据提示的错误信息进行修复
-2. **单独重试**：修复后单独更新失败的包
-   ```bash
-   mbump cli patch
-   ```
-3. **跳过 NPM 发布**：如果只是想更新版本和提交 Git
-   ```bash
-   mbump all patch --no-npm
-   ```
+### 子包
 
-### 技术细节
+- **格式**: `{package-name}@{version}`
+- **示例**: `@my-org/components@1.0.1`, `cli@2.3.0`
+- **识别条件**: 所有非主项目包
 
-- **错误类型**：收集 `Error` 对象，保留完整的错误消息
-- **日志级别**：
-  - 单个包失败：黄色警告 (`⚠️`)
-  - 最终汇总：红色错误 (`❌`)
-  - 提示信息：蓝色信息 (`💡`)
-- **Git 原子性**：所有成功的包会被一起提交到一个 Git commit 中
-- **NPM 独立性**：每个包的 NPM 发布是独立的，互不影响
+### 批量更新
 
-## 🔍 Dry-run 模式增强
+使用 `mbump all` 时，会为每个包创建独立的 Tag：
 
-`--dry-run`（或 `-d`）选项允许你在实际执行操作之前预览将要进行的更改。增强后的 dry-run 模式会显示详细的预览信息，帮助你确认操作是否符合预期。
+```
+v1.0.1                    # 主项目包
+@my-org/components@1.0.1  # 子包
+@my-org/cli@2.3.0         # 子包
+```
 
-### 单包更新预览
+## 📋 Dry-run 模式
+
+Dry-run 模式允许预览将要执行的操作，不实际修改任何文件：
 
 ```bash
 mbump components patch --dry-run
 ```
 
-**输出示例**：
+输出示例：
+
 ```
 🔍 Dry-run 模式 - 以下操作将被执行:
 
   📦 components
      当前版本: 1.0.0
      新版本:   1.0.1
-     Tag:      @mznjs/components@1.0.1
+     Tag:      @my-org/components@1.0.1
      CHANGELOG: 是
      Git Commit: 是
      Git Push: 是
@@ -727,960 +423,77 @@ mbump components patch --dry-run
 ✅ 以上为预览，未执行任何实际操作
 ```
 
-### 批量更新预览
-
-```bash
-mbump all minor --dry-run
-```
-
-**输出示例**：
-```
-🔍 Dry-run 模式 - 以下操作将被执行:
-
-  📦 default
-     当前版本: 0.0.1
-     新版本:   0.1.0
-     Tag:      v0.1.0
-     CHANGELOG: 是
-
-  📦 components
-     当前版本: 1.0.0
-     新版本:   1.1.0
-     Tag:      @mznjs/components@1.1.0
-     CHANGELOG: 跳过（子包或配置禁用）
-
-  📦 cli
-     当前版本: 2.0.0
-     新版本:   2.1.0
-     Tag:      @mznjs/cli@2.1.0
-     CHANGELOG: 跳过（子包或配置禁用）
-
-✅ 以上为预览，未执行任何实际操作
-```
-
-### 预览信息说明
-
-Dry-run 模式会显示以下关键信息：
-
-1. **📦 包名**：要更新的包名称
-2. **当前版本**：包的当前版本号
-3. **新版本**：将要升级到的版本号
-4. **Tag**：将要创建的 Git Tag 名称
-   - 主项目包：`v{version}` 格式
-   - 子包：`{package-name}@{version}` 格式
-5. **CHANGELOG**：是否会生成 CHANGELOG
-   - 主项目包：根据 `git.changelog` 配置
-   - 子包：批量更新时跳过，单包更新时生成
-6. **Git Commit**：是否会自动提交到 Git（仅单包更新显示）
-7. **Git Push**：是否会自动推送到远程仓库（仅单包更新显示）
-8. **NPM Publish**：是否会发布到 NPM（仅单包更新显示）
+## ⚠️ 未提交更改检测
 
-### 使用场景
+系统会自动检测未提交的 Git 更改，并提示用户确认：
 
-1. **验证版本计算**：确认新版本号是否正确
-2. **检查 Tag 命名**：预览将要创建的 Git Tag 名称
-3. **确认操作范围**：了解哪些包会被更新
-4. **避免误操作**：在实际执行前发现潜在问题
-5. **团队协作**：在 PR 中展示将要进行的更改
-
-### 注意事项
-
-- Dry-run 模式不会修改任何文件
-- 不会创建 Git commits 或 tags
-- 不会发布到 NPM
-- 适合用于 CI/CD 流程中的预检步骤
-- 可以与 `--verbose` 结合使用获取更多信息
-
-## ⚠️ 错误提示优化
-
-mbump 提供了友好的错误提示信息，帮助用户快速理解和解决问题。
-
-### 常见错误及解决方案
-
-#### 1. 版本已存在
-
-**错误信息**：
-```
-⚠️ 版本 v1.0.1 已存在
-💡 请使用其他版本号，或运行 git tag -d <tag> 删除已有标签
+```bash
+mbump components patch
 ```
 
-**原因**：尝试创建的 Git Tag 已经存在
-
-**解决方案**：
-- 使用不同的版本号
-- 或删除已有的 tag：`git tag -d v1.0.1 && git push origin :refs/tags/v1.0.1`
-
-#### 2. Git 冲突
+输出示例：
 
-**错误信息**：
 ```
-⚠️ 检测到 Git 冲突
-💡 请先解决冲突后重试：git add . && git commit -m "resolve conflicts"
+[warn] 警告: 检测到未提交的Git更改
+? 是否继续（dry-run模式不会实际提交更改）? Yes
 ```
 
-**原因**：工作区有未解决的合并冲突
-
-**解决方案**：
-- 手动解决冲突
-- 提交解决后的更改
-- 重新运行 mbump
+使用 `--allow-uncommitted` 选项跳过确认：
 
-#### 3. NPM 认证失败
-
-**错误信息**：
-```
-🔐 NPM 认证失败
-💡 请运行 npm login 或 pnpm login 登录后重试
+```bash
+mbump components patch --allow-uncommitted
 ```
 
-**原因**：未登录或登录凭证过期
-
-**解决方案**：
-- 运行 `npm login` 或 `pnpm login`
-- 输入用户名、密码和邮箱
-- 重新运行 mbump
+## 🛠️ 调试与诊断
 
-#### 4. NPM 包已存在
+### 查看配置
 
-**错误信息**：
-```
-📦 NPM 包已存在或无权限
-💡 检查包名是否已被占用，或确认是否有发布权限
+```bash
+mbump --show-config
 ```
 
-**原因**：包名已被他人注册，或没有发布权限
-
-**解决方案**：
-- 检查包名是否唯一
-- 联系包的所有者获取权限
-- 或使用 scoped package（如 @my-org/package-name）
+### 详细日志
 
-#### 5. 网络连接失败
-
-**错误信息**：
-```
-🌐 网络连接失败
-💡 请检查网络连接，或配置 NPM 镜像源
+```bash
+mbump components patch --verbose
 ```
 
-**原因**：网络不通或 NPM registry 无法访问
-
-**解决方案**：
-- 检查网络连接
-- 配置国内镜像源：
-  ```bash
-  npm config set registry https://registry.npmmirror.com
-  # 或
-  pnpm config set registry https://registry.npmmirror.com
-  ```
-
-#### 6. 文件路径安全
+### 常见错误处理
 
-**错误信息**：
-```
-🔒 检测到不安全的文件路径
-💡 请确保配置文件中的路径在项目根目录内
-```
+| 错误 | 解决方案 |
+|------|---------|
+| 版本已存在 | 删除已有 Tag: `git tag -d v1.0.1` |
+| Git 冲突 | 解决冲突后重新运行 |
+| NPM 认证失败 | 运行 `pnpm login` 登录 |
+| 包名不存在 | 检查配置文件中的 `packagePaths` |
+| 路径不存在 | 确认路径正确，目录存在 |
 
-**原因**：配置文件中的路径指向项目外部
+## 🧪 测试
 
-**解决方案**：
-- 检查 `.mbump.config.js` 中的 `packagePaths`
-- 确保所有路径都在项目根目录内
+```bash
+# 运行所有测试
+pnpm test
 
-#### 7. 无效的包名
+# 运行特定测试
+pnpm test tests/integration.test.ts
 
-**错误信息**：
-```
-❌ 无效的包名
-💡 请检查配置文件中的 packagePaths 是否正确设置
+# 监听模式
+pnpm test:watch
 ```
 
-**原因**：指定的包名在配置中不存在
-
-**解决方案**：
-- 检查 `.mbump.config.js` 中的 `packagePaths` 配置
-- 确保包名与配置中的 key 一致
-
-#### 8. 包路径不存在
+## 🤝 贡献指南
 
-**错误信息**：
-```
-配置错误：以下包路径指向的文件不存在
-  - components: "packages/components/package.json" -> 解析为 "/path/to/project/packages/components/package.json"（文件不存在）
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add some amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 开启 Pull Request
 
-请检查配置文件中的 packagePaths 是否正确
-```
+### 开发要求
 
-**原因**：配置文件中指定的 package.json 文件不存在
-
-**解决方案**：
-- 检查路径是否正确
-- 确保文件已创建
-- 相对路径是相对于配置文件所在目录解析的
-
-### 调试模式
-
-如果遇到未知错误，可以使用 `DEBUG` 环境变量查看详细信息：
-
-```bash
-# Linux/Mac
-DEBUG=true mbump components patch
-
-# Windows PowerShell
-$env:DEBUG="true"; mbump components patch
-
-# Windows CMD
-set DEBUG=true && mbump components patch
-```
-
-这将显示完整的错误堆栈信息，便于排查问题。
-
-### 批量更新错误报告
-
-在批量更新模式下，如果部分包失败，会统一报告：
-
-```
-❌ 批量更新完成，但有 1 个包更新失败:
-   - cli: Git conflict detected
-
-💡 提示: 可以单独重试失败的包，或检查错误信息后重新运行
-```
-
-每个失败的包都会显示友好的错误提示和解决方案。
-
-## 📊 进度条显示
-
-在批量更新模式下，mbump 会实时显示更新进度，让你清楚地了解当前处理状态。
-
-### 进度条格式
-
-```
-[████████████░░░░░░░░░░░░░░░░░░] 40% | 2/5 | ⟳ components - 处理中
-```
-
-**组成部分**：
-- **进度条**：`[████████████░░░░░░░░░░░░░░░░░░]` 可视化进度
-- **百分比**：`40%` 完成百分比
-- **计数**：`2/5` 当前进度/总数
-- **状态图标**：
-  - `⟳` 处理中
-  - `✓` 成功
-  - `✗` 失败
-- **包名**：当前处理的包名称
-- **状态文本**：处理中/完成/失败
-
-### 使用示例
-
-#### 批量更新进度
-
-```bash
-mbump all patch
-```
-
-**输出示例**：
-```
-📦 开始批量更新 5 个包...
-
-[██████████████████████████████] 100% | ✓ cli - 完成
-[██████████████████████████████] 100% | ✓ components - 完成
-[██████████████████████████████] 100% | ✓ core - 完成
-[██████████████████████████████] 100% | ✓ theme - 完成
-[██████████████████████████████] 100% | ✓ utils - 完成
-
-✅ 版本更新完成
-```
-
-#### NPM 发布进度
-
-```bash
-mbump all patch --npm
-```
-
-**输出示例**：
-```
-📦 开始批量更新 5 个包...
-
-[██████████████████████████████] 100% | ✓ cli - 完成
-[██████████████████████████████] 100% | ✓ components - 完成
-...
-
-🚀 开始发布 5 个包到 NPM...
-
-[██████████████████████████████] 100% | ✓ @mznjs/cli - 完成
-[██████████████████████████████] 100% | ✓ @mznjs/components - 完成
-...
-
-✅ 版本更新完成
-```
-
-#### 部分失败情况
-
-```bash
-mbump all patch
-```
-
-**输出示例**：
-```
-📦 开始批量更新 5 个包...
-
-[██████████████████████████████] 100% | ✓ cli - 完成
-[██████████████████████████████] 100% | ✓ components - 完成
-[██████████████████████████████] 100% | ✗ core - 失败
-[██████████████████████████████] 100% | ✓ theme - 完成
-[██████████████████████████████] 100% | ✓ utils - 完成
-
-❌ 批量更新完成，但有 1 个包更新失败:
-   - core: Git conflict detected
-
-💡 提示: 可以单独重试失败的包，或检查错误信息后重新运行
-```
-
-### 特性说明
-
-1. **实时更新**：进度条在处理每个包时实时更新
-2. **状态反馈**：清晰显示每个包的处理状态（处理中/成功/失败）
-3. **视觉友好**：使用 Unicode 字符绘制美观的进度条
-4. **自动换行**：每个包处理完成后自动换行，保留历史记录
-5. **双阶段进度**：版本更新和 NPM 发布分别显示进度
-
-### 技术实现
-
-- **进度计算**：`(current / total) * 100` 计算百分比
-- **进度条渲染**：使用 `█` 和 `░` 字符填充
-- **光标控制**：使用 `\r` 回车符实现原地更新
-- **状态管理**：维护 processing/success/failed 三种状态
-
-### 注意事项
-
-- 进度条仅在批量更新模式下显示
-- 单包更新不使用进度条（因为只有一个包）
-- Dry-run 模式不显示进度条（直接显示预览后退出）
-- 进度条宽度固定为 30 个字符，适应各种终端宽度
-
-## ⚡ 性能优化（缓存机制）
-
-mbump 内置了智能缓存机制，显著提升批量操作的性能，特别是在大型 Monorepo 项目中。
-
-### 缓存策略
-
-#### 1. 配置缓存
-
-**功能**：避免重复读取和解析配置文件
-
-**实现**：
-```typescript
-// 自动缓存配置
-const config = await loadConfigAsync(rootDir)
-
-// 第二次调用直接使用缓存
-const config2 = await loadConfigAsync(rootDir) // 从缓存读取
-```
-
-**缓存键**：项目根目录的绝对路径
-
-**清除缓存**：
-```typescript
-import { clearConfigCache } from '@mznjs/mbump'
-
-// 清除指定项目的缓存
-clearConfigCache('/path/to/project')
-
-// 清除所有缓存
-clearConfigCache()
-```
-
-#### 2. 包信息缓存
-
-**功能**：预加载所有包信息到内存，避免重复读取 package.json 文件
-
-**实现**：
-```typescript
-const manager = new VersionManager({ rootDir })
-
-// 构造函数中自动预加载所有包信息
-// 后续调用 getPackageInfo() 直接从缓存读取
-```
-
-**缓存管理 API**：
-
-```typescript
-// 清除指定包的缓存
-manager.clearPackageCache('packages/components/package.json')
-
-// 清除所有包缓存
-manager.clearPackageCache()
-
-// 刷新指定包的缓存（重新从文件读取）
-const pkg = manager.refreshPackageCache('packages/components/package.json')
-
-// 获取缓存统计信息
-const stats = manager.getCacheStats()
-console.log(stats)
-// {
-//   size: 5,
-//   packages: [
-//     'packages/components/package.json',
-//     'packages/cli/package.json',
-//     ...
-//   ]
-// }
-```
-
-### 性能提升效果
-
-#### 场景对比
-
-**未使用缓存**：
-```bash
-# 批量更新 10 个包
-mbump all patch
-
-# 每个包需要：
-# - 读取 package.json (10 次)
-# - 解析 JSON (10 次)
-# - 读取配置文件 (1 次)
-# 总计：21 次文件 I/O 操作
-```
-
-**使用缓存后**：
-```bash
-# 批量更新 10 个包
-mbump all patch
-
-# 优化后：
-# - 预加载所有 package.json (10 次，但并行执行)
-# - 后续操作全部从内存读取 (0 次 I/O)
-# - 配置文件缓存 (1 次)
-# 总计：11 次文件 I/O 操作，减少约 50%
-```
-
-#### 实际测试数据
-
-| 项目规模 | 包数量 | 优化前耗时 | 优化后耗时 | 提升 |
-|---------|--------|-----------|-----------|------|
-| 小型项目 | 3 个包 | 1.2s | 0.8s | 33% |
-| 中型项目 | 10 个包 | 3.5s | 1.8s | 49% |
-| 大型项目 | 50 个包 | 15.2s | 6.5s | 57% |
-
-### 缓存失效场景
-
-缓存在以下情况下会自动失效：
-
-1. **文件修改**：当 `savePackageInfo()` 被调用时，会自动更新缓存
-2. **手动清除**：调用 `clearPackageCache()` 或 `clearConfigCache()`
-3. **进程重启**：缓存存储在内存中，进程退出后自动清除
-
-### 最佳实践
-
-#### 1. 批量操作前预加载
-
-```typescript
-// VersionManager 构造函数已自动预加载
-const manager = new VersionManager({ rootDir })
-
-// 无需额外操作，直接使用即可
-await manager.updateVersion('all', 'patch')
-```
-
-#### 2. 长时间运行的进程
-
-```typescript
-// 如果文件可能被外部修改，定期刷新缓存
-setInterval(() => {
-  manager.clearPackageCache()
-}, 60000) // 每分钟清除一次缓存
-```
-
-#### 3. CI/CD 环境
-
-```typescript
-// CI/CD 环境中可以禁用缓存（每次都是全新环境）
-const manager = new VersionManager({
-  rootDir,
-})
-```
-
-#### 4. 调试模式
-
-```bash
-# 启用调试模式查看缓存使用情况
-DEBUG=true mbump all patch
-
-# 输出示例：
-# [DEBUG] 已预加载 5 个包的信息到缓存
-# [DEBUG] 使用缓存的配置
-# [DEBUG] 已缓存配置: /path/to/project
-```
-
-### 技术实现细节
-
-#### 配置缓存
-
-```typescript
-// 全局 Map 存储配置
-const configCache = new Map<string, Config>()
-
-// 缓存键：项目根目录的绝对路径
-const cacheKey = resolve(rootDir)
-
-// 检查缓存
-if (configCache.has(cacheKey)) {
-  return configCache.get(cacheKey)!
-}
-
-// 设置缓存
-configCache.set(cacheKey, config)
-```
-
-#### 包信息缓存
-
-```typescript
-// 实例级 Map 存储包信息
-private packageCache: Map<string, PackageInfo> = new Map()
-
-// 预加载
-private _preloadPackageCache(): void {
-  for (const pkgPath of Object.values(this.packagePaths)) {
-    this.getPackageInfo(pkgPath) // 触发缓存写入
-  }
-}
-
-// 读取（带缓存）
-private getPackageInfo(pkgPath: string): PackageInfo {
-  const cached = this.packageCache.get(pkgPath)
-  if (cached) {
-    return cached // 缓存命中
-  }
-
-  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'))
-  this.packageCache.set(pkgPath, pkg) // 写入缓存
-  return pkg
-}
-```
-
-### 注意事项
-
-1. **内存占用**：缓存会占用一定内存，但对于大多数项目来说影响微乎其微
-2. **一致性**：如果外部工具修改了 package.json，需要手动清除缓存
-3. **线程安全**：当前实现不是线程安全的，建议在单线程环境中使用
-4. **缓存大小**：没有设置最大缓存限制，理论上可以缓存无限数量的包
-
-### 未来优化方向
-
-- [ ] 添加 LRU 缓存策略，限制最大缓存数量
-- [ ] 支持文件系统监听，自动检测文件变化并更新缓存
-- [ ] 添加缓存持久化选项，跨进程共享缓存
-- [ ] 提供缓存命中率统计，帮助性能分析
-
-## 🧪 测试
-
-mbump 拥有完善的测试体系，包括单元测试和集成测试，确保代码质量和功能稳定性。
-
-### 测试覆盖范围
-
-#### 单元测试 (Unit Tests)
-- ✅ **版本计算**：验证 semver 版本递增逻辑
-- ✅ **安全检查**：验证路径遍历防护、命令注入防护
-- ✅ **工具函数**：验证各种辅助函数的正确性
-
-#### 集成测试 (Integration Tests)
-- ✅ **单包版本更新**：验证单个包的版本号更新流程
-- ✅ **批量版本更新**：验证多个包同时更新的场景
-- ✅ **CHANGELOG 生成**：验证 CHANGELOG.md 文件的创建和内容
-- ✅ **Git Tag 管理**：验证 Git 标签的创建、前缀配置等
-- ✅ **Dry-run 模式**：验证试运行模式不修改文件
-- ✅ **缓存机制**：验证配置缓存和包信息缓存
-- ✅ **错误处理**：验证无效包名、版本冲突等异常场景
-
-### 运行测试
-
-```bash
-# 运行所有测试
-pnpm test
-
-# 运行特定测试文件
-pnpm test tests/integration.test.ts
-
-# 监听模式（开发时使用）
-pnpm test:watch
-```
-
-### 测试统计
-
-| 测试类型 | 测试文件数 | 测试用例数 | 通过率 |
-|---------|-----------|-----------|--------|
-| 单元测试 | 2 | 12 | 100% ✅ |
-| 集成测试 | 1 | 16 | 100% ✅ |
-| **总计** | **3** | **28** | **100%** ✅ |
-
-### 集成测试特点
-
-#### 1. 隔离环境
-每个测试在临时目录中执行，避免污染真实项目：
-```typescript
-beforeEach(() => {
-  tempDir = join(os.tmpdir(), `mbump-test-${Date.now()}`)
-  mkdirSync(tempDir, { recursive: true })
-})
-
-afterEach(() => {
-  rmSync(tempDir, { recursive: true, force: true })
-})
-```
-
-#### 2. 完整工作流
-测试完整的版本更新流程：
-- 创建临时 Git 仓库
-- 创建 package.json 和配置文件
-- 执行版本更新
-- 验证结果（版本号、Git Tag、CHANGELOG）
-- 清理临时文件
-
-#### 3. 真实场景
-使用真实的 Git 命令和文件系统操作：
-```typescript
-execSync('git init', { cwd: tempDir })
-execSync('git config user.email "test@example.com"', { cwd: tempDir })
-execSync('git add . && git commit -m "feat: feature"', { cwd: tempDir })
-const tags = execSync('git tag', { cwd: tempDir, encoding: 'utf8' })
-```
-
-### 持续集成
-
-测试已集成到 CI/CD 流程中，每次提交都会自动运行：
-- ✅ 代码构建
-- ✅ 类型检查
-- ✅ ESLint 检查
-- ✅ 单元测试
-- ✅ 集成测试
-
-## 📊 版本类型
-
-### 标准版本类型
-- **major**: 主版本号（不兼容的 API 修改）
-- **minor**: 次版本号（向下兼容的功能性新增）
-- **patch**: 修订号（向下兼容的问题修正）
-
-### 预发布版本类型
-- **pre-major**: 预发布主版本
-- **pre-minor**: 预发布次版本
-- **pre-patch**: 预发布修订版本
-- **prerelease**: 预发布版本
-- **next**: 下一个预发布版本
-
-### 特殊版本类型
-- **conventional**: 根据 commits 自动生成版本类型
-- **as-is**: 保持当前版本不变（仅更新 CHANGELOG）
-
-## 🎯 使用场景
-
-### 场景 1: 日常开发
-
-```bash
-# 修复 bug 后发布补丁版本
-mbump patch
-
-# 添加新功能后发布小版本
-mbump minor
-
-# 重大重构后发布主版本
-mbump major
-```
-
-### 场景 2: 预发布测试
-
-```bash
-# 创建 beta 版本进行测试
-mbump pre-minor
-
-# 创建 rc 版本（需要自定义）
-mbump custom
-# 输入: 1.0.0-rc.1
-```
-
-### 场景 3: Monorepo 批量更新
-
-```bash
-# 交互式选择每个包的版本
-mbump all
-
-# 统一升级所有包的补丁版本
-mbump all patch
-
-# 试运行查看将要执行的变更
-mbump all minor --dry-run
-```
-
-### 场景 4: 路径模式（快速更新独立子包）
-
-```bash
-# 快速更新指定目录下的 package.json
-mbump ./packages/my-pkg
-
-# 指定版本类型
-mbump ./packages/my-pkg minor
-
-# 更新上级目录的项目
-mbump ../other-project
-
-# 试运行模式
-mbump ./packages/my-pkg --dry-run
-```
-
-### 场景 5: CI/CD 自动化
-
-```bash
-# 在 CI 环境中自动发布
-mbump components patch --npm --no-commit
-
-# 跳过未提交检查
-mbump core minor --allow-uncommitted
-```
-
-## 🔍 调试与诊断
-
-### 查看详细日志
-
-```bash
-mbump components patch --verbose
-```
-
-### 查看当前配置
-
-```bash
-mbump --show-config
-```
-
-输出示例：
-```
-📋 当前加载的配置:
-
-  配置文件: .mbump.config.mjs
-
-📦 包路径:
-  default: /path/to/project/package.json
-  components: /path/to/project/packages/components/package.json
-  cli: /path/to/project/packages/cli/package.json
-
-⚙️ 默认选项:
-  releaseType: patch
-  dryRun: false
-  verbose: false
-  allowUncommitted: false
-  npm: false
-
-🔧 Git 选项:
-  commit: true
-  push: true
-  tag: true
-  changelog: true
-
-🚀 发布选项:
-  command: pnpm publish --access public --no-git-checks
-  skipChecks: true
-```
-
-### 试运行模式
-
-```bash
-# 预览将要执行的操作，不实际修改文件
-mbump components minor --dry-run
-```
-
-## 🏷️ Git Tag 策略详解
-
-mbump 采用智能的 Git Tag 策略，根据包的类型自动选择合适的命名格式：
-
-### 主项目包 (default / root package)
-
-主项目包通常对应根目录的 `package.json`，配置为 `"default": "package.json"`。
-
-```bash
-mbump default patch
-# 或简写为
-mbump patch  # 如果默认包名为 default
-```
-
-**Tag 格式**：`{tagPrefix}{version}`
-- 默认前缀：`v`
-- 示例：`v1.0.1`, `v2.3.0`, `release-3.0.0`
-
-**行为**：
-- ✅ 自动创建带注释的 Git Tag
-- ✅ 推送到远程仓库（如果 `git.push = true`）
-- ✅ 使用配置的 `tagPrefix`（可通过 `git.tagPrefix` 自定义）
-
-**自定义前缀示例**：
-```json
-{
-  "git": {
-    "tagPrefix": "release-"
-  }
-}
-```
-```bash
-mbump default minor
-# → 创建 Tag: release-1.1.0
-```
-
----
-
-### 子包 (所有非主项目包)
-
-子包包括所有在 `packagePaths` 中配置的非主项目包。
-
-#### 单独更新子包
-
-```bash
-mbump components patch
-mbump cli minor
-```
-
-**Tag 格式**：`{package-name}@{version}`
-- **不使用** `tagPrefix` 配置
-- 直接使用 `package.json` 中的 `name` 字段
-- 为更新的包创建独立标签
-
-**示例**：
-```bash
-mbump components patch
-# 假设 components/package.json 中 "name": "@my-org/components"
-# → 创建 Tag: @my-org/components@1.0.1
-
-mbump cli minor
-# 假设 cli/package.json 中 "name": "@my-org/cli"
-# → 创建 Tag: @my-org/cli@2.3.0
-```
-
----
-
-#### Monorepo 批量更新
-
-```bash
-mbump all
-```
-
-**Tag 格式**：`{package-name}@{version}`
-- 不使用 `tagPrefix` 配置
-- 为每个更新的**子包**创建独立标签
-- **主项目包**仍然使用 `{tagPrefix}{version}` 格式
-
-**示例**：
-假设有以下包被更新：
-- `default` (主项目): 1.0.0 → 1.0.1
-- `components`: 1.0.0 → 1.0.1
-- `cli`: 2.2.0 → 2.3.0
-- `core`: 0.5.1 → 0.5.2
-
-将创建以下 Tags：
-```
-v1.0.1                    # 主项目包，使用 tagPrefix
-components@1.0.1          # 子包
-cli@2.3.0                 # 子包
-core@0.5.2                # 子包
-```
-
-**优势**：
-- ✅ 清晰区分主项目和子包的版本历史
-- ✅ 主项目保持简洁的 `v1.0.1` 格式
-- ✅ 子包使用明确的 `{包名}@{版本号}` 格式
-- ✅ 便于单独回滚某个包到特定版本
-- ✅ 符合 Monorepo 最佳实践（类似 pnpm、lerna）
-- ✅ 支持独立的 CI/CD 流程
-
----
-
-### Git 操作示例
-
-```bash
-# 查看所有 tags
-git tag -l
-
-# 查看主项目的 tags
-git tag -l "v*"
-
-# 查看特定子包的 tags
-git tag -l "components@*"
-
-# 查看所有子包的 tags
-git tag -l "*@*"
-
-# 检出主项目的特定版本
-git checkout v1.0.1
-
-# 检出子包的特定版本
-git checkout components@1.0.1
-
-# 推送所有 tags
-git push --tags
-```
-
----
-
-### 禁用 Tag 创建
-
-如果不需要自动创建 Tag，可以在配置中禁用：
-
-```json
-{
-  "git": {
-    "tag": false
-  }
-}
-```
-
-这将禁用所有包（包括主项目和子包）的自动 Tag 创建。
-
----
-
-### 注意事项
-
-1. **主项目包识别**：系统通过以下方式判断是否为主项目包：
-   - 包名为 `default`
-   - 或者包路径为 `package.json`（根目录）
-
-2. **子包命名**：子包的 Tag 名称直接来自其 `package.json` 中的 `name` 字段，可能包含 scope（如 `@my-org/components`）
-
-3. **Tag 唯一性**：Git 要求所有 Tag 名称唯一，因此不同包即使版本号相同，也会因为包名不同而产生不同的 Tag
-
-4. **批量更新行为**：使用 `mbump all` 时，所有更改会在一次 commit 中提交，然后为每个包创建独立的 Tag
-
-## ⚠️ 注意事项
-
-1. **Git 要求**: 确保项目在 Git 仓库中，且已配置用户信息
-2. **未提交更改**: 默认情况下，存在未提交更改时会提示确认
-3. **零配置支持**: 无需配置文件即可使用，系统自动使用默认配置 `{ default: 'package.json' }`
-4. **路径模式**: 支持 `mbump ./path` 模式，自动查找指定目录下的 `package.json`，适合快速更新独立子包
-5. **Node 版本**: 需要 Node.js >= 18.0.0
-6. **包管理器**: 默认使用 pnpm 发布，可在配置中修改为 npm 或 yarn
-7. **路径解析**: 相对路径相对于配置文件所在目录解析，而非当前工作目录
-8. **默认包保留**: `default` 键始终指向根目录的 `package.json`，即使配置了其他包路径
-9. **全局安装**: 支持 `npm install -g @mznjs/mbump`，所有依赖已移至 `dependencies` 确保全局安装后可用
-10. **配置文件格式**: 支持 `.ts`/`.mjs`/`.js`/`.cjs`/`.json`/`.yaml`/`.yml`/`.toml` 多种格式
-11. **配置文件优先级**: 按以下顺序查找：`.ts` → `.mjs` → `.js` → `.cjs` → `.json` → `.yaml` → `.yml` → `.toml` → `package.json`
-
-## 📚 更多资源
-
-- [配置示例](./config-examples/) - 各种格式的配置文件示例
-- [CHANGELOG](./CHANGELOG.md) - 版本更新历史
-
-## 🤝 贡献指南
-
-欢迎为 mbump 贡献代码！请遵循以下步骤：
-
-1. Fork 本仓库
-2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
-3. 提交更改 (`git commit -m 'Add some amazing feature'`)
-4. 推送到分支 (`git push origin feature/amazing-feature`)
-5. 开启 Pull Request
-
-### 开发要求
 - Node.js >= 18.0.0
 - 所有测试必须通过
 - 代码必须符合 ESLint 规范
-- 新功能必须包含测试用例
 
 ## 📄 许可证
 
@@ -1688,7 +501,7 @@ MIT License
 
 ## 👥 作者
 
-- **mznjs Team** - [GitHub](https://github.com/mznjs)
+**mznjs Team** - [GitHub](https://github.com/mznjs)
 
 ## 🙏 致谢
 
@@ -1700,4 +513,4 @@ MIT License
 
 ---
 
-**mbump** - 让版本管理更简单！🚀
+**mbump** - 让版本管理更简单！🚀