溯源码打码设备对接：示例程序

服务器地址：https://softwareagentcenter.com/trace-code

1. 安装 Python 3.9 或更高版本，然后运行：
   pip install websockets requests

2. 在门户页面申请测试账号，得到 farm_id 和 api_key。

3. 运行示例程序（模拟打码机，不用接真机）：
   python 3_client_farm_printer_sample.py --server https://softwareagentcenter.com/trace-code --farm <farm_id> --key <api_key> --device P1 --print-as text
   喷墨机打 8 位字码用 --print-as text，激光机打二维码用 --print-as qr。

4. 打开门户的「联调控制台」，填入同一个 farm_id 和 api_key，可以看到设备上线、每一条打印回报，
   也可以点「查询打印进度」让服务器实时问设备打到哪一条。

5. 接真机：只改 3_client_farm_printer_sample.py 里 PrinterAdapter.print_code() 一处，
   把模拟打印换成你们打码机的驱动调用。其余逻辑可以照搬，或照 4_protocol_trace_code_ws.md 用别的语言重写。
