极载AI知识库 × Obsidian
打通同步操作手册
通过 WebDAV 把极载AI平台的 Wiki 目录与本地 Obsidian 知识库双向同步：平台 agent 写的笔记实时出现在本地，本地编辑也会自动回传。全程约 10 分钟，只需配置一次。
00同步原理：先看懂这张图
整个链路只涉及三方：极载AI平台（云端 Wiki）、WebDAV 服务（同步通道）、Obsidian（本地知识库）。
agent 写的笔记
地址 + API Key 鉴权
双向搬运
随时编辑
双向同步：云端 → 本地拉取，本地 → 云端回传
/极载知识库），只在这一个目录内来回同步，放心使用。- 云端有什么：平台 agent 产出的 Wiki 笔记（如
OVERVIEW.md/INSIGHTS.md），实时写入云端Wiki/目录根层——它在你的库专属文件夹外面一层，是否同步进本地取决于第 05 步「远程磁盘文件夹」的设置（见 5.3）； - 本地会得到什么：同步范围内的云端笔记自动出现在你的 Obsidian 库里，可直接阅读、搜索、双链引用；
- 本地改了会怎样：在 Obsidian 里编辑的内容会回传云端，形成闭环。
01平台侧：生成 WebDAV 地址与 API Key
先在极载AI平台拿到两样东西：WebDAV 地址（服务器地址）和 API Key（密码）。这一步只需做一次。
1.1 找到「Obsidian 同步（Wiki）」卡片
打开极载AI平台，进入知识库设置区域，找到「Obsidian 同步（Wiki）」卡片。卡片上会显示：
- WebDAV 地址——点击右侧「复制」按钮复制保存；
- 下方列出了 4 步简明指引（生成 Key → 装插件 → 填参数 → 点同步）。
1.2 生成并保存 API Key
点击卡片里的「生成 API Key」按钮。生成后 Key 会显示在列表中。
1.3 Key 的管理规则
| 规则 | 说明 |
|---|---|
| 权限范围 | 每个 Key 都能访问该账号的 Wiki 目录 |
| 泄露处理 | 立即点击该 Key 右侧的「吊销」，使其失效，再生成新 Key |
| 丢失处理 | 吊销旧 Key → 重新生成 → 到 Obsidian 插件里把「密码」替换为新 Key |
02准备 Obsidian 并检查版本
如果你已装好 Obsidian 并能正常使用，可快速核对版本后跳到第 03 步。
- 已从官网下载并安装 Obsidian 桌面版，并创建/打开了一个本地知识库（Vault）；
- 界面语言设为「简体中文」：设置 → 关于 → 语言（本手册截图均为中文界面）；
- 版本在「关于」页可见，建议保持较新版本（本手册参考版本 1.14.4）。
Ctrl + ,。后续所有设置项都在这个窗口里完成。03开启第三方插件（社区插件）
Remotely Save 是社区插件，需要在「第三方插件」页确认安全模式已关闭，才能从插件市场安装。
- 打开 设置 → 第三方插件；
- 查看「安全模式」状态：如果按钮显示「开启」，说明安全模式已经是关闭状态，无需操作；
- 点击「社区插件市场」右侧的「浏览」按钮，打开插件市场。
04安装 Remotely Save 插件
在插件市场搜索「Remotely Save」，认准作者和下载量，安装并启用。
4.1 搜索插件
在市场顶部搜索框输入 Remotely Save，结果中第一个就是目标插件。
4.2 核对插件信息
点击进入插件详情页，核对以下信息后再安装：
| 核对项 | 本手册参考值 |
|---|---|
| 插件名 | Remotely Save |
| 作者 | fyears |
| 下载量 | 约 230 万（2.3M） |
| 支持的服务 | S3 / Dropbox / webdav / OneDrive / Google Drive / Box / pCloud / Yandex Disk / Koofr / Azure Blob 等 |
4.3 点击安装
在详情页点击「安装」。安装完成后按钮会变为「启用」，保持插件开关为打开状态。
05配置 WebDAV 连接参数
核心一步：把第 01 步拿到的地址和 Key 填进插件。填错一个字符都会导致连接失败，建议直接复制粘贴。
5.1 打开插件设置
路径一：设置 → 第三方插件 → 已安装插件 → Remotely Save → 「选项」；
路径二：设置窗口左侧列表直接点「Remotely Save」。
5.2 选择远程服务类型
在「选择远程服务」下拉框中选择 Webdav。选择后下方会出现「Webdav 设置」区域。
5.3 逐项填写参数
| 设置项 | 填写内容 | 说明 |
|---|---|---|
| 服务器地址 | 平台复制的 WebDAV 地址 | 以平台「Obsidian 同步（Wiki）」卡片上显示的地址为准，直接复制粘贴 |
| 用户名 | 随意填写 | 建议填你的邮箱，方便识别即可 |
| 密码 | API Key | 填第 01 步生成并保存的 Key（不是平台登录密码） |
| 鉴权类型 | basic | 保持默认即可 |
| Depth header | 只支持 depth="1" | 不确定服务端行为时选此项最稳妥 |
| 自定义 Header | 留空 | 不知道是什么就不用填 |
| 修改远程磁盘文件夹（实验性质） | 极载知识库 | 默认值为你的库名——插件在 Wiki/ 下建同名子目录，只同步这一个文件夹，多库共存互不干扰。想让平台 Wiki 更新产出的笔记（写在 Wiki/ 根层）也同步下来，就把这里清空，让整个 Wiki/ 目录与你的库双向同步；代价是库文件直接铺在 Wiki/ 根层、不再隔离 |
https://www.aiijiz.com/v）。请以你平台卡片上的地址为准，复制粘贴，避免手误。06检查连接是否成功
填完参数先别急着同步，用插件自带的检测功能验证一次。
- 在 Webdav 设置区往下找到「检查可否连接」；
- 点击右侧「检查」按钮；
- 等待几秒，观察右上角弹出的提示。
07基础设置：自动同步节奏
连接打通后，建议按下面的推荐值配置自动同步，做到「改完自动传，无需手动管」。
| 设置项 | 推荐值 | 作用 |
|---|---|---|
| 自动运行 | 每 5 分钟 | 每隔一段时间自动同步一次（会略微影响耗电） |
| 启动后自动运行一次 | 启动后第 30 秒运行一次 | 打开 Obsidian 后自动触发首轮同步 |
| 保存时同步（实验性质） | 开启 | 文件有修改保存时就尝试同步，接近实时（会略增耗电，改后可能需重启插件或软件） |
| 跳过大文件 | 200 MB | 超过阈值的文件不参与同步，防止误传大附件 |
| 在状态栏显示上一次成功的同步 | 开启 | 左下角状态栏常显上次同步时间，一眼确认状态 |
| 密码（端到端加密） | 可选，留空即无密码 | 设置后为云端文件加密；注意：密码及其它信息都会在本地保存，修改密码后需手动删除远程所有文件再重新同步 |
08进阶设置：冲突与删除策略
这些项保持默认即可稳定运行；理解每项的含义，出问题时才知道去哪调。
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| 并行度 | 5（默认） | 同时上传/下载的文件数上限；遇频控或报错可调低 |
| 同步 _ 文件或文件夹 | 关闭 | 是否同步下划线「_」开头的文件或文件夹 |
| 同步配置文件夹（实验性质） | 关闭 | 同步 .obsidian 配置（插件设置等）；开启会改动所有插件设置、可能需重启 Obsidian，风险自担，不建议开 |
| 同步书签（实验性质） | 关闭 | 是否同步 .obsidian/bookmarks.json；已开启配置文件夹同步时此项被忽略 |
| 删除文件到哪里 | 系统回收站（默认） | 删除操作先进回收站，可反悔，强烈建议保持默认 |
| 处理冲突 | 保留最后修改的版本（默认） | 本地与云端同一文件都被改动时，以最后修改为准（仅双向同步生效） |
| 删除智能处理冲突生成的重复文件 | 需要时「开始扫描」 | 确认重复文件都不要了，可一键清理本地重复项 |
09开始同步与日常使用
一切就绪，跑第一次同步。
9.1 触发同步的三种方式
- 手动：点击左侧边栏的同步按钮（循环箭头图标），或使用命令面板执行同步命令；
- 自动：第 07 步配置的定时/保存触发会自动执行；
- 首次建议手动跑一次：确认方向和内容无误后再交给自动。
9.2 首次同步会发生什么
- 插件在服务器上创建/识别专属文件夹（如
/极载知识库）； - 云端同步范围内（你的库专属文件夹；若 5.3 留空则为整个 Wiki/ 目录）的文件被拉取到本地库中；
- 本地已有的 Wiki 范围内文件被回传云端；
- 左下角状态栏显示「上一次成功的同步」时间。
9.3 日常使用建议
- 正常情况下无需任何操作——5 分钟定时 + 保存即同步已经覆盖绝大多数场景；
- 重要修改后想立刻上云：手动点一次同步按钮；
- 同步范围仅限 Wiki 目录，其他文件夹不会被上传，隐私文件放心放库里。
10插件管理与卸载
在「第三方插件 → 已安装插件」里，点击 Remotely Save 右侧的「⋮」菜单可进行管理。
| 操作 | 入口 |
|---|---|
| 检查插件更新 | 第三方插件页 →「插件安装情况」→ 检查更新；或开启「自动检查插件更新」 |
| 进入同步设置 | 插件行「⋮」→ 设置（即第 05-08 步的配置页） |
| 临时停用 | 插件行右侧的开关关闭即可，配置会保留 |
| 彻底卸载 | 「⋮」→ 卸载（仅移除插件，云端与本地文件不受影响） |
11常见问题排查（FAQ）
点击问题展开排查步骤。
「检查」连接时报错，连不上服务器？
按顺序核对：① 服务器地址是否完整（从平台复制粘贴，别手敲）；② 密码栏填的是 API Key，不是平台登录密码；③ 该 Key 是否已被吊销——回平台查看 Key 列表，失效就重新生成并更新到插件；④ 网络/代理是否拦截了该域名。修正后重新点「检查」。
API Key 忘了保存 / 找不到了怎么办？
Key 只在生成时完整显示一次，列表里只展示前缀。处理办法：回平台「吊销」旧 Key → 点「生成 API Key」→ 立即复制保存 → 到 Obsidian 插件的「密码」栏替换为新 Key → 重新检查连接。
两台设备同时编辑，出现冲突文件？
插件默认策略是「保留最后修改的版本」，落败版本可能以重复文件形式留下。可在进阶设置用「删除智能处理冲突生成的重复文件 → 开始扫描」清理。日常预防：切换设备前先同步一次，避免并行编辑同一篇笔记。
某个大文件/附件一直没被同步？
检查「跳过大文件」阈值（默认 200 MB），超过阈值的文件会被跳过。确需同步时可调大阈值；一般建议保持 200 MB，避免误传视频等大附件拖慢同步。
换了台电脑，如何在新设备上继续用？
新设备安装 Obsidian → 安装并启用 Remotely Save → 按第 05 步填入同一个 WebDAV 地址和 API Key → 检查连接 → 手动同步一次，云端 Wiki 目录的笔记会自动拉到本地。API Key 可多设备共用；若怀疑泄露，统一吊销换新 Key 并在各设备更新。
我想把插件设置、主题等配置也同步，可以吗？
可以但不建议：进阶设置里「同步配置文件夹（实验性质）」会同步 .obsidian 目录（含全部插件设置），官方提示这可能影响 Obsidian 及所有插件设置，且可能需要重启软件，风险自担。只同步笔记内容时保持关闭最稳。
我的笔记数据安全吗？存在哪里？
数据存放在极载AI平台的服务器上，且同步范围仅限 Wiki 专属目录，库里其他文件夹不会上传。如需更强保护，可在插件「基本设置」里配置端到端加密密码（注意：设置密码后需删除远程文件重新同步一次才能生效，且密码务必牢记）。API Key 一旦疑似泄露，立即回平台吊销。
如何确认刚才那次同步成功了？
两个信号：① 左下角状态栏显示的「上一次成功的同步」时间已更新（需开启第 07 步对应开关）；② 同步过程中出现的进度通知正常走完、无红色报错。需要重置时间记录可点基本设置里的「重设」。
动手配置前，有什么安全提醒？
① 先备份：首次使用同步类插件前，先复制一份整个知识库文件夹作为备份（这也是插件详情页的官方告诫）；② 删除策略保持「系统回收站」，给误删留后路；③ 不要把 API Key 发给他人或截图外传，截图注意打码。