文件索引
主要文件
- README (本文件)
開發人員文件
- API 參考資料 - 公開 API 文件。涵蓋 JavaScript/TypeScript 開發人員所需的元資料管理、導航控制與事件訂閱。
- 製作主題指南 - 主題開發人員指南。包括 CSS 類別參考、自訂屬性，以及明暗模式的主題範例。
- 啟動程序 - 外掛程式初始化順序。冷啟動與暖啟動流程、元資料快取解析、遞延清潔與內容產生管道。包含 Mermaid 圖表。
- 元資料管道 - 快取重建順序、提供者管道階段和完成訊號。包括 Mermaid 圖表。
- 儲存架構 - 儲存容器指南（IndexedDB、本機儲存、記憶體快取、設定）。資料流模式與使用指南。
- 渲染架構 - React 元件層級結構、使用 TanStack Virtual 的虛擬捲動、效能最佳化以及資料流程。
- 捲動協調 - 當樹狀結構改變時，外掛程式如何確保精確的捲動（標籤可見性、設定等）
- 服務架構 - 商業邏輯層：MetadataService、FileSystemOperations、ContentProviderRegistry。依賴注入模式與服務資料流程。
1 安裝
- 安裝 Obsidian- 從obsidian.md下載並安裝
- 啟用社群外掛程式- 移至設定 → 社群外掛程式 → 開啟社群外掛程式
- 安裝 Notebook Navigator- 按一下「瀏覽」→搜尋「Notebook Navigator」→安裝
- 安裝「樣式設定」（可選）- 若要自訂顏色和外觀，請在社群外掛程式中搜尋「樣式設定」，以安裝「樣式設定」外掛程式。
2 開始使用
以下是學習和掌握 Notebook Navigator 的官方教學：
視訊有 21 種語言的字幕。
3 安全與品質
在合併變更之前，Notebook Navigator 會使用TypeScript、ESLint與官方Obsidian ESLint 外掛、Prettier、Vitest和生產版本進行檢查。建置完成時必須是零錯誤和零警告。
安全檢查透過CodeQL 執行，掃描記錄在CodeQL 工作流程執行中，以及OpenSSF 計分卡中。目前的狀態顯示在此頁面頂端的徽章中。
Notebook Navigator 在本機執行，但某些功能會對更新、下載和遠端內容提出有文件記錄的 HTTP 請求。完整清單請參閱第 10 節 - 網路與診斷披露。
目錄
4 鍵盤捷徑
| 關鍵 | 操作 |
|---|---|
| ↑/↓ | 在當前窗格中向上/向下導航 |
| ← | 在導覽窗格中：收合或前往父級 在清單窗格中：切換至導覽窗格 |
| → | 在導覽窗格中：展開或切換至清單窗格 在清單窗格中：切換至編輯器 |
| Tab | 在導覽窗格中：切換至清單窗格 在清單窗格中：切換至編輯器 在搜尋欄中：切換至清單窗格 |
| Shift+Tab | 在清單窗格中：切換至導覽窗格 在搜尋欄中：切換至導覽窗格 |
| Enter (macOS) F2 (Windows/Linux) | 在導覽窗格或清單窗格中直接重新命名項目 |
| Enter | 在導覽窗格中：預設在 Windows/Linux 上開啟資料夾筆記（若已啟用） 在清單窗格中：在所有系統上開啟選取的檔案（若已啟用） 在搜尋欄中：切換至清單窗格 |
| Esc | 在搜尋欄中：關閉搜尋並將焦點移至清單窗格 |
| PageUp/PageDown | 在導覽窗格和清單窗格中向上/向下捲動 |
| Home/End | 跳至當前窗格中的第一個／最後一個項目 |
| 刪除 退格鍵 | 刪除選取的項目 |
| Cmd/Ctrl+A | 選取當前資料夾中的所有筆記 |
| Cmd/Ctrl+點擊 | 切換筆記選取狀態 |
| Shift+點擊 | 選取一組筆記 |
| Shift+Home/End | 從當前位置選取至第一個／最後一個項目 |
| Shift+↑/↓ | 向上／向下延伸選取範圍 |
| Cmd/Ctrl+↑/↓ | 在手動排序模式下將選取的檔案向上／向下重新排列 |
注意：所有鍵盤捷徑都可以自訂。有關新增 VIM 式導航 (h,j,k,l)、備用鍵及修改器組合的詳細資訊，請參閱第 7 節 - 自訂快速鍵。
5 同步與本機設定
Notebook Navigator 中的許多設定會顯示同步切換 - 在「啟用同步」與「停用同步」之間切換的雲圖示。這可控制每項設定的儲存位置，以及是否可跨裝置共用。
5.1 同步如何運作
Obsidian 外掛程式會將其設定儲存於data.json ，位於您的 vault 資料夾內的.obsidian/plugins/notebook-navigator/data.json 。當您使用同步服務 (例如Obsidian Sync、iCloud、GitHub、Dropbox 或 Google Drive) 時，此檔案就會與儲存庫的其他內容一起同步到您所有的裝置。任何儲存至data.json 的設定都會傳播至同步儲存庫的每部裝置。
當設定啟用同步處理 (預設值) 時，該值會儲存在data.json ，並透過同步處理服務同步處理到所有裝置。
當設定的同步關閉時，數值會儲存到 Obsidian 的本機儲存空間。本機儲存是特定於裝置的，不包括在儲存庫同步中。設定值在每個裝置上都有其獨立值。當您停用設定的同步處理時，目前的數值會複製到目前裝置的本機儲存空間，而且該數值會從data.json 移除，以防止它覆寫其他裝置上的本機值。
如果您不使用同步服務，同步切換就沒有實際作用，因為data.json 只儲存在本機中。
6 搜尋
Notebook Navigator 有兩種搜尋模式：篩選搜尋和全方位搜尋。使用向上/向下箭頭鍵或按一下搜尋圖示，即可在兩者之間切換。結合檔案名稱、屬性、標籤、日期和篩選條件於單一查詢 (例如：meeting .status=active #work @thisweek)。
6.1 篩選搜尋
依名稱、標籤、屬性、日期、資料夾、副檔名以及目前資料夾和子資料夾內的工作過濾檔案。預設搜尋模式。
檔案名稱
word- 匹配檔案名稱中包含「word」的筆記word1 word2- 要求每個字都必須符合檔案名稱-word- 排除檔案名稱中包含「word」的筆記
標籤
#tag- 包含標籤的備註（也匹配嵌套標籤，如#tag/subtag)#- 只包含已標記的筆記-#tag- 排除帶標籤的筆記-#- 只包含未標記筆記#tag1 #tag2- 同時匹配兩個標籤 (隱含 AND)#tag1 AND #tag2- 同時匹配兩個標籤 (明確 AND)#tag1 OR #tag2- 匹配任一標籤#a OR #b AND #c- AND 的優先順序更高：匹配#a，或同時匹配#b和#c- Cmd/Ctrl+Click 標籤以 AND 方式新增。Cmd/Ctrl+Shift+Click 以 OR 加入
屬性
.key- 包含註釋與產品鑰匙.key=value- 在屬性值包含value."Reading Status"- 帶有空格的屬性鍵（雙引號）."Reading Status"="In Progress"- 帶有空白的鍵和值必須使用雙引號-.key- 排除帶有屬性鑰匙的筆記-.key=value- 排除屬性值包含value- Cmd/Ctrl+Click 使用 AND 新增屬性。Cmd/Ctrl+Shift+Click 以 OR 加入
濾波器
has:task- 包含未完成任務的筆記-has:task- 排除未完成任務的筆記folder:meetings- 在資料夾名稱包含meetingsfolder:/work/meetings- 只在work/meetings（不包括子資料夾）中包含備註folder:/- 僅在儲存庫根目錄中包含筆記-folder:archive- 排除資料夾名稱包含archive-folder:/archive- 僅排除archive中的筆記 (不包括子資料夾)ext:md- 包含備註的擴展名md(ext:.md也支援)-ext:pdf- 排除具有延伸功能的筆記pdf- 結合標籤、名稱和日期 (例如：
folder:/work/meetings ext:md @thisweek)
日期
@today- 使用預設日期欄位匹配今天的筆記@yesterday,@last7d,@last30d,@thisweek,@thismonth- 相對日期範圍@2026-02-07- 匹配單日 (也支援@20260207)@2026- 匹配日曆年@2026-02或@202602- 搭配日曆月@2026-W05或@2026W05- 搭配 ISO 週@2026-Q2或@2026Q2- 搭配日曆季度@13/02/2026- 使用分隔符的數字格式 (@07022026在含糊不清時會跟隨您的區域)@2026-02-01..2026-02-07- 匹配包天範圍 (支援開放式)@c:...或@m:...- 目標建立或修改日期-@...- 排除日期匹配
預設日期欄位遵循目前的排序順序。依名稱排序時，日期欄位在設定 → 備註 → 日期 → 依名稱排序時設定。
AND/OR 行為
AND 和OR 運算符號適用於僅標籤/屬性查詢 (只包含#tag,-#tag,#,-#,.key,-.key,.key=value 或-.key=value 篩選條件的查詢)。如果查詢還包含名稱、日期、任務篩選項、資料夾篩選項或副檔名篩選項，則AND 和OR 會改為以檔案名稱字詞進行匹配。
- 操作員查詢：
#work OR .status=started - 混合查詢：
#work OR ext:md(OR在檔案名稱中進行匹配)
6.2 Omnisearch
在儲存庫中進行全文搜尋，可過濾至目前的資料夾、子資料夾或選取的標籤。需要Omnisearch外掛程式。如果未安裝 Omnisearch，搜尋會退回到篩選搜尋。
附註預覽顯示 Omnisearch 結果摘錄，而非預設預覽文字。
已知限制
- 效能- 在大型儲存庫中搜尋少於 3 個字元時會變慢
- 路徑篩選器— 僅針對簡單的 ASCII 路徑，才會將資料夾範圍資訊傳送至 Omnisearch；其他路徑則會在 Omnisearch 返回結果後進行篩選
- 有限的結果- Omnisearch 會搜尋整個儲存庫，並在篩選前傳回有限數量的結果，因此如果其他地方有許多符合的檔案，則可能不會出現目前資料夾中的相關檔案。
- 預覽文字- 備註預覽會以 Omnisearch 結果摘錄取代，如果實際的搜尋配對高亮顯示出現在檔案的其他地方，則可能不會顯示該高亮顯示
7 自訂熱鍵
編輯.obsidian/plugins/notebook-navigator/data.json 自訂 Notebook 導覽器熱鍵。開啟檔案並尋找keyboardShortcuts 區段。每個項目將一個動作對應到一個或多個按鍵綁定：
"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]
每個動作加入多個綁定，以支援交替的按鍵，就像上面的ArrowUp 和K 例子。透過列出每個值，將修改器組合在一個項目中，例如"modifiers": ["Mod", "Shift"] 。不支援鍵盤序列，例如gg 或dd 。編輯檔案後重新載入 Obsidian。
7.1 修改器
| 修改器 | 按鍵 |
|---|---|
Mod |
Cmd (macOS) / Ctrl (Win/Linux) |
Alt |
Alt / 選項 |
Shift |
移動鍵 |
Ctrl |
Control (跨平台時偏好Mod ) |
7.2 可用的動作
| 動作 | 預設鍵 |
|---|---|
pane:move-up |
向上箭頭 |
pane:move-down |
向下箭頭 |
pane:page-up |
PageUp |
pane:page-down |
PageDown |
pane:home |
首頁 |
pane:end |
End |
pane:rename |
Enter（macOS）、F2（Windows/Linux） |
pane:delete-selected |
刪除鍵、退格鍵 |
navigation:collapse-or-parent |
左箭頭 |
navigation:expand-or-focus-list |
右箭頭 |
navigation:focus-list |
Tab |
list:focus-navigation |
左箭頭、Shift+Tab |
list:focus-editor |
右箭頭、Tab |
list:select-all |
Mod+A |
list:extend-selection-up |
Shift+向上箭頭 |
list:extend-selection-down |
Shift+向下箭頭 |
list:manual-sort-up |
Mod+向上箭頭 |
list:manual-sort-down |
Mod+向下箭頭 |
list:range-to-start |
Shift+Home |
list:range-to-end |
Shift+End |
search:focus-list |
Tab、Enter |
search:focus-navigation |
Shift+Tab |
search:close |
Esc |
8 指令
在 Obsidian 的熱鍵設定中為這些指令設定自訂熱鍵：
檢視與導覽
Notebook Navigator: Open開啟左側欄的筆記簿導覽器。如果已經開啟，則會將鍵盤焦點移至清單窗格。建議：綁定快捷鍵，如Cmd/Ctrl+Shift+E，將鍵盤焦點移至清單窗格 -這對於全鍵盤瀏覽非常重要Notebook Navigator: Toggle left sidebar切換左側邊欄。開啟時，會將左側列檢視設定為 Notebook 導覽器 (不像 Obsidian 內建的「切換左側列」指令，會還原之前的左側列檢視)Notebook Navigator: Open homepage開啟筆記簿導覽器檢視，並載入設定中設定的首頁目標Notebook Navigator: Select vault profile開啟模組在保險庫設定檔間切換Notebook Navigator: Reveal file在導覽器中顯示目前的檔案。展開父資料夾，捲動到檔案。如果您已關閉Auto-reveal active note設定，並想要手動顯示備註，則此指令非常有用。建議：綁定到捷徑鍵，如Cmd/Ctrl+Shift+R，以快速將選取的資料夾或標籤變更為目前的檔案。Notebook Navigator: Open all files開啟目前所選資料夾或標籤中的所有筆記。開啟 15 個或以上檔案時，會顯示確認對話框Notebook Navigator: Navigate to folder搜尋對話方塊可跳至任何資料夾Notebook Navigator: Navigate to tag搜尋對話方塊可跳至任何標籤Notebook Navigator: Navigate to property搜尋對話方塊可跳至任何屬性鍵或值Notebook Navigator: Navigate back移至導覽器歷史中的上一個資料夾、標籤或屬性選項Notebook Navigator: Navigate forward移至導覽器歷史中的下一個資料夾、標籤或屬性選項Notebook Navigator: Add to shortcuts從捷徑中新增或移除目前的檔案、資料夾、標籤或屬性Notebook Navigator: Open shortcut 1-9依捷徑清單中的位置開啟捷徑Notebook Navigator: Search開啟快速搜尋欄位，若已開啟，則對焦。搜尋會在各個階段之間持續進行。建議：綁定到快速篩選檔案的快捷鍵，如Cmd/Ctrl+Shift+SNotebook Navigator: Search whole vault選取保管庫根目錄，並開啟包含子資料夾的搜尋功能（需啟用「Show root folder」）
選擇
Notebook Navigator: Select next file將選取移至目前資料夾或標籤檢視中的下一個檔案。尊重自訂排序順序。建議：綁定快捷鍵，如Option+Cmd+Right，以快速移至清單中的下一個檔案。Notebook Navigator: Select previous file將選擇移至目前資料夾或標籤檢視中的前一個檔案。尊重自訂排序順序。建議：綁定快捷鍵，如Option+Cmd+Left，以快速移至清單中的上一個檔案。
佈局與顯示
Notebook Navigator: Toggle dual pane layout切換單/雙窗格佈局 (桌面)。建議：綁定快捷鍵，如Cmd/Ctrl+Shift+A，以快速切換單窗格和雙窗格佈局Notebook Navigator: Toggle dual pane orientation在水平和垂直之間切換雙窗格方向Notebook Navigator: Toggle descendants切換顯示資料夾和標籤的子資料夾/後輩備註。建議：綁定快捷鍵，如Cmd/Ctrl+Shift+D，以快速切換顯示子資料夾/子資料夾的備註。Notebook Navigator: Toggle hidden folders, tags, and notes顯示或隱藏隱藏的資料夾、標籤和備註Notebook Navigator: Toggle tag sort order在按字母順序與按出現頻率排序標籤之間切換Notebook Navigator: Toggle tags by selection切換限制標籤為在選取資料夾或物業內的筆記中找到的標籤Notebook Navigator: Toggle properties by selection切換限制屬性為在選取資料夾或標籤內的筆記中找到的屬性Notebook Navigator: Toggle compact mode在標準與精簡模式之間切換清單模式Notebook Navigator: Toggle pinned section在清單窗格中顯示或隱藏釘住的筆記Notebook Navigator: Collapse / expand all items根據目前狀態折疊或展開所有項目。啟用Keep selected item expanded時 (預設為開啟)，除了目前的資料夾外，所有資料夾都會折疊。這對於在搜尋文件時保持導覽樹整齊非常方便。Notebook Navigator: Collapse / expand selected item折疊或展開所選導覽項目
行事曆
Notebook Navigator: Toggle calendar切換行事曆開啟或關閉。建議：綁定快捷鍵（如Cmd/Ctrl+Shift+C）以快速顯示行事曆Notebook Navigator: Open daily note根據行事曆設定開啟今日的每日記事。如果筆記不存在，則建立筆記Notebook Navigator: Open weekly note開啟目前的週記事。如果該備忘不存在，則建立該備忘Notebook Navigator: Open monthly note開啟目前的月記事。如果不存在，則建立月記Notebook Navigator: Open quarterly note開啟目前的季度筆記。如果不存在，則建立該筆記Notebook Navigator: Open yearly note開啟目前的年度筆記。如果不存在，則建立該筆記
檔案作業
重要：Obsidian 沒有「目前資料夾或標籤」的上下文，因此在 Obsidian 中建立筆記時，預設會在根資料夾、與目前檔案相同的資料夾，或特定資料夾中建立。使用 Notebook Navigator 工作時，您總是希望在目前選取的資料夾或標籤中建立新筆記，因此您應該做的第一件事就是將Cmd/Ctrl+N 綁定到Notebook Navigator: Create new note ，這樣新筆記就總是在目前選取的資料夾或標籤中建立。這也同樣適用於移動和刪除檔案。這就是您在使用筆記簿導覽器時，應該使用這些指令而非內建的 Obsidian 指令的原因。
Notebook Navigator: Create new note在目前選取的資料夾中建立筆記。建議：將Cmd/Ctrl+N綁定到此指令 (先從 Obsidian 的預設「建立新備忘」解除綁定)Notebook Navigator: Create new note from template從目前選取資料夾中的範本建立筆記 (需要 Templater)Notebook Navigator: Move files將選取的檔案移到另一個資料夾。選擇目前資料夾中的下一個檔案Notebook Navigator: Merge notes從目前清單順序中選擇的 Markdown 筆記建立一個筆記Notebook Navigator: Convert to folder note建立與檔案名稱相符的資料夾，並將檔案移至其中作為資料夾備註Notebook Navigator: Set as folder note將使用中的檔案重新命名為其資料夾附註名稱Notebook Navigator: Detach folder note取下選取資料夾中的資料夾附註，並將其重新命名Notebook Navigator: Pin all folder notes將所有資料夾中的資料夾備註皆設為釘選。此指令僅在啟用資料夾備註時才會顯示Notebook Navigator: Delete files刪除選取的檔案。選擇目前資料夾中的下一個檔案
標籤作業
Notebook Navigator: Add tag to selected files對話框可為選取的檔案新增標籤。支援建立新標籤Notebook Navigator: Set property on selected files在選取的檔案上設定屬性的對話框Notebook Navigator: Remove tag from selected files移除特定標籤的對話框。如果只有一個標籤，會立即移除Notebook Navigator: Remove all tags from selected files從選取的檔案清除所有標籤並確認
維護
Notebook Navigator: Rebuild cache重建本機 Notebook Navigator 快取。如果您遇到標籤遺失、預覽不正確或功能圖片遺失的情況，請使用此功能。
8.1 指令 ID
| 指令 ID | 指令名稱 |
|---|---|
notebook-navigator:open |
筆記本導覽器：開啟 |
notebook-navigator:toggle-left-sidebar |
筆記本導覽器：切換左側邊欄 |
notebook-navigator:open-homepage |
筆記本導覽器：開啟首頁 |
notebook-navigator:select-profile |
Notebook Navigator：選取儲存庫設定檔 |
notebook-navigator:select-profile-1 |
Notebook Navigator：選取儲存庫設定檔 1 |
notebook-navigator:select-profile-2 |
筆記本導覽器：選取儲存庫設定檔 2 |
notebook-navigator:select-profile-3 |
筆記本導覽器：選取儲存庫設定檔 3 |
notebook-navigator:reveal-file |
筆記本導覽器：顯示檔案 |
notebook-navigator:open-all-files |
筆記本導覽器：開啟所有檔案 |
notebook-navigator:navigate-to-folder |
筆記本導覽器：導航至資料夾 |
notebook-navigator:navigate-to-tag |
筆記本導覽器：導航至標籤 |
notebook-navigator:navigate-to-property |
筆記本導覽器：導航至屬性 |
notebook-navigator:navigate-back |
筆記本導覽器：返回 |
notebook-navigator:navigate-forward |
筆記本導覽器：向前導覽 |
notebook-navigator:add-shortcut |
筆記本導覽器：新增至捷徑 |
notebook-navigator:open-shortcut-1 |
筆記本導覽器：開啟捷徑 1 |
notebook-navigator:open-shortcut-2 |
筆記本導覽器：開啟捷徑 2 |
notebook-navigator:open-shortcut-3 |
筆記本導覽器：開啟捷徑 3 |
notebook-navigator:open-shortcut-4 |
筆記本導覽器：開啟捷徑 4 |
notebook-navigator:open-shortcut-5 |
筆記本導覽程式：開啟捷徑 5 |
notebook-navigator:open-shortcut-6 |
筆記本導覽程式：開啟捷徑 6 |
notebook-navigator:open-shortcut-7 |
筆記本導覽器：開啟捷徑 7 |
notebook-navigator:open-shortcut-8 |
筆記本導覽器：開啟捷徑 8 |
notebook-navigator:open-shortcut-9 |
筆記本導覽程式：開啟捷徑 9 |
notebook-navigator:search |
筆記本導覽器：搜尋 |
notebook-navigator:search-vault |
筆記本導覽器：搜尋整個儲存庫 |
notebook-navigator:toggle-dual-pane |
筆記本導覽器：切換雙窗格佈局 |
notebook-navigator:toggle-dual-pane-orientation |
筆記本導覽器：切換雙窗格方向 |
notebook-navigator:toggle-calendar |
筆記本導覽器：切換日曆 |
notebook-navigator:open-daily-note |
筆記本導覽器：開啟每日筆記 |
notebook-navigator:open-weekly-note |
筆記本導覽器：開啟每週筆記 |
notebook-navigator:open-monthly-note |
筆記本導覽器：開啟每月筆記 |
notebook-navigator:open-quarterly-note |
筆記本導覽器：開啟季度筆記 |
notebook-navigator:open-yearly-note |
筆記本導覽：開啟年度筆記 |
notebook-navigator:toggle-descendants |
筆記本導覽：切換子項目 |
notebook-navigator:toggle-hidden |
筆記本導覽器：切換隱藏資料夾、標籤與筆記 |
notebook-navigator:toggle-tag-sort |
筆記本導覽器：切換標籤排序順序 |
notebook-navigator:toggle-tags-by-selection |
筆記本導覽器：根據選取項目切換標籤 |
notebook-navigator:toggle-properties-by-selection |
筆記本導覽器：根據選取項目切換屬性 |
notebook-navigator:toggle-compact-mode |
筆記本導覽器：切換緊湊模式 |
notebook-navigator:toggle-pinned-section |
筆記本導覽器：切換固定區塊 |
notebook-navigator:collapse-expand |
筆記本導覽器：收起／展開所有項目 |
notebook-navigator:collapse-expand-selected-item |
筆記本導覽器：收起／展開選取的項目 |
notebook-navigator:new-note |
筆記本導覽器：建立新筆記 |
notebook-navigator:new-note-from-template |
筆記本導覽器：根據範本建立新筆記 |
notebook-navigator:move-files |
筆記本導覽器：移動檔案 |
notebook-navigator:merge-notes |
筆記本導覽器：合併筆記 |
notebook-navigator:select-next-file |
筆記本導覽器：選取下一個檔案 |
notebook-navigator:select-previous-file |
筆記本導覽器：選取上一個檔案 |
notebook-navigator:convert-to-folder-note |
筆記本導覽器：轉換為資料夾筆記 |
notebook-navigator:set-as-folder-note |
筆記本導覽器：設定為資料夾筆記 |
notebook-navigator:detach-folder-note |
筆記本導覽器：解除資料夾筆記的關聯 |
notebook-navigator:pin-all-folder-notes |
筆記本導覽器：將所有資料夾筆記釘選 |
notebook-navigator:delete-files |
筆記本導覽器：刪除檔案 |
notebook-navigator:add-tag |
筆記本導覽器：為選取的檔案新增標籤 |
notebook-navigator:set-property |
筆記本導覽器：為選取的檔案設定屬性 |
notebook-navigator:remove-tag |
筆記本導覽器：從選取的檔案中移除標籤 |
notebook-navigator:remove-all-tags |
筆記本導覽器：從選取的檔案中移除所有標籤 |
notebook-navigator:rebuild-cache |
筆記本導覽器：重建快取 |
9 特性
9.1 個介面
- 雙窗格佈局 - 導覽窗格 (資料夾/標籤/屬性) 和清單窗格 (檔案)
- 單窗格模式- 導覽和清單檢視，具有動態轉換效果
- 可調整窗格- 水平或垂直分割方向
- 獨立 UI 縮放- 在不變更 Obsidian 縮放的情況下縮放筆記本導覽器
- 啟動檢視- 導覽先行或清單先行
- 多語言支援- 21種語言，支援 RTL 排版
- 介面圖示集- 可自訂整個外掛程式的使用者介面圖示
9.2 導航
- Vault 設定檔- 多重篩選檢視，每個設定檔都有隱藏資料夾/標籤/筆記、檔案可見性、橫幅和捷徑功能
- 捷徑— 筆記、資料夾、標籤、屬性及儲存的搜尋，並可進行釘選與重新排序
- 最近的筆記/檔案- 每個儲存庫設定檔儲存最近的項目部分，可選擇釘選捷徑
- 行事曆- 具備日期選擇、特徵圖片預覽和支援垂直分割功能的每日記事行事曆
- 資料夾樹狀結構- 展開/折疊導覽，可手動排列根資料夾次序
- 標籤樹- 可設定根標籤順序的層級標籤
- 屬性瀏覽器- 瀏覽以關鍵和值組織的檔案屬性，並提供檔案數量、自訂顏色、圖示，以及拖放功能
- 自動顯示使用中的檔案- 資料夾擴充與捲動選取
- 鍵盤與指令- 可設定的熱鍵、選擇歷程往後/往前指令、下一個/上一個檔案指令、開啟捷徑 1-9 指令
9.3 組織
- 釘住備註- 將重要的備註置於資料夾和標籤的頂端
- 資料夾備註- 設定/刪除資料夾備註、釘選資料夾備註、在新標籤開啟選項
- 標籤作業- 新增/移除/清除標籤、重新命名/刪除標籤、在標籤中建立備註、拖放標籤層次結構
- 自訂排序和群組- 覆寫每個資料夾或標籤的排序/群組設定
- 每個資料夾/標籤的外觀- 標題列、預覽列、精簡模式、後裔切換
- 隱藏內容- 隱藏資料夾/標籤/筆記/檔案，每個儲存庫設定檔具有模式、前置內容屬性和基於標籤的過濾功能
- 從子目錄中排除資料夾— 根據儲存庫設定檔，在從子資料夾收集筆記時省略這些資料夾；被排除的資料夾仍會顯示，且選取時會顯示其中的筆記
- 顏色和圖示系統- 資料夾/標籤/屬性/檔案顏色、圖示包、emoji/Lucide 圖示、frontmatter 讀/寫、依檔案名稱和檔案類型類別對應的圖示
- 命名警告- 在命名檔案和資料夾時，警告禁止使用的檔案系統字元以及會破壞 Obsidian 連結的字元
9.4 檔案顯示
- 筆記預覽- 1-5 行預覽，可選擇 HTML 剝離
- 縮圖— 精選圖片，以及儲存於元資料快取中的 PDF、SVG 和繪圖檔案所自動生成的縮圖
- 外部影像- 可選擇下載外部影像和 YouTube 縮圖
- 日期群組- 依日期排序時，依今日、昨天、前 7 天、前 30 天、月、年群組筆記
- frontmatter 支援- 從 frontmatter 欄位讀取備註名稱和時間戳記
- 備註元資料- 在檔案清單中顯示修改日期和標籤
- 自訂屬性- 在檔案清單中顯示 frontmatter 屬性或字數，並可按資料夾/標籤覆寫和自訂顏色
- 父資料夾顯示- 檔案清單中可選擇的父資料夾名稱和圖示
- 精簡模式- 當預覽、日期和影像關閉時，顯示精簡
- 可按一下的標籤- 檔案清單中的標籤可直接導覽到該標籤
9.5 生產力
- 搜尋- 使用 AND/OR/exclusions 依檔案名稱、標籤、屬性、日期、資料夾、副檔名及任務進行篩選
- Omnisearch 整合- 透過Omnisearch進行全文搜尋
- 拖放- 檔案移動、標籤、捷徑指派、標籤樹轉屬、彈出式資料夾
- 上下文功能表- 建立筆記/資料夾/畫布/底座/繪圖，並執行檔案/標籤動作
- 繪圖- 從導覽和列表窗格功能表建立 Excalidraw 和 Tldraw 繪圖
- 範本- 使用 Templater 外掛程式的範本指令新備註
- 檔案操作- 建立、重新命名、複製、移動、丟棄檔案和資料夾
- 過濾- 資料夾/標籤/筆記/檔案排除與模式和 frontmatter 屬性
10 網路與診斷披露
Notebook Navigator 在本機執行，但某些功能會從 Obsidian 提出 HTTP 請求。啟動除錯日誌也可以在您的儲存庫中寫入本機診斷檔案。
10.1 發行更新檢查（可選）
- 設定：「啟動時檢查新版本」
- 請求：
https://api.github.com/repos/johansan/notebook-navigator/releases/latest - 頻率：每 24 小時最多一次，在啟動時
- 資料：傳送標準 HTTP 元資料；不包括儲存庫內容
10.2 個圖示包下載（可選）
- 設定：在圖示包標籤中啟用圖示包
- 請求：
https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/...(清單、字型、元資料) - 儲存：本機儲存於 IndexedDB
10.3 外部圖片、影片及 YouTube 縮圖
- 功能影像（可選）：由「下載外部影像」設定控制。下載功能影像的遠端影像和 YouTube 縮圖，並儲存在本機的 IndexedDB 中。
- 歡迎模態（首次啟動）：從
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg載入靜態縮圖。 - What's new 模組 (更新時/開啟時)：從
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg載入包含橫幅的發行說明的發行橫幅圖片。 - 「最新消息」模態視窗（更新時／開啟時）：從
https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4載入發布影片，供包含影片的發布說明使用。 - 「最新消息」彈出視窗（開啟發行影片時）：開啟來自
https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4的發行影片，以便瀏覽器能直接播放影片。 - What's new 模組 (更新時/開啟時)：從
https://img.youtube.com/vi/<id>/...載入包含 YouTube 連結的發行說明的 YouTube 縮圖。
10.4 啟動除錯檔（可選）
- 設定：「啟動除錯日誌」
- 儲存：在儲存庫根目錄中寫入一個有時間戳記的
nn-debug-...md檔案，然後在啟動穩定後停止。如果儲存庫根目錄已同步，則檔案可能會同步。 - 資料：包括啟動時間、外掛版本、最低支援的 Obsidian 版本、平台、快取記憶體計數、佇列計數、IndexedDB 狀態和診斷錯誤。它不包括筆記內容、標籤名稱、frontmatter 值或儲存庫檔案清單。
- 路徑和識別碼：啟動初始化、PDF 診斷和錯誤案例可包括 Obsidian 應用程式/儲存庫的識別碼、儲存庫相關的 PDF 路徑或錯誤堆疊詳細資料。在公開分享檔案前，請先審閱並刪除。
- 上傳：Notebook Navigator 不會上傳除錯檔案。只有當您在外掛程式外上傳、附加或同步這些檔案時，它們才會被分享。
10.5 隱私權與資料處理
- Notebook Navigator 不會將筆記內容、檔案名稱、標籤或除錯檔案傳送至 Notebook Navigator 伺服器。
- 對 GitHub、YouTube 及任何外部影像主機的請求都是直接從您的裝置提出，並包含標準 HTTP 元資料 (IP 位址、使用者代理程式及類似資料)。
- 下載的圖示套件和圖片會儲存在本機 (IndexedDB) 中。最近的筆記/檔案和 UI 狀態會儲存在本機 (Obsidian 本機儲存)。
11 星級歷史
12 接觸
Notebook Navigator 由Johan Sanneblad 建立並維護。Johan 擁有軟體開發博士學位，並曾為 Apple、Electronic Arts、Google、Microsoft、Lego、SKF、Volvo Cars、Volvo Group 和 Yamaha 等公司從事創新開發工作。
歡迎在LinkedIn 上與我聯繫。
13 問題或事項？
加入我們的 Discord尋求支援與討論，或在GitHub 套件庫中開啟問題。
不接受拉取請求。隨著「代理式編碼」（agentic coding）的興起，外部提交的程式碼無法按照本專案所維持的標準進行品質控管，因此任何拉取請求都會被自動關閉。請改以功能請求的形式提出構想——請開啟一個問題。詳情請參閱CONTRIBUTING.md。
14 許可證
本專案採用 GNU General Public License v3.0 授權 - 詳細資訊請參閱LICENSE檔案。