Selaa lähdekoodia

docs: 明确服务端与客户端版本号更新规范

细化 AGENTS.md 及构建文档,规定修改代码时需同步更新对应版本号。
yangkaixiang 1 kuukausi sitten
vanhempi
commit
5e84b41705
3 muutettua tiedostoa jossa 16 lisäystä ja 3 poistoa
  1. 3 2
      AGENTS.md
  2. 12 0
      docs/08-构建与编译.md
  3. 1 1
      server/internal/config/config.go

+ 3 - 2
AGENTS.md

@@ -3,7 +3,8 @@
 ## Build Rules
 
 - Windows 编译时,如果因进程占用导致编译失败,可以直接结束占用进程后重新编译。编译结束后重新打开程序。
-- 每次编译 server 端前,需要先修改版本号。
-- 编译win端前,需要修改主界面标题栏的版本号。
+- 每次修改 `server` 目录下会影响 Server 行为的代码时,必须同步更新 `server/internal/config/config.go` 中的 `ServerVersion`。
+- 每次修改 `windows` 目录下会影响 Windows 客户端行为或界面的代码时,必须同步更新 `windows/NetworkTool.Client/NetworkTool.Client.csproj` 中的 `InformationalVersion`,主界面标题栏会读取该版本号。
+- 编译 server 或 win 端前,需要确认对应版本号已按本次修改更新。
 - 版本号格式统一使用 `yyyy.MM.dd.HHmm`,例如 `2026.05.13.1446`。
 - 如果修改后的代码和docs里文档描述不一致,需要你来修改docs里的文档。

+ 12 - 0
docs/08-构建与编译.md

@@ -6,6 +6,18 @@
 
 ## 2. Windows 客户端编译
 
+### 2.0 Windows 客户端版本号约定
+
+每次修改 `windows` 端代码时,必须同步更新 `windows/NetworkTool.Client/NetworkTool.Client.csproj` 中的 `InformationalVersion`。
+
+版本号格式固定为当前时间:`yyyy.MM.dd.HHmm`,例如 `2026.05.13.1446`。
+
+该版本号会显示在 Windows 客户端主界面标题栏,用于排查客户端程序是否为最新版本。
+
+注意:只要改动了 `windows` 目录下会影响 Windows 客户端行为或界面的代码,就要更新该版本号。
+
+### 2.1 编译 Windows 客户端
+
 在仓库根目录执行:
 
 ```powershell

+ 1 - 1
server/internal/config/config.go

@@ -6,7 +6,7 @@ import (
 	"net"
 )
 
-const ServerVersion = "2026.05.13.1446"
+const ServerVersion = "2026.05.13.1700"
 
 type Config struct {
 	HTTPHost         string