- name
- uos-printer-driver-downloader
- description
- 本技能用于从统信UOS驱动中心搜索并下载打印机驱动程序。技能包含多个Python脚本，提供分离式和一体化两种使用方式。
打印机驱动下载技能
技能描述
本技能用于从统信UOS驱动中心搜索并下载打印机驱动程序。技能包含多个Python脚本，提供两种使用方式：
- 分离式：先搜索保存列表，再选择下载（适合需要反复选择对比的场景）
- 一体化：搜索下载一键完成（适合命令行和快速下载）
技能组成
脚本文件
1. list_printers.py - 打印机驱动搜索脚本
- 功能：搜索打印机驱动并以表格形式展示所有结果
- 输出：自动保存所有搜索结果到
driver_list.json文件 - 特点：
- 分离式工作流的第一步，保存结果供后续下载 - 支持命令行参数：python list_printers.py LJ2405 - 不传参数时保持交互式输入
2. download_driver.py - 打印机驱动下载脚本
- 功能：从
driver_list.json加载驱动列表，让用户选择后下载 - 输出：下载的驱动程序文件（.deb 格式）到桌面
- 特点：分离式工作流的第二步，默认保存到桌面
3. download_printer.py - 一体化打印机驱动下载脚本
- 功能：搜索并下载一体化，支持命令行参数
- 用法：
python download_printer.py <打印机型号> [下载目录] [--arch <架构>] - 示例：
- python download_printer.py "联想 LJ2405" /Users/yangkaijian/Desktop - python download_printer.py "联想 LJ2405" /Users/yangkaijian/Desktop --arch arm64
- 特点：
- 支持命令行参数，适合自动化 - 自动优先选择指定架构驱动（默认 amd64，可通过 --arch 修改，如 arm64、all） - 单个驱动时自动下载，多个时支持交互式选择 - 自动处理两层下载逻辑（先获取OSS临时链接，再下载真实 .deb 文件）
使用方法
前提条件
确保已安装以下依赖：
pip install requests方式一：分离式使用（推荐用于对比选择）
macOS 系统
# 步骤一：搜索并保存驱动列表（交互式）
/opt/miniconda3/bin/python3 list_printers.py
# 或直接用命令行参数搜索
/opt/miniconda3/bin/python3 list_printers.py LJ2405
# 步骤二：选择并下载驱动
/opt/miniconda3/bin/python3 download_driver.py统信 UOS 系统
# 步骤一：搜索并保存驱动列表（交互式）
python3 list_printers.py
# 或直接用命令行参数搜索
python3 list_printers.py LJ2405
# 步骤二：选择并下载驱动
python3 download_driver.py方式二：一体化使用（推荐用于快速下载）
# macOS（默认优先 amd64）
/opt/miniconda3/bin/python3 download_printer.py "联想 LJ2405" /Users/yangkaijian/Desktop
# 指定 arm64 架构
/opt/miniconda3/bin/python3 download_printer.py "联想 LJ2405" /Users/yangkaijian/Desktop --arch arm64
# 统信 UOS（默认优先 amd64）
python3 download_printer.py "联想 LJ2405" ~/Desktop
# 指定 arm64 架构
python3 download_printer.py "联想 LJ2405" ~/Desktop --arch arm64交互说明
分离式 - 步骤一（搜索并保存驱动列表）：
- 输入打印机型号关键词（如
1102、hp、canon等） - 查看搜索结果表格
- 所有结果自动保存到
driver_list.json
分离式 - 步骤二（选择并下载驱动）：
- 脚本自动读取
driver_list.json文件 - 显示可下载的驱动列表
- 输入序号选择要下载的驱动
- 输入
y确认下载，或n取消
一体化（搜索并直接下载）：
- 自动搜索指定型号的驱动
- 如果只有一个结果，直接下载
- 如果有多个结果，优先选择
--arch指定的架构（默认amd64），未匹配时支持交互式选择 - 自动下载到指定目录（默认为当前目录）
输出说明
表格格式
搜索结果和选择列表都以以下格式显示：
序号 | 架构 | 驱动型号 (Model) | 版本 (Version) | 包名 (Package)
------ | ---------- | -------------------------------------------- | ----------------- | ---------------
1 | amd64 | HP LaserJet Pro MFP M125nw | 1.0.5 | hplip
2 | arm64 | HP LaserJet Pro MFP M126nw | 1.0.6 | hplip保存文件格式
driver_list.json 文件内容示例（驱动列表格式）：
[
{
"deb_id": "12345",
"driver_id": "67890",
"package": "hplip",
"model": "HP LaserJet Pro MFP M125nw",
"arch": "amd64",
"version": "1.0.5"
},
{
"deb_id": "12346",
"driver_id": "67891",
"package": "hplip",
"model": "HP LaserJet Pro MFP M126nw",
"arch": "amd64",
"version": "1.0.6"
}
]下载文件命名
驱动物件文件命名格式：{package}_{version}_{arch}.deb
例如：hplip_1.0.5_amd64.deb
常见问题
Q1：搜索不到需要的打印机驱动怎么办？
- 尝试使用不同的关键词（如型号的一部分、厂商名称等）
- 检查关键词拼写
- 确认打印机确实支持UOS/统信系统
Q2：下载失败怎么办？
- 检查网络连接
- 确认
driver_list.json文件存在且内容正确 - 尝试重新运行
list_printers.py重新搜索
Q3：如何下载多个不同的驱动？
- 分离式：每次下载新驱动前，重新运行
list_printers.py搜索新驱动，这会覆盖driver_list.json文件 - 一体化：直接多次运行
download_printer.py指定不同型号
Q4：下载的文件保存在哪里？
download_driver.py：默认保存到桌面（/Users/yangkaijian/Desktop）download_printer.py：默认保存到当前目录，可通过第二个参数指定目录
Q5：三种脚本如何选择？
| 场景 | 推荐脚本 |
|---|---|
| 需要对比多个驱动后再选择 | list_printers.py + download_driver.py |
| 快速下载，知道具体型号 | download_printer.py |
| 批量自动化下载 | download_printer.py |
API 信息
本技能使用统信UOS官方驱动中心API：
- 搜索API：
https://www.chinauos.com/driver-api/v1/driver/query/list - 下载API：
https://www.chinauos.com/driver-api/v1/driver/download
技术细节
API 参数说明
搜索接口参数：
keyword：搜索关键词source：数据源标识（固定值：2）pageIndex：页码pageSize：每页数量
下载接口参数：
deb_id：DEB包IDdriver_id：驱动ID
下载流程
统信驱动中心的下载 API 采用两层下载逻辑：
- 向
driver-api/v1/driver/download发送请求，获取包含真实 OSS 临时签名链接的 JSON - 解析 JSON 中的
data.url，再请求该链接下载真实的.deb驱动文件
脚本已自动处理该流程，确保下载的是有效的 Debian 安装包。
错误处理
脚本包含以下错误处理：
- 网络连接超时（10秒搜索 / 60秒下载）
- HTTP错误状态码
- 文件写入错误
- JSON解析错误
- 序号超出范围
适用场景
- 在统信UOS系统上安装打印机驱动
- 批量搜索并筛选打印机驱动
- 离线环境下的驱动预下载
- 驱动版本管理与归档
注意事项
- 本技能仅适用于统信UOS系统或兼容其驱动包的Linux发行版
- 下载的驱动文件为
.deb格式，适用于Debian/Ubuntu等系统 - 建议在下载前确认打印机型号与驱动版本的兼容性
- 脚本运行需要互联网连接
- 存储空间需预留足够的驱动物件大小（通常10-50MB）
driver_list.json文件包含完整的驱动信息（deb_id 和 driver_id），请妥善保存