Mengunduh Ford Service Manuals versi HTML dan PDF dari PTS.
Membeli langganan manual servis Ford selama 72 jam dan ingin menyimpannya secara permanen? Ini repo untuk Anda.
Panduan ini merupakan hak cipta Ford, jadi jangan dibagikan!
Agar ini berfungsi saat ini memerlukan pengetahuan tentang DevTools browser. Jika Anda tidak yakin bagaimana cara menggunakannya, tanyakan pada teman yang tahu.
Skrip ini menggunakan playwright , pustaka interop browser tanpa kepala, untuk menyimpan dokumen sebagai file PDF, bukan HTML mentah (dengan cara ini file menyertakan gambar).
Meskipun skrip ini telah diverifikasi untuk bekerja pada Windows secara asli (lihat edisi #6), disarankan untuk menjalankannya di WSL. Berjalan di WSL membuat instalasi hal-hal seperti Git dan Node menjadi jauh lebih mudah.
WSL adalah cara untuk menjalankan Linux (Ubuntu direkomendasikan untuk proyek ini) bersama-sama dengan Windows. Ini jauh lebih cepat daripada mesin virtual tetapi masih menggunakan kernel Linux yang sebenarnya. Pelajari lebih lanjut dan lihat petunjuk pemasangan di sini.
corepack )corepack enablegit clone https://github.com/iamtheyammer/fetch-ford-service-manuals.git , dan masuk ke direktori repositori (kemungkinan dengan cd fetch-ford-service-manuals )git pull untuk mendapatkan informasi terbaru!git pull tidak mengatakan Already up to date. , jalankan 2 langkah berikutnya untuk memastikan dependensi Anda mutakhir.git stash , git pull , lalu git stash apply untuk menghapus simpanan file Anda.yarn untuk mengunduh dependensiyarn playwright-setup untuk mengunduh dan mengatur PlaywrightPetunjuk ini ditujukan untuk browser berbasis Chrome atau Chrome.
templates/ , buat salinan cookieString.txt.template , dan beri nama cookieString.txtcookieString.txttemplates/ , buat salinan params.json.template , dan beri nama params.json .Jika kendaraan Anda dibuat SEBELUM tahun 2003, gunakan petunjuk berikut.
Skrip ini memerlukan beberapa data tentang mobil Anda yang tidak tersedia di GUI PTS untuk mengambil manual yang benar.
https://www.fordservicecontent.com/Ford_Content/PublicationRuntimeRefreshPTS//publication/prod_1_3_372022/TreeAndCover/workshop/32/~WSLL/{some numbers here} . Seharusnya terlihat serupa dengan permintaan di foto ini.templates/params.json , dan salin/tempel informasi dari permintaan tersebut ke dalam nilai bidang JSON .workshop .Jika kendaraan Anda dibuat PADA TAHUN 2003 atau KEMUDIAN, gunakan petunjuk berikut.
templates/params.json , dan ubah saja:workshop.modelYear ke tahun mobil Andapre_2003.alphabeticalIndexURL ke URL yang Anda salin pada langkah 2https://www.fordservicecontent.com/Ford_Content/PublicationRuntimeRefreshPTS//wiring/TableofContent (ada parameter kueri di bagian akhir, tidak apa-apa). Seharusnya terlihat serupa dengan permintaan di foto ini.TableOfContent , bukan TableOfContent senvironment , bookType , dan languageCode ke .wiring di params.json .WiringBookTitle atau WiringBookCode masih hilang, Anda mungkin perlu memilih, Anda mungkin perlu memilih manual pengkabelan. Setelah memilih manual, Anda akan menemukannya dalam permintaan lain ke https://www.fordtechservice.dealerconnection.com/wiring/TableOfContents (dengan beberapa parameter kueri di akhir):booktitle → WiringBookTitlebook → WiringBookCodeparams.json sebaik mungkin.params.json .cookieString.txt.template bernama cookieString.txt jika Anda belum melakukannya.https://www.fordtechservice.dealerconnection.com/wiring/TableOfContents (ada parameter kueri di bagian akhir, tidak apa-apa).TableOfContent s , bukan TableOfContentcookieString.txt .cookieString.txt tidak boleh menyertakan Cookie: , misalnya.)cookieString.txt . Untuk mengunduh manual sebagai PDF, jalankan yarn start -c templates/params.json -s templates/cookieString.txt -o /directory/where/you/want/the/downloaded/manual/ . Anda akan melihat keluaran seperti ini.
Sebelum manual mulai diunduh, bot akan memvalidasi bahwa cookie Anda telah diatur dengan benar dengan mencoba membuka situs PTS di latar belakang. Meskipun Anda dapat melewati pemeriksaan ini, ada kemungkinan besar melewatkannya (dengan --noCookieTest ) akan mengakibatkan kesalahan di kemudian hari.
Pastikan direktori manual yang diunduh kosong-- direktori tersebut mempunyai banyak subfolder.
Anda bisa mendapatkan lebih banyak informasi param dengan menjalankan yarn start --help . Khususnya, --saveHTML akan menyimpan file .html bersama dengan file .pdf yang diunduh secara default, dan --ignoreSaveErrors akan terus mengunduh manual jika terjadi kesalahan, melewatkan file yang mengalami kesalahan.
Ini bisa memakan waktu cukup lama! Pada komputer cepat dengan koneksi internet cepat, dan, yang lebih penting, disk drive cepat, lebih dari 15 menit untuk mengunduh manual Taurus 2005. Bersabarlah!
Selain itu, folder yang dihasilkan cukup besar. Folder untuk Taurus 2005 berukuran sekitar 300MB, dan folder F150 berukuran beberapa gigabyte.
Mengalami masalah? Lihat Masalah Umum atau FAQ.
Bot ini mengunduh seluruh manual bengkel dan semua diagram pengkabelan untuk kendaraan yang Anda siapkan.
Diagram pengkabelan akan berada di outputpath/Wiring . Ada juga file toc.json dengan daftar isi diagram pengkabelan.
Jika Anda memiliki folder Wiring/Connector Views , Anda memiliki file khusus di sana: Connectors.csv . Ini memberi tahu Anda di mana menemukan setiap konektor di mobil, dan di mana letaknya di Bagan Lokasi Komponen. Buka di Excel atau Google Sheets untuk melihat datanya. Berikut ini contoh singkatnya:
| ID Konektor | Konektor | Lokasi Konektor Melihat Nomor Halaman | Referensi Jaringan | Lokasi di Kendaraan |
|---|---|---|---|---|
| Bab 168A | Transmisi 10R80 (2,7L) | 29 | F5 | Penularan |
| Bab 1840 | Solenoida Kontrol Tekanan Saluran (LPC). | 34 | E8 | Transmisi bagian dalam |
Wiring/Connector Location Views ) Struktur folder di direktori keluaran akan meniru struktur di PTS, jadi jika file memiliki path seperti 1: General Information -> 00: Service Information -> 100-00 General Information -> About this Manual , maka akan berada di folder outputpath/1: General Information/00: Service Information/100-00 General Information/About this Manual.pdf .
File cover.html berisi sampul buku dan daftar isi yang disusun dalam poin-poin. Pohon poin-poin tersebut secara langsung dipetakan ke struktur file manual yang diunduh. Perhatikan bahwa beberapa karakter tidak diperbolehkan dalam nama file/folder, jadi karakter seperti garis miring, titik dua, dan lainnya diganti dengan tanda hubung saat menyimpan.
File toc.json berisi daftar isi yang dapat dibaca komputer, dengan nama yang dipetakan ke "nomor dokumen", yang digunakan untuk mengambil PDF.
Kebanyakan sistem operasi membatasi nama file hingga 255 byte (bukan 255 karakter). Untuk nama file lebih dari 200 karakter (yang cukup jarang terjadi), pengunduh akan memotong namanya, lalu menambahkan (docID truncated) di bagian akhir.
Jika Anda kesulitan menemukan dokumen dengan nama panjang, cari di toc.json , yang akan berisi kunci dengan nilai. Nilai tersebut adalah docID yang akan ada di nama file.
Kendaraan dari tahun 2002 atau lebih tua memiliki struktur berbeda yang lebih sulit diambil di manual, jadi alat ini hanya menggunakan indeks alfabet. Ini berarti keluarannya sedikit berbeda; Anda cukup mendapatkan struktur datar dengan semua halaman dalam manual di folder keluaran yang Anda tentukan.
Anda dapat dengan mudah menelusuri manual dengan membuka outputpath/AA_Table_Of_Contents.html -- semua tautan berfungsi kecuali huruf di atas.
Ada juga beberapa file khusus:
AA_Table_Of_Contents.html adalah daftar isi khusus yang diproses tempat semua tautan berfungsi! Buka di browser Anda untuk menavigasi manual.AAA_alphabeticalIndex.json adalah file JSON dengan semua tautan dalam indeks abjad. Ini tidak berguna seperti daftar isi, tapi ada jika Anda membutuhkannya. Itu adalah hasil dari pemrosesan skrip.AAA_originalTableOfContents.html adalah daftar isi asli, jadi linknya tidak berfungsi. Itu ada di sana jika Anda membutuhkannya. Itu adalah hasil dari pemrosesan skrip. File-file ini diawali dengan AAA sehingga muncul di bagian atas daftar file di sebagian besar browser file.
Saat skrip dimulai, skrip mencoba masuk ke PTS untuk memverifikasi bahwa cookie Anda berfungsi. Jika gagal, Anda mungkin tidak dapat mengambil manual.
Cobalah untuk mengumpulkan kembali cookie dan pastikan Anda menggunakan cookie yang benar. Jika Anda 100% yakin bahwa cookie Anda benar, Anda dapat menambahkan --noCookieTest ke perintah.
Sepertinya langganan Anda sudah habis masa berlakunya. Anda harus memperbaruinya untuk mengunduh manual.
Pemeriksaan ini juga dapat dilewati dengan --noCookieTest , tetapi tanpa berlangganan Anda tidak akan dapat mengunduh manualnya.
... tidak ditemukan dalam string cookie. Hal ini dapat mempengaruhi fungsionalitas.Skrip secara otomatis memeriksa file cookie Anda terhadap daftar cookie yang diharapkan. Jika tidak dapat menemukan salah satu cookie yang diharapkan, ia akan memperingatkan Anda (perhatikan bahwa bot tidak berhenti jika cookie ini dicetak).
Jika Anda melihat pesan ini dan skrip mulai mengunduh manual, biarkan saja-- itu hanya peringatan. Jika Anda melihat pesan tersebut dan semuanya terunduh dengan baik, silakan buka masalah GitHub sehingga saya dapat memperbaikinya untuk orang lain.
Jika Anda mengalami masalah, coba kumpulkan kembali cookie Anda.
ERR_HTTP2_PROTOCOL_ERRORHal ini dapat berarti bahwa cookie Anda tidak valid atau Ford (sebenarnya Akamai) telah mendeteksi bahwa kami menggunakan browser tanpa kepala (Penulis Drama).
Pertama, coba kumpulkan kembali cookie Anda dan coba lagi. Jika Anda masih mengalami masalah, hubungi.
ERR_BAD_RESPONSE Ini biasanya berarti salah satu kolom di file params.json Anda salah. Periksa apakah semua bidang sudah benar, dan jika Anda masih mengalami masalah, buka masalah GitHub. (Hal ini terkadang terjadi saat Ford memperbarui situs mereka.)
Semua yang sudah saya uji. Hanya untuk bersenang-senang, saya mencoba:
Semua bekerja dengan sempurna!
Untuk mengumpulkan kembali cookie, ikuti instruksi dalam rangkaian instruksi ini, pastikan Anda:
Cookie: bagian header, jika Anda menyalinnyaRaw di kanan atas Request Headers; antara pasta pertama dan pasta keduaJika Anda masih mengalami masalah, hubungi.
Mungkin! Kami telah meraih kesuksesan di seluruh Amerika Utara, Amerika Selatan, Eropa, dan Australia.
Meskipun skripnya dalam bahasa Inggris (artinya semua pesan yang dicetak akan dalam bahasa Inggris), skrip tersebut akan mengunduh manual dalam bahasa yang ditentukan di params.json . Perhatikan bahwa Ford harus menyediakan manual dalam bahasa yang diminta.
Untuk mengunduh manual dalam bahasa tertentu, ubah bahasa PTS Anda , kumpulkan kembali semua parameter, dan jalankan pengunduhan lagi.
Karena Ford terus mengubah cara mengakses manual, proyek ini memerlukan pemeliharaan berkelanjutan.
Jika proyek ini bermanfaat bagi Anda, Anda dapat mendukung proyek ini melalui sponsor GitHub (klik tombol "Sponsor" di bagian atas halaman), belikan saya kopi, atau cukup bagikan!
Kontribusi melalui permintaan tarik juga sangat disambut baik. Untuk peluang tertinggi agar PR Anda digabungkan, silakan:
node_modules )yarn format sebelum dikirimkan untuk memudahkan peninjauanIni bukan persyaratan-- Saya selalu dapat membantu Anda dengan hal-hal ini-- tetapi ini membuat prosesnya lebih cepat.
Secara umum, saya dengan senang hati membantu, namun saya adalah seorang mahasiswa penuh waktu dan ini adalah proyek murni yang penuh gairah. Saya juga tidak memiliki langganan PTS untuk pengujian (biayanya cukup mahal untuk jangka panjang!).
Untuk bantuan, buka masalah GitHub atau bergabunglah dengan server Discord. Untuk membantu 99% masalah, saya memerlukan kesalahan yang Anda alami pada file params.json dan cookieString.txt Anda. Ada metode di server Discord untuk mengirimkannya secara pribadi.
Saya ingin memiliki buku manual untuk mobil saya, dan saya membeli langganan dengan harapan dapat mengunduh PDF, jadi itulah yang saya lakukan!
Dua alasan. Pertama, saya tidak ingin melakukan DDoS Ford (mereka juga memiliki Akamai di depannya, dan banyak permintaan paralel pasti akan memicunya dan membuat kami diblokir). Kedua, lebih mudah untuk membuat kode secara sinkron.
