mirror of
https://github.com/HackTricks-wiki/hacktricks-cloud.git
synced 2026-07-29 07:00:29 -07:00
83 lines
3.3 KiB
Markdown
83 lines
3.3 KiB
Markdown
# AGENTS.md
|
||
|
||
Καθοδήγηση για μελλοντικούς agents που εργάζονται σε αυτό το αποθετήριο.
|
||
|
||
## Repository Context
|
||
|
||
Αυτό είναι το HackTricks Cloud mdBook repository. Το σχετικό main book βρίσκεται στο:
|
||
|
||
`/Users/carlospolop/git/hacktricks`
|
||
|
||
Αλλαγές σε κοινό theme/search behavior συχνά πρέπει να εφαρμόζονται και στα δύο repositories.
|
||
|
||
## Search Index Loading Contract
|
||
|
||
Το custom search UI βρίσκεται στο:
|
||
|
||
`theme/ht_searcher.js`
|
||
|
||
Μπορεί επίσης να υπάρχει ένα generated copy στο:
|
||
|
||
`book/theme/ht_searcher.js`
|
||
|
||
Αν το production κάνει deploy τον ήδη-built `book/` directory, ενημέρωσε και τα δύο copies ή κάνε rebuild το
|
||
book πριν το deployment.
|
||
|
||
Η σειρά φόρτωσης του search index είναι σημαντική και cost-sensitive:
|
||
|
||
1. Φόρτωσε κάθε language-specific και fallback search index από το GitHub repository:
|
||
`HackTricks-wiki/hacktricks-searchindex`
|
||
2. Μόνο αν αποτύχουν όλοι οι GitHub-hosted candidates, κάνε fallback στο same-origin mdBook output.
|
||
|
||
Μην βάζεις το local `/searchindex.js` fallback πριν από οποιοδήποτε GitHub-hosted fallback όπως
|
||
`searchindex-cloud-en.js.gz`. Το να σερβίρεται `searchindex.js` από το `cloud.hacktricks.wiki` σε production είναι ακριβό.
|
||
|
||
Για αυτό το repo, το αναμενόμενο local fallback είναι:
|
||
|
||
`/searchindex.js`
|
||
|
||
Το main-book fallback για αυτό το repo είναι:
|
||
|
||
`/searchindex-book.js`
|
||
|
||
Αυτό το αρχείο είναι μόνο fallback. Η primary source πρέπει να παραμένει τα remote
|
||
`searchindex-<lang>.js.gz` και `searchindex-cloud-<lang>.js.gz` files στο
|
||
`HackTricks-wiki/hacktricks-searchindex`.
|
||
|
||
## Search Index Publishing
|
||
|
||
Τα workflows που publish encrypted compressed search indexes στο
|
||
`HackTricks-wiki/hacktricks-searchindex` είναι:
|
||
|
||
- `.github/workflows/build_master.yml`
|
||
- `.github/workflows/translate_all.yml`
|
||
|
||
Το generated source file είναι `book/searchindex.js`. Τα published remote artifact names είναι:
|
||
|
||
- `searchindex-cloud-en.js.gz`
|
||
- `searchindex-cloud-<lang>.js.gz`
|
||
|
||
Ο browser loader περιμένει τα remote `.js.gz` files να είναι XOR-encrypted gzip payloads χρησιμοποιώντας το
|
||
key που ορίζεται στο `theme/ht_searcher.js`.
|
||
|
||
## Build And Validation
|
||
|
||
Κοινά local checks:
|
||
|
||
- `node --check theme/ht_searcher.js`
|
||
- `mdbook build`
|
||
|
||
Αν το `mdbook build` αποτύχει, έλεγξε:
|
||
|
||
- `hacktricks-preprocessor-error.log`
|
||
- `hacktricks-preprocessor.log`
|
||
|
||
## Editing Notes
|
||
|
||
- Προτίμησε `rg` για αναζήτηση.
|
||
- Κράτα το generated `book/` output έξω από commits εκτός αν ζητηθεί ρητά. Τα search loader fixes είναι
|
||
εξαίρεση όταν οι ήδη-built pages πρέπει να διορθωθούν άμεσα.
|
||
- Αν αλλάζεις shared theme behavior, σύγκρινε και ενημέρωσε το αντίστοιχο αρχείο στο
|
||
`/Users/carlospolop/git/hacktricks`.
|
||
- Μην επαναφέρεις άσχετες τοπικές αλλαγές.
|