Skip to main content
WebMuxInstall WebMux

WebMux v0.6.0 release notes

View and download on GitHub Releases (external link)Download the latest release

更新内容

v0.6.0 增加终端图片、程序主动状态报告、按需文件树、Markdown 预览和启动配置级预览，并改进首次启动与移动端交互。

终端图片与 agent 状态

  • 支持 Kitty 图形协议的直接传输：PNG、RGB、RGBA、分块传输、裁剪、放置与删除；图片跟随终端滚动，普通屏幕与备用屏幕隔离，并限制解码和画布资源。修复 omp 重绘、局部文字擦除和历史回放导致图片丢失的问题（#130、#140）。
  • 新安装预置的 omp 启动配置包含 PI_FORCE_IMAGE_PROTOCOL=kitty。已有启动配置不会被覆盖，需要时可自行添加这个环境变量。
  • 支持 OSC 7501 程序状态报告和服务端探测应答，无浏览器附着时也能应答。按程序状态、Warp 事件、普通通知和响铃的来源优先级合并提醒，减少结构化 agent 的误报；新增默认开启的 program_status 配置（#143）。
  • 改进截断历史的安全回放与重绘，修复 Android 收起键盘后触摸终端意外重新弹出键盘的问题。

代码工作区与会话总览

  • 文件导航改为类似 VS Code 的按需文件树，支持展开、折叠、分页加载和当前文件定位（#126）。
  • 代码语法高亮按需加载；新增经过清洗的 Markdown 预览，预览中的外部图片与资源不自动加载。
  • 启动配置支持独立的预览行数和跳过末尾行数，未设置时沿用浏览器的全局预览（#139）。
  • 启动配置支持本地打包的 agent 图标；旧配置可以自动匹配图标（#137）。
  • 普通浏览器点击会话行时在新标签页打开终端，首页继续接收更新；主屏幕应用继续使用应用内导航（#136）。
  • 终端字体下限降为 8px（#135）。

首次启动与工程支持

  • 默认配置文件缺失时，首次启动自动创建私有配置并保存随机 Token；已有配置不自动改写（#131）。
  • 新安装首次创建启动配置时，提供 Shell、Claude Code、Codex CLI、Gemini CLI、Open Code 和 omp 的可编辑配置。
  • 新增文档与规格的行数、体积和目录结构检查，协议与用户故事文档按主题拆分（#142）。

升级须知

  • 替换服务端二进制并重启后生效；服务重启会结束当前 PTY 会话，请先处理正在运行的任务。
  • launch-configs.json 的当前写入格式为版本 2，兼容读取版本 1；已有启动配置和用户删除后的空配置均不会被重新预置。
  • OSC 7501 状态默认启用，可用 program_status = false 关闭。agent 在阻塞状态被强制结束、且 shell 未发送 OSC 133;A 时，状态可能持续显示等待，详见使用指南。
  • Kitty 图形暂不支持文件/共享内存传输、动画、Unicode 占位符和相对父放置。

验证

  • 发布提交：7b7a37569372a8ecb5a9f5a4dc7549730bb06cde，tag v0.6.0。
  • 主分支 Test 工作流：全部检查和最终汇总通过；首轮有两项 Chromium 安装超时，重跑未完成项后通过。
  • 本地预发布构建：8 个 Linux、macOS、Windows 产物的架构、SHA256 和托盘内嵌服务端摘要检查通过，Linux 二进制报告 webmux 0.6.0，示例配置校验通过。
  • 使用发布二进制启动隔离实例：认证、Origin 拒绝、内嵌页面与脚本、WebSocket、PTY 输入输出、断线重连、历史回放、退出与清理冒烟通过；终端与提醒的桌面/Pixel 7 Chromium E2E 为 25 项通过、3 项按平台条件跳过。
  • Release 工作流：构建与发布全部通过，包括前端构建、Go race、全部 8 个产物、SHA256 校验和版本检查。
  • 已重新下载线上全部 8 个文件并通过 SHA256SUMS；线上 Linux 二进制的版本、源码修订号与 CGO_ENABLED=0 正确，认证、WebSocket、PTY 和重连冒烟再次通过。
  • 未进行 Windows 实机托盘交互或 iOS/Android 真机验收；手机测试使用 Chromium 设备模拟。

下载

文件 用途
webmux-linux-{amd64,arm64} Linux 服务端，也用于 WSL 2
webmux-darwin-{amd64,arm64} macOS 服务端
webmux-windows-{amd64,arm64}.exe Windows 控制台客户端
webmux-tray-windows-{amd64,arm64}.exe Windows 托盘，管理 WSL 中的服务
SHA256SUMS 全部 8 个文件的 SHA256 校验值

完整变更：https://github.com/mzdluo123/webmux/compare/v0.5.0...v0.6.0

Back to the changelog