其他
在 LCSC/JLCPCB 元件库中搜索元件、查库存价格…
当用户提到 LCSC、JLCPCB 元件库、Cxxxxx 编号、生产采购、为 JLCPCB 组装准备 BOM，或需要下载/批量同步数据手册时使用。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
在 LCSC/JLCPCB 元件库中搜索特定
解决思路
- 用 `search_lcsc.py` 按关键词或描述搜索 LCSC/JLCPCB 元件：`python3 <skill-path>/scripts/search_lcsc.py "tactile switch"`。
- 只搜 JLCPCB 基础元件以省上料费：加 `--basic`。
- 按封装和库存过滤：`--package 0805 --in-stock`。
- 查看完整元件详情（制造商、datasheet URL、价格阶梯、参数属性）：加 `--details`。
- 输出机器可读 JSON（用于脚本和 agent BOM 富化）：加 `--json`。
- 按价格或库存排序：加 `--sort price`（或 `stock`）。
- 做参数化类别搜索（结果含封装、库存、价格和参数列）：加 `--category microcontrollers`。
- 通用搜索用 jlcsearch API：`GET https://jlcsearch.tscircuit.com/api/search?q=<query>&limit=20&full=true`。
- 类别搜索用：`GET /resistors/list.json?search=10k+0402` 等（如 resistors、capacitors、microcontrollers、voltage_regulators）。
- 解析 jlcsearch 响应：通用搜索返回 `{"components":[...]}`；类别端点返回 `{"<category>":[...]}`（键名不是 `components`）；类别行的价格字段是 `price1`，`attributes` 是 JSON 字符串。
- 需要制造商、datasheet URL 和价格阶梯时，用 Cxxxxx 直连 LCSC 详情接口：`GET https://wmsc.lcsc.com/ftps/wm/product/detail?productCode=C318884`。
- 调用 API 时保持 0.5s 间隔以尊重速率限制。
- 用 `sync_datasheets_lcsc.py <file.kicad_sch>` 为 KiCad 项目同步/维护 `datasheets/` 目录（生成与 DigiKey/Mouser 相同格式的 `manifest.json`）。
- 用 `--dry-run` 预览将要下载的内容。
- 用 `--force` 重试之前失败的下载。
- 用 `-o ./my-datasheets` 指定自定义输出目录。
- 用 `--parallel 3` 并行下载（3 个 worker）。
- 无 KiCad 项目时用批量模式：`python3 <skill-path>/scripts/sync_datasheets_lcsc.py --mpn-list mpns.txt --output ./datasheets`；每行一个 MPN，跳过空行和 `#` 注释（整行与行内），用 `is_real_mpn()` 过滤通用值并去重；省略 `--output` 时默认输出到当前工作目录的 `./datasheets/`。
- 同步脚本优先用 LCSC 编号（Cxxxxx）做精确搜索，回退到 MPN 关键词搜索。
- 当 jlcsearch 无结果或命中无 datasheet URL 时，回退到 wmsc.lcsc.com API（针对 Cxxxxx）。
- 同步脚本运行 kicad 原理图分析器提取元件、MPN 和 LCSC 编号，接受 MPN/LCSC 编号/其他分销商 PN。
- 同步脚本下载后校验 PDF 内容（MPN、制造商、描述关键词），并增量保存进度以便中断。
- 单次下载用 `fetch_datasheet_lcsc.py --search "GRM155R71C104KA88D" -o datasheet.pdf`。
- 按 LCSC 编号下载：`fetch_datasheet_lcsc.py --search "C14663" -o datasheet.pdf`。
- 直接 URL 下载：`python3 <skill-path>/scripts/fetch_datasheet_lcsc.py "https://wmsc.lcsc.com/..." -o datasheet.pdf`。
- 用 `--json` 获取 JSON 输出。
- `fetch_datasheet_lcsc.py` 使用 `requests` → `urllib` → `playwright` 回退链（不依赖 wget/curl），校验 PDF 头拒绝 HTML 错误页，LCSC URL 失败时回退到其他制造商来源；退出码 0=成功、1=下载失败、2=搜索/API 错误。
- 需要官方 LCSC API 时用它：`https://ips.lcsc.com`，需要 API key + 签名认证，联系 `support@lcsc.com` 申请；多数情况用 jlcsearch 即可。
- jlcsearch 不可用时，直接抓取 LCSC 网站搜索：`https://www.lcsc.com/search?q=<query>`。
- 跨平台交叉参考时用 `mfr` 字段（MPN）到 DigiKey/Mouser 查询。
- MPN 无精确 LCSC 匹配时：按关键参数搜索（如 "100nF 0402 X7R 16V"）。
- 找中国厂商的 pin-compatible 替代。
- 验证规格和封装匹配（即使同一封装尺寸，焊盘尺寸也可能不同）。
- 最后手段：标记为 "consigned" 并单独采购。
- 关注 `is_basic` 字段：JLCPCB 基础件免安装费，扩展件每个 $3。
- 注意 jlcsearch 的 `stock` 是 JLCPCB 组装库存，wmsc 详情的 `stockNumber` 是 LCSC 自己的库存，两者不同。
- jlcsearch 响应不再含 MOQ 和起订倍数，下单前查 LCSC 产品页。
- 中国厂商 datasheet 质量参差，可在 DigiKey 上交叉参考 MPN 获取更好文档。
适用边界 · 注意事项
- 原型（prototyping）阶段优先用 DigiKey/Mouser；LCSC 适合生产采购（JLCPCB/PCBWay 组装板）。
- 当元件不在 LCSC/JLCPCB 库中，或需要精确的官方 LCSC API（需审批）时，此技能覆盖不了。
- jlcsearch API 不可用且直接抓取 LCSC 网站也失败时，无法搜索/下载；BOM 全流程管理或 KiCad 原理图分析应分别使用 `bom` / `kicad` 技能。