Field Theory CLI(命令名 ft)用于把 X/Twitter 书签同步到本地,建立可检索的本地库,并可按类别、领域、作者、时间等维度查询,方便个人知识管理与 AI 智能体调用。安装命令为 npm install -g fieldtheory,要求 Node.js 20+;默认同步模式在 macOS 上需已登录 X 的 Google Chrome,Linux/Windows 需改用 OAuth 模式。
主要命令:ft sync 增量同步书签(--classify 同步后自动分类,--full 全量抓取,--api 走 OAuth API);ft search 进行 BM25 全文搜索;ft list 支持 --author、--category、--domain、--since 等过滤;ft show 查看单条书签;ft classify 用 LLM 分类,--regex 为无需 LLM 的正则分类;ft index 重建索引;ft viz 终端仪表盘;ft categories、ft domains、ft stats、ft path 查看统计与数据路径;ft fetch-media 下载书签中的静态图片。
数据默认保存在 ~/.ft-bookmarks/,包含 bookmarks.jsonl、SQLite FTS5 索引 bookmarks.db、元数据 bookmarks-meta.json;OAuth 令牌存放在 oauth-token.json 并设为 chmod 600。可用 FT_DATA_DIR 环境变量自定义数据目录,并可通过 crontab 定时执行同步。内置类别包括 tool、security、technique、launch、research、opinion、commerce。
可将 bookmarks.jsonl 直接用于 TypeScript/Node.js 脚本,或只读查询 SQLite 索引;也可在智能体脚本中调用 ft 命令。安全方面数据全部本地保存,无遥测,同步之外无外部调用。平台限制:Chrome 会话同步仅支持 macOS,其余平台需先 ft auth 再 ft sync --api。具体价格与更多细节资料未提供。