Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

term7-dev

/term7-dev

Podpowiada, jak zbudować, przetestować i sprawdzić zmiany w aplikacji term7 na Tauri 2 i Vue 3 oraz jej zasady kodu.

Repozytorium
term7 ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Podpowiada, jak zbudować, przetestować i sprawdzić zmiany w aplikacji term7 na Tauri 2 i Vue 3 oraz jej zasady kodu.

Wyzwalacze z opisu

fix thisadd Xcompilaroda os testesvalida a mudançagera o .debinstala pra testarcargo check
Oryginalny opis (EN)

How to build, test and validate a change in term7 (Tauri 2 + Vue 3/TypeScript + xterm.js), plus the code conventions to follow when editing src/ or src-tauri/. Use whenever you change code in this repo, need to compile, run tests, type-check, run cargo check/test/clippy, build the .deb, install it locally or try the app — even if the user only says "fix this" or "add X". Gatilhos em português: "compila", "roda os testes", "valida a mudança", "gera o .deb", "instala pra testar", "cargo check", "testar no app", "mexer no Rust/Vue".

Jak działa

  1. Validar uma mudança
  2. Testar o app de verdade
  3. Convenções que importam ao editar
Sekcje z nagłówków SKILL.md, w oryginale · 58 linii, 481 słów
Podgląd SKILL.md
---
name: term7-dev
description: >
  How to build, test and validate a change in term7 (Tauri 2 + Vue 3/TypeScript + xterm.js), plus the code
  conventions to follow when editing src/ or src-tauri/. Use whenever you change code in this repo, need to
  compile, run tests, type-check, run cargo check/test/clippy, build the .deb, install it locally or try the
  app — even if the user only says "fix this" or "add X". Gatilhos em português: "compila", "roda os testes",
  "valida a mudança", "gera o .deb", "instala pra testar", "cargo check", "testar no app", "mexer no Rust/Vue".
---

# Desenvolvendo no term7

## Validar uma mudança

Rode tudo isto antes de dar a mudança por pronta. O CI compila o `.deb` no PR, mas warnings e testes são
responsabilidade de quem muda.

```sh
npm run build        # vue-tsc --noEmit + vite build; obrigatório depois de mexer em src/
npm test             # testes do frontend (vitest)

# Rust: sempre pelo container (o ambiente de referência não tem Rust instalado)
docker compose run --rm --no-deps dev bash -c "cd src-tauri && cargo check"
docker compose run --rm --no-deps dev bash -c "cd src-tauri && cargo test"
# clippy: o rustup do container é o perfil minimal, sem o clippy
docker compose run --rm --no-deps dev bash -c "cd src-tauri && rustup component add clippy && cargo clippy"
```

- `cargo check` precisa passar **sem warnings**, não só sem erros.
- Os testes Rust ficam no próprio arquivo, em `#[cfg(test)] mod tests`, com nomes em português
  (ex.: `fn pasta_do_projeto()`). Siga o mesmo padrão.
- Se `npm test` ainda não existir no `package.json`, avise em vez de inventar outro comando.

## Testar o app de verdade

Interação (digitar, clicar, desempenho) se testa no app instalado, não no Docker:

```sh
docker compose run --rm build     # gera o .deb em dist-deb/ (mesmo Ubuntu 24.04 do CI)
scripts/install-local.sh          # instala em ~/.local, sem sudo (--remove desinstala)
~/.local/bin/term7
```

`docker compose run --rm dev` abre a interface, mas o container não tem GPU: tudo fica lento e o
xterm.js com WebGL não se comporta como no app real. Use o Docker só pra compilar.
Quem tem Rust e as libs do Tauri na máquina pode usar `npm run tauri dev` (hot reload).

## Convenções que importam ao editar

- **Comandos Tauri que fazem I/O ou chamam processos** (git, gh, arquivos, `/proc`) são `async` e usam
  `spawn_blocking`: comando síncrono roda na thread da janela e trava a interface.
- **Comando Tauri novo:** registre em `src-tauri/src/lib.rs`; permissões de janela em
  `src-tauri/capabilities/default.json`.
- **Saída do PTY** vai como bytes brutos (`InvokeResponseBody::Raw`), nunca JSON.
- **`gh`** precisa funcionar com a versão 2.4 (Ubuntu 22.04): sem `run list --branch` nem `workflowName`.
  Consultas ao GitHub são espaçadas (60 s; 15 s com action rodando).
- **Git em polling** usa `GIT_OPTIONAL_LOCKS=0`, pra não disputar o `index.lock` com o usuário.
- **Botões que não devem roubar o foco do terminal** usam `@mousedown.prevent`.
- **TypeScript fica em `~5.9`**: o `vue-tsc` não suporta o 7. Não suba essa dependência.
- O `identifier` (`br.tec.code7.term7`) e o `StartupWMClass` de `src-tauri/term7.desktop` precisam
  continuar iguais (é por ele que o Wayland identifica a janela).
- **Idioma:** comentários, textos da interface e docs em português do Brasil, com acentuação;
  identificadores em inglês. Comentários curtos que explicam o *porquê*, nunca repetem o código.

A estrutura de pastas e o papel de cada arquivo estão no `CLAUDE.md` da raiz. Se a mudança mexe com
GitHub ou Claude Code, veja também a skill `term7-integrations`.

Wersje

W bazie nie ma innych skilli o nazwie term7-dev.

Migawka bazy z 13.11.2026 · wersja paczki 0a63ae1c5d45 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100oats-tauri
    Pomaga zmieniać backend oats w Rust: polecenia w src-tauri, kontrakt invoke, uprawnienia, wtyczki Tauri, wiele okien i testy cargo z obejściami dla macOS.
  • 100tauri-desktop-app-engineering
    Opisuje, jak budować i wysyłać wieloplatformową aplikację Tauri z interfejsem React, Rustem i testami cargo.
  • 100dev
    Opisuje lokalne budowanie, instalowanie, testowanie i uruchamianie CLI, serwera, aplikacji mobilnej i desktopowej (Tauri) w monorepo Happy.
  • 100rust-tauri-backend
    Wdraża i zmienia backend Tauri v2 w Rust i most do frontendu: polecenia, zdarzenia IPC, menu, uprawnienia, okna i system plików.
  • 100screenpipe-tauri
    Dodaje i zmienia komendy Tauri oraz bindingi TypeScript w aplikacji desktopowej screenpipe, w tym typy Rust eksportowane do frontendu.
  • 100run-tests
    Uruchamia testy, clippy i sprawdzenie formatowania w projekcie Rust, żeby potwierdzić poprawność zmian przed zatwierdzeniem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.