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 应用、GitHub、浏览器以及没装插件的 Obsidian 中都能用。卸载插件，什么都不会坏。
- 随时可以反悔：Bring files back 会把文件下载回仓库，并把链接改回普通的附件链接。
全部功能
插件使用和 Aktar 应用相同的上传目标、路径模板和规则，所以从 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 应用配合
在装有 Aktar 的 Mac 或 PC 上，一键把插件和应用配对。之后上传都经由 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 应用添加
- 在 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。它的上传目标会出现在插件中，上传都经由应用完成。
命令
所有操作都在命令面板中，所以你可以在 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 应用配对时，Obsidian 根本看不到密钥。
它会连接哪里
只连接你添加的上传目标的存储端点和公开 URL；在桌面端，如果你与 Aktar 应用配对，还会连接 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 应用、网页上以及没装 Aktar 的 Obsidian 中都能显示图片。只有私有存储桶中的文件需要插件，因为它们需要签名 URL。
仓库里的文件会怎样？
文件移走后，本地副本会移到 Obsidian 的回收站；如果你选择 Keep it in the vault too，则会保留。没有笔记链接的文件，以及从 front matter、代码或白板中链接的文件，都留在原处。
还能改回去吗？
能。可以撤销上一次移动，把单篇笔记的文件拿回来，或从链接菜单中逐个拿回文件。文件会从你的存储桶下载下来，链接也会重新变成普通的附件链接。
能和 Obsidian Sync、iCloud 或 Git 一起用吗？
能。它不会取代你的同步方式，而是让要同步的内容变小。两台设备移动同一个文件时，会写入同一个对象和同一个链接，所以不会互相冲突。
要花多少钱？
插件免费开源。你只需为存储的内容向存储服务商付费；使用 Cloudflare R2 时，下载不收费。