feat(client): improve SDK packaging and registry config

Launcher/CMakeLists.txt

@@ -3,20 +3,19 @@ project(LauncherDemo LANGUAGES C CXX)
 # C++标准
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
-# Qt 自动处理ui/moc/rcc
-set(CMAKE_INCLUDE_CURRENT_DIR ON)
-set(CMAKE_AUTOMOC ON)
-set(CMAKE_AUTOUIC ON)
-set(CMAKE_AUTORCC ON)
-# 依赖Qt模块：网络、基础核心、窗口
-set(CMAKE_PREFIX_PATH "C:\\Qt\\5.15.2\\msvc2019_64" ${CMAKE_PREFIX_PATH})
-find_package(Qt5 REQUIRED COMPONENTS Core Network Gui Widgets)
-# 所有源码文件
-set(SRC_LIST
-    main.cpp
-    UpdateLogic.h
-    UpdateLogic.cpp
-)
+# Qt 自动处理ui/moc/rcc
+set(CMAKE_INCLUDE_CURRENT_DIR ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTORCC ON)
+
+# 所有源码文件
+set(SRC_LIST
+    main.cpp
+    UpdateLogic.h
+    UpdateLogic.cpp
+    ${CMAKE_SOURCE_DIR}/i18n/update-client.qrc
+)
 # 生成可执行程序
 add_executable(Launcher ${SRC_LIST})
 if(WIN32)

Launcher/UpdateLogic.cpp

@@ -1,10 +1,12 @@
 #include "UpdateLogic.h"
 #include "ConfigHelper.h"
 #include <QDebug>
-#include <QJsonArray>
-#include <QApplication>
-#include "PolicyHelper.h"
-#include "LocalStateHelper.h"
+#include <QJsonArray>
+#include <QApplication>
+#include <QDir>
+#include <QSaveFile>
+#include "PolicyHelper.h"
+#include "LocalStateHelper.h"
 
 UpdateLogic::UpdateLogic(QObject* parent)
     : QObject(parent)
@@ -81,8 +83,8 @@ void UpdateLogic::checkUpdate()
         });
 }
 
-void UpdateLogic::getDownloadUrl(const QString& appId, const QString& channel, const QString& ver, int verId)
-{
+void UpdateLogic::getDownloadUrl(const QString& appId, const QString& channel, const QString& ver, int verId)
+{
     QString url = m_serverAddr + "/api/v1/update/download-url";
     QJsonObject body;
     body["app_id"] = appId;
@@ -97,10 +99,69 @@ void UpdateLogic::getDownloadUrl(const QString& appId, const QString& channel, c
             qDebug() << "\n========== File Download Url ==========";
             qDebug() << resp["files"].toArray();
         });
-}
-
-void UpdateLogic::reportUpdateResult(const QString& deviceId, const QString& fromVer, const QString& toVer, bool success)
-{
+}
+
+bool UpdateLogic::cacheManifest(const QString& appId, const QString& channel, const QString& version,
+                                int versionId, const QString& cacheDir)
+{
+    m_error.clear();
+    if (appId.isEmpty() || channel.isEmpty() || version.isEmpty() || versionId <= 0) {
+        m_error = "manifest identity is incomplete";
+        return false;
+    }
+
+    QJsonObject response;
+    int statusCode = 0;
+    QJsonObject body;
+    body["app_id"] = appId;
+    body["channel"] = channel;
+    body["version"] = version;
+    body["version_id"] = versionId;
+    m_http.postRequest(m_serverAddr + "/api/v1/update/manifest", body,
+        [&](int code, const QJsonObject& resp) {
+            statusCode = code;
+            response = resp;
+        });
+
+    if (statusCode != 200) {
+        m_error = QString("manifest request failed (HTTP %1)").arg(statusCode);
+        return false;
+    }
+
+    const QJsonObject manifest = response.value("manifest").toObject();
+    const QString manifestText = response.value("manifest_text").toString();
+    if (manifest.isEmpty() || manifestText.isEmpty()) {
+        m_error = "manifest response is incomplete";
+        return false;
+    }
+    if (manifest.value("app_id").toString() != appId
+        || manifest.value("channel").toString() != channel
+        || manifest.value("version").toString() != version) {
+        m_error = "manifest identity does not match current version";
+        return false;
+    }
+
+    QDir dir(cacheDir);
+    if (!dir.exists() && !dir.mkpath(".")) {
+        m_error = "cannot create manifest cache directory";
+        return false;
+    }
+
+    QJsonObject wrapper;
+    wrapper["manifest"] = manifest;
+    wrapper["manifest_text"] = manifestText;
+    QSaveFile file(dir.filePath("manifest_" + version + ".json"));
+    const QByteArray bytes = QJsonDocument(wrapper).toJson(QJsonDocument::Indented);
+    if (!file.open(QIODevice::WriteOnly) || file.write(bytes) != bytes.size() || !file.commit()) {
+        m_error = "cannot save signed manifest cache";
+        return false;
+    }
+    qDebug() << "Current version manifest cached to" << file.fileName();
+    return true;
+}
+
+void UpdateLogic::reportUpdateResult(const QString& deviceId, const QString& fromVer, const QString& toVer, bool success)
+{
     QString url = m_serverAddr + "/api/v1/update/report";
     QJsonObject body;
     body["app_id"] = m_appId;
@@ -114,4 +175,4 @@ void UpdateLogic::reportUpdateResult(const QString& deviceId, const QString& fro
             qDebug() << "\n========== Update Report Result ==========";
             qDebug() << resp;
         });
-}
+}

Launcher/UpdateLogic.h

@@ -10,15 +10,18 @@ class UpdateLogic : public QObject
 public:
     explicit UpdateLogic(QObject* parent = nullptr);
 
-    void checkUpdate();
-    void getDownloadUrl(const QString& appId, const QString& channel, const QString& ver, int verId);
-    void reportUpdateResult(const QString& deviceId, const QString& fromVer, const QString& toVer, bool success);
-
-    bool getNeedUpdate() const { return m_needUpdate; }
-    QString getLatestVersion() const { return m_latestVer; }
-    QJsonObject getCheckResult() const { return m_checkResp; }
-    bool isNetworkOk() const { return m_networkOk; }
-    int lastStatusCode() const { return m_lastStatusCode; }
+    void checkUpdate();
+    void getDownloadUrl(const QString& appId, const QString& channel, const QString& ver, int verId);
+    void reportUpdateResult(const QString& deviceId, const QString& fromVer, const QString& toVer, bool success);
+    bool cacheManifest(const QString& appId, const QString& channel, const QString& version,
+                       int versionId, const QString& cacheDir);
+
+    bool getNeedUpdate() const { return m_needUpdate; }
+    QString getLatestVersion() const { return m_latestVer; }
+    QJsonObject getCheckResult() const { return m_checkResp; }
+    bool isNetworkOk() const { return m_networkOk; }
+    int lastStatusCode() const { return m_lastStatusCode; }
+    QString errorString() const { return m_error; }
 
     QString getAppId() const { return m_appId; }
     QString getChannel() const { return m_channel; }
@@ -32,7 +35,8 @@ private:
 
     bool m_needUpdate = false;
     bool m_networkOk = false;
-    int m_lastStatusCode = 0;
-    QString m_latestVer;
-    QJsonObject m_checkResp;
-};
+    int m_lastStatusCode = 0;
+    QString m_latestVer;
+    QJsonObject m_checkResp;
+    QString m_error;
+};

Launcher/main.cpp

@@ -1,13 +1,13 @@
-#include <windows.h>
-#include <QApplication>
-#include <QDebug>
-#include <QMessageBox>
-#include <QProcess>
-#include <QProgressDialog>
-#include <QInputDialog>
-#include <QLineEdit>
-#include <QTextCodec>
-#include "UpdateLogic.h"
+#include <QApplication>
+#include <QCoreApplication>
+#include <QDebug>
+#include <QMessageBox>
+#include <QProcess>
+#include <QProgressDialog>
+#include <QInputDialog>
+#include <QLineEdit>
+#include <QTranslator>
+#include "UpdateLogic.h"
 #include "../Common/ConfigHelper.h"
 #include "../Common/PolicyHelper.h"
 #include "../Common/LocalStateHelper.h"
@@ -17,15 +17,20 @@
 #include <QFileDialog>
 #include <QDir>
 
-int main(int argc, char* argv[])
-{
-    SetConsoleOutputCP(65001);
-    QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
-    QApplication app(argc, argv);
-    QApplication::setApplicationName("Marsco Launcher");
-
-    QProgressDialog progress("正在检查软件更新...", QString(), 0, 0);
-    progress.setWindowTitle("Marsco 软件启动器");
+int main(int argc, char* argv[])
+{
+    QApplication app(argc, argv);
+    QApplication::setApplicationName("Marsco Launcher");
+    QTranslator translator;
+    if (translator.load(":/i18n/update-client_zh_CN.qm"))
+        app.installTranslator(&translator);
+
+    const int elevatedWriteExitCode = ConfigHelper::runElevatedWriteCommandIfRequested();
+    if (elevatedWriteExitCode >= 0)
+        return elevatedWriteExitCode;
+
+    QProgressDialog progress(QCoreApplication::translate("Launcher", "Checking for software updates..."), QString(), 0, 0);
+    progress.setWindowTitle(QCoreApplication::translate("Launcher", "Marsco Launcher"));
     progress.setCancelButton(nullptr);
     progress.setWindowModality(Qt::ApplicationModal);
     progress.setMinimumDuration(0);
@@ -37,50 +42,57 @@ int main(int argc, char* argv[])
     ConfigHelper& config = ConfigHelper::instance();
     const auto isLicenseError = [](const QString& errorText) {
         const QString text = errorText.toLower();
-        return text.contains("license")
-            || errorText.contains("授权")
-            || errorText.contains("过期")
-            || errorText.contains("设备数量已达到上限")
-            || errorText.contains("已绑定其他授权");
-    };
-    const auto clearDeviceCredential = [&]() {
-        QFile::remove(QDir(appDir).filePath("config/client_identity.dat"));
-        config.setValue("Update", "device_id", QString());
-    };
+        return text.contains("license")
+            || text.contains("authorization")
+            || text.contains("expired")
+            || text.contains("device limit")
+            || text.contains("bound to another license");
+    };
+    const auto clearDeviceCredential = [&]() {
+        ConfigHelper::removeFileWithElevationIfNeeded(QDir(appDir).filePath("config/client_identity.dat"));
+        config.setValue("Update", "device_id", QString());
+    };
     QString licenseKey = config.getValue("License", "license_key").trimmed();
     auto promptAndSaveLicense = [&](const QString& reason) -> QString {
         QString promptReason = reason;
         while (true) {
             progress.close();
-            bool accepted = false;
-            const QString appName = config.getValue("App", "app_name").trimmed();
-            const QString prompt = promptReason.trimmed().isEmpty()
-                ? QString("请输入%1授权 License：").arg(appName.isEmpty() ? "软件" : appName)
-                : QString("%1\n\n请重新输入%2授权 License：").arg(promptReason, appName.isEmpty() ? "软件" : appName);
-            licenseKey = QInputDialog::getText(
-                nullptr,
-                "输入 License",
-                prompt,
+            bool accepted = false;
+            const QString appName = config.getValue("App", "app_name").trimmed();
+            const QString prompt = promptReason.trimmed().isEmpty()
+                ? QCoreApplication::translate("Launcher", "Please enter the License for %1:")
+                    .arg(appName.isEmpty() ? QCoreApplication::translate("Launcher", "the application") : appName)
+                : QCoreApplication::translate("Launcher", "%1\n\nPlease enter a new License for %2:")
+                    .arg(promptReason, appName.isEmpty() ? QCoreApplication::translate("Launcher", "the application") : appName);
+            licenseKey = QInputDialog::getText(
+                nullptr,
+                QCoreApplication::translate("Launcher", "Enter License"),
+                prompt,
                 QLineEdit::Normal,
                 QString(),
                 &accepted
-            ).trimmed();
-            if (!accepted) {
-                QMessageBox::information(nullptr, "需要 License", "首次启动需要输入管理员提供的 License。");
-                return QString();
-            }
-            if (licenseKey.isEmpty()) {
-                QMessageBox::warning(nullptr, "License 不能为空", "请粘贴管理员在后台创建的 License。");
-                promptReason.clear();
-                continue;
-            }
-            if (!config.setValue("License", "license_key", licenseKey)) {
-                QMessageBox::critical(nullptr, "保存 License 失败",
-                    QString("无法写入配置文件：%1\n%2").arg(config.configPath(), config.lastError()));
-                return QString();
-            }
-            progress.show();
-            progress.setLabelText("正在验证 License...");
+            ).trimmed();
+            if (!accepted) {
+                QMessageBox::information(nullptr,
+                    QCoreApplication::translate("Launcher", "License Required"),
+                    QCoreApplication::translate("Launcher", "A License provided by the administrator is required for the first launch."));
+                return QString();
+            }
+            if (licenseKey.isEmpty()) {
+                QMessageBox::warning(nullptr,
+                    QCoreApplication::translate("Launcher", "License Cannot Be Empty"),
+                    QCoreApplication::translate("Launcher", "Please paste the License created in the admin page."));
+                promptReason.clear();
+                continue;
+            }
+            if (!config.setValue("License", "license_key", licenseKey)) {
+                QMessageBox::critical(nullptr,
+                    QCoreApplication::translate("Launcher", "Failed to Save License"),
+                    QCoreApplication::translate("Launcher", "Cannot write the configuration file:\n%1\n%2").arg(config.configPath(), config.lastError()));
+                return QString();
+            }
+            progress.show();
+            progress.setLabelText(QCoreApplication::translate("Launcher", "Verifying License..."));
             QApplication::processEvents();
             return licenseKey;
         }
@@ -101,12 +113,14 @@ int main(int argc, char* argv[])
         }
         const QString error = identity.errorString();
         if (!isLicenseError(error)) {
-            progress.close();
-            QMessageBox::critical(nullptr, "设备身份验证失败", error);
-            return -1;
-        }
-        clearDeviceCredential();
-        licenseKey = promptAndSaveLicense(QString("当前 License 无法使用：%1").arg(error));
+            progress.close();
+            QMessageBox::critical(nullptr,
+                QCoreApplication::translate("Launcher", "Device Authentication Failed"),
+                error);
+            return -1;
+        }
+        clearDeviceCredential();
+        licenseKey = promptAndSaveLicense(QCoreApplication::translate("Launcher", "The current License cannot be used: %1").arg(error));
         if (licenseKey.isEmpty()) return 0;
     }
 
@@ -116,49 +130,61 @@ int main(int argc, char* argv[])
     const bool needUpdate = logic.getNeedUpdate();
     const bool networkOk = logic.isNetworkOk();
     const QString latestVer = logic.getLatestVersion();
-    const QJsonObject response = logic.getCheckResult();
-    const int targetVersionId = response.value("version_id").toInt();
-    const QString appId = logic.getAppId();
-    const QString channel = logic.getChannel();
+    const QJsonObject response = logic.getCheckResult();
+    const int targetVersionId = response.value("version_id").toInt();
+    const QString appId = logic.getAppId();
+    const QString channel = logic.getChannel();
+    const QString launchToken = config.getValue("App", "launch_token");
+    const QString currentVersion = config.getValue("App", "current_version");
 
     if (logic.lastStatusCode() == 401 || logic.lastStatusCode() == 403) {
         progress.close();
         const QJsonValue detail = response.value("detail");
         const QString message = detail.isObject() ? detail.toObject().value("msg").toString() : detail.toString();
-        const QString displayMessage = message.isEmpty() ? "设备或 License 授权无效。" : message;
-        if (isLicenseError(displayMessage)) {
-            clearDeviceCredential();
-            const QString newLicense = promptAndSaveLicense(QString("当前授权被服务端拒绝：%1").arg(displayMessage));
-            if (!newLicense.isEmpty()) {
-                progress.close();
-                QMessageBox::information(nullptr, "License 已保存", "请重新启动 Launcher 完成设备授权和更新检查。");
-            }
-            return 0;
-        }
-        QMessageBox::critical(nullptr, "授权被拒绝", displayMessage);
+        const QString displayMessage = message.isEmpty()
+            ? QCoreApplication::translate("Launcher", "The device or License authorization is invalid.")
+            : message;
+        if (isLicenseError(displayMessage)) {
+            clearDeviceCredential();
+            const QString newLicense = promptAndSaveLicense(QCoreApplication::translate("Launcher", "The current authorization was rejected by the server: %1").arg(displayMessage));
+            if (!newLicense.isEmpty()) {
+                progress.close();
+                QMessageBox::information(nullptr,
+                    QCoreApplication::translate("Launcher", "License Saved"),
+                    QCoreApplication::translate("Launcher", "Please restart Launcher to complete device authorization and update checking."));
+            }
+            return 0;
+        }
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Authorization Rejected"),
+            displayMessage);
         return -1;
     }
 
-    const QString launchToken = config.getValue("App", "launch_token");
-    const QString currentVersion = config.getValue("App", "current_version");
-    const auto configuredName = [&](const QString& key, const QString& fallback) {
-        const QString value = config.getValue("Runtime", key).trimmed();
-        return value.isEmpty() ? fallback : value;
+    const auto configuredName = [&](const QString& key, const QString& fallback) {
+        const QString value = config.getValue("Runtime", key).trimmed();
+        return value.isEmpty() ? fallback : value;
     };
     const QString mainExecutable = configuredName("main_executable", "MainApp.exe");
     const QString updaterExecutable = configuredName("updater_executable", "Updater.exe");
-    const QString mainAppPath = QDir(appDir).filePath(mainExecutable);
-    const QString updaterPath = QDir(appDir).filePath(updaterExecutable);
-    const auto importOfflinePackage = [&]() {
-        const QString package = QFileDialog::getOpenFileName(nullptr, "选择离线更新包", QString(), "Marsco 离线更新包 (*.upd)");
-        return package.isEmpty() ? false : QProcess::startDetached(updaterPath, QStringList{QString("--offline-package=%1").arg(package)});
-    };
+    const QString mainAppPath = QDir(appDir).filePath(mainExecutable);
+    const QString updaterPath = QDir(appDir).filePath(updaterExecutable);
+    const auto importOfflinePackage = [&]() {
+        const QString package = QFileDialog::getOpenFileName(nullptr,
+            QCoreApplication::translate("Launcher", "Select Offline Update Package"),
+            QString(),
+            QCoreApplication::translate("Launcher", "Marsco offline update package (*.upd)"));
+        return package.isEmpty() ? false : QProcess::startDetached(updaterPath, QStringList{QString("--offline-package=%1").arg(package)});
+    };
     const QString deviceId = config.getValue("Update", "device_id");
-    if (QCoreApplication::arguments().contains("--import-offline")) {
-        progress.close();
-        if (!importOfflinePackage()) QMessageBox::information(nullptr, "离线更新", "未选择离线更新包。");
-        return 0;
-    }
+    if (QCoreApplication::arguments().contains("--import-offline")) {
+        progress.close();
+        if (!importOfflinePackage())
+            QMessageBox::information(nullptr,
+                QCoreApplication::translate("Launcher", "Offline Update"),
+                QCoreApplication::translate("Launcher", "No offline update package was selected."));
+        return 0;
+    }
 
     const auto startMainApp = [&]() {
         QString ticketPath;
@@ -174,28 +200,33 @@ int main(int argc, char* argv[])
         return started;
     };
 
-    progress.setLabelText("正在验证本地运行策略...");
+    progress.setLabelText(QCoreApplication::translate("Launcher", "Verifying local runtime policy..."));
     QApplication::processEvents();
 
     PolicyHelper policy(appDir);
     if (!policy.loadPolicy("config/version_policy.dat") || !policy.isValid())
     {
         progress.close();
-        QMessageBox::critical(nullptr, "无法启动", QString("本地版本策略无效：%1").arg(policy.errorString()));
-        return -1;
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Cannot Start"),
+            QCoreApplication::translate("Launcher", "The local version policy is invalid: %1").arg(policy.errorString()));
+        return -1;
     }
     if (policy.isExpired())
     {
         progress.close();
-        QMessageBox::critical(nullptr, "无法启动", "本地版本策略已过期，请连接网络或联系管理员。");
-        return -1;
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Cannot Start"),
+            QCoreApplication::translate("Launcher", "The local version policy has expired. Please connect to the network or contact the administrator."));
+        return -1;
     }
     if ((!policy.allowRun() || !policy.isVersionAllowed(currentVersion)) && !(networkOk && needUpdate))
     {
         progress.close();
-        QMessageBox::critical(nullptr, "当前版本不可运行",
-            policy.message().isEmpty() ? QString("当前版本 %1 已被管理员停用。").arg(currentVersion)
-                                       : policy.message());
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Current Version Cannot Run"),
+            policy.message().isEmpty() ? QCoreApplication::translate("Launcher", "The current version %1 has been disabled by the administrator.").arg(currentVersion)
+                                       : policy.message());
         return -1;
     }
 
@@ -203,32 +234,39 @@ int main(int argc, char* argv[])
     if (!state.loadState())
     {
         progress.close();
-        QMessageBox::critical(nullptr, "无法启动", QString("无法读取本地状态：%1").arg(state.errorString()));
-        return -1;
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Cannot Start"),
+            QCoreApplication::translate("Launcher", "Cannot read the local state: %1").arg(state.errorString()));
+        return -1;
     }
     if (state.isPolicySeqRolledBack(policy.policySeq()))
     {
         progress.close();
-        QMessageBox::critical(nullptr, "安全检查失败", "检测到版本策略序列回退，已阻止启动。");
-        return -1;
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Security Check Failed"),
+            QCoreApplication::translate("Launcher", "A version policy sequence rollback was detected. Startup has been blocked."));
+        return -1;
     }
     if (state.isSystemTimeRewound())
     {
         progress.close();
-        QMessageBox::critical(nullptr, "安全检查失败", "检测到系统时间可能被回拨，已阻止启动。");
-        return -1;
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Security Check Failed"),
+            QCoreApplication::translate("Launcher", "A possible system time rollback was detected. Startup has been blocked."));
+        return -1;
     }
 
-    if (networkOk && needUpdate)
-    {
-        progress.close();
-        const bool rollbackOperation = response.value("action").toString() == "rollback_allowed";
-        const QString dialogTitle = rollbackOperation ? "版本回退"
-            : (policy.forceUpdate() ? "必须更新" : "发现新版本");
-        const QString prompt = policy.message().isEmpty()
-            ? QString(rollbackOperation ? "管理员提供了版本 %1 作为回退目标，是否现在降级？"
-                                        : "发现新版本 %1，是否现在更新？").arg(latestVer)
-            : policy.message() + QString("\n目标版本：%1").arg(latestVer);
+    if (networkOk && needUpdate)
+    {
+        progress.close();
+        const bool rollbackOperation = response.value("action").toString() == "rollback_allowed";
+        const QString dialogTitle = rollbackOperation ? QCoreApplication::translate("Launcher", "Version Rollback")
+            : (policy.forceUpdate() ? QCoreApplication::translate("Launcher", "Update Required") : QCoreApplication::translate("Launcher", "New Version Available"));
+        const QString prompt = policy.message().isEmpty()
+            ? (rollbackOperation
+                ? QCoreApplication::translate("Launcher", "The administrator provided version %1 as the rollback target. Downgrade now?").arg(latestVer)
+                : QCoreApplication::translate("Launcher", "Version %1 is available. Update now?").arg(latestVer))
+            : policy.message() + QCoreApplication::translate("Launcher", "\nTarget version: %1").arg(latestVer);
         bool accepted = true;
         if (policy.forceUpdate()) {
             QMessageBox::information(nullptr, dialogTitle, prompt);
@@ -237,44 +275,74 @@ int main(int argc, char* argv[])
                 QMessageBox::Yes | QMessageBox::No, QMessageBox::No) == QMessageBox::Yes;
         }
         if (!accepted) {
-            if (!startMainApp()) {
-                QMessageBox::critical(nullptr, "启动失败", QString("无法启动主程序：%1").arg(mainAppPath));
-                return -1;
-            }
+            if (!startMainApp()) {
+                QMessageBox::critical(nullptr,
+                    QCoreApplication::translate("Launcher", "Startup Failed"),
+                    QCoreApplication::translate("Launcher", "Cannot start the main application: %1").arg(mainAppPath));
+                return -1;
+            }
             return 0;
         }
         const QStringList updaterArgs{appId, channel, latestVer, QString::number(targetVersionId)};
-        if (!QProcess::startDetached(updaterPath, updaterArgs))
-        {
-            QMessageBox::critical(nullptr, "更新器启动失败", QString("无法启动更新器：%1").arg(updaterPath));
-            return -1;
+        if (!QProcess::startDetached(updaterPath, updaterArgs))
+        {
+            QMessageBox::critical(nullptr,
+                QCoreApplication::translate("Launcher", "Updater Startup Failed"),
+                QCoreApplication::translate("Launcher", "Cannot start the updater: %1").arg(updaterPath));
+            return -1;
         }
-        return 0;
-    }
-
-    if (!networkOk) {
-        progress.close();
-        if (QMessageBox::question(nullptr, "服务器不可用", "当前无法连接更新服务器。是否导入离线更新包？",
-                                  QMessageBox::Yes | QMessageBox::No, QMessageBox::No) == QMessageBox::Yes) {
-            if (!importOfflinePackage()) QMessageBox::information(nullptr, "离线更新", "未选择离线更新包或无法启动更新器。");
-            return 0;
+        return 0;
+    }
+
+    if (networkOk && !needUpdate && targetVersionId > 0 && latestVer == currentVersion)
+    {
+        progress.setLabelText(QCoreApplication::translate("Launcher", "Caching signed version manifest..."));
+        QApplication::processEvents();
+        const QString manifestCacheDir = QDir(ConfigHelper::instance().updateRoot()).filePath("manifest_cache");
+        if (!logic.cacheManifest(appId, channel, currentVersion, targetVersionId, manifestCacheDir))
+        {
+            progress.close();
+            QMessageBox::critical(nullptr,
+                QCoreApplication::translate("Launcher", "Manifest Cache Failed"),
+                QCoreApplication::translate("Launcher", "Cannot cache the signed manifest for the current version: %1").arg(logic.errorString()));
+            return -1;
+        }
+    }
+
+    if (!networkOk) {
+        progress.close();
+        if (QMessageBox::question(nullptr,
+                                  QCoreApplication::translate("Launcher", "Server Unavailable"),
+                                  QCoreApplication::translate("Launcher", "Cannot connect to the update server. Import an offline update package?"),
+                                  QMessageBox::Yes | QMessageBox::No, QMessageBox::No) == QMessageBox::Yes) {
+            if (!importOfflinePackage())
+                QMessageBox::information(nullptr,
+                    QCoreApplication::translate("Launcher", "Offline Update"),
+                    QCoreApplication::translate("Launcher", "No offline update package was selected, or the updater could not be started."));
+            return 0;
         }
         progress.show();
     }
 
-    if (!networkOk && !policy.isOfflineAllowed())
-    {
-        progress.close();
-        QMessageBox::critical(nullptr, "网络不可用", "无法连接更新服务器，且当前策略不允许离线启动。");
-        return -1;
-    }
-
-    progress.setLabelText(networkOk ? "当前已是最新版本，正在启动..." : "当前处于离线模式，正在启动...");
+    if (!networkOk && !policy.isOfflineAllowed())
+    {
+        progress.close();
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Network Unavailable"),
+            QCoreApplication::translate("Launcher", "Cannot connect to the update server, and the current policy does not allow offline startup."));
+        return -1;
+    }
+
+    progress.setLabelText(networkOk
+        ? QCoreApplication::translate("Launcher", "The application is up to date. Starting...")
+        : QCoreApplication::translate("Launcher", "Offline mode is active. Starting..."));
     QApplication::processEvents();
     if (!startMainApp())
     {
         progress.close();
-        QMessageBox::critical(nullptr, "启动失败", QString("无法启动主程序：%1").arg(mainAppPath));
+        QMessageBox::critical(nullptr,
+            QCoreApplication::translate("Launcher", "Startup Failed"),
+            QCoreApplication::translate("Launcher", "Cannot start the main application: %1").arg(mainAppPath));
         return -1;
     }
     progress.close();