feat: enhance CLI release command with additional options and update documentation

Author: haoziqaq

docs/cli/release.md

@@ -6,8 +6,25 @@ Interactive package release.
 
 ```shell
 rt release
+rt release --skip-npm-publish
+rt release --npm-tag beta
+rt release --skip-changelog --skip-git-tag
+rt release --check-remote-version --remote upstream
 ```
 
+### CLI Arguments
+
+All options can be passed as command-line arguments. CLI arguments take priority over config file options.
+
+| Argument | Description |
+| --- | --- |
+| `-t, --npm-tag <tag>` | npm dist-tag for publishing, e.g. `beta`, `next` |
+| `-r, --remote <remote>` | Git remote name for pushing |
+| `--skip-npm-publish` | Skip npm publish |
+| `--skip-changelog` | Skip changelog generation |
+| `--skip-git-tag` | Skip git tag |
+| `-c, --check-remote-version` | Skip publish if the current version already exists on npm |
+
 ### Config
 
 ```ts

docs/zh/cli/release.md

@@ -6,8 +6,25 @@
 
 ```shell
 rt release
+rt release --skip-npm-publish
+rt release --npm-tag beta
+rt release --skip-changelog --skip-git-tag
+rt release --check-remote-version --remote upstream
 ```
 
+### 命令行参数
+
+所有选项均可通过命令行参数传递，命令行参数的优先级高于配置文件。
+
+| 参数 | 描述 |
+| --- | --- |
+| `-t, --npm-tag <tag>` | npm 发布的 dist-tag，如 `beta`、`next` |
+| `-r, --remote <remote>` | git push 使用的 remote 名称 |
+| `--skip-npm-publish` | 跳过 npm 发布 |
+| `--skip-changelog` | 跳过 changelog 生成 |
+| `--skip-git-tag` | 跳过 git tag |
+| `-c, --check-remote-version` | 发布前检查 npm 远程版本，若版本已存在则跳过发布 |
+
 ### 配置
 
 ```ts

skills/rattail/references/cli/release.md

@@ -14,9 +14,24 @@ Release all packages, generate changelogs, tag, and optionally publish to npm. P
 
 ```bash
 rt release
+rt release --skip-npm-publish
+rt release --npm-tag beta
+rt release --skip-changelog --skip-git-tag
+rt release --check-remote-version --remote upstream
 ```
 
-This replaces the standalone `vr release` CLI. The command reads configuration from `rattail.release` in `vite.config.ts`.
+This replaces the standalone `vr release` CLI. The command reads configuration from `rattail.release` in `vite.config.ts`. All config options (except `task`) can also be passed as CLI arguments. CLI arguments take priority over config.
+
+## CLI Arguments
+
+| Argument                     | Description                                               |
+| ---------------------------- | --------------------------------------------------------- |
+| `-t, --npm-tag <tag>`        | npm dist-tag for publishing, e.g. `beta`, `next`          |
+| `-r, --remote <remote>`      | Git remote name for pushing                               |
+| `--skip-npm-publish`         | Skip npm publish                                          |
+| `--skip-changelog`           | Skip changelog generation                                 |
+| `--skip-git-tag`             | Skip git tag                                              |
+| `-c, --check-remote-version` | Skip publish if the current version already exists on npm |
 
 ## Configuration
 
@@ -53,6 +68,12 @@ export default defineConfig({
 | `checkRemoteVersion` | `boolean`                                   | Abort if npm already has same version       |
 | `task`               | `(newVersion, oldVersion) => Promise<void>` | Hook to run after version bump (e.g. build) |
 
+## Priority
+
+CLI arguments > config file (`rattail.release` in `vite.config.ts`) > defaults.
+
+The merge logic in `src/cli/bin.ts` spreads config first, then overlays any CLI arguments on top.
+
 ## Programmatic
 
 ```ts

src/cli/bin.ts

@@ -37,11 +37,36 @@ program
 program
   .command('release')
   .description('Release all packages and generate changelogs')
-  .action(async () => {
-    const { release } = await import('./release')
-
-    return release()
-  })
+  .option('-t, --npmTag <tag>', 'npm dist-tag (e.g. beta, next)')
+  .option('-r, --remote <remote>', 'Git remote name for pushing')
+  .option('--skip-npm-publish', 'Skip npm publish')
+  .option('--skip-changelog', 'Skip changelog generation')
+  .option('--skip-git-tag', 'Skip git tag')
+  .option('-c, --check-remote-version', 'Skip publish if the current version already exists on npm')
+  .action(
+    async (options: {
+      npmTag?: string
+      remote?: string
+      skipNpmPublish?: boolean
+      skipChangelog?: boolean
+      skipGitTag?: boolean
+      checkRemoteVersion?: boolean
+    }) => {
+      const { getConfig } = await import('./config')
+      const { release } = await import('./release')
+      const config = (await getConfig()).release ?? {}
+
+      return release({
+        ...config,
+        ...(options.npmTag != null ? { npmTag: options.npmTag } : {}),
+        ...(options.remote != null ? { remote: options.remote } : {}),
+        ...(options.skipNpmPublish ? { skipNpmPublish: true } : {}),
+        ...(options.skipChangelog ? { skipChangelog: true } : {}),
+        ...(options.skipGitTag ? { skipGitTag: true } : {}),
+        ...(options.checkRemoteVersion ? { checkRemoteVersion: true } : {}),
+      })
+    },
+  )
 
 program
   .command('publish')

src/vite-plus/index.ts

@@ -1,5 +1,4 @@
-import type { UserConfig, ConfigEnv } from '@voidzero-dev/vite-plus-core'
-import { defineConfig as defineVitePlusConfig } from 'vite-plus'
+import { defineConfig as defineVitePlusConfig, type UserConfig, type ConfigEnv } from 'vite-plus'
 import type { HookConfig, RattailConfig } from '../cli/config'
 
 export type {