feat: 优化客户端跨平台配置和运行态管理

Common/TicketHelper.cpp

@@ -10,17 +10,19 @@
 #include <QStandardPaths>
 #include <QUuid>
 
-static QByteArray ticketMac(const QJsonObject& payload, const QString& secret)
-{
+static QByteArray ticketMac(const QJsonObject& payload, const QString& secret)
+{
     return QMessageAuthenticationCode::hash(
         QJsonDocument(payload).toJson(QJsonDocument::Compact), secret.toUtf8(), QCryptographicHash::Sha256).toHex();
 }
 
-bool TicketHelper::createTicket(const QString& appId, const QString& deviceId,
-                                const QString& version, const QString& secret,
-                                QString* ticketPath, QString* errorMessage)
-{
-    if (appId.isEmpty() || version.isEmpty() || secret.isEmpty()) {
+bool TicketHelper::createTicket(const QString& appId, const QString& deviceId,
+                                const QString& version, const QString& secret,
+                                QString* ticketPath, QString* errorMessage)
+{
+    // Launcher 启动业务主程序前生成一次性 ticket。
+    // ticket 只保存在临时目录、有效期 60 秒，并用 launch_token 做 HMAC，防止用户绕过 Launcher 直接启动主程序。
+    if (appId.isEmpty() || version.isEmpty() || secret.isEmpty()) {
         if (errorMessage) *errorMessage = "ticket identity or secret is empty";
         return false;
     }
@@ -47,11 +49,13 @@ bool TicketHelper::createTicket(const QString& appId, const QString& deviceId,
     return true;
 }
 
-bool TicketHelper::consumeAndVerify(const QString& ticketPath, const QString& expectedAppId,
-                                    const QString& expectedDeviceId, const QString& expectedVersion,
-                                    const QString& secret, QString* errorMessage)
-{
-    const QString consumingPath = ticketPath + ".consuming."
+bool TicketHelper::consumeAndVerify(const QString& ticketPath, const QString& expectedAppId,
+                                    const QString& expectedDeviceId, const QString& expectedVersion,
+                                    const QString& secret, QString* errorMessage)
+{
+    // 主程序启动后第一时间把 ticket 改名成 .consuming，再读取并删除。
+    // 这样同一张 ticket 即使校验失败也不能被重复使用，避免重放启动。
+    const QString consumingPath = ticketPath + ".consuming."
         + QString::number(QCoreApplication::applicationPid());
     if (!QFile::rename(ticketPath, consumingPath)) {
         if (errorMessage) *errorMessage = "ticket missing or already consumed";