Fichas técnicas

agentee datasheet (MCP datasheet_fetch, datasheet_text, datasheet_add) obtém manuais de peças uma vez para uma cache partilhada por todos os projetos e agentes, ~/.cache/agentee/datasheets/ ($AGENTEE_DATASHEETS ou $XDG_CACHE_HOME mudam-na), e lê-os de volta 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

O manual de uma peça é procurado por ordem: o seu campo datasheet no esquema, o URL datasheet do respetivo símbolo, depois o manual que cada distribuidor com uma chave lista para o respetivo mpn (um campo Maker MPN é dividido, e um número de peça que é o início de um listado, tal como TMC2209-LA para TMC2209-LA-T, toma o respetivo manual). As transferências usam um agente de utilizador de navegador, repetem em HTTP 429 e 5xx, seguem uma página HTML para o PDF que ela liga, e desistem de um anfitrião que teve um tempo limite uma vez para o resto da execução. Só um PDF é mantido.

As cópias ficam em MAKER/MPN/HASH.pdf com um meta.json que guarda o URL, a fonte, o SHA-256, a data de obtenção e a linha de revisão lida das primeiras ou últimas páginas de cada cópia, de modo que uma peça é obtida uma vez e uma revisão mais nova fica ao lado da antiga. text lê uma cópia com pdftotext -layout e mantém o texto ao lado do PDF; nunca toca na rede quando a peça está em cache, e obtém-na primeiro quando não está (--offline recusa em vez disso). --find corresponde a palavras inteiras, sensível a maiúsculas quando a palavra tem maiúsculas, com linhas --context em redor de cada correspondência.

Uma obtenção de um projeto, ou de uma peça nele, regista o que usou em datasheets.toml na raiz do projeto:

[[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 (regra datasheet) para uma peça com um mpn que não tem URL de manual no respetivo símbolo ou peça e sem registo aqui, e para uma peça cuja última obtenção não encontrou manual. A correção é o PDF do utilizador através de datasheet add, ou um URL que funcione.