Obsidian 插件下载与安装 - 安网笔记同步

把 note.anwang.cn 队列里的内容同步进你的 Obsidian 笔记库：frontmatter 模板、按类型分目录、图片下载到本地、一天一文件/一篇一文件两种模式、自动同步。

安装步骤

下载 zip 并解压，得到 manifest.json 与 main.js 两个文件。
在你的 Obsidian 库里打开文件夹 .obsidian/plugins/（没有就新建 plugins 文件夹）。
新建文件夹 anwang-note-sync，把两个文件放进去。
重启 Obsidian → 设置 → 第三方插件 → 刷新列表 → 启用「安网笔记同步」。

配置与首次同步

插件设置里：服务端地址保持 https://note.anwang.cn，粘贴上面的通道密钥。
点「测试连接」，提示「待拉取 N 条」即绑定成功。
打开推送页发一条链接或文本，回到 Obsidian 点左侧同步图标（或命令面板执行「立即同步」）。
默认落库位置：Inbox/<类型>/日期-标题.md，可在设置里改。

设置项速查

设置	说明
默认保存目录 / 按类型分目录	见路径配置教程
笔记属性模板	支持 {{title}} {{url}} {{type}} {{date}} 等变量，见变量指南；可用在线生成器
图片模式	下载到本地 / 保留链接 / 不加载，见图片本地化教程
消息模式	一篇一个文件 / 一天一个文件，见合并模式说明
自动同步	按间隔后台拉取，开着 Obsidian 即可
失败策略	某条写入失败时：原始内容完整记录到 `<默认目录>/_同步失败记录.md`（含失败原因与图片地址），然后从队列丢弃，不无限重试

开发者接入

插件与服务端之间是三个简单接口，任何工具都能往你的库里推内容：

POST /api/v1/push   {"url":"https://...","note":"备注","tags":["标签"]}   # 推链接（服务端抓取正文）
POST /api/v1/push   {"text":"一段文字","title":"标题"}                    # 推文本
GET  /api/v1/pull   # 插件拉取待同步内容
POST /api/v1/ack    {"ids":[1,2]}   # 确认已写入，出队
请求头：Authorization: Bearer <通道密钥>

Obsidian 插件：下载与安装

安装步骤

配置与首次同步

设置项速查

开发者接入