Skip to content

Releases

v2.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 18:51

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,三种真崩溃:CDP Page.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,别的标签页 / ...

Read more

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 25 Oct 11:31

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 不再...
Read more

v2.0.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 04:19

2.0.0 是一次大版本:RelayMesh 从「人与 AI 的交互中继」扩展成带远程终端、模型执行、异步协作与项目任务的协同平台,同时有若干需要留意的行为变化(见「变更」与「升级须知」)。试用过 2.0.0-rc.1 ~ 2.0.0-rc.3 预览版的,本版包含它们的全部内容并带有后续的修复。

从 1.x 升级:先读文末「升级须知」(备份数据目录、Go 模块路径加了 /v2、已装的 Agent 不会自动升级)。

新增

  • 远程 Web 终端(ExecMesh):在浏览器里打开已装 Agent 的主机上的终端。Agent 可作为系统服务常驻运行(Linux / macOS / Windows),并提供 install.sh / install.ps1 一键安装;会话守护进程让 Agent 升级、重启或崩溃时终端会话不被杀掉;终端内容只保存在主机本机,服务端永远不存终端内容;还有 Web 一键升级 Agent、长上下文终端按需加载、历史日志与右键菜单。没有自带安装源的部署(单二进制 / go run)里,页面生成的安装命令会固定到这台服务端自己的版本(Release 二进制,以及 go run …@vX.Y.Z / go install …@vX.Y.Z 编出的程序,现在都能报告自己的版本号,不再显示 dev)。
  • 让模型在授权主机上执行命令(ExecMesh 档,默认关闭):terminal_targets / terminal_exec / terminal_run 三个 MCP 工具,以及文件能力 terminal_files(默认关闭,只能访问你指定的目录)。MCP 令牌改为一机一令牌加档位(RelayMesh / ExecMesh / 自定义),配合「模型 × 主机」授权与审计记录。
  • SSH 网关:经一台已装 Agent 的主机,接入没有 Agent 的 SSH 主机(人和模型都能用);登录凭据只保存在网关自己的存储里。
  • Agent 自动升级与发布签名:「提示」与「静默」两档(默认全关,同意发生在主机本机,服务端另有总闸);静默升级前会用编进 Agent 的 ed25519 发布公钥验签,验不过就不安装。GitHub Release 里的 Agent 程序会在正式发布后补签,对应的 .sig 作为 Release 资产提供,自己托管 Agent 分发目录的人可以直接用;用法与限制见 远程终端运维说明。
  • 异步协作:异步对话模式(「发了就走」,授权档位取代阶段滑块;不可逆操作改发 L2 确认卡,批准前绝不执行)、确认项(async_ask)、追加指令收件箱、Agent 身份与状态、聊天与群聊(chat 工具)、ntfy 推送、统一通知闸;HTML Artifact、数据 KV、评论、反链与项目 ZIP。
  • 项目、文档与任务:项目结构与项目文档库(project_docs)、任务清单与共享任务板(task_board:指派、接取、交付、验收、退回,任务级权限)、正文引用链接统一(#N、Q<N>、[[文档]]、sess-…)、内置使用手册(usage_guide)、项目管理 Agent 经 MCP 运行预设(preset_run,默认全关)。
  • 非交互续聊与会话守护:会话停摆检测与一键唤醒、终端预设与运行入口、自动续跑、网页「启用 Agent」、单次运行超时可配(上限 7 天)。
  • 新建会话「高级选项」:工作流编号、首条指令、初始阶段、项目目录与主机;默认收起,不填时与以前完全一样。
  • stdio 直驱支持多个编辑器窗口:同一个用户开多个 Cursor / Claude 窗口、各自配置 mcp stdio 时,第一个进程成为主进程(数据库、端口、网页控制台),后起的窗口自动接入、各自开会话,全部汇总在同一个控制台;主进程所在窗口关闭后,其余窗口在几秒内自动接管。以前第二个窗口会因为端口被占用直接报错退出。
  • OAuth 2.1 授权服务器(默认关闭):ChatGPT、Claude 等连接器可走授权码加 PKCE,令牌复用 ExecMesh 的全部闸门。
  • 预览视图(新会话视图):统一消息卡、右侧轨、整段历史搜索、未读与「以下为新消息」、会话级状态、群聊卡片与成员头像;加载更快:离屏卡片跳过渲染、先取索引再按需取正文、渐进渲染、次要请求让路。
  • 部署与文档:README 与部署示范重做(.env 驱动的 Compose 模板、AI 部署指南、验证 / 升级 / 备份 / 回滚 / 排错);补齐「进阶、调试与 Agent 变量」参考表,代码里读得到的环境变量在文档里都查得到。

变更

  • 默认会话视图改为预览视图:升级后没选过视图的设备默认进入预览视图;点一次「回到经典视图」就会被记住(每台设备各自一份)。单会话的「聊天视图(预览)」入口已删除;群聊窗口只有统一消息卡这一种画法(不再随预览开关切换),群聊里没有引用回复。
  • 异步对话开启后,授权档位取代阶段滑块;同步模式的回执逐字不变。
  • 会话阶段收敛为「讨论 / 方案 / 开发」三段;旧的阶段编号在所有入口自动映射,存量数据在启动时迁移(评估 / 方案 / 开发三条里你改过的文案原样保留,「验证」「完成」并入「开发」,这两条的自定义文案不保留)。
  • MCP 令牌:改为一机一令牌(/mcp?token= 的写法长期兼容);令牌只能访问 /mcp,不能再调用 REST / SSE 管理接口(返回 403 mcp_token_forbidden);凭据库里已有凭据时,/mcp 不再接受无法识别的令牌(以前带错误令牌会落入「开放访问」而照常通过);新建令牌默认不含终端权限;查看令牌明文需要再次验证 Web 口令。
  • 默认值:Docker Compose 模板默认监听所有网卡(README 已加强警告);远程终端总开关默认 auto(已设置 Web 密码且 JWT 密钥足够强才启用);模型执行与远程文件默认关闭。
  • 内嵌前端现在带缓存头:带哈希的 /assets/* 缓存一年(immutable),index.html 等为 no-cache 加 ETag。
  • stdio 直驱模式的侧栏默认收起:只有一个工作流时网页侧栏默认收起(编辑器侧边栏里只有这一个会话,不占地方),出现第二个工作流时自动展开;你手动展开 / 收起过就一直按你的选择。常驻服务(Docker / relaymesh serve)的行为不变,手机端不变。/api/v1/auth/status 新增只读字段 run_mode(stdio / serve)。
  • stdio 直驱遇到端口被占用时不再一律退出:占着端口的是另一个 RelayMesh stdio 进程时自动接入;是常驻服务(Docker / relaymesh serve)或别的程序时仍然退出,报错里写明占用者类型和怎么办(改用常驻服务的 http://127.0.0.1:<端口>/mcp,或用 RELAYMESH_PORT 换端口)。接入凭证 stdio-hub.json(权限 0600)放在数据目录,主进程每次启动重新生成、正常退出时删除。
  • 确认卡常驻「其他(自定义)」:预设选项都不对时可以自己写答复。
  • 侧栏左上角在远程终端可用时出现 RelayMesh | ExecMesh 切换器;设置按模块分类。
  • Cursor hook 的一键安装在没有 agent-dist 的部署里也能用:单二进制、go run、stdio 直驱的 Hub 自己拿不出 relaymesh-hook 时,install.sh / install.ps1 会自动改从 GitHub Release 下载(Hub 是正式版本时取同一个版本,开发版取最新;一律校验 SHA256,校验失败不换源重试);RELAYMESH_VERSION、RELAYMESH_REPO、RELAYMESH_DOWNLOAD_BASE 可调。docs/inbox.md 补了 stdio 下装 hook 的步骤。

移除

  • 「在线 / 暂离 / 托管」我的状态(数据库列保留,REST、MCP 回执分支与提示词设置已删)。
  • 旧的聊天视图窗口及其组件。
  • 两个从未生效的环境变量 RELAYMESH_ALLOW_NON_LOOPBACK、RELAYMESH_WAIT_COUNTDOWN_MINUTES:设置后一直没有任何效果,现在同样被忽略,不会报错。

安全

  • 去掉 Google Fonts 外链,网页内容安全策略(CSP)默认强制执行(RELAYMESH_CSP)。
  • MCP 请求体有了 8 MiB 上限(超出返回 413);环境变量令牌改为恒定时间比较。
  • stdio 主进程为多窗口新增了仅限本机的转发入口 /mcp-local:只在 stdio 主进程上存在(常驻服务、Docker、生产一律 404),要求 TCP 对端是回环地址并带数据目录里权限 0600 的随机钥匙(恒定时间比较,错误尝试限速),请求体上限 16 MiB,钥匙不写进任何日志与输出。
  • Agent 发布签名与验签(见「新增」);SSH 登录凭据只在网关、终端内容只在主机本机。
  • 依赖安全升级:Go 侧 golang.org/x/net(0.61.0)、golang.org/x/crypto(0.58.0,含 SSH 客户端的多项拒绝服务与认证相关修复)、golang.org/x/text(0.43.0)、quic-go(0.59.1),前端 axios(1.20.0)、vue(3.5.44)等。升级后 govulncheck 对源码与发布用的二进制都是 0 条可达漏洞,前端生产依赖 pnpm audit 为 0 条。
  • 构建基线提到 Go 1.26(go.mod 的 go 1.26.0、toolchain go1.26.9):上游已不再给 Go 1.25 回补标准库 HTTP/2 服务端的漏洞修复(GO-2026-6617 等,修复版本是 1.26.9 / 1.27.2),官方镜像与预编译二进制必须用 1.26.9 及以上构建;Dockerfile 与发布流水线已同步。

升级须知

  • 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增表与列,没有删除;回退到 1.6.x 的步骤与注意事项见 远程终端运维说明。
  • 从源码构建需要 Go 1.26 或更高(原来是 1.25);Docker 镜像与预编译二进制不受影响。
  • Go 模块路径从 2.0 起带 /v2(Go 对 2.x 版本的硬性要求):用 go run / go install 运行 RelayMesh 的,以及在 Cursor / Claude 等 MCP 配置的 args 里写了 go run github.com/teacat99/RelayMesh/cmd/relaymesh@latest 的,请改成 go run github.com/teacat99/RelayMesh/v2/cmd/relaymesh@latest;旧写法不会报错,但只会停在 1.x 的最后一版(1.6.3)。自己构建 Agent 并用 -ldflags -X 指定信任名单的,包路径同样要写成 github.com/teacat99/RelayMesh/v2/internal/relsign/trust.override。Docker 镜像、预编译二进制、install.sh 与 hook 安装器不受影响。
  • 已装在主机上的 Agent 不会被自动升级(自动升级默认关闭)。2.0 起可以在 Web 里一键升级,Agent 与会话守护进程请逐台按提示操作。
  • 新增了一批环境变量,默认值都是保守的(关闭、留空或最小权限),完整清单见 README 的「核心环境变量清单」一节。
  • 完整的行为变化清单(令牌、阶段、界面等)见 远程终端运维说明 第 3 节。

Full Changelog: v1.6.3...v2.0.0

v2.0.0-rc.3

v2.0.0-rc.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 20 Oct 19:13

预发布版本(预览):功能与行为可能在正式版之前调整,不建议用于生产。Docker 镜像标签为 2.0.0-rc.3;latest 镜像与 install.sh 默认下载的「最新正式版」不受影响。

即将发布的 2.0.0。这是一次大版本:RelayMesh 从「人与 AI 的交互中继」扩展成带远程终端、模型执行、异步协作与项目任务的协同平台,同时有若干需要留意的行为变化(见「变更」与「升级须知」)。

新增

  • 远程 Web 终端(ExecMesh):在浏览器里打开已装 Agent 的主机上的终端。Agent 可作为系统服务常驻运行(Linux / macOS / Windows),并提供 install.sh / install.ps1 一键安装;会话守护进程让 Agent 升级、重启或崩溃时终端会话不被杀掉;终端内容只保存在主机本机,服务端永远不存终端内容;还有 Web 一键升级 Agent、长上下文终端按需加载、历史日志与右键菜单。没有自带安装源的部署(单二进制 / go run)里,页面生成的安装命令会固定到这台服务端自己的版本(Release 二进制,以及 go run …@vX.Y.Z / go install …@vX.Y.Z 编出的程序,现在都能报告自己的版本号,不再显示 dev)。
  • 让模型在授权主机上执行命令(ExecMesh 档,默认关闭):terminal_targets / terminal_exec / terminal_run 三个 MCP 工具,以及文件能力 terminal_files(默认关闭,只能访问你指定的目录)。MCP 令牌改为一机一令牌加档位(RelayMesh / ExecMesh / 自定义),配合「模型 × 主机」授权与审计记录。
  • SSH 网关:经一台已装 Agent 的主机,接入没有 Agent 的 SSH 主机(人和模型都能用);登录凭据只保存在网关自己的存储里。
  • Agent 自动升级与发布签名:「提示」与「静默」两档(默认全关,同意发生在主机本机,服务端另有总闸);静默升级前会用编进 Agent 的 ed25519 发布公钥验签,验不过就不安装。GitHub Release 里的 Agent 程序会在正式发布后补签,对应的 .sig 作为 Release 资产提供,自己托管 Agent 分发目录的人可以直接用;用法与限制见 远程终端运维说明。
  • 异步协作:异步对话模式(「发了就走」,授权档位取代阶段滑块)、确认项(async_ask)、追加指令收件箱、Agent 身份与状态、聊天与群聊(chat 工具)、ntfy 推送、统一通知闸;HTML Artifact、数据 KV、评论、反链与项目 ZIP。
  • 项目、文档与任务:项目结构与项目文档库(project_docs)、任务清单与共享任务板(task_board:指派、接取、交付、验收、退回,任务级权限)、正文引用链接统一(#N、Q<N>、[[文档]]、sess-…)、内置使用手册(usage_guide)、项目管理 Agent 经 MCP 运行预设(preset_run,默认全关)。
  • 非交互续聊与会话守护:会话停摆检测与一键唤醒、终端预设与运行入口、自动续跑、网页「启用 Agent」、单次运行超时可配(上限 7 天)。
  • 新建会话「高级选项」:工作流编号、首条指令、初始阶段、项目目录与主机;默认收起,不填时与以前完全一样。
  • stdio 直驱支持多个编辑器窗口:同一个用户开多个 Cursor / Claude 窗口、各自配置 mcp stdio 时,第一个进程成为主进程(数据库、端口、网页控制台),后起的窗口自动接入、各自开会话,全部汇总在同一个控制台;主进程所在窗口关闭后,其余窗口在几秒内自动接管。以前第二个窗口会因为端口被占用直接报错退出。
  • OAuth 2.1 授权服务器(默认关闭):ChatGPT、Claude 等连接器可走授权码加 PKCE,令牌复用 ExecMesh 的全部闸门。
  • 预览视图(新会话视图):统一消息卡、右侧轨、整段历史搜索、未读与「以下为新消息」、会话级状态、群聊卡片与成员头像;加载更快:离屏卡片跳过渲染、先取索引再按需取正文、渐进渲染、次要请求让路。
  • 部署与文档:README 与部署示范重做(.env 驱动的 Compose 模板、AI 部署指南、验证 / 升级 / 备份 / 回滚 / 排错);补齐「进阶、调试与 Agent 变量」参考表,代码里读得到的环境变量在文档里都查得到。

变更

  • 默认会话视图改为预览视图:升级后没选过视图的设备默认进入预览视图;点一次「回到经典视图」就会被记住(每台设备各自一份)。单会话的「聊天视图(预览)」入口已删除;群聊窗口只有统一消息卡这一种画法(不再随预览开关切换),群聊里没有引用回复。
  • 异步对话开启后,授权档位取代阶段滑块;同步模式的回执逐字不变。
  • 会话阶段收敛为「讨论 / 方案 / 开发」三段;旧的阶段编号在所有入口自动映射,存量数据在启动时迁移(评估 / 方案 / 开发三条里你改过的文案原样保留,「验证」「完成」并入「开发」,这两条的自定义文案不保留)。
  • MCP 令牌:改为一机一令牌(/mcp?token= 的写法长期兼容);令牌只能访问 /mcp,不能再调用 REST / SSE 管理接口(返回 403 mcp_token_forbidden);凭据库里已有凭据时,/mcp 不再接受无法识别的令牌(以前带错误令牌会落入「开放访问」而照常通过);新建令牌默认不含终端权限;查看令牌明文需要再次验证 Web 口令。
  • 默认值:Docker Compose 模板默认监听所有网卡(README 已加强警告);远程终端总开关默认 auto(已设置 Web 密码且 JWT 密钥足够强才启用);模型执行与远程文件默认关闭。
  • 内嵌前端现在带缓存头:带哈希的 /assets/* 缓存一年(immutable),index.html 等为 no-cache 加 ETag。
  • stdio 直驱模式的侧栏默认收起:只有一个工作流时网页侧栏默认收起(编辑器侧边栏里只有这一个会话,不占地方),出现第二个工作流时自动展开;你手动展开 / 收起过就一直按你的选择。常驻服务(Docker / relaymesh serve)的行为不变,手机端不变。/api/v1/auth/status 新增只读字段 run_mode(stdio / serve)。
  • stdio 直驱遇到端口被占用时不再一律退出:占着端口的是另一个 RelayMesh stdio 进程时自动接入;是常驻服务(Docker / relaymesh serve)或别的程序时仍然退出,报错里写明占用者类型和怎么办(改用常驻服务的 http://127.0.0.1:<端口>/mcp,或用 RELAYMESH_PORT 换端口)。接入凭证 stdio-hub.json(权限 0600)放在数据目录,主进程每次启动重新生成、正常退出时删除。
  • 确认卡常驻「其他(自定义)」:预设选项都不对时可以自己写答复。
  • 侧栏左上角在远程终端可用时出现 RelayMesh | ExecMesh 切换器;设置按模块分类。
  • Cursor hook 的一键安装在没有 agent-dist 的部署里也能用:单二进制、go run、stdio 直驱的 Hub 自己拿不出 relaymesh-hook 时,install.sh / install.ps1 会自动改从 GitHub Release 下载(Hub 是正式版本时取同一个版本,开发版取最新;一律校验 SHA256,校验失败不换源重试);RELAYMESH_VERSION、RELAYMESH_REPO、RELAYMESH_DOWNLOAD_BASE 可调。docs/inbox.md 补了 stdio 下装 hook 的步骤。

移除

  • 「在线 / 暂离 / 托管」我的状态(数据库列保留,REST、MCP 回执分支与提示词设置已删)。
  • 旧的聊天视图窗口及其组件。
  • 两个从未生效的环境变量 RELAYMESH_ALLOW_NON_LOOPBACK、RELAYMESH_WAIT_COUNTDOWN_MINUTES:设置后一直没有任何效果,现在同样被忽略,不会报错。

安全

  • 去掉 Google Fonts 外链,网页内容安全策略(CSP)默认强制执行(RELAYMESH_CSP)。
  • MCP 请求体有了 8 MiB 上限(超出返回 413);环境变量令牌改为恒定时间比较。
  • stdio 主进程为多窗口新增了仅限本机的转发入口 /mcp-local:只在 stdio 主进程上存在(常驻服务、Docker、生产一律 404),要求 TCP 对端是回环地址并带数据目录里权限 0600 的随机钥匙(恒定时间比较,错误尝试限速),请求体上限 16 MiB,钥匙不写进任何日志与输出。
  • Agent 发布签名与验签(见「新增」);SSH 登录凭据只在网关、终端内容只在主机本机。
  • 依赖安全升级:Go 侧 golang.org/x/net(0.61.0)、golang.org/x/crypto(0.58.0,含 SSH 客户端的多项拒绝服务与认证相关修复)、golang.org/x/text(0.43.0)、quic-go(0.59.1),前端 axios(1.20.0)、vue(3.5.44)等。升级后 govulncheck 对源码与发布用的二进制都是 0 条可达漏洞,前端生产依赖 pnpm audit 为 0 条。
  • 构建基线提到 Go 1.26(go.mod 的 go 1.26.0、toolchain go1.26.9):上游已不再给 Go 1.25 回补标准库 HTTP/2 服务端的漏洞修复(GO-2026-6617 等,修复版本是 1.26.9 / 1.27.2),官方镜像与预编译二进制必须用 1.26.9 及以上构建;Dockerfile 与发布流水线已同步。

升级须知

  • 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增表与列,没有删除;回退到 1.6.x 的步骤与注意事项见 远程终端运维说明。
  • 从源码构建需要 Go 1.26 或更高(原来是 1.25);Docker 镜像与预编译二进制不受影响。
  • Go 模块路径从 2.0 起带 /v2(Go 对 2.x 版本的硬性要求):用 go run / go install 运行 RelayMesh 的,以及在 Cursor / Claude 等 MCP 配置的 args 里写了 go run github.com/teacat99/RelayMesh/cmd/relaymesh@latest 的,请改成 go run github.com/teacat99/RelayMesh/v2/cmd/relaymesh@latest;旧写法不会报错,但只会停在 1.x 的最后一版(1.6.3)。自己构建 Agent 并用 -ldflags -X 指定信任名单的,包路径同样要写成 github.com/teacat99/RelayMesh/v2/internal/relsign/trust.override。Docker 镜像、预编译二进制、install.sh 与 hook 安装器不受影响。
  • 已装在主机上的 Agent 不会被自动升级(自动升级默认关闭)。2.0 起可以在 Web 里一键升级,Agent 与会话守护进程请逐台按提示操作。
  • 新增了一批环境变量,默认值都是保守的(关闭、留空或最小权限),完整清单见 README 的「核心环境变量清单」一节。
  • 完整的行为变化清单(令牌、阶段、界面等)见 远程终端运维说明 第 3 节。

Full Changelog: v1.6.3...v2.0.0-rc.3

v2.0.0-rc.2

v2.0.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 20 Oct 16:43

预发布版本(预览):功能与行为可能在正式版之前调整,不建议用于生产。Docker 镜像标签为 2.0.0-rc.2;latest 镜像与 install.sh 默认下载的「最新正式版」不受影响。

即将发布的 2.0.0。这是一次大版本:RelayMesh 从「人与 AI 的交互中继」扩展成带远程终端、模型执行、异步协作与项目任务的协同平台,同时有若干需要留意的行为变化(见「变更」与「升级须知」)。

新增

  • 远程 Web 终端(ExecMesh):在浏览器里打开已装 Agent 的主机上的终端。Agent 可作为系统服务常驻运行(Linux / macOS / Windows),并提供 install.sh / install.ps1 一键安装;会话守护进程让 Agent 升级、重启或崩溃时终端会话不被杀掉;终端内容只保存在主机本机,服务端永远不存终端内容;还有 Web 一键升级 Agent、长上下文终端按需加载、历史日志与右键菜单。
  • 让模型在授权主机上执行命令(ExecMesh 档,默认关闭):terminal_targets / terminal_exec / terminal_run 三个 MCP 工具,以及文件能力 terminal_files(默认关闭,只能访问你指定的目录)。MCP 令牌改为一机一令牌加档位(RelayMesh / ExecMesh / 自定义),配合「模型 × 主机」授权与审计记录。
  • SSH 网关:经一台已装 Agent 的主机,接入没有 Agent 的 SSH 主机(人和模型都能用);登录凭据只保存在网关自己的存储里。
  • Agent 自动升级与发布签名:「提示」与「静默」两档(默认全关,同意发生在主机本机,服务端另有总闸);静默升级前会用编进 Agent 的 ed25519 发布公钥验签,验不过就不安装。GitHub Release 里的 Agent 程序会在正式发布后补签,对应的 .sig 作为 Release 资产提供,自己托管 Agent 分发目录的人可以直接用;用法与限制见 远程终端运维说明。
  • 异步协作:异步对话模式(「发了就走」,授权档位取代阶段滑块)、确认项(async_ask)、追加指令收件箱、Agent 身份与状态、聊天与群聊(chat 工具)、ntfy 推送、统一通知闸;HTML Artifact、数据 KV、评论、反链与项目 ZIP。
  • 项目、文档与任务:项目结构与项目文档库(project_docs)、任务清单与共享任务板(task_board:指派、接取、交付、验收、退回,任务级权限)、正文引用链接统一(#N、Q<N>、[[文档]]、sess-…)、内置使用手册(usage_guide)、项目管理 Agent 经 MCP 运行预设(preset_run,默认全关)。
  • 非交互续聊与会话守护:会话停摆检测与一键唤醒、终端预设与运行入口、自动续跑、网页「启用 Agent」、单次运行超时可配(上限 7 天)。
  • 新建会话「高级选项」:工作流编号、首条指令、初始阶段、项目目录与主机;默认收起,不填时与以前完全一样。
  • stdio 直驱支持多个编辑器窗口:同一个用户开多个 Cursor / Claude 窗口、各自配置 mcp stdio 时,第一个进程成为主进程(数据库、端口、网页控制台),后起的窗口自动接入、各自开会话,全部汇总在同一个控制台;主进程所在窗口关闭后,其余窗口在几秒内自动接管。以前第二个窗口会因为端口被占用直接报错退出。
  • OAuth 2.1 授权服务器(默认关闭):ChatGPT、Claude 等连接器可走授权码加 PKCE,令牌复用 ExecMesh 的全部闸门。
  • 预览视图(新会话视图):统一消息卡、右侧轨、整段历史搜索、未读与「以下为新消息」、会话级状态、群聊卡片与成员头像;加载更快:离屏卡片跳过渲染、先取索引再按需取正文、渐进渲染、次要请求让路。
  • 部署与文档:README 与部署示范重做(.env 驱动的 Compose 模板、AI 部署指南、验证 / 升级 / 备份 / 回滚 / 排错);补齐「进阶、调试与 Agent 变量」参考表,代码里读得到的环境变量在文档里都查得到。

变更

  • 默认会话视图改为预览视图:升级后没选过视图的设备默认进入预览视图;点一次「回到经典视图」就会被记住(每台设备各自一份)。单会话的「聊天视图(预览)」入口已删除;群聊窗口只有统一消息卡这一种画法(不再随预览开关切换),群聊里没有引用回复。
  • 异步对话开启后,授权档位取代阶段滑块;同步模式的回执逐字不变。
  • 会话阶段收敛为「讨论 / 方案 / 开发」三段;旧的阶段编号在所有入口自动映射,存量数据在启动时迁移(评估 / 方案 / 开发三条里你改过的文案原样保留,「验证」「完成」并入「开发」,这两条的自定义文案不保留)。
  • MCP 令牌:改为一机一令牌(/mcp?token= 的写法长期兼容);令牌只能访问 /mcp,不能再调用 REST / SSE 管理接口(返回 403 mcp_token_forbidden);凭据库里已有凭据时,/mcp 不再接受无法识别的令牌(以前带错误令牌会落入「开放访问」而照常通过);新建令牌默认不含终端权限;查看令牌明文需要再次验证 Web 口令。
  • 默认值:Docker Compose 模板默认监听所有网卡(README 已加强警告);远程终端总开关默认 auto(已设置 Web 密码且 JWT 密钥足够强才启用);模型执行与远程文件默认关闭。
  • 内嵌前端现在带缓存头:带哈希的 /assets/* 缓存一年(immutable),index.html 等为 no-cache 加 ETag。
  • stdio 直驱模式的侧栏默认收起:只有一个工作流时网页侧栏默认收起(编辑器侧边栏里只有这一个会话,不占地方),出现第二个工作流时自动展开;你手动展开 / 收起过就一直按你的选择。常驻服务(Docker / relaymesh serve)的行为不变,手机端不变。/api/v1/auth/status 新增只读字段 run_mode(stdio / serve)。
  • stdio 直驱遇到端口被占用时不再一律退出:占着端口的是另一个 RelayMesh stdio 进程时自动接入;是常驻服务(Docker / relaymesh serve)或别的程序时仍然退出,报错里写明占用者类型和怎么办(改用常驻服务的 http://127.0.0.1:<端口>/mcp,或用 RELAYMESH_PORT 换端口)。接入凭证 stdio-hub.json(权限 0600)放在数据目录,主进程每次启动重新生成、正常退出时删除。
  • 确认卡常驻「其他(自定义)」:预设选项都不对时可以自己写答复。
  • 侧栏左上角在远程终端可用时出现 RelayMesh | ExecMesh 切换器;设置按模块分类。
  • Cursor hook 的一键安装在没有 agent-dist 的部署里也能用:单二进制、go run、stdio 直驱的 Hub 自己拿不出 relaymesh-hook 时,install.sh / install.ps1 会自动改从 GitHub Release 下载(Hub 是正式版本时取同一个版本,开发版取最新;一律校验 SHA256,校验失败不换源重试);RELAYMESH_VERSION、RELAYMESH_REPO、RELAYMESH_DOWNLOAD_BASE 可调。docs/inbox.md 补了 stdio 下装 hook 的步骤。

移除

  • 「在线 / 暂离 / 托管」我的状态(数据库列保留,REST、MCP 回执分支与提示词设置已删)。
  • 旧的聊天视图窗口及其组件。
  • 两个从未生效的环境变量 RELAYMESH_ALLOW_NON_LOOPBACK、RELAYMESH_WAIT_COUNTDOWN_MINUTES:设置后一直没有任何效果,现在同样被忽略,不会报错。

安全

  • 去掉 Google Fonts 外链,网页内容安全策略(CSP)默认强制执行(RELAYMESH_CSP)。
  • MCP 请求体有了 8 MiB 上限(超出返回 413);环境变量令牌改为恒定时间比较。
  • stdio 主进程为多窗口新增了仅限本机的转发入口 /mcp-local:只在 stdio 主进程上存在(常驻服务、Docker、生产一律 404),要求 TCP 对端是回环地址并带数据目录里权限 0600 的随机钥匙(恒定时间比较,错误尝试限速),请求体上限 16 MiB,钥匙不写进任何日志与输出。
  • Agent 发布签名与验签(见「新增」);SSH 登录凭据只在网关、终端内容只在主机本机。
  • 依赖安全升级:Go 侧 golang.org/x/net(0.61.0)、golang.org/x/crypto(0.58.0,含 SSH 客户端的多项拒绝服务与认证相关修复)、golang.org/x/text(0.43.0)、quic-go(0.59.1),前端 axios(1.20.0)、vue(3.5.44)等。升级后 govulncheck 对源码与发布用的二进制都是 0 条可达漏洞,前端生产依赖 pnpm audit 为 0 条。
  • 构建基线提到 Go 1.26(go.mod 的 go 1.26.0、toolchain go1.26.9):上游已不再给 Go 1.25 回补标准库 HTTP/2 服务端的漏洞修复(GO-2026-6617 等,修复版本是 1.26.9 / 1.27.2),官方镜像与预编译二进制必须用 1.26.9 及以上构建;Dockerfile 与发布流水线已同步。

升级须知

  • 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增表与列,没有删除;回退到 1.6.x 的步骤与注意事项见 远程终端运维说明。
  • 从源码构建需要 Go 1.26 或更高(原来是 1.25);Docker 镜像与预编译二进制不受影响。
  • Go 模块路径从 2.0 起带 /v2(Go 对 2.x 版本的硬性要求):用 go run / go install 运行 RelayMesh 的,以及在 Cursor / Claude 等 MCP 配置的 args 里写了 go run github.com/teacat99/RelayMesh/cmd/relaymesh@latest 的,请改成 go run github.com/teacat99/RelayMesh/v2/cmd/relaymesh@latest;旧写法不会报错,但只会停在 1.x 的最后一版(1.6.3)。自己构建 Agent 并用 -ldflags -X 指定信任名单的,包路径同样要写成 github.com/teacat99/RelayMesh/v2/internal/relsign/trust.override。Docker 镜像、预编译二进制、install.sh 与 hook 安装器不受影响。
  • 已装在主机上的 Agent 不会被自动升级(自动升级默认关闭)。2.0 起可以在 Web 里一键升级,Agent 与会话守护进程请逐台按提示操作。
  • 新增了一批环境变量,默认值都是保守的(关闭、留空或最小权限),完整清单见 README 的「核心环境变量清单」一节。
  • 完整的行为变化清单(令牌、阶段、界面等)见 远程终端运维说明 第 3 节。

Full Changelog: v1.6.3...v2.0.0-rc.2

v2.0.0-rc.1

v2.0.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 20 Oct 15:11

预发布版本(预览):功能与行为可能在正式版之前调整,不建议用于生产。Docker 镜像标签为 2.0.0-rc.1;latest 镜像与 install.sh 默认下载的「最新正式版」不受影响。

即将发布的 2.0.0。这是一次大版本:RelayMesh 从「人与 AI 的交互中继」扩展成带远程终端、模型执行、异步协作与项目任务的协同平台,同时有若干需要留意的行为变化(见「变更」与「升级须知」)。

新增

  • 远程 Web 终端(ExecMesh):在浏览器里打开已装 Agent 的主机上的终端。Agent 可作为系统服务常驻运行(Linux / macOS / Windows),并提供 install.sh / install.ps1 一键安装;会话守护进程让 Agent 升级、重启或崩溃时终端会话不被杀掉;终端内容只保存在主机本机,服务端永远不存终端内容;还有 Web 一键升级 Agent、长上下文终端按需加载、历史日志与右键菜单。
  • 让模型在授权主机上执行命令(ExecMesh 档,默认关闭):terminal_targets / terminal_exec / terminal_run 三个 MCP 工具,以及文件能力 terminal_files(默认关闭,只能访问你指定的目录)。MCP 令牌改为一机一令牌加档位(RelayMesh / ExecMesh / 自定义),配合「模型 × 主机」授权与审计记录。
  • SSH 网关:经一台已装 Agent 的主机,接入没有 Agent 的 SSH 主机(人和模型都能用);登录凭据只保存在网关自己的存储里。
  • Agent 自动升级与发布签名:「提示」与「静默」两档(默认全关,同意发生在主机本机,服务端另有总闸);静默升级前会用编进 Agent 的 ed25519 发布公钥验签,验不过就不安装。GitHub Release 里的 Agent 程序会在正式发布后补签,对应的 .sig 作为 Release 资产提供,自己托管 Agent 分发目录的人可以直接用;用法与限制见 远程终端运维说明。
  • 异步协作:异步对话模式(「发了就走」,授权档位取代阶段滑块)、确认项(async_ask)、追加指令收件箱、Agent 身份与状态、聊天与群聊(chat 工具)、ntfy 推送、统一通知闸;HTML Artifact、数据 KV、评论、反链与项目 ZIP。
  • 项目、文档与任务:项目结构与项目文档库(project_docs)、任务清单与共享任务板(task_board:指派、接取、交付、验收、退回,任务级权限)、正文引用链接统一(#N、Q<N>、[[文档]]、sess-…)、内置使用手册(usage_guide)、项目管理 Agent 经 MCP 运行预设(preset_run,默认全关)。
  • 非交互续聊与会话守护:会话停摆检测与一键唤醒、终端预设与运行入口、自动续跑、网页「启用 Agent」、单次运行超时可配(上限 7 天)。
  • 新建会话「高级选项」:工作流编号、首条指令、初始阶段、项目目录与主机;默认收起,不填时与以前完全一样。
  • stdio 直驱支持多个编辑器窗口:同一个用户开多个 Cursor / Claude 窗口、各自配置 mcp stdio 时,第一个进程成为主进程(数据库、端口、网页控制台),后起的窗口自动接入、各自开会话,全部汇总在同一个控制台;主进程所在窗口关闭后,其余窗口在几秒内自动接管。以前第二个窗口会因为端口被占用直接报错退出。
  • OAuth 2.1 授权服务器(默认关闭):ChatGPT、Claude 等连接器可走授权码加 PKCE,令牌复用 ExecMesh 的全部闸门。
  • 预览视图(新会话视图):统一消息卡、右侧轨、整段历史搜索、未读与「以下为新消息」、会话级状态、群聊卡片与成员头像;加载更快:离屏卡片跳过渲染、先取索引再按需取正文、渐进渲染、次要请求让路。
  • 部署与文档:README 与部署示范重做(.env 驱动的 Compose 模板、AI 部署指南、验证 / 升级 / 备份 / 回滚 / 排错);补齐「进阶、调试与 Agent 变量」参考表,代码里读得到的环境变量在文档里都查得到。

变更

  • 默认会话视图改为预览视图:升级后没选过视图的设备默认进入预览视图;点一次「回到经典视图」就会被记住(每台设备各自一份)。单会话的「聊天视图(预览)」入口已删除;群聊窗口只有统一消息卡这一种画法(不再随预览开关切换),群聊里没有引用回复。
  • 异步对话开启后,授权档位取代阶段滑块;同步模式的回执逐字不变。
  • 会话阶段收敛为「讨论 / 方案 / 开发」三段;旧的阶段编号在所有入口自动映射,存量数据在启动时迁移(评估 / 方案 / 开发三条里你改过的文案原样保留,「验证」「完成」并入「开发」,这两条的自定义文案不保留)。
  • MCP 令牌:改为一机一令牌(/mcp?token= 的写法长期兼容);令牌只能访问 /mcp,不能再调用 REST / SSE 管理接口(返回 403 mcp_token_forbidden);凭据库里已有凭据时,/mcp 不再接受无法识别的令牌(以前带错误令牌会落入「开放访问」而照常通过);新建令牌默认不含终端权限;查看令牌明文需要再次验证 Web 口令。
  • 默认值:Docker Compose 模板默认监听所有网卡(README 已加强警告);远程终端总开关默认 auto(已设置 Web 密码且 JWT 密钥足够强才启用);模型执行与远程文件默认关闭。
  • 内嵌前端现在带缓存头:带哈希的 /assets/* 缓存一年(immutable),index.html 等为 no-cache 加 ETag。
  • stdio 直驱模式的侧栏默认收起:只有一个工作流时网页侧栏默认收起(编辑器侧边栏里只有这一个会话,不占地方),出现第二个工作流时自动展开;你手动展开 / 收起过就一直按你的选择。常驻服务(Docker / relaymesh serve)的行为不变,手机端不变。/api/v1/auth/status 新增只读字段 run_mode(stdio / serve)。
  • stdio 直驱遇到端口被占用时不再一律退出:占着端口的是另一个 RelayMesh stdio 进程时自动接入;是常驻服务(Docker / relaymesh serve)或别的程序时仍然退出,报错里写明占用者类型和怎么办(改用常驻服务的 http://127.0.0.1:<端口>/mcp,或用 RELAYMESH_PORT 换端口)。接入凭证 stdio-hub.json(权限 0600)放在数据目录,主进程每次启动重新生成、正常退出时删除。
  • 确认卡常驻「其他(自定义)」:预设选项都不对时可以自己写答复。
  • 侧栏左上角在远程终端可用时出现 RelayMesh | ExecMesh 切换器;设置按模块分类。
  • Cursor hook 的一键安装在没有 agent-dist 的部署里也能用:单二进制、go run、stdio 直驱的 Hub 自己拿不出 relaymesh-hook 时,install.sh / install.ps1 会自动改从 GitHub Release 下载(Hub 是正式版本时取同一个版本,开发版取最新;一律校验 SHA256,校验失败不换源重试);RELAYMESH_VERSION、RELAYMESH_REPO、RELAYMESH_DOWNLOAD_BASE 可调。docs/inbox.md 补了 stdio 下装 hook 的步骤。

移除

  • 「在线 / 暂离 / 托管」我的状态(数据库列保留,REST、MCP 回执分支与提示词设置已删)。
  • 旧的聊天视图窗口及其组件。
  • 两个从未生效的环境变量 RELAYMESH_ALLOW_NON_LOOPBACK、RELAYMESH_WAIT_COUNTDOWN_MINUTES:设置后一直没有任何效果,现在同样被忽略,不会报错。

安全

  • 去掉 Google Fonts 外链,网页内容安全策略(CSP)默认强制执行(RELAYMESH_CSP)。
  • MCP 请求体有了 8 MiB 上限(超出返回 413);环境变量令牌改为恒定时间比较。
  • stdio 主进程为多窗口新增了仅限本机的转发入口 /mcp-local:只在 stdio 主进程上存在(常驻服务、Docker、生产一律 404),要求 TCP 对端是回环地址并带数据目录里权限 0600 的随机钥匙(恒定时间比较,错误尝试限速),请求体上限 16 MiB,钥匙不写进任何日志与输出。
  • Agent 发布签名与验签(见「新增」);SSH 登录凭据只在网关、终端内容只在主机本机。
  • 依赖安全升级:Go 侧 golang.org/x/net(0.61.0)、golang.org/x/crypto(0.58.0,含 SSH 客户端的多项拒绝服务与认证相关修复)、golang.org/x/text(0.43.0)、quic-go(0.59.1),前端 axios(1.20.0)、vue(3.5.44)等。升级后 govulncheck 对源码与发布用的二进制都是 0 条可达漏洞,前端生产依赖 pnpm audit 为 0 条。
  • 构建基线提到 Go 1.26(go.mod 的 go 1.26.0、toolchain go1.26.9):上游已不再给 Go 1.25 回补标准库 HTTP/2 服务端的漏洞修复(GO-2026-6617 等,修复版本是 1.26.9 / 1.27.2),官方镜像与预编译二进制必须用 1.26.9 及以上构建;Dockerfile 与发布流水线已同步。

升级须知

  • 升级前备份数据目录(Docker 用户备份数据卷)。数据库在启动时自动迁移,只新增表与列,没有删除;回退到 1.6.x 的步骤与注意事项见 远程终端运维说明。
  • 从源码构建需要 Go 1.26 或更高(原来是 1.25);Docker 镜像与预编译二进制不受影响。
  • Go 模块路径从 2.0 起带 /v2(Go 对 2.x 版本的硬性要求):用 go run / go install 运行 RelayMesh 的,以及在 Cursor / Claude 等 MCP 配置的 args 里写了 go run github.com/teacat99/RelayMesh/cmd/relaymesh@latest 的,请改成 go run github.com/teacat99/RelayMesh/v2/cmd/relaymesh@latest;旧写法不会报错,但只会停在 1.x 的最后一版(1.6.3)。自己构建 Agent 并用 -ldflags -X 指定信任名单的,包路径同样要写成 github.com/teacat99/RelayMesh/v2/internal/relsign/trust.override。Docker 镜像、预编译二进制、install.sh 与 hook 安装器不受影响。
  • 已装在主机上的 Agent 不会被自动升级(自动升级默认关闭)。2.0 起可以在 Web 里一键升级,Agent 与会话守护进程请逐台按提示操作。
  • 新增了一批环境变量,默认值都是保守的(关闭、留空或最小权限),完整清单见 README 的「核心环境变量清单」一节。
  • 完整的行为变化清单(令牌、阶段、界面等)见 远程终端运维说明 第 3 节。

Full Changelog: v1.6.3...v2.0.0-rc.1

v1.6.3

Choose a tag to compare

@github-actions github-actions released this 30 Sep 18:33

Full Changelog: v1.6.2...v1.6.3

v1.6.2

Choose a tag to compare

@github-actions github-actions released this 16 Sep 06:48

Full Changelog: v1.6.1...v1.6.2

v1.6.1

Choose a tag to compare

@github-actions github-actions released this 16 Sep 06:25

Full Changelog: v1.6.0...v1.6.1

v1.6.0

Choose a tag to compare

@github-actions github-actions released this 16 Sep 02:47

Full Changelog: v1.5.0...v1.6.0