kungfu : ce que le dépôt permet réellement

Deux substrats d'exécution pour le travail d'agents

Le README présente Kungfu comme une infrastructure d'exécution pour le travail réel d'agents. Son autorité sémantique locale commence dans un journal en ajout seul qui expose deux substrats d'exécution. Fact enregistre ce qui est admis à une coupe explicite (Cut), et Episode enregistre l'expérience causale bornée par laquelle le travail s'est produit et l'état a changé. Episode est décrit comme l'objet de travail temporel phare, et non le seul objet fondateur. Les métadonnées du dépôt indiquent C++ comme langage et dev/v4/v4.0 comme branche par défaut, avec le site du projet à kungfu.tech ; le README lui-même se concentre sur le modèle conceptuel plutôt que sur l'implémentation.

Première utilisation avec trois objets

Pour la première utilisation, la documentation dit de ne retenir que trois objets : Project, Work et Agent. Ouvrez ou créez un Project, décrivez un résultat de Work, puis exécutez un Agent. Le modèle d'autorité plus profond est disponible quand la preuve ou la récupération l'exige, mais il n'est pas un prérequis pour commencer. Work Control organise le travail continu comme Initiative et la responsabilité bornée comme Assignment, fédère les observations exactes de l'espace de travail via Portfolio, et règle un Project Cut successeur. Aucun de ces termes ne redéfinit les substrats Fact et Episode neutres du domaine, selon le README.

Comment la documentation est organisée

Ce README est un itinéraire choisi à travers la documentation, volontairement plus court que l'index complet dans MAP.md. Les répertoires de responsabilité incluent Concepts, Guides, Architecture, Profiles, Qualification, Development, Research, Architecture Decisions, ADR Map, Evolution Map et Shifu. Chaque répertoire possède une fonction : Concepts couvre le vocabulaire et les principes, Qualification couvre les garanties et les limites, les ADR préservent les décisions porteuses, et Research préserve les options mesurées sans en faire des directives actuelles. Quand deux documents se chevauchent, le rôle décide de la propriété : Vocabulary possède les définitions publiques des termes, et Event Model possède la mécanique du journal et du Replay.

Exploitation, intégration et extension

Les guides d'exploitation couvrent le statut Alpha, les problèmes connus, le précontrôle de santé, Rewind, la configuration, la durabilité, l'installation du CLI, la mise à niveau et la compatibilité de sortie et de version. L'exécution installée se décrit elle-même via des commandes telles que `kungfu agent brief`, `kungfu agent capabilities --json` et `kungfu agent choose-mode --json`. Pour l'extension, la section architecture documente le modèle d'événements, les adaptateurs pour C++, Python, Node et les frontières de frameworks, la topologie kfx, les compétences et la création de profils orientée agent. Le README nomme ces domaines sans énoncer de garanties d'intégration spécifiques.

Évaluation institutionnelle et limites connues

L'évaluation institutionnelle commence par un document de décision qui mène à un profil de confiance institutionnelle sur hôte unique, à la durabilité et à la récupération après panne, à la compatibilité de sortie et de version, aux contrats, aux limites connues, à la qualification de performance de bout en bout, à la qualification d'atomicité des Episode et à la vérification des invariants. Le README déclare que Kungfu v4 prend actuellement en charge l'évaluation d'ingénierie et l'utilisation fantôme contrôlée pour le profil institutionnel, et que la documentation ne transforme pas une cible de conception non qualifiée en garantie de production. Le répertoire de qualification conserve les preuves et les non-affirmations.

Contributions et gouvernance documentaire

Les conseils de contribution couvrent la construction, le style, les tests, le DCO et les demandes de tirage, ainsi que des processus de développement comme les opérations d'attention Alpha et la ligne de base de santé communautaire. La frontière documentaire est exécutable : `./shifu docs:check` valide la structure Markdown, les ancres et la cohérence, tandis que `./shifu docs:prose` applique la politique Vale générée. La santé des URL externes est délibérément séparée parce que la disponibilité distante n'est pas une propriété déterministe d'un commit. Le README dit aussi que docs/README.md et docs/MAP.md sont les seuls fichiers Markdown à la racine, et que Kungfu n'a pas publié de contrat de compatibilité documentaire, donc les anciens chemins plats sont retirés plutôt que conservés comme redirections.

Contrôle pratique de kungfu

Utilisez l’exemple de configuration fourni par Kungfu, lancez le binaire ou le script documenté dans un environnement de simulation et contrôlez les journaux d’ordres, de marché et de stratégie. N’utilisez pas un compte réel sans avoir vérifié les connecteurs concernés.

Conclusion éditoriale

Utilisez l’exemple de configuration fourni par Kungfu, lancez le binaire ou le script documenté dans un environnement de simulation et contrôlez les journaux d’ordres, de marché et de stratégie. N’utilisez pas un compte réel sans avoir vérifié les connecteurs concernés. Kungfu est un framework de trading open source écrit en C++ avec des composants Python et une architecture orientée marché. Le README décrit ses modules, ses exemples et ses contraintes d’exécution. Les résultats financiers ou de performance ne sont pas garantis par la seule présence du code. La licence Apache-2.0 autorise les usages prévus par ses termes, sans constituer une garantie de sécurité, de support ou de résultat.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes