Merge pull request #1716 from Runfusion/feature/update-readme
docs: refresh README with feature showcase and media
This commit is contained in:
gsxdsm
256
README.es.md
256
README.es.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### De idea inicial a código en producción — automáticamente.
|
||||
|
||||
**Orquestador de agentes multinodo** — tareas, agentes, misiones, git, archivos y worktrees, con cualquier modelo, local o en la nube.
|
||||
### 🏭 Una fábrica de software, gestionada por un orquestador multiagente.
|
||||
|
||||
Describe lo que quieres — un equipo de agentes de IA lo **planifica, construye, revisa y entrega** por ti. Fusion es tu fábrica de software: una línea de montaje para el código que opera a través de tareas, agentes, misiones, git, archivos y worktrees, con cualquier modelo, local o en la nube.
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -45,6 +45,72 @@ Un tablero. Controlado desde cualquier lugar. Laptop, Mac mini, servidor Linux,
|
||||
|
||||
---
|
||||
|
||||
## Inicio rápido
|
||||
|
||||
**Sin instalación, directo desde npm:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
Esto lanza el panel. Los subcomandos se pasan directamente: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (O de forma explícita: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**Instalador en una línea** (macOS y Linux — usa Homebrew automáticamente, recurre a npm como alternativa):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS y Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # o: fn dashboard
|
||||
```
|
||||
|
||||
O en una sola línea (añade el tap automáticamente): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # o: fusion dashboard
|
||||
```
|
||||
|
||||
**Desde un clon** (para desarrollo):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Luego haz clic en la URL `Open:` que aparece en la terminal. Incorpora un token de portador
|
||||
(`http://localhost:4040/?token=fn_...`) que el navegador guarda en
|
||||
`localStorage` en la primera visita y reutiliza automáticamente. En el lado del
|
||||
servidor, Fusion ahora persiste el token del panel/daemon en
|
||||
`~/.fusion/settings.json` en la primera ejecución autenticada y lo reutiliza en
|
||||
inicios posteriores a menos que lo sobreescribas (`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`) o deshabilites la autenticación con `--no-auth`. Consulta
|
||||
[Referencia CLI → fn dashboard → Autenticación](./docs/cli-reference.md#fn-dashboard)
|
||||
para conocer la precedencia completa y las opciones de restablecimiento/revocación.
|
||||
|
||||
### Configuración inicial
|
||||
|
||||
En el primer lanzamiento, Fusion abre el **asistente de incorporación** con tres pasos guiados:
|
||||
|
||||
1. **Configuración de IA** — Usa una lista de proveedores simplificada para el inicio rápido (proveedores recomendados más los ya conectados), luego expande la **Configuración avanzada de proveedores** solo si necesitas proveedores adicionales o detalles de configuración. Solo necesitas un proveedor para comenzar. Las entradas de proveedor obsoletas de Google Gemini CLI / Antigravity están intencionalmente ocultas; las rutas de clave API de Google/Gemini, Google Generative AI, Vertex y Cloud Code permanecen disponibles.
|
||||
2. **GitHub (Opcional)** — Conecta GitHub para importar issues y gestionar PRs
|
||||
3. **Primera tarea** — Crea tu primera tarea o impórtala desde GitHub (si no hay ningún proyecto activo, la incorporación primero te pedirá que registres/selecciones un directorio de proyecto)
|
||||
|
||||
El asistente se puede **descartar y no bloquea** — haz clic en **Omitir por ahora** para usar el panel de inmediato. Vuélvelo a activar más tarde desde **Configuración → Autenticación → Reabrir guía de incorporación**.
|
||||
|
||||
### Móvil
|
||||
|
||||
Para el flujo de trabajo con Capacitor + PWA, consulta [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## El flujo
|
||||
|
||||
```
|
||||
@@ -87,6 +153,122 @@ Cada tarea muestra su plan, sus revisiones, sus diffs y sus cambios de archivos
|
||||
|
||||
---
|
||||
|
||||
## Míralo en acción
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
Las superficies más recientes de Fusion, de un vistazo — control de misión, workflows visuales, chat de agentes, salas multiagente y correo entre agentes.
|
||||
|
||||
### 🛰️ Command Center — control de misión para tu flota de agentes
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
Una sola pantalla para todo lo que hacen tus agentes. Ajusta en vivo la capacidad del planificador, observa el gasto de tokens por modelo en tiempo real y demuestra el valor con números concretos.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>Tokens</b> — gasto por modelo, en caché vs. entrada vs. salida, a lo largo del tiempo.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>Productividad</b> — resultados, percentiles de duración, mezcla de lenguajes.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>Equipo</b> — organigrama de agentes y participación de tokens por agente.</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Herramientas · Actividad · Productividad · Equipo · Ecosistema · GitHub · Señales · Sistema · Fiabilidad · Control de misión — cada pestaña es una lente distinta sobre la misma flota en vivo.
|
||||
|
||||
**La misma flota, a tu manera** — Command Center (y todo el panel) se re-estiliza en vivo en más de **70 temas de color**. Aquí está en Shadcn Light y Shadcn Dark Gray:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>Una docena de temas claros y una docena de temas oscuros</b> (clic para expandir)</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 Workflows seleccionables, creados visualmente
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
El recorrido de una tarea desde la idea hasta el merge es un **workflow** — y tú lo eliges y le das forma. Elige uno integrado (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering y más), inspecciona su grafo, luego duplícalo y personaliza columnas, puertas, canales de modelo y política de revisión en el [Editor de workflows](./docs/workflow-editor.md) visual. Sin necesidad de bifurcar el motor.
|
||||
|
||||
Aquí está el grafo de **Stepwise coding** — planifica, ejecuta y revisa cada paso antes del siguiente — explorado nodo a nodo en Shadcn Light y Dark Gray:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ Chat de agentes — habla con tus agentes, en pleno vuelo
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
Chat directo y chat por tarea con cualquier agente, en cualquier modelo. Pregunta por qué falló una tarea, orienta un enfoque, suelta adjuntos, responde tarjetas de preguntas en chat y reanuda los streams donde los dejaste — con renderizado completo de markdown y código en todo momento.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 Salas de chat multiagente
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
Coloca varios agentes en una sala y deja que se coordinen. Menciona a un miembro y responde directamente; los miembros ambientales pueden sumarse a la conversación hasta un límite. Aquí los agentes **CEO**, **Product Manager** y **CTO** se alinean sobre la propiedad de la tarea en `#leads` — sin ningún humano en el bucle. ([Documentación de chat](./docs/dashboard-guide.md#chat-view))
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 Correo de agentes — una bandeja de entrada entre tus agentes
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
Un buzón incorporado para delegación, aclaraciones y traspasos. Los agentes registran resúmenes de triage, solicitan aprobaciones y coordinan el trabajo en toda la flota — con vistas de Bandeja de entrada, Bandeja de salida, Agentes y Aprobaciones, para que puedas auditar cada intercambio.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Cómo funciona
|
||||
|
||||
```mermaid
|
||||
@@ -225,72 +407,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## Inicio rápido
|
||||
|
||||
**Sin instalación, directo desde npm:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
Esto lanza el panel. Los subcomandos se pasan directamente: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (O de forma explícita: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**Instalador en una línea** (macOS y Linux — usa Homebrew automáticamente, recurre a npm como alternativa):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS y Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # o: fn dashboard
|
||||
```
|
||||
|
||||
O en una sola línea (añade el tap automáticamente): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # o: fusion dashboard
|
||||
```
|
||||
|
||||
**Desde un clon** (para desarrollo):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Luego haz clic en la URL `Open:` que aparece en la terminal. Incorpora un token de portador
|
||||
(`http://localhost:4040/?token=fn_...`) que el navegador guarda en
|
||||
`localStorage` en la primera visita y reutiliza automáticamente. En el lado del
|
||||
servidor, Fusion ahora persiste el token del panel/daemon en
|
||||
`~/.fusion/settings.json` en la primera ejecución autenticada y lo reutiliza en
|
||||
inicios posteriores a menos que lo sobreescribas (`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`) o deshabilites la autenticación con `--no-auth`. Consulta
|
||||
[Referencia CLI → fn dashboard → Autenticación](./docs/cli-reference.md#fn-dashboard)
|
||||
para conocer la precedencia completa y las opciones de restablecimiento/revocación.
|
||||
|
||||
### Configuración inicial
|
||||
|
||||
En el primer lanzamiento, Fusion abre el **asistente de incorporación** con tres pasos guiados:
|
||||
|
||||
1. **Configuración de IA** — Usa una lista de proveedores simplificada para el inicio rápido (proveedores recomendados más los ya conectados), luego expande la **Configuración avanzada de proveedores** solo si necesitas proveedores adicionales o detalles de configuración. Solo necesitas un proveedor para comenzar. Las entradas de proveedor obsoletas de Google Gemini CLI / Antigravity están intencionalmente ocultas; las rutas de clave API de Google/Gemini, Google Generative AI, Vertex y Cloud Code permanecen disponibles.
|
||||
2. **GitHub (Opcional)** — Conecta GitHub para importar issues y gestionar PRs
|
||||
3. **Primera tarea** — Crea tu primera tarea o impórtala desde GitHub (si no hay ningún proyecto activo, la incorporación primero te pedirá que registres/selecciones un directorio de proyecto)
|
||||
|
||||
El asistente se puede **descartar y no bloquea** — haz clic en **Omitir por ahora** para usar el panel de inmediato. Vuélvelo a activar más tarde desde **Configuración → Autenticación → Reabrir guía de incorporación**.
|
||||
|
||||
### Móvil
|
||||
|
||||
Para el flujo de trabajo con Capacitor + PWA, consulta [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## Documentación
|
||||
|
||||
| Guía | Qué cubre |
|
||||
|
||||
266
README.fr.md
266
README.fr.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### De l'idée brute au code de production — automatiquement.
|
||||
|
||||
**Orchestrateur d'agents multi-nœuds** — tâches, agents, missions, git, fichiers et worktrees, avec n'importe quel modèle, local ou cloud.
|
||||
### 🏭 Une usine logicielle, pilotée par un orchestrateur multi-agents.
|
||||
|
||||
Décrivez ce que vous voulez — une équipe d'agents IA le **planifie, le construit, le révise et le livre** pour vous. Fusion est votre usine logicielle : une chaîne de montage pour le code qui s'étend sur les tâches, les agents, les missions, git, les fichiers et les worktrees, avec n'importe quel modèle, local ou cloud.
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -45,6 +45,73 @@ Un tableau. Contrôlé de n'importe où. Laptop, Mac mini, serveur Linux, VM clo
|
||||
|
||||
---
|
||||
|
||||
## Démarrage rapide
|
||||
|
||||
**Sans installation, directement depuis npm :**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
Cela lance le tableau de bord. Les sous-commandes passent directement : `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Ou de façon verbeuse : `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**Installateur en une ligne** (macOS et Linux — choisit automatiquement Homebrew, bascule sur npm en secours) :
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS et Linux) :
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # ou : fn dashboard
|
||||
```
|
||||
|
||||
Ou en une ligne (tap automatique) : `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global** :
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # ou : fusion dashboard
|
||||
```
|
||||
|
||||
**Depuis un clone** (pour le développement) :
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Cliquez ensuite sur l'URL `Open:` affichée dans le terminal. Elle intègre un jeton bearer
|
||||
(`http://localhost:4040/?token=fn_...`) que le navigateur capture dans
|
||||
`localStorage` à la première visite et réutilise automatiquement par la suite. Côté
|
||||
serveur, Fusion persiste désormais le jeton du tableau de bord/démon dans
|
||||
`~/.fusion/settings.json` à la première exécution authentifiée et le réutilise
|
||||
lors des démarrages ultérieurs, sauf si vous le remplacez (`--token`,
|
||||
`FUSION_DASHBOARD_TOKEN`, `FUSION_DAEMON_TOKEN`) ou désactivez l'authentification
|
||||
avec `--no-auth`. Voir
|
||||
[Référence CLI → fn dashboard → Authentification](./docs/cli-reference.md#fn-dashboard)
|
||||
pour la précédence complète et les options de réinitialisation/révocation.
|
||||
|
||||
### Configuration au premier lancement
|
||||
|
||||
Au premier lancement, Fusion ouvre l'**assistant d'intégration** en trois étapes guidées :
|
||||
|
||||
1. **Configuration IA** — Utilisez la liste simplifiée de fournisseurs de démarrage rapide (fournisseurs recommandés et fournisseurs déjà connectés), puis développez les **Paramètres avancés du fournisseur** uniquement si vous avez besoin de fournisseurs supplémentaires ou de détails de configuration. Un seul fournisseur suffit pour commencer. Les entrées de fournisseurs dépréciés Google Gemini CLI / Antigravity sont intentionnellement masquées ; les chemins clé API Google/Gemini, Google Generative AI, Vertex et Cloud Code restent pris en charge.
|
||||
2. **GitHub (optionnel)** — Connectez GitHub pour l'import de tickets et la gestion des PR
|
||||
3. **Première tâche** — Créez votre première tâche ou importez depuis GitHub (si aucun projet n'est actif, l'assistant vous invite d'abord à enregistrer/sélectionner un répertoire de projet)
|
||||
|
||||
L'assistant est **dismissable et non bloquant** — cliquez sur **Ignorer pour l'instant** pour utiliser le tableau de bord immédiatement. Relancez-le plus tard depuis **Paramètres → Authentification → Rouvrir le guide d'intégration**.
|
||||
|
||||
### Mobile
|
||||
|
||||
Pour le workflow Capacitor + PWA, voir [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## Le flux
|
||||
|
||||
```
|
||||
@@ -71,13 +138,13 @@ Chaque tâche affiche son plan, ses révisions, ses diffs et ses modifications d
|
||||
| | |
|
||||
|---|---|
|
||||
| 🧠 **Planification IA** | Décrivez une tâche en langage naturel. Les agents de planification la transforment en plan `PROMPT.md` avec étapes, périmètre des fichiers et critères d'acceptation. |
|
||||
| 🔁 **Portes de workflow** | Plan → Révision → Exécution → Révision à chaque étape. Les portes pré-fusion bloquent le mauvais code ; les portes post-fusion effectuent des vérifications informatives. |
|
||||
| 🔁 **Workflows sélectionnables** | Les workflows intégrés couvrent le codage, les correctifs rapides, le travail à forte révision, l'exécution par étapes, le Compound Engineering activé par plugin et les fragments de cycle de vie de PR. Choisissez un workflow par tâche ou créez-en des personnalisés dans l'[Éditeur de workflows](./docs/workflow-editor.md). |
|
||||
| 🌳 **Isolation par worktree** | Chaque tâche s'exécute dans sa propre branche et son propre worktree (`fusion/{task-id}`). Tâches parallèles. Zéro conflit. Délégation [worktrunk](https://github.com/max-sixty/worktrunk) optionnelle via [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (voir [abstraction WorktreeBackend](./docs/architecture.md#worktreebackend-abstraction)). |
|
||||
| ⚡ **Fusion intelligente** | Toutes les portes franchies ? Fusion effectue un squash-merge et passe à la suite. Activez la validation manuelle où vous le souhaitez. |
|
||||
| ⚡ **Fusion intelligente** | Toutes les portes franchies ? Fusion effectue un squash-merge et passe à la suite. Activez la validation manuelle où vous le souhaitez, héritez du défaut global d'auto-fusion en direct, ou définissez des remplacements auto/manuel explicites par tâche. |
|
||||
| 🛰️ **Maillage multi-nœuds** | Laptop, Mac mini, serveur Linux, VM cloud, téléphone — tout synchronisé. Bureau, mobile, web. |
|
||||
| 🧩 **N'importe quel modèle** | Anthropic, OpenAI, Ollama et plus encore. Local et cloud coexistent. |
|
||||
| 🧩 **N'importe quel modèle** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, runtimes locaux et [fournisseurs personnalisés](./docs/dashboard-guide.md#custom-providers) définis par l'utilisateur. Local et cloud coexistent, avec des voies de modèle/fallback de workflow configurables par projet. |
|
||||
| 🏢 **Entreprises d'agents** | Importez des équipes prédéfinies — plus de 440 agents répartis dans 16 entreprises — et faites-les fonctionner de façon autonome pendant des semaines. |
|
||||
| 📬 **Messagerie inter-agents** | Boîte aux lettres intégrée entre agents. Déléguer, clarifier, coordonner. |
|
||||
| 📬 **Messagerie inter-agents** | Boîte aux lettres intégrée entre agents. Déléguer, clarifier, coordonner ; les agents au rôle d'ingénieur peuvent activer la réclamation automatique du backlog quand vous voulez de l'aide à l'implémentation au-delà du retrait réservé à l'exécuteur. |
|
||||
| 🗨️ **Chat d’agents** | Chat direct, chat de tâche, pièces jointes, cartes de questions, flux reprenables et salles multi-agents expérimentales où les membres mentionnés répondent directement et les membres ambiants peuvent participer jusqu’à un plafond. ([Docs Chat](./docs/dashboard-guide.md#chat-view)) |
|
||||
| 🗺️ **Missions** | Planification hiérarchique (Mission → Jalon → Tranche → Fonctionnalité → Tâche) avec pilotage automatique et contrats de validation. |
|
||||
| 🔬 **Recherche** | Exécutions de recherche délimitées avec recherche web, GitHub, docs locaux et synthèse LLM (plus prise en charge intégrée de WebSearch/WebFetch dans les flux de planification et de synthèse lorsque disponible). Transformez les résultats en tâches. ([Docs](./docs/research.md)) |
|
||||
@@ -86,6 +153,122 @@ Chaque tâche affiche son plan, ses révisions, ses diffs et ses modifications d
|
||||
|
||||
---
|
||||
|
||||
## Voir en action
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
Les surfaces les plus récentes de Fusion, en un coup d'œil — contrôle de mission, workflows visuels, chat d'agents, salles multi-agents et messagerie inter-agents.
|
||||
|
||||
### 🛰️ Command Center — le contrôle de mission de votre flotte d'agents
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
Un seul écran pour tout ce que font vos agents. Ajustez la capacité du planificateur en direct, suivez la dépense de tokens par modèle en temps réel et prouvez la valeur avec des chiffres concrets.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>Tokens</b> — dépense par modèle, en cache vs. entrée vs. sortie, dans le temps.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>Productivité</b> — résultats, percentiles de durée, mix de langages.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>Équipe</b> — organigramme des agents et part de tokens par agent.</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Outils · Activité · Productivité · Équipe · Écosystème · GitHub · Signaux · Système · Fiabilité · Mission Control — chaque onglet est un angle différent sur la même flotte en direct.
|
||||
|
||||
**La même flotte, à votre façon** — Command Center (et tout le tableau de bord) se re-thématise en direct sur **plus de 70 thèmes de couleurs**. Le voici en Shadcn Light et Shadcn Dark Gray :
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>Une douzaine de thèmes clairs & une douzaine de thèmes sombres</b> (cliquer pour développer)</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 Workflows sélectionnables, créés visuellement
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
Le parcours d'une tâche, de l'idée à la fusion, est un **workflow** — et c'est à vous de le choisir et de le façonner. Choisissez un workflow intégré (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering et plus encore), inspectez son graphe, puis dupliquez et personnalisez les colonnes, les portes, les voies de modèle et la politique de révision dans l'[Éditeur de workflows](./docs/workflow-editor.md) visuel. Aucun fork du moteur requis.
|
||||
|
||||
Voici le graphe **Stepwise coding** — planifier, exécuter et réviser chaque étape avant la suivante — exploré nœud par nœud en Shadcn Light et Dark Gray :
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ Chat d'agents — parlez à vos agents, en plein vol
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
Chat direct et chat par tâche avec n'importe quel agent, sur n'importe quel modèle. Demandez pourquoi une tâche a échoué, orientez une approche, déposez des pièces jointes, répondez aux cartes de questions intégrées et reprenez les flux là où vous les avez laissés — rendu complet du markdown et du code de bout en bout.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 Salles de chat multi-agents
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
Placez plusieurs agents dans une salle et laissez-les se coordonner. Mentionnez un membre et il répond directement ; les membres ambiants peuvent rejoindre la conversation jusqu'à un plafond. Ici, les agents **CEO**, **Product Manager** et **CTO** s'accordent sur l'attribution des tâches dans `#leads` — sans humain dans la boucle. ([Docs Chat](./docs/dashboard-guide.md#chat-view))
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 Messagerie d'agents — une boîte de réception entre vos agents
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
Une boîte aux lettres intégrée pour la délégation, la clarification et les passations. Les agents déposent des résumés de triage, demandent des approbations et coordonnent le travail à travers la flotte — avec les vues Boîte de réception, Boîte d'envoi, Agents et Approbations, pour que vous puissiez auditer chaque échange.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## Comment ça fonctionne
|
||||
|
||||
```mermaid
|
||||
@@ -224,73 +407,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## Démarrage rapide
|
||||
|
||||
**Sans installation, directement depuis npm :**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
Cela lance le tableau de bord. Les sous-commandes passent directement : `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Ou de façon verbeuse : `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**Installateur en une ligne** (macOS et Linux — choisit automatiquement Homebrew, bascule sur npm en secours) :
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS et Linux) :
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # ou : fn dashboard
|
||||
```
|
||||
|
||||
Ou en une ligne (tap automatique) : `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global** :
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # ou : fusion dashboard
|
||||
```
|
||||
|
||||
**Depuis un clone** (pour le développement) :
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Cliquez ensuite sur l'URL `Open:` affichée dans le terminal. Elle intègre un jeton bearer
|
||||
(`http://localhost:4040/?token=fn_...`) que le navigateur capture dans
|
||||
`localStorage` à la première visite et réutilise automatiquement par la suite. Côté
|
||||
serveur, Fusion persiste désormais le jeton du tableau de bord/démon dans
|
||||
`~/.fusion/settings.json` à la première exécution authentifiée et le réutilise
|
||||
lors des démarrages ultérieurs, sauf si vous le remplacez (`--token`,
|
||||
`FUSION_DASHBOARD_TOKEN`, `FUSION_DAEMON_TOKEN`) ou désactivez l'authentification
|
||||
avec `--no-auth`. Voir
|
||||
[Référence CLI → fn dashboard → Authentification](./docs/cli-reference.md#fn-dashboard)
|
||||
pour la précédence complète et les options de réinitialisation/révocation.
|
||||
|
||||
### Configuration au premier lancement
|
||||
|
||||
Au premier lancement, Fusion ouvre l'**assistant d'intégration** en trois étapes guidées :
|
||||
|
||||
1. **Configuration IA** — Utilisez la liste simplifiée de fournisseurs de démarrage rapide (fournisseurs recommandés et fournisseurs déjà connectés), puis développez les **Paramètres avancés du fournisseur** uniquement si vous avez besoin de fournisseurs supplémentaires ou de détails de configuration. Un seul fournisseur suffit pour commencer. Les entrées de fournisseurs dépréciés Google Gemini CLI / Antigravity sont intentionnellement masquées ; les chemins clé API Google/Gemini, Google Generative AI, Vertex et Cloud Code restent pris en charge.
|
||||
2. **GitHub (optionnel)** — Connectez GitHub pour l'import de tickets et la gestion des PR
|
||||
3. **Première tâche** — Créez votre première tâche ou importez depuis GitHub (si aucun projet n'est actif, l'assistant vous invite d'abord à enregistrer/sélectionner un répertoire de projet)
|
||||
|
||||
L'assistant est **dismissable et non bloquant** — cliquez sur **Ignorer pour l'instant** pour utiliser le tableau de bord immédiatement. Relancez-le plus tard depuis **Paramètres → Authentification → Rouvrir le guide d'intégration**.
|
||||
|
||||
### Mobile
|
||||
|
||||
Pour le workflow Capacitor + PWA, voir [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## Documentation
|
||||
|
||||
| Guide | Ce qu'il couvre |
|
||||
|
||||
256
README.ko.md
256
README.ko.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### 거친 아이디어에서 프로덕션 코드까지 — 자동으로.
|
||||
|
||||
**멀티 노드 에이전트 오케스트레이터** — 태스크, 에이전트, 미션, git, 파일, 워크트리를 어떤 모델에서도, 로컬 또는 클라우드에서 실행합니다.
|
||||
### 🏭 멀티 에이전트 오케스트레이터가 운영하는 소프트웨어 공장.
|
||||
|
||||
원하는 것을 설명하세요 — AI 에이전트 팀이 **계획하고, 만들고, 검토하고, 배포**해 드립니다. Fusion은 여러분의 소프트웨어 공장입니다: 태스크, 에이전트, 미션, git, 파일, 워크트리를 가로질러 어떤 모델로든, 로컬 또는 클라우드에서 실행되는 코드 조립 라인입니다.
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [문서](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -45,6 +45,72 @@
|
||||
|
||||
---
|
||||
|
||||
## 빠른 시작
|
||||
|
||||
**설치 없이 npm에서 바로:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
이 명령은 대시보드를 실행합니다. 하위 명령은 다음과 같이 전달됩니다: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help` 등. (또는 명시적으로: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**원라인 설치 프로그램** (macOS & Linux — Homebrew를 자동 선택하고, 없으면 npm으로 대체):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS & Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 또는: fn dashboard
|
||||
```
|
||||
|
||||
또는 원라인(자동 탭 추가): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm 전역 설치**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 또는: fusion dashboard
|
||||
```
|
||||
|
||||
**클론으로 시작** (개발용):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
터미널에 출력되는 `Open:` URL을 클릭하세요. URL에는 베어러 토큰
|
||||
(`http://localhost:4040/?token=fn_...`)이 포함되어 있으며, 브라우저가 첫 방문 시
|
||||
`localStorage`에 캡처하여 이후 자동으로 재사용합니다. 서버 측에서 Fusion은
|
||||
첫 번째 인증된 실행 시 `~/.fusion/settings.json`에 대시보드/데몬 토큰을
|
||||
저장하고, 이후 시작 시 재사용합니다(`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`으로 재정의하거나 `--no-auth`로 인증을 비활성화하지 않는 한).
|
||||
전체 우선순위 및 재설정/취소 옵션은
|
||||
[CLI 참조 → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)을
|
||||
참조하세요.
|
||||
|
||||
### 최초 실행 설정
|
||||
|
||||
Fusion을 처음 시작하면 세 단계로 안내하는 **온보딩 마법사**가 열립니다:
|
||||
|
||||
1. **AI 설정** — 간소화된 빠른 시작 공급자 목록(권장 공급자 및 이미 연결된 공급자)을 사용하고, 추가 공급자나 설정 세부 사항이 필요한 경우에만 **고급 공급자 설정**을 펼칩니다. 시작하려면 공급자 하나만 있으면 됩니다. 더 이상 사용되지 않는 Google Gemini CLI / Antigravity 공급자 항목은 의도적으로 숨겨져 있으며, Google/Gemini API 키, Google Generative AI, Vertex, Cloud Code 경로는 계속 지원됩니다.
|
||||
2. **GitHub (선택 사항)** — 이슈 임포트 및 PR 관리를 위해 GitHub 연결
|
||||
3. **첫 번째 태스크** — 첫 번째 태스크를 생성하거나 GitHub에서 임포트(활성 프로젝트가 없는 경우, 온보딩이 먼저 프로젝트 디렉터리 등록/선택을 안내합니다)
|
||||
|
||||
마법사는 **해제 가능하며 비차단적** — **지금 건너뛰기**를 클릭하면 즉시 대시보드를 사용할 수 있습니다. 나중에 **설정 → 인증 → 온보딩 가이드 다시 열기**에서 재실행할 수 있습니다.
|
||||
|
||||
### 모바일
|
||||
|
||||
Capacitor + PWA 워크플로우는 [MOBILE.md](./MOBILE.md)를 참조하세요.
|
||||
|
||||
---
|
||||
|
||||
## 흐름
|
||||
|
||||
```
|
||||
@@ -86,6 +152,122 @@
|
||||
|
||||
---
|
||||
|
||||
## 실제 동작 모습
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
Fusion의 최신 화면들을 한눈에 — 미션 컨트롤, 시각적 워크플로, 에이전트 채팅, 멀티 에이전트 룸, 에이전트 간 메일.
|
||||
|
||||
### 🛰️ Command Center — 에이전트 플릿을 위한 미션 컨트롤
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
에이전트들이 하는 모든 일을 위한 한 화면. 실시간 스케줄러 용량을 조정하고, 모델별 토큰 소비를 실시간으로 지켜보며, 확실한 수치로 가치를 입증하세요.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>토큰</b> — 모델별 소비, 캐시 대 입력 대 출력, 시간 경과별.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>생산성</b> — 성과, 소요 시간 백분위, 언어 구성.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>팀</b> — 에이전트 조직도와 에이전트별 토큰 점유율.</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control — 모든 탭은 동일한 라이브 플릿을 바라보는 서로 다른 렌즈입니다.
|
||||
|
||||
**동일한 플릿, 당신의 방식대로** — Command Center(그리고 대시보드 전체)는 **70개 이상의 색상 테마**로 실시간 리스킨됩니다. 여기 Shadcn Light와 Shadcn Dark Gray로 표시된 모습입니다:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>12가지 라이트 테마 & 12가지 다크 테마</b> (클릭하여 펼치기)</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 시각적으로 작성하는 선택 가능한 워크플로
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
태스크가 아이디어에서 머지까지 거치는 여정이 곧 **워크플로**이며 — 직접 선택하고 다듬을 수 있습니다. 내장 워크플로(Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering 등)를 고르고, 그래프를 살펴본 뒤, 시각적 [워크플로 편집기](./docs/workflow-editor.md)에서 복제하여 컬럼, 게이트, 모델 레인, 검토 정책을 커스터마이즈하세요. 엔진 포크는 필요 없습니다.
|
||||
|
||||
다음은 **Stepwise coding** 그래프입니다 — 다음 단계로 넘어가기 전에 모든 단계를 계획, 실행, 검토합니다 — Shadcn Light와 Dark Gray에서 노드별로 살펴봅니다:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ 에이전트 채팅 — 실행 중인 에이전트와 대화
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
어떤 모델에서든 어떤 에이전트와도 직접 채팅 및 태스크별 채팅을 할 수 있습니다. 태스크가 왜 실패했는지 묻고, 접근 방식을 조정하고, 첨부파일을 넣고, 인채팅 질문 카드에 답하고, 멈췄던 지점에서 스트림을 재개하세요 — 전체에 걸쳐 완전한 마크다운 및 코드 렌더링을 지원합니다.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 멀티 에이전트 채팅 룸
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
여러 에이전트를 한 룸에 넣고 서로 조율하게 하세요. 구성원을 언급하면 직접 응답하고, 주변 구성원은 제한 내에서 대화에 참여할 수 있습니다. 여기서는 **CEO**, **Product Manager**, **CTO** 에이전트가 `#leads`에서 태스크 소유권을 정렬합니다 — 사람의 개입 없이. ([채팅 문서](./docs/dashboard-guide.md#chat-view))
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 에이전트 메일 — 에이전트 간 받은편지함
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
위임, 확인, 인계를 위한 내장 메일박스. 에이전트는 트리아지 요약을 제출하고, 승인을 요청하고, 플릿 전반에 걸쳐 작업을 조율합니다 — Inbox, Outbox, Agents, Approvals 보기를 제공하여 모든 교환을 감사할 수 있습니다.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## 작동 방식
|
||||
|
||||
```mermaid
|
||||
@@ -224,72 +406,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## 빠른 시작
|
||||
|
||||
**설치 없이 npm에서 바로:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
이 명령은 대시보드를 실행합니다. 하위 명령은 다음과 같이 전달됩니다: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help` 등. (또는 명시적으로: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**원라인 설치 프로그램** (macOS & Linux — Homebrew를 자동 선택하고, 없으면 npm으로 대체):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS & Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 또는: fn dashboard
|
||||
```
|
||||
|
||||
또는 원라인(자동 탭 추가): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm 전역 설치**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 또는: fusion dashboard
|
||||
```
|
||||
|
||||
**클론으로 시작** (개발용):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
터미널에 출력되는 `Open:` URL을 클릭하세요. URL에는 베어러 토큰
|
||||
(`http://localhost:4040/?token=fn_...`)이 포함되어 있으며, 브라우저가 첫 방문 시
|
||||
`localStorage`에 캡처하여 이후 자동으로 재사용합니다. 서버 측에서 Fusion은
|
||||
첫 번째 인증된 실행 시 `~/.fusion/settings.json`에 대시보드/데몬 토큰을
|
||||
저장하고, 이후 시작 시 재사용합니다(`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`으로 재정의하거나 `--no-auth`로 인증을 비활성화하지 않는 한).
|
||||
전체 우선순위 및 재설정/취소 옵션은
|
||||
[CLI 참조 → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)을
|
||||
참조하세요.
|
||||
|
||||
### 최초 실행 설정
|
||||
|
||||
Fusion을 처음 시작하면 세 단계로 안내하는 **온보딩 마법사**가 열립니다:
|
||||
|
||||
1. **AI 설정** — 간소화된 빠른 시작 공급자 목록(권장 공급자 및 이미 연결된 공급자)을 사용하고, 추가 공급자나 설정 세부 사항이 필요한 경우에만 **고급 공급자 설정**을 펼칩니다. 시작하려면 공급자 하나만 있으면 됩니다. 더 이상 사용되지 않는 Google Gemini CLI / Antigravity 공급자 항목은 의도적으로 숨겨져 있으며, Google/Gemini API 키, Google Generative AI, Vertex, Cloud Code 경로는 계속 지원됩니다.
|
||||
2. **GitHub (선택 사항)** — 이슈 임포트 및 PR 관리를 위해 GitHub 연결
|
||||
3. **첫 번째 태스크** — 첫 번째 태스크를 생성하거나 GitHub에서 임포트(활성 프로젝트가 없는 경우, 온보딩이 먼저 프로젝트 디렉터리 등록/선택을 안내합니다)
|
||||
|
||||
마법사는 **해제 가능하며 비차단적** — **지금 건너뛰기**를 클릭하면 즉시 대시보드를 사용할 수 있습니다. 나중에 **설정 → 인증 → 온보딩 가이드 다시 열기**에서 재실행할 수 있습니다.
|
||||
|
||||
### 모바일
|
||||
|
||||
Capacitor + PWA 워크플로우는 [MOBILE.md](./MOBILE.md)를 참조하세요.
|
||||
|
||||
---
|
||||
|
||||
## 문서
|
||||
|
||||
| 가이드 | 내용 |
|
||||
|
||||
256
README.md
256
README.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### From rough idea to production code — automatically.
|
||||
|
||||
**Multi-node agent orchestrator** — tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
|
||||
### 🏭 A software factory, run by a multi-agent orchestrator.
|
||||
|
||||
Describe what you want — a team of AI agents **plans, builds, reviews, and ships** it for you. Fusion is your software factory: an assembly line for code that runs across tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -43,6 +43,72 @@ One board. Controlled from anywhere. Laptop, Mac mini, Linux server, cloud VM, p
|
||||
|
||||
---
|
||||
|
||||
## Quick start
|
||||
|
||||
**Zero install, straight from npm:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS & Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # or: fn dashboard
|
||||
```
|
||||
|
||||
Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # or: fusion dashboard
|
||||
```
|
||||
|
||||
**From a clone** (for development):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Then click the `Open:` URL printed in the terminal. It embeds a bearer token
|
||||
(`http://localhost:4040/?token=fn_...`) that the browser captures to
|
||||
`localStorage` on first visit and reuses automatically thereafter. On the
|
||||
server side, Fusion now persists the dashboard/daemon token in
|
||||
`~/.fusion/settings.json` on first authenticated run and reuses it on later
|
||||
starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
|
||||
[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
|
||||
for full precedence and reset/revocation options.
|
||||
|
||||
### First-run setup
|
||||
|
||||
On first launch, Fusion opens the **onboarding wizard** with three guided steps:
|
||||
|
||||
1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
|
||||
2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
|
||||
3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
|
||||
|
||||
The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
|
||||
|
||||
### Mobile
|
||||
|
||||
For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## The flow
|
||||
|
||||
```
|
||||
@@ -84,6 +150,122 @@ Every task shows its plan, its reviews, its diffs, and its file changes in real
|
||||
|
||||
---
|
||||
|
||||
## See it in action
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
The newest surfaces in Fusion, at a glance — mission control, visual workflows, agent chat, multi-agent rooms, and inter-agent mail.
|
||||
|
||||
### 🛰️ Command Center — mission control for your agent fleet
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
One screen for everything your agents are doing. Tune live scheduler capacity, watch token spend by model in real time, and prove the value with hard numbers.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>Tokens</b> — spend by model, cached vs. input vs. output, over time.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>Productivity</b> — outcomes, duration percentiles, language mix.</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>Team</b> — agent org chart and token share per agent.</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control — every tab is a different lens on the same live fleet.
|
||||
|
||||
**The same fleet, your way** — Command Center (and the whole dashboard) re-skins live across **70+ color themes**. Here it is in Shadcn Light and Shadcn Dark Gray:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>A dozen light themes & a dozen dark themes</b> (click to expand)</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 Selectable workflows, authored visually
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
A task's journey from idea to merge is a **workflow** — and it's yours to choose and shape. Pick a built-in (Coding, Quick fix, Review-heavy, Stepwise, PR lifecycle, Compound engineering, and more), inspect its graph, then duplicate and customize columns, gates, model lanes, and review policy in the visual [Workflow Editor](./docs/workflow-editor.md). No engine fork required.
|
||||
|
||||
Here's the **Stepwise coding** graph — plan, execute, and review every step before the next — explored node-by-node in Shadcn Light and Dark Gray:
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ Agent chat — talk to your agents, mid-flight
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
Direct chat and per-task chat with any agent, on any model. Ask why a task failed, steer an approach, drop attachments, answer in-chat question cards, and resume streams where you left off — full markdown and code rendering throughout.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 Multi-agent chat rooms
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
Put multiple agents in a room and let them coordinate. Mention a member and it responds directly; ambient members can join the conversation up to a cap. Here the **CEO**, **Product Manager**, and **CTO** agents align on task ownership in `#leads` — no human in the loop. ([Chat docs](./docs/dashboard-guide.md#chat-view))
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 Agent mail — an inbox between your agents
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
A built-in mailbox for delegation, clarification, and hand-offs. Agents file triage summaries, request approvals, and coordinate work across the fleet — with Inbox, Outbox, Agents, and Approvals views, so you can audit every exchange.
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## How it works
|
||||
|
||||
```mermaid
|
||||
@@ -227,72 +409,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## Quick start
|
||||
|
||||
**Zero install, straight from npm:**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
|
||||
|
||||
**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew** (macOS & Linux):
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # or: fn dashboard
|
||||
```
|
||||
|
||||
Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
|
||||
|
||||
**npm global**:
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # or: fusion dashboard
|
||||
```
|
||||
|
||||
**From a clone** (for development):
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
Then click the `Open:` URL printed in the terminal. It embeds a bearer token
|
||||
(`http://localhost:4040/?token=fn_...`) that the browser captures to
|
||||
`localStorage` on first visit and reuses automatically thereafter. On the
|
||||
server side, Fusion now persists the dashboard/daemon token in
|
||||
`~/.fusion/settings.json` on first authenticated run and reuses it on later
|
||||
starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
|
||||
`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
|
||||
[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
|
||||
for full precedence and reset/revocation options.
|
||||
|
||||
### First-run setup
|
||||
|
||||
On first launch, Fusion opens the **onboarding wizard** with three guided steps:
|
||||
|
||||
1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
|
||||
2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
|
||||
3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
|
||||
|
||||
The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
|
||||
|
||||
### Mobile
|
||||
|
||||
For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
|
||||
|
||||
---
|
||||
|
||||
## Documentation
|
||||
|
||||
| Guide | What it covers |
|
||||
|
||||
252
README.zh-CN.md
252
README.zh-CN.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### 从粗糙想法到生产代码——全程自动化。
|
||||
|
||||
**多节点智能体编排器** — 任务、智能体、任务群、Git、文件与工作树，支持任意模型，本地与云端皆可。
|
||||
### 🏭 由多智能体编排器运行的软件工厂。
|
||||
|
||||
描述你想要的东西——一支 AI 智能体团队便会为你**规划、构建、审核并交付**。Fusion 就是你的软件工厂：一条贯穿任务、智能体、任务群、Git、文件与工作树的代码流水线，支持任意模型，本地与云端皆可。
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [文档](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -45,6 +45,70 @@
|
||||
|
||||
---
|
||||
|
||||
## 快速上手
|
||||
|
||||
**无需安装，直接通过 npm 运行：**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
这将启动仪表板。子命令可透传：`npx runfusion.ai task create "fix X"`、`npx runfusion.ai --help` 等（或完整写法：`npx @runfusion/fusion dashboard`）。
|
||||
|
||||
**一键安装脚本**（macOS 和 Linux——自动选用 Homebrew，失败则回退到 npm）：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew**（macOS 和 Linux）：
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 或：fn dashboard
|
||||
```
|
||||
|
||||
或使用一行命令（自动添加 tap）：`brew install runfusion/fusion/fusion`。
|
||||
|
||||
**npm 全局安装**：
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 或：fusion dashboard
|
||||
```
|
||||
|
||||
**从克隆仓库启动**（用于开发）：
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
然后点击终端输出的 `Open:` URL。该 URL 内嵌了一个持有者令牌
|
||||
（`http://localhost:4040/?token=fn_...`），浏览器首次访问时会将其捕获并存入
|
||||
`localStorage`，此后自动复用。在服务端，Fusion 会在首次经过身份验证的运行时将
|
||||
仪表板/守护进程令牌持久化至 `~/.fusion/settings.json`，并在后续启动时复用，
|
||||
除非你通过 `--token`、`FUSION_DASHBOARD_TOKEN`、`FUSION_DAEMON_TOKEN` 覆盖，
|
||||
或使用 `--no-auth` 禁用鉴权。完整的优先级规则及重置/吊销选项，请参见
|
||||
[CLI 参考 → fn dashboard → 身份验证](./docs/cli-reference.md#fn-dashboard)。
|
||||
|
||||
### 首次运行向导
|
||||
|
||||
首次启动时，Fusion 会打开**引导向导**，分三步引导：
|
||||
|
||||
1. **AI 配置** — 使用简化的快速启动提供商列表（推荐提供商加上已连接的提供商），如需添加更多提供商或查看详细设置，展开**高级提供商设置**即可。入门只需一个提供商。已弃用的 Google Gemini CLI / Antigravity 提供商条目已被有意隐藏；Google/Gemini API 密钥、Google Generative AI、Vertex 和 Cloud Code 路径仍受支持。
|
||||
2. **GitHub（可选）** — 连接 GitHub 以导入 Issue 和管理 PR
|
||||
3. **第一个任务** — 创建你的第一个任务，或从 GitHub 导入（若当前无活跃项目，引导向导会先提示你注册/选择项目目录）
|
||||
|
||||
向导**可关闭且不阻塞**——点击**暂时跳过**即可立即使用仪表板。稍后可从**设置 → 身份验证 → 重新打开引导向导**再次触发。
|
||||
|
||||
### 移动端
|
||||
|
||||
Capacitor + PWA 工作流，请参见 [MOBILE.md](./MOBILE.md)。
|
||||
|
||||
---
|
||||
|
||||
## 工作流程
|
||||
|
||||
```
|
||||
@@ -86,6 +150,122 @@
|
||||
|
||||
---
|
||||
|
||||
## 实地一览
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
Fusion 中最新的功能界面一览——任务控制中心、可视化工作流、智能体聊天、多智能体聊天室与智能体间邮件。
|
||||
|
||||
### 🛰️ 指挥中心 — 你的智能体舰队的任务控制中心
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
一块屏幕掌握智能体的所有动态。实时调节调度器容量，按模型实时观察 token 消耗，并用硬数据证明价值。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>Token</b> — 按模型划分的消耗，缓存 vs. 输入 vs. 输出，随时间变化。</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>生产力</b> — 产出成果、时长分位数、语言占比。</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>团队</b> — 智能体组织架构图与每个智能体的 token 占比。</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control — 每个标签页都是观察同一支实时舰队的不同视角。
|
||||
|
||||
**同一支舰队，随你定制** — 指挥中心（以及整个仪表板）可在 **70+ 种配色主题**间实时换肤。这里展示的是 Shadcn Light 和 Shadcn Dark Gray：
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>十余种浅色主题与十余种深色主题</b>（点击展开）</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 可视化编写的可选工作流
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
任务从想法到合并的旅程就是一条**工作流**——它由你选择、由你塑造。挑选一个内置工作流（Coding、Quick fix、Review-heavy、Stepwise、PR lifecycle、Compound engineering 等），查看其图形，然后在可视化[工作流编辑器](./docs/workflow-editor.md)中复制并定制列、门控、模型通道和审核策略。无需 fork 引擎。
|
||||
|
||||
这是 **Stepwise coding**（逐步编码）图形——在进入下一步前对每一步进行规划、执行和审核——在 Shadcn Light 和 Dark Gray 中逐节点探索：
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ 智能体聊天 — 在任务进行中与智能体对话
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
与任意智能体进行直接聊天和任务聊天，可用任意模型。询问任务为何失败、引导其方法、拖入附件、回答聊天内问题卡，并从上次中断处恢复流——全程支持完整的 markdown 和代码渲染。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 多智能体聊天室
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
把多个智能体放进同一个房间，让它们协作。提及某个成员，它便会直接回复；旁听成员可在上限内加入对话。这里 **CEO**、**产品经理**和 **CTO** 智能体在 `#leads` 中就任务归属达成一致——全程无需人工介入。（[聊天文档](./docs/dashboard-guide.md#chat-view)）
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 智能体邮件 — 智能体之间的收件箱
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
内置邮箱，用于委派、澄清与交接。智能体提交分诊摘要、请求审批，并在整支舰队间协调工作——配有收件箱、发件箱、智能体和审批视图，让你可以审计每一次往来。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## 工作原理
|
||||
|
||||
```mermaid
|
||||
@@ -224,70 +404,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## 快速上手
|
||||
|
||||
**无需安装，直接通过 npm 运行：**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
这将启动仪表板。子命令可透传：`npx runfusion.ai task create "fix X"`、`npx runfusion.ai --help` 等（或完整写法：`npx @runfusion/fusion dashboard`）。
|
||||
|
||||
**一键安装脚本**（macOS 和 Linux——自动选用 Homebrew，失败则回退到 npm）：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew**（macOS 和 Linux）：
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 或：fn dashboard
|
||||
```
|
||||
|
||||
或使用一行命令（自动添加 tap）：`brew install runfusion/fusion/fusion`。
|
||||
|
||||
**npm 全局安装**：
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 或：fusion dashboard
|
||||
```
|
||||
|
||||
**从克隆仓库启动**（用于开发）：
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
然后点击终端输出的 `Open:` URL。该 URL 内嵌了一个持有者令牌
|
||||
（`http://localhost:4040/?token=fn_...`），浏览器首次访问时会将其捕获并存入
|
||||
`localStorage`，此后自动复用。在服务端，Fusion 会在首次经过身份验证的运行时将
|
||||
仪表板/守护进程令牌持久化至 `~/.fusion/settings.json`，并在后续启动时复用，
|
||||
除非你通过 `--token`、`FUSION_DASHBOARD_TOKEN`、`FUSION_DAEMON_TOKEN` 覆盖，
|
||||
或使用 `--no-auth` 禁用鉴权。完整的优先级规则及重置/吊销选项，请参见
|
||||
[CLI 参考 → fn dashboard → 身份验证](./docs/cli-reference.md#fn-dashboard)。
|
||||
|
||||
### 首次运行向导
|
||||
|
||||
首次启动时，Fusion 会打开**引导向导**，分三步引导：
|
||||
|
||||
1. **AI 配置** — 使用简化的快速启动提供商列表（推荐提供商加上已连接的提供商），如需添加更多提供商或查看详细设置，展开**高级提供商设置**即可。入门只需一个提供商。已弃用的 Google Gemini CLI / Antigravity 提供商条目已被有意隐藏；Google/Gemini API 密钥、Google Generative AI、Vertex 和 Cloud Code 路径仍受支持。
|
||||
2. **GitHub（可选）** — 连接 GitHub 以导入 Issue 和管理 PR
|
||||
3. **第一个任务** — 创建你的第一个任务，或从 GitHub 导入（若当前无活跃项目，引导向导会先提示你注册/选择项目目录）
|
||||
|
||||
向导**可关闭且不阻塞**——点击**暂时跳过**即可立即使用仪表板。稍后可从**设置 → 身份验证 → 重新打开引导向导**再次触发。
|
||||
|
||||
### 移动端
|
||||
|
||||
Capacitor + PWA 工作流，请参见 [MOBILE.md](./MOBILE.md)。
|
||||
|
||||
---
|
||||
|
||||
## 文档
|
||||
|
||||
| 指南 | 内容 |
|
||||
|
||||
254
README.zh-TW.md
254
README.zh-TW.md
@@ -1,12 +1,12 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
||||
|
||||
# Fusion
|
||||
# <img src="./demo/assets/fusion-logo-orange.svg" alt="" width="34" align="center" /> Fusion
|
||||
|
||||
### 從粗略想法到正式上線的程式碼——全自動完成。
|
||||
|
||||
**多節點代理人協調器** — 任務、代理人、任務群組、git、檔案與工作樹，支援任何模型，本地或雲端皆可。
|
||||
### 🏭 一座軟體工廠，由多代理人協調器運作。
|
||||
|
||||
描述你想要的——一支 AI 代理人團隊會為你**規劃、建置、審閱並交付**。Fusion 就是你的軟體工廠：一條橫跨任務、代理人、任務群組、git、檔案與工作樹的程式碼生產線，支援任何模型，本地或雲端皆可。
|
||||
|
||||
[**runfusion.ai →**](https://runfusion.ai) · [文件](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
||||
|
||||
@@ -45,6 +45,71 @@
|
||||
|
||||
---
|
||||
|
||||
## 快速開始
|
||||
|
||||
**免安裝，直接從 npm 執行：**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
這會啟動儀表板。子指令可直接傳遞：`npx runfusion.ai task create "fix X"`、`npx runfusion.ai --help` 等。（或完整形式：`npx @runfusion/fusion dashboard`。）
|
||||
|
||||
**單行安裝程式**（macOS 與 Linux——自動選用 Homebrew，若無則退回 npm）：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew**（macOS 與 Linux）：
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 或：fn dashboard
|
||||
```
|
||||
|
||||
或使用單行指令（自動新增 tap）：`brew install runfusion/fusion/fusion`。
|
||||
|
||||
**npm 全域安裝**：
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 或：fusion dashboard
|
||||
```
|
||||
|
||||
**從複本執行**（供開發使用）：
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
然後點擊終端機中顯示的 `Open:` 網址。該網址內嵌一個不記名令牌
|
||||
（`http://localhost:4040/?token=fn_...`），瀏覽器會在首次造訪時擷取並存入
|
||||
`localStorage`，之後自動重複使用。在伺服器端，Fusion 會在首次驗證執行時
|
||||
將儀表板與背景程式令牌持久化至 `~/.fusion/settings.json`，並在後續啟動時
|
||||
重複使用，除非你覆蓋它（`--token`、`FUSION_DASHBOARD_TOKEN`、
|
||||
`FUSION_DAEMON_TOKEN`）或以 `--no-auth` 停用驗證。完整的優先順序與
|
||||
重設/撤銷選項，請參閱
|
||||
[命令列參考 → fn dashboard → 驗證](./docs/cli-reference.md#fn-dashboard)。
|
||||
|
||||
### 首次執行設定
|
||||
|
||||
首次啟動時，Fusion 會開啟**引導精靈**，提供三個引導步驟：
|
||||
|
||||
1. **AI 設定** — 使用簡化的快速啟動供應商清單（建議的供應商，加上已連線的供應商），只有在需要其他供應商或詳細設定時，才展開**進階供應商設定**。只需一個供應商即可開始使用。已棄用的 Google Gemini CLI / Antigravity 供應商項目已刻意隱藏；Google/Gemini API 金鑰、Google Generative AI、Vertex 與 Cloud Code 路徑仍受支援。
|
||||
2. **GitHub（選填）** — 連結 GitHub 以匯入議題並管理 PR
|
||||
3. **第一個任務** — 建立你的第一個任務或從 GitHub 匯入（若無作用中的專案，引導精靈會先提示你註冊/選取專案目錄）
|
||||
|
||||
精靈**可關閉且不阻擋操作**——點擊**暫時略過**即可立即使用儀表板。之後可從**設定 → 驗證 → 重新開啟引導指南**再次觸發。
|
||||
|
||||
### 行動裝置
|
||||
|
||||
Capacitor + PWA 工作流程，請參閱 [MOBILE.md](./MOBILE.md)。
|
||||
|
||||
---
|
||||
|
||||
## 工作流程
|
||||
|
||||
```
|
||||
@@ -86,6 +151,122 @@
|
||||
|
||||
---
|
||||
|
||||
## 實際運作一覽
|
||||
|
||||
<!--
|
||||
FNXC:Docs 2026-06-21-19:55:
|
||||
README must lead with a smaller wordmark and a visual showcase of the latest surfaces (Command Center, selectable workflows, agent chat, multi-agent chat rooms, agent mail) so the value lands fast.
|
||||
Each feature pairs a short looping GIF with value copy; Command Center additionally carries real fleet stats, the token/productivity/team graph trio, and the 70+-theme grid (incl. shadcn light/mono/orange/black) to make the data pop.
|
||||
Media lives in demo/assets/ (committed, GitHub-inline GIFs); stat numbers are sourced from a live seeded fleet — refresh them if the captures are re-shot.
|
||||
Each feature keeps its original Tokyo Night capture and adds a Shadcn Light + Shadcn Dark Gray pair; the theme showcase is split into a light-themes grid and a dark-themes grid. Workflow GIFs feature the Stepwise coding graph with node-level zoom/pan.
|
||||
-->
|
||||
|
||||
Fusion 中最新的功能一覽——任務指揮中心、視覺化工作流程、代理人聊天、多代理人聊天室與代理人間郵件。
|
||||
|
||||
### 🛰️ Command Center——你代理人艦隊的任務指揮中心
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center.gif" alt="Fusion Command Center: live concurrency gauges, token charts, and fleet telemetry across tabs" width="900" />
|
||||
</div>
|
||||
|
||||
一個畫面掌握代理人正在進行的一切。即時調整排程器容量、依模型即時觀察 token 花費，並以實際數據證明價值。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="33%"><img src="./demo/assets/command-center-tokens.png" alt="Tokens by model, token trend, and tokens-over-time charts" /><br/><sub><b>Tokens</b> — 依模型的花費、快取 vs. 輸入 vs. 輸出，隨時間變化。</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-productivity.png" alt="Productivity: commits, human-hours saved, task duration percentiles, and files by language" /><br/><sub><b>Productivity</b> — 成果、時長百分位數、語言組成。</sub></td>
|
||||
<td width="33%"><img src="./demo/assets/command-center-team.png" alt="Agent org chart with token share and tokens-by-agent breakdown" /><br/><sub><b>Team</b> — 代理人組織圖與每位代理人的 token 占比。</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
> Tokens · Tools · Activity · Productivity · Team · Ecosystem · GitHub · Signals · System · Reliability · Mission Control——每一個分頁都是同一支即時艦隊的不同視角。
|
||||
|
||||
**同一支艦隊，依你所好**——Command Center（以及整個儀表板）可在 **70+ 種色彩主題**間即時換膚。這裡是 Shadcn Light 與 Shadcn Dark Gray：
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/command-center-light.gif" alt="Command Center in Shadcn Light theme" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/command-center-gray.gif" alt="Command Center in Shadcn Dark Gray theme" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
<details>
|
||||
<summary><b>十多種淺色主題與十多種深色主題</b>（點擊展開）</summary>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/command-center-themes-light.png" alt="Command Center across 12 light color themes" width="900" />
|
||||
<br/><br/>
|
||||
<img src="./demo/assets/command-center-themes-dark.png" alt="Command Center across 12 dark color themes" width="900" />
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
### 🔁 可選工作流程，以視覺化方式撰寫
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/workflows.gif" alt="Fusion Workflow Editor: switching between built-in workflow graphs" width="820" />
|
||||
</div>
|
||||
|
||||
任務從想法到合併的旅程是一個**工作流程**——而它由你選擇與塑造。選取內建工作流程（Coding、Quick fix、Review-heavy、Stepwise、PR lifecycle、Compound engineering 等），檢視其圖形，接著在視覺化[工作流程編輯器](./docs/workflow-editor.md)中複製並自訂欄、關卡、模型通道與審閱政策。無需 fork 引擎。
|
||||
|
||||
這是 **Stepwise coding** 圖形——在進入下一步前，規劃、執行並審閱每個步驟——以 Shadcn Light 與 Dark Gray 逐節點探索：
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/workflows-light.gif" alt="Stepwise coding workflow graph in Shadcn Light, panning across nodes" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/workflows-gray.gif" alt="Stepwise coding workflow graph in Shadcn Dark Gray, panning across nodes" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 🗨️ 代理人聊天——在執行途中與你的代理人對話
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-chat.gif" alt="Fusion agent chat: a threaded conversation with an agent diagnosing a failed task" width="900" />
|
||||
</div>
|
||||
|
||||
與任何代理人在任何模型上進行直接聊天與每任務聊天。詢問任務為何失敗、引導方法、放上附件、回答聊天內問題卡，並從上次中斷處恢復串流——全程支援完整的 markdown 與程式碼渲染。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-light.png" alt="Agent chat thread in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-chat-gray.png" alt="Agent chat thread in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 👥 多代理人聊天室
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/chat-rooms.gif" alt="Fusion chat room: CEO, Product Manager, and CTO agents coordinating in #leads" width="900" />
|
||||
</div>
|
||||
|
||||
把多個代理人放進一個房間，讓他們協調作業。提及某位成員，它就會直接回覆；環境成員可在上限內加入對話。這裡 **CEO**、**Product Manager** 與 **CTO** 代理人在 `#leads` 中就任務歸屬達成共識——全程沒有人類介入。（[聊天文件](./docs/dashboard-guide.md#chat-view)）
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-light.gif" alt="Multi-agent chat room in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/chat-rooms-gray.gif" alt="Multi-agent chat room in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### 📬 代理人郵件——代理人之間的收件匣
|
||||
|
||||
<div align="center">
|
||||
<img src="./demo/assets/agent-mail.gif" alt="Fusion mailbox: inter-agent messages with triage summaries and approvals" width="900" />
|
||||
</div>
|
||||
|
||||
內建的郵件信箱，用於委派、釐清與交接。代理人會提交分流摘要、請求核准，並在整支艦隊間協調作業——具備 Inbox、Outbox、Agents 與 Approvals 檢視，讓你能稽核每一次往來。
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-light.gif" alt="Agent mailbox in Shadcn Light" /><br/><sub><b>Shadcn Light</b></sub></td>
|
||||
<td width="50%"><img src="./demo/assets/agent-mail-gray.gif" alt="Agent mailbox in Shadcn Dark Gray" /><br/><sub><b>Shadcn Dark Gray</b></sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
---
|
||||
|
||||
## 運作原理
|
||||
|
||||
```mermaid
|
||||
@@ -224,71 +405,6 @@ npx companies.sh add paperclipai/companies/gstack
|
||||
|
||||
---
|
||||
|
||||
## 快速開始
|
||||
|
||||
**免安裝，直接從 npm 執行：**
|
||||
|
||||
```bash
|
||||
npx runfusion.ai
|
||||
```
|
||||
|
||||
這會啟動儀表板。子指令可直接傳遞：`npx runfusion.ai task create "fix X"`、`npx runfusion.ai --help` 等。（或完整形式：`npx @runfusion/fusion dashboard`。）
|
||||
|
||||
**單行安裝程式**（macOS 與 Linux——自動選用 Homebrew，若無則退回 npm）：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://runfusion.ai/install.sh | sh
|
||||
fusion dashboard
|
||||
```
|
||||
|
||||
**Homebrew**（macOS 與 Linux）：
|
||||
|
||||
```bash
|
||||
brew tap runfusion/fusion
|
||||
brew install fusion
|
||||
fusion dashboard # 或：fn dashboard
|
||||
```
|
||||
|
||||
或使用單行指令（自動新增 tap）：`brew install runfusion/fusion/fusion`。
|
||||
|
||||
**npm 全域安裝**：
|
||||
|
||||
```bash
|
||||
npm install -g @runfusion/fusion
|
||||
fn dashboard # 或：fusion dashboard
|
||||
```
|
||||
|
||||
**從複本執行**（供開發使用）：
|
||||
|
||||
```bash
|
||||
pnpm dev dashboard
|
||||
```
|
||||
|
||||
然後點擊終端機中顯示的 `Open:` 網址。該網址內嵌一個不記名令牌
|
||||
（`http://localhost:4040/?token=fn_...`），瀏覽器會在首次造訪時擷取並存入
|
||||
`localStorage`，之後自動重複使用。在伺服器端，Fusion 會在首次驗證執行時
|
||||
將儀表板與背景程式令牌持久化至 `~/.fusion/settings.json`，並在後續啟動時
|
||||
重複使用，除非你覆蓋它（`--token`、`FUSION_DASHBOARD_TOKEN`、
|
||||
`FUSION_DAEMON_TOKEN`）或以 `--no-auth` 停用驗證。完整的優先順序與
|
||||
重設/撤銷選項，請參閱
|
||||
[命令列參考 → fn dashboard → 驗證](./docs/cli-reference.md#fn-dashboard)。
|
||||
|
||||
### 首次執行設定
|
||||
|
||||
首次啟動時，Fusion 會開啟**引導精靈**，提供三個引導步驟：
|
||||
|
||||
1. **AI 設定** — 使用簡化的快速啟動供應商清單（建議的供應商，加上已連線的供應商），只有在需要其他供應商或詳細設定時，才展開**進階供應商設定**。只需一個供應商即可開始使用。已棄用的 Google Gemini CLI / Antigravity 供應商項目已刻意隱藏；Google/Gemini API 金鑰、Google Generative AI、Vertex 與 Cloud Code 路徑仍受支援。
|
||||
2. **GitHub（選填）** — 連結 GitHub 以匯入議題並管理 PR
|
||||
3. **第一個任務** — 建立你的第一個任務或從 GitHub 匯入（若無作用中的專案，引導精靈會先提示你註冊/選取專案目錄）
|
||||
|
||||
精靈**可關閉且不阻擋操作**——點擊**暫時略過**即可立即使用儀表板。之後可從**設定 → 驗證 → 重新開啟引導指南**再次觸發。
|
||||
|
||||
### 行動裝置
|
||||
|
||||
Capacitor + PWA 工作流程，請參閱 [MOBILE.md](./MOBILE.md)。
|
||||
|
||||
---
|
||||
|
||||
## 文件
|
||||
|
||||
| 指南 | 涵蓋內容 |
|
||||
|
||||
BIN
demo/assets/agent-chat-gray.png
Normal file
BIN
demo/assets/agent-chat-gray.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 173 KiB |
BIN
demo/assets/agent-chat-light.png
Normal file
BIN
demo/assets/agent-chat-light.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 292 KiB |
BIN
demo/assets/agent-chat.gif
Normal file
BIN
demo/assets/agent-chat.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 165 KiB |
BIN
demo/assets/agent-mail-gray.gif
Normal file
BIN
demo/assets/agent-mail-gray.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 889 KiB |
BIN
demo/assets/agent-mail-light.gif
Normal file
BIN
demo/assets/agent-mail-light.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 644 KiB |
BIN
demo/assets/agent-mail.gif
Normal file
BIN
demo/assets/agent-mail.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 972 KiB |
BIN
demo/assets/chat-rooms-gray.gif
Normal file
BIN
demo/assets/chat-rooms-gray.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 688 KiB |
BIN
demo/assets/chat-rooms-light.gif
Normal file
BIN
demo/assets/chat-rooms-light.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 522 KiB |
BIN
demo/assets/chat-rooms.gif
Normal file
BIN
demo/assets/chat-rooms.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.5 MiB |
BIN
demo/assets/command-center-gray.gif
Normal file
BIN
demo/assets/command-center-gray.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
BIN
demo/assets/command-center-light.gif
Normal file
BIN
demo/assets/command-center-light.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
BIN
demo/assets/command-center-productivity.png
Normal file
BIN
demo/assets/command-center-productivity.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 119 KiB |
BIN
demo/assets/command-center-team.png
Normal file
BIN
demo/assets/command-center-team.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 161 KiB |
BIN
demo/assets/command-center-themes-dark.png
Normal file
BIN
demo/assets/command-center-themes-dark.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 908 KiB |
BIN
demo/assets/command-center-themes-light.png
Normal file
BIN
demo/assets/command-center-themes-light.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 926 KiB |
BIN
demo/assets/command-center-tokens.png
Normal file
BIN
demo/assets/command-center-tokens.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 149 KiB |
BIN
demo/assets/command-center.gif
Normal file
BIN
demo/assets/command-center.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.7 MiB |
4
demo/assets/fusion-logo-orange.svg
Normal file
4
demo/assets/fusion-logo-orange.svg
Normal file
@@ -0,0 +1,4 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none">
|
||||
<circle cx="64" cy="64" r="52" stroke="#f97316" stroke-width="8" />
|
||||
<path d="M26 101C44 82 62 64 82 45C90 37 98 30 104 24C96 35 89 47 81 60C70 79 57 95 43 108C38 112 32 108 26 101Z" fill="#f97316" />
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 286 B |
BIN
demo/assets/workflows-gray.gif
Normal file
BIN
demo/assets/workflows-gray.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 250 KiB |
BIN
demo/assets/workflows-light.gif
Normal file
BIN
demo/assets/workflows-light.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 210 KiB |
BIN
demo/assets/workflows.gif
Normal file
BIN
demo/assets/workflows.gif
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 246 KiB |
Reference in New Issue
Block a user