0fb6757100
Refresh the public docs to describe current workflow selection, editor, chat, and feature surfaces. - Add a top-level README workflow overview with built-in workflow IDs and editor links. - Update localized READMEs and docs index entries for workflows, chat, plugins, research, and remote access. - Expand Getting Started, Dashboard Guide, and Workflow Steps with workflow selection and authoring guidance. Files changed: README.es.md | 71 ++++++++++++++++++++++++++++++++----------------- README.fr.md | 67 +++++++++++++++++++++++++++++++--------------- README.ko.md | 71 ++++++++++++++++++++++++++++++++----------------- README.md | 65 +++++++++++++++++++++++++++++--------------- README.zh-CN.md | 71 ++++++++++++++++++++++++++++++++----------------- README.zh-TW.md | 71 ++++++++++++++++++++++++++++++++----------------- docs/README.md | 11 ++++---- docs/dashboard-guide.md | 11 +++++--- docs/getting-started.md | 18 ++++++++++--- docs/workflow-steps.md | 34 +++++++++++++++++++++++ 10 files changed, 339 insertions(+), 151 deletions(-) Fusion-Task-Id: FN-6521 Fusion-Task-Lineage: 6f8683fe-4a7c-4d41-bcf6-e6e5db9b100f
493 lines
31 KiB
Markdown
493 lines
31 KiB
Markdown
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
|
|
|
# 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.
|
|
|
|
[**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)
|
|
|
|
[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · **Español** · [한국어](./README.ko.md)
|
|
|
|
*Esta es una traducción automática; el README en inglés es el documento canónico.*
|
|
|
|
[](./LICENSE)
|
|
[](https://www.npmjs.com/package/@runfusion/fusion)
|
|
[](https://discord.gg/ksrfuy7WYR)
|
|
|
|
|
|
|
|
<br />
|
|
|
|
<img src="./demo/assets/fusion-reel.gif" alt="Demo de Fusion: de idea inicial a código en producción" width="900" />
|
|
|
|
<br />
|
|
<br />
|
|
|
|
<a href="https://runfusion.ai">
|
|
<img src="https://runfusion.ai/fusion-dashboard.png" alt="Panel de Fusion: columnas kanban de Planificación, Pendiente, En progreso, En revisión y Listo con tarjetas de tarea activas" width="900" />
|
|
</a>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## Todo tu entorno de desarrollo. En una sola pantalla.
|
|
|
|
Describe una tarea en lenguaje natural. Un agente de planificación lee tu proyecto, comprende el contexto y escribe un plan completo en `PROMPT.md` — pasos, alcance de archivos, criterios de aceptación. Luego Fusion planifica, revisa, ejecuta y vuelve a revisar, en un worktree de git aislado, con una aprobación humana donde tú la necesites.
|
|
|
|
Un tablero. Controlado desde cualquier lugar. Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todo conectado.
|
|
|
|
> Como Trello, pero tus tareas son especificadas, ejecutadas y entregadas por IA. Construido sobre el gran trabajo de [dustinbyrne/kb](https://github.com/dustinbyrne/kb).
|
|
|
|
---
|
|
|
|
## El flujo
|
|
|
|
```
|
|
① Describir ② Planificación ③ El tablero ④ Worktree aislado
|
|
───────────── ───────────── ───────────── ─────────────────────
|
|
"Agregar modo → El agente escribe → Plan → Revisión → → rama fusion/FN-123
|
|
oscuro al PROMPT.md Ejecución → concurrente, cero
|
|
panel de (pasos, alcance, Revisión (por conflictos de
|
|
configuración" aceptación) paso, hasta archivos
|
|
terminar)
|
|
```
|
|
|
|
### Ve cada paso antes del merge
|
|
|
|
<div align="center">
|
|
<img src="https://runfusion.ai/screenshot-task-detail.png" alt="Detalle de tarea en Fusion: pasos del flujo visibles en una tarea en progreso con diffs y cambios de archivos" width="820" />
|
|
</div>
|
|
|
|
Cada tarea muestra su plan, sus revisiones, sus diffs y sus cambios de archivos en tiempo real. Entra a una tarea activa y ajusta la dirección, refina las restricciones, pausa o reescribe el prompt.
|
|
|
|
---
|
|
|
|
## Qué lo hace diferente
|
|
|
|
| | |
|
|
|---|---|
|
|
| 🧠 **Planificación con IA** | Describe una tarea en lenguaje natural. Los agentes de planificación la convierten en un plan `PROMPT.md` con pasos, alcance de archivos y criterios de aceptación. |
|
|
| 🔁 **Workflows seleccionables** | Los integrados cubren codificación, arreglos rápidos, trabajo con revisión intensa, ejecución paso a paso, Compound Engineering con plugin y fragmentos de ciclo de vida de PR. Elige un workflow por tarea o crea personalizados en el [Editor de workflows](./docs/workflow-editor.md). |
|
|
| 🌳 **Aislamiento con worktrees** | Cada tarea corre en su propia rama y worktree (`fusion/{task-id}`). Tareas en paralelo. Cero conflictos. Delegación opcional a [worktrunk](https://github.com/max-sixty/worktrunk) mediante [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (ver [abstracción WorktreeBackend](./docs/architecture.md#worktreebackend-abstraction)). |
|
|
| ⚡ **Controles de merge inteligente** | ¿Pasa todas las puertas? Fusion hace squash-merge y avanza. Puedes exigir aprobación manual, heredar el valor global de auto-merge o definir sobreescrituras por tarea. |
|
|
| 🛰️ **Malla multinodo** | Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados. Escritorio, móvil, web. |
|
|
| 🧩 **Cualquier modelo** | Anthropic, OpenAI, Ollama, Google Generative AI, Z.ai, runtimes locales y [proveedores personalizados](./docs/dashboard-guide.md#custom-providers). Local y nube coexisten, con canales de modelo/fallback configurables por workflow. |
|
|
| 🏢 **Empresas de agentes** | Importa equipos predefinidos — más de 440 agentes en 16 empresas — y ejecútalos de forma autónoma durante semanas. |
|
|
| 📬 **Mensajería entre agentes** | Buzón incorporado entre agentes. Delega, aclara, coordina. |
|
|
| 🗨️ **Chat de agentes** | Chat directo, chat de tareas, adjuntos, tarjetas de preguntas en chat, streams reanudables y salas multiagente experimentales donde los miembros mencionados responden directamente y miembros ambientales pueden sumarse hasta un límite. ([Documentación de chat](./docs/dashboard-guide.md#chat-view)) |
|
|
| 🗺️ **Misiones** | Planificación jerárquica (Misión → Hito → Slice → Característica → Tarea) con piloto automático y contratos de validación. |
|
|
| 🔬 **Investigación** | Ejecuciones de investigación delimitadas con búsqueda web, GitHub, documentación local y síntesis con LLM (además de soporte integrado en tiempo de ejecución para WebSearch/WebFetch en flujos de planificación y síntesis cuando está disponible). Convierte los hallazgos en tareas. ([Documentación](./docs/research.md)) |
|
|
| 🧪 **Automejora** | Los agentes reflexionan sobre su propio resultado y actualizan sus prompts a medida que aprenden tu base de código. |
|
|
| 🔓 **Código abierto. MIT.** | Sin dependencia de proveedor. Ejecútalo en tu propio hardware. Se actualiza semanalmente. |
|
|
|
|
---
|
|
|
|
## Cómo funciona
|
|
|
|
```mermaid
|
|
graph TD
|
|
H((Tú)) -->|idea inicial| T["Planificación<br/><i>planificación automática</i>"]
|
|
T --> TD["Pendiente<br/><i>programado para ejecución</i>"]
|
|
TD --> IP["En progreso<br/><i>para cada paso:<br/>planificar, revisar, ejecutar, revisar</i>"]
|
|
|
|
subgraph IP["En progreso"]
|
|
direction TD
|
|
NS([Iniciar paso]) --> P[Planificar]
|
|
P --> R1{Revisar}
|
|
R1 -->|revisar| P
|
|
R1 -->|aprobar| E[Ejecutar]
|
|
E --> R2{Revisar}
|
|
R2 -->|revisar| E
|
|
R2 -->|siguiente paso| NS
|
|
R2 -->|repensar| P
|
|
end
|
|
|
|
R2 -->|listo| IR["En revisión<br/><i>listo para merge,<br/>o completado automáticamente</i>"]
|
|
IR -->|squash merge directo<br/>o PR mergeado| D["Listo"]
|
|
|
|
style H fill:#161b22,stroke:#8b949e,color:#e6edf3
|
|
style T fill:#2d2006,stroke:#d29922,color:#d29922
|
|
style TD fill:#0d2044,stroke:#58a6ff,color:#58a6ff
|
|
style IP fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff
|
|
style P fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style R1 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style E fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style R2 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style NS fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff
|
|
style IR fill:#0d2d16,stroke:#3fb950,color:#3fb950
|
|
style D fill:#1a1a1a,stroke:#8b949e,color:#8b949e
|
|
```
|
|
|
|
Las tareas con dependencias se procesan secuencialmente. Las tareas independientes se ejecutan en paralelo. Opcionalmente puedes requerir aprobación manual antes de que las tareas pasen de Planificación a Pendiente (configuración `requirePlanApproval`).
|
|
|
|
---
|
|
|
|
## Resumen del flujo de trabajo
|
|
|
|
Fusion workflows definen cómo una tarea pasa de una idea a una entrega. La ruta de codificación predeterminada sigue siendo el ciclo **Planificación/triage → Ejecución → Pasos del flujo → Revisión → Merge**, pero ahora la política vive en un workflow seleccionable en lugar de estar solo codificada en el motor.
|
|
|
|
- **Selecciona por tarea:** elige un workflow desde los controles de workflow de la tarea/tablero, o asígnalo con `fn_workflow_select` / `workflow_id` al crear tareas.
|
|
- **Catálogo integrado:** Coding (`builtin:coding`), Quick fix (`builtin:quick-fix`), Review-heavy (`builtin:review-heavy`), Compound engineering (`builtin:compound-engineering`, requiere plugin), Stepwise coding (`builtin:stepwise-coding`) y PR lifecycle (`builtin:pr-workflow`, un fragmento reutilizable de grafo de PR).
|
|
- **Personaliza con seguridad:** inspecciona los workflows integrados, duplícalos o crea workflows personalizados en el [Editor de workflows](./docs/workflow-editor.md). Los ajustes específicos de workflow cubren canales de modelo, revisión/aprobación, ejecución de pasos, campos de tarea y columnas.
|
|
|
|
Lee [Pasos del flujo](./docs/workflow-steps.md) para la semántica de ejecución y [Editor de workflows](./docs/workflow-editor.md) para la guía de autoría en el panel.
|
|
|
|
---
|
|
|
|
## Multinodo. Un tablero. Todas las plataformas.
|
|
|
|
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-mesh.gif" alt="Malla de Fusion: laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados" width="820" />
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — cada nodo es un par. El estado de tus tareas, agentes, registros y diffs permanecen sincronizados en toda la malla. El mismo Fusion se distribuye como:
|
|
|
|
- 🖥️ **Aplicación de escritorio** — Electron para **macOS** (Intel + Apple Silicon), **Windows** 10/11 y **Linux**
|
|
- 📱 **Aplicación móvil** — Capacitor para **iOS/iPadOS** y **Android** ([MOBILE.md](./MOBILE.md))
|
|
- 🌐 **Panel web** — cualquier navegador moderno, servido desde el daemon `fn dashboard`
|
|
- 🔌 **CLI** — binario `fn` + extensión para flujos de trabajo centrados en la terminal
|
|
|
|
Inicia el daemon en cualquier nodo, conecta tus otros dispositivos y el tablero te sigue a todas partes.
|
|
|
|
---
|
|
|
|
## Ejecuta una empresa de agentes
|
|
|
|
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-company-reel.gif" alt="Empresa de agentes Fusion: importa un equipo y ejecútalo de forma autónoma durante semanas" width="820" />
|
|
|
|
</div>
|
|
|
|
Importa un equipo. Ejecútalo de forma autónoma durante semanas. **Más de 440 agentes en 16 empresas**, preparados para misiones, buzones y delegación entre agentes.
|
|
|
|
```bash
|
|
npx companies.sh add paperclipai/companies/gstack
|
|
```
|
|
|
|
---
|
|
|
|
## Compatible con las herramientas que ya usas.
|
|
|
|
Fusion se integra con las herramientas que ya conoces. **Hermes**, **Paperclip** y **OpenClaw** vienen como plugins de primera clase — enruta cualquier espacio de trabajo al entorno de ejecución que mejor se adapte a la tarea. Y cualquier empresa de agentes de Paperclip se importa con un solo comando.
|
|
|
|
<div align="center">
|
|
<img src="./demo/assets/hermes-logo.svg" alt="Hermes" height="56" />
|
|
</div>
|
|
|
|
### [Hermes](https://hermes-agent.nousresearch.com) <sub>`experimental`</sub>
|
|
|
|
<sub>Nous Research</sub>
|
|
|
|
El agente autónomo de código abierto de **Nous Research**. Instala el plugin de Hermes y ejecuta agentes a través de Hermes para trabajos de larga duración con contexto creciente — enruta cualquier espacio de trabajo de Fusion hacia él.
|
|
|
|
### OpenClaw <sub>`experimental`</sub>
|
|
|
|
El soporte del entorno de ejecución de OpenClaw está disponible como plugin experimental (`fusion-plugin-openclaw-runtime`) para paridad en el descubrimiento y la configuración del entorno. Configura los agentes con `runtimeConfig.runtimeHint: "openclaw"` después de instalar el plugin.
|
|
|
|
<br />
|
|
|
|
<div align="center">
|
|
<img src="./demo/assets/paperclip-logo.svg" alt="Paperclip" height="56" />
|
|
</div>
|
|
|
|
### [Paperclip](https://paperclip.ing) <sub>`experimental`</sub>
|
|
|
|
<sub>paperclip.ing</sub>
|
|
|
|
El plano de control humano para la mano de obra de IA. Instala el plugin de Paperclip para ejecutar agentes a través de Paperclip dentro de Fusion.
|
|
|
|
Fusion también soporta nativamente el estándar de empresa de agentes **[`companies.sh`](https://github.com/paperclipai/companies)**: importa un equipo predefinido — **más de 440 agentes en 16 empresas** — y déjalos coordinarse a través del buzón, las misiones y las puertas de flujo de Fusion durante semanas de trabajo autónomo. El mismo formato de empresa, los mismos agentes, las mismas habilidades que Paperclip.
|
|
|
|
```bash
|
|
npx companies.sh add paperclipai/companies/gstack
|
|
```
|
|
|
|
<br />
|
|
|
|
> **Hermes**, **Paperclip** y **OpenClaw** son plugins de entorno de ejecución **experimentales** — las APIs y los formatos de comunicación pueden cambiar entre versiones menores.
|
|
|
|
---
|
|
|
|
## 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 |
|
|
|---|---|
|
|
| [Primeros pasos](./docs/getting-started.md) | Instalación, incorporación, primera tarea y selección básica de workflows |
|
|
| [Guía del panel](./docs/dashboard-guide.md) | Vistas de tablero/lista, chat, editor de workflows, gestor de git, configuración y herramientas UI |
|
|
| [Gestión de tareas](./docs/task-management.md) | Ciclo de vida, especificaciones de prompts, comentarios, archivado e integración con GitHub |
|
|
| [Referencia CLI](./docs/cli-reference.md) | Referencia completa de comandos `fn` y daemon |
|
|
| [Referencia de configuración](./docs/settings-reference.md) | Configuración global/proyecto, jerarquía de modelos, configuración de workflows y proveedores personalizados |
|
|
| [Pasos del flujo](./docs/workflow-steps.md) | Runtime de workflows, integrados, puertas, plantillas y fases |
|
|
| [Editor de workflows](./docs/workflow-editor.md) | Autoría visual, importación/exportación, campos/columnas/configuración y editor móvil |
|
|
| [Investigación](./docs/research.md) | Ejecuciones de investigación, hallazgos, exportaciones e integración con tareas |
|
|
| [Agentes](./docs/agents.md) | Gestión de agentes, spawning, latidos y buzones |
|
|
| [Misiones](./docs/missions.md) | Jerarquía, planificación, piloto automático y contratos de validación |
|
|
| [Gestión de plugins](./docs/plugin-management.md) | Descubrir, instalar, habilitar, configurar y solucionar plugins |
|
|
| [Autoría de plugins](./docs/PLUGIN_AUTHORING.md) | Crear plugins con hooks, rutas, herramientas, runtimes y superficies de panel |
|
|
| [Acceso remoto](./docs/remote-access.md) | Acceso remoto con token, Tailscale/Cloudflare y solución de problemas |
|
|
| [Multiproyecto](./docs/multi-project.md) | Registro central, aislamiento y migraciones |
|
|
| [Docker](./docs/docker.md) | Despliegue en contenedores |
|
|
|
|
---
|
|
|
|
## Características principales
|
|
|
|
- **AI Planning** — Planning agent generates detailed `PROMPT.md` with steps, file scope, and acceptance criteria
|
|
- **Step-by-step Execution** — Plan → Review → Execute → Review cycle for each task step, with graph-mode workflows able to model per-step parse/execute/review/rework explicitly
|
|
- **Git Worktree Isolation** — Each task runs in its own worktree (`fusion/{task-id}` branch)
|
|
- **Selectable workflows** — Pick Coding, Quick fix, Review-heavy, Stepwise coding, plugin-gated Compound Engineering, custom workflows, or PR lifecycle fragments where appropriate ([overview](#resumen-del-flujo-de-trabajo); [Workflow Steps](./docs/workflow-steps.md#resumen-del-flujo-de-trabajo))
|
|
- **Visual Workflow Editor** — Inspect read-only built-ins, duplicate/customize workflows, and edit graph nodes, columns, task fields, typed settings, and per-project values ([Workflow Editor](./docs/workflow-editor.md))
|
|
- **Workflow Steps** — Configurable quality gates (pre-merge blocks merge; post-merge informational), plus opt-in [Browser Verification](./docs/workflow-steps.md#workflow-declared-optional-steps)
|
|
- **Workflow-native policy** — Fast-mode planning, typed triage thresholds, review/approval, step execution, and model/fallback lanes are workflow settings ([Settings Reference](./docs/settings-reference.md#workflow-settings))
|
|
- **GitHub + PR lifecycle** — Import issues, create PRs, display live PR/issue badges, and use workflow-mode PR lifecycle graph fragments where enabled
|
|
- **Dashboard** — Real-time kanban/list/graph views, agent management, terminal, git manager, missions, chat, workflow editor, custom providers, and one-click updates
|
|
- **Missions** — Hierarchical planning (Mission → Milestone → Slice → Feature → Task) with autopilot, validation contracts, fix-feature retries, mission-goal linking, and blocked handoffs
|
|
- **Multi-Project** — Manage multiple projects from one installation with project isolation
|
|
- **Custom Providers** — Add OpenAI-compatible, OpenAI Responses, Anthropic-compatible, or Google Generative AI providers; saved models appear in project and workflow model dropdowns ([Dashboard Guide](./docs/dashboard-guide.md#custom-providers))
|
|
- **Smart merge controls** — Global auto-merge stays live for default tasks, while explicit per-task overrides can force auto/manual behavior
|
|
- **Inter-Agent Messaging** — Built-in messaging for coordination between agents and users; engineer-role agents can opt into backlog auto-claim
|
|
- **Agent Chat + Chat Rooms** — Direct/task chat supports attachments, resumable streams, question response cards, and renameable conversations; experimental rooms route mentioned members as direct responders ([Dashboard Guide → Chat View](./docs/dashboard-guide.md#chat-view))
|
|
|
|
### Autenticación de proveedores
|
|
|
|
Fusion soporta autenticación basada en OAuth para proveedores de IA configurados en **Configuración → Autenticación**. Para la mayoría de los proveedores OAuth, cuando se accede al panel desde un host que no es localhost (nodo remoto, host/IP de LAN o proxy inverso), las URLs de inicio de sesión del proveedor se reescriben para enrutar los callbacks de OAuth a través de un endpoint puente (`/api/auth/oauth-callback`) de modo que las redirecciones lleguen a la sesión de navegador activa.
|
|
|
|
- **Anthropic (Claude)** — Usa un flujo de código de autorización pegado en Configuración/incorporación: inicia sesión y pega la URL de redirección final (o el código) de vuelta en Fusion para completar el inicio de sesión
|
|
- **OpenAI Codex** — Usa el mismo flujo de código de autorización pegado con validación segura de estado
|
|
- **Factory AI — mediante Droid CLI** *(opcional)* — requiere instalación local de Droid CLI + `droid auth login`; la detección sigue la ruta efectiva del binario en tiempo de ejecución (predeterminado `droid`, o `droidBinaryPath` del plugin cuando está configurado), luego habilita en **Configuración → Autenticación** y reinicia Fusion
|
|
- **llama.cpp — mediante servidor HTTP** *(opcional)* — configura la URL de tu servidor llama.cpp (predeterminado `http://127.0.0.1:8080`) y la clave API opcional, luego habilita en **Configuración → Autenticación**
|
|
- **Otros proveedores** — Autentícate mediante entrada de clave API en Configuración (incluidas la clave API de Google/Gemini, Google Generative AI, Vertex y los alias de Cloud Code)
|
|
|
|
### Sistema de modelos
|
|
|
|
Fusion usa una jerarquía de modelos de doble alcance con cinco canales independientes. La configuración global define los valores predeterminados de referencia; la configuración de proyecto proporciona sobreescrituras por proyecto.
|
|
|
|
| Canal | Propósito | Claves de referencia global | Claves de sobreescritura por proyecto |
|
|
|------|---------|---------------------|----------------------|
|
|
| Executor | Agente de ejecución de tareas | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` |
|
|
| Planning | Agente de planificación de tareas | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` |
|
|
| Validator | Revisor de plan/código | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` |
|
|
| Title Summarization | Generación automática de títulos | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` |
|
|
| Workflow Step Refinement | Refinamiento de prompts con IA | (usa `defaultProvider`/`defaultModelId`) | (usa `modelProvider`/`modelId` en WorkflowStep) |
|
|
|
|
**Canales de workflow:** El workflow predeterminado expone canales de modelo Plan/Triage, Executor, Reviewer y fallback en **Configuración → Modelos de proyecto**, y los workflows avanzados pueden declarar valores tipados adicionales ([Referencia de configuración](./docs/settings-reference.md#workflow-settings)).
|
|
|
|
**Sobreescrituras por tarea:** Las tareas pueden sobreescribir los canales de executor, validator y planning con campos de modelo por tarea (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`).
|
|
|
|
**Precedencia:** Por tarea → Sobreescritura de proyecto → Canal global → `defaultProvider`/`defaultModelId` → Resolución automática.
|
|
|
|
Para la documentación completa de configuración, consulta la [Referencia de configuración](./docs/settings-reference.md).
|
|
|
|
### Tareas programadas / automatizaciones
|
|
|
|
Fusion soporta automatización de tareas programadas a través de los endpoints `/api/automations`. Las automatizaciones pueden ejecutar comandos de shell o flujos de trabajo de múltiples pasos en un horario configurable.
|
|
|
|
#### Alcance de la programación
|
|
|
|
Las automatizaciones y rutinas pueden ejecutarse en dos alcances:
|
|
|
|
- **Global** — Se ejecuta en todos los proyectos. Úsalo para mantenimiento entre proyectos, copias de seguridad o reportes unificados.
|
|
- **Proyecto** — Se ejecuta solo dentro de un proyecto específico. Úsalo para CI, pruebas o tareas de despliegue específicas del proyecto.
|
|
|
|
Cuando creas una programación sin elegir un alcance, Fusion usa por defecto el **alcance de proyecto** con el ID de proyecto `default` por compatibilidad con versiones anteriores.
|
|
|
|
Para especificar un alcance de forma explícita:
|
|
- En el modal de **Tareas programadas** del panel, usa el selector **Global / Proyecto**.
|
|
- Mediante la API, pasa `?scope=global` o `?scope=project&projectId=<id>` en los endpoints de automatización/rutina.
|
|
|
|
**Reglas de resolución de alcance:**
|
|
- `scope=global` siempre se resuelve en el canal de automatización/rutina global, independientemente del proyecto activo.
|
|
- `scope=project` requiere un `projectId`. Si se omite, vuelve a `"default"`.
|
|
- Las operaciones de CRUD, ejecución, activación/desactivación y webhook están estrictamente aisladas por alcance: una programación global no puede ser modificada desde una solicitud de alcance de proyecto, y viceversa.
|
|
|
|
**Orientación operativa para configuraciones multiproyecto:**
|
|
- Prefiere programaciones **globales** para infraestructura compartida (p. ej., copias de seguridad nocturnas, extracción de información de memoria).
|
|
- Prefiere programaciones de **proyecto** para automatización por repositorio (p. ej., ejecutores de pruebas por proyecto, hooks de despliegue).
|
|
- Los canales global y de proyecto son sondeados de forma independiente por el motor, por lo que las ejecuciones pendientes en un canal no bloquean al otro.
|
|
|
|
#### Automatizaciones
|
|
|
|
| Endpoint | Método | Descripción |
|
|
|---------|--------|-------------|
|
|
| `/api/automations` | GET | Listar todas las automatizaciones (filtradas por alcance si se especifica) |
|
|
| `/api/automations` | POST | Crear automatización (el alcance predeterminado es `project`) |
|
|
| `/api/automations/:id` | GET | Obtener automatización por ID |
|
|
| `/api/automations/:id` | PATCH | Actualizar automatización |
|
|
| `/api/automations/:id` | DELETE | Eliminar automatización |
|
|
| `/api/automations/:id/run` | POST | Activar ejecución manual |
|
|
| `/api/automations/:id/toggle` | POST | Activar/desactivar |
|
|
| `/api/automations/:id/steps/reorder` | POST | Reordenar pasos de la automatización |
|
|
|
|
#### Rutinas
|
|
|
|
Las rutinas son tareas de agente de IA activadas por programaciones cron, webhooks o ejecución manual. Las rutinas comparten el mismo modelo de alcance global/proyecto que las automatizaciones.
|
|
|
|
| Endpoint | Método | Descripción |
|
|
|---------|--------|-------------|
|
|
| `/api/routines` | GET | Listar todas las rutinas (filtradas por alcance si se especifica) |
|
|
| `/api/routines` | POST | Crear rutina (el alcance predeterminado es `project`) |
|
|
| `/api/routines/:id` | GET | Obtener rutina por ID |
|
|
| `/api/routines/:id` | PATCH | Actualizar rutina |
|
|
| `/api/routines/:id` | DELETE | Eliminar rutina |
|
|
| `/api/routines/:id/run` | POST | Activar manualmente |
|
|
| `/api/routines/:id/trigger` | POST | Activación manual canónica |
|
|
| `/api/routines/:id/runs` | GET | Obtener historial de ejecuciones |
|
|
| `/api/routines/:id/webhook` | POST | Activación por webhook (verificación de firma compatible) |
|
|
|
|
---
|
|
|
|
## Ejemplos rápidos de CLI
|
|
|
|
```bash
|
|
fn task create "Fix the login bug" # Entrada rápida → planificación
|
|
fn task plan "Build auth system" # Planificación guiada por IA
|
|
fn task import owner/repo --labels bug # Importar issues de GitHub
|
|
fn task show FN-001 # Ver detalles de la tarea
|
|
fn task logs FN-001 --follow # Transmitir registros de ejecución
|
|
fn task steer FN-001 "Use TypeScript" # Guiar al agente durante la ejecución
|
|
|
|
fn project add my-app /path/to/app # Registrar un proyecto
|
|
fn project list # Listar todos los proyectos
|
|
|
|
fn settings set maxConcurrent 4 # Configurar ajustes
|
|
fn settings export # Exportar configuración
|
|
|
|
fn mission create "Auth System" "Build auth" # Crear misión
|
|
fn mission activate-slice <slice-id> # Activar un slice
|
|
|
|
fn skills search react # Buscar en skills.sh
|
|
fn skills install firebase/agent-skills # Instalar habilidades de agente
|
|
```
|
|
|
|
---
|
|
|
|
## Paquetes
|
|
|
|
| Paquete | Descripción |
|
|
|---------|-------------|
|
|
| `@fusion/core` | Modelo de dominio — tareas, columnas del tablero, almacén SQLite |
|
|
| `@fusion/dashboard` | Interfaz web — servidor Express + tablero kanban con SSE |
|
|
| `@fusion/engine` | Motor de IA — planificación, ejecución, programación, pasos del flujo |
|
|
| `@runfusion/fusion` | CLI + extensión — publicado en npm |
|
|
|
|
---
|
|
|
|
## Desarrollo
|
|
|
|
```bash
|
|
pnpm install # Instalar dependencias
|
|
pnpm local # Iniciar panel/API local en un puerto distinto al 4040
|
|
pnpm local -- --engine # Iniciar panel local con el motor de IA
|
|
pnpm build # Compilar paquetes del espacio de trabajo predeterminado (excluye escritorio/móvil)
|
|
pnpm build:all # Compilar todos los paquetes (incluyendo escritorio/móvil)
|
|
pnpm dev dashboard # Ejecutar panel + motor de IA
|
|
pnpm dev:ui # Solo el panel (sin motor de IA)
|
|
pnpm lint # Verificar estilo de código en todos los paquetes
|
|
pnpm typecheck # Verificar tipos en todos los paquetes
|
|
pnpm test # Ejecutar todas las pruebas
|
|
```
|
|
|
|
### Compilar un ejecutable independiente
|
|
|
|
Compila un binario `fn` autocontenido usando [Bun](https://bun.sh/):
|
|
|
|
```bash
|
|
pnpm build:exe # Compilar para la plataforma actual
|
|
pnpm build:exe:all # Compilación cruzada para todas las plataformas
|
|
```
|
|
|
|
---
|
|
|
|
## Licencia
|
|
|
|
MIT — código abierto, sin dependencia de proveedor. Ver [LICENSE](./LICENSE).
|
|
|
|
<div align="center">
|
|
|
|
**[runfusion.ai →](https://runfusion.ai)**
|
|
|
|
</div>
|