diff --git a/README.es.md b/README.es.md new file mode 100644 index 0000000000..a69739fc7c --- /dev/null +++ b/README.es.md @@ -0,0 +1,469 @@ +
+ +Fusion + +# 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: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) +[![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) +[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) +![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) +![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg) + +
+ +Demo de Fusion: de idea inicial a código en producción + +
+
+ + + Panel de Fusion: columnas kanban de Planificación, Pendiente, En progreso, En revisión y Listo con tarjetas de tarea activas + + +
+ +--- + +## 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 + +
+ Detalle de tarea en Fusion: pasos del flujo visibles en una tarea en progreso con diffs y cambios de archivos +
+ +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. | +| 🔁 **Puertas de flujo** | Plan → Revisión → Ejecución → Revisión en cada paso. Las puertas previas al merge bloquean código deficiente; las posteriores ejecutan verificaciones informativas. | +| 🌳 **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)). | +| ⚡ **Merge inteligente** | ¿Pasa todas las puertas? Fusion hace squash-merge y avanza. Habilita aprobación manual en cualquier punto. | +| 🛰️ **Malla multinodo** | Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados. Escritorio, móvil, web. | +| 🧩 **Cualquier modelo** | Anthropic, OpenAI, Ollama y más. Local y en la nube coexisten. | +| 🏢 **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. | +| 🗨️ **Salas de chat multiagente** | Conversaciones grupales con alcance de proyecto donde varios miembros de la sala pueden responder: los miembros mencionados son respondedores directos, y miembros ambientales adicionales pueden responder hasta un límite. Actualmente **experimental** — habilita `chatRooms` en **Configuración → Funciones experimentales → Salas de chat**. ([Documentación de salas de chat](./docs/dashboard-guide.md#chat-rooms)) | +| 🗺️ **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
planificación automática"] + T --> TD["Pendiente
programado para ejecución"] + TD --> IP["En progreso
para cada paso:
planificar, revisar, ejecutar, revisar"] + + 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
listo para merge,
o completado automáticamente"] + IR -->|squash merge directo
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`). + +--- + +## Multinodo. Un tablero. Todas las plataformas. + +
+ +Malla de Fusion: laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados + +
+ +![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) +![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) +![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) +![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white) + +
+ +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 + +
+ +Empresa de agentes Fusion: importa un equipo y ejecútalo de forma autónoma durante semanas + +
+ +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. + +
+ Hermes +
+ +### [Hermes](https://hermes-agent.nousresearch.com) `experimental` + +Nous Research + +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 `experimental` + +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. + +
+ +
+ Paperclip +
+ +### [Paperclip](https://paperclip.ing) `experimental` + +paperclip.ing + +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 +``` + +
+ +> **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 e incorporación | +| [Guía del panel](./docs/dashboard-guide.md) | Vistas de tablero/lista, terminal, gestor de git | +| [Gestión de tareas](./docs/task-management.md) | Ciclo de vida de la tarea y comandos CLI | +| [Referencia CLI](./docs/cli-reference.md) | Referencia completa de comandos y daemon | +| [Referencia de configuración](./docs/settings-reference.md) | Opciones de configuración | +| [Arquitectura](./docs/architecture.md) | Funcionamiento interno del sistema | +| [Agentes](./docs/agents.md) | Gestión de agentes, creación, latido | +| [Pasos del flujo](./docs/workflow-steps.md) | Puertas de calidad, plantillas, fases | +| [Misiones](./docs/missions.md) | Jerarquía de misiones, planificación, piloto automático | +| [Multiproyecto](./docs/multi-project.md) | Registro central, modos de aislamiento | +| [Docker](./docs/docker.md) | Despliegue en contenedores | + +--- + +## Características principales + +- **Planificación con IA** — El agente de planificación genera un `PROMPT.md` detallado con pasos, alcance de archivos y criterios de aceptación +- **Ejecución paso a paso** — Ciclo Plan → Revisión → Ejecución → Revisión para cada paso de la tarea +- **Aislamiento con worktrees de git** — Cada tarea corre en su propio worktree (rama `fusion/{task-id}`) +- **Pasos del flujo** — Puertas de calidad configurables (previas al merge: bloquean el merge; posteriores al merge: informativas) +- **Integración con GitHub** — Importar issues, crear PRs, insignias en tiempo real de PR/issue +- **Panel** — Tablero kanban en tiempo real, gestión de agentes, terminal, gestor de git, planificador de misiones +- **Misiones** — Planificación jerárquica (Misión → Hito → Slice → Característica → Tarea) con piloto automático, contratos de validación, reintentos de corrección de características y semántica de entrega bloqueada +- **Multiproyecto** — Gestiona múltiples proyectos desde una sola instalación con aislamiento de proyectos +- **Mensajería entre agentes** — Sistema de mensajería integrado para la coordinación entre agentes y usuarios +- **Salas de chat (experimental)** — Chat grupal con alcance de proyecto donde los miembros mencionados se enrutan como respondedores directos y miembros ambientales adicionales pueden responder hasta un límite (habilitar en **Configuración → Funciones experimentales → Salas de chat**; detalles en [Guía del panel → Salas de chat](./docs/dashboard-guide.md#chat-rooms)) + +### 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) | + +**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=` 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 # 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). + +
+ +**[runfusion.ai →](https://runfusion.ai)** + +
diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 0000000000..ed18bbd973 --- /dev/null +++ b/README.fr.md @@ -0,0 +1,469 @@ +
+ +Fusion + +# 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. + +[**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** · [Español](./README.es.md) · [한국어](./README.ko.md) + +*Traduction automatique — le README anglais fait foi.* + +[![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) +[![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) +[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) +![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) +![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg) + +
+ +Démo Fusion : de l'idée brute au code de production + +
+
+ + + Tableau de bord Fusion : colonnes kanban Planification, À faire, En cours, En révision, Terminé avec des cartes de tâches actives + + +
+ +--- + +## Tout votre environnement de développement. Sur un seul écran. + +Décrivez une tâche en langage naturel. Un agent de planification lit votre projet, comprend le contexte et rédige un plan `PROMPT.md` complet — étapes, périmètre des fichiers, critères d'acceptation. Fusion planifie ensuite, révise, exécute et révise à nouveau, dans un worktree git isolé, avec une validation humaine où vous le souhaitez. + +Un tableau. Contrôlé de n'importe où. Laptop, Mac mini, serveur Linux, VM cloud, téléphone — tous connectés. + +> Comme Trello, mais vos tâches sont spécifiées, exécutées et livrées par l'IA. Construit sur l'excellent travail de [dustinbyrne/kb](https://github.com/dustinbyrne/kb). + +--- + +## Le flux + +``` + ① Décrire ② Planification ③ Le tableau ④ Worktree isolé + ───────────── ───────────── ───────────── ───────────────────── + "Ajouter un → L'agent rédige → Plan → Révision → → branche fusion/FN-123 + bouton mode PROMPT.md Exécution → Révision concurrent, zéro + sombre dans le (étapes, périmètre, (par étape, jusqu'à conflit de fichiers + panneau réglages" acceptation) la fin) +``` + +### Voir chaque étape avant la fusion + +
+ Détail d'une tâche Fusion : étapes du workflow visibles sur une tâche en cours avec diffs et modifications de fichiers +
+ +Chaque tâche affiche son plan, ses révisions, ses diffs et ses modifications de fichiers en temps réel. Intervenez sur une tâche active pour réorienter, affiner les contraintes, mettre en pause ou reformuler. + +--- + +## Ce qui la différencie + +| | | +|---|---| +| 🧠 **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. | +| 🌳 **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. | +| 🛰️ **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. | +| 🏢 **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. | +| 🗨️ **Salles de discussion multi-agents** | Conversations de groupe à portée de projet où plusieurs membres peuvent répondre : les membres mentionnés sont des répondants directs, et des membres ambiants supplémentaires peuvent répondre jusqu'à un certain plafond. Actuellement **expérimental** — activez `chatRooms` dans **Paramètres → Fonctionnalités expérimentales → Salles de discussion**. ([Documentation des salles de discussion](./docs/dashboard-guide.md#chat-rooms)) | +| 🗺️ **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)) | +| 🧪 **Auto-amélioration** | Les agents réfléchissent à leurs propres résultats et mettent à jour leurs prompts au fur et à mesure qu'ils apprennent votre base de code. | +| 🔓 **Open source. MIT.** | Pas d'enfermement propriétaire. Faites-le tourner sur votre propre matériel. Livraisons hebdomadaires. | + +--- + +## Comment ça fonctionne + +```mermaid +graph TD + H((Vous)) -->|idée brute| T["Planification
planification automatique"] + T --> TD["À faire
programmé pour l'exécution"] + TD --> IP["En cours
pour chaque étape :
plan, révision, exécution, révision"] + + subgraph IP["En cours"] + direction TD + NS([Commencer l'étape]) --> P[Plan] + P --> R1{Révision} + R1 -->|réviser| P + R1 -->|approuver| E[Exécuter] + E --> R2{Révision} + R2 -->|réviser| E + R2 -->|étape suivante| NS + R2 -->|repenser| P + end + + R2 -->|terminé| IR["En révision
prêt à fusionner,
ou auto-complétion"] + IR -->|squash merge direct
ou PR fusionnée| D["Terminé"] + + 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 +``` + +Les tâches avec dépendances sont traitées séquentiellement. Les tâches indépendantes s'exécutent en parallèle. Vous pouvez exiger une validation manuelle avant que les tâches passent de Planification à À faire (paramètre `requirePlanApproval`). + +--- + +## Multi-nœuds. Un tableau. Toutes les plateformes. + +
+ +Maillage Fusion : laptop, Mac mini, serveur Linux, VM cloud, téléphone — tous synchronisés + +
+ +![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) +![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) +![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) +![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white) + +
+ +Laptop, Mac mini, serveur Linux, VM cloud, téléphone — chaque nœud est un pair. L'état de vos tâches, vos agents, vos journaux et vos diffs restent synchronisés sur tout le maillage. Le même Fusion est livré sous forme de : + +- 🖥️ **Application de bureau** — Electron pour **macOS** (Intel + Apple Silicon), **Windows** 10/11 et **Linux** +- 📱 **Application mobile** — Capacitor pour **iOS/iPadOS** et **Android** ([MOBILE.md](./MOBILE.md)) +- 🌐 **Tableau de bord web** — tout navigateur moderne, servi par le démon `fn dashboard` +- 🔌 **CLI** — binaire `fn` + extension pour les workflows orientés terminal + +Démarrez le démon sur n'importe quel nœud, connectez vos autres appareils, et le tableau vous suit partout. + +--- + +## Faire tourner une entreprise d'agents + +
+ +Entreprise d'agents Fusion : importer une équipe, la faire tourner de façon autonome pendant des semaines + +
+ +Importez une équipe. Faites-la tourner de façon autonome pendant des semaines. **Plus de 440 agents répartis dans 16 entreprises**, câblés pour les missions, les boîtes aux lettres et la délégation inter-agents. + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +--- + +## Compatible avec les outils que vous utilisez déjà. + +Fusion s'intègre avec les outils que vous aimez. **Hermes**, **Paperclip** et **OpenClaw** sont tous livrés comme plugins de première classe — routez n'importe quel espace de travail vers le runtime qui convient à la tâche. Et n'importe quelle entreprise d'agents Paperclip s'importe en une seule commande. + +
+ Hermes +
+ +### [Hermes](https://hermes-agent.nousresearch.com) `experimental` + +Nous Research + +L'agent autonome open source de **Nous Research**. Installez le plugin Hermes et exécutez des agents via Hermes pour les travaux de longue durée à contexte croissant — routez n'importe quel espace de travail Fusion vers lui. + +### OpenClaw `experimental` + +La prise en charge du runtime OpenClaw est disponible sous forme de plugin expérimental (`fusion-plugin-openclaw-runtime`) pour la parité de découverte/configuration du runtime. Configurez les agents avec `runtimeConfig.runtimeHint: "openclaw"` après installation du plugin. + +
+ +
+ Paperclip +
+ +### [Paperclip](https://paperclip.ing) `experimental` + +paperclip.ing + +Le plan de contrôle humain pour le travail IA. Installez le plugin Paperclip pour exécuter des agents via Paperclip dans Fusion. + +Fusion prend également en charge nativement le standard d'entreprises d'agents **[`companies.sh`](https://github.com/paperclipai/companies)** : importez une équipe prédéfinie — **plus de 440 agents répartis dans 16 entreprises** — et laissez-les se coordonner via la boîte aux lettres, les missions et les portes de workflow de Fusion pendant des semaines de travail autonome. Même format d'entreprise, mêmes agents, mêmes compétences que Paperclip. + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +
+ +> **Hermes**, **Paperclip** et **OpenClaw** sont des plugins de runtime **expérimentaux** — les API et les formats de communication peuvent évoluer entre les versions mineures. + +--- + +## 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 | +|---|---| +| [Premiers pas](./docs/getting-started.md) | Installation et intégration | +| [Guide du tableau de bord](./docs/dashboard-guide.md) | Vues tableau/liste, terminal, gestionnaire git | +| [Gestion des tâches](./docs/task-management.md) | Cycle de vie des tâches et commandes CLI | +| [Référence CLI](./docs/cli-reference.md) | Référence complète des commandes et du démon | +| [Référence des paramètres](./docs/settings-reference.md) | Options de configuration | +| [Architecture](./docs/architecture.md) | Internals du système | +| [Agents](./docs/agents.md) | Gestion des agents, instanciation, heartbeat | +| [Étapes de workflow](./docs/workflow-steps.md) | Portes de qualité, modèles, phases | +| [Missions](./docs/missions.md) | Hiérarchie de missions, planification, pilotage automatique | +| [Multi-projet](./docs/multi-project.md) | Registre central, modes d'isolation | +| [Docker](./docs/docker.md) | Déploiement en conteneur | + +--- + +## Fonctionnalités principales + +- **Planification IA** — L'agent de planification génère un `PROMPT.md` détaillé avec étapes, périmètre des fichiers et critères d'acceptation +- **Exécution pas à pas** — Cycle Plan → Révision → Exécution → Révision pour chaque étape de tâche +- **Isolation par worktree git** — Chaque tâche s'exécute dans son propre worktree (branche `fusion/{task-id}`) +- **Étapes de workflow** — Portes de qualité configurables (pré-fusion : bloque la fusion ; post-fusion : informatif) +- **Intégration GitHub** — Import de tickets, création de PR, badges PR/ticket en temps réel +- **Tableau de bord** — Tableau kanban en temps réel, gestion des agents, terminal, gestionnaire git, planificateur de missions +- **Missions** — Planification hiérarchique (Mission → Jalon → Tranche → Fonctionnalité → Tâche) avec pilotage automatique, contrats de validation, nouvelles tentatives sur correctifs/fonctionnalités et sémantique de transfert en cas de blocage +- **Multi-projet** — Gérez plusieurs projets depuis une installation unique avec isolation des projets +- **Messagerie inter-agents** — Messagerie intégrée pour la coordination entre agents et utilisateurs +- **Salles de discussion (Expérimental)** — Discussion de groupe à portée de projet où les membres mentionnés sont routés comme répondants directs et des membres ambiants supplémentaires peuvent répondre jusqu'à un certain plafond (activer via **Paramètres → Fonctionnalités expérimentales → Salles de discussion** ; détails dans [Guide du tableau de bord → Salles de discussion](./docs/dashboard-guide.md#chat-rooms)) + +### Authentification des fournisseurs + +Fusion prend en charge l'authentification OAuth pour les fournisseurs IA configurée via **Paramètres → Authentification**. Pour la plupart des fournisseurs OAuth, lorsque le tableau de bord est accédé via un hôte non-localhost (nœud distant, hôte/IP LAN ou proxy inverse), les URL de connexion du fournisseur sont réécrites pour router les callbacks OAuth via un endpoint bridge (`/api/auth/oauth-callback`) afin que les redirections atteignent la session navigateur active. + +- **Anthropic (Claude)** — Utilise un flux de code d'autorisation collé dans Paramètres/l'assistant : connectez-vous, puis collez l'URL de redirection finale (ou le code) dans Fusion pour terminer la connexion +- **OpenAI Codex** — Utilise le même flux de code d'autorisation collé avec validation d'état sécurisée +- **Factory AI — via Droid CLI** *(optionnel)* — nécessite une installation locale de Droid CLI + `droid auth login` ; la détection suit le chemin du binaire runtime effectif (par défaut `droid`, ou `droidBinaryPath` du plugin si configuré), puis activez dans **Paramètres → Authentification** et redémarrez Fusion +- **llama.cpp — via serveur HTTP** *(optionnel)* — configurez l'URL de votre serveur llama.cpp (par défaut `http://127.0.0.1:8080`) et la clé API optionnelle, puis activez dans **Paramètres → Authentification** +- **Autres fournisseurs** — Authentifiez via la saisie de clé API dans Paramètres (y compris clé API Google/Gemini, Google Generative AI, Vertex et alias Cloud Code) + +### Système de modèles + +Fusion utilise une hiérarchie de modèles à double portée avec cinq voies indépendantes. Les paramètres globaux définissent les valeurs par défaut de base ; les paramètres de projet fournissent des remplacements par projet. + +| Voie | Objectif | Clés globales de base | Clés de remplacement par projet | +|------|---------|---------------------|----------------------| +| Exécuteur | Agent d'exécution des tâches | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` | +| Planification | Agent de planification des tâches | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` | +| Validateur | Réviseur de plan/code | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` | +| Résumé de titre | Génération automatique de titre | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` | +| Raffinement des étapes de workflow | Raffinement de prompt IA | (utilise `defaultProvider`/`defaultModelId`) | (utilise `modelProvider`/`modelId` sur WorkflowStep) | + +**Remplacements par tâche :** Les tâches peuvent remplacer les voies exécuteur, validateur et planification avec des champs de modèle par tâche (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`). + +**Précédence :** Par tâche → Remplacement projet → Voie globale → `defaultProvider`/`defaultModelId` → Résolution automatique. + +Pour la documentation complète des paramètres, voir la [Référence des paramètres](./docs/settings-reference.md). + +### Tâches planifiées / automatisations + +Fusion prend en charge l'automatisation de tâches planifiées via les endpoints `/api/automations`. Les automatisations peuvent exécuter des commandes shell ou des workflows multi-étapes selon un calendrier configurable. + +#### Portée de la planification + +Les automatisations et les routines peuvent s'exécuter dans deux portées : + +- **Globale** — S'exécute sur tous les projets. À utiliser pour la maintenance inter-projets, les sauvegardes ou les rapports unifiés. +- **Projet** — S'exécute uniquement dans un projet spécifique. À utiliser pour la CI, les tests ou les déploiements spécifiques au projet. + +Lorsque vous créez une planification sans choisir de portée, Fusion utilise par défaut la **portée projet** avec l'ID de projet `default` pour la compatibilité ascendante. + +Pour cibler explicitement une portée : +- Dans le modal **Tâches planifiées** du tableau de bord, utilisez le bouton **Global / Projet**. +- Via l'API, passez `?scope=global` ou `?scope=project&projectId=` sur les endpoints d'automatisation/routine. + +**Règles de résolution de portée :** +- `scope=global` se résout toujours vers la voie d'automatisation/routine globale, indépendamment du projet actif. +- `scope=project` nécessite un `projectId`. S'il est omis, il bascule sur `"default"`. +- Les opérations CRUD, exécution, bascule et webhook sont strictement isolées par portée : une planification globale ne peut pas être modifiée depuis une requête à portée projet, et vice versa. + +**Conseils opérationnels pour les configurations multi-projets :** +- Préférez les planifications **globales** pour l'infrastructure partagée (ex. : sauvegardes nocturnes, extraction de résumés mémorisés). +- Préférez les planifications **projet** pour l'automatisation par dépôt (ex. : lanceurs de tests par projet, hooks de déploiement). +- Les voies globale et projet sont interrogées indépendamment par le moteur, donc les exécutions dues dans une voie ne bloquent pas l'autre. + +#### Automatisations + +| Endpoint | Méthode | Description | +|---------|--------|-------------| +| `/api/automations` | GET | Lister toutes les automatisations (filtrées par portée si spécifiée) | +| `/api/automations` | POST | Créer une automatisation (portée par défaut : `project`) | +| `/api/automations/:id` | GET | Obtenir une automatisation par ID | +| `/api/automations/:id` | PATCH | Mettre à jour une automatisation | +| `/api/automations/:id` | DELETE | Supprimer une automatisation | +| `/api/automations/:id/run` | POST | Déclencher une exécution manuelle | +| `/api/automations/:id/toggle` | POST | Activer/désactiver | +| `/api/automations/:id/steps/reorder` | POST | Réordonner les étapes d'automatisation | + +#### Routines + +Les routines sont des tâches d'agents IA déclenchées par des planifications cron, des webhooks ou une exécution manuelle. Les routines partagent le même modèle de portée global/projet que les automatisations. + +| Endpoint | Méthode | Description | +|---------|--------|-------------| +| `/api/routines` | GET | Lister toutes les routines (filtrées par portée si spécifiée) | +| `/api/routines` | POST | Créer une routine (portée par défaut : `project`) | +| `/api/routines/:id` | GET | Obtenir une routine par ID | +| `/api/routines/:id` | PATCH | Mettre à jour une routine | +| `/api/routines/:id` | DELETE | Supprimer une routine | +| `/api/routines/:id/run` | POST | Déclenchement manuel | +| `/api/routines/:id/trigger` | POST | Déclenchement manuel canonique | +| `/api/routines/:id/runs` | GET | Obtenir l'historique d'exécution | +| `/api/routines/:id/webhook` | POST | Déclenchement par webhook (vérification de signature prise en charge) | + +--- + +## Exemples CLI rapides + +```bash +fn task create "Fix the login bug" # Entrée rapide → planification +fn task plan "Build auth system" # Planification guidée par IA +fn task import owner/repo --labels bug # Importer des tickets GitHub +fn task show FN-001 # Voir les détails d'une tâche +fn task logs FN-001 --follow # Suivre les journaux d'exécution +fn task steer FN-001 "Use TypeScript" # Guider l'agent en cours d'exécution + +fn project add my-app /path/to/app # Enregistrer un projet +fn project list # Lister tous les projets + +fn settings set maxConcurrent 4 # Configurer les paramètres +fn settings export # Exporter la configuration + +fn mission create "Auth System" "Build auth" # Créer une mission +fn mission activate-slice # Activer une tranche + +fn skills search react # Rechercher dans skills.sh +fn skills install firebase/agent-skills # Installer des compétences d'agent +``` + +--- + +## Paquets + +| Paquet | Description | +|---------|-------------| +| `@fusion/core` | Modèle de domaine — tâches, colonnes du tableau, store SQLite | +| `@fusion/dashboard` | Interface web — serveur Express + tableau kanban avec SSE | +| `@fusion/engine` | Moteur IA — planification, exécution, ordonnancement, étapes de workflow | +| `@runfusion/fusion` | CLI + extension — publié sur npm | + +--- + +## Développement + +```bash +pnpm install # Installer les dépendances +pnpm local # Démarrer le tableau de bord/API local sur un port différent de 4040 +pnpm local -- --engine # Démarrer le tableau de bord local avec le moteur IA +pnpm build # Construire les paquets du workspace par défaut (exclut bureau/mobile) +pnpm build:all # Construire tous les paquets (y compris bureau/mobile) +pnpm dev dashboard # Exécuter le tableau de bord + le moteur IA +pnpm dev:ui # Tableau de bord seul (sans moteur IA) +pnpm lint # Linter tous les paquets +pnpm typecheck # Vérifier les types de tous les paquets +pnpm test # Exécuter tous les tests +``` + +### Construire un exécutable autonome + +Construisez un binaire `fn` autonome et auto-contenu avec [Bun](https://bun.sh/) : + +```bash +pnpm build:exe # Construire pour la plateforme actuelle +pnpm build:exe:all # Compilation croisée pour toutes les plateformes +``` + +--- + +## Licence + +MIT — open source, sans enfermement propriétaire. Voir [LICENSE](./LICENSE). + +
+ +**[runfusion.ai →](https://runfusion.ai)** + +
diff --git a/README.ko.md b/README.ko.md new file mode 100644 index 0000000000..beead4c0bc --- /dev/null +++ b/README.ko.md @@ -0,0 +1,468 @@ +
+ +Fusion + +# 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) + +[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · [Español](./README.es.md) · **한국어** + +*이 문서는 기계 번역본입니다. 공식 원본은 [영문 README](./README.md)를 참조하세요.* + +[![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) +[![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) +[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) +![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) +![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg) + +
+ +Fusion 릴: 거친 아이디어에서 프로덕션 코드까지 + +
+
+ + + Fusion 대시보드: Planning, Todo, In Progress, In Review, Done 칸반 컬럼과 활성 태스크 카드 + + +
+ +--- + +## 전체 개발 환경을 하나의 화면에서. + +평문으로 태스크를 설명하면, 계획 에이전트가 프로젝트를 읽고 컨텍스트를 파악한 뒤 단계, 파일 범위, 완료 기준이 담긴 `PROMPT.md` 계획서를 작성합니다. 이후 Fusion은 격리된 git 워크트리에서 계획, 검토, 실행, 재검토를 순서대로 수행하며, 원하는 곳마다 사람의 승인 단계를 추가할 수 있습니다. + +보드 하나로. 어디서든 제어. 노트북, Mac mini, Linux 서버, 클라우드 VM, 휴대폰 — 모두 연결됩니다. + +> Trello와 유사하지만, 태스크의 명세 작성, 실행, 납품을 AI가 수행합니다. [dustinbyrne/kb](https://github.com/dustinbyrne/kb)의 훌륭한 작업을 기반으로 구축되었습니다. + +--- + +## 흐름 + +``` + ① 설명 ② 계획 ③ 보드 ④ 격리된 워크트리 + ───────────── ───────────── ───────────── ───────────────────── + "설정 패널에 → 에이전트가 → 계획 → 검토 → → fusion/FN-123 브랜치 + 다크 모드 토글 PROMPT.md 작성 실행 → 검토 동시 실행, + 추가" (단계, 범위, (각 단계마다, 파일 충돌 없음 + 완료 기준) 완료까지) +``` + +### 머지 전에 모든 단계를 확인하세요 + +
+ Fusion 태스크 상세: 진행 중인 태스크의 워크플로우 단계, 차이점, 파일 변경 내역이 실시간으로 표시 +
+ +모든 태스크는 계획, 검토, 차이점, 파일 변경 내역을 실시간으로 보여줍니다. 진행 중인 태스크에 들어가 방향을 조정하거나, 제약을 강화하거나, 일시 정지하거나, 재프롬프트할 수 있습니다. + +--- + +## 차별점 + +| | | +|---|---| +| 🧠 **AI 계획** | 평문으로 태스크를 설명하면, 계획 에이전트가 단계, 파일 범위, 완료 기준이 포함된 `PROMPT.md` 계획서로 변환합니다. | +| 🔁 **워크플로우 게이트** | 모든 단계마다 계획 → 검토 → 실행 → 검토 주기를 거칩니다. 사전 머지 게이트는 불량 코드를 차단하고, 사후 머지 게이트는 정보성 검사를 실행합니다. | +| 🌳 **워크트리 격리** | 각 태스크는 자체 브랜치와 워크트리(`fusion/{task-id}`)에서 실행됩니다. 병렬 태스크. 충돌 없음. [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings)를 통한 선택적 [worktrunk](https://github.com/max-sixty/worktrunk) 위임 지원([WorktreeBackend 추상화](./docs/architecture.md#worktreebackend-abstraction) 참조). | +| ⚡ **스마트 머지** | 모든 게이트 통과 시 Fusion이 스쿼시 머지하고 다음으로 넘어갑니다. 어디서든 수동 승인을 선택할 수 있습니다. | +| 🛰️ **멀티 노드 메시** | 노트북, Mac mini, Linux 서버, 클라우드 VM, 휴대폰 — 모두 동기화됩니다. 데스크톱, 모바일, 웹. | +| 🧩 **모든 모델** | Anthropic, OpenAI, Ollama 등 다양한 모델을 지원합니다. 로컬과 클라우드가 공존합니다. | +| 🏢 **에이전트 컴퍼니** | 사전 구축된 팀 — 16개 컴퍼니에 걸쳐 440개 이상의 에이전트 — 을 임포트하여 몇 주 동안 자율적으로 실행합니다. | +| 📬 **에이전트 간 메시징** | 에이전트 간 내장 메일박스. 위임, 확인, 조율이 가능합니다. | +| 🗨️ **멀티 에이전트 채팅 룸** | 여러 룸 구성원이 답할 수 있는 프로젝트 범위 그룹 대화: 언급된 구성원은 직접 응답자로, 추가 주변 구성원은 최대 한도까지 응답할 수 있습니다. 현재 **실험적** — **설정 → 실험적 기능 → 채팅 룸**에서 `chatRooms`를 활성화하세요. ([채팅 룸 문서](./docs/dashboard-guide.md#chat-rooms)) | +| 🗺️ **미션** | 계층적 계획(미션 → 마일스톤 → 슬라이스 → 기능 → 태스크), 자동 조종, 검증 계약 포함. | +| 🔬 **리서치** | 웹 검색, GitHub, 로컬 문서, LLM 합성을 활용한 경계 있는 리서치 실행(계획 및 합성 흐름에서 런타임 내장 WebSearch/WebFetch 지원 포함). 결과를 태스크로 전환합니다. ([문서](./docs/research.md)) | +| 🧪 **자기 개선** | 에이전트가 자신의 출력물을 돌아보고 코드베이스를 학습하면서 프롬프트를 업데이트합니다. | +| 🔓 **오픈 소스. MIT.** | 벤더 종속 없음. 자체 하드웨어에서 실행. 매주 배포. | + +--- + +## 작동 방식 + +```mermaid +graph TD + H((사용자)) -->|거친 아이디어| T["계획 중
자동 계획"] + T --> TD["할 일
실행 예약됨"] + TD --> IP["진행 중
각 단계마다:
계획, 검토, 실행, 검토"] + + subgraph IP["진행 중"] + direction TD + NS([단계 시작]) --> P[계획] + P --> R1{검토} + R1 -->|수정| P + R1 -->|승인| E[실행] + E --> R2{검토} + R2 -->|수정| E + R2 -->|다음 단계| NS + R2 -->|재검토| P + end + + R2 -->|완료| IR["검토 중
머지 준비,
또는 자동 완료"] + IR -->|직접 스쿼시 머지
또는 PR 머지| D["완료"] + + 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 +``` + +의존성이 있는 태스크는 순차적으로 처리됩니다. 독립적인 태스크는 병렬로 실행됩니다. 태스크가 계획 단계에서 할 일로 이동하기 전에 수동 승인을 요구하도록 설정할 수 있습니다(`requirePlanApproval` 설정). + +--- + +## 멀티 노드. 하나의 보드. 모든 플랫폼. + +
+ +Fusion 메시: 노트북, Mac mini, Linux 서버, 클라우드 VM, 휴대폰 — 모두 동기화 + +
+ +![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) +![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) +![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) +![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white) + +
+ +노트북, Mac mini, Linux 서버, 클라우드 VM, 휴대폰 — 모든 노드가 동등한 피어입니다. 태스크 상태, 에이전트, 로그, 차이점이 메시 전반에 걸쳐 동기화된 상태로 유지됩니다. 동일한 Fusion이 다음과 같이 제공됩니다: + +- 🖥️ **데스크톱 앱** — **macOS**(Intel + Apple Silicon), **Windows** 10/11, **Linux**용 Electron +- 📱 **모바일 앱** — **iOS/iPadOS** 및 **Android**용 Capacitor ([MOBILE.md](./MOBILE.md)) +- 🌐 **웹 대시보드** — `fn dashboard` 데몬에서 제공되는 모든 최신 브라우저 +- 🔌 **CLI** — 터미널 중심 워크플로우를 위한 `fn` 바이너리 + 확장 + +임의의 노드에서 데몬을 시작하고 다른 기기를 연결하면, 보드가 어디서든 따라다닙니다. + +--- + +## 에이전트 컴퍼니 운영 + +
+ +Fusion 에이전트 컴퍼니: 팀을 임포트하여 몇 주 동안 자율적으로 운영 + +
+ +팀을 임포트하세요. 몇 주 동안 자율적으로 운영하세요. 미션, 메일박스, 에이전트 간 위임을 위해 연결된 **16개 컴퍼니에 걸쳐 440개 이상의 에이전트**. + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +--- + +## 이미 사용 중인 도구와 호환됩니다. + +Fusion은 여러분이 좋아하는 도구와 통합됩니다. **Hermes**, **Paperclip**, **OpenClaw**는 모두 일급 플러그인으로 제공되어 — 작업에 맞는 런타임으로 워크스페이스를 라우팅할 수 있습니다. 그리고 모든 Paperclip 에이전트 컴퍼니는 단일 명령으로 임포트됩니다. + +
+ Hermes +
+ +### [Hermes](https://hermes-agent.nousresearch.com) `experimental` + +Nous Research + +**Nous Research**의 오픈 소스 자율 에이전트. Hermes 플러그인을 설치하고 장시간 실행되는 컨텍스트가 증가하는 작업에 Hermes를 통해 에이전트를 실행하세요 — 임의의 Fusion 워크스페이스를 라우팅할 수 있습니다. + +### OpenClaw `experimental` + +OpenClaw 런타임 지원은 런타임 탐색/설정 동등성을 위한 실험적 플러그인(`fusion-plugin-openclaw-runtime`)으로 제공됩니다. 플러그인을 설치한 후 `runtimeConfig.runtimeHint: "openclaw"`로 에이전트를 설정하세요. + +
+ +
+ Paperclip +
+ +### [Paperclip](https://paperclip.ing) `experimental` + +paperclip.ing + +AI 노동을 위한 사람 제어 플레인. Paperclip 플러그인을 설치하여 Fusion 내에서 Paperclip을 통해 에이전트를 실행하세요. + +Fusion은 **[`companies.sh`](https://github.com/paperclipai/companies)** 에이전트 컴퍼니 표준을 네이티브로 지원합니다: 사전 구축된 팀 — **16개 컴퍼니에 걸쳐 440개 이상의 에이전트** — 을 임포트하고, 수 주 동안의 자율 작업을 위해 Fusion의 메일박스, 미션, 워크플로우 게이트를 통해 조율하게 하세요. Paperclip과 동일한 컴퍼니 형식, 동일한 에이전트, 동일한 스킬. + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +
+ +> **Hermes**, **Paperclip**, **OpenClaw**는 **실험적** 런타임 플러그인입니다 — API와 와이어 형식은 마이너 릴리스 사이에 변경될 수 있습니다. + +--- + +## 빠른 시작 + +**설치 없이 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)를 참조하세요. + +--- + +## 문서 + +| 가이드 | 내용 | +|---|---| +| [시작하기](./docs/getting-started.md) | 설치 및 온보딩 | +| [대시보드 가이드](./docs/dashboard-guide.md) | 보드/목록 뷰, 터미널, git 관리자 | +| [태스크 관리](./docs/task-management.md) | 태스크 수명 주기 및 CLI 명령 | +| [CLI 참조](./docs/cli-reference.md) | 전체 명령 및 데몬 참조 | +| [설정 참조](./docs/settings-reference.md) | 구성 옵션 | +| [아키텍처](./docs/architecture.md) | 시스템 내부 구조 | +| [에이전트](./docs/agents.md) | 에이전트 관리, 스폰, 하트비트 | +| [워크플로우 단계](./docs/workflow-steps.md) | 품질 게이트, 템플릿, 단계 | +| [미션](./docs/missions.md) | 미션 계층 구조, 계획, 자동 조종 | +| [멀티 프로젝트](./docs/multi-project.md) | 중앙 레지스트리, 격리 모드 | +| [Docker](./docs/docker.md) | 컨테이너 배포 | + +--- + +## 핵심 기능 + +- **AI 계획** — 계획 에이전트가 단계, 파일 범위, 완료 기준이 담긴 상세한 `PROMPT.md`를 생성합니다 +- **단계별 실행** — 각 태스크 단계마다 계획 → 검토 → 실행 → 검토 주기를 진행합니다 +- **Git 워크트리 격리** — 각 태스크는 자체 워크트리(`fusion/{task-id}` 브랜치)에서 실행됩니다 +- **워크플로우 단계** — 구성 가능한 품질 게이트(사전 머지: 머지 차단; 사후 머지: 정보 제공) +- **GitHub 연동** — 이슈 임포트, PR 생성, 실시간 PR/이슈 배지 +- **대시보드** — 실시간 칸반 보드, 에이전트 관리, 터미널, git 관리자, 미션 플래너 +- **미션** — 계층적 계획(미션 → 마일스톤 → 슬라이스 → 기능 → 태스크), 자동 조종, 검증 계약, 수정-기능 재시도, 차단 핸드오프 시맨틱 포함 +- **멀티 프로젝트** — 단일 설치에서 여러 프로젝트를 프로젝트 격리로 관리 +- **에이전트 간 메시징** — 에이전트와 사용자 간 조율을 위한 내장 메시징 +- **채팅 룸 (실험적)** — 언급된 구성원이 직접 응답자로 라우팅되고 추가 주변 구성원이 최대 한도까지 답할 수 있는 프로젝트 범위 그룹 채팅(**설정 → 실험적 기능 → 채팅 룸**에서 활성화; [대시보드 가이드 → 채팅 룸](./docs/dashboard-guide.md#chat-rooms)에서 자세히 확인) + +### 공급자 인증 + +Fusion은 **설정 → 인증**을 통해 구성된 AI 공급자의 OAuth 기반 인증을 지원합니다. 대부분의 OAuth 공급자의 경우, 대시보드가 비 localhost 호스트(원격 노드, LAN 호스트/IP, 또는 리버스 프록시)를 통해 접근될 때, 공급자 로그인 URL이 OAuth 콜백을 브리지 엔드포인트(`/api/auth/oauth-callback`)를 통해 라우팅하도록 재작성되어 리다이렉트가 활성 브라우저 세션에 도달합니다. + +- **Anthropic (Claude)** — 설정/온보딩에서 붙여넣기 인가 코드 흐름을 사용합니다: 로그인한 후 최종 리다이렉트 URL(또는 코드)을 Fusion에 붙여넣어 로그인을 완료합니다 +- **OpenAI Codex** — 안전한 상태 검증이 포함된 동일한 붙여넣기 인가 코드 흐름을 사용합니다 +- **Factory AI — Droid CLI 경유** *(선택 사항)* — 로컬 Droid CLI 설치 + `droid auth login` 필요; 탐지는 유효한 런타임 바이너리 경로를 따릅니다(기본값 `droid`, 또는 플러그인 설정 시 `droidBinaryPath`), 이후 **설정 → 인증**에서 활성화하고 Fusion을 재시작하세요 +- **llama.cpp — HTTP 서버 경유** *(선택 사항)* — llama.cpp 서버 URL(기본값 `http://127.0.0.1:8080`)과 선택적 API 키를 설정한 후 **설정 → 인증**에서 활성화하세요 +- **기타 공급자** — 설정에서 API 키 입력으로 인증합니다(Google/Gemini API 키, Google Generative AI, Vertex, Cloud Code 별칭 포함) + +### 모델 시스템 + +Fusion은 다섯 개의 독립적인 레인을 가진 이중 범위 모델 계층 구조를 사용합니다. 전역 설정은 기준 기본값을 정의하고, 프로젝트 설정은 프로젝트별 재정의를 제공합니다. + +| 레인 | 목적 | 전역 기준 키 | 프로젝트 재정의 키 | +|------|---------|---------------------|----------------------| +| Executor | 태스크 실행 에이전트 | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` | +| Planning | 태스크 계획 에이전트 | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` | +| Validator | 계획/코드 검토자 | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` | +| Title Summarization | 자동 제목 생성 | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` | +| Workflow Step Refinement | AI 프롬프트 개선 | (`defaultProvider`/`defaultModelId` 사용) | (WorkflowStep의 `modelProvider`/`modelId` 사용) | + +**태스크별 재정의:** 태스크는 태스크별 모델 필드(`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`)로 executor, validator, planning 레인을 재정의할 수 있습니다. + +**우선순위:** 태스크별 → 프로젝트 재정의 → 전역 레인 → `defaultProvider`/`defaultModelId` → 자동 해결. + +전체 설정 문서는 [설정 참조](./docs/settings-reference.md)를 참조하세요. + +### 예약된 태스크 / 자동화 + +Fusion은 `/api/automations` 엔드포인트를 통해 예약된 태스크 자동화를 지원합니다. 자동화는 구성 가능한 일정에 따라 셸 명령 또는 다단계 워크플로우를 실행할 수 있습니다. + +#### 스케줄링 범위 + +자동화와 루틴은 두 가지 범위에서 실행될 수 있습니다: + +- **전역** — 모든 프로젝트에 걸쳐 실행됩니다. 프로젝트 간 유지 관리, 백업, 또는 통합 보고에 사용하세요. +- **프로젝트** — 특정 프로젝트 내에서만 실행됩니다. 프로젝트별 CI, 테스트, 또는 배포 태스크에 사용하세요. + +범위를 선택하지 않고 일정을 생성하면, Fusion은 하위 호환성을 위해 `default` 프로젝트 ID로 **프로젝트 범위**를 기본값으로 사용합니다. + +범위를 명시적으로 지정하려면: +- 대시보드 **예약된 태스크** 모달에서 **전역 / 프로젝트** 토글을 사용하세요. +- API를 통해서는 자동화/루틴 엔드포인트에 `?scope=global` 또는 `?scope=project&projectId=`를 전달하세요. + +**범위 해결 규칙:** +- `scope=global`은 항상 활성 프로젝트와 독립적으로 전역 자동화/루틴 레인으로 해결됩니다. +- `scope=project`는 `projectId`를 필요로 합니다. 생략하면 `"default"`로 대체됩니다. +- CRUD, 실행, 토글, 웹훅 작업은 엄격하게 범위 격리됩니다: 전역 일정은 프로젝트 범위 요청에서 변경될 수 없고, 그 반대도 마찬가지입니다. + +**멀티 프로젝트 설정을 위한 운영 지침:** +- 공유 인프라(예: 야간 백업, 메모리 인사이트 추출)에는 **전역** 일정을 선호하세요. +- 저장소별 자동화(예: 프로젝트별 테스트 실행기, 배포 훅)에는 **프로젝트** 일정을 선호하세요. +- 전역 및 프로젝트 레인은 엔진에 의해 독립적으로 폴링되므로, 한 레인의 예정된 실행이 다른 레인을 차단하지 않습니다. + +#### 자동화 + +| 엔드포인트 | 메서드 | 설명 | +|---------|--------|-------------| +| `/api/automations` | GET | 모든 자동화 목록 조회 (범위가 지정된 경우 필터링됨) | +| `/api/automations` | POST | 자동화 생성 (범위 기본값: `project`) | +| `/api/automations/:id` | GET | ID로 자동화 조회 | +| `/api/automations/:id` | PATCH | 자동화 업데이트 | +| `/api/automations/:id` | DELETE | 자동화 삭제 | +| `/api/automations/:id/run` | POST | 수동 실행 트리거 | +| `/api/automations/:id/toggle` | POST | 활성화/비활성화 토글 | +| `/api/automations/:id/steps/reorder` | POST | 자동화 단계 순서 변경 | + +#### 루틴 + +루틴은 크론 일정, 웹훅, 또는 수동 실행으로 트리거되는 AI 에이전트 태스크입니다. 루틴은 자동화와 동일한 전역/프로젝트 범위 모델을 공유합니다. + +| 엔드포인트 | 메서드 | 설명 | +|---------|--------|-------------| +| `/api/routines` | GET | 모든 루틴 목록 조회 (범위가 지정된 경우 필터링됨) | +| `/api/routines` | POST | 루틴 생성 (범위 기본값: `project`) | +| `/api/routines/:id` | GET | ID로 루틴 조회 | +| `/api/routines/:id` | PATCH | 루틴 업데이트 | +| `/api/routines/:id` | DELETE | 루틴 삭제 | +| `/api/routines/:id/run` | POST | 수동 트리거 | +| `/api/routines/:id/trigger` | POST | 정식 수동 트리거 | +| `/api/routines/:id/runs` | GET | 실행 기록 조회 | +| `/api/routines/:id/webhook` | POST | 웹훅 트리거 (서명 검증 지원) | + +--- + +## CLI 빠른 예제 + +```bash +fn task create "Fix the login bug" # 빠른 입력 → 계획 단계 +fn task plan "Build auth system" # AI 안내 계획 수립 +fn task import owner/repo --labels bug # GitHub 이슈 임포트 +fn task show FN-001 # 태스크 세부 정보 보기 +fn task logs FN-001 --follow # 실행 로그 스트리밍 +fn task steer FN-001 "Use TypeScript" # 실행 중 에이전트 방향 안내 + +fn project add my-app /path/to/app # 프로젝트 등록 +fn project list # 모든 프로젝트 목록 + +fn settings set maxConcurrent 4 # 설정 구성 +fn settings export # 설정 내보내기 + +fn mission create "Auth System" "Build auth" # 미션 생성 +fn mission activate-slice # 슬라이스 활성화 + +fn skills search react # skills.sh 검색 +fn skills install firebase/agent-skills # 에이전트 스킬 설치 +``` + +--- + +## 패키지 + +| 패키지 | 설명 | +|---------|-------------| +| `@fusion/core` | 도메인 모델 — 태스크, 보드 컬럼, SQLite 저장소 | +| `@fusion/dashboard` | 웹 UI — Express 서버 + SSE가 포함된 칸반 보드 | +| `@fusion/engine` | AI 엔진 — 계획, 실행, 스케줄링, 워크플로우 단계 | +| `@runfusion/fusion` | CLI + 확장 — npm에 게시됨 | + +--- + +## 개발 + +```bash +pnpm install # 의존성 설치 +pnpm local # 비 4040 포트에서 로컬 대시보드/API 시작 +pnpm local -- --engine # AI 엔진과 함께 로컬 대시보드 시작 +pnpm build # 기본 워크스페이스 패키지 빌드 (데스크톱/모바일 제외) +pnpm build:all # 모든 패키지 빌드 (데스크톱/모바일 포함) +pnpm dev dashboard # 대시보드 + AI 엔진 실행 +pnpm dev:ui # 대시보드만 실행 (AI 엔진 없음) +pnpm lint # 모든 패키지 린트 +pnpm typecheck # 모든 패키지 타입 검사 +pnpm test # 모든 테스트 실행 +``` + +### 독립 실행 파일 빌드 + +[Bun](https://bun.sh/)을 사용하여 단일 자급자족 `fn` 바이너리를 빌드합니다: + +```bash +pnpm build:exe # 현재 플랫폼용 빌드 +pnpm build:exe:all # 모든 플랫폼용 크로스 컴파일 +``` + +--- + +## 라이선스 + +MIT — 오픈 소스, 벤더 종속 없음. [LICENSE](./LICENSE) 참조. + +
+ +**[runfusion.ai →](https://runfusion.ai)** + +
diff --git a/README.md b/README.md index df726dfdfe..54ef74879d 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,8 @@ [**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.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · [Español](./README.es.md) · [한국어](./README.ko.md) + [![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) [![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) [![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000000..0f95341ee1 --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,466 @@ +
+ +Fusion + +# 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) + +[English](./README.md) · **简体中文** · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · [Español](./README.es.md) · [한국어](./README.ko.md) + +*本文档为社区机器翻译版本，英文 README 为权威原版。* + +[![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) +[![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) +[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) +![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) +![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg) + +
+ +Fusion 演示：从粗糙想法到生产代码 + +
+
+ + + Fusion 仪表板：包含待规划、待办、进行中、审核中、已完成看板列及活跃任务卡片 + + +
+ +--- + +## 你的整个开发环境。尽在一块面板之上。 + +用自然语言描述一个任务。规划智能体会读取你的项目、理解上下文，并撰写完整的 `PROMPT.md` 计划——包括步骤、文件范围和验收标准。随后 Fusion 在隔离的 Git 工作树中完成规划、审核、执行与再审核，你可以在任意环节设置人工审批门控。 + +一块看板。随处操控。笔记本、Mac mini、Linux 服务器、云虚拟机、手机——全部互联。 + +> 就像 Trello，只不过你的任务由 AI 来定义、执行和交付。基于 [dustinbyrne/kb](https://github.com/dustinbyrne/kb) 的出色工作构建。 + +--- + +## 工作流程 + +``` + ① 描述 ② 规划 ③ 看板 ④ 隔离工作树 + ───────────── ───────────── ───────────── ───────────────────── + "在设置面板 → 智能体撰写 → 规划 → 审核 → → fusion/FN-123 分支 + 添加深色模式 PROMPT.md 执行 → 审核 并行运行，零 + 切换按钮" （步骤、范围、 （逐步进行，直到 文件冲突 + 验收标准） 完成） +``` + +### 合并前看清每一步 + +
+ Fusion 任务详情：进行中的任务显示工作流步骤、差异对比和文件变更 +
+ +每个任务都会实时展示其计划、审核记录、差异对比和文件变更。你可以随时介入活跃任务，调整方向、收紧约束、暂停执行或重新提示。 + +--- + +## 与众不同之处 + +| | | +|---|---| +| 🧠 **AI 规划** | 用自然语言描述任务。规划智能体将其转化为包含步骤、文件范围和验收标准的 `PROMPT.md` 计划。 | +| 🔁 **工作流门控** | 每个步骤均经历：规划 → 审核 → 执行 → 审核。合并前门控阻止劣质代码，合并后门控执行信息性检查。 | +| 🌳 **工作树隔离** | 每个任务在独立分支和工作树（`fusion/{task-id}`）中运行，支持并行任务，零冲突。可通过 [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) 选择性启用 [worktrunk](https://github.com/max-sixty/worktrunk) 委托（参见 [WorktreeBackend 抽象](./docs/architecture.md#worktreebackend-abstraction)）。 | +| ⚡ **智能合并** | 通过所有门控后，Fusion 自动压缩合并并继续推进。你也可以在任意环节开启手动审批。 | +| 🛰️ **多节点网格** | 笔记本、Mac mini、Linux 服务器、云虚拟机、手机——全部同步。桌面端、移动端、Web 端均支持。 | +| 🧩 **任意模型** | 支持 Anthropic、OpenAI、Ollama 等，本地与云端并存。 | +| 🏢 **智能体公司** | 导入预构建团队——16 家公司共 440+ 个智能体——自主运行数周。 | +| 📬 **智能体间消息** | 内置智能体间邮箱，支持委派、澄清与协调。 | +| 🗨️ **多智能体聊天室** | 项目范围内的群组会话，多位成员可以回复：被提及成员为直接响应者，其他旁听成员在上限内也可参与回复。当前为**实验性**功能——在**设置 → 实验性功能 → 聊天室**中启用 `chatRooms`。（[聊天室文档](./docs/dashboard-guide.md#chat-rooms)） | +| 🗺️ **任务群** | 层级式规划（任务群 → 里程碑 → 切片 → 功能 → 任务），支持自动驾驶和验证契约。 | +| 🔬 **调研** | 有边界的调研运行，集成网络搜索、GitHub、本地文档和 LLM 综合分析（规划与综合流程中还支持运行时内置 WebSearch/WebFetch）。将调研发现直接转化为任务。（[文档](./docs/research.md)） | +| 🧪 **自我改进** | 智能体反思自身输出，并在熟悉你的代码库后持续更新其提示词。 | +| 🔓 **开源，MIT 协议。** | 无供应商锁定。可在自有硬件上运行。每周持续更新。 | + +--- + +## 工作原理 + +```mermaid +graph TD + H((你)) -->|粗糙想法| T["规划中
自动规划"] + T --> TD["待办
已安排执行"] + TD --> IP["进行中
每步骤：
规划、审核、执行、审核"] + + subgraph IP["进行中"] + direction TD + NS([开始步骤]) --> P[规划] + P --> R1{审核} + R1 -->|修改| P + R1 -->|批准| E[执行] + E --> R2{审核} + R2 -->|修改| E + R2 -->|下一步| NS + R2 -->|重新规划| P + end + + R2 -->|完成| IR["审核中
待合并，
或自动完成"] + IR -->|直接压缩合并
或 PR 合并| D["已完成"] + + 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 +``` + +有依赖关系的任务按顺序处理，相互独立的任务并行运行。可选择在任务从规划移至待办前要求手动审批（`requirePlanApproval` 设置）。 + +--- + +## 多节点。一块看板。全平台覆盖。 + +
+ +Fusion 网格：笔记本、Mac mini、Linux 服务器、云虚拟机、手机——全部同步 + +
+ +![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) +![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) +![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) +![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white) + +
+ +笔记本、Mac mini、Linux 服务器、云虚拟机、手机——每个节点都是对等方。你的任务状态、智能体、日志和差异对比在整个网格中保持同步。同一个 Fusion 提供以下形态： + +- 🖥️ **桌面应用** — 基于 Electron，支持 **macOS**（Intel + Apple Silicon）、**Windows** 10/11 和 **Linux** +- 📱 **移动应用** — 基于 Capacitor，支持 **iOS/iPadOS** 和 **Android**（[MOBILE.md](./MOBILE.md)） +- 🌐 **Web 仪表板** — 任意现代浏览器，由 `fn dashboard` 守护进程提供服务 +- 🔌 **CLI** — `fn` 二进制文件 + 扩展，面向终端优先的工作流 + +在任意节点启动守护进程，连接其他设备，看板随你所在。 + +--- + +## 运行一个智能体公司 + +
+ +Fusion 智能体公司：导入团队，自主运行数周 + +
+ +导入一个团队，自主运行数周。**16 家公司共 440+ 个智能体**，预置了任务群、邮箱和智能体间委派机制。 + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +--- + +## 与你已在使用的工具兼容。 + +Fusion 与你喜爱的工具深度集成。**Hermes**、**Paperclip** 和 **OpenClaw** 均作为一等公民插件发布——将任意工作区路由到最适合该任务的运行时。任何 Paperclip 智能体公司均可通过单条命令导入。 + +
+ Hermes +
+ +### [Hermes](https://hermes-agent.nousresearch.com) `experimental` + +Nous Research + +**Nous Research** 出品的开源自主智能体。安装 Hermes 插件后，可通过 Hermes 运行智能体以处理长期运行、上下文持续增长的工作——将任意 Fusion 工作区路由至其上。 + +### OpenClaw `experimental` + +OpenClaw 运行时支持以实验性插件（`fusion-plugin-openclaw-runtime`）的形式提供，用于运行时发现与配置对等。安装插件后，使用 `runtimeConfig.runtimeHint: "openclaw"` 配置智能体。 + +
+ +
+ Paperclip +
+ +### [Paperclip](https://paperclip.ing) `experimental` + +paperclip.ing + +AI 劳动力的人工控制平面。安装 Paperclip 插件后，可在 Fusion 内部通过 Paperclip 运行智能体。 + +Fusion 还原生支持 **[`companies.sh`](https://github.com/paperclipai/companies)** 智能体公司标准：导入预构建团队——**16 家公司共 440+ 个智能体**——让它们通过 Fusion 的邮箱、任务群和工作流门控协作，自主运行数周。与 Paperclip 共用相同的公司格式、相同的智能体和相同的技能。 + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +
+ +> **Hermes**、**Paperclip** 和 **OpenClaw** 均为**实验性**运行时插件——API 和通信格式可能在次要版本间发生变更。 + +--- + +## 快速上手 + +**无需安装，直接通过 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)。 + +--- + +## 文档 + +| 指南 | 内容 | +|---|---| +| [入门指南](./docs/getting-started.md) | 安装与引导 | +| [仪表板指南](./docs/dashboard-guide.md) | 看板/列表视图、终端、Git 管理器 | +| [任务管理](./docs/task-management.md) | 任务生命周期与 CLI 命令 | +| [CLI 参考](./docs/cli-reference.md) | 完整命令与守护进程参考 | +| [设置参考](./docs/settings-reference.md) | 配置选项 | +| [架构](./docs/architecture.md) | 系统内部机制 | +| [智能体](./docs/agents.md) | 智能体管理、生成与心跳 | +| [工作流步骤](./docs/workflow-steps.md) | 质量门控、模板与阶段 | +| [任务群](./docs/missions.md) | 任务群层级、规划与自动驾驶 | +| [多项目](./docs/multi-project.md) | 中央注册表与隔离模式 | +| [Docker](./docs/docker.md) | 容器部署 | + +--- + +## 核心功能 + +- **AI 规划** — 规划智能体生成包含步骤、文件范围和验收标准的详细 `PROMPT.md` +- **逐步执行** — 每个任务步骤均经历规划 → 审核 → 执行 → 审核循环 +- **Git 工作树隔离** — 每个任务在独立工作树（`fusion/{task-id}` 分支）中运行 +- **工作流步骤** — 可配置的质量门控（合并前：阻止合并；合并后：信息性检查） +- **GitHub 集成** — 导入 Issue、创建 PR、实时 PR/Issue 徽章 +- **仪表板** — 实时看板、智能体管理、终端、Git 管理器、任务群规划器 +- **任务群** — 层级式规划（任务群 → 里程碑 → 切片 → 功能 → 任务），支持自动驾驶、验证契约、修复功能重试和阻塞移交语义 +- **多项目** — 从单一安装管理多个项目，项目间相互隔离 +- **智能体间消息** — 内置消息机制，用于智能体与用户之间的协调 +- **聊天室（实验性）** — 项目范围内的群组聊天，被提及成员作为直接响应者路由，其他旁听成员在上限内可回复（通过**设置 → 实验性功能 → 聊天室**启用；详情见[仪表板指南 → 聊天室](./docs/dashboard-guide.md#chat-rooms)） + +### 提供商身份验证 + +Fusion 支持通过**设置 → 身份验证**为 AI 提供商配置基于 OAuth 的身份验证。对于大多数 OAuth 提供商，当仪表板通过非 localhost 主机访问（远程节点、局域网主机/IP 或反向代理）时，提供商登录 URL 会被重写，通过桥接端点（`/api/auth/oauth-callback`）路由 OAuth 回调，以确保重定向能到达活跃的浏览器会话。 + +- **Anthropic (Claude)** — 在设置/引导向导中使用粘贴授权码流程：登录后，将最终重定向 URL（或授权码）粘贴回 Fusion 以完成登录 +- **OpenAI Codex** — 使用相同的粘贴授权码流程，附带安全状态验证 +- **Factory AI — 通过 Droid CLI** *（可选）* — 需要本地安装 Droid CLI 并执行 `droid auth login`；检测遵循有效运行时二进制路径（默认为 `droid`，或配置了插件 `droidBinaryPath` 时使用该路径），然后在**设置 → 身份验证**中启用并重启 Fusion +- **llama.cpp — 通过 HTTP 服务器** *（可选）* — 配置你的 llama.cpp 服务器 URL（默认 `http://127.0.0.1:8080`）和可选 API 密钥，然后在**设置 → 身份验证**中启用 +- **其他提供商** — 在设置中通过 API 密钥条目进行身份验证（包括 Google/Gemini API 密钥、Google Generative AI、Vertex 和 Cloud Code 别名） + +### 模型系统 + +Fusion 使用双作用域模型层级，包含五条独立通道。全局设置定义基准默认值，项目设置提供每个项目的覆盖配置。 + +| 通道 | 用途 | 全局基准键 | 项目覆盖键 | +|------|---------|---------------------|----------------------| +| 执行器 | 任务执行智能体 | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` | +| 规划器 | 任务规划智能体 | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` | +| 验证器 | 计划/代码审核 | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` | +| 标题摘要 | 自动标题生成 | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` | +| 工作流步骤优化 | AI 提示词优化 | （使用 `defaultProvider`/`defaultModelId`） | （使用 WorkflowStep 上的 `modelProvider`/`modelId`） | + +**任务级覆盖：** 任务可通过任务级模型字段（`modelProvider`/`modelId`、`validatorModelProvider`/`validatorModelId`、`planningModelProvider`/`planningModelId`）覆盖执行器、验证器和规划器通道。 + +**优先级：** 任务级 → 项目覆盖 → 全局通道 → `defaultProvider`/`defaultModelId` → 自动解析。 + +完整设置文档，请参见[设置参考](./docs/settings-reference.md)。 + +### 计划任务 / 自动化 + +Fusion 通过 `/api/automations` 端点支持计划任务自动化。自动化任务可按可配置的计划运行 Shell 命令或多步骤工作流。 + +#### 调度范围 + +自动化任务和例程可在两种范围内运行： + +- **全局** — 跨所有项目运行。适用于跨项目维护、备份或统一报告。 +- **项目** — 仅在特定项目内运行。适用于项目特定的 CI、测试或部署任务。 + +创建计划时若未选择范围，Fusion 默认使用 **project 范围**并以 `default` 项目 ID，以保持向后兼容。 + +显式指定范围的方式： +- 在仪表板的**计划任务**模态框中，使用**全局 / 项目**切换开关。 +- 通过 API，在自动化/例程端点上传递 `?scope=global` 或 `?scope=project&projectId=`。 + +**范围解析规则：** +- `scope=global` 始终解析到全局自动化/例程通道，与活跃项目无关。 +- `scope=project` 需要 `projectId`。若省略，则回退到 `"default"`。 +- 增删改查、运行、切换和 Webhook 操作严格按范围隔离：全局计划不能通过项目范围请求修改，反之亦然。 + +**多项目环境操作建议：** +- 共享基础设施（如夜间备份、记忆洞察提取）优先使用**全局**计划。 +- 仓库级自动化（如每项目测试运行器、部署钩子）优先使用**项目**计划。 +- 全局通道和项目通道由引擎独立轮询，一个通道中到期的运行不会阻塞另一个。 + +#### 自动化任务 + +| 端点 | 方法 | 说明 | +|---------|--------|-------------| +| `/api/automations` | GET | 列出所有自动化任务（若指定范围则按范围过滤） | +| `/api/automations` | POST | 创建自动化任务（范围默认为 `project`） | +| `/api/automations/:id` | GET | 按 ID 获取自动化任务 | +| `/api/automations/:id` | PATCH | 更新自动化任务 | +| `/api/automations/:id` | DELETE | 删除自动化任务 | +| `/api/automations/:id/run` | POST | 触发手动运行 | +| `/api/automations/:id/toggle` | POST | 切换启用/禁用 | +| `/api/automations/:id/steps/reorder` | POST | 重排自动化步骤顺序 | + +#### 例程 + +例程是由 Cron 计划、Webhook 或手动执行触发的 AI 智能体任务。例程与自动化任务共用相同的全局/项目范围模型。 + +| 端点 | 方法 | 说明 | +|---------|--------|-------------| +| `/api/routines` | GET | 列出所有例程（若指定范围则按范围过滤） | +| `/api/routines` | POST | 创建例程（范围默认为 `project`） | +| `/api/routines/:id` | GET | 按 ID 获取例程 | +| `/api/routines/:id` | PATCH | 更新例程 | +| `/api/routines/:id` | DELETE | 删除例程 | +| `/api/routines/:id/run` | POST | 手动触发 | +| `/api/routines/:id/trigger` | POST | 规范化手动触发 | +| `/api/routines/:id/runs` | GET | 获取执行历史 | +| `/api/routines/:id/webhook` | POST | Webhook 触发（支持签名验证） | + +--- + +## CLI 快速示例 + +```bash +fn task create "Fix the login bug" # 快速录入 → 规划 +fn task plan "Build auth system" # AI 辅助规划 +fn task import owner/repo --labels bug # 导入 GitHub Issue +fn task show FN-001 # 查看任务详情 +fn task logs FN-001 --follow # 流式查看执行日志 +fn task steer FN-001 "Use TypeScript" # 在执行中途引导智能体 + +fn project add my-app /path/to/app # 注册项目 +fn project list # 列出所有项目 + +fn settings set maxConcurrent 4 # 配置设置 +fn settings export # 导出配置 + +fn mission create "Auth System" "Build auth" # 创建任务群 +fn mission activate-slice # 激活切片 + +fn skills search react # 搜索 skills.sh +fn skills install firebase/agent-skills # 安装智能体技能 +``` + +--- + +## 包结构 + +| 包 | 说明 | +|---------|-------------| +| `@fusion/core` | 领域模型——任务、看板列、SQLite 存储 | +| `@fusion/dashboard` | Web UI——Express 服务器 + 带 SSE 的看板 | +| `@fusion/engine` | AI 引擎——规划、执行、调度、工作流步骤 | +| `@runfusion/fusion` | CLI + 扩展——发布至 npm | + +--- + +## 开发 + +```bash +pnpm install # 安装依赖 +pnpm local # 在非 4040 端口启动本地仪表板/API +pnpm local -- --engine # 启动带 AI 引擎的本地仪表板 +pnpm build # 构建默认工作区包（不含桌面端/移动端） +pnpm build:all # 构建所有包（含桌面端/移动端） +pnpm dev dashboard # 运行仪表板 + AI 引擎 +pnpm dev:ui # 仅仪表板（无 AI 引擎） +pnpm lint # 对所有包执行代码检查 +pnpm typecheck # 对所有包执行类型检查 +pnpm test # 运行所有测试 +``` + +### 构建独立可执行文件 + +使用 [Bun](https://bun.sh/) 构建单个自包含的 `fn` 二进制文件： + +```bash +pnpm build:exe # 为当前平台构建 +pnpm build:exe:all # 跨平台编译所有目标 +``` + +--- + +## 许可证 + +MIT — 开源，无供应商锁定。详见 [LICENSE](./LICENSE)。 + +
+ +**[runfusion.ai →](https://runfusion.ai)** + +
diff --git a/README.zh-TW.md b/README.zh-TW.md new file mode 100644 index 0000000000..d4d15d287c --- /dev/null +++ b/README.zh-TW.md @@ -0,0 +1,467 @@ +
+ +Fusion + +# 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) + +[English](./README.md) · [简体中文](./README.zh-CN.md) · **繁體中文** · [Français](./README.fr.md) · [Español](./README.es.md) · [한국어](./README.ko.md) + +*本文件為機器翻譯，英文版 README 為權威版本。* + +[![License: MIT](https://img.shields.io/badge/license-MIT-3fb950.svg)](./LICENSE) +[![npm](https://img.shields.io/npm/v/@runfusion/fusion.svg?color=58a6ff)](https://www.npmjs.com/package/@runfusion/fusion) +[![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/ksrfuy7WYR) +![Status](https://img.shields.io/badge/status-early%20preview-d29922.svg) +![Shipping](https://img.shields.io/badge/shipping-weekly-bc8cff.svg) + +
+ +Fusion 展示影片：從粗略想法到正式上線的程式碼 + +
+
+ + + Fusion 儀表板：規劃中、待辦、進行中、審閱中、已完成看板欄位，以及作用中的任務卡 + + +
+ +--- + +## 整個開發環境。盡在一個畫面。 + +用白話文描述一個任務。規劃代理人讀取你的專案、理解脈絡，並撰寫完整的 `PROMPT.md` 計畫——包含步驟、檔案範圍與驗收條件。接著 Fusion 在獨立的 git 工作樹中依序規劃、審閱、執行、再審閱，並在你指定的任何環節設置人工核准關卡。 + +一個看板。從任何地方操控。筆電、Mac mini、Linux 伺服器、雲端虛擬機、手機——全部連線。 + +> 就像 Trello，但你的任務由 AI 負責規格撰寫、執行與交付。基於 [dustinbyrne/kb](https://github.com/dustinbyrne/kb) 的優秀成果打造。 + +--- + +## 工作流程 + +``` + ① 描述 ② 規劃 ③ 看板 ④ 獨立工作樹 + ───────────── ───────────── ───────────── ───────────────────── + 「在設定面板 → 代理人撰寫 → 規劃 → 審閱 → → fusion/FN-123 分支 + 加入深色模式 PROMPT.md 執行 → 審閱 並行執行，零 + 切換開關」 （步驟、範圍、 （每步驟，直到 檔案衝突 + 驗收條件） 完成） +``` + +### 合併前看清每個步驟 + +
+ Fusion 任務詳情：進行中的任務顯示工作流程步驟、差異比較與檔案變更 +
+ +每個任務都即時顯示其計畫、審閱紀錄、差異比較與檔案變更。進入作用中的任務，調整方向、收緊限制條件、暫停或重新提示。 + +--- + +## 與眾不同之處 + +| | | +|---|---| +| 🧠 **AI 規劃** | 用白話文描述任務。規劃代理人將其轉換為含步驟、檔案範圍與驗收條件的 `PROMPT.md` 計畫。 | +| 🔁 **工作流程關卡** | 每個步驟皆執行：規劃 → 審閱 → 執行 → 審閱。合併前關卡阻擋劣質程式碼；合併後關卡執行資訊性檢查。 | +| 🌳 **工作樹隔離** | 每個任務在各自的分支與工作樹（`fusion/{task-id}`）中執行。任務並行執行，零衝突。可選用 [worktrunk](https://github.com/max-sixty/worktrunk) 委派，透過 [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) 設定（詳見 [WorktreeBackend 抽象層](./docs/architecture.md#worktreebackend-abstraction)）。 | +| ⚡ **智慧合併** | 通過所有關卡後，Fusion 自動壓縮合併並繼續執行。可在任何環節選擇手動核准。 | +| 🛰️ **多節點網狀架構** | 筆電、Mac mini、Linux 伺服器、雲端虛擬機、手機——全部同步。桌面、行動裝置、網頁皆支援。 | +| 🧩 **任意模型** | 支援 Anthropic、OpenAI、Ollama 等。本地與雲端模型共存。 | +| 🏢 **代理人公司** | 匯入預建團隊——橫跨 16 家公司的 440+ 個代理人——自主運行數週。 | +| 📬 **代理人間訊息傳遞** | 代理人之間內建郵件信箱。委派、釐清、協調。 | +| 🗨️ **多代理人聊天室** | 專案範圍的群組對話，多位成員可回覆：被提及的成員為直接回應者，其餘環境成員最多可回應至上限。目前為**實驗性功能**——在**設定 → 實驗性功能 → 聊天室**中啟用 `chatRooms`。（[聊天室文件](./docs/dashboard-guide.md#chat-rooms)） | +| 🗺️ **任務群組** | 層級式規劃（任務群組 → 里程碑 → 切片 → 功能 → 任務），具備自動駕駛模式與驗證合約。 | +| 🔬 **研究** | 有界研究執行，整合網頁搜尋、GitHub、本地文件與 LLM 合成（規劃與合成流程中亦支援執行時內建的 WebSearch/WebFetch）。將研究結果轉換為任務。（[文件](./docs/research.md)） | +| 🧪 **自我改善** | 代理人反思自身輸出，並隨著對你的程式碼庫的了解更新自身提示詞。 | +| 🔓 **開放原始碼，MIT 授權。** | 無廠商綁定。在自己的硬體上執行。每週持續更新。 | + +--- + +## 運作原理 + +```mermaid +graph TD + H((你)) -->|粗略想法| T["規劃中
自動規劃"] + T --> TD["待辦
排定執行"] + TD --> IP["進行中
每個步驟：
規劃、審閱、執行、審閱"] + + subgraph IP["進行中"] + direction TD + NS([開始步驟]) --> P[規劃] + P --> R1{審閱} + R1 -->|修訂| P + R1 -->|核准| E[執行] + E --> R2{審閱} + R2 -->|修訂| E + R2 -->|下一步驟| NS + R2 -->|重新思考| P + end + + R2 -->|完成| IR["審閱中
準備合併
或自動完成"] + IR -->|直接壓縮合併
或已合併的 PR| D["已完成"] + + 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 +``` + +有相依關係的任務依序處理；獨立任務並行執行。可選擇在任務從「規劃中」移至「待辦」前要求手動核准（`requirePlanApproval` 設定）。 + +--- + +## 多節點。一個看板。全平台支援。 + +
+ +Fusion 網狀架構：筆電、Mac mini、Linux 伺服器、雲端虛擬機、手機——全部同步 + +
+ +![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Windows](https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white) +![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black) +![Web](https://img.shields.io/badge/Web-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white) +![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=apple&logoColor=white) +![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white) + +
+ +筆電、Mac mini、Linux 伺服器、雲端虛擬機、手機——每個節點都是對等節點。你的任務狀態、代理人、日誌與差異比較在整個網狀架構中保持同步。同一個 Fusion 以下列形式發布： + +- 🖥️ **桌面應用程式** — 支援 **macOS**（Intel + Apple Silicon）、**Windows** 10/11 與 **Linux** 的 Electron 應用程式 +- 📱 **行動應用程式** — 支援 **iOS/iPadOS** 與 **Android** 的 Capacitor 應用程式（[MOBILE.md](./MOBILE.md)） +- 🌐 **網頁儀表板** — 任何現代瀏覽器，由 `fn dashboard` 背景程式提供服務 +- 🔌 **命令列介面** — `fn` 執行檔 + 適合以終端機為主要工作流程的擴充功能 + +在任意節點啟動背景程式，連接其他裝置，看板就會跟著你到任何地方。 + +--- + +## 執行代理人公司 + +
+ +Fusion 代理人公司：匯入團隊，自主執行數週 + +
+ +匯入一個團隊，自主執行數週。**橫跨 16 家公司的 440+ 個代理人**，專為任務群組、信箱與代理人間委派而設計。 + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +--- + +## 與你已在使用的工具相容。 + +Fusion 整合你喜愛的工具。**Hermes**、**Paperclip** 與 **OpenClaw** 皆作為一等公民外掛程式發布——將任何工作區路由至最適合該任務的執行環境。任何 Paperclip 代理人公司都能以單一指令匯入。 + +
+ Hermes +
+ +### [Hermes](https://hermes-agent.nousresearch.com) `experimental` + +Nous Research + +來自 **Nous Research** 的開放原始碼自主代理人。安裝 Hermes 外掛程式，透過 Hermes 執行代理人，適合需要長時間執行、上下文持續增長的工作——可將任何 Fusion 工作區路由至 Hermes。 + +### OpenClaw `experimental` + +OpenClaw 執行環境支援作為實驗性外掛程式（`fusion-plugin-openclaw-runtime`）提供，可進行執行環境探索與設定對等。安裝外掛程式後，以 `runtimeConfig.runtimeHint: "openclaw"` 設定代理人。 + +
+ +
+ Paperclip +
+ +### [Paperclip](https://paperclip.ing) `experimental` + +paperclip.ing + +AI 勞動力的人類控制平面。安裝 Paperclip 外掛程式，在 Fusion 內透過 Paperclip 執行代理人。 + +Fusion 也原生支援 **[`companies.sh`](https://github.com/paperclipai/companies)** 代理人公司標準：匯入預建團隊——**橫跨 16 家公司的 440+ 個代理人**——讓他們透過 Fusion 的信箱、任務群組與工作流程關卡協調作業，自主工作數週。相同的公司格式、相同的代理人、相同的技能，與 Paperclip 一致。 + +```bash +npx companies.sh add paperclipai/companies/gstack +``` + +
+ +> **Hermes**、**Paperclip** 與 **OpenClaw** 為**實驗性**執行環境外掛程式——API 與通訊格式可能在次要版本之間有所變動。 + +--- + +## 快速開始 + +**免安裝，直接從 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)。 + +--- + +## 文件 + +| 指南 | 涵蓋內容 | +|---|---| +| [入門指南](./docs/getting-started.md) | 安裝與引導 | +| [儀表板指南](./docs/dashboard-guide.md) | 看板/清單檢視、終端機、git 管理器 | +| [任務管理](./docs/task-management.md) | 任務生命週期與命令列指令 | +| [命令列參考](./docs/cli-reference.md) | 完整指令與背景程式參考 | +| [設定參考](./docs/settings-reference.md) | 組態選項 | +| [系統架構](./docs/architecture.md) | 系統內部運作 | +| [代理人](./docs/agents.md) | 代理人管理、生成與心跳 | +| [工作流程步驟](./docs/workflow-steps.md) | 品質關卡、範本、階段 | +| [任務群組](./docs/missions.md) | 任務群組層級、規劃、自動駕駛模式 | +| [多專案](./docs/multi-project.md) | 中央登錄表、隔離模式 | +| [Docker](./docs/docker.md) | 容器部署 | + +--- + +## 核心功能 + +- **AI 規劃** — 規劃代理人產生詳細的 `PROMPT.md`，包含步驟、檔案範圍與驗收條件 +- **逐步執行** — 每個任務步驟執行「規劃 → 審閱 → 執行 → 審閱」循環 +- **Git 工作樹隔離** — 每個任務在各自的工作樹（`fusion/{task-id}` 分支）中執行 +- **工作流程步驟** — 可設定的品質關卡（合併前：阻擋合併；合併後：資訊性） +- **GitHub 整合** — 匯入議題、建立 PR、即時 PR/議題徽章 +- **儀表板** — 即時看板、代理人管理、終端機、git 管理器、任務群組規劃器 +- **任務群組** — 層級式規劃（任務群組 → 里程碑 → 切片 → 功能 → 任務），具備自動駕駛模式、驗證合約、修復功能重試與封鎖交接語意 +- **多專案** — 從單一安裝管理多個專案，具備專案隔離 +- **代理人間訊息傳遞** — 代理人與使用者之間協調用的內建訊息傳遞 +- **聊天室（實驗性）** — 專案範圍的群組對話，被提及的成員為直接回應者，其餘環境成員最多可回覆至上限（在**設定 → 實驗性功能 → 聊天室**中啟用；詳見[儀表板指南 → 聊天室](./docs/dashboard-guide.md#chat-rooms)） + +### 供應商驗證 + +Fusion 透過**設定 → 驗證**支援 AI 供應商的 OAuth 驗證。對大多數 OAuth 供應商而言，當儀表板透過非 localhost 主機存取（遠端節點、區域網路主機/IP 或反向代理），供應商登入網址會被重寫，以透過橋接端點（`/api/auth/oauth-callback`）路由 OAuth 回呼，確保重導向能到達作用中的瀏覽器工作階段。 + +- **Anthropic (Claude)** — 在設定/引導精靈中使用貼上授權碼流程：登入後，將最終的重導向網址（或授權碼）貼回 Fusion 以完成登入 +- **OpenAI Codex** — 使用相同的貼上授權碼流程，搭配安全的狀態驗證 +- **Factory AI — 透過 Droid CLI** *（選填）* — 需要本地安裝 Droid CLI 並執行 `droid auth login`；偵測依照有效的執行環境二進位路徑（預設為 `droid`，或設定後的外掛程式 `droidBinaryPath`），然後在**設定 → 驗證**中啟用並重新啟動 Fusion +- **llama.cpp — 透過 HTTP 伺服器** *（選填）* — 設定你的 llama.cpp 伺服器網址（預設 `http://127.0.0.1:8080`）與選填的 API 金鑰，然後在**設定 → 驗證**中啟用 +- **其他供應商** — 在設定中透過輸入 API 金鑰進行驗證（包含 Google/Gemini API 金鑰、Google Generative AI、Vertex 與 Cloud Code 別名） + +### 模型系統 + +Fusion 使用具備五條獨立通道的雙範圍模型層級。全域設定定義基準預設值；專案設定提供每個專案的覆蓋值。 + +| 通道 | 用途 | 全域基準金鑰 | 專案覆蓋金鑰 | +|------|---------|---------------------|----------------------| +| Executor | 任務執行代理人 | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` | +| Planning | 任務規劃代理人 | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` | +| Validator | 計畫/程式碼審閱者 | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` | +| Title Summarization | 自動標題產生 | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` | +| Workflow Step Refinement | AI 提示詞精煉 | （使用 `defaultProvider`/`defaultModelId`） | （使用 WorkflowStep 上的 `modelProvider`/`modelId`） | + +**每任務覆蓋：** 任務可透過每任務模型欄位（`modelProvider`/`modelId`、`validatorModelProvider`/`validatorModelId`、`planningModelProvider`/`planningModelId`）覆蓋執行器、驗證器與規劃通道。 + +**優先順序：** 每任務 → 專案覆蓋 → 全域通道 → `defaultProvider`/`defaultModelId` → 自動解析。 + +完整的設定文件，請參閱[設定參考](./docs/settings-reference.md)。 + +### 排程任務/自動化 + +Fusion 透過 `/api/automations` 端點支援排程任務自動化。自動化可按設定的排程執行 shell 指令或多步驟工作流程。 + +#### 排程範圍 + +自動化與常式可在兩種範圍中執行： + +- **全域** — 跨所有專案執行。適用於跨專案維護、備份或統一報告。 +- **專案** — 僅在特定專案中執行。適用於特定專案的 CI、測試或部署任務。 + +當你建立排程而未選擇範圍時，Fusion 為了向後相容，預設使用 `default` 專案 ID 的**專案範圍**。 + +明確指定範圍的方式： +- 在儀表板的**排程任務**對話框中，使用**全域 / 專案**切換。 +- 透過 API，在自動化/常式端點上傳遞 `?scope=global` 或 `?scope=project&projectId=`。 + +**範圍解析規則：** +- `scope=global` 永遠解析至全域自動化/常式通道，與作用中的專案無關。 +- `scope=project` 需要 `projectId`。若省略，退回至 `"default"`。 +- CRUD、執行、切換與 webhook 操作嚴格進行範圍隔離：全域排程無法從專案範圍的請求進行變更，反之亦然。 + +**多專案設定的操作指引：** +- 偏好使用**全域**排程處理共用基礎設施（例如每夜備份、記憶體洞察擷取）。 +- 偏好使用**專案**排程處理每個儲存庫的自動化（例如每個專案的測試執行器、部署鉤子）。 +- 全域與專案通道由引擎獨立輪詢，因此一個通道中的到期執行不會阻擋另一個通道。 + +#### 自動化 + +| 端點 | 方法 | 說明 | +|---------|--------|-------------| +| `/api/automations` | GET | 列出所有自動化（若指定範圍則依範圍篩選） | +| `/api/automations` | POST | 建立自動化（範圍預設為 `project`） | +| `/api/automations/:id` | GET | 依 ID 取得自動化 | +| `/api/automations/:id` | PATCH | 更新自動化 | +| `/api/automations/:id` | DELETE | 刪除自動化 | +| `/api/automations/:id/run` | POST | 觸發手動執行 | +| `/api/automations/:id/toggle` | POST | 切換啟用/停用 | +| `/api/automations/:id/steps/reorder` | POST | 重新排序自動化步驟 | + +#### 常式 + +常式是由 cron 排程、webhook 或手動執行觸發的 AI 代理人任務。常式與自動化共用相同的全域/專案範圍模型。 + +| 端點 | 方法 | 說明 | +|---------|--------|-------------| +| `/api/routines` | GET | 列出所有常式（若指定範圍則依範圍篩選） | +| `/api/routines` | POST | 建立常式（範圍預設為 `project`） | +| `/api/routines/:id` | GET | 依 ID 取得常式 | +| `/api/routines/:id` | PATCH | 更新常式 | +| `/api/routines/:id` | DELETE | 刪除常式 | +| `/api/routines/:id/run` | POST | 手動觸發 | +| `/api/routines/:id/trigger` | POST | 正式手動觸發端點 | +| `/api/routines/:id/runs` | GET | 取得執行歷史 | +| `/api/routines/:id/webhook` | POST | Webhook 觸發（支援簽章驗證） | + +--- + +## 命令列快速範例 + +```bash +fn task create "Fix the login bug" # 快速輸入 → 規劃 +fn task plan "Build auth system" # AI 引導規劃 +fn task import owner/repo --labels bug # 匯入 GitHub 議題 +fn task show FN-001 # 檢視任務詳情 +fn task logs FN-001 --follow # 串流執行日誌 +fn task steer FN-001 "Use TypeScript" # 執行中引導代理人 + +fn project add my-app /path/to/app # 註冊專案 +fn project list # 列出所有專案 + +fn settings set maxConcurrent 4 # 設定組態 +fn settings export # 匯出組態 + +fn mission create "Auth System" "Build auth" # 建立任務群組 +fn mission activate-slice # 啟動切片 + +fn skills search react # 搜尋 skills.sh +fn skills install firebase/agent-skills # 安裝代理人技能 +``` + +--- + +## 套件 + +| 套件 | 說明 | +|---------|-------------| +| `@fusion/core` | 領域模型——任務、看板欄位、SQLite 儲存庫 | +| `@fusion/dashboard` | 網頁 UI——Express 伺服器 + 搭配 SSE 的看板 | +| `@fusion/engine` | AI 引擎——規劃、執行、排程、工作流程步驟 | +| `@runfusion/fusion` | 命令列介面 + 擴充功能——發布至 npm | + +--- + +## 開發 + +```bash +pnpm install # 安裝相依套件 +pnpm local # 在非 4040 連接埠啟動本地儀表板/API +pnpm local -- --engine # 啟動本地儀表板並包含 AI 引擎 +pnpm build # 建置預設工作區套件（不含桌面/行動裝置） +pnpm build:all # 建置所有套件（包含桌面/行動裝置） +pnpm dev dashboard # 執行儀表板 + AI 引擎 +pnpm dev:ui # 僅儀表板（不含 AI 引擎） +pnpm lint # 對所有套件執行 lint +pnpm typecheck # 對所有套件進行型別檢查 +pnpm test # 執行所有測試 +``` + +### 建置獨立執行檔 + +使用 [Bun](https://bun.sh/) 建置單一自包含的 `fn` 執行檔： + +```bash +pnpm build:exe # 為目前平台建置 +pnpm build:exe:all # 跨平台編譯所有平台 +``` + +--- + +## 授權條款 + +MIT——開放原始碼，無廠商綁定。請參閱 [LICENSE](./LICENSE)。 + +
+ +**[runfusion.ai →](https://runfusion.ai)** + +
diff --git a/docs/cli-reference.md b/docs/cli-reference.md index 73ac1ece03..cad8358f5b 100644 --- a/docs/cli-reference.md +++ b/docs/cli-reference.md @@ -211,7 +211,7 @@ fn dashboard --lang zh-TW # force a UI locale for this run ``` The terminal UI is localized. `--lang ` (one of `en`, `zh-CN`, `zh-TW`, -`fr`, `es`) takes precedence over the saved dashboard language setting and the +`fr`, `es`, `ko`) takes precedence over the saved dashboard language setting and the `LC_ALL`/`LC_MESSAGES`/`LANG`/`LANGUAGE` environment. See [Localization contributor guide](./i18n-contributing.md). diff --git a/docs/settings-reference.md b/docs/settings-reference.md index cf38740a1c..e5e33abf8e 100644 --- a/docs/settings-reference.md +++ b/docs/settings-reference.md @@ -33,7 +33,7 @@ Defaults from `DEFAULT_GLOBAL_SETTINGS`; key scope from `GLOBAL_SETTINGS_KEYS`. |---|---|---:|---| | `themeMode` | `"dark" \| "light" \| "system"` | `"dark"` | Dashboard theme mode. | | `colorTheme` | `ColorTheme` | `"default"` | Dashboard color theme preset. | -| `language` | `"en" \| "zh-CN" \| "zh-TW" \| "fr" \| "es"` | `undefined` | UI language for the dashboard and TUI. When unset, the dashboard detects from localStorage → browser language and the CLI from `--lang` flag → environment locale, falling back to `en`. Validated at the store write boundary (`validateLocale`); invalid values are dropped. Reset to auto-detect via the dashboard's "Auto" language option or `fn settings set language auto` (clears the persisted key). | +| `language` | `"en" \| "zh-CN" \| "zh-TW" \| "fr" \| "es" \| "ko"` | `undefined` | UI language for the dashboard and TUI. When unset, the dashboard detects from localStorage → browser language and the CLI from `--lang` flag → environment locale, falling back to `en`. Validated at the store write boundary (`validateLocale`); invalid values are dropped. Reset to auto-detect via the dashboard's "Auto" language option or `fn settings set language auto` (clears the persisted key). | | `dashboardFontScalePct` | `number` | `100` | Dashboard font scale percentage used by Appearance settings. Valid range: `85` to `125`; applied pre-hydration via document root font-size so board typography (column headers/counts, task cards, and quick-entry text) scales with the setting from first paint. | | `defaultProvider` | `string` | `undefined` | Default AI provider. | | `defaultModelId` | `string` | `undefined` | Default AI model ID. | diff --git a/i18next.config.ts b/i18next.config.ts index 03283d9f7d..a57acc83c5 100644 --- a/i18next.config.ts +++ b/i18next.config.ts @@ -18,7 +18,7 @@ import { * source, not by file path. `common` is the default namespace. */ export default defineConfig({ - locales: ["en", "zh-CN", "zh-TW", "fr", "es"], + locales: ["en", "zh-CN", "zh-TW", "fr", "es", "ko"], extract: { input: [ "packages/dashboard/app/**/*.{ts,tsx}", diff --git a/packages/cli/src/bin.ts b/packages/cli/src/bin.ts index b6dacfb95e..3ab9799e8d 100644 --- a/packages/cli/src/bin.ts +++ b/packages/cli/src/bin.ts @@ -420,7 +420,7 @@ Options: --interactive Interactive mode (port selection for dashboard, issue selection for import) --paused Start with engine paused (automation disabled) --dev Start dashboard only (no AI engine) - --lang Terminal-UI locale for this run (en, zh-CN, zh-TW, fr, es); the browser dashboard resolves its own language + --lang Terminal-UI locale for this run (en, zh-CN, zh-TW, fr, es, ko); the browser dashboard resolves its own language --attach Attach file(s) on task create (repeatable) --depends Declare dependency on task create (repeatable) --no-dedup Bypass deterministic duplicate guard on task create diff --git a/packages/cli/src/commands/__tests__/settings.test.ts b/packages/cli/src/commands/__tests__/settings.test.ts index 1de05dd11e..b1b82659d6 100644 --- a/packages/cli/src/commands/__tests__/settings.test.ts +++ b/packages/cli/src/commands/__tests__/settings.test.ts @@ -25,7 +25,7 @@ vi.mock("@fusion/core", () => { return { GlobalSettingsStore: vi.fn(), DEFAULT_SETTINGS, - SUPPORTED_LOCALES: ["en", "zh-CN", "zh-TW", "fr", "es"], + SUPPORTED_LOCALES: ["en", "zh-CN", "zh-TW", "fr", "es", "ko"], resolveWorktrunkSettings: (globalValue: any, projectValue: any) => ({ enabled: projectValue?.enabled ?? globalValue?.enabled ?? false, ...(projectValue?.binaryPath ?? globalValue?.binaryPath ? { binaryPath: projectValue?.binaryPath ?? globalValue?.binaryPath } : {}), diff --git a/packages/core/src/__tests__/locale-settings.test.ts b/packages/core/src/__tests__/locale-settings.test.ts index f9d8a7d65b..84a096039a 100644 --- a/packages/core/src/__tests__/locale-settings.test.ts +++ b/packages/core/src/__tests__/locale-settings.test.ts @@ -12,13 +12,13 @@ import { } from "../index.js"; describe("locale primitives", () => { - it("exposes exactly the five supported locale codes", () => { - expect([...SUPPORTED_LOCALES]).toEqual(["en", "zh-CN", "zh-TW", "fr", "es"]); + it("exposes exactly the six supported locale codes", () => { + expect([...SUPPORTED_LOCALES]).toEqual(["en", "zh-CN", "zh-TW", "fr", "es", "ko"]); }); it("uses en as the default/source locale", () => { expect(DEFAULT_LOCALE).toBe("en"); - expectTypeOf().toEqualTypeOf<"en" | "zh-CN" | "zh-TW" | "fr" | "es">(); + expectTypeOf().toEqualTypeOf<"en" | "zh-CN" | "zh-TW" | "fr" | "es" | "ko">(); }); it("narrows supported codes and rejects everything else via isLocale", () => { diff --git a/packages/core/src/types.ts b/packages/core/src/types.ts index 54f2a1b0a4..f230cfdabc 100644 --- a/packages/core/src/types.ts +++ b/packages/core/src/types.ts @@ -212,7 +212,7 @@ export type ColorTheme = (typeof COLOR_THEMES)[number]; * here (plus translated catalogs) is the only code change a new language * needs — see `@fusion/i18n`. zh-CN and zh-TW are independent catalogs and * are never auto-converted between scripts. */ -export const SUPPORTED_LOCALES = ["en", "zh-CN", "zh-TW", "fr", "es"] as const; +export const SUPPORTED_LOCALES = ["en", "zh-CN", "zh-TW", "fr", "es", "ko"] as const; export type Locale = (typeof SUPPORTED_LOCALES)[number]; /** Source-of-truth language and the fallback for all locales. */ export const DEFAULT_LOCALE: Locale = "en"; diff --git a/packages/dashboard/app/components/LanguageSelector.tsx b/packages/dashboard/app/components/LanguageSelector.tsx index 167b9b4e38..3000dfa73f 100644 --- a/packages/dashboard/app/components/LanguageSelector.tsx +++ b/packages/dashboard/app/components/LanguageSelector.tsx @@ -10,6 +10,7 @@ const ENDONYMS: Record = { "zh-TW": "繁體中文", fr: "Français", es: "Español", + ko: "한국어", }; /** Settings control for choosing the UI language. Applies in place (no reload). */ diff --git a/packages/dashboard/app/hooks/__tests__/useLanguage.test.ts b/packages/dashboard/app/hooks/__tests__/useLanguage.test.ts index fbef6512f3..bc7b74dbcf 100644 --- a/packages/dashboard/app/hooks/__tests__/useLanguage.test.ts +++ b/packages/dashboard/app/hooks/__tests__/useLanguage.test.ts @@ -83,7 +83,7 @@ describe("useLanguage", () => { it("exposes the supported locale list", () => { const { result } = renderHook(() => useLanguage()); - expect([...result.current.supportedLocales]).toEqual(["en", "zh-CN", "zh-TW", "fr", "es"]); + expect([...result.current.supportedLocales]).toEqual(["en", "zh-CN", "zh-TW", "fr", "es", "ko"]); }); it("hydrates from server settings when no local choice exists", async () => { diff --git a/packages/i18n/locales/ko/app.json b/packages/i18n/locales/ko/app.json new file mode 100644 index 0000000000..2cf740485b --- /dev/null +++ b/packages/i18n/locales/ko/app.json @@ -0,0 +1,11 @@ +{ + "settings": { + "appearance": { + "title": "모양", + "language": "언어", + "languageAuto": "자동", + "languageAutoHint": "브라우저 언어를 따릅니다", + "languageHint": "{{brand}} 인터페이스의 언어를 선택하세요." + } + } +} diff --git a/packages/i18n/locales/ko/cli.json b/packages/i18n/locales/ko/cli.json new file mode 100644 index 0000000000..6c38171a78 --- /dev/null +++ b/packages/i18n/locales/ko/cli.json @@ -0,0 +1,9 @@ +{ + "tui": { + "loading": "불러오는 중…", + "loadingTasks": "작업을 불러오는 중…", + "noTasks": "이 프로젝트에 작업이 없습니다.", + "switchProjectsHint": "[{{key}}] 키를 눌러 프로젝트를 전환합니다.", + "quit": "종료" + } +} diff --git a/packages/i18n/locales/ko/common.json b/packages/i18n/locales/ko/common.json new file mode 100644 index 0000000000..2f7cbbab9e --- /dev/null +++ b/packages/i18n/locales/ko/common.json @@ -0,0 +1,15 @@ +{ + "columns": { + "triage": "계획", + "todo": "할 일", + "in-progress": "진행 중", + "in-review": "검토 중", + "done": "완료", + "archived": "보관됨" + }, + "actions": { + "save": "저장", + "cancel": "취소", + "close": "닫기" + } +} diff --git a/packages/i18n/locales/ko/errors.json b/packages/i18n/locales/ko/errors.json new file mode 100644 index 0000000000..bfd5403c99 --- /dev/null +++ b/packages/i18n/locales/ko/errors.json @@ -0,0 +1,4 @@ +{ + "fetchProjectsFailed": "프로젝트를 불러오지 못했습니다", + "openTaskLogsFailed": "작업 로그를 열지 못했습니다: {{detail}}" +} diff --git a/packages/i18n/src/cli-catalogs.ts b/packages/i18n/src/cli-catalogs.ts index 354c3bc256..699fd939ce 100644 --- a/packages/i18n/src/cli-catalogs.ts +++ b/packages/i18n/src/cli-catalogs.ts @@ -9,6 +9,9 @@ import es_errors from "../locales/es/errors.json"; import fr_common from "../locales/fr/common.json"; import fr_cli from "../locales/fr/cli.json"; import fr_errors from "../locales/fr/errors.json"; +import ko_common from "../locales/ko/common.json"; +import ko_cli from "../locales/ko/cli.json"; +import ko_errors from "../locales/ko/errors.json"; import zh_CN_common from "../locales/zh-CN/common.json"; import zh_CN_cli from "../locales/zh-CN/cli.json"; import zh_CN_errors from "../locales/zh-CN/errors.json"; @@ -32,6 +35,11 @@ export const cliResources = { cli: fr_cli, errors: fr_errors, }, + "ko": { + common: ko_common, + cli: ko_cli, + errors: ko_errors, + }, "zh-CN": { common: zh_CN_common, cli: zh_CN_cli,