最快、最稳妥的解决方案是使用 Miniconda。它可以直接帮你下载一个独立的 Python 3.10 环境，完全绕过 Ubuntu 的 apt 系统。

请依次执行以下步骤（百分之百能解决 Python 版本问题）：

第一步：下载并安装 Miniconda

这会安装一个独立的包管理器。

下载安装脚本

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
(注：如果你是甲骨文 ARM 机器，请把上面的链接换成 https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh)

运行安装

bash Miniconda3-latest-Linux-x86_64.sh
按 Enter 查看协议（一直按或者按 q 跳过）。

输入 yes 接受协议。

按 Enter 确认安装路径。

最重要的一步：最后它会问 Do you wish the installer to initialize Miniconda3...，一定要输入 yes 并回车！

激活环境

source ~/.bashrc
(执行完这行，你的命令行前面应该会出现 (base) 字样)

第二步：创建一个 Python 3.10 环境

现在我们可以像点菜一样直接要一个 Python 3.10。

conda create -n filebox python=3.10 -y

第三步：激活新环境

conda activate filebox
(此时命令行前面会变成 (filebox)，说明你现在已经在使用 Python 3.10 了)

验证一下：

python --version
# 必须显示 Python 3.10.x

第四步：重新安装项目依赖并启动

现在环境好了，最后重新跑一遍项目流程：

# 进入项目目录
cd /opt/filebox/FileCodeBox

# 安装依赖 (conda 环境里不需要再创建 venv 了，直接装)
pip install -r requirements.txt

# 启动
python main.py