前言
在编写电子电路、信号处理相关的技术博客时，经常需要将示波器屏幕截图插入到文章中。传统的手动截图方式效率低下：需要手动操作示波器保存截图、选择文件、上传图片、手动调整格式。今天介绍一个基于Python的自动化工具keysightpf.py，可以一键从Keysight示波器获取图像并自动插入到CSDN编辑器中。
工具简介
keysightpf.py是一个专为Keysight示波器设计的自动化脚本，具有以下特点：
- 自动获取示波器图像：支持通过浏览器或SCPI协议获取图像
- 完整屏幕截图：获取包含坐标轴的完整示波器屏幕（876×562），而非仅显示区域
- 自动插入CSDN：一键将图像插入到CSDN编辑器
- 智能图号管理：自动生成和递增图号
- DOP集成：支持集成到自定义绘图面板
- 灵活的参数控制：支持标题、宽度、对齐方式等多种样式
功能演示
1. 基本使用
最简单的使用方式：从默认示波器（192.168.0.6）获取图像并插入CSDN编辑器：
keysightpf k指定IP地址后缀：
keysightpf k6# 从192.168.0.6获取图像keysightpf k106# 从192.168.0.106获取图像下面是实际效果：执行keysightpf k 6后，示波器截图会自动插入到光标位置。
2. 自动图号功能
脚本可以自动检测文档中的标题层级，生成对应的图号：
keysightpf k6.# 自动生成图号keysightpf k6.标题# 自动生成图号并添加标题keysightpf k61.2.3# 使用指定图号1.2.3从不同级别的标题开始检测图号：
keysightpf k6+# 从####开始检测keysightpf k6=# 从###开始检测keysightpf k6|# 从######开始检测▲ 图3.1 正弦波3. 图片样式控制
添加标题：
keysightpf k6正弦波输出# 添加标题"正弦波输出"▲ 正弦波输出设置图片宽度：
keysightpf k6=800# 设置宽度为800像素添加副标题：
keysightpf k6|频率1kHz# 添加副标题"频率1kHz"▲ 图3.3.2 频率1kHz4. DOP集成
DOP（Draw Object Panel）是自定义绘图面板，支持更丰富的图像处理：
keysightpf k6*# 仅粘贴到DOPkeysightpf k6## # 粘贴到DOP底部keysightpf k6### # 智能裁剪+粘贴到DOPkeysightpf k6**# 智能裁剪模式+粘贴到DOP底部▲ 图4结合opengf命令进行箭头标注：
keysightpf k6># 粘贴到DOP+执行opengf >（单箭头）keysightpf k6>># 粘贴到DOP+执行opengf >>（双箭头）keysightpf k6<# 粘贴到DOP+执行opengf <（反向单箭头）5. 其他功能
仅复制到剪贴板：
keysightpf k6#从剪贴板文件获取图像：
keysightpf k6c左侧文本模式：
keysightpf k6ii# 左侧宽度160带文本keysightpf k610|text# 左侧宽度10带文本操作后关闭窗口：
keysightpf k6text.技术实现
图像获取方式
脚本支持两种图像获取方式：
浏览器截图（推荐）：通过Selenium浏览器自动化工具，截取示波器Web界面，获取完整屏幕图像（876×562），包含坐标轴等完整信息。
SCPI协议：通过TCP连接示波器，发送SCPI命令
:DISPlay:DATA? PNG获取图像数据，仅获取显示区域（800×512）。
浏览器降级策略
为了保证兼容性，脚本采用浏览器降级策略：
- Edge系统驱动（优先）
- Edge下载驱动（备选）
- Chrome（最后备选）
智能等待优化
使用WebDriverWait等待页面完全加载，仅需3-5秒即可完成截图，相比早期的20秒固定等待有显著提升。
使用环境
依赖库
pipinstallselenium webdriver-manager pillow pyautogui win32clipboard示波器配置
确保示波器网络配置正确：
- IP地址：192.168.0.x
- Web服务：端口80
- SCPI服务：端口5025
完整命令参考
| 命令 | 功能说明 |
|---|---|
keysightpf k | 从192.168.0.6获取图像 |
keysightpf k 6 | 从192.168.0.6获取图像 |
keysightpf k 106 | 从192.168.0.106获取图像 |
keysightpf k 6 . | 自动生成图号 |
keysightpf k 6 . 标题 | 自动生成图号并添加标题 |
keysightpf k 6 1.2.3 | 使用指定图号1.2.3 |
keysightpf k 6 + | 从####开始检测 |
keysightpf k 6 = | 从###开始检测 |
| `keysightpf k 6 | ` |
keysightpf k 6 标题 | 添加标题 |
keysightpf k 6 =640 | 设置宽度为640 |
keysightpf k 6 [ | 左对齐 |
keysightpf k 6 ] | 右对齐 |
| `keysightpf k 6 | text` |
keysightpf k 6 * | 仅粘贴到DOP |
keysightpf k 6 ## | 粘贴到DOP底部 |
keysightpf k 6 ### | 智能裁剪+粘贴到DOP |
keysightpf k 6 ** | 智能裁剪模式+粘贴到DOP底部 |
keysightpf k 6 > | 粘贴到DOP+执行opengf > |
keysightpf k 6 < | 粘贴到DOP+执行opengf < |
keysightpf k 6 # | 仅复制到剪贴板 |
keysightpf k 6 c/C | 从剪贴板文件获取图像 |
总结
keysightpf.py是一个高效的示波器截图工具，能够显著提升编写技术文档的效率。通过简单的命令，即可实现从示波器获取图像到插入CSDN编辑器的全自动化流程。
参考资源
- Selenium官方文档：https://www.selenium.dev/documentation/
- SCPI标准：https://www.ivifoundation.org/docs/scpi-99.pdf
作者：Dr. BaiChao
日期：2026年2月10日
