Datenblätter - agentee-Referenz

agentee-Datenblatt: Holt das Datenblatt jedes Bauteils einmal in einen gemeinsamen Cache, liest es als Text zurück und protokolliert, was ein Design verwendet hat.

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) lädt Bauteil-Datenblätter einmal in einen Cache, den jedes Projekt und jeder Agent teilt, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS oder $XDG_CACHE_HOME verschieben ihn), und liest sie als Text zurück.

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

Das Datenblatt eines Bauteils wird in dieser Reihenfolge gesucht: sein datasheet-Feld im Schaltplan, das datasheet-URL seines Symbols, dann das Datenblatt, das jeder Händler mit einem Schlüssel für seine mpn auflistet (ein Maker MPN-Feld wird geteilt, und eine Bauteilnummer, die der Anfang einer aufgeführten ist, wie TMC2209-LA für TMC2209-LA-T, nimmt dessen Datenblatt). Downloads verwenden einen Browser-User-Agent, wiederholen bei HTTP 429 und 5xx, folgen einer HTML-Seite zum verlinkten PDF und geben für den Rest der Ausführung auf einem Host auf, der einmal zeitüberschritten ist. Nur ein PDF wird behalten.

Kopien liegen unter MAKER/MPN/HASH.pdf mit einem meta.json, das die URL, die Quelle, den SHA-256, das Abrufdatum und die Revisionszeile aus der ersten oder letzten Seite jeder Kopie enthält, sodass ein Bauteil einmal abgerufen wird und eine neuere Revision neben der alten liegt. text liest eine Kopie mit pdftotext -layout und behält den Text neben dem PDF; es berührt das Netzwerk nie, wenn das Bauteil im Cache ist, und ruft es zuerst ab, wenn es nicht ist (--offline lehnt stattdessen ab). --find passt ganze Wörter, unterscheidet Groß- und Kleinschreibung, wenn das Wort Großbuchstaben hat, mit --context Zeilen um jeden Treffer.

Ein Abruf eines Designs oder eines Bauteils darin protokolliert, was es verwendet hat, in datasheets.toml im Projektstamm:

[[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 warnt (Regel datasheet) für ein Bauteil mit einer mpn, das keine Datenblatt-URL auf seinem Symbol oder Bauteil hat und keinen Eintrag hier, und für ein Bauteil, dessen letzter Abruf kein Datenblatt fand. Die Lösung ist das PDF des Nutzers über datasheet add, oder eine funktionierende URL.