9.8 KiB
逐字 Markdown 修复审查
审查日期:2026-10-26。范围仅为 app/src/doctor_workstation/ui/dialogs/ai_consult.py 本次新增的 Markdown 识别、逐字分流及长尾追加优化,以及 test_ai_stream_markdown_ui.py、test_ai_character_presentation_r40.py 的相关断言。根 AGENTS.md 按本任务提供的内容执行;工作区缺少 .trellis/。未修改已有代码、测试或用户改动;本报告为唯一新增交付文件。所有复现均为本地 offscreen Qt 和合成数据,无模型请求、网络、部署或真实病历访问。
结论
标题、加粗、普通列表的主要接线修复成立。首次两个目标测试文件共 90 项通过;包含最新真实 SSE 断言的最终四组定向验证为 125 项通过,3 项排除。但发现三个可操作问题,其中长尾追加会造成播放期间实际格式错误和字面字符遗漏,建议合入前处理。原始批准源文 _raw_payload 在复现中始终完整;下述字符遗漏发生在可见投影,最终整文渲染会纠正,不能因此认为播放期间已正确。
1. [P2] 长尾关闭行内格式后,普通字继续继承旧格式,且普通字也可能改变 Markdown 语法
位置:app/src/doctor_workstation/ui/dialogs/ai_consult.py:2268–2270,阈值设置在 2286。
_stream_tail_plain 成立后,仅检查本次增量是否包含指定语法字符(星号、下划线、反引号、括号等)或换行,然后直接在文档末尾 cursor.insertText(text)。Qt 的末尾字符格式来自前一个已渲染字符,因此关闭加粗、行内代码、强调或链接后的普通字,会继续继承已经结束的格式。更关键的是,字母也能改变下划线分隔符的开闭条件,不能把“不含语法字符”视为“解析结果不变”。
实际通过 _ChatBubble.queue_approved_stream_text() 加受控 timeout 复现,未调用 terminal:
| 已播出的源文前缀 | 后续普通增量 | 播放中结果 | set_payload() oracle |
|---|---|---|---|
"**" + "x" * 2050 + "**" |
TAIL |
TAIL 的 fontWeight 为 700 |
400 |
chr(96) + "x" * 2050 + chr(96) |
TAIL |
TAIL 仍为等宽代码字体 |
普通字体 |
"[" + "x" * 2050 + "](https://example.test)" |
TAIL |
TAIL 的 isAnchor() 为 true |
false |
"_" + "x" * 2050 + "_" |
TAIL |
可见文本为 x * 2050 + TAIL,少两个 _ |
完整显示 _、2050 个 x、_TAIL |
最后一种是确定的可见来源字符遗漏:最终串中的后一个 _ 已不再能结束强调,但快路径没有重新解析它。短段落会因为每帧重解析而正确,问题由此次保留已解析格式的长尾快路径引入。
建议:只有在明确知道 Markdown 解析状态允许安全追加时才走快路径,并显式选择追加字符应有的格式。遇到闭合分隔符后的相邻普通字时,至少重新解析受影响的尾部;不要仅用增量字符白名单判断。新增阈值以上的“关闭加粗/代码/链接后追加普通字”和“闭合 _ 后追加字母”测试,terminal 之前比较格式与可见字符。
现有 test_long_tail_keeps_format_and_parses_later_inline_syntax 只检查既有加粗保留和后来加粗成功,没有检查后来加粗后的普通尾字是否恢复正文格式,也没有覆盖下划线重新分类。
2. [P2] 长列表每个普通字仍遍历整个未完成尾段,长尾优化未避免逐帧全段格式化
位置:app/src/doctor_workstation/ui/dialogs/ai_consult.py:2265、2291;实际逐字入口为 3421。
没有空行分隔的长列表、表格或单换行报告,会让 _stream_tail_position 一直保持 0。即使普通字已走 2270 的增量追加,代码仍然每帧扫描整个 _stream_tail 查稳定边界,并以旧 position 调用 apply_reading_rhythm();后者从该块遍历到全文末尾,为每块重新设置格式。输入增长后,每个普通字都重复处理所有旧块。换行、括号等常见字符又触发整个长尾的 Markdown 重解析。
在当前虚拟环境中,用 "- synthetic item\n" * rows 预置与队列播放相同的 _RichMessage 尾段状态,随后分别追加普通 x 和换行;该预置只省略数万次无关前置帧,不改变测量时的尾段状态:
| 行数 | 普通字帧中位耗时(5 次) | 换行帧耗时 |
|---|---|---|
| 500 | 6.57 ms | 11.98 ms |
| 1000 | 13.23 ms | 41.07 ms |
| 2000 | 27.28 ms | 203.73 ms |
2000 行独立复测:Markdown 入口普通帧中位数 26.71 ms;此前纯文本逐字入口为 10.81 ms。具体时间依机器而异,但全段遍历及增长趋势可直接由代码确认。该方法在 GUI 线程执行,timer 还会在帧结束后再等待 24 ms,因此会进一步降低播放速率并卡顿其他界面操作。
建议:普通字追加时,将阅读节奏更新范围限制在实际受影响的当前块;增量不含换行时避免反复扫描所有旧行。对必须重解析的长列表/表格保留受控策略。增加无空行、多块长尾的有限性能回归,不能仅用单段 "甲" * 2200 验证优化。
3. [P2] Markdown 识别规则漏掉 Qt 支持的语法,整篇仍可能一直按原文播放
位置:app/src/doctor_workstation/ui/dialogs/ai_consult.py:2177–2180、3377–3379。
当前正则决定是否进入 Markdown 渲染,而非仅作为优化提示。若整篇没有其他命中的标记,Qt 支持的引用式链接、自动链接、独立横线或反斜杠转义会一直进入纯文本分支,直到 terminal 才改变显示。这保留了此次修复要解决的“生成完之前仍显示控制字符”问题的一部分。
离线实际复现:
| 批准正文 | 正则命中 | 全部字素已播完、尚未 terminal | 最终渲染 oracle |
|---|---|---|---|
[name][id]\n\n[id]: https://example.test |
否 | 原始链接标记和定义全文可见 | name,可点击链接 |
<https://example.test> |
否 | 两个尖括号可见 | https://example.test,可点击链接 |
--- |
否 | 三个减号可见 | 横线,无该字面正文 |
a\\*b |
否 | 反斜杠可见 | a*b |
建议:让分流覆盖实际承诺支持的 Markdown 集合,或改用能够保持纯文本性能的统一 Markdown 投影策略;至少补充这几种未命中语法在 terminal 之前的回归。引用式链接还依赖后续定义,修复识别后需要同时验证稳定段落策略,不应只检查最后一帧。
验证及保留结论
最终定向运行:
cd D:\web\zyt\app
.\.venv\Scripts\python.exe -B -m pytest -p no:cacheprovider tests/test_ai_stream_markdown_ui.py tests/test_ai_character_presentation_r40.py tests/test_ai_consult_active_stream_ui.py tests/test_ai_consult_source_rendering_r36.py -k 'not paused_upstream' -q
结果:125 passed,3 deselected。这些通过结果支持主要 Markdown 接线、既有字素节奏、延后完成、患者归属等契约继续成立,但不覆盖以上长尾格式收尾、下划线语法反转和多块尾段成本。
此前一次探索性运行还包含 test_ai_approved_presentation_r38.py,共出现 25 项失败:3 项为主代理已确认修复前失败的 paused_upstream,22 项位于旧 R38 展示契约测试(包含 5 秒内完成长篇逐字播放等预期)。没有以这次探索性失败推断本次修复引入回归,亦未修改这些测试;新增问题均以上述独立、确定的 Qt 复现为依据。
未发现本次新增代码把未批准正文写入 _raw_payload,也未发现 Markdown 模式切换提前展示积压正文。_presentation_has_markdown 对完整批准源文的预检测只决定解析方式;start:end 仍限制可见源偏移。普通内容升级为 Markdown 时重建已播前缀的行为与当前实现意图一致。
半截控制标记在闭合之前短暂可见仍是现有增量解析策略的边界,未把它重复列为本次新缺陷。旧测试中针对暂停上游、短时间内完成所有逐字播放或旧完成生命周期的预期,也不在本报告中作为本次新增问题。
修正后定向复核(2026-10-26)
本轮仅复查原三项复现和对应修正,不扩大范围;以下结论更新前文整改前状态。
| 原问题 | 复核结论 |
|---|---|
| 1. 长尾关闭格式后继承或漏字 | 原复现已解决。 2050 字符的加粗、代码、星号强调、链接、下划线强调分别闭合后,再经真实逐字队列追加 TAIL;未 terminal 时的可见文本及尾字粗细、斜体、等宽属性、链接属性均与完整渲染 oracle 相同。下划线两字符恢复完整;所有 _raw_payload 保持原文。 |
| 2. 普通字逐帧遍历整段 | 原普通增量问题已解决。 2000 行列表尾段追加十次普通 x,每帧 apply_reading_rhythm() 仅触及 1 块,稳定边界全尾扫描调用数为 0。当前机器中位耗时 16.39 ms。语法变化帧仍会重解析长尾:同一列表追加换行约 224 ms;因此只能确认普通增量的重复全段工作已去除,不能宣称所有长列表帧均满足 24 ms。 |
| 3. 正则漏掉原报告列出的语法 | 原四个复现已解决。 显式引用链接、自动链接、独立 ---、a\*b 均在 terminal 前与完整渲染的可见文本相同;两种链接的目标也一致。显式引用及后续定义能在同一尾段正确解析。 |
独立运行新增回归文件:
cd D:\web\zyt\app
.\.venv\Scripts\python.exe -B -m pytest -p no:cacheprovider tests/test_ai_stream_markdown_ui.py -q
结果:21 passed。另运行上述原始合成复现,全部断言通过。本轮没有再次运行旧 R38,没有修改应用代码或测试,仅追加本报告。原三项中的格式、识别及普通增量全段遍历复现已消除;长列表语法变化帧的解析成本保留为明确性能限制,本轮没有新增阻断问题。