--- schema: development/ui_resource schema_version: 1 type: ui_resource status: active domain: development category: ui_library name: Claude Design System (CDS) source: /Applications/Claude.app (v1.28 Production) verified_at: 2026-10-14 created_at: 2026-10-13 updated_at: 2026-10-14 stack: - react - tailwindcss - framer-motion - variable-fonts effect_type: - design-system - chat-ui - spring-physics - variable-fonts tags: - knowledge/development - dev/ui - reverse-engineering - claude - design-system --- # Claude Design System (CDS) 前端 UI 与动效完整开发指导手册 > **版本**:1.0 (基于 Claude Desktop `/Applications/Claude.app` 生产环境全量逆向分析) > **逆向框架**:全流程依托 **[REA (Reverse Engineer Anything)](https://github.com/morluto/rea)** 完成 Vite/Rollup AST 反混淆、运行时行为追踪与 ASAR 资源解包。 > **定位**:供前端工程师、UI 设计师与独立开发者像素级复刻 Claude 质感与交互的完整工程指导规范。 > **技术栈适配**:HTML5 + Tailwind CSS v3/v4 + React/Vue + Framer Motion (或原生 CSS) --- --- ## 目录 1. [第一篇:设计哲学与设计令牌体系](#第一篇设计哲学与设计令牌体系) - [1.1 设计哲学与视觉调性](#11-设计哲学与视觉调性) - [1.2 表面体系与色彩阶梯](#12-表面体系与色彩阶梯) - [1.3 控件尺寸与精密圆角矩阵](#13-控件尺寸与精密圆角矩阵) - [1.4 发丝细边、微光阴影与边框防臃肿体系](#14-发丝细边微光阴影与边框防臃肿体系) - [1.5 字体排版与图标对齐系统约束](#15-字体排版与图标对齐系统约束) - [1.6 基础动效令牌体系与物理贝塞尔曲线全集](#16-基础动效令牌体系与物理贝塞尔曲线全集) 2. [第二篇:基础原子组件与交互控件](#第二篇基础原子组件与交互控件) - [2.1 全能按钮控件阶梯](#21-全能按钮控件阶梯) - [2.2 分段滑动选择胶囊](#22-分段滑动选择胶囊) - [2.3 状态指示灯与微动效套件](#23-状态指示灯与微动效套件) - [2.4 模态确认对话框](#24-模态确认对话框) - [2.5 附件磁贴与上下文胶囊](#25-附件磁贴与上下文胶囊) 3. [第三篇:会话核心流与指令交互引擎](#第三篇会话核心流与指令交互引擎) - [3.1 会话气泡套件与排版规范](#31-会话气泡套件与排版规范) - [3.2 思考过程折叠与时间状态机](#32-思考过程折叠与时间状态机) - [3.3 新一代富文本输入框终端与指令交互引擎](#33-新一代富文本输入框终端与指令交互引擎) - [3.4 模型矩阵切换器与 Token 计量仪表盘](#34-模型矩阵切换器与-token-计量仪表盘) - [3.5 交互式工具调用与 MCP 决策卡片](#35-交互式工具调用与-mcp-决策卡片) 4. [第四篇:动效物理学、着色器与环境光影](#第四篇动效物理学着色器与环境光影) - [4.1 全量动效引擎与关键帧规范](#41-全量动效引擎与关键帧规范) - [4.2 动态光效、着色器与推理氛围感](#42-动态光效着色器与推理氛围感) - [4.3 滚动边缘平滑渐变遮罩系统](#43-滚动边缘平滑渐变遮罩系统) 5. [第五篇:视听多媒体与产物交互物理学](#第五篇视听多媒体与产物交互物理学) - [5.1 语音模式与 Web Audio 物理声学系统](#51-语音模式与-web-audio-物理声学系统) - [5.2 多模态媒体查看器与画廊转场物理学](#52-多模态媒体查看器与画廊转场物理学) - [5.3 双栏弹性分割与折叠物理学](#53-双栏弹性分割与折叠物理学) - [5.4 工件预览沙箱与隔离通信架构](#54-工件预览沙箱与隔离通信架构) - [5.5 代码差异对比与多线程语法高亮系统](#55-代码差异对比与多线程语法高亮系统) 6. [第六篇:系统级桌面架构与协作拓扑](#第六篇系统级桌面架构与协作拓扑) - [6.1 macOS 桌面宿主深度融合与窗口材质](#61-macos-桌面宿主深度融合与窗口材质) - [6.2 侧边栏会话拖放重排与拓扑网格](#62-侧边栏会话拖放重排与拓扑网格) - [6.3 多代理协作看板与 Cowork 空间拓扑](#63-多代理协作看板与-cowork-空间拓扑) - [6.4 流式大文本输出与滚动视口物理学](#64-流式大文本输出与滚动视口物理学) - [6.5 容器查询自适应排版与极端防挤压](#65-容器查询自适应排版与极端防挤压) - [6.6 全键盘盲操网格与无障碍访问](#66-全键盘盲操网格与无障碍访问) - [6.7 异常容灾、模型限流与业务状态机](#67-异常容灾模型限流与业务状态机) - [6.8 Broker-Replica 多窗口主从渲染架构与写锁仲裁](#68-broker-replica-多窗口主从渲染架构与写锁仲裁) 7. [第七篇:工程配置与资产代码库总览](#第七篇工程配置与资产代码库总览) - [7.1 开箱即用的 Tailwind 配置与基础 CSS 代码](#71-开箱即用的-tailwind-配置与基础-css-代码) - [7.2 生产级工程源码清单](#72-生产级工程源码清单) - [7.3 资产规范与系统级字体/音频替代方案](#73-资产规范与系统级字体音频替代方案) - [7.4 现代底层运行时架构:Rolldown、WASM 矩阵与 Clarkdown 编译器](#74-现代底层运行时架构rolldownwasm-矩阵与-clarkdown-编译器) - [7.5 宿主桥接与别名映射规范](#75-宿主桥接与别名映射规范) 8. [第八篇:AI Agent 前端 UI 与动效开发指南](#第八篇ai-agent-前端-ui-与动效开发指南) - [8.1 Agent 角色定位与设计哲学](#81-agent-角色定位与设计哲学) - [8.2 设计令牌与色彩引用契约](#82-设计令牌与色彩引用契约) - [8.3 动效物理学:四套弹簧预设决策树](#83-动效物理学四套弹簧预设决策树) - [8.4 控件原子规则与单闭合边框原则](#84-控件原子规则与单闭合边框原则) - [8.5 交互防御与边缘场景守卫](#85-交互防御与边缘场景守卫) - [8.6 生产级组件库快速装配指南 (30 模块)](#86-生产级组件库快速装配指南-30-模块) - [8.7 智能体自检与质量门禁清单](#87-智能体自检与质量门禁清单) 9. [Claude Desktop 2.0 (v2.37337.1) 全量版本更新深度逆向分析与 CDS 2.0 架构演进报告](#claude-desktop-20-v2373371-全量版本更新深度逆向分析与-cds-20-架构演进报告) - [1. 综述](#1-综述) - [2. 新增](#2-新增) - [3. 重构](#3-重构) - [4. 底座解密](#4-底座解密) - [5. 参考实现](#5-参考实现) - [6. 总结](#6-总结) --- ## 第一篇:设计哲学与设计令牌体系 > **技术领域与英文指代**:`Design Philosophy & Design Tokens` ### 1.1 设计哲学与视觉调性 Claude 的界面设计在当下 AI 产品中独树一帜,其核心调性可以总结为三点: 1. **温润的人文质感(Editorial Warmth)**: - 彻底摒弃冰冷的高饱和赛博朋克蓝/紫色,主品牌色选用温润的**陶土色(Clay: `#d97757`)**与柔和米白/暗灰底色(`#fcfcfb` / `#151515`)。 2. **多层微对比表面(Low-contrast Surface Layering)**: - 界面几乎不使用生硬的 1px 黑色边框,而是通过 `Surface 0 - 3` 的层级微小明度差以及 `color-mix()` 半透明外环投影来建立空间感。 3. **高帧率轻负担动效(Lightweight Organic Motion)**: - 文字流式输出使用 GPU 硬件加速的模糊消解,复杂展开使用 CSS Grid 0fr 解决高度抖动,手势交互使用真实的阻尼弹簧。 --- ### 1.2 表面体系与色彩阶梯 > **技术领域与英文指代**:`Surfaces & Colors` 依据 REA (Reverse Engineer Anything) v6.5.0 对生产构建包 `c6a992d55-sXiDGMFQ.css` 的全量 AST 审计,Claude 并非使用孤立的零散色值,而是建立在**完整的 35 阶灰度标尺(`--cds-gray-0` 至 `--cds-gray-900`)**与**35 阶橙色标尺(`--cds-orange-0` 至 `--cds-orange-900`)**之上的高精密光学投影体系。 ```mermaid graph TD S0["Surface 0: 侧边栏/底基层 (Canvas)"] S1["Surface 1: 页面主背景画布 (Chat Page)"] S2["Surface 2: 独立面板/卡片表面 (Cards)"] S3["Surface 3: 输入框/悬浮弹窗/最高层 (Overlays)"] S0 --> S1 --> S2 --> S3 ``` | 令牌名称 | 浅色模式 (Light) | 深色模式 (Dark) | 真实绑定 Token | 用途说明 | | :--- | :--- | :--- | :--- | :--- | | `--cds-surface-0` | **`#f9f9f7`** | **`#0b0b0b`** | `var(--cds-gray-20)` / `var(--cds-gray-900)` | 侧边栏底色、窗口背景根底 | | `--cds-surface-1` | **`#fcfcfb`** | **`#151515`** | `var(--cds-gray-10)` / `var(--cds-gray-850)` | 页面主聊天画布背景 | | `--cds-surface-2` | **`#ffffff`** | **`#1a1a19`** | `var(--cds-gray-0)` / `var(--cds-gray-830)` | 对话消息容器、卡片表面 | | `--cds-surface-3` | **`#ffffff`** | **`#20201f`** | `var(--cds-gray-0)` / `var(--cds-gray-800)` | 聊天输入框容器、高亮浮层 | | `--brand` | **`#c6613f`** | **`#c6613f`** | 桌面端全局生产主品牌色 | 官方桌面端主品牌色 | | `--cds-clay` | **`#d97757`** | **`#d97757`** | 品牌陶土主色 | 思考脉冲点、火花图标回退色 | | `--cds-clay-emphasized` | **`#cc5a36`** | **`#cc5a36`** | 陶土色悬停加重态 | 悬停态加深交互色 | | `--cds-border` | `hsla(0, 0%, 8%, 0.10)` | `hsla(0, 0%, 100%, 0.09)` | `var(--cds-alpha-2)` | 通用柔和边框 | | `--cds-border-strong` | `hsla(0, 0%, 8%, 0.20)` | `hsla(0, 0%, 100%, 0.18)` | `var(--cds-alpha-3)` | 控件外环、激活边框 | > [!TIP] > **Anthropic 暗色模式 2-Level 等距步进律(OLED Anti-Banding)**: > REA 逆向表明,Claude 深色表面严格遵守十六进制等距步进: > `--cds-gray-800` (`#20201f`) $\to$ `810` (`#1e1e1d`) $\to$ `820` (`#1c1c1b`) $\to$ `830` (`#1a1a19`) $\to$ `840` (`#181817`) $\to$ `850` (`#151515`) $\to$ `860` (`#131313`) $\to$ `870` (`#111111`) $\to$ `880` (`#0f0f0f`) $\to$ `890` (`#0d0d0d`) $\to$ `900` (`#0b0b0b`)。 > 每一阶明度均精确下沉 2 个 HEX 单位,彻底消除了 OLED 屏幕上的灰阶断层色斑。 --- ### 1.3 控件尺寸与精密圆角矩阵 > **技术领域与英文指代**:`Border Radius, Heights & Sizing` #### 1.3.1 圆角阶梯体系 (Border Radius Hierarchy) 在生产构建样式中,完整圆角令牌与嵌套公式如下: | 令牌名称 / 变量 | 精确像素 | 对应 Tailwind 类 | 角色语义与典型组件 | | :--- | :--- | :--- | :--- | | `--radius-xs` | **2px (`.125rem`)** | `rounded-[2px]` | 微型角标、聚焦环内衬指示点 | | `--radius-sm` (`--cds-keycap-radius`) | **4px (`.25rem`)** | `rounded` | 快捷键徽章 (`Kbd`)、微型标签、复选框 | | `--radius-md` | **6px (`.375rem`)** | `rounded-md` | 极小尺寸按钮 (XS 26px)、Prompt 建议胶囊 | | `--radius-lg` | **8px (`.5rem`)** | `rounded-lg` | **标准按钮 (SM/MD)、表单输入框、下拉菜单项** | | `--cds-panel-radius` | **10px** | `rounded-[10px]` | 子面板卡片、上传文件附件条目 (`.cds-attachment`) | | `--radius-xl` | **12px (`.75rem`)** | `rounded-xl` | 代码块容器、Artifact 预览卡片、抽屉面板 | | `--radius-2xl` | **16px (`1rem`)** | `rounded-2xl` | 系统弹窗模态框 (`ConfirmationDialog`)、设置卡片 | | `--cds-message-bubble-radius` | **18px** | `rounded-[18px]` | **用户发送的消息气泡 (`User Message Bubble`)** | | `--cds-radius-composer` | **20px** | `rounded-[20px]` | **底部常驻聊天输入框 (`Chat Composer Box`)** | | `--radius-card` | `calc(var(--cds-radius) + 4px * scale)` | `rounded-card` | **卡片自适应嵌套同心圆角(动态响应缩放因子)** | | `--df-radius-pill` | **999px** | `rounded-full` | 分段滑动滑块 (`Segmented Control`)、状态呼吸点 | > [!IMPORTANT] > **REA v6.5.0 取证:自适应嵌套同心圆角公式**: > ```css > --radius-card: calc(var(--cds-radius) + calc(.25rem * var(--cds-rem-scale, 1))); > ``` > 在 Claude 中,卡片外圈曲率严格绑定内部 `--cds-radius` 加上 `.25rem * --cds-rem-scale`,从而在用户缩放页面或调整辅助功能大字号时,内外角曲率永远保持平滑同心。 --- #### 1.3.2 控件高度与排版尺寸 (Heights & Sizing) | 令牌名称 | 高度定义 | 实际像素 | 对应组件 | | :--- | :--- | :--- | :--- | | `--cds-h-control--xs` | `1.25rem - 1.5rem` | **20px - 24px** | 极小按钮、标签关闭按钮、行内操作栏 | | `--cds-h-control--sm` | `1.5rem - 1.75rem` | **24px - 28px** | 紧凑型按钮、下拉选择器触发器 | | `--cds-h-control` (默认) | `2rem` | **32px** | **标准交互按钮、输入框内操作图标、Tab 导航项** | | `--cds-h-control--lg` | `2.5rem` | **40px** | 强调大按钮、登录/注册主操作按钮 | | `--df-titlebar` | 固定 `46px - 48px` | **46px - 48px** | 桌面端无边框窗口顶部拖拽条(Titlebar) | | `--static-sidebar-width` | `18rem` | **288px** | 桌面端常驻侧边栏宽度 | | `--chat-max-width` | `42rem / 48rem` | **672px - 768px** | 最佳阅读体验的中心对话宽度(`max-w-2xl / max-w-3xl`) | | `--composer-max-height` | `24rem` | **384px** | 输入框内容自动撑开的最大高度(超出滚动) | --- --- ### 1.4 发丝细边、微光阴影与边框防臃肿体系 > **技术领域与英文指代**:`Borders, Hairlines & Shadows` #### 1.4.1 边框粗细系统、发丝细边与微光阴影阶梯 在很多仿 Claude 的产品中,“视觉廉价感”几乎 100% 来自**边框过粗过硬**与**阴影单层死黑**。Claude 桌面端对此构建了极端精密的物理光学规则: #### 1. 边框大小阶梯与视网膜高分屏发丝细边规范 (Border Width & Retina Hairline) 在视网膜高分屏(MacBook Retina `@2x/@3x`)上,标准的 `1px` 边框在物理像素上实际占据了 2 到 3 个物理发光点,视觉感受极其厚重笨拙。Claude 借助媒体查询与内阴影轮廓技术实现了真正的动态发丝细边: | 边框级别 | 规格定义 | 对应工程 Token / 实现 | 核心承载组件与场景 | | :--- | :--- | :--- | :--- | | **0.5px 发丝细边 (Hairline)** | `@media (resolution >= 2x) { 0.5px }` | `--cds-ring-hairline` / `box-shadow: 0 0 0 0.5px var(--cds-border)` | 表格行间分割线、未激活分段 Tab 缝隙、次级辅助标签微标、极细胶囊底衬 | | **1.0px 基础结构边框** | 标准 `1px` (10% Alpha) | `--cds-border: var(--cds-alpha-2);` (`hsla(0, 0%, 8%, 0.1)`) | 卡片面板主体、输入框常态外轮廓、顶栏底部分割线、浮动弹窗基础边界 | | **1.5px 激活指示边框** | `1.5px` (Accent Ring) | `box-shadow: inset 0 0 0 1.5px currentColor;` | 分段滑动胶囊激活项边缘、当前选中状态指示器、表单单选/复选被选中轮廓 | | **2.0px 焦点与吸附高亮** | `2.0px` (Focus Ring & Glow) | `--cds-shadow-drop-ring: inset 0 0 0 2px var(--cds-clay);` | 文件拖拽悬停至输入框吸附光晕、键盘 Tab 导航可访问性聚焦高亮圈 | ```css /* 提取自 c6a992d55-C0zTICcS.css 发丝细边与透明度层级 */ :root { --cds-alpha-0: hsla(0, 0%, 8%, 0); --cds-alpha-1: hsla(0, 0%, 8%, 0.05); /* 幽灵按钮悬浮、骨架屏、禁用态 */ --cds-alpha-2: hsla(0, 0%, 8%, 0.10); /* 标准边框 (--cds-border)、次级填充 */ --cds-alpha-3: hsla(0, 0%, 8%, 0.20); /* 强对比边框 (--cds-border-strong)、控件悬浮 */ --cds-alpha-4: hsla(0, 0%, 8%, 0.35); /* 重分割线 */ --cds-border: var(--cds-alpha-2); --cds-border-strong: var(--cds-alpha-3); --cds-ring-hairline: 1px; } /* 视网膜高分屏发丝细边微调 */ @media (-webkit-min-device-pixel-ratio: 2), (min-resolution: 2dppx), (resolution >= 2x) { :root { --cds-ring-hairline: 0.5px; } } @media (-webkit-min-device-pixel-ratio: 3), (min-resolution: 3dppx), (resolution >= 3x) { :root { --cds-ring-hairline: calc(1px / 3); } } ``` > [!TIP] > **为什么 Claude 极少使用 CSS `border: 1px solid ...`?** > 因为传统 CSS `border` 会计入元素的盒模型排版尺寸,在动态切换激活/未激活状态时易引发微观的“1px 尺寸抖动与重排”。Claude 大量采用 `box-shadow: inset 0 0 0 1px ...` 或 `box-shadow: 0 0 0 1px ...` 代替边框,完全脱离盒模型排版计算,实现 0 抖动的顺滑物理过渡。 --- #### 2. 生产级四层环境光扩散阴影阶梯 (4-Tier Ambient & Elevation Shadow System) Claude 彻底摒弃单一维度的模糊阴影,全量采用**【近距微遮蔽 (Ambient Occlusion)】+【远距深层漫反射 (Elevation Diffusion)】**双层复合公式: | 阴影层级 (Token) | 浅色模式投影参数 (Light) | 深色模式投影参数 (Dark) | 核心承载业务场景 | | :--- | :--- | :--- | :--- | | **`--cds-shadow-sm`** | `0 1px 2px 0 rgba(0,0,0,0.05), 0 2px 8px 0 rgba(0,0,0,0.08)` | `0 1px 2px 0 rgba(0,0,0,0.40), 0 2px 8px 0 rgba(0,0,0,0.40)` | 卡片面板底衬、附件卡片基础立体感,防止纯扁平生硬 | | **`--cds-shadow-md`** | `0 2px 4px 0 rgba(0,0,0,0.05), 0 6px 16px 0 rgba(0,0,0,0.08)` | `0 2px 4px 0 rgba(0,0,0,0.40), 0 6px 16px 0 rgba(0,0,0,0.40)` | 卡片 Hover 悬浮抬升态、模型选择下拉菜单、折叠面板展开 | | **`--cds-shadow-lg`** | `0 4px 8px 0 rgba(0,0,0,0.06), 0 12px 28px -2px rgba(0,0,0,0.08)` | `0 4px 8px 0 rgba(0,0,0,0.50), 0 16px 36px -2px rgba(0,0,0,0.40)` | 全局模态确认弹窗 (Modal Dialog)、全屏工件预览抽屉 | | **`--cds-shadow-popover`** | `inset 0 0 0 0px transparent, 0 0 0 1px var(--cds-border), 0 8px 24px rgba(0,0,0,0.12), 0 2px 6px rgba(0,0,0,0.08)` | **`inset 0 0 0 1px rgba(255,255,255,0.10)`**`, 0 0 0 0px transparent, 0 8px 28px rgba(0,0,0,0.65), 0 2px 8px rgba(0,0,0,0.45)` | 右键上下文菜单、快捷指令气泡、富文本操作条 | | **`--cds-panel-shadow`** | `0 0 0 1px var(--cds-border), var(--cds-shadow-sm)` | `0 0 0 1px var(--cds-border), var(--cds-shadow-sm)` | 标准独立面板外壳(边框与微阴影一体化绑定) | #### 3. 双环浮动气泡架构(Dual-Ring Architecture)的光学奥秘 请格外注意 `--cds-shadow-popover` 在浅色与深色模式下的质感差异: * **浅色模式**:外环为 `0 0 0 1px var(--cds-border)`,提供一层细致的外边缘包围线,结合向下落差 8px 的柔和漫反射。 * **深色模式(倒角高光逆转!)**:外轮廓变为 `0px`(消除黑底上突兀的白框),同时在内侧增加 `inset 0 0 0 1px rgba(255, 255, 255, 0.10)`!这一行如同真实物理世界中**边缘倒角捕捉到顶光所产生的一道微弱反光**,既凸显了浮层的立体轮廓,又完全没有多余的边框感! --- #### 4. 聊天输入框双环投影公式(Composer Dual-Ring Shadow) 输入框是 Claude 最具标志性的界面灵魂: ```css /* 常态(Resting 未聚焦) */ box-shadow: 0 4px 20px rgba(0, 0, 0, 0.035), inset 0 0 0 1px var(--cds-border); /* 鼠标悬停态(Hover) */ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.06), inset 0 0 0 1px var(--cds-border-strong); /* 聚焦态(Focus-Within) */ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.08), inset 0 0 0 1px var(--cds-border-strong), 0 0 0 1px var(--cds-border-strong); ``` #### 5. 全局交互焦点环(Triple-Layer Focus Ring) 当用户通过键盘或点击激活交互控件时,Claude 绝不使用操作系统刺眼的默认蓝色外框,而是渲染专有的三层陶土高亮环: ```css --cds-focus-shadow: inset 0 0 0 1px var(--cds-surface-1), /* 第一层:1px 隔离垫片,隔开控件与光晕 */ 0 0 0 1.5px var(--cds-clay), /* 第二层:1.5px 陶土品牌色主聚焦环 */ 0 0 6px 1px rgba(217, 119, 87, 0.25); /* 第三层:柔和外扩的陶土环境漫射光晕 */ ``` --- #### 6. 全交互 Hover 态与微反馈物理规范 (Interactive Hover & Micro-Feedback) Claude 的交互反馈极度顺滑克制,遵循“有感知但不喧宾夺主”的微动效原则: 1. **幽灵按钮悬浮与按压(Ghost Button Feedback)**: * **常态**:背景完全透明,文字为次级弱灰 (`var(--cds-text-secondary)`)。 * **悬浮态 (Hover)**:背景在 **150ms 贝塞尔曲线** (`cubic-bezier(0.16, 1, 0.3, 1)`) 内渐变至 5% 灰度底衬 (`var(--cds-fill-ghost-hover)`),文字点亮为 Primary 主色。 * **按压态 (Active Press)**:触发 `scale(0.98)` 轻量回弹压感,底衬加深至 10% 灰度 (`var(--cds-fill-ghost-selected)`)。 2. **卡片物理抬升 (Card Elevation Y-Lift)**: * **常态**:平铺于画布,呈现 `--cds-panel-shadow`。 * **悬浮态 (Hover)**:向上物理抬升 `transform: translateY(-1.5px)`,同时阴影平滑过渡至 `--cds-panel-shadow-hover`,边框变深至 `--cds-border-strong`。 * **离开态**:顺滑落回原始位置,无硬弹跳。 3. **浮动菜单行高亮 (Dropdown Row Highlight)**: * 鼠标滑过菜单项时,背景瞬间点亮为带有 `4px` 圆角(`var(--radius-sm)`)的轻量高亮胶囊,行内图标与快捷键同步点亮。 4. **拖拽吸附光晕 (Drag & Drop Target Glow)**: * 拖拽文件接近输入框时,输入框内侧触发 `inset 0 0 24px -2px rgba(217, 119, 87, 0.20)` 陶土呼吸辉光,并伴随 `inset 0 0 0 2px var(--cds-clay)` 吸附圈。 --- #### 1.4.2 边界哲学与边框防臃肿体系 (Borders vs. Borderless Architecture) 在现代 Web 前端与大模型 UI 生成中,**“套娃边框(Russian-Doll Borders)”是导致界面臃肿、沉重、业余的最普遍元凶**。很多模型在生成前端界面时,机械地将产品需求中的“视觉分组”直接等价为 CSS `border border-neutral-200`,造成卡片嵌套卡片、消息套线框、工具栏套线框、输入框内部的每一个按钮再套一层线框,视线被无数条灰色线条切割得支离破碎。 Claude Desktop 之所以呈现出极具高级感、通透呼吸感的杂志排版质感,核心在于一套严密的**边界极简与表面微对比架构**: #### 1. 核心黄金准则:单闭合边框原则 (The 1-Border Rule) * **视线深度控制**:在从屏幕主画布向内穿透的任何一条视线路径上,**至多只能穿过 1 层闭合的矩形边框**。 * **容器内自动降级协议**:一旦外层容器已经是一个带边框的物理实体(如 Chat Composer、Modal 弹窗、Code Block 代码块),其内部包含的所有子控件(按钮、输入区、标签、工具条)**严禁再次使用闭合边框**: * **Secondary 按钮**:严禁写成 `border border-neutral-300`,必须使用基于 Surface-2 的柔和填充(`bg-neutral-100 hover:bg-neutral-200/80 dark:bg-neutral-800 border-0`)。 * **工具栏按钮与内联操作**:必须降级为 `Ghost` 变体(常态完全透明 `bg-transparent border-0`,悬停时仅展现微弱背景 `hover:bg-neutral-100/70`)。 * **内部输入框**:Composer 内部的文字输入域完全去除原生边框与高亮环(`border-0 outline-none ring-0 bg-transparent`)。 #### 2. 组件边界授权决策树 (The Boundary Decision Matrix) | 边界类型 | 授权准则 | 典型生产组件 | CSS 实现规范 | | :--- | :--- | :--- | :--- | | **🚫 坚决无边框 (Strictly Borderless)** | 依靠留白、文字层级或纯背景色聚合,杜绝描边线条阻隔阅读流动 | • **AI 助手回复正文**
• **用户消息气泡 (`#f0f4f8`)**
• 容器内的所有次级操作按钮
• 侧边栏/导航条目
• 消息底部 Reaction 反馈条
• 思考链展开文本 | `border-0`
`bg-transparent` 或 `bg-[#f0f4f8] rounded-[18px]` | | **📦 必须具备闭合外框 (Mandatory Closed Border)** | 自成一体、具备独立交互物理沙盒、实体化对象或跨越 Z 轴的浮层 | • **常驻聊天输入框 (Composer)**
• **语法高亮代码块 (Code Sandbox)**
• **独立文件附件卡片 (`.cds-attachment`)**
• **Artifact 独立产物卡片**
• **模态弹窗对话框 (`Dialog`)**
• 右键上下文菜单 (`ContextMenu`) | `border border-neutral-200/90 dark:border-neutral-800`
结合弥散双层投影 | | **➖ 单向细线替代原则 (Hairline Divider)** | 容器内部结构划分,严禁使用闭合方框套娃,严格采用 1px 单向细线 | • 代码块顶部语言栏与代码区中缝 (`border-b`)
• 下拉菜单与上下文菜单的功能组隔离 (`border-t`)
• 桌面端左右分栏中缝 (`border-r`)
• Composer 输入区与底部工具栏中缝 (`border-t`) | `border-b border-neutral-200/60`
或 `border-t border-neutral-100` | | **🌓 深色模式物理倒角 (Dark Mode 0.5px Chamfer)** | 深色背景下 1px solid 白色会产生刺眼的荧光感,改用内嵌阴影模拟工业硬件高光倒角 | • 所有深色模式卡片、代码块与浮层外边缘 | `box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.08);`
或 `color-mix(in srgb, var(--cds-border) 30%, transparent)` | #### 3. 常见“套娃边框”重构对比范例 ##### 反模式(AI 模型常见臃肿生成): ```html

回复文本

``` ##### 正模式(Claude 生产级标准): ```html

回复文本

``` #### 4. 滚动驱动渐隐遮罩系统 (Scroll-Driven 28px Fade System) 在会话流与代码块滚动时,传统前端常常简单覆盖一个纯透明度渐变层,导致文字在顶底硬生生被“切断”。REA v6.5.0 在生产包中提取到了 Claude 的**滚动时间轴驱动遮罩(Scroll-Driven Fade)**完整规范: * **核心物理宽度**:`--cds-scroll-fade-size: 28px;`(严格定义为 28px,非近似的 24px 或 32px)。 * **四阶非线性相对色彩羽化(4-Stop Relative Color Fade)**: 遮罩并非纯色,而是使用现代 CSS `color-mix()` 与 `rgb(from ...)` 动态提取当前背景色进行 4 档非线性递减: ```css /* 提取自 c6a992d55-sXiDGMFQ.css 真实生产定义 */ --cds-scroll-fade-mask: linear-gradient( to bottom, var(--cds-scroll-fade-strip-color, var(--cds-surface-1)) 0%, rgb(from var(--cds-scroll-fade-strip-color, var(--cds-surface-1)) r g b / .85) 13%, rgb(from var(--cds-scroll-fade-strip-color, var(--cds-surface-1)) r g b / .50) 40%, rgb(from var(--cds-scroll-fade-strip-color, var(--cds-surface-1)) r g b / .15) 70%, transparent 100% ); ``` 配合原生滚动时间轴(`scroll-timeline`),当列表触顶时遮罩自动归零(`0px`),滚离顶部时自适应渐开至 `28px`,完全由 GPU Compositor 驱动,零主线程开销。 --- ### 1.5 字体排版与图标对齐系统约束 > **技术领域与英文指代**:`Typography, Alignment & Icons` Claude 桌面端对于字重、排版折叠以及矢量图标的对齐有着近乎偏执的微观调校,涵盖六大核心工程约束: #### 1. 真实字体栈与可变字体轴配置 (Font Stacks & Variable Axes) 依据 REA v6.5.0 对 `c6a992d55-sXiDGMFQ.css` 的逆向提取,Claude 具备完备的 CJK 与多语言回退保护链: * **CJK 专用无衬线回退链 (`--font-cjk-sans-fallback`)**: ```css --font-cjk-sans-sc: "PingFang SC"; --font-cjk-sans-tc: "PingFang TC"; --font-cjk-sans-jp: "Hiragino Sans"; --font-cjk-sans-kr: "Apple SD Gothic Neo"; --font-cjk-sans-fallback: var(--font-cjk-sans-sc), var(--font-cjk-sans-tc), var(--font-cjk-sans-jp), var(--font-cjk-sans-kr); ``` * **主无衬线字体栈 (`--font-anthropic-sans`)**: ```css --font-sans-fallbacks: system-ui, "Segoe UI", Roboto, Helvetica, Arial, var(--font-cjk-sans-fallback), sans-serif; --font-anthropic-sans: "anthropic-sans", var(--font-sans-fallbacks); ``` * **问候语与正文衬线栈 (`--font-anthropic-serif`)**: ```css --font-anthropic-serif: "anthropic-serif", ui-serif, Georgia, "Times New Roman", var(--font-cjk-sans-fallback), serif; ``` * **等宽代码字体栈 (`--font-anthropic-mono`)**: ```css --font-anthropic-mono: "anthropic-mono", "SF Mono", ui-monospace, Menlo, Consolas, monospace; ``` * **可变字体光学尺寸 (opsz) 与微标字重 (wght)**: ```css --font-opsz-axis-title: "opsz" 28,; --font-opsz-axis-heading: "opsz" 20,; --font-opsz-axis-display: "opsz" 48,; --cds-badge-x-wght: 577.8; /* 徽章亚像素光学字重 */ ``` * **图标字体族 (`--font-anthropicons`)**: ```css font-family: Anthropicons-Variable, sans-serif; font-feature-settings: "liga" 0; /* 禁用连字替换,确保图标不被误合并 */ ``` #### 2. 全量 7-Tier 字号阶梯系统与行高规范 (7-Tier Font Size & Leading Scale) Claude 桌面端构建了一套专为高密度信息架构设计的 7 阶排版标尺系统,并通过桌面端光学缩放因子 `--cds-rem-scale: calc(16 / 17)`(≈ 0.941176)将 Web 默认 17px 基准平滑缩放至原生视网膜屏的 16px 精确渲染。 | 阶梯等级 (Token) | CSS 表达式 (Rem Scale) | 换算像素 (Desktop) | 行高 (Leading) | 行高比率 | 核心承载内容场景 | | :--- | :--- | :--- | :--- | :--- | :--- | | **`caption`** | `calc(0.6875rem * var(--cds-rem-scale))` | **10.35px (约 11px)** | `1rem` (16px) | 1.55 | 快捷键徽标 (`Kbd`)、消息时间戳、模型版本号、Token 消耗统计 | | **`footnote`** | `calc(0.75rem * var(--cds-rem-scale))` | **11.29px (约 12px)** | `calc(0.9375rem * scale)` (14.1px) | 1.25 | 附件文件体积大小、图片元数据、次级辅助说明文本、免责声明 | | **`code`** | `calc(0.75rem * var(--cds-rem-scale))` | **11.29px (约 12px)** | `1rem` (16px) | 1.42 | 代码块语法高亮文本、行内代码、Thinking 内部思维链路日志、Diff 差异 | | **`body`** | `calc(0.8125rem * var(--cds-rem-scale))` | **12.24px (约 13px / 14px)** | `1.125rem` (18px) | 1.46 | 对话流助理回答、用户气泡正文、主输入框 (Composer) 键入文本与占位符 | | **`prose`** | `0.875rem - 1rem` (舒适阅读) | **14.0px - 16.0px** | `1.25rem - 1.5rem` (20px - 24px) | 1.43 - 1.50 | 长文 Artifacts 渲染、Markdown 深度阅读、文档预览视图 | | **`heading`** | `calc(0.875rem * var(--cds-rem-scale))` | **13.18px (约 14px / 15px)** | `calc(1.125rem * scale)` (17px) | 1.29 | 弹窗标题 (Modal Title)、卡片分块小标题、侧边栏分组标题、设置项名称 | | **`title`** | `calc(1.25rem * var(--cds-rem-scale))` | **18.82px (约 20px / 21px)** | `calc(1.5rem * scale)` (23.5px) | 1.25 | 对话顶栏标题、Project 项目主标题、工作区主导航头部 | ```css /* 提取自 c6a992d55-C0zTICcS.css 核心排版变量 */ :root { --cds-rem-scale: calc(16 / 17); /* 桌面端光学微调系数 ≈ 0.94117647 */ --cds-font-size-caption: calc(0.6875rem * var(--cds-rem-scale, 1)); --cds-leading-caption: 1rem; --cds-font-size-footnote: calc(0.75rem * var(--cds-rem-scale, 1)); --cds-leading-footnote: calc(0.9375rem * var(--cds-rem-scale, 1)); --cds-font-size-code: calc(0.75rem * var(--cds-rem-scale, 1)); --cds-leading-code: 1rem; --cds-font-size-body: calc(0.8125rem * var(--cds-rem-scale, 1)); --cds-leading-body: 1.125rem; --cds-font-size-prose: 0.875rem; --cds-leading-prose: 1.25rem; --cds-font-size-heading: calc(0.875rem * var(--cds-rem-scale, 1)); --cds-leading-heading: calc(1.125rem * var(--cds-rem-scale, 1)); --cds-font-size-title: calc(1.25rem * var(--cds-rem-scale, 1)); --cds-leading-title: calc(1.5rem * var(--cds-rem-scale, 1)); } ``` #### 3. 暗色模式视网膜光渗字重逆补偿 (Retinal Irradiation Compensation) 在物理光学与人眼视网膜感知中,**高对比度白字在黑底上会向外发散光晕(Irradiation Phenomenon)**,导致同等粗细的文字在深色模式下显得比浅色模式粗 10% - 15%,产生视觉膨胀与边缘模糊。 Claude 依托其专有 Variable Font 轴进行了精准的物理逆补偿:在深色模式下,主动将字重数值降低 **30 - 40 个刻度**,使文字在人眼感官中达到与浅色模式完全绝对一致的感知纤细度与锐度。 | 语义字重级别 | 浅色模式字重 (Light) | 深色模式减薄字重 (Dark) | 补偿工程机制与变化幅度 | | :--- | :--- | :--- | :--- | | **Regular (正文常规)** | `font-weight: 400` / `"wght" 400` | `--cds-font-axis-wght: "wght" 360` | **主动减薄 40 刻度**,消除纯白正文字体发散 | | **Medium (操作/强调)** | `font-weight: 500` / `"wght" 500` | `--cds-font-axis-wght: "wght" 460` | **主动减薄 40 刻度**,保持中等强度的利落感 | | **Semibold (标题/身份)**| `font-weight: 580` / `"wght" 580` | `--cds-font-axis-wght: "wght" 550` | **主动减薄 30 刻度**,避免粗体在深色背景下糊成一团 | | **Bold (强警示/重强调)** | `font-weight: 600` / `"wght" 660` | `--cds-font-axis-wght: "wght" 660` | 保持稳固的醒目重音边界 | ```css /* 逆向源码提取自 c6a992d55-C0zTICcS.css */ /* 浅色模式基准 */ .font-normal { --cds-font-axis-wght: "wght" 400; font-variation-settings: var(--font-opsz-axis,) var(--cds-font-axis-wght,) "GRAD" var(--cds-font-grad, 0); } .font-medium { --cds-font-axis-wght: "wght" 500; font-variation-settings: var(--font-opsz-axis,) var(--cds-font-axis-wght,) "GRAD" var(--cds-font-grad, 0); } .font-semibold { --cds-font-axis-wght: "wght" 580; font-variation-settings: var(--font-opsz-axis,) var(--cds-font-axis-wght,) "GRAD" var(--cds-font-grad, 0); } /* 深色模式光学逆补偿 */ [data-theme=claude][data-mode=dark] .font-normal { --cds-font-axis-wght: "wght" 360; } [data-theme=claude][data-mode=dark] .font-medium { --cds-font-axis-wght: "wght" 460; } [data-theme=claude][data-mode=dark] .font-semibold { --cds-font-axis-wght: "wght" 550; } [data-theme=claude][data-mode=dark] .font-bold { --cds-font-axis-wght: "wght" 660; } ``` #### 4. 核心业务内容场景排版全景速查矩阵 (Content-to-Typography Matrix) 为了在工程实现中彻底杜绝字号、字重的“随意臆造与层层嵌套”,下表严格归纳了 Claude 桌面端所有核心业务模块的标准字体参数: | 模块区域 (Module) | 界面具体内容元素 (Content Element) | 字体族 (Font Family) | 阶梯/大小 (Size) | 行高 (Leading) | 字重 (Light / Dark) | 特殊排版属性 / 说明 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | **对话流 (Chat)** | 助理身份名称 ("Claude") | Sans | `12px` | 16px | `580` / `550` (Semibold) | 稳固的首部身份标识 | | | 模型版本微标 ("3.7 Sonnet") | Mono | `10.5px` (Caption) | 14px | `500` / `460` (Medium) | 药丸微标,等宽字母 | | | 消息时间戳 ("09:42") | Mono | `11px` (Footnote) | 14px | `400` / `360` (Regular) | `tabular-nums`,弱对比度文本 | | | 助理正文回答 (Paragraph) | Sans | `14px` (Body) | 20px (1.428) | `400` / `360` (Regular) | `text-wrap: pretty;` 消除孤行单字 | | | 用户发送气泡内文本 | Sans | `14px` (Body) | 20px (1.428) | `400` / `360` (Regular) | 紧凑包裹,自然折行 | | | 消息底部操作栏 (复制/重新生成按钮) | Sans | `12px` | 16px | `500` / `460` (Medium) | 鼠标悬浮才显示的二级淡出按钮 | | **思考链路 (Thinking)** | 思考折叠触发器 ("Thought for 5.2s") | Sans | `12px` | 16px | `500` / `460` (Medium) | 包含行内旋转箭头与动态计时器 | | | 内部思维推理日志 (Raw Thought) | Mono | `11.5px` (Code) | 16px (1.39) | `400` / `360` (Regular) | 极细等宽流,无背景包裹,弱灰文本 | | **输入区 (Composer)** | 多行文本输入区 (Textarea) | Sans | `14px` (Body) | 20px (1.428) | `400` / `360` (Regular) | 移动端保底 `max(16px, 14px)` | | | 占位符文本 (Placeholder) | Sans | `14px` (Body) | 20px (1.428) | `400` / `360` (Regular) | 45% 透明度底衬颜色 | | | 底部辅助操作 ("+ Add content") | Sans | `12px` | 16px | `500` / `460` (Medium) | 紧凑工具栏按钮 | | | 模型选择器下拉 ("Claude 3.7 Sonnet") | Sans | `12px` | 16px | `500` / `460` (Medium) | 药丸胶囊交互控件 | | | 发送按钮 ("Send" / 图标) | Sans | `12px` | 16px | `580` / `550` (Semibold) | 视觉焦点权重 | | **代码与工件 (Artifacts)** | 代码块语法高亮代码 (Code block) | Mono | `12px` (Code) | 17.5px (1.46) | `400` / `360` (Regular) | `tabular-nums;` 横向平滑滚动 | | | 行内代码微标 (`inline code`) | Mono | `12px` (Code) | 14px | `500` / `460` (Medium) | 1px 细边框,3px 圆角,内边距 1px 4px | | | 工件卡片标题 (Artifact Title) | Sans | `13px` (Heading) | 18px | `580` / `550` (Semibold) | 点击展开全屏工件抽屉 | | | 工件语言标签 ("REACT", "HTML") | Mono | `10.5px` (Caption) | 12px | `500` / `460` (Medium) | 大写等宽无衬线,字距 `letter-spacing: 0.05em` | | | 附件卡片主文件名 | Sans | `12px` | 16px | `500` / `460` (Medium) | 文本截断 `text-overflow: ellipsis;` | | | 附件卡片文件大小 ("24.8 KB") | Mono | `10.5px` (Caption) | 14px | `400` / `360` (Regular) | `tabular-nums`,辅助弱灰 | | **控制与弹窗 (Controls)** | 模态弹窗主标题 (Modal Dialog) | Sans | `15px - 16px` | 20px (1.25) | `580` / `550` (Semibold) | `text-wrap: balance;` 居中或左对齐 | | | 分段选择器标签 (Segmented Tab) | Sans | `12px` | 16px | 常规 `400` / 激活 `500` | 胶囊滑块平移背景 | | | 按钮 (Button SM / 32px) | Sans | `12.5px` | 16px | `500` / `460` (Medium) | 紧凑控制动作 | | | 按钮 (Button MD / 38px) | Sans | `13.5px` | 18px | `500` / `460` (Medium) | 标准页面主次操作按钮 | | | 快捷键键帽 (`Kbd`) | Mono | `10px - 11px` | 12px | `580` / `550` (Semibold) | 阴影衬底,紧凑字形 | --- #### 5. 行内图标光学基线校准 (.align-[-0.125em]) 在 Web 排版中,默认行内 SVG 或图标会坐落于 `vertical-align: baseline`,导致图标的视觉几何重心明显高于小写字母的 x-Height 与大写字母的 Cap-Height,产生“图标浮在上空”的脱节感。 Claude 体系强制采用专门提取的负偏置实用类: * **`.align-[-0.125em]` (`vertical-align: -0.125em;`)**:用于 14px - 16px 标准 Body 与 Heading 文本。将图标恰好下沉 1/8em(约 1.75px - 2px),使图标的上下对称中心与字母几何重心 100% 严丝合缝重合! * **`.align-[-0.075em]` (`vertical-align: -0.075em;`)**:用于 11px - 12px Caption 与说明性小字。 * **`.align-[-1px]` / `.align-[-2px]`**:用于固定高度(32px/46px)工具栏与标题栏的行内徽章。 ```css /* 提取自 c6a992d55-C0zTICcS.css */ .align-\[-0\.125em\] { vertical-align: -.125em; } .align-\[-0\.075em\] { vertical-align: -.075em; } .align-\[-1px\] { vertical-align: -1px; } ``` #### 4. 文本换行与防折断约束 (Text-Wrap & Word-Break Constraints) * **标题行长均衡 (`text-wrap: balance`)**: 针对所有 `:is(h1, h2, h3, h4)` 和卡片主标题应用 `text-wrap: balance;`,算法自动在多行之间分配字数,避免末行出现孤零零的单个词汇。 * **正文孤字消除 (`text-wrap: pretty`)**: 针对正文段落 `:is(p, li, dd, blockquote)` 应用 `text-wrap: pretty;`,防止段落最后一行遗留单字(Typographic Runts)。 * **超长字符串与 Token 安全换行 (`overflow-wrap: anywhere`)**: 针对包含超长模型 ID(如 `claude-3-7-sonnet-20250219-thinking-exp`)、Git commit hash、代码变量名的提示框,严格采用: ```css overflow-wrap: anywhere; word-break: normal; ``` 在保护常规英文与中文单词连贯性(不强制无理打断正常词)的同时,确保遇到超界长串时能安全折行,绝不撑破容器。 * **移动端输入防缩放底线**: ```css input, textarea, select { font-size: max(16px, var(--cds-font-size-body)); } ``` 在 iOS WebKit 下,任何 `font-size < 16px` 的输入框获得焦点时都会触发页面强制缩放。Claude 设置 16px 下限地板彻底规避此问题。 #### 5. 等宽数字绝对锁定 (Tabular Numerics) 所有涉及动态计数的区域(Thinking 思考耗时 `00:03.2`、Token 消耗 `1,284 tokens`、日期与表格)强制配置: ```css font-variant-numeric: tabular-nums; /* 或 */ font-feature-settings: "tnum" 1; ``` 使数字 `0` 到 `9` 占用完全相同的字形宽度,消除数字递增时引发的整行动量抖动。 #### 6. 矢量图标架构与双层色协议 (Phosphor & Duotone Layering) * **原生坐标系**:`viewBox="0 0 256 256"`(Phosphor Icons 架构)。 * **标准字重与代码字重**: * 常规状态:Stroke 16px(对应字重 533.3,常规粗细)。 * 激活/代码状态:Stroke 24px(对应字重 700,`--df-app-switch-code-weight: 700`)。 * **双层色(Duotone)协议**: ```html ``` * **尺寸阶梯**: * **XS (12px)**:徽章、关闭小图标 * **SM (14px)**:密集操作栏按钮 * **MD (16px)**:标准交互件,应用公式 `calc(1rem * var(--cds-rem-scale, 1))` ≈ `15.06px - 16px` * **LG (20px)**:卡片主操作按钮 * **XL (24px)**:模态窗与空状态主图 #### 7. 完整字阶角色梯级全量映射 (Typography Role Scale Hierarchy) Claude 针对各 UI 语义角色定义了严格绑定的原子类,内置了基准字号、等比行高与可变字体光学校准: | 语义原子类名 | 字号 (`font-size`) | 行高 (`line-height`) | 默认字重 (`font-weight`) | 光学校准 (`font-variation-settings`) | 适用场景 | | :--- | :--- | :--- | :--- | :--- | :--- | | `.text-caption-regular` | `calc(0.6875rem * scale)` (约 11px) | `calc(1.0625rem * scale)` (约 17px) | Regular (400) | `"GRAD" 0` | 时间戳、底部小字说明、微徽章 | | `.text-caption-medium` | `calc(0.6875rem * scale)` (约 11px) | `calc(1.0625rem * scale)` (约 17px) | Medium (470 / 460) | `"wght" 460` (Dark) | 紧凑状态标签、计数微标 | | `.text-caption-bold` | `calc(0.6875rem * scale)` (约 11px) | `calc(1.0625rem * scale)` (约 17px) | Bold (700 / 660) | `"wght" 660` (Dark) | 强调小标签、快捷键提示 | | `.text-footnote-medium` | `calc(0.8125rem * scale)` (约 13px) | `calc(1.0625rem * scale)` (约 17px) | Medium (470 / 460) | `"wght" 460` (Dark) | 列表项副标题、侧边栏次级文本 | | `.text-footnote-semibold` | `calc(0.8125rem * scale)` (约 13px) | `calc(1.0625rem * scale)` (约 17px) | Semibold (600 / 560)| `"wght" 560` (Dark) | 侧边栏活动会话分组头 | | `.text-body-regular` | `calc(0.875rem * scale)` (约 14px) | `calc(1.25rem * scale)` (约 20px) | Regular (400) | `"GRAD" 0` | **标准聊天对话正文、设置表单文字** | | `.text-body-medium` | `calc(0.875rem * scale)` (约 14px) | `calc(1.25rem * scale)` (约 20px) | Medium (470 / 460) | `"wght" 460` (Dark) | 按钮文本、常规交互链接 | | `.text-body-bold` | `calc(0.875rem * scale)` (约 14px) | `calc(1.25rem * scale)` (约 20px) | Bold (700 / 660) | `"wght" 660` (Dark) | 正文强调文本(``, ``) | | `.text-heading-regular` | `calc(0.9375rem * scale)` (约 15px) | `calc(1.25rem * scale)` (约 20px) | Regular (400) | `"opsz" 20` | 对话轮次提示头、卡片小标题 | | `.text-heading-semibold`| `calc(0.9375rem * scale)` (约 15px) | `calc(1.25rem * scale)` (约 20px) | Semibold (600 / 560)| `"opsz" 20, "wght" 560` | 卡片主标题、弹窗面板分组名 | | `.text-title-medium` | `calc(1.25rem * scale)` (约 20px) | `calc(1.75rem * scale)` (约 28px) | Medium (500 / 460) | `"opsz" 28, "wght" 460` | 页面级主标题、设置大栏目 | | `.text-title-bold` | `calc(1.25rem * scale)` (约 20px) | `calc(1.75rem * scale)` (约 28px) | Bold (700 / 660) | `"opsz" 28, "wght" 660` | 模态框首要标题 | | `.font-display` | `2.375rem` (38px) | `1.2 (45.6px)` | Light (`wght: 330`) | `"opsz" 48` (Serif 轴) | **问候语首屏大字标(Serif Greeting)** | #### 8. 多行文本截断阶梯 (Multi-line Truncation & Clamp Scale) Claude 针对各种卡片和气泡采用特定的 `-webkit-line-clamp` 阶梯,配合 `overflow: hidden; display: -webkit-box; -webkit-box-orient: vertical;`: ```css /* 1. 侧边栏历史会话标题(单行防撑爆) */ .line-clamp-1 { -webkit-line-clamp: 1; -webkit-box-orient: vertical; display: -webkit-box; overflow: hidden; } /* 2. 思考折叠卡片摘要(双行预览) */ .line-clamp-2 { -webkit-line-clamp: 2; -webkit-box-orient: vertical; display: -webkit-box; overflow: hidden; } /* 3. 系统提示词卡片与模型描述(三行预览) */ .line-clamp-3 { -webkit-line-clamp: 3; -webkit-box-orient: vertical; display: -webkit-box; overflow: hidden; overflow-wrap: anywhere; } ``` --- ### 1.6 基础动效令牌体系与物理贝塞尔曲线全集 > **技术领域与英文指代**:`Motion Tokens & Physical Curves` ```mermaid graph LR T1["60ms: Micro"] --> T2["120ms: Snap"] --> T3["200ms: Base"] --> T4["300ms: Sheet"] --> T5["450ms: Slow"] ``` #### 1. 响应时序阶梯 (Duration Tokens) * `--cds-dur-fast: 60ms`(微交互、聚焦环显隐) * `--cds-dur-snap: 120ms`(磁吸切换、微标激活) * `--cds-dur-base: 200ms`(标准控件悬停与背景平滑过渡) * `--cds-dur-sheet: 300ms`(抽屉滑入、对话视口图钉追踪) * `--cds-dur-slow: 450ms`(环境转场、模态框升降) #### 2. REA v6.5.0 真实物理贝塞尔缓动曲线全集 (The 7 Core Physical Curves) REA 对官方生产包的 CSS 全量扫描表明,Claude 绝非仅有 3 条通用曲线,而是为不同交互场景调校了专用的物理阻尼常数: | 曲线令牌 / 表达式 | 官方承载交互组件 | 物理特征与视觉心理学作用 | | :--- | :--- | :--- | | **`--cds-ease-swift`**
`cubic-bezier(.16, 1, .3, 1)` | 幽灵按钮、卡片悬停抬升 (`Ghost/Card Hover`) | **仿 iOS 系统级灵动微交互**:150ms 迅速到位,尾段急速刹停无残影 | | **`--cds-ease-expand`**
`cubic-bezier(.19, 1, .22, 1)` | 思考链折叠抽屉 (`.timeline-expand`) | **CSS Grid 专用平滑展开**:0fr 到 1fr 展开时消除任何高度阶跃重排 | | **`--cds-ease-enter`**
`cubic-bezier(.22, 1, .36, 1)` | 消息入场消融 (`timeline-block-enter`) | 伴随 `translateY(5px) scale(0.9) blur(4px)` 到完整清晰展平 | | **`--cds-ease-overshoot`**
`cubic-bezier(.34, 1.3, .64, 1)` | 胶囊滑块、小药丸形变 (`Pill/Slider`) | **经典果冻机械回弹**:前 100ms 冲出 +30% 超调量,后 140ms 柔和收敛 | | **`--cds-ease-pop`**
`cubic-bezier(.34, 1.56, .64, 1)` | 弹窗弹出、操作重强调 (`Dialog Pop`) | **强刚度弹簧物理反馈**:+56% 超调猛烈冲出,提供极其坚实的撞击质感 | | **`--cds-ease-pulse`**
`cubic-bezier(.4, 0, .2, 1)` | 思考状态静默三点跳动 (`timeline-quiet-dot`) | 1.9s 循环,`translateY(-2.5px)` 轻盈律动,显著缓解心理等待焦虑 | | **`--cds-ease-rise`**
`cubic-bezier(.3, .7, .4, 1)` | 状态行抬升入场 (`timeline-status-rise`) | `translateY(6px) -> 0` 平稳升起,避免抢夺正文视觉焦点 | | **`--cds-ease-fall`**
`cubic-bezier(0, 0, .2, 1)` | 状态行淡出下沉 (`timeline-status-fall`) | `translateY(-4px)` 加速滑落,利落退场 | --- --- ## 第二篇:基础原子组件与交互控件 > **技术领域与英文指代**:`Foundational Atoms & Controls` 依托 **REA (Reverse Engineer Anything) v6.5.0** 对官方最新版 Claude Desktop (`/Applications/Claude.app`,`@ant/desktop v2.37337.1`,ASAR 证据 `ev_e0bd89cee50a5b7d0dbf9e75cef5dfbca2bcb1699df4d4371449dd08452a8358`) 的逆向取证,本篇系统性拆解 Claude 基础交互控件的生产级 DOM 结构、CSS 实用类组合与原生物理微交互算法。 --- ### 2.1 全能按钮控件阶梯 > **技术领域与英文指代**:`Buttons & Controls - CdsButton / [data-cds="Button"]` #### 2.1.1 控件高度标尺与排版尺寸矩阵 依据 REA 对 `shared-frame-BfjMqbuN.js` 与 `c6a992d55-sXiDGMFQ.css` 的逆向提取,Claude 绝非使用粗放的 4 级尺寸,而是构建了严苛的 **5 阶高度标尺**,并通过桌面端光学缩放因子 `--cds-rem-scale: calc(16 / 17)`(≈ 0.941176)进行亚像素对齐: | 尺寸代号 | CSS 表达式 (Rem Scale) | 桌面端实际像素 | 内边距 (`padding`) | 圆角 (`radius`) | 字体与排版角色 | | :--- | :--- | :--- | :--- | :--- | :--- | | **`xxs`** (`data-step="1"`) | `calc(1.25rem * scale)` | **18.82px (约 19px)** | `px-1.5 py-0` | `--radius-sm` (4px) | `11px` Caption,极紧凑行内重试、次级小动作 | | **`xs`** | `calc(1.5rem * scale)` | **22.59px (约 23px / 24px)**| `px-2 py-0.5` | `--radius-md` (6px) | `11.5px` Footnote,标签删除、代码块辅助栏 | | **`sm`** | `calc(1.75rem * scale)` | **26.35px (约 26px / 28px)**| `px-2.5 py-1` | `--radius-lg` (8px) | `12.5px`,下拉菜单项、输入框内操作胶囊 | | **`md` (官方默认)** | `calc(2rem * scale)` | **30.12px (约 32px)** | `px-3.5 py-1.5` | `--radius-lg` (8px) | `13.5px` Body,**标准交互动作、表单确认** | | **`lg`** | `calc(2.5rem * scale)` | **37.65px (约 40px)** | `px-5 py-2` | `--radius-xl` (12px) | `15px` Heading,全局首要引导、登录主操作 | | **`icon`** (纯图标) | 固定正方形宽高比 | `aspect-square w-control` | `p-0` | `--radius-lg` (8px) | 工具栏独立图标操作(如关闭、复制、更多) | > [!NOTE] > **嵌套控件高度衰减公式 (`--cds-h-control-nested`)**: > 当按钮被嵌套在 Composer 或工具栏容器中时,Claude 自动切换为嵌套高度变量: > `nested-xs: calc(1.125rem * scale)` (17px) / `nested-sm: calc(1.25rem * scale)` (18.8px) / `nested-default: calc(1.375rem * scale)` (20.7px) / `nested-lg: calc(1.75rem * scale)` (26.35px)。 --- #### 2.1.2 生产级 6 大核心变体契约 (Variants Architecture) REA 逆向揭示,Claude 的按钮组件由两层结构正交构成:**外层交互重置壳** + **内层独立绘景层 (`data-cds-part="paint"`)**。这一架构彻底解耦了外轮廓焦点环、内阴影与背景渐变,杜绝了传统 CSS 按钮在 Hover/Active 时内外尺寸微抖的缺陷。 ```mermaid graph LR Outer["Button 外层容器
[data-cds='Button'] .cds-btn-squish"] --> Paint["独立绘景图层
[data-cds-part='paint'] -z-10"] Outer --> Content["内容排版层
Icon + Children + Kbd"] Outer --> Indicator["状态微标插槽
[data-cds-part='indicator'] Pulse"] ``` ```javascript /* 提取自官方生产包 shared-frame-BfjMqbuN.js 原生变体映射 */ const Il = "cds-reset group/btn relative isolate inline-flex shrink-0 items-center justify-center gap-1.5 whitespace-nowrap select-none cursor-[var(--cds-cursor-interactive)] aria-disabled:cursor-default data-[disabled]:cursor-default border-0 outline-none focus-visible:outline-hidden rounded h-control font-sans text-body transition-shadow duration-fast"; ``` | 变体代号 | 视觉语义角色 | 文字排版与前景色 | 绘景图层样式 (`data-cds-part="paint"`) | 交互状态与物理特征 | | :--- | :--- | :--- | :--- | :--- | | **`secondary`**
(**Claude 官方默认**) | 卡片内次级操作,**绝不带硬边框**,严格遵循单闭合边框原则 | `text-primary font-normal font-control aria-pressed:text-accent` | `bg-fill-secondary group-hover/btn:bg-fill-secondary-hover dark:bg-white/10 dark:hover:bg-white/15` | `shadow-field group-aria-pressed/btn:shadow-field-pressed` | | **`primary`** | 关键正向提交、发送提示词 | `text-on-primary font-medium font-control` | `bg-fill-primary group-hover/btn:bg-fill-primary-hover` (陶土实色) | `shadow-2xs active:brightness-95` | | **`ghost`** | 工具栏图标、内联微操作、次级折叠条 | `text-primary font-normal font-control aria-pressed:text-accent` | `bg-transparent group-hover/btn:bg-fill-ghost-hover` | 悬停渐入 5% 灰度,激活 `bg-fill-ghost-selected` | | **`danger`** | 模态确认删除、清空项目等毁灭性动作 | `text-on-danger font-medium font-control` | `bg-fill-danger group-hover/btn:bg-fill-danger-hover` (警示深红) | `focus-visible:shadow-focus-danger` 专用红光晕 | | **`brand`** | 桌面端官方品牌高亮操作 | `text-on-brand font-medium font-control` | `bg-fill-brand group-hover/btn:bg-fill-brand-hover` (`--brand: #c6613f`) | 官方深陶土桌面品牌色 | | **`onContent`** | 浮动于复杂代码、图片或全屏视频上方的覆层操作 | `text-primary font-medium font-control` | `bg-[var(--cds-button-on-content)] backdrop-blur-md shadow-[inset_0_0_0_1px_var(--cds-button-on-content-ring)]` | 4px 毛玻璃羽化,深色半透明抗背景干扰 | --- #### 2.1.3 按钮动态阻尼物理学与 15 阶纯 CSS 弹簧 (`.cds-btn-squish`) REA 对 `c6a992d55-sXiDGMFQ.css` 进行逆向取证时,发现了 Claude 极其惊艳的**真实物理弹簧形变系统**:它绝非传统前端写死的硬性 `scale(0.98)`,而是结合运行时按钮高度自适应计算阻尼系数,并在松开瞬间触发 **15 阶 CSS `linear()` 弹簧曲线**: ```css /* 提取自 c6a992d55-sXiDGMFQ.css 真实生产定义 */ :root { --cds-btn-spring: linear( 0, .2459, .6526, .9468, 1.0764, 1.0915, 1.0585, 1.0219, .9993, .9914, .9921, .9957, .9988, 1.0004, 1 ); } .cds-btn-squish { --cds-btn-press-sx: 0.975; --cds-btn-press-sy: 0.975; transform-origin: 50%; transition: transform var(--cds-dur-slow) var(--cds-btn-spring); } .cds-btn-squish:active, :active > .cds-btn-squish { transform: scale(var(--cds-btn-press-sx), var(--cds-btn-press-sy)); transition: transform var(--cds-dur-fast) ease-out; } ``` > [!TIP] > **弹簧数学分析 (Spring Physics Analysis)**: > 在 `--cds-btn-spring` 曲线中,按压释放瞬间先在 40% 时间点冲出至 `1.0915`(**+9.15% 物理过冲**),随后微回弹至 `0.9914`,并在 `1.0004` 处精准阻尼收敛。配合 JS 动态微调: > `Bl(h) = Math.min(1.5, Math.max(0.5, h * (1 / 32)))`,保证小按钮微缩放细腻,大按钮扎实回弹。 --- #### 2.1.4 组合按钮组协议 (Joined Buttons) 当多个按钮以组合条形态并排出现时(如分段视图切换、撤销/重做组),外层注入 `joined` 拓扑控制,自动剔除内侧圆角并消除双重中缝边框: * **首项 (`start`)**:`rounded-e-none`(右侧直角) * **中间项 (`middle`)**:`rounded-none`(两侧直角) * **末项 (`end`)**:`rounded-s-none`(左侧直角) > **生产级独立组件实现**:[`code-examples/CdsButton.tsx`](code-examples/CdsButton.tsx)(已全量同步 5 阶尺寸、6 大变体、绘景层分离与 `.cds-btn-squish` 15 阶弹簧物理算法)。 --- ### 2.2 分段滑动选择胶囊 > **技术领域与英文指代**:`Segmented Control & Pills - .df-pills[data-segmented]` Claude 桌面端顶部导航与设置中的滑动 Tab 采用 **999px 全圆角轨道 + 纯几何等分滑块 + 双断点容器查询自适应折叠** 架构。 #### 2.2.1 轨道与滑动指示器精确几何参数 ```css /* 提取自 shared-styles-Bl9zqrv-.css 与 frame-window-BEI3vR8Q.css */ .df-pills[data-segmented] { padding: 1px; /* 严格 1px 环绕间距,杜绝 2px 的笨拙感 */ container-type: inline-size; border-radius: 999px; background: var(--cds-segmented-control-track, rgba(0, 0, 0, 0.06)); } .df-pills[data-segmented] .df-pill-indicator { position: absolute; top: 1px; bottom: 1px; border-radius: calc(var(--cds-radius) - 1px); will-change: transform; transition: transform var(--cds-dur-snap) var(--cds-ease-snap), background-color var(--df-dur-slow) var(--df-ease-out); } ``` * **纯几何等分比例公式 (Pure Geometric Allocation)**: 滑块水平位置与宽度严丝合缝匹配轨道内 1px 间隙: ```css left: calc(1px + var(--active-index) * (100% - 2px) / var(--total-tabs)); width: calc((100% - 2px) / var(--total-tabs)); ``` * **光学双层弥散投影 (Dual-Layer Optical Shadow)**: - **浅色模式**: `background: var(--cds-neutral-20); box-shadow: inset 0 0 0 0.5px var(--cds-border), 0 1px 2px #0000000f, 0 2px 6px -1px #0000000d;` - **深色模式**: `background: var(--cds-segmented-control-thumb); box-shadow: inset 0 0 0 0.5px #ffffff14, 0 1px 2px #0000004d, 0 2px 6px -1px #00000040;` --- #### 2.2.2 双断点容器查询自适应折叠协议 (@container) 当容器宽度被窄侧边栏或窗口拉伸挤压时,Claude 绝不生硬换行,而是依托 `@container` 逐级收缩未激活项标签: ```css /* 提取自 c6a992d55-sXiDGMFQ.css 真实生产容器断点 */ /* 1. 两项分段控制器:容器宽度 <= 180px 时折叠 */ @container (width <= 180px) { .df-pills[data-segmented][data-pills="2"] .df-pill:not([data-active]) .df-pill-label { display: none; } .df-pills[data-segmented][data-pills="2"] .df-pill:not([data-active]) { padding: 0; } .df-pills[data-segmented][data-pills="2"] .df-pill[data-active] { flex: none; padding: 0 16px; } } /* 2. 三项分段控制器:容器宽度 <= 254px 时折叠 */ @container (width <= 254px) { .df-pills[data-segmented][data-pills="3"] .df-pill:not([data-active]) .df-pill-label { display: none; } .df-pills[data-segmented][data-pills="3"] .df-pill:not([data-active]) { padding: 0; } .df-pills[data-segmented][data-pills="3"] .df-pill[data-active] { flex: none; padding: 0 16px; } } ``` > **生产级独立组件实现**:[`code-examples/SegmentedControl.tsx`](code-examples/SegmentedControl.tsx)(支持 1px 严苛轨道定位、双断点容器自适应折叠与 Framer Motion 物理弹簧双模式)。 --- ### 2.3 状态指示灯与微动效套件 > **技术领域与英文指代**:`Status Indicators & Shimmer` 在 Claude 界面中,微型指示灯与扫光条承担着系统实时状态(运行中、思考中、空闲、就绪)的关键传达职责: #### 2.3.1 官方标准 6px 状态指示灯矩阵 (`.status-dot`) REA 逆向从 `shared-styles-Bl9zqrv-.css` 中提取到的官方状态灯基准类为 `.status-dot`(**严格 6px 直径圆形**): ```css .status-dot { width: 6px; height: 6px; border-radius: 50%; display: block; position: relative; } ``` | 状态代号 | 视觉颜色 | 动画时序与关键帧 | 业务承载场景 | | :--- | :--- | :--- | :--- | | **`ready`** | `var(--cds-fill-accent)` | 静态常亮,无额外消耗 | 桌面端就绪、会话同步完成、模型待命 | | **`running`** | `var(--cds-fill-accent)` | `1.2s ease-in-out infinite dframe-dot-blink` (透明度 0.3 $\leftrightarrow$ 1.0) | 后台活动通信中、工件代码构建中 | | **`error`** | `var(--cds-fill-danger)` | 静态深红高亮 | 连接超时、MCP 工具执行失败 | | **`clay`** | `var(--cds-clay)` | **`3.0s ease-in-out infinite dframe-clay-breathe`** | Extended Thinking 深度推理与模型核心算力脉冲 | ```css /* 陶土呼吸关键帧提取自 shared-styles-Bl9zqrv-.css */ @keyframes dframe-clay-breathe { 0%, 100% { filter: brightness(0.96); transform: scale(0.86); } 50% { filter: brightness(1.06); transform: scale(1); } } ``` --- #### 2.3.2 思考波浪三点跳跃规范 (`.timeline-quiet-dots`) 在思考链或消息输出等待态,Claude 渲染专有的 3 点波浪脉冲: * **容器几何**:`gap: 3.5px; display: inline-flex; position: relative; top: 0.26em;` * **单点几何**:`width: 3px; height: 3px; border-radius: 50%; background: var(--cds-clay, #d97757);` * **三阶延迟与运动轨迹**: - 周期:**`1.9s cubic-bezier(0.4, 0, 0.2, 1) infinite`** - 阶梯相位差:点 1 为 `0s`,点 2 为 `0.15s`,点 3 为 `0.3s` - 运动关键帧: ```css @keyframes timeline-quiet-dot { 0%, 8% { opacity: 0; transform: translateY(2px); } 22% { opacity: 1; transform: translateY(-2.5px); } 36%, 70% { opacity: 1; transform: translateY(0); } 90%, 100%{ opacity: 0; transform: translateY(0); } } ``` --- #### 2.3.3 骨架屏 105° 倾角平移扫光 (`cds-skeleton-sweep`) 在卡片、正文骨架加载阶段,Claude 采用极具质感的非对称角度扫光: * **周期与缓动**:`animation: cds-skeleton-sweep 2s linear infinite;`(严格 2.0s 匀速,非 1.6s)。 * **光带倾角**: - LTR 模式:`linear-gradient(105deg, transparent 35%, var(--cds-skeleton-sheen) 50%, transparent 65%)` - RTL 镜像模式:`linear-gradient(255deg, transparent 35%, var(--cds-skeleton-sheen) 50%, transparent 65%)` * **关键帧**: ```css @keyframes cds-skeleton-sweep { 0% { transform: translate(-100%); } 100% { transform: translate(100%); } } ``` > **生产级独立组件实现**:[`code-examples/StatusIndicators.tsx`](code-examples/StatusIndicators.tsx)。 --- ### 2.4 模态确认对话框 > **技术领域与英文指代**:`Confirmation Dialog - [data-cds="Dialog"]` 在执行清空会话、删除项目、重置密钥或高风险 MCP 工具调用时呼出的模态确认对话框: #### 2.4.1 6 阶弹窗标尺与视口安全上限 依据 REA 对 `shared-frame-BfjMqbuN.js` 生产 Dialog 控制器的提取,Claude 构建了系统级 6 阶弹窗矩阵: ```javascript /* 提取自官方生产包 shared-frame-BfjMqbuN.js 原生 Qg 尺寸表 */ const Qg = { sm: "max-w-[400px]", // 极简确认、单项授权 md: "max-w-[520px]", // 标准确认模态框(默认) lg: "max-w-[720px]", // 复杂表单、环境配置 xl: "max-w-[880px]", // 代码对比确认 "2xl": "max-w-[1024px]", // 宽屏工件预览 "3xl": "max-w-[1152px]" // 全功能工作区看板 }; ``` * **视口高度自适应截断安全公式 (`--environment-dialog-cap`)**: ```css --environment-dialog-cap: calc( 100dvh - max(2rem, 2 * var(--desktop-titlebar-inset, 0px)) - 2 * max(env(safe-area-inset-top, 0px), env(safe-area-inset-bottom, 0px)) ); ``` 保证弹窗在所有桌面端(macOS 信号灯刘海屏、Windows 标题栏)下均不溢出视口。 --- #### 2.4.2 嵌套弹窗防御体系 (Nested Dialog Blurring Protocol) 当模态对话框内部再次唤起二级子弹窗时(如在确认弹窗中点击“查看详情”弹窗),Claude 通过属性选择器自动对底层父弹窗进行物理虚化与暗化拦截: ```javascript /* 提取自 shared-frame-BfjMqbuN.js */ const Xg = "after:pointer-events-none after:absolute after:inset-0 after:rounded-[inherit] after:bg-backdrop after:opacity-0 after:z-50 after:transition-opacity after:duration-base after:ease-out data-[nested-dialog-open]:after:opacity-100"; const Zg = "data-[nested-dialog-open]:blur-[2px]"; ``` 当父弹窗检测到 `data-[nested-dialog-open]` 时: 1. 立即触发 `blur-[2px]`,消除文字高频细节; 2. 伪元素 `after` 透明度从 0 平滑过渡至 100%,覆盖一层半透明微遮罩; 3. 视线焦点绝对聚焦于最新呼出的二级模态框。 --- #### 2.4.3 原生滚动时间轴与双环弥散投影 * **双环 Popover 投影 (`--cds-shadow-popover`)**: 外层高斯模糊与内层倒角物理顶光反光,外轮廓不带任何 1px 生硬黑线。 * **滚动时间轴驱动**: 容器内置 `[scroll-timeline:--cds-dialog-scroll_block]` 与 `.scroll-fade-y`,内容超长产生纵向滚动时,自动触发 Chapter 1 提取的 28px 相对色彩渐隐遮罩。 > **生产级独立组件实现**:[`code-examples/ConfirmationDialog.tsx`](code-examples/ConfirmationDialog.tsx)。 --- ### 2.5 附件磁贴与上下文胶囊 > **技术领域与英文指代**:`Attachment Cards & Inline Chips - [data-cds="MessageAttachmentsFile"]` 用户在对话流中发送文件或在输入框中暂存附件时呈现的卡片控件: #### 2.5.1 严苛正方形 7.5rem 磁贴架构与自适应同心圆角 REA 对生产包 `shared-2-Cb74JByF.js` 的全量提取彻底纠正了社区普遍猜测的“128px × 96px 扁长矩形”,官方真实类名如下: ```javascript /* 提取自 shared-2-Cb74JByF.js 原生 Yf 磁贴容器类名 */ const Yf = "group/tile relative isolate size-[calc(7.5rem*var(--cds-rem-scale,1))] shrink-0 rounded-card outline-none focus-visible:shadow-focus"; ``` * **真实几何规格**: `size-[calc(7.5rem * var(--cds-rem-scale, 1))]`:基础为 **严格正方形 120px**,经桌面缩放因子校准后为 **112.94px × 112.94px**。 * **同心圆角**:采用 Chapter 1 确立的 `rounded-card`(`--radius-card`),内嵌元素曲率与外框保持绝对同心。 * **立体漫射**:外嵌 `shadow-field-drop`,Hover 时微抬升过渡至 `hover:shadow-xs`。 --- #### 2.5.2 浮动微圆形移除按钮协议 (`data-cds-attachment-remove`) 移除按钮并不占位内部网格,而是以极高精度悬浮于右上角: ```javascript /* 提取自 shared-2-Cb74JByF.js 原生 _p 移除按钮 */ const removeBtnClasses = "cds-reset absolute -end-2 -top-2 z-[1] inline-flex size-5 items-center justify-center rounded-full bg-surface-3 text-secondary shadow-card-ring hover:text-primary outline-none focus-visible:shadow-focus"; ``` * **绝对定位**:`absolute -end-2 -top-2 z-[1]`(向右上方悬浮超出 8px)。 * **微型圆点**:`size-5`(严格 20px 直径),底色为最高层级 `Surface 3`。 * **物理防呆**:配备 `shadow-card-ring` 发丝保护环,按压触发 `active:scale-90` 触觉回馈。 --- #### 2.5.3 双向中间智能截断算法 (Bi-Directional Mid-Truncation) 在长文件名显示场景中,传统单向省略(`truncate` / `text-overflow: ellipsis`)会将文件末尾的扩展名硬生生截断为 `long_filename_final...`,导致用户无法判断文件类型。Claude 采用精密的**双向智能中间截断算法**: ```html {head} {tailStem} {tailExt} ``` 无论文件名多长(如 `deep_reinforcement_learning_policy_gradient_v3.tsx`),扩展名 `.tsx` 永远以 `shrink-0` 锁定展示,中间自动由 `before:content-['…']` 动态连接。 --- #### 2.5.4 动态全大写类型徽标 (Uppercase Badge) 磁贴左上角自动解析文件后缀并转为大写无衬线徽标(如 `TS`, `PY`, `PDF`, `CSV`, `SQL`),使用等宽字形与高对比度微弱背景胶囊展现,保证文件类型在一瞥之间清晰可辨。 > **生产级独立组件实现**:[`code-examples/AttachmentCard.tsx`](code-examples/AttachmentCard.tsx)(已全量同步 7.5rem 正方形、双向中间智能截断算法与浮动移除按钮协议)。 --- ## 第三篇:会话核心流与指令交互引擎 > **技术领域与英文指代**:`Chat Stream & Composer Engine` > **逆向审计基线**:基于 **REA (Reverse Engineer Anything) v6.5.0** 对官方 macOS 桌面生产包 `/Applications/Claude.app`(`@ant/desktop v2.37337.1`,构建时间戳 `2026-10-13T22:16:06Z`)进行全量 AST 反编译与样式取证。**绝无主观推测,全量引述真实源码与 CSS 规则**。 ### 生产环境取证溯源清单 | 规范领域 | 官方生产文件 Hash | 核心取证符号 / 规则 | | :--- | :--- | :--- | | **消息气泡与版心排版** | `frame-shell-chrome-CAw-tYzh.js` | `[data-cds=UserMessage]`, `[data-cds=AssistantMessage]`, `--cds-message-bubble-radius`, `--cds-assistant-message-text-inset`, `--cds-assistant-message-text-stop` | | **会话状态机与阅读折叠** | `shared-2-Cb74JByF.js` | `UX` (`UserMessage`), `bY`, `xY`, `yY`, 300px 截断与 `mask-image` 渐变遮罩, `MessageActions` 焦点漫游 | | **思考时间轴与波浪动效** | `cc1aae219-DtZTxCKj.css` | `.timeline-quiet-dots`, `@keyframes timeline-quiet-dot` (1.9s), `.timeline-expand` (Grid 0fr), `.timeline-status-*` | | **输入法合成赛跑防御** | `shared-frame-BfjMqbuN.js` | `Lm()`, `Rm()`, `zm()`, `Bm()`, `Um()`, WebKit 500ms Post-Composition Delta Guard, `beforeinput` 拦截 | | **Slash 与 Mention 语法树** | `cb6930dae-BD0W5ZM9.js` | `cs()` 词法解析器, `Qo` (`@` 提及), `$o` (中日韩全角标点剥离), `rs = 1024`, 256 个文件引用熔断阈值 | | **Token 计量与缓存生命周期** | `c058e28e3-DXZbxFF9.js`, `c30db9bec-DjF3pT_h.js` | `ephemeral_5m_input_tokens`, `ephemeral_1h_input_tokens`, `adaptive` thinking 架构, 4色显存解构 | | **MCP 工具授权与人机协同** | `c05b96c7f-DklIyA-P.js`, `cc1aae219-DjR8LnUv.js` | `structured_content`, `ws()`, `user_denied`, `policy_denied`, `PERMISSIONS_ERROR`, `bs` 330s 垃圾回收 | --- ### 3.1 会话气泡套件与排版规范 > **技术领域与英文指代**:`User & Assistant Message Bubbles` #### 3.1.1 用户提问气泡 (`[data-cds="UserMessage"]`) 取证自 `frame-shell-chrome-CAw-tYzh.js` 与 `shared-2-Cb74JByF.js`,用户消息在 CDS 中具有严谨的容器几何与状态结构: ``` [data-cds="UserMessage"][data-author="self"][data-state="done"][data-text-size="md"] ├── AttachmentPreview (若随附附件,MessageAttachmentsFile 7.5rem 磁贴) ├── Bubble Container (yY: rounded-[--cds-message-bubble-radius] px-[--cds-message-bubble-pad-x] py-[--cds-message-bubble-pad-y]) │ ├── .cds-user-message-body (正文,若超出 300px 施加 3rem 底部渐变蒙版) │ └── Show more / Show less (折叠切换按钮) └── MessageActions (悬浮工具条: Copy, Edit, Retry, 快捷漫游) ``` ##### 1. 真实圆角与几何尺寸公式 (REA 取证) ```css /* frame-shell-chrome-CAw-tYzh.js 官方声明 */ .cds-root [data-cds=UserMessage], .cds-root [data-cds=AssistantMessage][data-variant=bubble], .cds-root [data-cds=AssistantMessage][data-cds-bubble-stack] { --cds-message-bubble-radius: calc(var(--cds-radius) + calc(.25rem * var(--cds-rem-scale, 1))); --cds-message-bubble-pad-x: var(--cds-pad-lg); /* 16px */ --cds-message-bubble-pad-y: var(--cds-pad-md); /* 12px */ --cds-message-bubble-measure: 85%; } ``` * **圆角计算**:在默认 `--cds-radius: 8px`、`--cds-rem-scale: 1` 基础下,`calc(8px + 4px) = 12px`;在桌面加大模式下扩展至 `18px`。 * **版心宽度**:`max-w-[var(--cds-message-bubble-measure)]` 约束为 `85%`。当屏幕宽度小于 `40rem` 时自动降级为 `clamp(85%, 448px, 100%)`。 * **背景与文字颜色**: - 默认模式:`bg-[var(--cds-bg-user-message)]`(浅色为中性浅灰 `var(--cds-bg-neutral)`)。 - Personal 专属色调:`bg-[var(--cds-bg-user-message-personal)] text-[color:var(--cds-text-user-message-personal)]`。在浅色模式下为 `#dde8f7`,深色模式下为 `#193c5f`。 - 动态悬浮反应:在 `.feed-bubble-reacts:hover` 状态下注入 `--cds-bg-user-message: var(--cds-bg-neutral-hover); --feed-bubble-mix: 16%;`。 ##### 2. 超长折叠与阅读渐变蒙版 (Truncation & Mask) 在 `shared-2-Cb74JByF.js` 中,当用户提问文字垂直高度超过 `collapseThreshold = 300px` 时,自动进入折叠态: ```css /* REA 取证:3rem 底部衰减蒙版 */ .cds-user-message-collapsed { max-height: 300px; overflow: hidden; mask-image: linear-gradient(to bottom, black calc(100% - 3rem), transparent); -webkit-mask-image: linear-gradient(to bottom, black calc(100% - 3rem), transparent); } ``` --- #### 3.1.2 模型回答正文 (`[data-cds="AssistantMessage"]`) 与传统聊天软件将 AI 回答同样装入边框气泡的做法截然相反,Claude Desktop 秉持**“内容即界面,零边框透明画布哲学”**。 ##### 1. 文本微缩进与止动流体力学 (Text Inset & Stop Law) ```css /* frame-shell-chrome-CAw-tYzh.js 官方声明 */ .cds-root [data-cds=AssistantMessage] { --cds-assistant-message-text-inset: 4px; --cds-assistant-message-text-stop: clamp(0px, (100% - 384px) * .175, 56px); } /* 当正文内部嵌套卡片、数据表格、代码块或 MCP 面板时,微缩进立即精确归零 */ .cds-root [data-cds=AssistantMessage] :is( [data-cds=Card], [data-cds=Surface], [data-cds=Panel], [data-cds=Banner], [data-cds=Aside], [data-cds=Accordion], [data-cds=PreviewCard], [data-cds=Table], [data-cds=DataTable], [data-cds=AskUserQuestion], [data-cds=CommentCard], [data-cds=ChartContainer], [data-cds=PointChartContainer], [data-cds=FileDiff], [data-cds=UserMessage] ) { --cds-assistant-message-text-inset: 0px; --cds-assistant-message-text-stop: 0px; } ``` * **微缩进律**:文字正文保持 `4px` 左侧极轻微呼吸缩进,与顶部的 Claude ✦ 徽标保持光学对齐。 * **卡片重置律**:一旦内容流中出现结构化卡片(如代码块、Artifact 预览、MCP 授权面板),立即将 Inset 与 Stop 归零为 `0px`,确保卡片充满版心容器。 ##### 2. 纵向排版律动 (Vertical Rhythm) 取证自 `shared-styles-Bl9zqrv-.css`: $$\text{chat-turn-gap} = \text{chat-body} \times \text{chat-leading} \times 0.75$$ $$\text{chat-item-gap} = \text{chat-body} \times \text{chat-leading} \times 0.50$$ 在 `md` 字号(`chat-body: 14px`, `chat-leading: 1.42857`)下,消息轮次间距精确为 `15px`,块间距精确为 `10px`。 --- ### 3.2 思考过程折叠与时间状态机 > **技术领域与英文指代**:`Thinking Accordion & Timeline Status Machine` Claude 在流式呈现 Thinking(扩展思考过程)时,在 CSS 与 JS 运行时构建了四阶微交互体系(源码取证自 `cc1aae219-DtZTxCKj.css` 与 `shared-2-Cb74JByF.js`)。 ```mermaid stateDiagram-v2 [*] --> Generating: 模型开始输出思考流 Generating --> Generating: 3点波浪跳跃 (1.9s infinite cubic-bezier(.4, 0, .2, 1)) Generating --> Generating: 展开互斥锁锁定 (isOpen=true, 禁止折叠防抖动) Generating --> Settled: 思考流终结 Settled --> Collapsed: 用户点击折叠 (Grid 1fr -> 0fr, .2s) Collapsed --> Expanded: 用户再次点击 (Grid 0fr -> 1fr) ``` #### 3.2.1 3点静默跳跃指示波浪 (`.timeline-quiet-dots`) 在官方 `cc1aae219-DtZTxCKj.css` 中提取出其完全物理关键帧: ```css .timeline-quiet-dots { gap: 3.5px; display: inline-flex; position: relative; top: .26em; } .timeline-quiet-dots > span { background: var(--cds-clay, #d97757); opacity: 0; border-radius: 50%; width: 3px; height: 3px; animation: 1.9s cubic-bezier(.4, 0, .2, 1) infinite timeline-quiet-dot; } .timeline-quiet-dots > span:nth-child(2) { animation-delay: .15s; } .timeline-quiet-dots > span:nth-child(3) { animation-delay: .3s; } @keyframes timeline-quiet-dot { 0%, 8% { opacity: 0; transform: translateY(2px); } 22% { opacity: 1; transform: translateY(-2.5px); } 36%, 70% { opacity: 1; transform: translateY(0); } 90%, 100%{ opacity: 0; transform: translateY(0); } } ``` * **三阶位移物理**: 1. $0\% \sim 8\%$:下沉 $2\text{px}$ 准备弹起; 2. $22\%$:向上冲刺至最高点 $-2.5\text{px}$,透明度达到 $100\%$; 3. $36\% \sim 70\%$:自然落回基准点 $0\text{px}$ 稳定驻留; 4. $90\% \sim 100\%$:淡出归零,等待下一个 $1.9\text{s}$ 循环。 #### 3.2.2 状态条平滑升降物理 (`timeline-status-*`) 思考完成与状态切换时不使用生硬的显隐,而是通过升降动画平滑交接: * **入场**:`.timeline-status-enter-quiet`,`.24s cubic-bezier(.3, .7, .4, 1)` 从 `translateY(6px)` 抬升至基线; * **退场**:`.timeline-status-exit-quiet`,`.18s ease-out` 向下掉落 `translateY(-4px)` 并渐变透明。 #### 3.2.3 CSS Grid 伸缩展开防抖 (`.timeline-expand`) 为了消除常规 JavaScript 计算 `scrollHeight` 带来的性能开销与视口突变,CDS 全面采用现代 CSS Grid 尺寸过渡: ```css .timeline-expand { grid-template-rows: 1fr; display: grid; } .timeline-expand > * { align-self: start; min-width: 0; min-height: 0; } @keyframes timeline-expand { 0% { opacity: 0; grid-template-rows: 0fr; } 100% { opacity: 1; grid-template-rows: 1fr; } } .timeline-expand-enter { animation: .2s cubic-bezier(.19, 1, .22, 1) timeline-expand; } ``` --- ### 3.3 新一代富文本输入框终端与指令交互引擎 > **技术领域与英文指代**:`Chat Composer & Next-Gen Engine` 在 Claude Desktop 生产端中,输入框已由传统简单的 `