Obsidian 外掛程式
Obsidian 版 Aktar
讓筆記保持輕巧，把附件放在你自己的 S3、Cloudflare R2、Backblaze B2、DigitalOcean Spaces 或 MinIO 儲存貯體。貼上或拖入檔案，它就會上傳到儲存貯體；已有的附件也能移過去。每個連結都是一般的 https:// URL，有沒有安裝外掛程式都能用。
免費且開放原始碼。支援桌面版、iPhone、iPad 和 Android，需要 Obsidian 1.11.4 或以上版本。
一般連結，不被綁住
Aktar 會把嵌入改寫成指向儲存貯體 URL 的標準 Markdown 圖片。尺寸和說明文字都會保留，筆記的樣子也不變。
![[IMG_2041.png|300]]- 筆記只有幾 KB，同步方式照舊，不論你用 Obsidian Sync、iCloud、Git 還是其他工具。
- 連結在任何 Markdown App、GitHub、瀏覽器，以及沒有安裝外掛程式的 Obsidian 中都能用。解除安裝，什麼都不會壞。
- 隨時可以改變主意：Bring files back 會把檔案下載回儲存庫，並把連結改回一般的附件連結。
所有功能
外掛程式使用和 Aktar App 相同的目的地、路徑範本和規則，所以從 Obsidian 上傳的檔案，會和從 Mac 或手機上傳的檔案放在同一個地方。
-
貼上與拖入
貼上或拖入的檔案會立刻以預留位置出現在筆記中，上傳完成後變成連結。你可以決定貼上或拖入時哪些內容要上傳到儲存貯體：圖片、所有檔案或都不上傳，也能為新的圖片嵌入設定預設寬度。
-
移動現有附件
移動一則筆記或整個儲存庫的附件。在真正動手之前，試執行會列出每個檔案以及每則會變動的筆記。Front matter、程式碼區塊和白板中的連結不會被更動，它們的檔案也不會。本機副本會移到垃圾桶，你也可以選擇保留。
-
任何移動都能復原
Undo the last move to the bucket 會把檔案下載回儲存庫，並把每個連結恢復原狀。
-
把檔案拿回來
把一則筆記的檔案從儲存貯體下載回儲存庫。連結會變回一般的附件連結，寫法依照你的 Obsidian 連結設定：Wiki 連結或 Markdown，最短路徑或相對路徑。
-
自動移動新附件
在手機上加入的照片，或其他外掛程式存進儲存庫的檔案，只要被筆記嵌入，就會移到儲存貯體。沒有筆記連結的檔案會留在原處。如果需要，可以只套用到一個資料夾。
-
私有儲存貯體
筆記保留一般連結，外掛程式則透過在你裝置上簽署、有效期一小時的 URL 顯示檔案。沒有你的金鑰，誰都打不開。
-
檔案庫
側邊欄中的面板有三種檢視：筆記用到哪些儲存貯體檔案、用在哪裡，儲存貯體的資料夾和檔案，以及上傳佇列。找出不再有任何筆記連結的檔案，確認後一次刪除。
-
連結操作
在連結上按右鍵即可拷貝，拷貝有效期為 1 小時、1 天或 7 天的連結，打開它，把檔案拿回儲存庫，或從儲存貯體刪除。刪除前，它會告訴你哪些筆記連結了這個檔案。
-
更小的照片
上傳前把照片轉換成 WebP，在相同畫質下大約只有 JPEG 的三分之一大小，還能縮小到 3840、2560、1920、1280 或 1024 像素。GIF 和 SVG 不會被更動。在無法產生 WebP 的裝置上（iPhone、iPad），照片會轉成 JPEG。
-
照片不帶位置
照片離開裝置之前，拍攝地點會被移除。圖片本身不受影響。
-
離線也能用
看過的圖片會保存在裝置上，容量上限由你決定，沒有網路時筆記也能顯示。上傳會在佇列中等待，離線或重新啟動 Obsidian 都不會遺失，網路恢復後自動上傳。
-
與 Aktar App 搭配
在裝有 Aktar 的 Mac 或 PC 上，一鍵將外掛程式與 App 配對。之後的上傳都會透過 Aktar 完成，使用它的目的地、金鑰、歷史記錄和掛鉤，Obsidian 永遠看不到金鑰。
-
發布筆記
把筆記連同圖片變成儲存貯體中的網頁，連結會自動拷貝。可以選擇永久連結，或 7 天內有效的連結（私有儲存貯體一律為 7 天）。網頁無法執行指令碼，Take down 可以將它移除。
-
儲存庫備份
每天或每週把整個儲存庫壓縮成 zip 上傳到你的儲存貯體，檔名無法被猜到，並保留最新的 3、7、14 或 30 份。只要在最常開機的那部裝置上開啟即可。Obsidian 的設定資料夾預設不會包含在內，除非你選擇包含，因為其他外掛程式可能在裡面保存密碼。
-
你自己的資料夾結構
預設情況下，每個儲存庫在儲存貯體中都有自己的資料夾：
obsidian/{vault}/{year}/{month}/{short}.{ext}。可以使用筆記的名稱或資料夾、日期、原始檔名或短代碼。移動的檔案名稱只取決於檔案本身，所以兩部同步的裝置移動同一個檔案時，會寫入同一個物件，得到相同的連結。 -
每部裝置都能用
同一個外掛程式可以在 Mac、Windows 和 Linux 上執行，也能在 iPhone、iPad 和 Android 版 Obsidian 中執行。目的地會隨儲存庫同步，金鑰則不會；每部裝置用轉移碼取得一次金鑰即可。
開始設定
從 Obsidian 的社群外掛程式（Settings › Community plugins › Browse）安裝 Aktar 並啟用。然後用以下三種方式之一加入目的地。
從 Aktar App 加入
- 在 Mac、PC、iPhone 或 Android 手機上的 Aktar 中，打開一個目的地並選擇分享到其他裝置。拷貝轉移連結。
- 在 Obsidian 中打開 Settings › Aktar › Add from Aktar app。連結會從剪貼簿自動填入。
- 輸入 Aktar 顯示的 12 字元轉移碼。金鑰會加密後一併帶過來，目的地就可以使用了。
與這台電腦上的 Aktar 配對
- 安裝 Mac 版 Aktar 0.19 或 Windows 版 Aktar 0.12 或以上版本，並在其中加入一個目的地。
- 在 Obsidian 中打開 Settings › Aktar › Aktar app，按一下 Connect。
- 在 Aktar 顯示的對話框中按一下 Connect。它的目的地會出現在外掛程式中，上傳都會透過 App 完成。
指令
所有操作都在命令選擇器中，所以你可以在 Settings › Hotkeys 為它們設定快速鍵。最常用的幾個也在編輯器的右鍵選單裡。
- Upload a file into this note
- 選擇一個檔案，上傳並插入到筆記的游標位置。
- Move this note’s attachments to the bucket
- 試執行後，移動目前筆記的附件。
- Move attachments to the bucket…
- 試執行後，移動整個儲存庫或某個資料夾中的附件。
- Bring this note’s files back into the vault
- 把目前筆記的儲存貯體檔案下載到儲存庫，並把連結改成附件連結。
- Undo the last move to the bucket
- 復原上一次移動：檔案回來，連結恢復原狀。
- Open the library
- 在側邊欄中打開檔案庫。
- Publish this note as a web page
- 把目前筆記變成儲存貯體中的網頁，並拷貝它的連結。
- Take down this note’s web page
- 從儲存貯體移除目前筆記的網頁。
- Back up the vault now
- 不管排程如何，立即把儲存庫壓縮上傳到儲存貯體。
- Retry uploads
- 重新嘗試正在等待的上傳。
- Save failed uploads into the vault instead
- 把一直失敗的上傳儲存到儲存庫中，什麼都不會遺失。
- Add a destination from an Aktar app
- 用轉移連結和轉移碼加入目的地。
金鑰留在裝置上
目的地儲存在外掛程式的設定中，會隨儲存庫同步。金鑰永遠不會放在那裡。它們保存在每部裝置上 Obsidian 的機密儲存空間中，不會同步，所以你分享出去或放進 Git 的儲存庫不帶任何金鑰。
如果某部裝置有目的地卻沒有它的金鑰，外掛程式會告訴你，並請你輸入轉移碼。與 Aktar App 配對時，Obsidian 完全看不到金鑰。
它會連線到哪裡
只連線到你加入的目的地的儲存端點和公開 URL；在桌面版上，如果你與 Aktar App 配對，還會連線到 127.0.0.1 上的 Aktar。中間沒有 Aktar 伺服器，不需要帳號，沒有分析，也沒有遙測。
它會列出儲存庫中的檔案，以便知道哪些筆記連結了哪個檔案，只有你上傳、移動或備份的檔案才會進入你的儲存貯體。它只在你打開 Add from Aktar app 時讀取一次剪貼簿，用來填入轉移連結。
系統需求
- Mac、Windows、Linux、iPhone、iPad 或 Android 上的 Obsidian 1.11.4 或以上版本
- Amazon S3、Cloudflare R2、Backblaze B2、DigitalOcean Spaces、MinIO 或其他 S3 相容服務上的儲存貯體，可以有公開 URL，也可以保持私有
- 選用：Mac 版 Aktar 0.19 或 Windows 版 Aktar 0.12 或以上版本，用於一鍵配對
常見問題
沒有外掛程式，我的筆記還能正常顯示嗎？
可以。每個連結都是指向你儲存貯體的一般 Markdown 連結，所以筆記在任何 Markdown App、網頁上，以及沒有 Aktar 的 Obsidian 中都能顯示圖片。只有私有儲存貯體中的檔案需要外掛程式，因為它們需要簽署過的 URL。
儲存庫裡的檔案會怎樣？
檔案移走後，本機副本會移到 Obsidian 的垃圾桶；如果你選擇 Keep it in the vault too，則會保留。沒有筆記連結的檔案，以及從 front matter、程式碼或白板中連結的檔案，都會留在原處。
可以改回去嗎？
可以。你可以復原上一次移動，把單則筆記的檔案拿回來，或從連結選單逐一拿回檔案。檔案會從你的儲存貯體下載下來，連結也會重新變成一般的附件連結。
能和 Obsidian Sync、iCloud 或 Git 一起用嗎？
可以。它不會取代你的同步方式，而是讓要同步的內容變小。兩部裝置移動同一個檔案時，會寫入同一個物件和同一個連結，所以不會互相衝突。
要花多少錢？
外掛程式免費且開放原始碼。你只需為儲存的內容付費給儲存服務商；使用 Cloudflare R2 時，下載不收費。