WebMux 更新日志

WebMux v0.10.2

2026-11-03T05:56:42Z

What's Changed

feat(tray): 增加按用户安装的 Windows 安装程序与托盘 quit 子命令 by @RuabbitX in https://github.com/mzdluo123/webmux/pull/245
feat(web): migrate the file reader to @pierre/diffs by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/253
feat(hybrid): 支持 Claude Code 混合会话 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/251
fix(hybrid): 聊天端使用 ACP 会话标题 by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/250
ci: 拆分 Go 缓存并按变更裁剪测试 job by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/254
feat(launch): 支持选择 Bash / Zsh 启动文件 by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/248
feat(chat): 显示回合实时与最终耗时 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/258
feat(release): 提供 Linux deb/rpm 安装包与包内 systemd 用户服务 by @RuabbitX in https://github.com/mzdluo123/webmux/pull/256
chore(openspec): 归档 add-windows-installer 与 add-linux-packages by @RuabbitX in https://github.com/mzdluo123/webmux/pull/259
fix(hybrid): 持久化并展示可恢复会话标题 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/257
Fix superseded snapshot replay ending the current replay window early by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/261
docs: 文档守卫不再豁免表格行，并将超宽表格改为列表 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/262
test(web): 嵌入资源测试适配预压缩的 .br/.gz 布局 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/263
docs: 文档导航治理、README 首页重写与可达性/链接校验 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/264

New Contributors

@RuabbitX made their first contribution in https://github.com/mzdluo123/webmux/pull/245

Full Changelog: https://github.com/mzdluo123/webmux/compare/v0.10.1...v0.10.2

WebMux v0.10.1

2026-11-02T04:55:35Z

What's Changed

fix(web): 统一会话创建入口与默认行为 by @myot233 in https://github.com/mzdluo123/webmux/pull/244

Full Changelog: https://github.com/mzdluo123/webmux/compare/v0.10.0...v0.10.1

WebMux v0.10.0

2026-11-01T16:49:16Z

更新内容

v0.10.0 新增 Codex CLI 混合模式、资源管理器文件操作与九款 CLI 启动配置；独立代码窗口改为独立实例；终端重绘风暴与会话恢复闪屏得到修复。

新功能

混合模式支持 Codex CLI，并检查第三方 ACP 连接器是否已安装（#217）。
代码资源管理器右键菜单支持上传、下载、ZIP、重命名、复制、移动与删除；复制与 ZIP 限 100 MiB / 10000 项，递归删除遇 .git 或嵌套仓库会拒绝（#224）。
启动配置补齐九款 CLI 及其品牌图标，图标在本地打包（#219）。
独立代码窗口改为在 iframe 中运行独立实例，弹出和收回时保留完整阅读状态（#237）。
统一 WebMux Logo 与应用图标（#218）。
聊天视图提供快捷指令入口，指令插入消息输入框。

终端

调整尺寸引起的重绘风暴改为按帧合并输出，并消除整屏重新测量（#240）。
同步输出与回放期间，终端文字与 Kitty 图片在同一帧切换，会话恢复时不再闪屏（#239，#241）。
重连期间重新显示“正在恢复…”提示（#232）。
锁定终端尺寸后保持网格并显示滚动条（#221）。
输出队列按积压字节限制，PTY reader 发布输出后让出调度，持续或突发的小块输出不再误断开慢客户端。

修复

慢速 Git 发现不再误报超时，并保留上次快照（#233）。
长按结束的点击不再误选弹出面板中的操作（#225）。
首页默认恢复输出预览（#216）。
独立代码窗口中 diff 行号范围选择失效（#215）。
托盘“远程访问”子菜单不再出现重复的远程 URL。

内部

agent 的 ACP / 终端差异收拢到适配器接口（#230）；前端路由匹配与懒加载组件抽出（#242）；隧道设置去重（#235）。
CI 提速，并消除偶发失败的测试（#231，#243）。

升级须知

替换二进制后需重启服务；重启会结束当前所有终端会话，混合会话可从首页“可恢复”分组恢复。
新安装不再预置 Gemini CLI 启动配置（上游已停止服务个人账号）。已有 launch-configs.json 不会被改写。

完整变更：v0.9.1...v0.10.0。

验证

发布提交：f1d2579，tag v0.10.0。
Release 工作流：Go race 与跨平台构建通过。
下载全部 9 项载荷后与 SHA256SUMS 逐项比对通过；Linux amd64 二进制运行输出 webmux 0.10.0；install.sh 语法检查通过。

WebMux v0.9.1

2026-10-31T04:34:25Z

更新内容

v0.9.1 修复终端逐字回显和 AI / 日志流式输出一顿一顿的问题（#214）。

取消服务端输出合并时固定的 50 ms 等待，有输出即可发送，只合并当前已排队的字节。
保留 64 KiB 合并上限、控制消息顺序、慢客户端保护和退出前排空。
新增真实 PTY / WebSocket 逐字回显延迟回归，以及 14 万字节连续输出的完整性与退出顺序回归。

高频小块输出会增加 WebSocket / TLS 帧数与封装开销，实际流量增幅取决于每块大小和输出频率；终端内容字节数不变。

升级须知

替换二进制后需重启服务；重启会结束当前所有终端会话，混合会话可从首页“可恢复”分组恢复。

验证

发布提交：664c1586e625a41d8956886bccdd1710894fd08e，tag v0.9.1。
主分支 Test 工作流：全部检查通过，覆盖 Linux / macOS Go race、桌面 / 手机 E2E、Vitest、Storybook、性能、格式与构建检查。
Release 工作流：Go race、跨平台构建、SHA256SUMS 与 Linux 版本号校验通过，8 个二进制、安装脚本及校验清单均已上传。
发布后复核：9 项载荷的 GitHub 上传摘要与 SHA256SUMS 一致；另从 GitHub 下载 macOS arm64 二进制、安装脚本及清单，独立校验 SHA-256。macOS arm64 二进制运行返回 webmux 0.9.1，安装脚本语法检查通过。

完整变更：v0.9.0...v0.9.1。

WebMux v0.9.0

2026-10-30T17:07:46Z

更新内容

v0.9.0 新增会话交互物临时文件夹（上传与 agent 产物的统一落点，可在代码栏查看，并可一键插入使用说明提示词），强化代码工作区的 Markdown 预览并新增 HTML / 表格 / JSON / PDF 预览，软键栏支持 Shift 修饰键，终端新增快捷键参考。

会话临时文件夹

每个会话拥有一个交互物临时文件夹 $TMPDIR/webmux-artifacts-<uid>-<实例摘要>/<会话ID>，首次需要时创建，权限 0700；路径已被符号链接、他人目录或共享权限目录占用时拒绝使用且不改动它（#213）。
代码栏导航顶部新增“工作区 | 临时文件夹”切换，可浏览、搜索、预览和下载其中文件；临时文件夹没有“修改”与 Diff（#213）。
⚡ 快捷指令菜单顶部固定“插入临时文件夹提示词”，把说明临时文件夹用法的提示词（含真实路径）插入终端或草稿，不自动回车；模板可在“设置 → 快捷指令”中编辑、恢复默认并跨设备同步（新设置键 artifactPrompt）（#213）。
新接口 POST /api/sessions/{id}/artifacts 返回文件夹路径（#213）。

代码工作区

Markdown 预览：相对链接在代码面板内打开文件或定位目录，标题锚点与“目录”，工作区相对图片懒加载，围栏代码块语法高亮；文件预览与聊天消息使用独立的净化规则（#210）。
新增 HTML（隔离静态渲染）、CSV/TSV 表格、JSON 与 PDF 预览（#210）；修复 PDF 页码框输入时被滚动覆盖的问题（#212）。

终端与界面

软键栏新增 Shift：点按一次性生效，长按约 0.5 秒锁定；支持 Shift+Tab、Shift+方向键等组合（#206）。
终端右上角新增“快捷键”参考面板，说明键位、平台差异与生效范围（#207）。
聊天输入框下方的会话选项统一收为图标控件，横向滚动不再挤压输入框（#205）。

文档

文档单行宽度守卫收紧至 300 显示列，并对超长段落做语义改写（#211）。

升级须知

替换二进制后需重启服务；重启会结束当前所有终端会话，混合会话可从首页“可恢复”分组恢复。
上传文件位置变化：上传改存到会话临时文件夹的 uploads/，同名文件追加 (2) 等序号。升级前留在草稿或待发送聊天附件中的旧 webmux-upload-* 路径会被拒绝，需要重新上传。
上传文件随会话清理：普通会话移除后其临时文件夹（含上传文件）随之删除；混合会话保留到删除其可恢复记录为止；服务启动时清扫不再属于任何可恢复会话的文件夹。以前上传文件会保留到服务停止。
artifactPrompt 为 null（使用内置模板）时不写入 settings.json。若保存过自定义模板，回退到旧版本前请在设置页点击“恢复默认”，否则旧版本会把设置文件判为损坏（503）。

验证

发布提交：3ca88de72073c270577e00cd4cad48e4addebc74，tag v0.9.0。
主分支 Test 工作流：全部检查通过。首次运行中 macOS E2E 分片因与本次变更无关的 split-background.spec.ts 偶发失败（重试通过，CI 视 flaky 为失败），重跑失败分片后通过；本地对该用例重复 40 次全部通过。
本地在发布提交上运行 make check 与完整 make test：Go race、Vitest 单元 544 / 浏览器 375、Storybook 332、E2E 255（27 跳过）、性能 16 全部通过。

WebMux v0.8.0

2026-10-29T04:50:50Z

更新内容

v0.8.0 增加 ACP 混合会话（同一段 OpenCode / omp 对话在聊天视图与原生 TUI 之间切换）、聊天附件、tmux 风格终端分屏和锁定终端尺寸，并收紧启动配置校验、修复会话迁移后回放与状态轮询加锁问题。

混合会话（聊天 ↔ 终端）

新增 ACP 混合会话：OpenCode 与 omp 的同一段对话可以在原生 TUI 与聊天视图之间来回切换，webmux 会话 ID 不变，历史由 agent 自己保存。会话页头部用“聊天 | 终端”控件切换，正在执行的回合先中断再切换，失败自动回到原来的一端（#181、#187、#190）。
聊天视图支持多设备共享队列、插话、权限请求与表单、空闲休眠（chatIdleSleepMinutes，默认 30 分钟）和重启后从首页“可恢复”分组恢复；CLI ls 显示所在端，attach 在聊天端时被动分离或拒绝。
聊天端可选择权限模式（每次询问 / 自动批准），默认自动批准（#181）。点击上下文用量环可查看 Token 使用详情（#181）。
切到终端时一直显示进度，直到新 TUI 在本页输出第一屏，切换窗格淡入；“减少动态效果”下不播放动画（#192）。
聊天视图支持上传文件与图片（选择、拖放、粘贴），上传中可取消（#194、#197）；agent 声明相应能力时，图片以 ACP image 块、其他文件以 resource 块直接发送，能力不足时退回为服务器路径并提示（#196、#198）。
新安装首次启动预置的启动配置默认自动批准（Claude Code、Codex CLI、Gemini CLI、Open Code、omp），其中 Open Code 与 omp 默认开启混合模式；已有 launch-configs.json 不会被改写（#191）。

终端与界面

支持 tmux 风格分屏：同一页面左右/上下嵌套最多 8 个窗格，拖动调整比例，Ctrl+B 前缀切换、放大和关闭窗格；布局保存在本机，窄于 768px 时一次显示一个窗格（#199）。
终端菜单新增“锁定尺寸”：移动端弹出软键盘或地址栏变化时不再改变 PTY 行列，避免 TUI 重绘卡顿（#184、#185）。
软键栏增加 # 和 ! 按键（#182、#183）。
会话卡片在当前标签页打开终端，修饰键点击保留浏览器默认行为；会话页顶栏、首页会话卡片信息行和聊天输入框焦点样式重新整理，大字号窄卡片不再横向溢出。
创建 worktree 时“起始提交”显示 commit 标题，并标明本地/远程分支（#200）。

可靠性与修复

修复 MoveClients 之后浏览器请求回放会吞掉“已迁移”消息、连接停在无输出状态的问题；状态轮询读取 /proc 时不再持有 Manager 锁；关闭服务时等待状态与伴随进程协程退出（#201）。
DELETE /api/sessions/{id} 按错误类型返回 404 / 409 / 400 / 503 / 500，不再一律 404（#201）。
macOS 上读取进程可执行文件路径恒为空的问题已修复（#187）。
修复若干不稳定测试；文档与 spec 增加单行长度守卫（#193、#195）。

升级须知

替换二进制后需重启服务；重启会结束当前所有终端会话，仓库登记与磁盘工作树保留。混合会话在重启后标记为已中断，可从首页“可恢复”分组恢复到聊天或终端（排队消息不保留）。
启动时校验更严格：listen 端口无效（如 :99999），或 allowed_origins 中有不是精确小写 scheme://host[:port] 形式的条目（带路径、末尾斜杠、默认端口、大写字母或缺少 scheme）时，服务直接启动失败。这些条目在旧版本中本来就无法匹配、请求会被 403 拒绝；升级前请先修正配置（#201）。
新增状态文件 hybrid-sessions.json（及其锁），只保存会话对应关系、命令快照与状态，不含环境变量值、消息或 token；损坏时只禁用混合会话，普通会话不受影响。
启动配置的 hybrid 字段只在勾选时写入，文件仍为版本 2。回退到旧版本前先取消所有混合勾选，否则旧版本会报告启动配置文件损坏。
新安装的预置 agent 配置带有自动批准参数（如 --dangerously-skip-permissions、--dangerously-bypass-approvals-and-sandbox、--yolo），agent 执行命令不再逐条确认；需要逐条确认时在“设置 → 启动配置”中删除这些参数。

验证

发布提交：27b88ac4b1215431ca8032151e03a7681700f3a5，tag v0.8.0。
主分支 Test 工作流：全部检查（Go race、Vitest、Storybook、性能、Ubuntu 与 macOS E2E 分片）和最终汇总通过。发布前修复了 TestFakeAgentProfiles 在 CI 上偶发失败的测试竞态（只改测试）。
本地 make check（构建、类型、格式、文档守卫、Oxlint、前端架构守卫、Go 架构守卫、go vet、golangci-lint）与 make test-fast（Go race 全部包、479 个单元、326 个浏览器用例）通过。
本地 make release VERSION=0.8.0：8 个 Linux、macOS、Windows 产物的架构和 SHA256SUMS 校验通过，Linux 二进制报告 webmux 0.8.0；allowed_origins 带末尾斜杠时启动失败并给出原因。
Release 工作流：前端构建、Go race、全部产物、SHA256 校验和版本检查通过。
已重新下载线上全部文件并通过 SHA256SUMS；线上 Linux 二进制版本、源码修订号与 CGO_ENABLED=0 正确。隔离实例冒烟：未认证 401、创建会话并读到输出预览、删除会话、首页静态资源；新状态目录预置 6 条启动配置，Open Code 与 omp 为混合模式。
混合会话的真实 agent 验收（omp 18.13.2、OpenCode 2.1.4）在 #187 中完成；本次发布未重复真实 agent、Windows 实机托盘和 iOS/Android 真机手工验收。

下载

文件	用途
`install.sh`	Linux/macOS 一键安装脚本
`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`	全部文件的 SHA256 校验值

What's Changed

feat(web): 软键栏增加 # 和 ! 按键 by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/183
docs(openspec): 归档 add-program-status-signals by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/188
feat(web): 增加锁定终端尺寸选项 (#184) by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/185
feat: ACP 混合会话——聊天视图与原生 TUI 之间切换 (#181) by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/187
fix(hybrid): 修正 #187 合入后 main 上的不稳定测试与两处状态发布时序 (#181) by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/190
feat(launch): 预置 agent 配置默认自动批准，OpenCode 与 omp 默认混合模式 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/191
feat(web): 切到终端时显示进度直到新 TUI 首屏输出，切换窗格淡入 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/192
docs: 为文档与 spec 增加单行长度守卫 by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/195
feat(web): 聊天模式支持上传文件与图片并插入路径 (#194) by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/197
feat(hybrid): 聊天附件以 ACP 图片/嵌入资源块发送 by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/198
fix(web): show commit titles for worktree starting points by @myot233 in https://github.com/mzdluo123/webmux/pull/200
feat(web): 支持 tmux 风格的终端分屏 by @myot233 in https://github.com/mzdluo123/webmux/pull/199
fix: address code quality scan findings (session replay, error mapping, config validation, a11y) by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/201

Full Changelog: https://github.com/mzdluo123/webmux/compare/v0.7.3...v0.8.0

WebMux v0.7.3

2026-10-27T13:58:59Z

升级注意

webmux run --launch-config / --config-id 现在按配置名称选择（区分大小写），不再接受配置 ID（#176）。
webmux run -- COMMAND（Linux/macOS）现在默认继承调用方 shell 的环境，--env 覆盖同名值；终端身份变量、WEBMUX_SESSION_ID、PWD/OLDPWD 不继承。Windows 客户端与启动配置不受影响（#180）。

What's Changed

fix: 给出 Tailscale 所有权未知时的精确恢复命令 (#174) by @pullfrog[bot] in https://github.com/mzdluo123/webmux/pull/178
feat(cli): webmux run 按名称选择启动配置 by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/176
feat(tray): 将所有复制链接收拢到单一菜单 (#177) by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/179
feat(cli): webmux run 默认继承调用方环境 (#175) by @mzdluo123 in https://github.com/mzdluo123/webmux/pull/180

Full Changelog: https://github.com/mzdluo123/webmux/compare/v0.7.2...v0.7.3

WebMux v0.7.2

2026-10-27T12:03:41Z

更新内容

v0.7.2 是小版本更新：新增 webmux start 后台启动；所有已授权的 HTTPS 入口都可以开启推送；终端支持用 Ctrl+C 复制选中内容。

CLI

新增 webmux start：没有 systemd/launchd 时也能在后台运行，启动命令立即返回，并打印 PID、本机地址和日志路径。日志默认写到 <state_dir>/webmux.log。服务已在运行时重复执行不会再启动一份，可用 webmux stop / webmux status 停止和查看（#164、#172）。

推送

只要页面来自已授权的 HTTPS 入口，就可以开启推送，包括 Tailscale Serve/Funnel、Cloudflare Named Tunnel，以及 allowed_origins 里配置的 HTTPS 地址。如果反向代理在非 443 端口上转发、并去掉了 Host 里的端口号，通知链接会按配置的端口生成。本机回环地址仍可开启；Quick Tunnel 和非本机的普通 HTTP 地址仍不支持，并会说明原因（#154、#173）。

终端

有选中内容时按 Ctrl+C 复制选区，没有选中时照常发送 SIGINT，与 Windows Terminal 一致（#170、#171）。

升级说明

替换二进制后需要重启服务。重启会结束当前所有终端会话，仓库登记和磁盘上的工作树会保留。

WebMux v0.7.1

2026-10-27T10:07:34Z

更新内容

v0.7.1 是小版本更新：增加一键安装脚本与 CLI 使用 Web 端启动配置，改进 PWA 前台重连、安装入口与浏览器标签页运行指示，并修复 Home Screen 应用中设置导航遮挡顶栏的问题。

安装与 CLI

新增 POSIX install.sh 一键安装脚本，作为 Release 资产发布，不依赖 raw.githubusercontent.com：支持 Linux/macOS 的 amd64/arm64，先直连 GitHub，失败后按 WEBMUX_MIRRORS 回退镜像；二进制与同源 SHA256SUMS 校验通过才原子替换，失败保留旧文件；可用 WEBMUX_VERSION、WEBMUX_INSTALL_DIR、WEBMUX_SHA256 固定版本、目录与摘要。脚本只安装二进制，不修改配置、服务或 shell（#163、#166）。
webmux run --launch-config ID（别名 --config-id）直接使用 Web 端保存的启动配置，argv 与环境变量由服务端解析；与 -- 后命令、--env 互斥，空 ID 和冲突别名在创建会话前拒绝（#168）。
会话环境统一终端身份：移除宿主终端/多路复用器（Kitty、tmux、Warp、iTerm、WezTerm、Ghostty、Windows Terminal 等）变量，默认设置 TERM=xterm-256color、COLORTERM=truecolor、TERM_PROGRAM=webmux、TERM_PROGRAM_VERSION 与 WEBMUX_SESSION_ID；显式启动环境仍可覆盖（#168）。

Web 与 PWA

健康的终端连接回到前台时先探测并保留，不再无条件重连；设置页新增“安装应用”分区，显示安装状态与非安全上下文提示；manifest 增加 id/lang，推送授权只请求一次（#161、#165）。
当前终端或首页任一会话处于运行中时，浏览器标签页标题加 ▶ 前缀并播放本地生成的 favicon 动画；等待、空闲、退出时恢复静态图标，prefers-reduced-motion 下保持静态（#162、#167）。
Home Screen 应用中设置页吸顶分区导航按实际顶栏高度定位，不再遮挡顶栏（#157、#159）。

升级说明

替换二进制后需重启服务；重启会结束现有终端会话，仓库登记与磁盘工作树保留。

WebMux v0.7.0

2026-10-27T02:28:48Z

更新内容

v0.7.0 增加 Tailscale Serve / Funnel 托管、跨设备服务端偏好同步、统一配置与状态持久化，并修复原生附着、响应契约和浏览器失败路径问题。

Tailscale 安全入口

支持检测 Tailscale 状态，并通过配置文件或设置页创建、切换和关闭 Serve / Funnel HTTPS 入口；保存后立即生效，无需重启或结束终端会话（#144、#145）。
支持 Linux/macOS、WSL 原生 Tailscale 和显式选择的 Windows 主机 provider；Windows provider 要求 WSL mirrored 网络，自动模式不会代管 Windows 节点。
按精确端口和目标记录所有权，启动时对账，退出或切换时只移除本实例入口，不执行全局 reset；端口冲突、状态损坏或目标不明时失败关闭。
Host / Origin 按 Cloudflare 与 Tailscale 来源及端口独立授权。Funnel 默认关闭，开启前需要风险确认；状态接口不返回 token、其他入口目标或原始 CLI 输出。

跨设备偏好与配置诊断

新增服务端偏好存储及 REST / WebSocket 同步：主题、终端字号、输出预览、代码阅读、快捷指令、主页工作树和软键盘偏好可在桌面与手机间即时同步（#119、#146、#147）。
更新带修订号并原子提交，冲突返回 409；客户端按操作意图重读并最多重放一次，断线通过快照恢复，慢客户端不会阻塞其他连接。
webmux config show 默认只读显示磁盘配置，--live 显示运行进程的已验证内存快照、字段来源、实例和存储健康；凭据只显示是否配置，磁盘与活进程诊断不相互回退。

持久化与可靠性

统一 JSON 存储的权限、跨进程生命周期锁、严格有界解码、原子替换和目录同步；损坏文件保留并按领域隔离，提交结果不确定时冻结写入，不广播虚构成功。
新增全平台持久化清单守卫，核对存储描述符、文件写入入口、锁和文档，防止新增状态文件绕过统一治理。
原生 run / attach 在退出或分离前取消并等待输入、输出和尺寸协程，不再遗留 stdin 读取或误关持久会话；Unix 处理信号中断重试，Windows 使用可取消同步读取。
必填响应数组和映射稳定编码为 [] / {}，并增加 Go wire 快照到前端 Zod 的契约测试；推送存储失败记录内部原因，同时保持固定、脱敏的客户端错误。
改进中途 401 恢复、上传 413/500/中断后的重试、重复提交防护、列表断线恢复、代码标签键盘导航、路由焦点、深色首屏和 reduced-motion 行为（#149、#152）。

工程与本地测试

新增 Go / 前端质量基线，CI 固定运行 golangci-lint、全仓 vet、类型感知 Oxlint、Svelte 推荐规则、严格索引和测试目录类型检查（#148、#150）。
新增 make test-fast（Go race + Vitest 单元/组件），make test 保持完整门禁；本地 E2E 默认最多 2 个 worker，可用 WEBMUX_E2E_WORKERS 和 GO_TEST_PARALLEL 调整（#151、#153）。
E2E 与性能套件共用一次预构建运行时；CI 保持原有分片和 worker 配置，并缓存 Playwright 的 Linux 系统依赖、忽略等待同轮运行产物时的失败 API 响应。

升级须知

替换服务端二进制并重启后生效；服务重启会结束当前 PTY 会话，请先处理正在运行的任务。
先停止全部旧实例并备份配置与状态目录。 新旧版本不得共用同一状态目录并发运行；锁文件统一为完整数据文件名加 .lock。
tunnel.json 改为 tunnel-settings.json，Tailscale 所有权记录改为 tailscale-ownership.json。旧 tailscale.json 会阻止启动：先核实或撤销旧版本创建的外部入口，不要直接删除记录后遗忘仍存在的入口。
launch-configs.json 仅接受版本 2；版本 1 文件会保留并使启动配置不可用。升级前用旧版本保存为 v2，或备份后重建。
旧浏览器偏好不会自动上传；首次使用时在设置页重新确认。Token、Web Push 身份、草稿和最近目录仍保留在本机，不纳入跨设备同步。
Serve 仅 tailnet 可达；Funnel 会公开到互联网。公网入口仍要求 WebMux token，链接与 token 泄露等同于命令执行权限。Windows 实机托盘、真实公网 Funnel、Linux/macOS 原生 Tailscale 和 iOS/Android 真机未做本次手工验收。

验证

发布提交：b43fc684eac930687c4889c2d4c2c93d5ed5e09a，tag v0.7.0。
主分支 Test 工作流：全部检查和最终汇总通过。合并后首轮发现设置页/快照契约交叉集成问题及一项 Go 测试 lint，已修复并在最终提交重新完整验证。
本地 make check、make test-fast（421 个单元、264 个浏览器用例）和完整桌面/Pixel 7 Chromium E2E（194 通过、20 按平台条件跳过）通过；8 个 Linux、macOS、Windows 产物的架构、SHA256 和托盘内嵌服务端摘要检查通过，Linux 二进制报告 webmux 0.7.0。
隔离实例手工验收：认证与 Origin 拒绝、磁盘/实时配置诊断、REST/WebSocket、PTY 输入输出、重连回放、退出清理、原生 run/attach 分离后继续运行、服务定义 dry-run。
桌面与 Pixel 7 双客户端偏好双向同步、重启持久化、409/非法请求、损坏设置文件保留与 503 降级均通过；偏好损坏时真实终端创建、命令、回放和退出仍可用。
真实 WSL2 mirrored + Windows Tailscale Serve 10000：设置页应用、HTTPS 页面、认证、Origin、WebSocket、状态脱敏和精确清理通过；既有 443/8444 入口保持不变。Funnel 风险确认与取消通过，未创建真实公网 Funnel。
上传 413、500、网络中断后第四次重试成功；深色首屏、reduced-motion、中途 401 恢复、路由焦点、代码标签方向键/Home/End、桌面/移动布局手工验收通过。
Release 工作流：构建与发布全部通过，包括前端构建、Go race、全部 8 个产物、SHA256 校验和版本检查。
已重新下载线上全部 8 个文件并通过 SHA256SUMS；线上 Linux 二进制的版本、源码修订号与 CGO_ENABLED=0 正确，认证、WebSocket、PTY 和重连冒烟再次通过。

下载

文件	用途
`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.6.0...v0.7.0

WebMux v0.6.0

2026-10-26T11:08:08Z

更新内容

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

WebMux v0.5.0

2026-10-25T10:35:13Z

更新内容

本版本把启动方式统一为用户自定义的启动配置，移除内置启动预设；新增终端输出查找、网页端公网隧道设置（持久化、无需重启）、代码工作区图片预览与下载，以及响应式设置分区导航。终端与代码工作区在窄屏上更紧凑。后端完成控制器 / 服务分层重构，并由架构测试与线上 JSON 快照约束。

⚠ 升级须知

移除内置启动预设：不再提供 Shell、Claude Code、Codex CLI、omp 等内置预设，TOML 中的 [[presets]] 与 shell 不再生效（旧配置仍可加载，这两项被忽略）。请在“设置 → 启动配置”中保存需要的命令；新安装没有任何启动配置，也可在新建会话时“手动填写”一次性命令。
API 不兼容：删除 GET /api/presets；POST /api/sessions 不再接受 preset / args，传入会返回 400（unknown field "preset"），请改用完整 argv 的 cmd 或 configId；SessionInfo 去掉 preset 字段；webmux config show --json 不再输出 presets。
客户端需一起升级：v0.4.0 及更早版本的 webmux run 与 Windows 控制台客户端会发送 preset 字段，连接 v0.5.0 服务端时创建会话会失败（400）。请同时更新服务端与各客户端二进制。
隧道配置来源：在网页“设置 → 公网访问”第一次保存后，配置写入 <state_dir>/tunnel.json 并优先于 TOML [tunnel]；--tunnel / --tunnel=false 只覆盖本次启动。“恢复配置文件设置”会删除网页配置并关闭隧道。

自定义启动配置

新建会话的“启动命令”分为“预先输入”（选择已保存的配置，显示名称、命令和环境变量数量）与“手动填写”（一次性命令，不写入服务端）两个 Tab，切换时保留各自输入，并记住上次成功使用的选择。
启动配置新增“加载 ~/.bashrc”选项：勾选后以交互式 Bash 包装原命令，从 ~/.bashrc 获取 PATH 与环境变量；再次编辑时显示原命令，不会重复包裹。
“启动位置”改为 Tab，仓库与工作树改用主题一致的下拉框。

查找终端输出

终端菜单“查找终端输出”或 Ctrl+Shift+F（macOS ⌘F）打开查找；支持区分大小写、全词、正则，Enter / Shift+Enter 导航，Esc 关闭。查找输入不会发送到 PTY。
范围是浏览器 xterm 当前保留的缓冲（普通终端最多 10000 行，全屏程序仅当前屏幕）；服务端历史已截断时会提示。

网页端公网隧道设置

新增“设置 → 公网访问”（/settings/tunnel）：选择 Quick Tunnel 或填写 Named Tunnel 凭据与主机名，保存并启用，无需重启、不结束会话。开关与配置跨重启保留。
凭据只写不读；启用前确认风险，并要求 WebMux 登录 Token 至少 43 字符。存储损坏或锁冲突时保持本地服务可用且公网关闭；关闭操作即使无法落盘也会立即撤销公网访问。
新增 GET /api/tunnel、PUT /api/tunnel/settings、PUT /api/tunnel/enabled、DELETE /api/tunnel/settings；Windows 托盘的隧道开关与网页设置共享同一持久化状态。

代码工作区

预览 PNG、JPEG、GIF、WebP、AVIF、BMP、ICO 图片（适应窗口、1:1、缩放、拖动，手机双指缩放），并可按原始字节下载文件（#108）。
Diff 根据宽度自动切换并排 / 统一布局，“完整文件”合并为一个菜单；引用来源按选中行自动推断（#114）。
工具栏与标签栏合并；窄屏把文档栏收进代码菜单（#112）。

界面与性能

设置页新增分区导航：桌面在左侧，手机为顶部横向吸顶导航，支持键盘、地址片段直达与前进后退。
窄于 640px 时终端顶栏只保留常用操作，全屏、上传、滚动到最新移入菜单；翻看历史时出现“回到最新”按钮。iPhone 主屏幕 Web App 不再显示无效的全屏入口（#112）。
设置与管理表单按需加载，会话输出更新时保持列表顺序稳定，大量会话下筛选更流畅（#121）。

架构与工程

后端按控制器 / 服务 / 共享层分层，internal/archtest 以规则 R0–R10 强制约束；所有 REST / WebSocket JSON 由 internal/contract 类型定义，并以线上快照测试固定（#117）。
服务端内部消息编码失败时以关闭码 1011 仅断开当前连接，会话继续运行。
前端新增架构守卫 pnpm --dir web check:arch（设计系统规则、依赖层级、重复代码、未用导出），基线已清零（#118）。
状态文件统一原子写入；托盘、服务与运行时记录现在也会 fsync 文件与目录（#115）。
CI：E2E 分片复用同一份构建，整体时长缩短（#109、#113、#116）。

验证

发布提交：651687bdfca3b84ad8a33524e5070833f067167c，tag v0.5.0。
发布提交上的 Test 工作流全部通过。
Release 工作流通过：前端构建、Go race 测试、CGO_ENABLED=0 下全部 8 个产物构建，SHA256SUMS 校验与版本检查。
本地冒烟：含 shell / [[presets]] 的旧 TOML 可正常启动；GET /api/presets 返回 404；带 preset 的创建请求返回 400，仅带 cmd 的请求返回 201。
未在 Windows 实机上验证托盘发布产物，也未在 iOS / Android 真机上验证本版本的窄屏布局与终端查找。

下载

文件	用途
`webmux-linux-{amd64,arm64}`	Linux 服务端（也用于 WSL 2）
`webmux-darwin-{amd64,arm64}`	macOS 服务端
`webmux-tray-windows-{amd64,arm64}.exe`	Windows 托盘，管理 WSL 中的 WebMux
`webmux-windows-{amd64,arm64}.exe`	Windows 控制台客户端（建议改名为 `webmux.exe` 并放入 `PATH`）
`SHA256SUMS`	全部 8 个文件的 SHA256 校验值

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

WebMux v0.4.0

2026-10-24T07:30:07Z

更新内容

本版本加入服务端启动配置和多条暂存，设置页可查看公网隧道的运行状态，并提供 Named Tunnel 配置指引。默认监听地址改为 0.0.0.0:7681：未配置 token 且监听地址不是 loopback 时，每次启动自动生成强 token。原生终端附着会把本地终端的明暗配色报告给会话，Claude Code 与 Codex CLI 预设也会加载 ~/.bashrc。

⚠ 升级须知

默认监听所有接口，并自动生成 token：默认 listen 从 127.0.0.1:7681 改为 0.0.0.0:7681。未配置 token 且监听地址不是 loopback（包括默认值）时，每次启动生成 256 位随机 token，并在终端打印带 #token= 的本地链接；以 systemd / launchd 运行时该链接会写入 journal 或日志，且每次重启更换。需要固定 token 时，请执行 webmux config init（webmux service install 初始化的配置已带 token）。只有仅监听 loopback 且未启用隧道时，空 token 才表示不认证。正在运行的实例可通过 webmux status --json --reveal-token 读取当前 token。配置中显式写了 listen 的用户不受默认值变化影响。
agent 预设改为经交互式 bash 启动：默认 claude、codex 预设与 omp 一样以 bash -ic 'exec <agent> "$@"' <agent> 启动。配置中已声明 [[presets]] 的用户需要手动修改对应 cmd；已保存的启动配置是命令副本，不会随之改变。

启动配置（#103）

设置页新增“启动配置”：把“名称 + 完整命令 + 环境变量”保存在服务端，换浏览器或设备后仍可使用；可从内置预设填入命令，名称默认取预设标签。环境变量值默认遮挡，列表与新建会话页只显示变量个数。
新建会话页并列显示内置预设与已保存配置，一次性命令收在“临时命令（不保存）”中；上次选择从 lastPreset 自动迁移为 lastLaunch。
新增 /api/launch-configs 增删改查接口：列表只返回 envNames，变量值经 GET /api/launch-configs/{id} 读取。POST /api/sessions 新增 configId，与 preset/cmd/args/env 互斥。
配置保存在 <state_dir>/launch-configs.json（0600，原子写入），由独立文件锁保护；文件损坏或被同一状态目录的另一实例占用时，该功能返回 503 并在设置页显示原因与路径，内置预设与临时命令照常可用。

草稿与暂存（#98）

同一会话可保留多条暂存，分别编辑、排序、取用和删除，与当前草稿互不覆盖；暂存面板以图标操作，显示条数、字符数及满额原因。
界面图标统一为本地打包的 Iconify（tabler）图标。

公网隧道（#101、#104）

设置页区分 Quick / Named Tunnel，按步骤说明创建隧道、获取隧道 token、发布应用、写入配置和重启验证，明确根 token 与隧道 token 的区别及 43 字符要求；新增 Named Tunnel 配置指南。
设置页按运行时状态显示隧道未启用、启动中、已就绪或异常停止；就绪时区分 Quick / Named 并显示公网地址。

终端与原生附着

同步本地终端配色：程序已开启明暗报告（DEC 2031）时，webmux attach / run 在取得控制后向本地终端查询背景色（OSC 11），按亮度向会话发送 CSI ? 997 ; 1|2 n，查询应答本身不写入会话。之前从浏览器切到原生终端后，程序会沿用其他设备的配色。分离时关闭本地终端的 2031 模式。本地终端不应答 OSC 11 时不发送报告；Windows Terminal 不支持 2031，附着期间切换主题后需重新附着或按 Enter 重新取得控制。
agent 预设加载 ~/.bashrc：Claude Code、Codex CLI 预设经交互式 bash 启动，~/.bashrc 中的环境变量与 PATH 对 agent 可见，追加参数原样传入。

其他

登录页的共享 Token 右侧新增问号提示，说明 token 的用途、生成方式、配置路径和启动参数覆盖（#107）。
移除工作区底部的两条提示（#102）。
Node.js 升级到 26.12.1，文档改为直接安装 pnpm（#105）。
OpenSpec 规格同步并归档全部 14 个变更（#106）。

验证

发布提交：c352ae862c9c9c1270c2563a1ca6a32bd737c547，tag v0.4.0。
Release 工作流通过：前端构建、Go race 测试，以及 CGO_ENABLED=0 下 Linux / macOS 服务端和 Windows 控制台 / 托盘的 amd64、arm64 构建；SHA256SUMS 校验与版本检查均通过。
在发布提交上，Test 工作流全部通过：格式与构建、Ubuntu Go race、Vitest 单元与浏览器测试、Storybook、Ubuntu / macOS E2E，以及 CLS 和 4 倍 CPU 降速检查。首次运行中 push.spec.ts 的 Service Worker 通知用例在 chromium-mobile 上未显示通知（重试通过，按 failOnFlakyTests 记为失败），重跑失败的作业后全部通过。
未在 Windows 实机上验证本版本的托盘发布产物；原生附着的配色同步只用模拟终端与 PTY 冒烟测试验证，未在各终端实机上逐一验证。

下载

文件	用途
`webmux-linux-{amd64,arm64}`	Linux 服务端（也用于 WSL 2）
`webmux-darwin-{amd64,arm64}`	macOS 服务端
`webmux-tray-windows-{amd64,arm64}.exe`	Windows 托盘，管理 WSL 中的 WebMux
`webmux-windows-{amd64,arm64}.exe`	Windows 控制台客户端（建议改名为 `webmux.exe` 并放入 `PATH`）
`SHA256SUMS`	全部 8 个文件的 SHA256 校验值

完整变更：https://github.com/mzdluo123/webmux/compare/v0.3.0...v0.4.0

WebMux v0.3.0

2026-10-22T16:04:45Z

更新内容

本版本加入注意力提醒的 Web Push 推送：会话需要处理时，即使页面已关闭或手机已锁屏也能收到通知。同时主页区分 Shell 报告目录与会话归属，Windows 托盘检查 WSL 中 webmux 的兼容性与版本对应，并修复多项 iOS 体验问题。

通知推送（Web Push）

注意力推送（#88）：设备开启推送后，会话需要处理时收到系统通知，页面关闭或手机锁屏后依然有效。页面须从 Cloudflare Named Tunnel 域名（https://<tunnel.hostname>）或回环地址打开；Quick Tunnel 返回 409 quick_tunnel，VPN / 局域网地址等其他来源不能订阅。
加密（RFC 8291 aes128gcm）和 VAPID（RFC 8292）只使用 Go 标准库，无新增依赖。VAPID 密钥和最多 32 个订阅保存在 <state_dir>/push.json（0600）；推送服务返回 404 / 410 时删除订阅。日志只记录订阅 ID 和推送服务主机，不记录 endpoint。
去重：首次快照中已存在的提醒不推送，spinner 输出、来源变化和重连不会重复推送；内部订阅落后重连后，期间产生的提醒只推送一次。
新增配置段 [push]：enabled、subject、ttl_seconds、kinds（bell 默认关闭）和 include_title。/local/v1/status 与 webmux status --json 新增可选的 push 字段，契约仍为 v1。
设置页新增“通知推送”卡片：前置条件不满足时逐项提示（非安全上下文、iOS 未从主屏幕打开、Quick Tunnel、配置未启用、权限被拒等）。Chrome 改用静默权限提示时，卡片说明在地址栏铃铛处允许通知。
测试通知一次发送到所有已订阅设备，并报告设备数、成功数、移除数和错误；未开启推送的浏览器也能发送，便于在桌面上检查手机后台的显示效果。
Windows 托盘在隧道项下显示“手机推送”状态和已订阅设备数；“手机推送设置说明…”按是否配置 Named Tunnel 给出设置步骤，不包含 Token。

会话与代码查看

Shell 报告目录（#89）：解析 shell 通过 OSC 7 报告的当前目录，在会话行中与启动目录分开显示，远端主机的报告带“远端”标记；会话仍按启动目录归属到仓库 / 工作树。SessionInfo 新增可空字段 reportedCwd。docs/usage.md 提供可自行启用的 bash / zsh 片段，WebMux 不改写 shell rc。
会话菜单可复制 Shell 报告目录（无报告时复制启动目录）。
代码导航新增“按路径打开”：相对路径以 Shell 报告目录（无报告时用启动目录）为基点，由新增的 GET /api/sessions/{id}/code/locate 在服务端解析符号链接，只打开代码工作区根内的路径；目录会跳转到文件树。
omp 预设加载 ~/.bashrc（#91）：默认 omp 预设改为 bash -ic 'exec omp "$@"' omp，~/.bashrc 中的环境变量对 omp 可见，参数边界、进程组和退出码保持不变。配置中已声明 [[presets]] 的用户需要手动修改 omp 的 cmd，或执行 webmux config init --force 重新生成。

Windows（WSL）托盘

版本兼容检查（#96）：托盘执行 webmux version --json，先按控制契约判断兼容，再按版本号判断对应，并在菜单状态行指出较旧的一方，例如 托盘 0.3.0 · WSL 0.2.0（WSL 较旧）。正在运行的实例与已安装文件版本不同时，提示重启后生效（重启会结束所有会话）。
WSL 中的 webmux 较新且为正式发布版本时，菜单提供“下载托盘 <版本>”，打开对应的 Release 页面。
契约不兼容的实例仍可启动和停止：托盘按 Windows 侧可达性跟踪，不会误判失败或自动重启，状态行显示“运行中（不兼容，功能受限）”。
新增 webmux version --json，输出 {"v":1,"version":"…","contract":1}，不读取配置；webmux version 的文本输出不变。旧版 webmux 不支持 --json 时，托盘回退解析文本并视为契约 v1。

iOS 与移动端

点击方向键等软键不再收起 iOS 键盘（#94）。
添加到主屏幕的 iPhone 应用中，主页和设置页顶栏不再被状态栏和 iOS 26 的边缘模糊遮挡。

其他

项目以 MIT 许可证发布。
仓库要求随功能变更维护 User Stories（#92）。
4 倍 CPU 降速下的交互延迟阈值从 200 ms 放宽到 300 ms，避免共享 runner 的性能波动导致检查失败。

验证

发布提交：ff726f04b52577b0ff8531372a5a5838b2b77e2f，tag v0.3.0。
Release 工作流通过：前端构建、Go race 测试，以及 CGO_ENABLED=0 下 Linux / macOS 服务端和 Windows 控制台 / 托盘的 amd64、arm64 构建；构建时确认两个托盘都内嵌了 Linux 服务端摘要。SHA256SUMS 校验与版本检查均通过。
在发布提交上，Test 工作流全部通过：格式与构建、Ubuntu Go race、Vitest 单元与浏览器测试、Storybook、Ubuntu / macOS E2E，以及 CLS 和 4 倍 CPU 降速检查。
未在 Windows 实机上验证本版本的托盘发布产物；CI 无法覆盖推送经 APNs / FCM 的实际送达。

下载

文件	用途
`webmux-linux-{amd64,arm64}`	Linux 服务端（也用于 WSL 2）
`webmux-darwin-{amd64,arm64}`	macOS 服务端
`webmux-tray-windows-{amd64,arm64}.exe`	Windows 托盘，管理 WSL 中的 WebMux
`webmux-windows-{amd64,arm64}.exe`	Windows 控制台客户端（建议改名为 `webmux.exe` 并放入 `PATH`）
`SHA256SUMS`	全部 8 个文件的 SHA256 校验值

手机推送的配置步骤见部署指南。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.2.0...v0.3.0

WebMux v0.2.0

2026-10-22T01:10:03Z

更新内容

本版本加入 Windows（WSL）支持：WebMux 运行在 WSL 2 中，Windows 端提供托盘程序和控制台客户端。同时引入客户端 / 服务端架构，新增原生终端附着和用户级服务管理。

Windows（WSL）

托盘程序 webmux-tray-windows-{amd64,arm64}.exe（#82）：在 WSL 2 中启动、监控和停止 WebMux，支持托盘托管与 systemd 两种启动方式；托盘托管的服务意外退出后自动重启（10 分钟内最多 5 次）。支持选择发行版、登录时自动启动，并保证同一用户只运行一个实例，无需管理员权限。
托盘安装 / 升级 WSL 中的 webmux：托盘下载与自身同版本、匹配发行版架构的 Linux 二进制（GitHub 无响应时改用镜像），SHA-256 必须与发布构建时写入托盘的摘要一致才会安装，不会静默自动安装。
访问入口：托盘可以打开 WebMux，也可以复制本机、远程、公网链接或 Token。配置了 Token 时，复制的链接带 #token=，不进入剪贴板历史和云同步，60 秒后自动清除；通知只显示不含 Token 的地址。
远程访问：WSL NAT 模式下，托盘可以把选定的主机地址（Tailscale 地址优先）转发到 WSL 中的服务，并保留 Host / Origin 校验。Cloudflare 公网隧道可在运行中开关，开启前需要确认，无需重启服务。
控制台客户端 webmux-windows-{amd64,arm64}.exe（#84）：在 PowerShell / Windows Terminal 中执行 run、attach、ls、open、status。客户端经 wsl.exe --exec webmux bridge 访问服务，无需 Token，不依赖 WSL 的 localhost 转发或网络模式；当前目录自动换算为 WSL 路径。
托盘启动的服务会把 ~/.local/bin 等目录加入 PATH，修复 claude / codex / omp 会话报“找不到可执行文件”的问题。

命令行与本机 API

客户端 / 服务端架构（#83）：服务除 TCP 外还监听一个 0600 权限的 Unix 套接字，按对端 UID 认证，并提供 /local/v1/status、shutdown、token、tunnel。会话内的进程可以创建、列出、附着会话，但不能停止服务、读取 Token 或控制隧道。
新增子命令 serve、status、stop、bridge 和 config path|show|validate|check|init。status / stop 支持版本化 JSON 输出，serve 支持 --log-file。
原生终端附着（#85）：webmux run -- <命令> 在当前目录创建会话并附着，webmux attach <ID> 接续会话，ls / open 查找会话和链接。Ctrl+] 分离后会话继续运行，可在浏览器或手机上接管。
附着修复：浏览器取得控制后，原生终端的自动应答不再抢回控制，只有按 Enter 才会重新接管。在 modifyOtherKeys、kitty 键盘协议和 Windows Terminal win32-input-mode 编码下，也能识别 Enter 和 Ctrl+]。
用户级服务（#86）：webmux service install|status|logs|start|stop|restart|uninstall 以当前用户安装 systemd --user 或 launchd 服务，无需 sudo。--dry-run 可预览服务文件，--force 可更新服务定义；卸载时保留配置、日志和状态目录。

文档

README 新增设计理念（第一级别的 WSL 支持、低侵入性、融入现有终端 agent 工作流、高性能低占用）和 Windows（WSL）快速开始。
新增 User Stories，按功能列出用户目的和验收要点（#87）。

验证

发布提交：1a182519ef3ad28177d88f33197b4312f48e05f0，tag v0.2.0。
Release 工作流通过：前端构建、Go race 测试，以及 CGO_ENABLED=0 下 Linux / macOS 服务端和 Windows 控制台 / 托盘的 amd64、arm64 构建。SHA256SUMS 校验与版本检查均通过。
下载已发布的 webmux-linux-amd64 后验证：SHA256SUMS 校验通过，版本为 0.2.0；认证请求返回 200，未认证返回 401，非法 Origin 写请求返回 403，创建 shell 会话返回 201；webmux status 和 webmux ls 经本机套接字正确显示实例和会话。webmux-tray-windows-amd64.exe 内嵌的 Linux 服务端摘要与 SHA256SUMS 一致。
在发布提交上，Test 工作流中的格式与构建、Ubuntu Go race、Vitest 单元与浏览器测试、Storybook、Ubuntu / macOS E2E 全部通过。“CLS 和 4 倍 CPU 降速”检查中，桌面端 create-and-type 的交互延迟为 248 ms，超过 200 ms 阈值；相同前端代码在 77ab858 上为 168 ms 并通过，因此判定为 runner 性能波动。
未在 Windows 实机上验证托盘和控制台客户端。

下载

文件	用途
`webmux-linux-{amd64,arm64}`	Linux 服务端（也用于 WSL 2）
`webmux-darwin-{amd64,arm64}`	macOS 服务端
`webmux-tray-windows-{amd64,arm64}.exe`	Windows 托盘，管理 WSL 中的 WebMux
`webmux-windows-{amd64,arm64}.exe`	Windows 控制台客户端（建议改名为 `webmux.exe` 并放入 `PATH`）
`SHA256SUMS`	全部 8 个文件的 SHA256 校验值

Windows 安装步骤见 README 和部署指南。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.10...v0.2.0

WebMux v0.1.10

2026-10-21T08:39:24Z

更新内容

新功能

代码工作区可弹出到独立窗口：顶栏“刷新全部”右侧新增按钮，把整个代码工作区连同已打开的标签移到单独窗口，引用发送和变化检测照常工作，收起主窗口代码栏也不影响；关闭窗口或点“收回”即回到原位。Chrome / Edge 在 HTTPS 或 localhost 下使用置顶画中画窗口，HTTP 访问、Safari、Firefox 使用普通弹出窗口；手机和平板不显示该按钮。
通过 Cloudflare Tunnel 远程访问，支持带 Token 的登录链接和二维码（#63）。

界面与交互

移动端工作区和代码页的常用按钮从 44px 缩小到 36px，同屏可显示更多内容。
会话卡片的状态、连接与时间紧凑排列，不再按固定列分散。
顶栏连接状态和主机名紧贴操作按钮，状态变化不再引起布局跳动。
终端程序可感知页面的浅色/深色主题切换（DEC 2031）；移除终端下方的黑色条带；worktree 的“启动会话”按钮更易识别。

稳定性

稳定终端相关检查，加快新建会话表单的打开速度（#81）。

验证

发布提交：27dbd12586c09505545fa3916d2104f6ebd20b34，tag v0.1.10。
在该提交的独立源码目录运行冻结依赖安装，交叉构建 Linux/macOS 的 amd64、arm64 二进制，CGO_ENABLED=0；Svelte/TypeScript 检查零错误、零警告。
Linux amd64 发布产物启动验证通过：版本为 0.1.10，357 个内嵌资源通过 HTTP 逐字节校验；认证健康检查返回 200，未认证返回 401，非法 Origin 写请求返回 403。
GitHub Actions 全部通过：格式与构建、Ubuntu Go race、Vitest 单元与浏览器测试、Storybook、Ubuntu/macOS E2E，以及 CLS 和 4 倍 CPU 降速测试。
四个二进制均通过 SHA256SUMS 校验。

下载

下载对应系统和架构的二进制，赋予执行权限后运行。SHA256SUMS 提供四个平台文件的 SHA256 校验值。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.9...v0.1.10

WebMux v0.1.9

2026-10-21T03:17:31Z

更新内容

工作区与代码查看

支持选择哪些 worktree 显示在首页，简化工作区与会话层级；收紧工具栏，改善窄屏和大字体下的操作可达性（#62、#65、#77）。
代码差异支持语法高亮、并排与统一视图，并完善空差异和文本选择提示（#73）。
统一界面设计、控件和反馈状态，在线状态显示服务端主机名（#66、#75）。

稳定性与性能

改善大量终端输出、进程与仓库负载下的会话响应，限制预览重复处理和输入排队时间，减少进程与 Git 查询开销（#64）。
修复无人值守的 sleep 被误判为等待输入的问题，覆盖 Linux 和 macOS（#61）。
减少页面布局跳动，限制启动时可选仓库查询的等待时间，改善慢设备上的创建反馈；增加桌面/移动端 4 倍 CPU 降速回归验证（#79）。
压缩内嵌前端资源，中文字体改用系统字体，保留打包的拉丁字母、终端符号和图标字体；四个平台的可执行文件约为 11.7–12.5 MB，较 v0.1.8 的约 37.6–38.3 MB 明显缩小（#80）。
更新 CodeMirror，采用 Oxfmt/Oxlint，并复用构建、并行隔离测试以改善 CI 耗时（#42、#74、#78）。

验证

发布提交：a8a6aed601b6d4a7721596d79753c1455293ef74，tag v0.1.9。
使用 Go 1.26.1、Node.js 24.22.0 和 pnpm 12.11.2，从该提交的独立源码目录运行冻结依赖安装，交叉构建 Linux/macOS 的 amd64、arm64 二进制，CGO_ENABLED=0；Svelte/TypeScript 检查零错误、零警告。
macOS arm64 发布产物启动验证通过：版本为 0.1.9，全部 357 个内嵌资源通过 HTTP 逐字节校验；健康检查和认证会话列表返回 200，未认证返回 401，非法 Origin 写请求返回 403，服务正常退出。
GitHub Actions 全部通过：格式与构建、Ubuntu Go race、Vitest 单元与浏览器测试、Storybook、Ubuntu/macOS E2E，以及 CLS 和 4 倍 CPU 降速测试；独立源码目录的本地 Go race 全套测试也通过。
四个二进制均通过 SHA256SUMS 校验。

下载

下载对应系统和架构的二进制，赋予执行权限后运行。SHA256SUMS 提供四个平台文件的 SHA256 校验值。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.8...v0.1.9

WebMux v0.1.8

2026-10-20T15:05:41Z

更新内容

工作区与移动端

新增会话实时搜索，支持按会话标题、目录、仓库名称和分支查找；提供全部、运行中、等待中和已退出状态筛选，并显示数量（#59）。
搜索时自动展开匹配的仓库，提供无匹配结果提示和清除筛选入口（#59）。
调整会话卡片、终端输出预览和状态展示；增大触控区域，改善窄屏及大字体下的布局（#59）。

终端与构建

升级 xterm.js 至 6.0.0，同步升级 fit 和 WebGL 插件；适配触摸滚动，保留 Alt/Option 方向键导航行为，并调整 WebGL 资源释放顺序（#51）。
升级 Vite 至 8.3.4、Svelte 插件至 7.3.1，保留 Chrome/Edge 107、Firefox 104 和 Safari 16 的构建目标（#56）。
拆分并行 CI 任务，保留 macOS Go race 与 E2E 覆盖；改善主题切换回归测试的稳定性。

验证

发布提交：f89f407897e444e0df07e38e95a789070be9e1e6（tag v0.1.8）。
GitHub Actions 全部通过：格式与构建、Go race、Vitest 单元与浏览器测试、Storybook，以及 Ubuntu/macOS E2E。
使用 Go 1.26.1、Node.js 24.22.0、pnpm 12.11.2，从 tag 独立构建 Linux/macOS 的 amd64、arm64 二进制；Svelte/TypeScript 检查零错误、零警告。
macOS arm64 发布产物启动验证通过：版本为 0.1.8，内嵌网页及入口 JS/CSS 返回 200，已认证健康检查返回 200，会话列表 API 未认证返回 401、认证后返回 200。

下载

选择对应操作系统和架构的二进制，赋予执行权限后运行。SHA256SUMS 包含四个二进制文件的 SHA256 校验值。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.7...v0.1.8

WebMux v0.1.7

2026-10-20T11:47:00Z

更新内容

新功能

手机输入与恢复可信化：提交确认、草稿本机保存、断线后增量续接，并引入会话控制端，只有控制端调整 PTY 尺寸，其他客户端按控制端的网格观看（#37）。
引入 Storybook 及 UI 溢出回归测试（#40）。
新增持久终端产品能力基线测量工具 cmd/baseline（#39）。

修复与安全加固

API 拒绝不受信任的请求 Host（#25）。
终端输入超出 WebSocket 发送预算时明确拒绝并提示；resize/resync 控制帧按类型合并，在队列恢复后重试，不会丢失（#33）。
终端渲染积压时自动恢复（#36）；慢客户端反复重连时退避（#34）。
代码引用中的 shell 元字符正确加引号（#29）。
限制预览解析的资源占用：重复指令工作量（#26）、组合字符数量（#27）；丢弃未使用的超链接元数据（#28）。
限制 Git 输出捕获大小（#32）；代码查看在校验根目录前先获取预算（#30）。

性能

进程树分类改为线性遍历（#31）；缓存内嵌静态资源的响应表示（#35）。

依赖与构建

从源码构建需要 Go 1.26+（golang.org/x/sys v0.49.0，#54）；发布的二进制不受影响。
Go：BurntSushi/toml v1.6.0、coder/websocket v1.8.15。
前端：TypeScript 6.0.3、zod 4.6.7、cn 0.5.0、svelte-check 4.7.7、vitest 5.0.5、playwright 1.64.1。

验证

发布提交：9b492ca960b779e2dd7b27af8a1afb414bb760cc。
GitHub Actions Test：Ubuntu、macOS 均通过。
从该提交独立构建 Linux/macOS 的 amd64、arm64 二进制。
Linux amd64 发布产物启动验证通过，版本为 0.1.7；内嵌网页返回 HTTP 200，会话列表 API 未认证返回 401、认证后返回 200。
本次发布未执行 iOS/Android 真机验收。

下载

选择对应操作系统和架构的二进制，赋予执行权限后运行。SHA256SUMS 包含四个二进制文件的 SHA256 校验值。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.6...v0.1.7

WebMux v0.1.6

2026-10-19T14:00:45Z

更新内容

新增终端快捷命令功能（#10）。
修复 iOS 输入法提交空格、数字和标点时输入丢失，以及组合输入期间的抖动（#9）。
改进 agent 等待关注状态：通过终端侧信号保持通知状态，后续输出不会清除，实际用户输入或相关生命周期信号才会清除（#8）。
调整浏览器测试对亚像素间隙及 resize 期间滚动手势的处理。

验证

发布提交：949ec3bbde1835199bb1f88b6c2318db0be25fb3。
GitHub Actions Test：Ubuntu、macOS 均通过。
从该提交独立构建 Linux/macOS 的 amd64、arm64 二进制。
Linux amd64 发布产物启动验证通过，版本为 0.1.6；内嵌网页及会话列表 API 返回 HTTP 200。
本次发布未执行 iOS/Android 真机验收。

下载

选择对应操作系统和架构的二进制，赋予执行权限后运行。SHA256SUMS 包含四个二进制文件的 SHA256 校验值。

完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.5...v0.1.6

WebMux v0.1.5

2026-10-15T12:23:18Z

更新内容

修复：平板上虚拟键盘意外弹出

连接手写笔、键盘套或开启桌面模式的平板，浏览器会把主指针报告为“精确指针”，此前被当作桌面设备处理：进入终端即自动聚焦并弹出键盘，软键栏和 ⌨ 按钮也被隐藏。

现在只要设备带触摸屏，就按触摸设备处理：

只有点击软键栏的 ⌨ 才会唤起虚拟键盘。进入终端、轻点终端、开启草稿、关闭粘贴 / 复制 / 字体弹窗、读取剪贴板失败、上传完成都不再自动聚焦输入。
软键栏在所有带触摸屏的设备上默认显示。
手写笔点击终端与手指一致：可滑动、捏合、长按选择，不会弹出键盘。

桌面鼠标操作不变，进入终端仍自动聚焦。

文档

README 重写为项目首页；原设计文档拆分为 docs/ 下的使用指南、部署指南、架构设计与 API 协议，新增 CONTRIBUTING.md 与 SECURITY.md。

使用与升级注意

带触摸屏的笔记本电脑也会显示软键栏，且用鼠标进入终端时不再自动聚焦，需先点击一次终端。
重启 WebMux 会结束现有终端会话；升级前请保存工作。仅替换磁盘上的二进制不会让正在运行的进程加载新版本。
仍须部署在 loopback 或可信 VPN 上；所有 API 与 WebSocket 均受 Token 和 Origin 检查保护。

下载

提供 Linux / macOS 的 amd64、arm64 独立可执行文件，均禁用 CGO，内嵌匹配版本前端。下载对应平台附件后使用 SHA256SUMS 校验完整性。

验证

GitHub Actions 在 Ubuntu 与 macOS 上均通过：格式检查、Go race、前端单元与 Chromium 组件测试及完整 E2E。
新增 E2E 回归：模拟主指针为精确指针的触摸平板，验证创建会话、从列表进入、手写笔点击、关闭弹窗后均不聚焦输入，仅点击 ⌨ 后聚焦；修复前该用例失败。
Linux amd64 附件实际运行：webmux version 输出 0.1.5，内嵌前端页面可访问且包含新的触摸屏样式，未带 Token 的 API 返回 401、带 Token 返回 200。
所有附件的构建元数据指向发布提交 2cad924，工作区无未提交修改，CGO 禁用。
平板行为已由维护者在真实设备上确认；macOS 与 Linux ARM64 附件为交叉编译产物，未在对应平台运行本次附件。

WebMux v0.1.4

2026-10-15T11:19:23Z

更新内容

草稿模式

终端顶栏新增“草稿”：左列上下分割为终端与多行草稿面板，可拖动手柄调整高度，同一终端实例通过正常 fit/resize 更新 PTY。
只有点击“发送”才提交：先完整粘贴正文，成功后在 bracketed paste 之外追加一次 Enter；框内 Enter 只换行，输入法组合期间禁用发送。粘贴与 Enter 均被本地连接接受后才清空并关闭草稿；失败或部分成功保留正文且不自动补发。
草稿与模式按会话隔离，仅保存在当前页面内存，刷新、关闭页面或认证失效会丢失。
开启草稿后，代码位置引用、上传路径与剪贴板文本进入草稿，而非直接输入终端。

终端与移动端

终端程序的 OSC 52 复制写入浏览器剪贴板；不可用时回退到复制文本框。回放历史（重新进入、刷新、重连）不再重复触发复制。
长文本复制 / 粘贴对话框限制在视口内滚动显示。
轻点、滑动或缩放终端不再唤起键盘，需输入时点击软键栏 ⌨；软键栏在触摸设备默认显示为单行横向滚动，菜单可“强制显示底部工具栏”。

代码工作区

桌面导航面板可拖动或用方向键调整宽度；打开文件或 Diff 不再自动收起导航。
修改列表使用彩色 Git 状态图标，只显示文件名，完整路径见悬停提示。

会话列表

会话行按状态着色背景（运行中、可能在等你、空闲、已退出），浅色与深色主题各用对应终端调色板。

其他

修复 xterm 在待执行视口帧前被销毁时抛错。
前端拆分触摸手势、上传与代码导航模块，行为不变。

使用与升级注意

草稿“发送”会追加回车；目标程序未启用 bracketed paste 时，正文中的换行也可能触发提交。
重启 WebMux 会结束现有终端会话；升级前请保存工作。仅替换磁盘上的二进制不会让正在运行的进程加载新版本。
仍须部署在 loopback 或可信 VPN 上；所有 API 与 WebSocket 均受 Token 和 Origin 检查保护。

下载

提供 Linux / macOS 的 amd64、arm64 独立可执行文件，均禁用 CGO，内嵌匹配版本前端。下载对应平台附件后使用 SHA256SUMS 校验完整性。

验证

GitHub Actions 在 Ubuntu 与 macOS 上均通过：格式检查、Go race、前端单元与 Chromium 组件测试及完整 E2E。
本地 Linux 同样通过：go vet、Go race、前端单元 41 项 / 组件 41 项、E2E 79 项通过（9 项按设计跳过）。
Linux amd64 附件实际运行：webmux version 输出 0.1.4，内嵌前端页面可访问，未带 Token 的 API 返回 401、带 Token 返回 200。
所有附件的构建元数据指向发布提交 64a4e24，工作区无未提交修改，CGO 禁用。
macOS 与 Linux ARM64 附件为交叉编译产物，未在对应平台运行本次附件。

WebMux v0.1.3

2026-10-15T05:39:20Z

更新内容

终端代码工作区

在终端旁浏览工作区文件与 Git 修改，浏览器内计算 Diff；支持展开折叠上下文、查看旧侧 / 新侧完整文件，并把 路径:行号 位置引用插入终端（不自动回车）。
Diff 行号栏拆为旧 / 新两列并右对齐，删除行与新增行不再错位；“引用来源”决定引用使用哪一侧版本与行号。
移动视图更紧凑：文件标签只显示文件名（悬停可见完整路径），文档路径与 Diff 控件合并为可换行的单行区域，查找 / 跳转行改为图标按钮；路径过长时从开头省略并保持左对齐。
查找栏与跳转行面板改用 shadcn 组件：支持区分大小写、全词、正则、上一个 / 下一个、选中全部匹配；跳转行支持 N、+N、-N、N%、行:列。
新增行号栏显示开关，选择保存在当前浏览器。
夜间模式：行号栏改用主题色，语法高亮新增与终端一致的 GitHub Dark 配色；切换主题即时生效。

稳定性

移动端触摸：点击代码行后点右侧＋发送位置；终端恢复滚动，并新增“滚动到最新位置”按钮。
上传完成后等待前台重连与回放结束再插入路径，支持取消，插入失败如实提示。
修复会话预览在缩窄后再增高时可能因虚假历史偏移导致的崩溃。
从终端返回会话列表时正确释放本页监听器，列表重新挂载后恢复操作，不刷新整页、不结束会话。
前端自托管 Inter、Noto Sans SC 与 Maple Mono 字体，不再依赖外部字体服务。

使用与升级注意

代码工作区只读浏览，不修改工作区文件；Diff 中“跳转行”按代码区行序定位，而非左侧显示的 Git 行号。
重启 WebMux 会结束现有终端会话；升级前请保存工作。仅替换磁盘上的二进制不会让正在运行的进程加载新版本。
仍须部署在 loopback 或可信 VPN 上；所有 API 与 WebSocket 均受 Token 和 Origin 检查保护。

下载

提供 Linux / macOS 的 amd64、arm64 独立可执行文件，均禁用 CGO，内嵌匹配版本前端。下载对应平台附件后使用 SHA256SUMS 校验完整性。

验证

GitHub Actions 在 Ubuntu 与 macOS 上均通过：格式检查、Go race、前端单元 37 项 / Chromium 组件 33 项及完整 E2E。
Linux amd64 附件实际运行：webmux version 输出 0.1.3，内嵌前端页面可访问，未带 Token 的 API 返回 401、带 Token 返回 200。
所有附件的构建元数据指向发布提交 9720225，工作区无未提交修改，CGO 禁用。
macOS 与 Linux ARM64 附件为交叉编译产物，未在对应平台运行本次附件。

WebMux v0.1.2

2026-10-14T16:07:17Z

更新内容

新增前端设置页，可调整会话预览显示行数和跳过末尾行数；默认显示 10 行、跳过末尾 1 行。设置保存在当前浏览器，提供效果示例和恢复默认。
终端顶栏新增上传按钮，支持选择文件、拖入文件、桌面粘贴剪贴板文件或图片。上传时显示百分比和进度条，支持取消，完成后自动隐藏进度。
上传成功后将服务器绝对路径粘贴到当前终端；文件名经过 shell 引号保护，不自动按回车。普通文本粘贴保留 xterm 的 bracketed paste 行为，支持原生 Ctrl+V / Cmd+V 与 Ctrl+Shift+V。
上传文件流式写入系统临时目录中的独立 webmux-upload-* 子目录，不写入工作区、不覆盖同名文件；失败、取消或会话退出时清理未完成文件。

使用与升级注意

单文件上限 100 MiB，上传期限 5 分钟。目录 / 文件权限为 0700 / 0600；成功文件保留供终端使用，由用户或系统临时目录策略清理，不自动随会话关闭删除。
剪贴板权限和可读取的文件类型取决于浏览器与操作系统；读取权限不足时可使用原生粘贴、上传按钮或拖拽。
预览 JSON 字段仍为 preview，服务端最多提供当前屏幕底部 100 条非空行，由浏览器按本地设置裁剪；前后端请一起升级。附件已内嵌匹配版本前端。
重启 WebMux 会结束现有终端会话；升级前请保存工作。仅替换磁盘上的二进制不会让正在运行的进程加载新版本。
仍须部署在 loopback 或可信 VPN 上；上传接口与其他 API 一样受 Token 和 Origin 检查保护。

下载

提供 Linux / macOS 的 amd64、arm64 独立可执行文件，均禁用 CGO。下载对应平台附件后使用 SHA256SUMS 校验完整性。

验证

Linux 下全量 Go race tests 通过；前端单元测试 25 项、Chromium 组件测试 22 项通过。
桌面 / Pixel 7 Chromium E2E 共 31 项通过、5 项按平台跳过，覆盖文件选择、拖拽、剪贴板图片 / 文件、普通文本粘贴和路径输入。
GitHub Actions 在 Ubuntu 与 macOS 上均通过：格式检查、Go race、前端单元 / Chromium 组件及完整 E2E 测试。
真实浏览器限速上传 2 MiB 文件，约 16 秒完成，观察到实际进度变化并核对了完整文件内容。
本次 Linux amd64 发布二进制实际运行验证了版本号、内嵌设置页与 HTTP 认证；所有附件的构建元数据均指向发布提交，CGO 禁用。
macOS 与 Linux ARM64 附件为交叉编译产物，未在对应平台运行本次附件。

WebMux v0.1.1

2026-10-14T14:26:10Z

更新内容

工作区界面统一使用 shadcn 组件：仓库分组、单层工作树卡片和会话列表行，减少嵌套边框。
会话行扩大点击范围，终端返回按钮使用 Tabler 图标；菜单操作保持独立。
已有本地分支改为可搜索、可滚动列表，保留占用限制和目标路径联动。
终端预览固定显示三行，依据当前屏幕底部三条非空行生成，正确处理光标重绘、擦行、清屏、主/备用屏幕切换和尺寸变化；不再把被覆盖的状态栏当作新增输出。
原始 PTY 输出、终端回放和输入协议不变；预览解析不向 PTY 发送输入或设备查询响应。

升级注意

会话 JSON 的 lastLine 已替换为 preview，前后端必须一起升级；附件中的二进制已内嵌匹配版本的前端。
重启 WebMux 会结束现有终端会话，升级前请保存工作。仅替换磁盘可执行文件不会使正在运行的进程加载新版本。
从源码构建需要 Go 1.24+；运行二进制不需要 Go 或 Node.js。

下载

提供 Linux / macOS 的 amd64、arm64 独立可执行文件，均禁用 CGO。下载对应平台文件后，使用 SHA256SUMS 校验完整性。

验证

Linux 环境下全量 Go race tests 通过。
前端单元测试 22 项、浏览器组件测试 22 项通过；桌面/移动端 E2E 共 25 项通过、3 项跳过。
真实 PTY 状态栏重绘后的预览与浏览器 xterm 屏幕一致，并验证了备用屏幕切换、恢复和清屏。
macOS 与 Linux ARM64 为交叉编译产物，未在对应平台运行验证。

WebMux v0.1.0

2026-10-14T13:05:17Z

首个发布，对应提交 3c8dd18。

单用户、可重连的 Web 终端。浏览器断开不会结束服务端 PTY；服务重启会结束会话。命令以服务用户身份运行，不是沙箱。不要暴露到公网；默认只监听 127.0.0.1:7681。

资产

CGO_ENABLED=0 静态二进制，运行端不需要 Node.js 或 Go。

文件	平台
`webmux-linux-amd64`	Linux x86_64
`webmux-linux-arm64`	Linux arm64
`webmux-darwin-amd64`	macOS Intel
`webmux-darwin-arm64`	macOS Apple Silicon

用 SHA256SUMS 校验。

chmod +x webmux-linux-amd64
./webmux-linux-amd64 version
./webmux-linux-amd64 --listen 127.0.0.1:7681

包含

持久 PTY、有界回放、共享 token 与 Origin 检查、WebSocket 重连
会话列表，shell / claude / codex / omp 预设与自定义启动命令
仓库清单与 git worktree 管理
桌面与移动端终端（触控滚动、软键）
Linux 与 macOS（amd64 / arm64）进程探测与清理
systemd 用户服务与 launchd 示例

安装与配置见仓库 README。