公式识别和界面库符号冲突

用法按说明分几条。安装时带上图形界面这个附加项。命令行直接运行 pix2tex，可以处理已有图片或剪贴板里的图片。

四条入口不要混着修

图形界面的命令是 latexocr。启动后截图，模型预测出公式，并复制到剪贴板。

接口另一种装法是带上 api 附加项并升级安装。然后用模块方式运行 pix2tex.api.run。这会在 8502 端口起一个演示页。

在代码里从 PIL 引入 Image，从 pix2tex.cli 引入 LatexOCR。打开一张图片，构造模型，把图片传进去，打印结果。说明写模型对较小分辨率更好，会自动缩小输入。

运行后的第一类问题是证书。警告里是 CERTIFICATE_VERIFY_FAILED，本地发行者证书找不到，位置写到 _ssl.c 的 1000 行附近。对话说可以更新证书。临时关掉校验被明确写成不建议用于正式环境。不要把关掉校验当成步骤。

在这台系统的 Python 3.12 安装里，有一条安装证书的命令，位于应用程序目录下的 Python 3.12 里。证书问题先走这一条。它补的是这份解释器找得到的根证书。

第二类是界面库导入失败。动态库缺少一个调试输出用的符号。对话判断是 PySide6 和 PyQt6 可能冲突。两套库都碰底层的界面组件时，会装进彼此对不上的二进制。

处理是先卸掉这两个包，再只装 PySide6。图形界面只需要其中一套。两套留下任何一套的残留，缺符号还会出现。卸的时候用的是包名，不要去删解释器目录里的单个二进制文件。

第三类是值错误：数组有多个元素时，真值不明确，提示改用 any 或 all。这是把数组放进了条件判断。对话猜测和 PIL 与 NumPy 的版本有关，并建议升级 Pillow 和 NumPy。升级是对话给的步骤。错误本身表示条件里出现了数组，升级之后若仍出现，就查是哪一次判断用了数组。

依赖可以先升级安装工具，再按 requirements 升级。仍不行，就新建虚拟环境，在新环境里安装同时带图形界面和 api 的附加项。新环境能排除旧环境里已经装上的另一套界面库。

对话还给了容器图像 lukasblecher/pix2tex，标签 api。运行时把容器的 8502 映射到本机 8502，用完即删。浏览器打开本机的 8502。容器把界面库隔离开，本机的 PySide6 和 PyQt6 不会再撞在一起。

本机命令和容器不要同时绑同一个 8502。先停一个再开另一个。打不开页面时，先看是谁占用了端口，而不是先重装。

证书和界面库是两件事

代码示例里的图片路径是占位。换成你的文件。模型构造没有参数。打印的是模型对这张图的返回。返回前说明已经提到会按较小分辨率处理。

命令行、截图界面、8502 演示和这三行代码是四条入口。证书问题影响需要联网取版本信息的那一步。界面库符号只影响图形界面。数组真值问题出在图像处理过程里。三条不要混成一次重装。

缺符号的报错里会带本机虚拟环境的路径。文章和日志向外发的时候删掉用户目录。留下包名和缺的符号就够判断。

只装 PySide6 之后再运行 latexocr。截图能出结果并进剪贴板，这一条就通了。剪贴板是空的，再看截图有没有真的交给模型，而不是再卸一次包。

8502 上的演示用来看接口是否工作。和本地 latexocr 互为替代。证书若只在检查版本时警告，演示页仍可能打开。以页面能否识别为准，不要只看有没有警告。

升级 Pillow 和 NumPy 之后，用同一张图片再跑一次代码入口。结果应是公式文本。若仍是数组真值错误，把错误栈里真正做判断的那一行找出来。对话没有贴出那一行，不要编一个条件去改。

新虚拟环境要重新安装，不会继承旧环境的包。这是它能避开冲突的原因。建完环境却忘了安装附加项，命令会找不到，那是另一则错误。

容器镜像拉下来再映射端口。本机没有这些依赖也能用 8502。适合界面库怎么卸都还有残留的时候。

安装附加项时，方括号是包的额外功能，不是可有可无的说明。漏了方括号，装上的是不含界面或接口的那一份。命令不存在时先看安装那一行有没有写对附加项。

证书命令只针对这份安装里的 Python 3.12。解释器若来自别的发行，路径会不同。不要对另一份解释器运行这条命令。对话给的就是应用程序目录下的这一份。

临时关校验能让某次请求通过，也会让别的下载失去校验。对话已经说不建议。步骤里不保留这一项。

四条入口里，代码入口最容易确认模型本身。它不经过界面库。界面库缺符号时，先用代码入口看识别是否还能工作。能打印公式，就只修界面库，不要重装模型。