Trove AI Sync — Obsidian Plugin

把 Trove AI 知识库的文章一次性同步到你的 Obsidian vault。

一次性快照 (One-shot snapshot) 每篇文章对每个 vault 只同步一次。之后线上 AI 重处理 / 本地 Obsidian 编辑 / 标签 / 双链 —— 插件都不会再触碰已存在的 .md 文件。

功能

• 📥 拉取 Trove AI 服务器上的文章,按平台分目录(知乎/抖音/小红书/B站/公众号/...)写到本地 vault
• 📝 每篇文章带 frontmatter(trove_id / title / source_url / tags / summary / synced_at ...)
• 🔗 知识图谱里的关联文章自动渲染为 Obsidian [[wikilink]],在图谱视图里直接可视化
• 🖼️ 图片走 Trove AI 服务器代理(绝对 URL,只要服务器可达就能渲染)
• 🛡️ 双重 OR 已同步判定:sync_state.json ∪ frontmatter 扫描——误删任一都不会重写已有文件
• ⏱️ 可配置自动轮询 / 手动 Sync Now 命令 / 状态栏实时显示

安装(Sideload,V1)

Obsidian 社区市场审核走 1–2 周;本插件目前先支持手动安装。

Step 1: clone + build 产物

git clone https://github.com/weaiw/trove-sync-obsidian.git
cd trove-sync-obsidian
npm install
npm run build

不想 build? 直接从 Releases 页面 下载 main.js / manifest.json / styles.css 三个文件,跳到 Step 2。

build 产物:main.js / manifest.json / styles.css(根目录)。

Step 2: 拷贝到目标 vault

VAULT=~/Documents/MyObsidianVault         # 改成你自己的 vault
mkdir -p "$VAULT/.obsidian/plugins/trove-sync"
cp main.js manifest.json styles.css "$VAULT/.obsidian/plugins/trove-sync/"

Step 3: 在 Obsidian 里启用

1. 打开 Obsidian → 设置 → 第三方插件
2. 关掉"安全模式"(如果还开着)
3. 在"已安装插件"列表里找到 Trove AI Sync → 启用

Step 4: 配置

设置 → 找到 Trove AI Sync 分区:

• 服务器地址:http://trove.yourdomain.com
• 同步 Token:在网页端 Trove AI → 设置 → Obsidian 备份 → 生成本地同步 Token
• 文件夹:默认 Trove AI(vault 根下的子目录)
• 自动同步间隔:默认 300 秒
• 打开"启用自动同步"

Step 5: 跑一次

• 命令面板(⌘P)→ Sync Now (Trove AI),或
• 设置面板里点 Sync Now

完成后看左下角状态栏:Trove AI: +N 篇。

命令

命令	用途
Sync Now (Trove AI)	立即拉取所有未同步的文章
Test Connection (Trove AI)	验证服务器 + token 是否可用

与 backend 的协议

端点	方法	用途
/api/sync/issue-token	POST	网页端签发 365 天 sync token
/api/sync/articles	GET	分页拉取本用户已 AI 处理的文章
/api/sync/stats	GET	文章总数 / 可同步数
/api/sync/revoke-all-tokens	POST	一键吊销所有同步 token

数据安全

• Token 等同于密码,不要分享、截图、提交到公开仓库
• 误泄露:回 Trove AI 网页 → 设置 → Obsidian 备份 → "撤销所有同步 Token",所有已签发的 token 立即失效。然后重新生成,填回这里
• Vault 是明文 markdown;同步 = 本地有完整副本。Trove AI 服务器即使消失,本地数据也在

卸载

设置 → 第三方插件 → 关掉 Trove AI Sync → 删掉 <vault>/.obsidian/plugins/trove-sync/ 目录。 你 vault 里已同步的 .md 文件不会被动到。

路线图

• 提交到 Obsidian 社区插件市场
• 图片本地下载(脱离服务器也能看图)
• 单篇"强制重新同步"
• 同步时显示进度条