[202_112] 增加版本更新的提示

TeXmacs/misc/themes/liii-night.css

@@ -925,6 +925,68 @@ QWidget#auxiliary_container {
   background-color: rgba(255, 255, 255, 0.2);
 }
 
+/****************************************************************************
+* 版本更新提示条样式
+****************************************************************************/
+#updateNotificationBar {
+  background-color: #0d2b4a;
+  border: 1px solid #1a4a7a;
+  border-left: none;
+  border-right: none;
+  border-top: none;
+}
+
+#updateNotificationMessage {
+  color: #64b5f6;
+  font-size: 13px;
+  font-weight: 500;
+}
+
+#updateNotificationUpdateButton {
+  background-color: #1976d2;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  padding: 4px 12px;
+  font-size: 12px;
+  font-weight: 500;
+}
+
+#updateNotificationUpdateButton:hover {
+  background-color: #1565c0;
+}
+
+#updateNotificationSnoozeButton {
+  background-color: transparent;
+  border: 1px solid #4a7a9a;
+  color: #64b5f6;
+  padding: 4px 12px;
+  border-radius: 4px;
+  font-size: 12px;
+  font-weight: 500;
+}
+
+#updateNotificationSnoozeButton:hover {
+  background-color: #1a3a5a;
+}
+
+#updateNotificationCloseButton {
+  background-color: transparent;
+  color: #64b5f6;
+  border: none;
+  font-size: 16px;
+  font-weight: bold;
+  border-radius: 4px;
+  padding: 0;
+  margin: 0;
+  min-width: 24px;
+  min-height: 24px;
+}
+
+#updateNotificationCloseButton:hover {
+  background-color: rgba(100, 181, 246, 0.1);
+}
+
 /****************************************************************************
 * 文档编辑区域样式
 ****************************************************************************/

TeXmacs/misc/themes/liii.css

@@ -893,6 +893,68 @@ QWidget#auxiliary_container {
   background-color: rgba(0, 0, 0, 0.2);
 }
 
+/****************************************************************************
+* 版本更新提示条样式
+****************************************************************************/
+#updateNotificationBar {
+  background-color: #e3f2fd;
+  border: 1px solid #bbdefb;
+  border-left: none;
+  border-right: none;
+  border-top: none;
+}
+
+#updateNotificationMessage {
+  color: #1565c0;
+  font-size: 13px;
+  font-weight: 500;
+}
+
+#updateNotificationUpdateButton {
+  background-color: #1976d2;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  padding: 4px 12px;
+  font-size: 12px;
+  font-weight: 500;
+}
+
+#updateNotificationUpdateButton:hover {
+  background-color: #1565c0;
+}
+
+#updateNotificationSnoozeButton {
+  background-color: transparent;
+  border: 1px solid #90caf9;
+  color: #1976d2;
+  padding: 4px 12px;
+  border-radius: 4px;
+  font-size: 12px;
+  font-weight: 500;
+}
+
+#updateNotificationSnoozeButton:hover {
+  background-color: #e3f2fd;
+}
+
+#updateNotificationCloseButton {
+  background-color: transparent;
+  color: #1565c0;
+  border: none;
+  font-size: 16px;
+  font-weight: bold;
+  border-radius: 4px;
+  padding: 0;
+  margin: 0;
+  min-width: 24px;
+  min-height: 24px;
+}
+
+#updateNotificationCloseButton:hover {
+  background-color: rgba(21, 101, 192, 0.1);
+}
+
 /*文本工具栏窗口样式*/
 QWidget#text_toolbar {
   background: #ffffff;

TeXmacs/plugins/lang/dic/en_US/zh_CN.scm

@@ -2559,4 +2559,9 @@
 ("zoom/unzoom" "放大/缩小")
 ("You are currently in guest mode, login to enable AI, MathOCR,and other features" "您当前处于访客状态，登录激活AI和公式识别等功能")
 ("Login Now" "立即登录")
-("Use extensible brackets" "使用可伸缩括号")
+("Use extensible brackets" "使用可伸缩括号")
+;; 版本更新提示
+("New version available" "发现新版本")
+("current" "当前")
+("Update now" "立即更新")
+("Remind later" "稍后提醒")

TeXmacs/progs/utils/misc/version-update.scm

@@ -0,0 +1,85 @@
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;;
+;; MODULE      : version-update.scm
+;; DESCRIPTION : 版本更新检查（开发者配置）
+;; COPYRIGHT   : (C) 2026  Mogan STEM authors
+;;
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+(texmacs-module (utils misc version-update))
+
+;; ============================================
+;; 开发者配置区（修改此处调整行为）
+;; ============================================
+(define SNOOZE-DAYS 3)  ; 稍后提醒间隔，单位：天
+
+;; Mock 远程版本号（用于测试，设为 #f 则使用真实网络请求）
+;; 示例：(define MOCK-REMOTE-VERSION "2026.3.0")
+(define MOCK-REMOTE-VERSION #f)
+
+;; ============================================
+;; 内部实现
+;; ============================================
+
+;; 获取 Mock 远程版本号（优先从持久化存储读取）
+(tm-define (get-mock-remote-version)
+  (:secure #t)
+  (let ((stored (persistent-get (get-texmacs-home-path) MOCK-VERSION-KEY)))
+    (if (and stored (!= stored ""))
+        stored
+        MOCK-REMOTE-VERSION)))
+
+;; 设置 Mock 远程版本号（同时保存到持久化存储）
+(tm-define (set-mock-remote-version! version)
+  (:secure #t)
+  (set! MOCK-REMOTE-VERSION version)
+  (persistent-set (get-texmacs-home-path) MOCK-VERSION-KEY version))
+
+;; 清除 Mock 远程版本号（恢复默认 #f）
+(tm-define (clear-mock-remote-version)
+  (:secure #t)
+  (set! MOCK-REMOTE-VERSION #f)
+  (persistent-remove (get-texmacs-home-path) MOCK-VERSION-KEY))
+
+(define LAST-CHECK-KEY "version_last_check")
+(define SNOOZE-UNTIL-KEY "version_snooze_until")
+(define MOCK-VERSION-KEY "version_mock_remote")
+
+(define (current-timestamp)
+  (current-time))
+
+;; 检查是否应该检查更新（考虑稍后提醒时间）
+(tm-define (should-check-version-update?)
+  (:secure #t)
+  (let* ((now (current-timestamp))
+         (snooze-until (or (persistent-get (get-texmacs-home-path) SNOOZE-UNTIL-KEY) "0"))
+         (snooze-time (if (== snooze-until "") 0 (string->number snooze-until))))
+    (>= now snooze-time)))
+
+;; 强制清除所有记录（用于测试）
+(tm-define (clear-version-update-history)
+  (:secure #t)
+  (persistent-remove (get-texmacs-home-path) SNOOZE-UNTIL-KEY)
+  (clear-mock-remote-version))
+
+;; 稍后提醒（使用默认间隔）
+(tm-define (snooze-version-update)
+  (:secure #t)
+  (let* ((now (current-timestamp))
+         (future (+ now (* SNOOZE-DAYS 24 3600))))
+    (persistent-set (get-texmacs-home-path) SNOOZE-UNTIL-KEY
+                    (number->string future))))
+
+;; 获取下载页URL
+;; 社区版跳转到 mogan.app，商业版跳转到 liiistem.cn/com
+(tm-define (get-update-download-url)
+  (:secure #t)
+  (if (community-stem?)
+      ;; 社区版官网
+      (if (== (get-output-language) "chinese")
+          "https://mogan.app/zh/"
+          "https://mogan.app/en/")
+      ;; 商业版官网
+      (if (== (get-output-language) "chinese")
+          "https://liiistem.cn/install.html"
+          "https://liiistem.com/install.html")))

devel/202_112.md

@@ -0,0 +1,159 @@
+# 202_112 版本更新提示功能
+
+## 2026年3月26日
+
+### 如何测试
+
+#### 步骤1：设置 Mock 版本
+1. 因为测试版本一般都是最新的，测试版本号比远程获取的大，所以需要模拟一个更大的远程版本，在 Scheme 会话中执行：
+```scheme
+(set-mock-remote-version! "2026.3.0")
+```
+
+#### 步骤2：重启应用&检查功能
+1. 重启应用后，等待10秒后查看提示条是否显示
+2. 点击立即更新，看是否跳转到mogan 官网（社区版跳转到 mogan 官网，商业版跳转到 liii stem 官网）
+3. 点击稍后提示，看提示条是否消失（稍后提示 3 天后再提醒）
+
+#### 步骤3：再次重启应用&清除记录
+1. 重启应用，等待 10 秒后查看是否无提示条显示（上面点击了稍后提醒，不应该显示）
+```scheme
+;; 查看存储的稍后提醒时间戳（Unix时间）
+(persistent-get (get-texmacs-home-path) "version_snooze_until")
+```
+2. 清除mock remote version 的设定和稍后提示的缓存标记
+```scheme
+(clear-version-update-history)
+```
+
+### 测试要点
+- 新版本可用时正确显示提示条
+- 点击"立即更新"打开浏览器，提示条不消失
+- 点击"稍后提醒"3天后再次提示
+- 版本号比较正确（如 2026.10.0 > 2026.2.0）
+- 社区版和商业版都显示版本更新提示
+- 社区版跳转到 mogan.app，商业版跳转到 liiistem.cn/com
+
+---
+
+### What
+实现版本更新提示功能，当有新版本可用时，在窗口顶部显示提示条，引导用户更新到最新版本。
+
+### 功能特性
+1. **自动检查版本** - 启动后延迟10秒自动检查远程版本
+2. **语义化版本比较** - 正确比较版本号（如 2026.10.0 > 2026.2.0）
+3. **多语言支持** - 根据语言环境显示不同官网链接
+4. **双版本支持** - 社区版和商业版都显示版本更新提示，但跳转到不同官网
+
+### 用户操作按钮
+- **立即更新** - 打开浏览器跳转到官网下载页，提示条保持显示
+- **稍后提醒** - 3天后（开发者可配置）再次提示
+- **关闭** - 仅隐藏当前会话
+
+### 新增文件
+```
+src/Plugins/QWindowKit/updatenotificationbar.hpp
+src/Plugins/QWindowKit/updatenotificationbar.cpp
+TeXmacs/progs/utils/misc/version-update.scm
+```
+
+### 修改文件
+```
+src/Plugins/Qt/qt_tm_widget.hpp
+src/Plugins/Qt/qt_tm_widget.cpp
+TeXmacs/misc/themes/liii.css
+TeXmacs/misc/themes/liii-night.css
+TeXmacs/plugins/lang/dic/en_US/zh_CN.scm
+```
+
+### 开发者配置
+在 `TeXmacs/progs/utils/misc/version-update.scm` 中：
+
+```scheme
+;; 配置稍后提醒间隔（单位：天）
+(define SNOOZE-DAYS 3)
+```
+
+### Scheme 控制接口
+```scheme
+(use-modules (utils misc version-update))
+
+;; 检查是否应该检查更新（设置了稍后提醒不检查更新，否则检查更新）
+(should-check-version-update?)
+
+;; Mock 版本控制（用于测试，持久化存储，重启后生效）
+(get-mock-remote-version)               ; 查看当前 mock 版本
+(set-mock-remote-version! "2026.3.0")   ; 设置 mock 版本，重启后生效
+(clear-mock-remote-version)             ; 清除 mock 版本，恢复真实网络请求
+
+;; 稍后提醒
+(snooze-version-update)
+
+;; 清除所有记录（包括 mock 版本）
+(clear-version-update-history)
+```
+
+### UI 布局
+版本更新提示条和登录提示条垂直堆叠显示：
+```
+┌─────────────────────────────────────────┐
+│  🎉 发现新版本 v2026.3.0（当前 v2026.2.1）│
+│        [立即更新] [稍后提醒]        [×]  │
+├─────────────────────────────────────────┤
+│  访客登录提示条（如有）                  │
+│        [立即登录]                   [×]  │
+└─────────────────────────────────────────┘
+```
+
+### 官网链接
+
+| 版本 | 中文 | 英文 |
+|------|------|------|
+| 社区版 | `https://mogan.app/zh/` | `https://mogan.app/en/` |
+| 商业版 | `https://liiistem.cn/install.html` | `https://liiistem.com/install.html` |
+
+### 记录存储位置
+| 平台 | 路径 |
+|------|------|
+| macOS | `~/Library/Application Support/moganlab/system/_/` |
+| Linux | `~/.local/share/moganlab/system/_/` |
+| Windows | `%APPDATA%/moganlab/system/_/` |
+
+### 提示显示判定逻辑
+
+版本更新提示条的显示需要满足以下条件（按顺序检查）：
+
+```
+应用启动
+    ↓
+延迟10秒
+    ↓
+检查稍后提醒时间 ──否──→ 结束（不显示）
+    ↓ 是（当前时间 > 设置的稍后提醒时间）
+获取远程版本号（Mock优先）
+    ↓
+语义化版本比较（只比较前三位数字）
+    ↓
+远程版本 > 本地版本 ──否──→ 结束（不显示）
+    ↓ 是
+显示提示条
+```
+
+**关键判定条件：**
+
+| 检查项 | 说明 | Scheme变量/函数 |
+|--------|------|-----------------|
+| 稍后提醒时间 | 用户点击"稍后提醒"后记录的时间戳 | `version_snooze_until` |
+| 版本号比较 | 取前三位数字比较，如 `2026.10.0` vs `2026.2.1` | `isVersionNewer()` |
+
+**注意：** 目前没有"跳过此版本"功能，用户只能选择"稍后提醒"或保持提示条显示。
+
+### Why
+帮助用户及时获取最新版本，提升用户体验和软件安全性。
+
+### How
+1. 启动后延迟10秒检查版本
+2. Mock 版本优先于网络请求（用于测试）
+3. 语义化版本号比较（取前三位数字）
+4. 社区版和商业版都显示版本更新提示，根据版本类型跳转到不同官网
+5. 用户操作后记录状态到本地持久化存储