Konnect是一款面向 KiCAD 10 的 AI 辅助 PCB 设计插件：单个 Rust 二进制，通过 MCP 协议向 Claude 等 AI 助手暴露 200 多个原理图、布局、布线、审查与制造工具。其中最具实用价值的能力之一，是内置的JLCPCB 本地料件目录——把覆盖 LCSC 全量库存（约 250 万料件）的目录数据库下载到本地，让 AI 助手离线快速完成JLCPCB 元件搜索与有货替代料推荐，帮你把 BOM 里的缺货料、涨价料、冷门料一键换成现货好订的型号。

为什么本地料件搜索值得学

PCB 设计到后期，最消耗时间的往往不是画原理图，而是"找料"：

• 这个电阻/电容/IC 在 JLCPCB 上有没有现货？库存够不够我的打样数量？
• 常用料涨价了，有没有同封装、同参数、更便宜的替代料？
• 供应商停产/下架了，快速换料后还要核对封装是否一致。

传统做法是人工在网页上逐个搜、逐个比价。Konnect 的思路是把整个目录搬进本地：AI 助手直接查库、直接比参数，搜索和换料建议在一次对话里完成。相关实现位于 crates/konnect-core/src/tools/integration.rs，完整的工具清单见 tool-directory.md。

一键下载本地目录：download_jlcpcb_database

所有搜索工具都依赖一个本地 SQLite 数据库（FTS5 全文索引），首次使用前只需让 AI 调用一次download_jlcpcb_database：

1. 从 JLCPCB 目录源（bouni.github.io/kicad-jlcpcb-toolsfeed）读取分片清单；
2. 分块下载（chunk 1…N），带指数退避重试，网络抖动、429、5xx 自动重试；
3. 解压合并成本地current-parts-fts5.db，写入配置默认路径；
4. 之后search_jlcpcb_parts、suggest_jlcpcb_alternatives全部离线查库，毫秒级返回。

几个贴心的细节（见 integration.rs）：

• 单文件上限 1 GB、整库上限 8 GB，防止异常下载拖垮磁盘；
• 会话内相同查询走5 分钟 TTL 缓存，响应中带cached字段，重复查询不再跑 SQL；
• 忘了先下载时，报错信息会直接提示 "Rundownload_jlcpcb_databasefirst"，而不是让你对着一个 250 万料件的目录发呆（这正是 issue #218 的教训）。

下载后还可以用get_jlcpcb_database_stats查看料件总数、最后更新时间与文件体积，随时确认目录新鲜度。

核心工具一：search_jlcpcb_parts 元件搜索

search_jlcpcb_parts是"按关键词找料"的主力工具（工具定义）：

五字段匹配逻辑：每个词都会同时查 Description（描述）、MFR_Part（厂商料号）、LCSC（LCSC 编号）、Package（封装）、Manufacturer（厂商）五列，全部词都命中才返回（匹配实现）。例如：

• "Pin Header 1x7"、"1x7 header pin"、"through hole pin header"三种写法结果一致——词序随便排；
• 词可以跨列拼接，"boomele 2.54mm 1x7"能把厂商、规格、描述拼在一起查；
• %和_被视为字面字符而非通配符，查"50%"不会退化成模糊匹配。

查询词越多，过滤越严格——这是刻意为之：与其返回一堆相似项让你翻，不如一次给准。

核心工具二：suggest_jlcpcb_alternatives 替代料推荐

真正体现"找有货替代料"价值的是suggest_jlcpcb_alternatives（工具定义），它解决的是更具体的问题："我的原理图里已经有这个料、这个封装了，帮我找同参数同封装的现货。"

输入只有两样：

• value：元件参数或料号，如100nF、10k、AMS1117-3.3（按"完整值"整体匹配，100nF不会误中0.1uF）；
• footprint：KiCad 封装 ID（如Capacitor_SMD:C_0402_1005Metric）或直接给 LCSC 封装名（如0402、SOT-23）。

智能在哪：

1. 封装自动翻译：KiCad 封装名（C_0402_1005Metric）会被映射成 LCSC 的封装名（0402）。这是 lcsc_packages.rs 的核心工作——早期版本直接取封装名最后一段（1005Metric），LCSC 目录里根本没有这种名字，导致"标准封装永远查不到料"（issue #785）。现在按芯片尺寸码、命名封装、鸥翼（SOIC/TSSOP）、QFN/QFP 体尺寸等规则映射，连QFN-48-1EP_7x7mm都能对上 LCSC 的UFQFPN-48(7x7)；
2. 分层排序：JLCPCBBasic → Preferred → Extended依次靠前，再比已知价格与库存。Basic 料免过费、Extended 料要按唯一料号加收 setup fee，排序规则直接对应打样成本；
3. 库存门槛：min_stock_count默认 100，建议把打样数量填进去，低于库存下限的料直接剔除；
4. 价格封顶：可选max_price_usd，超预算的料不返回；
5. 响应透明：结果里附带"匹配了哪些 LCSC 封装名、按什么排序、剔除了多少低库存/未知价/超价料"，每条建议都可追溯。

真实目录数据的对照示例见测试夹具 suggest_alternatives.README.md，其中100nFin0402一组就同时展示了 Basic 料、Extended 料与低库存（8~19 片）料的排序效果。

单料详情与数据新鲜度

• get_jlcpcb_part：按 LCSC 编号（如C14663）取单个料件的完整字段——描述、厂商料号、封装、价格、库存、datasheet 链接；
• get_jlcpcb_database_stats：料件总数、最后更新时间、文件体积；
• enrich_datasheets/get_datasheet_url：通过 LCSC API 批量补齐原理图里所有元件的 datasheet 字段，选料时直接翻到数据手册。

从搜料到下单：配合制造导出流程

找到有货替代料只是第一步。Konnect 的制造工具链可以接着把BOM和CPL（pick-and-place）一并导出成 JLCPCB 模板格式，整条"换料 → 导出 → 下单"链路见 crates/konnect-core/src/tools/manufacturing.rs，官方技能文档给出完整操作规范：

• 技能总览：kicad-manufacture/SKILL.md
• JLCPCB 订单契约核对清单：references/jlcpcb-rules.md

工作流建议：先用search_jlcpcb_parts/suggest_jlcpcb_alternatives产出候选料，再按 jlcpcb-rules.md 的要求在下单页核对厂商料号、封装、类别与库存，最后把 BOM/CPL 与门户模板逐项比对后再支付。

常见坑与最佳实践

写在最后

Konnect 的 JLCPCB 元件搜索不是"把官网搜索封装成一个工具"，而是把 250 万料件的目录做成本地 SQLite 全文索引：search_jlcpcb_parts做关键词粗筛，suggest_jlcpcb_alternatives用封装映射 + 参数整体匹配 + 分层排序做精筛，两者配合get_jlcpcb_part与制造导出，让"找有货替代料"从网页翻页变成 AI 对话里的几秒钟。装上 Konnect，把找料交给目录，把时间留给设计本身。

延伸阅读：README.md 中的安装方式与工具总览、docs/KICAD_INTEGRATION.md 的 KiCAD 集成说明、crates/konnect-core/src/tools/lcsc_packages.rs 的封装映射规则。