Repository navigation
v2.0.0-rc.3
Pre-release
Pre-release
·
4 commits
to main
since this release
预发布版本(预览):功能与行为可能在正式版之前调整,不建议用于生产。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