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-cliField Theory CLI 是一款本地优先local-first的命令行工具帮你把 XTwitter书签同步到本地、管理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 20npm install -g fieldtheory装好之后ft就是你的新命令。下面聚焦三个最能体现CLI 与 Mac App 协作的功能。一、Field Theory Library本地 Markdown 知识库Library是 Field Theory 的知识底座——一个纯 Markdown 文件夹默认位于~/.fieldtheory/library/。你可以用它存读书笔记、研究笔记、灵感卡片所有操作都可以通过命令行完成也都能在 Mac App 里可视化查看。常用 Library 命令速查命令作用ft library search 关键词在本地 Library 的 Markdown 中全文搜索ft library show 路径打印某一页及版本元信息ft library create 路径 --stdin新建一页ft library update 路径 --stdin --expected-sha256 hash带冲突保护的更新ft library delete 路径移到废纸篓可恢复ft library open 路径在 Field Theory Mac App 里打开该页两个贴心设计冲突保护更新页面时可以带上--expected-sha256只有文件哈希匹配才允许写入避免多端同时编辑时互相覆盖——这对你和 AI 助手共写一本笔记尤其有用。一键在 App 中打开ft library open是协作的关键。它会通过包 App 的 bundle idcom.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仅支持 macOSApp 本体是 Mac 应用自动优先选择 arm64 版本的 DMGApple 硅芯片用户更顺滑原子化替换先备份旧版、再安装新版失败自动回滚不会把应用装坏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。常见问题FAQQ我的数据安全吗A数据全部留在本地~/.fieldtheory/无遥测、无分析、无上传。CLI 只在同步书签时向 X 发起网络请求。Q能在 Linux / Windows 上用吗A书签同步、搜索、分类、Library 等核心功能跨平台可用但ft install app和在 App 中打开页面是 macOS 专属。QCLI 和 Mac App 会冲突吗A不会。两者共享同一份本地数据CLI 负责读写与深链App 负责可视化与远程同步各司其职。小结Field Theory CLI 把命令行变成了 Mac App 的得力助手三个最值得上手的功能Library——本地 Markdown 知识库终端写、App 里读。便携命令——把操作流程沉淀成可复用、可校验的资产。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CLI 与 Mac App 无缝协作：Field Theory CLI 的 Library、便携命令与 ft install app 完整指南
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-cliField Theory CLI 是一款本地优先local-first的命令行工具帮你把 XTwitter书签同步到本地、管理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 20npm install -g fieldtheory装好之后ft就是你的新命令。下面聚焦三个最能体现CLI 与 Mac App 协作的功能。一、Field Theory Library本地 Markdown 知识库Library是 Field Theory 的知识底座——一个纯 Markdown 文件夹默认位于~/.fieldtheory/library/。你可以用它存读书笔记、研究笔记、灵感卡片所有操作都可以通过命令行完成也都能在 Mac App 里可视化查看。常用 Library 命令速查命令作用ft library search 关键词在本地 Library 的 Markdown 中全文搜索ft library show 路径打印某一页及版本元信息ft library create 路径 --stdin新建一页ft library update 路径 --stdin --expected-sha256 hash带冲突保护的更新ft library delete 路径移到废纸篓可恢复ft library open 路径在 Field Theory Mac App 里打开该页两个贴心设计冲突保护更新页面时可以带上--expected-sha256只有文件哈希匹配才允许写入避免多端同时编辑时互相覆盖——这对你和 AI 助手共写一本笔记尤其有用。一键在 App 中打开ft library open是协作的关键。它会通过包 App 的 bundle idcom.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仅支持 macOSApp 本体是 Mac 应用自动优先选择 arm64 版本的 DMGApple 硅芯片用户更顺滑原子化替换先备份旧版、再安装新版失败自动回滚不会把应用装坏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。常见问题FAQQ我的数据安全吗A数据全部留在本地~/.fieldtheory/无遥测、无分析、无上传。CLI 只在同步书签时向 X 发起网络请求。Q能在 Linux / Windows 上用吗A书签同步、搜索、分类、Library 等核心功能跨平台可用但ft install app和在 App 中打开页面是 macOS 专属。QCLI 和 Mac App 会冲突吗A不会。两者共享同一份本地数据CLI 负责读写与深链App 负责可视化与远程同步各司其职。小结Field Theory CLI 把命令行变成了 Mac App 的得力助手三个最值得上手的功能Library——本地 Markdown 知识库终端写、App 里读。便携命令——把操作流程沉淀成可复用、可校验的资产。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考