Field Theory CLI

Field Theory CLI (ft) 是一款专为 Mac（同时也支持 Linux 和 Windows）设计的开源命令行工具，用于在本地同步、存储、搜索和管理你的 X (Twitter) 书签。它将分散的社交媒体收藏转化为结构化的个人知识库，并无缝集成到 Claude Code、Codex 等 AI 代理工作流中。

核心亮点

1. 完全本地与隐私优先

• 数据主权：所有书签数据、媒体文件和索引均存储在本地 (~/.ft-bookmarks/)，无遥测，无云端上传。
• 安全同步：支持通过浏览器会话提取 Cookie 或官方 OAuth API 进行同步，敏感令牌以严格权限存储。

2. AI 驱动的智能分类

• 自动标签：利用 LLM 对书签进行智能分类（如 tool, research, security, opinion 等），超越简单的关键词匹配。
• 内容增强：可回填被截断的推文文本、扩展链接文章内容，甚至下载本地媒体资产（图片/视频海报）。

3. 强大的搜索与可视化

• 全文检索：基于 SQLite FTS5 和 BM25 算法，实现毫秒级全文搜索。
• 终端仪表盘：通过 ft viz 查看包含火花线、类别分布和域名统计的实时终端仪表板。
• 多维筛选：按作者、日期、类别、域名或文件夹灵活列表和筛选。

4. Agent 原生集成

• Skill 安装：一键为 Claude Code 和 Codex 安装 /fieldtheory 技能。
• 自然语言查询：允许 AI 代理直接访问你的书签库，回答如“我过去三年关于癌症研究的书签有哪些？”或“帮我找出最好的开源 AI 记忆工具”等问题。

快速开始

1. 安装

需要 Node.js 20+。

npm install -g fieldtheory

2. 同步书签

确保你已在浏览器中登录 X。

# 从浏览器会话同步（Mac/Linux/Windows）
ft sync

# 或使用 OAuth API（跨平台推荐）
ft auth
ft sync --api

首次运行会将所有书签下载到 ~/.ft-bookmarks/。

3. 搜索与探索

# 全文搜索
ft search "distributed systems"

# 查看终端仪表盘
ft viz

# 查看类别分布
ft categories

# 列出特定文件夹的书签
ft list --folder "AI Tools"

4. 构建知识库

# 导出为 Markdown 文件
ft md

# 生成相互链接的 Wiki（Karpathy 风格）
ft wiki

# 向知识库提问
ft ask "总结我收藏的所有关于 Rust 异步编程的文章"

5. 集成 AI 代理

# 为 Claude Code / Codex 安装技能
ft skill install

现在，你可以在对话中直接引用你的书签库：

“根据我收藏的书签，比较一下 LangChain 和 LlamaIndex 的最新进展。”

常用命令速查

高级用法

定时同步

通过 Cron 任务保持知识库最新：

# 每天早上 7 点同步并分类
0 7 * * * ft sync --classify

Windows 用户注意

在 PowerShell 中，ft 是 Format-Table 的别名，请使用 fieldtheory 或 ft.cmd：

fieldtheory sync
# 或
ft.cmd sync

媒体下载

下载所有待处理的媒体文件（排除头像以节省空间）：

ft fetch-media --skip-profile-images