项目定位:Lume 与 lume-qt 是什么关系
先把名字交代清楚,否则后文那一串 lume 开头的符号会让人以为整个项目是用 Lume 写的。
Lume 是一个单二进制的 C11 后端框架:业务逻辑写在 .lume 脚本里,产物是约 1.7 MB 的可执行文件,同时提供静态站点、JSON API、SSE 与原生 SQLite;没有 Node 运行时,也没有独立的前端服务进程。它自己只承担 DSL 这一层,HTTP、会话、MCP 来自静态链接的 agent-httpd。
它写起来是一个服务声明加一条路由,数据直接落 SQLite:
server {
port = medmon_port;
workers = medmon_workers;
bind = medmon_bind;
};
get "/api/medmon/health", (req) => {
let r = try(() => sql_write(db, "DELETE FROM events WHERE id = -1"));
if (r.err != null) {
return { status: 503, body: { ok: false, err: r.err } };
}
return { body: { ok: true, write: true } };
};
引用自 tools/lume-medmon/app.lume:33 至 tools/lume-medmon/app.lume:37 与 tools/lume-medmon/app.lume:169 至 tools/lume-medmon/app.lume:175。这条路由是"零行写入"的写链路探针——不改任何业务数据,但真的打开 SQLite 写事务,因此能发现"读接口正常、POST 已卡死"的状态,比只看进程存活有用。
在 lume-qt 里,Lume 只承担这一个角色:桌面壳把审计上行、阈值下发、健康探针交给这个参考服务,壳侧只需一个环境变量 QTRS_LUME_URL=http://127.0.0.1:8090。本地 JSONL 台账始终是权威,Lume 侧镜像可选且非阻塞,另外提供 medmon_summary、medmon_events、medmon_review 三个只读工具。这个参考实现并不带生产所需的东西——按台次建索引、保留期清理、写侧鉴权,服务本身也默认无鉴权无 TLS,所以只该跑在 loopback 上。
于是本文的五条默认假设全部落在 Qt 这一侧:Lume 既不是 C++ 宿主的运行时依赖,也不是替换对象。后文出现的 lumesink.cpp、isAllowedLumeKey、digestForLume 是"往 Lume 服务上行的那一路"的命名,代码从头到尾是 C++,与 DSL 语法无关。
把职责边界先摆出来,后文五条才好落位:
React / TypeScript 工作台 UI · 3D 体渲染 · 实时看板 · 状态管理
↕ QWebChannel(属性 + 信号;请求由 JS 侧发起,宿主只应答)
Qt / C++ 宿主 窗口生命周期 · 设备通信 · DICOM 解析 · scheme 应答 · 索引落盘
↕ 本地文件 / 本地进程
本地服务 Lume 参考服务(审计上行,可选)· JSONL 权威台账
三条边各有各的协议:app:// 管页面与资源怎么被加载,QWebChannel 管宿主与页面怎么说话,QTRS_LUME_URL 管壳怎么把审计往镜像服务上行。五条替换分别动的是其中一条边,而不是整体架构。
速览(TL;DR)
- 默认路径由「
file://加载静态产物 +QWebChannel注入」组成,在单页、无路由、低频桥接时成立;叠上 history 路由、实时数据与脏数据后,失效点不在 UI。 - 页面改由自定义
app://scheme 提供:宿主应答意味着回退规则有了可写的位置,无扩展名的深链回退已落在resolveRequestPath里;但前端目前没有路由依赖,这条规则暂不会被触发。桥接不受影响,因为官方桥只要求 transport 有send与onmessage。 - 前端产物挂进 C++ 构建链,
make cpp自带前端同步,把「人记得按顺序跑」从纪律变成构建图的一条边。 - 链路健康不能从单帧年龄推断:
SignalState/ChannelHealth/BatchSeries把中断、慢与批量排队分开;DICOM 用hasZ独立标记缺失,而不是拿 0 当哨兵。 - 脱敏不是一条正则的事:路径规则必须先于 UID 规则执行(顺序反过来会留下半截),上行只保留白名单字段、未知字段默认丢弃。
默认路径:起手式与它成立的交集
绝大多数 Qt WebEngine 桌面项目起步时是同一种形态:前端用 Vite / webpack 打生产包,产物落到 resources/web;C++ 侧用 QWebEngineView load 一个 file:// 开头的本地入口;双向通信用 QWebChannel 把一个 QObject 注入页面;构建顺序是"先前端、再 C++、最后一起打包"。
它流行的原因很朴素:把"构建"和"运行"解耦。前端能在浏览器里跑的,塞进 QWebEngineView 大体也能跑;前端工程师不必理解 CMake,宿主工程师不必理解 Vite;产物是纯静态的,塞进任何资源系统都行。对一个"页面 + 几个按钮 + 少量桥接"的工具类应用,几乎零成本。Makefile:7 至 Makefile:10 的四行头部注释就是这套思路的浓缩——目标可单独触发,前端产物定向到 resources/web,C++ 构建消费它。
通信那一半按"注入即用"设计。仓库直接带着 Qt 官方那份 qwebchannel.js:
var QWebChannel = function(transport, initCallback, converters)
{
if (typeof transport !== "object" || typeof transport.send !== "function") {
console.error("The QWebChannel expects a transport object with a send function and onmessage callback property." +
" Given is: transport: " + typeof(transport) + ", transport.send: " + typeof(transport.send));
return;
}
引用自 frontend/public/qwebchannel.js:20 至 frontend/public/qwebchannel.js:27。构造函数只检查 transport 有 send 与 onmessage;消息类型表 QWebChannelMessageTypes(frontend/public/qwebchannel.js:8)只定义 signal、propertyUpdate、init、invokeMethod 这类协议语义,对页面从哪个 URL 加载不作任何假设。于是「file:// + 静态产物 + QWebChannel」成为一个自洽的最小闭环。
它的成立交集比想象中窄:单页、无 history 路由、打包资源不依赖绝对根路径、前端只在发布时构建一次、链路低频、数据干净、单实例靠约定。落在交集里(工具型桌面壳、内部演示、只读面板),默认路径的简洁性是真实优势,没有理由为了"架构上更漂亮"去替换它。
但套路里有两处省略被当成永远成立:一是"页面加载方式与业务逻辑无关",二是"前端产物何时重建由人按对顺序决定"。这两处省略在实时数据、脏数据与数据出端的场景里会延伸出五个具体失效点,下面逐条给出替换机制。
五条替换
一、页面加载:file:// → 自定义 app:// scheme
失效:页面一旦用 history 路由,或打包资源用绝对根路径引用,file:// 就没有服务端回退可依赖,深链接刷新直接落到空路径。这不是"不够优雅",是"不工作"。
替换:给页面一个自己的 scheme,由宿主应答请求。但要说清它买到的是什么:一个可以写入回退规则的位置,不是回退本身。file:// 的困境不是"少一个 handler",而是根本没有地方能写回退;换成 app:// 之后位置有了,规则写不写、怎么写,仍由宿主决定。
证据:这条不是口头宣布,而是启动路径里的一段硬性注册,位置还有顺序约束:
// 注册自定义 scheme 必须在 QApplication 构造之前,
// 否则 Qt WebEngine 会拒绝使用未注册的 scheme。
QWebEngineUrlScheme scheme("app");
scheme.setSyntax(QWebEngineUrlScheme::Syntax::Host);
引用自 src/main.cpp:123 至 src/main.cpp:126。注册只是把 scheme 立起来,划定安全边界的是 flags,这里五个一起给:
scheme.setFlags(
QWebEngineUrlScheme::Flag::SecureScheme
| QWebEngineUrlScheme::Flag::LocalScheme
| QWebEngineUrlScheme::Flag::LocalAccessAllowed
| QWebEngineUrlScheme::Flag::CorsEnabled
| QWebEngineUrlScheme::Flag::FetchApiAllowed);
引用自 src/main.cpp:130 至 :135。五个 flag 各管一件事:该 scheme 是否被当作安全上下文、是否属于本地资源、本地访问是否放开、是否允许跨源、是否允许 fetch。全开有具体理由——体积二进制由页面 fetch 取走、资源与页面同源、数据层要跨源访问;但这也是本项目信任面最宽的一处配置,等于把五条权限一次性推到接近 https 的宽度。改这里应当逐条说明理由,而不是当模板照抄。
再往下是"谁来应答"。AppSchemeHandler 只有四条分支:
| 请求 | 处理 | 出处 |
|---|---|---|
app://app/ |
空路径归一化成 index.html |
src/schemepath.cpp:17 至 :19 |
app://app/console(无扩展名深链) |
同样归一化成 index.html |
src/schemepath.cpp:23 至 :26 |
app://app/__volume/current.bin |
不走文件系统,交给 provider 供数 | src/appschemehandler.cpp:31 至 :35 |
app://app/assets/index-abc.js |
读磁盘文件,按扩展名给 MIME | :56 至 :91 |
| 其他不存在的路径(含目录穿越) | UrlNotFound,不做改写 |
:46 至 :54 |
回退规则本身不长,但必须单独存在:scheme::resolveRequestPath(src/schemepath.cpp:10 至 :29)只做三件事——去掉前导 /、空路径回入口页、无扩展名的路由式路径一律当成 index.html。字符集限定为字母数字与 / _ -,所以 /../etc/passwd 这类带点的路径不会被悄悄洗成首页,仍旧交给 canonical 校验去 404。handler 里只剩一句调用(src/appschemehandler.cpp:29),"谁来应答"与"怎么回退"就此分开。
这条规则有单测兜着:tests/scheme_path_test.cpp 覆盖根路径、/console 与 /review/7 两种深链、资源透传、虚拟资源透传、可疑路径不被改写五种情况,ctest 里跑成 SchemePathUnitTests。
桥接侧不受影响:官方桥只要求 transport 有 send 与 onmessage(frontend/public/qwebchannel.js:20 至 :27),协议类型与 URL scheme 无关(:8)。
边界:没有 history 路由、资源也不依赖绝对根路径时,换 scheme 只是平白多一份处理器代码。本项目正处在这个状态——前端没有路由依赖(frontend/package.json 里没有 react-router、wouter),回退规则写好了也永不触发,所以它买到的是"以后加路由时不必回头改宿主",而不是"现在就少了 404"。
二、构建时机:从人的顺序到构建图的边
失效:前端与 C++ 共享同一套数据契约时,"人记得按对顺序跑"撑不住。忘跑前端、跑了旧产物、C++ 侧看到上一版 resources/web,表现都是"代码是对的、跑出来是错的",而且没有一处会主动报错。这不是某个构建系统的缺陷,是把两套构建解耦这一设计付出的代价。
替换:把前端构建挂进 C++ 的依赖链。make cpp 因此不再是"只编 C++",而是"配置 + 编译 C++,同时前端被同步"。
证据:Makefile:7 至 Makefile:8 的两行头部注释不是修辞,是对构建图的描述;真正钉住它的是 CMake 那条 ALL 目标:
add_custom_target(frontend-build ALL
COMMAND "${BASH_EXECUTABLE}" "${CMAKE_CURRENT_SOURCE_DIR}/scripts/frontend-build.sh"
COMMENT "Building React frontend (Vite) → resources/web (skipped if unchanged)"
VERBATIM
)
引用自 CMakeLists.txt:44 至 CMakeLists.txt:48。ALL 是关键词:前端从"可选目标"变成"每次构建的默认前置",不靠 Makefile 里的书写顺序。脚本内部比对前端源码有无变化、没变就跳过,所以没有把增量构建退化成全量重跑;configure 目标在 build.ninja 已存在时也跳过 CMake 配置,让 ninja 自己去 regenerate(Makefile:70)。构建变量在文件顶部固定、并可由环境变量覆盖(Makefile:15 至 :17、Makefile:12),换机器不会退化成写死的单条路径。
边界:Web 页面只是可选调试面板、不参与主界面时,把前端挂进主构建链就是拖慢编译。
三、链路健康:从单帧年龄到按通道建模
失效:桥通了只说明消息能收发。到达时间会因渲染进程忙、合成器排队、页面不可见被整体偏移;渲染进程繁忙时,同一轮事件循环内到达的多次更新会被一次读走,QWebChannel 不会标注哪一段是积压样本合并投递,单看某一帧的年龄,就会把"批量排队"误判成"链路慢"。另一层是时钟源:实时样本的 tsUs 是采集时刻,DICOM 体积的 tsUs 是宿主侧解析完成时刻,一律按设备时钟扣偏移会算出荒谬的年龄。
替换:把每个通道的到达时间做成带状态的统计模型——状态集合显式定义、阈值按通道分别给、批量投递与真实延迟分开判定。
证据:Channel(frontend/src/latency.ts:14)、SignalState(:17)、ChannelHealth 里的 ageMs 与 staleAfterMs(:19 至 :24)把"中断"从 UI 观感变成可查询的量;BatchSeries 的 samples、gaps(:146)把延迟与积压拆开;volume 被归入 HOST_STAMPED_CHANNELS(frontend/src/latency.ts:115),因此不参与设备时钟偏移扣除。
时基这一步值得单独说:frontend/src/latency.ts:65 用的是 performance.timeOrigin + performance.now()(模块注释在 :9)。performance.now() 是单调时钟,timeOrigin 把单调读数锚到墙钟原点,因此算间隔不受系统时间被 NTP 校正或用户改表影响;而体积通道的 tsUs 是 DICOM 解析完成时的墙钟时刻。两者语义不同,混算就是错。
边界:这套模型只在链路是持续数据流时成立。alarm 是事件型通道,只记"这一次花了多久",没有年龄/中断语义;volume 是数秒量级的一次性解析,套 100 ms 的链路预算会永远判慢,所以它有单独的预算。
四、字段缺失:从零值哨兵到存在性标记
失效:DCMTK 的 findAndGetFloat64 在标签缺失时把出参写成 0。于是"直接读 rescale slope"在常常没有 Rescale 标签的 MR 序列上拿到 slope=0,整个体积全零、黑屏;样例脑部 T1 恰好显式写了 1/0,这个坑长期被掩盖。同类问题还有位深:16 位数据做 >> 8 截断,有效值会被抹平。
替换:读不到就显式回落到调用方设定的初值;存在性用独立字段,而不是让数值兼任哨兵;位深按原始宽度保存。
证据:坑与回落都写在同一个文件里——注释交代 DCMTK 的行为,代码把回落写死在两条 bad() 分支上:
// rescale slope / intercept(CT 常非 1/0,MR 多为 1/0,但不可假定)
//
// 注意:DCMTK 的 findAndGetFloat64 在标签缺失时会把出参写成 0(不是保留
// 原值)。之前直接 `findAndGetFloat64(DCM_RescaleSlope, slope)` 会让没有
// Rescale 标签的序列(MR 很常见)变成 slope=0 → 整个体积全零 → 黑屏。
// 样例脑部 T1 恰好显式写了 1/0,所以这个坑一直被掩盖。
double slope = 1.0, intercept = 0.0;
if (ds->findAndGetFloat64(DCM_RescaleSlope, slope).bad())
slope = 1.0;
if (ds->findAndGetFloat64(DCM_RescaleIntercept, intercept).bad())
intercept = 0.0;
引用自 src/dicomreader.cpp:90 至 src/dicomreader.cpp:100——回落值必须显式写出来,否则调用方设定的 1.0 / 0.0 会被那个 0 吃掉。
同一思路在结构上更清楚:Slice 把"有没有 Z"拆成独立字段,raw 按原始 16 位保存。
struct Slice {
std::vector<uint16_t> raw; // rows × cols(行主序),8 位数据也统一存为 uint16
int rows = 0;
int cols = 0;
double z = 0.0; // 空间 Z(ImagePositionPatient 第 3 轴)
bool hasZ = false; // 是否真的读到了 Z —— 不能用 z==0.0 当哨兵
引用自 src/dicomreader.cpp:28 至 src/dicomreader.cpp:33。hasZ 单列是为了避免 z==0.0 兼任哨兵,raw 用 std::vector<uint16_t> 是为了保住完整位深——两条理由都写在注释里,而不是事后总结。
这条回落目前没有单元测试兜住:仓库 tests/ 下只有 bridge_test.cpp 与 volume_stats_test.cpp,DICOM 解析没有对应用例。要补的话,最小矩阵是这四行:
| 场景 | slope / intercept | 期望 |
|---|---|---|
| CT 显式写了 Rescale | 2 / -1024 | 按原值换算,不回落 |
| MR 缺 Rescale 标签 | 读不到(DCMTK 已把出参写成 0) | 回落 1 / 0,体积不为零 |
| 显式写零值 | 0 / 0 | 按真实零值处理,不被回落覆盖 |
| 缺 ImagePositionPatient | 无 Z | hasZ=false,不参与层间距计算 |
前三行验的是"回落没有把合法的 0 也吃掉",第四行验的是"缺失没有被值域冒充"——这正是 Slice 那个布尔字段的用武之地。
边界:只有"零是合法取值"的字段才需要这一位布尔;某个格式里 0 天然等于"没有",哨兵写法更省事。
五、脱敏:从字符串正则到分层最小化
失效:脱敏被简化成"上线前跑一遍正则"时,它是否成立取决于两件很少被写下来的事——命中顺序,和有没有兜底白名单。路径里常嵌 DICOM UID(/data/1.2.840.113619…/slice.dcm 这种形态),先跑 UID 规则会把路径从中间切断、留下一截更显眼的裸路径;黑名单也永远追不上新增字段,厂商加一个新 tag、调试多打一个字段,数据就出去了。
替换:拆成三段固定顺序——路径折叠、UID 折叠、字段白名单;但要说准射程:这是字符串层的最小化,不是完整去标识化。PHI 不止在路径和 UID 里。
证据:scrubText(src/lumesink.cpp:23)里路径规则先于 UID 规则执行,字符类允许空格以便覆盖 Application Support 这类目录名;UID 规则用 \d+(?:\.\d+){2,} 让三段式的 2.25.<整数> 也不漏网,代价是形如 IPv4 的字符串被一并折掉。
QString scrubText(const QString &text)
{
QString out = text;
// 路径先于 UID 折叠:路径里常带 DICOM UID,先吃掉整段才不会留下半截。
// 字符类允许空格(macOS 的 "Application Support" 这类目录名很常见),
// 到句子标点或换行停止;宁可连尾随描述一起折掉,也不能留下半截路径。
static const QRegularExpression homePathRe(
QStringLiteral("~/[^\\r\\n,;\"'。;,、]+"));
static const QRegularExpression windowsPathRe(
QStringLiteral("[A-Za-z]:[\\\\/][^\\r\\n,;\"'。;,、]+"));
static const QRegularExpression unixPathRe(
QStringLiteral("(?:/Users|/home|/private|/tmp|/var|/opt|/Library|/Applications|/System|/Volumes)"
"/[^\\r\\n,;\"'。;,、]+"));
// DICOM UID 可以只有三段(2.25.<整数> 是 UUID 派生形式);旧正则要求五段,
// 会把 2.25.* 与 1.2.840.10008 这类短 UID 原样放行。IPv4 与此同形,会一并
// 折叠成 <uid>,属于可接受的过度脱敏:本地 JSONL 仍是完整权威记录。
static const QRegularExpression uidRe(QStringLiteral("\\d+(?:\\.\\d+){2,}"));
out.replace(homePathRe, QStringLiteral("<path>"));
out.replace(windowsPathRe, QStringLiteral("<path>"));
out.replace(unixPathRe, QStringLiteral("<path>"));
out.replace(uidRe, QStringLiteral("<uid>"));
return out;
}
引用自 src/lumesink.cpp:23 至 :45。
标识字段的稳定化由 digestForLume 承担:lume-qt| 前缀加 SHA-256 再取前 16 位十六进制(src/lumesink.cpp:16 至 :20),同一值在本项目域内稳定,在别处使用 SHA-256 时不会撞成同一个可关联标识。
边界:按层看,这套东西只做完了两层,第三层是空的。
- 第一层,字符串折叠:覆盖的是"已经进入字符串的路径与 UID",仅此而已。
- 第二层,key 白名单:
sanitizeValue对 object / array 递归(src/lumesink.cpp:206至:217),所以嵌套层级不会漏键;但isAllowedLumeKey是按 key 授白名单,不是按路径。同一个 key 在 A 处是时序(ageMs),在 B 处可能就是自由文本,平面白名单分不出来。要更强,得改成按路径授白名单。 - 第三层,数据存储侧:本地 JSONL 仍然是敏感数据。不上云不等于安全——文件权限、保留期、备份与清理都不在这三条正则的职责里;
prunePacsStoreIfConfigured只是把"默认不删"守住,不等于有留存策略。
还有一类东西根本不在这套机制射程内:PatientName、InstitutionName、私有 tag、自由文本描述、异常与调试输出。scrubText 处理的是字符串,不是数据模型,所以它看不见"这个字段本身就叫患者姓名"。
这也是这节标题必须改的原因:原名"从一条正则到三段固定顺序"容易让人以为三条正则就是一套脱敏方案。准确的说法是字符串层固定顺序 + 结构层 key 白名单,合起来只是分层最小化的前两层。
边界:交集之外,以及不能越过的线
把五条反过来读,就是仍该走默认路径的判据。与其散在段落里,不如摆成一张表——从左往右读是"什么条件该换",从右往左读是"什么条件该留":
| 项目条件 | 该走的路 | 为什么 |
|---|---|---|
| 单页、无路由、资源不直接依赖绝对根路径 | file:// |
换 scheme 只多一份 handler |
| SPA、history 路由 | app:// + 显式回退规则 |
scheme 只提供可写回退的位置,规则要自己写 |
| 前后端共享数据契约 | 前端构建挂进构建图 | 人的顺序撑不住产物一致性 |
| 持续实时数据流 | 通道级健康模型 | 单帧年龄分不开积压与延迟 |
| 零值可能是合法值 | 显式存在性标记 | 数值兼任哨兵会吞掉真实的 0 |
| 医疗数据对外上行 | 字符串层折叠 + key 白名单 | 黑名单追不上新增字段 |
这张表不是让步清单,是同一件事的正反面:左边条件不成立时,右边那套机制换来的只有复杂度。
还有几条即使前提满足也不该越过的线,越过去就不是取舍而是错误。一是去标识化的方向:isAllowedLumeKey 写明上行只保留审计/时序需要的字段,未知字段一律丢弃——漏字段的代价是 PHI 出端,远大于少一个字段,改成"默认放行 + 黑名单"等于把纵深防御换成单点;scrubText 里路径规则先于 UID 规则同理,顺序颠倒会留下半截。二是时钟源分离:体积通道的 tsUs 是宿主时间,为"统一处理更简洁"而合并,会让看板上的年龄变成假数。三是保留期清理不能被当成默认开启:prunePacsStoreIfConfigured 在环境变量为空或数值非正时直接返回(if (env.isEmpty()) return; 与 if (days <= 0) return;,src/bridge.cpp:25 至 :29),去掉这层判断,就把"默认不删数据"变成了"默认删数据"。
四是进程唯一性。应用数据目录与体渲染偏好都是单写者假设,第二个实例起不来不是洁癖,是防止两份进程互相覆盖同一批文件。这里没有随手用 QLockFile:它的「陈旧」判定同时看文件年龄与进程存活,把 staleLockTime 设成 0 又会连带关掉存活检查,进程被 kill -9 之后反而再也起不来(src/main.cpp:35 至 :41 的注释就是这段取舍)。抢锁靠 O_CREAT | O_EXCL 独占创建并写入自己的 pid,过期锁的处置只认 PID 存活:
// 持有者还活着(EPERM 说明进程存在但属于别人)→ 拒绝启动。
if (pid > 0 && (::kill(static_cast<pid_t>(pid), 0) == 0 || errno == EPERM)) {
if (holderPid) *holderPid = pid;
return false;
}
// 死进程留下的锁:清掉,下一轮重新用 O_EXCL 抢。
QFile::remove(path);
节选,src/main.cpp:57 至 :63,函数自 :42 起,注释在 :35 至 :41。
要验证这些边界,最省事的做法是用仓库自带目标把替换前后各跑一遍:
make all # 完整构建(前端 + C++),见 Makefile:37
make bridge_test # 只验桥接层,见 Makefile:195
make cpp # 配置 + 编译 C++,顺带同步前端,见 Makefile:8
make frontend # 仅构建前端(产物 → resources/web),见 Makefile:7
make clean # 清理 build 与前端产物,见 Makefile:86
差别不在命令行长短:前者需要人保证顺序,后者由构建图保证顺序。
一句话:反常识不等于普遍真理。默认路径在它的交集里是对的,这套替换在它的前提里也是对的;工程判断的落点从来不是"哪条路更先进",而是"当前项目踩在哪个交集里"。
源码导航
仓库:https://github.com/erishen/lume-qt
MakefileCMakeLists.txtfrontend/public/qwebchannel.jsfrontend/src/latency.tssrc/main.cppsrc/dicomreader.cppsrc/lumesink.cppsrc/bridge.cpptools/lume-medmon/app.lume
为什么不直接用 file:// 加载打包好的前端?
file:// 没有服务端回退,history 路由的深链接刷新会落到空路径,绝对根路径引用的打包资源也解析不到。页面一旦需要 SPA 路由或自定义缓存策略,这条路就不成立,lume-qt 因此改由自定义 app:// scheme 提供页面。
为什么不能只看单帧年龄判断链路好坏?
渲染进程忙碌时 QWebChannel 会把多个信号合并投递,单帧年龄会把”批量排队”误判成”链路慢”。latency.ts 用 ChannelHealth 的 ageMs、staleAfterMs 判中断,再用 BatchSeries 的 samples、gaps 把延迟与积压分开,见 frontend/src/latency.ts:146。
DICOM 的 rescale slope 读不到时会怎样?
DCMTK 的 findAndGetFloat64 在标签缺失时把出参写成 0,常无 Rescale 标签的 MR 序列就会拿到 slope=0,整个体积全零。lume-qt 改成读不到就回落到调用方设定的初值,并把”缺失”写成独立状态而不是让 0 兼任哨兵,见 src/dicomreader.cpp:33。
什么情况下应该保留默认路径?
单页、无路由、低频桥接、数据干净、单实例靠约定能撑住的应用,默认路径仍是最简解;自定义 scheme、构建链同步、通道级健康模型都是为特定约束付的代价,约束不存在时替换只是多一份代码。
发表回复