K-Tech Vault Atlas は、フォルダと HUB（MOC）の地図をスキャンして、足りないところをパネルで直すプラグインです。ノートが増えて迷子になった人にも、まだ使い方に自信がない人にも、「どこから辿ればよいか」を先に見えるようにするために作りました。
K-Tech Vault Atlas scans folder and hub (MOC) layout, then lets you fix gaps from one panel. It is for people whose notes piled up, and for people who still find the vault hard to navigate — so the next step is visible before you reorganize.
設定 → Community plugins → Browse で「K-Tech Vault Atlas」を検索。ID は k-tech-vault-atlas。
Settings → Community plugins → Browse, then search “K-Tech Vault Atlas”. ID: k-tech-vault-atlas.
入口、すでにある HUB、まだ無い HUB、触ってほしくないフォルダを、先に一覧にします。
It lists the entry, hubs you already have, hubs still missing, and folders you do not want touched — first.
画像は画面の構成を示すものです。お使いのテーマやモードで、実際の表示は変わります。
These images show layout, not a pixel-perfect screenshot. The actual screen depends on your theme and light or dark mode.
フォルダは増えたのに、親 HUB から辿れない。入口ノートはあるのに、新しい HUB がリンクされていない。そういう「地図の穴」をスキャンで出します。整理の途中で全部を動かさなくてよいです。
Folders multiplied, but parent hubs do not list the children. The startup note exists, yet new hubs are not linked. Atlas lists those gaps. You do not have to move the whole vault first.
MOC や HUB の作り方が曖昧でも、トグル ON でテンプレから HUB を作れます。OFF はゴミ箱へ移してフォルダを保留するだけです。手書きの地図は Deep Scan で守れます。
If hub (MOC) notes still feel unclear, turn a toggle ON to create one from a template. OFF moves it to trash and defers the folder. Hand-written maps can be locked in Deep Scan.
パネルが開くと、まず通常スキャンが走ります。入口ノート、既存 HUB、推奨、リンク不足、記載ギャップ、保留が一覧になります。
The panel runs a quick scan first. You get the entry note, existing hubs, recommendations, link gaps, hub list gaps, and deferred folders.
ON で HUB 作成（確認あり）。OFF でゴミ箱へ（確認あり）。入口・external・保護中は消えません。親リンクと入口リンク、HUB の未記載はボタンで追記できます。
ON creates a hub (with confirm). OFF sends it to trash (with confirm). Entry notes, external hubs, and protected hubs stay. Parent links, entry links, and missing hub list items can be appended after confirm.
手書き HUB の保護と、Inbox / Daily / 設定フォルダなどの除外候補を確認します。Folder Guide は空フォルダや命名のゆれを報告するだけで、自動では動かしません。
Protect hand-written hubs and review exclude suggestions (Inbox, Daily, config folder). Folder Guide only reports empty folders and naming drift. It does not move files.
画像は画面の構成を示すものです。お使いのテーマやモードで、実際の表示は変わります。
These images show layout, not a pixel-perfect screenshot. The actual screen depends on your theme and light or dark mode.
入口の有無、HUB の件数、推奨フォルダ、親 HUB からの未リンク、入口から未リンクの HUB、フォルダ直下の未記載、保留中のフォルダを一度に出します。Vault の外には何も送りません。
It lists whether the entry exists, hub counts, recommended folders, missing parent links, hubs not linked from the entry, notes missing from a hub list, and deferred folders. Nothing leaves the vault.
推奨行のトグルを ON にすると、フォルダ名に合わせたテンプレで HUB ノートを作ります。OFF にすると HUB をゴミ箱へ移し、そのフォルダは保留リストに入ります。ノートが増えたら「再検討」に戻します。確認ダイアログを挟みます。
Turn a recommendation ON to create a hub from a template named after the folder. Turn OFF to trash the hub and defer the folder. If note count grows, it comes back for review. A confirm dialog sits in between.
子 HUB があるのに親の本文に無い、入口から辿れない、という穴を出します。wikilink を追記するだけで、フォルダの移動はしません。
It finds child hubs missing from the parent note, and hubs missing from the entry. It only appends wikilinks. It does not move folders.
入口ノート、frontmatter の hub-managed: external、Deep Scan で付けた保護は削除できません。Inbox や Daily、設定フォルダは除外候補として出します。フォルダ構成を大きく変えたときだけ走らせれば十分です。
The entry note, hub-managed: external, and Deep Scan protection cannot be deleted. Inbox, Daily, and the vault config folder show up as exclude suggestions. Run this when the layout actually changed.
空フォルダ、ノートが無くサブフォルダだけの場所、名前が近いフォルダを報告します。自動ではリネームも移動もしません。人が見てから決めます。
It reports empty folders, folders that only contain subfolders, and near-duplicate names. It never renames or moves them. You decide.
通常スキャンで、フォルダ直下のノートが HUB に書いてあるかを見ます。未記載は確認したあと、その HUB だけ追記できます。本文からの削除はしません。手書きや Dataview の HUB は追記しません。
A quick scan checks whether notes in a folder are listed in that folder's hub. You can append missing notes to one hub at a time after confirm. Atlas never deletes hub body lines. Hand-written and Dataview hubs are not rewritten.
Homepage プラグインが入っていれば、起動ノート（kind: File）を Atlas の入口にできます。Homepage の設定は読み取るだけで、書き換えません。解決できないときは手動パス（既定 Home.md）に戻します。無ければ作成できます。
If the Homepage plugin is enabled, Atlas can use its startup note (kind: File) as the entry. It only reads Homepage settings. If that fails, it falls back to the manual path (default Home.md), which you can create.
スキャン結果を Markdown にして、設定したフォルダ（既定 90 System/Vault Atlas/）へ保存できます。クリップボードへコピーもできます。除外ルールは Vault Profile として端末内の data.json に残ります。
Export the scan as Markdown into a folder you choose (default 90 System/Vault Atlas/), or copy it. Exclude rules stay in local data.json as the Vault Profile.
フォルダの一括移動やリネームはしません。
It does not bulk-move or rename folders.
スキャンは端末内だけです。Buy Me a Coffee は押したときだけブラウザが開きます。
Scans stay on the device. Buy Me a Coffee opens in the browser only if you click it.
ロックされた HUB はトグル OFF できません。
Locked hubs cannot be toggled off.
フォルダの目次ノートです。frontmatter の type: hub（設定で変更可）で判定します。いわゆる MOC と同じ役割です。
A contents note for a folder. Detected by frontmatter type: hub (configurable). Same role as an MOC.
HUB を OFF にしたときだけ、その HUB ファイルをゴミ箱へ移します。確認があります。通常のメモは対象外です。最終的な削除は Obsidian の「削除したファイル」設定に従います。
Only when you turn a hub OFF, that hub file goes to trash, after confirm. Ordinary notes are not targeted. Final delete follows Obsidian’s “Deleted files” setting.
しません。記載ギャップは通常スキャンで出します。未記載の追記は、確認したあと 1 件ずつです。本文にあるリンクは消しません。手書き（ロック）と Dataview の HUB は追記しません。
No. Hub list gaps show up on a quick scan. Missing notes are appended one hub at a time after confirm. Existing hub body lines are not deleted. Locked and Dataview hubs are not rewritten.
不要です。スキャンはローカル Vault だけを見ます。
No. The scan only looks at the local vault.
Obsidian の Community plugins から「K-Tech Vault Atlas」を検索して Install → Enable です。手動のときは GitHub Release の main.js / manifest.json / styles.css をプラグインフォルダへ置きます。
Search “K-Tech Vault Atlas” in Community plugins, then Install and Enable. You can also drop main.js, manifest.json, and styles.css from the GitHub Release into the plugin folder.
1.8.7 以降です。
1.8.7 or later.
K-Tech Vault Atlas は無料・MIT ライセンスです。役に立ったら、コーヒー1杯分の応援が今後の更新の励みになります（任意です）。
K-Tech Vault Atlas is free and MIT licensed. If it helps, a coffee keeps the updates coming (optional).
