Fluent-Qt

API 参考

DiagnosticSession

在内存中采集有限容量的界面状态与可选日志诊断会话。界面相关方法须在 GUI 线程调用;快照会自动过滤控件文本与路径,日志正文仅在显式开启时记录(不会自动脱敏)。

fluent::diagnostics::DiagnosticSession

继承自 QObject

构造函数

属性

bool recording
读取 isRecording()变化信号 recordingChanged()

方法

bool start(QWidget* root, bool includeLogMessages = false, int maximumDurationMs = 300000)

为 @p root 启动诊断录制(控件仍由应用管理,不会随会话销毁);若已在录制中则返回 false。@p maximumDurationMs 为 0 时持续记录直到手动停止,正值则在指定毫秒后自动停止。

void stop()

停止录制并采集最终界面快照。

void clear()

停止录制并清空所有已采集的数据。

QVariantMap report() const

返回已采集的 JSON 检查报告(QVariantMap 格式)。

QVariantMap captureReport()

在不中断录制的情况下采集当前界面的 JSON 检查报告(仅限 GUI 线程调用)。

static QByteArray createBundle(const QVariantMap& report, const QVariantMap& attachments = {})

在内存中将 report.json 与可选附件打包为 ZIP(上限 20 MiB);若附件名无效或超出大小上限则返回空数组。

static QVariantMap environment()

返回运行环境基本信息(不含主机名和本地路径)。

void recordMessage(QtMsgType type, const QString& category, const QString& message)

记录一条日志消息;在会话存活期间可从工作线程安全调用。

MessageSink messageSink() const

返回线程安全的日志接收回调;会话销毁后自动失效。

信号

类型与别名

析构函数

受保护成员

方法

Qt 基类文档:QObject