Repository navigation
cs CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Díky za pomoc! COPG-VD má být snadný k přispívání. Tato příručka vám řekne, kde co leží, a těch pár konvencí, které dodržujeme.
COPG-VD je Zygisk spoofer zařízení: malá nativní knihovna, která je injektována do procesů aplikací, aby přepsala otisk zařízení a build, plus vanilla-JS WebUI pro jeho ovládání. Je to fork COPG (od AlirezaParsi), udržovaný VD171 pod licencí Apache-2.0. Viz ARCHITECTURE.md a FILE-STRUCTURE.md.
Ve výchozím stavu omezuje spoof na stack Google Play přes Zygisk, takže je to lehčí, robustnější alternativa k PlayIntegrityFix.
AI asistenti a agenti jsou zde prvotřídní přispěvatelé, ne dodatečný nápad.
- Projekt je postaven tak, aby byl čitelný: konfigurace je jediný JSON soubor
(
/data/adb/COPG-VD/COPG-VD.json, dokumentovaný v CONFIGURATION.md), enginy jsou malé a soběstačné a rozvržení je v FILE-STRUCTURE.md. - Patche s pomocí AI jsou posuzovány a přijímány za stejných podmínek jako jakékoli jiné - podle správnosti, srozumitelnosti a konvencí níže, ne podle toho, kdo (nebo co) je napsal.
- Stejná laťka pro všechny: skutečná funkce se nikdy neoslabuje, spoof zůstává koherentní a nic tajného nebo specifického pro zařízení nepřistane v repozitáři (viz .gitignore).
- Pro testování potřebujete rootnuté zařízení nebo emulátor se Zygiskem (KernelSU, APatch nebo Magisk).
- Sestavte nativní knihovnu per ABI pomocí NDK (r29) a CMake: přesný příkaz viz krok
Build zygisk librariesv.github/workflows/COPG-VD.yml. CI sestaví všechny tři ABI za vás. - Sestavte flashovatelný zip: zkopírujte sestavené
libspoof.sodomodule/zygisk/<abi>.so, pakcd module && zip -r9 ../COPG-VD-dev.zip .a nahrajte jej. - WebUI je
module/webroot/(otevřete jej z root manageru). Logika spoofingu jezygisk/spoof_module.cpp; stahovač profilu jemodule/fingerprint-update.sh.
-
Každý zdrojový soubor modulu (
.cpp,.sh,.js,.css,.html) začíná hlavičkou s bannerem projektu (zkopírujte ji z libovolného existujícího souboru). Nástroje pod.github/používají místo toho krátký komentář. - Kód a komentáře anglicky. Udržujte komentáře minimální a jen tam, kde je potřeba.
-
Žádný em-dash ani en-dash; vždy používejte prostou pomlčku
-. - WebUI je vanilla JS (jeden
scripts.js); žádné frameworky. - Nikdy neoslabujte skutečnou funkci: udržujte spoof koherentní a nenechte hooky shodit aplikaci, ke které jsou připojeny (mají záměrně kontrolu na null).
- Řetězce UI leží v
module/webroot/lang/. Angličtina je kanonický fallback (en.js+en.json); ostatních 20 jazyků je<code>.json. - Pro přidání nebo změnu řetězce: upravte
en.jsaen.json, pak aktualizujte každý<code>.json. Dotknout se viditelného popisku znamená aktualizovat všechny jazykové soubory a všechnyREADME.<code>.md. - Překlady jsou prostý JSON: skvělý první příspěvek.
- Udržujte PR zaměřené. Popište co a proč.
- Podepište své commity (DCO):
git commit -s(přidáSigned-off-by:). - CI musí zůstat zelené. Buďte laskaví v recenzích: viz CODE_OF_CONDUCT.md.
Hledejte štítky good first issue a help wanted. Překlady, dokumentace a nové profily
Pixelů jsou skvělé výchozí body.
Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.