WebMux 文档中心

这里是所有文档的入口，按“你想做什么”分组。每份文档都能从本页或 AGENTS.md 沿链接找到，make docs-check 会拒绝无法到达的文档与失效链接（规则见 文档治理）。

了解 WebMux

• 项目介绍：定位、设计理念、全部特性、混合会话概览与技术栈。
• User Stories：每项功能的用户目的与验收要点，适合评审和查找“某个功能能做什么”。
• 常见问题与获取帮助：常见疑问、排障入口与反馈渠道。

安装与部署

• 部署指南：总索引。
  • 安装与升级：一键脚本、deb / rpm、手动下载与升级。
  • 配置：命令行参数、配置项与状态目录。
  • 服务管理与平台差异：systemd / launchd、agent 的 PATH。
  • 远程访问与 HTTPS：手机访问、访问链接、HTTPS。
  • 安装为应用与手机推送：PWA 与 Web Push。
  • Windows（WSL）部署：托盘、控制台客户端与故障诊断。
• Cloudflare Named Tunnel 配置指南：固定的 HTTPS 公网入口。
• Tailscale Serve / Funnel：自动证书的 tailnet / 公网入口。
• 安全策略：安全模型、支持的版本与漏洞报告。

日常使用

• 使用指南：会话、新建会话、后台启动、终端附着、草稿、代码工作区、仓库与 worktree、移动端。
  • 终端使用：查找、分屏、复制粘贴、终端图形与文件上传。
• 混合会话：OpenCode / omp / Codex CLI / Claude Code 在聊天视图与终端间切换。
• CLI agent 接入：预置的九款 CLI agent 启动配置与提醒。

开发与架构

• 参与贡献：开发环境、常用命令、测试、PR 与 OpenSpec 工作流。
• 架构设计：会话模型、缓冲与回放、状态探测、分层规则 R0–R10。
• API 与协议：REST、WebSocket 帧与错误码（按主题分页）。
• 配置与持久化清单：状态目录中每类文件的格式与治理。
• OpenSpec 规格索引：按主题列出 openspec/specs/ 下的全部 capability。
• 代码规范：Go、前端、前端架构守卫。
• 界面：设计系统、Storybook 与防溢出测试。

性能与质量

• 布局稳定性与 4× CPU 回归：性能测试的测量方式与阈值。
• 页面性能与连接稳定性验证：页面加载与重连的实测记录。
• 内嵌二进制体积：发布二进制的体积对比。
• CI 耗时优化与验收：CI 墙钟时间的优化记录。
• 产品能力 baseline：可复现评测、统计口径与量化结果。

文档与 Agent 规则

• 文档治理：文档规模、链接可达性与 README 预算。
• Agent 规则：从 AGENTS.md 迁出的仓库地图、约定、测试与 User Stories 维护规则。