WebMux v0.2.0 更新说明
在 GitHub Release 查看与下载（外部链接）下载最新版本
更新内容
本版本加入 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，tagv0.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 校验值 |
完整变更：https://github.com/mzdluo123/webmux/compare/v0.1.10...v0.2.0