Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/new-user-install-review-20260725.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

从没有 CX-Codex 运行环境的 Windows 状态出发,按 README 的一行命令已经能够完成安装、构建、启动、免费临时公网访问、密码登录、发送消息和接收回复。

首次源码预览安装最终成功用时 153.5 秒。正式 2.5.6 已完成公开资产与安装回归,并补上仅限本机的二维码配对页。正式 2.5.7 修复了外层 PowerShell 捕获安装 JSON 时调用脚本不退出的问题;后续公开资产回归又发现安装器可能在公网验证仍为 `verifying` 时提前返回 `ok=false`,2.5.8 候选已改为等待运行时真正 `ready`。项目仍不能称为真正“傻瓜式”,主要差距变为:下载阶段缺少连续进度、首次工作区选择不够明确,以及手机扫码后仍需手动输入密码。
首次源码预览安装最终成功用时 153.5 秒。正式 2.5.6 已完成公开资产与安装回归,并补上仅限本机的二维码配对页。正式 2.5.7 修复了外层 PowerShell 捕获安装 JSON 时调用脚本不退出的问题;后续公开资产回归又发现安装器可能在公网验证仍为 `verifying` 时提前返回 `ok=false`,正式 2.5.8 已改为等待运行时真正 `ready`,并完成最新公开资产复测。项目仍不能称为真正“傻瓜式”,主要差距变为:下载阶段缺少连续进度、首次工作区选择不够明确,以及手机扫码后仍需手动输入密码。

## 测试边界

Expand Down Expand Up @@ -58,14 +58,14 @@
| 浏览器发送 | 已发送 |
| 浏览器接收 | 收到“新人安装验证成功” |
| 实时连接 | 正常 |
| 正式 Release 首次安装 | 2.5.3 通过 |
| 正式 Release 首次安装 | 2.5.3 建立基线;最新 2.5.8 公开资产一步安装通过 |
| 运行中升级与同版本重复升级 | 2.5.3 通过 |
| 默认保留数据卸载与重装 | 2.5.3 通过;2.5.4 正式版关闭超时误警告 |
| 正式五进程无警告卸载 | 2.5.4 通过 |
| Quick Tunnel 瞬时不可达恢复 | 正式 2.5.5 自动重试一次 |
| 本机二维码配对 | 正式 2.5.6 已通过真实解码和公网 404 验证 |
| PowerShell 捕获安装 JSON | 正式 2.5.7 已在外层变量捕获、真实服务健康、三项公网鉴权和官方卸载链路中通过 |
| 安装结果等待公网就绪 | 2.5.8 候选已在真实 7420 源码安装中等待到 `ready` 后返回,三项公网验证全部通过 |
| 安装结果等待公网就绪 | 正式 2.5.8 已从公开 Release 安装到 `ready` 后返回,三项公网验证全部通过 |

## 实测发现并已经修复

Expand All @@ -81,7 +81,7 @@
10. `StartNow` 使用通用日志时可能被已有实例占用。现在使用端口级启动日志,并用真实健康与卸载关停作为 Windows CI 门禁。
11. 正式 2.5.1 首次安装成功后,重复执行原命令会因旧服务占用安装目录而无法原子替换。2.5.2 已停止目标父服务与隧道,但正式回归又发现 `codex.exe` 子进程可能继续持有目录;2.5.3 改为停止整棵受管进程树、有限重试,失败时自动恢复旧服务。
12. 安装 JSON 被外层 PowerShell 变量或自动化管道捕获时,常驻 Node 服务可能继承原生进程作业或输出句柄,导致 JSON 已产生但调用脚本不退出。2.5.7 改由 CIM 创建隐藏 worker,再由 worker 启动带独立日志句柄的服务;回归要求外层捕获退出后服务继续健康,并可由官方卸载完整停止。
13. 正式 2.5.7 公开资产首次安装中,本机健康已通过、Quick Tunnel 几秒后也完全可用,但安装器在运行时仍为 `verifying` 时读取了一次状态并返回 `ok=false`。2.5.8 候选会持续等待 `active + ready + health + HTTP auth + WebSocket auth`,并给瞬时公网失败重试保留约 4 秒窗口。
13. 正式 2.5.7 公开资产首次安装中,本机健康已通过、Quick Tunnel 几秒后也完全可用,但安装器在运行时仍为 `verifying` 时读取了一次状态并返回 `ok=false`。正式 2.5.8 会持续等待 `active + ready + health + HTTP auth + WebSocket auth`,并给瞬时公网失败重试保留约 4 秒窗口;同一条 README 命令的公开资产复测已通过

## 槽点

Expand All @@ -92,7 +92,7 @@
- 2.5.4 正式版让官方卸载器以子进程优先顺序关闭整棵受管进程树,真实五进程卸载与自动化夹具均无超时警告。
- 正式 2.5.5 在 Quick Tunnel 公网验证完全不可达时自动重试一次,但错误鉴权状态仍立即失败。
- 正式 2.5.6 已提供仅限本机的二维码配对页;正式 2.5.7 已关闭 PowerShell 捕获安装结果时的后台服务句柄挂起。
- 2.5.7 发布后公开安装实测发现并复现了 `verifying` 提前返回;2.5.8 候选源码已在同一台机器以外层变量捕获方式通过真正的 ready 边界。
- 2.5.7 发布后公开安装实测发现并复现了 `verifying` 提前返回;正式 2.5.8 已在同一台机器以外层变量捕获方式通过真正的 ready 边界。
- README 默认使用 Release + SHA-256 链路,不再依赖 `main` 源码归档。
- Release 工作流强制校验标签、`package.json` 和版本说明一致,避免误发错版本。

Expand Down
1 change: 1 addition & 0 deletions tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -13980,6 +13980,7 @@ The pending home conversation must derive `is-turn-in-progress` from its current

### Current automated evidence (2026-07-25)

- 正式 `v2.5.8` 公开资产新人回归通过:官方卸载先保留用户数据与 Codex 登录目录,README 一条命令随后安装 2.5.8;外层 PowerShell 捕获正常退出,stdout 仅一行 JSON,本机服务与 Quick Tunnel 均为 `ready`,公网健康、HTTP 鉴权和 WebSocket 鉴权全部通过。全新隔离浏览器从公网密码页登录,点击可见“新建会话”后进入新会话路由,“开始任务”、消息输入框和设置入口均可见,1254px 视口无横向溢出;临时测试浏览器和诊断日志已清理,未保存公网地址、密码或私人会话内容。
- Windows 产品化源契约要求安装器在输出人类可读结果或 JSON 前等待 Quick Tunnel 运行态,并把 `active + ready + health + HTTP auth + WebSocket auth` 作为唯一成功边界;连续错误快照会保留约 4 秒,覆盖一次瞬时公网失败重试窗口。
- 真实 7420 源码安装已在外层 PowerShell 变量捕获下通过:stdout 仅一行 JSON,安装调用在运行时进入 `ready` 后退出,本机健康与公网健康、HTTP 鉴权、WebSocket 鉴权全部通过,既有 Codex 登录目录保持不变。
- Windows 产品化回归现在从外层 Windows PowerShell 变量捕获真实 `StartNow` 安装器 JSON;要求调用在 60 秒内退出、stdout 仍只有一行 JSON、服务继续存活且 `/health` 返回 200,随后官方卸载必须停止服务并关闭端口,从而直接覆盖正式 Release 安装回归发现的挂起路径。
Expand Down