Eine Astrologie-Engine mit 1.100 Regeln ist besser gebaut als viele KI-Produkte

Ein TypeScript-Repository zur Berechnung chinesischer Horoskope hat diese Woche 16.868 Sterne auf GitHub. Das ist mehr, als die meisten Entwicklerwerkzeuge in einem Leben bekommen, für ein Thema, das die meisten westlichen Ingenieure unter „keine Software" ablegen würden.
Das Interessante ist nicht das Thema. Es ist, dass das Repository handwerklich besser gebaut ist als vieles, was unter dem Label „KI-Produkt" ausgeliefert wird.
ziwei-doushu ist eine Open-Source-Engine für 紫微斗数 – Purple Star Astrology –, gebaut auf dem System, das 倪海厦 in seinen 天纪-Vorlesungen lehrte. Die Horoskope werden vollständig im Browser berechnet. Kein API-Key, kein Modell, keine Inferenz. Es ist Arithmetik, Nachschlagetabellen und 1.100 Zeilen Regeln für Muster.
Und es kommt mit 768 Regressionshoroskopen.
Was es tatsächlich berechnet
Wer die Domäne nicht kennt, für den ist die Fähigkeitstabelle im README zugleich eine Liste der Arten, wie diese Berechnung schiefgeht.
Korrektur auf wahre Sonnenzeit. Eine auf der Uhr notierte Geburtszeit ist nicht die Sonnenzeit an diesem Ort. Die Engine korrigiert die Längendifferenz plus die Zeitgleichung, damit ein im Osten des Landes gestelltes Horoskop nicht eine Doppelstunde daneben liegt. Das ist das astrologische Äquivalent eines Zeitzonen-Bugs, und es ist das Erste, was in naiven Implementierungen bricht.
Chinesische Sommerzeit, 1986 bis 1991. Das Land hatte sechs Jahre lang Sommerzeit und dann nicht mehr. Die Engine erkennt das Intervall, zieht die Stunde aber bewusst nicht automatisch ab – das README sagt ausdrücklich, dass Uhrzeiten vom Nutzer bestätigt und dann über eine separate clock-adjust.ts umgerechnet werden. Das ist der richtige Instinkt. Die Eingabe eines Nutzers still zu verändern ist der Weg zu Horoskopen, die selbstsicher falsch sind.
Vier Konventionen für Schaltmonate. Die Schulen streiten, ob ein Schaltmonat zum Vormonat gehört, zum Folgemonat, tageweise geteilt wird oder als eigener zählt. Die Engine macht daraus eine Einstellung, statt eine Seite zu wählen. Dasselbe für die Sternhelligkeit, wo verschiedene Traditionen – und verschiedene Versionen derselben kommerziellen Software – unterschiedliche Skalen nutzen. Sieben Stufen werden unterstützt, mit einer gröberen Drei-Stufen-Klassifikation als Anzeige-Fallback.
Tageswechsel bei später zi-Stunde. 23:00 bis 23:59 gilt als der nächste Tag, 00:00 bis 00:59 als der aktuelle. Ist ein Geburtsort angegeben, wird nach wahrer Sonnenzeit entschieden, damit beide Regeln konsistent bleiben.
Darüber liegen die vier Wandlungen und die fliegenden Sterne, zwölf Platzierungen von Geistern und Übeln, die zwischen Geburts- und Jahresebene wechseln, und eine Musterbibliothek mit über 1.100 Regeln – 紫府同宫, 日月并明, 七杀朝斗 und der Rest.

Die Tests sind das Argument
Jeder kann behaupten, seine Engine rechne richtig. Diese hier veröffentlicht eine Testsuite, die bei jedem Push und Pull Request läuft, und die Liste dessen, was sie prüft, ist der informativste Teil des Repositorys:
768 Horoskope gegen die ehernen Regeln des Systems. Sommerzeit-Intervalle. Die 立春-Grenze, an der in diesem Kalender das Jahr wechselt und an der fast jede Implementierung einen Off-by-one hat. Die Platzierung von 红鸾 und 天喜. Konsistenz des Stundenindex über Beispielhoroskope. Randbedingungen des Stundenindex. Datumsgültigkeit. Der Fall, dass zwei Wandlungen im selben Palast landen.
Das ist keine Marketingliste. Das ist eine Liste von jemandem, den jeder Punkt der Reihe nach gebissen hat. Allein die 立春-Grenze bricht eine naive Implementierung jedes Jahr für jeden, der in der ersten Februarwoche geboren ist.
Die Installation
Drei Befehle:
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install
Optional cp .env.example .env.local, dann npm run dev. Die Prüfung ist npm run typecheck für einen vollständigen TypeScript-Durchlauf und npm test für die Regressionssuite der Horoskop-Engine.
Für das Stellen oder Anzeigen eines Horoskops ist kein API-Key nötig, und für das Kompatibilitätshoroskop auch nicht. Alles läuft clientseitig, was für etwas, das aus Geburtsdatum und Geburtsort gebaut wird, die richtige Entscheidung ist.
Die Grenze, die der Autor gezogen hat, und warum sie das Ehrlichste im README ist
Die Open-Source-Version enthält die Backend-API-Routen nicht. Horoskop stellen, Horoskop anzeigen und Kompatibilität stellen laufen alle lokal. Aber der Endpunkt für die KI-Deutung – /api/interpret – und der Endpunkt für die Kompatibilitätsanalyse sind nicht implementiert.
Ohne sie sagt die Oberfläche klar, dass die Open-Source-Version diesen Endpunkt nicht enthält. Und das README ergänzt eine Zeile, die ein Problem auflöst, das Leute immer wieder meldeten: Einen API-Key zu konfigurieren macht diese Funktionen nicht lauffähig. Issue #30 existiert, weil Nutzer das Gegenteil annahmen.
Das ist eine ungewöhnliche Entscheidung. Der einfache Weg wäre, einen Stub auszuliefern, der ein Modell aufruft und plausibel klingenden Kommentar produziert. Stattdessen ist das Repository ein Rechner, der sich weigert, ein Orakel zu spielen. Wenn so viel der Online-Präsenz dieses Themas selbstsicherer Unsinn ist, lohnt es, ein Werkzeug zu bemerken, das an der Grenze dessen stoppt, was es berechnen kann.
Die Benennung, und warum sie wie eine Bibliothek liest
Der Code ist um die Art organisiert, wie die Disziplin tatsächlich gelehrt wird, und deshalb ist er lesbar.
lib/ziwei/algorithm.ts enthält die Stellungsfolge: Lebenspalast setzen, das Fünf-Elemente-Schema bestimmen, die vierzehn Hauptsterne setzen, die Hilfssterne setzen, Jahrzehnt- und Jahreszyklen auslegen. constants.ts enthält Stämme, Zweige und Sternlisten. sihua.ts enthält die vier Wandlungen – 禄, 权, 科, 忌, inklusive der Selbstwandlungsfälle der fliegenden Sterne. Dann getrennte Module für die Musterbibliothek und die Helligkeitstabellen.
Wer das Thema kennt, für den ist diese Zuordnung offensichtlich. Wer es nicht kennt, kann sie trotzdem lesen: Konstanten, dann Arithmetik, dann Regeln, dann deutungsnahe Daten. Die Domäne ist fremd, die Struktur nicht – so sieht gute Software aus, wenn sie jemand baut, der die Sache versteht und nicht den Trend.
Die Wahl von TypeScript zählt ebenfalls. Horoskope sind ein Baum von Palästen mit Sternen darin, transformiert durch Regeln, die aufeinander verweisen. Ein Typsystem, das ausdrücken kann, dass ein Palast eine Liste von Sternen enthält und jeder eine Helligkeitsstufe aus einer festen Menge, fängt eine ganze Fehlerklasse zur Compile-Zeit, und das Repository fährt vor allem anderen einen vollen Typecheck. Für eine Domäne mit so vielen aufgezählten Werten ist das keine Dekoration.
Warum ein KI-Blog über eine Astrologie-Engine schreibt
Weil sie das saubere Gegenbeispiel dazu ist, wie die meisten KI-Produkte gerade gebaut werden.
Hier ist ein System, in dem jede Ausgabe deterministisch ist, jede Regel einer benannten Tradition zugeordnet werden kann, jede mehrdeutige Konvention ein Konfigurationsschalter ist statt einer Meinung, und Korrektheit durch 768 Regressionsfälle erzwungen wird. Frag es zweimal dasselbe, und du bekommst dieselbe Antwort. Nichts wird halluziniert, weil nichts generiert wird.
Dann ist da der Teil, den es ausdrücklich nicht tut: deuten. Die Deutungsschicht – der Teil, der Urteil verlangt und bei dem verschiedene Praktiker sich widersprechen – bleibt dem Nutzer oder einem separat implementierten Endpunkt überlassen.
Die meisten Teams, die mit Sprachmodellen bauen, würden von dieser Trennung profitieren. Berechne, was sich exakt berechnen lässt, und sei ausdrücklich darüber, wo die Deutung anfängt. Die Alternative ist ein System, das autoritär klingt über den Unterschied zwischen beidem – genau der Fehlermodus, den dieses Repository vermeiden sollte.
Der Code ist MIT. Der Datensatz ist CC BY 4.0. Die klassischen Texte sind gemeinfrei. Die Worte des Dozenten sind nicht-kommerziell lizenziert, und das README sagt es. Alles davon ist dokumentiert, was mehr ist, als die meisten Projekte über weit weniger strittiges Material schaffen.
Du musst nicht an das Thema glauben, um vom Engineering zu lernen. Das ist meist das Zeichen für ein gut gemachtes Ding.
Verwandte Artikel
Der Verwaltungsrat baute nebenbei einen Exportausschuss
Nur eines der beiden Ereignisse vom 17. November wurde zur Schlagzeile. Das andere verändert das Unternehmen wahrscheinlicher: ein ständiger Ausschuss für Exportkontrolle.
Nvidia hat nie eine zweite Reihe gebaut
Nvidia hat dreiunddreißig Jahre auf die Autorität eines Gründers gebaut. Die Suche nach seinem Nachfolger zeigt, was dabei nie mitgebaut wurde: eine zweite Reihe.
Zehn Abstufungen, keine einzige neue Zahl
Niemand hat neue Daten zum Auftragsbestand geliefert. Geändert hat sich nicht die Mitte der Prognose, sondern die Breite der Spanne – und das reicht für zehn Abstufungen.
Ein Konzern, vier Billionen Dollar und eine einzige Person
In neun Tagen wechselt Nvidia den Chef, baut den Verwaltungsrat um und legt trotzdem Zahlen vor. Der Markt hat in dieser Zeit vor allem eines getan: einen Preis für einen einzigen Menschen gefunden.