企业官网建设流程全解析

Ubuntu22.04 配 QT6.5 缺 xcb-cursor0，这次让 Codex 走 TaoToken 补依赖

Ubuntu 22.04 LTS 上装完 QT 6.5，启动 QT Creator 时若遇到 xcb-cursor0 缺失，手动搜报错往往会在 apt 源、xcb 插件和 QT 安装组件之间来回试。本文换一个排障入口：让 Codex 走 TaoToken（官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=）作为 API 兼容通道，由它来读取报错、生成并执行依赖修复命令。QT Group 账号注册、教育许可证申请、在线安装文件 qt-unified-linux-x64-4.7.0-online.run 的下载和执行都不变；TaoToken 只负责让 Codex 能发起模型请求，不参与 QT 安装。下面按排障顺序拆开：先复现问题，再给 Codex 配 TaoToken，然后贴报错修 libxcb-cursor0，最后验证 QT Creator 和 demo 是否能跑。

原问题与场景：Ubuntu22.04 启动 QT Creator 报 xcb-cursor0 缺失

环境可以概括为：Ubuntu 22.04 LTS、QT 6.5 LTS、通过官方在线安装器安装 QT Creator。安装过程本身可能顺利结束，但第一次启动 QT Creator 时直接退出，终端里出现与 xcb 平台插件相关的提示，关键点是 Qt 6.5 之后加载 xcb 平台插件需要 xcb-cursor0 或 libxcb-cursor0。随后还会提示无法加载 xcb 插件，并列出一些可用平台插件，例如 minimal、eglfs、linuxfb、offscreen、vnc、wayland 等。这个现象容易让人误以为 QT 安装包损坏，其实大多数情况下只是系统缺少运行库。

原始流程里，第 1 步注册 QT Group 账号获取安装包的操作不变。个人、企业试用或学生教育许可证都在 QT 侧完成，和 TaoToken 无关。真正要额外做的，是给 Codex 配一条模型通道，让它帮你分析报错并补依赖。与其在浏览器里反复搜“Ubuntu QT Creator xcb-cursor0 报错”，不如把终端输出原样贴给 Codex，让它先判断系统版本、apt 源状态、包是否已安装，再给出可执行命令。

这里要区分两个层面：QT 本身的安装、许可证、组件选择，仍然按 QT 官方流程走；Codex 只是排障助手，TaoToken 只是 Codex 的 API 兼容通道。不要让模型去改 QT 安装目录，也不要让它替换安装器。排障目标很明确：安装 libxcb-cursor0，让 QT Creator 能重新加载 xcb 平台插件。

TaoToken 前置：给 Codex 准备 API 兼容通道

先打开 TaoToken 官网创建账号，然后进入控制台创建 API Key。这个 Key 后面会填到 Codex 的环境变量里，形如 YOUR_API_KEY。TaoToken 的 API 地址使用 https://taotoken.net/api，不要额外拼错路径。Codex 侧需要改的是 ~/.codex/config.toml，把模型提供方指向 TaoToken。

建议先确认本机已经有 Codex CLI。可以在终端执行：

codex --version

如果没有安装，按 Codex CLI 的官方方式装好后再继续。重点是配置自定义 model provider。TaoToken 提供 OpenAI 兼容接口，所以 Codex 的 config.toml 里要写清楚 base_url、env_key 和 wire_api。model 字段填你在 TaoToken 控制台看到的模型 ID，不要凭感觉填。不同账号可见模型可能不同，以控制台为准。

这个前置步骤不会影响 QT 安装，也不会帮你自动获得 QT Group 许可证。它只解决一个问题：让 Codex 能通过 TaoToken 接收你的排障请求，并返回命令建议或执行计划。配置完成后，再让 Codex 处理 xcb-cursor0 报错，流程会顺很多。

可复制配置：~/.codex/config.toml、环境变量和 libxcb-cursor0 安装命令

先创建或编辑 Codex 配置文件。下面这份可以直接复制，把 MODEL_ID 和 YOUR_API_KEY 替换成真实值：

mkdir -p ~/.codex cat > ~/.codex/config.toml <<'EOF' model_provider = "taotoken" model = "MODEL_ID" approval_policy = "on-request" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat" EOF

然后配置环境变量。临时生效可以这样：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

长期生效可以写入 shell 配置：

echo 'export TAOTOKEN_API_KEY="YOUR_API_KEY"' >> ~/.bashrc source ~/.bashrc

检查变量是否生效：

echo $TAOTOKEN_API_KEY

接下来处理 xcb-cursor0。手动执行时只需要两条核心命令：

sudo apt-get update sudo apt-get install -y libxcb-cursor0

如果你想让 Codex 来补依赖，可以在 Codex 会话里贴入类似提示：

我在 Ubuntu 22.04 上启动 QT Creator 时遇到 xcb-cursor0/libxcb-cursor0 缺失。 请先检查系统版本、apt 源和 libxcb-cursor0 状态，再给出并执行修复： sudo apt-get update && sudo apt-get install -y libxcb-cursor0。 不要修改 QT 安装目录，最后给出重启 QT Creator 的验证步骤。

如果 Codex 因为审批或沙箱限制不能执行 sudo，就由你手动复制命令到终端执行。配置和命令分离是好事：TaoToken 负责模型通道，apt 负责补系统库，QT 安装器负责 QT 本体，三者不要混在一起。

验证请求与成功结果：curl、Codex 和 QT Creator

先验证 TaoToken 通道是否可用。可以用 curl 发一个最小请求，URL 使用 https://taotoken.net/api/v1/chat/completions，模型 ID 换成控制台里的真实值：

curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "MODEL_ID", "messages": [{"role": "user", "content": "只回复 pong"}], "max_tokens": 16 }'

如果返回 JSON 且包含模型回复，说明 Key、Base URL 和模型 ID 基本正确。接着启动 Codex：

codex

在 Codex 里贴入 xcb-cursor0 报错，让它检查 libxcb-cursor0 的安装状态，并执行修复命令。安装完成后验证包状态：

dpkg -s libxcb-cursor0 | grep Status ldconfig -p | grep xcb-cursor

然后重新启动 QT Creator。如果终端里不再出现 xcb 平台插件初始化失败，QT Creator 能正常打开，就进入 QT 的 demo 验证：选择一个默认配置的示例工程，编译并运行。demo 能编译运行，说明 QT Creator 和 xcb 平台插件已经能正常工作。

成功结果可以记成三句话：curl 请求 TaoToken 有正常返回；apt 显示 libxcb-cursor0 已安装；QT Creator 重启后不再报 xcb-cursor0 缺失，demo 可编译运行。注意，TaoToken 不参与 QT 安装，也不改变 QT 许可证状态，它只是在 Codex 排障这条链路上提供 API 兼容通道。

本篇常见错排查：401、404、sudo 和 xcb 插件

排障时不要一上来就重装 QT。xcb-cursor0 缺失是系统运行库问题，重装 QT Creator 往往不会自动补上 libxcb-cursor0。也不要让 Codex 修改 QT 安装目录里的插件文件。正确顺序是：确认 apt 源可用，安装 libxcb-cursor0，验证动态库能被 ldconfig 看到，再重启 QT Creator。如果 Codex 给出了额外诊断命令，例如查看系统版本、检查 DISPLAY、检查 XWayland，可以按需执行。

语义一致CTA：拿 Key、配 Codex、按接入文档验证

本篇是 Ubuntu22.04 配 QT6.5 时的 xcb-cursor0 排障和 Codex 接入场景，所以最后要回到两个动作：先去 TaoToken 创建 API Key，再把 Base URL 配成 https://taotoken.net/api 写进 Codex 的 ~/.codex/config.toml。之后把 xcb-cursor0 报错贴给 Codex，让它协助执行 sudo apt-get install libxcb-cursor0，装完重开 QT Creator 验证。TaoToken 只作为 Codex 的 API 兼容通道，不参与 QT 本身安装。

API Keys 入口： https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

接入文档： https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

如果你后续要长期用 Codex 做 Ubuntu、QT、编译链和 Agent 类任务，可以再看 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite