你改好了文件,内核还在跑旧代码:execute_code 现在会当场告诉你


你让 Hermes 去修一个小 bug:calc_rate() 应该返回 2,现在返回 1。它读了文件、改了代码、用 execute_code 跑了一遍验证,输出还是 1。它再读一次文件,确认改动确实写进去了,然后开始道歉——或者更糟,把正确的代码再“改”一遍,或者干脆放弃说“这个 bug 和环境有关”。

真正发生的事很简单:代码确实改对了,但你看到的 1 来自内存里的旧模块。会话内核把 sys.modules 跨越调用保留着,文件在磁盘上变了,它并不知情。结果看起来完全正常,没有任何东西告诉你为什么。

2026 年 11 月 12 日合并的 PR #153665 让这件事变得可见:execute_code 现在会在结果里点名哪些模块是在内核载入之后被改过的。

一句话说清原理:Python 的 import 是一次性的

在普通脚本里这不成问题:每次 python script.py 都是全新进程,import 从头再来一遍。

execute_code 不是这样。为了让你能“上一格定义的变量这一格继续用”,它把一个内核进程留着,多个单元格在同一个进程里跑。代价就是 sys.modules 里的模块对象一直活着——你的 import calc_rate 发生在它被修改之前,那这个对象就永远是旧的那一版。

于是出现一种特别折磨人的错位:文件内容是对的,read_file 读出来是对的,模型推理也是对的,只有执行结果是旧的。模型没有办法从输出里看出这一点,只能胡乱猜测。

改了什么:每个单元格跑完记一次文件的修改时间

内核现在做两件事:

  • 每个单元格执行完之后,记录本会话里所有被 import 的项目模块的源码修改时间(mtime)。
  • 下一个单元格执行之前,比对一遍:哪些文件的 mtime 变了,就把名字放进结果的 warning 里。

标准库和 site-packages / dist-packages 里的模块直接跳过——你不需要知道 pip 包里发生了什么。扫描读的是每个模块自己的字典,遇到读不动的东西(惰性模块、非模块对象)就跳过,绝不会因为 sys.modules 里有个奇怪条目就让整个单元格失败。模块名来自单元格进程,所以主进程只保留合法的点分标识符,并且按 stdout 同样的规则做敏感信息脱敏。

结果长这样(这是真实跑出来的原文,本地内核放在 warning 字段,远程内核放在 kernel.warning):

Edited on disk after this kernel imported it: calc_rate. If this cell used it
without reloading, it ran the OLD code. Run importlib.reload(<module>) (and
re-import any names taken from it), or call again with reset=true to start
from fresh imports.

用 nvidia/nemotron-3.5-super-vl 在 Nous Portal 上跑同一段提示词,两个分支的对比:

旧行为 新行为
第三个单元格的输出 rate 1 rate 1
第三个单元格的结果 无提示 warning:点名 calc_rate 并给出两种修法
模型自己的复述 “打印了 rate 1,没有警告文字” “打印了 rate 1,并警告:模块在磁盘上被改过……”
内核状态 保留 保留

最后一行是关键:没有丢掉任何东西。变量、import、打开的文件句柄都还在。只是结果多了一个字段。名字只说一次,已经 reload 或重新 import 过的模块不会再被点名。

两种补救办法,代价不一样

办法一:importlib.reload()。 保留变量,重新载入模块:

import importlib
import calc_rate

importlib.reload(calc_rate)
calc_rate.rate()   # 现在跑的是磁盘上的新代码

注意一个细节,警告里也写了:from mod import f 拿到的名字绑定的是旧对象,reload 之后 f 还指向旧的。要么重新 import 一次,要么全部用 mod.f() 的方式调用。

办法二:reset=true。 重开一个内核,从干净的 import 开始。代价是这个会话里的变量全没了——如果你刚花十分钟载入了一个大 DataFrame,别这么做。

为什么不是“改文件就重启内核”

有个更早的 PR(#127819)就是这么做的:只要工作目录下有 .py 文件被编辑,就重启整个内核。听上去很干脆,实际很粗暴——变量、载入的数据集全部丢失,而且哪怕你改的那个文件根本没人 import,也照样重启。

现在的做法更小:内核继续活着,只在真的被 import 过的模块上提示,并且说清代价。这个思路上的取舍也体现在不覆盖的场景里,了解边界比了解功能更有用:

  • 编译扩展(.so / .pyd)和没有 __file__ 的模块不监控。
  • 同一个单元格里先 import 再改文件,不报告——内核分辨不出这和常见的“先写后 import”有什么区别。
  • 同一个单元格里改完再 reload,如果 reload 本身失败了(比如有语法错误),那个单元格的 traceback 里会有错误,但下一个单元格不会再补一条警告。
  • 扫描无法判断这个单元格到底有没有用到那个模块,所以措辞是条件式的(“如果这个单元格用了它而没有重载”),而不是断言。

这对日常工作意味着什么

如果你的工作流是“agent 写代码 → 跑一次 → 看到失败 → 再改 → 再跑”,那这个提示会直接省掉几轮瞎猜。看到这个 warning 的时候,正确的动作是 reload 或 reset,而不是继续怀疑自己的修改。

顺带一提,execute_code 还有另一类“看起来像 bug 其实不是”的情况:循环检测器误杀和编辑重发后的重放。命令层面的完整参数(包括 reset)在命令参考里。

上线状态

PR #153665 于 2026 年 11 月 12 日合并进 main,标题里明确写了它取代 #127819。v0.23.1 发布于 11 月 10 日,不含这次改动;要么等下一个版本,要么从 main 装。官方文档 code-execution.md 里新增的 “Edited modules” 段落随代码一起进了仓库。

更新(2026-11-17):这里说的改动已随 v0.23.2 发布(2026-11-16),hermes update 就能拿到。上文「不在 v0.23.1 里」是发布当时的快照。