Improve Recent documents (#15824)

Achuan-2 · web-flow · commit d9e0c56a4794 · 2025-10-24T11:12:14.000+08:00
* ✨ Improve Recent documents
基于文档最近浏览时间进行排序

* ✨ 支持显示最近关闭文档

* ✨ 支持显示最近关闭文档

* ✨ 支持显示最近关闭文档

* ✨ 支持显示最近关闭文档

* ✨ 支持显示最近关闭文档

* ✨ 支持显示最近关闭文档

* ✨支持Ctrl+Shift+T打开最近关闭的文档

* 🎨 clean code

* 🔥 移除表格插入行/列的默认快捷键

* ✨ 最近文档支持显示最近修改文档

* 🎨

* ✨ 最近文档支持查看最近打开

* 🎨

* ⏪

* Update win-build.bat
diff --git a/app/appearance/langs/ar_SA.json b/app/appearance/langs/ar_SA.json
@@ -1361,6 +1361,10 @@
   "uploadError": "خطأ في الرفع",
   "uploading": "يتم الرفع...",
   "wysiwyg": "‫ما تراه هو ما تحصل عليه (WYSIWYG)‬",
+  "recentViewed": "تم عرضها مؤخراً",
+  "recentOpened": "تم فتحها مؤخراً",
+  "recentClosed": "تم إغلاقها مؤخراً",
+  "recentModified": "تم تعديلها مؤخراً",
   "_label": "العربية",
   "_time": {
     "albl": "من قبل",
diff --git a/app/appearance/langs/de_DE.json b/app/appearance/langs/de_DE.json
diff --git a/app/appearance/langs/en_US.json b/app/appearance/langs/en_US.json
@@ -1361,6 +1361,10 @@
   "uploadError": "upload error",
   "uploading": "Uploading...",
   "wysiwyg": "WYSIWYG",
+  "recentViewed": "Recently Viewed",
+  "recentOpened": "Recently Opened",
+  "recentClosed": "Recently Closed",
+  "recentModified": "Recently Modified",
   "_label": "English",
   "_time": {
     "albl": "ago",
diff --git a/app/appearance/langs/es_ES.json b/app/appearance/langs/es_ES.json
@@ -1361,6 +1361,10 @@
   "uploadError": "error de subida",
   "uploading": "Subiendo...",
   "wysiwyg": "WYSIWYG",
+  "recentViewed": "Visto recientemente",
+  "recentOpened": "Abierto recientemente",
+  "recentClosed": "Cerrado recientemente",
+  "recentModified": "Modificado recientemente",
   "_label": "Español",
   "_time": {
     "albl": "hace",
diff --git a/app/appearance/langs/fr_FR.json b/app/appearance/langs/fr_FR.json
@@ -1361,6 +1361,10 @@
   "uploadError": "erreur de transfert",
   "uploading": "Transfert en cours",
   "wysiwyg": "WYSIWYG",
+  "recentViewed": "Récemment consulté",
+  "recentOpened": "Récemment ouvert",
+  "recentClosed": "Récemment fermé",
+  "recentModified": "Récemment modifié",
   "_label": "Français",
   "_time": {
     "albl": "Précédemment",
diff --git a/app/appearance/langs/he_IL.json b/app/appearance/langs/he_IL.json
diff --git a/app/appearance/langs/it_IT.json b/app/appearance/langs/it_IT.json
diff --git a/app/appearance/langs/ja_JP.json b/app/appearance/langs/ja_JP.json
@@ -1361,6 +1361,10 @@
   "uploadError": "アップロードエラー",
   "uploading": "アップロード中...",
   "wysiwyg": "WYSIWYG",
+  "recentViewed": "最近閲覧",
+  "recentOpened": "最近開いた",
+  "recentClosed": "最近閉じる",
+  "recentModified": "最近更新",
   "_label": "日本語",
   "_time": {
     "albl": "前",
diff --git a/app/appearance/langs/pl_PL.json b/app/appearance/langs/pl_PL.json
diff --git a/app/appearance/langs/pt_BR.json b/app/appearance/langs/pt_BR.json
diff --git a/app/appearance/langs/ru_RU.json b/app/appearance/langs/ru_RU.json
diff --git a/app/appearance/langs/zh_CHT.json b/app/appearance/langs/zh_CHT.json
@@ -1361,6 +1361,10 @@
   "uploadError": "上傳錯誤",
   "uploading": "上傳中...",
   "wysiwyg": "所見即所得",
+  "recentViewed": "最近瀏覽",
+  "recentOpened": "最近開啟",
+  "recentClosed": "最近關閉",
+  "recentModified": "最近更新",
   "_label": "繁體中文",
   "_time": {
     "albl": "前",
diff --git a/app/appearance/langs/zh_CN.json b/app/appearance/langs/zh_CN.json
@@ -1361,6 +1361,10 @@
   "uploadError": "上传错误",
   "uploading": "上传中...",
   "wysiwyg": "所见即所得",
+  "recentViewed": "最近浏览",
+  "recentOpened": "最近打开",
+  "recentClosed": "最近关闭",
+  "recentModified": "最近修改",
   "_label": "简体中文",
   "_time": {
     "albl": "前",
diff --git a/app/src/boot/globalEvent/keydown.ts b/app/src/boot/globalEvent/keydown.ts
@@ -1532,6 +1532,19 @@ export const windowKeyDown = (app: App, event: KeyboardEvent) => {
         return;
     }
 
+    if (matchHotKey("⇧⌘T", event)) {
+        if ((window as any).siyuan.closedTabs && (window as any).siyuan.closedTabs.length > 0) {
+            const closedTab = (window as any).siyuan.closedTabs.pop();
+            openFileById({
+                app,
+                id: closedTab.id,
+                action: [Constants.CB_GET_FOCUS, Constants.CB_GET_SCROLL]
+            });
+        }
+        event.preventDefault();
+        return;
+    }
+
     if (matchHotKey(window.siyuan.config.keymap.general.goToTab1.custom, event) && !event.repeat) {
         switchTabByIndex(0);
         event.preventDefault();
diff --git a/app/src/business/openRecentDocs.ts b/app/src/business/openRecentDocs.ts
@@ -10,10 +10,18 @@ import {focusByRange} from "../protyle/util/selection";
 import {hasClosestByClassName} from "../protyle/util/hasClosest";
 import {hideElements} from "../protyle/ui/hideElements";
 
-const getHTML = async (data: { rootID: string, icon: string, title: string }[], element: Element, key?: string) => {
+const getHTML = async (data: { rootID: string, icon: string, title: string, viewedAt?: number, closedAt?: number, openAt?: number, updated?: number }[], element: Element, key?: string, sortBy: "viewedAt" | "closedAt" | "openAt" | "updated" = "viewedAt") => {
     let tabHtml = "";
     let index = 0;
-    data.forEach((item) => {
+    
+    // 根据排序字段对数据进行排序
+    const sortedData = [...data].sort((a, b) => {
+        const aValue = a[sortBy] || 0;
+        const bValue = b[sortBy] || 0;
+        return bValue - aValue; // 降序排序
+    });
+    
+    sortedData.forEach((item) => {
         if (!key || item.title.toLowerCase().includes(key.toLowerCase())) {
             tabHtml += `<li data-index="${index}" data-node-id="${item.rootID}" class="b3-list-item${index === 0 ? " b3-list-item--focus" : ""}">
 ${unicode2Emoji(item.icon || window.siyuan.storage[Constants.LOCAL_IMAGES].file, "b3-list-item__graphic", true)}
@@ -77,7 +85,7 @@ export const openRecentDocs = () => {
         hideElements(["dialog"]);
         return;
     }
-    fetchPost("/api/storage/getRecentDocs", {}, (response) => {
+    fetchPost("/api/storage/getRecentDocs", {sortBy: "viewedAt"}, (response) => {
         let range: Range;
         if (getSelection().rangeCount > 0) {
             range = getSelection().getRangeAt(0);
@@ -91,6 +99,14 @@ export const openRecentDocs = () => {
     <svg class="b3-form__icon-icon"><use xlink:href="#iconSearch"></use></svg>
     <input placeholder="${window.siyuan.languages.search}" class="b3-text-field fn__block b3-form__icon-input">
 </div>
+<div class="fn__flex-center fn__ml8">
+    <select class="b3-select fn__size200" id="recentDocsSort">
+    <option value="viewedAt">${window.siyuan.languages.recentViewed}</option>
+    <option value="updated">${window.siyuan.languages.recentModified}</option>
+    <option value="openAt">${window.siyuan.languages.recentOpened}</option>
+    <option value="closedAt">${window.siyuan.languages.recentClosed}</option>
+    </select>
+</div>
 </div>`,
             content: `<div class="fn__flex-column switch-doc">
     <div class="fn__flex fn__flex-1" style="overflow:auto;"></div>
@@ -106,13 +122,13 @@ export const openRecentDocs = () => {
         const searchElement = dialog.element.querySelector("input");
         searchElement.focus();
         searchElement.addEventListener("compositionend", () => {
-            getHTML(response.data, dialog.element, searchElement.value);
+            getHTML(response.data, dialog.element, searchElement.value, sortSelect.value as "viewedAt" | "closedAt" | "openAt" | "updated");
         });
         searchElement.addEventListener("input", (event: InputEvent) => {
             if (event.isComposing) {
                 return;
             }
-            getHTML(response.data, dialog.element, searchElement.value);
+            getHTML(response.data, dialog.element, searchElement.value, sortSelect.value as "viewedAt" | "closedAt" | "openAt" | "updated");
         });
         dialog.element.setAttribute("data-key", Constants.DIALOG_RECENTDOCS);
         dialog.element.addEventListener("click", (event) => {
@@ -125,6 +141,45 @@ export const openRecentDocs = () => {
                 event.preventDefault();
             }
         });
+        
+        // 添加排序下拉框事件监听
+        const sortSelect = dialog.element.querySelector("#recentDocsSort") as HTMLSelectElement;
+        sortSelect.addEventListener("change", () => {
+            // 重新调用API获取排序后的数据
+            if (sortSelect.value === "updated") {
+                // 使用SQL查询获取最近修改的文档
+                const data = {
+                    stmt: "SELECT * FROM blocks WHERE type = 'd' ORDER BY updated DESC LIMIT 33"
+                };
+                fetchSyncPost("/api/query/sql", data).then((sqlResponse) => {
+                    if (sqlResponse.data && sqlResponse.data.length > 0) {
+                        // 转换SQL查询结果格式
+                        const recentModifiedDocs = sqlResponse.data.map((block: any) => {
+                            // 从ial中解析icon
+                            let icon = "";
+                            if (block.ial) {
+                                const iconMatch = block.ial.match(/icon="([^"]*)"/);
+                                if (iconMatch) {
+                                    icon = iconMatch[1];
+                                }
+                            }
+                            return {
+                                rootID: block.id,
+                                icon: icon,
+                                title: block.content,
+                                updated: block.updated
+                            };
+                        });
+                        getHTML(recentModifiedDocs, dialog.element, searchElement.value, "updated");
+                    }
+                });
+            } else {
+                fetchPost("/api/storage/getRecentDocs", {sortBy: sortSelect.value}, (newResponse) => {
+                    getHTML(newResponse.data, dialog.element, searchElement.value, sortSelect.value as "viewedAt" | "closedAt" | "openAt");
+                });
+            }
+        });
+        
         getHTML(response.data, dialog.element);
     });
 };
diff --git a/app/src/constants.ts b/app/src/constants.ts
@@ -572,10 +572,10 @@ export abstract class Constants {
                 checkToggle: {default: "⌘↩", custom: "⌘↩"},
             },
             table: {
-                insertRowAbove: {default: "⇧⌘T", custom: "⇧⌘T"},
-                insertRowBelow: {default: "⇧⌘D", custom: "⇧⌘D"},
-                insertColumnLeft: {default: "⇧⌘L", custom: "⇧⌘L"},
-                insertColumnRight: {default: "⇧⌘R", custom: "⇧⌘R"},
+                insertRowAbove: {default: "", custom: ""},
+                insertRowBelow: {default: "", custom: ""},
+                insertColumnLeft: {default: "", custom: ""},
+                insertColumnRight: {default: "", custom: ""},
                 moveToUp: {default: "⌥⌘T", custom: "⌥⌘T"},
                 moveToDown: {default: "⌥⌘B", custom: "⌥⌘B"},
                 moveToLeft: {default: "⌥⌘L", custom: "⌥⌘L"},
diff --git a/app/src/editor/util.ts b/app/src/editor/util.ts
@@ -56,6 +56,10 @@ export const openFileById = async (options: {
         showMessage(response.msg);
         return;
     }
+    
+    // 更新文档浏览时间
+    fetchPost("/api/storage/updateRecentDocViewTime", {rootID: response.data.rootID});
+    
     return openFile({
         app: options.app,
         fileName: response.data.rootTitle,
diff --git a/app/src/layout/Wnd.ts b/app/src/layout/Wnd.ts
@@ -30,6 +30,7 @@ import {Search} from "../search";
 import {showMessage} from "../dialog/message";
 import {openFileById, updatePanelByEditor} from "../editor/util";
 import {scrollCenter} from "../util/highlightById";
+import {fetchPost} from "../util/fetch";
 import {getAllModels} from "./getAll";
 import {clearCounter} from "./status";
 import {saveScroll} from "../protyle/scroll/saveScroll";
@@ -555,6 +556,9 @@ export class Wnd {
             }
             // focusin 触发前，layout__wnd--active 和 tab 已设置，需在调用里面更新
             if (update) {
+                // 更新文档浏览时间
+                fetchPost("/api/storage/updateRecentDocViewTime", {rootID: currentTab.model.editor.protyle.block.rootID});
+                
                 updatePanelByEditor({
                     protyle: currentTab.model.editor.protyle,
                     focus: true,
@@ -632,6 +636,12 @@ export class Wnd {
         if (tab.callback) {
             tab.callback(tab);
         }
+        
+        // 当文档第一次加载到页签时更新 openAt 时间
+        if (tab.model instanceof Editor && tab.model.editor?.protyle?.block?.rootID) {
+            fetchPost("/api/storage/updateRecentDocOpenTime", {rootID: tab.model.editor.protyle.block.rootID});
+        }
+        
         // 移除 centerLayout 中的 empty
         if (this.parent.type === "center" && this.children.length === 2 && !this.children[0].headElement) {
             this.removeTab(this.children[0].id);
@@ -781,6 +791,14 @@ export class Wnd {
                 }
                 if (item.model instanceof Editor) {
                     saveScroll(item.model.editor.protyle);
+                    // 更新文档关闭时间
+                    fetchPost("/api/storage/updateRecentDocCloseTime", {rootID: item.model.editor.protyle.block.rootID});
+                    if (!(window as any).siyuan.closedTabs) {
+                        (window as any).siyuan.closedTabs = [];
+                    }
+                    (window as any).siyuan.closedTabs.push({
+                        id: item.model.editor.protyle.block.rootID
+                    });
                 }
                 if (this.children.length === 1) {
                     this.destroyModel(this.children[0].model);
diff --git a/app/src/mobile/editor.ts b/app/src/mobile/editor.ts
@@ -52,6 +52,9 @@ export const openMobileFileById = (app: App, id: string, action: TProtyleAction[
             showMessage(data.msg);
             return;
         }
+        
+        // 更新文档浏览时间
+        fetchPost("/api/storage/updateRecentDocViewTime", {rootID: data.data.rootID});
         const protyleOptions: IProtyleOptions = {
             blockId: id,
             rootId: data.data.rootID,
diff --git a/app/src/mobile/menu/getRecentDocs.ts b/app/src/mobile/menu/getRecentDocs.ts
@@ -8,7 +8,7 @@ import {openMobileFileById} from "../editor";
 import {App} from "../../index";
 
 export const getRecentDocs = (app: App) => {
-    fetchPost("/api/storage/getRecentDocs", {}, (response) => {
+    fetchPost("/api/storage/getRecentDocs", {sortBy: "viewedAt"}, (response) => {
         let html = "";
         response.data.forEach((item: any, index: number) => {
             html += `<li data-index="${index}" data-node-id="${item.rootID}" class="b3-list-item${index === 0 ? " b3-list-item--focus" : ""}">
diff --git a/kernel/api/router.go b/kernel/api/router.go
@@ -78,6 +78,10 @@ func ServeAPI(ginServer *gin.Engine) {
 	ginServer.Handle("POST", "/api/storage/getCriteria", model.CheckAuth, getCriteria)
 	ginServer.Handle("POST", "/api/storage/removeCriterion", model.CheckAuth, model.CheckAdminRole, model.CheckReadonly, removeCriterion)
 	ginServer.Handle("POST", "/api/storage/getRecentDocs", model.CheckAuth, getRecentDocs)
+	ginServer.Handle("POST", "/api/storage/updateRecentDocViewTime", model.CheckAuth, updateRecentDocViewTime)
+	ginServer.Handle("POST", "/api/storage/updateRecentDocCloseTime", model.CheckAuth, updateRecentDocCloseTime)
+	ginServer.Handle("POST", "/api/storage/updateRecentDocOpenTime", model.CheckAuth, updateRecentDocOpenTime)
+	
 	ginServer.Handle("POST", "/api/storage/getOutlineStorage", model.CheckAuth, getOutlineStorage)
 	ginServer.Handle("POST", "/api/storage/setOutlineStorage", model.CheckAuth, model.CheckAdminRole, model.CheckReadonly, setOutlineStorage)
 	ginServer.Handle("POST", "/api/storage/removeOutlineStorage", model.CheckAuth, model.CheckAdminRole, model.CheckReadonly, removeOutlineStorage)
diff --git a/kernel/api/storage.go b/kernel/api/storage.go
@@ -29,7 +29,18 @@ func getRecentDocs(c *gin.Context) {
 	ret := gulu.Ret.NewResult()
 	defer c.JSON(http.StatusOK, ret)
 
-	data, err := model.GetRecentDocs()
+	arg, ok := util.JsonArg(c, ret)
+	if !ok {
+		return
+	}
+
+	// 获取排序参数
+	sortBy := "viewedAt" // 默认按浏览时间排序
+	if arg["sortBy"] != nil {
+		sortBy = arg["sortBy"].(string)
+	}
+
+	data, err := model.GetRecentDocs(sortBy)
 	if err != nil {
 		ret.Code = -1
 		ret.Msg = err.Error()
@@ -236,3 +247,59 @@ func removeOutlineStorage(c *gin.Context) {
 		return
 	}
 }
+
+
+func updateRecentDocViewTime(c *gin.Context) {
+	ret := gulu.Ret.NewResult()
+	defer c.JSON(http.StatusOK, ret)
+
+	arg, ok := util.JsonArg(c, ret)
+	if !ok {
+		return
+	}
+
+	rootID := arg["rootID"].(string)
+	err := model.UpdateRecentDocViewTime(rootID)
+	if err != nil {
+		ret.Code = -1
+		ret.Msg = err.Error()
+		return
+	}
+}
+
+
+func updateRecentDocOpenTime(c *gin.Context) {
+	ret := gulu.Ret.NewResult()
+	defer c.JSON(http.StatusOK, ret)
+
+	arg, ok := util.JsonArg(c, ret)
+	if !ok {
+		return
+	}
+
+	rootID := arg["rootID"].(string)
+	err := model.UpdateRecentDocOpenTime(rootID)
+	if err != nil {
+		ret.Code = -1
+		ret.Msg = err.Error()
+		return
+	}
+}
+
+func updateRecentDocCloseTime(c *gin.Context) {
+	ret := gulu.Ret.NewResult()
+	defer c.JSON(http.StatusOK, ret)
+
+	arg, ok := util.JsonArg(c, ret)
+	if !ok {
+		return
+	}
+
+	rootID := arg["rootID"].(string)
+	err := model.UpdateRecentDocCloseTime(rootID)
+	if err != nil {
+		ret.Code = -1
+		ret.Msg = err.Error()
+		return
+	}
+}
diff --git a/kernel/model/storage.go b/kernel/model/storage.go
