Skip to content

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 25 Oct 11:31
· 1 commit to main since this release

2.1.0 是 2.0.0 之后的第一个功能版本。最大的新能力是分支会话:把会话里「岔出去的一块」做成独立的会话,与原来的会话(主会话)互通消息;分支的请示先送主会话定夺,主会话在你开放的范围内可以改分支的参数、唤醒它、给它派任务。此外有每个会话单独一份的常驻规则与统一可改的唤醒词模板、异步对话的严格收尾门与协作提醒、ntfy 推送的按类型优先级与异常提醒、OAuth 的限时接入窗口;页面首次打开更快、打开长会话更顺。同时下线了会话页的「经典视图」与交互式「开终端」预设 / 会话守护,并修复了授权接口的两处安全问题。有几处行为变化需要留意(见「升级须知」)。

从 2.0.0 升级:先读文末「升级须知」(备份数据目录;OAuth 自动注册默认改为限时窗口;内置唤醒词默认文字有变化;交互式「开终端」预设与会话守护下线)。本版没有改动 Agent 的代码,已装的 Agent 不必为此升级。

新增

  • 分支会话(手册):把一个会话里岔出去的一块做成独立的会话——有自己的页面、工作流编号与智能体——同时和主会话保持联系:分支能向主会话汇报、请示,主会话能在你允许的范围内读它的汇报、给它发话。两边互发的是「同伴消息」,不是用户指令,与你的要求冲突时永远以你为准。网页上:会话页头新增「分支」按钮(手机在「⋯」菜单里叫「分支会话」)→ 新建分支(名称;「向主会话开放多少」:仅可见 / 协作 / 托管,默认协作;要不要把你在分支里说的话抄送给主会话);侧栏里分支缩进收在主会话下面;对话里主会话与分支之间的话是具名卡,带「对方还没读 / 已读」;分支面板里可以改开放范围、开关抄送、结束分支。智能体侧:新增 MCP 工具 branch(list / create / say / read / close,另有下面几条要用的 answer / escalate)与 session_params(工具总数 15 → 17),有分支关系的会话回执头多一行 branch:,收件箱里分支消息单独成组。限额防失控:一个主会话最多 8 个活动分支、每小时最多新建 5 个,同一发送方每小时最多发 60 条分支消息。已有的两个会话可以用命令行 relaymesh branch-link --main … --branch … 连成主会话与分支(默认只预演,--apply 之前先生成数据库快照,默认开放范围是「仅可见」),branch-unlink 解除。没有任何分支关系的会话,回执头里不会多出任何内容。下面四条是主会话能在你开放的范围内做的事:
  • 分支会话 · 请示先送主会话定夺:分支里的智能体用 async_ask 发请示时,只要该分支向主会话开放了「定夺请示」(协作 / 托管预设默认开,「仅可见」不开),这张卡先送主会话,在分支页上显示「待主会话」;主会话的智能体用 branch(action: "answer") 代答,或用 branch(action: "escalate", note) 转交给你(必须写明原因)。你都看得到:代答的请示写「主会话代答」,展开后写明这不是你本人的答复,分支的智能体读到的答复也带同样的标注;转交的请示回到「待您处理」并按通知设置提醒。兜底:主会话超过时限没答复(默认 30 分钟,「设置 → 等待策略」里可改成 5–1440 分钟)自动转交给你;分支被结束、关系被解除或你关掉「定夺请示」时,没答的请示立刻转交给你;你随时可以直接答复,先到先得;还有「高风险(L2)请示不让主会话代答」的开关(默认关)。只有分支里智能体发的请示(ask / plan)才路由,阻塞式汇报(interactive_feedback)仍直接等你。
  • 分支会话 · 主会话改分支的设置:开放范围新增「改参数」,分四档(不可改 / 常驻规则 / 常驻规则 + 阶段 / 全部参数),仅可见 = 不可改,协作 = 常驻规则,托管 = 全部参数。主会话的智能体用 session_params 读写;档位到「全部参数」才能再改唤醒提示词、标题和异步开关(异步开关只能关闭,或恢复你以前开过的状态;第一次开启永远是你的事)。每次调用都重新检查档位,全有或全无,同一分支每小时最多写 30 项;主会话改不了档位本身、授权、凭据、项目目录与主机、终端访问。分支会在下一次回执里被告知(只告知一次),授权档位(auth:)不会因此放宽。分支面板里有「主会话改过的参数」记录(谁改的、改了什么),最新一条可以「撤销」。放宽要验证密码,收紧不要:新建分支时选了带「改参数」的预设、或把档位调高,要再输入一次 Web 密码;终端总闸关着(没设 Web 密码、密钥偏弱或 RELAYMESH_TERMINAL=off)验证不了时,放宽的项被压回原值、其余设置照常保存,界面写明哪一项没放宽以及原因。
  • 分支会话 · 主会话唤醒分支,与分支的状态一览:开放范围里的「启动」一项(仅可见、协作 = 关,托管 = 开)。主会话的智能体用项目管理 Agent 的 preset_run 运行指向自己分支的「非交互续聊」预设,把停下来的分支唤醒;只有你在分支面板里打开了「启动」、并且已经有指向该分支的续聊预设,才运行得了;别的管理 Agent 看不到也运行不了这条预设;你关掉「启动」后,下一次立刻被拒。主会话的 branch list 给每个活动分支带上 Agent 状态、未完成任务数与启动方式,网页上主会话面板里每个活动分支多一行状态。第一次真实运行请在场(见「已知限制」)。
  • 分支会话 · 主会话给分支派任务:开放范围里的「任务」一项(仅可见 = 只读,协作 / 托管 = 派单)。项目的任务权限在强制执行档时,普通智能体本来不能指派任务;分支派单是唯一带范围的例外:主会话的智能体可以把它自己创建的任务指派给自己的、开放了「任务」的活动分支(task_create / task_update / task_board batch 里设 assignee,assignee: "" 收回),分支接取、交付后由主会话验收;分支不能验收自己的交付。要两边在同一张项目任务板上:分支要有一个会话落在已登记进主会话所在项目的目录里。派单不会叫醒分支,要它马上开始用 branch(action: "say") 或 preset_run。结束分支时没做完的任务退回主会话。
  • 非交互续聊预设:可选「接哪个对话」:启动器里「非交互续聊」预设的表单把对话来源改成三选一——指定会话(填对话编号固定接它,留空跟随工作流里智能体最近汇报的对话,与以前一致);新会话(在主机上新开一个对话,并可选「运行成功之后」记下编号、之后接着它〔默认〕/ 切到「最近会话」/ 每次都新开);最近会话(新增:用 Cursor CLI 的 --continue 接着目录里最近动过的对话;它接的是「最近动过的」,不论是谁开的,同一目录有多个会话时可能接错,表单里写明了这一点,运行记录与聊天里会写出实际接上的对话)。已有的预设不用改,行为与升级前一致。详见终端运维手册 §8.13。
  • ntfy 推送:按消息类型设置优先级:「设置 → 外观与通知 → 手机 / 桌面推送(ntfy)」里新增「按消息类型设置」表,每一类消息一行,可以单独选「不推送」或 1~5 级,每行有「试发」按钮;原来的「优先级」改名「默认优先级」,只管表里写着「跟随默认优先级」的几类。没动过这张表时,所有消息的优先级与升级前完全一样。
  • ntfy 异常推送(默认全部关闭):新增四类「出了问题才推」的提醒,在上面的表里按需打开——Agent 出错或被中断(持续满 1 分钟才推)、Agent 疑似卡住、ExecMesh 主机掉线(断线超过 5 分钟才推)、安全告警(OAuth 授权码或刷新令牌被重放、终端解锁尝试过多被锁定、网页登录失败过多被锁定)。每一类都有去重(安全告警 10 分钟内最多一条),刚打开或服务刚重启时已经存在的异常不补推;内容只写现象,不含 IP、审计明细、终端内容与工具参数。详见通知。
  • OAuth「接入窗口」与「刚登记、还没授权」清单:「设置 → OAuth 授权」页顶部新增接入窗口卡片:要添加新的 ChatGPT / Claude 连接器时点「开启 10 分钟」,窗口期间客户端才能自己登记;「续期」累加(总共最长 60 分钟),「立即关闭」随时可用;窗口只存在内存里,Hub 重启即关闭。下面新增「刚登记、还没授权的客户端」清单(客户端名、回调主机与「官方来源 / 陌生来源 / 本机回环」标记、登记时间与来源 IP),不认识的可以「删除登记」。开 / 续 / 关窗口与删除登记都要再次验证密码,并写入审计。详见 OAuth 授权。
  • 会话常驻规则(每个会话单独一份):会话页输入区工具栏新增「常驻」小标签,为这个会话写一段常驻规则(最多 1200 字);智能体每一次回执头都带上它(resident: 行),上下文被压缩后读收件箱或检查点时也带。智能体只能读(workflow_context 的 resident_get),不能改,也不能借它放宽授权档位。编辑弹窗里有预览(与智能体回执里的样子逐字一致)、最近 10 个历史版本(可载入、可回滚)与「主线会话 / 分支会话」两份现成模板(「设置 → 会话提示词」里可以改)。没写过规则的会话,回执与以前逐字节一致。详见会话提示词。
  • 唤醒词模板:几个出口统一、可改、可预览:Hub 叫醒智能体、或让新智能体接入会话时发给它的那段话,过去在几个地方各自生成;现在统一成同一套模板与 %变量(%workflow、%title、%inbox、%tasks、%next、%resident、%limit 等,「现状」类在发出那一刻现算),按「预设里自己写的正文 → 会话模板 → 全局覆盖 → 内置默认」分层选用。会话页「常驻」弹窗新增「唤醒词」页签,「设置 → 会话提示词」下半部分新增三类全局覆盖;启动器预设与「启用 Agent」的提示词框带说明,并有「预览最终发出去的文字」。每份模板最多 1500 字;新开对话与网页启动提示词必须带 %workflow;唤醒词不能放宽授权。
  • 严格收尾门:做完所有非搁置任务再结束会话:开着异步对话的会话,只要本会话名下还有未完成(待办 / 进行中 / 验证中)的任务,回复窗口就暂停、智能体也不能收尾;放下任务的正规出口是「暂缓」(等你拍板的事要先发确认卡)。谁的任务挡谁按指派关系判定:没有指派的归创建者,已指派的归承接者,承接者拒绝后回到派发者,已交付待验收的归派发者;你在网页上派的、已交付待验收的任务不挡任何会话。回复窗口小标签变成「锁 + 剩余时间 + 个数」,点开有「收尾门」一节:看清单、「本次放行」、按会话开关、替智能体把某个任务置「暂缓」。默认对所有异步会话开启;同步会话与从没开过异步的会话不变。详见异步对话模式。
  • 暂缓的两条软提醒:智能体最近 24 小时内把任务置为「暂缓」、却没写在等哪张确认卡(Q<N>)或等什么、也没有结论时,回执的 tasks: 行与 task_board overview 会点名提醒一次;反过来,确认卡已被你答复、挂着它的任务却还停在「暂缓」且答复之后没人动过时,同样点名(例如 Q89→#164),防止答复被漏处理。两条都只是提醒、不拦截。
  • 共享任务板的协作提醒(回执头与网页):回执头里新增 board: 行——承接者一侧是「指派待你接取」「交付被退回」,派任务的人一侧是「你派出的任务已交付待验收」「指派被拒绝」「超过 2 小时没人接」「承接者已不存在」,每类最多列 5 个编号并附上一次调用就能办掉的动作;它是状态式提醒,处理掉就消失,没有待办时回执与以前逐字节一致。网页上:侧栏会话卡右下角出现「N 项待接取」徽标;任务页筛选栏在板上出现过指派后多出「指派给我 / 我派出的 / 待接取」三个快捷项;待接取的行写「已等多久」,超过 2 小时变红。详见共享任务板。
  • 群聊里的协作系统消息:派任务的人与承接者都在同一个群里时,派活 / 改派、交付、拒绝接取、退回返工、验收通过会在群里留一条居中的灰色系统消息(例如「A 把 #12「接口改造」派给了 B」);接取与撤销指派不发。一次批量操作里同一种事件、同一对人合成一条;任务的协作状态没有真的变化时不重复发。系统消息不带 @、不进任何人的收件箱、不算未读,也不进 Agent 互相 @ 的回复链与冷却计数。
  • 「指派久无人接」的一次性提醒,时长可在设置里调:一个协作指派停在「待接取」超过阈值(默认 2 小时)还没人接,系统在网页里提醒你一次——浏览器系统通知加提示音(按你的通知设置);每个指派只提醒一次,重启不重复,被拒绝或撤销后重新派出算新的一轮;提醒开关关着或免打扰开着时不丢,条件解除后补发一次。「设置 → 外观与通知 →『指派久无人接的提醒』」有一个开关和一个时长(30 分钟 ~ 24 小时,默认 2 小时),时长同时决定任务行「已等」什么时候变红与回执头 board: 行里「超过 N 小时没人接」的口径。手机推送是它的备用通道:ntfy 表里新增「指派久无人接」一类(默认不推送,建议 3 级)。
  • 非交互续聊、「启用 Agent」与会话页「运行」支持 Windows 主机:以前这三处遇到 Windows 主机一律拒绝(unsupported_os)。现在命令按 PowerShell 的写法拼成一整行,经这台主机的 Agent 用 PowerShell 运行(机器上要有 pwsh 或 powershell;只找到 cmd 时拒绝并说明)。目录写盘符路径(C:\work)或 UNC 路径,可执行文件写命令名(agent.cmd)或盘符路径;Cursor 的命令行在 Windows 上通常是经 cmd.exe 的批处理,所以目录与可执行文件路径里不许有 " % ^ & | < > ! * ?(保存与运行时都会指出是哪个字符),提示词里的这些符号自动换成全角、双引号换成单引号,整条命令超过 7000 个字符时拒绝。Linux / macOS 上运行的命令与改动前逐字节相同。详见终端运维手册 §8.10。

变更

  • 群聊页向会话页对齐:消息搜索换成与会话页同一个面板(结果带「谁说的」与时间、关键词高亮,↑ ↓ 选择、回车跳转、Esc 关闭);页面右侧有了与会话页同一条的缩略轴(群里别的成员每句话一道刻度,点一下滚到那条消息,窗口窄于 768px 时隐藏);页头多了一枚「群里现在怎么样」的状态徽标(「N 位在等你」「N 位疑似卡住」「N 位工作中」……几种同时存在时取最需要你注意的一种,点开展开成员面板,状态来自会话页同一份实时数据);输入区外观与会话页对齐(发送按钮改成带字的小号按钮,宽屏下有快捷键提示)。不涉及后端与数据。
  • OAuth 自动注册默认改为「限时窗口」(升级须知):2.0.0 里自动注册(DCR,ChatGPT / Claude / Claude Code 靠它向 Hub 登记)只要总开关开着就常开,公网上任何人都能往库里写登记。现在有三种方式——「关闭」「限时窗口」(默认)「常开」;窗口没开着时 POST /oauth/register 返回 403 registration_window_closed,响应里写明要管理员去「设置 → OAuth 授权」开启接入窗口。升级后,如果「自动注册」原本是开着的,它会变成「限时窗口」:下一次添加连接器之前要先开接入窗口;想保持旧行为,把「自动注册」改成「常开」。 已经授权的客户端不受影响、不需要重新授权;客户端 ID 本身是 https 地址(CIMD)的客户端不登记,也不受窗口约束。策略接口多认 dcr_always(不带表示 false)。
  • OAuth 设置页重做(接入 ChatGPT / Claude 更容易上手):OAuth 从「设置 → MCP 与安全」里拆出来,成为单独的「设置 → OAuth 授权」一页,从一排开关改成一条能走完的流程。顶部是状态卡:总开关是不是真的在服务、对外地址来自哪里(环境变量 / 本页设置 / 按你访问页面的地址推导,后者会标黄警告)、要粘贴进连接器的地址(可一键复制);「一键自检」检查两个元数据端点和「不带令牌访问 /mcp 应当返回 401」,并如实写明这次检查证明不了什么(例如公网是否可达)。接入向导分 ChatGPT、Claude(网页)、Claude Code 三个标签,步骤与命令都能一键复制。令牌有效期收进「高级设置」;「已授权的应用」每行写明权限、授权时间、最近使用的时间与来源。被环境变量 RELAYMESH_OAUTH=off 关闭时,页面直接说明原因与出路。OAuth 授权新增「快速开始」与「它是怎么工作的(人话版)」。
  • 内置唤醒词默认文字改写(升级须知):没有自己写提示词的预设与网页新建会话,发出的默认文字变了:新默认把常驻规则、未读追加指令、未完成任务与检查点的下一步一起带上,醒来就知道在哪、该守什么;需要你拍板的事一律发确认卡并写 Q 编号;目录是 git 仓库才要求核对 git 状态;权限沿用此前的授权范围。非交互运行的内置默认仍会追加「结果必须发到 RelayMesh」的说明,预设运行仍会补「本次最长运行时间」一句(现在可以写 %limit 放到自己想要的位置)。想要旧写法的,在对应编辑框里点「以内置默认为底稿」自己改。预设里的提示词字数上限由原来的 600 字(非交互续聊)提到 1500 字。
  • 异步对话契约补一条:要等你拍板的事先发确认卡:智能体发现某件事必须等你决定才能继续时,要先用 async_ask 发确认卡,再把对应任务置为「暂缓」并在进展里写明 Q 编号,这样你不会错过需要你拍板的内容,也不会因此挡住收尾。
  • 切换明暗主题不再卡住页面:页面里所有元素都带一条 0.15 秒的颜色过渡,切主题时浏览器要一次建出「元素数 × 2.6」个过渡动画,内容很长的会话页(约 2.5 万个元素)实测同步卡 4 秒多。现在切换的那一刻临时关掉全局过渡、两帧之后恢复:这样的长会话页切换从 4.4 秒降到 0.78 秒;切主题变成瞬间切换(不再逐元素淡入淡出),悬停淡入等平时的过渡一切照旧。
  • 首次打开更快:页面代码按需加载,脚本与样式预压缩成 Brotli:任务清单、项目、文档、群聊四个整页、设置表单和几个小弹窗原来都打在入口脚本里(约占四成),现在只在点开时才取:首屏数据回来、浏览器空闲时按顺序悄悄预取(省流量模式不预取),鼠标悬停 / 键盘聚焦到相应入口时立刻开始取;块取不回来(多半是页面开着期间发了新版本)时,整页给出「刷新页面」并弹一条全局「刷新」提示。同时,构建时给每个脚本与样式另存一份 Brotli 压缩副本(随 web/dist 内嵌,约多 0.8 MB),浏览器声明接受 br 时服务端直接发它,不接受的仍走动态 gzip。实测首屏 5 个脚本 / 样式的实际传输量 648.7 → 359.0 KB(−44.7%);限速、冷缓存下打开最大的那个会话,1 Mbps 从 7.8 秒降到 5.5 秒,3 Mbps 从 3.9 秒降到 1.6 秒。

移除

  • OAuth 设置里的四项「信任来源」开关(信任 ChatGPT 来源、信任 Claude 来源、本机回环、自定义信任的客户端域名):它们从来不会拒绝授权,只决定批准页上要不要标黄,却容易让人误以为「不勾就连不上」。现在批准页的黄色提醒是固定规则:官方 ChatGPT / Claude 的域名不提示,其他陌生来源和本机回环地址提示;真正的闸门只剩总开关与「自动注册」。PUT /api/v1/oauth/policy 不再认这四个字段(多传会被忽略),库里残留的旧值升级后被忽略、下次保存策略时丢弃,不需要手动处理。
  • 会话页的「经典视图」与视图切换入口:2.0.0 起预览视图就是默认视图,经典视图只剩一条「回到经典视图」的退路。现在经典视图连同切换入口一起删除:会话页(以及项目任务页里的消息列表)只有一套统一消息卡的列表;地址里的 ?view=classic、?view=preview、?chat=1 被忽略。以前在某台设备上点过「回到经典视图」的,升级后第一次打开会自动回到预览视图,并清掉那台设备上的旧本地记录,不用手动处理。经典视图独有、预览卡漏掉的一处内容一并补上:待答复提问的「L2」风险标签。
  • 交互式「开终端」预设与会话守护(升级须知):启动器里的预设原来有两种——「终端预设」(点一下在主机上开一个终端并敲进固定命令,可配「会话守护」:监测、红点、唤醒、重新拉起)和「非交互续聊」。「在主机上开终端」用 ExecMesh 的网页终端自己登录上去就行,所以前一类预设与会话守护下线,代码一并删除:新建预设只剩「非交互续聊」(接口拒绝新建或修改交互式预设,返回 launcher_interactive_retired);已有的交互式预设在清单里标「旧版(已停用)」,只能删除(仍要解锁),数据原样保留、没有被迁移或改写;会话页顶栏「终端」按钮上的守护红点、启动器里的监测状态与「唤醒」「重新拉起」「标记完成」、/api/v1/terminal/guard 这组接口、MCP workflow_context 的 wake_permit 动作与回执头里的 guard: 提示行(再调用会得到 unknown action,无害)、对话时间线里的守护告警卡与待确认条里的「守护告警」汇总行都不再有;唤醒词模板的第四类「键入唤醒」也一并删除,只剩续聊、新开对话、网页启动提示词三类(老模板正文里残留的 %n、%max、%reason 不再替换、原样保留)。不受影响:非交互续聊预设及它的自动续跑与异常提醒、「启用 Agent」、会话页的「运行」、ExecMesh 网页终端本身。自动续跑放弃时的通知(原来叫「会话守护告警」,现在叫「不再自动续跑」)与群聊过密提醒仍走「系统告警」这一类通知,已有的推送设置(开关与优先级)原样保留。一个连带影响:托管终端的屏幕信号(「终端在等你批准」提醒、屏幕来的实时 token)靠已有的旧预设认出终端属于哪个工作流,新建不了这类预设之后,只有已经存在的旧预设还认得出来,这条能力保留不动。数据方面没有迁移:设置键 terminal_guard_state 现在只存自动续跑的登记,旧的守护状态在下一次写入时被丢弃,旧版本仍读得出这份文档。刷新页面之前,旧页面向已删除的接口发请求会得到 404 / 400,刷新即可。

修复

  • 打开长会话更顺:打开一个有两百多条通知的长会话时,页面不再停在离底部几百到几千像素的半空(贴着底部就继续贴底,不在底部才钉住正在看的那一块);头几秒不再反复把列表往底部拽,你向上滚的意图优先,「滚动被吞」消失;整张会话表到达之前只画载入骨架,到达那一刻一次画出最近一段并贴好底,不再先画一屏无关内容、再整页跳走(侧栏会话列表第一次取数时同样先画骨架);首屏先渲染最新的几轮,其余由浏览器空闲时分批补齐(最终内容一个不少);去掉了每段 Markdown 引用与时间线重算里的大量重复计算;翻到最上面载入更早的几轮之后,页面偶尔被拽回最底部的毛病也修了。对一个真实的长会话做只读复测(宿主机有负载抖动,只看量级):最长的单个长任务 1.0 ~ 1.3 秒 → 0.26 ~ 0.32 秒,第一轮出现后 6 秒内的长任务合计 2.9 ~ 3.2 秒 → 1.6 ~ 2.3 秒。没有消除的:打开后约 1 ~ 2 秒内页面仍基本滚不动,累计版面位移(CLS)也还偏高,见「已知限制」。
  • 点击跳转到相距很远的确认卡,滚动在半路就停了:工具栏「待答复」、正文里的 Q23 引用、搜索命中确认项,都是让那张卡自己滚到视口中央。浏览器的平滑滚动在起跑时就把终点算死了,而卡上方还没渲染过的通知用的是占位高度,一路滚过去才变成真实高度,终点就偏——距离越远偏得越多。现在平滑滚动起跑之后交给「落地校准」(右侧时间轴点击、搜索命中同一套):停稳后量卡的真实位置,偏了就补,居中对齐;你中途自己滚动就放手。
  • 会话页底部「收到 N 条新动态」提示的数字终于有人维护了:以前这个数字只数新增的轮次——进度通知、任务进展、提问卡来了不提示;数字只增不减;只有 1 条时干脆不写数字。现在是你从底部往上滚(超过 80px)之后新到的 Agent 消息(汇报 / 进度通知 / 任务进展 / 提问与计划卡,你自己的话不计)里,还在视口下方、没看到的条数;看到一条减一,全看过了提示就消失,任何条数都带数字。
  • 群聊页点「回到最新」,有时停在最新一页的开头、按钮还亮着:从搜索结果跳进很早的历史之后点「回到最新」,列表换页那一刻顶部的「载入更早」若先被触发,会把滚动位置留在这一页的顶部,打断往底部去的平滑滚动。现在点下去先把「在底部」记成真、再直接贴到最底部。只改前端。
  • 托管自驾工单一多,侧栏「托管自驾」就列不全;接口翻页时每个页界还会漏掉一条:工单列表接口一页最多 100 条、默认 20 条,页面却只取第一页,工单超过 20 个之后侧栏只显示其中一部分。现在页面一页页取完再显示(取的途中又有新的取数发出就放弃这一轮,某一页取失败时留着原来的列表)。修页面时还发现服务端翻页本身有偏差:next_cursor 给的是「下一页第一条」的编号,而下一页从「编号大于游标」取起,那一条被自己跳过——每个页界漏一条,REST 与 MCP 的 list_tasks 翻页都受影响;现在游标是本页最后一条。
  • 托管自驾页底部的发送按钮与输入框提示,终于是「发送最高指令」「向指挥端投递人工最高指令……」:底部输入区早就支持由调用方指定「按钮文字」「输入框提示」,托管自驾页也传了,可输入区里没有任何地方读它们,页面上一直显示由「当前选中的会话」推出来的「提交反馈 / 追加反馈」之类,而在这里发出去的是给指挥端的最高指令,字样是误导的。会话页的文案与以前完全一致。
  • 会话页刚打开时,「项目任务」一行、Agent 状态与会话相关芯片、侧栏「群聊」下的群列表晚到,把已经画好的内容推开:这几样原来要等各自的数据取回来才出现,把下面的内容推下约 30 px、把快捷回复按钮推右约 670 px。现在页面在本机记住每个工作流上一次的样子(有几个任务、状态条里这一批芯片整体多宽)与侧栏群聊列了几个群,再次打开时在数据到达之前先把位置占好(淡色静态块,对读屏隐藏,数据一到就原地换成真的内容;没有任务、没有 Agent、没有群聊的工作流不会多出一条空带)。记忆只存在浏览器本地,写入失败时静默跳过。第一次打开某个工作流仍会位移一次;剩下的版面位移(时间线末尾容器与通知气泡)原因还没有查明。
  • 页面刚打开(或断线重连)的那一两秒里发生的改动,要等下一次事件才补上,事件不来就一直是旧的:服务端的事件只发给「此刻在线」的页面、不补发,所以页面载入后、实时流连上前(以及断线期间)别处的改动没有人听见。现在首次连上与重连走同一条补取路径:连上之后,页面上用过的这些数据各重取一次——全局设置、托管自驾的任务列表、侧栏「任务清单」的计数与确认项、项目文档目录、常驻提示词、异步档位,以及当前工作流的整张会话表(只在整表缺了列表里的某一轮、或某一轮比列表里的旧时才取)。代价是每次连上多发几个很小的请求。顺带修了一处:项目文档目录重取时丢掉了页面上正亮着的筛选条件。
  • stdio 多个编辑器窗口全部关闭时,偶发留下接入凭证文件:窗口全部关闭、转发进程正在退出的那几秒里,「主进程还在不在」的检查可能恰好撞上端口空闲,于是又起了一个新的主进程、写下新的 stdio-hub.json,进程随后退出,文件就留在数据目录里。现在转发进程一旦开始关闭就不再接管。
  • 点任务链接,打开的是别的任务:任务有两个编号——界面和智能体说的 #N 是「板内序号」(每张任务板各自从 1 数起),任务页地址里的 ?task= 是任务的数据库编号。「收尾门」清单里点某个任务、以及正文里的 #N 链接在新标签页打开(⌘ / Ctrl / 中键点击、复制链接)时,把 #N 当成了数据库编号,打开的常常是别的项目的任务。现在收尾门清单按数据库编号打开;#N 链接的地址改成 ?seq=N,任务页向服务端按这个项目的任务板把序号解析成任务(新增只读接口 GET /api/v1/work-items/by-seq?workflow_id=&seq=)。直接左键点正文里的 #N(在页面里就地弹出详情)一直是对的;以前被复制出去、写成 ?task=<序号> 的旧链接,写下时编号就错了,纠正不了。
  • Agent 状态芯片「等你回答」滞后约 1 分钟:智能体刚发起 interactive_feedback 时,新会话还不在页面本地的列表里,页面找不到它属于哪个工作流,就没有重新取 Agent 状态,芯片要等 60 秒的定时校准才从「工作中」变成「等你回答」。现在取回会话后会补一次状态重取。
  • 授权页被放弃的请求会一直占着限流名额,直到重启 Hub:/oauth/authorize 给每个等待批准的请求记一个限流名额(同一个 IP + 客户端最多 20 个、全局最多 5000 个),过去只有批准 / 拒绝时才归还;用户打开授权页又关掉、或客户端发起后不再回来的请求,10 分钟后虽然作废了,名额却永远不还,累积到上限后这个 IP + 客户端的授权会一直得到 slow_down,只有重启 Hub 才恢复。现在名额随请求的生命周期归还:批准、拒绝、过期、管理员删除登记的客户端,每条路径都归还且只归还一次。
  • 批准页把真实的 ChatGPT / Claude 误报成「陌生来源」:用 https 对外地址时,自动注册出来的 client_id 本身以 https:// 开头,批准页过去把它当成 CIMD 客户端、去比对 Hub 自己的域名,于是连真实的 ChatGPT / Claude 登记也总是显示「此客户端不在默认信任列表中」。现在按「这个 client_id 是不是在本服务登记过」区分:登记过的看它登记的回调地址,官方域名不再提示。

安全

  • 授权发起接口在并发请求下可能让进程崩溃,同一个授权请求也可能被并发批准多次:/oauth/authorize 是(开启 OAuth 授权服务后)不需要登录就能访问的接口,它记录「请求编号→来源 IP」的那张表没有加锁,授权请求之间、或与批准 / 拒绝同时到达时,Go 运行时可能报 concurrent map writes 并直接退出进程(这类错误不能被恢复);另外批准 / 拒绝先「读到请求」、最后才「删掉请求」,同一个请求被并发提交多次决定时可能都成功。现在这张表取消,来源 IP 直接存在请求自身上;批准 / 拒绝改为原子地取走请求,并发提交只有一个成功。2.0.0 有这个问题;「启用 OAuth 授权服务器」默认关闭,只有开启了的 Hub 才暴露 /oauth/*。
  • 批准页「官方来源」的判断收紧为按域名边界精确匹配:此前对自动注册(DCR)的客户端,只要重定向主机名里带 chatgpt / claude 就当作官方来源、不提示;现在官方来源只认 chatgpt.com、claude.ai、claude.com 及其子域名,chatgpt-fake.example.com、chatgpt.com.evil.org 这类长得像的域名按陌生来源提示。这条提醒不是闸门,但把仿冒域名当成官方来源会让人放松警惕。

升级须知

  • 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增表与列(新增 workflow_branches、branch_param_events、workflow_prompts、workflow_prompt_revisions 四张表,以及收件箱行、确认项、任务、异步档位等表上的几个可空或带默认值的列与索引),没有删除或改写已有的数据。需要退回 2.0.0 时换回旧程序即可,旧版本忽略新表与新列;唯一要先做的:如果已经有人用过分支会话,旧版本不认识收件箱行的新种类 branch,会把还没读的分支消息当成「用户追加」送给智能体——退回之前先执行 UPDATE queued_feedbacks SET status = 'expired' WHERE kind = 'branch' AND status = 'pending'(详见分支会话「运维:回滚到不认识分支会话的版本」)。
  • 退回 2.0.0 时的 OAuth 设置:总开关、对外地址与令牌有效期原样带回;「自动注册」在 2.0.0 里没有限时窗口,开着就是常开,退回后即恢复常开;如果在 2.1.0 里保存过一次 OAuth 策略,被删掉的四项「信任来源」在 2.0.0 里读到的是全关(2.1.0 保存时不再写这四个键;它们只影响批准页上要不要标黄,不影响授权能否成功),需要的话在 2.0.0 的设置里重新勾选。
  • OAuth 自动注册默认改为「限时窗口」:升级后,如果「自动注册」原本是开着的,它会变成「限时窗口」——下一次添加 ChatGPT / Claude 连接器之前,先在「设置 → OAuth 授权」里开启接入窗口;想保持旧行为,把「自动注册」改成「常开」。已经授权的客户端不受影响。
  • 内置唤醒词的默认文字改写了:没有自己写提示词的预设与网页新建会话,发出的默认文字变了;想要旧写法的,在对应编辑框里点「以内置默认为底稿」自己改。自己写了提示词的预设不受影响。
  • 会话页的「经典视图」已删除:地址里的 ?view=classic 等参数被忽略;以前点过「回到经典视图」的设备,升级后第一次打开会自动回到预览视图。
  • 交互式「开终端」预设与会话守护已下线:已有的交互式预设在启动器清单里标「旧版(已停用)」,只能删除;要在主机上开终端,请用 ExecMesh 网页终端。非交互续聊预设、自动续跑、「启用 Agent」、会话页的「运行」不受影响。推送设置里原来的「会话守护告警」一行改名「不再自动续跑」,开关与优先级沿用。
  • 「指派久无人接」提醒:升级前就已经久无人接的指派,升级后的第一轮扫描会各提醒一次(按承接者合成,一轮最多 5 条)。
  • Agent 不必升级:本版没有改动 Agent 的代码(relaymesh-agent、hook 程序、安装脚本与 Hub 和 Agent 之间的协议都与 2.0.0 相同),已装的 Agent 照常与新版 Hub 配合;自动升级默认仍然关闭。
  • 构建基线不变:从源码构建需要 Go 1.26 或更高,Go 模块路径仍是 github.com/teacat99/RelayMesh/v2。

已知限制

  • 分支会话没有在真实主机上由真实的智能体跑过:它的端到端验证用的是模拟的 agent;真实环境里的第一次分支唤醒(preset_run 运行续聊预设)与第一次派单,请在场观察。
  • Windows 主机的非交互续聊:只用假的 agent.cmd 在两台真实 Windows 主机(Windows PowerShell 5.1 与 PowerShell 7.6)上验证过命令的拼装与传递;真正的 Cursor CLI 垫片没有实测过。
  • 手机宽度:界面只在 390px 宽上验证过。
  • OAuth 接入(含限时窗口):用模拟的客户端验证过,没有经过真实 ChatGPT / Claude 连接器的联调。
  • 打开很长的会话:打开后约 1 ~ 2 秒内页面仍基本滚不动,累计版面位移(CLS)实测仍有约 0.4 ~ 0.7;已查明的来源都处理了,剩下的原因没有查明。

Full Changelog: v2.0.0...v2.1.0