refactor: 统一版本号管理，消除硬编码

项目版本(pom.xml revision)和parser版本(parserVersion)统一为单一来源，前端构建时自动同步，发版只需改根pom.xml的两个属性。
2026-06-10 23:47:29 +00:00 · 2026-05-29 10:57:49 +08:00
parent a4e8585e2c
commit 0e14c9a925
10 changed files with 54 additions and 16 deletions
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 # 一款网盘分享链接云解析快速下载服务  
 QQ交流群：1017480890
 <p align="center">
-<a href="https://github.com/qaiu/netdisk-fast-download/actions/workflows/maven.yml"><img src="https://img.shields.io/github/actions/workflow/status/qaiu/netdisk-fast-download/maven.yml?branch=v0.1.9b8a&style=flat"></a>
+<a href="https://github.com/qaiu/netdisk-fast-download/actions/workflows/maven.yml"><img src="https://img.shields.io/github/actions/workflow/status/qaiu/netdisk-fast-download/maven.yml?branch=main&style=flat"></a>
 <a href="https://www.oracle.com/cn/java/technologies/downloads"><img src="https://img.shields.io/badge/jdk-%3E%3D17-blue"></a>
-<a href="https://vertx-china.github.io"><img src="https://img.shields.io/badge/vert.x-4.5.24-blue?style=flat"></a>
+<a href="https://vertx-china.github.io"><img src="https://img.shields.io/badge/vert.x-4.5.27-blue?style=flat"></a>
 <a href="https://raw.githubusercontent.com/qaiu/netdisk-fast-download/master/LICENSE"><img src="https://img.shields.io/github/license/qaiu/netdisk-fast-download?style=flat"></a>
 <a href="https://github.com/qaiu/netdisk-fast-download/releases/"><img src="https://img.shields.io/github/v/release/qaiu/netdisk-fast-download?style=flat"></a>
 <a href="https://atomgit.com/QAIU/netdisk-fast-download"><img src="https://atomgit.com/QAIU/netdisk-fast-download/star/badge.svg" alt="AtomGit"></a>
@@ -419,7 +419,7 @@ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtow
 > 注意: netdisk-fast-download.service中的ExecStart的路径改为实际路径
 ```shell
 cd ~
-wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v0.1.9b7/netdisk-fast-download-bin.zip
+wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v3.0.2/netdisk-fast-download-bin.zip
 unzip netdisk-fast-download-bin.zip
 cd netdisk-fast-download
 bash service-install.sh
--- a/parser/README.md
+++ b/parser/README.md
@@ -4,26 +4,26 @@ NFD 解析器模块：聚合各类网盘/分享页解析，统一输出文件列

 - 语言：Java 17
 - 构建：Maven
- 模块版本：10.1.17
+- 模块版本：10.2.5

 ## 依赖（Maven Central）
 ```xml
 <dependency>
  <groupId>cn.qaiu</groupId>
  <artifactId>parser</artifactId>
-  <version>10.1.17</version>
+  <version>10.2.5</version>
 </dependency>
 ```
 - Gradle Groovy DSL：
 ```groovy
 dependencies {
-  implementation 'cn.qaiu:parser:10.1.17'
+  implementation 'cn.qaiu:parser:10.2.5'
 }
 ```
 - Gradle Kotlin DSL：
 ```kotlin
 dependencies {
-  implementation("cn.qaiu:parser:10.1.17")
+  implementation("cn.qaiu:parser:10.2.5")
 }
 ```

--- a/parser/doc/CUSTOM_PARSER_GUIDE.md
+++ b/parser/doc/CUSTOM_PARSER_GUIDE.md
@@ -28,7 +28,7 @@
 <dependency>
    <groupId>cn.qaiu</groupId>
    <artifactId>parser</artifactId>
-    <version>10.1.17</version>
+    <version>10.2.5</version>
 </dependency>
 ```

--- a/parser/doc/CUSTOM_PARSER_QUICKSTART.md
+++ b/parser/doc/CUSTOM_PARSER_QUICKSTART.md
@@ -11,7 +11,7 @@
 <dependency>
    <groupId>cn.qaiu</groupId>
    <artifactId>parser</artifactId>
-    <version>10.1.17</version>
+    <version>10.2.5</version>
 </dependency>
 ```

--- a/parser/pom.xml
+++ b/parser/pom.xml
@@ -12,7 +12,7 @@

    <groupId>cn.qaiu</groupId>
    <artifactId>parser</artifactId>
-    <version>10.2.5</version>
+    <version>${parserVersion}</version>
    <packaging>jar</packaging>

    <name>cn.qaiu:parser</name>
@@ -52,7 +52,6 @@
    </distributionManagement>

    <properties>
-        <revision>0.2.1</revision>
        <java.version>17</java.version>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
--- a/pom.xml
+++ b/pom.xml
@@ -32,6 +32,7 @@
        <slf4j.version>2.0.16</slf4j.version>
        <commons-lang3.version>3.18.0</commons-lang3.version>
        <commons-beanutils2.version>2.0.0</commons-beanutils2.version>
+        <parserVersion>10.2.5</parserVersion>
        <jackson.version>2.18.6</jackson.version>
        <!-- Logback 最新稳定版 -->
        <logback.version>1.5.32</logback.version>
@@ -74,7 +75,7 @@
            <dependency>
                <groupId>cn.qaiu</groupId>
                <artifactId>parser</artifactId>
-                <version>10.2.5</version>
+                <version>${parserVersion}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
--- a/web-front/package.json
+++ b/web-front/package.json
@@ -5,8 +5,8 @@
  "scripts": {
    "serve": "vue-cli-service serve",
    "dev": "vue-cli-service serve",
-    "build": "vue-cli-service build && node scripts/compress-vs.js",
-    "build:no-compress": "vue-cli-service build",
+    "build": "node scripts/sync-version.js && vue-cli-service build && node scripts/compress-vs.js",
+    "build:no-compress": "node scripts/sync-version.js && vue-cli-service build",
    "lint": "vue-cli-service lint"
  },
  "dependencies": {
--- a/web-front/scripts/sync-version.js
+++ b/web-front/scripts/sync-version.js
@@ -0,0 +1,23 @@
+const fs = require('fs');
+const path = require('path');
+
+const pomPath = path.resolve(__dirname, '../../pom.xml');
+const pkgPath = path.resolve(__dirname, '../package.json');
+
+const pomContent = fs.readFileSync(pomPath, 'utf-8');
+const match = pomContent.match(/<revision>([^<]+)<\/revision>/);
+if (!match) {
+  console.error('sync-version: <revision> not found in root pom.xml');
+  process.exit(1);
+}
+
+const version = match[1];
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+if (pkg.version === version) {
+  console.log(`sync-version: package.json already at ${version}`);
+  process.exit(0);
+}
+
+pkg.version = version;
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+console.log(`sync-version: package.json ${pkg.version} -> ${version}`);
--- a/web-front/src/views/Home.vue
+++ b/web-front/src/views/Home.vue
@@ -73,7 +73,7 @@
        </div>
        <!-- 项目简介移到卡片内 -->
        <div class="project-intro">
-          <div class="intro-title">NFD网盘直链解析0.3.0</div>
+          <div class="intro-title">NFD网盘直链解析 {{ projectVersion }}</div>
          <div class="intro-desc">
            <div>支持网盘：蓝奏云、蓝奏云优享、小飞机盘、123云盘、iCloud、移动云空间、联想乐云、QQ闪传等 <el-link style="color:#606cf5" :href="githubRepoUrl + '?tab=readme-ov-file#%E7%BD%91%E7%9B%98%E6%94%AF%E6%8C%81%E6%83%85%E5%86%B5'" target="_blank"> &gt;&gt; </el-link></div>
            <div>文件夹解析支持：蓝奏云、蓝奏云优享、小飞机盘、123云盘</div>
@@ -717,6 +717,9 @@ export default {
    githubRepoUrl() {
      return process.env.VUE_APP_GITHUB_REPO_URL
    },
+    projectVersion() {
+      return process.env.VUE_APP_VERSION || '0.0.0'
+    },
    // 检查是否配置了认证信息（针对当前链接的网盘类型）
    hasAuthConfig() {
      const panType = this.getCurrentPanType()
--- a/web-front/vue.config.js
+++ b/web-front/vue.config.js
@@ -16,6 +16,17 @@ function getGitHubRepoUrl() {
  } catch (e) {}
  return 'https://github.com/qaiu/netdisk-fast-download';
 }
+// 从根 pom.xml 读取项目版本号（单一版本来源）
+function getProjectVersion() {
+  try {
+    const pomContent = require('fs').readFileSync(path.resolve(__dirname, '../pom.xml'), 'utf-8');
+    const match = pomContent.match(/<revision>([^<]+)<\/revision>/);
+    if (match) return match[1];
+  } catch (e) {}
+  return require('./package.json').version;
+}
+const PROJECT_VERSION = getProjectVersion();
+
 const GITHUB_REPO_URL = getGitHubRepoUrl();

 const CompressionPlugin = require('compression-webpack-plugin');
@@ -69,7 +80,8 @@ module.exports = {
    },
    plugins: [
      new webpack.DefinePlugin({
-        'process.env.VUE_APP_GITHUB_REPO_URL': JSON.stringify(GITHUB_REPO_URL)
+        'process.env.VUE_APP_GITHUB_REPO_URL': JSON.stringify(GITHUB_REPO_URL),
+        'process.env.VUE_APP_VERSION': JSON.stringify(PROJECT_VERSION)
      }),
      new MonacoEditorPlugin({
        languages: ['javascript', 'typescript', 'json'],