Repository navigation
th 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 | 中文
ขอบคุณที่ช่วยเหลือ! COPG-VD ถูกออกแบบมาให้ร่วมพัฒนาได้ง่าย คู่มือนี้บอกคุณว่า สิ่งต่าง ๆ อยู่ที่ไหนและธรรมเนียมไม่กี่อย่างที่เราปฏิบัติตาม
COPG-VD เป็น ตัวปลอมอุปกรณ์ Zygisk (Zygisk device spoofer): ไลบรารี native ขนาดเล็กที่ถูกฉีด เข้าไปในโปรเซสของแอปเพื่อเขียนลายนิ้วมือและ build ของอุปกรณ์ใหม่ บวกกับ WebUI แบบ vanilla-JS เพื่อขับเคลื่อน มัน มันเป็นฟอร์กของ COPG (โดย AlirezaParsi) ดูแลรักษาโดย VD171 ภายใต้ใบอนุญาต Apache-2.0 ดู ARCHITECTURE.md และ FILE-STRUCTURE.md
โดยค่าเริ่มต้นมันจำกัดขอบเขตการปลอมไว้ที่สแตก Google Play ผ่าน Zygisk ดังนั้นมันจึงเป็น ทางเลือกที่เบากว่าและทนทานกว่า PlayIntegrityFix
ผู้ช่วยและเอเจนต์ AI เป็นผู้ร่วมพัฒนาชั้นหนึ่งที่นี่ ไม่ใช่สิ่งที่คิดทีหลัง
- โครงการถูกสร้างมาให้อ่านง่าย: การตั้งค่าเป็นไฟล์ JSON ไฟล์เดียว
(
/data/adb/COPG-VD/COPG-VD.jsonมีเอกสารใน CONFIGURATION.md) เครื่องยนต์มีขนาดเล็กและอยู่ในตัวเอง และโครงสร้างอยู่ใน FILE-STRUCTURE.md - แพตช์ที่ช่วยเหลือโดย AI ถูกตรวจสอบและยอมรับในเงื่อนไขเดียวกับตัวอื่น: โดย ความถูกต้อง ความชัดเจน และธรรมเนียมด้านล่าง ไม่ใช่โดยใคร (หรือสิ่งใด) เขียนมัน
- มาตรฐานเดียวกันสำหรับทุกคน: ฟีเจอร์จริงไม่เคยถูกทำให้อ่อนลง การปลอมคงความสอดคล้อง และ ไม่มีอะไรที่เป็นความลับหรือเฉพาะอุปกรณ์เข้าสู่ repo (ดู .gitignore)
- คุณต้องมีอุปกรณ์ที่ root แล้วหรือ emulator ที่มี Zygisk (KernelSU, APatch หรือ Magisk) เพื่อทดสอบ
- Build ไลบรารี native ต่อ ABI ด้วย NDK (r29) และ CMake: ดูขั้นตอน
Build zygisk librariesใน.github/workflows/COPG-VD.ymlสำหรับ คำสั่งที่แน่นอน CI build ทั้งสาม ABI ให้คุณ - Build zip ที่แฟลชได้: คัดลอก
libspoof.soที่ build แล้วไปยังmodule/zygisk/<abi>.soจากนั้นcd module && zip -r9 ../COPG-VD-dev.zip .แล้วแฟลชมัน - WebUI คือ
module/webroot/(เปิดจากตัวจัดการ root) ตรรกะการปลอมคือzygisk/spoof_module.cpp; ตัวดึงโปรไฟล์คือmodule/fingerprint-update.sh
-
ทุกไฟล์ซอร์สของโมดูล (
.cpp,.sh,.js,.css,.html) เริ่มด้วย ส่วนหัวแบนเนอร์ของโครงการ (คัดลอกจากไฟล์ที่มีอยู่) เครื่องมือภายใต้.github/ใช้ คอมเมนต์สั้น ๆ แทน - โค้ดและคอมเมนต์เป็นภาษาอังกฤษ เก็บคอมเมนต์ให้น้อยที่สุดและเฉพาะที่จำเป็น
-
ห้าม em-dash หรือ en-dash; ใช้ hyphen ธรรมดา
-เสมอ - WebUI เป็น vanilla JS (
scripts.jsไฟล์เดียว); ไม่มี framework - ห้ามทำให้อ่อนลง ฟีเจอร์จริง: คงการปลอมให้สอดคล้อง และอย่าทำให้ hook ทำให้แอปที่มันติดอยู่ล่ม (พวกมันถูกตรวจสอบ null โดยเจตนา)
- สตริง UI อยู่ใน
module/webroot/lang/ภาษาอังกฤษเป็นค่าสำรองหลัก (en.js+en.json); อีก 20 ภาษาคือ<code>.json - ในการเพิ่มหรือเปลี่ยนสตริง: แก้
en.jsและen.jsonจากนั้นอัปเดตทุก<code>.jsonการแตะป้ายที่มองเห็นได้หมายถึงการอัปเดตไฟล์ภาษา ทั้งหมด และREADME.<code>.mdทั้งหมด - การแปลเป็น JSON ธรรมดา: เป็นการร่วมพัฒนาครั้งแรกที่ดีเยี่ยม
- เก็บ PR ให้เน้นประเด็น อธิบายว่าอะไรและทำไม
- Sign off commit ของคุณ (DCO):
git commit -s(เพิ่มSigned-off-by:) - CI ต้องคงเขียว ใจดีในการรีวิว: ดู CODE_OF_CONDUCT.md
มองหาป้าย good first issue และ help wanted การแปล เอกสาร และ
โปรไฟล์ Pixel ใหม่ ล้วนเป็นจุดเริ่มต้นที่ดีเยี่ยม
เอกสารนี้สร้างขึ้นด้วย Claude (Anthropic) และดูแลโดย VD171 ยินดีรับการแก้ไขและการปรับปรุง ดู CONTRIBUTING.md