数据手册 - agentee 参考

agentee 数据手册：将每个元件的数据手册获取一次到共享缓存，以文本形式读取，并记录设计中的使用情况。

agentee datasheet（MCP datasheet_fetch、datasheet_text、datasheet_add）将零件数据手册获取一次到每个项目和智能体共享的缓存中，~/.cache/agentee/datasheets/（$AGENTEE_DATASHEETS 或 $XDG_CACHE_HOME 移动它），并将其作为文本读回。

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 字段，符号的 datasheet URL，然后是每个带有密钥的分销商为其 mpn 列出的数据手册（Maker MPN 字段被拆分，并且是列出的零件号开头的零件号，例如 TMC2209-LA 对应 TMC2209-LA-T，采用其数据手册）。下载使用浏览器用户代理，在 HTTP 429 和 5xx 时重试，跟随 HTML 页面到其链接的 PDF，并在主机超时一次后放弃该运行期间的其余部分。仅保留 PDF。

副本位于 MAKER/MPN/HASH.pdf，带有 meta.json，保存每个副本的 URL、来源、SHA-256、获取日期以及从其第一页或最后一页读取的修订行，因此零件仅获取一次，较新的修订版与旧版并排。text 使用 pdftotext -layout 读取副本，并将文本保留在 PDF 旁边；当零件已缓存时，它从不接触网络，当未缓存时，它首先获取（--offline 拒绝）。--find 匹配整词，当单词有大写字母时区分大小写，每个命中周围有 --context 行。

获取设计或其中零件的记录，将其使用的内容记录在项目根目录的 datasheets.toml 中：

[[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 警告（规则 datasheet）对于具有 mpn 但其符号或零件上没有数据手册 URL 且此处没有记录的零件，以及最后一次获取未找到数据手册的零件。修复方法是用户通过 datasheet add 提供的 PDF，或一个有效的 URL。