WebMux User Stories
基于 main@306d253 的文档在 GitHub 上查看编辑此页
本文从用户目的出发，描述 WebMux 当前各项功能用来做什么，并给出可观察的验收要点。适用于理解产品、评审变更和检查功能覆盖。
基线核对日期：2026-10-23（之后各次局部核对见核对记录）。范围为主分支 5195154 的实现，另含 US-N07–US-N08 所述的设置页公网访问说明与运行时隧道状态；OpenSpec 中只有规划、没有实现的内容不视为现有能力。验收要点描述行为契约，不代表本次已重新执行全部测试。
阅读约定与产品边界
Section titled “阅读约定与产品边界”- 使用者：通过桌面、手机或平板浏览器使用服务器上的 Shell、CLI agent 和其他终端程序的人。
- 部署者：安装、配置和维护自己的 WebMux 服务的人，通常也是使用者。
- 贡献者：开发、测试和发布 WebMux 的人；相关故事单独列在 L 节。
- WebMux 面向单用户，多设备连接仍共享同一服务用户的权限，不存在团队账号、成员角色或设备间文件隔离。
- 会话是服务端持有的 PTY 与进程；工作树是磁盘上的 Git worktree。浏览器断开不会结束会话，关闭会话不会删除工作树。
- 会话、终端缓冲和发送确认记录不是跨服务重启的持久数据（混合会话只持久化与 agent 会话的对应关系，见 Q 节）；仓库清单持久保存在服务端，草稿、暂存和显示偏好保存在当前浏览器。
- 本文不承诺进程沙箱、公网访问安全、文件编辑、自动 clone/fetch、自动安装 agent 或跨服务重启恢复终端。
- 故事编号保持稳定。新增功能应补充故事；改变行为时同步修改验收要点与相关测试，不因排序调整而重新编号。
| 分组 | 功能范围 | 故事编号 |
|---|---|---|
| A | 连接、认证、品牌标识与访问边界 | US-A01–US-A06 |
| B | 创建会话与选择启动位置 | US-B01–US-B08 |
| C | 会话总览、搜索与提醒 | US-C01–US-C14 |
| D | 终端操作、分屏、续接、多设备与生命周期 | US-D01–US-D15 |
| E | 剪贴板与文件上传 | US-E01–US-E07 |
| F | 草稿编写、保存与发送确认 | US-F01–US-F09 |
| G | 快捷指令 | US-G01–US-G06 |
| H | 手机、平板与触摸操作、慢速网络 | US-H01–US-H11 |
| I | 代码工作区、Diff、引用与文件操作 | US-I01–US-I19 |
| J | 仓库登记与 worktree 管理 | US-J01–US-J11 |
| K | 配置、运行与服务管理 | US-K01–US-K13 |
| L | 开发、验证与发布支持 | US-L01–US-L12 |
| M | 原生终端、CLI 与本机控制面 | US-M01–US-M08 |
| N | Cloudflare 公网隧道 | US-N01–US-N08 |
| O | Windows/WSL 托盘管理 | US-O01–US-O12 |
| P | Tailscale Serve / Funnel | US-P01–US-P07 |
| Q | 混合会话（聊天 ↔ 终端） | US-Q01–US-Q16 |
各分组的完整故事、验收要点与依据位于以下文件；故事编号与上方索引保持一致。
| 文件 | 分组 |
|---|---|
| 连接、启动与会话总览 | A–C |
| 终端、输入与移动端 | D–H |
| 代码工作区与工作树 | I–J |
| 配置、运行与贡献者工具 | K–L |
| 原生客户端、隧道与托盘 | M–P |
| 终端分屏用户故事 | D13–D14 |
| 网络压缩用户故事 | H10–H11 |
| 混合会话 | Q |
| 功能覆盖核对与后续维护 | 覆盖索引与维护约定 |
各次局部核对的记录（对应的故事、已运行的验证、范围限制）按日期存放在以下文件，条目按日期升序。新的核对记录追加到最新的文件，不要写回本文；超过文件上限时按“拆分过长文件”的办法按日期再拆。
| 文件 | 日期范围 |
|---|---|
| verification-log-2026-10-23-to-26 | 2026-10-23 至 2026-10-26 |
| verification-log-2026-10-27-to-31 | 2026-10-27 至 2026-10-31 |
| verification-log-2026-11 | 2026-11-01 至 2026-11-02 |