# V1 手册总览 (/docs/v1)

> **版本**：1.0 (基于 Claude Desktop `/Applications/Claude.app` 生产环境全量分析)  
> **分析框架**：全流程依托 **[REA (Reverse Engineer Anything)](https://github.com/morluto/rea)** 完成 Vite/Rollup AST 反混淆、运行时行为追踪与 ASAR 资源解包。  
> **定位**：供前端工程师、UI 设计师与独立开发者像素级复刻 Claude 质感与交互的完整工程指导规范。  

---

## 🧭 第一版分卷大纲与导航索引 [#-第一版分卷大纲与导航索引]

### 🎨 [第一篇：设计哲学与设计令牌体系](01-设计哲学与设计令牌体系.md) [#-第一篇设计哲学与设计令牌体系]
* [1.1 设计哲学与视觉调性](01-设计哲学与设计令牌体系.md#11-设计哲学与视觉调性)
* [1.2 表面体系与色彩阶梯](01-设计哲学与设计令牌体系.md#12-表面体系与色彩阶梯)
* [1.3 控件尺寸与精密圆角矩阵](01-设计哲学与设计令牌体系.md#13-控件尺寸与精密圆角矩阵)
* [1.4 发丝细边、微光阴影与边框防臃肿体系](01-设计哲学与设计令牌体系.md#14-发丝细边微光阴影与边框防臃肿体系)
* [1.5 字体排版与图标对齐系统约束](01-设计哲学与设计令牌体系.md#15-字体排版与图标对齐系统约束)
* [1.6 基础动效令牌体系与物理贝塞尔曲线全集](01-设计哲学与设计令牌体系.md#16-基础动效令牌体系与物理贝塞尔曲线全集)

### 🧱 [第二篇：基础原子组件与交互控件](02-基础原子组件与交互控件.md) [#-第二篇基础原子组件与交互控件]
* [2.1 全能按钮控件阶梯](02-基础原子组件与交互控件.md#21-全能按钮控件阶梯)
* [2.2 分段滑动选择胶囊](02-基础原子组件与交互控件.md#22-分段滑动选择胶囊)
* [2.3 状态指示灯与微动效套件](02-基础原子组件与交互控件.md#23-状态指示灯与微动效套件)
* [2.4 模态确认对话框](02-基础原子组件与交互控件.md#24-模态确认对话框)
* [2.5 附件磁贴与上下文胶囊](02-基础原子组件与交互控件.md#25-附件磁贴与上下文胶囊)

### 💬 [第三篇：会话核心流与指令交互引擎](03-会话核心流与指令交互引擎.md) [#-第三篇会话核心流与指令交互引擎]
* [3.1 会话气泡套件与排版规范](03-会话核心流与指令交互引擎.md#31-会话气泡套件与排版规范)
* [3.2 思考过程折叠与时间状态机](03-会话核心流与指令交互引擎.md#32-思考过程折叠与时间状态机)
* [3.3 新一代富文本输入框终端与指令交互引擎](03-会话核心流与指令交互引擎.md#33-新一代富文本输入框终端与指令交互引擎)
* [3.4 模型矩阵切换器与 Token 计量仪表盘](03-会话核心流与指令交互引擎.md#34-模型矩阵切换器与-token-计量仪表盘)
* [3.5 交互式工具调用与 MCP 决策卡片](03-会话核心流与指令交互引擎.md#35-交互式工具调用与-mcp-决策卡片)

### ⚡ [第四篇：动效物理学、着色器与环境光影](04-动效物理学、着色器与环境光影.md) [#-第四篇动效物理学着色器与环境光影]
* [4.1 全量动效引擎与关键帧规范](04-动效物理学、着色器与环境光影.md#41-全量动效引擎与关键帧规范)
* [4.2 动态光效着色器与推理氛围感](04-动效物理学、着色器与环境光影.md#42-动态光效着色器与推理氛围感)
* [4.3 滚动边缘平滑渐变遮罩系统](04-动效物理学、着色器与环境光影.md#43-滚动边缘平滑渐变遮罩系统)

### 🎧 [第五篇：视听多媒体与产物交互物理学](05-视听多媒体与产物交互物理学.md) [#-第五篇视听多媒体与产物交互物理学]
* [5.1 语音模式与 Web Audio 物理声学系统](05-视听多媒体与产物交互物理学.md#51-语音模式与-web-audio-物理声学系统)
* [5.2 多模态媒体查看器与画廊转场物理学](05-视听多媒体与产物交互物理学.md#52-多模态媒体查看器与画廊转场物理学)
* [5.3 双栏弹性分割与折叠物理学](05-视听多媒体与产物交互物理学.md#53-双栏弹性分割与折叠物理学)
* [5.4 工件预览沙箱与隔离通信架构](05-视听多媒体与产物交互物理学.md#54-工件预览沙箱与隔离通信架构)
* [5.5 代码差异对比与多线程语法高亮系统](05-视听多媒体与产物交互物理学.md#55-代码差异对比与多线程语法高亮系统)

### 🖥️ [第六篇：系统级桌面架构与协作拓扑](06-系统级桌面架构与协作拓扑.md) [#️-第六篇系统级桌面架构与协作拓扑]
* [6.1 macOS 桌面宿主深度融合与窗口材质](06-系统级桌面架构与协作拓扑.md#61-macos-桌面宿主深度融合与窗口材质)
* [6.2 侧边栏会话拖放重排与拓扑网格](06-系统级桌面架构与协作拓扑.md#62-侧边栏会话拖放重排与拓扑网格)
* [6.3 多代理协作看板与 Cowork 空间拓扑](06-系统级桌面架构与协作拓扑.md#63-多代理协作看板与-cowork-空间拓扑)
* [6.4 流式大文本输出与滚动视口物理学](06-系统级桌面架构与协作拓扑.md#64-流式大文本输出与滚动视口物理学)
* [6.5 容器查询自适应排版与极端防挤压](06-系统级桌面架构与协作拓扑.md#65-容器查询自适应排版与极端防挤压)
* [6.6 全键盘盲操网格与无障碍访问](06-系统级桌面架构与协作拓扑.md#66-全键盘盲操网格与无障碍访问)
* [6.7 异常容灾模型限流与业务状态机](06-系统级桌面架构与协作拓扑.md#67-异常容灾模型限流与业务状态机)

### 🛠️ [第七篇：工程配置与资产代码库总览](07-工程配置与资产代码库总览.md) [#️-第七篇工程配置与资产代码库总览]
* [7.1 开箱即用的 Tailwind 配置与基础 CSS 代码](07-工程配置与资产代码库总览.md#71-开箱即用的-tailwind-配置与基础-css-代码)
* [7.2 生产级工程源码清单](07-工程配置与资产代码库总览.md#72-生产级工程源码清单)
* [7.3 资产规范与系统级字体/音频替代方案](07-工程配置与资产代码库总览.md#73-资产规范与系统级字体音频替代方案)

### 🤖 [第八篇：AI Agent 前端 UI 与动效开发指南](08-AI-Agent-前端-UI-与动效开发指南.md) [#-第八篇ai-agent-前端-ui-与动效开发指南]
* [8.1 Agent 角色定位与设计哲学](08-AI-Agent-前端-UI-与动效开发指南.md#81-agent-角色定位与设计哲学)
* [8.2 设计令牌与色彩引用契约](08-AI-Agent-前端-UI-与动效开发指南.md#82-设计令牌与色彩引用契约)
* [8.3 动效物理学：四套弹簧预设决策树](08-AI-Agent-前端-UI-与动效开发指南.md#83-动效物理学四套弹簧预设决策树)
* [8.4 控件原子规则与单闭合边框原则](08-AI-Agent-前端-UI-与动效开发指南.md#84-控件原子规则与单闭合边框原则)
* [8.5 交互防御与边缘场景守卫](08-AI-Agent-前端-UI-与动效开发指南.md#85-交互防御与边缘场景守卫)
* [8.6 生产级组件库快速装配指南 (30 模块)](08-AI-Agent-前端-UI-与动效开发指南.md#86-生产级组件库快速装配指南-30-模块)
* [8.7 智能体自检与质量门禁清单](08-AI-Agent-前端-UI-与动效开发指南.md#87-智能体自检与质量门禁清单)