---

Siftly 是什么？

Siftly 可以将你的 Twitter/X 书签转化为一个 可搜索、分类、可视化的知识库 —— 完全在你的本地机器上运行。无需云端、无需订阅、也不需要浏览器扩展。除了你配置的 AI API 调用之外，所有数据都保留在本地。

它会在你的书签上运行一个 四阶段的 AI 流程：

📥 导入（内置书签小工具或控制台脚本——无需扩展）
    ↓
🏷️ 实体提取   — 从原始推文数据中挖掘标签、URL、提及以及 100 多种已知工具（免费，零 API 调用）
    ↓
👁️ 视觉分析      — 读取每张图片/GIF/视频缩略图中的文本、物体和上下文信息（每张图片约 30–40 个视觉标签）
    ↓
🧠 语义标签     — 为每个书签生成 25–35 个可搜索标签，支持 AI 驱动的搜索
    ↓
📂 分类       — 为每个书签分配 1–3 个类别，并附带置信度分数

流程完成后，你将获得：

• AI 搜索 — 不仅能按关键词，还能按语义查找书签（"关于加密货币崩盘的搞笑表情包"）
• 交互式思维导图 — 可视化地探索你的整个书签图谱
• 筛选浏览 — 网格或列表视图，可按类别、媒体类型和日期进行筛选
• 导出工具 — 下载媒体文件，或导出为 CSV / JSON / ZIP 格式

---

快速开始

前提条件

• Node.js 18+
• npm（随 Node.js 自带）

就这么简单。 如果你已经安装并登录了 Claude Code CLI，AI 功能将自动生效——无需 API 密钥。

选项 A — 一条命令（推荐）

git clone https://github.com/viperrcrypto/Siftly.git
cd Siftly
./start.sh

start.sh 会安装依赖项、设置数据库、检查 Claude CLI 的认证状态，并自动打开 http://localhost:3000。

选项 B — 使用 Claude Code

如果你使用 Claude Code 来搭建项目，它会读取 CLAUDE.md 文件，准确知道如何开始。只需打开项目文件夹：

git clone https://github.com/viperrcrypto/Siftly.git
claude Siftly/

Claude Code 会帮你完成设置并启动应用，直接利用你现有的 Claude 订阅——无需额外配置。

选项 C — 手动设置

git clone https://github.com/viperrcrypto/Siftly.git
cd Siftly
npm install
npx prisma generate
npx prisma migrate dev --name init
npx next dev

打开 http://localhost:3000

---

AI 认证

Siftly 会自动检测最佳可用的认证方式——在大多数情况下无需任何配置。

优先级顺序

序号	方法	如何操作
1	Claude Code CLI (无需配置)	已经登录？Siftly 会自动从 macOS 钥匙串中读取你的会话
2	设置中的 API 密钥	打开应用内的“设置”页面，粘贴你的密钥
3	ANTHROPIC_API_KEY 环境变量	在 .env.local 或你的 shell 环境中设置
4	本地代理	将 ANTHROPIC_BASE_URL 设置为任何与 Anthropic 兼容的端点

Claude Code CLI（无需 API 密钥）

如果你使用 Claude Code，你已经登录。Siftly 会从 macOS 钥匙串中检测到你的会话，并自动使用你的 Claude 订阅（Free/Pro/Max）。

当此功能启用时，“设置”页面会显示一个绿色的 “检测到 Claude CLI——无需 API 密钥” 标志，并注明你的订阅等级。

注意： 此方法仅适用于 macOS。在 Linux/Windows 上，请改用“设置”中的 API 密钥。

获取 API 密钥（如果需要）

1. 访问 console.anthropic.com
2. 创建一个新的 API 密钥
3. 打开 Siftly → “设置” → 粘贴密钥

新账户会提供 $5 的免费额度——按照 Haiku 定价，足够处理数千个书签（约 $0.00025/书签）。

---

导入你的书签

Siftly 提供了 内置的导入工具——无需浏览器扩展。前往 “导入” 页面，选择以下任一方法：

方法 A — 书签小工具 (推荐)

1. 在 Siftly 侧边栏中进入 “导入” 页面
2. 将 “导出 X 书签” 链接拖到浏览器书签栏中 （或者右键点击书签栏 → 添加书签 → 粘贴 URL）
3. 登录 X 后，访问 x.com/i/bookmarks
4. 点击书签栏中的 “导出 X 书签”——页面上会出现一个紫色按钮
5. 点击 “▶ 自动滚动”——工具会自动滚动并捕获所有书签
6. 完成后，点击紫色的 “导出 N 个书签” 按钮——bookmarks.json 文件会被下载
7. 回到 Siftly → “导入” → 拖放或上传该文件

方法 B — 浏览器控制台脚本

1. 登录 X 后，访问 x.com/i/bookmarks
2. 打开开发者工具：按下 F12（Windows/Linux）或 ⌘⌥J（Mac），然后切换到 “控制台” 选项卡
3. 从 Siftly 的导入页面复制控制台脚本，粘贴到控制台并按下回车键
4. 点击 “▶ 自动滚动”，等待所有书签被捕获
5. 点击导出按钮——bookmarks.json 文件会自动下载
6. 回到 Siftly → “导入” → 上传该文件

重新导入

你可以随时重新导入——Siftly 会自动跳过重复项，只添加新的书签。

---

AI 分类

一旦你导入书签，分类就会自动开始。 你也可以手动触发分类，方法如下：

• 在 “导入” 页面（上传后）
• 在 “思维导图” 页面（当书签尚未分类时）
• 在侧边栏的 “分类” 页面

4 阶段流水线

阶段	功能
实体提取	从存储的推文 JSON 中挖掘话题标签、URL、@提及以及 100 多种已知工具/产品名称 — 免费，无需 API 调用
视觉分析	分析每张图片、GIF 和视频缩略图 — OCR 文本、物体、场景、情绪、梗模板，每张图片包含 30–40 个视觉标签
语义标记	结合推文文本和图片上下文，为每个书签生成 25–35 个精准的搜索标签。同时提取情感、人物和公司名称。
分类	利用所有丰富后的数据，为每个书签分配 1–3 个类别，并附带置信度分数

该流水线是 增量式 的——如果中断，它会从中断处继续运行。使用 “重新运行全部（强制全部）” 可以重新分析已处理过的书签。

---

功能

🔍 AI 搜索

支持对所有书签数据进行自然语言查询：

• “关于加密货币崩盘的搞笑表情包”
• “React Hooks 教程”
• “比特币价格走势图”
• “最佳 AI 编码工具”

通过全文检索索引 (FTS5) 加上 Claude 的语义重排序，同时搜索推文文本、图片 OCR、视觉标签、语义标签和类别。结果按相关性排序，并为每个匹配项提供 AI 生成的解释说明。

🗺️ 思维导图

交互式的力导向图，按类别组织显示所有书签：

• 展开或折叠任意类别以查看其书签
• 点击书签节点即可在 X 平台上打开原始推文
• 按类别进行颜色编码的图例
• 如果书签尚未分类，内嵌的 AI 分类 按钮可在不离开页面的情况下启动流水线。

📚 浏览与筛选

• 网格视图（马赛克布局）或 列表视图
• 按类别、媒体类型（照片/视频）或搜索文本进行筛选
• 按最新或最旧排序
• 每页 24 条记录分页
• 当前筛选条件芯片可单独移除或一键清空
• 将鼠标悬停在任一卡片上即可下载媒体内容或跳转至原始推文。

⚙️ 类别

预设了 8 个默认类别，并配有 AI 可读的描述：

类别	颜色
搞笑表情包	琥珀色
AI 资源	紫色
开发工具	青色
设计	粉色
金融与加密	绿色
生产效率	橙色
新闻	靛蓝色
综合	灰蓝色

您可以创建自定义类别，指定名称、颜色及可选描述。描述将在分类过程中直接传递给 AI——描述越具体，分类结果就越准确。

📤 导出

• CSV — 与电子表格兼容，包含所有字段
• JSON — 完整结构化数据导出
• ZIP — 导出某个类别的书签及所有媒体文件，并附带 manifest.csv 清单文件。

⌨️ 命令面板

按下 Cmd+K（Mac）或 Ctrl+K（Windows/Linux），即可在应用的任何位置搜索所有书签。

---

配置

所有设置均可在 /settings 页面或通过环境变量进行管理：

设置	环境变量	描述
Anthropic API 密钥	ANTHROPIC_API_KEY	如果已登录 Claude CLI，则可选；否则，AI 功能需要此密钥
API 基础 URL	ANTHROPIC_BASE_URL	自定义端点，用于代理或本地 Anthropic 兼容模型
AI 模型	仅限设置页面	Haiku 4.5（默认，最快且最便宜）、Sonnet 4.6、Opus 4.6
OpenAI 密钥	仅限设置页面	如果未设置 Anthropic 密钥，则可作为替代提供商
数据库	DATABASE_URL	SQLite 文件路径（默认：file:./prisma/dev.db）

自定义 API 端点

将 Siftly 指向任何 Anthropic 兼容的服务器：

ANTHROPIC_BASE_URL=http://localhost:8080

---

架构

siftly/
├── app/
│   ├── api/
│   │   ├── analyze/images/   # 批量图像视觉分析（获取进度，POST 启动）
│   │   ├── bookmarks/        # 列表、筛选、分页、删除
│   │   │   └── [id]/categories/ # 单个书签的类别管理
│   │   ├── categories/       # 类别增删改查
│   │   │   └── [slug]/       # 单个类别的操作
│   │   ├── categorize/       # 4 阶段 AI 流水线（启动、状态、停止）
│   │   ├── export/           # CSV、JSON、ZIP 导出
│   │   ├── import/           # JSON 文件导入，带有去重功能并自动触发流水线
│   │   │   ├── bookmarklet/  # 书签小工具专用导入端点
│   │   │   └── twitter/      # Twitter 专用导入端点
│   │   ├── link-preview/     # 服务器端 OG 元数据抓取
│   │   ├── media/            # 媒体代理/下载端点
│   │   ├── mindmap/          # 图形节点与边，用于可视化
│   │   ├── search/ai/        # 自然语言语义搜索（FTS5 + Claude）
│   │   ├── settings/         # API 密钥和模型配置
│   │   │   ├── cli-status/   # Claude CLI 认证检测端点
│   │   │   └── test/         # API 密钥验证端点
│   │   └── stats/            # 仪表板统计数据
│   ├── ai-search/            # AI 搜索页面
│   ├── bookmarks/            # 浏览、筛选、分页
│   ├── categories/           # 类别管理
│   │   └── [slug]/           # 类别详情页
│   ├── categorize/           # 流水线监控器，实时显示进度
│   ├── import/               # 三步导入流程（说明 → 上传 → 分类）
│   ├── mindmap/              # 交互式图形
│   ├── settings/             # 配置
│   └── page.tsx              # 仪表板
│
├── components/
│   ├── mindmap/              # 思维导图画布、节点、边
│   │   ├── mindmap-canvas.tsx
│   │   ├── category-node.tsx
│   │   ├── tweet-node.tsx
│   │   ├── root-node.tsx
│   │   ├── chain-edge.tsx
│   │   └── mindmap-context.ts
│   ├── command-palette.tsx   # Cmd+K 全局搜索
│   ├── nav.tsx               # 侧边导航
│   └── theme-toggle.tsx      # 明暗模式切换
│
├── lib/
│   ├── categorizer.ts        # AI 分类逻辑及默认类别
│   ├── claude-cli-auth.ts    # 检测 macOS Keychain 中的 Claude CLI OAuth 会话
│   ├── vision-analyzer.ts    # 图像分析及批量语义标记
│   ├── image-context.ts      # 共享图像上下文构建器
│   ├── fts.ts                # SQLite FTS5 全文检索索引
│   ├── rawjson-extractor.ts  # 从原始推文 JSON 中提取实体
│   ├── parser.ts             # 多格式 JSON 解析器
│   ├── exporter.ts           # CSV、JSON、ZIP 导出
│   ├── types.ts              # 共享 TypeScript 类型
│   └── db.ts                 # Prisma 客户端单例
│
├── prisma/
│   └── schema.prisma         # SQLite 模式
│
├── start.sh                  # 一键启动脚本（安装 + 数据库初始化 + 打开浏览器）
└── CLAUDE.md                 # Claude Code AI 助手使用说明

数据库模式

书签          — 推文文本、作者、日期、原始 JSON、语义标签、增强元数据
  ├── 媒体项   — 包含 AI 生成图像标签的图片/视频/GIF
  └── 书签类别 — 带置信度分数（0–1）的类别分配

类别          — 名称、别名、十六进制颜色、AI 可读描述
设置           — 键值存储（API 密钥、模型偏好）
导入任务         — 跟踪导入文件的状态和进度

Prisma + SQLite + FTS5

Siftly 使用 Prisma 迁移来管理关系型模式变更。 在开发环境中，当模式发生变化时，运行 npx prisma migrate dev --name <change-name>。 对于生产环境或运行时启动，使用 npx prisma migrate deploy 应用已提交的迁移。 FTS5 (bookmark_fts) 在运行时由 lib/fts.ts 管理，而不是在 schema.prisma 中定义。 目前这是有意为之，因为 Prisma 并不直接支持 SQLite 虚拟表的定义。

有关 Prisma 命令和工作流的详细信息，请参阅：

• https://www.prisma.io/docs/orm/prisma-migrate/workflows/development-and-production
• https://www.prisma.io/docs/orm/prisma-client/setup-and-configuration/generating-prisma-client

---

技术栈

技术	版本	作用
Next.js	16	全栈框架（App Router）
TypeScript	5	全程类型安全
Prisma	7	ORM + 迁移
SQLite	—	本地数据库 — 零配置，包含 FTS5
Tailwind CSS	v4	样式
Anthropic SDK	—	视觉处理、语义标注、分类、搜索
@xyflow/react	12	交互式思维导图图表
Framer Motion	12	动画
Radix UI	—	无障碍 UI 原语
JSZip	—	导出类别 ZIP 文件
Lucide React	—	图标

---

开发

# 一键启动（安装依赖、设置数据库、打开浏览器）
./start.sh

# 或者手动：
npm install
npx prisma generate
npx prisma migrate dev --name init
npx next dev

# 类型检查
npx tsc --noEmit

# 打开数据库 GUI
npx prisma studio

# 构建生产环境
npm run build && npm start

自定义类别

编辑 lib/categorizer.ts 中的 DEFAULT_CATEGORIES。每个条目需要：

{
  name: '我的类别',       // 显示名称
  slug: 'my-category',   // URL 安全标识符（必须唯一）
  color: '#6366f1',      // UI 中显示的十六进制颜色
  description: '...',    // 自然语言描述 — 直接用于 AI 提示词
}

description 字段会直接影响 AI 对书签的分类方式，请尽量具体。

添加已知工具

将域名字符串添加到 lib/rawjson-extractor.ts 中的 KNOWN_TOOL_DOMAINS，以便实体提取器能够自动识别推文数据中指向这些工具的链接。

---

隐私

• 所有数据均本地存储在您机器上的 SQLite 文件中
• 唯一的外部调用是您配置的 AI 提供商（推文文本 + 图像数据）
• 无遥测、无跟踪、无需账户
• 您的书签绝不会触及其他第三方服务器，仅会发送至您配置的 AI 端点

---

支持开发

如果 Siftly 为您节省了时间，请考虑留下小费 ☕

---

许可证

MIT — 详见 LICENSE

---

Siftly 快速上手指南

Siftly 是一款可自托管的 Twitter/X 书签管理器，利用 AI 技术将您的书签转化为可搜索、可分类的可视化知识库。所有数据本地存储，无需浏览器扩展。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS（推荐，支持自动检测 Claude CLI）、Linux 或 Windows
• Node.js：版本 18 或更高 (下载地址)
• 包管理器：npm (随 Node.js 安装)
• AI 认证（二选一）：
  • 方案 A (推荐 macOS 用户)：安装并登录 Claude Code CLI，Siftly 可自动读取会话，无需 API Key。
  • 方案 B (通用)：准备一个 Anthropic API Key (新用户赠送 $5 额度)。

安装步骤

您可以选择以下任一方式进行安装和启动。

方式 A：一键启动脚本（推荐）

这是最简便的方法，脚本会自动处理依赖安装、数据库初始化和应用启动。

git clone https://github.com/viperrcrypto/Siftly.git
cd Siftly
./start.sh

执行后，浏览器将自动打开 http://localhost:3000。

方式 B：使用 Claude Code

如果您已安装 Claude Code，它会自动读取项目配置并完成设置：

git clone https://github.com/viperrcrypto/Siftly.git
claude Siftly/

方式 C：手动安装

如果上述方法不适用，可手动执行以下步骤：

git clone https://github.com/viperrcrypto/Siftly.git
cd Siftly
npm install
npx prisma generate
npx prisma migrate dev --name init
npx next dev

启动成功后，访问 http://localhost:3000。

基本使用

1. 配置 AI (如需)

• macOS 用户：若已登录 Claude Code CLI，进入设置页面即可看到绿色徽章提示"Claude CLI detected"，无需额外操作。
• 其他用户：点击侧边栏 Settings，粘贴您的 ANTHROPIC_API_KEY。

2. 导入书签

Siftly 内置了导入工具，无需安装浏览器扩展。

1. 在 Siftly 界面点击侧边栏的 Import。
2. 创建书签工具：将页面上的 "Export X Bookmarks" 链接拖拽到浏览器的书签栏。
3. 获取数据：
   • 登录 x.com/i/bookmarks。
   • 点击刚才添加的书签，页面会出现紫色按钮。
   • 点击 "▶ Auto-scroll"，工具会自动滚动并抓取所有书签。
   • 完成后点击 "Export N bookmarks"，下载 bookmarks.json 文件。
4. 上传：回到 Siftly 的 Import 页面，拖入或上传该 JSON 文件。

3. 自动分析与分类

文件上传后，4 阶段 AI 流水线会自动启动：

1. 实体提取：免费提取标签、URL 和提及。
2. 视觉分析：分析图片/视频内容，生成视觉标签。
3. 语义标记：为每个书签生成 25-35 个搜索标签。
4. 分类归档：自动将书签分配至 1-3 个类别。

您可以在 Categorize 页面查看实时进度。

4. 搜索与浏览

• AI 搜索：在搜索框输入自然语言，例如 "funny meme about crypto crashing" 或 "react hooks tutorial"，系统会基于语义而非单纯关键词匹配结果。
• 思维导图：点击 Mindmap 查看可视化的书签关系图，支持按类别展开/折叠。
• 快捷搜索：在任何页面按下 Cmd+K (Mac) 或 Ctrl+K (Win/Linux) 唤起全局命令面板进行搜索。