Codex 0.166 键盘选区与队列恢复怎么用

Codex CLI 0.166.0(GitHub 标签 rust-v0.166.0,2026-10-29 19:47 UTC)正式带上了 transcript 键盘选区、集成搜索,以及 codex queue --resume。本机装了 @openai/codex@0.166.0,跑过 codex --version、codex --help、codex queue --help 和 codex doctor --help;选区与排队行为对照 Release 与 PR #57221–#57224、#57232。套餐、额度和本地模型接法见 Codex 怎么买、多少钱;短讯见 Codex 0.166 快讯。这里不展开。
环境:Debian box;2026-10-30(北京时间)执行 npm install @openai/codex@0.166.0,codex --version 输出 codex-cli 0.166.0。下文命令可复制。选区快捷键与动作以 Release 与上述 PR 为准;本机只跑了 help/version,没有走付费 API。
前置:升到 0.166.0 并扫一眼命令面
npm 上 @openai/codex 可装到 0.166.0。任选:
# 一次性跑(拉对应平台二进制)
npx @openai/codex@0.166.0 --version
# 或装进全局 / 项目
npm install -g @openai/codex@0.166.0
codex --version
# → codex-cli 0.166.0
本机实测版本行即 codex-cli 0.166.0。顶层 help 已列出 agents、exec、queue、resume、fork、doctor、mcp、plugin 等;无子命令时参数转给交互 CLI。和 0.165 对比的完整变更页:rust-v0.165.0...rust-v0.166.0。
构建元数据(Release Chores):开发与发布构建统一到 Node.js 24.22.1 与 Rust 1.95.0;standalone executor 打进正式 CLI / app-server 包。你本机 Node 不必等于 24 才能跑已发布的 npm 包——本机用 Node 22 也能装出 0.166.0 并打出版本行。

@openai/codex@0.166.0;版本 codex-cli 0.166.0;queue --help 含 --resume;doctor --help 含 --network-only。分步 1:键盘选区——从历史里精确抠一段
长会话里常要引用 Agent 早先打出的报错、补丁或命令输出。0.166 把键盘驱动的 transcript 选区做成正式能力:词、行、页级移动,集成搜索,快捷键可配(Release 首条 New Features)。
PR #57221 把动作写细:
- 词移动:
w/b/e;逻辑行边界;整页与半页滚动;跳到 transcript 头尾;尊重已配置的 pager 绑定。 - 整行选择:
V;交换选区活动端:o。 - 进入选区时若已有鼠标选区,会接过来,再用键盘改范围。
搜索挂在选区模式上(#57222):
/打开 Find;Enter把光标移到匹配处,并扩展当前选区。n找更旧匹配,Shift+n找更新匹配;光标或选区一变,会取消排队中的重复跳转。- 取消新搜索时恢复先前的搜索/光标/选区;空查询复用上一次搜索串。
- 光标对齐到可选 grapheme;离开选区模式时仍保留已展开的匹配上下文。
入口快捷键(#57223):配置键 tui.keymap.global.select_transcript。未改绑定时有隐式「leader + [」——leader 跟你现有 TUI leader 配置走。可显式 remap 或 unbind;与已有绑定冲突时按现有键位处理。选区命令优先于被 remap 的 pager 快捷键。页脚显示选区导航与复制提示,宽度不够时缩略。
离开选区时按住退出键,旧逻辑可能把重复输入灌进 composer 并误提交草稿。#57224 改了输入路由:退出键被消费掉,提交与排队要重新按键;选区外的粘贴在搜索态会被忽略。
异步问答与 transcript 回复的 Markdown 渲染也对齐了(#57259、#57292),选中复制时格式更一致。用法上:先搜索跳到关键字,再用 V 扩成整行或词移动收窄,复制后贴回 composer,当作「只保留这段」的锚点。
分步 2:codex queue --resume——排队后把线程拉回来
本机 codex queue --help 原文要点:
Usage: codex queue [OPTIONS] --thread <THREAD> --message <TEXT>
--thread <THREAD> Session UUID 或精确会话名
--message <TEXT> 要排队的文本
--resume 入队后,尝试在本地 daemon 或所选 --remote
上恢复该线程;恢复失败只警告,入队仍算成功
常见情况:线程已卸下,你还想先塞一条后续指令,再把它拉起来继续跑:
# 把 THREAD 换成会话 UUID 或确切名字
codex queue --thread "$THREAD" \
--message "继续修 failing test,先看最近 git diff,不要扩 scope" \
--resume
PR #57232 补充:
- 已在跑的线程不会被重复拉起。
- 是否 resume 只看线程状态;远程元数据可以带另一操作系统的路径。
- 归档线程拒绝恢复;入队成功但 resume 失败时,退出仍成功并打警告。
远程对准可用 --remote:ws://host:port、wss://…、unix:// 或 unix://PATH;bearer 可用 --remote-auth-token-env 指环境变量名。-c key=value 可覆盖启动配置,但排队消息用的是该线程已有模型。本地还可 -C/--cd 指定工作根。
codex resume(子命令 resume)负责交互会话恢复(默认 picker,可用 --last);queue --resume 是先写入队列消息,再可选唤醒。只想接着聊,用 codex resume --last 更直接。
| 场景 | 更合适的命令 |
|---|---|
| 回到上次交互会话继续聊 | codex resume / codex resume --last |
| 给已有会话塞消息,并尝试唤醒未加载线程 | codex queue … --resume |
| 只诊断连通与 WebSocket | codex doctor --network-only |
| 从历史复制一段精确上下文 | transcript 键盘选区 + 复制 |
| 分叉一份历史另开话题 | codex fork(本版另修了恢复/分叉时审批与权限保留) |
分步 3:安全拦截说明与 doctor --network-only
TUI 侧(#57363、#57365):生物安全与网络安全策略拦截会给出主题说明,并可选更安全的后续提示;说明与错误域不匹配时回退旧错误处理。拦截解释未就绪时先显示临时通知;排队输入在 recourse 等待期间会被暂存。
排障侧本机已确认:
codex doctor --network-only
# 只跑:有效配置、网络环境、provider HTTP、Responses WebSocket
# 跳过库表、MCP 等;配置加载失败则红acted 报错并停止探测
codex doctor --json # 机器可读(脱敏)
codex doctor --summary # 只看分组行与最终计数
另:捆绑、Vertex AI、Amazon Bedrock 模型目录加入 GPT-6.1 Terra(#57293)。目录里有条目,不代表你账号所在区域一定开通,以产品侧为准。修复列表里两条运维向改动也相关:恢复/分叉时保留已确认的审批与权限(#57227);跨 resume/fork 保留推理 Token 记账,避免过早压缩(#57839)。
常见坑
--resume失败仍显示成功:help 写明恢复失败只警告,入队仍成功。CI/脚本别只看退出码;要扫 stderr 警告,或随后用codex resume/codex agents确认线程是否在跑。- 选区快捷键对不上:默认隐式是 leader +
[。若改过tui.keymap.global.select_transcript或解绑,按旧记忆会失效。与 pager remap 冲突时选区优先——先查配置再怀疑功能消失。 - 离开选区误提交草稿:升到 0.166 后 #57224 会吃掉退出键并要求重新按键才提交。若仍复现,先确认
codex --version真是0.166.0(有人全局与 npx 各装一版)。 - 把
queue --resume当成resume:前者必须带--thread与--message;缺一不可。只想继续上次会话,用codex resume --last。 - THREAD 写错名字:help 要求 Session UUID 或精确会话名。模糊名前缀不会自动补全;归档会话会拒恢复。
完成标准
codex --version打印codex-cli 0.166.0。codex queue --help能看到--resume及「失败只警告、入队仍成功」。- 交互会话里能用配置的选区快捷键进入 transcript 选区,并用
/搜索后复制一段历史。 - 对已知
THREAD执行带--resume的queue:消息入队;若线程本未加载,应尝试恢复(失败则有警告)。 - 需要查网时,
codex doctor --network-only能跑完并给出分组结果(或明确的配置错误)。
最后
先升到 0.166.0,用 help 确认 queue --resume 和 doctor --network-only,再在真实会话里练选区复制和排队恢复。发版说明见文末;套餐与本地模型看 系列第 1 篇,短讯见 Codex 0.166 快讯。
- GitHub:openai/codex rust-v0.166.0
- PR #57221:transcript 键盘选区
- PR #57222:选区模式集成 Find
- PR #57232:codex queue --resume
- 本文实测:本机
@openai/codex@0.166.0,codex --version/queue --help/doctor --help(2026-10-30,北京时间)