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

Updater/UpdaterLogic.cpp

@@ -31,9 +31,11 @@ UpdaterLogic::UpdaterLogic(QObject* parent)
     m_serverAddr = ConfigHelper::instance().getValue("Server", "api_base_url");
 }
 
-void UpdaterLogic::getManifest(const QString& appId, const QString& channel, const QString& targetVer, int versionId)
-{
-    QString url = m_serverAddr + "/api/v1/update/manifest";
+void UpdaterLogic::getManifest(const QString& appId, const QString& channel, const QString& targetVer, int versionId)
+{
+    // Manifest 由服务端按版本动态生成，描述目标版本包含哪些文件以及每个文件的 SHA256。
+    // Updater 先拿到 Manifest，再请求下载 URL，最后按 Manifest 校验本地文件。
+    QString url = m_serverAddr + "/api/v1/update/manifest";
     QJsonObject body;
     body["app_id"] = appId;
     body["channel"] = channel;
@@ -145,9 +147,11 @@ bool UpdaterLogic::verifySignature(const QByteArray& payload, const QString& sig
 #endif
 }
 
-bool UpdaterLogic::verifyManifestSignature(const QString& publicKeyPath) const
-{
-    if (m_manifest.isEmpty() || m_manifestText.isEmpty())
+bool UpdaterLogic::verifyManifestSignature(const QString& publicKeyPath) const
+{
+    // 验签用的是客户端随 SDK 分发的公钥。
+    // 只要服务端私钥没有泄漏，客户端就能发现被篡改的 Manifest。
+    if (m_manifest.isEmpty() || m_manifestText.isEmpty())
     {
         qDebug() << "No manifest available to verify";
         return false;
@@ -167,9 +171,11 @@ bool UpdaterLogic::verifyManifestSignature(const QString& publicKeyPath) const
     return verifySignature(m_manifestText.toUtf8(), signature, path);
 }
 
-bool UpdaterLogic::saveManifestCache(const QString& cacheDir) const
-{
-    if (m_manifest.isEmpty())
+bool UpdaterLogic::saveManifestCache(const QString& cacheDir) const
+{
+    // 启动后的完整性检查依赖本地 Manifest 缓存。
+    // 升级成功后缓存签名清单，下一次离线启动也能校验当前版本文件。
+    if (m_manifest.isEmpty())
         return false;
 
     QDir dir(cacheDir);