fx - 基于终端的编码代理

什么是 fx？

fx 是一款使用 Zig 编写的基于 CLI 的编码代理。它专为在终端中运行而设计，以原生进程形式工作，并可通过嵌入或基于协议的集成融入更大型的系统。该项目强调小型二进制文件、最少的输出，以及一种更接近 Unix shell 而非完整终端 IDE 的工作流。

文档将 fx 描述为与模型无关的开源项目，采用 Apache-2.0 许可证。你可以在项目目录中以交互方式使用它，跨会话恢复工作，或通过 fx ask 以非交互方式运行。同一运行时还可通过 Agent Client Protocol 对外提供服务，或编译为 WebAssembly，以供基于 JavaScript 的界面使用。

fx 能做什么？

精简的原生 CLI

fx 是一款终端优先的编码代理，提供类似 shell 的界面，旨在保持输出简洁并聚焦当前工作区。

交互与非交互模式

用户可以使用 `fx` 开始新会话，使用 `fx resume` 继续已有会话，或使用 `fx ask` 发送单次请求。

感知工作区的执行

当前目录会成为主要工作区，读取、搜索和列出文件等命令都会在该上下文中运行。

具备权限感知的操作

fx 以自动权限模式启动，会审查敏感调用，并在可能修改文件或运行命令的操作前进行提示。可以使用 `/permissions` 更改权限模式。

多种部署方式

同一代理可以原生运行于终端中，通过 `fx acp` 经由 ACP 提供服务，或通过实验性的 WebAssembly SDK 从 JavaScript 加载。

可扩展的代理运行时

文档提到 skills、插件、MCP、浏览器集成，以及可配置的 SDK 行为，用于处理身份验证、存储、命令执行和网络请求。

使用场景

“基于终端的代码辅助”

在代码仓库中工作，让 fx 检查文件、解释代码、添加测试或运行测试套件，同时在工具调用发生时查看实时记录。

“基于会话的开发工作流”

恢复之前的工作、查看已保存的会话，并在稍后返回项目时找回上下文。

“嵌入式编码代理界面”

将 fx 作为编辑器、应用或服务背后的运行时，在无需从头构建代理的情况下提供编码代理能力。

“JavaScript 或浏览器托管的代理体验”

当需要无头代理或交互式终端式界面时，将 WebAssembly 构建版本加载到 JS 应用中。

“带审批的受控自动化”

在文件访问和命令执行需要经过审查后才能运行的环境中使用 fx。

常见问题

fx 是什么？

fx 是一款基于 CLI 的 AI 编码代理和工具框架，用于在终端中处理代码，或将代理嵌入其他系统。

如何开始使用？

文档展示了使用 `curl -fsSL https://fx.sh/setup.sh | bash` 进行安装，随后使用 `fx login` 完成 Vercel 身份验证，或设置 AI Gateway API 密钥。

fx 可以在没有交互式终端会话的情况下运行吗？

可以。文档介绍了用于单次请求的 `fx ask`，以及用于查看和配置的 `fx status`、`fx models` 和 `fx permissions` 等命令。

fx 是否只能与一个模型提供商配合使用？

不是。该网站将 fx 描述为与模型无关，适用于本地模型、网关、直接访问提供商 API 或订阅服务。

fx 可以嵌入其他产品吗？

可以。文档介绍了原生 ACP 支持，以及用于基于 JavaScript 集成的实验性 WebAssembly SDK。

fx