<div id="web-ui"></div>

# 网页界面

Web UI 界面 — 界面系统、指示点、附件处理、聊天轮次视觉，以及 GUI-agent 上下文流转。

- [`invariants.md`](invariants.zh.md) — 跨模块 UI 不变量清单（改相关模块前先过一遍）
- [`chat-transcript-follow.html`](chat-transcript-follow.zh.html) — 统一的转录跟随：发送、流式、跳到最新、会话切换与历史窗口共用一套附着/脱离策略
- [`chat-turn-visual-spec.html`](chat-turn-visual-spec.zh.html) — 聊天轮次视觉规范（执行时间线、文件修改摘要表面、手动函数运行和消息导航）；文件历史语义见[运行时权威设计](../runtime/operations/file-management.zh.html)
- [`tool-group-summary.html`](tool-group-summary.zh.html) — 折叠工具调用行的标题：摘要语法、+N −M 改动徽标、进行时文案，以及整轮摘要的取舍
- [`interaction-feedback.md`](interaction-feedback.zh.md) — 交互反馈 0ms 规则（乐观状态先行，数据后补）
- [`turn-occupancy.md`](turn-occupancy.zh.md) — 停止、发送队列与 session 槽位占用（在取消意图上释放）
- [`state-layer.md`](state-layer.zh.md) — Web 状态层：每个会话一个 store 实例，真正共享的数据留全局
- [`center-tabs-and-split-layout.html`](center-tabs-and-split-layout.zh.html) — 普通 tab 与复合分屏 tab 的生命周期、显示、持久化和跨窗口转移权威设计
- [`built-in-browser.html`](built-in-browser.zh.html) — 内置浏览器主页、浏览器 profile 导入、紧凑 History 与四入口新建 pane
- [`browser-extensions.html`](browser-extensions.zh.html) — 不支持 Chrome/Edge 扩展安装与管理的产品决策、保留的浏览器能力，以及旧扩展数据不执行也不自动删除的边界
- [`integrated-terminal.html`](integrated-terminal.zh.html) — 真实 PTY 终端与本机 Claude Code 直接启动入口
- [`composer-local-attachment-paths.html`](composer-local-attachment-paths.zh.html) — Composer 到模型上下文的本地附件路径保留规则
- [`composer-responsive-controls.html`](composer-responsive-controls.zh.html) — Composer 响应式控件及紧凑状态交互契约
- [`composer-tool-profile-menu.html`](composer-tool-profile-menu.zh.html) — 共享菜单文法上的选项（+）菜单；Tools 操作与 profile 二级菜单行为
- [`effort-picker.html`](effort-picker.zh.html) — 思考力度卡片：标题行的淡紫档位名与 `?` 帮助提示、中性刻度滑轨与最高档动态方格、滑块上的档位提示、"推荐"标注
- [`programs-source-categories.html`](programs-source-categories.zh.html) — Programs 分组与来源分类行为
- [`composer-interaction-modes.md`](composer-interaction-modes.zh.md) — Composer 交互模式
- [`attachment-handling.zh.html`](attachment-handling.zh.html) — 完整附件设计：存储、执行准入、内容交付、恢复与验收
- [`chat-attachments.html`](chat-attachments.zh.html) — 聊天附件双向流转：聊天流里显示成什么、agent 怎么把文件交回来、可读文件怎么点开
- [`gui-agent.html`](gui-agent.zh.html) — GUI agent 入口、状态机、结果契约与实现状态
- [`agent-control-overlay.html`](agent-control-overlay.zh.html) — agent 控制窗口或网页时画在上方的状态胶囊和指针：位置、文案、动效、强调色与输入安全
- [`indicator-dots.md`](indicator-dots.zh.md) — 指示点
- [`git-folder-pills.md`](git-folder-pills.zh.md) — 输入框里每个目录的 git 胶囊：分支、修改计数、切分支、worktree、PR
- [`hover-tips.md`](hover-tips.zh.md) — 输入框区域悬停提示：统一的 `HoverTip` + `TipBody`，标题带当前值，浅色细节行
- [`icons.md`](icons.zh.md) — 图标体系：哪一族用在哪里（输入框区域 Solar、外壳动效线性图标、其余 lucide）、动效约定、署名
- [`surface-system.md`](surface-system.zh.md) — Surface 系统
- [`theme-system.html`](theme-system.zh.html) — 主题入口、完整 token 契约、组件消费与桌面浮层传播的权威设计
- [`settings-collapsible-columns.html`](settings-collapsible-columns.zh.html) — 应用主侧栏与 Settings 分类栏的独立 49px 折叠；Provider 列表始终展开，搜索框通栏
- [`avatar-randomization.html`](avatar-randomization.zh.html) — Agent/用户共用的头像选择器：先选类型，再进入同风格变体或字母字段
- [`web-styles.md`](web-styles.zh.md) — Web 样式组织（一个组件一个文件，目录对齐组件树）
- [`window-state.md`](window-state.zh.md) — 桌面窗口普通尺寸、最大化/全屏与标题栏缩放命中
- [`window-lifecycle.md`](window-lifecycle.zh.md) — 一个主窗口：启动、Dock、二次启动共用同一次创建
