Repository navigation
2.2.0 是 2.1.0 之后的功能版本。最大的新能力是搜索:全局搜索(Ctrl+K / ⌘K)与 Hub 内置的 SQLite FTS5 全文索引、默认关闭的语义检索(你勾选项目之后才会有内容发出去)、智能体用的只读 search 工具,以及你发出的消息自动附上的「相关线索」。其次是留存与迁移:项目归档导出(含整项目增量备份、离线核对与合并命令、供脚本用的 MCP 导出工具),已归档的会话与群聊可以删除,并在 30 天内恢复。侧栏里的会话现在可以拖动排序、不再自动改变顺序,沉到视野外的「在等你」会话在列表边缘有提示;会话页在桌面与手机上都默认只渲染末尾一段,长会话不再整页重排发抖;热更新时挂着的 MCP 等待不再被硬切断。还有:OAuth 连接器并入「MCP 凭据管理」、再次授权时沿用旧设置,分支会话默认沿用主会话的任务板,Agent 原生支持 OpenWrt 系固件,GUI 接管式唤醒(默认关闭),页面诊断设施(崩溃自报、抖动排查、卡顿录制),以及主机卡片上的「可升级」不再误报。有几处行为变化需要留意(见「升级须知」)。
从 2.1.0 升级:先读文末「升级须知」(备份数据目录;第一次启动会在后台建全文索引,大库要几分钟;已归档的群聊不再给成员发授权;侧栏顺序改为手动顺序;本版改动了 Agent 的代码,已装的 Agent 照常可用,要用新能力再升级)。
新增
-
已归档的群聊可以删除:整个群移进回收站,保留 30 天内可恢复:此前归档的群聊只能一直留在列表里(勾上「显示已归档」才看得到),网页上没有删除入口。现在「群聊」列表勾上「显示已归档」后,每个已归档的群聊行右边多了一个「删除」按钮(在用的群聊没有,要先归档;手机上这个开关与按钮的点按区域都不小于 44px)。点开后先写清这个群有多大(几条消息、几个成员、其中几个会话还在群里、正文约多少体积)和会发生什么,并要求你手动输入群名确认;确认后整个群(消息、成员关系与你的已读位置)一次性移进回收站——不是立刻永久删除。群聊的回收站与会话的合在同一个地方:归档库的「最近删除」页签里会话与群聊混排(按删除时间从新到旧),群聊条目带「群聊」徽章、范围(共几条消息、几个成员、快照占用多少空间)与还剩几天,一键恢复;恢复后的群仍是已归档状态,消息编号与内容、成员、已读位置原样回来。保留天数与会话共用(默认 30,
RELAYMESH_TRASH_RETENTION_DAYS可调),期满后服务端每小时清理一次,清掉之后无法找回(没有「立即彻底删除」按钮)。牵连范围先说清再让你确认:① 项目与成员的会话本身一律不删(只是不再属于这个群,也不再收到它的消息);② 群在项目里持有的授权会被撤销,之后从回收站恢复群聊也不会自动还原,需要的话请重新授权,确认框里逐条列出将被撤销的授权,回收站条目与恢复后的提示里写明撤销了几条;③ 成员收件箱里还没读的群聊 @ 提醒被撤回(已经读过的不动);④ 群与项目的绑定随群移走,恢复时项目已不存在就清空绑定,成员的会话已不存在就记为离开群聊。项目审计里随群撤销的每条授权记一个revoke(详情带via: group.trash),另有一条只记数量、不含消息正文的group.trash,恢复记group.restore,到期清理由 system 记group.purge。删除与恢复只给网页登录的人用,智能体调这四个接口一律403,MCP 里没有删群的工具。项目归档的增量导出照常:被删的群在下一次增量里是一条删除标记,恢复后整个群原样回来(有测试逐字节核对)。回收站里的群聊消息不进全文 / 语义检索,恢复后自动重新建索引。新增一张group_trashes表(向后兼容的增量迁移;回滚到旧版本时它被忽略,回收站里的群在旧版本里看不到,升回来仍在)。 -
侧栏的会话可以拖动调整顺序,并且不再自动改变顺序:此前侧栏的排序是一套自动规则(置顶 → 最新一轮所在的自然日 → 同日按初次创建时间 → 最新一轮时间),昨天创建的会话今天来了新一轮,就会整体越过今天之前的所有会话。现在顺序是你自己排的数据:只有两件事会改变它——你拖动(或用菜单移动),或者出现一条新会话(默认排在最上面);日期、活跃度、待确认、状态都不再影响排位。电脑上按住卡片拖动(移动超过 4 像素开始,松手落下,
Esc取消,靠近列表边缘自动滚动;拖动中有跟随指针的小标签、落点指示线,原位变淡,松手不会误选中那里的卡);手机上点侧栏头部的「整理」,每张卡左侧出现把手,拖把手换序(整理模式下点卡片不进会话,点「完成」退出);右键 / 长按菜单里也有「移到最上 / 上移 / 下移 / 移到最下」,长列表或不方便拖动时用。分支会话也能拖,只能在同一个主会话的分支之间换序(它挂在哪个主会话下面是数据关系,不是显示偏好),拖主会话时它的分支跟着走;置顶仍是每台设备自己的显示分组(置顶的在前、不写服务器)。只在「全部」芯片且没有搜索词时可以拖(别的芯片与搜索结果里的「相邻」不完整,落点没有明确含义)。顺序保存在服务器上,手机和电脑看到同一个顺序(GET/PUT /api/v1/ui/sidebar-order,只有登录的人能调;存在现有的system_settings表里,键ui.sidebar_order,没有新表,回滚到旧版本时旧版本不认识这个键、顺序回到旧规则):写入带版本号,别处抢先改了就返回 409,页面在服务器上最新的顺序上重做这次拖动,不丢你的操作;保存成功后实时推给其他设备(SSE 事件sidebar_order_updated),另一台设备不用刷新。升级当天侧栏一格不动:第一次打开时(会话与任务都取到之后)把当前看到的顺序写上去当作初始顺序,一次性,之后旧规则不再参与排序。保存失败时(断网等)顺序在本机照常生效,筛选条上出现「顺序未同步」并自动重试(2 秒、5 秒、15 秒),重试用完仍失败时再拖一次即可重新保存。 -
侧栏边缘提醒:沉在可视区外的「在等你」会话不再被掩盖:顺序不再自动改变之后,在等你回复的会话可能沉到列表下面(或被滚到上面)看不见。现在列表的上 / 下边缘会出现提示条:有会话在等你(待回复的会话、还没确认收到的重点进度通知、等你反馈的托管工单)时写「↑ / ↓ N 个在等你」,只有新消息时写「N 个有新消息」;点一下滚到最近的那一个并让它的卡闪一下;正在看的那个会话不算;拖动中不显示。
-
设置 →「备份与导出」里的项目归档导出中心:选项目一键导出,看最近的导出记录,以及「MCP 能不能导出」:此前导出项目归档只有项目页里一个「导出归档」按钮,设置页里找不到;而在编辑器里让智能体用 MCP 的
project_archive导出分支会话,常常被拦下。现在「设置 → 备份与导出」多一块导出中心:① 选一个项目,一键导出(与项目页共用同一套下载流程;项目页的「导出归档」仍在原处,并支持#project-archive-export深链);② 最近的导出记录——取自项目审计里的project.export,带着包里各类记录的条数,清理旧会话前拿来核对;③ 令牌概览——哪些 MCP 令牌带着「项目归档导出」权限、现在能不能用、为什么不能。MCP 侧被拦的原因写进了工具描述、文档与勾选权限后的提示:Hub 的 MCP 是无状态 HTTP,客户端会缓存tools/list,授权之后要重连 MCP 才会出现project_archive;这个工具只适合脚本或自动备份(要用同一个令牌、并且能连上 Hub 才取得到包),编辑器里的智能体请走网页导出。不涉及库结构变更与接口变更。 -
设置 → 诊断多了「抖动排查」:量出页面上「信息会抖」到底是哪个元素在挪、挪了多少(诊断设施,已决定长期保留,之后出问题还用它采集):会话页打开时信息还会抖,光靠描述和截图说不清是谁在动。现在诊断记录里多一项
jank(预设「抖动排查」=trace+jank):用浏览器的版面偏移观测(Layout Shift)把每一次页面元素的挪位记下来——什么时候、挪了多少、被挪的是哪个元素(只记类名与位置,不记任何文字)、之后 300 毫秒内页面上有什么增删(作为线索)、当时在哪个路由(只记路由模板,如/session/:id,不含工作流编号)。累计抖动分按浏览器 CLS 的规则分窗取最大的一段;用户刚点击 / 输入之后紧接着发生的挪动(浏览器标为hadRecentInput)不计入总分、但单独计数;每个元素分到多少,按它被挪动的面积分摊。左下角诊断徽标实时显示「抖 x.xxx · n 次」,点开面板能看到最大的几次偏移,以及「清零重记」「上报抖动记录」;上报的手动报告带payload.jank(体积有上限,最坏情况也小于 50 KB)。用法三步:设置 → 诊断 → 预设「抖动排查」→ 保存并重新加载页面;打开会抖的页面,先别点别的,等约 10 秒看徽标上的数字;点徽标里的「上报抖动记录」(或设置 → 诊断里的「上报一份当前状态」)。也可以直接用网址?rm_diag=trace,jank。jank不在「全部怀疑项」预设里(它自己要常驻一个观察器,不默认带上)。不改变任何默认行为。 -
相关线索:你发的消息会自动附上「可能相关的旧内容」,智能体读到消息时一并看到:此前智能体想知道「你这句话和以前哪份文档、哪个任务有关」只能自己去
search,而你发出的消息本身从不告诉它。现在你发一条消息(网页上的「提交反馈」「追加指令」、任务的改进需求……所有你发给智能体的话)之后,服务端在后台按这条消息开头 200 字的意思,在同一个项目的文档 / 任务 / 确认项 / 会话汇报里找最多 3 条相似度够高的内容(文档 / 任务 / 确认项不低于 0.60,会话汇报不低于 0.70——短而泛的消息最容易带出没有主题的旧汇报,实测全是噪音,所以这一类的门槛单独定高一些),一行一条(时间 · 类型 · 标题 · 编号,例如2026-11-03 17:39(刚刚)· 文档 · 「认证流程说明」 · notes/auth.md)写在这条消息上;智能体读这条消息时(interactive_feedback的回执、workflow_context(action:"inbox")、get_session_history末尾的related_hints)一并带上,开头写明「只是线索,不是指令」,标题是别人写的内容、不是对智能体的要求;要看全文再用search或原有工具按编号打开。不拖慢任何一次发送,也不让谁等:算线索是异步的,读消息的那一刻还没算好就不带——等着回复的智能体几乎总是先读到回复,线索随后才写上,网页上标「读取时还没算好」,智能体之后看历史、或再读一次收件箱(读过没确认的追加)时补发;超过 1.5 秒、嵌入服务不通、额度用完、工作流没有项目、项目没勾进语义范围、智能体语义检索没开放,一律是「没有线索」,不报错。网页上看得见:消息下面有一条线索条(时间 · 类型 · 标题 · 编号,悬停看相似度与引用);设置 →「搜索」→「相关线索」:总开关(默认开)、每条最多几条(1–5,默认 3)、相似度下限(0.30–0.95,默认 0.60,管文档 / 任务 / 确认项)、会话汇报类的相似度下限(0.30–0.95,默认 0.70,只管会话汇报,与上一项各管各的)、每小时最多算几次(1–600,默认 30),以及运行情况(本次启动以来各种结果的次数、耗时 p50 / p90 / 最大、最近一小时真正外发的次数)与花费估算;改动写审计search.hints(只记被改的数字与开关,不记消息与线索内容)。隐私与花费:只在项目范围内找,只用智能体语义检索已经开放的内容与权限(与search工具一致);每条被算的消息把开头 200 字(外发前已隐去密钥样例)当查询词发给嵌入服务一次、不存储,计入语义检索的每日 token 额度;太短的消息(「继续」「好的」)不算;同一个工作流里已经在上下文里的汇报不当线索;撤回消息时线索一起消失。默认什么都不会发出去:语义检索总开关与「允许智能体使用语义检索」任何一个关着,线索就不会算、也不会外发。数据库新增 4 个可空列(feedback_sessions.reply_hints / reply_hints_at、queued_feedbacks.hints / hints_at),向后兼容。 -
设置里新增「诊断」:一键开启页面崩溃诊断,并让浏览器在崩溃后自己把原因报回来(诊断设施,已决定长期保留,之后出问题还用它采集):此前排查 Edge 上「打开某个会话约 2 秒后整页崩溃」要手写
?rm_diag=…网址,而且渲染进程一崩,页面自己来不及留下任何东西。现在「设置 → 诊断」一个面板做完三件事:① 这个浏览器的诊断记录——「只记录」「全部怀疑项 + 记录」「全部取消」三个预设,也可以逐项勾选(trace只记不改行为、tail有界渲染、ime输入法让位,vv单列,tailbar/tailfill收在「高级」里),点「保存并重新加载页面」生效(网址里的?rm_diag=优先于存储,所以保存时会把它从网址摘掉,免得盖掉刚保存的选择);② 浏览器自报崩溃——页面崩溃或内存不足后,浏览器自己把「崩溃了 + 原因」投递回服务端的一个匿名只写入口(浏览器自带的 Reporting API:首页与 SPA 回退页的响应头带Reporting-Endpoints与Document-Policy: include-js-call-stacks-in-crash-reports,指向POST /api/v1/diag/browser-reports;静态资源与接口不带)。入口不需要登录,所以守得很紧:只收崩溃类通知、请求体 ≤ 8 KB、一次最多 5 条、全站每分钟 30 条、每个来源地址每分钟 10 条,字段白名单整理后入库(原因、网址只留路径与wf、调用栈、页面可见性、页面最后写给浏览器的现场),不存任何会话内容,超限或开关关着一律回 204 不入库;设置里有开关(默认开,改动立即生效,关掉后首页不再带上报地址);浏览器自报的和页面自己交的分开计数、各留最近 200 / 50 份,互不挤掉。诊断记录开着时,页面每 5 秒把当前路径、开关、JS 堆、DOM 节点数写给浏览器的 Crash Report API,崩溃通知里就带着最后一次的值;③ 这个浏览器的状态与最近上报——是不是 https 页面、是否支持自报与崩溃现场、窗口与屏幕、核数与内存档、JS 堆、DOM 元素数、构建文件(可复制);「上报一份当前状态」确认上报这条路是通的;最近 20 条上报(页面自查的与浏览器自报的混排,点开看完整 JSON、一键复制);面板底部是 Edge 复测的三步说明。真实浏览器实测(Chrome 148,三种真崩溃:CDPPage.crash、chrome://crash、对渲染进程发 SIGSEGV):崩溃报告在崩溃后几秒内送达,端点名default与crash-reporting任一个都行(两个都写着);只在 https 页面上有效——http://127.0.0.1上连最普通的 CSP 违规报告都不发(面板在 http 页面上会提示,状态是黄色);一次崩溃可能报多份(崩溃时在前台的页面一份,同一个渲染进程里还活着的后退缓存旧页面各一份,可见性hidden);实测的三种真崩溃报告里都没有reason(规范里内存不足 / 无响应才会给oom/unresponsive,未实测)。局限:浏览器不保证每种崩溃都报,崩溃后马上关掉浏览器报告会丢;Edge 上是否真的送达要等实测。不改变任何默认行为。 -
「用户追加」成为可检索的一类,智能体可以按编号重读:你在会话页「追加」框里发给智能体的话,原本只会在智能体读到的那一刻出现一次,上下文被压缩之后既搜不到也找不回来(搜索命中的几乎都是智能体自己的汇报)。现在它是全文检索的第六类 用户追加(
kind=message):全局搜索(Ctrl+K/⌘K)的类型标签里多了「用户追加」,结果标题写成「追加 #12 …」、说明行写状态(已确认 / 已读取,未确认 / 已过期),点开进它所属的会话页。什么时候进索引:智能体读到之后才进(还在排队、没被任何智能体读取过的追加搜不到);你撤回一条,它立即出索引;只有图片没有文字的追加、确认项答复 / 群聊 @ 提醒 / 分支会话之间的消息这些系统行不算。正文是你写的文字加上快捷标签;可见范围、权限与「会话汇报」完全一致(只在自己的项目里;智能体令牌要有「会话查询」权限;项目权限档位照常生效)。全文检索默认就搜它(本机、不外发);语义检索默认不勾:设置 → 搜索 →「语义检索 · 运行」的「允许外发的类型」里多了「用户追加」一项,默认不勾(那是你随口对智能体说的话,更私人),勾上才会把这些追加的文字发给你配置的嵌入服务,估算与确认弹窗照常写清条数与 token;已保存的类型选择不受影响。智能体侧:search的kinds多了message(令牌有「会话查询」权限时默认就查);workflow_context新增只读动作inbox_get(workflow_id+id,也可用ids,一次最多 5 条)按编号打开一条已读过的追加全文(单条最多 2 万字):不改任何状态,还没被读取过的追加只指引改用inbox,被撤回的只告知「请忽略」,别的会话的、系统行与不存在的编号一律只说「找不到」;get_session_history里被截断或没列出的追加的提示也改成指向它。升级与回滚:不涉及库结构变更;升级后的第一次启动会在后台把已读过的追加补进索引(本机,不外发,期间设置页显示「索引建立中」,可以照常搜);回滚到旧版本时索引里多出来的这一类(以及语义向量里勾选过的「用户追加」)被旧版本忽略——旧版本不认识message,点名它只会得到「未知的检索类型」,其余搜索与语义照常——不需要恢复数据库;再升回来时会自动补回索引(同一份库来回切换验证过)。 -
智能体检索额度可调:设置页里直接改「每个令牌每分钟最多查几次」,保存后立即生效,并给出语义检索的花费估算:此前智能体用
search的频率是写死的——关键词每个令牌每分钟 60 次,语义每个令牌每分钟 6 次、全体令牌合计每分钟 30 次,而实测一次语义查询只花几十个 token,额度可以放宽很多。现在设置 → 搜索 →「智能体检索」下方多了「智能体检索额度」,三个数可以改:全文每个令牌每分钟(默认 60,1–600)、语义每个令牌每分钟(默认 6,1–120)、语义全体令牌合计每分钟(默认 30,1–600,不能小于每个令牌的额度)。不改就保持原来的默认,改过的可以一键「恢复默认」;保存后立即生效,不需要重启——智能体的下一次search调用就按新额度判定(调高后刚被挡回的令牌马上能再查,调低后窗口里已有的次数超过新额度时下一次调用就被挡回),throttled回执里的limit与备注写的是当前的数字,语义「查询向量外发」的总限速(网页搜索框与智能体共用,命中缓存的不占次数)也同步成新的合计值。页面上输入不合法(不是整数、越界、合计小于单令牌)会当场提示、不能保存;接口同样校验,不合法返回 400 且什么都不改。页面按你填的合计额度估算语义检索一天最多花多少:一次语义查询约 60 个 token(查询词最长 300 字,约 450 个),一天最多「合计额度 × 1440」次,再受「语义检索」里每日 token 上限封顶,填了单价就同时给出金额;这是上限、不是预测,只做展示,不参与任何额度的计算。接口GET/PUT /api/v1/search/agent-quota(PUT请求体是三项的任意子集,或{"reset": true}),同样只认网页登录,智能体的 MCP 令牌一律 403,不能给自己加额度;每次修改在审计里记一条search.agent_quota(不属于任何项目,只含被改项的新值,或reset: true,不含查询词与内容)。不涉及库结构变更(三个数存在system_settings里,库里没有的就是默认值;回滚到旧版本后这些数字被忽略、回到 60 / 6 / 30)。诚实边界:额度按凭据计、不是安全边界;合计额度同时是语义查询向量外发的总限速,调大它会让网页搜索框与智能体一起多发查询,花费由「语义检索」的每日 token 上限兜底。见 docs/search.md「智能体检索」的「限额」。 -
会话可以固定主机:新建时填的主机会一直生效,会话右键菜单多了「编辑主机」:此前网页上给会话填的主机只是个初始值——智能体第一次汇报时,服务端会按凭据绑定的主机重新算一遍并盖掉它(侧栏分组、项目成员判定都按这个标签),所以你在新建会话 / 新建分支对话框里填的主机,下一轮就可能被改回去;新建分支时预填成服务自己的主机名(比如
relaymesh-prod)、等智能体用绑定了真实主机的凭据汇报后又被纠正,也是同一回事。现在可以固定:为某个会话固定了主机之后,它排在整条判定链的最前面(固定 > 凭据绑定 > 全局设置 > 环境变量 > 沿用 > 默认),智能体用哪个凭据汇报都不会再改它。三个入口:新建会话 / 新建分支对话框里填了主机就自动固定(不填则和以前完全一样;MCP 的branch create没有主机参数,服务自己的主机名只是兜底、不算固定);侧栏会话右键菜单的「编辑主机…」(有工作流编号的会话才有);在同一个对话框里「清除固定」回到自动。固定时这个会话名下已有的会话与排队中的追加一并改成新主机(只改标签,不改更新时间,最近活跃排序不受影响),历史留在同一个主机分组里;清除固定只是回到自动,已有记录保持现在的标签、下一轮汇报起重新计算。项目成员按「主机 + 目录」认,所以改主机可能让会话移出或加入某个项目、任务板跟着项目走:保存前对话框先预演——要改写多少行、有几轮仍在等回复、项目归属改前改后(会变时用醒目的提示写明)——确认之后才保存,服务端在一个事务里完成并核对结果。只有网页登录的人能改(接口GET /api/v1/workflows/<id>/host、POST …/host/preview、PUT …/host,请求体{"host_name":"…"},空串表示清除;MCP 令牌一律 403,没有任何 MCP 工具能写它,「主机名由服务端决定、模型不能自报」的前提不变)。每次生效的改动在项目审计里记一条session.host(只记旧值 / 新值、改写行数与项目名,不含会话正文;改动让会话移出一个项目、加入另一个时,两个项目的审计页各有一条),并广播workflow_host_changed,别的标签页 / 设备实时校准。在「凭据」里改某个凭据绑定的主机名时,原来会把用它的会话的主机一并改掉;现在被固定的会话除外,免得固定值设了、历史行却被冲回去。不涉及库结构变更(固定值存在system_settings里,键为wf_host_override:<工作流编号>;会话进回收站再恢复时一并带回,删除整个工作流时一并清掉)。诚实边界:固定的只是「标签」,不改智能体凭据与授权,也不会让智能体真的跑到另一台机器上;Agent 状态卡按(凭据,主机,目录)认,固定主机之后状态卡会成为一条新的身份;MCP 的list_sessions默认只列出调用方凭据所在主机的会话,被固定到别的主机的会话要带workflow_id才能列出;会话的目录不受影响——没绑定目录时仍随智能体第一次汇报的目录,绑定了就必须一致。见 项目迁移与工作流改绑 的「会话的主机与目录是怎么定下来的」与「固定一个会话的主机」。 -
GUI 客户端接管式唤醒(第 1、2 期):Hub 可以在装着 Cursor 的主机上,替你在「Agents」窗口里续聊旧会话或新开会话:命令行唤醒(
agent -p …)够不到只存在于 Cursor 图形界面里的对话。现在主机的所有者可以让那台主机上的 Agent 经本机 Chrome DevTools 协议接管已经在运行的 Cursor「Agents」窗口:Hub 按你的请求在指定会话里输入唤醒词并点击发送(resume),或在指定仓库分组里点「New Agent」新开一个会话、并把它的对话编号学回来(new),也可以只读探查窗口(probe,不输入、不点击)。默认关闭,只有主机所有者能开:在主机上用relaymesh-agent gui-wake enable --allow probe[,resume][,new]写本机同意文件(--allow必须明确列出,没有「默认放开」),Cursor 要用--remote-debugging-port启动(只连回环端点);同意文件不存在、enabled为 false、损坏或没有允许某个动作时,Agent 根本不会去连调试端口,Hub 与网页都改不了它,gui-wake disable随时收回,每次动作写本机审计gui-wake.log。Hub 一侧:GET/PUT /api/v1/terminal/gui-wake/targets(工作流 → 主机 / 仓库分组 / 文字来源)、POST .../preview、POST .../probe(登录即可,只读)、POST .../run(需刚刚解锁);终端审计新增gui_wake_run/gui_wake_probe/gui_wake_targets三种事件,网页审计面板里有中文标签。安全设计:页面脚本写死在 Agent 里,Hub 只下发动作、编号与文字,文字用Input.insertText输入;运行中、输入框有草稿、窗口里有未关闭对话框、状态读不到的会话一律不动;点发送之前失败 =not_sent(可以回退到 CLI 唤醒),点发送之后没取到证据 =unknown,永不重试、永不回退(否则可能把同一个会话叫醒两次);同一工作流同一动作两次至少隔 60 秒、24 小时最多 20 次、结果不确定之后冷却 5 分钟(计数来自审计,Hub 重启不清零),同一台主机同一时刻只做一个动作;审计与聊天系统行不含唤醒词的文字;没有新增 MCP 工具,模型不能触发。不涉及库结构变更(目标配置存在system_settings里);握手多两个可选字段、Hub 与 Agent 之间多gui_req/gui_res两种帧,新旧版本互相忽略不认识的部分;Agent 要升级之后才带这个能力。诚实边界:还没有在真实 Cursor 客户端上做过一次真正的发送——选择器来自对 Cursor 3.27.x 窗口结构的只读观察,全部动作只在假的 Agents 页面上验证过(单元测试、对 Agent 与 Hub 两侧的变异测试、浏览器 e2egui-wake),第一次真实使用请你在场、先用probe校准;没有网页按钮,模型 / 环境 / 分支选择与自动触发都不在这一期。见 远程终端运维 的第 11 节。 -
会话页多了「GUI 唤醒」入口:网页上就能核对并发一次续聊唤醒:此前 GUI 唤醒只有接口,配目标、看预览、发一次都得自己调。现在会话页头(终端总闸打开时;手机在「⋯」菜单里)有「GUI 唤醒」按钮,弹窗把整个流程串起来,只做续聊:①目标设置——选装着 Cursor 的主机(下拉里标着在线 / 离线)、可选的仓库分组(写法不对当场提示)、文字来源,可存成这个会话的目标、设为默认目标、删除或清除,每次写入要刚刚解锁,写之前先重读一遍服务端现状、只改这一条再整份写回,不会盖掉别处的修改;②预览——一打开就按服务端真正发送时同一份检查算好:主机与在线状态、仓库分组、会话编号、将要输入的原文与「会作为一条用户消息出现在真实对话里」的提醒、不能发送的原因(没有目标时指向「目标设置」,不是接口);③只读探查——让那台主机读一遍 Cursor 窗口的状态,不输入、不点击;④发送一次——要勾选「我已核对…人在那台机器前」并刚刚解锁,输完密码后、真正发送前网页再读一遍预览和你看过的对一遍,主机 / 会话 / 仓库分组 / 原文变了就不发并写明变了什么;结果只有「已发送 / 没有发送 / 不确定有没有发出(不要重试,请到那台机器的窗口里核对)」,发送后浏览器按会话记着冷却(已发送 60 秒、不确定 5 分钟),刷新后仍生效,服务端的限流与冷却照常挡着。这一期网页不做新开会话、自动 / 定时 / 批量、回退到 CLI 的勾选与 MCP 工具;Hub 与 Agent 没有改动(网页只是第 1、2 期那些接口的调用方),没有新增表或列,回滚到旧版本照常工作。同样还没有在真实窗口上发送过,第一次请你在场。详见 终端操作 §11.3。
-
项目页多了「会话 / 群聊 / 任务」三个概览页签,默认打开「会话」:项目页原来只有知识库、模块、管理三个页签,看不到项目里有哪些会话、群聊和任务。现在页签是六个:会话、群聊、任务、知识库、模块、管理,前三个各是一份完整的列表,点一行就跳到具体页面(会话页、群聊窗口、任务清单页并打开这条任务),后退回到原来的页签(任务详情是个抽屉,第一次后退先关抽屉)。会话页签每个成员工作流一行(标题、状态徽标、轮数、最近动静),待回复的排最前,已归档的会话照列(徽标「已归档」)、点开仍回到会话页;群聊页签列出群里有本项目成员的群,按最近动静排序、实时重排,带未读数与「点名了你」数,每行写本项目有几位成员、另有几位来自别处,成员来自几个项目的群另标「跨项目」;任务页签先列项目自己的任务板,成员在归入项目之前留下的独立板另列并说明为什么出现(只看不合并),状态按钮可筛选、行是只读的,「任务清单页」按钮打开整张板。默认页签从「知识库」改成了「会话」:直接打开
/projects/<编号>现在落在「会话」,知识库的地址是/projects/<编号>?tab=kb(会话页头的「项目」入口与文档页里的链接已经带上;收藏了旧地址的,点一下「知识库」页签即可)。手机上六个页签一行放得下,任务页签的板与状态按钮是一行横向滚动、每个按钮点按区不小于 44px。见 项目、知识库与授权。 -
同一个应用再次授权:沿用旧设置、批准后撤销旧授权,凭据列表按应用归拢:连接器每走一遍授权,Hub 都会新建一条授权加一条凭据——换了网络、重新连接、客户端重新登记之后,你在旧凭据上调好的主机、执行模式上限、限额、有效期、来源限制与权限都不再生效,凭据列表里同一个应用也会排出好几行(
OAuth: ChatGPT · 3、· 4……)。现在授权页会列出这个应用名下还没撤销的旧授权(授权编号、状态、它现在的设置、最近使用),并给两个勾选框:「沿用授权 #N 的设置」(默认勾上;新凭据以旧凭据现在的值为底:主机名单、执行模式上限、权限、限额、有效期、来源 IP 限制与备注;有意不沿用两样——「允许整个文件系统」开关,开启它要刚刚重新验证密码并写审计,不能借批准页悄悄带过去,以及项目归档导出,OAuth 凭据本来就不能开),「批准后撤销旧授权」(有在用的旧授权时默认不勾;等新授权真正拿到令牌之后才撤销——连接器批准了却没来取令牌时旧授权不会动;撤销走与手动撤销相同的路径:旧令牌立即失效、进行中的命令被结束,并写一条oauth_grant_superseded审计)。两个都不勾就是原来的行为(新授权按默认设置创建、旧授权全部保留);第一次授权这个应用时授权页与以前一模一样。凭据管理里同一个应用的多条授权归拢:当前(授权编号最大)的一行下面有一条说明条「同一应用还有 N 条较早的授权,其中 M 条最近 30 天内还在使用」,可展开 / 收起;较早的授权带「较早的授权 · 当前是 #N」与「最近 30 天无使用」标记;「撤销其余旧授权」逐条撤销,确认框里点名撤销哪几条、保留哪条、有几条最近还在用。设置 → OAuth 授权的「已授权的应用」里较早的授权同样标出「已有新授权 #N」,从那里点「管理权限」跳到被折叠的较早授权时会自动展开。接口上:GET /api/v1/oauth/requests/:id多返回previous(旧授权清单),POST /api/v1/oauth/requests/:id/decision多接受inherit_from与supersede(目标必须是这个应用名下还没撤销的授权,否则400且code为invalid_previous_grant、待决请求保留,可重新选择),授权列表与凭据的oauth对象多带client_key(同一个应用的不透明分组键)。不涉及库结构变更、不新增依赖、令牌格式不变。 见 OAuth 授权服务器。 -
全局搜索(
Ctrl+K/⌘K)与 SQLite FTS5 全文索引:任意页面按Ctrl+K(macOS⌘K)或点侧栏底部的放大镜,打开全局搜索对话框,同时搜项目文档、任务、确认项、会话汇报与群消息;可按类型筛选,范围可选「全部 / 当前项目 / 当前会话」,可勾选含已归档的文档与会话;标题命中排前、其余按更新时间新到旧,每条带命中处的片段并高亮检索词;↑↓PageUpPageDown选择,回车跳到那条内容(文档进文档页、任务进任务页并弹出详情、确认项与会话汇报进会话页并定位、群消息进那个群),翻到底自动加载下一页,扫描量触顶时提示「继续找」。快捷键在终端区域与已经开着别的对话框时让路,手机宽度下对话框不超出屏幕。底层是 Hub 内置的 FTS5 全文索引(默认开启,后台回填并分批让出,建立期间照常可搜、对话框顶部提示结果可能不完整;对话框页脚有开关,RELAYMESH_SEARCH_INDEX=off可强制关闭,关闭只是停止维护索引、各页面里原有的搜索不受影响,再打开自动补齐):索引只负责提名候选,每条命中都回到原始数据重新读取、重新核对文字与归属,所以删掉、改掉、挪走的内容不会出现在结果里,索引落后最多少一条新内容、不会多出一条不该看的;写入只给内容打「待同步」标记(约 0.3 毫秒),搜索前先同步待写入的内容。查询写法:多个词都要包含;英文数字按整词匹配、大小写不敏感、全角等同半角、三个字符以上自动按前缀匹配;中文两个字按相邻两字匹配,三个字及以上要求连续出现,单个汉字不能单独检索(提示再多输入一个字)。新增只有登录的人能调的接口GET /api/v1/search、GET /api/v1/search/status、PUT /api/v1/search/settings(MCP 令牌调不了)。在 10 万条内容、约 85 MB 原文的开发主机实测里:索引体积约原文的 0.74 倍,首次回填约 73 秒(后台),普通查询中位数 4 到 7 毫秒,限定项目范围中位数约 32 毫秒。升级时库里会新增全文索引表与一个覆盖索引(feedback_sessions上的idx_fs_wf_proj,解析「项目有哪些会话」从 156 毫秒降到 9 毫秒),都是向后兼容的增量迁移。范围与口径:「当前项目」里的文档只含项目知识库里的文档(还没迁移进项目的老文档用「当前会话」或「全部」搜);群消息搜到的是群里的全部历史(登录的人是群里的「人」);群页还不支持按消息定位,命中后先进到那个群。各页面里原有的搜索(任务清单、文档库、群聊窗口)这个版本不动,以后改用同一份索引时英文会改成整词 / 前缀匹配。见 全文搜索。 -
可选的语义检索(第一部分):设置、API Key 保管、测试连接与用量:设置里新增「搜索」分类,上半是全文索引的状态与开关(与全局搜索页脚是同一个开关,并列出各类内容的索引进度),下半是默认关闭的「语义检索(可选)」:配置一个兼容 OpenAI 的在线嵌入服务(服务地址、模型、向量维度、每批条数、超时、每日 token 上限)。这一条交付「能配置、能测通」;向量索引、后台嵌入与按意思的检索见下一条。**「测试连接」只发固定的一句英文
RelayMesh embedding connection test,不含你的任何内容;你的文档、任务或会话内容只有在下一条所说的「总开关 + 勾选项目」之后才会发出。**API Key 在网页里粘贴、只写不读:服务端用 AES-256-GCM 加密后存库,主密钥是数据目录里自动生成的master.key(权限 0600,保存第一把密钥时才创建),页面只显示末四位,不会出现在任何接口响应、日志、审计、导出或浏览器存储里;密钥绑定到保存时的服务主机,改了服务地址的主机后不会发给新地址(状态显示「主机不一致」),改回去即恢复,这样即使有人把地址改成自己的服务再点测试也拿不到密钥。出站防护默认严格(只允许 https,连接时检查实际 IP 并拒绝本机 / 内网 / 保留地址,不跟随重定向,不走环境变量代理),自建服务可在高级选项里打开「允许 http 与内网地址」。「测试连接」可以直接用表单里尚未保存的修改试,成功时显示维度、耗时与 token,维度与配置不一致时给告警,失败时给出可读的原因(鉴权、地址或模型、限流、超时、证书、被拦截等);对真正外呼的测试限频(两次至少隔 3 秒)。用量按 Hub 本地日期记录请求数、token 数与失败次数(每次外呼恰好记一笔),并显示每日上限与最近几天的明细。新增只有登录的人能调的接口GET/PUT /api/v1/search/semantic、PUT/DELETE /api/v1/search/semantic/key、POST /api/v1/search/semantic/test、GET /api/v1/search/semantic/usage(MCP 令牌一律 403),配置、保存密钥、清除密钥与测试连接都会在审计里留一条人工操作记录(只记字段名与结果,不记取值与密钥)。升级时库里会新增两张表(embed_credentials存加密后的密钥与末四位,embed_usages按天存用量),都是向后兼容的增量迁移。见 全文搜索 的「语义检索(可选)」一节。 -
可选的语义检索(第二部分):向量索引、后台嵌入与按意思的检索(默认关闭):设置 → 搜索 →「语义检索 · 运行」。默认什么都不会发出去:要你自己打开总开关、逐个勾选项目、保留想允许的内容类型(文档、任务、确认项、会话汇报、群消息,可逐类取消;终端输出与进度流永远不发),内容才会被切片、隐去疑似密钥(私钥块、带口令的网址、JWT、授权头、
sk-/ AWS / GitHub / Slack / Google 的密钥、长十六进制串、password=之类的赋值)之后发给你配置的嵌入服务;点「应用范围…」时弹窗写明发往哪台主机、预计多少条与最多约多少 token,点「确认并应用」之前什么都不发;总开关关着、或没勾选项目时,没有后台协程、没有对外请求、也不占内存。后台增量嵌入:按文本指纹只重发变动的片段,限速(默认每分钟最多 1000 块)、先预留额度再发请求、每日 token 上限用完当天停到次日;服务暂时不可用时指数退避重试(点「立即检查」可立刻重试),鉴权失败、地址或模型不对这类重试没有意义的错误会自动暂停并写明原因;向量块数上限 20 万。取消勾选一个项目(或取消一类内容)会在响应返回之前就删掉对应的向量,还可以暂停、继续、立即检查、清除全部向量;换了模型或维度,旧向量立即停用,确认「重建向量库…」(先写明预计 token)之前既不外发、也不使用旧向量。全局搜索里词法结果照旧先出,语义结果稍后出现在单独的「意思相近」分组里(不与词法结果合并打分;与词法重复的只留词法那一条;词法没有命中时语义排最上面),页脚写「语义 · 覆盖 N%」,没有生效时说明原因;每条语义命中都回到原文重新核对范围与文字,对不上就丢弃,向量库里不存原文。你在搜索框里输入的检索词也会发给嵌入服务(先隐去疑似密钥,同一个词 10 分钟内只发一次,每分钟最多 30 次)。新增只有登录的人能调的接口GET /api/v1/search/semantic/status、PUT .../enabled、PUT .../scope、POST .../pause/resume/rescan/rebuild、DELETE .../vectors?confirm=1与GET .../query(MCP 令牌一律 403),每项操作在审计里留一条只含项目编号、数量与布尔值的记录,不含内容文本、检索词或密钥。查询接口另有可选参数min_score(-1~1)可以单次覆盖相似度下限(-1 = 不设下限,只用来看完整的分数分布、校准阈值,不改同意范围与回源核对),状态里的capabilities声明了服务端支持它。升级时库里会新增三张表(embed_projects、embed_entries、embed_chunks),向后兼容的增量迁移。诚实边界:相似度下限默认 0.50(见下一条,可在设置里调);token 预估是偏保守的上限;向量存在 Hub 的数据库里、不加密,请和原文同等对待。见 全文搜索 的「语义检索(可选)」一节。 -
语义检索:相似度下限可调(默认 0.50),用量里可估算费用:设置 → 搜索 →「语义检索(可选)」多了三个输入框。相似度下限(0.20–0.90,默认从 0.35 提到 0.50):低于它的语义命中不展示;改完立即生效,不用重启、不用重建向量、不会重新嵌入,也不向嵌入服务发请求。默认值是 2026-10-27 在真实服务上用 15 道自拟问题扫过一遍后定的——0.35 时没有答案的问题也会凑出一组不相关的结果,0.50 起没有误报,而期望命中的分数最低 0.63;样本很小,不是统计结论,所以留成可调。单价(每百万 token)与币种标记:按你所用服务的官方价格自己填(Hub 不预置任何价格),填了之后,用量里的今天 / 累计 / 逐日明细、项目行的预估、「应用范围」「重建」「清除」确认弹窗和进度里的「还差多少」都会带上「按你设置的单价约 ¥x」;只做展示,不参与额度、外呼与限流,也不含税费、阶梯价、折扣或免费额度,历史各天按当前单价重算。向后兼容:库里旧配置里没有这三个字段,读出来就是 0.50 / 不估算。设置接口
PUT /api/v1/search/semantic多了min_score、price_per_million、price_currency。见 全文搜索 的「在哪里配置」与「用量」。 -
语义检索:单条上限提到 600 块,设置页可以看「哪些内容没有被完整嵌入」:设置 → 搜索 →「语义检索 · 运行」→「进度与存储」里,「N 条因过长只嵌入了前面一部分 / 内容太短,不嵌入 / 被嵌入服务拒绝」下面多了「查看未完整嵌入的条目」,点开列出每一条的内容类型、标题、所属项目与原因(因过长只嵌入了前面一部分 / 补后半部分时被服务拒绝 / 整条被服务拒绝 / 内容太短);只列已勾选项目里现在仍然存在的内容,最多前 200 条(总数与各原因的条数另给),标题里疑似密钥的部分已隐去;只读、不外发任何内容,只有登录的人看得到(新增接口
GET /api/v1/search/semantic/incomplete,MCP 令牌 403)。同时单条内容最多嵌入的块数从 200 提到 600(约 25 万个汉字,之前约 8 万):每个条目会记下自己嵌入时用的上限,升级后只有被截断的条目会补嵌后半部分(已经嵌好的块按指纹复用、不重发,只发新增的块),其余条目一个字都不会重发;内容指纹的口径没变,已有向量不会作废。补后半部分被服务拒绝(比如内容安全拦截)时,保留前面已经嵌好的部分、记下新上限、不会每轮重试,并在明细里单独标出。升级时embed_entries表新增一列chunk_cap,向后兼容的增量迁移(旧条目读出来是 0,按 200 算);补嵌多花的 token 与被截断的条目数成正比,仍受每日 token 上限约束。诚实边界:单条上限还在,更长的内容语义检索只覆盖前面约 25 万字;关键词检索不受影响(全文索引每条最多 1 MiB)。见 全文搜索 的「哪些内容没有被完整嵌入」。 -
项目归档导出:项目页「管理」页签的「设置」小节多了「导出归档」按钮(接口
GET /api/v1/projects/<编号>/archive,只有登录的人能调),把项目的工作流、群聊、任务、确认项、你发过的追加指令、智能体的会话汇报与项目文档导出成一个压缩包,能离开 RelayMesh 单独保存、用脚本核对、也能直接阅读:数据文件是.jsonl,给人读的是.md;manifest.json最后写入,列出每个文件的 SHA-256、各类记录数与编号区间;同样的数据导出两次,数据文件逐字节相同,可以直接提交进仓库做备份。群消息可以按群续导(group加after_seq,群消息的序号是每个群各自的,所以续导必须指明群;旧文件接上续导的文件,就等于全量文件)。导出是只读、流式的(不会把整个包攒在内存里),同一时刻只允许一个(第二个得到 429),中途失败会中止连接而不是留下一个看起来完整的坏包;每次导出在审计里记一条project.export,只记范围、数量与字节数,不含正文。这个版本不包含图片原件、群消息的 @ 投递记录、终端与执行日志,也不含任何凭据与系统设置;见 项目归档。 -
项目归档导出的 MCP 工具(给脚本与智能体做定时备份):令牌多了一个默认关闭的权限位「项目归档导出」(
archive),带它的令牌才有project_archive工具(没有这一位的令牌在tools/list里根本看不到它)。授予要重新输入 Web 密码、令牌必须是强令牌,并且要在凭据上勾选允许导出的项目——令牌只能导出自己名单里的项目,调用里自报的身份只用来在审计里署名,令牌才是边界;环境变量令牌、本机 stdio、开放访问与能力 URL 凭据永远不带它。工具有三个动作:plan(只读预览:各类记录数、每个群的last_seq)、export(登记一次导出,返回export_id、一次性下载网址与现成的curl命令)、status(状态、字节数、清单 SHA-256、水位);压缩包本身不会进对话,Hub 也不往主机目录写文件,由脚本用同一把令牌带Authorization头去取。下载票据是 256 位随机数、只存内存、10 分钟有效、完整取完一次就作废、绑定取得它的那把令牌,不会出现在日志与审计里;同一时刻只有一个导出在读库(与网页导出共用同一把闸),每把令牌每小时最多登记 6 次导出、同时最多 3 张没用掉的网址。每次令牌导出与每次被拒绝的尝试都写进审计(project.export,署名是令牌名称加自报身份,只记范围、数量、字节数与水位,不含正文),授予与收回记archive.grant/archive.revoke。凭据页新增「项目归档导出」勾选与项目名单,列表显示每把令牌能导出哪些项目;手册project-archive主题新增「给智能体 / 脚本用」一节,附可直接用的 bash 定时备份脚本;见 项目归档。 -
整项目增量备份(项目归档的
since)与离线核对、合并命令:令牌导出的整项目归档会登记一条「基线」(每条记录的 SHA-256 摘要,不存任何正文),下一次project_archive的export带上它的baseline_id作since,取到的就是增量包:只含相对基线新增或改动的记录、被删记录的清单tombstones.jsonl、群里新增的消息与有变化的文档,清单里mode为incremental(format_version为2,只认识版本 1 的读取方会直接拒绝它,不会把残缺的包当完整的),based_on记着它基于哪条基线与那个包的清单 SHA-256,delta汇总各类记录新增 / 改动 / 删除的条数;增量包自己也登记基线,可以一环接一环。基线只能由登记它的那把令牌在那个项目里使用,每把令牌每个项目保留最近 5 条、最长 30 天,收回授权(关掉归档位、去掉项目、停用或删除令牌)会一并清掉;基线不存在或过期时明确报baseline_missing/baseline_expired,不会悄悄退回完整导出,since与include/group/after_seq同用报since_conflict。新增离线命令relaymesh archive verify <包>…(核对每个包的文件清单、SHA-256、记录条数、删除清单,多个包时还核对能不能接成一条链:第一个是完整包、每个增量包基于它前面那一个、项目与范围不变、水位首尾相接)与relaymesh archive merge -o <目录> <完整包> <增量包>…(先核对再合并;输出目录必须不存在或为空;合并出的数据文件与「同一时刻新做一次完整导出」逐字节相同,manifest.json多一项merged_from;群消息里导出时现算的发送者名字在合并时按最终的群成员表重新取名,所以工作流改名也不破坏这一点),两者只读你给的文件,不连接 Hub;缺一环、乱序、包被改过、水位对不上都会指出具体哪一环。手册project-archive主题新增「整项目增量备份」与可直接用的 bash 增量备份脚本(每 N 天换一条完整链,基线失效自动改做完整包,有relaymesh命令时逐次核对整条链);诚实边界:增量省的是传输与存放,Hub 仍要读一遍整个项目来算变化,且仍受「同一时刻只允许一个导出」约束;见 项目归档。 -
重点进度通知:滑动确认「已收到」,不让关键信息淹没在海量进度里:智能体发不阻塞的进度通知(
interactive_feedback的wait:false)时可以再带level:"key",网页上这条通知就是醒目的琥珀色强调卡(头部实心「重点」徽标),正文末尾多一条「向右滑动,确认已收到」的滑块——滑过约 90% 才算确认(一次点按、轻微抖动、向左拖都不算,松手没到位弹回;焦点在滑块上按 Enter / 空格 / 向右方向键也能确认)。时间线顶部有「N 条重点通知待确认 · 跳到最早一条」的摘要条,侧栏会话卡有对应的「重点」徽标;确认后卡片恢复成普通进度卡的样子、头部写「已确认 · 时间」,摘要条与徽标同步减少,其它标签页 / 设备实时同步。确认只是网页侧的记录,不会反向通知智能体(不进收件箱、不影响等待与收尾),普通进度通知完全不变。每个工作流每个滚动小时最多 3 条重点通知,超出的按普通通知发布并在回执里说明(level_downgraded);level写错或用在阻塞汇报上则忽略并说明(level_ignored)。只有网页登录才能确认(POST /api/v1/sessions/<会话号>/ack,MCP 令牌得到 403)。数据库只新增两个可空的列(notice_level、acked_at),升级与回滚都不需要迁移。 -
智能体检索:MCP 多了只读工具
search,在自己所属的项目里一次查文档、任务、确认项和会话汇报:参数query(必填,最多 300 字)、mode(keyword默认 /semantic/both)、kinds(doc/task/confirm/session)、limit(默认 10,最多 20)。返回的只是引用、标题和不超过 200 字的片段(要看全文再用project_docs、workflow_context、async_ask、get_session_history打开),每条标明来源(关键词 / 语义);both先给关键词命中、再补语义命中里没出现过的,不合并打分。只查调用方工作流所属的项目(不属于任何项目返回no_project),遵守项目的权限档位(强制执行档会隐去没有读权限的命中,审计档只记「若强制会隐去几条」),session类型要凭据有「会话查询」权限;群消息与已归档内容不搜。设置 → 搜索多了「智能体检索」两个开关:允许智能体使用全文检索(默认开,只读本机索引、没有外发)、允许智能体使用语义检索(默认关,每次查询都会把查询词外发给嵌入服务),改动立即生效,接口GET/PUT /api/v1/search/agent-access同样只认网页登录。限额:关键词每个令牌每分钟 60 次,语义每个令牌每分钟 6 次、全体令牌合计每分钟 30 次;超限返回status: "throttled"与retry_after_seconds,不算错误。审计里每次调用记一条search.agent(模式、类型、条数、被隐去的条数、查询词的字数、令牌名,不记查询词本身),被限流另记search.agent_throttled,项目审计页能筛选与读到白话解释。已知边界:workflow_id是调用方自己声明的、不是安全边界,令牌才是;关键词检索没有全体合计上限;全文索引关着时search的关键词模式不可用(没有按子串扫描的后备)。见 docs/search.md「智能体检索」。 -
页面搜索走全文索引(第 0 阶段:共用底座与开关):页面里原有的搜索(文档库、会话页与群聊窗口的搜索面板等,哪些以「已接入的页面」清单为准)打算分阶段改成先问全文索引、与全局搜索用同一套规则;这一步先把共用的底座与开关交付,页面逐个接入,第一个是任务页(见下一条)。设置 → 搜索多了「页面搜索走全文索引」开关(默认开,改动立即生效并持久化;关掉后已接入的页面立刻回到原来的搜索),开关下面如实列出「已接入的页面」。底座做的事:按检索词向索引要一份范围内的候选集(最多 5000 条,每条候选都和全局搜索一样回到原始数据核对过文字与归属),页面再用自己的筛选条件求交、排序与分页保持原样、行仍从原始数据读取;开关关着、全文索引没在工作、这类内容还没回填完、检索词太短(比如单个汉字)、候选超过 5000 条、索引一条也没找到、取候选时出错——这些情形一律自动回退页面原来的搜索(日后接入的页面会在响应里带
search: {mode, reason}写明原因),索引故障不会让页面搜索报错,也不会让页面多看到不该看的内容。接口:GET /api/v1/search/status多了page_index、page_index_pages;PUT /api/v1/search/settings的请求体多了可选的page_index_enabled(两项都可选、至少给一项;环境变量强制关闭全文索引时「打开索引 + 改页面开关」的请求被 409 拒绝且不会改了一半)。没有新增表与列,不改写入路径,不向外发任何内容。 诚实边界:改用索引的好处是规则统一、不是更快(800 多条任务的生产库里,原来的子串匹配约 24 到 30 毫秒,走索引约 41 到 61 毫秒);接入后规则会变——英文改成整词 / 三字符以上前缀(ploy不再能找到deploy)、多个词不要求相邻、单个汉字不能单独检索(会回退原来的搜索)——每个页面接入时会在这里单独写明。见 docs/search.md「页面搜索走全文索引」。 -
页面搜索走全文索引(第 1 阶段:任务页):搜索框搜整张任务板,不再只看已载入的清单:以前任务页的搜索框只在已载入的清单里过滤——清单一次最多 500 条(最近更新的)、已完成与已搁置的任务只载入近 30 天,更早的任务搜不到,页面上方的提示却写着「用搜索缩小范围可以看到它们」。现在搜索框里有字(停顿约 0.12 秒后)整页换成服务端检索结果:搜的是这张任务板的全部任务,规则与全局搜索一致(英文整词、三个字符以上按前缀,中文两字相邻,多个词都要包含,不分大小写;
#12或12直接找到编号为 12 的任务;标题、说明、进度、结论、标签、所在模块与工作流都会搜);排序是编号命中、标题命中、其它字段命中三档,同档按最近更新;标题与命中片段里的词高亮,标题没命中时标题下面多一行带栏名的片段;五个状态按钮上的数字是服务端按命中算的(受类型筛选影响、不受点选的状态影响);底部「再加载 N 条」一次 50 条,任务有变化时已加载的命中静默刷新、不闪烁;按Esc或点「退出搜索,回到任务清单」回到原来的清单,滚动位置与筛选都还在。设置 → 搜索里的「页面搜索走全文索引」开关现在管着它,「已接入的页面」列出「任务页」;关掉开关、全文索引没在工作或还在建立、词太短(比如单个汉字)、候选超过 5000 条、索引一条也没找到、取候选出错时,服务端自动回退成整串文字匹配(仍然搜整张任务板),索引在建立或出错时结果上方会提一句;服务端检索本身失败(断网等)时,页面退回原来的「只在已载入的任务里筛选」,并提示、给「重试」。新接口GET /api/v1/work-items/search(只有登录的人能调,MCP 令牌 403;参数workflow_id、q、state、kind、limit(默认 50,最大 100)、offset),返回命中、total、scope_total、各状态命中数facets、归一后的检索词terms、search: {mode, reason}与next_offset。没有新增表与列,不改写入路径,不向外发任何内容。 诚实边界:规则与以前不同——英文不再是任意子串(ploy找不到deploy,deplo可以)、多个词不要求相邻、单个汉字改走整串回退;排序只分三档再按最近更新,没有相关度打分;MCP 里任务列表的query参数仍是原来的整串匹配,这一步没有动它。见 docs/search.md「任务页的搜索」。 -
Agent 原生支持 OpenWrt 系固件(QWRT、ImmortalWrt、iStoreOS 等路由器):
install用 procd 托管常驻服务(用户反馈):这类固件没有 systemd,此前agent install会报「未检测到正在运行的 systemd」。现在没有在运行的 systemd、并且同时有/etc/openwrt_release、/etc/rc.common与/sbin/procd时,install/uninstall/status/upgrade改用 procd:服务写成/etc/init.d/relaymesh-agent(可执行的 init 脚本,崩溃 5 秒后自动拉起,开机自启链接在/etc/rc.d),日志用logread -e relaymesh-agent -f看(进 logd 的内存日志,不写闪存)。路由器内存与闪存都紧,所以 OpenWrt 上默认只装一个服务(会话与 Agent 同进程,Agent 重启会结束会话);要独立的会话守护进程加--holder external(再装一份/etc/init.d/relaymesh-holder),已经装过它的主机重新执行不带--holder的命令会沿用它。root 的默认数据目录在 OpenWrt 上改为/etc/relaymesh-agent(闪存):OpenWrt 的/var指向内存盘,放在/var/lib下身份文件重启就丢、每次开机都成了一台新主机;显式把--data-dir指到/tmp、/var、/run、/dev/shm下会被拒绝并说明原因;刷固件(sysupgrade)默认会清掉未登记的文件,想保留机器码就把数据目录加进/etc/sysupgrade.conf。暂不支持:--user(OpenWrt 没有用户级服务)、自动升级、Web 一键升级、upgrade --auto-rollback与删除主机时的「同时卸载设备端」(都依赖 systemd 的瞬态单元;Agent 不会声明这些能力,Web 不会给出会失败的按钮);升级走手动,在主机上重新执行 Web「升级窗口」给出的命令或relaymesh-agent upgrade。Web 生成的安装命令默认带--auto-upgrade:OpenWrt 上装好服务后只提示「没有开启自动升级」,退出码仍是 0。systemd 与 launchd 的安装、升级、卸载行为不变(内部把「怎么管服务」抽成了统一的接口,原有测试全部保持通过)。诚实边界:procd 一侧按 OpenWrt 官方的实现编写,单元测试用 procd 模拟器与 BusyBoxsh覆盖了脚本生成、参数引用与安装 / 失败回滚 / 卸载 / 升级流程,但还没有在真机上验证;预编译的 Agent 只有 linux/amd64 与 linux/arm64,其他 CPU(mipsle、armv7 等)请自行编译。见 远程终端运维 的 1.5 节。 -
OAuth 授权的连接器并入「MCP 凭据管理」:权限、主机、有效期、来源限制和启停都能改(用户反馈):此前 ChatGPT、Claude 这类经 OAuth 授权的连接器,只能在「OAuth 授权」页看到授权记录并撤销,批准时给出的权限(终端执行、可用主机、执行模式上限)之后无法调整,手动令牌能改的项目它一项也改不了。现在每个仍然有效的 OAuth 授权都是「设置 → MCP 与安全 → MCP 凭据管理」列表里的一行(蓝色「OAuth」标记,写着应用名、授权时间与需要重新授权的时间),点编辑就是和普通令牌同一个编辑器:终端执行 / 文件 / 兼容命名 / 运行预设与治理类工具、可用主机、执行模式上限、限额、有效期、来源 IP 限制、名称备注与启停;保存走同一套校验与二次解锁(放宽要再次验证密码,收紧只要登录),改动在连接器的下一次调用生效,不需要它重新授权。与普通令牌不同的地方:没有可查看、复制或重新生成的令牌(令牌由连接器自己持有,对应接口返回
400 oauth_credential_no_token);「删除」换成「撤销授权」(访问令牌立即失效、进行中的命令被结束、连接器要重新授权,不可恢复);不绑定主机名;不能开「项目归档导出」;不占 50 把凭据的名额。停用只是让连接器的调用返回 401,授权保留,重新启用即恢复;刷新令牌换新令牌不会把已停用的凭据重新启用。「OAuth 授权」页的授权行改为显示凭据现在的权限(不再是批准那一刻的快照),多了「已停用 / 等待连接器取令牌」状态与「管理权限」按钮(直达列表里那一行);「模型访问」矩阵里带终端权限的 OAuth 授权同样出现并带标记;凭据列表在授权被批准、撤销、或在别的标签页改动时自动刷新。接口:GET /api/v1/credentials的 OAuth 条目带oauth对象且token为空串,GET /api/v1/oauth/grants每行多了credential_id、is_active、live、permissions。没有新增表与列,不迁移数据;回滚到旧版本后这些凭据重新隐藏,连接器照常可用,权限保持你改过的样子。诚实边界:管理员可以把权限放宽到批准时的范围之外(与给普通令牌加权限是同一个信任域);撤销不可恢复,要再用必须重新走授权。见 OAuth「在凭据管理里管理 OAuth 授权」。 -
已归档的会话可以删除:整条移进回收站,保留 30 天内可恢复(用户反馈):归档库(PC 弹窗 / 手机整页)每张归档卡多了「删除」。点开后先写清这条会话有多大(几轮、几张截图、几条待投递消息、约多少体积)和保留多久,并要求你手动输入会话名确认;确认后整条会话(所有轮次、截图、待投递消息、阶段状态、草稿与会话名)一次性移进回收站——不是立刻永久删除。归档库顶上多了「已归档 / 最近删除」两个页签:「最近删除」列出还在保留期内的会话(范围、删除时间、还剩几天),一键恢复,所有轮次按原来的时间回到归档库、仍是已归档状态;保留期满后服务端每小时清理一次,清掉之后无法找回(没有「立即彻底删除」按钮,要彻底清掉就等它到期)。保留天数默认 30,可用环境变量
RELAYMESH_TRASH_RETENTION_DAYS调整(1–365)。现在不能删除时(还有一轮没有归档、仍是某个未归档群聊的成员、有进行中的分支、还有待处理的确认项),确认框逐条写明原因与解决办法,服务端同样拦截。任务清单、项目文档、群聊消息、确认项与审计记录不在回收站里,也不会随会话删除或恢复。只有网页登录的人能删除 / 恢复(MCP 令牌调这四个接口一律 403);操作记进项目审计(session.trash/session.restore/session.purge,只记数量与大小,不记会话正文)。接口:GET /api/v1/workflows/<id>/trash-preview、POST /api/v1/workflows/<id>/trash(请求体{"confirm_name":"…"})、GET /api/v1/trash/workflows、POST /api/v1/trash/workflows/<编号>/restore;回收站是新增的表workflow_trashes(向后兼容的增量迁移)。 -
OAuth 审计补全:连接器提示「需要重新连接」时,能从审计里查清是哪一条授权、被谁、因为什么:用户反馈 ChatGPT 的 OAuth「过期时间好像很短」,查下来令牌并没有过期:重新授权时默认勾着「撤销旧授权」,旧授权被一条接一条撤销,仍在用旧授权的另一个会话下次刷新就拿到
400 invalid_grant、显示「需要重新连接」。但当时审计里只有成功的事件,被拒绝的刷新与「谁撤销了哪条授权」都没有记录,只能靠反向代理的访问日志倒推。现在:① 新事件oauth_token_denied:令牌端点拒绝一次刷新或换码时记一条,详情只含授权编号、原因代码(revoked授权已撤销、idle_expired闲置到期、absolute_expired绝对期限到期、unknown_token找不到授权、client_mismatch/resource_mismatch与授权时不符、code_invalid/pkce_failed换码失败、lookup_error/write_error库出错)与相关时间点(授权时间、最近刷新、到期时间),不含令牌、授权码或来源地址;同一类拒绝一分钟内只记第一条(被压掉的条数写在下一条的suppressed=N里),不认识的令牌也按分钟限流,所以拿错令牌的客户端刷不满审计;② 授权批准、令牌签发、刷新轮换、授权码重放、撤销等所有 OAuth 事件的详情都带grant=#N,一串事件能连成同一条授权的时间线;③oauth_revoke写明来源:source=admin(管理员在设置里撤销、或删除了授权创建的凭据)、source=supersede(批准新授权时勾选了「撤销旧授权」)、source=connector(连接器自己调用了/oauth/revoke);④ 网页审计面板里这些事件都有中文标签与原因说明。查法见 OAuth 授权 的「审计事件:排查连接器为什么提示重新连接」。不涉及库结构变更与接口变更。
变更
-
已归档的群聊不再给成员「发」群授权:此前群在项目里持有授权(项目页「授权」小节里的群授权,「群共享」就是一条只读授权)时,只要是群成员就继承这份授权,已归档的群也一样——归档后看起来群已经不用了,成员却还通过它拿着项目权限。现在已归档的群不再让成员继承授权(授权记录本身保留,取消归档后继承恢复);删除已归档的群聊时授权会被撤销(见「新增」)。
-
侧栏排序:由「自动规则」改为「手动顺序」:旧规则(置顶 → 最新一轮所在的自然日 → 同日按初次创建时间 → 最新一轮时间)只在手动顺序还没生效时使用——升级当天、服务器上还没有顺序且读取失败又没有本机缓存,此时排法与以前一字不差,不会让你先看到一次错乱。新会话默认排在最上面(置顶的仍在最前),新建的分支出现在它主会话下面的第一位;已归档的会话取消归档后回到原来的位置(顺序里看不见的条目原地保留)。
-
桌面浏览器打开会话页也默认走「末尾有界渲染」,长会话不再整页重排发抖:此前只有手机(触屏)默认只渲染时间线末尾一段,桌面浏览器要在地址栏写
?rm_diag=tail才用得上,默认仍是一次画出整条时间线(重型会话里是两三万个元素),打开时页面会反复重排、肉眼可见地抖。用户在两个重型会话里用开着有界渲染的诊断版录制并复测(帧间隔平稳、没有版面抖动,可以正常使用),确认后改成所有设备默认开启:打开会话页只画末尾一段,更早的通知不一次画出来,窗口顶部有「更早还有 N 条未展开」细条(带「展开更多」与「全部展开」),向上滚到约两屏以内才补齐;内容一个不少、不折叠不截断。取舍(与手机上一直如此):浏览器自带的Ctrl+F找不到还没展开的卡(页面内搜索与全局搜索Ctrl+K不受影响,也可以先点「全部展开」);右侧时间线轨只含已展开的条目;末尾不超过 36 块的会话与以前完全一样。逃生口:地址栏加?rm_diag=off回到旧的整段渲染(会记住,之后不带参数也保持);?rm_diag=default清掉记住的设置、回到设备默认;设置 →「诊断」里「全部取消」同样回到默认。默认值只是行为、不是诊断模式:没有徽标、不记面包屑、不写任何存储;显式写的开关叠加在默认值之上(桌面?rm_diag=trace= 有界渲染 + 记录,上报里flags是真正生效的开关、dflags标明哪些是默认带的),同一族的显式开关接管这一族(?rm_diag=tailbar只要细条、?rm_diag=tailfill只要有界补齐,不会被默认补成整套,崩溃排查时拆开试用)。手机不变(仍默认有界渲染 + 输入法避让),桌面不带输入法避让。不改数据、接口与动画。 -
热更新 / 重启时不再把挂着的 MCP 等待硬切断:先唤醒,带「服务更新」回执结束这一轮:此前 Hub 收到退出信号后只给在途请求 5 秒,而
interactive_feedback/continue_feedback_session默认要挂 120 秒(或会话设置的挂起倒计时)等你回复,所以热更时只要有智能体正挂着等待,连接一律在第 5 秒被切断(客户端看到fetch failed/UND_ERR_SOCKET),智能体只能自己想办法重连。现在退出的第一步是排空:所有挂着的等待立刻醒来——这一刻你恰好提交的回复照常交付、你取消的会话照常回取消,其余的返回一份带=== 等待回执 ===与【服务更新】的回执,写明「服务正在更新,会话与你的回复都已保存,这不是空回执也不是出错」,并指引智能体AwaitShell20 秒后调用continue_feedback_session(连不上就每 10 秒重试,最多 6 次),这一轮不计入「收尾宽限」的轮数;排空开始之后才到的新等待也直接拿到这份回执;continue_feedback_session预先计入的那次续命被排空唤醒时会退回,不多占收尾宽限。排空最多 2 秒,之后照旧关闭监听。实验 Hub 实测(6 个并发等待 × 3 轮,探针每 20 毫秒一次;旧版是与现在生产同一套退出逻辑的快照):挂着的等待,旧版 18/18 在 5.02 秒被切断,新版 18/18 在 42–72 毫秒内带回执返回;进程退出 5.02–5.03 秒 → 57–69 毫秒;服务不可用的空窗期 5.2 秒 → 0.24–0.28 秒;重启后 9/9 个会话按回执继续、立刻拿到了期间提交的回复;不挂起的短调用约 5 毫秒,前后没有差别。边界:装上这项改动的那一次热更,退出的仍是旧进程,仍会照旧在 5 秒时切断一次,从下一次热更起才平稳;终端相关的等待(terminal_exec/terminal_run的等待)与 stdio 模式不在范围内;网页的实时流(SSE)在重启时仍会断开并由页面自动重连;生产的空窗期还包含容器重建,不在实验 Hub 的数字里。不涉及库结构变更,也没有新增设置;旧智能体看到的只是一份带说明的普通等待回执。 -
get_session_history有了「轮数 + 字符预算」与翻页,默认能看到最近 30 轮汇报:以前智能体调它读一个工作流,拿到的是「最近 100 行」——实际只有 10 行(下面「修复」里的存储层缺陷),而这 10 行常常大半是进度通知,真正的汇报几乎看不到;每一轮的汇报正文又原样全给、没有任何上限,一轮长汇报就能占掉上万字符。现在按轮数与字符预算从新往旧列:默认最近 30 轮汇报、总共约 3 万字符,可用新参数调——rounds(1–100)、max_chars(2000–20 万)、before(翻页游标)、appended(带几条用户追加,默认 10、0 = 不要、最多 200)。进度通知不占轮数,每次只列最近 20 条且每条只有标题与第一行(compact: true,工作流被你命名过时通知的标题都一样,所以带上第一行才分得清),合计不超过预算的六分之一,列不下的给notices_omitted;要读到全部通知,带新参数kind: "notice"只读通知、用before一页页往前翻(rounds此时表示一页多少条,字符预算照样生效;kind: "round"则只读汇报、不夹通知;写错的值会报错,只读单条时不起作用)。列不下的会明说:结果里多omitted_rounds、omitted_notices、next_before与一段history_note,再调一次带before就接着往前翻(同一工作流里,不重不漏);最新的一轮自己就超出预算时不丢掉、而是截断(truncated: true与全文字符数chars_total),要读全文用它的session_id(不带workflow_id)单独读取,单条默认给全文(上限 10 万字符,max_chars可调到 20 万)。用户追加最多占预算的三分之一,单条超过 3000 字的只给开头(text_truncated: true、text_chars),列不全时给appended_omitted。小工作流用不满预算时,结果与以前逐字一致,上面这些新键都不出现(同步回执的黄金文件没变)。list_sessions带workflow_id时同样受益于下面的修复。不涉及库结构变更(翻页走feedback_sessions上已有的「工作流 + 创建时间」索引)。不在本期:每次输入自动检索、群聊可见性、嵌入模型。见 常见问题 的「get_session_history返回的内容有上限」。 -
主会话能不能改分支的常驻规则:现在一眼看得出来,设置页的旧说法也改了:这个能力其实早就有了——主会话的智能体用
session_params(set,patch: {"resident": "…"},不超过 1200 字)为自己名下的分支写常驻规则,前提是你在分支面板里把「主会话改参数」开到「常驻规则」或更高(「协作」「托管」预设自带,「仅可见」没有);回执里会写明这一版是主会话代写的、不冒充你,你随时能改或撤销。但设置页写着「智能体只读,改规则只有你能做」,会让人以为做不到,主会话的智能体也没法一眼看出哪个分支能写、哪个不能。现在:①branch的list与create结果里每个分支的就绪度readiness多了第五项params(改常驻规则)——就绪时ready: true,没就绪时missing写明还缺什么、请你去哪里打开(前四项的顺序与键不变,params排在最后);② 设置 → 会话提示词、会话里的「常驻」弹窗与 会话提示词 的说法改成「智能体不能改自己这个会话的规则,分支会话是例外」,并新增一节「分支会话:主会话代写常驻规则」讲清前提、怎么看、怎么撤销。只多了一项只读的就绪度与文案,权限判定、接口与库结构都没变(写入权限仍只在ApplySessionParams一处判定,限额与撤销照旧)。不在本期:创建分支时带初始规则、一次改多个分支、可继承的规则模板。 -
任务清单页:「任务还留在原来的任务板上」提示默认只占一行:任务建在「项目登记目录」之前、因此仍留在原来独立任务板上的工作流,任务清单页顶部会有一条琥珀色的归板提示。它原来是三段话一直展开着(电脑上约 86px、手机上约 150px 高),把第一条任务挤到了屏幕下半部。现在默认只留标题那一行加一个「说明」按钮(手机上整行是不小于 44px 的点按区),点一下展开完整的原因与后果、再点一下收起;换到另一张任务板时自动收起。提示的内容、出现的条件与接口都没有变。
-
异步对话:不用等 hook 接入,可以提前开启:以前必须先让编辑器 hook 接入、RelayMesh 收到过它的事件,才能打开某个工作流的异步对话开关(否则返回 409)。现在随时可以开:hook 还没接入时回执写明「异步对话已开启,等 hook 接入后自动生效」,本次对话暂按同步处理;一旦收到这个工作流 hook 的事件,就自动进入异步,不用再点一次;关掉就恢复成原来的样子。网页上的开关与状态提示、
async_mode接口(can_enable恒为true,保留给老前端)、主会话通过session_params恢复异步的规则(第一次开启永远是用户的事)都随之更新;见 异步对话模式。 -
分支会话:新建分支可以起工作流编号、绑目录、收窄开放范围:网页「新建分支」的「更多选项」里多了工作流编号(读得懂的名字比自动生成的一串字符好认,已被占用直接在输入框下提示);智能体的
branch(action: "create")多了可选参数branch(编号)、branch_directory(项目目录)、expose_preset/expose(开放范围)。智能体建分支时:开放范围只能收窄、不能放宽(managed、更高的「改参数」档位、打开「启动」都会被拒绝并点名);目录只能是没登记进任何项目、或登记在主会话自己的项目里的路径(按路径判断,不看主机,别的项目登记过的一律拒绝),否则分支会进到别的项目的任务板、看到别人的任务。被拒绝的请求不会留下半个分支。不带这些参数时与以前完全一样;网页上你自己建不受这些限制。 -
分支会话:「就绪度」说清主会话还缺什么:
branch(action: "list")的每个活动分支、以及create的结果里多了readiness,逐项(say发消息、decide代答请示、launch启动、assign派单)写明现在能不能用,不能的话还缺什么(比如「任务」没开到派单、分支和主会话不在同一张项目板、还没有指向它的启动预设)。网页的分支面板上,每个进行中的分支行多了「消息」「请示」两枚芯片,与原有的「启动」「派单」芯片并列,悬停有说明与下一步。 -
分支会话:主会话建的分支,开场说明据实写明:智能体用
branch(action: "create")建出来的分支,会话里第一条说明原来也写「已在网页创建,正在等待智能体接入」,读到的人会以为是自己在网页上建的;现在写成「已由主会话<工作流编号>创建为分支会话,正在等待分支的智能体接入」,其余内容(工作流编号、启动提示词)不变。用户在网页上建的分支与普通会话文案不变。 -
分支会话:
branch list的启动提示补一句留话与唤醒的区别:「启动」开着、也有续聊预设时,launch.how里除了preset_run的用法,再写明「只想留话、不必马上动手,用branch(action: "say"),分支下一次调用 RelayMesh 时会读到,不会被叫醒」。 -
分支会话手册补充:新增「留话、提醒与唤醒:几条路径各管什么」——
say、任务派单、编辑器 hook、preset_run、异常退出自动续跑(默认关闭)、你亲自发话各自能不能叫醒已经收尾的分支;按目的选路径的对照表;接手已有上下文的会话该按什么顺序读(checkpoint_get→inbox→chat list/chat read加peek)。 -
分支会话:分支默认沿用主会话的任务板,从根上避免「分支不在同一张板」(用户反馈):此前分支和主会话各按自己的会话目录归板——分支在目录登记进项目之前建了任务,就被钉在独立板上,登记目录换不了板、派单被拒(idcm-core 的事故,见「修复」里的归板原因一条)。现在分支只要满足「活动关系里的分支、自己的会话目录没有登记进任何项目(含已归档的项目)、名下没有钉在别的板上的任务或规划节点」,它的任务板就是主会话现在所在的那张板:主会话在项目板上,分支就在项目板上,不用先登记目录、也不用小心安排建任务的先后顺序;分支建的任务与主会话共用一套编号。分支在板上的权利是一条与项目权限档位无关的结构性边界:对主会话和别人建的任务、规划树里已有的节点只读,可以新建自己的任务、往规划树里追加自己的模块和功能、接手主会话派给自己的任务(接取、写进展、交付);想改别人建的任务,请它的创建者改,或请主会话指派给分支。关系结束之后分支仍留着自己的任务,权利不会因为结束而变大(别人的只读、自己的照改)。行为变化,请留意:以前在「关闭 / 仅审计」档里,沿用同一张板的分支可以直接改别人的任务,现在会被拒绝,拒绝文案写明「沿用主会话的任务板、对别人建的任务只读」以及怎么办。不适用或不变的情形:分支自己的目录登记在别的项目里——仍在那个项目的板上;分支在连成分支之前就有自己的任务(比如用
branch-link把早就在跑的会话挂到主会话下面)——板保持不变,不迁移、不改编号;主会话自己落在独立板上(目录没登记)时,分支沿用那张独立板,仍然派不了单(派单要求同一个项目的板),请用户登记主会话的目录——登记之后没有自己任务的分支会自动跟到项目板,不需要再登记分支的目录;登记完成之前主会话和分支都不要先建任务或规划节点。接口与工具:GET /api/v1/work-items的board_why多了inherited(带from主会话编号与from_title标题);branch(action: "list")的assign.board_reason多了inherited,branch(action: "create")对沿用主会话项目板的新分支不再带board_tip;分支的任务页顶部多一行「任务板沿用主会话「…」」。没有新增表与列,不迁移数据,不改任务编号;沿用是读取时按当前关系现算的,回滚到旧版本后没有自己任务的分支退回按目录归板,已经建在主会话板上的任务仍留在那张板上。见 分支会话「分支默认沿用主会话的任务板」。 -
分支会话:主会话页不再重复显示分支的内容,分支的消息与事件只在分支自己的页面上(用户反馈):此前分支与主会话之间的消息卡、你在分支里说话时抄送的署「你」的卡、分支的事件行(建立 / 结束 / 请示转交 / 参数修改等)也会出现在主会话页的对话里,与分支页重复。现在这些都只显示在分支页,主会话页的对话回到只有主会话自己的内容;分支面板与页头的「N 个分支」入口不变。为了不漏掉要你回答的事,页头「N 个分支」旁多了「待答 N」徽标(有几个活动分支正在等你回答);悬停说明里还写着有几个请示在等主会话的智能体定夺——这类请示不计入徽标,分支面板里那一行写「N 个请示待主会话定夺」。不受影响:主会话的智能体照常用
branch(action: "read" / "say")与收件箱收发分支的消息,请示的路由、确认卡与侧栏 / 页头的待答复数都没变。这是纯前端的变化:没有开关,没有改接口与数据;回滚到旧版本即恢复原来的显示。 -
侧栏「群聊」的群列表可以折叠,默认折叠:侧栏「群聊」入口右边多了一个折叠按钮(箭头),点一下展开 / 折叠入口下面最近有动静的几个群;默认是折叠的,升级后第一次打开,原来一直展开着的列表会收起来。折叠不会漏消息:入口那一行的未读数与「@我」角标照旧显示(是整个群聊的合计),页面也照常取群列表;在某个群的页面里折叠着时,入口那一行会高亮,告诉你现在就在群聊里。展开 / 折叠的选择只记在这个浏览器里(一个开关、没有任何业务内容),没有记忆或读不了浏览器存储时就是折叠;按钮能用键盘操作(
Tab聚焦、Enter/ 空格切换,读屏会读出「展开 / 折叠群聊列表」与当前状态),触屏上点按区更大,还没有群时按钮置灰。 -
重点通知的滑动确认条:滑块由圆形改成方块(用户反馈,符合项目风格):滑块是小圆角的方块(和项目里其它按钮、卡片一致),轨道与「已滑过的部分」也由胶囊改成小圆角矩形。顺手修正了轨道高度漏算边框的问题——滑块的下沿原来是贴着轨道边框的,现在上下居中、四边留的空一样宽(桌面轨道 40 → 42 像素,触屏 48 → 50 像素,滑块大小不变)。交互不变:滑过约 90% 才算确认,键盘 Enter / 空格 / 向右方向键也能确认。
-
网页诊断模式(诊断设施,已决定长期保留,之后出问题还用它采集):有用户的 Windows Edge 上打开某些会话约 2 秒后整页崩溃(
STATUS_BREAKPOINT,渲染进程里 V8 的致命错误,页面脚本捕获不到),退回「按需展开」与「手机输入法避让」之前的版本就不崩,Linux 上的 Chrome 148 / Edge 156 复现不了。为定位是哪一处新行为引起的,这两处改动现在各挂一个开关,默认全部关闭 = 回到以前的行为:?rm_diag=tail(末尾通知流按需展开:tailbar= 窗口顶部「更早还有 N 条未展开」细条,tailfill= 有界补齐与钉锚点后的基线更新)、?rm_diag=ime(手机输入法避让)、?rm_diag=trace(只记面包屑、不改任何行为),可用逗号叠加;?rm_diag=off清除;开关存在浏览器本地,之后不带参数也沿用。打开任一开关后:左下角有「诊断」徽标(点开可看说明、手动上报、复制、关闭);页面在后台把「最近发生了什么」(打开 / 路由 / 每批补齐前后的 DOM 节点数与 JS 堆 / 滚动 / 长任务)记在本地存储里;万一渲染进程崩了,重新打开时发现上一次没有正常退出,就把崩溃前的记录整理成报告、顶部提示并自动上报到服务端(POST /api/v1/diag/page-reports,只有网页登录用户能用,MCP 令牌一律 403,只留最近 50 份,读回用GET)。收件箱卡「几分钟前」改成每卡读 30 秒共享时钟的改动不受开关影响。 -
网页诊断模式新增「卡顿录制」:手机上开始录制 → 照常操作 → 停止并上报,一份报告说清卡在哪(诊断设施,一并长期保留):原来的「上报当前记录」只有最近 160 条面包屑(视口事件、长任务、报错、DOM 节点数与 JS 堆),分不清一帧里是脚本、样式布局还是绘制在花时间,也看不到有哪些动画在跑。诊断徽标的面板里多了「卡顿录制」:点「开始录制」后徽标变红显示计时,你照常操作(点输入栏、打字、收起键盘;有待答复的确认卡时再点它的输入框),再点徽标「停止并上报」。录的是数字:每一帧的间隔分布、长帧(Long Animation Frame)的分段与脚本归因(渲染之前是脚本、之后是样式 / 布局 / 绘制,脚本给出文件名与字符偏移)、慢交互(输入延迟 / 处理 / 呈现延迟)、键盘突发(布局视口缩了多少)与焦点落点(输入栏 / 确认卡 / 其它)、输入栏让位状态的切换、DOM 变动量(按 250 ms 分桶)、输入栏与会话列表的尺寸变化、屏幕快照(元素总数 / 会话列表内 / 已渲染轮次 / 末尾未渲染、JS 堆、确认卡个数、正在跑的动画按名字分组并标出无限循环与屏幕外的)。只记数字与元素类名,不记任何文字内容;默认不挂任何观察器(开始录制之后才挂,停止就摘);最长 90 秒,到点自动停止但不会自动上报;上报失败可重试、可复制、可丢弃。报告种类
record(POST /api/v1/diag/page-reports的种类白名单多了它,其余限制不变)。不改变任何默认行为。 -
手机(触屏设备)上默认走「有界渲染」并让输入栏避开别处的输入框;诊断开关的
off变成真正的逃生口,新增default:触屏设备(主指针是手指,(pointer: coarse))不用再手写?rm_diag=tail,ime——打开会话页默认就走末尾有界渲染(更早的通知不再一次画出两三万个元素,窗口顶部有「更早还有 N 条未展开」细条,向上滚到约两屏以内才补齐)和输入法避让(焦点在输入栏之外的输入框,比如确认卡的备注框、搜索框时,软键盘弹起不再把底部输入栏顶起来)。桌面浏览器(主指针是鼠标)当时一个默认都没有(后来也改成默认有界渲染,见本节「桌面浏览器打开会话页也默认走末尾有界渲染」一条)。默认值只是行为、不是诊断模式:没有徽标、不记面包屑、不写任何存储;显式写的开关叠加在默认值之上(手机上?rm_diag=trace= 有界渲染 + 输入法避让 + 记录,上报里flags是真正生效的开关、dflags标明哪些是默认带的)。逃生口:地址栏加?rm_diag=off把默认也整体关掉(回到以前的行为),并且记住,之后不带参数也保持关闭;?rm_diag=default清掉记住的设置、回到设备默认;徽标面板里的「关闭诊断」只关诊断(等价于default),不会把手机上的默认优化一起关掉。同时修了有界渲染下的一处隐患:窗口起点以前只按「块的键」钉住,而块的键会在晚到的卡片 / 新来的话让卡片重新分摞时改变,钉子一丢就把整段时间线一次渲染出来(几万个元素,手机主线程被占好几秒,真机第 1 号上报见过);现在有界渲染下改按条目钉(条目的键不变),条目也不在了才用钉住时的下标兜底。诊断开着时多一种面包屑tail:jump(起点一次往前跳超过两批,带来由与钉子的找回方式)。不改动画、不改桌面默认。 -
会话页:打开长会话不再「抖」十几秒——末尾通知流改成按需展开(手机与桌面浏览器现在都默认开启,见本节「桌面浏览器打开会话页也默认走末尾有界渲染」一条)(用户反馈:页面十分卡顿,堆叠的卡片越多,静止的页面抖得越久):以前打开会话页先画最新 12 块,其余在空闲时每批 12 块地补齐,总工作量与总时长随末尾块数线性增长(生产上 500 多块的会话要 14~17 秒才停下,期间主线程有近一半时间在忙)。现在打开后只补到视口上方约两屏(至少 1800 像素)就停,更早的内容在你向上滚到那里时即时补一批(约 0.1 秒),不多画一块;窗口顶部有一条「更早还有 N 条未展开」的细条,带「展开更多」(补一批)与「全部展开」两个按钮。内容一个不少、不折叠不截断;搜索命中、右侧轨、待答复徽标与 Q 引用的跳转会先补到目标再落地。取舍:浏览器自带的
Ctrl+F找不到还没展开的卡(页面内搜索与全局搜索Ctrl+K不受影响,也可以先点「全部展开」),右侧轨只含已展开的条目;末尾不超过 36 块时与以前完全一样。同时,收件箱卡的「几分钟前」状态文字改成每张卡自己读一个 30 秒一跳的共享时钟,不再每 10 秒让整页的卡片集体重渲染一遍。实验室成对对照(同一份库):末尾 400 块的会话,打开到页面稳定 8.0 → 2.5 秒、主线程忙 4.4 → 1.3 秒、长任务 14 → 3 个、页面元素 29,923 → 3,399 个;空闲时主线程基本不动。 -
授权页:有在用的旧授权时,「批准后撤销旧授权」不再默认勾上;「最近无使用」的界线从 7 天放宽到 30 天:最初的设计里这个勾选框默认勾上;但 ChatGPT 这类连接器往往低频使用,旧授权「最近没用」不等于没人在用,勾着它重新授权,仍在用旧授权的另一个会话下次刷新就会被拒绝、提示「需要重新连接」(令牌本身没有过期)。现在:旧授权里只要有一条连接器取过令牌(在用的),默认不勾,勾选框下面用一段黄字写明这些旧授权各自的最近使用时间与风险,确认它们都已经换成新授权再自己勾上;列出的旧授权全是半成品(批准了没取过令牌)时才默认勾上,没有谁会受影响。「沿用旧设置」的默认不变(有取过令牌的旧授权时勾上)。凭据管理里「最近无使用」的界线从 7 天放宽到 30 天(说明条与徽标文字跟着改成「最近 30 天……」);撤销单条授权、撤销其余旧授权、设置里撤销已授权的应用,这三种确认框都写明这条授权的最近一次使用(几天前加具体时间,没用过就说没用过),并提醒「最近没用不代表不再需要」。不涉及库结构变更与接口变更(
supersede仍由批准请求体显式传入)。
修复
-
按工作流读会话时,条数超过 50 被悄悄改成 10:存储层
GetSessionsByWorkflow/GetFeedbackRoundsByWorkflow把大于 50 的条数改回默认的 10,所以get_session_history想要「最近 100 行」只拿到 10 行、list_sessions带workflow_id与limit也最多 10 条(默认limit是 20,最大 100),而这些行里进度通知占了大头。现在没给条数(≤ 0)仍是默认 10,大于上限 200 才按 200 截断,其余按给的数取;原来传 1 / 5 / 10 / 20 / 50 的调用方不受影响。不涉及库结构变更。 -
「可升级」不再误报:Agent 有了独立的「升级级别」登记表:主机卡片上的「可升级」以前只看 Agent 侧代码指纹——指纹只能说「代码变没变」,说不出「这一变对这台主机有没有必要升级」,所以只改了注释、只改了别的系统的代码、或只是调整了指纹覆盖的目录,没有任何实际变化的主机也会亮「可升级」(一台线上的 Windows 主机就因为一次「指纹多算了一个目录、代码没变」的提交亮了灯)。现在每个发出去过的指纹都登记在
internal/agentrev/history.json这张只追加的表里:一行 = 一个指纹 + 这一版相对上一版哪些系统必须升级(windows/linux/darwin/all,或none)+ 一句人话说明;一个系统的「升级级别」就是表里到这一行为止、对它必须升级的行数。主机与服务端自带的指纹都登记在表里时,Hub 按这台主机的系统比级别:级别更低才标「可升级」,悬停多一行「升级后得到:…」;指纹不同但级别相同则不标,展开主机详情写「与服务端自带的 X 有差异,已确认无需升级」(悬停列出差异是什么),Web 一键升级也以同样的理由拒绝(主机上手动agent upgrade不受限制),静默自动升级也不再把这类主机当作有新版本;主机在表里排在服务端自带的这一版之后(服务端回退过)则不提醒。任何一边没登记(旧 Agent、本地开发构建)仍按原来的指纹 / 版本号规则判断,不会因此丢提醒;Agent 一侧「守护进程比主程序旧」的提示依旧是逐字节比对指纹,不放宽。只改 Hub 一侧的判断,Agent 与线协议都没变;主机视图新增两个可选字段up_to_date_by_level与upgrade_notes,旧前端会忽略它们;不涉及库结构。上线时登记了到当前版本为止的 14 行(其中只改注释、只改指纹覆盖范围、GUI 唤醒的线协议与执行器入库、Windows 升级后的启动重试等登记为「无需升级」)。新增命令go run ./cmd/agentrev record --bump <系统> --note <一句话>(登记新行)、check(查当前源码是否已登记)、list(列出整张表与各系统的级别);有测试保证当前源码的指纹已登记,发版与部署前的自检也会先查;表不在指纹范围内,登记新行不会改变指纹。见 远程终端运维 的「Agent 侧代码指纹」。 -
Windows 升级后 Agent 没立刻起来:升级命令现在会自己再启动,并把看门狗的兜底说清楚:
relaymesh-agent upgrade停掉旧 Agent、换好程序后会重新启动它的计划任务。刚停掉旧实例时,任务计划程序有时会因为任务的「实例已存在则忽略」策略,吞掉马上到来的启动请求——命令报成功、进程却没起来。在一台真实机器上(v1.6.3直接升到v2.1.0的第一次升级)就是这样:命令输出「几秒内没有看到 Agent 进程」,新 Agent 直到 3 分 50 秒后计划任务的看门狗(每 5 分钟一次的重复触发器)触发才上线,期间主机在 Web 上显示离线,用户以为升级把它搞坏了。现在没看到进程时命令会自动再启动一次计划任务(最多共 3 次;进程已在运行时重复启动会被同一条策略忽略,不会起第二个),成功时在输出里如实提示「前 N 次启动没有拉起进程,已自动重试」;3 次都没起来也不算升级失败(程序已经换好),输出会写明「看门狗每 5 分钟触发一次,最迟约 5 分钟内会把 Agent 拉起来,这几分钟里主机显示离线」,并给出可直接粘贴的立即启动命令schtasks /Run /TN <任务名>;install里同样的「没看到进程」提示改用这套说法。会话守护进程仍然不动,里面的会话不受影响。只影响 Windows 的升级 / 安装输出与启动重试,不涉及库结构。见 远程终端运维 的「升级窗口 + 命令」。 -
OAuth:没填「对外地址」时,授权完成后客户端不再报「issuer 不匹配」(用户反馈):Hub 的授权服务器按 RFC 9207 在授权响应里带
iss,MCP 客户端会拿它与元数据里的issuer逐字比对。环境变量与设置页都没填「对外地址」时,元数据的issuer是按请求头推导的(如https://relaymesh.example.com),而批准授权那一步(Web 授权页的 REST 调用)手头没有原始请求,算出来的iss却是http://127.0.0.1——用户走完授权页,客户端提示「OAuth authorization response issuer does not match the expected issuer」并放弃授权。现在发起授权时就把当时对客户端宣称的 issuer 记进待决请求,批准与拒绝都用它,元数据、批准、拒绝与出错重定向四处一致;填了对外地址的部署本来就一致,不受影响。新增回归测试覆盖「没填 / 填了」两种情形,不改库表。仍建议在 设置 → OAuth 授权里填好对外地址(见 docs/oauth.md「对外地址优先级」),不要依赖反向代理头。 -
安装脚本在 BusyBox 路由器固件上不再把 Linux 认成「Linlx」(用户反馈,QWRT 等 OpenWrt 系固件):在这类设备上执行 Web 生成的安装命令会报「不支持的操作系统: Linlx」。原因是脚本用
tr '[:upper:]' '[:lower:]'把uname -s转小写,而这类固件的 BusyBox 没带tr的字符类支持,会把[:upper:]当成普通字符逐位对应(u变成l),Linux就成了Linlx(同样环境里 macOS 与 Windows 的 Git Bash 也会被误判)。现在平台检测不再调用tr,直接按uname -s的常见写法匹配;遇到真正不支持的系统或 CPU 时,错误信息会同时带上系统名与 CPU 的原值。安装脚本由 Hub 发放,升级 Hub 后在 Web「接入主机」重新复制命令即可拿到新脚本。这一条只修「认出系统」;OpenWrt 用 procd、没有 systemd,之后注册常驻服务的部分见「新增」里的 OpenWrt(procd)支持。 -
群聊:Agent 发一条消息,不再把别人先发、自己还没读的话悄悄标成已读:Agent 在群里发消息时,它的已读游标会跟到自己这一条;而默认的
chat read只从游标往后取,所以别人先发、它还没读的话就被越过去,再也读不到,群里的已读回执也会把这条话误显示成「已读」。现在游标只推到「它还没读的、别人发的第一条文本」之前(入群之前的消息、系统行不算);读过之后再发,游标照旧跟到自己这一条。你在网页上发消息的行为不变(整段群聊都摆在你眼前)。 -
分支会话:「不在同一张任务板上」说清真实原因,不再一律劝人去登记目录(idcm-core 反馈):分支在目录登记进项目之前就建了任务,之后再把目录登记进主会话所在的项目,分支仍然不在同一张板、派单继续被拒——因为一个工作流名下一旦有了任务或规划节点,就钉在这些任务当时所在的板上,登记目录不会自动换板(换板会改任务编号,只能经用户确认的显式合并,这个功能目前还没有)。以前各处提示只会说「目录没登记」,把人引到一个修不好问题的动作上。现在:
branch(action: "list")里分支的assign在不同板时多了board_reason(dir_not_registered/no_session_dir/project_dir/pinned_by_tasks/pinned_by_modules)与board_note(一句话事实,写明钉住了几个任务、目录现在属于哪个项目),问题出在主会话一侧时还有main_board_reason;how、readiness、派单被拒的文案(仍含「不在这张任务板上」)和网页分支面板里「可派单 · 不同板」芯片的悬停说明都按真实原因写下一步——目录没登记的才建议去登记,已被任务钉住的明说「登记目录换不了板、暂时派不了单、需要用户决定」。branch(action: "create")建出还不同板的分支时,结果里带board_tip,提醒「先登记目录,再让分支里的 Agent 建任务或规划节点」(手册与网页「新建分支」窗口里也加了这条先后顺序)。任务页在「任务钉在原来的板上、而会话目录现在归属另一张板」时,顶部多一条只讲事实的说明(GET /api/v1/work-items的响应多了board_why,其余情况不出现),任务照常可看可改。没有新增表与列,不迁移数据,不改任务编号,也没有提供换板或合并的功能;老前端忽略新字段照常可用,回滚到旧版本只是回到旧的提示文字。(之后新建的分支默认沿用主会话的板,这一条主要覆盖老分支与「主会话自己不在项目板上」的情形,见「变更」里的分支默认沿用主会话的任务板。)见 分支会话「为什么不在同一张板」与 共享任务板「工作流在哪张板上」。 -
手机上在确认卡、总评框、搜索框里打字时,底部输入区不再跟着软键盘上顶(用户反馈):触屏设备上,当焦点落在底部输入区之外的输入框(确认卡的「其他(自定义)」文本框、总评框、各类搜索框……)并且软键盘弹起时,底部输入区临时收起(草稿不丢),把本来就只剩一小条的可视高度让给正在输入的那个框,并把它滚进可见范围;焦点回到输入区自己的文本框、失焦或键盘收起时恢复。只在触屏设备上判定,桌面没有任何变化。这一项用浏览器里的模拟软键盘(缩小视口)验证过,没有在真机上测过。
-
会话页:向上翻看长会话时,补齐的几批内容偶发把页面拽回最底部(实验室在很忙的主机上见过一次,生产没有收到过报告):你向上翻看时,补齐每插入一批更早的内容,都会把正在看的那块钉在原位;但钉住之后,用来推算「变化之前是不是贴着底部」的上一次大小没有跟着更新,紧接着的下一批(或迟到的一帧)把「滚动位置比记录的大小还靠下」误判成「本来就在底部」,把你拽回最底下。现在钉住之后立刻把这份记录更新到当时的大小。新增一条确定性的端到端用例(连着补两批、两批之间不留一帧),改前必然复现(正在看的那块 240px → −761px、离底 0),改后纹丝不动;浏览器里向上载入更早的轮次早就有同类处理。
-
OAuth:令牌端点遇到库错误不再冒充「授权已失效」,
/oauth/revoke现在认刷新令牌,策略读不出来时不再发出零时长令牌:审查令牌端点时发现三处潜在问题,都在连接器最依赖的刷新路径上:① 库读写出错被当成授权失效:刷新时查库或写库失败,原来返回400 invalid_grant,连接器会据此丢弃授权、要求用户重新连接;现在返回500 server_error(连接器应稍后重试,授权完好),并在审计里记lookup_error/write_error;刷新轮换的写库顺序改成「先存新访问令牌、再换刷新令牌」,任何一步失败都不会把没存下的令牌交给连接器,旧的刷新令牌仍然有效。②/oauth/revoke(RFC 7009)带刷新令牌从来没有生效过:刷新令牌与访问令牌共用rmo_前缀,原来的代码按前缀判断类型,刷新令牌总被当成访问令牌去查、查不到就什么也没撤销(即使走到刷新令牌那一支,也只作废授权、不停用凭据、不写审计);现在先按访问令牌查、查不到再按刷新令牌查,两种写法走同一条撤销路径,来源记为source=connector;刷新令牌只认当前那一枚——已被轮换掉的旧刷新令牌(连接器刷新之后顺手清理旧令牌)按 RFC 7009 回 200、什么都不做,不会把刚签发的整条授权一并撤掉(查授权时「上一枚」令牌也会命中,宽限期与重放检测要用它)。③ OAuth 策略读不出来时按默认值处理:原来读取出错会得到全零策略(访问令牌有效期 0、刷新空闲 0 天),签发出一条立刻过期的授权;现在读不出来就用内置默认值。均有单元与集成测试覆盖(故障注入模拟库读写失败)。
安全
- 访问日志不再记下搜索框里输入的内容:全局搜索的检索词放在网址的
q=参数里,而 Hub 的访问日志会原样记下整条网址——你在搜索框里粘贴的一串密钥(想查「它用在哪」)就会留在日志里。现在/api/路径上的q=与令牌类参数(token、ticket、access_token、key、api_key、password)一样记成***。已经写进旧日志的内容不会被改写;反向代理(nginx 等)自己的访问日志不归 Hub 管,同样会记下网址里的q=,需要的话请在代理上屏蔽这个参数。
升级须知
- 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增、不删除也不改写已有数据:新增 16 张表——回收站两张(
workflow_trashes、group_trashes)、项目归档增量基线(archive_baselines)、页面诊断上报(page_diag_reports)、全文索引(search_entries、search_states、search_stales,以及虚拟表search_fts和它自带的三张内部表search_fts_config、search_fts_data、search_fts_idx)、语义检索(embed_credentials、embed_usages、embed_projects、embed_entries、embed_chunks);7 个可空或带默认值的列——feedback_sessions.notice_level/acked_at/reply_hints/reply_hints_at、queued_feedbacks.hints/hints_at、mcp_credentials.archive_projects;以及feedback_sessions上的覆盖索引idx_fs_wf_proj。在一份按 2.1.0 的结构造出来的库上做过升级演练(含带图片的长会话、项目、任务、确认项与知识库文档):升级后没有表或列消失、旧表的行数没有变少,接口读到的会话、任务、确认项、项目与知识库文档与升级前逐项一致。如果配置过语义检索的 API Key,备份时要把数据目录里的master.key一起带上(它与数据库配对,丢了就得重新填 Key)。 - 升级后的第一次启动会在后台为已有内容建全文索引(本机,不外发):Hub 马上就绪、照常可用,建立期间搜索结果可能不完整,「设置 → 搜索」里看得到进度。演练里按 2.1.0 的结构灌了会话汇报:5 万条(库约 270 MB)0.7 秒就绪、约 47 秒补齐索引,20 万条(库约 1.08 GB)1.9 秒就绪、约 234 秒补齐,补齐后重启约 0.3 秒就绪;补齐期间前台请求全部成功,Hub 内存峰值约 66 ~ 68 MB。索引体积请按真实内容约为原文的 0.74 倍预留空间(演练用的是合成数据,库只多了约一成:5 万条 270 → 303 MB,20 万条 1.08 → 1.20 GB,不能照搬)。不想在第一次启动时建索引:带环境变量
RELAYMESH_SEARCH_INDEX=off启动,以后想开再去掉它、在「设置 → 搜索」里打开。 - 需要退回 2.1.0 时换回旧程序即可,不需要先执行任何 SQL:2.1.0 忽略新表与新列(新表原样留在库里,再升回来仍在),本版没有引入 2.1.0 不认识的收件箱行种类。演练里(含 5 万与 20 万条会话汇报的大库)2.1.0 打开升级后的库照常就绪、没有表或列消失、行数没有变少、接口读到的数据与升级前一致、完整性检查通过,再升回来同样没问题。退回之后本版的功能在 2.1.0 里不存在:回收站里的会话与群聊看不到(升回来仍在)、侧栏顺序回到旧的自动规则、语义检索与相关线索停用,新的 MCP 工具
search与project_archive消失(MCP 客户端缓存了工具列表时要重连一次)。 - 已归档的群聊不再给成员「发」群授权(安全相关的行为变化):升级后,已归档的群在项目里持有的授权不再让成员继承(授权记录本身保留,取消归档后恢复)。如果你一直靠一个已归档的群给某些会话开着项目权限,升级后它们会失去这份权限,要么取消归档,要么在项目页重新授权。
- 侧栏顺序改为手动顺序:升级当天侧栏一格不动,第一次打开时把当前看到的顺序固化为初始顺序;之后不再按日期、活跃度或待确认自动排序,新会话排在最上面,要重排就拖动。顺序存在服务器上,各设备一致。
- 会话页桌面与手机都默认只渲染末尾一段:更早的内容在向上滚到约两屏以内时补齐,浏览器自带的
Ctrl+F找不到还没展开的卡(先点「全部展开」,或用页面内搜索与Ctrl+K)。地址栏加?rm_diag=off可回到整段渲染(会记住)。 - 这一次升级的重启,挂着等待的智能体仍会被切断一次:新的「热更新先唤醒、带『服务更新』回执结束这一轮」要等装上本版之后的下一次重启才生效,升级这一次退出的仍是旧进程;智能体照回执里的指引
AwaitShell后调用continue_feedback_session即可接上。 - 新增一个不需要登录的匿名入口
POST /api/v1/diag/browser-reports(默认开启):浏览器崩溃后用它自报原因。入口只收崩溃类通知、请求体不超过 8 KB、一次最多 5 条、全站每分钟 30 条、每个来源地址每分钟 10 条,只存字段白名单整理后的内容(不含会话内容),超限或关闭时一律回 204 不入库。不想开放:「设置 → 诊断」里关掉,关掉后首页不再带上报地址。 - 默认不会发出任何内容的新功能:语义检索(要你打开总开关并勾选项目)、相关线索(语义检索与「允许智能体使用语义检索」都要开)、GUI 接管式唤醒(要主机所有者在那台主机上写同意文件)都默认关闭;全文索引、项目归档导出、回收站、浏览器崩溃自报默认可用,其中只有崩溃自报接收不需要登录的请求(见上一条)。
- 几处智能体与授权相关的默认变了:授权页在有「在用的旧授权」时,「批准后撤销旧授权」默认不再勾上(ChatGPT 这类低频使用的连接器,旧授权「最近没用」不等于没人在用);
get_session_history默认返回最近 30 轮汇报(约 3 万字符),进度通知只列标题与第一行;任务页的搜索框改走全文索引,规则与全局搜索一致(英文整词 / 前缀、单个汉字不能单独检索),「设置 → 搜索」里可以关掉「页面搜索走全文索引」回到原来的搜索;Hub 的访问日志不再记/api/请求里的q=。MCP 客户端缓存着旧的工具列表时,升级后要重连一次才看得到search。 - 本版改动了 Agent 的代码,已装的 Agent 照常可用,用新能力再升级:改动是 OpenWrt 系固件用 procd 托管常驻服务、GUI 接管式唤醒的 Agent 一侧(默认关闭)、Windows 升级后启动计划任务被吞时自动重试、GUI 唤醒的一处调用竞争修复。握手多两个可选字段、Hub 与 Agent 之间多
gui_req/gui_res两种帧,新旧版本互相忽略不认识的部分,已装的 Agent 不升级也与新版 Hub 配合。主机卡片上的「可升级」按internal/agentrev/history.json的升级级别判断:从 2.0.0 / 2.1.0 的 Agent 升到这一版会亮灯(登记了两次「所有系统必须升级」:OpenWrt 支持与 GUI 唤醒的 Agent 一侧),悬停会写明升级后得到什么;用不到这些能力就不必升级。自动升级默认仍然关闭。 - 构建基线不变:从源码构建需要 Go 1.26 或更高,Go 模块路径仍是
github.com/teacat99/RelayMesh/v2。
已知限制
- GUI 接管式唤醒没有在真实的 Cursor 客户端上发送过:选择器来自对 Cursor 3.27.x 窗口结构的只读观察,全部动作只在假的 Agents 页面上验证过;第一次真实使用请你在场、先用
probe校准。 - OpenWrt(procd)没有在真机上验证过:只用 procd 模拟器与 BusyBox
sh覆盖过脚本生成与安装 / 回滚 / 卸载 / 升级流程;预编译的 Agent 只有 linux/amd64 与 linux/arm64,其他 CPU 请自行编译。 - Windows 主机的非交互续聊:只用假的
agent.cmd在两台真实 Windows 主机(Windows PowerShell 5.1 与 PowerShell 7.6)上验证过命令的拼装与传递;真正的 Cursor CLI 垫片没有实测过。 - 分支会话与 OAuth 连接器:分支会话的自动化验证用的是模拟的 agent,「主会话用
preset_run唤醒分支」没有做过真实运行的验证,第一次请在场观察;OAuth 接入的自动化测试用模拟的客户端,ChatGPT 连接器已有真实使用与反馈(本版的授权再授权、审计补全与默认值调整都来自它),Claude 连接器的联调还没有记录。 - 手机宽度:界面只在 390px 宽上验证过。
- 浏览器崩溃自报:只在 https 页面上有效;真崩溃实测过 Chrome 148,Edge 上是否送达没有实测;一次崩溃可能报多份。
- 很长的会话:默认只渲染末尾一段的取舍见「升级须知」(
Ctrl+F找不到未展开的卡)。2.1.0 记下的「打开长会话时累计版面位移偏高(约 0.4 ~ 0.7)」本版没有重新量出数字,只有用户在两个重型会话里的复测(帧间隔平稳、没有版面抖动)。 - 非常大的库第一次升级:20 万条会话汇报(库约 1.08 GB)的演练里,建全文索引期间会话列表的响应中位数约 1.1 秒(5 万条时约 0.4 秒),登录状态接口(
auth/status,中位数约 36 毫秒)出现过一次约 3.3 秒的耗时,原因没有查明、没有请求失败。这个规模以上的库,升级后第一次启动请预留几分钟,或用RELAYMESH_SEARCH_INDEX=off先错开建索引。 - 语义检索与相关线索的阈值:语义检索的默认相似度下限(0.50)来自 15 道自拟问题的小样本,相关线索里会话汇报类的下限(0.70)来自对真实回复的少量观察,都不是统计结论,所以做成了可调。
Full Changelog: v2.1.0...v2.2.0