USER GUIDE

使用指南

获取符号与封装，在 AD 中查找、查看和放置。本文面向 0.6.1-dev.8 邀请测试版。

适用环境：Windows x64 · Altium Designer 24 · .NET Framework 4.8

⚠
这是邀请测试版。请在工程副本上验证；旧版 WorkspaceManager.DLL 闪退尚未确认解决。真实 AD 的加载、连线、放置和更新 PCB 需要测试者验收。
01

安装和打开面板

准备

解压整个安装包

不要直接在 ZIP 内运行。保存所有 AD 工程文件，完全退出 AD，再双击 Install.cmd。按 Windows 提示允许安装程序写入 AD 目录。

未找到 AD24 或找到多个版本时，选择对应安装目录的 X2.exe。安装器不会强制退出 AD。

启动

Panels → LibrarySearch

看到“安装完成”后重新启动 AD，在右下角 Panels 菜单中选择 LibrarySearch。版本可在“更多 → 版本与测试说明”查看。

面板可停靠或浮动。建议宽度至少 340 像素；狭窄时拖宽即可看到更多名称。

02

获取和放置一个元件

  1. 先准备目标工程新建或打开 PrjPcb，加入原理图 SchDoc 和 PCB PcbDoc，执行 File → Save All。
  2. 获取面板选择“在线获取”，输入 C7473159，点击“获取”。首次需要联网；相同编号已下载时直接使用本机版本。
  3. 分类和核对结果可切换“全部 / 原理图 / PCB 封装”。选中一条，点击“查看库”，核对引脚编号、连接点、极性和尺寸。若有转换警告，请优先检查。
  4. 放置符号重新激活目标原理图，选中符号，点击“放置符号”。在画布点击位置，按 Esc 退出。双击结果也可发起放置。
  5. 保存工程插件会先把成对的库文件复制到工程目录，再加入工程。放置完成后执行 Save All。
  6. 更新 PCB按 AD 常规流程执行 Design → Update PCB Document；先检查 ECO，再执行。确认封装可用、引脚与焊盘编号对应。直接放置封装时请先激活 PCB 文档。
查看来源库会切换 AD 的当前文档。继续放置之前，记得点回目标原理图或 PCB 标签页。
03

符号和封装存在哪里

本机元件库和工程随附库各保留一份。面板底部显示当前库目录；在“更多 → 打开元件保存目录”打开。

Windows“文档”\LibrarySearch\
  Components\C7473159\下载版本\
    C7473159.SchLib      原理图符号
    C7473159.PcbLib      PCB 封装
    component.json      型号、关联和文件校验信息
    SOURCE.txt           官方数据来源
    converter.log        本次转换记录
  Index\C7473159.json   “我的元件”使用的索引

你的工程文件夹\
  项目.PrjPcb
  原理图.SchDoc
  电路板.PcbDoc
  Libraries\LibrarySearch\C7473159\内容版本\
    C7473159.SchLib
    C7473159.PcbLib
    SOURCE.txt
    README.txt
常见问题使用方式
以后还能离线用吗？切换“我的元件”，用型号、编号或封装名搜索。首次获取需要联网。
能换保存位置吗？更多 → 更改元件保存目录。新目录用于今后下载；已有下载不自动搬移。原工程内的随附库不受影响。Windows 文档目录可能位于 OneDrive，以面板显示路径为准。
发给同事怎么打包？保存全部后复制或压缩整个工程目录，保留 Libraries 子目录。接收方打开工程并检查库路径及 ECO；不要只发送单独的 SchDoc。
重新获取会覆盖旧库吗？更多 → 重新获取当前元件会创建新版本。旧下载和已放置元件不会自动替换。核对后通过重新放置或 AD 的元件更新流程更新。
卸载会删库吗？不会。安装、回退和取消下载均不删除长期库数据。取消只移除本次未完成的临时文件。
已有本地库怎么办？切换“本地索引”，点击“选择目录”，选择库总文件夹。插件自动扫描子目录中的 SchLib、PcbLib、IntLib，读取真实元件名并生成缓存，不需要 TSV。未变化文件复用缓存；更多 → 刷新本地库可强制重读。本地关联沿用原库，不自动打包配套封装。
3D

随元件获取 3D

在线“获取”会同时尝试下载源库的 STEP，选中元件可见 3D 状态。模型直接内嵌于 PcbLib，随工程库保存，无需配置模型目录。源库无 STEP 或模型下载失败时保留二维库；可从“更多 → 重新获取当前元件”重试。旧二维库继续可用，在线重新获取会尝试补齐模型，已放置元件请通过 AD 的库更新流程更新。

打开封装并切换 AD 的 3D 显示，核对方向、位置和高度。“3D 已内嵌”代表模型已写入，不代表实际对位已经测试。

04

推荐先测这些元件

在线获取以下四个编号，覆盖普通 IC、极性元件、运放和多单元器件四类典型形态，建议优先测试。

从旧版升级时，旧 OnlineCache 目录保持原样，不会自动导入“我的元件”。请在线重新获取需要的元件，以使用修正后的电气端点；原工程仍可访问旧库，但既有符号不会自动更新。

编号重点检查
C7473159TP4057：符号、6 个引脚和配套封装，普通 IC 的浅黄主体。
C51933293LED：空心三角形、两个发光箭头、K/A 和编号，连接点在引脚最外端。
C7433OP07：运放三角形、四方向连接点、引脚名称和封装关联。
C6964TL074：多单元 A/B/C/D、共用封装与电源引脚。U?A 的 A 是单元标记。
每个元件依次测试：获取 → 查看符号 / 封装 → 放置 → 从外侧连接点连线 → 保存 → 更新 PCB → 关闭重开工程 → 断网从“我的元件”复用 → 将整个工程复制到另一个目录并检查路径。
05

出错时如何处理

现象处理
获取失败或超时核对完整编号和联网状态，稍后重试。获取可取消。官方服务缺失的数据无法生成完整配对。
不能放置先激活正确类型的目标文档；在线元件还要求文档属于已保存的 PrjPcb。若刚打开库文件，请切回目标画布。
更新 PCB 找不到封装检查工程下是否有 Libraries 中的 PcbLib，是否已保存全部，符号关联名称是否与封装库内名称一致。记录编号和 ECO 提示后反馈。
符号外观不完整或连接点异常记录编号，截取包含引脚编号和连接点的截图，并说明是否来自最新获取或旧版已放置元件。
AD 闪退先恢复并保存工程；记录时间、最后一个操作和编号。此版本尚未确认解决旧版 WorkspaceManager.DLL 崩溃，请停止在生产工程测试。
06

反馈、日志和回退

点击“更多 → 导出反馈日志”，保存 ZIP。填写其中的编号、AD 完整版本、复现步骤、期望结果、实际结果和是否可重复。可另附截图。

反馈包仅包含有限日志和运行环境，不包含工程或库文件，也不会自动发送。用户目录会替换为 %USERPROFILE%；其他文件名和自定义目录仍可能出现在日志里，发送前请检查。

配置：%LOCALAPPDATA%\LibrarySearch\settings.json
日志：%LOCALAPPDATA%\LibrarySearch\Logs\

需要停用或回到旧版时，保存并关闭 AD，双击 Uninstall.cmd。安装前已有 LibrarySearch 时恢复原注册；首次安装时停用测试版。下载库、工程库和备份均保留。

范围

范围与数据来源

本版面向 AD24 的小范围功能测试；当前宿主引用本机 24.3.1.35 接口编译，其他小版本待测试。在线获取会尝试 STEP 并嵌入 PcbLib；无模型时保留二维封装。3D 方向、高度、对位、特殊图形和库格式仍需用户在 AD 核对。安装器和插件尚未签名，随包的 SHA-256 清单用于核对文件完整性。

元件数据来源：嘉立创EDA / EasyEDA 官方库（lceda.cn · easyeda.com）。元件功能、尺寸和电气连接应最终对照厂商数据手册。