Fichas técnicas - referencia de agentee

Ficha técnica de agentee: descarga la ficha técnica de cada componente una vez en una caché compartida, la lee de nuevo como texto y registra lo que usó un diseño.

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) descarga fichas técnicas de componentes una vez en una caché compartida por todos los proyectos y agentes, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS o $XDG_CACHE_HOME la mueven), y las lee de nuevo como texto.

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 ficha técnica de un componente se busca en orden: su campo datasheet en el esquemático, la URL de datasheet de su símbolo, luego la ficha técnica que cada distribuidor con clave lista para su mpn (un campo Maker MPN se divide, y un número de pieza que es el inicio de uno listado, como TMC2209-LA para TMC2209-LA-T, toma su ficha técnica). Las descargas usan un agente de usuario de navegador, reintentan con HTTP 429 y 5xx, siguen una página HTML al PDF que enlaza, y se rinden con un host que tuvo un tiempo de espera una vez para el resto de la ejecución. Solo se conserva un PDF.

Las copias viven en MAKER/MPN/HASH.pdf con un meta.json que guarda la URL, la fuente, el SHA-256, la fecha de descarga y la línea de revisión leída de sus primeras o últimas páginas, de modo que un componente se descarga una vez y una revisión más nueva se sitúa junto a la antigua. text lee una copia con pdftotext -layout y mantiene el texto junto al PDF; nunca toca la red cuando el componente está en caché, y lo descarga primero cuando no lo está (--offline se niega en su lugar). --find coincide palabras completas, sensible a mayúsculas cuando la palabra tiene mayúsculas, con líneas de --context alrededor de cada coincidencia.

Una descarga de un diseño, o de un componente en él, registra lo que usó en datasheets.toml en la raíz del proyecto:

[[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 avisa (regla datasheet) para un componente con un mpn que no tiene URL de ficha técnica en su símbolo o componente y no tiene registro aquí, y para un componente cuya última descarga no encontró ficha técnica. La solución es el PDF del usuario a través de datasheet add, o una URL que funcione.