An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
:sparkles: Support clearing recent document history https://github.com/siyuan-note/siyuan/issues/20785
Daniel0a64d2f845ef
diff --git a/app/appearance/langs/ar.json b/app/appearance/langs/ar.jsonindex e073d52574..4d2cd44ae7 100644--- a/app/appearance/langs/ar.json+++ b/app/appearance/langs/ar.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "مسح سجل المستندات الأخيرة",+ "confirmClearRecentDocs": "هل تريد مسح جميع سجلات تصفح المستندات وفتحها وإغلاقها؟ ستبقى المستندات، وسيستمر تسجيل النشاط الجديد.","bazaarInstalling": "جارٍ التثبيت...","collapseSyncDetails": "إخفاء التفاصيل","agentInstructionsLocationConflict": "يختلف محتوى data/ai/AGENTS.md عن data/storage/ai/AGENTS.md؛ ادمج المحتوى في الملف الجديد ثم احذف الملف القديم",diff --git a/app/appearance/langs/de.json b/app/appearance/langs/de.jsonindex a989264e26..7145506b33 100644--- a/app/appearance/langs/de.json+++ b/app/appearance/langs/de.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Verlauf zuletzt verwendeter Dokumente leeren",+ "confirmClearRecentDocs": "Alle Einträge zum Anzeigen, Öffnen und Schließen von Dokumenten löschen? Die Dokumente bleiben erhalten und neue Aktivitäten werden weiterhin aufgezeichnet.","bazaarInstalling": "Wird installiert...","collapseSyncDetails": "Details ausblenden","agentInstructionsLocationConflict": "data/ai/AGENTS.md und data/storage/ai/AGENTS.md unterscheiden sich; führen Sie die Inhalte in der neuen Datei zusammen und entfernen Sie dann die alte Datei",diff --git a/app/appearance/langs/en.json b/app/appearance/langs/en.jsonindex c462c39ebe..014706e792 100644--- a/app/appearance/langs/en.json+++ b/app/appearance/langs/en.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Clear recent document history",+ "confirmClearRecentDocs": "Clear all document browsing, opening and closing records? Documents are kept and new activity will still be recorded.","bazaarInstalling": "Installing...","collapseSyncDetails": "Hide details","agentInstructionsLocationConflict": "data/ai/AGENTS.md and data/storage/ai/AGENTS.md differ; merge their contents into the new file, then remove the old file",diff --git a/app/appearance/langs/es.json b/app/appearance/langs/es.jsonindex ea4206aaa4..3fa837731a 100644--- a/app/appearance/langs/es.json+++ b/app/appearance/langs/es.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Borrar el historial de documentos recientes",+ "confirmClearRecentDocs": "¿Borrar todos los registros de consulta, apertura y cierre de documentos? Los documentos se conservarán y se seguirá registrando la nueva actividad.","bazaarInstalling": "Instalando...","collapseSyncDetails": "Ocultar detalles","agentInstructionsLocationConflict": "data/ai/AGENTS.md y data/storage/ai/AGENTS.md difieren; combine su contenido en el archivo nuevo y luego elimine el antiguo",diff --git a/app/appearance/langs/fr.json b/app/appearance/langs/fr.jsonindex 485e6f9ec5..5d4c5a0fcc 100644--- a/app/appearance/langs/fr.json+++ b/app/appearance/langs/fr.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Effacer l’historique des documents récents",+ "confirmClearRecentDocs": "Effacer tous les enregistrements de consultation, d’ouverture et de fermeture de documents ? Les documents seront conservés et les nouvelles activités continueront d’être enregistrées.","bazaarInstalling": "Installation en cours...","collapseSyncDetails": "Masquer les détails","agentInstructionsLocationConflict": "data/ai/AGENTS.md et data/storage/ai/AGENTS.md diffèrent ; fusionnez leur contenu dans le nouveau fichier, puis supprimez l’ancien fichier",diff --git a/app/appearance/langs/he.json b/app/appearance/langs/he.jsonindex 8bf6515e57..a5967f5a18 100644--- a/app/appearance/langs/he.json+++ b/app/appearance/langs/he.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "ניקוי היסטוריית המסמכים האחרונים",+ "confirmClearRecentDocs": "לנקות את כל רשומות העיון, הפתיחה והסגירה של מסמכים? המסמכים יישמרו ופעילות חדשה תמשיך להירשם.","bazaarInstalling": "מתקין...","collapseSyncDetails": "הסתר פרטים","agentInstructionsLocationConflict": "התוכן של data/ai/AGENTS.md ושל data/storage/ai/AGENTS.md שונה; יש למזג את התוכן בקובץ החדש ואז להסיר את הקובץ הישן",diff --git a/app/appearance/langs/hi.json b/app/appearance/langs/hi.jsonindex 5ad14b624c..58df6e86cf 100644--- a/app/appearance/langs/hi.json+++ b/app/appearance/langs/hi.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "हाल के दस्तावेज़ों का इतिहास साफ़ करें",+ "confirmClearRecentDocs": "दस्तावेज़ देखने, खोलने और बंद करने के सभी रिकॉर्ड साफ़ करें? दस्तावेज़ सुरक्षित रहेंगे और नई गतिविधि रिकॉर्ड होती रहेगी।","bazaarInstalling": "इंस्टॉल हो रहा है...","collapseSyncDetails": "विवरण छिपाएँ","agentInstructionsLocationConflict": "data/ai/AGENTS.md और data/storage/ai/AGENTS.md की सामग्री अलग है; सामग्री को नई फ़ाइल में मिलाएँ, फिर पुरानी फ़ाइल हटाएँ",diff --git a/app/appearance/langs/id.json b/app/appearance/langs/id.jsonindex 2d0386b40e..4413b66a82 100644--- a/app/appearance/langs/id.json+++ b/app/appearance/langs/id.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Hapus riwayat dokumen terbaru",+ "confirmClearRecentDocs": "Hapus semua catatan penelusuran, pembukaan, dan penutupan dokumen? Dokumen tetap disimpan dan aktivitas baru akan tetap dicatat.","bazaarInstalling": "Sedang memasang...","collapseSyncDetails": "Sembunyikan detail","agentInstructionsLocationConflict": "Isi data/ai/AGENTS.md dan data/storage/ai/AGENTS.md berbeda; gabungkan isinya ke berkas baru, lalu hapus berkas lama",diff --git a/app/appearance/langs/it.json b/app/appearance/langs/it.jsonindex cc890ce8e0..3a1079f862 100644--- a/app/appearance/langs/it.json+++ b/app/appearance/langs/it.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Cancella la cronologia dei documenti recenti",+ "confirmClearRecentDocs": "Cancellare tutti i dati relativi alla consultazione, apertura e chiusura dei documenti? I documenti saranno conservati e le nuove attività continueranno a essere registrate.","bazaarInstalling": "Installazione in corso...","collapseSyncDetails": "Nascondi dettagli","agentInstructionsLocationConflict": "data/ai/AGENTS.md e data/storage/ai/AGENTS.md sono diversi; unisci i contenuti nel nuovo file, quindi rimuovi quello precedente",diff --git a/app/appearance/langs/ja.json b/app/appearance/langs/ja.jsonindex 1d70b5bf29..ac65fc2657 100644--- a/app/appearance/langs/ja.json+++ b/app/appearance/langs/ja.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "最近のドキュメント履歴を消去",+ "confirmClearRecentDocs": "ドキュメントの閲覧、開いた履歴、閉じた履歴をすべて消去しますか?ドキュメントは保持され、今後の操作は引き続き記録されます。","bazaarInstalling": "インストール中...","collapseSyncDetails": "詳細を閉じる","agentInstructionsLocationConflict": "data/ai/AGENTS.md と data/storage/ai/AGENTS.md の内容が異なります。内容を新しいファイルに統合してから古いファイルを削除してください",diff --git a/app/appearance/langs/ko.json b/app/appearance/langs/ko.jsonindex 45d23bb8cc..19257fd3aa 100644--- a/app/appearance/langs/ko.json+++ b/app/appearance/langs/ko.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "최근 문서 기록 지우기",+ "confirmClearRecentDocs": "문서를 열람하고 열고 닫은 기록을 모두 지우시겠습니까? 문서는 유지되며 새로운 활동은 계속 기록됩니다.","bazaarInstalling": "설치 중...","collapseSyncDetails": "세부 정보 접기","agentInstructionsLocationConflict": "data/ai/AGENTS.md와 data/storage/ai/AGENTS.md의 내용이 다릅니다. 새 파일에 내용을 병합한 후 이전 파일을 삭제하세요",diff --git a/app/appearance/langs/nl.json b/app/appearance/langs/nl.jsonindex afc72b8a13..8f6637d24e 100644--- a/app/appearance/langs/nl.json+++ b/app/appearance/langs/nl.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Geschiedenis van recente documenten wissen",+ "confirmClearRecentDocs": "Alle gegevens over het bekijken, openen en sluiten van documenten wissen? Documenten blijven behouden en nieuwe activiteiten worden nog steeds vastgelegd.","bazaarInstalling": "Installeren...","collapseSyncDetails": "Details verbergen","agentInstructionsLocationConflict": "data/ai/AGENTS.md en data/storage/ai/AGENTS.md verschillen; voeg de inhoud samen in het nieuwe bestand en verwijder daarna het oude bestand",diff --git a/app/appearance/langs/pl.json b/app/appearance/langs/pl.jsonindex dc004d99e9..13a392adbc 100644--- a/app/appearance/langs/pl.json+++ b/app/appearance/langs/pl.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Wyczyść historię ostatnich dokumentów",+ "confirmClearRecentDocs": "Wyczyścić wszystkie wpisy dotyczące przeglądania, otwierania i zamykania dokumentów? Dokumenty zostaną zachowane, a nowe działania będą nadal rejestrowane.","bazaarInstalling": "Instalowanie...","collapseSyncDetails": "Ukryj szczegóły","agentInstructionsLocationConflict": "Pliki data/ai/AGENTS.md i data/storage/ai/AGENTS.md różnią się; scal ich zawartość w nowym pliku, a następnie usuń stary plik",diff --git a/app/appearance/langs/pt-BR.json b/app/appearance/langs/pt-BR.jsonindex bf2507dc47..957d032ab0 100644--- a/app/appearance/langs/pt-BR.json+++ b/app/appearance/langs/pt-BR.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Limpar histórico de documentos recentes",+ "confirmClearRecentDocs": "Limpar todos os registros de consulta, abertura e fechamento de documentos? Os documentos serão mantidos e novas atividades continuarão sendo registradas.","bazaarInstalling": "Instalando...","collapseSyncDetails": "Ocultar detalhes","agentInstructionsLocationConflict": "data/ai/AGENTS.md e data/storage/ai/AGENTS.md são diferentes; mescle o conteúdo no novo arquivo e remova o antigo",diff --git a/app/appearance/langs/ru.json b/app/appearance/langs/ru.jsonindex 19b0c7678a..0a8c79f227 100644--- a/app/appearance/langs/ru.json+++ b/app/appearance/langs/ru.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Очистить историю недавних документов",+ "confirmClearRecentDocs": "Очистить все записи о просмотре, открытии и закрытии документов? Документы сохранятся, а новые действия будут по-прежнему записываться.","bazaarInstalling": "Установка...","collapseSyncDetails": "Скрыть подробности","agentInstructionsLocationConflict": "Содержимое data/ai/AGENTS.md и data/storage/ai/AGENTS.md различается; объедините его в новом файле, затем удалите старый файл",diff --git a/app/appearance/langs/sk.json b/app/appearance/langs/sk.jsonindex e36948d8b0..fb358d5f28 100644--- a/app/appearance/langs/sk.json+++ b/app/appearance/langs/sk.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Vymazať históriu nedávnych dokumentov",+ "confirmClearRecentDocs": "Vymazať všetky záznamy o prezeraní, otváraní a zatváraní dokumentov? Dokumenty zostanú zachované a nové činnosti sa budú naďalej zaznamenávať.","bazaarInstalling": "Inštaluje sa...","collapseSyncDetails": "Skryť podrobnosti","agentInstructionsLocationConflict": "Súbory data/ai/AGENTS.md a data/storage/ai/AGENTS.md sa líšia; zlúčte ich obsah do nového súboru a potom odstráňte starý súbor",diff --git a/app/appearance/langs/sr.json b/app/appearance/langs/sr.jsonindex ed8b000259..8a06e175d4 100644--- a/app/appearance/langs/sr.json+++ b/app/appearance/langs/sr.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Обриши историју недавних докумената",+ "confirmClearRecentDocs": "Обрисати све записе о прегледању, отварању и затварању докумената? Документи ће бити сачувани, а нове активности ће се и даље бележити.","bazaarInstalling": "Инсталирање...","collapseSyncDetails": "Сакриј детаље","agentInstructionsLocationConflict": "Садржаји датотека data/ai/AGENTS.md и data/storage/ai/AGENTS.md се разликују; обједините их у новој датотеци, па уклоните стару датотеку",diff --git a/app/appearance/langs/th.json b/app/appearance/langs/th.jsonindex e50742cd7f..c6893ce0e4 100644--- a/app/appearance/langs/th.json+++ b/app/appearance/langs/th.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "ล้างประวัติเอกสารล่าสุด",+ "confirmClearRecentDocs": "ล้างบันทึกการดู เปิด และปิดเอกสารทั้งหมดหรือไม่? เอกสารจะยังคงอยู่และจะยังคงบันทึกกิจกรรมใหม่ต่อไป","bazaarInstalling": "กำลังติดตั้ง...","collapseSyncDetails": "ซ่อนรายละเอียด","agentInstructionsLocationConflict": "เนื้อหาใน data/ai/AGENTS.md และ data/storage/ai/AGENTS.md ต่างกัน โปรดรวมเนื้อหาไว้ในไฟล์ใหม่แล้วลบไฟล์เดิม",diff --git a/app/appearance/langs/tr.json b/app/appearance/langs/tr.jsonindex 133f0a269d..2e94411ed7 100644--- a/app/appearance/langs/tr.json+++ b/app/appearance/langs/tr.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Son belge geçmişini temizle",+ "confirmClearRecentDocs": "Belgeleri görüntüleme, açma ve kapatmayla ilgili tüm kayıtlar temizlensin mi? Belgeler korunur ve yeni etkinlikler kaydedilmeye devam eder.","bazaarInstalling": "Yükleniyor...","collapseSyncDetails": "Ayrıntıları gizle","agentInstructionsLocationConflict": "data/ai/AGENTS.md ve data/storage/ai/AGENTS.md farklı; içeriklerini yeni dosyada birleştirin, ardından eski dosyayı kaldırın",diff --git a/app/appearance/langs/uk.json b/app/appearance/langs/uk.jsonindex 8062833153..e5f9071808 100644--- a/app/appearance/langs/uk.json+++ b/app/appearance/langs/uk.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "Очистити історію нещодавніх документів",+ "confirmClearRecentDocs": "Очистити всі записи про перегляд, відкриття та закриття документів? Документи залишаться, а нові дії й надалі записуватимуться.","bazaarInstalling": "Встановлення...","collapseSyncDetails": "Приховати подробиці","agentInstructionsLocationConflict": "Вміст data/ai/AGENTS.md і data/storage/ai/AGENTS.md відрізняється; об’єднайте його в новому файлі, а потім видаліть старий файл",diff --git a/app/appearance/langs/zh-CN.json b/app/appearance/langs/zh-CN.jsonindex 812ffe14fc..b27a9148c9 100644--- a/app/appearance/langs/zh-CN.json+++ b/app/appearance/langs/zh-CN.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "清空最近文档记录",+ "confirmClearRecentDocs": "确定清空所有文档浏览、打开和关闭记录?文档将保留,后续操作仍会产生新记录。","bazaarInstalling": "正在安装...","collapseSyncDetails": "收起详情","agentInstructionsLocationConflict": "data/ai/AGENTS.md 与 data/storage/ai/AGENTS.md 内容不同,请将内容合并到新文件后移除旧文件",@@ -1441,8 +1443,8 @@"clearTempFiles": "清理临时文件","clearTempFilesTip": "清理应用运行过程中产生的临时文件以释放存储空间","uploadFileTooLarge": "⚠️ 上传的文件 [${x}] 很大 [${y}],请确认是否继续上传?",- "recentDocsMaxListCount": "最近的文档最大数量",- "recentDocsMaxListCountTip": "最近的文档对话框中列出文档的最大数量",+ "recentDocsMaxListCount": "最近文档最大数量",+ "recentDocsMaxListCountTip": "最近文档对话框中列出文档的最大数量","bazaarNeedVersion": "需升级到思源笔记 v${x} 或更高版本才能使用","downloadRollback": "下载并回滚","callout": "提示块",@@ -2005,7 +2007,7 @@"riffCard": "闪卡","compare": "比较","switchTab": "页签切换",- "recentDocs": "最近的文档",+ "recentDocs": "最近文档","autoLaunch": "开机自动启动","autoLaunchTip": "启用后会在登录操作系统后自动启动应用","sortByContent": "按原文内容顺序",diff --git a/app/appearance/langs/zh-TW.json b/app/appearance/langs/zh-TW.jsonindex 2e878faf1d..7602113b44 100644--- a/app/appearance/langs/zh-TW.json+++ b/app/appearance/langs/zh-TW.json@@ -1,4 +1,6 @@{+ "clearRecentDocs": "清空最近文件記錄",+ "confirmClearRecentDocs": "確定清空所有文件瀏覽、開啟和關閉記錄?文件將保留,後續操作仍會產生新記錄。","bazaarInstalling": "正在安裝...","collapseSyncDetails": "收起詳細資訊","agentInstructionsLocationConflict": "data/ai/AGENTS.md 與 data/storage/ai/AGENTS.md 內容不同,請將內容合併至新檔案後移除舊檔案",diff --git a/app/guide/20210808180117-6v0mkxr/20200923234011-ieuun1p/20210808180303-xaduj2o/20200924100906-0u4zfq3.sy b/app/guide/20210808180117-6v0mkxr/20200923234011-ieuun1p/20210808180303-xaduj2o/20200924100906-0u4zfq3.syindex c6e0d1a106..3af1c88980 100644--- a/app/guide/20210808180117-6v0mkxr/20200923234011-ieuun1p/20210808180303-xaduj2o/20200924100906-0u4zfq3.sy+++ b/app/guide/20210808180117-6v0mkxr/20200923234011-ieuun1p/20210808180303-xaduj2o/20200924100906-0u4zfq3.sy@@ -6,7 +6,7 @@"id": "20200924100906-0u4zfq3","title": "Window and Tab","type": "doc",- "updated": "20261016111305"+ "updated": "20261021161724"},"Children": [{@@ -1263,6 +1263,20 @@}]},+ {+ "ID": "20261021161724-4je25jy",+ "Type": "NodeParagraph",+ "Properties": {+ "id": "20261021161724-4je25jy",+ "updated": "20261021161724"+ },+ "Children": [+ {+ "Type": "NodeText",+ "Data": "In the desktop and mobile recent documents list, select recently viewed, opened, or closed documents and click the trash button at the top to clear all three types of records after confirmation. This clears only the local records in the current workspace; documents, recent creation and modification lists, and tab navigation history are kept. New browsing, opening, or closing activity will be recorded again, including closing a tab that was already open."+ }+ ]+ },{"ID": "20260930192450-5l394sc","Type": "NodeHeading",diff --git a/app/guide/20210808180117-czj9bvb/20200812220555-lj3enxa/20210808180321-hbvl5c2/20200822191536-rm6hwid.sy b/app/guide/20210808180117-czj9bvb/20200812220555-lj3enxa/20210808180321-hbvl5c2/20200822191536-rm6hwid.syindex cd24ff417a..52ad39f3bb 100644--- a/app/guide/20210808180117-czj9bvb/20200812220555-lj3enxa/20210808180321-hbvl5c2/20200822191536-rm6hwid.sy+++ b/app/guide/20210808180117-czj9bvb/20200812220555-lj3enxa/20210808180321-hbvl5c2/20200822191536-rm6hwid.sy@@ -6,7 +6,7 @@"id": "20200822191536-rm6hwid","title": "窗口和页签","type": "doc",- "updated": "20261016111305"+ "updated": "20261021161724"},"Children": [{@@ -1126,7 +1126,7 @@"Children": [{"Type": "NodeText",- "Data": "最近的文档:使用 "+ "Data": "最近文档:使用 "},{"Type": "NodeTextMark",@@ -1267,6 +1267,20 @@}]},+ {+ "ID": "20261021161724-njzetfk",+ "Type": "NodeParagraph",+ "Properties": {+ "id": "20261021161724-njzetfk",+ "updated": "20261021161724"+ },+ "Children": [+ {+ "Type": "NodeText",+ "Data": "在桌面端和移动端的最近文档列表中,选择最近浏览、最近打开或最近关闭后,点击顶部的垃圾桶按钮并确认,即可一次清空这三类记录。清空仅影响当前工作区的本地记录,不删除文档,不影响最近创建、最近修改列表及页签前进后退记录。后续浏览、打开或关闭文档会重新产生记录,包括关闭清空前已经打开的页签。"+ }+ ]+ },{"ID": "20260930192450-4myh8mr","Type": "NodeHeading",diff --git a/app/guide/20211226090932-5lcq56f/20211226115423-d5z1joq/20211226121203-rjjngpz/20211226123216-tlxw66f.sy b/app/guide/20211226090932-5lcq56f/20211226115423-d5z1joq/20211226121203-rjjngpz/20211226123216-tlxw66f.syindex a88f12ce8a..c688f52c19 100644--- a/app/guide/20211226090932-5lcq56f/20211226115423-d5z1joq/20211226121203-rjjngpz/20211226123216-tlxw66f.sy+++ b/app/guide/20211226090932-5lcq56f/20211226115423-d5z1joq/20211226121203-rjjngpz/20211226123216-tlxw66f.sy@@ -6,7 +6,7 @@"id": "20211226123216-tlxw66f","title": "視窗和分頁","type": "doc",- "updated": "20261016111305"+ "updated": "20261021161724"},"Children": [{@@ -1267,6 +1267,20 @@}]},+ {+ "ID": "20261021161724-fyxcblw",+ "Type": "NodeParagraph",+ "Properties": {+ "id": "20261021161724-fyxcblw",+ "updated": "20261021161724"+ },+ "Children": [+ {+ "Type": "NodeText",+ "Data": "在桌面端和行動端的最近文件列表中,選擇最近瀏覽、最近開啟或最近關閉後,點擊頂部的垃圾桶按鈕並確認,即可一次清空這三類記錄。清空僅影響目前工作區的本機記錄,不刪除文件,不影響最近建立、最近修改列表及分頁前進後退記錄。後續瀏覽、開啟或關閉文件會重新產生記錄,包括關閉清空前已經開啟的分頁。"+ }+ ]+ },{"ID": "20260930192450-1xrty7u","Type": "NodeHeading",diff --git a/app/guide/20240530133126-axarxgx/20240530101000-4qitucx/20240530101000-g3ugxml/20240530101000-7yv4y5z.sy b/app/guide/20240530133126-axarxgx/20240530101000-4qitucx/20240530101000-g3ugxml/20240530101000-7yv4y5z.syindex d4e5bb68f9..ebfd53fb13 100644--- a/app/guide/20240530133126-axarxgx/20240530101000-4qitucx/20240530101000-g3ugxml/20240530101000-7yv4y5z.sy+++ b/app/guide/20240530133126-axarxgx/20240530101000-4qitucx/20240530101000-g3ugxml/20240530101000-7yv4y5z.sy@@ -7,7 +7,7 @@"id": "20240530101000-7yv4y5z","title": "ウィンドウとタブ","type": "doc",- "updated": "20261016111305"+ "updated": "20261021161724"},"Children": [{@@ -1272,6 +1272,20 @@}]},+ {+ "ID": "20261021161724-g2sq8su",+ "Type": "NodeParagraph",+ "Properties": {+ "id": "20261021161724-g2sq8su",+ "updated": "20261021161724"+ },+ "Children": [+ {+ "Type": "NodeText",+ "Data": "デスクトップ版とモバイル版の最近のドキュメント一覧で、最近閲覧した、開いた、または閉じたドキュメントを選び、上部のごみ箱ボタンを押して確認すると、この3種類の履歴をまとめて消去できます。消去するのは現在のワークスペースのローカル履歴のみで、ドキュメント、最近作成・更新されたドキュメントの一覧、タブの進む・戻る履歴は保持されます。その後の閲覧、開く、閉じる操作は再び記録され、消去前から開いていたタブを閉じる場合も記録されます。"+ }+ ]+ },{"ID": "20260930192450-sbtyvdc","Type": "NodeHeading",diff --git a/app/src/business/clearRecentDocs.test.ts b/app/src/business/clearRecentDocs.test.tsnew file mode 100644index 0000000000..86dacee933--- /dev/null+++ b/app/src/business/clearRecentDocs.test.ts@@ -0,0 +1,115 @@+import * as assert from "node:assert/strict";+import {readFileSync} from "node:fs";+import {test} from "node:test";+import {runInNewContext} from "node:vm";+import {ModuleKind, ScriptTarget, transpileModule} from "typescript";+const {createMockRequire} = require("../../tests/fixtures/mockModules.cjs");++const harness = () => {+ let click: () => void;+ let sortBy = "viewedAt";+ let active = true;+ let cleared = 0;+ const hidden = new Set<string>();+ const button = {disabled: false, classList: {toggle: (name: string, value: boolean) => value ? hidden.add(name) : hidden.delete(name)},+ addEventListener: (_name: string, callback: () => void) => { click = callback; }};+ const confirmations: Array<{confirm: () => Promise<void>, cancel: () => void}> = [];+ const requests: Array<{resolve: (response: {code: number}) => void, reject: (error: Error) => void}> = [];+ const errors: string[] = [];+ const siyuan = {config: {readonly: false}, isPublish: false,+ languages: {clearRecentDocs: "Clear recent history", confirmClearRecentDocs: "Confirm clear"}};+ const exports: any = {};+ runInNewContext(transpileModule(readFileSync("src/business/clearRecentDocs.ts", "utf8"), {+ compilerOptions: {module: ModuleKind.CommonJS, target: ScriptTarget.ES2021},+ }).outputText, {exports, window: {siyuan}, require: createMockRequire({+ "../dialog/confirmDialog": {confirmDialog: (_title: string, _text: string, confirm: () => Promise<void>, cancel: () => void) =>+ confirmations.push({confirm, cancel})},+ "../dialog/message": {showMessage: (message: string) => errors.push(message)},+ "../util/fetch": {fetchSyncPost: (url: string) => {+ assert.equal(url, "/api/storage/clearRecentDocs");+ return new Promise((resolve, reject) => requests.push({resolve, reject}));+ }},+ "../util/escape": {escapeHtmlTextAndAttr: (text: string) => text},+ })});+ const update = exports.bindClearRecentDocs(button, () => sortBy, () => active, () => cleared++);+ return {button, hidden, confirmations, requests, errors, siyuan, update, click: () => click(),+ sort: (value: string) => { sortBy = value; update(); }, deactivate: () => { active = false; }, cleared: () => cleared};+};++test("clear recent history requires confirmation and prevents duplicate submissions", async () => {+ const h = harness();+ h.click();+ h.click();+ assert.equal(h.confirmations.length, 1);+ assert.equal(h.requests.length, 0);+ assert.equal(h.button.disabled, true);+ h.confirmations[0].cancel();+ assert.equal(h.button.disabled, false);+ h.click();+ const pending = h.confirmations[1].confirm();+ h.click();+ h.requests[0].resolve({code: 0});+ await pending;+ assert.equal(h.cleared(), 1);+ assert.equal(h.button.disabled, false);+});++test("failed clears retain records and allow retry", async () => {+ for (const networkFailure of [false, true]) {+ const h = harness();+ h.click();+ const pending = h.confirmations[0].confirm();+ if (networkFailure) {+ h.requests[0].reject(new Error("offline"));+ } else {+ h.requests[0].resolve({code: -1});+ }+ await pending;+ assert.equal(h.cleared(), 0);+ assert.equal(h.button.disabled, false);+ assert.deepEqual(h.errors, networkFailure ? ["offline"] : []);+ h.click();+ assert.equal(h.confirmations.length, 2);+ }+});++test("clear is available only in writable history views", () => {+ const h = harness();+ for (const mode of ["created", "updated"]) {+ h.sort(mode);+ assert.equal(h.hidden.has("fn__none"), true);+ h.click();+ }+ for (const mode of ["viewedAt", "openAt", "closedAt"]) {+ h.sort(mode);+ assert.equal(h.hidden.has("fn__none"), false);+ }+ h.siyuan.config.readonly = true;+ h.update();+ h.click();+ assert.equal(h.hidden.has("fn__none"), true);+ h.siyuan.config.readonly = false;+ h.siyuan.isPublish = true;+ h.update();+ h.click();+ assert.equal(h.confirmations.length, 0);+ assert.equal(h.hidden.has("fn__none"), true);+});++test("closed views cannot submit a confirmation or receive a late clear result", async () => {+ for (const beforeRequest of [false, true]) {+ const h = harness();+ h.click();+ if (beforeRequest) {+ h.deactivate();+ }+ const pending = h.confirmations[0].confirm();+ if (!beforeRequest) {+ h.deactivate();+ h.requests[0].resolve({code: 0});+ }+ await pending;+ assert.equal(h.requests.length, beforeRequest ? 0 : 1);+ assert.equal(h.cleared(), 0);+ }+});diff --git a/app/src/business/clearRecentDocs.ts b/app/src/business/clearRecentDocs.tsnew file mode 100644index 0000000000..5b4fdcd25b--- /dev/null+++ b/app/src/business/clearRecentDocs.ts@@ -0,0 +1,44 @@+import {confirmDialog} from "../dialog/confirmDialog";+import {showMessage} from "../dialog/message";+import {fetchSyncPost} from "../util/fetch";+import {escapeHtmlTextAndAttr} from "../util/escape";++export const clearRecentDocsButtonHTML = () => `<button type="button" data-action="clear-recent-docs" class="block__icon block__icon--show fn__none b3-tooltips b3-tooltips__sw" aria-label="${escapeHtmlTextAndAttr(window.siyuan.languages.clearRecentDocs)}"><svg><use xlink:href="#iconTrashcan"></use></svg></button>`;++export const bindClearRecentDocs = (button: HTMLButtonElement, getSortBy: () => string,+ isActive: () => boolean, onCleared: () => void) => {+ let pending = false;+ const canWrite = () => !window.siyuan.config.readonly && !window.siyuan.isPublish;+ const update = () => {+ button.classList.toggle("fn__none", !canWrite() || ["created", "updated"].includes(getSortBy()));+ button.disabled = pending;+ };+ button.addEventListener("click", () => {+ if (pending || !canWrite() || !isActive() || ["created", "updated"].includes(getSortBy())) {+ return;+ }+ pending = true;+ update();+ const finish = () => {+ pending = false;+ update();+ };+ confirmDialog(window.siyuan.languages.clearRecentDocs, window.siyuan.languages.confirmClearRecentDocs, async () => {+ try {+ if (!canWrite() || !isActive()) {+ return;+ }+ const response = await fetchSyncPost("/api/storage/clearRecentDocs", {});+ if (response.code === 0 && isActive()) {+ onCleared();+ }+ } catch (error) {+ showMessage(error.message, 0, "error");+ } finally {+ finish();+ }+ }, finish);+ });+ update();+ return update;+};diff --git a/app/src/business/openRecentDocs.test.ts b/app/src/business/openRecentDocs.test.tsindex 452d8f550e..b60791cbec 100644--- a/app/src/business/openRecentDocs.test.ts+++ b/app/src/business/openRecentDocs.test.ts@@ -19,6 +19,8 @@ const createHarness = () => {callbacks.set("input:" + name, callback)};const select = {value: "", addEventListener: (name: string, callback: (...args: any[]) => void) =>callbacks.set("select:" + name, callback)};+ let clearCallback: () => void;+ let clearUpdates = 0;const host = {innerHTML: ""};const path = {innerHTML: "", previousElementSibling: host};let icons: Array<{tagName: string, classes: Set<string>, classList: {add: (name: string) => void},@@ -84,6 +86,13 @@ const createHarness = () => {assert.equal(element, root);cleanups.push(host.innerHTML);}},+ "./clearRecentDocs": {+ clearRecentDocsButtonHTML: () => "<button data-action=\"clear-recent-docs\"></button>",+ bindClearRecentDocs: (_button: unknown, _getSort: unknown, _isActive: unknown, callback: () => void) => {+ clearCallback = callback;+ return () => clearUpdates++;+ },+ },"../dialog": {Dialog: class {element = root;constructor(options: any) {@@ -94,7 +103,7 @@ const createHarness = () => {}, "\nexports.render = renderRecentDocsContent;");const settle = async () => { await new Promise(resolve => setImmediate(resolve)); };return {api, root, host, path, input, select, siyuan, pathRequests, requests, callbacks, cleanups, patches, settle,- icons: () => icons, dialogOptions: () => dialogOptions};+ icons: () => icons, dialogOptions: () => dialogOptions, clear: () => clearCallback(), clearUpdates: () => clearUpdates};};test("recent document SVG, Unicode and image icons receive the shared document preview target", async () => {@@ -213,3 +222,50 @@ test("recent Arrow and Enter handlers ignore popover editors and closing dialogexports.keydown({key: "Enter", target: input, preventDefault() {}}, {});assert.equal(calls, 3);});++test("clearing invalidates pending sort and path responses and refreshes the current filter", async () => {+ const h = createHarness();+ h.api.openRecentDocs();+ h.requests[0].receive({data: [{rootID: "old", title: "Old"}]});+ h.select.value = "closedAt";+ h.callbacks.get("select:change")();+ assert.equal(h.clearUpdates(), 1);+ h.clear();+ assert.doesNotMatch(h.host.innerHTML, /data-node-id/);+ assert.equal(h.requests[2].data.sortBy, "closedAt");+ h.requests[1].receive({data: [{rootID: "stale", title: "Stale"}]});+ h.pathRequests[0].resolve({code: 0, data: "/Old"});+ await h.settle();+ assert.doesNotMatch(h.host.innerHTML, /data-node-id/);+ h.requests[2].receive({data: []});+ h.input.value = "Old";+ h.callbacks.get("input:input")({isComposing: false});+ assert.doesNotMatch(h.host.innerHTML, /data-node-id/, "search must not restore cleared cached data");+});++test("clearing after switching to created documents preserves that list and reloads the current mode", async () => {+ const h = createHarness();+ h.api.openRecentDocs();+ h.requests[0].receive({data: []});+ h.select.value = "created";+ h.callbacks.get("select:change")();+ h.requests[1].receive({data: [{rootID: "created", title: "Created"}]});+ h.pathRequests[0].resolve({code: 0, data: "/Created"});+ await h.settle();+ h.clear();+ assert.match(h.host.innerHTML, /data-node-id="created"/);+ assert.equal(h.requests[2].data.sortBy, "created");+});++test("clearing invalidates a pending history render even when a creation query is now selected", async () => {+ const h = createHarness();+ h.api.openRecentDocs();+ h.requests[0].receive({data: [{rootID: "old", title: "Old"}]});+ h.select.value = "created";+ h.callbacks.get("select:change")();+ h.clear();+ h.pathRequests[0].resolve({code: 0, data: "/Old"});+ await h.settle();+ assert.doesNotMatch(h.host.innerHTML, /data-node-id="old"/);+ assert.equal(h.requests[2].data.sortBy, "created");+});diff --git a/app/src/business/openRecentDocs.ts b/app/src/business/openRecentDocs.tsindex 47bfc5e106..81d9f2557c 100644--- a/app/src/business/openRecentDocs.ts+++ b/app/src/business/openRecentDocs.ts@@ -11,6 +11,7 @@ import {Dialog} from "../dialog";import {hasClosestByClassName} from "../protyle/util/hasClosest";import {hideElements} from "../protyle/ui/hideElements";import {destroyDialogBlockPanels} from "../block/panelOwnership";+import {bindClearRecentDocs, clearRecentDocsButtonHTML} from "./clearRecentDocs";const recentDocsRenderVersions = new WeakMap<Element, number>();@@ -122,6 +123,8 @@ export const openRecentDocs = (openOnly = false) => {<option value="openAt">${window.siyuan.languages.recentOpened}</option><option value="closedAt">${window.siyuan.languages.recentClosed}</option></select>+ <span class="fn__space"></span>+ ${clearRecentDocsButtonHTML()}</div></div>`,content: `<div class="fn__flex-column switch-doc">@@ -155,19 +158,30 @@ export const openRecentDocs = (openOnly = false) => {}});- // 添加排序下拉框事件监听+ const isActive = () => dialog.element.isConnected && !dialog.element.hasAttribute("data-dialog-closing");let sortRequestId = 0;- sortSelect.addEventListener("change", () => {+ const loadRecentDocs = () => {const requestId = ++sortRequestId;- // 重新调用 API 获取排序后的数据fetchPost("/api/storage/getRecentDocs", {sortBy: sortSelect.value}, (newResponse) => {- if (requestId !== sortRequestId || !dialog.element.isConnected ||- dialog.element.hasAttribute("data-dialog-closing")) {+ if (requestId !== sortRequestId || !isActive()) {return;}response = newResponse;renderRecentDocsContent(newResponse.data, dialog.element, searchElement.value);});+ };+ const updateClearButton = bindClearRecentDocs(dialog.element.querySelector('[data-action="clear-recent-docs"]'),+ () => sortSelect.value, isActive, () => {+ recentDocsRenderVersions.set(dialog.element, (recentDocsRenderVersions.get(dialog.element) || 0) + 1);+ if (!["created", "updated"].includes(sortSelect.value)) {+ response.data = [];+ void renderRecentDocsContent([], dialog.element, searchElement.value);+ }+ loadRecentDocs();+ });+ sortSelect.addEventListener("change", () => {+ updateClearButton();+ loadRecentDocs();if (!window.siyuan.config.readonly && !window.siyuan.isPublish) {void fileConfigApi.patch("recentDocsSort", sortSelect.value);}diff --git a/app/src/mobile/menu/getRecentDocs.test.ts b/app/src/mobile/menu/getRecentDocs.test.tsnew file mode 100644index 0000000000..4759e2631f--- /dev/null+++ b/app/src/mobile/menu/getRecentDocs.test.ts@@ -0,0 +1,85 @@+import * as assert from "node:assert/strict";+import {readFileSync} from "node:fs";+import {test} from "node:test";+import {runInNewContext} from "node:vm";+import {ModuleKind, ScriptTarget, transpileModule} from "typescript";+const {createMockRequire} = require("../../../tests/fixtures/mockModules.cjs");++const harness = () => {+ const handlers = new Map<string, (event?: unknown) => void>();+ const list = {innerHTML: "", isConnected: true, addEventListener() {}};+ const input = {value: "", addEventListener: (name: string, cb: () => void) => handlers.set("input:" + name, cb)};+ const select = {value: "", addEventListener: (name: string, cb: () => void) => handlers.set("select:" + name, cb)};+ const element = {querySelector: (selector: string) => selector === "ul" ? list : selector === "input" ? input : select};+ const requests: Array<{url: string, data: any, receive: (response: any) => void}> = [];+ let clear: () => void;+ let isActive: () => boolean;+ let destroy: () => void;+ let updates = 0;+ const exports: any = {};+ runInNewContext(transpileModule(readFileSync("src/mobile/menu/getRecentDocs.ts", "utf8"), {+ compilerOptions: {module: ModuleKind.CommonJS, target: ScriptTarget.ES2021},+ }).outputText, {exports, window: {siyuan: {config: {fileTree: {recentDocsSort: "viewedAt"}}, languages: {}}},+ require: createMockRequire({+ "../../config/tabs/fileRuntime": {fileConfigApi: {patch: async () => {}}},+ "../../util/fetch": {fetchPost: (url: string, data: any, receive: (response: any) => void) => requests.push({url, data, receive})},+ "../../emoji/fileTreeIcon": {getFileTreeIconHTML: () => ""},+ "../../constants": {Constants: {}},+ "../../util/escape": {escapeHtml: (text: string) => text},+ "../../protyle/util/hasClosest": {},+ "../editor": {},+ "../../business/clearRecentDocs": {+ clearRecentDocsButtonHTML: () => "<button data-action=\"clear-recent-docs\"></button>",+ bindClearRecentDocs: (_button: unknown, _getSort: unknown, active: () => boolean, callback: () => void) => {+ isActive = active;+ clear = callback;+ return () => updates++;+ },+ },+ "./model": {openModel: (options: any) => { destroy = options.destroyCallback; options.bindEvent(element); }},+ })});+ exports.getRecentDocs({});+ requests[0].receive({data: [{rootID: "old", title: "Old"}]});+ return {list, input, select, requests, handlers, clear: () => clear(), isActive: () => isActive(),+ destroy: () => destroy(), updates: () => updates};+};++test("mobile clear invalidates old sort responses and cached search records", () => {+ const h = harness();+ assert.match(h.list.innerHTML, /data-node-id="old"/);+ h.select.value = "closedAt";+ h.handlers.get("select:change")();+ assert.equal(h.updates(), 1);+ h.clear();+ assert.equal(h.list.innerHTML, "");+ assert.equal(h.requests[2].data.sortBy, "closedAt");+ h.requests[1].receive({data: [{rootID: "stale", title: "Stale"}]});+ assert.equal(h.list.innerHTML, "");+ h.input.value = "Old";+ h.handlers.get("input:input")({isComposing: false});+ assert.equal(h.list.innerHTML, "");+ h.input.value = "";+ h.requests[2].receive({data: [{rootID: "new", title: "New"}]});+ assert.match(h.list.innerHTML, /data-node-id="new"/);+});++test("mobile clear preserves creation and modification lists selected while confirmation was open", () => {+ for (const sort of ["created", "updated"]) {+ const h = harness();+ h.select.value = sort;+ h.handlers.get("select:change")();+ h.requests[1].receive({data: [{rootID: sort, title: sort}]});+ h.clear();+ assert.match(h.list.innerHTML, new RegExp(`data-node-id="${sort}"`));+ assert.equal(h.requests[2].data.sortBy, sort);+ }+});++test("mobile model close rejects late sort responses and invalidates clear ownership", () => {+ const h = harness();+ h.handlers.get("select:change")();+ h.destroy();+ assert.equal(h.isActive(), false);+ h.requests[1].receive({data: [{rootID: "late", title: "Late"}]});+ assert.doesNotMatch(h.list.innerHTML, /data-node-id="late"/);+});diff --git a/app/src/mobile/menu/getRecentDocs.ts b/app/src/mobile/menu/getRecentDocs.tsindex 60dc7a4caf..5b50c69ff6 100644--- a/app/src/mobile/menu/getRecentDocs.ts+++ b/app/src/mobile/menu/getRecentDocs.ts@@ -7,6 +7,7 @@ import {hasClosestByClassName} from "../../protyle/util/hasClosest";import {openModel} from "./model";import {openMobileFileById} from "../editor";import type {App} from "../../index";+import {bindClearRecentDocs, clearRecentDocsButtonHTML} from "../../business/clearRecentDocs";interface IRecentDoc {rootID: string;@@ -31,9 +32,11 @@ export const getRecentDocs = (app: App) => {const sortBy = window.siyuan.config.fileTree.recentDocsSort as TRecentDocsSort;fetchPost("/api/storage/getRecentDocs", {sortBy}, (response) => {let recentDocs = response.data as IRecentDoc[];+ let active = true;openModel({title: window.siyuan.languages.recentDocs,icon: "iconRecentDocs",+ destroyCallback: () => { active = false; },html: `<div class="fn__flex-column" style="height: 100%"><div class="toolbar toolbar--border" style="padding: 8px"><input placeholder="${window.siyuan.languages.searchPlaceholder}" class="b3-text-field fn__flex-1" autocomplete="off" autocorrect="off" spellcheck="false">@@ -45,6 +48,8 @@ export const getRecentDocs = (app: App) => {<option value="openAt">${window.siyuan.languages.recentOpened}</option><option value="closedAt">${window.siyuan.languages.recentClosed}</option></select>+ <span class="fn__space"></span>+ ${clearRecentDocsButtonHTML()}</div><ul class="b3-list b3-list--mobile fn__flex-1"></ul></div>`,@@ -62,16 +67,30 @@ export const getRecentDocs = (app: App) => {}});let sortRequestId = 0;- sortSelect.addEventListener("change", () => {+ const isActive = () => active && listElement.isConnected;+ const loadRecentDocs = () => {const newSortBy = sortSelect.value as TRecentDocsSort;const requestId = ++sortRequestId;fetchPost("/api/storage/getRecentDocs", {sortBy: newSortBy}, (newResponse) => {- if (requestId !== sortRequestId) {+ if (requestId !== sortRequestId || !isActive()) {return;}recentDocs = newResponse.data as IRecentDoc[];renderRecentDocs(recentDocs, listElement, searchElement.value);});+ };+ const updateClearButton = bindClearRecentDocs(element.querySelector('[data-action="clear-recent-docs"]'),+ () => sortSelect.value, isActive, () => {+ if (!["created", "updated"].includes(sortSelect.value)) {+ recentDocs = [];+ renderRecentDocs(recentDocs, listElement, searchElement.value);+ }+ loadRecentDocs();+ });+ sortSelect.addEventListener("change", () => {+ const newSortBy = sortSelect.value as TRecentDocsSort;+ updateClearButton();+ loadRecentDocs();if (!window.siyuan.config.readonly && !window.siyuan.isPublish) {void fileConfigApi.patch("recentDocsSort", newSortBy);}diff --git a/app/src/types/api/index.d.ts b/app/src/types/api/index.d.tsindex 6b59d55039..890c717de3 100644--- a/app/src/types/api/index.d.ts+++ b/app/src/types/api/index.d.ts@@ -7212,6 +7212,18 @@ export interface APIPOSTRoutes {/** 服务器路由要求;资源权限与笔记本租约仍由内核校验 */authorization?: readonly ["authenticated"];};+ /**+ * 清空当前工作区的全部最近浏览、打开和关闭记录,不删除文档,也不修改文档创建和修改时间。+ * 记录不参与数据同步;后续浏览、打开或关闭文档会重新产生记录。最近创建和最近修改列表不受影响。+ * 仅允许可写工作区的管理员调用,无需请求参数;重复清空仍返回成功。+ */+ "/api/storage/clearRecentDocs": {+ request: EmptyRequestInput;+ response: { "code": 0; "data": null; "msg": string; } | { "code": -1; "data": { "closeTimeout": number; } | null; "msg": string; };+ body: "none";+ /** 服务器路由要求;资源权限与笔记本租约仍由内核校验 */+ authorization?: readonly ["authenticated","admin","writable"];+ };"/api/storage/getCriteria": {request: EmptyRequestInput;response: { "code": 0; "data": Array<Criterion | null> | null; "msg": string; } | { "code": -1; "data": { "closeTimeout": number; } | null; "msg": string; };diff --git a/kernel/api/contract_storage_test.go b/kernel/api/contract_storage_test.goindex 068ac08638..b831c1959a 100644--- a/kernel/api/contract_storage_test.go+++ b/kernel/api/contract_storage_test.go@@ -1,15 +1,94 @@package apiimport (+ "encoding/json"+ "net/http""net/http/httptest"+ "os"+ "path/filepath""strings""testing""github.com/gin-gonic/gin"+ "github.com/siyuan-note/siyuan/kernel/apicontract"+ "github.com/siyuan-note/siyuan/kernel/conf""github.com/siyuan-note/siyuan/kernel/model""github.com/siyuan-note/siyuan/kernel/util")+func TestAPIContractClearRecentDocs(t *testing.T) {+ previousDir, previousConf, previousReadonly := util.DataDir, model.Conf, util.ReadOnly+ util.DataDir, model.Conf, util.ReadOnly = t.TempDir(), model.NewAppConf(), false+ model.Conf.FileTree.Store(conf.NormalizeFileTree(conf.NewFileTree()))+ t.Cleanup(func() { util.DataDir, model.Conf, util.ReadOnly = previousDir, previousConf, previousReadonly })+ const route = "/api/storage/clearRecentDocs"+ recordPath := filepath.Join(util.DataDir, "storage", "recent-doc.json")+ if err := os.MkdirAll(filepath.Dir(recordPath), 0700); err != nil {+ t.Fatal(err)+ }+ const records = `[{"rootID":"20261021000000-abcdefg","viewedAt":1,"openAt":2,"closedAt":3}]`+ for _, scenario := range []struct {+ name string+ role model.Role+ readonly bool+ status int+ success bool+ }{+ {"unauthenticated", model.RoleVisitor, false, http.StatusUnauthorized, false},+ {"administrator", model.RoleAdministrator, false, http.StatusOK, true},+ {"editor", model.RoleEditor, false, http.StatusForbidden, false},+ {"reader", model.RoleReader, false, http.StatusForbidden, false},+ {"readonly", model.RoleAdministrator, true, http.StatusOK, false},+ } {+ t.Run(scenario.name, func(t *testing.T) {+ if err := os.WriteFile(recordPath, []byte(records), 0600); err != nil {+ t.Fatal(err)+ }+ util.ReadOnly = scenario.readonly+ engine := gin.New()+ engine.Use(func(c *gin.Context) { c.Set(model.RoleContextKey, scenario.role) })+ engine.POST(route, contractRouteHandlers(apicontract.ClearRecentDocs, clearRecentDocs)...)+ recorder := httptest.NewRecorder()+ request := httptest.NewRequest("POST", route, nil)+ request.RemoteAddr = "198.51.100.1:12345"+ engine.ServeHTTP(recorder, request)+ if recorder.Code != scenario.status {+ t.Fatalf("unexpected status: %d %s", recorder.Code, recorder.Body.String())+ }+ if scenario.status == http.StatusOK {+ requireAPIContract(t, "POST", route, recorder)+ var result struct {+ Code int `json:"code"`+ }+ if err := json.Unmarshal(recorder.Body.Bytes(), &result); err != nil || (result.Code == 0) != scenario.success {+ t.Fatalf("unexpected response: %s, %v", recorder.Body.String(), err)+ }+ }+ data, err := os.ReadFile(recordPath)+ want := records+ if scenario.success {+ want = "[]"+ }+ if err != nil || string(data) != want {+ t.Fatalf("unexpected persisted records: %s, %v", data, err)+ }+ })+ }+ util.ReadOnly = false+ util.DataDir = t.TempDir()+ if err := os.WriteFile(filepath.Join(util.DataDir, "storage"), []byte("blocked"), 0600); err != nil {+ t.Fatal(err)+ }+ engine := gin.New()+ engine.POST(route, clearRecentDocs)+ recorder := httptest.NewRecorder()+ engine.ServeHTTP(recorder, httptest.NewRequest("POST", route, nil))+ requireAPIContract(t, "POST", route, recorder)+ if !strings.Contains(recorder.Body.String(), `"code":-1`) {+ t.Fatalf("write failure returned success: %s", recorder.Body.String())+ }+}+func TestAPIContractReadonlyRecentDocsIgnoreBody(t *testing.T) {for _, kernelReadonly := range []bool{false, true} {name := "reader role"diff --git a/kernel/api/router.go b/kernel/api/router.goindex f4527cf302..e4406b44ae 100644--- a/kernel/api/router.go+++ b/kernel/api/router.go@@ -238,6 +238,7 @@ func registerStorageRoutes(ginServer *gin.Engine) {ginServer.Handle("POST", "/api/storage/setCriterion", contractRouteHandlers(apicontract.SetCriterion, setCriterion)...)ginServer.Handle("POST", "/api/storage/removeCriterion", contractRouteHandlers(apicontract.RemoveCriterion, removeCriterion)...)ginServer.Handle("POST", "/api/storage/getRecentDocs", contractRouteHandlers(apicontract.GetRecentDocs, getRecentDocs)...)+ ginServer.Handle("POST", "/api/storage/clearRecentDocs", contractRouteHandlers(apicontract.ClearRecentDocs, clearRecentDocs)...)ginServer.Handle("POST", "/api/storage/updateRecentDocOpenTime", contractRouteHandlers(apicontract.UpdateRecentDocOpenTime, updateRecentDocOpenTime)...)ginServer.Handle("POST", "/api/storage/updateRecentDocViewTime", contractRouteHandlers(apicontract.UpdateRecentDocViewTime, updateRecentDocViewTime)...)ginServer.Handle("POST", "/api/storage/updateRecentDocCloseTime", contractRouteHandlers(apicontract.UpdateRecentDocCloseTime, updateRecentDocCloseTime)...)diff --git a/kernel/api/storage.go b/kernel/api/storage.goindex 9d99dba68c..f1a66fb0b4 100644--- a/kernel/api/storage.go+++ b/kernel/api/storage.go@@ -228,6 +228,13 @@ var getRecentDocs = contractHandler(apicontract.GetRecentDocs, func(c *gin.Contereturn apicontract.Success(recentDocContracts(data))})+var clearRecentDocs = contractHandler(apicontract.ClearRecentDocs, func(c *gin.Context, request apicontract.EmptyRequest) apicontract.Response[apicontract.Null] {+ if err := model.ClearRecentDocs(); err != nil {+ return apicontract.Failure[apicontract.Null](-1, err.Error())+ }+ return apicontract.Success(apicontract.Null{})+})+var updateRecentDocOpenTime = contractHandler(apicontract.UpdateRecentDocOpenTime, func(c *gin.Context, request apicontract.RecentDocUpdateRequest) apicontract.Response[apicontract.Null] {ret := gulu.Ret.NewResult()diff --git a/kernel/apicontract/contracts.go b/kernel/apicontract/contracts.goindex 8cc631d84a..9370b898c0 100644--- a/kernel/apicontract/contracts.go+++ b/kernel/apicontract/contracts.go@@ -530,6 +530,11 @@ var PatchViewState = define[ViewStatePatchRequest, map[string]JSONValue]("patchVvar RemoveViewState = define[StorageKeyRequest, Null]("removeViewState", "/api/storage/removeViewState", AuthenticatedAccess|AdminAccess|WritableAccess, JSONBody, ResponseOptions{Setting: SettingWrite{Namespace: "storage", Mode: SettingSilent}}, "POST")var GetRecentDocs = define[RecentDocsRequest, []*RecentDoc]("getRecentDocs", "/api/storage/getRecentDocs", AuthenticatedAccess, LegacyOptionalBody, ResponseOptions{}, "POST")+// 清空当前工作区的全部最近浏览、打开和关闭记录,不删除文档,也不修改文档创建和修改时间。+// 记录不参与数据同步;后续浏览、打开或关闭文档会重新产生记录。最近创建和最近修改列表不受影响。+// 仅允许可写工作区的管理员调用,无需请求参数;重复清空仍返回成功。+var ClearRecentDocs = define[EmptyRequest, Null]("clearRecentDocs", "/api/storage/clearRecentDocs", AuthenticatedAccess|AdminAccess|WritableAccess, NoBody, ResponseOptions{}, "POST")+var GetCriteria = define[EmptyRequest, []*Criterion]("getCriteria", "/api/storage/getCriteria", AuthenticatedAccess, NoBody, ResponseOptions{}, "POST")var SetCriterion = define[SetCriterionRequest, Null]("setCriterion", "/api/storage/setCriterion", AuthenticatedAccess|AdminAccess|WritableAccess, JSONBody, ResponseOptions{Setting: SettingWrite{Namespace: "storage", Mode: SettingSilent}}, "POST")var RemoveCriterion = define[RemoveCriterionRequest, Null]("removeCriterion", "/api/storage/removeCriterion", AuthenticatedAccess|AdminAccess|WritableAccess, JSONBody, ResponseOptions{Setting: SettingWrite{Namespace: "storage", Mode: SettingSilent}}, "POST")diff --git a/kernel/apicontract/schema.json b/kernel/apicontract/schema.jsonindex 8db72a3eb5..736a5f020f 100644--- a/kernel/apicontract/schema.json+++ b/kernel/apicontract/schema.json@@ -166336,6 +166336,86 @@]}},+ {+ "method": "POST",+ "path": "/api/storage/clearRecentDocs",+ "handler": "clearRecentDocs",+ "authorization": [+ "authenticated",+ "admin",+ "writable"+ ],+ "body": "none",+ "request": {+ "$ref": "#/$defs/EmptyRequestInput"+ },+ "response": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "code": {+ "type": "integer",+ "enum": [+ 0+ ]+ },+ "data": {+ "type": "null"+ },+ "msg": {+ "type": "string"+ }+ },+ "required": [+ "code",+ "msg",+ "data"+ ],+ "additionalProperties": false+ },+ {+ "type": "object",+ "properties": {+ "code": {+ "type": "integer",+ "enum": [+ -1+ ]+ },+ "data": {+ "anyOf": [+ {+ "type": "object",+ "properties": {+ "closeTimeout": {+ "type": "number"+ }+ },+ "required": [+ "closeTimeout"+ ],+ "additionalProperties": false+ },+ {+ "type": "null"+ }+ ]+ },+ "msg": {+ "type": "string"+ }+ },+ "required": [+ "code",+ "msg",+ "data"+ ],+ "additionalProperties": true+ }+ ]+ }+ },{"method": "POST","path": "/api/storage/getCriteria",diff --git a/kernel/model/storage.go b/kernel/model/storage.goindex e83c8eed9e..5df0231557 100644--- a/kernel/model/storage.go+++ b/kernel/model/storage.go@@ -333,6 +333,13 @@ func GetRecentDocs(sortBy string) (ret []*RecentDoc, err error) {return getRecentDocs(sortBy)}+// ClearRecentDocs 清空当前工作区的浏览、打开和关闭记录,后续访问继续记录。+func ClearRecentDocs() error {+ recentDocLock.Lock()+ defer recentDocLock.Unlock()+ return setRecentDocs([]*RecentDoc{})+}+// UpdateRecentDocOpenTime 更新文档打开时间(只在第一次从文档树加载到页签时调用)func UpdateRecentDocOpenTime(rootID string) (err error) {if !canPersistRecentDoc(rootID) {diff --git a/kernel/model/storage_test.go b/kernel/model/storage_test.goindex 3ecac24381..86f72ec892 100644--- a/kernel/model/storage_test.go+++ b/kernel/model/storage_test.go@@ -17,10 +17,94 @@package modelimport (+ "bytes"+ "os"+ "path/filepath""reflect""testing"++ "github.com/siyuan-note/siyuan/kernel/conf"+ "github.com/siyuan-note/siyuan/kernel/util")+func TestClearRecentDocs(t *testing.T) {+ fixture := setupFileOperationTest(t)+ Conf.FileTree.Store(conf.NormalizeFileTree(conf.NewFileTree()))+ docPath := filepath.Join(util.DataDir, fixture.box.ID, fixture.sourcePath)+ before, err := os.ReadFile(docPath)+ if err != nil {+ t.Fatal(err)+ }+ for _, update := range []func(string) error{UpdateRecentDocOpenTime, UpdateRecentDocViewTime, UpdateRecentDocCloseTime} {+ if err = update(fixture.sourceID); err != nil {+ t.Fatal(err)+ }+ }+ records, err := loadRecentDocsRaw()+ if err != nil || len(records) != 1 || records[0].ViewedAt == 0 || records[0].OpenAt == 0 || records[0].ClosedAt == 0 {+ t.Fatalf("missing initial activity records: %+v, %v", records, err)+ }+ for range 2 {+ if err = ClearRecentDocs(); err != nil {+ t.Fatal(err)+ }+ data, readErr := os.ReadFile(filepath.Join(util.DataDir, "storage", "recent-doc.json"))+ if readErr != nil || string(data) != "[]" {+ t.Fatalf("clear did not persist an empty array: %s, %v", data, readErr)+ }+ for _, sortBy := range []string{"viewedAt", "openAt", "closedAt"} {+ if docs, getErr := GetRecentDocs(sortBy); getErr != nil || docs == nil || len(docs) != 0 {+ t.Fatalf("cleared %s records remain: %+v, %v", sortBy, docs, getErr)+ }+ }+ }+ after, err := os.ReadFile(docPath)+ if err != nil || !bytes.Equal(before, after) {+ t.Fatalf("clear changed document content or timestamps: %v", err)+ }+ for _, activity := range []struct {+ name string+ update func(string) error+ viewed, opened, closed bool+ }{+ {"view", UpdateRecentDocViewTime, true, false, false},+ {"open", UpdateRecentDocOpenTime, true, true, false},+ {"close existing tab", UpdateRecentDocCloseTime, false, false, true},+ } {+ t.Run(activity.name, func(t *testing.T) {+ if err := ClearRecentDocs(); err != nil {+ t.Fatal(err)+ }+ if err := activity.update(fixture.sourceID); err != nil {+ t.Fatal(err)+ }+ records, err := loadRecentDocsRaw()+ if err != nil || len(records) != 1 || records[0].RootID != fixture.sourceID ||+ (records[0].ViewedAt > 0) != activity.viewed || (records[0].OpenAt > 0) != activity.opened ||+ (records[0].ClosedAt > 0) != activity.closed {+ t.Fatalf("new activity should not restore old times: %+v, %v", records, err)+ }+ })+ }+}++func TestClearRecentDocsMissingStorageAndWriteFailure(t *testing.T) {+ previousDir, previousConf := util.DataDir, Conf+ util.DataDir, Conf = t.TempDir(), NewAppConf()+ Conf.FileTree.Store(conf.NormalizeFileTree(conf.NewFileTree()))+ t.Cleanup(func() { util.DataDir, Conf = previousDir, previousConf })+ if err := ClearRecentDocs(); err != nil {+ t.Fatalf("missing storage should be initialized: %v", err)+ }+ util.DataDir = t.TempDir()+ if err := os.WriteFile(filepath.Join(util.DataDir, "storage"), []byte("blocked"), 0600); err != nil {+ t.Fatal(err)+ }+ if err := ClearRecentDocs(); err == nil {+ t.Fatal("write failure must not be reported as success")+ }+}+func TestBuildRecentDocsByTimeStmt(t *testing.T) {tests := []struct {name string