Serial Studio 终端滚动体验重构交互式滚动条、可配置 Scrollback 与 Text/Hex 标签规范【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文围绕 Serial Studio 开源遥测仪表盘仓库中的设计规范 Spec 0006 — Terminal scrollbar, configurable scrollback, and Text/Hex display labels 展开结合其控制台Console终端控件的真实源码实现、设置持久化逻辑与 LLM 翻译管线系统讲解三项控制台体验改造可拖拽、可翻页的交互式滚动条范围 100–100,000 行的可配置滚动回退scrollback缓冲以及 Text / Hex 显示模式标签的国际化固定pinning。读完本文你将理解这些改动背后的设计约束、验收标准以及它们在 Serial Studio 源码中的具体落点。背景与动机控制台终端的三个痛点Serial Studio 的 Console 终端Terminal控件是面向串口、BLE、MQTT、Modbus、CAN 等数据源的核心输出视图。在 Spec 0006 立项时该控件存在三个可观察的体验问题滚动条是装饰性的控制台仅在自动滚动autoscroll解除时绘制一根细薄的滑块thumb它既无法被拖拽点击轨道也不会翻页而在数据持续流入autoscroll 开启时用户完全看不到历史缓冲区有多大、视口停在何处。从 PuTTY、minicom、Arduino IDE 等串口监视器迁移而来的用户天然期望一个真滚动条。滚动回退被硬编码为 1,000 行长时间捕获会静默丢失最早的记录用户排查几分钟前的偶发事件时数据早已被逐出缓冲区没有途径用内存换取历史深度上限不可见也不可配置。显示模式标签本地化效果差当时选项文案为 Plain Text / Hexadecimal经过机器翻译变成 Hexadezimal、Klartext 等冗长且各不相同的本地化词撑爆了下拉框而 Hex 本就是各目标语言通用的技术缩写理应保留为 Text / Hex 两个短标签且 Hex 在每种语言中必须逐字节一致——这是当时的 LLM 翻译管线无法对精确匹配术语提供的保证。目标与非目标规范确立的目标有三观看实时数据流的用户能一眼看到 scrollback 存量并能像原生终端一样拖拽、点击滚动条浏览历史用户可在承载其他控制台选项的同一设置界面中配置控制台历史保留行数且设置跨重启生效控制台显示模式下拉框在英文源中显示 Text / Hex且 Hex 在每次翻译运行时、每个发布语言中都精确呈现为 Hex无需人工逐语言复查。同时明确划定边界Non-Goals不改动 VT-100 仿真、选择、复制、渲染管线滚动条交互所必需的除外不做按仪表盘实例widget 级的 scrollback 覆盖仅设一个全局设置不新增滚动回退搜索与导出现有控制台导出功能保持不变不改动数据发送行的 ASCII/HEX 标签及任何其他翻译字符串也不对既有语言做超出 Hex 规则本身的受保护术语批量重译。需求总览R1–R7编号需求要点R1交互式滚动条内容超过视口且用户离开实时尾部autoscroll 解除时显示滑块——仅滑块、无轨道条autoscroll 开启时保持无额外界面元素可拖拽滑块、可点击/翻页于不可见的轨道带滚轮行为保持现状R2滚动交互与 autoscroll 联动手动离开底部拖拽、轨道点击、滚轮上滚解除 autoscroll滚回底部或任何既有重新接合手势重新启用避免读者被强拉回尾部也无需寻找开关R3滚动条反映缓冲区位置滑块大小与位置跟踪可见比例与偏移随数据流入实时更新LTR 与 RTL 布局均正确R4可配置 scrollback控制台工具栏 Settings 弹窗与设置对话框 Console 节提供行数选项范围 100–100,000默认 1,000随其他控制台设置跨重启持久化R5scrollback 实时生效修改无需重启调低至当前行数以下立即裁掉最旧行调高则缓冲可增长到新上限裁剪后光标位置、选区状态、滚动偏移保持一致无崩溃、无颜色错位、无越界光标R6Text/Hex 标签显示模式选项在英文源中为 Text 与 Hex在所有出现该选项对的位置控制台工具栏与设置对话框一致R7Hex 翻译固定LLM 翻译管线识别精确源串 Hex 并使用手工策展的逐语言译文替代模型翻译拉丁文字语言保留 Hex西里尔与 RTL/Indic 文字使用标准转写Хекс、هيكس、הקס、हेक्सCJK 使用本族词16進、16진수、十六进制固定规则对每次未来翻译运行生效而非一次性修补规范还注明两处 2026-07-13 的修订AmendmentsR1 从初稿的始终可见轨道滑块回退为autoscroll 期间隐藏、仅滑块R4 补充说明控制台工具栏及其 Settings 弹窗在草案之后落地commit9c4c32d9该弹窗即原始需求中的控制台内设置菜单R7 从初稿所有语言一律 Hex改为逐语言策展值。验收标准AC1–AC6规范给出六条可直接验证的验收标准且状态均为已完成[x]AC1滚动条交互在运行中的应用中累积超过一视口控制台数据后——autoscroll 开启时无滚动条滚轮上滚显示滑块拖拽可回刷历史点击滑块上方/下方翻页拖拽或滚动到底部恢复 autoscroll 并隐藏滑块。维护者 LTR 与 RTL 双向观察。AC2配置入口控制台工具栏 Settings 弹窗与 Settings → Console 均显示 scrollback 选项输入 100 与 100,000 被接受范围外值被拒绝或钳制重启后值仍然生效。AC3实时裁剪在 100,000 上限下缓存 5,000 行时于 Settings 中将上限降至 100缓冲区立即收缩为最新 100 行无崩溃、无颜色错乱、无滚动位置卡死——包括数据流式写入过程中。AC4标签显示模式下拉框英文显示 Display: Text / Display: Hex切换仍正常启用十六进制渲染。AC5翻译固定对再生成的字符串目录运行 LLM 翻译管线后源串 Hex 在每个语言.ts文件中写入策展值如ru_RU/uk_UA为 Хекс、zh_CN为 十六进制、拉丁文字语言为 Hex且管线自身输出/日志显示该字符串被固定pinned而非模型翻译。可通过翻译运行后对.ts文件的脚本化检查验证。AC6性能回归门槛--benchmark-hotpath仍通过全部门槛在默认 1,000 行设置下控制台改动对每次追加无可测回归。CI 门槛。约束与不变量流式性能是决定性约束控制台必须在高数据率下保持流畅滚动条交互与可配置上限不得引入随缓冲区大小增长的每次追加分配或簿记。降低上限允许在设置变更的瞬间做一次成比例的工作——而不是每帧。裁剪与上限变更必须让文本行、逐字符颜色行、光标、选区保持同步——颜色缓冲区错位是此控件曾出现过的已发布缺陷类别。在 100,000 行上限且启用 ANSI 颜色时的内存占用最坏情况必须保持在数百 MB 的低位范围即按此边界选取。默认行为完全保留从不触碰新设置的用户得到与今天完全一致的 1,000 行缓冲与滚轮/键盘行为。重命名后的标签走正常翻译流程任何语言不得出现两个重命名选项的空项或过期项。不引入新依赖不改动帧解析热路径。源码实现纵深滚动条如何真正可交互Spec 的 R1–R3 在core/Ui/UI/Widgets/Terminal.cpp中得到了完整落地。该控件维护m_autoscroll与m_scrollOffsetY两个核心状态滚动条的几何与交互全部由一组纯几何函数驱动scrollbarTrackRect()Terminal.cpp返回全高轨道矩形宽度固定为 6 像素并依据m_translator.rtl()在 RTL 布局下镜像到左侧——这正是 R3 要求LTR 与 RTL 双布局正确的实现位置。scrollbarThumbRect()Terminal.cpp按可见比例计算滑块高度availableHeight * availableHeight / lines并施加 20px 最小高度与轨道一半的最大高度再按当前m_scrollOffsetY与lineCount() - linesPerPage()的比例映射滑块 Y 坐标。滑块随数据流入实时重算满足 R3 的位置反映缓冲区。handleScrollbarPress()Terminal.cpp命中滑块内则进入m_draggingScrollbar拖拽态并解除 autoscroll命中滑块上方/下方则按一页linesPerPage()向上/向下翻页——即 AC1 中点击翻页的交互鼠标移动、释放、抓取丢失时分别在对应事件处理器中更新偏移与清除拖拽态Terminal.cpp。applyScrollbarOffset()Terminal.cpp将 R2 的联动规则集中实现——滚出底部clamped maxOffset且 autoscroll 开启时自动解除滚回底部clamped maxOffset时自动重新接合。paintScrollbar()Terminal.cpp仅当 autoscroll 关闭且内容超出一屏时绘制圆角滑块与 R1 修订后的autoscroll 期间保持无额外界面元素完全一致。从这些实现可以看出规范中滚动条交互不得进入帧解析热路径的约束如何被满足所有交互逻辑都发生在用户输入事件鼠标按下/移动/滚轮与绘制路径上缓冲区追加路径不感知滚动条。源码实现纵深可配置 scrollback 的持久化与实时裁剪设置存储与钳制R4scrollback 行数由 Console 会话处理器Console::Handler统一管理。在 Handler.cpp 中设置从QSettings读取m_scrollbackLines m_settings.value(Console/ScrollbackLines, 1000).toInt(); ... m_scrollbackLines qBound(100, m_scrollbackLines, 100000);键名Console/ScrollbackLines、默认值 1,000、范围钳制 100–100,000 与规范 R4 完全对应。写入路径Handler.cpp同样经过qBound约束后回写QSettings并发出scrollbackLinesChanged信号使界面与终端控件都能实时响应。该属性通过 Handler.h 的Q_PROPERTY(int scrollbackLines READ ... WRITE ... NOTIFY ...)暴露给 QML。两个设置入口的 QML 绑定可在 app/qml/Widgets/Dashboard/Terminal.qml工具栏 Settings 弹窗中的scrollbackSpin值绑定Cpp_Console_Handler.scrollbackLines与 app/qml/Dialogs/Settings/SettingsConsolePage.qml设置对话框 Console 节的 Scrollback Lines 输入控件中找到二者与规范 R4/AC2 要求的两个入口一一对应。实时生效与裁剪保持一致性R5缓冲裁剪的核心在 Terminal.cpp 的applyScrollbackLimit()void Widgets::Terminal::applyScrollbackLimit() { int maxLines m_consoleHandler.scrollbackLines(); SS_ASSERT(maxLines 100 maxLines 100000, maxLines qBound(100, maxLines, 100000)); m_buffer.setMaxLines(maxLines); const int dropped m_buffer.trimToMaxLines(); drainBufferEvents(); if (dropped 0) m_buffer.squeeze(); m_stateChanged true; update(); }它监听scrollbackLinesChanged信号构造时连接于 Terminal.cpp调低上限时通过TerminalBuffer::trimToMaxLines()一次性裁掉超出行随后squeeze()收缩QList前置擦除遗留的容量调高上限则只更新m_maxLines让后续追加自然增长。这与 R5降低立即裁剪、提高仅允许增长的语义精确吻合也兑现了降低上限只做一次性成比例工作的性能约束。TerminalBuffer是终端控件的行存储核心TerminalBuffer.h同时维护文本行m_data、逐字符颜色行m_colorData、重复计数m_repeatCounts、光标m_cursor与上限m_maxLines。裁剪后的一致性保障分两层缓冲层trimFront()同步删除三组数据的前缀TerminalBuffer.cpp视图层drainBufferEvents()取出takeDroppedLines()与takeCursorMoved()后调用applyLineDrop()Terminal.cpp将滚动偏移减去被裁行数、把选区整体上移或在选区完全落入被裁区时清空并标记搜索状态为脏——这正是规范文本行、颜色行、光标、选区保持同步不变量的工程实现。该行为还有对应的单元测试背书trimToMaxLinesAfterCapDrop()app/tests/tst_terminal_buffer.cpp构造一个 5 行缓冲将上限从 100 降至 2 后断言trimToMaxLines()返回 3、剩余行恰为{d, e}、takeDroppedLines()为 3、再次裁剪返回 0——完整覆盖 R5/AC3 描述的降低上限立即裁掉最旧行场景。源码实现纵深Hex 翻译固定的落地R6–R7Hex 的翻译固定由翻译管线脚本 app/translations/llm_translate.py 中的PINNED_TRANSLATIONS字典实现PINNED_TRANSLATIONS { Hex: { cs_CZ: Hex, de_DE: Hex, es_MX: Hex, fr_FR: Hex, it_IT: Hex, nl_NL: Hex, pl_PL: Hex, pt_BR: Hex, ro_RO: Hex, sv_SE: Hex, tr_TR: Hex, vi_VN: Hex, ru_RU: Хекс, uk_UA: Хекс, ar_SA: هيكس, he_IL: הקס, hi_IN: हेक्स, ja_JP: 16進, ko_KR: 16진수, zh_CN: 十六进制, }, }脚本注释明确了机制按精确源字符串匹配固定pinned by EXACT source-string match被固定的条目永不进入 LLM手工挑选的值在每次运行中原样发布。拉丁文字语言保留惯例 Hex西里尔与 RTL/Indic 使用标准转写CJK 使用本族术语——与规范 R7 修订后的策展策略逐项一致。管线的执行逻辑分为两段翻译阶段约 llm_translate.py对每个源串先查PINNED_TRANSLATIONS命中则直接写入并记录[PINNED] Hex → ... (manual translation, no LLM call)日志不发起模型调用校验阶段--verify-only约 llm_translate.py仅对拉丁文字cased scripts语言复核固定值若已存在条目与固定值不一致则输出[PIN] Hex → ...并覆盖回写防止后续运行漂移。这保证了固定规则对每次未来翻译运行生效R7 的核心诉求即便模型随机性导致某次生成偏离校验通道也会把 Hex 的翻译钉回策展值从而满足 AC5 的可脚本化检查。界面侧显示模式下拉框的英文源标签位于 app/qml/Widgets/Dashboard/Terminal.qmlqsTr(Text)与qsTr(Hex)含 ToolTipqsTr(Hex display mode)。这两个选项对在控制台工具栏与设置对话框两处出现与 R6 的覆盖范围一致切换仍驱动十六进制渲染AC4。总结Spec 0006 展示了 Serial Studio 控制台终端的一次克制而完整的体验升级交互式滚动条让历史浏览回到原生终端水准R1–R3scrollback 从不可见的硬编码 1,000 行变为范围 100–100,000、实时生效、跨重启持久化的全局设置R4–R5显示模式标签收敛为 Text / Hex 并以精确匹配 手工策展 校验回写的机制在 LLM 翻译管线中逐字节钉死R6–R7。六条验收标准全部达成且受流式性能为决定性约束、默认行为零变化、不引入新依赖等硬性不变量保护。若需继续深入可阅读规范原文 doc/claude/specs/0006-terminal-scroll-ux/spec.md、终端实现 core/Ui/UI/Widgets/Terminal.cpp、缓冲存储 core/Ui/UI/Widgets/Terminal/TerminalBuffer.cpp 与对应单元测试 app/tests/tst_terminal_buffer.cpp。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Serial Studio 终端滚动体验重构：交互式滚动条、可配置 Scrollback 与 Text/Hex 标签规范
Serial Studio 终端滚动体验重构交互式滚动条、可配置 Scrollback 与 Text/Hex 标签规范【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文围绕 Serial Studio 开源遥测仪表盘仓库中的设计规范 Spec 0006 — Terminal scrollbar, configurable scrollback, and Text/Hex display labels 展开结合其控制台Console终端控件的真实源码实现、设置持久化逻辑与 LLM 翻译管线系统讲解三项控制台体验改造可拖拽、可翻页的交互式滚动条范围 100–100,000 行的可配置滚动回退scrollback缓冲以及 Text / Hex 显示模式标签的国际化固定pinning。读完本文你将理解这些改动背后的设计约束、验收标准以及它们在 Serial Studio 源码中的具体落点。背景与动机控制台终端的三个痛点Serial Studio 的 Console 终端Terminal控件是面向串口、BLE、MQTT、Modbus、CAN 等数据源的核心输出视图。在 Spec 0006 立项时该控件存在三个可观察的体验问题滚动条是装饰性的控制台仅在自动滚动autoscroll解除时绘制一根细薄的滑块thumb它既无法被拖拽点击轨道也不会翻页而在数据持续流入autoscroll 开启时用户完全看不到历史缓冲区有多大、视口停在何处。从 PuTTY、minicom、Arduino IDE 等串口监视器迁移而来的用户天然期望一个真滚动条。滚动回退被硬编码为 1,000 行长时间捕获会静默丢失最早的记录用户排查几分钟前的偶发事件时数据早已被逐出缓冲区没有途径用内存换取历史深度上限不可见也不可配置。显示模式标签本地化效果差当时选项文案为 Plain Text / Hexadecimal经过机器翻译变成 Hexadezimal、Klartext 等冗长且各不相同的本地化词撑爆了下拉框而 Hex 本就是各目标语言通用的技术缩写理应保留为 Text / Hex 两个短标签且 Hex 在每种语言中必须逐字节一致——这是当时的 LLM 翻译管线无法对精确匹配术语提供的保证。目标与非目标规范确立的目标有三观看实时数据流的用户能一眼看到 scrollback 存量并能像原生终端一样拖拽、点击滚动条浏览历史用户可在承载其他控制台选项的同一设置界面中配置控制台历史保留行数且设置跨重启生效控制台显示模式下拉框在英文源中显示 Text / Hex且 Hex 在每次翻译运行时、每个发布语言中都精确呈现为 Hex无需人工逐语言复查。同时明确划定边界Non-Goals不改动 VT-100 仿真、选择、复制、渲染管线滚动条交互所必需的除外不做按仪表盘实例widget 级的 scrollback 覆盖仅设一个全局设置不新增滚动回退搜索与导出现有控制台导出功能保持不变不改动数据发送行的 ASCII/HEX 标签及任何其他翻译字符串也不对既有语言做超出 Hex 规则本身的受保护术语批量重译。需求总览R1–R7编号需求要点R1交互式滚动条内容超过视口且用户离开实时尾部autoscroll 解除时显示滑块——仅滑块、无轨道条autoscroll 开启时保持无额外界面元素可拖拽滑块、可点击/翻页于不可见的轨道带滚轮行为保持现状R2滚动交互与 autoscroll 联动手动离开底部拖拽、轨道点击、滚轮上滚解除 autoscroll滚回底部或任何既有重新接合手势重新启用避免读者被强拉回尾部也无需寻找开关R3滚动条反映缓冲区位置滑块大小与位置跟踪可见比例与偏移随数据流入实时更新LTR 与 RTL 布局均正确R4可配置 scrollback控制台工具栏 Settings 弹窗与设置对话框 Console 节提供行数选项范围 100–100,000默认 1,000随其他控制台设置跨重启持久化R5scrollback 实时生效修改无需重启调低至当前行数以下立即裁掉最旧行调高则缓冲可增长到新上限裁剪后光标位置、选区状态、滚动偏移保持一致无崩溃、无颜色错位、无越界光标R6Text/Hex 标签显示模式选项在英文源中为 Text 与 Hex在所有出现该选项对的位置控制台工具栏与设置对话框一致R7Hex 翻译固定LLM 翻译管线识别精确源串 Hex 并使用手工策展的逐语言译文替代模型翻译拉丁文字语言保留 Hex西里尔与 RTL/Indic 文字使用标准转写Хекс、هيكس、הקס、हेक्सCJK 使用本族词16進、16진수、十六进制固定规则对每次未来翻译运行生效而非一次性修补规范还注明两处 2026-07-13 的修订AmendmentsR1 从初稿的始终可见轨道滑块回退为autoscroll 期间隐藏、仅滑块R4 补充说明控制台工具栏及其 Settings 弹窗在草案之后落地commit9c4c32d9该弹窗即原始需求中的控制台内设置菜单R7 从初稿所有语言一律 Hex改为逐语言策展值。验收标准AC1–AC6规范给出六条可直接验证的验收标准且状态均为已完成[x]AC1滚动条交互在运行中的应用中累积超过一视口控制台数据后——autoscroll 开启时无滚动条滚轮上滚显示滑块拖拽可回刷历史点击滑块上方/下方翻页拖拽或滚动到底部恢复 autoscroll 并隐藏滑块。维护者 LTR 与 RTL 双向观察。AC2配置入口控制台工具栏 Settings 弹窗与 Settings → Console 均显示 scrollback 选项输入 100 与 100,000 被接受范围外值被拒绝或钳制重启后值仍然生效。AC3实时裁剪在 100,000 上限下缓存 5,000 行时于 Settings 中将上限降至 100缓冲区立即收缩为最新 100 行无崩溃、无颜色错乱、无滚动位置卡死——包括数据流式写入过程中。AC4标签显示模式下拉框英文显示 Display: Text / Display: Hex切换仍正常启用十六进制渲染。AC5翻译固定对再生成的字符串目录运行 LLM 翻译管线后源串 Hex 在每个语言.ts文件中写入策展值如ru_RU/uk_UA为 Хекс、zh_CN为 十六进制、拉丁文字语言为 Hex且管线自身输出/日志显示该字符串被固定pinned而非模型翻译。可通过翻译运行后对.ts文件的脚本化检查验证。AC6性能回归门槛--benchmark-hotpath仍通过全部门槛在默认 1,000 行设置下控制台改动对每次追加无可测回归。CI 门槛。约束与不变量流式性能是决定性约束控制台必须在高数据率下保持流畅滚动条交互与可配置上限不得引入随缓冲区大小增长的每次追加分配或簿记。降低上限允许在设置变更的瞬间做一次成比例的工作——而不是每帧。裁剪与上限变更必须让文本行、逐字符颜色行、光标、选区保持同步——颜色缓冲区错位是此控件曾出现过的已发布缺陷类别。在 100,000 行上限且启用 ANSI 颜色时的内存占用最坏情况必须保持在数百 MB 的低位范围即按此边界选取。默认行为完全保留从不触碰新设置的用户得到与今天完全一致的 1,000 行缓冲与滚轮/键盘行为。重命名后的标签走正常翻译流程任何语言不得出现两个重命名选项的空项或过期项。不引入新依赖不改动帧解析热路径。源码实现纵深滚动条如何真正可交互Spec 的 R1–R3 在core/Ui/UI/Widgets/Terminal.cpp中得到了完整落地。该控件维护m_autoscroll与m_scrollOffsetY两个核心状态滚动条的几何与交互全部由一组纯几何函数驱动scrollbarTrackRect()Terminal.cpp返回全高轨道矩形宽度固定为 6 像素并依据m_translator.rtl()在 RTL 布局下镜像到左侧——这正是 R3 要求LTR 与 RTL 双布局正确的实现位置。scrollbarThumbRect()Terminal.cpp按可见比例计算滑块高度availableHeight * availableHeight / lines并施加 20px 最小高度与轨道一半的最大高度再按当前m_scrollOffsetY与lineCount() - linesPerPage()的比例映射滑块 Y 坐标。滑块随数据流入实时重算满足 R3 的位置反映缓冲区。handleScrollbarPress()Terminal.cpp命中滑块内则进入m_draggingScrollbar拖拽态并解除 autoscroll命中滑块上方/下方则按一页linesPerPage()向上/向下翻页——即 AC1 中点击翻页的交互鼠标移动、释放、抓取丢失时分别在对应事件处理器中更新偏移与清除拖拽态Terminal.cpp。applyScrollbarOffset()Terminal.cpp将 R2 的联动规则集中实现——滚出底部clamped maxOffset且 autoscroll 开启时自动解除滚回底部clamped maxOffset时自动重新接合。paintScrollbar()Terminal.cpp仅当 autoscroll 关闭且内容超出一屏时绘制圆角滑块与 R1 修订后的autoscroll 期间保持无额外界面元素完全一致。从这些实现可以看出规范中滚动条交互不得进入帧解析热路径的约束如何被满足所有交互逻辑都发生在用户输入事件鼠标按下/移动/滚轮与绘制路径上缓冲区追加路径不感知滚动条。源码实现纵深可配置 scrollback 的持久化与实时裁剪设置存储与钳制R4scrollback 行数由 Console 会话处理器Console::Handler统一管理。在 Handler.cpp 中设置从QSettings读取m_scrollbackLines m_settings.value(Console/ScrollbackLines, 1000).toInt(); ... m_scrollbackLines qBound(100, m_scrollbackLines, 100000);键名Console/ScrollbackLines、默认值 1,000、范围钳制 100–100,000 与规范 R4 完全对应。写入路径Handler.cpp同样经过qBound约束后回写QSettings并发出scrollbackLinesChanged信号使界面与终端控件都能实时响应。该属性通过 Handler.h 的Q_PROPERTY(int scrollbackLines READ ... WRITE ... NOTIFY ...)暴露给 QML。两个设置入口的 QML 绑定可在 app/qml/Widgets/Dashboard/Terminal.qml工具栏 Settings 弹窗中的scrollbackSpin值绑定Cpp_Console_Handler.scrollbackLines与 app/qml/Dialogs/Settings/SettingsConsolePage.qml设置对话框 Console 节的 Scrollback Lines 输入控件中找到二者与规范 R4/AC2 要求的两个入口一一对应。实时生效与裁剪保持一致性R5缓冲裁剪的核心在 Terminal.cpp 的applyScrollbackLimit()void Widgets::Terminal::applyScrollbackLimit() { int maxLines m_consoleHandler.scrollbackLines(); SS_ASSERT(maxLines 100 maxLines 100000, maxLines qBound(100, maxLines, 100000)); m_buffer.setMaxLines(maxLines); const int dropped m_buffer.trimToMaxLines(); drainBufferEvents(); if (dropped 0) m_buffer.squeeze(); m_stateChanged true; update(); }它监听scrollbackLinesChanged信号构造时连接于 Terminal.cpp调低上限时通过TerminalBuffer::trimToMaxLines()一次性裁掉超出行随后squeeze()收缩QList前置擦除遗留的容量调高上限则只更新m_maxLines让后续追加自然增长。这与 R5降低立即裁剪、提高仅允许增长的语义精确吻合也兑现了降低上限只做一次性成比例工作的性能约束。TerminalBuffer是终端控件的行存储核心TerminalBuffer.h同时维护文本行m_data、逐字符颜色行m_colorData、重复计数m_repeatCounts、光标m_cursor与上限m_maxLines。裁剪后的一致性保障分两层缓冲层trimFront()同步删除三组数据的前缀TerminalBuffer.cpp视图层drainBufferEvents()取出takeDroppedLines()与takeCursorMoved()后调用applyLineDrop()Terminal.cpp将滚动偏移减去被裁行数、把选区整体上移或在选区完全落入被裁区时清空并标记搜索状态为脏——这正是规范文本行、颜色行、光标、选区保持同步不变量的工程实现。该行为还有对应的单元测试背书trimToMaxLinesAfterCapDrop()app/tests/tst_terminal_buffer.cpp构造一个 5 行缓冲将上限从 100 降至 2 后断言trimToMaxLines()返回 3、剩余行恰为{d, e}、takeDroppedLines()为 3、再次裁剪返回 0——完整覆盖 R5/AC3 描述的降低上限立即裁掉最旧行场景。源码实现纵深Hex 翻译固定的落地R6–R7Hex 的翻译固定由翻译管线脚本 app/translations/llm_translate.py 中的PINNED_TRANSLATIONS字典实现PINNED_TRANSLATIONS { Hex: { cs_CZ: Hex, de_DE: Hex, es_MX: Hex, fr_FR: Hex, it_IT: Hex, nl_NL: Hex, pl_PL: Hex, pt_BR: Hex, ro_RO: Hex, sv_SE: Hex, tr_TR: Hex, vi_VN: Hex, ru_RU: Хекс, uk_UA: Хекс, ar_SA: هيكس, he_IL: הקס, hi_IN: हेक्स, ja_JP: 16進, ko_KR: 16진수, zh_CN: 十六进制, }, }脚本注释明确了机制按精确源字符串匹配固定pinned by EXACT source-string match被固定的条目永不进入 LLM手工挑选的值在每次运行中原样发布。拉丁文字语言保留惯例 Hex西里尔与 RTL/Indic 使用标准转写CJK 使用本族术语——与规范 R7 修订后的策展策略逐项一致。管线的执行逻辑分为两段翻译阶段约 llm_translate.py对每个源串先查PINNED_TRANSLATIONS命中则直接写入并记录[PINNED] Hex → ... (manual translation, no LLM call)日志不发起模型调用校验阶段--verify-only约 llm_translate.py仅对拉丁文字cased scripts语言复核固定值若已存在条目与固定值不一致则输出[PIN] Hex → ...并覆盖回写防止后续运行漂移。这保证了固定规则对每次未来翻译运行生效R7 的核心诉求即便模型随机性导致某次生成偏离校验通道也会把 Hex 的翻译钉回策展值从而满足 AC5 的可脚本化检查。界面侧显示模式下拉框的英文源标签位于 app/qml/Widgets/Dashboard/Terminal.qmlqsTr(Text)与qsTr(Hex)含 ToolTipqsTr(Hex display mode)。这两个选项对在控制台工具栏与设置对话框两处出现与 R6 的覆盖范围一致切换仍驱动十六进制渲染AC4。总结Spec 0006 展示了 Serial Studio 控制台终端的一次克制而完整的体验升级交互式滚动条让历史浏览回到原生终端水准R1–R3scrollback 从不可见的硬编码 1,000 行变为范围 100–100,000、实时生效、跨重启持久化的全局设置R4–R5显示模式标签收敛为 Text / Hex 并以精确匹配 手工策展 校验回写的机制在 LLM 翻译管线中逐字节钉死R6–R7。六条验收标准全部达成且受流式性能为决定性约束、默认行为零变化、不引入新依赖等硬性不变量保护。若需继续深入可阅读规范原文 doc/claude/specs/0006-terminal-scroll-ux/spec.md、终端实现 core/Ui/UI/Widgets/Terminal.cpp、缓冲存储 core/Ui/UI/Widgets/Terminal/TerminalBuffer.cpp 与对应单元测试 app/tests/tst_terminal_buffer.cpp。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
