agentee

Elementy

Karty katalogowe

agentee datasheet: pobierz kartę katalogową każdej części raz do wspólnego bufora, odczytaj ją jako tekst i zapisz, czego użył projekt.

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) pobiera datasheety elementów raz do cache wspólnego dla każdego projektu i agenta, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS lub $XDG_CACHE_HOME zmieniają jego lokalizację), i odczytuje je z powrotem jako tekst.

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

Datasheet elementu jest wyszukiwany w kolejności: jego pole datasheet w schemacie, URL datasheet jego symbolu, a następnie datasheet, który każdy dystrybutor z kluczem wymienia dla jego mpn (pole Maker MPN jest dzielone, a numer elementu, który jest początkiem wymienionego, np. TMC2209-LA dla TMC2209-LA-T, bierze jego datasheet). Pobieranie używa user agenta przeglądarki, ponawia przy HTTP 429 i 5xx, podąża ze strony HTML do powiązanego PDF i rezygnuje z hosta, który raz przekroczył limit czasu, na resztę uruchomienia. Zachowywany jest tylko PDF.

Kopie znajdują się w MAKER/MPN/HASH.pdf z meta.json zawierającym URL każdej kopii, źródło, SHA-256, datę pobrania i linię rewizji odczytaną z pierwszej lub ostatniej strony, więc element jest pobierany raz, a nowsza rewizja leży obok starej. text odczytuje kopię przez pdftotext -layout i trzyma tekst obok PDF; nigdy nie dotyka sieci, gdy element jest w cache, i pobiera go najpierw, gdy nie jest (--offline odmawia zamiast tego). --find dopasowuje całe słowa, wrażliwe na wielkość liter, gdy słowo ma wielkie litery, z liniami --context wokół każdego trafienia.

Pobranie projektu lub elementu w nim zapisuje, czego użyto, w datasheets.toml w korzeniu projektu:

[[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 ostrzega (reguła datasheet) dla elementu z mpn, który nie ma URL datasheet na symbolu lub elemencie i nie ma rekordu tutaj, oraz dla elementu, którego ostatnie pobranie nie znalazło datasheetu. Poprawką jest PDF użytkownika przez datasheet add lub działający URL.

docs/format.md · Markdown dla agentów