Console 控制台日志¶

用于输出系统运行时的控制台日志。支持日志多级高亮、行数限制、自动滚动、一键清除，并自动适配 68 种主题样式。

基础用法¶

控制台日志

from monkeyqt import MkConsole

# 创建控制台组件，可指定标题
console = MkConsole("系统运行日志 / System Logs")

# 打印不同级别的日志
console.info("系统初始化中...")
console.success("核心引擎加载成功！")
console.warn("内存占用较高，请注意。")
console.error("网络连接失败，请检查配置。")
console.debug("调试信息: port=8080, retry_count=3")

功能配置¶

行数限制（防止内存泄露）¶

默认最大保留 1000 行日志，超过的部分会自动裁剪：

# 设置最多保留 500 行日志
console.set_max_lines(500)

自动滚动与时间戳¶

可以动态控制是否在输出新日志时自动滚动到底部，以及是否在日志前显示当前时间戳：

# 启用/禁用自动滚动
console.set_autoscroll(True)

# 显示/隐藏时间戳
console.set_show_timestamp(True)

一键清除¶

提供清除按钮，也可以通过代码一键清空日志和统计计数器：

# 清空所有日志
console.clear()

API¶

构造函数¶

MkConsole(title="控制台日志 / Console Logs", parent=None)

参数	类型	默认值	说明
`title`	`str`	`"控制台日志 / Console Logs"`	控制台顶部的标题文本
`parent`	`QWidget`	`None`	父组件

方法¶

方法	参数类型	说明
`log(text, level="info", timestamp=True)`	`text: str`, `level: str`, `timestamp: bool`	核心日志输出接口。`level` 可选 `"info"`, `"success"`, `"warning"`, `"error"`, `"debug"`
`info(text)`	`text: str`	快速输出 `INFO` 级别日志（主色调高亮）
`success(text)`	`text: str`	快速输出 `SUCCESS` 级别日志（绿色高亮）
`warn(text)`	`text: str`	快速输出 `WARNING` 级别日志（黄色高亮）
`error(text)`	`text: str`	快速输出 `ERROR` 级别日志（红色高亮）
`debug(text)`	`text: str`	快速输出 `DEBUG` 级别日志（灰色高亮）
`clear()`	无	清空控制台的所有文本，并将各类级别日志计数器归零
`set_max_lines(limit)`	`limit: int`	设置最大保留行数限制，防止日志过多造成内存泄露
`set_autoscroll(enabled)`	`enabled: bool`	设置新日志追加时，是否自动将滚动条移动到最下方
`set_show_timestamp(show)`	`show: bool`	设置是否在每条日志的最前面添加 `[HH:MM:SS]` 时间戳

继承与主题适配¶

MkConsole 继承自 QWidget，其自身已完美整合 68 种设计风格。当开启主题引擎时，其配色、边框与字体会与全局主题无缝适配。