X/Twitter【推文+书签+AI分类】同步到Obsidian 使用指南type
Post
status
Published
date
Jun 11, 2026
slug
twitter-obsidian-guide
summary
同步 X/Twitter 推文、书签到 Obsidian Vault（长推文、Thread、X 文章、图片本地化、AI 智能分类）。免费体验 100 条。
tags
推特
X
obsidian
category
技术分享
icon
password
同步 X/Twitter 推文、书签到 Obsidian Vault（长推文、Thread、X 文章完整支持，图片本地化，AI 智能分类），新增内容自动增量同步。
一、下载安装
1. 下载插件
2. 解压并安装
- 解压
twitter2obsidian.zip，得到twitter2obsidian文件夹
- 打开你的 Obsidian Vault 所在目录，找到
.obsidian/plugins/文件夹 - macOS：
你的Vault目录/.obsidian/plugins/ - Windows：
你的Vault目录\.obsidian\plugins\ - 如果
plugins文件夹不存在，手动创建一个
- 把
twitter2obsidian文件夹整个复制到plugins/目录下
最终结构：
提示：.obsidian是隐藏文件夹。macOS 按Cmd + Shift + .显示隐藏文件，Windows 在文件资源管理器中勾选"显示隐藏的项目"。
3. 启用插件
- 打开 Obsidian
- 进入 设置 → 第三方插件
- 如果提示"安全模式"，点击关闭安全模式
- 点击刷新按钮，找到 Twitter Sync
- 打开开关启用插件
二、配置插件
启用后，在 设置 → Twitter Sync 中进行配置。
1. 填写授权码（免费体验可跳过）
插件提供免费同步 100 条推文 / 书签，可以先登录直接体验。需要继续使用时，在「授权码」输入框填入购买的授权码，点击「验证」即可。
2. 登录 Twitter/X
- 点击「登录 Twitter/X」按钮
- 在弹出的窗口中登录你的 X/Twitter 账号
- 登录成功后，点击窗口上方的「登录完成，提取 Cookie」按钮
- 看到登录成功提示即可
注意：Cookie 持久化在 Obsidian 的 webview 分区里，不会因为重启 Obsidian 丢失。如果登录过期，插件会自动提示你重新登录。
3. 同步设置
设置项 | 说明 | 建议值 |
定时自动同步 | 是否按设定间隔自动同步 | 开启 |
自动同步间隔 | 每隔多少分钟自动同步一次 | 建议 10 分钟以上 |
每批同步数量 | 每次同步拉取的推文条数 | 20 条 |
Twitter 的频率限制相对宽松，但间隔也不建议设太短。提示「请求频率限制」时，等几分钟会自动恢复，可以适当增大同步间隔。
4. AI 智能分类（可选）
开启后，同步推文时会自动用 AI 为推文选择分类和标签，无需手动整理。
- 打开「AI 智能分类」开关
- 填写 API Key、API 地址、模型名称（需自备 API Key）
- 保存后新同步的推文会自动分类打标签
支持 OpenAI、Gemini、DeepSeek、Qwen 等多种 AI 模型。
三、开始同步
自动同步
插件启用后会按设定的间隔自动同步，无需手动操作。新增书签和推文自动追加，旧的不重复写入。
手动同步
命令面板：按
Cmd + P（macOS）或 Ctrl + P（Windows），搜索「同步」相关命令即可立即触发。同步进度
- 同步过程中会在右上角弹出 Notice 提示
- 历史数据同步完成后自动转为增量同步
四、同步内容说明
目录结构
笔记格式
每条推文一份 Markdown 笔记，包含 YAML 属性区和正文：
- 属性（frontmatter）：作者、@screenName、推文链接、标签、创建时间等，方便检索与双链
- 正文：
- 推文完整内容：短推文、长推文（Note Tweet）、Thread 串、X 文章全部支持
- 图片自动下载到
Twitter/Media/目录并嵌入引用（本地保存，不受推文删除影响） - 视频以链接形式保留
- 自动提取推文 Hashtag，去重优化，最多 3 个标签写入 frontmatter；开启 AI 后自动分类打标签
五、常见问题
Q：同步时提示「登录已失效」？
Twitter/X 的登录信息有有效期，过期后插件会自动检测并提示。点击设置中的「登录 Twitter/X」重新登录即可。
Q：图片显示不出来？
确认
Twitter/Media/ 目录下有对应的图片文件。如果没有，可能是下载失败，在插件设置中清除缓存重新同步即可。Q：想重新同步所有数据？
在插件设置中点击「清除缓存并重新同步」按钮。这只会重置同步记录，不会删除已有的笔记文件（会覆盖更新）。
Q：切换了 Twitter 账号怎么办？
插件会自动检测账号切换并重置同步状态，无需手动操作。
Q：同步间隔设多少合适？
建议 10 分钟以上，每批 20 条。Twitter 的频率限制相对宽松，但也不建议设太短。提示「请求频率限制」时，等几分钟会自动恢复，可以适当增大同步间隔。
Q：提示「该授权码已绑定其他设备」？
授权码绑定单设备使用。如需更换设备，在原设备插件设置中点「解绑」后再到新设备上重新绑定即可。
Q：如何更新插件？
下载新版本的
twitter2obsidian.zip，解压后覆盖 .obsidian/plugins/twitter2obsidian/ 目录下的文件，重新加载 Obsidian 即可。设置和已同步状态都保留，更新插件不会丢。Q：支持手机端 Obsidian 吗？
当前仅支持 Obsidian 桌面端（Mac / Windows / Linux），因为同步过程需要本地网络与文件系统能力。已同步的 Markdown / 媒体文件可在 Obsidian 移动端正常浏览。
六、购买授权码
插件提供免费同步 100 条推文 / 书签，达到限额后需要在设置页填入授权码继续同步。
购买后将授权码粘贴到「设置 → Twitter Sync → 授权码」输入框中，点击「验证」即可。
授权码绑定单设备使用。如需更换设备，在原设备插件设置中点「解绑」后再到新设备上重新绑定即可。
七、安全问题
🛡️ 隐私保护声明（Privacy Policy）
我们重视您的隐私，并承诺采取一切合理措施保护您的个人数据安全。
1. 插件运行方式
- 本插件为 Obsidian 原生插件，所有操作均在 Obsidian 桌面端本地执行，不会将任何数据发送至我们或第三方服务器。
- 插件不会收集、存储或分析您的 X/Twitter 账户信息、Cookie 或推文内容。所有同步内容直接写入您本地的 Obsidian Vault。
- 本插件仅作为个人知识库工具使用。
2. 数据访问权限
- 插件通过隐藏 webview 调用 X/Twitter web API 拉取您的推文和书签，写入您本地的 Obsidian Vault。
- 插件不会主动抓取、储存或分发任何非您本人账号下的数据。
3. 第三方平台说明
- 插件使用 X/Twitter 官方 web API 拉取数据；如启用了 AI 智能分类，会以您配置的 AI 接口发送推文文本进行分类，该请求只发往您配置的 API 端点，不经过我们。
- 授权码验证使用我们的服务端，仅传输授权码字符串和设备指纹哈希，不涉及任何笔记内容。
4. 本地存储说明
- 插件配置（同步设置、授权码等）和已同步状态保存在 Vault 内
.obsidian/plugins/twitter2obsidian/data.json，X/Twitter Cookie 保存在 Obsidian 自身的 webview 分区内，均不会被上传或远程保存。
⚠️ 使用免责声明（Disclaimer）
1. 第三方平台责任
本插件为独立开发工具，与 X（Twitter）及 Obsidian 官方无任何隶属关系。所有商标与内容归各平台所有。用户在使用本插件过程中，应遵守各平台的使用条款，不得进行非法抓取、批量爬取、账号共享等违规行为。如用户行为违反平台政策或法律法规，由用户自行承担责任。
2. 功能范围说明
- 本插件定位为协助用户搭建个人知识库的工具，仅用于将用户本人账号下的推文、书签整理同步到本地 Obsidian Vault。
- 严禁将本插件用于任何形式的数据爬取、批量抓取他人内容、二次分发或商业化数据采集。
- 插件依赖用户在插件内登录并授权后方可使用，若平台接口发生变化导致插件无法运行，请联系开发者反馈。
3. 使用风险提示
用户使用插件过程中所产生的任何同步行为，均为用户主动触发。请用户自行评估数据内容的敏感性，合理使用插件。
八、联系与反馈
- Author:自律小嘉同学
- URL:https://blog.notionedu.com/article/twitter-obsidian-guide
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
