← Retour au blog
AiEnviron 8 min de lecture

Un moteur astrologique de 1 100 règles mieux conçu que la plupart des produits IA

Publié le 9 nov. 2026
Un moteur astrologique de 1 100 règles mieux conçu que la plupart des produits IA

Un dépôt TypeScript de calcul de thèmes astrologiques chinois compte 16 868 étoiles sur GitHub cette semaine. C'est plus que ce que la plupart des outils de développement obtiennent en une vie, pour un sujet que la majorité des ingénieurs occidentaux classeraient dans « pas du logiciel ».

La partie intéressante n'est pas le sujet. C'est que le dépôt est un meilleur morceau d'ingénierie que beaucoup de ce qui sort sous l'étiquette « produit IA ».

ziwei-doushu est un moteur open source pour le 紫微斗数, l'astrologie de l'Étoile pourpre, construit sur le système que Ni Haixia enseigne dans ses conférences « Tian Ji ». Les thèmes sont calculés entièrement dans le navigateur. Pas de clé d'API, pas de modèle, pas d'inférence. De l'arithmétique, des tables de correspondance et 1 100 lignes de règles de motifs.

Et il vient avec 768 thèmes de régression.

Ce qu'il calcule vraiment

Si vous ne connaissez pas le domaine, le tableau des capacités du README fait aussi office de liste des façons dont ce genre de calcul se trompe.

Correction du temps solaire vrai. Une heure de naissance relevée sur une horloge n'est pas le temps solaire de ce lieu. Le moteur corrige l'écart de longitude et l'équation du temps, pour qu'un thème établi à l'est du pays ne tombe pas une double-heure à côté. C'est l'équivalent astrologique d'un bug de fuseau horaire, et c'est la première chose qui casse dans les implémentations naïves.

Heure d'été chinoise, 1986 à 1991. Le pays a appliqué l'heure d'été pendant six ans puis a arrêté. Le moteur détecte l'intervalle mais ne retire délibérément pas l'heure automatiquement : le README précise que les lectures d'horloge sont confirmées par l'utilisateur puis converties via un fichier clock-adjust.ts séparé. C'est une intuition correcte. Ajuster silencieusement l'entrée d'un utilisateur, c'est comme ça qu'on produit des thèmes faux avec assurance.

Quatre conventions pour les mois intercalaires. Les écoles ne sont pas d'accord : le mois intercalaire appartient-il au mois précédent, au mois suivant, se divise-t-il par jour, ou compte-t-il pour lui-même ? Le moteur en fait un réglage au lieu de choisir un camp. Même chose pour la brillance des étoiles, où différentes traditions, et différentes versions du même logiciel commercial, utilisent des échelles différentes. Sept niveaux sont pris en charge, avec une classification plus grossière à trois niveaux pour l'affichage de repli.

Changement de jour à la fin de l'heure zi. De 23 h 00 à 23 h 59 est traité comme le lendemain ; de 00 h 00 à 00 h 59 comme le jour courant. Si un lieu de naissance est fourni, le jugement se fait sur le temps solaire vrai pour que les deux règles restent cohérentes.

Là-dessus se posent les quatre transformations et les étoiles volantes, douze placements d'esprits et de tueurs qui se déplacent entre la couche natale et la couche annuelle, et une bibliothèque de motifs de plus de 1 100 règles : 紫府同宫, 日月并明, 七杀朝斗 et les autres.

A carved wooden printing block and a worn ink brush on coarse paper

Les tests sont l'argument

N'importe qui peut affirmer que son moteur de thèmes est correct. Celui-ci publie une suite de tests qui tourne à chaque push et chaque pull request, et la liste de ce qu'elle vérifie est la partie la plus instructive du dépôt :

768 thèmes confrontés aux règles de fer du système. Les intervalles d'heure d'été. La limite de 立春, où l'année change dans ce calendrier et où presque toutes les implémentations ont un décalage d'une unité. Le placement de 红鸾 et 天喜. La cohérence de l'index horaire sur des thèmes témoins. Les conditions de bord de l'index horaire. La validité des dates. Le cas où deux transformations tombent dans le même palais.

Ce n'est pas une liste marketing. C'est une liste écrite par quelqu'un qui a été mordu par chaque élément, l'un après l'autre. La limite de 立春 à elle seule casse une implémentation naïve chaque année, pour quiconque est né la première semaine de février.

L'installer

Trois commandes :

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install

En option cp .env.example .env.local, puis npm run dev. La vérification, c'est npm run typecheck pour une passe TypeScript complète et npm test pour la suite de régression du moteur de thèmes.

Aucune clé d'API n'est nécessaire pour établir ou afficher un thème, et aucune pour le thème de compatibilité. Tout tourne côté client, ce qui est le bon choix pour quelque chose construit à partir d'une date et d'un lieu de naissance.

La frontière tracée par l'auteur, et pourquoi c'est la chose la plus honnête du README

La version open source n'inclut pas les routes d'API backend. L'établissement du thème, son affichage et le calcul de compatibilité sont tous locaux. Mais le point d'accès d'interprétation par IA, /api/interpret, et celui de l'analyse de compatibilité ne sont pas implémentés.

Sans eux, l'interface dit clairement que la version open source n'inclut pas ce point d'accès. Et le README ajoute une ligne qui règle un problème que les gens n'arrêtaient pas de signaler : configurer une clé d'API ne fera pas fonctionner ces fonctions. L'issue #30 existe parce que des utilisateurs ont supposé le contraire.

C'est une décision inhabituelle. Le geste facile serait de livrer un simulacre qui appelle un modèle et produit un commentaire plausible. Le dépôt est au contraire une calculatrice qui refuse de prétendre qu'elle est un oracle. Vu la part de non-sens assuré dans la présence en ligne de ce sujet, un outil qui s'arrête au bord de ce qu'il sait calculer mérite qu'on le remarque.

Le nommage, et pourquoi ça se lit comme une bibliothèque

Le code est organisé autour de la façon dont la discipline est réellement enseignée, et c'est pourquoi il est lisible.

lib/ziwei/algorithm.ts contient la séquence de calcul : placer le palais de vie, déterminer le 局 des cinq éléments, placer les quatorze étoiles majeures, placer les étoiles auxiliaires, disposer les cycles décennaux et annuels. constants.ts contient les troncs, les branches et les listes d'étoiles. sihua.ts contient les quatre transformations (禄, 权, 科, 忌), y compris les cas d'auto-transformation des étoiles volantes. Puis des modules séparés pour la bibliothèque de motifs et les tables de brillance.

Si vous connaissez le sujet, cette correspondance est évidente. Sinon, elle reste lisible : des constantes, puis de l'arithmétique, puis des règles, puis des données proches de l'interprétation. Le domaine n'est pas familier et la structure l'est, ce à quoi ressemble un bon logiciel quand il est écrit par quelqu'un qui comprend la chose plutôt que la tendance.

Le choix de TypeScript compte aussi. Un thème est un arbre de palais contenant des étoiles, transformé par des règles qui se référencent entre elles. Un système de types capable d'exprimer « un palais contient une liste d'étoiles, chacune avec un niveau de brillance pris dans un ensemble fixe » attrape toute une classe de bugs à la compilation, et le dépôt lance une vérification de types complète avant tout le reste. Pour un domaine avec autant de valeurs énumérées, ce n'est pas de la décoration.

Pourquoi un blog sur l'IA écrit sur un moteur d'astrologie

Parce que c'est le contre-exemple propre de la façon dont la plupart des produits IA sont construits aujourd'hui.

Voilà un système où chaque sortie est déterministe, chaque règle est attribuable à une tradition nommée, chaque convention ambiguë est un commutateur de configuration plutôt qu'une opinion, et l'exactitude est garantie par 768 cas de régression. Posez-lui deux fois la même question et vous obtenez la même réponse. Rien n'est halluciné, parce que rien n'est généré.

Et puis il y a la partie qu'il refuse explicitement de faire : interpréter. La couche d'interprétation, celle qui demande du jugement et où différents praticiens ne seront pas d'accord, est laissée à l'utilisateur ou à un point d'accès implémenté séparément.

La plupart des équipes qui construisent avec des modèles de langage gagneraient à copier cette séparation. Calculer ce qui peut l'être, exactement, et être explicite sur l'endroit où l'interprétation commence. L'alternative est un système qui sonne autoritaire sur la différence entre les deux, précisément le mode de défaillance que ce dépôt a été conçu pour éviter.

Le code est sous MIT. Le jeu de données est en CC BY 4.0. Les textes classiques sont dans le domaine public. Les propos du conférencier sont sous licence non commerciale, et le README le dit. Tout cela est documenté, ce que la plupart des projets ne réussissent pas même sur des matériaux bien moins contestés.

Vous n'avez pas besoin de croire au sujet pour apprendre quelque chose de l'ingénierie. C'est en général la marque d'une chose bien faite.

Articles associés