Contribuir · Docs de Tunnel Agent

Compila Tunnel Agent desde el código fuente, ejecuta los tests y envía un pull request.

Las contribuciones son bienvenidas. Tunnel Agent está escrito en C# sobre .NET 10 con Avalonia 11 y CommunityToolkit.Mvvm.

Compilar desde el código fuente#

Instala el SDK de .NET 10.0.203+ y después:

git clone https://github.com/beyondhumane/tunnel-agent.git
cd tunnel-agent
dotnet restore
dotnet run --project src/TunnelAgent.Avalonia/TunnelAgent.Avalonia.csproj

Ejecuta los tests:

dotnet test tests/TunnelAgent.Tests/TunnelAgent.Tests.csproj

Estructura del repositorio#

Ruta	Contenido
`src/TunnelAgent.Abstractions`	Interfaces y modelos compartidos.
`src/TunnelAgent.Core`	Catálogo de motores y lógica principal.
`src/TunnelAgent.Infrastructure`	Implementaciones de plataforma y almacenamiento.
`src/TunnelAgent.Avalonia`	La app de escritorio: vistas, view models, servicios, temas y traducciones.
`tests/TunnelAgent.Tests`	Tests unitarios.
`site`	Esta web.

Pull requests#

Mantén los PR acotados: una función o corrección por PR.
Sigue el estilo y los nombres del código existente.
Añade una línea a CHANGELOG.md bajo ## [Unreleased] por cada cambio de comportamiento.
Todos los checks de CI tienen que pasar antes de mergear.

Trabajar en esta web#

La web es una app de Vite + React prerenderizada a HTML estático. Las páginas en inglés están en site/content/docs/*.md y sus traducciones al español en site/content/docs/es/*.md.

cd site
npm install
npm run dev

Créditos#

Tunnel Agent se apoya en CLIProxyAPI, perplexity-webui-scraper y 9Router, y se inspiró en VibeProxy. El seguimiento de cuota se basa en Quotio y OpenUsage.