Termide 0.45:插件,以及看得见的委派任务
用你自己的程序扩展 termide,并随时掌握代理分派出去的工作

新增
- 面板的暂停会一并停住它交出去的受托代理。 暂停面板以前只停住面板自己的循环:受托代理会把任务一直做完,后台受托代理也照常运行,于是面板停在
‖,它的工作却在背后继续进行。现在每个任务都会在下一次请求或调用之前停下,并在暂停解除时——通过/continue、[▶]或撤回暂停——从停下的地方继续;放弃已暂停的运行或停止它,也会释放被停住的任务。状态条中的暂停行会数出它们(‖ 已暂停 · 2 个等待中),被停住的受托代理的视图也会在其按钮上方的横线上说明这一点。由外部代理运行的受托代理跑的是它自己的程序,任何暂停都无法让它停下:它会继续运行,单独计数(· 1 个仍在运行),只能停止。 - 委派的任务在 termide 关闭后依然保留,并由委派它们的面板继续。 委派任务的日志现在会记录其运行的开始和结束,任务停在面板的暂停处时记为
paused,因此 termide 退出时尚未完成的任务会被识别为未完成,并在会话列表中显示为⏸ &。负责继续它们的是委派它们的面板,因此面板把它们留在视野中,而不是打开新面板:每个未完成的受托代理在输入框上方占一行(& task · 查找加载器 · search — 尚未完成),单击该行会打开那个会话,由它自己的卡片询问。受托代理的面板不会自己打开。继续卡片上的 继续 会继续面板自己的工作,并连带它留下的每个受托代理:每个受托代理都在交出它的那个task调用之下于后台重新运行,从自己的日志中取回已做的步骤——做过的事都在那里,所以它是接着做而不是从头开始——结束后回答委派它的面板;它的权限请求以卡片形式送到那个面板。没有自己未完成工作的面板只就受托代理询问,此时 继续 只启动它们。稍后决定 让这些行留在原处,任务留在会话列表(F6)中;无法在此继续的受托代理会在询问的面板中说明。 - 从项目根目录运行的命令。 命令以前在聚焦面板的目录中运行,因此每次切换目录后,同一行命令的含义就不同了:在深层目录的面板里,
cargo test只测试一个 crate,./scripts/deploy.sh则什么也找不到。在commands.toml中设置cwd = "project"后,无论聚焦的是哪个面板,命令都在项目根目录中运行,在所有模式下(包括终端)都是如此,direnv 也从那里解析;不设置时,它仍像以前一样跟随聚焦面板。命令的创建和编辑表单中有一个 Run from the project folder 复选框,不必再手动编辑文件。命令在哪里运行属于其批准范围的一部分,因此把项目的命令移到另一个目录会重新询问。 - 按实际目录树显示项目的仓库。 一个项目如果是按主机和团队分组的检出目录集合,以前会按文件夹名把仓库列成一个扁平列表,于是两个
crm检出无法区分。现在 git 面板的仓库下拉列表用文件树的连线绘制这棵树:文件夹显示为暗色行,可用Enter、←/→或单击折叠,仓库位于其下;打开列表时会展开到当前仓库。与其中仓库同名的文件夹不会额外占一行,所有仓库都直接位于项目下的项目则保持扁平。收起的选择器显示项目内的路径,过滤也匹配该路径,因此输入主机名或分组名就能找到其下的内容。 - 代理可以委派给自己的副本。 以前只有存在另一个使用 termide 自有循环、可接手工作的代理时才提供
task,因此像全新安装那样只有一个default代理时,根本没有task。现在每个这样的代理都可以把任务交给自己的一个全新副本:为搜索提供干净的上下文,或在后台运行工作。受托代理本身仍然没有task,因此委派不会嵌套。 - 无需浏览器的网页搜索。 以前只有存在可运行搜索的 Chrome 系浏览器时才提供
web_search,因此在没有浏览器的地方——Termux、没有图形界面的服务器——代理完全无法搜索。现在没有浏览器时,会像fetch那样通过普通 HTTP 获取搜索引擎的结果页,因此只要设置了引擎就提供该工具。默认的 DuckDuckGo 可以这样工作;用 JavaScript 生成结果的引擎(Google、Bing)不会返回结果,调用会说明这一点。 - 实时观看受托代理的工作。 在后台运行的任务以前在结束之前只在其块中显示几行。现在在它的块上按
o,或单击输入框上方它的那一行,会在布局之上显示它的视图,任何列都不会移动:随会话日志的增长显示受托代理的步骤,以及视图打开期间它向你提出的权限请求和问题。视图末尾是一排带按键的按钮:在面板中 F9 把视图移到独立面板中,接管 Ctrl+T 接管任务,停止 停止任务,后两者都需先确认,还有 关闭 Esc;跟随任务的面板则在其输入框边框上提供[✎]和[■]。视图打开期间像模态窗口一样占据整个窗口;Esc关闭视图,任务继续运行;任务结束后,视图按其结束时的样子显示,在面板中则会打开它的会话,可继续对话。 - 外部代理作为受托代理。 带
command的代理以前从不在task可交付工作的对象之列,文档中所说的“仅在面板中”也无从实现。现在它与其他代理一起列出,它的任务也像任何受托代理一样在后台运行:运行它自己的程序,为任务启动、随任务结束,使用自己的工具,进度显示在任务的块中,会话得以保留,权限请求则在委派面板中交给你。 - 单击即可查看所有正在运行的子代理。 正在运行的子代理超过三个时,输入框上方的状态条只显示
& +N,别无其他。现在单击它会显示全部子代理,其后有一行& ▴,用于把它们重新折叠起来。 - 插件。 把程序复制到全局
config.toml旁边的plugins/<name>/中,并配上为其命名的plugin.toml,它就会为每个打开的项目在后台运行,并通过 stdin 和 stdout 以 JSON-RPC 通信:它能获知文件的打开和保存,向命令面板和 “命令”菜单添加命令,在状态栏中显示项目,根据它发送的 Markdown 打开自己的面板(plugin:<action>链接是回到插件的按钮),在 termide 的窗口中提问——一个问题、一个选择、一行文本、一个表单——并以插件名作为标题,以免被当作 termide 自己的窗口,在编辑器中与语言服务器的诊断并列标记行,读取和编辑项目中打开的缓冲区(一次编辑是一个撤销步骤),打开文件和终端,获知焦点、更改、关闭和 git 事件,为自己的命令设置专属快捷键,发送通知,并为代理提供可报告进度的工具。它还可以在编辑器中与语言服务器并列提供补全、悬停提示、代码操作、跳转到定义和引用,或为没有语言服务器的语言提供这些功能;可以在Ctrl+S写入文件之前编辑它(file/will_save,保存时格式化),并获知代理运行的开始和结束。命令面板会显示插件的状态、重新读取插件目录并重启插件,设置中有一个“插件”标签页,用于设置插件的模式和项目的开关。全局config.toml为每个插件指定模式——on、opt-in或off——项目的.termide/config.toml只能在该模式范围内切换它,因此任何仓库都无法唤醒你未允许的插件。反复崩溃的插件会以退避方式重启,一分钟内崩溃三次后就不再重启。参见doc/en/plugins.md;examples/plugins/中有一个用于编写插件的小型 Python 库,以及用它构建的三个插件。
移除
subagent_run以及在面板中运行的委派任务。 委派任务在哪里运行以前是一项设置([ai] subagent_run、设置中的 委派任务运行位置、AGENT.md中的subagent_run):在后台、在空闲的代理面板中、在为它打开的面板中,或通过卡片询问。现在每个受托代理都在后台运行,在委派它的面板中向你询问其规则未作决定的事项,并在你需要时在你为它打开的面板中观看,因此该设置、它的卡片以及任务占用的面板都已移除。config.toml中的该键会被忽略;在AGENT.md中,它会被报告为 termide 不读取的键。
变更
- 仓库发现限定在项目内部。 现在会在项目根目录下三层(而不是两层)查找嵌套仓库和子模块,因此像
<project>/<host>/<group>/<repo>这样的布局能列出其中的检出,而以前一个也列不出。包含项目的仓库——覆盖整个主目录的 dotfiles 仓库、上层的 monorepo——在找到项目自己的仓库后不再加入 git 面板的列表,以前它可能成为默认仓库;当根目录及其下都不是仓库时(例如在repo/src打开的项目),它仍会保留。 - Git 网络失败会指明仓库和服务器。 fetch、pull 或 push 失败时以前只显示
git fetch failed;当一个项目中有许多位于不同服务器上的仓库时,现在会指明是哪一个:git fetch services/api (gitlab.corp): …。 - 后台任务在后台运行,不再占用面板。 以后台方式交出的
task以前会占用一个代理面板——空闲的,或在其他面板旁新开的——并在运行期间改变布局。现在它像调用所等待的任务一样在后台运行,并在委派面板的输入框上方占一行——显示受托代理、任务、它最近做的事以及时间——行上的✕经确认后停止它,单击则显示它的视图。委派面板自身的运行停止时,它的卡片仍然保留;关闭该面板或其项目会停止它的任务,确认时会数出任务数量。任务运行期间,面板的会话保持不变,就像运行期间一样:新会话、打开另一个会话或切换模型或代理,都要等它们结束。 - 在工具清单中勾选即可批准项目的 MCP 服务器。 等待
/trust的服务器以前在其标题右端有一个[✓]按钮,批准的同时会关闭清单。现在它的标题左侧有一个自己的复选框,未勾选([ ] MCP: ext);勾选后立即批准,清单保持打开:服务器连接,其工具出现在标题下方并处于启用状态,即使会话之前关闭了它们。其余按钮——[↻]、[⇥]/[⇤]——不再关闭清单:它们执行各自的操作,清单保持打开并随之更新。 - 状态条中每个运行中的行都可通过其
✕停止。 以前只有以后台方式交出的任务在输入框上方的行中有✕;代理正在等待的子代理,以及代理移到后台的命令,只能通过停止整个运行来停止,子代理则还可以在其视图中停止。现在它们每个都有一个✕,经确认后单独停止它,无论在哪里停止任务,确认的措辞都相同:它会指明受托代理,视图中的 停止 现在也是如此。 - 受托代理会向你询问,而不是被拒绝。 在后台运行的委派任务以前只能做规则和模式已经允许的事:任何本该询问的操作都会被拒绝,尽管你就在委派它的面板里。现在它的权限请求会以常规卡片送到那个面板,像它的问题一样以
& <delegate> ·开头,对 termide 自有循环和 Claude Code 副本都是如此;只有没有人可询问的termide --prompt运行仍会拒绝它们。并行工作的受托代理依次询问,一次一张卡片,而以前同时出现的第二个问题会被拒绝。你在本会话中授予受托代理的权限只对它的任务有效,也不会向它提供“始终”选项。
修复
- 恢复的 git 面板能看到整个项目。 启动时按保存的布局重新打开的 git 面板,以前只列出它保存时所在的那个仓库,既没有项目的其他仓库,也没有它们所在的目录树;只有从菜单打开的面板才有。现在它会像新面板一样找到它们,并保持所选的仓库。
- 向上滚动仓库和分支列表时不再跳动。 列表以前把光标固定在底边;现在窗口保持不动,只在光标离开时才移动。
- Claude Code 面板的受托代理无法观看。 在使用 Claude Code 的面板中,单击正在运行的任务的行或在其块上按
o都没有反应:termide 的工具通过 MCP 为 Claude Code 提供服务,而 MCP 为每次调用分配了自己的 id,因此任务被登记在一个其块所没有的 id 之下。现在调用会采用代理宣告它时所用的 id,任务的视图也会像在使用 termide 自有循环的面板中那样打开。 - 启动失败的外部代理会说明原因。 当它的程序立即退出时——
npx拒绝运行缓存副本丢失了可执行位的适配器、未登录、崩溃——面板、委派任务或 auto 模式的审查只显示initialize: the agent closed the connection,原因则以debug级别写入日志。现在失败信息会以该程序打印的最后一行结尾,与调试适配器的做法相同:initialize: the agent closed the connection: sh: …/claude-agent-acp: Permission denied。 工具标签与清单一致。 关闭过某个 MCP 服务器工具的会话,以前会把这些工具全部从计数中扣除,无论是否提供:当该服务器尚未连接时恢复会话——项目的服务器正在等待/trust,或已从配置中删除——会显示0/25,而清单中的每个复选框都已勾选。现在该标签和横幅统计的是清单中的项目及其中已勾选的项目。- 在没有 glibc 的系统上运行
install.sh。 安装程序以前在 Linux 上总是选择 gnu 构建,而它需要系统的 glibc 加载器;在没有该加载器的系统上——以 64 位内核启动的 32 位 Raspberry Pi OS(arm_64bit=1)、Alpine、NixOS——安装的二进制文件会报错 “No such file or directory”。现在它会检查加载器,缺失时安装完全静态的 musl 构建。 - 系统监视器以 MB 显示较小的内存量。 低于 2 GB 时现在以 MB 显示:一块约有 0.9 GB 内存的板子以前显示
RAM 0/1GB,因为按整 GB 计算时总量向上取整、用量向下取整。
安全
- 拒绝不受信任的 emSign 证书。 termide 用于 HTTPS 和 FTPS 的 TLS 栈——代理的连接和网页工具、FTPS 文件管理器——以前可能接受经由不受信任的 emSign 中间证书的证书链,而这些证书的私钥现已公开(RUSTSEC-2026-0381、RUSTSEC-2026-0382)。现在会拒绝它们。
- 项目配置不能再指定 termide 运行什么,也不能放宽代理的权限。
.termide/config.toml随仓库一起提供,它以前可以设置调试器或 LSP 服务器的command和args、终端的default_shell、网页工具的chrome_path、日志的file_path、连接的base_url和api_key_env(把任意变量中的密钥发送到任意服务器),以及代理的权限mode和allow规则。现在这些只从全局文件读取;在项目文件中它们会被忽略,并在日志中记录一行,设置窗口在保存到项目时会将它们显示为在全局设置中设置。项目仍然可以让代理询问或拒绝。从菜单中选择的 shell 现在保存在全局配置中。 - 项目的 MCP 服务器和钩子需等待批准。 来自项目
mcp.toml或任何.mcp.json的服务器,以及来自项目hooks.toml的钩子,以前会在代理面板打开时自行启动。现在它们会等待:面板会说明每一项将运行什么,/trust列出它们,/trust <name>按其当前配置批准其中一项,批准保存在 termide 的数据目录中;其命令、参数、环境或地址一旦更改,就需要再次等待批准。项目也不能再关闭或替换你自己的钩子。 - 项目的命令在首次运行前会询问。 项目
commands.toml中的命令以前一经选中或按下其快捷键就会运行——而仓库可以把命令绑定到任意按键,包括普通字母,因此在编辑器中打字就可能运行它。现在它首次运行时会显示要运行的内容(包括其build)并询问;批准保存在项目之外,只要命令保持不变就一直有效;在批准之前,只有按住Ctrl或Alt的快捷键或 F 键才会询问,用于输入文本的按键只有在命令获得批准后才会绑定。在 termide 自己的表单中编写的命令在保存时即获批准。 - 项目的代理不能放宽模式或启动程序。 项目
.termide/ai/agents/下的AGENT.md以前可以以all模式启动——而模型可以自行委派给它——或者是一个外部代理,选中时 termide 会运行它的command。现在项目的代理只能以plan或ask模式启动,外部代理只能在配置的agents/中定义。 - 搜索引擎只来自配置。 项目的
ai/web/engines/<name>.toml以前可以重新定义引擎,把代理的网页搜索发送到仓库选定的服务器;现在只读取配置中的引擎。 - “在此项目中始终允许”保存在项目之外。 该规则现在写入 termide 数据目录中的
trust/<project path>/permissions.toml,而不是项目的.termide/config.toml。旧版本写在那里的规则现在会被忽略,因为 termide 无法区分哪些是你的、哪些来自仓库:请重新回答一次“始终允许”,或把它们移到全局文件中。