pythonAgent 免安装运行包（Linux / 麒麟统信国产 OS）
=================================================

架构：x86_64
构造方式：内置 CPython + pyatspi（**目标机无需安装 Python**）

使用（两条命令，全程不联网）
----------------------------
1) 解压（**解压出来的目录固定叫 pythonAgent**，Java 侧按这个路径调启动脚本）：
       tar -xzf pythonAgent_linux_x86_64.tar.gz -C /opt
       cd /opt/pythonAgent
2) 启动：
       ./start.sh

   看到 "[pythonAgent] started." 即成功。
   停止 ./stop.sh，重启 ./restart.sh，日志在 logs/agent.log。

关于系统依赖（不需要你手动装）
------------------------------
AT-SPI 运行库（at-spi2-core）由 start.sh **自动离线安装**：
  * 优先用本包 deps/ 里的 .deb（不联网）；
  * 没有管理员权限时自动降级为把库解压到包内私有目录，不碰系统。
  * 实在装不上才会提示人工处理步骤。

  请**不要**执行 `sudo apt install at-spi2-core` —— 那是联网操作，
  在离线客户机上必然失败。本包已自带所需的 .deb。

验证
----
    ./install_deps.sh --check
    runtime/bin/python3.sh src/linux_diagnostics.py

常见问题
--------
* 提示"元素数为 0" -> agent 必须与被测应用在**同一个图形桌面会话**里，
  请在桌面终端启动，不要用纯 SSH。
* 被测 Qt 应用无障碍节点缺失 -> start.sh 已自动导出
  QT_ACCESSIBILITY=1、QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1。
* 红框高亮失效 -> runtime 缺 tkinter，见上面"验证"。
* 需要把诊断信息发给技术支持 -> 见 DEPLOY-GUIDE.md 第五节。
