From e1804536832a6d6b1802a91941de1f3035b98eac Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Mon, 3 Aug 2026 15:38:13 +0800
Subject: [PATCH 1/8] [2085] add recent document search development notes

---
 devel/2085.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 devel/2085.md

diff --git a/devel/2085.md b/devel/2085.md
new file mode 100644
index 0000000000..949e67c9a5
--- /dev/null
+++ b/devel/2085.md
@@ -0,0 +1,37 @@
+# [2085] 编辑菜单中的最近文档搜索
+
+## 相关文档
+- [Issue #4143](https://github.com/MoganLab/mogan/issues/4143) - 采用 QML 重构并修复最近文档搜索。
+
+## 任务相关的代码文件
+- `TeXmacs/progs/doc/docgrep.scm`
+- `TeXmacs/progs/texmacs/menus/edit-menu.scm`
+- `src/Plugins/Qt/QTMQmlDialog.cpp`
+- `src/Plugins/Qt/qml/SearchRecentDocuments.qml`
+
+## 如何测试
+```powershell
+xmake build stem
+xmake install stem
+& '.\build\packages\stem\data\bin\MoganSTEM.exe'
+```
+
+在“编辑 -> 搜索最近打开的文档”中输入文件名的一部分，确认结果按模糊匹配显示。选中条目并点击“打开”，确认文件被加载。
+
+## 2026/08/03 采用 QML 重构最近文档搜索
+
+### What
+- 用 QML 对话框替换旧的交互式全文 grep 输入。
+- 显示最近文档的文件名和路径，并支持实时模糊筛选与显式选择。
+- 对最近文件路径去重；初始和筛选后均不默认选中，避免重复项同时高亮或误打开。
+- 补充 QML 加载与桥接测试。
+- 在 `ai-docs/qml/qml-dialog.html` 中补充该对话框的交互设计稿。
+
+### Why
+旧交互式输入在中文输入法确认候选字时会提前执行，且其全文搜索语义不符合按最近文件选择文档的预期。
+
+### How
+- Scheme 侧提供最近文件列表，并在确认选择后加载对应路径。
+- C++ 将最近文件模型注入 QML，保持 UTF-8 路径编码。
+- C++ 以规范化路径去重，保留最近记录中的第一次出现。
+- QML 按文件名优先、完整路径兜底执行子序列模糊匹配；只有显式选中并点击“打开”才加载选定文件。

From 58b73b970631cff7825b43bef64bb53f3828a889 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Mon, 3 Aug 2026 15:41:19 +0800
Subject: [PATCH 2/8] [2085] refactor recent document search with QML

---
 TeXmacs/progs/doc/docgrep.scm                |  12 ++
 TeXmacs/progs/texmacs/menus/edit-menu.scm    |   2 +-
 ai-docs/qml/qml-dialog.html                  | 155 ++++++++++++++-
 src/Plugins/Qt/QTMQmlDialog.cpp              |  52 +++++
 src/Plugins/Qt/QTMQmlDialog.hpp              |   9 +
 src/Plugins/Qt/moganqml.qrc                  |   1 +
 src/Plugins/Qt/qml/SearchRecentDocuments.qml | 194 +++++++++++++++++++
 src/Plugins/Qt/qml/qmldir                    |   1 +
 src/Scheme/L5/glue_qt.lua                    |   8 +-
 tests/Plugins/Qt/qml_dialog_test.cpp         |  14 ++
 tests/Plugins/Qt/qml_load_test.cpp           |  31 +++
 11 files changed, 473 insertions(+), 6 deletions(-)
 create mode 100644 src/Plugins/Qt/qml/SearchRecentDocuments.qml

diff --git a/TeXmacs/progs/doc/docgrep.scm b/TeXmacs/progs/doc/docgrep.scm
index 6c568b96ce..076e3186b8 100644
--- a/TeXmacs/progs/doc/docgrep.scm
+++ b/TeXmacs/progs/doc/docgrep.scm
@@ -247,3 +247,15 @@
     (load-document (string-append "tmfs://grep/" query))
   ) ;with
 ) ;tm-define
+
+(tm-define (recent-documents-for-qml) (map url->system (recent-file-list 25)))
+
+(tm-define (open-search-recent-documents)
+  (:interactive #t)
+  (with path
+    (cpp-search-recent-documents-dialog)
+    (when (!= path "")
+      (load-document (system->url path))
+    ) ;when
+  ) ;with
+) ;tm-define
diff --git a/TeXmacs/progs/texmacs/menus/edit-menu.scm b/TeXmacs/progs/texmacs/menus/edit-menu.scm
index dd7314b5da..1490ba42fe 100644
--- a/TeXmacs/progs/texmacs/menus/edit-menu.scm
+++ b/TeXmacs/progs/texmacs/menus/edit-menu.scm
@@ -99,7 +99,7 @@
     ) ;->
   ) ;if
   ---
-  ("Search recent documents" (interactive docgrep-in-recent))
+  ("Search recent documents" (open-search-recent-documents))
   ---
   (if (use-menus?) (-> "Preferences" (link preferences-menu)))
   (if (use-popups?) ("Preferences" (open-preferences)))
diff --git a/ai-docs/qml/qml-dialog.html b/ai-docs/qml/qml-dialog.html
index 926a5d9ec1..bce953ef51 100644
--- a/ai-docs/qml/qml-dialog.html
+++ b/ai-docs/qml/qml-dialog.html
@@ -299,6 +299,76 @@
       box-shadow: var(--shadow);
     }
 
+    .recent-search-shell {
+      width: min(620px, 100%);
+      background: #ffffff;
+      border: 1px solid #d6dfdf;
+      border-radius: var(--radius);
+      padding: 22px;
+      box-shadow: var(--shadow);
+    }
+
+    .recent-search-shell h3 {
+      text-align: center;
+      font-size: 18px;
+      margin-bottom: 18px;
+    }
+
+    .recent-search-input {
+      width: 100%;
+      height: 38px;
+      border: 1px solid #9fcac7;
+      border-radius: 10px;
+      padding: 0 12px;
+      background: #f9fcfc;
+      color: #25353a;
+      font: inherit;
+    }
+
+    .recent-results {
+      list-style: none;
+      margin-top: 14px;
+      border: 1px solid #cad7d7;
+      border-radius: 10px;
+      overflow: hidden;
+    }
+
+    .recent-result {
+      padding: 10px 12px;
+      border-bottom: 1px solid #e4eeee;
+      cursor: pointer;
+    }
+
+    .recent-result:last-child {
+      border-bottom: 0;
+    }
+
+    .recent-result.active {
+      background: #dff3f1;
+      color: #194f53;
+    }
+
+    .recent-result strong,
+    .recent-result span {
+      display: block;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    .recent-result span {
+      margin-top: 3px;
+      color: #60787e;
+      font-size: 12px;
+    }
+
+    .recent-empty {
+      display: none;
+      padding: 18px;
+      color: var(--muted);
+      text-align: center;
+    }
+
     .field {
       display: grid;
       grid-template-columns: 120px 1fr;
@@ -993,6 +1063,7 @@ <h1>QML 组件模拟器</h1>
       <button class="nav-btn" data-target="statistics">Statistics.qml</button>
       <button class="nav-btn" data-target="preferences">Preferences.qml</button>
       <button class="nav-btn" data-target="confirmRestart">ConfirmRestart.qml</button>
+      <button class="nav-btn" data-target="recentSearch">SearchRecentDocuments.qml</button>
       <div class="sidebar-foot">模拟目标: DialogShell / DialogButtons / EnumCombo / SelectableList / PreviewPane 组合逻辑。</div>
     </aside>
 
@@ -1577,6 +1648,36 @@ <h3>切换界面语言</h3>
         </p>
       </section>
 
+      <section class="panel" id="panel-recent-search">
+        <article class="recent-search-shell">
+          <h3>Search recent documents</h3>
+          <input class="recent-search-input" id="recent-search-input" type="text" placeholder="Search">
+          <ul class="recent-results" id="recent-results">
+            <li class="recent-result active" data-name="National Natural Science Foundation proposal" data-path="C:\\Users\\Mogan\\Documents\\National Natural Science Foundation proposal.tmu">
+              <strong>National Natural Science Foundation proposal</strong>
+              <span>C:\\Users\\Mogan\\Documents\\National Natural Science Foundation proposal.tmu</span>
+            </li>
+            <li class="recent-result" data-name="Research notes" data-path="C:\\Users\\Mogan\\Documents\\Research notes.tm">
+              <strong>Research notes</strong>
+              <span>C:\\Users\\Mogan\\Documents\\Research notes.tm</span>
+            </li>
+            <li class="recent-result" data-name="Thesis outline" data-path="D:\\Writing\\Thesis outline.tmu">
+              <strong>Thesis outline</strong>
+              <span>D:\\Writing\\Thesis outline.tmu</span>
+            </li>
+            <li class="recent-empty" id="recent-empty">No matching recent documents</li>
+          </ul>
+          <div class="btn-row" style="justify-content: flex-end; margin-top: 14px;">
+            <button class="btn primary" id="recent-open">Open</button>
+            <button class="btn" data-log="SearchRecentDocuments: cancel()">Cancel</button>
+          </div>
+        </article>
+        <p class="legend">
+          QML: <code>recentDocuments + fuzzyScore()</code>
+          <code>onTextChanged -&gt; updateMatches()</code>
+          <code>Open -&gt; closeBridge.submit({ path })</code>
+        </p>
+      </section>
 
     </main>
   </div>
@@ -1591,7 +1692,8 @@ <h3>切换界面语言</h3>
         paragraph: document.getElementById('panel-paragraph'),
         statistics: document.getElementById('panel-statistics'),
         preferences: document.getElementById('panel-preferences'),
-        confirmRestart: document.getElementById('panel-confirm-restart')
+        confirmRestart: document.getElementById('panel-confirm-restart'),
+        recentSearch: document.getElementById('panel-recent-search')
       };
 
       const titleMap = {
@@ -1601,7 +1703,8 @@ <h3>切换界面语言</h3>
         paragraph: 'ParagraphFormat.qml 模拟',
         statistics: 'Statistics.qml 模拟',
         preferences: 'Preferences.qml 模拟',
-        confirmRestart: 'ConfirmRestart.qml 模拟'
+        confirmRestart: 'ConfirmRestart.qml 模拟',
+        recentSearch: 'SearchRecentDocuments.qml 模拟'
       };
 
       const codeMap = {
@@ -1611,7 +1714,8 @@ <h3>切换界面语言</h3>
         paragraph: 'EnumCombo x N + tabs(基础/高级) + make-multi-line-with 写回',
         statistics: 'statsModel: [{label, value}, ...] + closeBridge.choose(0) 关闭',
         preferences: 'prefTabs(5) + subTabs(6) + EnumCombo + Toggle + 纯 OK 提交',
-        confirmRestart: 'message + buttonLabels + closeBridge.choose(index)'
+        confirmRestart: 'message + buttonLabels + closeBridge.choose(index)',
+        recentSearch: 'recentDocuments + fuzzyScore() + closeBridge.submit({ path })'
       };
 
       const viewTitle = document.getElementById('view-title');
@@ -1646,6 +1750,49 @@ <h3>切换界面语言</h3>
         });
       });
 
+      const recentSearchInput = document.getElementById('recent-search-input');
+      const recentResults = document.querySelectorAll('.recent-result');
+      const recentEmpty = document.getElementById('recent-empty');
+      let recentSelected = document.querySelector('.recent-result.active');
+
+      function fuzzyMatch(text, query) {
+        let cursor = 0;
+        const haystack = text.toLowerCase();
+        for (const character of query.toLowerCase()) {
+          cursor = haystack.indexOf(character, cursor);
+          if (cursor < 0) return false;
+          cursor += 1;
+        }
+        return true;
+      }
+
+      recentSearchInput.addEventListener('input', () => {
+        const query = recentSearchInput.value.trim();
+        let visibleCount = 0;
+        recentResults.forEach((row) => {
+          const matched = !query || fuzzyMatch(row.dataset.name, query) || fuzzyMatch(row.dataset.path, query);
+          row.style.display = matched ? '' : 'none';
+          if (matched) visibleCount += 1;
+        });
+        recentEmpty.style.display = visibleCount ? 'none' : 'block';
+        const selectedVisible = recentSelected && recentSelected.style.display !== 'none';
+        if (!selectedVisible) {
+          recentSelected = Array.from(recentResults).find((row) => row.style.display !== 'none') || null;
+          recentResults.forEach((row) => row.classList.toggle('active', row === recentSelected));
+        }
+      });
+
+      recentResults.forEach((row) => {
+        row.addEventListener('click', () => {
+          recentSelected = row;
+          recentResults.forEach((item) => item.classList.toggle('active', item === row));
+        });
+      });
+
+      document.getElementById('recent-open').addEventListener('click', () => {
+        if (recentSelected) log('SearchRecentDocuments: submit({ path: "' + recentSelected.dataset.path + '" })');
+      });
+
       document.getElementById('form-submit').addEventListener('click', () => {
         const values = {
           language: document.getElementById('field-language').value,
@@ -1871,4 +2018,4 @@ <h3>切换界面语言</h3>
     })();
   </script>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/src/Plugins/Qt/QTMQmlDialog.cpp b/src/Plugins/Qt/QTMQmlDialog.cpp
index 566280f30c..d5dd2fc49e 100644
--- a/src/Plugins/Qt/QTMQmlDialog.cpp
+++ b/src/Plugins/Qt/QTMQmlDialog.cpp
@@ -26,9 +26,12 @@ using moebius::data::scm_unquote;
 using moebius::data::tree_to_scheme_tree;
 
 #include <QDialog>
+#include <QDir>
+#include <QFileInfo>
 #include <QQmlContext>
 #include <QQmlError>
 #include <QQuickWidget>
+#include <QSet>
 #include <QString>
 #include <QStringList>
 #include <QVBoxLayout>
@@ -599,3 +602,52 @@ cpp_preferences_dialog () {
   delete bridge;
   return tree (TUPLE);
 }
+
+// ---- Search recent documents ------------------------------------------------
+
+string
+cpp_search_recent_documents_dialog () {
+  string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
+  if (preset != "") return preset == "cancel" ? string ("") : preset;
+
+  QVariantList  recentDocuments;
+  QSet<QString> seenPaths;
+  tmscm         recentPaths= eval_scheme ("(recent-documents-for-qml)");
+  for (tmscm cur= recentPaths; !tmscm_is_null (cur); cur= tmscm_cdr (cur)) {
+    tmscm item= tmscm_car (cur);
+    if (!tmscm_is_string (item)) continue;
+    QString path= QString::fromUtf8 (as_charp (tmscm_to_string (item)));
+    if (path.isEmpty ()) continue;
+    QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
+    if (seenPaths.contains (normalizedPath)) continue;
+    seenPaths.insert (normalizedPath);
+    QVariantMap document;
+    document["path"]= path;
+    document["name"]= QFileInfo (path).fileName ();
+    recentDocuments << document;
+  }
+
+  array<string>    buttons= {string ("Open"), string ("Cancel")};
+  QmlDialogBridge* bridge = nullptr;
+  run_qml_dialog (
+      "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
+      [&] (QQuickWidget* qw, QDialog& host) {
+        bridge= inject_common_context (qw, host);
+        qw->rootContext ()->setContextProperty (
+            "searchDialogTitle", qt_translate ("Search recent documents"));
+        qw->rootContext ()->setContextProperty ("searchPlaceholder",
+                                                qt_translate ("Search"));
+        qw->rootContext ()->setContextProperty (
+            "searchEmptyText", qt_translate ("No matching recent documents"));
+        qw->rootContext ()->setContextProperty ("recentDocuments",
+                                                recentDocuments);
+        qw->rootContext ()->setContextProperty ("dialogButtons",
+                                                translate_buttons (buttons));
+      },
+      520, 450);
+
+  QString path;
+  if (bridge) path= bridge->results ().value ("path").toString ();
+  delete bridge;
+  return from_qstring (path);
+}
diff --git a/src/Plugins/Qt/QTMQmlDialog.hpp b/src/Plugins/Qt/QTMQmlDialog.hpp
index 6ac1cda09f..a2b4f8d41f 100644
--- a/src/Plugins/Qt/QTMQmlDialog.hpp
+++ b/src/Plugins/Qt/QTMQmlDialog.hpp
@@ -204,4 +204,13 @@ void cpp_statistics_dialog (string title, tree items);
  */
 tree cpp_preferences_dialog ();
 
+/**
+ * @brief Open the QML search dialog for recently opened documents.
+ *
+ * @return The selected document path, or an empty string after Cancel, Esc,
+ *
+ * window close, or QML loading failure.
+ */
+string cpp_search_recent_documents_dialog ();
+
 #endif // defined QTM_QML_DIALOG_H
diff --git a/src/Plugins/Qt/moganqml.qrc b/src/Plugins/Qt/moganqml.qrc
index 6955c83c19..19f1c659a4 100644
--- a/src/Plugins/Qt/moganqml.qrc
+++ b/src/Plugins/Qt/moganqml.qrc
@@ -21,5 +21,6 @@
         <file>qml/ParagraphFormat.qml</file>
         <file>qml/Statistics.qml</file>
         <file>qml/Preferences.qml</file>
+        <file>qml/SearchRecentDocuments.qml</file>
     </qresource>
 </RCC>
diff --git a/src/Plugins/Qt/qml/SearchRecentDocuments.qml b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
new file mode 100644
index 0000000000..29218f1ea5
--- /dev/null
+++ b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
@@ -0,0 +1,194 @@
+import QtQuick
+import "atoms"
+
+DialogShell {
+    id: root
+    implicitWidth: 520
+    implicitHeight: 450
+    implicitMargins: Theme.margin
+
+    property string title: typeof searchDialogTitle !== "undefined" ? searchDialogTitle : "Search recent documents"
+    property string placeholder: typeof searchPlaceholder !== "undefined" ? searchPlaceholder : "Search"
+    property string emptyText: typeof searchEmptyText !== "undefined" ? searchEmptyText : "No matching recent documents"
+    property var documents: typeof recentDocuments !== "undefined" ? recentDocuments : []
+    property var buttonLabels: typeof dialogButtons !== "undefined" ? dialogButtons : ["Open", "Cancel"]
+    property var matches: []
+    property int selectedIndex: -1
+
+    function fuzzyScore(text, query) {
+        var haystack = text.toLocaleLowerCase()
+        var needle = query.toLocaleLowerCase()
+        var cursor = 0
+        var score = 0
+        for (var i = 0; i < needle.length; ++i) {
+            var index = haystack.indexOf(needle.charAt(i), cursor)
+            if (index < 0)
+                return -1
+            score += index - cursor
+            cursor = index + 1
+        }
+        return score
+    }
+
+    function updateMatches() {
+        var query = searchInput.text.trim()
+        var next = []
+        for (var i = 0; i < documents.length; ++i) {
+            var document = documents[i]
+            var score = query.length === 0 ? i : fuzzyScore(document.name, query)
+            if (score < 0 && query.length > 0)
+                score = fuzzyScore(document.path, query)
+            if (score >= 0)
+                next.push({ "name": document.name, "path": document.path, "score": score })
+        }
+        next.sort(function(a, b) { return a.score - b.score })
+        matches = next
+        selectedIndex = -1
+    }
+
+    function openSelection() {
+        if (selectedIndex >= 0 && selectedIndex < matches.length)
+            closeBridge.submit({ "path": matches[selectedIndex].path })
+    }
+
+    Component.onCompleted: updateMatches()
+    onDocumentsChanged: updateMatches()
+
+    content: Column {
+        spacing: Theme.gapM
+
+        Text {
+            width: parent.width
+            height: Theme.titleH
+            text: root.title
+            color: Theme.fg
+            font.pixelSize: 18 * Theme.scaleFactor
+            font.weight: Font.Bold
+            horizontalAlignment: Text.AlignHCenter
+            verticalAlignment: Text.AlignVCenter
+            elide: Text.ElideRight
+        }
+
+        Rectangle {
+            width: parent.width
+            height: Theme.rowH
+            radius: Theme.radius
+            color: Theme.fieldBg
+            border.width: Theme.borderW
+            border.color: searchInput.activeFocus ? Theme.dropdownBorder : Theme.borderClr
+
+            Text {
+                anchors.fill: parent
+                anchors.leftMargin: Theme.comboPad
+                anchors.rightMargin: Theme.comboPad
+                text: root.placeholder
+                color: Theme.muted
+                font.pixelSize: Theme.fontBody
+                verticalAlignment: Text.AlignVCenter
+                visible: searchInput.text.length === 0 && !searchInput.activeFocus
+                elide: Text.ElideRight
+            }
+
+            TextInput {
+                id: searchInput
+                anchors.fill: parent
+                anchors.leftMargin: Theme.comboPad
+                anchors.rightMargin: Theme.comboPad
+                color: Theme.fg
+                font.pixelSize: Theme.fontBody
+                verticalAlignment: TextInput.AlignVCenter
+                selectByMouse: true
+                clip: true
+                focus: true
+                onTextChanged: root.updateMatches()
+                Component.onCompleted: forceActiveFocus()
+            }
+        }
+
+        Rectangle {
+            width: parent.width
+            height: 230 * Theme.scaleFactor
+            radius: Theme.radius
+            color: Theme.listBg
+            border.width: Theme.borderW
+            border.color: Theme.borderClr
+
+            Rectangle {
+                anchors.fill: parent
+                anchors.margins: parent.border.width
+                radius: Math.max(0, parent.radius - parent.border.width)
+                color: parent.color
+                clip: true
+
+                ListView {
+                    id: resultList
+                    anchors.fill: parent
+                    anchors.margins: Theme.padS
+                    clip: true
+                    boundsBehavior: Flickable.StopAtBounds
+                    model: root.matches
+
+                    delegate: Rectangle {
+                        width: resultList.width
+                        height: 48 * Theme.scaleFactor
+                        radius: Theme.radius
+                        color: root.selectedIndex === index ? Theme.selectBg : (resultMouse.containsMouse ? Theme.fieldBgHover : "transparent")
+                        border.width: root.selectedIndex === index ? Theme.borderW : 0
+                        border.color: Theme.selectBorder
+
+                        Column {
+                            anchors.fill: parent
+                            anchors.leftMargin: Theme.comboPad
+                            anchors.rightMargin: Theme.comboPad
+                            spacing: Theme.padS
+
+                            Text {
+                                width: parent.width
+                                text: modelData.name
+                                color: root.selectedIndex === index ? Theme.selectFg : Theme.fg
+                                font.pixelSize: Theme.fontBody
+                                font.weight: Font.DemiBold
+                                elide: Text.ElideRight
+                            }
+
+                            Text {
+                                width: parent.width
+                                text: modelData.path
+                                color: Theme.muted
+                                font.pixelSize: Theme.fontTiny
+                                elide: Text.ElideMiddle
+                            }
+                        }
+
+                        MouseArea {
+                            id: resultMouse
+                            anchors.fill: parent
+                            hoverEnabled: true
+                            cursorShape: Qt.PointingHandCursor
+                            onClicked: root.selectedIndex = index
+                        }
+                    }
+                }
+
+                Text {
+                    anchors.centerIn: parent
+                    visible: root.matches.length === 0
+                    text: root.emptyText
+                    color: Theme.muted
+                    font.pixelSize: Theme.fontBody
+                }
+            }
+        }
+
+        DialogButtons {
+            anchors.horizontalCenter: parent.horizontalCenter
+            buttonLabels: root.buttonLabels
+            onClicked: function(index) {
+                if (index === 0)
+                    root.openSelection()
+                else
+                    closeBridge.cancel()
+            }
+        }
+    }
+}
diff --git a/src/Plugins/Qt/qml/qmldir b/src/Plugins/Qt/qml/qmldir
index cbd79391d7..aa1fcc92bb 100644
--- a/src/Plugins/Qt/qml/qmldir
+++ b/src/Plugins/Qt/qml/qmldir
@@ -5,3 +5,4 @@ FontSelector 1.0 FontSelector.qml
 ParagraphFormat 1.0 ParagraphFormat.qml
 Statistics 1.0 Statistics.qml
 Preferences 1.0 Preferences.qml
+SearchRecentDocuments 1.0 SearchRecentDocuments.qml
diff --git a/src/Scheme/L5/glue_qt.lua b/src/Scheme/L5/glue_qt.lua
index 278e06a0fe..094c7b5119 100644
--- a/src/Scheme/L5/glue_qt.lua
+++ b/src/Scheme/L5/glue_qt.lua
@@ -89,6 +89,12 @@ function main()
                 ret_type = "tree",
                 arg_list = {}
             },
+            {
+                scm_name = "cpp-search-recent-documents-dialog",
+                cpp_name = "cpp_search_recent_documents_dialog",
+                ret_type = "string",
+                arg_list = {}
+            },
             {
                 scm_name = "cpp-rasterize-widget",
                 cpp_name = "cpp_rasterize_widget",
@@ -197,4 +203,4 @@ function main()
             }
         }
     }
-end
\ No newline at end of file
+end
diff --git a/tests/Plugins/Qt/qml_dialog_test.cpp b/tests/Plugins/Qt/qml_dialog_test.cpp
index f5e2a98677..e7cc8bb853 100644
--- a/tests/Plugins/Qt/qml_dialog_test.cpp
+++ b/tests/Plugins/Qt/qml_dialog_test.cpp
@@ -72,6 +72,7 @@ private slots:
   void test_translate_buttons ();
   void test_confirm_close_hook ();
   void test_form_dialog_hook ();
+  void test_search_recent_documents_hook ();
 };
 
 // 字段下标协议常量与协议文档一致。
@@ -245,6 +246,19 @@ TestQmlDialog::test_form_dialog_hook () {
   }
 }
 
+void
+TestQmlDialog::test_search_recent_documents_hook () {
+  {
+    EnvHook hook ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS", "C:/docs/needle.tm");
+    QCOMPARE (cpp_search_recent_documents_dialog (),
+              string ("C:/docs/needle.tm"));
+  }
+  {
+    EnvHook hook ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS", "cancel");
+    QCOMPARE (cpp_search_recent_documents_dialog (), string (""));
+  }
+}
+
 #ifdef QTTEXMACS
 QTEST_MAIN (TestQmlDialog)
 #else
diff --git a/tests/Plugins/Qt/qml_load_test.cpp b/tests/Plugins/Qt/qml_load_test.cpp
index e2c8533464..78fa105479 100644
--- a/tests/Plugins/Qt/qml_load_test.cpp
+++ b/tests/Plugins/Qt/qml_load_test.cpp
@@ -185,6 +185,7 @@ private slots:
   void test_paragraph_format_loads ();
   void test_preferences_loads ();
   void test_statistics_loads ();
+  void test_search_recent_documents_loads ();
 };
 
 // 共用：构造带 closeBridge/dpScale/isDark 的 QQuickWidget，加载给定 qrc url。
@@ -334,6 +335,36 @@ TestQmlLoad::test_statistics_loads () {
   QCOMPARE (qw->status (), QQuickWidget::Ready);
 }
 
+void
+TestQmlLoad::test_search_recent_documents_loads () {
+  QDialog       host;
+  QQuickWidget* qw= new QQuickWidget (&host);
+  qw->setResizeMode (QQuickWidget::SizeRootObjectToView);
+  StubBridge* bridge= new StubBridge (qw);
+  qw->rootContext ()->setContextProperty ("closeBridge", bridge);
+  qw->rootContext ()->setContextProperty ("dpScale", 1.0);
+  qw->rootContext ()->setContextProperty ("isDark", false);
+  qw->rootContext ()->setContextProperty ("searchDialogTitle",
+                                          QString ("Search recent documents"));
+  qw->rootContext ()->setContextProperty ("searchPlaceholder",
+                                          QString ("Search"));
+  qw->rootContext ()->setContextProperty (
+      "searchEmptyText", QString ("No matching recent documents"));
+  QVariantMap document;
+  document["name"]= QString ("notes.tm");
+  document["path"]= QString ("C:/docs/notes.tm");
+  QVariantList documents;
+  documents << document;
+  qw->rootContext ()->setContextProperty ("recentDocuments", documents);
+  QStringList buttons;
+  buttons << "Open"
+          << "Cancel";
+  qw->rootContext ()->setContextProperty ("dialogButtons", buttons);
+  qw->setSource (QUrl ("qrc:/qml/SearchRecentDocuments.qml"));
+  QCOMPARE (qw->status (), QQuickWidget::Ready);
+  QCOMPARE (qw->rootObject ()->property ("selectedIndex").toInt (), -1);
+}
+
 #ifdef QTTEXMACS
 QTEST_MAIN (TestQmlLoad)
 #else

From 5203290875d2a8380d8b98e1a8076a75f50d1c35 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Mon, 3 Aug 2026 16:36:37 +0800
Subject: [PATCH 3/8] [2085] isolate recent document search dialog

---
 devel/2085.md                                 |  4 +-
 src/Plugins/Qt/QTMQmlDialog.cpp               | 56 +-------------
 src/Plugins/Qt/QTMQmlDialog.hpp               | 10 +--
 src/Plugins/Qt/QTMQmlDialogInternal.hpp       | 14 ++++
 .../Qt/RecentDocumentsSearchDialog.cpp        | 73 +++++++++++++++++++
 .../Qt/RecentDocumentsSearchDialog.hpp        | 23 ++++++
 6 files changed, 116 insertions(+), 64 deletions(-)
 create mode 100644 src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
 create mode 100644 src/Plugins/Qt/RecentDocumentsSearchDialog.hpp

diff --git a/devel/2085.md b/devel/2085.md
index 949e67c9a5..067d4b21fa 100644
--- a/devel/2085.md
+++ b/devel/2085.md
@@ -6,7 +6,8 @@
 ## 任务相关的代码文件
 - `TeXmacs/progs/doc/docgrep.scm`
 - `TeXmacs/progs/texmacs/menus/edit-menu.scm`
-- `src/Plugins/Qt/QTMQmlDialog.cpp`
+- `src/Plugins/Qt/RecentDocumentsSearchDialog.hpp`
+- `src/Plugins/Qt/RecentDocumentsSearchDialog.cpp`
 - `src/Plugins/Qt/qml/SearchRecentDocuments.qml`
 
 ## 如何测试
@@ -35,3 +36,4 @@ xmake install stem
 - C++ 将最近文件模型注入 QML，保持 UTF-8 路径编码。
 - C++ 以规范化路径去重，保留最近记录中的第一次出现。
 - QML 按文件名优先、完整路径兜底执行子序列模糊匹配；只有显式选中并点击“打开”才加载选定文件。
+- 最近文档搜索的路径和模型逻辑独立于 QML 通用对话框底座，复用其内部模态引擎和 context 注入接口。
diff --git a/src/Plugins/Qt/QTMQmlDialog.cpp b/src/Plugins/Qt/QTMQmlDialog.cpp
index 4109f05654..ed7c67f6a3 100644
--- a/src/Plugins/Qt/QTMQmlDialog.cpp
+++ b/src/Plugins/Qt/QTMQmlDialog.cpp
@@ -27,12 +27,9 @@ using moebius::data::scm_unquote;
 using moebius::data::tree_to_scheme_tree;
 
 #include <QDialog>
-#include <QDir>
-#include <QFileInfo>
 #include <QQmlContext>
 #include <QQmlError>
 #include <QQuickWidget>
-#include <QSet>
 #include <QString>
 #include <QStringList>
 #include <QVBoxLayout>
@@ -126,7 +123,7 @@ setup_frameless_qml_host (QDialog& d) {
  * QObject parent，不会被宿主 QDialog 析构带走，以便 form 型 exec 后取
  * results()）。
  */
-static QmlDialogBridge*
+QmlDialogBridge*
 inject_common_context (QQuickWidget* qw, QDialog& host) {
   bool isDark=
       occurs ("dark", tm_style_sheet) || occurs ("liii-night", tm_style_sheet);
@@ -172,7 +169,7 @@ lock_fixed_size (QQuickWidget* qw, QVBoxLayout* vl, QDialog& d, int logic_w,
  *         QML 加载失败返回 -1。调用方据此映射结果（确认型 → 按钮下标；form 型
  *         → Accepted/Rejected，表单值另行从 bridge->results() 取）。
  */
-static int
+int
 run_qml_dialog (const string& qml_url, const char* debug_tag,
                 std::function<void (QQuickWidget*, QDialog&)> inject_context,
                 int logic_w, int logic_h) {
@@ -641,52 +638,3 @@ cpp_preferences_dialog () {
   delete bridge;
   return tree (TUPLE);
 }
-
-// ---- Search recent documents ------------------------------------------------
-
-string
-cpp_search_recent_documents_dialog () {
-  string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
-  if (preset != "") return preset == "cancel" ? string ("") : preset;
-
-  QVariantList  recentDocuments;
-  QSet<QString> seenPaths;
-  tmscm         recentPaths= eval_scheme ("(recent-documents-for-qml)");
-  for (tmscm cur= recentPaths; !tmscm_is_null (cur); cur= tmscm_cdr (cur)) {
-    tmscm item= tmscm_car (cur);
-    if (!tmscm_is_string (item)) continue;
-    QString path= QString::fromUtf8 (as_charp (tmscm_to_string (item)));
-    if (path.isEmpty ()) continue;
-    QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
-    if (seenPaths.contains (normalizedPath)) continue;
-    seenPaths.insert (normalizedPath);
-    QVariantMap document;
-    document["path"]= path;
-    document["name"]= QFileInfo (path).fileName ();
-    recentDocuments << document;
-  }
-
-  array<string>    buttons= {string ("Open"), string ("Cancel")};
-  QmlDialogBridge* bridge = nullptr;
-  run_qml_dialog (
-      "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
-      [&] (QQuickWidget* qw, QDialog& host) {
-        bridge= inject_common_context (qw, host);
-        qw->rootContext ()->setContextProperty (
-            "searchDialogTitle", qt_translate ("Search recent documents"));
-        qw->rootContext ()->setContextProperty ("searchPlaceholder",
-                                                qt_translate ("Search"));
-        qw->rootContext ()->setContextProperty (
-            "searchEmptyText", qt_translate ("No matching recent documents"));
-        qw->rootContext ()->setContextProperty ("recentDocuments",
-                                                recentDocuments);
-        qw->rootContext ()->setContextProperty ("dialogButtons",
-                                                translate_buttons (buttons));
-      },
-      520, 450);
-
-  QString path;
-  if (bridge) path= bridge->results ().value ("path").toString ();
-  delete bridge;
-  return from_qstring (path);
-}
diff --git a/src/Plugins/Qt/QTMQmlDialog.hpp b/src/Plugins/Qt/QTMQmlDialog.hpp
index 831bbd92c7..308dad4d56 100644
--- a/src/Plugins/Qt/QTMQmlDialog.hpp
+++ b/src/Plugins/Qt/QTMQmlDialog.hpp
@@ -92,6 +92,7 @@
 #define QTM_QML_DIALOG_H
 
 #include "array.hpp"
+#include "RecentDocumentsSearchDialog.hpp"
 #include "string.hpp"
 #include "tree.hpp"
 
@@ -214,13 +215,4 @@ bool cpp_version_dialog (string title, string message);
  */
 tree cpp_preferences_dialog ();
 
-/**
- * @brief Open the QML search dialog for recently opened documents.
- *
- * @return The selected document path, or an empty string after Cancel, Esc,
- *
- * window close, or QML loading failure.
- */
-string cpp_search_recent_documents_dialog ();
-
 #endif // defined QTM_QML_DIALOG_H
diff --git a/src/Plugins/Qt/QTMQmlDialogInternal.hpp b/src/Plugins/Qt/QTMQmlDialogInternal.hpp
index 4c4fb5b16d..80681757c9 100644
--- a/src/Plugins/Qt/QTMQmlDialogInternal.hpp
+++ b/src/Plugins/Qt/QTMQmlDialogInternal.hpp
@@ -10,10 +10,17 @@
 #ifndef QTM_QML_DIALOG_INTERNAL_H
 #define QTM_QML_DIALOG_INTERNAL_H
 
+#include "array.hpp"
+#include "string.hpp"
 #include "tree.hpp"
 
 #include <QStringList>
 #include <QVariantMap>
+#include <functional>
+
+class QDialog;
+class QQuickWidget;
+class QmlDialogBridge;
 
 // 字段节点下标协议（见 QTMQmlDialog.hpp @par 数据协议）：
 // (<type> <label> <key> (<options>...) <value> <live?>)
@@ -57,4 +64,11 @@ QVariantMap field_tree_to_qml (tree f);
  */
 QStringList translate_buttons (array<string> buttons);
 
+QmlDialogBridge* inject_common_context (QQuickWidget* qw, QDialog& host);
+
+int run_qml_dialog (
+    const string& qml_url, const char* debug_tag,
+    std::function<void (QQuickWidget*, QDialog&)> inject_context, int logic_w,
+    int logic_h);
+
 #endif // defined QTM_QML_DIALOG_INTERNAL_H
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
new file mode 100644
index 0000000000..e3f22e7835
--- /dev/null
+++ b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
@@ -0,0 +1,73 @@
+/******************************************************************************
+ * MODULE      : RecentDocumentsSearchDialog.cpp
+ * DESCRIPTION : 最近打开文档搜索 QML 对话框的实现。
+ * COPYRIGHT   : (C) 2026 Mogan STEM
+ *
+ * This software falls under the GNU general public license version 3 or later.
+ * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
+ ******************************************************************************/
+
+#include "RecentDocumentsSearchDialog.hpp"
+
+#include "QTMQmlDialogBridge.hpp"
+#include "QTMQmlDialogInternal.hpp"
+
+#include "qt_utilities.hpp"
+#include "s7_tm.hpp"
+#include "sys_utils.hpp"
+
+#include <QDialog>
+#include <QDir>
+#include <QFileInfo>
+#include <QQmlContext>
+#include <QQuickWidget>
+#include <QSet>
+#include <QVariantList>
+#include <QVariantMap>
+
+string
+cpp_search_recent_documents_dialog () {
+  string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
+  if (preset != "") return preset == "cancel" ? string ("") : preset;
+
+  QVariantList  recentDocuments;
+  QSet<QString> seenPaths;
+  tmscm         recentPaths= eval_scheme ("(recent-documents-for-qml)");
+  for (tmscm cur= recentPaths; !tmscm_is_null (cur); cur= tmscm_cdr (cur)) {
+    tmscm item= tmscm_car (cur);
+    if (!tmscm_is_string (item)) continue;
+    QString path= QString::fromUtf8 (as_charp (tmscm_to_string (item)));
+    if (path.isEmpty ()) continue;
+    QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
+    if (seenPaths.contains (normalizedPath)) continue;
+    seenPaths.insert (normalizedPath);
+    QVariantMap document;
+    document["path"]= path;
+    document["name"]= QFileInfo (path).fileName ();
+    recentDocuments << document;
+  }
+
+  array<string>    buttons= {string ("Open"), string ("Cancel")};
+  QmlDialogBridge* bridge = nullptr;
+  run_qml_dialog (
+      "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
+      [&] (QQuickWidget* qw, QDialog& host) {
+        bridge= inject_common_context (qw, host);
+        qw->rootContext ()->setContextProperty (
+            "searchDialogTitle", qt_translate ("Search recent documents"));
+        qw->rootContext ()->setContextProperty ("searchPlaceholder",
+                                                qt_translate ("Search"));
+        qw->rootContext ()->setContextProperty (
+            "searchEmptyText", qt_translate ("No matching recent documents"));
+        qw->rootContext ()->setContextProperty ("recentDocuments",
+                                                recentDocuments);
+        qw->rootContext ()->setContextProperty ("dialogButtons",
+                                                translate_buttons (buttons));
+      },
+      520, 450);
+
+  QString path;
+  if (bridge) path= bridge->results ().value ("path").toString ();
+  delete bridge;
+  return from_qstring (path);
+}
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp
new file mode 100644
index 0000000000..eadccdc4a6
--- /dev/null
+++ b/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp
@@ -0,0 +1,23 @@
+/******************************************************************************
+ * MODULE      : RecentDocumentsSearchDialog.hpp
+ * DESCRIPTION : 最近打开文档搜索 QML 对话框的入口。
+ * COPYRIGHT   : (C) 2026 Mogan STEM
+ *
+ * This software falls under the GNU general public license version 3 or later.
+ * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
+ ******************************************************************************/
+
+#ifndef RECENT_DOCUMENTS_SEARCH_DIALOG_HPP
+#define RECENT_DOCUMENTS_SEARCH_DIALOG_HPP
+
+#include "string.hpp"
+
+/**
+ * @brief Open the QML search dialog for recently opened documents.
+ *
+ * @return The selected document path, or an empty string after Cancel, Esc,
+ * window close, or QML loading failure.
+ */
+string cpp_search_recent_documents_dialog ();
+
+#endif // defined RECENT_DOCUMENTS_SEARCH_DIALOG_HPP

From 4ea2549338d298e6b04960179c8ed6e57f2781f4 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Mon, 3 Aug 2026 17:00:03 +0800
Subject: [PATCH 4/8] [2085] bridge recent document search data

---
 devel/2085.md                                 |  3 ++
 src/Plugins/Qt/QTMQmlDialog.hpp               |  2 +-
 src/Plugins/Qt/QTMQmlDialogInternal.hpp       |  8 ++--
 .../Qt/RecentDocumentsSearchBridge.cpp        | 17 +++++++
 .../Qt/RecentDocumentsSearchBridge.hpp        | 46 +++++++++++++++++++
 .../Qt/RecentDocumentsSearchDialog.cpp        | 19 ++++----
 src/Plugins/Qt/qml/SearchRecentDocuments.qml  | 10 ++--
 tests/Plugins/Qt/qml_load_test.cpp            | 13 ++----
 8 files changed, 90 insertions(+), 28 deletions(-)
 create mode 100644 src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
 create mode 100644 src/Plugins/Qt/RecentDocumentsSearchBridge.hpp

diff --git a/devel/2085.md b/devel/2085.md
index 067d4b21fa..ff7d9d21bc 100644
--- a/devel/2085.md
+++ b/devel/2085.md
@@ -8,6 +8,8 @@
 - `TeXmacs/progs/texmacs/menus/edit-menu.scm`
 - `src/Plugins/Qt/RecentDocumentsSearchDialog.hpp`
 - `src/Plugins/Qt/RecentDocumentsSearchDialog.cpp`
+- `src/Plugins/Qt/RecentDocumentsSearchBridge.hpp`
+- `src/Plugins/Qt/RecentDocumentsSearchBridge.cpp`
 - `src/Plugins/Qt/qml/SearchRecentDocuments.qml`
 
 ## 如何测试
@@ -37,3 +39,4 @@ xmake install stem
 - C++ 以规范化路径去重，保留最近记录中的第一次出现。
 - QML 按文件名优先、完整路径兜底执行子序列模糊匹配；只有显式选中并点击“打开”才加载选定文件。
 - 最近文档搜索的路径和模型逻辑独立于 QML 通用对话框底座，复用其内部模态引擎和 context 注入接口。
+- 专属 bridge 向 QML 暴露候选模型和已翻译文案；通用 `QmlDialogBridge` 负责提交路径与取消。
diff --git a/src/Plugins/Qt/QTMQmlDialog.hpp b/src/Plugins/Qt/QTMQmlDialog.hpp
index 308dad4d56..3d0ed117ef 100644
--- a/src/Plugins/Qt/QTMQmlDialog.hpp
+++ b/src/Plugins/Qt/QTMQmlDialog.hpp
@@ -91,8 +91,8 @@
 #ifndef QTM_QML_DIALOG_H
 #define QTM_QML_DIALOG_H
 
-#include "array.hpp"
 #include "RecentDocumentsSearchDialog.hpp"
+#include "array.hpp"
 #include "string.hpp"
 #include "tree.hpp"
 
diff --git a/src/Plugins/Qt/QTMQmlDialogInternal.hpp b/src/Plugins/Qt/QTMQmlDialogInternal.hpp
index 80681757c9..5cfaec75e9 100644
--- a/src/Plugins/Qt/QTMQmlDialogInternal.hpp
+++ b/src/Plugins/Qt/QTMQmlDialogInternal.hpp
@@ -66,9 +66,9 @@ QStringList translate_buttons (array<string> buttons);
 
 QmlDialogBridge* inject_common_context (QQuickWidget* qw, QDialog& host);
 
-int run_qml_dialog (
-    const string& qml_url, const char* debug_tag,
-    std::function<void (QQuickWidget*, QDialog&)> inject_context, int logic_w,
-    int logic_h);
+int
+run_qml_dialog (const string& qml_url, const char* debug_tag,
+                std::function<void (QQuickWidget*, QDialog&)> inject_context,
+                int logic_w, int logic_h);
 
 #endif // defined QTM_QML_DIALOG_INTERNAL_H
diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
new file mode 100644
index 0000000000..772787c033
--- /dev/null
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
@@ -0,0 +1,17 @@
+/******************************************************************************
+ * MODULE      : RecentDocumentsSearchBridge.cpp
+ * DESCRIPTION : 最近打开文档搜索的 QML 数据桥接实现。
+ * COPYRIGHT   : (C) 2026 Mogan STEM
+ *
+ * This software falls under the GNU general public license version 3 or later.
+ * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
+ ******************************************************************************/
+
+#include "RecentDocumentsSearchBridge.hpp"
+
+RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (
+    QVariantList documents, QString title, QString placeholder,
+    QString emptyText, QStringList buttonLabels, QObject* parent)
+    : QObject (parent), m_documents (documents), m_title (title),
+      m_placeholder (placeholder), m_emptyText (emptyText),
+      m_buttonLabels (buttonLabels) {}
diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
new file mode 100644
index 0000000000..fc447c2de5
--- /dev/null
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
@@ -0,0 +1,46 @@
+/******************************************************************************
+ * MODULE      : RecentDocumentsSearchBridge.hpp
+ * DESCRIPTION : 最近打开文档搜索的 QML 数据桥接。
+ * COPYRIGHT   : (C) 2026 Mogan STEM
+ *
+ * This software falls under the GNU general public license version 3 or later.
+ * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
+ ******************************************************************************/
+
+#ifndef RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
+#define RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
+
+#include <QObject>
+#include <QString>
+#include <QStringList>
+#include <QVariantList>
+
+class RecentDocumentsSearchBridge : public QObject {
+  Q_OBJECT
+  Q_PROPERTY (QVariantList documents READ documents CONSTANT)
+  Q_PROPERTY (QString title READ title CONSTANT)
+  Q_PROPERTY (QString placeholder READ placeholder CONSTANT)
+  Q_PROPERTY (QString emptyText READ emptyText CONSTANT)
+  Q_PROPERTY (QStringList buttonLabels READ buttonLabels CONSTANT)
+
+public:
+  RecentDocumentsSearchBridge (QVariantList documents, QString title,
+                               QString placeholder, QString emptyText,
+                               QStringList buttonLabels,
+                               QObject*    parent= nullptr);
+
+  const QVariantList& documents () const { return m_documents; }
+  const QString&      title () const { return m_title; }
+  const QString&      placeholder () const { return m_placeholder; }
+  const QString&      emptyText () const { return m_emptyText; }
+  const QStringList&  buttonLabels () const { return m_buttonLabels; }
+
+private:
+  QVariantList m_documents;
+  QString      m_title;
+  QString      m_placeholder;
+  QString      m_emptyText;
+  QStringList  m_buttonLabels;
+};
+
+#endif // defined RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
index e3f22e7835..f1a74e2915 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
@@ -11,6 +11,7 @@
 
 #include "QTMQmlDialogBridge.hpp"
 #include "QTMQmlDialogInternal.hpp"
+#include "RecentDocumentsSearchBridge.hpp"
 
 #include "qt_utilities.hpp"
 #include "s7_tm.hpp"
@@ -53,16 +54,14 @@ cpp_search_recent_documents_dialog () {
       "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
       [&] (QQuickWidget* qw, QDialog& host) {
         bridge= inject_common_context (qw, host);
-        qw->rootContext ()->setContextProperty (
-            "searchDialogTitle", qt_translate ("Search recent documents"));
-        qw->rootContext ()->setContextProperty ("searchPlaceholder",
-                                                qt_translate ("Search"));
-        qw->rootContext ()->setContextProperty (
-            "searchEmptyText", qt_translate ("No matching recent documents"));
-        qw->rootContext ()->setContextProperty ("recentDocuments",
-                                                recentDocuments);
-        qw->rootContext ()->setContextProperty ("dialogButtons",
-                                                translate_buttons (buttons));
+        RecentDocumentsSearchBridge* searchBridge=
+            new RecentDocumentsSearchBridge (
+                recentDocuments, qt_translate ("Search recent documents"),
+                qt_translate ("Search"),
+                qt_translate ("No matching recent documents"),
+                translate_buttons (buttons), &host);
+        qw->rootContext ()->setContextProperty ("recentSearchBridge",
+                                                searchBridge);
       },
       520, 450);
 
diff --git a/src/Plugins/Qt/qml/SearchRecentDocuments.qml b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
index 29218f1ea5..3ed98f802e 100644
--- a/src/Plugins/Qt/qml/SearchRecentDocuments.qml
+++ b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
@@ -7,11 +7,11 @@ DialogShell {
     implicitHeight: 450
     implicitMargins: Theme.margin
 
-    property string title: typeof searchDialogTitle !== "undefined" ? searchDialogTitle : "Search recent documents"
-    property string placeholder: typeof searchPlaceholder !== "undefined" ? searchPlaceholder : "Search"
-    property string emptyText: typeof searchEmptyText !== "undefined" ? searchEmptyText : "No matching recent documents"
-    property var documents: typeof recentDocuments !== "undefined" ? recentDocuments : []
-    property var buttonLabels: typeof dialogButtons !== "undefined" ? dialogButtons : ["Open", "Cancel"]
+    property string title: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.title : "Search recent documents"
+    property string placeholder: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.placeholder : "Search"
+    property string emptyText: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.emptyText : "No matching recent documents"
+    property var documents: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.documents : []
+    property var buttonLabels: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.buttonLabels : ["Open", "Cancel"]
     property var matches: []
     property int selectedIndex: -1
 
diff --git a/tests/Plugins/Qt/qml_load_test.cpp b/tests/Plugins/Qt/qml_load_test.cpp
index c4c1008484..cb68756f71 100644
--- a/tests/Plugins/Qt/qml_load_test.cpp
+++ b/tests/Plugins/Qt/qml_load_test.cpp
@@ -13,6 +13,7 @@
  * It comes with NO WARRANTY whatsoever. Details see LICENSE.
  ******************************************************************************/
 
+#include "RecentDocumentsSearchBridge.hpp"
 #include "base.hpp"
 
 #include <QDialog>
@@ -347,22 +348,18 @@ TestQmlLoad::test_search_recent_documents_loads () {
   qw->rootContext ()->setContextProperty ("closeBridge", bridge);
   qw->rootContext ()->setContextProperty ("dpScale", 1.0);
   qw->rootContext ()->setContextProperty ("isDark", false);
-  qw->rootContext ()->setContextProperty ("searchDialogTitle",
-                                          QString ("Search recent documents"));
-  qw->rootContext ()->setContextProperty ("searchPlaceholder",
-                                          QString ("Search"));
-  qw->rootContext ()->setContextProperty (
-      "searchEmptyText", QString ("No matching recent documents"));
   QVariantMap document;
   document["name"]= QString ("notes.tm");
   document["path"]= QString ("C:/docs/notes.tm");
   QVariantList documents;
   documents << document;
-  qw->rootContext ()->setContextProperty ("recentDocuments", documents);
   QStringList buttons;
   buttons << "Open"
           << "Cancel";
-  qw->rootContext ()->setContextProperty ("dialogButtons", buttons);
+  RecentDocumentsSearchBridge* searchBridge= new RecentDocumentsSearchBridge (
+      documents, QString ("Search recent documents"), QString ("Search"),
+      QString ("No matching recent documents"), buttons, qw);
+  qw->rootContext ()->setContextProperty ("recentSearchBridge", searchBridge);
   qw->setSource (QUrl ("qrc:/qml/SearchRecentDocuments.qml"));
   QCOMPARE (qw->status (), QQuickWidget::Ready);
   QCOMPARE (qw->rootObject ()->property ("selectedIndex").toInt (), -1);

From 505d1e04749526cef2c02fcdd6b55cdc97adbb71 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Mon, 3 Aug 2026 17:18:07 +0800
Subject: [PATCH 5/8] [2085] simplify recent documents search dialog

---
 devel/2085.md                                 |  1 -
 src/Plugins/Qt/QTMQmlDialog.hpp               | 11 ++++++++-
 .../Qt/RecentDocumentsSearchDialog.cpp        |  3 +--
 .../Qt/RecentDocumentsSearchDialog.hpp        | 23 -------------------
 4 files changed, 11 insertions(+), 27 deletions(-)
 delete mode 100644 src/Plugins/Qt/RecentDocumentsSearchDialog.hpp

diff --git a/devel/2085.md b/devel/2085.md
index ff7d9d21bc..bcd1896408 100644
--- a/devel/2085.md
+++ b/devel/2085.md
@@ -6,7 +6,6 @@
 ## 任务相关的代码文件
 - `TeXmacs/progs/doc/docgrep.scm`
 - `TeXmacs/progs/texmacs/menus/edit-menu.scm`
-- `src/Plugins/Qt/RecentDocumentsSearchDialog.hpp`
 - `src/Plugins/Qt/RecentDocumentsSearchDialog.cpp`
 - `src/Plugins/Qt/RecentDocumentsSearchBridge.hpp`
 - `src/Plugins/Qt/RecentDocumentsSearchBridge.cpp`
diff --git a/src/Plugins/Qt/QTMQmlDialog.hpp b/src/Plugins/Qt/QTMQmlDialog.hpp
index 3d0ed117ef..85837dd4e9 100644
--- a/src/Plugins/Qt/QTMQmlDialog.hpp
+++ b/src/Plugins/Qt/QTMQmlDialog.hpp
@@ -91,7 +91,6 @@
 #ifndef QTM_QML_DIALOG_H
 #define QTM_QML_DIALOG_H
 
-#include "RecentDocumentsSearchDialog.hpp"
 #include "array.hpp"
 #include "string.hpp"
 #include "tree.hpp"
@@ -215,4 +214,14 @@ bool cpp_version_dialog (string title, string message);
  */
 tree cpp_preferences_dialog ();
 
+/**
+ * @brief Open the QML search dialog for recently opened documents.
+ *
+ *
+ * @return The selected document path, or an empty string after Cancel, Esc,
+ *
+ * window close, or QML loading failure.
+ */
+string cpp_search_recent_documents_dialog ();
+
 #endif // defined QTM_QML_DIALOG_H
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
index f1a74e2915..d6f0bb1e38 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
@@ -7,8 +7,7 @@
  * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
  ******************************************************************************/
 
-#include "RecentDocumentsSearchDialog.hpp"
-
+#include "QTMQmlDialog.hpp"
 #include "QTMQmlDialogBridge.hpp"
 #include "QTMQmlDialogInternal.hpp"
 #include "RecentDocumentsSearchBridge.hpp"
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp
deleted file mode 100644
index eadccdc4a6..0000000000
--- a/src/Plugins/Qt/RecentDocumentsSearchDialog.hpp
+++ /dev/null
@@ -1,23 +0,0 @@
-/******************************************************************************
- * MODULE      : RecentDocumentsSearchDialog.hpp
- * DESCRIPTION : 最近打开文档搜索 QML 对话框的入口。
- * COPYRIGHT   : (C) 2026 Mogan STEM
- *
- * This software falls under the GNU general public license version 3 or later.
- * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
- ******************************************************************************/
-
-#ifndef RECENT_DOCUMENTS_SEARCH_DIALOG_HPP
-#define RECENT_DOCUMENTS_SEARCH_DIALOG_HPP
-
-#include "string.hpp"
-
-/**
- * @brief Open the QML search dialog for recently opened documents.
- *
- * @return The selected document path, or an empty string after Cancel, Esc,
- * window close, or QML loading failure.
- */
-string cpp_search_recent_documents_dialog ();
-
-#endif // defined RECENT_DOCUMENTS_SEARCH_DIALOG_HPP

From cd2c950df8d0da42a4dd40b4ae1a36595efa66ae Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Tue, 4 Aug 2026 14:21:59 +0800
Subject: [PATCH 6/8] [2085] align recent documents search QML bridge

---
 .../Qt/RecentDocumentsSearchBridge.cpp        | 46 ++++++++++++++--
 .../Qt/RecentDocumentsSearchBridge.hpp        | 39 +++++++++++---
 .../Qt/RecentDocumentsSearchDialog.cpp        | 31 ++---------
 src/Plugins/Qt/qml/SearchRecentDocuments.qml  | 54 +++++++++++++++----
 tests/Plugins/Qt/qml_load_test.cpp            | 12 +++--
 5 files changed, 131 insertions(+), 51 deletions(-)

diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
index 772787c033..0b5c908294 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
@@ -9,9 +9,49 @@
 
 #include "RecentDocumentsSearchBridge.hpp"
 
+#include "converter.hpp"
+#include "qt_utilities.hpp"
+#include "s7_tm.hpp"
+
+#include <QDir>
+#include <QFileInfo>
+#include <QSet>
+#include <QVariantMap>
+
+RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (QObject* parent)
+    : RecentDocumentsSearchBridge (
+          recent_documents (), qt_translate ("Search recent documents"),
+          qt_translate ("Search"),
+          qt_translate ("No matching recent documents"), parent) {}
+
 RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (
     QVariantList documents, QString title, QString placeholder,
-    QString emptyText, QStringList buttonLabels, QObject* parent)
+    QString emptyText, QObject* parent)
     : QObject (parent), m_documents (documents), m_title (title),
-      m_placeholder (placeholder), m_emptyText (emptyText),
-      m_buttonLabels (buttonLabels) {}
+      m_placeholder (placeholder), m_emptyText (emptyText) {}
+
+QVariantList
+RecentDocumentsSearchBridge::recent_documents () {
+  QVariantList  documents;
+  QSet<QString> seenPaths;
+  tmscm         recentPaths= eval_scheme ("(recent-documents-for-qml)");
+  for (tmscm cur= recentPaths; !tmscm_is_null (cur); cur= tmscm_cdr (cur)) {
+    tmscm item= tmscm_car (cur);
+    if (!tmscm_is_string (item)) continue;
+
+    QString path= utf8_to_qstring (cork_to_utf8 (tmscm_to_string (item)));
+    if (path.isEmpty ()) continue;
+    QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
+#ifdef Q_OS_WIN
+    normalizedPath= normalizedPath.toCaseFolded ();
+#endif
+    if (seenPaths.contains (normalizedPath)) continue;
+    seenPaths.insert (normalizedPath);
+
+    QVariantMap document;
+    document["path"]= path;
+    document["name"]= QFileInfo (path).fileName ();
+    documents << document;
+  }
+  return documents;
+}
diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
index fc447c2de5..5d828b3824 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
@@ -7,40 +7,67 @@
  * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
  ******************************************************************************/
 
+/**
+ * @file RecentDocumentsSearchBridge.hpp
+ * @brief 最近文档搜索对话框的只读 QML 数据桥。
+ */
+
 #ifndef RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
 #define RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
 
 #include <QObject>
 #include <QString>
-#include <QStringList>
 #include <QVariantList>
 
+/**
+ * @brief 向 QML 暴露最近文档模型及已翻译文案。
+ *
+ * @details 候选列表在创建时生成并保持只读；筛选和选择状态由 QML 本地维护，
+ * 避免搜索过程修改 Scheme 的最近文档记录。
+ */
 class RecentDocumentsSearchBridge : public QObject {
   Q_OBJECT
   Q_PROPERTY (QVariantList documents READ documents CONSTANT)
   Q_PROPERTY (QString title READ title CONSTANT)
   Q_PROPERTY (QString placeholder READ placeholder CONSTANT)
   Q_PROPERTY (QString emptyText READ emptyText CONSTANT)
-  Q_PROPERTY (QStringList buttonLabels READ buttonLabels CONSTANT)
 
 public:
+  /**
+   * @brief 从 Scheme 的最近文档记录创建桥。
+   * @param parent Qt 对象所有者。
+   */
+  explicit RecentDocumentsSearchBridge (QObject* parent= nullptr);
+
+  /**
+   * @brief 使用指定模型创建桥，供 QML 加载测试注入稳定数据。
+   * @param documents 候选项，每项包含 `name` 和 `path`。
+   * @param title 已翻译的对话框标题。
+   * @param placeholder 已翻译的搜索提示。
+   * @param emptyText 已翻译的空结果提示。
+   * @param parent Qt 对象所有者。
+   */
   RecentDocumentsSearchBridge (QVariantList documents, QString title,
                                QString placeholder, QString emptyText,
-                               QStringList buttonLabels,
-                               QObject*    parent= nullptr);
+                               QObject* parent= nullptr);
 
   const QVariantList& documents () const { return m_documents; }
   const QString&      title () const { return m_title; }
   const QString&      placeholder () const { return m_placeholder; }
   const QString&      emptyText () const { return m_emptyText; }
-  const QStringList&  buttonLabels () const { return m_buttonLabels; }
 
 private:
+  /**
+   * @brief 将 Scheme 最近文档列表转换为 QML 候选模型。
+   * @return 以规范化路径去重后的 `{name, path}` 列表。
+   * @note 路径须经 Cork 到 UTF-8 转换，避免中文文件名在 QML 中乱码。
+   */
+  static QVariantList recent_documents ();
+
   QVariantList m_documents;
   QString      m_title;
   QString      m_placeholder;
   QString      m_emptyText;
-  QStringList  m_buttonLabels;
 };
 
 #endif // defined RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
index d6f0bb1e38..6097b1c969 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
@@ -13,40 +13,17 @@
 #include "RecentDocumentsSearchBridge.hpp"
 
 #include "qt_utilities.hpp"
-#include "s7_tm.hpp"
 #include "sys_utils.hpp"
 
 #include <QDialog>
-#include <QDir>
-#include <QFileInfo>
 #include <QQmlContext>
 #include <QQuickWidget>
-#include <QSet>
-#include <QVariantList>
-#include <QVariantMap>
 
 string
 cpp_search_recent_documents_dialog () {
   string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
   if (preset != "") return preset == "cancel" ? string ("") : preset;
 
-  QVariantList  recentDocuments;
-  QSet<QString> seenPaths;
-  tmscm         recentPaths= eval_scheme ("(recent-documents-for-qml)");
-  for (tmscm cur= recentPaths; !tmscm_is_null (cur); cur= tmscm_cdr (cur)) {
-    tmscm item= tmscm_car (cur);
-    if (!tmscm_is_string (item)) continue;
-    QString path= QString::fromUtf8 (as_charp (tmscm_to_string (item)));
-    if (path.isEmpty ()) continue;
-    QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
-    if (seenPaths.contains (normalizedPath)) continue;
-    seenPaths.insert (normalizedPath);
-    QVariantMap document;
-    document["path"]= path;
-    document["name"]= QFileInfo (path).fileName ();
-    recentDocuments << document;
-  }
-
   array<string>    buttons= {string ("Open"), string ("Cancel")};
   QmlDialogBridge* bridge = nullptr;
   run_qml_dialog (
@@ -54,13 +31,11 @@ cpp_search_recent_documents_dialog () {
       [&] (QQuickWidget* qw, QDialog& host) {
         bridge= inject_common_context (qw, host);
         RecentDocumentsSearchBridge* searchBridge=
-            new RecentDocumentsSearchBridge (
-                recentDocuments, qt_translate ("Search recent documents"),
-                qt_translate ("Search"),
-                qt_translate ("No matching recent documents"),
-                translate_buttons (buttons), &host);
+            new RecentDocumentsSearchBridge (&host);
         qw->rootContext ()->setContextProperty ("recentSearchBridge",
                                                 searchBridge);
+        qw->rootContext ()->setContextProperty ("dialogButtons",
+                                                translate_buttons (buttons));
       },
       520, 450);
 
diff --git a/src/Plugins/Qt/qml/SearchRecentDocuments.qml b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
index 3ed98f802e..87c449b4be 100644
--- a/src/Plugins/Qt/qml/SearchRecentDocuments.qml
+++ b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
@@ -1,3 +1,5 @@
+// Keep filtering and selection local so searching cannot change recent records.
+
 import QtQuick
 import "atoms"
 
@@ -6,14 +8,16 @@ DialogShell {
     implicitWidth: 520
     implicitHeight: 450
     implicitMargins: Theme.margin
+    onActivate: root.openSelection()
 
     property string title: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.title : "Search recent documents"
     property string placeholder: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.placeholder : "Search"
     property string emptyText: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.emptyText : "No matching recent documents"
     property var documents: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.documents : []
-    property var buttonLabels: typeof recentSearchBridge !== "undefined" ? recentSearchBridge.buttonLabels : ["Open", "Cancel"]
+    property var buttonLabels: typeof dialogButtons !== "undefined" ? dialogButtons : ["Open", "Cancel"]
     property var matches: []
     property int selectedIndex: -1
+    readonly property real resultListHeight: 230 * Theme.scaleFactor
 
     function fuzzyScore(text, query) {
         var haystack = text.toLocaleLowerCase()
@@ -39,11 +43,28 @@ DialogShell {
             if (score < 0 && query.length > 0)
                 score = fuzzyScore(document.path, query)
             if (score >= 0)
-                next.push({ "name": document.name, "path": document.path, "score": score })
+                next.push({
+                    "name": document.name,
+                    "path": document.path,
+                    "score": score,
+                    "order": i
+                })
         }
-        next.sort(function(a, b) { return a.score - b.score })
-        matches = next
-        selectedIndex = -1
+        next.sort(function(a, b) {
+            return a.score === b.score ? a.order - b.order : a.score - b.score
+        })
+        root.matches = next
+        root.selectedIndex = -1
+    }
+
+    function moveSelection(step) {
+        if (matches.length === 0)
+            return
+        if (selectedIndex < 0)
+            selectedIndex = step > 0 ? 0 : matches.length - 1
+        else
+            selectedIndex = Math.max(0, Math.min(matches.length - 1, selectedIndex + step))
+        resultList.positionViewAtIndex(selectedIndex, ListView.Contain)
     }
 
     function openSelection() {
@@ -51,8 +72,8 @@ DialogShell {
             closeBridge.submit({ "path": matches[selectedIndex].path })
     }
 
-    Component.onCompleted: updateMatches()
-    onDocumentsChanged: updateMatches()
+    Component.onCompleted: root.updateMatches()
+    onDocumentsChanged: root.updateMatches()
 
     content: Column {
         spacing: Theme.gapM
@@ -62,7 +83,7 @@ DialogShell {
             height: Theme.titleH
             text: root.title
             color: Theme.fg
-            font.pixelSize: 18 * Theme.scaleFactor
+            font.pixelSize: Theme.fontBody + Theme.padS
             font.weight: Font.Bold
             horizontalAlignment: Text.AlignHCenter
             verticalAlignment: Text.AlignVCenter
@@ -102,12 +123,24 @@ DialogShell {
                 focus: true
                 onTextChanged: root.updateMatches()
                 Component.onCompleted: forceActiveFocus()
+                Keys.onPressed: function(event) {
+                    if (event.key === Qt.Key_Down) {
+                        root.moveSelection(1)
+                        event.accepted = true
+                    } else if (event.key === Qt.Key_Up) {
+                        root.moveSelection(-1)
+                        event.accepted = true
+                    } else if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter) {
+                        root.openSelection()
+                        event.accepted = true
+                    }
+                }
             }
         }
 
         Rectangle {
             width: parent.width
-            height: 230 * Theme.scaleFactor
+            height: root.resultListHeight
             radius: Theme.radius
             color: Theme.listBg
             border.width: Theme.borderW
@@ -130,7 +163,7 @@ DialogShell {
 
                     delegate: Rectangle {
                         width: resultList.width
-                        height: 48 * Theme.scaleFactor
+                        height: Theme.rowH + Theme.padS
                         radius: Theme.radius
                         color: root.selectedIndex === index ? Theme.selectBg : (resultMouse.containsMouse ? Theme.fieldBgHover : "transparent")
                         border.width: root.selectedIndex === index ? Theme.borderW : 0
@@ -183,6 +216,7 @@ DialogShell {
         DialogButtons {
             anchors.horizontalCenter: parent.horizontalCenter
             buttonLabels: root.buttonLabels
+            primaryIndex: 0
             onClicked: function(index) {
                 if (index === 0)
                     root.openSelection()
diff --git a/tests/Plugins/Qt/qml_load_test.cpp b/tests/Plugins/Qt/qml_load_test.cpp
index c4da626557..a884f55cc7 100644
--- a/tests/Plugins/Qt/qml_load_test.cpp
+++ b/tests/Plugins/Qt/qml_load_test.cpp
@@ -374,16 +374,20 @@ TestQmlLoad::test_search_recent_documents_loads () {
   document["path"]= QString ("C:/docs/notes.tm");
   QVariantList documents;
   documents << document;
-  QStringList buttons;
-  buttons << "Open"
-          << "Cancel";
   RecentDocumentsSearchBridge* searchBridge= new RecentDocumentsSearchBridge (
       documents, QString ("Search recent documents"), QString ("Search"),
-      QString ("No matching recent documents"), buttons, qw);
+      QString ("No matching recent documents"), qw);
   qw->rootContext ()->setContextProperty ("recentSearchBridge", searchBridge);
+  qw->rootContext ()->setContextProperty ("dialogButtons",
+                                          QStringList{"Open", "Cancel"});
   qw->setSource (QUrl ("qrc:/qml/SearchRecentDocuments.qml"));
   QCOMPARE (qw->status (), QQuickWidget::Ready);
   QCOMPARE (qw->rootObject ()->property ("selectedIndex").toInt (), -1);
+  const QVariantList buttonLabels=
+      qw->rootObject ()->property ("buttonLabels").toList ();
+  QCOMPARE (buttonLabels.size (), 2);
+  QCOMPARE (buttonLabels[0].toString (), QString ("Open"));
+  QCOMPARE (buttonLabels[1].toString (), QString ("Cancel"));
 }
 
 void

From adfb78d3e36aa5ad7986563615973666510699e4 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Tue, 4 Aug 2026 15:43:44 +0800
Subject: [PATCH 7/8] [2085] update recent document search notes

---
 ai-docs/qml/qml-dialog.html |  6 +++---
 devel/2085.md               | 24 ++++++++++++++++++++++--
 2 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/ai-docs/qml/qml-dialog.html b/ai-docs/qml/qml-dialog.html
index ac57b829b2..d62c619022 100644
--- a/ai-docs/qml/qml-dialog.html
+++ b/ai-docs/qml/qml-dialog.html
@@ -1694,7 +1694,7 @@ <h3>Search recent documents</h3>
         <p class="legend">
           QML: <code>recentDocuments + fuzzyScore()</code>
           <code>onTextChanged -&gt; updateMatches()</code>
-          <code>Open -&gt; closeBridge.submit({ path })</code>
+          <code>Open -&gt; recentSearchBridge.open(path)</code>
         </p>
       </section>
 
@@ -1737,7 +1737,7 @@ <h3>Search recent documents</h3>
         statistics: 'statsModel: [{label, value}, ...] + closeBridge.choose(0) 关闭',
         preferences: 'prefTabs(5) + subTabs(6) + EnumCombo + Toggle + 纯 OK 提交',
         confirmRestart: 'message + buttonLabels + closeBridge.choose(index)',
-        recentSearch: 'recentDocuments + fuzzyScore() + closeBridge.submit({ path })'
+        recentSearch: 'recentDocuments + fuzzyScore() + recentSearchBridge.open(path)'
       };
 
       const viewTitle = document.getElementById('view-title');
@@ -1809,7 +1809,7 @@ <h3>Search recent documents</h3>
       });
 
       document.getElementById('recent-open').addEventListener('click', () => {
-        if (recentSelected) log('SearchRecentDocuments: submit({ path: "' + recentSelected.dataset.path + '" })');
+        if (recentSelected) log('SearchRecentDocuments: open("' + recentSelected.dataset.path + '")');
       });
 
       document.getElementById('form-submit').addEventListener('click', () => {
diff --git a/devel/2085.md b/devel/2085.md
index 5d46677a85..60a9465607 100644
--- a/devel/2085.md
+++ b/devel/2085.md
@@ -21,7 +21,7 @@
 ## 任务相关的代码文件
 - `TeXmacs/progs/doc/docgrep.scm`
 - `TeXmacs/progs/texmacs/menus/edit-menu.scm`
-- `src/Plugins/Qt/RecentDocumentsSearchDialog.cpp`
+- `src/Plugins/Qt/QTMQmlDialog.cpp`
 - `src/Plugins/Qt/RecentDocumentsSearchBridge.hpp`
 - `src/Plugins/Qt/RecentDocumentsSearchBridge.cpp`
 - `src/Plugins/Qt/qml/SearchRecentDocuments.qml`
@@ -38,6 +38,25 @@ xmake install stem
 
 在“编辑 -> 搜索最近打开的文档”中输入文件名的一部分，确认结果按模糊匹配显示。选中条目并点击“打开”，确认文件被加载。
 
+## 2026/08/04 Bridge 收敛与路径编码
+
+### What
+- 删除冗余的 `RecentDocumentsSearchDialog.cpp`，将对话框 glue 入口收回
+  `QTMQmlDialog.cpp`。
+- 将最近文档 bridge 收敛为独立 `QObject`：它提供只读模型并完成确认回流；通用
+  `QmlDialogBridge` 只处理取消、Esc 与窗口拖动。
+- 最近文档读取和返回均使用 UTF-8 系统路径，保留中文文件名。
+
+### Why
+专属业务动作不应继承通用 form bridge；同时 `system->url` 只接受 UTF-8 系统路径，
+将路径转换为 Cork 会导致中文路径在回传后无法打开。
+
+### How
+- `url->system` 的 Scheme 返回值经 `QString::fromUtf8` 进入 QML；QML 确认后通过
+  `from_qstring_utf8` 回传给 `system->url`。
+- QML 继续使用 `DialogShell`、`Theme` 和独立的 `recentSearchBridge`，不在筛选中
+  修改最近记录。
+
 ## 2026/08/03 采用 QML 重构最近文档搜索
 
 ### What
@@ -56,4 +75,5 @@ xmake install stem
 - C++ 以规范化路径去重，保留最近记录中的第一次出现。
 - QML 按文件名优先、完整路径兜底执行子序列模糊匹配；只有显式选中并点击“打开”才加载选定文件。
 - 最近文档搜索的路径和模型逻辑独立于 QML 通用对话框底座，复用其内部模态引擎和 context 注入接口。
-- 专属 bridge 向 QML 暴露候选模型和已翻译文案；通用 `QmlDialogBridge` 负责提交路径与取消。
+- 专属 bridge 向 QML 暴露候选模型和已翻译文案，并在确认时回传所选路径；通用
+  `QmlDialogBridge` 仅负责取消、Esc 和窗口关闭。

From 510ba3a39ad2f0d769e8f9b21201b5c876379e91 Mon Sep 17 00:00:00 2001
From: pigmagicfly <2831850183@qq.com>
Date: Tue, 4 Aug 2026 15:43:52 +0800
Subject: [PATCH 8/8] [2085] fix recent document search paths

---
 src/Plugins/Qt/QTMQmlDialog.cpp               | 31 ++++++++++-
 src/Plugins/Qt/QTMQmlDialog.hpp               |  7 +--
 .../Qt/RecentDocumentsSearchBridge.cpp        | 31 ++++++-----
 .../Qt/RecentDocumentsSearchBridge.hpp        | 52 ++++++++++---------
 .../Qt/RecentDocumentsSearchDialog.cpp        | 46 ----------------
 src/Plugins/Qt/qml/SearchRecentDocuments.qml  |  4 +-
 tests/Plugins/Qt/qml_dialog_test.cpp          |  6 +--
 tests/Plugins/Qt/qml_load_test.cpp            | 29 +++++++++--
 8 files changed, 107 insertions(+), 99 deletions(-)
 delete mode 100644 src/Plugins/Qt/RecentDocumentsSearchDialog.cpp

diff --git a/src/Plugins/Qt/QTMQmlDialog.cpp b/src/Plugins/Qt/QTMQmlDialog.cpp
index 894a34ac05..f46f039ad4 100644
--- a/src/Plugins/Qt/QTMQmlDialog.cpp
+++ b/src/Plugins/Qt/QTMQmlDialog.cpp
@@ -13,6 +13,7 @@
 #include "PreferencesBridge.hpp"
 #include "QTMQmlDialogBridge.hpp"
 #include "QTMQmlDialogInternal.hpp"
+#include "RecentDocumentsSearchBridge.hpp"
 #include "VersionDialogBridge.hpp"
 
 #include "analyze.hpp"   // occurs
@@ -598,8 +599,36 @@ cpp_version_dialog (string title, string message) {
   return choice == 1;
 }
 
+string
+cpp_search_recent_documents_dialog () {
+  string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
+  if (preset != "") return preset == "cancel" ? string ("") : preset;
+
+  array<string>                buttons= {string ("Open"), string ("Cancel")};
+  QmlDialogBridge*             closeBridge = nullptr;
+  RecentDocumentsSearchBridge* searchBridge= nullptr;
+  run_qml_dialog (
+      "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
+      [&] (QQuickWidget* qw, QDialog& host) {
+        closeBridge = inject_common_context (qw, host);
+        searchBridge= new RecentDocumentsSearchBridge (&host);
+        qw->rootContext ()->setContextProperty ("recentSearchBridge",
+                                                searchBridge);
+        qw->rootContext ()->setContextProperty ("dialogButtons",
+                                                translate_buttons (buttons));
+      },
+      520, 450);
+
+  QString path;
+  if (searchBridge) path= searchBridge->selectedPath ();
+  delete closeBridge;
+  delete searchBridge;
+  return from_qstring_utf8 (path);
+}
+
 /**
- * @brief 首选项 QML 对话框的 glue 入口（声明/语义见 QTMQmlDialog.hpp）。
+ * @brief 首选项 QML 对话框的 glue 入口（声明/语义见
+ * QTMQmlDialog.hpp）。
  *
  * @details 走 run_qml_dialog（exec 阻塞模态，同
  * FormDialog——首选项是一次性提交， 无需 live
diff --git a/src/Plugins/Qt/QTMQmlDialog.hpp b/src/Plugins/Qt/QTMQmlDialog.hpp
index 85837dd4e9..f0d4ced372 100644
--- a/src/Plugins/Qt/QTMQmlDialog.hpp
+++ b/src/Plugins/Qt/QTMQmlDialog.hpp
@@ -215,12 +215,7 @@ bool cpp_version_dialog (string title, string message);
 tree cpp_preferences_dialog ();
 
 /**
- * @brief Open the QML search dialog for recently opened documents.
- *
- *
- * @return The selected document path, or an empty string after Cancel, Esc,
- *
- * window close, or QML loading failure.
+ * @brief 打开最近文档搜索 QML 对话框。
  */
 string cpp_search_recent_documents_dialog ();
 
diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
index 0b5c908294..2d4fe50a39 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.cpp
@@ -1,6 +1,6 @@
 /******************************************************************************
  * MODULE      : RecentDocumentsSearchBridge.cpp
- * DESCRIPTION : 最近打开文档搜索的 QML 数据桥接实现。
+ * DESCRIPTION : 最近打开文档搜索 QML bridge 的数据与确认动作实现。
  * COPYRIGHT   : (C) 2026 Mogan STEM
  *
  * This software falls under the GNU general public license version 3 or later.
@@ -9,26 +9,30 @@
 
 #include "RecentDocumentsSearchBridge.hpp"
 
-#include "converter.hpp"
 #include "qt_utilities.hpp"
 #include "s7_tm.hpp"
 
+#include <QDialog>
 #include <QDir>
 #include <QFileInfo>
 #include <QSet>
 #include <QVariantMap>
 
-RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (QObject* parent)
-    : RecentDocumentsSearchBridge (
-          recent_documents (), qt_translate ("Search recent documents"),
-          qt_translate ("Search"),
-          qt_translate ("No matching recent documents"), parent) {}
+RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (QDialog* host)
+    : m_documents (recent_documents ()), m_host (host),
+      m_title (qt_translate ("Search recent documents")),
+      m_placeholder (qt_translate ("Search")),
+      m_emptyText (qt_translate ("No matching recent documents")) {
+  ASSERT (host != NULL,
+          "RecentDocumentsSearchBridge expects a valid QDialog host");
+}
 
-RecentDocumentsSearchBridge::RecentDocumentsSearchBridge (
-    QVariantList documents, QString title, QString placeholder,
-    QString emptyText, QObject* parent)
-    : QObject (parent), m_documents (documents), m_title (title),
-      m_placeholder (placeholder), m_emptyText (emptyText) {}
+void
+RecentDocumentsSearchBridge::open (const QString& path) {
+  if (path.isEmpty ()) return;
+  m_selectedPath= path;
+  m_host->done (QDialog::Accepted);
+}
 
 QVariantList
 RecentDocumentsSearchBridge::recent_documents () {
@@ -39,7 +43,8 @@ RecentDocumentsSearchBridge::recent_documents () {
     tmscm item= tmscm_car (cur);
     if (!tmscm_is_string (item)) continue;
 
-    QString path= utf8_to_qstring (cork_to_utf8 (tmscm_to_string (item)));
+    // url->system 已给出 UTF-8 系统路径；再转 Cork 会破坏非 ASCII 文件名。
+    QString path= QString::fromUtf8 (as_charp (tmscm_to_string (item)));
     if (path.isEmpty ()) continue;
     QString normalizedPath= QDir::cleanPath (QDir::fromNativeSeparators (path));
 #ifdef Q_OS_WIN
diff --git a/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
index 5d828b3824..5cc705b517 100644
--- a/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
+++ b/src/Plugins/Qt/RecentDocumentsSearchBridge.hpp
@@ -1,29 +1,36 @@
 /******************************************************************************
  * MODULE      : RecentDocumentsSearchBridge.hpp
- * DESCRIPTION : 最近打开文档搜索的 QML 数据桥接。
+ * DESCRIPTION : 最近打开文档搜索 QML 对话框的独立 bridge。
  * COPYRIGHT   : (C) 2026 Mogan STEM
  *
  * This software falls under the GNU general public license version 3 or later.
  * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
  ******************************************************************************/
 
-/**
- * @file RecentDocumentsSearchBridge.hpp
- * @brief 最近文档搜索对话框的只读 QML 数据桥。
+/*! @file RecentDocumentsSearchBridge.hpp
+ *  @brief 最近文档搜索 QML 对话框的 C++↔QML bridge。
+ *
+ * @par 设计
+ * - @b 只读数据：构造时读取 Scheme 最近文档并去重。
+ *   路径转为 UTF-8；QML 只读候选模型和翻译文案。
+ *   筛选和选择状态始终留在 QML 本地。
+ * - @b 确认回流：open() 保存用户显式选择的路径并结束模态。
+ *   closeBridge 处理取消、Esc 与窗口拖动。
+ *
+ * @note bridge 不挂 QObject parent，调用方在 exec 返回后删除。
+ *       宿主 QDialog 只在 open() 期间借用。
  */
 
 #ifndef RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
 #define RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
 
+#include <QDialog>
 #include <QObject>
 #include <QString>
 #include <QVariantList>
 
 /**
- * @brief 向 QML 暴露最近文档模型及已翻译文案。
- *
- * @details 候选列表在创建时生成并保持只读；筛选和选择状态由 QML 本地维护，
- * 避免搜索过程修改 Scheme 的最近文档记录。
+ * @brief 向 QML 暴露最近文档模型和确认动作。
  */
 class RecentDocumentsSearchBridge : public QObject {
   Q_OBJECT
@@ -34,40 +41,37 @@ class RecentDocumentsSearchBridge : public QObject {
 
 public:
   /**
-   * @brief 从 Scheme 的最近文档记录创建桥。
-   * @param parent Qt 对象所有者。
-   */
-  explicit RecentDocumentsSearchBridge (QObject* parent= nullptr);
-
-  /**
-   * @brief 使用指定模型创建桥，供 QML 加载测试注入稳定数据。
-   * @param documents 候选项，每项包含 `name` 和 `path`。
-   * @param title 已翻译的对话框标题。
-   * @param placeholder 已翻译的搜索提示。
-   * @param emptyText 已翻译的空结果提示。
-   * @param parent Qt 对象所有者。
+   * @brief 从 Scheme 的最近文档记录创建 bridge。
+   * @param host 宿主 QDialog；open() 调其 done(Accepted)，不接管其生命期。
    */
-  RecentDocumentsSearchBridge (QVariantList documents, QString title,
-                               QString placeholder, QString emptyText,
-                               QObject* parent= nullptr);
+  explicit RecentDocumentsSearchBridge (QDialog* host);
 
   const QVariantList& documents () const { return m_documents; }
   const QString&      title () const { return m_title; }
   const QString&      placeholder () const { return m_placeholder; }
   const QString&      emptyText () const { return m_emptyText; }
+  QString             selectedPath () const { return m_selectedPath; }
+
+  /**
+   * @brief 记录用户显式选中的路径并结束对话框。
+   * @param path QML 当前选中候选项的原始路径。
+   */
+  Q_INVOKABLE void open (const QString& path);
 
 private:
   /**
    * @brief 将 Scheme 最近文档列表转换为 QML 候选模型。
    * @return 以规范化路径去重后的 `{name, path}` 列表。
-   * @note 路径须经 Cork 到 UTF-8 转换，避免中文文件名在 QML 中乱码。
+   * @note url->system 已返回 UTF-8 系统路径，不能再转为 Cork。
    */
   static QVariantList recent_documents ();
 
   QVariantList m_documents;
+  QDialog*     m_host;
   QString      m_title;
   QString      m_placeholder;
   QString      m_emptyText;
+  QString      m_selectedPath;
 };
 
 #endif // defined RECENT_DOCUMENTS_SEARCH_BRIDGE_HPP
diff --git a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp b/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
deleted file mode 100644
index 6097b1c969..0000000000
--- a/src/Plugins/Qt/RecentDocumentsSearchDialog.cpp
+++ /dev/null
@@ -1,46 +0,0 @@
-/******************************************************************************
- * MODULE      : RecentDocumentsSearchDialog.cpp
- * DESCRIPTION : 最近打开文档搜索 QML 对话框的实现。
- * COPYRIGHT   : (C) 2026 Mogan STEM
- *
- * This software falls under the GNU general public license version 3 or later.
- * It comes WITHOUT ANY WARRANTY whatsoever. Details see LICENSE.
- ******************************************************************************/
-
-#include "QTMQmlDialog.hpp"
-#include "QTMQmlDialogBridge.hpp"
-#include "QTMQmlDialogInternal.hpp"
-#include "RecentDocumentsSearchBridge.hpp"
-
-#include "qt_utilities.hpp"
-#include "sys_utils.hpp"
-
-#include <QDialog>
-#include <QQmlContext>
-#include <QQuickWidget>
-
-string
-cpp_search_recent_documents_dialog () {
-  string preset= get_env ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS");
-  if (preset != "") return preset == "cancel" ? string ("") : preset;
-
-  array<string>    buttons= {string ("Open"), string ("Cancel")};
-  QmlDialogBridge* bridge = nullptr;
-  run_qml_dialog (
-      "qrc:/qml/SearchRecentDocuments.qml", "SearchRecentDocuments.qml",
-      [&] (QQuickWidget* qw, QDialog& host) {
-        bridge= inject_common_context (qw, host);
-        RecentDocumentsSearchBridge* searchBridge=
-            new RecentDocumentsSearchBridge (&host);
-        qw->rootContext ()->setContextProperty ("recentSearchBridge",
-                                                searchBridge);
-        qw->rootContext ()->setContextProperty ("dialogButtons",
-                                                translate_buttons (buttons));
-      },
-      520, 450);
-
-  QString path;
-  if (bridge) path= bridge->results ().value ("path").toString ();
-  delete bridge;
-  return from_qstring (path);
-}
diff --git a/src/Plugins/Qt/qml/SearchRecentDocuments.qml b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
index 87c449b4be..21e530e1ae 100644
--- a/src/Plugins/Qt/qml/SearchRecentDocuments.qml
+++ b/src/Plugins/Qt/qml/SearchRecentDocuments.qml
@@ -1,4 +1,4 @@
-// Keep filtering and selection local so searching cannot change recent records.
+// 筛选和选择留在 QML 本地，避免搜索过程改写 Scheme 的最近记录。
 
 import QtQuick
 import "atoms"
@@ -69,7 +69,7 @@ DialogShell {
 
     function openSelection() {
         if (selectedIndex >= 0 && selectedIndex < matches.length)
-            closeBridge.submit({ "path": matches[selectedIndex].path })
+            recentSearchBridge.open(matches[selectedIndex].path)
     }
 
     Component.onCompleted: root.updateMatches()
diff --git a/tests/Plugins/Qt/qml_dialog_test.cpp b/tests/Plugins/Qt/qml_dialog_test.cpp
index e7cc8bb853..d91137dc99 100644
--- a/tests/Plugins/Qt/qml_dialog_test.cpp
+++ b/tests/Plugins/Qt/qml_dialog_test.cpp
@@ -249,9 +249,9 @@ TestQmlDialog::test_form_dialog_hook () {
 void
 TestQmlDialog::test_search_recent_documents_hook () {
   {
-    EnvHook hook ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS", "C:/docs/needle.tm");
-    QCOMPARE (cpp_search_recent_documents_dialog (),
-              string ("C:/docs/needle.tm"));
+    string  path= "C:/文档/报告.tm";
+    EnvHook hook ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS", path);
+    QCOMPARE (cpp_search_recent_documents_dialog (), path);
   }
   {
     EnvHook hook ("MOGAN_TEST_SEARCH_RECENT_DOCUMENTS", "cancel");
diff --git a/tests/Plugins/Qt/qml_load_test.cpp b/tests/Plugins/Qt/qml_load_test.cpp
index a884f55cc7..e4e9daecc3 100644
--- a/tests/Plugins/Qt/qml_load_test.cpp
+++ b/tests/Plugins/Qt/qml_load_test.cpp
@@ -13,7 +13,6 @@
  * It comes with NO WARRANTY whatsoever. Details see LICENSE.
  ******************************************************************************/
 
-#include "RecentDocumentsSearchBridge.hpp"
 #include "base.hpp"
 
 #include <QDialog>
@@ -39,6 +38,29 @@ class StubBridge : public QObject {
   Q_INVOKABLE void startMove () {}
 };
 
+class RecentDocumentsSearchStubBridge : public QObject {
+  Q_OBJECT
+  Q_PROPERTY (QVariantList documents READ documents CONSTANT)
+  Q_PROPERTY (QString title READ title CONSTANT)
+  Q_PROPERTY (QString placeholder READ placeholder CONSTANT)
+  Q_PROPERTY (QString emptyText READ emptyText CONSTANT)
+
+public:
+  explicit RecentDocumentsSearchStubBridge (QVariantList documents,
+                                            QObject*     parent= nullptr)
+      : QObject (parent), m_documents (documents) {}
+
+  QVariantList documents () const { return m_documents; }
+  QString      title () const { return "Search recent documents"; }
+  QString      placeholder () const { return "Search"; }
+  QString      emptyText () const { return "No matching recent documents"; }
+
+  Q_INVOKABLE void open (const QString&) {}
+
+private:
+  QVariantList m_documents;
+};
+
 class VersionStubBridge : public QObject {
   Q_OBJECT
   Q_PROPERTY (QString title READ title CONSTANT)
@@ -374,9 +396,8 @@ TestQmlLoad::test_search_recent_documents_loads () {
   document["path"]= QString ("C:/docs/notes.tm");
   QVariantList documents;
   documents << document;
-  RecentDocumentsSearchBridge* searchBridge= new RecentDocumentsSearchBridge (
-      documents, QString ("Search recent documents"), QString ("Search"),
-      QString ("No matching recent documents"), qw);
+  RecentDocumentsSearchStubBridge* searchBridge=
+      new RecentDocumentsSearchStubBridge (documents, qw);
   qw->rootContext ()->setContextProperty ("recentSearchBridge", searchBridge);
   qw->rootContext ()->setContextProperty ("dialogButtons",
                                           QStringList{"Open", "Cancel"});