WebMux v0.9.0 release notes

更新内容

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 全部通过。