MooTool Next Compose 查找条「查找」按钮补齐与 JSON 替换后 notice 清空:DIFF-289 对齐 Electron 的实现剖析

原创2026-10-14 18:22:271,830 阅读
文章标签:开发工具桌面应用MCP 服务

MooTool Next Compose 查找条「查找」按钮补齐与 JSON 替换后 notice 清空:DIFF-289 对齐 Electron 的实现剖析

导读

本文围绕 MooTool Next(Compose 桌面版)的 DIFF-289 差异记录展开,讲解两处与 Electron 版对齐的行为修正:一是 JSON / 随手记 / Host / HTTP 四处查找条统一补齐独立「查找」按钮,使点击与 Enter、下一处保持一致的向前跳转语义;二是 JSON 单次替换、全部替换成功后清空状态栏/检查器的 notice 提示,避免旧提示残留误导。通过仓库源码与测试用例的交叉印证,读者可以完整掌握 Compose 版查找条「按钮 + 快捷键 + 守卫 + notice 生命周期」的实现链路,并可直接复用到 Electron 与 Compose 的双端行为对齐工作中。

一、DIFF-289 的来龙去脉:Electron 与 Compose 的查找条差距

1.1 问题背景

在 MooTool Next 的 Electron 版中,FindReplaceBar 查找条在查找输入框旁一直带有一个独立的「查找」按钮(对应 findReplace.find),且点击该按钮与按下 Enter 的行为完全一致。而 Compose 版此前只有「上一处 / 下一处」两个步进按钮,Enter 也仅由输入框的 onFindQueryEnterKey 触发,缺失了与 Electron 对齐的显式「查找」按钮。

与此同时,JSON 替换成功后存在一处提示残留问题:Electron 版在替换成功后清空 notice,而 Compose 版 JSON 工具在替换成功时虽然调用了 clearJsonPathQueryResult() 清空 JSONPath 结果,但状态栏/检查器的 notice 仍可能保留旧提示(例如上一次「格式化成功」「已导入」等),导致界面状态与事实不符。

1.2 本文涉及的修复范围

按 DIFF-289 记录,本次行为对齐包含两条规则:

  • JSON / 随手记 / Host / HTTP 查找条:查找词非空时启用 find.find(即「查找」按钮),点击执行与 Enter / 下一处相同的向前跳转;
  • JSON 单次替换、全部替换成功:notice 置空(仍然保留 clearJsonPathQueryResult() 的调用)。

二、「查找」按钮:四处查找条的统一补齐

2.1 按钮本体:MooButton + 文案键 find.find

四处查找条(JSON、随手记、Host、HTTP 响应)的「查找」按钮实现高度一致,均使用 MooButton 组件、国际化文案键 find.find,并复用同一套启用守卫:

模块 查找条所在文件 启用守卫 跳转逻辑
JSON JsonScreen.kt EditorFindBarPresentation.findQueryActionEnabled jumpFind(container, session, true)
随手记 QuickNoteScreen.kt EditorFindBarPresentation.findQueryActionEnabled jump(true)
Host HostScreen.kt HostWiringPresentation.findQueryActionEnabled jumpFind(true)
HTTP 响应 HttpScreen.kt HttpResponsePresentation.findQueryActionEnabled step(true)

此外,仅查找模式的通用组件 EditorFindOnlyBar.kt 同样实现了「查找」按钮,供其他只查找不替换的编辑器场景复用。

2.2 启用守卫:EditorFindBarPresentation

DIFF-289 的关键语义是「查找词非空时启用」。这一规则被收敛到了公共领域层对象 EditorFindBarPresentation.kt:

object EditorFindBarPresentation {
    fun findQueryActionEnabled(query: String): Boolean = query.isNotBlank()
    fun findStepActionEnabled(query: String): Boolean = findQueryActionEnabled(query)
}
  • findQueryActionEnabled:仅当查询词 isNotBlank() 时「查找」按钮可用,空白串(包括纯空格)一律禁用;
  • findStepActionEnabled:直接复用上述守卫,因此「上一处 / 下一处」与「查找」按钮的启用条件完全一致。

Host 与 HTTP 模块通过薄封装复用同一规则,避免各端漂移:

对应的单元测试 EditorFindBarPresentationTest.kt 覆盖了空串、纯空格、普通词与带空格词四类输入:

assertFalse(EditorFindBarPresentation.findQueryActionEnabled(""))
assertFalse(EditorFindBarPresentation.findStepActionEnabled("  "))
assertTrue(EditorFindBarPresentation.findQueryActionEnabled("x"))
assertTrue(EditorFindBarPresentation.findStepActionEnabled(" x "))

HostWiringPresentationTest.kt 与 HttpResponsePresentationTest.kt 也分别验证了空串禁用、有效词启用的边界。

2.3 点击即「向前跳转」:与 Enter / 下一处的行为对齐

DIFF-289 要求「点击执行与 Enter / 下一处相同的向前跳转」。以 JSON 为例,JsonScreen.kt 的私有函数 jumpFind 统一收口了三种触发路径:

private fun jumpFind(container: AppContainer, session: JsonSession, forward: Boolean) {
    if (session.findQuery.isBlank()) return
    val match = RstaFindNavigation.jump(session.editor, session.findQuery, session.findOptions, forward)
    if (match == null) {
        container.toastFindNoMatches()
    } else {
        onEdt { session.editor.select(match.start, match.end) }
    }
}
  • 「查找」按钮:onClick = { jumpFind(container, session, true); onChanged() },即 forward = true;
  • 「下一处」按钮:jumpFind(container, session, true);
  • Enter 键:输入框通过 onFindQueryEnterKey { jumpFind(container, session, true); onChanged() } 触发。

三者最终都走到同一条向前跳转链路。底层跳转由 RstaFindNavigation.jump 承担,它先通过选区计算 selectionIndex(有选区时取前进方向末端的 maxOf / minOf),再调用 FindReplace.findNext 返回下一处匹配。匹配失败时统一弹出「无匹配」Toast(toastFindNoMatches())。

三、JSON 替换成功后的 notice 清空

3.1 问题的具体表现

Compose 版 JSON 工具的 notice 字段承载状态栏/检查器的提示信息(如「格式化成功」「已导入」「Vault 已保存」等)。在替换成功但未清空 notice 之前,用户完成一次替换后,底部状态栏仍可能残留与当前操作无关的旧提示,与 Electron 版「替换即清空」的体验不一致。

3.2 单次替换与全部替换的清空实现

在 JsonScreen.kt 的查找条中,两个替换按钮在成功分支都执行了相同的三连操作:

单次替换(「替换」按钮):

MooButton(container.t("find.replace"), onClick = {
    onEdt {
        if (!RstaFindNavigation.replaceAndSelectNext(session.editor, session.findQuery, session.replaceText, session.findOptions)) {
            container.toastFindNoMatches()
        } else {
            session.findReplacedCount += 1
            session.clearJsonPathQueryResult()
            session.notice = ""
            session.copyState = CopyFeedbackPolicy.IDLE
        }
        onChanged()
    }
})

全部替换(「全部替换」按钮):

MooButton(container.t("find.replaceAll"), onClick = {
    val (next, count) = FindReplace.replaceAll(session.editor.text, session.findQuery, session.replaceText, session.findOptions)
    if (count == 0) {
        container.toastFindNoMatches()
    } else {
        onEdt { session.editor.setText(next, recordUndo = true) }
        session.clearJsonPathQueryResult()
        session.findReplacedCount = count
        session.notice = ""
        session.copyState = CopyFeedbackPolicy.IDLE
    }
    onChanged()
})

成功分支的四个动作含义如下:

  1. session.findReplacedCount += 1(或 = count):累加替换计数,驱动查找条尾部「已替换 N 处」文本;
  2. session.clearJsonPathQueryResult():清空检查器的 JSONPath 查询结果(DIFF-289 明确「仍 clearJsonPathQueryResult()」);
  3. session.notice = "":即本次修复新增的核心动作,置空状态栏提示;
  4. session.copyState = CopyFeedbackPolicy.IDLE:重置复制反馈状态,防止旧的「已复制」UI 状态残留。

3.3 clearJsonPathQueryResult 与 notice 的职责边界

clearJsonPathQueryResult 定义在 JsonInspectorResult.kt,实现极为简单——只把 pathResult 置空:

internal fun JsonSession.clearJsonPathQueryResult() {
    pathResult = ""
}

它是 JsonSession 的扩展函数,通过注释明确了适用场景:「编辑器经 EditorBuffer.setText 批量替换后调用,避免残留 JSONPath 结果」。因此它与 notice 是两个独立的状态通道:pathResult 对应检查器结果区的 JSONPath 查询/路径预览,notice 对应状态栏提示文本。DIFF-289 的修复正是在替换成功路径上把两条通道同时清空,与 Electron 行为完全对齐。

3.4 验证方式

DIFF-289 记录的验证命令为:

./gradlew :composeApp:desktopTest --offline

该命令在离线模式下运行 Compose 桌面端测试集。与本次改动直接相关的守卫测试分布在 commonTest(EditorFindBarPresentationTest)与 desktopTest(HostWiringPresentationTest、HttpResponsePresentationTest),它们覆盖了「查找词非空才启用」的完整边界条件。

四、与相邻 DIFF 的关系:查找条行为演进的一环

DIFF-289 并非孤立改动,它处于 Compose 查找条持续对齐 Electron 的行为链路上。仓库中相邻编号的差异记录可帮助理解上下文:

这些记录共同说明 MooTool Next 通过「一条 DIFF 一个行为差异」的渐进式方式,将 Compose 版界面逐步拉齐到 Electron 版体验。

五、从源码结构可推断的复用要点

结合上述实现,从源码结构可以总结出三条可直接复用的工程模式:

  1. 行为守卫集中化:启用条件(query.isNotBlank())收敛到 EditorFindBarPresentation,各模块通过委托封装复用,杜绝「各写一份、口径不一」的漂移;
  2. 多条触发路径统一收口:「查找」按钮、Enter、上一处/下一处都调用同一个 jump(forward) 函数,保证语义恒等于「向前/向后跳转」;
  3. 状态通道分层清理:pathResult(JSONPath 结果)与 notice(状态栏提示)分开管理,业务操作成功时按需同时清空,避免用户界面出现过期信息。

结语

DIFF-289 以两条极简规则完成了 Compose 查找条与 Electron 的两处对齐:独立「查找」按钮让鼠标用户获得与键盘(Enter)完全一致的向前跳转体验;JSON 替换成功后 notice 置空则消除了状态栏过期提示的误导。其实现细节——EditorFindBarPresentation 的统一守卫、jumpFind 的多路收口、clearJsonPathQueryResult 与 notice 的分层清理——为后续所有查找/替换类工具的跨端对齐提供了清晰样板。如需复现或验证,可直接运行 ./gradlew :composeApp:desktopTest --offline。

登录后查看全文
MooTool