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。
This commit is contained in:
@@ -28,7 +28,7 @@ PLUGIN_ID = "com.svfs.demo"
|
||||
#: 版本 → 说明(2.0.0 有可感知的变化,用来演示升级与回滚)
|
||||
CHANGELOG = {
|
||||
1: "初始版本",
|
||||
2: "v2:新增主题色切换与变更记录",
|
||||
2: "v2:新增主题色切换、消息订阅与变更记录",
|
||||
}
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ def _manifest(version):
|
||||
"api_version": PLUGIN_API_VERSION,
|
||||
"entry": "index.html",
|
||||
"icon": "icon.svg",
|
||||
"permissions": ["storage", "notify", "title", "net", "dialog"],
|
||||
"permissions": ["storage", "notify", "title", "net", "dialog", "messages"],
|
||||
"description": "演示/调试客户端桥的全部能力(host.info / storage / net / notify / title / 原生对话框)。",
|
||||
}
|
||||
|
||||
@@ -159,6 +159,17 @@ _INDEX_TEMPLATE = """\
|
||||
<pre id="net-out" class="note">未请求。相对 path 会拼在客户端配置的服务器地址后。</pre>
|
||||
</section>
|
||||
|
||||
<section class="card">
|
||||
<h2>消息(messages 权限,服务端主动推送)</h2>
|
||||
<p class="note">服务端按插件 id 定向推送的消息;这类消息不进宿主的消息中心。</p>
|
||||
<div class="row">
|
||||
<button id="msg-listen">开始订阅</button>
|
||||
<button id="msg-clear">清空记录</button>
|
||||
<span class="note">已收 <b id="msg-count">0</b> 条</span>
|
||||
</div>
|
||||
<pre id="msg-out" class="note">未订阅。</pre>
|
||||
</section>
|
||||
|
||||
<section class="card">
|
||||
<h2>通知 / 标题(notify / title 权限)</h2>
|
||||
<button id="notify">发一条原生通知</button>
|
||||
@@ -287,6 +298,30 @@ async function main() {
|
||||
}
|
||||
};
|
||||
|
||||
// ---- messages:订阅服务端推给本插件的消息(需要 messages 权限)----
|
||||
var msgCount = 0;
|
||||
var msgLines = [];
|
||||
$("msg-clear").onclick = function () {
|
||||
msgCount = 0; msgLines = [];
|
||||
$("msg-count").textContent = "0";
|
||||
show("msg-out", "(已清空记录)");
|
||||
};
|
||||
$("msg-listen").onclick = function () {
|
||||
if (!svfs.messages) {
|
||||
show("msg-out", "这个宿主没有 messages 能力(需要客户端支持桥 API v5+,"
|
||||
+ "且清单里声明 messages 权限)");
|
||||
return;
|
||||
}
|
||||
svfs.messages.subscribe(function (message) {
|
||||
msgCount += 1;
|
||||
$("msg-count").textContent = String(msgCount);
|
||||
var body = message.json ? JSON.stringify(message.json) : message.text;
|
||||
msgLines.unshift("[" + msgCount + "] " + body);
|
||||
show("msg-out", msgLines.slice(0, 20).join("\\n"));
|
||||
});
|
||||
show("msg-out", "已订阅,等待服务端推送…(仪表盘数据这类业务载荷走的就是这条路)");
|
||||
};
|
||||
|
||||
// ---- notify / title ----
|
||||
$("notify").onclick = function () {
|
||||
svfs.ui.notify("来自 " + info.pluginId + " 的通知(" + PLUGIN_VERSION + ")");
|
||||
|
||||
Reference in New Issue
Block a user