企业官网建设流程全解析

CSV/JSON/Obsidian一网打尽：Siftly书签导出与第二大脑迁移攻略

【免费下载链接】SiftlyLocal Twitter/X bookmark organizer with AI categorization and mindmap visualization项目地址: https://gitcode.com/gh_mirrors/si/Siftly

Siftly 是一个完全本地运行的 Twitter/X 书签整理工具，支持 AI 自动分类、语义搜索和思维导图。当你的书签库积累到几百甚至上千条时，备份与迁移就变得至关重要。本文带你用 3 种格式（CSV / JSON / Obsidian）把 Siftly 书签库完整导出，轻松完成"第二大脑"迁移，全程无需编写任何代码。

为什么必须导出你的书签库？

书签是典型的"数字资产"，却也是最容易被遗忘的资产。导出能帮你解决 3 个核心问题：

Siftly 的导出能力全部内置，数据始终留在你自己的机器上，只有你配置的 AI 接口才会产生外呼。

3 种导出格式快速对比

Siftly 内置了 4 个导出入口（CSV、JSON、分类 ZIP、Obsidian），先看清差异再选格式：

一键 CSV 导出：把书签变成表格

这是最常用的格式。打开 Siftly 侧边栏进入Settings（设置）页面，滚动到Data Management区块，点击"Export as CSV"按钮，浏览器会立即下载bookmarks.csv。

导出的表格包含 7 个字段：

• tweetId— 推文唯一 ID
• text— 推文正文
• authorHandle— 作者账号
• source— 来源（书签 / 点赞）
• categories— AI 分类结果（多分类用分号分隔）
• tweetCreatedAt— 推文发布时间
• mediaUrls— 全部媒体文件链接

用 Excel 或 Google Sheets 打开后，你可以按分类筛选、按时间排序，甚至统计"我一年收藏了多少条 AI 相关内容"。所有字段都做了标准的 CSV 转义处理（引号自动翻倍、整行加引号），含逗号或引号的推文正文不会把表格搞乱，相关实现见 lib/exporter.ts。

JSON 全量导出：无损备份的最佳选择

JSON 格式保留全部结构化数据：正文、作者、分类名称及颜色、slug、每条媒体的类型/URL/缩略图、导入时间等，一份文件即可完整还原整个书签库。

同样是设置页 Data Management 区块的"Export as JSON"按钮，下载bookmarks.json后建议放到网盘同步目录做定期备份。JSON 结构定义可查看 exportBookmarksJson，接口路由实现在 app/api/export/route.ts。

💡 提示：如果你未来要迁移到其他书签工具，JSON 是最友好的"中间格式"——任何语言几行脚本就能解析它。

按分类打包 ZIP：连图片视频一起带走

这是 Siftly 最有特色的导出功能：导出某个分类时，会连同该分类下所有书签的图片、GIF、视频一起打包下载。

操作步骤：

1. 进入侧边栏Categories（分类）页面
2. 点击任意分类卡片进入详情页
3. 点击右上角"Export ZIP"按钮

解压后你会得到：

media/ ← 该分类的所有媒体文件（jpg/png/mp4） manifest.csv ← 清单：tweetId、正文、作者、推文链接、分类、日期

比如你收藏了一整个 "Design"（设计灵感）分类，打包后就是一个独立的本地素材库，媒体文件名会自动沿用原始 URL 的文件名，找不到时回退为media_序号.扩展名，打包逻辑在 exportCategoryAsZip，页面按钮实现在 app/categories/[slug]/page.tsx。

⚠️ 媒体下载走的是逐条抓取（15 秒超时），如果某张图源站失效会自动跳过，不影响整个打包。

Obsidian 导出：一键迁移到你的第二大脑 🧠

Siftly 内置了Obsidian 直连导出，可以把整个书签库变成标准的 Obsidian 笔记库（Vault），这是"第二大脑"迁移的核心功能。

配置步骤（3 步完成）

1. 进入设置页：侧边栏 →Settings
2. 填写 Vault 路径：在Obsidian Export区块的 "Vault path" 输入你的 Obsidian 库绝对路径（例如/Users/you/ObsidianVault），也可以点击文件夹图标用图形化目录浏览器选择，然后点击Save
3. 执行导出：点击"Export to Obsidian"按钮，完成后页面会显示"写入 N 条笔记 / 跳过 N 条 / 创建 N 个索引文件"

勾选Overwrite existing notes可覆盖同名旧笔记，不勾选则自动跳过已存在的文件——这意味着你可以重复导入而不破坏自己加过手工批注的笔记，非常适合做增量同步。

生成的笔记长什么样？

每条推文会生成一篇独立 Markdown，文件名为2026-09-28 - @作者 - 推文ID.md，结构如下：

• YAML frontmatter：推文 ID、作者、日期、原文链接、分类列表
• 标签体系：自动注入twitter/bookmark、author/作者、AI 语义标签和category/分类四级标签，直接对接 Obsidian 的标签面板
• 正文 + 媒体：推文原文，图片以内联 Markdown 嵌入，视频/GIF 以链接形式保留
• 来源区块：一键跳回原推文的 "View on X" 链接

更妙的是，导出时还会在_index目录下自动生成两类双链索引页：

这些索引文件让"收藏 → 检索 → 关联"在 Obsidian 图谱视图中真正闭环，核心逻辑见 lib/obsidian-exporter.ts，服务端入口在 app/api/export/obsidian/route.ts。

🛡️ 安全设计：写入前会校验路径必须是绝对路径、已存在的目录，并拦截/etc、/usr等系统目录，防止误操作写坏系统文件（见 validateVaultPath）。

迁移工作流建议：三步建立你的第二大脑

综合以上功能，推荐这样一条迁移路线：

1. 先全量备份：设置页导出 CSV（人看）+ JSON（机器读），各存一份到网盘
2. 专题归档：挑几个高频分类（如 "AI Resources"）用 ZIP 打包媒体素材
3. 知识入库：配置 Obsidian 路径后全量导出，把_index里的索引页设为各分类的入口笔记

之后每次导入新书签（Siftly 会自动去重并触发 AI 分类），只需再点一次 Obsidian 导出，增量笔记会自动补齐——你的第二大脑就这样持续生长 🌱。

常见问题 FAQ

Q1：导出的 CSV 用 Excel 打开中文/表情乱码怎么办？文件是标准 UTF-8 编码，直接用 Excel"数据 → 从文本导入"并选择 UTF-8 编码即可正常显示。

Q2：能只导出某个分类的 CSV 吗？CSV/JSON 是全局导出；若只需要某分类，用该分类详情页的ZIP 导出，包内manifest.csv就是该分类的表格数据。

Q3：Obsidian 导出会下载媒体文件吗？不会。笔记中的图片保留原始在线链接（Obsidian 里可直接预览），需要离线媒体时请使用 ZIP 分类导出。

Q4：我修改过 Vault 路径了，会报错吗？会先校验再写入：路径不存在、非绝对路径或指向系统目录时，Siftly 会直接返回错误提示而不会写入任何文件。

核心模块路径速查

• CSV/JSON/ZIP 导出逻辑：lib/exporter.ts
• Obsidian 导出逻辑：lib/obsidian-exporter.ts
• 导出 API 路由：app/api/export/route.ts
• Obsidian 导出 API 路由：app/api/export/obsidian/route.ts
• 设置页（导出入口）：app/settings/page.tsx
• 分类详情页（ZIP 按钮）：app/categories/[slug]/page.tsx
• 本地命令行工具（可配合导出做自动化）：cli/siftly.ts

从表格备份到 Obsidian 第二大脑，Siftly 的导出体系覆盖了书签管理"最后一公里"的所有需求——数据在手，知识永存。

【免费下载链接】SiftlyLocal Twitter/X bookmark organizer with AI categorization and mindmap visualization项目地址: https://gitcode.com/gh_mirrors/si/Siftly