Μετάβαση στο κύριο περιεχόμενο

Γνωστές εκπλήξεις

Αυτό το αρχείο παρακολουθεί σημεία σύγχυσης ειδικά για το χώρο αποθήκευσης που προκάλεσαν σφάλματα πρακτόρων.

Κριτήρια Εισόδου​

Προσθέστε μια καταχώριση μόνο εάν όλα είναι αληθή:

  • Είναι ειδικά για αυτό το αποθετήριο (όχι γενικές συμβουλές).
  • Είναι πιθανό να επαναληφθεί για μελλοντικούς πράκτορες.
  • Έχει ένα συγκεκριμένο μετριασμό που μπορεί να ακολουθηθεί.

Εάν δεν είστε βέβαιοι, ρωτήστε τον προγραμματιστή πριν προσθέσετε μια καταχώριση.

Πρότυπο εισόδου​

### [Short title]

- **Date:** YYYY-MM-DD
- **Observed by:** agent name or contributor
- **Context:** where/when it happened
- **What was surprising:** concrete unexpected behavior
- **Impact:** what went wrong or could go wrong
- **Mitigation:** exact step future agents should take
- **Status:** confirmed | superseded

Συμμετοχές​

Το Portless αλλάζει το κανονικό URL τοπικής εφαρμογής​

  • Ημερομηνία: 2026-03-18
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Επαλήθευση προγράμματος περιήγησης και ροές καπνού
  • Αυτό που ήταν εκπληκτικό: Η προεπιλεγμένη τοπική διεύθυνση URL δεν είναι η συνηθισμένη θύρα Vite. Το repo αναμένει το https://bitsocial.localhost μέσω Portless, επομένως ο έλεγχος του localhost:3000 ή του localhost:5173 μπορεί να χτυπήσει λάθος εφαρμογή ή τίποτα.
  • Επίδραση: Οι έλεγχοι του προγράμματος περιήγησης μπορεί να αποτύχουν ή να επικυρώσουν τον λάθος στόχο ακόμα και όταν ο διακομιστής προγραμματισμού είναι υγιής.
  • Μετριασμός: Χρησιμοποιήστε πρώτα το https://bitsocial.localhost. Παρακάμψτε το μόνο με το PORTLESS=0 corepack yarn start όταν χρειάζεστε ρητά μια άμεση θύρα Vite.
  • Κατάσταση: επιβεβαιώθηκε

Τα άγκιστρα Commitizen μπλοκάρουν τις μη διαδραστικές δεσμεύσεις​

  • Ημερομηνία: 2026-03-18
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Ροές εργασιών δέσμευσης που βασίζονται σε πράκτορες
  • Αυτό που ήταν έκπληξη: Το git commit ενεργοποιεί το Commitizen μέσω του Husky και περιμένει για διαδραστική είσοδο TTY, η οποία κρέμεται από μη διαδραστικά κελύφη πρακτόρων.
  • Επίδραση: Οι πράκτορες μπορούν να σταματήσουν επ' αόριστον κατά τη διάρκεια της κανονικής δέσμευσης.
  • Μετριασμός: Χρησιμοποιήστε το git commit --no-verify -m "message" για δεσμεύσεις που δημιουργούνται από πράκτορες. Οι άνθρωποι μπορούν ακόμα να χρησιμοποιούν το corepack yarn commit ή το corepack yarn exec cz.
  • Κατάσταση: επιβεβαιώθηκε

Το Corepack απαιτείται για να αποφευχθεί το Yarn classic​

  • Ημερομηνία: 2026-03-19
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Μετάβαση του Package Manager στο Yarn 4
  • Αυτό που ήταν έκπληξη: Το μηχάνημα εξακολουθεί να έχει μια παγκόσμια κλασική εγκατάσταση του Yarn στο PATH, επομένως η εκτέλεση του απλού yarn μπορεί να επιλυθεί σε v1 αντί για καρφιτσωμένη έκδοση Yarn 4.
  • Επίδραση: Οι προγραμματιστές μπορούν κατά λάθος να παρακάμψουν το καρφίτσωμα του διαχειριστή πακέτων του repo και να λάβουν διαφορετική συμπεριφορά εγκατάστασης ή έξοδο αρχείου κλειδώματος.
  • Μετριασμός: Χρησιμοποιήστε το corepack yarn ... για εντολές κελύφους ή εκτελέστε πρώτα το corepack enable, έτσι ώστε το απλό yarn να επιλύεται στην καρφιτσωμένη έκδοση του Yarn 4.
  • Κατάσταση: επιβεβαιώθηκε

Τα διορθωμένα ονόματα εφαρμογών Portless συγκρούονται μεταξύ των δέντρων εργασίας του Bitsocial Web​

  • Ημερομηνία: 30-03-2026
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Εκκίνηση του yarn start σε ένα δέντρο εργασίας Bitsocial Web ενώ ένα άλλο δέντρο εργασίας εξυπηρετούσε ήδη μέσω Portless
  • Αυτό που ήταν εκπληκτικό: Η χρήση του κυριολεκτικού ονόματος εφαρμογής Portless bitsocial σε κάθε δέντρο εργασίας προκαλεί σύγκρουση της ίδιας της διαδρομής, ακόμη και όταν οι θύρες υποστήριξης είναι διαφορετικές, επομένως η δεύτερη διαδικασία αποτυγχάνει επειδή το bitsocial.localhost είναι ήδη καταχωρημένο.
  • Επίδραση: Οι παράλληλοι κλάδοι του Bitsocial Web μπορούν να μπλοκάρουν ο ένας τον άλλον, παρόλο που το Portless προορίζεται να τους επιτρέψει να συνυπάρχουν με ασφάλεια.
  • Μετριασμός: Κρατήστε την εκκίνηση Portless πίσω από το scripts/start-dev.mjs, το οποίο τώρα χρησιμοποιεί μια διαδρομή *.bitsocial.localhost με εμβέλεια διακλάδωσης εκτός της κανονικής θήκης και επανέρχεται σε μια διαδρομή εμβέλειας διακλάδωσης όταν το γυμνό όνομα bitsocial.localhost είναι ήδη κατειλημμένο.
  • Κατάσταση: επιβεβαιώθηκε

Η προεπισκόπηση εγγράφων χρησιμοποιείται στη θύρα σκληρού κώδικα 3001​

  • Ημερομηνία: 30-03-2026
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Εκτέλεση του yarn start μαζί με άλλα τοπικά repos και πράκτορες
  • Αυτό που ήταν εκπληκτικό: Η εντολή root dev έτρεχε τον χώρο εργασίας των εγγράφων με το docusaurus start --port 3001, επομένως ολόκληρη η περίοδος προγραμματισμού απέτυχε κάθε φορά που μια άλλη διεργασία κατείχε ήδη το 3001, παρόλο που η κύρια εφαρμογή χρησιμοποιούσε ήδη Portless.
  • Επίδραση: Το yarn start θα μπορούσε να σκοτώσει τη διαδικασία ιστού αμέσως μετά την εκκίνηση, διακόπτοντας άσχετη τοπική εργασία λόγω σύγκρουσης εγγράφων-θύρας.
  • Μετριασμός: Διατηρήστε την εκκίνηση των εγγράφων πίσω από το yarn start:docs, το οποίο χρησιμοποιεί πλέον το Portless συν το scripts/start-docs.mjs για να τιμήσει μια ελεύθερη θύρα με έγχυση ή να επιστρέψει στην επόμενη διαθέσιμη θύρα όταν εκτελείται απευθείας.
  • Κατάσταση: επιβεβαιώθηκε

Διορθωμένα έγγραφα Το όνομα κεντρικού υπολογιστή Portless ήταν κωδικοποιημένο​

  • Ημερομηνία: 2026-04-03
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Εκτέλεση του yarn start σε ένα δευτερεύον δέντρο εργασίας Bitsocial Web ενώ ένα άλλο δέντρο εργασίας εξυπηρετούσε ήδη έγγραφα μέσω Portless
  • Αυτό που ήταν εκπληκτικό: Το start:docs κατέγραψε ακόμα το κυριολεκτικό όνομα κεντρικού υπολογιστή docs.bitsocial.localhost, επομένως το yarn start θα μπορούσε να αποτύχει, παρόλο που η εφαρμογή σχετικά ήξερε ήδη πώς να αποφύγει τις συγκρούσεις διαδρομής Portless για το δικό της όνομα κεντρικού υπολογιστή.
  • Επίδραση: Τα παράλληλα δέντρα εργασίας δεν μπορούσαν να χρησιμοποιήσουν αξιόπιστα την εντολή root dev επειδή η διαδικασία των εγγράφων τερμάτισε πρώτα και το concurrently στη συνέχεια σκότωσε την υπόλοιπη περίοδο λειτουργίας.
  • Μετριασμός: Διατηρήστε την εκκίνηση των εγγράφων πίσω από το scripts/start-docs.mjs, το οποίο τώρα εξάγει το ίδιο όνομα κεντρικού υπολογιστή Portless με εμβέλεια κλάδου με την εφαρμογή about και εισάγει το κοινόχρηστο δημόσιο URL στον στόχο διακομιστή μεσολάβησης /docs.
  • Κατάσταση: επιβεβαιώθηκε

Τα κελύφη Worktree μπορεί να χάσουν την καρφιτσωμένη έκδοση Node του repo​

  • Ημερομηνία: 2026-04-03
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Εκτέλεση του yarn start σε δέντρα εργασίας Git όπως το .claude/worktrees/* ή τα αδέλφια worktree
  • Τι ήταν περίεργο: Ορισμένα κελύφη δέντρου εργασίας επιλύθηκαν node και yarn node στον κόμβο Homebrew 25.2.1, παρόλο που οι ακίδες repo 22.12.0 στο ZXQPLACEHOLDER4ZQPLACEHOLDER θα μπορούσαν να εκτελεστούν το ZXQPLACEHOLDER4ZQPLACEH εκτοξευτές σε λάθος χρόνο εκτέλεσης.
  • Επίδραση: Η συμπεριφορά του διακομιστή προγραμματιστών μπορεί να μετακινηθεί μεταξύ του κύριου ταμείου και των δέντρων εργασίας, καθιστώντας δύσκολη την αναπαραγωγή σφαλμάτων και παραβιάζοντας την αναμενόμενη αλυσίδα εργαλείων Node 22 του repo.
  • Μετριασμός: Διατηρήστε τους εκτοξευτές προγραμματιστών πίσω από τα scripts/start-dev.mjs και scripts/start-docs.mjs, τα οποία τώρα εκτελούνται ξανά κάτω από το δυαδικό αρχείο κόμβου .nvmrc όταν το τρέχον κέλυφος βρίσκεται σε λάθος έκδοση. Η ρύθμιση του κελύφους θα πρέπει να προτιμά το nvm use.
  • Κατάσταση: επιβεβαιώθηκε

Τα υπολείμματα docs-site/ μπορούν να κρύψουν την πηγή εγγράφων που λείπει μετά το refactor​

  • Ημερομηνία: 2026-04-01
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Εκκαθάριση monorepo μετά τη συγχώνευση μετά τη μετακίνηση του έργου Docusaurus από docs-site/ σε docs/
  • Αυτό που ήταν εκπληκτικό: Ο παλιός φάκελος docs-site/ μπορεί να παραμείνει στο δίσκο με μπαγιάτικα αλλά σημαντικά αρχεία όπως το i18n/, ακόμη και μετά τη μετακίνηση του αποθετηρίου παρακολούθησης στο docs/. Αυτό κάνει το refactor να φαίνεται διπλό τοπικά και μπορεί να κρύψει το γεγονός ότι οι μεταφράσεις των παρακολουθούμενων εγγράφων δεν μετακινήθηκαν στην πραγματικότητα στο docs/.
  • Επίδραση: Οι πράκτορες μπορούν να διαγράψουν τον παλιό φάκελο ως "άχρηστα" και να χάσουν κατά λάθος το μοναδικό τοπικό αντίγραφο των μεταφράσεων των εγγράφων ή να συνεχίσουν να επεξεργάζονται σενάρια που εξακολουθούν να δείχνουν τη νεκρή διαδρομή docs-site/.
  • Μετριασμός: Αντιμετωπίστε το docs/ ως το μόνο κανονικό έργο εγγράφων. Πριν διαγράψετε τυχόν τοπικά υπολείμματα docs-site/, επαναφέρετε την παρακολουθούμενη πηγή όπως το docs/i18n/ και ενημερώστε τα σενάρια και τα άγκιστρα για να σταματήσετε να αναφέρετε το docs-site.
  • Κατάσταση: επιβεβαιώθηκε

Η πολυτοπική προεπισκόπηση εγγράφων μπορεί να αυξήσει τη μνήμη RAM κατά την επαλήθευση​

  • Ημερομηνία: 2026-04-01
  • Παρατηρήθηκε από: Codex
  • Πλαίσιο: Διόρθωση εγγράφων i18n, δρομολόγηση τοπικών ρυθμίσεων και συμπεριφορά εύρεσης σελίδας με το yarn start:docs και το Playwright
  • Αυτό που ήταν εκπληκτικό: Η προεπιλεγμένη λειτουργία προεπισκόπησης εγγράφων δημιουργεί τώρα μια πλήρη δημιουργία εγγράφων πολλαπλών τοπικών ρυθμίσεων συν την ευρετηρίαση του Pagefind πριν από την προβολή, και η διατήρηση αυτής της διαδικασίας ζωντανή μαζί με πολλές συνεδρίες Playwright ή Chrome μπορεί να καταναλώσει πολύ περισσότερη μνήμη RAM από έναν κανονικό βρόχο ανάπτυξης Vite ή μεμονωμένης τοποθεσίας Docusaurus.
  • Επίδραση: Το μηχάνημα μπορεί να περιοριστεί στη μνήμη, οι περίοδοι λειτουργίας του προγράμματος περιήγησης μπορεί να διακοπούν και οι διακοπτόμενες εκτελέσεις μπορεί να αφήσουν μπαγιάτικους διακομιστές εγγράφων ή προγράμματα περιήγησης χωρίς κεφάλι που συνεχίζουν να καταναλώνουν μνήμη.
  • Μετριασμός: Για εργασίες εγγράφων που δεν χρειάζονται επαλήθευση τοπικής διαδρομής ή εύρεσης σελίδας, προτιμήστε το DOCS_START_MODE=live yarn start:docs. Χρησιμοποιήστε την προεπιλεγμένη πολυτοπική προεπισκόπηση μόνο όταν χρειάζεται να επικυρώσετε μεταφρασμένες διαδρομές ή το Pagefind. Διατηρήστε μία μόνο περίοδο λειτουργίας Playwright, κλείστε τις παλιές συνεδρίες του προγράμματος περιήγησης πριν ανοίξετε νέες και σταματήστε τον διακομιστή εγγράφων μετά την επαλήθευση, εάν δεν τον χρειάζεστε πλέον.
  • Κατάσταση: επιβεβαιώθηκε