docs(docs): ...

Author: hylexus

build.gradle.kts

@@ -470,6 +470,73 @@ configure(subprojects) {
 }
 // endregion Maven
 
+// region updateVersion
+/**
+ * 以 gradle.properties 中的 projectVersion 为单一来源，同步以下文件：
+ *   1. package.json 的 "version" 字段
+ *   2. docs/src 中 Maven/Gradle 依赖版本号（仅含 io.github.hylexus.xtream 坐标的）
+ * 跳过 release-notes/ 目录（历史版本标题保留不动）。
+ */
+val semverRegex = Regex("""\d+\.\d+\.\d+(-[a-zA-Z]\w*(\.\w+)*)?""")
+
+tasks.register("updateVersion") {
+    group = "release"
+    description = "同步 projectVersion 到 package.json 和文档中的依赖版本号（不含 release-notes）"
+
+    doLast {
+        val newVersion = xtreamConfig.projectVersion.trim()
+        println("=== updateVersion: $newVersion ===")
+
+        // 1. package.json —— 更新 "version" 字段
+        fileTree(projectDir) {
+            include("**/package.json")
+            exclude("**/node_modules/**")
+        }.forEach { pkg ->
+            val text = pkg.readText()
+            val updated = text.replace(
+                Regex(""""version":\s*"\d+\.\d+\.\d+(-[a-zA-Z]\w*(\.\w+)*)?""" + "\""),
+                "\"version\": \"$newVersion\""
+            )
+            if (updated != text) {
+                pkg.writeText(updated)
+                println("  [package.json] ${relativePath(pkg)}")
+            }
+        }
+
+        // 2. docs 中的版本号 —— 仅替换项目自身 Maven/Gradle 依赖版本
+        fileTree("$projectDir/docs/src") {
+            include("**/*.md")
+            exclude("**/release-notes/**", "**/node_modules/**")
+        }.forEach { doc ->
+            val text = doc.readText()
+            var changed = false
+
+            // Maven: <version>X.Y.Z</version> 仅当前面有项目 groupId 时替换
+            val afterMaven = text.replace(
+                Regex(
+                    """(io\.github\.hylexus\.xtream[\w-]*[\s\S]{0,300}?<version>)$semverRegex(</version>)""",
+                    setOf(RegexOption.DOT_MATCHES_ALL)
+                )
+            ) { "${it.groupValues[1]}$newVersion${it.groupValues[4]}" }
+            if (afterMaven != text) changed = true
+
+            // Gradle: io.github.hylexus.xtream:artifactId:X.Y.Z
+            val afterGradle = afterMaven.replace(
+                Regex("(io\\.github\\.hylexus\\.xtream:[\\w-]+:)$semverRegex")
+            ) { "${it.groupValues[1]}$newVersion" }
+            if (afterGradle != afterMaven) changed = true
+
+            if (changed) {
+                doc.writeText(afterGradle)
+                println("  [docs       ] ${relativePath(doc)}")
+            }
+        }
+
+        println("=== updateVersion done ===")
+    }
+}
+// endregion updateVersion
+
 fun isJavaProject(project: Project): Boolean {
     return project != rootProject
             && (

debug/jt/jt-1078-server-spring-boot-starter-debug-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-project",
   "private": true,
-  "version": "0.5.0",
+  "version": "0.6.0",
   "packageManager": "pnpm@10.33.0",
   "type": "module",
   "scripts": {

debug/jt/jt-808-server-spring-boot-starter-debug-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-project",
   "private": true,
-  "version": "0.5.0",
+  "version": "0.6.0",
   "packageManager": "pnpm@10.33.0",
   "type": "module",
   "scripts": {

docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xtream-codec",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "docs for xtream-codec",
   "license": "Apache License 2.0",
   "type": "module",

docs/src/ext/jt/jt808/dashboard/quick-start.md

@@ -30,15 +30,15 @@ article: false
 <dependency>
     <groupId>io.github.hylexus.xtream</groupId>
     <artifactId>jt-808-server-dashboard-spring-boot-starter-reactive</artifactId>
-    <version>0.5.0</version>
+    <version>0.6.0</version>
 </dependency>
 ```
 
 @tab Gradle
 
 ```groovy
 
-api("io.github.hylexus.xtream:jt-808-server-dashboard-spring-boot-starter-reactive:0.5.0")
+api("io.github.hylexus.xtream:jt-808-server-dashboard-spring-boot-starter-reactive:0.6.0")
 ```
 
 :::

docs/src/ext/jt/jt808/quick-start/quick-start.md

@@ -36,15 +36,15 @@ tag:
 <dependency>
     <groupId>io.github.hylexus.xtream</groupId>
     <artifactId>jt-808-server-spring-boot-starter-reactive</artifactId>
-    <version>0.5.0</version>
+    <version>0.6.0</version>
 </dependency>
 ```
 
 @tab Gradle
 
 ```groovy
 
-api("io.github.hylexus.xtream:jt-808-server-spring-boot-starter-reactive:0.5.0")
+api("io.github.hylexus.xtream:jt-808-server-spring-boot-starter-reactive:0.6.0")
 ```
 
 :::

docs/src/guide/core/quick-start/quick-start.md

@@ -22,15 +22,15 @@ tag:
 <dependency>
     <groupId>io.github.hylexus.xtream</groupId>
     <artifactId>xtream-codec-core</artifactId>
-    <version>0.5.0</version>
+    <version>0.6.0</version>
 </dependency>
 ```
 
 @tab Gradle
 
 ```groovy
 
-api("io.github.hylexus.xtream:xtream-codec-core:0.5.0")
+api("io.github.hylexus.xtream:xtream-codec-core:0.6.0")
 ```
 
 :::

docs/src/release-notes/latest.md

@@ -5,6 +5,22 @@ article: false
 
 # Latest
 
+## 0.6.0(2026-06-02)
+
+### 📔 Documentation
+
+- 新增文档 [@DerivedField](https://iotplanet.top/xtream-codec/guide/core/annotation-driven/derived-field.html)
+- 新增文档 [多版本支持](https://iotplanet.top/xtream-codec/guide/core/annotation-driven/multi-version.html)
+
+### ⭐ New Features
+
+- 新增 [@DerivedField](https://iotplanet.top/xtream-codec/guide/core/annotation-driven/derived-field.html) 注解
+
+### ❤️ Contributors
+
+- [opencode AI](https://github.com/anomalyco/opencode)
+- [@hylexus](https://github.com/hylexus)
+
 ## 0.5.0(2026-05-30)
 
 ### 📔 Documentation

ext/jt/jt-1078-server-dashboard-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jt-1078-server-dashboard-ui",
   "private": true,
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

ext/jt/jt-808-server-dashboard-ui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vite-template",
   "private": true,
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "scripts": {
     "dev": "vite",