企业官网建设流程全解析

CLI 与 Mac App 无缝协作：Field Theory CLI 的 Library、便携命令与 ft install app 完整指南

【免费下载链接】fieldtheory-cliField Theory CLI for bookmarks, Library, commands, and agent workflows项目地址: https://gitcode.com/gh_mirrors/fi/fieldtheory-cli

Field Theory CLI 是一款本地优先（local-first）的命令行工具，帮你把 X（Twitter）书签同步到本地、管理Field Theory Library知识库、创建便携命令（portable commands），还能用一条ft install app命令下载安装官方 Mac App，并与 Claude Code、Codex 等 AI 助手深度集成。无论你是想给终端装一个"第二大脑"，还是想让 CLI 与 Mac 图形界面无缝协作，这篇指南都能帮你一次上手。

💡 一句话定位：CLI 是 Mac App 的"命令行伴侣"——它知道本地~/.fieldtheory目录结构，能直接在 App 里打开页面，也能帮你装 App。

为什么需要 Field Theory CLI？

大多数书签工具只停留在"存下来"，而 Field Theory CLI 的野心是把你收藏的内容变成可搜索、可问答、可协作的知识网络。它的特点：

• 📥数据全本地：书签、Library、命令都存放在你的电脑上，无遥测、无后台上传。
• 🤖Agent 友好：任何有 shell 权限的 AI 助手都能调用它检索你的收藏。
• 🖥️CLI + App 双端：终端里改的东西，图形界面里立刻能打开、能同步。

安装只需一行（需要 Node.js 20+）：

npm install -g fieldtheory

装好之后，ft就是你的新命令。下面聚焦三个最能体现"CLI 与 Mac App 协作"的功能。

一、Field Theory Library：本地 Markdown 知识库

Library是 Field Theory 的"知识底座"——一个纯 Markdown 文件夹，默认位于~/.fieldtheory/library/。你可以用它存读书笔记、研究笔记、灵感卡片，所有操作都可以通过命令行完成，也都能在 Mac App 里可视化查看。

常用 Library 命令速查

两个贴心设计

冲突保护：更新页面时可以带上--expected-sha256，只有文件哈希匹配才允许写入，避免多端同时编辑时互相覆盖——这对你和 AI 助手"共写一本笔记"尤其有用。

一键在 App 中打开：ft library open是协作的关键。它会通过包 App 的 bundle id（com.fieldtheory.app）直接定位到已安装的 Field Theory，而不会误信系统里全局的fieldtheory://处理器，避免错误地唤起其他开发中的 Electron 应用。相关逻辑见 src/app-open.ts。

ft library create notes/agent-memory.md --stdin ft library open notes/agent-memory.md

在终端写笔记，回车一下就能在漂亮的图形界面里阅读和批注——这就是"无缝"的含义。

二、便携命令：把"流程"也变成可复用的资产

Portable commands（便携命令）是 Field Theory 的一大特色：它是一个个 Markdown 文件，描述"某件事怎么做"——像标准操作手册（SOP），既能被人阅读，也能被 Field Theory 和 AI 助手直接执行。

它们默认存放在~/.fieldtheory/commands/下，核心命令有三：

• 📋ft commands list：列出所有便携命令
• ✍️ft commands new <名称>：创建一个带标准模板的新命令
• ✅ft commands validate [名称]：检查命令格式与"护栏"（guardrails）是否合规

新建命令时会自动生成一套结构清晰的模板，包含"用途 / 步骤 / 护栏 / 验证"四个部分，帮你把模糊的经验沉淀成可执行的流程。命令文件的创建与校验逻辑在 src/commands-files.ts。

ft commands new release-checklist ft commands validate release-checklist

💡 提示：便携命令与 Library 共享同一套"Markdown + 版本哈希"的读写模型，所以你甚至可以用ft library open把命令也带到 App 里查看。

三、ft install app：一条命令装好 Mac App

如果你还没装 Field Theory 的图形界面，CLI 也能帮你搞定。ft install app会从官方发布源拉取最新打包版本，自动完成"下载 → 挂载 → 安装到 /Applications"。

它的几个工程细节很讲究（见 src/app-install.ts）：

• 🍎仅支持 macOS（App 本体是 Mac 应用）
• 🎯自动优先选择 arm64 版本的 DMG，Apple 硅芯片用户更顺滑
• 🔄原子化替换：先备份旧版、再安装新版，失败自动回滚，不会把应用装坏

ft install app

装好 App 后，CLI 与 App 就正式"联机"了——共享同一个本地目录，双向可见。

四、CLI 与 Mac App 如何"无缝"协作？

理解协作机制，关键在于两个 App 共用一个数据之家：~/.fieldtheory/。目录结构大致如下：

~/.fieldtheory/ bookmarks/ # X 书签原始缓存 + SQLite 全文索引 library/ # Markdown 知识库（ft library 管理） Commands/ # 便携命令（ft commands 管理） ideas/ # Possible 种子、运行、后台任务

这些路径的解析逻辑集中在 src/paths.ts，也允许你用环境变量（如FT_LIBRARY_DIR）自定义位置。

深链打开（Deep Link）是协作的另一半：CLI 通过fieldtheory://协议的链接把"要打开哪一页"告诉 App，再由 App 渲染出来。你可以用FT_APP_DEV_DIR把 CLI 指向日志开发中的 App 检出目录，方便开发者联调：

export FT_APP_DEV_DIR=/Users/you/dev/fieldtheory/mac-app ft library open notes/example.md

一句话总结这条链路：

CLI 读写本地文件 → 生成深链 → Mac App 打开并可视化 → App 负责远程同步

五、加分项：让 AI 助手"看懂"你的收藏

装好 CLI 后，强烈建议再装一个 Agent 技能，让 AI 在相关时自动去搜你的书签：

ft skill install # 自动检测 Claude Code 与 Codex

然后直接对 AI 提需求，例如："我过去三年收藏过哪些癌症研究相关内容？进展如何？"——AI 会借助ft去检索并总结。技能安装逻辑见 src/skill.ts。

常见问题（FAQ）

Q：我的数据安全吗？A：数据全部留在本地~/.fieldtheory/，无遥测、无分析、无上传。CLI 只在同步书签时向 X 发起网络请求。

Q：能在 Linux / Windows 上用吗？A：书签同步、搜索、分类、Library 等核心功能跨平台可用；但ft install app和"在 App 中打开页面"是 macOS 专属。

Q：CLI 和 Mac App 会冲突吗？A：不会。两者共享同一份本地数据，CLI 负责读写与深链，App 负责可视化与远程同步，各司其职。

小结

Field Theory CLI 把"命令行"变成了 Mac App 的得力助手，三个最值得上手的功能：

1. 📚Library——本地 Markdown 知识库，终端写、App 里读。
2. 🧩便携命令——把操作流程沉淀成可复用、可校验的资产。
3. 🚀ft install app——一条命令装好并升级 Mac App。

配合ft skill install，它还能无缝接入你的 AI 工作流。想了解全部命令，可直接运行ft --help，或阅读项目说明 README.md 与核心实现 src/library.ts、src/commands-files.ts。

现在打开终端，敲下ft，开始搭建属于你的"第二大脑"吧。

【免费下载链接】fieldtheory-cliField Theory CLI for bookmarks, Library, commands, and agent workflows项目地址: https://gitcode.com/gh_mirrors/fi/fieldtheory-cli