--- @agent 前台直跑测试 ---

空文件编辑测试

验证写入文件后内容正确性

完整的 Execute 链路测试

TestEditFile_ExactMatch_AuthoritativeBanner 验证精确匹配仍声明权威无需复核。

TestEditFile_FuzzyMatch_CautionBanner 验证模糊匹配（L3/L4）的成功提示 不再声称"无需确认"，而是建议复核（避免在最该验证时抑制自愈）。

TestEngineObserver_CallSequence 验证 EngineObserver 的回调顺序和参数正确性。

TestEngineObserver_NilFallback 验证不注入 observer 时 nil 自动降级为 noop 不会 panic。

TestErrorHandling 运行错误处理能力评估（3 个黄金用例）。

TestEventError_ResetsThinkingBlock 验证 EventError 在 thinking 块活跃时， 正确截断 lines（移除从 thinkingLineStart 起的所有行）并重置 thinkingLineStart。

TestEventThinkingDelta_NoBlankLineBeforeHeader 验证 thinking 块头部（« thinking »） 直接追加在 "◆ harness9:" 之后，不出现孤立的空行占位符。

TestExtractReasoningContent_PriorityReasoningContent 验证当两个字段同时存在时， reasoning_content 优先于 reasoning 返回（DeepSeek-R1 原生格式优先）。

TestFinalize_ContiguousIndices 验证常规（OpenAI）密集 index 从 0 起的情形。

TestFinalize_Empty 验证无工具调用时返回 nil。

TestFinalize_OutOfOrderArrival 验证乱序到达的 index 也按升序输出。

TestFinalize_SparseIndices 是核心回归测试：当 index 不从 0 开始（Anthropic 在 thinking/text 块占据 index 0 时，tool_use 块从 index 1 起，key 集合形如 {1,2}）， 旧实现 `for i:=0;i<len(

TestFlushPendingThinking_UpdatesPendingReplyStart 验证 flushPendingThinking 后 pendingReplyStart 被更新到 thinking 结束行之后，后续 action 文本从正确位置写入。

TestFormatJSON 验证 JSON 渲染的三类分支：空输入、短 payload 内联、长 payload pretty-print。

TestFormatJSON_LongPayloadIsPretty 验证超过 argInlineThreshold 的 payload 被 pretty-print 并加缩进。

TestFormatJSON_NoHTMLEscape 验证 &、<、> 字符不被转义为 \uXXXX 形式。 这是日志可读性的关键 — 命令中常见的 && 必须原样显示，不能出现 & 这种 Unicode 转义。

TestFormatLoopEnd 验证结束日志包含 turns 和 total 字段。

TestFormatLoopStart 验证启动日志包含所有关键参数字段。

TestFormatMsg 验证通用单行日志条目的前缀拼接格式。

TestFormatOutput 验证基础输出渲染：单行、多行、空输入、超长截断。

TestFormatToolDone 验证 status 与耗时格式化、成功/失败标签切换、截断后缀。

TestFormatToolStart 验证工具启动条目的头部 + arguments 渲染。

TestFormatTurnStart 验证 Turn 头部日志包含 turn 编号、history 和 tools 字段。

TestFtsQuery 验证 ftsQuery 将用户输入安全转换为 FTS5 MATCH 表达式： 每个 token 被双引号包裹（内部双引号翻倍转义），以 OR 连接。

L1: 精确匹配替换

L1: 精确匹配多处 → 返回错误

L1: 原始文本精确匹配，保留原始格式（包括 \r\n）

L2: CRLF 文件中 source_text 也带 CRLF

L2: CRLF 文件中 target_text 含 CRLF

L2: 换行符归一化匹配（CRLF → LF）

L2: 真正测试换行符归一化 — CRLF 文件中使用纯 LF 的多行 source_text

L3: 空 source_text 不应进入 L3

L3: 测试 source_text 带有额外首尾空白的情况

L3: 整体首尾去空匹配

L4: 验证 lineByLineReplace 对 CRLF 文件的保留

L4: 缩进不一致时的模糊匹配