秀秀 3.234 专项修正 - 守一替身X军团美国出口、Codex持久登录与自动恢复

记录日期：中国时间 2026-08-26；不可覆盖快照 ID：648b7f552f589b2f035e50a897f8715995341735c3affc4ac8bae41675f8d2f1

记录完整性：详细记录待补齐：原因判断、采用方法、数据/调用链路、兼容保护

## 秀秀 3.234 专项修正 - 守一替身X军团美国出口、Codex持久登录与自动恢复

- 建立时间：2026-08-26 CST。
- 详细记录标准：v1。
- 修改范围：仅守一替身虚拟机的X军团Codex出口、登录与桌面授权入口；不修改其它服务器、普通业务BOT、群聊、数据库业务内容、EasyTier或秀秀公网入口。
- 修改目的：使用指定订阅中的美国节点作为GPT/Codex唯一出口，恢复X军团Codex真实调用；实现断网后的健康检测、订阅刷新、代理重连、开机自动恢复与已授权账号的持久登录。
- 根本原因：旧出口虽能建立部分HTTP连接，但Codex设备授权与刷新请求不稳定；X Worker使用`socks5h://127.0.0.1:17891`时，Codex CLI无法稳定完成设备授权请求。桌面旧“Codex设备授权”又把凭据写入桌面账号的`.codex-manual`，而生产X Worker读取`/var/lib/xiuxiu3-x/codex-home`，形成网页登录与生产执行登录态分离。
- 修改逻辑：订阅只提取受支持的美国节点，忽略订阅自带DNS、路由、控制器和其它地区节点，生成最小化Mihomo配置；Codex执行改走同一节点的HTTP CONNECT端口17890，浏览器仍可保留17891 SOCKS端口。代理每小时刷新订阅，每2分钟检查设备授权接口，连续失败3次才刷新配置并重启，避免单次抖动造成频繁切换。
- 自动恢复：`xiuxiu3-x-proxy.service`与`xiuxiu3-x-worker.service`继续开机自启；Worker新增启动前出口等待，出口未恢复时退出并由`Restart=always`重试，不在断网状态抢跑任务。Codex登录态每10分钟巡检；已保存的ChatGPT授权由Codex自动刷新并在重启后复用。账号主动撤销授权或安全策略失效时只告警，不绕过OpenAI安全机制自动重新授权。
- 桌面授权：修复“X军团Codex一键授权”入口，自动打开只走美国节点的隔离Chrome授权页，并通过受限sudo命令把授权写入X军团真实`CODEX_HOME`；sudo权限只允许这一条固定授权脚本，不开放任意root命令。授权凭据权限为0600，归属`xiuxiu3x`，未写入日志、网页或普通备份。
- 改动文件：`/etc/xiuxiu3-x/mihomo-us.yaml`、`/usr/local/sbin/xiuxiu3-x-us-refresh`、`xiuxiu3-x-us-health`、`xiuxiu3-x-wait-egress`、`xiuxiu3-x-auth-health`、对应systemd service/timer、`xiuxiu3-x-worker.service.d/96-http-proxy.conf`与`97-egress-ready.conf`、桌面授权脚本和快捷方式。
- 验证结果：订阅包含5个节点但生产配置只保留1个美国VMess节点，实际公网出口为美国IP；ChatGPT设备授权接口HTTP 200。X军团显示`Logged in using ChatGPT`，真实`gpt-5.6-sol`只读调用返回`X_CODEX_US_OK`。授权文件为0600且位于生产`CODEX_HOME`；重启X Worker后`ExecStartPre`出口等待状态0、Worker与代理均active、登录巡检`X_CODEX_AUTH_HEALTHY`、X002/X016/X017/X018轮询时间持续更新。
- 稳定性边界：当前订阅只有1个美国节点，因此具备自动刷新、健康检测和重连，但没有第二个美国IP可供故障切换；按真人要求不会回退到韩国或其它地区节点。若订阅后续增加美国节点，刷新器会纳入美国节点并使用fallback健康选择。
- 同步与回滚：本项为守一替身X军团专用，不同步其它服务器。回滚目录为`/var/lib/xiuxiu3-x/change-backups/20260826-us-subscription-egress/`；恢复原Mihomo配置、删除新增定时器及Worker drop-in并daemon-reload后重启代理/Worker即可，不恢复数据库或业务文件。