2026 年 11 月 19 日,Eclipse Theia 维护者宣布推出 1.77,带来多文件差异编辑器、更完善的辅助窗口以及 AI Agent 的变化。开发者每天在建议修改和受影响的工作之间来回切换,这些变化与他们直接相关。公告还有另一群读者,即用 Theia 打造自己开发工具的团队。除了看得见的功能,他们还要处理运行时软件包向 ES 模块迁移的问题。 发布公告
这次更新最值得看的是围绕生成之后的工作所做的改动。一组修改得放得进屏幕,人得找到不太对劲的地方,受打断的任务也得能接着看懂。就算提供建议的模型完全一样,编辑器仍能让这些时刻好应付一些。对采用新版的团队,好的结果是找回上下文更省力,同时底层应用足够可靠,让人能继续审阅。要达到这个结果,升级时应拿熟悉的任务走一遍,尤其要经过团队自己的扩展。
一个版本有几种日期,也有几类用户#
11 月 19 日是公开公告和 Jonas Helming 发布邮件的日期。Eclipse 项目目录中,1.77.0 版本日期记为 11 月 5 日。一名维护者也在 11 月 3 日就 ES 模块迁移发出通知,邀请大家在更广泛的公告前反馈。这些日期对试过预览版、或已经用对应软件包构建的团队很有意义,他们接触变化的时间可能早于新闻。本文讨论的是 11 月 19 日公告及其对采用 1.77 系列的影响。 项目版本记录 · 较早的迁移通知
使用现成的 Theia IDE,与拿平台组装自己的产品,也有类似差别。平台给网页和桌面工具提供框架,可下载的 IDE 是基于框架组装的一种应用。普通用户主要接触命令和控件。产品维护者则要负责周边的软件包、构建设置和服务。同一份公告,对前者可能是一点日常便利,对后者却可能是一次相当大的依赖升级。 Theia 文档
设想一家工程公司,给设备配置格式做了专用编辑器。用户可能从来不打开普通的 JavaScript 项目,维护者依旧得构建工具,把自己的面板接到 Theia 服务上。能让员工一次检查多项配置修改的新功能,可能足以支持升级。但具体要花多少工夫,取决于自定义面板移动时怎样运行、如何保存数据,以及测试对平台作了哪些假设。光看版本号,很难知道这套具体工作会怎样变化。
看开源工具的更新,可以先从用户已经在做的任务出发,再找平台变了哪一段。通用演示能让人看到新控件。打开已有项目,则会看到演示之外,人们依赖哪些控件。升级试用时保留这些项目,讨论就能落到实处。维护者和用户可以面对同一组修改,说明新版是否让自己更容易保持方向,即便双方衡量进度的方式不同。
属于同一项工作的修改,可以放到一处审#
多文件差异编辑器把一组修改放进同一个标签页,也包含新增和删除的文件,每项都有可折叠标题。内嵌编辑器接近可见区域时才加载。对于一次提出跨文件修改的助手,这种实现很合适。人可以沿着整组修改往下检查,少一些逐个开关标签页的动作。 多文件差异编辑器实现
比如一次普通重命名,改到接口、解析器和两项测试。在窄屏笔记本上,检查完最后一个文件,再回到第一个,光是定位就可能花不少精力。连续的审阅界面能让几处改动的关系更容易保留在眼前。它也可能让人扫过标题就跳过某项。值得试的是,审阅者能否依然找到决定正确性的具体修改,再回到整组内容,而不丢掉阅读位置。
对于生成的补丁,可信度经常取决于一处配套细节。新增参数的代码看起来合理,某个调用者却仍在传旧值。两份文件都容易找的视图,可以帮助读者早点提出这个问题。至于相关调用者是不是只有这一个,还需要搜索、测试和代码理解来判断。这里的机会,是少花时间搬动证据,把更多注意力用来解释证据。
一次公平的试用可以包括单处修改、新增与删除混合的修改,以及一份很长但不值得逐行读的生成文件。试用者可以记下回到重要位置有多快,有没有不小心漏过折叠项。把这些观察和原来的工作方式比较,比计时第一个标签页多久打开更有意思。离开界面检查另一处代码后,审阅者还能把整组修改接起来,这样的便利才更容易说服人。
视图可以搬走,关掉它意味着什么也得清楚#
新版扩展了主窗口和辅助窗口之间的移动能力,并增加布局恢复。另一项贡献改善了复杂控件在这些窗口中的表现。开发者因此可以在处理别处工作时,把相关视图留在身边。对于产品维护者,自家视图一旦离开主工作台,要考虑的窗口状态也增加了。 窗口行为变化 · 复杂控件支持
最直观的使用条件是外接显示器,较小屏幕也可能受益。连着远程项目的开发者,可以把实时预览放在一份短代码旁,最后检查补丁时再切到集中审阅视图。另一人可能把命令输出单独放着,主窗口用来查看配置面板。好布局应该减少反复寻找。如果窗口经常出现在看不到的地方,便利也可能被抵消,特别是在办公桌和笔记本之间切换之后。
关闭行为值得看,因为人已经从许多应用中形成了习惯。新版提供偏好设置,允许在关掉辅助窗口时,把所有视图搬回主窗口。默认行为是关闭视图,同时对可能丢失状态的情况作安排。浏览器对弹窗的限制也会影响启动时能恢复什么。给团队规定一种布局之前,值得实际关一次、开一次。 窗口偏好与浏览器限制
维护自定义面板的团队,可以把这件事做得很具体。输入一个值,让一项结果继续等待,再把面板移走,关闭辅助窗口,看看回来后出现什么。重新打开项目后再来一遍。预期结果要符合面板用途。临时日志有时可以舍弃,未保存的设备配置则需要明显的找回路径。工具如果把两者同样处理,恢复体验就可能混乱。新版腾出了更好的组织空间,如何让人理解仍是应用自己的责任。
项目说明共用一份,更好维护#
Theia AI 改为从 AGENTS.md 取得项目指导。单文件夹工作区的根文件会进入 Agent 上下文,子目录文件和多根工作区按相关性读取。这项变化也包括迁移 Theia 原有的项目信息模板。仓库如果已给其他编程工具维护这个文件,现在可以在同一处保存这部分说明。 项目指导变更
一条不常变、但遗漏代价很高的规则,最能体现这样做的价值。项目可能要求改 schema 时同步更新生成客户端,也可能规定某个目录需要单独构建。两份说明就算都写得认真,也可能逐渐不一致。共用文件让团队在命令变化时只改一处。它能不能发挥作用,仍取决于说明是否够短、够准确,让第一次接触项目的人也知道怎样做。
这还带来一种熟悉的审阅责任。项目指导会影响以后的许多修改,新增指令应当像构建脚本改动一样受到检查。可以问,同事第一次打开这个工作区,会怎样执行这句话?依赖本机别名的说明,到远程主机可能就没用了。只跑部分测试的命令,也可能放过重要依赖。在命令旁边写清预期结果,通常也更方便人检查。
多根工作区是检验这个想法的好地方。开发者可能同时打开应用和共享库,让助手跨两边修改。指导需要有合理范围,读者也要知道一个命令属于哪个项目。一个小型跨边界任务,就有机会看出 Agent 有没有找到相关说明,最后的补丁是否兼顾两边。这种练习也帮维护者删除重复、过时的指令。长期节约的工作,来自团队实际使用的工具共用一份准确说明。
模型连接,也是众多依赖之一#
新的实验性 ChatGPT 集成允许用户登录,再选择订阅中可用的模型。它以 Theia 软件包提供,与 API 密钥接入并存。对已经购买访问权限的人,尝试编辑器的准备可能会简单一些。实现代码与公开评审讨论了账号状态、提供商选择和会话处理,这些细节决定连接在日常工作里能否持续可用。 ChatGPT 集成与评审
哪怕团队从不更换偏好的模型,这也与他们有关。用户从桌面应用换到浏览器连接的开发主机,可能发现登录流程和编辑器设置同样重要。应该拿未来真要用的账号和环境来试。选择器中显示的模型、服务权限,以及能不能接着完成一项真实任务,是几个互相关联的观察。分别记下来,日后支持这套环境的人就容易解释失败发生在哪。
升级还改变了模型同一轮发出的多个工具调用如何运行。共用执行器把并行执行扩展到各提供商,让此前按顺序处理的部分配置也能重叠执行独立请求。最合适的是确实相互独立的工作,比如先从几处收集信息,再准备一份修改建议。应用仍然需要了解哪些操作可以一起推进。 并行工具执行
设想助手正在读几份文件,开发者同时改了其中一份。更早读完可以缩短等待,结果也得忠实反映当时读取的内容。如果某个动作依赖前一步的输出,把它们叠在一起就改变了任务。升级试用可以拿几项存在已知依赖的普通操作,再配几项独立读取,检查应用有没有保留正确顺序。值得量的是到达开发者可以接受的结果需要多久。更多动作同时进行,要在结果仍有充分依据时才算有用。
ES 模块会暴露扩展中隐藏的假设#
把新版界面交给用户之前,平台采用者应该先看运行时迁移。Theia 软件包如今声明为 ES 模块,构建工具仍采用 CommonJS。迁移文档说明了打包应用如何继续容纳 CommonJS 扩展。因此,迁移工作取决于维护者负责哪一层,以及那段代码怎样执行。如果把所有软件包都当成以同样方式加载,本地能构建就可能无法准确预示交付产品的行为。 运行时迁移贡献
共享依赖的导入是一个明显例子。版本化指南要求扩展通过 Theia 的共享库导出访问 inversify 等依赖。另走入口,可能载入两个身份不兼容的副本。编译检查未必能暴露这种问题。类名看起来对,也可能来自错误的库副本。更自然的测试,是沿着安装产品中的同一路径创建并真正使用自定义服务。 版本化 ES 模块迁移说明
模块加载也影响测试。原来在其他导入之前运行的准备动作,求值顺序变化后可能不再奏效。维护者可能花时间排查一个只在测试环境存在的「产品问题」,也可能因为测试以另一种方式加载而漏掉真实故障。值得尽早问,生产入口和测试入口是从哪里开始不同的?沿着边界查,比全仓替换语法、希望结果表现完全一样,更容易把迁移做准确。
对产品团队,分步骤试用也有成本上的好处。先用目标版本构建现有产品,再走用户依赖的自定义服务。等这些路径符合预期之后,再判断新布局或 Agent 设置是否改善日常工作。否则,账号连不上、面板丢状态、模块加载出问题,都可能在同一次演示里出现。记下哪个变化引入哪种现象,可以减少把一层的问题归到另一层的时间。
编译器和桌面变化各有范围#
Theia 编译器升级到 TypeScript 6。迁移指南表示,只使用输出声明文件的项目还能继续采用 TypeScript 5.9,采用新编译器的团队则要检查模块解析、环境类型和互操作变化。11 月的介绍文章与版本化指南对模块解析的说法不同,维护者应检查所构建版本的配置。1.77.0 标签下的指南指定 NodeNext。 编译器迁移贡献 · 版本化编译器指南
明确编译器选择,也方便团队讨论升级。如果编辑器和命令行用不同编译器,同一段代码可能只在其中一边显示警告。简单审阅就会变成补丁到底算不算完成的争论。用一个可复现的小项目走自定义扩展,是确认各步骤由哪个配置控制的实际办法。等每个人都能稳定复现同一警告,再决定改代码、配置还是升级编译器的时间。
桌面产品维护者还要经过 Electron 这道边界。1.77 公告列出 Electron 44、异步剪贴板接口及更新的原生模块编译要求。这意味着要在真实安装包里验证产品自己的桌面交互。一个读取剪贴板的表单,以及在开发者机器上构建的模块,都可能只在某种条件下正常。浏览器版工具在这些位置承担的工作又有差异。 Electron 更新贡献
演练里适合加入人分神时也会做的操作。从调试器复制一个值,按非默认布局打开项目,停止一项还在输出结果的任务。新审阅视图省下的时间,可能被每天一次的普通操作故障抵消。所以代表性试用要从打开应用跟到完成一小段工作,再看人怎么退出和回来。仅仅确认启动画面能出现,还看不到这些环节。
第二项任务,才看得出这次升级值不值#
试用 Theia IDE,可以从一份自己已经熟悉的补丁开始。在平时的屏幕上检查它,移走一个相关视图,关掉应用,再回来。第二项任务会揭示,布局帮自己恢复了上下文,还是又要重新搭一遍。也能检查休息之后,助手的项目指导和账号是否依然能用。这些观察直接关系日常工作,也为和现用工具公平比较留出空间。
拿 Theia 做产品的团队,则需要给维护工作另外记一栏。多少自定义服务需要修改?哪些测试如今真实反映了产品加载方式?同事能否在迁移机器之外重新构建?答案决定为了享受新功能付出了多少成本。开放平台使团队可以读实现、改产品,理解和维护这些修改的预算,依旧由交付产品的团队承担。
远程开发试用还应记录每项观察发生在哪里。一个迟迟没完成的命令,可能正在等远程主机,浏览器本身依然响应正常。一份很大的差异可能在某台笔记本上滚动别扭,而构建在另一处很快完成。把两种观察记开,团队更容易决定要改哪里,报告对别的采用者也更有用。短暂录屏、应用版本和小型示例项目,往往比一句「远程开发很慢」提供更多线索。结果积极时也值得这样记,下一支团队需要知道这套安排在哪一部分发挥了作用。
独立的性能结论,需要工作负载、基线和可复现测量。发布材料介绍了可见改进和一些内部计时,日常结果仍取决于屏幕、项目布局、提供商和扩展组合。团队可以测定位下一个相关文件用了多久、关窗口后怎样恢复,以及到达可接受的 Agent 结果需要多久。重复几项熟悉的任务,比笼统说编辑器变快更容易看清得失,尤其是一处改善缩短等待,另一处却引入迁移成本的时候。
Theia 1.77 把审阅者的工作放到了 Agent 工作旁边,因此值得关注。它给组织修改集和跨工具共享上下文提供了更多方法。更广泛的价值,要看一个普通且不完美的任务中,这些控件能否一直让用户知道自己在做什么。对维护者,有说服力的结果是产品顺利跨过依赖迁移,用户接着做下一件事时,也少了一些重新拼凑上下文的工夫。这是可以拿来评价开放开发平台的具体标准。