Przejdź do głównej zawartości

Web

Korzystanie z matrix w przeglądarce.

matrix może działać jako aplikacja internetowa w przeglądarce, zapewniając takie same możliwości kodowania AI bez konieczności korzystania z terminala.

Sieć matrix - Nowa sesja

Pierwsze kroki

Uruchom interfejs sieciowy, uruchamiając:

Okno terminala
matrix web

Spowoduje to uruchomienie lokalnego serwera na 127.0.0.1 z losowo dostępnym portem i automatyczne otwarcie matrix w domyślnej przeglądarce.


Konfiguracja

Możesz skonfigurować serwer WWW za pomocą flag wiersza poleceń lub w [pliku konfiguracyjnym] (./config).

Port

Domyślnie matrix wybiera dostępny port. Możesz określić port:

Okno terminala
matrix web --port 4096

Nazwa hosta

Domyślnie serwer łączy się z 127.0.0.1 (tylko localhost). Aby udostępnić matrix w swojej sieci:

Okno terminala
matrix web --hostname 0.0.0.0

Podczas korzystania z 0.0.0.0 matrix wyświetli zarówno adresy lokalne, jak i sieciowe:

Local access: http://localhost:4096
Network access: http://192.168.1.100:4096

Wykrywanie mDNS

Włącz mDNS, aby Twój serwer był wykrywalny w sieci lokalnej:

Okno terminala
matrix web --mdns

To automatycznie ustawia nazwę hosta na 0.0.0.0 i anonsuje serwer jako matrix.local.

Możesz dostosować nazwę domeny mDNS, aby uruchamiała wiele instancji w tej samej sieci:

Okno terminala
matrix web --mdns --mdns-domain myproject.local

CORS

Aby zezwolić na dodatkowe domeny dla CORS (przydatne w przypadku niestandardowych interfejsów):

Okno terminala
matrix web --cors https://example.com

Uwierzytelnianie

Aby chronić dostęp, ustaw hasło za pomocą zmiennej środowiskowej MATRIX_SERVER_PASSWORD:

Okno terminala
MATRIX_SERVER_PASSWORD=secret matrix web

Domyślna nazwa użytkownika to matrix, ale można ją zmienić za pomocą MATRIX_SERVER_USERNAME.


Korzystanie z interfejsu internetowego

Po uruchomieniu interfejs sieciowy zapewnia dostęp do sesji matrix.

Sesje

Przeglądaj sesje i zarządzaj nimi ze strony głównej. Możesz zobaczyć aktywne sesje i rozpocząć nowe.

matrix Web - Aktywna sesja

Stan serwera

Kliknij „Zobacz serwery”, aby wyświetlić podłączone serwery i ich status.

matrix Web - See Servers


Podłączanie terminala

Możesz podłączyć terminal TUI do działającego serwera WWW:

Okno terminala
# Start the web server
matrix web --port 4096
# In another terminal, attach the TUI
matrix attach http://localhost:4096

Umożliwia to jednoczesne korzystanie z interfejsu sieciowego i terminala, współdzieląc te same sesje i stan.


Plik konfiguracyjny

Możesz także skonfigurować ustawienia serwera w pliku konfiguracyjnym matrix.json:

{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}

Flagi wiersza poleceń mają pierwszeństwo przed ustawieniami pliku konfiguracyjnego.