Skip to content

cs CONTRIBUTING

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Přispívání do VD Dropbear

Díky za tvůj zájem. Tohle je malý projekt citlivý na bezpečnost (rozdává root), takže se změny posuzují s ohledem na to.

Rozvržení repozitáře

module/     the installable KernelSU / APatch / Magisk module (scripts, WebUI, config, installer)
patches/    the patch set applied on top of upstream Dropbear (the only changes to the SSH server)
src/        where CI unpacks upstream Dropbear to build (not committed)
scripts/    build and maintenance helpers
.github/    CI workflows and issue/PR templates
docs/       documentation (mirrored to the wiki)

Sestavení

Binárku produkuje CI z upstreamového mkj/dropbear plus záplat v patches/. Pro lokální sestavení potřebuješ Android NDK:

scripts/build.sh            # fetches the tracked upstream, applies patches, builds arm64 + arm32

Sada záplat je záměrně minimální a auditovatelná: neutrální/konfigurovatelný identifikační řetězec, konfigurací řízené cesty pro authorized_keys a soubor s heslem, oprava openpty pro Android a běhová konfigurace. Nové záplaty prosím udržuj malé, zdokumentované a v PR zdůvodněné.

Pull requesty

  • Jedna logická změna na jeden PR; popiš motivaci a bezpečnostní dopad.
  • Drž se stávajícího stylu shellu (POSIX sh / Android mksh; žádné bashismy).
  • Každý soubor nese krátkou hlavičku SPDX. Zachovej ji.
  • Aktualizuj CHANGELOG.md pod [Unreleased] u každé reálné změny viditelné pro uživatele.
  • Odesláním PR souhlasíš s licencováním svého příspěvku pod licencí projektu Apache-2.0.

Překlady

README a dokumentace se udržují v mnoha jazycích (README.<lang>.md). Zdrojem pravdy je angličtina; překlady ji následují. Pokud vylepšíš překlad nebo přidáš jazyk, zachovej strukturu a kotvy sekcí shodné s anglickou verzí.

Hlášení chyb a bezpečnostních problémů

Pro chyby a žádosti o funkce použij šablony issue. U čehokoli, co by mohlo ohrozit zařízení, se řiď souborem SECURITY.md a nahlas to soukromě místo otevření veřejného issue.


Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.

Clone this wiki locally