# fx

fx 是一款小巧、开放且原生的编码代理与命令行工具，可在终端中处理代码，支持本地或云端推理，并便于研究、嵌入和集成到更大型系统中。

- Findings24: <https://findings24.com/zh-CN/tools/fx>
- 网站: <https://fx.sh>
- 价格: Freemium
- 分类: AI 趣味工具

## 什么是 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。

## 快速信息

- **类别**: 开发者工具
- **平台**: CLI、原生进程、ACP、WebAssembly
- **主要用户**: 在代码仓库中工作的开发者，或将编码代理嵌入系统的团队
- **许可证**: Apache-2.0
- **源域名**: fx.sh
- **状态**: 实验性