feat: 消息模块（MQTT 推送 + 统一总线），并补退出登录/顺序编排/设置分页签

一、消息模块：服务端主动推送 + 插件定向分发 * topics.py：主题方案 <prefix>/<org>/user/<user>/message、.../user/<user>/plugin/<id>、 .../broadcast/{message,plugin/<id>}。org 是租户位（多租户上线不用改格式，broker 按 <prefix>/<org>/# 下发 ACL 即可隔离）；用户名/插件 id 经**可逆**百分号编码占一个层级，客户端与示例服务端共用同一套拼主题函数； * bus.py：统一消息总线——按**主题**分类（主机消息进消息中心、插件消息不进，仪表盘数据那类业务载荷永远不会混进给人看的列表）、归属校验（org/user 不符即丢弃，broker ACL 配错也挡得住）、按 id 去重（QoS 1 重投与"推送/补齐重叠"都不会重复显示）、插件消息按插件缓存 50 条，等页面打开后一次性补投； * mqtt.py + mqtt_service.py：paho 适配（可选依赖 [mqtt]）+ Qt 适配（paho 的网络线程经排队信号把消息交给主线程的总线）；重连交给 paho（指数退避），重连成功自动重新订阅；没装 paho / 没配 broker 都只是"没有实时推送"，HTTP 补齐照常； * worker.py：登录后**先**补齐（GET /api/messages?since=）再连 MQTT，两条路进同一总线；在途结果带身份快照，退出登录/换账号后丢弃； * 界面：侧栏 ✉ 未读徽标 + 消息中心（级别/标题/时间/来源/广播标记、立即同步、全部已读、清空、通道状态灯）；warn/error 顺手发系统托盘通知； * 插件侧：新权限 messages（PLUGIN_API_VERSION→5），页面里 svfs.messages.subscribe()；宿主经 window.__svfsPush 投递，早到的先排队、订阅时补发（桥调试台已接上演示）； * examples/plugin_server.py：/api/messages、/api/push（kind=message|plugin）、 /api/broadcast；配了 SVFS_MQTT_HOST 就真发布到 broker，并把 broker 地址随登录响应下发（/api/login 与 /api/me 都带），客户端不用手填。二、退出登录 = 关掉主窗口 + 回到登录界面 * 强制登录下"未登录的主窗口"本就不该存在：重新登录成功用新会话开回主窗口，关掉登录窗即退出客户端；退出时断开推送、清掉该账号收到的消息与总线身份（下一个人不该看到上一个人的消息），并收掉已打开的插件页面； * 用户中心的"退出登录"先关掉自己再进登录门，避免模态窗口叠模态。三、插件顺序编排 * installer.arrange()：编排过的在前、未编排的按名称；管理页卡片加 ↑/↓，侧栏/图标栏/ 管理页三者一致；存 settings 的 plugin_order，只影响显示（不动包与注册表）； * "启动时打开"的默认规则改为"显示顺序里第一个启用的插件"（原来是按 id 排）； * 新增「恢复默认顺序」（编排过才出现）。四、修复 * 收缩侧栏后页面左上角露出一块纯白方块：页面栈对 Qt 是透明的（主题只给 QMainWindow/QDialog 设了背景），侧栏让出的那条在重绘时序里露白。给 QStackedWidget 不透明底色，并加像素级回归用例（撤掉修复即 FAIL，实测 1237 个白像素）； * build_opener() 每次都要隐式枚举 Windows 证书库：全量测试跑几百次后以断点异常崩在证书枚举里（faulthandler 定位在 _load_windows_store_certs）。改成进程内只建一次 SSL context、启动时在主线程预建； * 在途的消息补齐结果会喂给新会话（退出登录时用户名已空 → 拼主题抛异常，被 Qt 回调静默吞掉）：带身份快照，不匹配即丢弃。五、设置界面按类型分页签（插件 / 服务器 / 存储 / 网络 / 诊断） * 每页内容在滚动区里（窗口拉小或以后再加项是滚动条，而不是把控件压扁）； * 新增「消息推送（MQTT）」一节：broker（host / host:port / mqtts://host:8883）、组织、端口、TLS、主题前缀、broker 账号，保存即重连；状态行显示**生效**配置与来源（手配 / 服务端下发）。broker 密码不进界面：默认用登录 token（已加密存储），需要单独的密码时由服务端下发——与"凭据不明文落盘"保持一致。测试与验证 * 新增 tests/test_client_messages.py（主题/封皮/总线，纯层）、tests/test_client_mqtt.py （装配层 + 自建最小 broker 的端到端，不依赖 mosquitto）、test_plugin_server.py 的消息接口与"/api/push → broker → 客户端总线"闭环；WebEngine 冒烟里加了页面级 messages 探针； * **测试入口改为 tests/run_tests.py**：QtWebEngine 在 offscreen 下的解释器退出路径会崩（测试全绿但退出码 139，CI 只看退出码就会判失败），runner 按 unittest 的结果 os._exit 绕开那段清理；测试真崩在中途时退出码照样非 0（用故意失败的用例验证过）。 README 与 CI 都切到这个入口； * 全量 720 条通过（6 skip），exit 0。
2026-09-17 01:06:02 +08:00
parent ae9fc8dbe4
commit e0d5bad7b2
29 changed files with 4105 additions and 105 deletions
@@ -257,10 +257,13 @@ class SettingsTest(VFSTestCase):
        self.assertEqual(
            data,
            {"base_url": "", "auth_token": "", "auth_user": "",
-             "startup_plugin": "", "cache_dir": "",
+             "startup_plugin": "", "plugin_order": [], "cache_dir": "",
             "net_timeout": settings.NET_TIMEOUT_DEFAULT,
             "net_retries": settings.NET_RETRIES_DEFAULT,
-             "proxy": "", "ca_bundle": "", "log_to_file": True},
+             "proxy": "", "ca_bundle": "", "log_to_file": True,
+             "org": "", "mqtt_host": "",
+             "mqtt_port": settings.MQTT_PORT_DEFAULT, "mqtt_tls": False,
+             "mqtt_prefix": "svfs", "mqtt_username": "", "mqtt_password": ""},
        )
        data["base_url"] = "http://10.0.0.5:9000"
        settings.save(self.tmp, data)
@@ -271,10 +274,13 @@ class SettingsTest(VFSTestCase):
        self.assertEqual(
            settings.load(self.tmp),
            {"base_url": "", "auth_token": "", "auth_user": "",
-             "startup_plugin": "", "cache_dir": "",
+             "startup_plugin": "", "plugin_order": [], "cache_dir": "",
             "net_timeout": settings.NET_TIMEOUT_DEFAULT,
             "net_retries": settings.NET_RETRIES_DEFAULT,
-             "proxy": "", "ca_bundle": "", "log_to_file": True},
+             "proxy": "", "ca_bundle": "", "log_to_file": True,
+             "org": "", "mqtt_host": "",
+             "mqtt_port": settings.MQTT_PORT_DEFAULT, "mqtt_tls": False,
+             "mqtt_prefix": "svfs", "mqtt_username": "", "mqtt_password": ""},
        )

    def test_resolve_cache_dir(self):
@@ -587,6 +593,69 @@ class VersionCompareTest(VFSTestCase):
            self.assertEqual(result["current"], "0.1.0")


+class PluginOrderTest(VFSTestCase):
+    """插件顺序编排（纯函数 + 设置持久化）。"""
+
+    @staticmethod
+    def _entry(plugin_id, name):
+        return {"id": plugin_id, "name": name}
+
+    def test_arrange_without_order_keeps_name_order(self):
+        entries = [self._entry("com.b", "Bravo"), self._entry("com.a", "Alpha")]
+        arranged = installer.arrange(entries, [])
+        self.assertEqual([e["id"] for e in arranged], ["com.a", "com.b"])
+        # 空 order 与 None 等价（"从没编排过"这两种写法都可能出现）
+        self.assertEqual(installer.arrange(entries, None), arranged)
+        # 不改动传入的列表（原地排序会污染调用方持有的 payload）
+        self.assertEqual([e["id"] for e in entries], ["com.b", "com.a"])
+
+    def test_arrange_puts_ordered_ids_first(self):
+        entries = [self._entry("com.a", "Alpha"), self._entry("com.b", "Bravo"),
+                   self._entry("com.c", "Charlie")]
+        arranged = installer.arrange(entries, ["com.c", "com.a"])
+        self.assertEqual([e["id"] for e in arranged],
+                         ["com.c", "com.a", "com.b"])  # 未编排的按名称跟后面
+
+    def test_arrange_ignores_uninstalled_ids(self):
+        entries = [self._entry("com.a", "Alpha"), self._entry("com.b", "Bravo")]
+        # com.gone 已卸载：当没看见，剩下两个仍按给定顺序排
+        arranged = installer.arrange(entries, ["com.gone", "com.b"])
+        self.assertEqual([e["id"] for e in arranged], ["com.b", "com.a"])
+
+    def test_arrange_is_stable_for_new_plugins(self):
+        """新装的插件（不在 order 里）落在"未编排"那一档，不干扰已编排的。"""
+        entries = [self._entry("com.a", "Alpha"), self._entry("com.new", "Zulu"),
+                   self._entry("com.b", "Bravo")]
+        arranged = installer.arrange(entries, ["com.b", "com.a"])
+        self.assertEqual([e["id"] for e in arranged],
+                         ["com.b", "com.a", "com.new"])
+
+    def test_plugin_order_roundtrip_and_cleanup(self):
+        base = paths.ensure_layout(self.path("data"))
+        self.assertEqual(settings.plugin_order(base), [])
+        # 去重 + 保序 + 丢掉空值
+        self.assertEqual(
+            settings.set_plugin_order(base, ["com.b", "com.a", "com.b", "", None]),
+            ["com.b", "com.a"],
+        )
+        self.assertEqual(settings.plugin_order(base), ["com.b", "com.a"])
+        # 复位
+        settings.set_plugin_order(base, [])
+        self.assertEqual(settings.plugin_order(base), [])
+
+    def test_plugin_order_survives_bad_values(self):
+        base = paths.ensure_layout(self.path("data"))
+        data = settings.load(base)
+        data["plugin_order"] = "com.a"  # 手改坏成字符串
+        settings.save(base, data)
+        self.assertEqual(settings.plugin_order(base), [])
+        # 返回的是副本：改它不影响模块级默认值（否则后面每次读取都被污染）
+        first = settings.load(base)["plugin_order"]
+        first.append("com.polluted")
+        self.assertEqual(settings.load(base)["plugin_order"], [])
+        self.assertEqual(settings.DEFAULTS["plugin_order"], [])
+
+
 class DiagnosticsTest(VFSTestCase):
    """诊断日志：环形缓冲、报告、自身绝不抛异常。"""