在 DSH 环境中开发 PCB 设计 Agent 时，需要按型号或描述查找电子元器件。现有路径是起 bash 进程让模型现写 curl 脚本调搜索引擎，存在每次调用都起进程昂贵且错误率高、结果不可结构化、无法保证可设计性（器件不一定有 EDA 模型）等问题。本插件封装芯灵 queryPage 搜索接口为一次函数调用，毫秒级返回结构化 JSON，默认过滤出带 EDA 模型的器件，保证结果可直接用于 PCB 设计。
插件介绍¶
dsh-tool-pcb-parts-search 是一个 DSH PCB 元器件搜索工具插件。插件按关键词搜索 IC / 有源 / 无源电子元器件，用于 PCB 设计与 EDA 选型。由 Huaqiu-Electronics 维护，许可证为 MIT。
核心能力¶
- 元器件搜索：按关键词搜索 IC / 有源 / 无源电子元器件。
- 结构化数据：返回包含 mpn, mfgid, description, datasheet 的 JSON 数据。
- EDA 模型过滤：默认只返回带原理图符号 / PCB 封装的器件。
- 安全与健壮性：
- 入口参数双重校验（keyword 长度、page_size 范围、require_eda_model 类型）。
- HTTP 状态码 + 业务 code 双重校验。
- 仅向白名单域名 eda.cn 发送请求。
- 防御性结构解包与字段白名单过滤。
安装与启用¶
使用官方安装命令将插件加入 DSH Profile：
dsh plugin --profile web add <repo-or-tarball>
dsh plugin --profile headless add <repo-or-tarball>
安装后，插件会自动注册 pcb_parts_search 工具。
使用方法¶
工具支持以下参数：
* keyword：必填，搜索关键词（型号或描述），长度限制 200 字符。
* page_size：可选，返回条数，范围 1-50，默认 5。
* require_eda_model：可选，是否只返回带 EDA 模型的器件，默认 true。
调用示例：
pcb_parts_search { keyword: "STM32F103C8T6" }
pcb_parts_search { keyword: "0402 10k resistor", page_size: 10 }
pcb_parts_search { keyword: "LM358", require_eda_model: false }
限制与注意事项¶
- 搜索方式：仅支持关键词模糊搜索，非 MPN 精确查询。需要精确定位时需在返回结果中二次过滤。
- 数据源：仅查询芯灵 eda.cn，不聚合其他元器件平台。
- 网络依赖：需要网络访问第三方接口，离线环境不可用。
- 返回字段：不包含库存、价格、封装尺寸等采购信息。
总结¶
该插件通过封装芯灵接口，为 DSH Agent 提供了标准化的 PCB 元器件搜索能力，解决了 Agent 在 EDA 选型时获取结构化数据难、缺乏 EDA 模型的问题。源码及更多信息请访问 GitHub。
