Pāriet uz saturu

Izstrāde

Skatīt kā Markdown Rediģēt vietnē GitHub Dokumentācija vietnē 1675df8

Prasības

  • Bun darbvietas instalācijām un skriptiem
  • Node.js 20+
  • tmux un cloudflared pilna cikla testiem
  • Daytona API atslēga + git akreditācijas dati smilškastes integrācijas testam (neobligāti)
  • Playwright UI pilna cikla testiem

Instalēšana

Apvalks
bun install

Palaidiet lietotni

Apvalks
bun run dev:beam

Tiek izveidots CLI, palaists lokālais serveris portā 8787 (to var mainīt ar TERMBRIDGE_DEV_PORT) ar tmux sesiju codex (to var mainīt ar TERMBRIDGE_DEV_SESSION), kā arī palaists Vite izstrādes UI, kas novirza /__tb (tostarp WebSockets) uz šo serveri. Tiek parādīts izstrādes redeem URL, ko atvērt pārlūkprogrammā. Iestatiet TERMBRIDGE_SKIP_BUILD=1, lai izlaistu CLI būvēšanu.

Vairākas sesijas

Apvalks
TERMBRIDGE_SESSIONS=2 bun run dev:beam

Vai arī izmantojiet saīsni:

Apvalks
bun run dev:beam:multi

dev:beam iestata TERMBRIDGE_INSECURE_COOKIE=1, ja vien to neiestatāt paši, lai sesijas sīkdatnes darbotos, izmantojot parastu HTTP. Ja palaižat CLI tieši bez HTTPS, iestatiet to skaidri:

Apvalks
TERMBRIDGE_INSECURE_COOKIE=1 node cli/dist/bin.js --no-tunnel --public-url http://127.0.0.1:8080 --port 8080

Testi

Apvalks
bun run test
  • test:mocked palaiž vienību un integrācijas testus ar 100% pārklājumu.
  • test:cli palaiž reālus CLI + UI pilna cikla testus (tmux + cloudflared + Playwright).
  • Daytona smilškastes tests test:cli nolasa iestatījumus tikai no .env faila termbridge-test-app direktorijā blakus šim repozitorijam (../termbridge-test-app/.env). Tas tiek palaists, ja šajā failā ir iestatīti TERMBRIDGE_E2E_DAYTONA=1 un TERMBRIDGE_DAYTONA_API_KEY. Norādiet tajā TERMBRIDGE_SANDBOX_REPO repozitoriju, ko varat klonēt; noklusējuma testa repozitorijs ir privāts, un tam nepieciešami arī TERMBRIDGE_SANDBOX_GIT_USERNAME un TERMBRIDGE_SANDBOX_GIT_TOKEN.

Dokumentācija

Dokumentācijas saturs ir vienkārši Markdown faili mapē docs/; katrai lapai ir priekšējie metadati, bet meta.json faili nosaka navigācijas secību. Dokumentācija ir publicēta vietnē termbridge.dev. Validējiet to ar:

Apvalks
node scripts/check-docs-content.mjs --root docs --expected-docs 16 --expected-nav 3

Dokumentācijas satura darbplūsma veic to pašu pārbaudi pieprasījumos, kas skar docs/.