Field Theory CLI
把 X 书签同步到本地，供终端代理检索、整理和执行工作流。
按维度查看评分与理由
证据显示：README 明确说明数据本地存储、无遥测、无分析，且 OAuth 令牌以 chmod 600 存储，并警告用户将令牌视为密码。SECURITY.md 提供了漏洞报告流程，并强调不要共享敏感数据。但缺少对权限最小化的明确说明，例如未说明 CLI 是否请求超出所需的最小权限。用户确认方面，README 提到某些操作（如 `ft library delete`）会移动文件到废纸篓，但未明确说明是否在破坏性操作前请求确认。数据流透明度方面，README 说明了数据存储位置和网络请求（仅同步时访问 X API），但未详细说明所有数据流。敏感数据处理方面，README 和 SECURITY.md 提供了处理 cookies 和令牌的指导，但未提供代码级验证。依赖安全方面，package.json 列出了依赖，但未提供安全审计或漏洞扫描证据。外部影响方面，README 提到 `ft install app` 会下载并安装应用，但未说明是否请求用户确认。回滚方面，README 提到 `ft library delete` 会移动文件到废纸篓，但未提供其他回滚机制。来源归属方面，README 列出了仓库家族，但未提供详细的贡献者信息。扣分原因：缺少对权限最小化、用户确认、回滚和来源归属的明确证据。
证据显示：README 和测试文件展示了 CLI 的功能，测试覆盖了多个模块，但未提供完整的测试结果或覆盖率。依赖可用性方面，package.json 列出了依赖，但未提供依赖的可用性保证或镜像。失败消息方面，测试中未明确展示失败消息的处理，但代码中可能有错误处理。扣分原因：依赖可用性和失败消息的证据不足。
证据显示：README 描述了多种使用场景，包括个人书签管理、知识库构建、代理集成等，并提供了平台支持矩阵。能力边界方面，README 列出了命令和功能，但未明确说明不支持的功能。触发精度方面，命令和选项描述清晰，但未提供详细的触发条件。环境适配方面，README 提供了 Windows 和 macOS 的注意事项，但未提供所有平台的详细配置。扣分原因：能力边界和触发精度的证据不足。
证据显示：README 提供了清晰的命令文档、安装说明、示例和平台支持，信息架构合理。命名稳定性方面，命令名称和选项在 README 中一致。已知限制方面，README 提到了一些限制，如 Windows 上 `ft` 别名冲突，但未全面列出。许可证方面，MIT 许可证文件存在。版本控制方面，package.json 有版本号，但未提供变更日志。维护责任方面，README 提供了问题跟踪和贡献指南，但未明确维护者。扣分原因：已知限制、版本变更日志和维护责任的证据不足。
证据显示：README 展示了 CLI 的输出格式，如 `ft viz` 的终端仪表盘，但未提供实际输出示例。边际价值方面，CLI 提供了多种功能，但未与其他工具比较。成本效益方面，CLI 是免费开源的，但未提供性能或资源使用数据。扣分原因：输出可用性、边际价值和成本效益的证据不足。
证据显示：README 中的声明大多有代码或测试支持，但未提供独立的验证。跨来源佐证方面，README 提到了仓库家族，但未提供其他来源的验证。事实与推断分离方面，README 区分了功能描述和推荐，但未明确标注推断。扣分原因：声明可追溯性、跨来源佐证和事实推断分离的证据不足。
- 该 CLI 会读取浏览器会话 cookie 以同步书签，用户应确保在可信环境中使用，并注意 cookie 的敏感性。
- OAuth 令牌存储在本地，用户应确保文件权限正确，并避免泄露。
- `ft install app` 会下载并安装应用，用户应确认来源可信。
- 该仓库的发布者身份未经验证，用户应谨慎评估信任度。
这个 Agent 能做什么，适合哪些场景？
Field Theory CLI 是面向 X 书签的本地优先命令行工具，同时也是 Field Theory Mac app 的命令行配套组件。它将书签缓存为 JSONL，并建立 SQLite FTS5 搜索索引，支持搜索、筛选、统计、可视化和分类。它还能把书签导出为 Markdown，生成互相链接的知识库，并通过 `ft ask` 对该知识库提问。CLI 管理 `~/.fieldtheory/library` 中的本地 Library 页面和 `~/.fieldtheory/commands` 中的可移植命令。具备 shell 权限的 Claude Code、Codex 或其他代理可通过安装 `/fieldtheory` skill 使用这些本地上下文。
运行 ft sync 时，工具从已登录 X 的受支持浏览器本地 cookie 数据库读取会话 cookie，调用 X 的内部 GraphQL API 下载书签；也可先执行 ft auth，再以 ft sync --api 通过 OAuth API 同步。它将原始数据写入 ~/.fieldtheory/bookmarks/bookmarks.jsonl，并用 bookmarks.db 中的 SQLite FTS5 索引提供 ft search <query> 的 BM25 排名搜索。ft classify 和 ft classify-domains 使用 LLM 给书签分类，ft md 导出逐条 Markdown，ft wiki 编译互链知识库，ft lint 检查或修复可修复的 wiki 问题。ft library 子命令可搜索、创建、带 SHA-256 冲突保护地更新、移入废纸篓或在 Mac app 中打开 Library 页面；ft commands 可创建、列出和验证可移植命令。
- 一位重度 X 用户希望每天把新书签同步到本地，并用
ft search查找过去收藏的分布式系统资料。 - 研究人员需要把书签导出为 Markdown，并用
ft wiki和ft ask将收藏内容整理为可检索知识库。 - 使用 Claude Code 或 Codex 的开发者希望代理在处理任务时检索自己的书签和本地 Field Theory Library。
- Field Theory Mac app 用户需要从终端创建或更新 Library 页面，并通过
ft library open在打包版应用中打开它们。 - 维护多个本地仓库的用户想用
ft possible、保存的书签种子和仓库集，生成后续工作机会的提示与后台任务。
这个 Agent 有哪些优点和局限？
- 默认同步直接利用本地浏览器会话，无需 X API；同时提供
ft auth和ft sync --api的 OAuth 路径。 - 原始 JSONL 缓存、SQLite FTS5/BM25 搜索索引和 Markdown 导出都存放在本地
~/.fieldtheory路径下。 - 从同步、媒体补全、分类到 wiki、问答和 lint，覆盖了书签到本地知识库的完整命令行流程。
- 提供 Claude Code 与 Codex 的
/fieldtheoryskill 安装，并能管理可被 Field Theory 和代理使用的可移植命令。
- 核心数据源是 X 书签；默认同步依赖已登录 X 的本地浏览器会话及 X 的内部 GraphQL API。
- 虽然多数书签功能列为跨平台，产品明确以 Mac 为设计目标，Library 打开和 Mac app 安装功能依赖 macOS 生态。
- 默认同步的浏览器支持和故障处理存在平台差异；Windows 上 Firefox 需要 Node.js 22.5+ 或 PATH 中的
sqlite3。 - LLM 分类虽被支持，但文档未说明可选模型、计费方式或离线分类能力。
如何安装或部署这个 Agent？
安装前需要 Node.js 20+。执行：
npm install -g fieldtheory进行默认会话同步时，需要 Chrome 系、Firefox 等受支持浏览器且其中已登录 X；首次可运行：
ft sync若使用跨平台 OAuth 同步，先运行 ft auth，然后运行：
ft sync --api如何使用这个 Agent？
先同步并搜索：
ft sync
ft search "distributed systems"可查看概览：
ft viz
ft categories
ft stats导出并构建知识库：
ft md
ft wiki
ft ask "你的问题"若要让 Claude Code 或 Codex 使用本地书签上下文，运行：
ft skill install这个 Agent 与同类方案有什么区别？
同步方式有两条明确路径：默认 ft sync 使用浏览器会话和 X 的内部 GraphQL API；ft auth 加 ft sync --api 使用官方 v2 OAuth API，并标注为跨平台。CLI 与 Field Theory Mac app、Codex plugin 和发布仓库分属不同仓库：CLI 负责命令行问题，Mac app 源码和插件问题应分别提交到对应项目。
常见问题
是否需要支付 X API 费用？
ft sync 不需要 API，会使用受支持浏览器中的已登录 X 会话。官方 API 路径需要通过 ft auth 配置 OAuth。它会保存浏览器 cookie 吗？
~/.fieldtheory/bookmarks/oauth-token.json，并设置为 owner-only。可否在 Windows 上使用？
fieldtheory 或 ft.cmd，因为 ft 已是内建别名。代理能直接使用什么能力？
ft skill install 会为 Claude Code 和 Codex 安装 /fieldtheory skill；任何具备 shell 权限的代理也可调用 CLI 命令访问本地数据。