前言

我把每日報告寫在 Obsidian 裡,ToDo 也寫在每日報告的 md 檔中。
我把 Raycast 的 Obsidian 擴充功能中的「Daily Note」指令綁定到熱鍵,讓我可以一鍵打開今天的每日報告。
不過,這個指令打開的是 Obsidian 的視窗。

另一方面,Raycast 內建的筆記功能 Raycast Notes 也非常好用。
不管當下正在使用哪個應用程式,都可以一鍵把筆記視窗叫到前景。
因此我開始想,能不能也把每日報告做成像 Raycast Notes 那樣以彈出視窗顯示。

這篇文章要介紹的是,如何在任何畫面下都能一鍵把 Obsidian 的每日報告彈出顯示。
會介紹兩種作法:直接安裝 Floating Notes 這個外掛,以及參考它自行製作一個外掛。

無法用 Raycast 擴充功能做出來

一開始我想的是,能不能做一個能把 md 檔以彈出視窗顯示的 Raycast 擴充功能。
但擴充功能能夠呈現的畫面只有以下 4 種:

畫面類型 | 說明
List | 以清單方式列出相似項目
Grid | 以網格方式排列占用較大空間的項目
Detail | 顯示 Markdown 字串,旁邊也可以附上中繼資料欄位
Form | 排列輸入欄位,用來建立新內容

md 的內容可以用 Detail 顯示,但只能看,不能直接寫入。
Form 雖然有文字輸入欄位(Form.TextArea),但它的設計是把輸入內容送出後儲存,並不是像編輯器一樣持續書寫的畫面。
我希望能像 Raycast Notes 一樣,直接在彈出的每日報告上編輯內容,因此判斷沒有編輯器功能的 Raycast 擴充功能無法做到。

Obsidian 的外掛 Floating Notes

於是我轉而尋找 Obsidian 端的方案,結果找到了一個名為 Floating Notes 的外掛,設計靈感正是來自 Raycast Notes。

https://github.com/haotiencheng/obsidian-floating-notes

它可以把筆記開在一個小型獨立視窗中,並保持在其他應用程式前方。
可開啟的筆記可以從「目前打開的筆記」、「指定筆記」、「今天的每日筆記」等選項中選擇。

Obsidian 的熱鍵只有在 Obsidian 視窗處於作用中時才有效。
因此 Floating Notes 在外掛內部架設了本機 HTTP 伺服器,讓 Raycast 之類的啟動器可以呼叫。
只要把 README 裡的腳本註冊到 Raycast 的 Script Command(將 shell 腳本註冊為 Raycast 指令的功能),再綁定熱鍵,就能在任何應用程式中叫出彈出視窗。

原樣使用仍不夠的 3 個地方

實際安裝 Floating Notes 使用後,我發現有 3 個地方讓我有點在意。

1. 下載數不多

下載數約為 2k(截至 2026 年 11 月 14 日)。
Obsidian 官方說明指出,社群外掛可以存取電腦檔案,也可以連上網際網路。
新版本會自動掃描,但人工審查只限於較熱門的外掛。
下載數較少的外掛,其程式碼可能會隨著每次更新而變動,這讓我覺得有些不安。

2. 無法顯示在全螢幕視窗之上

設定說明裡寫著,它也可以顯示在全螢幕應用程式之上。
但在我的環境中,當我在全螢幕的 Chrome 裡按下熱鍵時,彈出視窗卻出現在桌面的空間中。

3. 點擊其他地方時不會自動關閉

在 Floating Notes 中,只要再按一次熱鍵,或按下 Escape,就會隱藏。
而我希望的是,只要點到其他應用程式就能自動關閉。

只做需要的功能來自製

Floating Notes 是以 MIT 授權公開的,可以修改後使用。
因此我參考 Floating Notes 的程式碼,自己做了一個只包含必要功能的外掛。
因為它是我自己的外掛、放在 vault 裡,所以不會因為更新而改變內容。

我做出來的外掛動作如下:

  • 透過 Raycast 的熱鍵,以最前景彈出視窗顯示今天的每日報告;再按一次則隱藏
  • 可顯示在全螢幕應用程式之上
  • 點擊其他地方時,以及按下 Escape 時也會隱藏
  • 如果今天還沒有每日報告,就從平常使用的每日報告模板建立後開啟

(補充) 從 Floating Notes 修改的地方

雖然這個外掛純粹是個人用途,沒有打算公開,但為了讓讀者在自己實作時可以把這些資訊交給 AI,我還是把原理寫下來。

原理與程式碼 Obsidian 是用 Electron 製作的,所以彈出視窗本身也是 Electron 的 BrowserWindow。
為了讓它能顯示在全螢幕之上,我把 setAlwaysOnTop 的層級從 "floating" 提升為 "screen-saver",並移除了傳給 setVisibleOnAllWorkspaces 的 skipTransformProcessType: true。
我只改 Floating Notes 中這兩個地方測試後,就能顯示在全螢幕 Chrome 之上了。
而「點擊其他地方就隱藏」的行為,則是透過失去焦點時觸發的 blur 事件實作的。

/**
 * 取得彈出視窗的 BrowserWindow(型別宣告略)
 */
const bw = popout.win.electronWindow;

// 以 screen-saver 層級固定在最前面
bw.setAlwaysOnTop(true, "screen-saver");
// 也顯示在全螢幕應用程式的工作區中
bw.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
// 當使用者點擊其他應用程式而失去焦點時隱藏
bw.on("blur", () => hidePopup());
  • 和 Floating Notes 一樣,Obsidian 沒有啟動就無法使用
  • 根據 Electron 文件,移除 skipTransformProcessType 後,每次呼叫時視窗與 Dock 都會短暫消失。這個外掛只在建立彈出視窗時呼叫一次
  • electronWindow 不是 Obsidian 的公開 API 屬性。Obsidian 更新後可能會失效

最後

一開始我想到的是 Raycast 擴充功能,完全沒想到可以用 Obsidian 外掛來做。
原本 Raycast 擴充功能做不到的事情,透過 Obsidian 外掛與 Raycast Script Command 的組合竟然可以實現,讓我學到很多。

參考資料

株式会社シンシア

在株式會社シンシア,我們聘用沒有實務經驗的工程師與學生工程實習生,並與他們一同工作。
※ 關於シンシア的工作方式,請參考這裡

我們每年會收到超過 100 位沒有實務經驗者的應徵,並進行技術面試。
如果這篇文章對你有一點幫助,也非常歡迎你去看看 wantedly 的故事,對我們來說會非常開心!


原文出處:https://qiita.com/kuma_3838/items/e8a11dd95f319a1545d6


精選技術文章翻譯,幫助開發者持續吸收新知。

共有 0 則留言


精選技術文章翻譯,幫助開發者持續吸收新知。
🏆 本月排行榜
🥇
boluoji
📝39   💬3   ❤️7
961
🥈
我愛JS
📝3   💬1   ❤️5
106
🥉
站長阿川
📝1   💬3   ❤️2
44
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次
📢 贊助商廣告 · 我要刊登