谷雨PCBA

告别纸质图纸
PCBA样品装配与调试
变得简单高效

不装软件、不泄漏源文件、不依赖硬件工程师。
打开浏览器，即可实现PCB与原理图联动、精准定位元件。

⚡ 立即在线体验 ↓ 下载安装包
http://try.ghostyu.com
软件截图
~12 MB
单文件，零依赖部署
浏览器
客户端无需安装任何软件
中文不乱码
UTF-8 / GBK 编码自动识别
PDF 原理图
与 PCB 视图双向联动
你是否也遇到这些问题

硬件人面临的三大困境

每一项都在消耗工程师宝贵的时间与精力

01
📋
又慢又容易出错
纸质 BOM 对着丝印图逐一核对，上百个元件耗时费眼，贴错了还不知道，返工代价高。
02
🔒
离不开 EDA 与源文件
查一张原理图得先装 EDA 软件、再要源文件，核心文件很容易泄漏，数据安全无法保障。
03
🏝️
图纸成了信息孤岛
软件、测试、售后都需要查图纸，却只能等硬件工程师中转，工具门槛高效率低。
核心功能

三项功能，对症解决三大痛点

🎯 功能一

元件一键定位
告别纸质图纸

导入 BOM 和元件坐标文件，点击清单中任意一个元件，PCB 丝印图上对应位置立即以动态光圈高亮显示。支持顶层 / 底层双面切换，点击 PCB 图上任意位置还能反查元件信息。

  • 支持按位号精确搜索或型号模糊搜索
  • 点击 PCB 任意位置反查该处元件
  • 顶层 / 底层丝印图一键切换，点击BOM自动跟随切层
  • CSV 自动识别 UTF-8 与 GBK 编码，无需转换
TOP BOM 坐标 ⚡ C1 C2 U1 R1 R2 BOM 物料清单 位号 型号 层 C1 100nF TOP C2 10µF TOP R1 10kΩ TOP U1 ESP32-S3 TOP
🔗 功能二

PCB / 原理图双向联动
支持所有 EDA 软件

导入 PDF 原理图，即可与 PCB 视图实现双向跳转联动。全程不需要 PCB / 原理图源文件，只要截图和 PDF 文档，硬件源文件永远不用外发。

  • 点击 PCB 元件 → 原理图自动翻页定位
  • 点击原理图元件 → PCB 对应位置高亮
  • 全程只需 PDF 和截图，无需任何 EDA 源文件
  • 软件 / 测试 / 售后人员均可在浏览器直接查阅，零门槛
PCB 丝印图 U1 C1 R1 ⇄ PDF 原理图 第 1 页 / 3 VCC IO0 IO2 GND TX RX EN U1 ESP32-S3 C1 100nF R1 10kΩ
⚡ 功能三

配置一次，全员开箱即用

管理员将 BOM、坐标、丝印图、原理图路径写入一个 JSON 配置文件，发给团队成员。成员打开浏览器点击闪电按钮，所有资源秒速加载完毕。

  • 一个 JSON 文件涵盖所有项目资源路径
  • 原始文件集中管控于服务器，普通用户无需接触
  • 天然实现权限隔离，知识产权安全无忧
  • 支持本机 / 局域网 / 云服务器三种部署方式
PCB BOM 坐标 ⚡
📄 AnyName.json ✓ 已选择
bom.csv
✓
coord.csv
✓
top.png
✓
sch.pdf
✓
✓ 4 项资源加载完成，开箱即用
使用流程

四步上手，三分钟完成首次使用

1
下载安装包
获取 .exe 和 license.lic
→
2
双击启动
控制台显示服务地址
→
3
浏览器访问
输入 IP:8080 登录
→
4
点击 ⚡ 导入
选择 JSON 配置文件即可
灵活部署

三种部署方式，按需选择

💻
本机部署
双击运行，浏览器访问 localhost:8080，仅本机可用，零配置，适合个人使用或临时体验。
个人开发 · 单台调试
🏭
局域网部署
一台机器运行，全办公室 / 工厂通过浏览器访问。项目文件统一维护，多人共享使用。
办公室 · 工厂 · 研发团队
☁️
云服务器部署
部署到任意云服务器，通过公网 IP 从任意地点访问，适合异地团队、供应商、售后工程师。
远程异地 · 更加灵活
使用指南

从零开始，三分钟跑起来

覆盖安装部署、项目配置、日常操作与常见问题，开箱即用。

💻系统要求

服务端（运行程序的电脑）

项目要求
操作系统Windows 10+ 或 Linux
内存512 MB 以上
网络局域网或公网均可

客户端（访问的设备）

项目要求
浏览器Chrome / Edge 90+
安装无需安装任何软件
网络能访问服务器即可

📦安装步骤

  1. 前往官网下载页，获取对应平台压缩包，解压得到三个文件：
    pcba-assistant.exe（Windows）或 pcba-assistant（Linux）、 license.lic
  2. 将两个文件放在同一目录下，例如 D:\pcba\（Windows）或 /opt/pcba/（Linux）
  3. Windows：双击 pcba-assistant.exe 运行。
    Linux：先授权再运行：chmod +x pcba-assistant && ./pcba-assistant
  4. 控制台显示 Server running at http://0.0.0.0:8080 即启动成功，控制台窗口保持开启
  5. 打开浏览器访问： 本机 → http://localhost:8080， 局域网其他设备 → http://[服务器IP]:8080
  6. 登录页输入默认账号 admin / changeme，登录后立即在 config.json 中修改密码
首次启动后程序会自动生成 config.json 和 projects/ 目录，无需手动创建。

🌐三种部署方式

方式适用场景访问地址
本机部署 个人使用、单台电脑调试 http://localhost:8080
局域网部署 同一办公室/工厂多人共用 http://192.168.x.x:8080
云服务器部署 异地团队、供应商、远程售后 http://公网IP:8080
局域网部署需在服务器防火墙添加 TCP 8080 入站规则，且服务器不能进入休眠状态。

📁项目需要哪些文件？

文件格式必填说明
BOM 物料清单.csv✅含位号、封装、元件型号
元件坐标文件.csv✅含位号、层别、X/Y 坐标
顶层丝印图.png / .jpg✅PCB 顶层截图，边缘须与 PCB 实际边缘对齐
底层丝印图.png / .jpg可选PCB 底层截图，同上要求
原理图.pdf可选从 EDA 工具导出的 PDF
PCB 丝印图截图要求：
① 图片四条边必须紧贴 PCB 实际边缘，不能有多余白边；
② 坐标文件原点（0,0）应位于 PCB 左下角。若有偏差，在 JSON 配置中设置 originOffset 补偿。

📋CSV 字段名称对照（自动识别）

工具会按顺序依次查找备用列名，首个匹配的列立即生效，无需修改导出文件。

BOM 文件

字段支持的列名（从左到右优先）
序号No. no id 序号
位号Designator designators component 位号
型号Part Value PartValue value name comment
用量Quantity qty amount 数量
封装Footprint package 封装

坐标文件

字段支持的列名（从左到右优先）
位号Designator component RefDes 位号
X 坐标Center-X(mm) Mid X x PosX
Y 坐标Center-Y(mm) Mid Y y PosY
层别Layer Side 层（含 bot/b → 底层）
分隔符支持逗号（,）和分号（;）；表头不必在第一行，工具会自动定位。

⚡创建一键导入配置文件（project.json）

管理员将以下内容保存为 .json 文件，发给使用者即可（文件可放在任意位置，如桌面或共享盘）。

{
    "pcbSize":   { "width": 120.5, "height": 85.0 },
    "bom":       "/projects/项目A/bom.csv",
    "coord":     "/projects/项目A/coord.csv",
    "pcbTop":    "/projects/项目A/top.png",
    "pcbBottom": "/projects/项目A/bottom.png",
    "schematic": "/projects/项目A/schematic.pdf"
}
字段必填说明
pcbSize✅PCB 实际物理尺寸（毫米），用于精确坐标换算
originOffset可选坐标原点偏移（毫米），坐标与丝印图对不上时使用
bom✅BOM 文件路径（/projects/… 代表服务器根目录）
coord✅坐标文件路径
pcbTop✅顶层丝印图路径
pcbBottom可选底层丝印图路径
schematic可选PDF 原理图路径
使用一键导入时，项目文件（BOM、坐标、图片）须统一放在服务器 projects/项目名/ 目录下；project.json 本身可以放在任意位置。

⚡一键导入（推荐）

  1. 打开浏览器访问工具地址
  2. 点击工具栏 ⚡（闪电） 按钮
  3. 选择管理员发给你的 .json 配置文件
  4. 系统自动加载 PCB 图、BOM 表、坐标数据及原理图，即刻可用
一键导入同时起到权限隔离作用——使用者无需接触 BOM、坐标、图片等原始文件。
所有文件均在浏览器本地解析，不会传输到任何服务器，我们不会收集您的任何文件和资料。

🔍元件搜索

模式说明
模糊搜索（默认）输入 C 找所有电容；输入 100nF 找所有该型号元件
精确搜索（勾选复选框）输入 C1 只定位 C1，不匹配 C10、C11

原理图视图中的搜索框为全文精确搜索，逐页定位包含该文字的页面。

🔄TOP / BOTTOM 切换

工具栏可手动切换顶层/底层丝印图。

在 BOM 表中点击元件时，PCB 视图会自动切换到该元件所在层并高亮，无需手动切换。

🖱️PCB 图操作

操作效果
滚动鼠标上下滚动 PCB 图
左键拖动平移 PCB 图
工具栏缩放按钮放大 / 缩小
点击元件位置反查该处元件信息，BOM 表自动高亮对应行

🔗PCB 与原理图双向联动

PCB → 原理图

点击 PCB 图上的元件，原理图自动翻页到该元件所在页并用红色圆圈高亮位号。

原理图 → PCB

点击原理图中的元件，PCB 图对应元件位置出现红色呼吸圆点高亮显示。

需要坐标文件包含完整位号，且 PDF 中位号文字可被识别。

🔔版本更新

  1. 程序启动后自动检测新版本；有更新时顶部「谷雨」按钮出现红色小圆点
  2. 点击该按钮，在弹出的「关于」对话框中点击 立即更新
  3. 程序自动下载并替换，约 4 秒后浏览器自动刷新——升级完成
升级不影响 config.json 和 projects/ 中的数据。
用文本编辑器打开 config.json，直接修改 password 字段为新密码，保存后重启 exe 即可。
工具支持 UTF-8（含 BOM）和 GBK 两种编码，一般会自动识别。若仍乱码，用 Excel 或 Notepad++ 将文件另存为 UTF-8 with BOM 格式再导入。
修改 config.json 中的 port 字段为其他端口（如 9090），重启程序。也可通过命令行临时指定： 
.\pcba-assistant.exe -port 9090
请依次排查：
① 服务器防火墙是否放行了对应端口（默认 8080）
② 客户端和服务器是否在同一局域网
③ 访问地址是否使用了服务器的正确 IP（不是 localhost）
在 JSON 配置文件中添加 pcbSize（精确的 PCB 物理尺寸，毫米）和 originOffset 字段： 
{
  "pcbSize":      { "width": 120.5, "height": 85.0 },
  "originOffset": { "x": 2.5, "y": -1.0 }
}
可能原因：坐标文件未加载（重新导入）；或当前显示层与元件所在层不一致（手动切换 TOP/BOTTOM 后重试）。
关于我们

硬件工程师写给自己的工具

无锡谷雨电子有限公司专注于蓝牙通信领域的硬件研发，我们虽然不是软件公司，但我们开发的软件同样实用。

这套 PCBA 辅助工具，最初只是为了解决自己团队在 PCB 贴片、调试、维修中遇到的实际问题，用 AI 辅助开发、供公司内部使用。

后来发现它对所有做硬件的团队都有帮助，于是决定开放给所有创业者免费使用。

如果这个工具帮助了你，欢迎购买企业授权支持我们继续迭代——虽然我们不强制，但相信每一位有契约精神的使用者。

抖音联系方式 扫码关注抖音 · 联系我们
立即在线体验

现在就体验一下？

无需注册、无需安装，打开浏览器即可体验完整功能，内置示例项目开箱可用。

在线试用：try.ghostyu.com
账号：test | 密码：test123
⚡ 立即在线体验 ↓ 下载安装包
抖音联系方式

扫码关注抖音账号

↑