Fiches techniques

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) récupère les fiches techniques des composants une fois dans un cache partagé par tous les projets et agents, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS ou $XDG_CACHE_HOME le déplace), et les relit en texte.

agentee datasheet fetch lna                    # every part of a layout or schematic
agentee datasheet fetch U3                     # one part, by reference, symbol or part number
agentee datasheet fetch TMC2209-LA
agentee datasheet fetch U3 --url https://example.com/u3.pdf
agentee datasheet text TMC2209-LA --find VS    # passages holding VS, with page and line
agentee datasheet text U3 --pages 4-6
agentee datasheet add XYZ123 ~/Downloads/xyz123.pdf --manufacturer Acme
agentee datasheet list
agentee datasheet purge                        # drop every copy no library part pins

La fiche technique d'un composant est recherchée dans l'ordre : son champ datasheet dans le schéma, l'URL datasheet de son symbole, puis la fiche technique que chaque distributeur avec une clé liste pour son mpn (un champ Maker MPN est découpé, et un numéro de composant qui est le début d'un numéro listé, comme TMC2209-LA pour TMC2209-LA-T, prend sa fiche technique). Les téléchargements utilisent un agent utilisateur de navigateur, réessaient sur HTTP 429 et 5xx, suivent une page HTML vers le PDF qu'elle lie, et abandonnent un hôte qui a expiré une fois pour le reste de l'exécution. Seul un PDF est conservé.

Les copies sont dans MAKER/MPN/HASH.pdf avec un meta.json contenant l'URL, la source, le SHA-256, la date de récupération et la ligne de révision lue sur sa première ou dernière page de chaque copie, de sorte qu'un composant est récupéré une fois et qu'une révision plus récente est à côté de l'ancienne. text lit une copie avec pdftotext -layout et garde le texte à côté du PDF ; il ne touche jamais au réseau si le composant est en cache, et le récupère d'abord s'il ne l'est pas (--offline refuse à la place). --find correspond aux mots entiers, sensible à la casse si le mot a des majuscules, avec des lignes --context autour de chaque correspondance.

Une récupération d'une conception, ou d'un composant dedans, enregistre ce qu'elle a utilisé dans datasheets.toml à la racine du projet :

[[parts]]
key = "TPS7A9101DSKR"
manufacturer = "TI"
refs = ["U9", "U24"]
url = "https://www.ti.com/lit/ds/symlink/tps7a91.pdf"
source = "symbol TPS7A91"
sha256 = "1ab38416..."
revision = "SBVS282A – DECEMBER 2016 – REVISED SEPTEMBER 2026"
fetched = "2026-10-09"

[[parts]]
key = "SPF5189Z"
refs = ["U1"]
missing = "https://www.qorvo.com/products/d/da001910: HTTP 429"

check avertit (règle datasheet) pour un composant avec un mpn qui n'a pas d'URL de fiche technique sur son symbole ou composant et pas d'enregistrement ici, et pour un composant dont la dernière récupération n'a pas trouvé de fiche technique. La correction est le PDF de l'utilisateur via datasheet add, ou une URL qui fonctionne.