Skip to main content

​
常见问题

FIM One 与任何OpenAI兼容的LLM提供商配合使用。这包括：
  • 商业API — OpenAI、DeepSeek、Anthropic（Claude）、阿里巴巴通义千问、Google Gemini，以及任何公开/v1/chat/completions端点的提供商。
  • 本地/自托管 — Ollama、vLLM、LocalAI、LM Studio，以及任何其他提供OpenAI兼容API格式的运行时。
你可以通过.env中的三个环境变量配置提供商：
有关提供商特定的示例，请参阅快速开始指南。
可以。FIM One连接到任何实现OpenAI兼容API格式的端点。常见的自托管选项包括：当提供商不需要身份验证时，将LLM_API_KEY设置为任何非空字符串（例如ollama）。所有智能体功能——ReAct推理、DAG规划、工具调用——无论模型是本地还是云托管，都以相同方式工作。
FIM One在源代码可用许可证下发布。这不是OSI批准的开源许可证，但为大多数用例提供了广泛的自由：允许的用途：
  • 在你的组织内部使用
  • 修改和自定义开发
  • 保持许可证完整的分发
  • 嵌入到你自己的（非竞争）应用程序中
受限的用途：
  • 多租户SaaS产品
  • 竞争性智能体平台
  • 白标或移除品牌
如有商业许可询问，请在GitHub上提交issue。完整条款请参阅LICENSE。
可以——收费不是许可证限制的内容。你可以向单个客户交付基于FIM One的解决方案，前提是这是一个专用的单租户部署，供该客户自己内部使用，且FIM One品牌保持完整。以下三种情况需要单独的商业许可证：
  • 白标 — 移除或隐藏FIM One品牌，使其以客户品牌发布。（这是代理商和集成商最常见的问题。）
  • 多租户重用 — 从一个共享部署为多个客户服务，或任何”FIM One即服务”产品。
  • 竞争平台 — 使用FIM One构建另一个智能体编排、工作流或任务规划平台。
有关完整分解，请参阅许可证页面上的常见场景。
不要为敏感漏洞开设公开GitHub issue。
  • 敏感报告（凭证泄露、身份验证绕过、注入等）— 使用GitHub安全公告或发送邮件至security@fim.ai。
  • 低严重性问题（缺失头部、信息披露）— 使用security标签开设常规GitHub issue。
所有报告在48小时内（工作日）得到确认。关键问题尽快修补；其他问题随下一个版本发布。有关范围、响应时间表和自托管最佳实践，请参阅完整的安全政策。

​
部署

最低要求：生产环境推荐：Docker 替代方案： Docker 20+ 和 Docker Compose v2。无需本地 Python 或 Node.js——所有内容都在容器内构建。
支持。Docker 和本地开发都支持 ARM 架构，包括 Apple Silicon（M1/M2/M3/M4）Mac。Docker 镜像原生构建为 linux/arm64，所有 Python 和 Node.js 依赖都有 ARM 兼容的 wheels 或备选方案。
FIM One 以两种不同的方式使用数据库：1. 内部数据库（FIM One 自身数据）：
  • SQLite ——零配置默认选项，适合开发和单工作进程部署。
  • PostgreSQL ——推荐用于生产环境，多工作进程设置（WORKERS > 1）时必需。
2. 连接器目标（您连接的系统）：FIM One 可以通过数据库连接器连接到外部数据库作为数据源：每个数据库连接器自动生成三个工具：list_tables、describe_table 和 query。默认包含架构内省、AI 驱动的注释和只读查询执行。
可以。FIM One 从一开始就为多租户部署而构建：
  • JWT 身份验证 ——基于令牌的身份验证，具有每用户会话隔离。
  • 组织隔离 ——资源（智能体、连接器、MCP 服务器）的作用域限定在组织内。知识库对其所有者保持私密，永远不会直接共享。
  • 基于角色的访问 ——管理员和用户角色，具有适当的权限边界。
  • 资源所有权 ——对话和配置按用户隔离。
对于多用户生产部署，使用 PostgreSQL 作为内部数据库，并将 WORKERS 设置为与预期并发相匹配。

​
功能

FIM One 提供两个执行引擎，各自适合不同的任务类型：自动模式（默认模式）使用快速 LLM 分类器分析每个传入查询，并自动将其路由到最优引擎。您也可以通过聊天 UI 中的三向切换开关手动选择模式（自动/标准/规划器）。如需深入了解，请参阅执行模式。
FIM One 提供三种创建连接器的方式——无需 Python 代码：1. 导入 OpenAPI 规范 — 上传 YAML、JSON 或指向 OpenAPI 规范的 URL。FIM One 解析规范并自动生成包含所有操作的连接器。2. AI 聊天构建器 — 用自然语言描述您想要连接的 API。AI 在对话中生成并迭代连接器配置，使用 10 个专门的构建器工具进行设置、操作、测试和智能体接线。3. MCP 协议 — 直接连接任何 MCP（模型上下文协议）服务器。第三方 MCP 生态系统开箱即用。对于数据库连接器，配置连接详情（主机、端口、凭证），FIM One 会自动生成模式内省和查询工具。请参阅 AI 构建器文档和扩展指南获取分步说明。
可以。FIM One 的副驾驶模式专门为嵌入主机系统而设计。您可以通过以下方式集成：
  • iframe — 将 FIM One 聊天界面直接嵌入任何网页。
  • 小部件 — 轻量级聊天小部件，覆盖在现有 UI 上。
  • API — 直接使用 FastAPI 后端进行完全自定义集成。
在副驾驶模式下，AI 在用户熟悉的界面中与用户协作——查询数据、生成报告和编排操作，无需强制用户切换应用程序。请参阅执行模式了解独立、副驾驶和中心交付模式的配置详情。
FIM One 支持 6 种语言（英语、中文、日语、韩语、德语、法语），采用完全自动化的翻译管道：
  1. 仅编辑英文源文件 — frontend/messages/en/*.json 中的 UI 字符串、docs/*.mdx（根级别）中的文档和 README.md。
  2. 提交时自动翻译 — 预提交钩子检测对英文文件的更改，并通过项目的快速 LLM 进行翻译。翻译是增量的：仅处理新增、修改或删除的内容。
  3. 切勿手动编辑翻译文件 — messages/zh/、messages/ja/、docs/zh/、docs/ja/ 等中的文件都是自动生成的，将被覆盖。
克隆后设置翻译钩子：
强制完全重新翻译：

​
贡献

FIM One 欢迎各种形式的贡献 — 代码、文档、翻译、错误报告和功能建议。快速开始：
  1. 阅读贡献指南了解设置说明、编码规范和 PR 流程。
  2. 浏览好的第一个问题查找适合新手的精选任务。
  3. 查看开放问题了解错误和功能请求。
先驱计划： 前 100 位获得 PR 合并的贡献者将被认可为创始贡献者，获得永久署名、个人资料徽章和优先问题支持。
代码库遵循异步优先、协议优先的架构，零供应商锁定。
  • 文档 — 您正在这里。浏览指南、概念和配置部分。
  • Discord — 加入 FIM One Discord 获取实时帮助和社区讨论。
  • GitHub Issues — 在 GitHub 上提交错误报告和功能请求。
  • Twitter/X — 关注 @FIM_One 获取更新和公告。