OpenSpec 规格索引
基于 main@306d253 的文档在 GitHub 上查看编辑此页
openspec/specs/ 下每个目录是一个 capability，spec.md 用 SHALL/MUST 描述它的现行需求。本页按主题列出全部 capability，让读者从 文档中心 沿链接找到每一份规格。
- 这里只收录已归档生效的主规格；在途变更位于
openspec/changes/<变更>/，由 OpenSpec 工作流管理，归档后并入对应 capability。 - 新增、拆分或改名 capability 时，在同一变更中更新本页；
internal/docguard会把没有链接到的规格报告为不可达。 - 规格描述“应当怎样”；功能用途与验收要点见 User Stories，工作流见 参与贡献。
- terminal-control：多设备同时打开同一会话时的唯一控制端与接管
- terminal-stream-resume：按输出 offset 与运行代际增量续接终端输出
- terminal-buffer-find：在保留的终端输出中查找、跳转与复制
- terminal-header：终端页顶栏在桌面与手机上的信息与操作收纳
- terminal-input-composer：统一的草稿模式输入入口
- terminal-draft-persistence：草稿在刷新、关页与认证失效后的本机恢复
- terminal-draft-scratch：每个会话的草稿暂存区
- terminal-submission-delivery：草稿与快捷指令可确认、不重复的送达语义
- terminal-quick-commands：在设置中保存并一键发送常用命令
- terminal-session-cli：
webmux run|attach|ls|open本机终端附着 - session-launch-environment：会话启动时的进程环境约定
- launch-configs：服务器持久化的启动配置（名称 + argv + 环境变量）
- session-artifacts：会话产物目录
Agent 状态与提醒
Section titled “Agent 状态与提醒”- agent-attention：依据 BEL、OSC 9/777 等信号判断 agent 需要介入
- program-status：识别 OSC 7501 Program Status Protocol 上报的运行状态
- attention-push：离开页面或锁屏后通过 Web Push 推送注意力事件
- push-notification-client：在本设备开启、关闭和测试推送
混合会话（ACP）
Section titled “混合会话（ACP）”- hybrid-sessions：同一段对话在聊天视图与原生 TUI 之间切换
- hybrid-agent-profiles：内置 agent 档案，负责识别、启动、恢复与中断
- hybrid-session-recovery：服务重启后恢复混合会话
- agent-session-identity：识别 TUI 端当前打开的 agent 会话
- acp-agent-connection：作为 ACP 客户端与 agent 子进程交互的协议边界
- acp-connector-availability：ACP 连接器（如 codex-acp）的可用性与安装提示
- chat-view：ACP 输出的对话界面
- chat-prompt-queue：回合进行中的多设备共享消息队列
- terminal-diff-review：在终端旁浏览工作树、完整文件与 Diff
- terminal-code-references：把文件、行或 Diff 片段引用插入终端
- code-image-preview：只读查看与对比图片
- code-markdown-preview：Markdown 预览、目录与文档内跳转
- code-document-preview：文档类文件预览
- code-popout-window：代码工作区弹出为独立窗口
- code-tree-drop-upload：拖放文件到资源管理器上传
仓库与工作树
Section titled “仓库与工作树”- repository-registry：独立于会话的持久仓库清单
- workspace-overview：按仓库分组的会话总览
- workspace-sessions：会话与仓库、工作树的关联
- worktree-lifecycle：发现、创建与清理 Git worktree
配置、状态与同步
Section titled “配置、状态与同步”- cli-config：客户端定位、检查与初始化配置
- effective-configuration：区分已配置值与运行中生效值
- server-settings-sync：主题、字号、预览等偏好的跨设备同步
- state-persistence：状态目录文件的统一存储、权限与有界解码
- persistence-governance：持久化清单、守卫与故障测试
服务运行与分发
Section titled “服务运行与分发”- cli-server-control：
webmux start|stop|status等服务控制命令 - server-local-api：同一用户本机客户端使用的本地 API
- server-runtime-record：可校验的本机运行时记录
- access-link：携带 Token 的访问链接
- release-distribution：一次标签发布产出全部平台二进制与校验和
- linux-packages：deb 与 rpm 安装包
- tunnel-exposure：通过 Cloudflare Tunnel 以 HTTPS 暴露到公网
- runtime-tunnel-control：运行期间开启或关闭公网隧道
- web-tunnel-settings：网页设置中的 Cloudflare Tunnel 管理
- tailscale-exposure：Tailscale Serve / Funnel 自动证书 HTTPS
- tailscale-web-settings：网页设置中的 Tailscale 状态与开关
Windows（WSL）
Section titled “Windows（WSL）”- windows-console-client：PowerShell / Windows Terminal 控制台客户端
- windows-installer：按用户安装的托盘安装程序
- windows-tray-host：常驻通知区域的托盘程序
- windows-tray-access：从托盘打开或复制访问链接
- windows-tray-forwarding：WSL 网络不可达时的托盘端口转发
- windows-tray-push-guidance：托盘中的手机推送前置条件提示
- windows-tray-server-compat：托盘与 WSL 中 webmux 的版本兼容判断
- windows-tray-tunnel：托盘一键开关公网隧道
- windows-tray-wsl-install：由托盘在 WSL 中安装同版本 webmux
- wsl-service-lifecycle：托盘在 WSL 中启动、监控与重启服务
- controller-service-layering：后端 Controller 与 Service 分层
- frontend-architecture-guard：前端架构检查入口