chore: 版本号统一为 V0.1 (package.json 1.0.0 -> 0.1.0, 与 tauri.conf.json/Cargo.toml 对齐) + readme 补充版本管理约定

2026-10-22 09:59:26 +08:00
2 changed files with 44 additions and 27 deletions
@@ -1,6 +1,6 @@
 {
  "name": "iboard",
-  "version": "1.0.0",
+  "version": "0.1.0",
  "type": "module",
  "scripts": {
    "tauri": "tauri",
@@ -1,27 +1,44 @@
-# iBoard
-用于收集和整理经济数据，但是以策略为主体重新组织。
- 首页主要是放经济文章
- 数据主要是放各种经济数据和图表。
- 策略是放按照经济理论组织的相关数据和图表的对比。
-
-
-
-## 首页
-首页显示新闻模块和报警模块的数据，按照时间最新优先，无限滚动，直到数据库中没有数据为止。
-
-
-### 新闻模块
-增加一个新闻模块，数据来源是每日夜间 3点，通过妙想 MCP 获取国内外最新经济政治新闻，按影响大小排序10条。
-存入数据库。
-
-
-### 报警模块
-World Bank 中的数据只用来对比妙想 MCP 拉取的数据正确性。当同一时间的同一项数据不同时，记录一个报警。
-
-## 监控
-监控分为服务器监控和服务监控两部分。
-服务器监控对接 komari，地址：https://komari.honor3.com/
-
+# iBoard
+用于收集和整理经济数据，但是以策略为主体重新组织。
+
+## 版本管理 (V0.1)
+
+版本号遵循 `主版本.次版本.修订号`，**唯一手动管理点是 `package.json` 的 `version` 字段**（当前 `0.1.0`）。
+发版时只改这一处，以下位置必须保持一致（改版本时一并核对）：
+
+| 文件 | 字段 | 说明 |
+| --- | --- | --- |
+| `package.json` | `version` | **唯一源**，前端 `src/version.js` 与 OTA 打包脚本均读取此值 |
+| `src-tauri/tauri.conf.json` | `version` | Tauri 应用版本（Android/桌面包版本） |
+| `src-tauri/Cargo.toml` | `[package].version` | Rust 包版本，需与 tauri.conf.json 一致 |
+
+说明：
+- `src/version.js` 从 `package.json` 取值，前端"我"页与 OTA 检查接口展示的即此版本，不要另写死版本号。
+- `BUILD_ID` 每次编译自动生成（见 `vite.config.js` 的 `__BUILD_ID__`），无需手动维护。
+- `ota-package/latest.json` 为运行时产物，不纳入版本管理。
+
+- 首页主要是放经济文章
+- 数据主要是放各种经济数据和图表。
+- 策略是放按照经济理论组织的相关数据和图表的对比。
+
+
+
+## 首页
+首页显示新闻模块和报警模块的数据，按照时间最新优先，无限滚动，直到数据库中没有数据为止。
+
+
+### 新闻模块
+增加一个新闻模块，数据来源是每日夜间 3点，通过妙想 MCP 获取国内外最新经济政治新闻，按影响大小排序10条。
+存入数据库。
+
+
+### 报警模块
+World Bank 中的数据只用来对比妙想 MCP 拉取的数据正确性。当同一时间的同一项数据不同时，记录一个报警。
+
+## 监控
+监控分为服务器监控和服务监控两部分。
+服务器监控对接 komari，地址：https://komari.honor3.com/
+


 ## 前端 OTA 升级
@@ -91,7 +108,7 @@ node scripts/build-ota.mjs   # 打成 tar.gz + 签名 + latest.json
 ### Web 端

 Web 浏览器访问 (同源) 时, 服务端返回简化版 manifest, 仅显示"有新版本请刷新".
-Web 端不会自动下载包, 也不会替换前端代码.
+Web 端不会自动下载包, 也不会替换前端代码.


 ### CI 自动签名 (Gitea Actions)
@@ -111,4 +128,4 @@ otes (可选)

 **注意**:
 - CI 用的私钥必须**与** 	auri.conf.json 里 plugins.hotswap.pubkey **配对**; 换密钥时需要同时更新 CI secret 和 conf.
- 不要把私钥 commit 到 git, 整个 ota-package/hotswap.key 已被 .gitignore 排除.
+- 不要把私钥 commit 到 git, 整个 ota-package/hotswap.key 已被 .gitignore 排除.