架构概述
Infinia 是一个 AI 原生的流程编排平台。其核心是「规划-执行」智能体：它把自然语言目标拆解为多步业务流程，并统一调度三类扩展面 —— .fyp 插件、.fys 技能、进程内 AI 工具。在架构上，4.0.0 是一个三层系统：一个无头 Spring Boot 后端、一个 Vue 3 单页应用，以及一个掌控进程生命周期的 Electron 桌面外壳。同一套 Vue UI 既可以在浏览器标签页中运行，也可以在 Electron 窗口里运行——外壳改变的只是后端的启动方式和 UI 的服务方式。
三层结构
┌─────────────────────────────────────────────────────────────────┐
│ Electron desktop shell (desktop/, TypeScript 主进程) │
│ • spawns / owns the Java backend process │
│ • exposes window.fengyu.{apiBase, token, pickFile, ...} via │
│ contextBridge before page load │
│ • serves the built SPA in a sandboxed BrowserWindow │
│ • kills the backend on app quit (close → hide to tray) │
└───────────────┬───────────────────────────────┬─────────────────┘
│ spawns (release) │ loads HTML/JS
▼ │
┌──────────────────────────────────┐ │
│ Headless Spring Boot backend │ │
│ fan.summer.fengyu.HeadlessLauncher │
│ • binds 127.0.0.1:24056 │ │
│ • token-gated REST + SSE │ │
│ • spawns plugin worker processes│ │
│ • Spring Boot 4.1.0 + Spring AI │ │
└───────────────┬──────────────────┘ │
│ HTTP (loopback only) │
▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ Vue 3 SPA (frontend/, TypeScript) │
│ Pinia + vue-router 4 + vue-i18n 10, Vuetify 3 (MD3) │
│ • talks to the backend over the loopback HTTP API │
│ • loads plugin UI micro-frontends via the MF host │
└─────────────────────────────────────────────────────────────────┘请求流
每一个来自 UI 的请求都走同一条环回路径：
- SPA（在浏览器中或 Electron BrowserWindow 中）向后端发起一个 HTTP 请求。
- 该请求指向
127.0.0.1:<port>，其中<port>是后端在启动时以FENGYU_PORT=<n>打印出来的值（默认24056）。 - 后端的
TokenAuthFilter检查X-FengYu-Token头。不携带匹配令牌的请求会被拒绝——有三类豁免：/api/health、/api/setup/*，以及/plugin-runtime/{id}/**下的静态插件 UI 资产。 - 通过鉴权的请求到达控制器，后者可能会通过 JSON-RPC 2.0 把工作派发给进程外的插件 Worker。
仅绑定环回地址
后端强制 server.address=127.0.0.1。它不会监听任何外部网络接口——API 只能从运行该进程的同一台机器访问。这是首要的网络安全边界：没有任何方式能从另一台主机访问该 API。
每次启动的令牌鉴权
每一次后端启动都由单个令牌进行鉴权：
- 启动器接受
--token=<t>CLI 参数，并把它存为系统属性fengyu.auth.token。 - 每个受保护的请求都必须携带
X-FengYu-Token: <t>。 - 该令牌在每次启动时重新生成；不存在持久化的凭据。桌面外壳在页面加载前通过
window.fengyu.token()这个 contextBridge 快照把它暴露给 SPA。
环回绑定与每次启动的令牌相结合，使得即使进程正在运行，API 也只对本地用户可见。
各层职责
| 层 | 负责内容 |
|---|---|
| 后端 | REST/SSE 接口、持久化、AI 后端、插件 Worker 生命周期、鉴权 |
| 前端 | Vue 3 SPA、Pinia store、插件 UI 挂载、初始化向导路由 |
| 桌面端 | 后端拉起/健康检查/初始化编排、contextBridge API、窗口 + 托盘生命周期 |
| 插件系统 | .fyp 包契约、进程外 Worker、沙箱化 UI |
扩展面与智能体
智能体编排三类各自独立的扩展面，每一类出于不同原因而隔离：
- 插件（
.fyp） 以进程外 JSON-RPC Worker 运行 —— Worker 崩溃永远不会拖垮宿主，且 Worker 绝不触碰宿主的 Spring 上下文或 JPA 会话。其 UI 是沙箱化的微前端。参见插件系统。 - 技能（
.fys） 是渐进式插件包：只有其精简目录存在于系统提示词中，完整内容通过内置的skill工具按需加载。参见技能。 - AI 工具 是进程内的 Spring AI
ToolCallbackbean，模型在对话中可直接调用。参见 AI 工具。
关于智能体端到端可驱动的能力，参见功能特性的能力矩阵。