源码系统概览
文章正文
FuXi 是一款住在终端里的 AI 编程智能体，官方代号一画开天，提供 TUI 界面的代码读取、文件修改、命令执行与工具调用能力。
本仓库承载 FuXi 的官方文档、演示素材与落地页，产品本体以单静态二进制分发，源码闭源，个人与团队可免费使用。
源码简介
FuXi 采用思考、行动、验证循环工作，推理任务后用工具修改文件、运行命令并检查结果，直到测试全绿与 PR 就绪。
内置 50 多种工具，覆盖文件读写、shell、ripgrep 搜索、网页抓取、LSP 诊断、Jupyter 与通过 MCP 的浏览器控制。
智能路由按请求复杂度评分分配模型档位，简单任务用轻量模型，困难任务用强模型，并支持自动故障转移与主备竞速。
单个静态二进制文件没有运行时依赖，macOS、Linux 与 Windows 均可用，安装后自动加入用户 PATH。
需要说明的是，产品源码为闭源授权，产品由上海翊太科技有限公司发布，当前版本 0.1.2，仓库提供的是官方文档、演示与安装指引，GitHub 已有 972 颗星。
适用场景
适合在终端里完成代码修复、测试驱动开发与代码审查的开发者，例如修复失败的测试并跑通整个测试套件。
适合需要管理多个 LLM 提供商的团队，支持 OpenAI 兼容端点、Gemini、Bedrock 与 Vertex，成本感知路由自动分配模型。
适合希望数据自控的用户，API 密钥保存在本地配置目录，也可以使用 FuXi OAuth 登录托管模型。
与 Claude Code 这类终端 AI 编程工具相比，FuXi 更强调提供商中立与成本路由，而不是绑定单一模型厂商。
功能亮点
50 多种内置工具与并行子智能体全部装在一个二进制里，支持后台任务与 shell 命令执行。
安全护栏在 shell 命令执行前用 AST 分类器与规则集过滤，配合细粒度权限、操作审计与显式权限模型。
会话记录持久化到磁盘，检查点支持恢复、回滚与分叉，空闲期梦境整理跨会话整合记忆。
MCP 客户端、hooks、skills、plugins 与自定义斜杠命令全部支持热重载，插件市场位于 fuxicode.com。
自动更新会先校验 SHA-256 再原子替换二进制，不会留下安装到一半的状态。
对比开源终端智能体 OpenHands，FuXi 以单二进制分发并提供 OAuth 托管模型，OpenHands 则完整开源可二次开发。
| 维度 | FuXi | Claude Code |
|---|---|---|
| 技术栈 | 单静态二进制，闭源分发 | 闭源 CLI 工具 |
| 部署复杂度 | 一条安装命令，无运行时依赖 | 需 Node.js 环境 |
| 功能侧重 | 多提供商成本路由、MCP、TUI | Anthropic 模型深度集成 |
技术架构与部署指南
技术栈与运行环境
前端：TUI 终端界面，仓库内置 index.html 官方落地页。
后端：产品本体为静态二进制，源码闭源，未在本仓库发布。
数据库：会话与记忆持久化到本地磁盘目录，无外部数据库依赖。
运行环境：macOS、Linux 或 Windows，安装后二进制位于 ~/.local/bin。
其他依赖：OpenAI 兼容端点、Gemini、Bedrock、Vertex 等模型提供商，可选 MCP 服务器与插件。
安装与部署提示
macOS 与 Linux 执行 curl 安装脚本，Windows 在 PowerShell 中执行 irm 安装命令。
安装后运行 fuxi doctor 做环境自检，fuxi verify 验证与模型提供商的连通性。
首次启动会在 ~/.fuxi 目录生成配置，可以选择 fuxi login 登录托管模型，或自带密钥写入 config.yaml。
多提供商管理使用分层 schema，providers 目录加 model 选择，也可用 fuxi wizard 交互式配置。
升级与安装是同一条命令，再次运行安装脚本即可原地升级。
截图与演示说明
启动 fuxi 进入 TUI 界面，顶部为输入框，主区域展示模型回复与工具调用过程。
斜杠命令面板按 / 呼出，支持模型切换、费用查看、上下文统计、会话压缩与 git 提交等操作。
内置演示 GIF 展示修复失败测试、运行测试套件与新增功能的完整流程。
docs 目录提供快捷键速查、常见问题与对比图，落地页展示产品定位与核心特性。
常见问题
问：FuXi 需要付费吗？
产品本体永久免费，个人、团队与企业均无需许可费用，模型调用按提供商计费。
问：本仓库包含产品源码吗？
不包含，产品源码闭源，仓库提供官方文档、演示素材、安装指引与 issue 追踪。
问：支持哪些模型提供商？
支持 OpenAI 兼容端点、Gemini、Bedrock 与 Vertex，也可用 FuXi OAuth 托管模型。
问：安装需要什么依赖？
单个静态二进制，无运行时依赖，安装脚本会自动加入用户 PATH。
安全风险提示
本次检查未发现恶意文件，仓库内容为文档与安装指引。
路径：README 安装脚本；类型：远程脚本安装；证据：安装命令从 releases.fuxicode.com 拉取脚本执行；建议：安装前核对脚本内容与校验和。
路径：~/.fuxi/config.yaml；类型：密钥存储；证据：模型 API Key 写入本地配置文件；建议：妥善保护配置目录权限。
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本仓库为官方闭源产品的文档与发布仓库，下载内容不包含产品源码，请通过官方安装脚本获取二进制。
最后更新：2026-08-18。
GitHub项目开源地址：https://github.com/fuxicodex/Fuxi
