OpenHands 1.41 的 verify 补上非 happy path,地图控件和浏览器时区也纳入测试
OpenHands 1.41.0 是个让我先看版本号就愣一下的版本。GitHub 的 release tag 写的是 v1.41.0,2026 年 11 月 16 日发。可 PyPI 上的 `openhands-ai` 包,最新是 1.11.0。两条版本轨道各走各的。这是个坑。这篇先讲这个坑,再讲 1.41 真正的增量。
我先给判断。这一版的价值不在新功能,在 verify-openhands 把测试补到了非 happy path。你是在用 OpenHands 做 QA 的团队,或者接了 ACP 的 Claude Code、Codex 用户,值得看。只是偶尔拉起来跑跑 Agent,这版跟你关系不大。
版本分裂,别对着 1.41 去装包
我第一反应是装 1.41.0,结果 `pip index versions openhands-ai` 列出来的最高是 1.11.0。我装了 1 遍,`import openhands` 成功。但 bin 目录里没有 openhands 这个命令行,包结构里也没有 verify、control 这些模块。整个 1.41 的 changelog 说的那些能力,没一样在这个 pip 包里。
pip install openhands-ai --no-deps
python -c "import openhands; print(openhands.__version__)" # 1.11.0
我在本机(macOS arm64,Python 3.13.12)跑出这个结果,版本号就是 1.11.0。我打开包目录核了 1 遍,里面只有 app_server、server、db、analytics 这几个目录,是后端服务库,不是给终端用的 CLI。所以 1.41.0 是 monorepo 的产品版本号,pip 包走另一条 1.x 的轨道。别对着 release tag 去装包。装包会扑空。
verify 补的是"非 happy path"
verify-openhands 这条是最实的改动,PR 编号 19670,它干的事是给 OpenHands 自己的测试补盲区。作者数了一笔账:从 skill 第一版(2026 年 10 月 6 日)到 11 月 11 日,main 进了 228 个 fix commit,131 个是别人写的。其中约 115 个修的 bug,是这个 skill 从来没测出来的。这 115 个漏测,他按用户场景分了六类。
我打开 PR 核了 1 遍这六类。云或企业后端 37 个、启动和状态迁移 20 个、环境 16 个、自动化表单 15 个、真实数据形状 7 个、安全和 ACP 配置 20 个。看这些数字。看明白了吗,问题不在页面没测,在"用户当时处在什么情境"没进测试:一个设置页的按钮,普通路径点一遍没问题,但用户从保存的历史里重开、或者中间切了别的页面,它就崩。
六问法,和 map controls 命令
它给的解法是一份 `references/scenarios.md`,每个子功能过了 happy path 之后,还要问六个问题。这六个问题我抓出来核了 1 遍,问的是:每个控件都操作过了吗、用户会回来看它吗、中间是不是干了别的、过渡长什么样、数据像真实用户吗、跑在用户真实环境吗。核心就一句,happy path 之外的情境才是 bug 藏身处。这是硬伤。
配套还加了一条命令,`control-openhands map controls`。它是 `map testids` 的反向:列出 src 里那些有字面 test id、但没有任何 map 文件提到的交互元素,再归到对应的 family。这条命令我没跑,因为它不随 pip 包分发,只在 monorepo 的开发工具里,但它解决问题的方向很清,专抓"有控件但没进测试图"的死角。
按 agent 报告选推理强度
另一条改动是 ACP 的推理强度,PR 19436。以前 Canvas 没法设 Claude Code、Codex 的 reasoning effort,每次都跑默认档;现在 effort 存成独立的 `acp_effort` 字段,composer 里按 agent 报告的可选档位出 chips,会话中能切。我核了 1 遍它的依赖:要 SDK 1.62.0,云上还要 OpenHands/enterprise 的一个部署,394 个 ACP 相关测试通过。
这一条的价值在"省 token":推理强度越高,烧的 token 越多,让用户在一个简单的重命名操作上切到 low,跟全程跑 max,成本差得不是一点。但它是 ACP 云功能,本地自建 OpenHands 的用不上。这条记牢。
选型,谁该升
| 场景 | 该不该关注 | 理由 |
|---|---|---|
| 用 OpenHands 做 QA、要补非 happy path | 该 | verify 的六问法直接可抄 |
| 接 ACP 的 Claude Code / Codex | 该 | 推理强度能按需切,省 token |
| 本地自建、偶尔跑 Agent | 跳过 | 两条改动都进不了你的部署 |
| 只想装个 pip 包用 CLI | 跳过 | 1.41 的功能根本不在 pip 包里 |
这张表是我的选型建议,不是官方给的。我这次只跑到了"装包加核对版本加读 PR",没起整套 OpenHands,因为它要 Docker 加 LLM key。跑不通就如实说跑了什么,比装成跑通强。
回头把这次实测捋一遍。我跑了 1 遍 `pip index versions openhands-ai` 看到最高 1.11.0,装了 1 遍 `openhands-ai --no-deps` 后 import 成功但没有 CLI,打开了 1 遍包目录确认没有 verify 和 control 模块,抓了 1 遍两个 PR 的正文核出 228 个 commit 和 115 个漏测这两个数。四步里真正卡住的是整套平台要 Docker 加 LLM key,我本机没有,所以没起。这些是我本机的真实记录。
一句话。1.41 的增量不在新功能,在把测试补到非 happy path、把推理强度交给用户按需切。做 QA 和接 ACP 的人该看,其余跳过。
更多推荐

所有评论(0)