uos-printer-driver-downloader（uos 打印机驱动下载器）

打印机驱动下载技能

技能描述

本技能用于从统信UOS驱动中心搜索并下载打印机驱动程序。技能包含多个Python脚本，提供两种使用方式：

1. 分离式：先搜索保存列表，再选择下载（适合需要反复选择对比的场景）
2. 一体化：搜索下载一键完成（适合命令行和快速下载）

技能组成

脚本文件

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：三种脚本如何选择？

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包ID
• driver_id：驱动ID

下载流程

统信驱动中心的下载 API 采用两层下载逻辑：

1. 向 driver-api/v1/driver/download 发送请求，获取包含真实 OSS 临时签名链接的 JSON
2. 解析 JSON 中的 data.url，再请求该链接下载真实的 .deb 驱动文件

脚本已自动处理该流程，确保下载的是有效的 Debian 安装包。

错误处理

脚本包含以下错误处理：

• 网络连接超时（10秒搜索 / 60秒下载）
• HTTP错误状态码
• 文件写入错误
• JSON解析错误
• 序号超出范围

适用场景

• 在统信UOS系统上安装打印机驱动
• 批量搜索并筛选打印机驱动
• 离线环境下的驱动预下载
• 驱动版本管理与归档

注意事项

1. 本技能仅适用于统信UOS系统或兼容其驱动包的Linux发行版
2. 下载的驱动文件为 .deb 格式，适用于Debian/Ubuntu等系统
3. 建议在下载前确认打印机型号与驱动版本的兼容性
4. 脚本运行需要互联网连接
5. 存储空间需预留足够的驱动物件大小（通常10-50MB）
6. driver_list.json 文件包含完整的驱动信息（deb_id 和 driver_id），请妥善保存