# Daytona

Daytona ļauj Termbridge palaist termināli un priekšskatījumu mākoņa smilškastē. Izmantojiet to, ja vajadzīga reproducējama vide vai mākoņa priekšskatījums, vai ja vēlaties, lai klēpjdators paliktu dīkstāvē.

## Prasības

- Daytona atslēga API
- Repozitorijs URL, kuru smilškaste var klonēt
- Git akreditācijas dati, ja repozitorijs ir privāts

## Ātrais sākums

Iestatiet aizmugursistēmu uz Daytona un norādiet repozitorija konfigurāciju:

```bash
export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_DAYTONA_API_KEY=your_key
export TERMBRIDGE_SANDBOX_REPO=https://github.com/you/your-repo.git
export TERMBRIDGE_SANDBOX_BRANCH=main
export TERMBRIDGE_SANDBOX_PATH=your-repo
export TERMBRIDGE_SANDBOX_NAME=termbridge-sandbox
export TERMBRIDGE_SANDBOX_PUBLIC=true
export TERMBRIDGE_SANDBOX_PREVIEW_PORT=5173
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true
```

Pēc tam palaidiet Termbridge kā parasti:

```bash
npx termbridge
```

Vienmēr iestatiet `TERMBRIDGE_SANDBOX_REPO` (vai `--sandbox-repo`). Ja šī vērtība nav norādīta, Termbridge pašlaik izmanto iebūvētu noklusējuma repozitoriju, kas nav publiski pieejams, tāpēc smilškaste tiek izveidota, bet klonēšana neizdodas ([#2](https://github.com/inline0/termbridge/issues/2)).

## Daytona savienojums

| Mainīgais | Nolūks |
| --- | --- |
| `TERMBRIDGE_DAYTONA_API_KEY` | Jūsu Daytona API atslēga |
| `TERMBRIDGE_DAYTONA_API_URL` | API galapunkts (pēc noklusējuma `https://app.daytona.io/api`) |
| `TERMBRIDGE_DAYTONA_TARGET` | Daytona mērķa reģions (neobligāti) |

Tie tiek nodoti Daytona SDK. Ja kāds no tiem nav iestatīts, SDK izmanto savu `DAYTONA_API_KEY`, `DAYTONA_API_URL` vai `DAYTONA_TARGET` mainīgo.

## Tiešais smilškastes režīms (bez tuneļa)

Tiešajā režīmā Termbridge serveris darbojas smilškastē, un Cloudflare netiek izmantots. Kopīgošanas URL ir Daytona priekšskatījuma saite uz serveri smilškastē.

```bash
export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_DIRECT=true
export TERMBRIDGE_SANDBOX_SERVER_PORT=8080
```

`TERMBRIDGE_SANDBOX_SERVER_PORT` (vai `--port`) pēc noklusējuma ir `8080`. Tiešajā režīmā tiek izveidota publiska smilškaste, ja vien neiestatāt `TERMBRIDGE_SANDBOX_PUBLIC=false`, un UI paslēpj termināļu pārslēdzēju.

Joprojām varat iespējot priekšskatījumu, iestatot `TERMBRIDGE_SANDBOX_PREVIEW_PORT`; tiešajā režīmā šī vērtība tiek pārsūtīta kā servera ports `--proxy`.

## Repozitorija klonēšana

Termbridge izveidos smilškasti un klonēs jūsu repozitoriju smilškastes darba direktorijā.

Izmantojiet šos iestatījumus:

| Mainīgais | Nolūks |
| --- | --- |
| `TERMBRIDGE_SANDBOX_REPO` | Klonējamā repozitorija URL (vienmēr iestatiet; skatiet ātrās darba sākšanas ceļvedi) |
| `TERMBRIDGE_SANDBOX_BRANCH` | Izgūstamais atzars (neobligāti) |
| `TERMBRIDGE_SANDBOX_PATH` | Repozitorija ceļš smilškastē (neobligāti) |
| `TERMBRIDGE_SANDBOX_NAME` | Smilškastes nosaukums (neobligāti; pēc noklusējuma `termbridge-<random hex>`) |

Ja `TERMBRIDGE_SANDBOX_PATH` nav iestatīts, Termbridge to nosaka pēc repozitorija nosaukuma.

## Privātie repozitoriji

Sniedziet git akreditācijas datus, klonējot privātos repozitorijus:

```bash
export TERMBRIDGE_SANDBOX_GIT_USERNAME=your_github_username
export TERMBRIDGE_SANDBOX_GIT_TOKEN=your_github_token
```

Tiek atbalstīts arī `TERMBRIDGE_SANDBOX_GIT_PASSWORD`; ja tas ir iestatīts, tas aizstāj tokenu.

## Koda veidošanas aģenti

Termbridge var instalēt koda veidošanas aģentus smilškastē un sinhronizēt jūsu vietējo autentifikāciju, lai tie būtu uzreiz gatavi lietošanai.

Pilnu iestatīšanas ceļvedi, automātisko režīmu un drošības informāciju skatiet ceļvedī [Koda veidošanas aģenti](https://termbridge.inline0.dev/lv/docs/sandboxes/coding-agents).

## Priekšskatījuma režīms

Lai parādītu priekšskatījuma skatu, iestatiet `TERMBRIDGE_SANDBOX_PREVIEW_PORT` uz portu, ko izmanto izstrādes serveris smilškastē.

Ja izmantojat Vite, pārliecinieties, ka serveris ir piesaistīts visām saskarnēm:

```bash
npm run dev -- --host 0.0.0.0 --port 5173
```

Termbridge iegūst Daytona priekšskatījuma saiti un pārsūta tās pieprasījumus caur Termbridge serveri, lai priekšskatījums tiktu ielādēts UI.

## Publiskās un privātās smilškastes

| Mainīgais | Darbība |
| --- | --- |
| `TERMBRIDGE_SANDBOX_PUBLIC=true` | Izveido publisku smilškasti |
| `TERMBRIDGE_SANDBOX_PUBLIC=false` | Izveido privātu smilškasti |

Ja mainīgais nav iestatīts, smilškastes ir privātas, izņemot tiešo režīmu, kurā tās ir publiskas.

Privātām smilškastēm Termbridge automātiski pārsūta priekšskatījuma tokenu, kad tas starpnieko priekšskatījuma pieprasījumus.

## Tīrīšana un dzīves cikls

Lai dzēstu smilškastes, kad Termbridge tiek aizvērts:

```bash
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true
```

Īslaicīgām vai testa smilškastēm izmantojiet prefiksu:

```bash
export TERMBRIDGE_SANDBOX_NAME=termbridge-test-$(date +%s)
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true
```

Tādējādi smilškastes lietojums paliek kontrolējams un tiek novērstas diska kvotas problēmas.

## CLI karodziņi

Varat konfigurēt Daytona arī ar karodziņiem. Karodziņam ir priekšroka pār atbilstošo vides mainīgo.

| Karodziņš | Vides mainīgais | Nolūks |
| --- | --- | --- |
| `--backend sandbox-daytona` | `TERMBRIDGE_BACKEND` | Izmantot Daytona aizmugursistēmu |
| `--sandbox-repo <url>` | `TERMBRIDGE_SANDBOX_REPO` | Repozitorija URL |
| `--sandbox-branch <branch>` | `TERMBRIDGE_SANDBOX_BRANCH` | Atzars |
| `--sandbox-path <path>` | `TERMBRIDGE_SANDBOX_PATH` | Repozitorija ceļš smilškastē |
| `--sandbox-name <name>` | `TERMBRIDGE_SANDBOX_NAME` | Smilškastes nosaukums |
| `--sandbox-preview-port <port>` | `TERMBRIDGE_SANDBOX_PREVIEW_PORT` | Priekšskatījuma ports |
| `--sandbox-public` | `TERMBRIDGE_SANDBOX_PUBLIC=true` | Izveidot publisku smilškasti |
| `--sandbox-direct` | `TERMBRIDGE_SANDBOX_DIRECT=true` | Palaist serveri smilškastē (bez tuneļa) |

Privātai smilškastei nav karodziņa; izmantojiet `TERMBRIDGE_SANDBOX_PUBLIC=false`. Iebūvētajā `termbridge --help` izvadē joprojām tiek rādīti `--daytona-*` nosaukumi un `--backend daytona`, kas tiek noraidīti ([#1](https://github.com/inline0/termbridge/issues/1)).

## Problēmu novēršana

**Priekšskatījuma skats ir tukšs**
- Pārliecinieties, ka izstrādes serveris darbojas smilškastē.
- Izmantojiet `--host 0.0.0.0`, lai priekšskatījuma ports būtu sasniedzams.
- Pārbaudiet, vai `TERMBRIDGE_SANDBOX_PREVIEW_PORT` atbilst izstrādes servera portam.

**Smilškasti neizdodas izveidot kvotas kļūdu dēļ**
- Izdzēsiet vecās smilškastes Daytona informācijas panelī.
- Īslaicīgām sesijām izmantojiet `TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true`.

**Neizdodas klonēt repozitoriju**
- Vēlreiz pārbaudiet repozitorija URL, atzaru un akreditācijas datus.
- Pārliecinieties, ka tokenam Git ir repozitorija lasīšanas piekļuve.