Liigu sisu juurde

Arendus

Vaata Markdownina Muuda teenuses GitHub Dokumentatsioon: 1675df8

Nõuded

  • Bun tööruumi paigalduste ja skriptide jaoks
  • Node.js 20+
  • tmux ja cloudflared läbivateks testideks
  • Daytona API võti ja git-mandaadid liivakasti integratsioonitestiks (valikuline)
  • Playwright UI läbivate testide jaoks

Paigaldamine

Shell
bun install

Rakenduse käivitamine

Shell
bun run dev:beam

See loob CLIi järgu, käivitab kohaliku serveri pordil 8787 (muutmiseks kasutage TERMBRIDGE_DEV_PORT) seansi tmux codex-ga (muutmiseks kasutage TERMBRIDGE_DEV_SESSION) ning käivitab Vitei arenduse UI-i, mis suunab /__tb (sh WebSocketid) sellesse serverisse. Väljundis kuvatakse arenduskeskkonna lunastamis-URL, mille saate brauseris avada. Jätke CLIi järk vahele, määrates TERMBRIDGE_SKIP_BUILD=1.

Mitu seanssi

Shell
TERMBRIDGE_SESSIONS=2 bun run dev:beam

Või kasutage otseteed:

Shell
bun run dev:beam:multi

dev:beam määrab väärtuseks TERMBRIDGE_INSECURE_COOKIE=1, kui te pole seda ise määranud, nii et seansiküpsised töötavad tavalise HTTP kaudu. Kui käivitate CLIi otse ilma HTTPS-ta, määrake see sõnaselgelt:

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

Testid

Shell
bun run test
  • test:mocked käivitab ühik- ja integratsioonitestid 100% katvusega.
  • test:cli käivitab päris CLI + UI läbivad testid (tmux + cloudflared + Playwright).
  • test:clii Daytona liivakastitest loeb seaded ainult termbridge-test-app-kataloogis selle hoidla kõrval olevast .env-failist (../termbridge-test-app/.env). Test käivitub, kui failis on määratud TERMBRIDGE_E2E_DAYTONA=1 ja TERMBRIDGE_DAYTONA_API_KEY. Määrake seal TERMBRIDGE_SANDBOX_REPO hoidla, mida saab kloonida; vaikimisi testhoidla on privaatne ning vajab ka TERMBRIDGE_SANDBOX_GIT_USERNAME ja TERMBRIDGE_SANDBOX_GIT_TOKEN.

Dokumentatsioon

Dokumentatsioon koosneb tavalistest Markdown-failidest kataloogis docs/, iga lehe päises on frontmatter ning navigeerimisjärjestuse määravad meta.json-failid. See avaldatakse aadressil termbridge.dev. Valideerige see käsuga:

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

Dokumentatsiooni sisu töövoog käivitab sama kontrolli tõmbetaotlustel, mis muudavad docs/-i.