fuxicodex/Fuxi

二〇二六年九月八日·★ 2,671·⑂ 73·Python·NOASSERTION ·最新发布 0.1.2 · 2026-08-06 · GitHub 原仓库

摘要

FuXi 是一个终端 AI 编程 agent，用 Go 构建，以单个静态二进制分发，无运行时依赖。它提供 Think → Act → Verify agent 循环，支持 50+ 内置工具（文件读写、shell、ripgrep、LSP 诊断、Jupyter、浏览器操作等），具备成本感知路由、自动故障转移、安全护栏、持久会话与记忆、MCP 客户端及自动更新功能。支持任意兼容 OpenAI 的模型，提供方无关，个人、团队或企业均免许可费用。项目由 FUXI 开发，发布于 GitHub，采用专有许可证。

FuXi

English | 简体中文

一个驻留在你终端里的 AI 编程 agent。

FuXi 是一个快速、自包含的终端 AI 编程 agent——读取代码、编辑文件、运行命令，并通过丰富的 TUI 驱动工具，支持跨 LLM 提供方的成本感知路由和自动故障转移。它用 Go 构建，以单个静态二进制文件分发，无运行时依赖。可以把它看作 Claude Code 的提供方无关替代品：接入任意兼容 OpenAI 的模型，即可在其之上获得 agent 化的 Think → Act → Verify 循环。

终端优先 · 提供方无关 · 自带密钥 · MCP 客户端 · 自动更新

主页：https://www.fuxicode.com

curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash   # 安装
fuxi                                                        # 启动

FuXi 运行演示

FuXi 能做什么

其 agent 化的 Think → Act → Verify 循环和智能路由让任何兼容 OpenAPI 的模型都能超越其原始 benchmark 表现——已在可复现任务集上对照另一编程 agent 验证（见 benchmark）。

亮点

模型是引擎，FuXi 是载体。 模型本身只能回答问题；FuXi 将其转化为一个工作者——推理、在你的真实代码库上行动、验证结果，并以可控的成本和方式完成这一切。

FuXi 架构

Think → Act → Verify 循环

智能路由

提升任意模型能力

50+ 内置工具——文件读写/编辑、shell（bash / PowerShell）、ripgrep 搜索、网页抓取、LSP 诊断、Jupyter、浏览器操作、后台任务和并行子 agent——全部集成在一个二进制文件中。
安全护栏——shell 命令在执行前经过 AST 安全分类器；细粒度权限和审计日志让自主工作始终处于你的掌控之下。
持久会话与记忆——对话记录持久化到磁盘；检查点支持恢复、回滚或分叉；空闲时"做梦"机制跨会话整合记忆；长对话自动压缩以节省 token。
自带密钥，或直接登录——任意提供方 API 密钥（兼容 OpenAPI、Gemini、Bedrock/Vertex），或通过 FuXi OAuth 登录。
可扩展——MCP 客户端、hooks、技能、插件和斜杠命令，全部支持热重载。
永久免费——单个静态二进制，无运行时依赖，个人、团队或企业均免许可费用。
自动更新——后台版本检查，一条命令 fuxi update，替换运行中二进制前会校验 checksum。

FuXi 对比

FuXi 是一个终端优先的 AI 编程 agent，设计为提供方无关。功能可用性反映各产品截至 2026 年中公开文档化的定位；细节变化很快，请将其视为方向性参考。

实测对比

FuXi vs Claude Code 实测对比

两个系统均通过各自原生客户端驱动，在相同基线和同一客观评分器（pytest + coverage）下，覆盖 15 个微维度和 4 个大项目维度。完整方法论、原始结果、环境版本、确切命令和已知限制见 benchmark/REPORT.md，你可以自行验证或重新运行。

坦诚说明：这是一个小规模、自运行的任务集——并非第三方 benchmark——且衡量的是 agent 循环，而非原始模型分数。请将其视为一个数据点，而非头条数字。

评估与基准

FuXi 的构建目标就是被诚实衡量。目前它未发布第三方 benchmark（如 SWE-bench、Terminal-Bench 或 Aider polyglot benchmark）的公开分数。我们更倾向于可复现、可自行验证的评估，而非头条数字——以下是你如何在自己的工作上自行评估 FuXi。

实用评估清单

安装与自检——安装后运行 fuxi doctor 验证环境（配置、API 密钥、git、ripgrep），再运行 fuxi verify 确认提供方连接。通过检查是基线。
复现真实任务——在自己项目中挑一个失败的测试，让 FuXi 修复它；然后扩展模块并重新运行测试套件（上方演示展示的正是这一流程）。在若干日常任务中重复：代码审查、提交、PR、重构。
并排对比——用另一个工具运行相同的任务、模型和上下文，比较：正确性、工具覆盖、成本和迭代时间。在同一基础上评判才能保证公平。

FuXi 暴露了对比所需的一切——TUI 内的 /cost、/usage、/context 和 /status——并自带环境自检（fuxi doctor）。未来发布的 benchmark 将从此部分链接。

安装

macOS / Linux

curl -fsSL https://releases.fuxicode.com/bootstrap.sh | bash

Windows (PowerShell)

irm https://releases.fuxicode.com/bootstrap.ps1 | iex

Windows (CMD)

curl -fsSL https://releases.fuxicode.com/install.cmd -o "%TEMP%\fuxi-install.cmd" && "%TEMP%\fuxi-install.cmd"

三种方式均安装到 ~/.local/bin（Windows 上为 %USERPROFILE%\.local\bin），若不在其中则将其添加到你的用户 PATH。之后再次运行同一命令即可就地升级现有安装——安装和升级是同一个命令。

默认安装最新版本；可通过参数指定特定版本，例如 ./bootstrap.sh 0.1.2 或 ./bootstrap.ps1 0.1.2。

验证安装

fuxi --version
fuxi doctor      # 环境健全性检查（配置、API 密钥、git、ripgrep、...）

卸载

# macOS / Linux
rm -f "$HOME/.local/bin/fuxi"
rm -rf "$HOME/.fuxi"   # 可选：同时删除配置/状态

# Windows (PowerShell)
Remove-Item -Force "$env:USERPROFILE\.local\bin\fuxi.exe"
Remove-Item -Recurse -Force "$env:USERPROFILE\.fuxi"   # 可选

快速开始

启动 TUI：

fuxi

首次运行时 FuXi 会在 ~/.fuxi/ 下创建配置。你需要一个模型来对话，可通过以下两种方式之一：

登录——fuxi login 打开浏览器以你的 FuXi 账户认证，自动配置 FuXi 托管的模型。无需 API 密钥。
自带密钥——通过环境变量设置提供方 API 密钥，或直接编写 ~/.fuxi/config.yaml（fuxi init 生成起始模板，并根据已设置的环境变量自动检测提供方）：
```
provider: openapi
base_url: https://your-endpoint/v1
api_key: <your-key>       # 或改为导出 FUXI_API_KEY
model: your-model
```
需要管理多个提供方/模型而非单个？使用分层 schema——providers: 目录加上 model: 选择层：
```
providers:
  custom:
    type: openapi
    base_url: https://your-endpoint/v1
    api_key: <your-key>
    models:
      - id: your-model-id
model:
  active: { provider: custom, id: your-model-id }
```
分层 schema 支持多个提供方和按模型设置。

或运行 fuxi wizard 进行交互式设置流程（选择提供方、输入 base URL/密钥、选择模型、测试连接）。

模型配置完成后，可随时用 /model 切换，用 /config 管理其余设置——所有内容（权限、hooks、技能、插件）都通过 TUI 内的斜杠命令驱动。

使用指南

完整的分步指南——从安装到高级功能——见 docs/usage.md。本节为快速参考。

命令行参数

启动 fuxi 时的常用参数，按用途分组。完整参考见 fuxi --help。

领域	参数	用途
模型	`-m, --model <name>`	覆盖本次运行的模型
	`-P, --provider <type>`	提供方类型：`anthropic` \| `openapi`
	`-b, --base-url <url>`	覆盖 base URL（启用 OpenAPI 提供方）
	`-k, --api-key <key>`	覆盖本次运行的 API 密钥
会话	`-r, --resume <sessionId>`	恢复特定历史对话
	`-c, --continue`	继续此目录中最近的对话
	`--session-id <uuid>`	使用特定会话 ID（必须是有效 UUID）
	`--fork-session`	恢复时创建新会话 ID 而非复用原 ID
	`--prefill <text>`	预填 prompt 输入但不提交
	`-d, --dir <path>`	工作目录
权限	`--permission-mode <mode>`	`default` \| `plan` \| `bypassPermissions`
	`--auto`	自动批准安全工具调用（分类器门控，带熔断器）
	`--dangerously-skip-permissions`	跳过所有权限检查（危险）
思考	`--thinking <mode>`	`enabled` \| `adaptive` \| `disabled`
	`--effort <level>`	`low` \| `medium` \| `high` \| `max`
	`--max-tokens <n>`	每次 API 调用的最大输出 token 数
工具与 MCP	`--tools <tools...>`	限制内置工具集（`""` = 无，`default` = 全部，或名称列表）
	`--mcp-config <configs...>`	从 JSON 字符串或文件路径加载 MCP 服务器
	`--strict-mcp-config`	仅使用 `--mcp-config` 中的 MCP 服务器
检查	`--status`	打印解析后的提供方状态并退出
	`--config`	打印解析后的配置并退出
调试	`--debug [pattern]`	启用调试日志，可选按模式过滤
	`--verbose`	启用详细日志
	`-v, --version` / `-h, --help`	版本 / 完整参数与命令参考

fuxi --help 还列出系统 prompt 覆盖、工具限制、采样控制和 swarm/agent 参数。

子命令

命令	功能
`fuxi`（或 `fuxi tui`）	启动交互式 TUI
`fuxi login`	登录 FuXi 账户，然后配置 API 凭据
`fuxi setup-token`	登录并打印 token 以导出为 `FUXI_OAUTH_TOKEN`（headless/CI）
`fuxi wizard`	TUI 设置向导：提供方、base URL、密钥、模型、连接测试
`fuxi init [--force]`	生成 `~/.fuxi/config.yaml` 模板（从环境变量自动检测提供方）
`fuxi doctor`	对环境运行诊断检查
`fuxi verify`	验证提供方连接
`fuxi info`	显示提供方和模型信息
`fuxi update [version]`	下载并安装发布版本（checksum 验证，原子操作）
`fuxi agents`	列出按来源分组的已配置 agent
`fuxi proxy`	启动智能路由代理（提供方之间的协议桥接）
`fuxi launch [args]`	通过代理启动被代理的二进制，使用你的 FuXi 配置
`fuxi mcp serve`	将 FuXi 自身作为 MCP stdio 服务器运行
`fuxi remote-control`	作为云端远程控制 worker 运行（`--remote-control` 的别名）

TUI 内斜杠命令

输入 / 并按 Enter（或 Tab 自动补全）浏览所有命令：

命令	功能
`/help`, `/commands`, `/menu`	显示或搜索所有命令
`/model`	切换当前模型
`/config`	打开配置
`/status`	显示提供方状态
`/context`	显示当前上下文窗口使用量
`/cost`, `/usage`	会话成本 / 套餐用量限制
`/compact`	压缩对话历史以释放上下文
`/clear`	清空对话
`/history`, `/resume`	浏览或恢复历史会话/检查点
`/tools`	列出可用工具
`/permissions`	显示当前权限配置
`/memory`	显示项目记忆文件
`/fork`	显示 fork-agent 统计
`/away`	列出或显示存储的会话 away 摘要
`/commit`	创建 git 提交
`/review`	审查代码 / 创建 PR
`/doctor`	运行诊断检查
`/copy`, `/paste`	复制最后一条回复 / 将剪贴板文本作为下一条 prompt 发送
`/exit`	退出

键盘与输入： / 后按 Enter 打开命令浏览器 · Tab 自动补全斜杠命令 · Ctrl+R 搜索 prompt 历史 · Ctrl+V 或终端粘贴直接粘贴到输入框 · 括号粘贴处理大段粘贴。完整快捷键参考见 docs/keybindings.md。

更新

FuXi 在后台检查新版本，有可用更新时打印一行提示。就地更新：

fuxi update            # 最新版
fuxi update 0.1.2      # 特定版本

fuxi update 下载目标构建，对照已发布 manifest 验证其 SHA-256，并原子替换运行中的二进制——绝不会留下部分安装的版本。用 --no-update-notifier 或 NO_UPDATE_NOTIFIER=1 抑制后台检查。

配置

配置目录： ~/.fuxi/（可用 FUXI_CONFIG_DIR 覆盖）。
配置文件： ~/.fuxi/config.yaml——提供方、模型、思考/努力程度、路由偏好和按端点覆盖。FuXi 运行期间更改会热重载。fuxi init 生成起始模板，/config 在 TUI 内管理设置。
优先级： 环境变量 > config.yaml > 内置默认值。
项目设置： 已检入的项目设置文件（权限、hooks）按项目生效。
插件： 第一方市场位于 fuxicode.com/plugins。

关键环境变量：

变量	用途
`FUXI_BASE_URL` / `FUXI_API_KEY` / `FUXI_MODEL`	兼容 OpenAPI 的提供方配置
`FUXI_THINKING_MODE` / `FUXI_THINKING_EFFORT`	`auto\|enabled\|disabled` / `low\|medium\|high\|max`
`FUXI_CONFIG_DIR`	覆盖配置目录（默认 `~/.fuxi`）
`FUXI_DEBUG`	设为 `1` 启用调试日志
`NO_UPDATE_NOTIFIER`	设为 `1` 抑制后台更新检查提示
`FUXI_TEMPERATURE` / `FUXI_TOP_P` / `FUXI_SEED`	采样控制

运行 fuxi --help 获取完整环境变量参考，包括沙箱限制和 MCP 资源上限。

项目结构

本仓库托管 FuXi 的文档、发布安装器和 issue 跟踪器。产品源码为专有代码，不在此发布（见许可证）。

README.md / README.zh-CN.md — 主文档（英文 / 简体中文）
docs/ — 演示 GIF、对比图、使用指南、键盘参考、FAQ
CHANGELOG.md — 发布历史
CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, SUPPORT.md — 社区与支持指南
security-privacy/ — 安全与隐私计划：治理章程、政策、标准、流程、全球合规矩阵和信任中心

许可证

译自 GitHub · 项目涌现 · 录于二〇二六年九月八日