UI Improvement
把界面做成可以使用、可以阅读、会回应的作品。先理解人在做什么,再决定内容怎样
相处,用字、色、形、空间与变化把关系做出来。功能成立以后,美感仍值得单独判断:
比例、节奏和气质是否完整,不能由“没有溢出”或“操作成功”代替回答。
采用一个跨领域设计者的工作视角:建筑看动线、尺度与空间归属;工业设计看操作
暗示、材料与接合;平面设计看版面、字形和视觉重量;交互设计看行为、时间和返回。
这些视角帮助作决定,不要求把每页都做成建筑、器物或海报。给新人解释做法时,
用具体画面串起观察、选择、制作与回看,入门示范见设计手册。
扫描发现范围与共性,试作解决审美未知,复验检验关系是否成立;局部成功不代替
任务要求的多页面覆盖或用户接受。
恢复本批任务与现场
确定目标、修改边界、已接受方向、基线与预览能力,续接已有观察,不重新发明整套设计。
局部目标直接处理;发现风格缺口不自动授权全产品改版。规范、组件 owner 与实现检查
来自项目,设计方向来自任务和当前有效表达,不绑定品牌、设计系统或特定 design skill。
从真实入口梳理页面、组件用法、内容及相关状态。同构重复可分组,差异保留;记录已看、
源码推断与未看,不能以清单存在代替覆盖。也保留切换、重绘和返回前后需维持的对象、
草稿与操作位置,不让页面清单漏掉接合处。按影响、共性与当前未知选择深挖点。
从画面判断缺口在哪一层
先核对任务动线与表达载体:用户为完成什么,需知道什么、比较什么、决定什么,
怎样进入、行动和返回。控件能运行不证明选型适当,页面漂亮也可能迫使不必要的
跳转、反复展开或重新定位。涉及选择控件、页面/面板/dialog、步骤与信息架构时,
读交互结构与载体,先改受损关系再打磨表面。
以下三层处理视觉表达,不把交互动线缩成间距问题,也不把 CSS 属性固定分箱;颜色有可读性约束,布局有操作和响应式约束,
间距与圆角也能参与风格。
- 基础秩序:可检查的尺度、对齐、间距、控件和响应式关系。具体规则来自用途,
不设全产品唯一参数,也不以所有坐标相等为目标。
- 风格框架:整体气质落实为颜色、字体、形状、表面层次和布局节奏的关联选择。
风格名和 token 清单不能证明这些选择相互支撑。
- 局部搭配:在框架内组织内容、主次与视觉锚点,允许角色和密度带来差异,
但要与所在区域及整体相接。
基础秩序成立后,仍主动判断整体是否有设计完成度;不等用户指出“不精致”才进入。
若各部件单独正确、合起来仍像默认组件拼装,或参数打磨没有改变观感,使用
构图与搭配试作。它通过画面诊断和有区分力的试作
发展审美判断,不把软装简化成挑皮肤,也不默认全部去框、变小或变淡。
延续产品语言不等于保护旧构图。诊断涉及整体组织时,允许用相同真实内容重编完整区域,
再与保守修饰对照;不能用参数打磨声称已解决内容关系。
能指出缺口却缺少表达做法时,读视觉修辞,从官方案例
选择相容的构图与搭配手法,转译到真实内容;它是制作素材,不是需逐项满足的清单。
具体到阴影、色组、虚线/实线、圆角和动效的制作,读表面与动效配方,
选择成组材料并映射项目已有角色,参数先作试作起点,不写成通用规范。
未收到具体问题也先看真实画面。按区域职责由整屏进入分组和原比例局部,再回到整体;
滚动看完整页面,包括导航、身份、说明与收尾。按内容角色判断轴线、间距、比例和重量,
对照邻近正常用法;数学等距与盒子居中不代替字形的光学平衡。
沿阅读和操作路线看文字轮廓,含说明、状态、输入与动作旁的文字。无溢出仍可能有
孤字、标点短尾或失衡行长;按内容角色调整宽度、字级或换行,复看邻近尺寸,保留原文。
把同一事实的值、文字、图形、行动和预览连起来看,变化或取消后核对它们是否同步;
动作图标与标签也要描述当前操作。
主动按组成与用法差异选代表性的完整控件组,在原比例局部核对“文字—附属图形—内缘”
的留白、重量及同行基线,不等工具警报或用户指出位置。看闭合、展开、焦点与选中状态,
保住原生语义和键盘行为,再决定调整样式或复用已有组件。DOM 量不到的绘制部件仍回看
实际局部;功能能用或没有碰撞不能证明工艺完成,确实看不到的状态才保留待验。
需要定位或解释疑点时读非视觉量测与交互探测,
用已有脚本读取计算样式、盒模型、文字和邻接关系,并按需截取带周边的局部。
工具提供事实和观察缺口,设计判断决定查哪里、修什么;候选警报与数值通过都不直接验收。
没有明显错位,仍可能只是把内容放进了剩余空间。说明它应传达什么,再看现有形式
是否形成了可辨的组成部分。克制也应有关系,不因图形少判错,不以次要内容为由免去
设计判断。记录位置、症状、情境与影响,分开观察、原因猜测和审美偏好。
用完整表达建立或恢复风格
从空间关系进入制作:先摆真实标题、内容与动作,认出主体和它的邻接关系;再把
版面主次译成字重、字色、行长和停顿;让表面、轮廓、阴影与操作暗示配合;最后
完成展开、反馈与返回中的变化。这是判断依赖,不是强制分阶段:上层已成立就从
实际缺口进入,细节反过来暴露空间问题时也可重编,不要求每次清空样式重做。
基础问题按规则修正;已有风格成立就恢复其关系,直接打磨局部。风格缺失或互相矛盾时,
先在允许范围内制作完整用法,不让每个角落各自发明样式。
需要建立风格或打破方案趋同时,读 设计语言种子,
按用途选择具体参考对象,在真实内容中生长;已有有效框架时不必换种子。选定后需要
把语言发展成布局、字色形、状态与跨尺寸关系时,读设计决定指引。先理解对象
服务什么、怎样组织内容与行动,再提炼字、色、形、层次和变化如何承载这些原则。
种子保留形神关系与适用边界,不是皮肤菜单;品牌宣传与产品工作区分别分析。
建立或还原语言时,以当前官方已发布参考和实际画面为主,记录平台、版本与核实日期;
分批上线与旧版分别判断。按需用当前设计参考
核实对象,未知保留待核。还原另看角色关系、排版节奏与关键形态的辨识度,原则相近或
功能合理不证明形神到位。缺画面就补参考,已有参考仍欠精致时用
参考工艺对照将差异转成制作决定。
分析新对象时核对构建基础:任务与信息架构、视觉原则、主题/组件实现、资产和生成
指导分别提供什么。模型常见输出、厂商品牌和默认组件样式不自动成为设计语言;
模型及 Agent 产品的取舍例子见 构建基础分析。
从内容与使用情境提出要形成的气质及阅读骨架:谁是主角,哪些是概览、操作、辅助或
收尾,颜色、字形、表面与节奏怎样共同表达这些角色。先做成包含主次与邻接关系的画面,
实际看成立与否,再沉淀可复用选择;不要先写完全部 token 再把内容填进去。
有效方向尚未形成时,试作组织逻辑有差异的表达,比较得到什么、牺牲什么;已有有效
方向不为凑候选重复制作。缺偏好边界时给具体对照,缺视觉做法时查看职责相近的成熟
用法,优先利用项目已有好例子。借关系重新制作,不复制整套风格或把参考名气当证据。
风格框架保存关联选择及适用条件,不保存某页参数作为通用模板。字体、形状或色面
可以表达归属与气质;不同角色不必同一容器,也不能仅因框线相似就强行拆散。探索与
克制都服务效果,装饰多少本身不是质量标准。
装饰可以表达温度、节奏和个性,不因删去后功能仍能运行就认定该删;保留时看它
与整体是否相容、是否损害关键内容和操作。艺术表达与功能关系可以共同决定取舍。
在框架内打磨局部
把局部当作接合处看:标题与正文、轮廓与留白、图标与字形、表面与输入、说明与
动作是否共同表达一种关系。整块定位与内部对齐分别决定,数学等距不代替光学平衡。
不要只问某个阴影或颜色是否漂亮,也问它让这里像什么、怎样使用,以及与周围是否配合。
试作前说明用户会从形式直接认出什么,以及它与所在区域有什么关系,再用完整编排
实现判断。候选只换边线、字号或强调位置而内容关系未变,仍是同一构图的打磨,不能
靠给差异起名声称有新组织。理由自洽不代表画面成立,无明确收益可以撤回整套表达。
视觉锚点不能靠假身份、状态或无功能按钮充实画面。用真实长度和有关状态比较整体
形状、比例、节奏、角色辨认与注意代价。归位可以解决所属关系,但不证明原位置的
表达已成立;两者难以区分时,在相同空间约束下另作对照。
检查当前表达是否完成它的用途:快速把握、密集扫读、逐段比较和连续填写需要不同
组织。样式协调仍可能留下无意义的阅读、滚动或动作。必要时重组前景与回查材料,
保留必要正文和入口,不靠删内容或默认折叠所有长文制造精简。
传播、复验与交付
先在负责位置完成一段用法,复看完整区域与相关动作,再沿消费者差异传播。共享组件、
主题与页面编排各归其 owner;传播相同语义和有效关系,密度与构图参数可按情境变化。
同构用法抽样发现根因,保留未看差异;单页漂亮不能代替用户要求的全量覆盖。
共享修改进入不同消费者,核对实际涉及的长内容、窄屏、明暗、空态或错误态,不要求
不存在的状态。退步先检查复用条件,收缩共享改变或修接合,不逐处堆补丁,也不另建
设计系统来统一外观。
响应式按内容容纳能力判断,不能只看一宽一窄两张端点图。并排区域要给正文、字段、
导航和行动留出真实可用宽度;接近容纳极限时实际调整窗口,看压缩后的行长、动作与
留白是否仍成立,再决定何时重组。断点来自这种关系,不沿用常见设备宽度作为依据。
结构改变后,重新辨认实际滚动容器、操作入口和返回位置;CSS 改成上下排列不证明
阅读与编辑的接续也跟着成立。不需穷举像素,选择会改变组织的边界查看即可。
对照基线复看发现问题的局部与整屏。局部改善不能破坏邻接、状态含义、必要内容或
功能。主题切换、入场或重排有有限过渡时,稳定画面在有关过渡完成后复看;中间帧
的混合颜色不直接证明最终主题故障。过渡过程另实际观察,不能以稳定可读或禁用动效
的截图宣称动态效果通过。
点击完成不等于可见后果成立,外框不溢出不等于内部没有挤压。
沿本批已经记录的症状逐项回看,说明消除、改善或仍存在;参数变化与旁边的问题修好,
不能代替原症状的结果。只看新警报会漏掉无法量测却已经观察到的视觉问题。
同一对象有多个操作时,沿每次完成与返回核对反馈邻接、改变的事实及仍未提交的草稿;
结果文字准确也可能因位置误导用户。必要时回看交互结构参考,不只复看初始画面。
经常配对的动作要走完往返:从所读内容进入批注、从比较对象进入编辑,再回到原对象。
单向入口可点不证明整条路线顺畅;观察是否反复滚动、重找上下文或依赖页首操作,
按任务频率决定是否补就近返回、调整邻接或保留现状,不给所有页面强加浮动工具栏。
字体、颜色与表面关系在相关主题和内容中仍应成立,用户否定的方案保留为反例,
不靠重写理由验收。
交代实际覆盖、共同根因、有效选择、消费者差异、回归、保留项和下一入口。代码检查、
视觉判断、交互观察与用户接受分别记录;无法看页面就保留待验,不称实际复看通过。
预算不足保留可续接的观察和决定,不创建永久扫描状态或默认定时运行。
构图与搭配试作
用于基础秩序已经成立,但画面缺少设计完成度;也用于自主扫描时发现各部件正确却合起来
没有气质的区域。参考对照见 设计决定指引。
目标是培养可制作、可纠正的审美判断,不承诺人格描述能让模型成为设计天才。
需要具体制作素材时看视觉修辞,按当前缺口选择手法及原始示例,
保持已有风格框架,不为了使用某种手法另换品牌。
先看见,而不是先找规则
在正常大小完整阅读页面,再看承担身份、内容、控制和收尾的区域。暂时不读源码,
说清视线先落在哪、随后去哪、哪里停顿或断掉;指出画面位置,不用“高级、简洁、精致”
代替观察。没有功能故障也要看:边框是否切碎同一对象,空白是否围绕主体形成形状,
字色是否有过多同等音量,重要内容是否像被剩余空间收容。它们是调查线索,不是必删项。
从任务选定希望形成的气质及视觉主角。例如长期阅读需要让文字连贯而有停顿;连接管理
需要身份、状态与修改结果相接;两者不必都安静到没有辨识度。让主体获得一种确切的
表达:清楚的排版轴、属于它的表面、可辨的轮廓或真实对象的视觉特征。辅助材料围绕它
配合,不用虚构数据、装饰标题、随机图标或大按钮制造重心。
用画面提出可推翻的诊断
选择最影响整体的一段关系,而不是列完所有 CSS 属性。写一个短假设:哪个表达导致
什么观感,改变后预计哪里会更好辨认或更协调。如果同时把所有字变小、颜色变淡、
间距压紧,却不能说明哪个关系改变,仍未形成解法。
参考只能提供候选;研究它怎样让同一对象连贯、不同角色有反差,以及细节如何相互
呼应。保留源码与画面的冲突和版本限制,不为了对齐一张旧图抹掉本产品的内容。
也不把当前源码合法当成审美不可修改:行为与数据合同限制什么可以改变,旧样式本身
不证明构图已经成立。
试作要产生认识
先区分必须保留的产品语言与可以重做的画面组织。字体、色调、对象身份和交互合同可以
延续,现有卡片嵌套、阅读轴和动作编排不因此成为保护对象。如果诊断指出整体组织欠缺,
方案却只调整 padding、字号和边框,检查是否绕开了诊断;参数修饰不能代替构图解法。
此时可在隔离样板中用同样的真实内容重新编排这一完整区域,暂时摆脱原 DOM 的便利:
先组织主体、辅助与操作的关系,再用已有组件实现。参考中选择一个确切的组织手法,
说明它解决什么关系,再转译到当前内容;不要只拷贝参数,也不要为显得不同另换品牌。
将这个试作与保守修饰放在相同状态下看,允许保守方案胜出,也允许两者都不够好。
对不确定的关系做有区分力的局部试作,连同所在完整区域一起看。可以先临时去掉某种
分隔,看对象更连贯还是失去归属;也可以改变阅读轴、表面层级或动作位置,看重心是否
清楚。临时去掉只是诊断手段,不是默认采用极简。仍缺表达时,另一候选应改变组织或
搭配关系,不只是换圆角或颜色。
内容、对象数量、必要动作和状态保持等价,避免删掉困难内容来赢得比较。用项目已有
字体、组件、资产和表面发展表达,允许有理由的角色差异;不以所有值相同为目标。
新的形式需要把标题、说明、输入、状态和收尾一起做完,不能只留下漂亮首屏。
回看正常大小的整屏,再看局部。确认视觉重量、疏密、空白轮廓和主体形态实际改变;
能用较少解释直接感知收益才支持保留。文字仍是文字,内容稀疏也能有构图;不能把
“更多留白”“更少边框”“更小字号”当成品质的单向尺度。对照没有明确收益,撤回这项
试作或重诊断,别给它换一套理由。
收束到一套搭配
选出成立的整体后,沿它的共同关系检查细节:标题与标签的声音,图标与字形的重量,
表面与输入的层级,外轮廓与内部留白,行长与组间停顿,展开与返回后的归属。只修破坏
这套搭配的细节,不把每个区域独立装修。明暗和窄屏允许重分配密度,主体与操作关系
仍需可辨;鼠标、键盘及触控目标不能因视觉紧凑失去可用性。
从参考借来的局部尺度要回到当前组合核对:短选项可以用短控件,但右侧空白应参与
排版轴、分组或邻接关系;若只是每行停在不同位置,参数虽合理,组合仍未完成。
同样,重要信息前移会占用空间,需回看它是否让常见任务更直接,尤其是窄屏。
交付实际前后画面和仍不满意的部分。自主诊断、制作手艺、参考还原、任务可用与用户
偏好分别判断;独立评审同意不等于用户接受。用户否定时,把产物留下作反例,找出是
诊断不够、表达未做到、评价误判还是偏好未知;不把一次否定机械译成新品牌规则。
当前设计参考与版本边界
核对于 2026-10-03—04。默认以当前官方已发布体验、现行指南和实际画面为主要参考;
历史材料解释演化。抓取日期、文章日期、产品版本、组件库版本与分批上线范围分别记录。
新文章不必意味着新外观,旧发布的形态也可能仍是当前有效指导。
Claude:当前客户端;旧暖编辑归因撤回
参考对象是 Claude 网页/桌面客户端,不是 Claude Code 生成网页、Claude Design
营销页或 Anthropic 品牌 artifacts。此前 claude.html 的暖纸、衬线、陶土与札记编排
只代表一个通用暖编辑试作;撤回其对当前 Claude 客户端的代表性,不作为最新种子。
2026-09-16 公告及
现行帮助
说明 chat 与 Cowork 融合、Design 进入会话,并分批推出。该日期支持功能和入口变化,
不证明用户提到的几个月前视觉改版发生于同日。准确的视觉改版日期与完整新版画面仍
待核实;暂不命名完整“最新 Claude 风”,也不以局部状态替代最新全量体验。
官方 frontend-design 的文件更新定位到
41bbe19,2026-09-03。
它是生成指导,不能补当前客户端外观证据。下一次还原应先拿到当前正常会话、输入、
导航与相关面板的完整画面,再提炼具体关系;不能把“更新”简单理解成改成深色。
Apple:OS 27 的 Liquid Glass 修订
2026-09-14 正式发布
确认 iOS/iPadOS/macOS 27。当前 Design Resources
提供这些平台的 27 UI Kit;其他平台资源仍有旧版号,分别判断,不整体改标 27。
主要设计变化以 WWDC26 102
和 SwiftUI 更新为依据。
相对 2025 初版,玻璃扩散背景、暗边与镜面亮边增强分离,透明程度可调;Mac/iPad
侧栏抵窗口边缘,活跃窗口有强调色,窗口曲率更统一紧凑,滚动进入工具栏区域后有
统一表面帮助可读。核心仍是内容层清楚、导航与控制层随背景和状态变化。
已实际查看官方 macOS 27 kit 缩略图
与 iOS 27 kit 缩略图:
前者是分组表单和嵌套控件,后者包含 sheet 顶缘、圆形浮动控制及透背景 Dock;不能
仅凭表单缩略图推定完整玻璃导航行为。使用时再看职责相近的完整场景。
现行 HIG Materials
仍限制玻璃主要用于导航与控制,不把内容卡片全部玻璃化。
此前 apple.html/apple-v2.html 是资料应用的实色近似;不能当最新 OS 27 的完整还原。
WWDC25 保留为体系起源,经典 macOS 形式仅作历史补充。
Linear:2026 refresh 与近期现行画面
2026-03-12 UI refresh及
设计解释是本轮可证实的整体外观
更新:位置/视图/动作头部一致,导航退让,边界减少、结构仍可辨,默认灰更暖且
降低饱和度。2024 说明只解释前史。
同时核对 当前 changelog:已读到 2026-09-24 的更新,
9 月 Priority inbox 等提供现行画面入口。近期功能更新不能被误称另一次整体视觉
改版;也不能以 8 月 StyleX 代码迁移推断换了设计语言。精确还原时以当前相应场景
画面为主,不能仅凭 3 月原则认证 linear-v2.html 为最新产品复刻。
Material:现行 Expressive,包含 2026 更新
实际用浏览器查看 2026-05-19 I/O 更新、
现行 layout及
canonical examples:
2026 增加 scaffold、spacing 与跨设备指导,组织 bar、rail 和内容 panes,按任务改变
list-detail、feed 与 supporting pane;不是把桌面卡片缩窄堆到手机。
Typography更新栏标 Aug 2026:根据
文字系统高度调整行高与组件尺寸。中文界面需观察实际字形,不能仅按拉丁字体试作。
Lists与
Menus的当前案例有分段列表、选择行、
局部鲜明菜单和层级;其更新栏分别为 Dec/Nov 2025,不能改称 2026 首次发布。
Shape和
Motion的 Expressive 更新也始于 May 2025,
仍属现行指导。观察圆/方张力、按角色变化的轮廓与因果形变;空间运动与色/透明度
变化有不同物理要求,不能到处回弹。表现性字体只在任务相符的重点区域使用,
参考当前 editorial treatments。
Compose 库的 stable/alpha 版号属于实现库,不是整个设计系统统一版本;Web 组件
尚有 Expressive unavailable,借设计不等于现成 Web 库已完整支持。旧 2025 研究可以
解释原则,但新的还原需要当前组件、布局与多语言画面。前两份 Material 试作为原
文字参考实验,v3 已补布局迁移;均未核对全部现行关系。
其他对象的状态
- Figma:当前官方 sidebar 指南
仍介绍 UI3,区分导航、底部工具条和属性;部分旧视频有旧界面提示。2024 博客可
解释演化,不能代替当前画面;本轮尚未核实全部最新工具行为,原试作只作组织实验。
- DeepSeek Harness:原读本地
639ed015(2026-09-29);当前远端 HEAD 已是
5badb15009ae1756c3afe0ae0cef1faafc290ccc(2026-10-03)。Git tree 核对发现 client UI
有变化,原版不再被称为最新。需要沿实际使用的主题、布局与交互重新核对,不因
新 commit 就假设全部视觉已改变。当前源码。
- AgentParty:远端 HEAD 核对仍为
3086c7a,与原研究一致;源码版本仍有效,
原产品实际页面与完整状态尚未运行,原试作不能因此成为最新产品精确还原。
实作校准的边界
内部原型实验不作为公开效果证据。迁移参考时,在相同内容与尺寸条件下检查任务关系、
构图与局部工艺,分别记录实现、实际观察和用户接受。几何检查通过不等于行文节奏成立,
短摘要孤尾、图标光学关系和正常输入状态仍需实际查看。一个场景的迁移成功也不能证明
种子成熟或技能稳定提高设计质量。
模型与 Agent 产品:设计的构建基础
2026-10-03,按用户指定对象查证。相似外观可能来自不同来源:模型默认生成倾向、
生成指导、厂商品牌、组件库底座、自建主题或具体业务编排。先分清来源,再决定能否
提炼种子;不从模型名称推断训练数据、隐藏提示或作者身份。
本轮取舍
| 对象 | 已核实的构建基础 | 如何吸收 |
| Claude 生成 UI | 官方 frontend-design 是选方向、构图和反模板的方法;artifact builder 另有 React/Tailwind/shadcn 底座 | 方法来源与反模板样本,不能当统一风格 |
| Anthropic 品牌/Claude 产品 | 品牌 skill 有色板与字体;这不是当前 Claude App 的完整设计体系 | 品牌候选,产品语言另核对,不以品牌参数直接收种子 |
| Codex 生成 UI | 公开提示与 frontend 指导;区分已有设计系统、应用与营销 | 方法来源;应用指导部分借 Linear,不另造“Codex 风” |
| Codex 客户端 | 项目/任务/对话/审查等工作区结构,与生成网页指导不同 | 领域结构例子;完整视觉语言尚未核实 |
| DeepSeek Harness | 上游设计平台与 deepsuite 变量、自写主题/控件/布局、对话和输出阅读结构 | 固定版本结构参考,当前外观待复核 |
| AgentParty | 自写 CSS、作者博客品牌演化、终端事实与协作信息架构 | 有明确形神关系的独立候选,待页面观察 |
这是当前证据下的取舍,不按名气或“有独特样式”自动入选。已有库不是缺点,自写 CSS
也不证明优越;关键是哪些关系经过有意组织、怎样服务任务、能迁移到什么范围。
Claude:当前客户端与生成基础分开
此前将“温暖编辑风”归为 Claude 代表的判断已撤回。任务明确指当前网页/桌面客户端,
生成指导和品牌色板不能代替现行完整画面。其版本、实际观察与待核实范围见
当前设计参考。
通用暖编辑表达可以保留,不能继续宣称已还原当前 Claude。
官方 frontend-design
要求根据 brief 形成方向,并列出常见生成模板:暖奶油与衬线/陶土强调、暗底鲜亮强调、
报纸细线、同质圆角卡片等。它明确这些形式可适合某些任务,问题在于不随任务选择。
用户指定方向仍优先。因此它不支持“Claude 总应长成暖纸衬线”,也不是对这些风格的禁令。
web-artifacts-builder
提供 React、TypeScript、Vite、Tailwind 和 shadcn/ui。这解释一种可见实现底座,不能证明
所有 Claude 输出都来自它,更不能证明 Claude 产品自身的 UI 使用同一套组件。
brand-guidelines
另提供 Anthropic 品牌的深浅色、橙/蓝/绿与 Poppins/Lora 字体角色。它服务品牌 artifacts,
不能把其中字体直接当 Claude App 现行字体合同。色板证明识别选择,尚不足以解释完整
导航、对话、输入与状态关系;候选语言也不应被缩减成这份品牌参数。
另外,官方 Claude Design 说明
与 Artifacts 说明
交代输出可用用户的设计系统,成果在对话旁继续编辑。它们分别支持生成基础与产品组织,
不能将生成成果的配色当宿主 UI 的配色。
Codex:公开前端方法不等于客户端风格
Codex Prompting Guide
的前端提示要求选方向、避免套用默认、跨输出变化,并保留已有设计系统。
OpenAI 前端设计文章
强调构图、内容、参考与验证;其中应用指导明确借 Linear 的节制、可读密度和工作区分工,
营销部分则是另一种表达。这是生成方法,不是名为 Codex 的固定字/色/形体系。
公开建议中的避免默认字体、默认卡片等,需要按具体目标吸收,不能升级为本 skill
对系统字体或所有卡片的禁止。DeepSeek Harness 用系统字体就有自己的任务与平台依据。
客户端发布记录 说明项目侧栏、任务线程与审查面板,
支持工作对象和结果审查的结构。客户端自身、CLI、模型和 frontend 指导是不同对象;本轮
没有核对当前客户端完整 token、所有页面或源码,不把稀疏中性外观提炼为已证实的视觉哲学。
DeepSeek Harness
实际只读本地相邻仓库,版本 639ed015397290b3745d163aafe02ffee4aa3f84。以下链接固定版本:
可保留为固定版本 Agent 对话工作台结构参考:阅读与输入保持主轴,过程和成果可回查,辅助区域按职责
分层。源码支持这些关系,但没有证据表明它们来自模型自动生成风格,或必然直接继承
Apple/Claude。上游设计稿未独立回查,不能继续猜测其更早来源。
AgentParty:博客品牌演化与终端协作
只读浅克隆,版本 3086c7a82b147defe8b39591bbf4fec52bf043bf。
package.json
是 React/Vite 与自写 CSS;桌面 Tauri 复用 Web 构建,未见以 shadcn 等作全站控件底座。
历史设计
明确参考作者博客;当前 tokens
与 doodle.css
已是 neo-brutalist terminal:米纸、方角墨线、淡墨硬偏移、珊瑚强调和等宽字。已取消
抖动边框与手写标题,不能让旧设计记录覆盖现状;hover/pressed 位移延续纸片隐喻。
团队面板设计
按分工、Agent 看板与协调组织内容;状态、待处置与回查是协作事实,不随纸色复制。
可提炼“终端式精确材料与较亲切的实体表面并置”,但这是源码与用途的解释,不冒充
作者已确认的完整哲学。硬影只是部分形式,不能据此推定两个产品的服务价值或任务组织相同。
保留候选及领域例子。官方 hero 是宣传插画,图标 sprite 仅能说明资产;本轮未运行
真实页面,不能评价完整密度、响应式和注意代价。源码不足以确定 UI 的生成模型。
下次如何核实候选
填写型界面看引导、长内容输入、错误、返回和完成;协作型界面看频道、长消息、
成员与任务状态、协调操作和窄屏。完整观察再检验内在原则是否被实际形式承载,发现
问题可收缩种子或撤回,不靠设计文档替视觉验收。模型输出倾向若需验证,应固定任务、
环境、模型与可见指导并观察不同样本,不能用一张生成图推断模型本性。
将种子发展为一套可执行的设计
在选定语言后使用。本指引把任务关系转成布局、字色形、状态与尺寸的共同选择;
对象依据和版本见种子与当前参考。
这是迁移指引,尚未经过跨任务稳定性验证,不是品牌复刻规范。
从任务确定骨架
控件、信息层次或跳转本身不合理时,先用交互结构核对活动,
再进入视觉骨架。风格不能把不适当的select、modal或分步流程包装成合理选择。
先找用户操作的对象、反复发生的行动,以及行动前需要知道什么。选择一个主要阅读/
制作轴线,再放定位、比较、操作、回查与收尾。不要预设每个任务都有侧栏、三个 pane、
一张大卡和一个固定底部输入框;这些结构必须能解释真实需求。
| 任务关系 | 合适的起点 | 改变布局的触发 |
| 对多个对象反复比较属性、切换详情 | 稳定列表或表格 + 当前对象详情 | 属性可同屏比较才用表格;长标题与少属性适合列表 |
| 长时间阅读一个对象,再行动 | 连续阅读轴 + 相邻行动,定位退让 | 窄屏可将选择器移至可返回入口,保留对象名称与切换途径 |
| 实际制作/修改一个作品 | 制作对象居中,参考与属性辅助 | 只读材料不是作品;没有制作对象就不强造画布 |
| 顺序填写或理解一项任务 | 引导、必要材料、输入、结果连成顺序 | 回看或分支很多时用稳定步骤定位;不要强迫无关步骤 |
桌面多栏只是同时看多个角色的一种方式。窄屏先判断哪些需要同时出现,哪些可以
切换;长时间阅读可从单 pane 开始,即时对照或批注可能仍需并列辅助区,反复比较可
保留紧凑概览。给切换对象、返回与草稿明确归属,
不能为了短首屏把必要材料删掉。更多留白、更多密度都要由任务解释。
让一组形式共同承担职责
先选能区分主体、导航、控制与结果的关系,再协调局部数值。原型可从少量关联选择
开始,不必先写完整 token 系统。
- 字:标题表达对象或动作,正文保证连续阅读,状态帮助扫读,说明弱于正文但仍
可读。展示字体只放在有表达职责的位置;中文实际字形、行高与换行须实看。
- 色:先让前景与背景可读,再分选择、动作和业务状态。当前选择不等于成功,
不能用一种强调色代替全部状态;错误不能只改变颜色。
- 形与表面:给同一职责相近轮廓,不同层级可变化;嵌套关系先看内外边距与曲率。
阴影和透明度表达层次,装饰不能把所有面提升为前景。
- 空间:同组更近,跨组有节奏,文字与操作有明确归属。先看整屏重量,再看
图标与文字的光学关系;只有数学等距不足以证明正确。
- 变化:展开、选择、输入、反馈应能追溯到触发对象。动画用于说明变化,减少动态
时仍能理解;未实现的动态关系不靠静态截图认证。
若整体趋同,先确认是否损害目标:同一任务可以共享有效骨架。组织成立时,核对
字体角色、表面层次、控件轮廓与强调的关联形式,不必为了差异重排布局。若风格成立而局部不协调,修局部,
无需换种子。若混合语言,按区域职责组合并共用状态意义,不把多套强调系统叠起来。
参考工艺对照
用于目标语言已经选定,但实现只有相似外壳、缺少精致感的任务。先找参考中职责相近的
完整页面或区域:阅读对阅读,填写对填写,对象管理对对象管理。聊天页只能证实聊天的
组织,不足以指导全部设置或资料页;没有对应页面时,明确借哪一段关系,其余仍需设计。
保留参考截图与当前基线,注明视口、缩放、主题和状态。尽量用等价长度、数量和角色的
内容比较;不要让参考的短标题、空白状态或精美素材替实现赢得比较。参考无法替换内容时,
先区分内容造成的差异与编排造成的差异,再用项目真实内容检验迁移。
将眼前画面拆成“关系—承载方式—决定性细节”。例如辅助说明弱于输入区,是关系;
通过贴近字段、较小字级和较轻前景实现,是承载方式;实际行高、换行宽度和与下一组的
距离决定它是否安静且清楚。记录能在画面中指出的依据,不以“高级、克制、清晰”代替。
量测可帮助找比例和差值,不能把不同内容、字形和用途强压到相同像素。
按当前最大差异制作,通常从整屏向内收敛:
- 骨架与重量:主体宽度与起点,导航、标题、内容和动作各占多少注意;哪些区块靠
排版相连,哪些确实需要容器。先修共同轴线与组间关系,避免在失衡骨架上磨按钮。
- 字与密度:实际字体及回退字体、字重、字号、行高和行长怎样形成层级;组内紧密
与组间停顿是否不同。检查中文、长说明和真实标签,不从 CSS 字体名推定已呈现。
- 表面与轮廓:背景到内容面、输入面与浮层的层级是否清楚;边线的明暗、内外曲率、
分隔和投影是否共同表达角色。主题色相同而每组都加框,仍可能改变参考的整体语言。
- 局部与变化:图标的笔画、可见大小与文字的光学对齐,控件内边距、焦点、悬停和
展开后的邻接关系。稳定初态接近不证明活动时仍精致。
不是每次重做全部层次;上层已经成立就保留,从有证据的缺口进入。每项重要变化说明是
忠实迁移、为业务或平台适配,还是仍缺参考。适配要给出具体约束与视觉代价;不能把
所有偏离归为“允许变化”,也不为复刻造无功能控件或删必要内容。
制作后在一致条件下并排看整屏和关键局部,也回到正常大小实际使用。先说明原差异是否
缩小,再判断是否牺牲了其他关系。若改完只有参数变化却无法指出画面收益,撤回或查
上一层原因;不要靠更多装饰补偿。保留两条结论:任务与动线是否成立,参考语言和工艺
是否到位。前者通过而后者未到位时,仍是待打磨的实现,不以功能验收结束还原工作。
各种子的设计决定与反证
Apple 平台关系:稳定内容,清楚控制层
用于内容浏览和直接操作。先做连续、可读的内容面,再把定位与控制放到可区分的
功能层。字级随内容任务,系统字体与克制强调优先;选中态、嵌套控件与工具条共同
帮助定位,不以巨大窗口曲线替代内部设计。
Web 迁移可以用实底控制面、亮边或轻投影;透明必须有真实背景并保持可读,正文
不做玻璃。滚动、展开和返回保持操作来源,窄屏只留当前所需控制。内容被材质遮盖、
卡片全漂浮或操作来源失踪时,撤回相应形式。不能声称 CSS 具备原生光学保障。
Linear 工作区关系:稳定定位,丰富内容,外围退让
用于高频对象管理和比较。头部明确位置、当前视图与该视图动作,跨视图相同职责
保持位置;导航降低竞争,主体保留足够清楚的属性、选中态与动作。紧凑无衬线、
暖中性色与少分隔共同服务扫读,不能单凭灰色或小字形成语言。
布局由比较需要决定:少对象不额外造全局工作区;对象属性多时形成稳定行列,长文
详情另用合适阅读宽度。窄屏让比较属性保留身份,可变为每对象分组,不能截掉关键
状态。只有三份资料不能验证密度;如果所有文字都弱、必须猜行归属或导航比任务
更抢眼,先修层次。按内容重做,而不是固定三栏。
Material 表达关系:熟悉操作骨架,关键动作鲜明
先确定主要动作及其对象,选择 list-detail、feed 或 supporting pane 等任务相符的
组织。bar、rail、pane 不必全部出现;分类不是产品级导航时可以使用局部筛选。
以一组色阶区分背景、分组和选择,按角色变化轮廓与尺度;主动作通过位置、尺寸、
颜色共同清楚,辅助动作保留名称并退让。
正文使用稳定的字级与表面,表现性标题只用于真正需要强调的内容。窄屏选择单 pane
或保留概览须由使用频率决定,返回保留当前对象和草稿;焦点随实际重绘留在合理
位置。若鲜明输入区夺走阅读、各按钮同样突出或陌生形状妨碍辨认,降低表达强度。
Expressive 不等于紫色、大圆角或到处回弹。
Figma 制作关系:作品占主轴,工具与属性随对象
保留为制作型任务的组织参考;完整当前外观尚待补齐。先找实际编辑对象,制作工具
紧邻工作,定位和属性分别承担导航与检查;只读参考放辅助位置。输入控件、标签、
焦点和选中对象共同说明正在改什么。不能为了模仿工具台发明没有作用的工具栏。
窄屏需要切换辅助面时仍能返回作品,不把参考升为中心、把制作挤到角落。
编辑式手绘:角色叙事进入任务,操作区安静
先决定谁在做什么,再用原创角色与少量平涂色组织引导,
让黑墨轮廓与稳定无衬线承接内容;在这个种子中,角色插画以叙事组织引导。
这不是所有装饰插图的通用要求;其他表达可由温度、节奏和个性成立,仍看整体相容性。
进入填写/比较后减少装饰密度,功能图标保持熟悉与对齐。不要把边框全画歪或用
手写字体承担长文。若角色妨碍扫读、引导比工作更长,收缩叙事区域。
Claude 当前客户端、DeepSeek Harness 与 AgentParty 暂作有边界的案例:前者缺正常
会话/输入完整证据,DeepSeek 当前源码变化未完成复核,AgentParty 缺原产品运行
画面。可借已证实的局部关系,不能当完整设计规范。暖编辑旧试作可作一般阅读气质
对照,不能再代表 Claude。依据边界明确时,不为齐全把所有案例升级成种子。
怎样检验指引已经有用
在真实内容里看主体、辅助和行动是否一眼能分辨,实际完成切换、输入、返回与反馈;
再检查整页、局部、窄屏和当前任务有的长内容/空态/失败态。短摘要孤尾、图标光学
错位与次要区域缺设计都不能靠“没有溢出”排除。错误反馈属于原动作,成功结果属于
原对象;克制的空态也要说明为什么空、下一步是什么。
迁移验证选择未参与调参的新对象,让执行者只接收任务、skill 和所需参考,先留下
设计决定及其依据,再看产物。评审分开检查任务满足、形神关系、视觉质量与偏好;
原型合理不认证品牌还原,用户喜欢也不能抵消操作丢失。新业务仍需自行设计具体流程;
执行者无法由指引确定主体、辅助、动作与跨尺寸关系,或只能照搬旧样板,才说明迁移
指导不足。若是手艺漏项则修局部执行,不不断膨胀方法。
从真实对象提炼设计语言种子
先研究具体对象,再总结语言。本轮选择 Apple 平台界面、Linear 工作区、Material 3
Expressive 与 Figma UI3:它们公开了设计意图、具体表达及适用边界,部分有改版反例。
这是有依据的对象选择,不是本轮测得的流行排名;一个场景也不代表品牌的全部设计。
初查于 2026-10-03;当前版本和后续纠正以当前设计参考为准。
Apple 已更新到 OS 27,Material 补 2026 指导;Claude 暖编辑归因撤回。此前凭气质编出
的六组分类撤回,不作为成熟种子。旧试作的形式辨识不能替代现行版本核对。
另保留有公开源码依据的 DeepSeek Harness 历史结构参考,范围限定于阅读、
输入与过程回查,当前版本外观未复核。Claude/Codex 生成指导、厂商品牌及 AgentParty 候选的
构建基础与取舍见 构建基础分析,不按名称全部收种子。
Apple/Linear/Material 保留为有现行依据的迁移参考,Figma 保留制作关系与修订反例;
Claude 完整客户端、编辑式手绘与纸面终端等仍为候选。没有一个已获稳定产出或用户
审美验收。内部实验不作为公开效果证据;使用者仍需在自己的任务中检验。
选定后如何形成设计,读设计决定指引。
“神”是从对象中提炼的服务价值与组织原则,“形”是承载原则的具体表达,“生长”是
迁移建议。下面不提供品牌皮肤或待导入的组件库,也不把官方意图当迁移效果实证。
审美语言与代表样本
参考产品也可以帮助识别可迁移的审美语言,不必以品牌名称命名所有种子。以下是工作
命名,不宣称行业已有统一分类;手绘与暖编辑在这里都是通用构成建议,
不代表某个客户端或已验证的产品案例。完整页面及迁移效果仍需检验。
构建依据见分析。
编辑式手绘(Editorial Doodle),通用构成建议。 黑墨轮廓、局部不规则线条、
简化人物与猫、少量平涂亮色,配合稳定的无衬线正文和清楚的控件。这种手绘的核心
是有编辑意图的叙事:插画解释谁在做什么、引导进入任务,视觉人格随任务负担退让。
首页可以活泼,填写时安静,管理页优先扫读。迁移时先找到产品的叙事角色,再组织
场景与装饰密度;不要把所有边框画歪、改成手写字体或到处贴吉祥物。硬描边与硬影
只是部分形式,不能单凭它们把整套语言概括为新粗野主义。
温暖编辑风(Warm Editorial),通用旧试作;撤回 Claude 当前客户端的代表归因。
暖白/奶油底、近黑文字、陶土强调、富有阅读节奏的排版,常以衬线展示文字搭配实用
正文。公开 frontend-design 确实列出了这一常见组合,但它不是当前客户端外观依据。
当前 Claude 的正常会话与桌面完整新版画面仍待核实,不以该组合填补。
这里提炼的是一种可辨认的语言家族:用纸面阅读感、克制层级和温和强调营造思考与
交谈的气质。该气质是设计解释,不是已测得的信任提升。迁移时让长文本、结果和
行动形成清楚的阅读节奏,按内容选择字体角色;不要只把背景染米色,或让暖色、
低对比和衬线妨碍密集操作。品牌 skill 的字体不能直接充当 Claude App 字体证据。
两个种子都可以亲切,但表达机制不同:编辑式手绘靠角色与场景叙事,温暖编辑风靠
阅读、字级和语气。试作应检验这些关系,不仅比较配色。候选状态表示效果待检验,
不意味着否认可辨认的风格本身。
选择起点
| 对象与研究范围 | 核心关系 | 适用起点 | 容易借错的形 |
| Apple 平台界面,OS 27 现行修订 | 内容主导,功能层清楚,操作与空间关系连续 | 内容浏览、跨尺寸导航与直接操作 | 全页玻璃、统一大圆角、仅静态模仿 |
| Linear 工作区,2026 refresh 与现行参考 | 保持工作密度,稳定定位,按职责分配注意 | 多视图任务与属性比较 | 灰紫暗色、小字、全部低对比 |
| Material 3 Expressive,含 2026 更新 | 情绪表达与关键动作识别共同设计 | 主动作、分组与情绪连接 | 满屏彩色、任意形状、破坏熟悉操作 |
| Figma UI3;品牌另分析 | 作品居中,工具可达,熟练工作不断裂 | 制作对象、编辑器与属性检查 | 品牌海报或悬浮面板直接套工作台 |
| DeepSeek Harness 客户端,固定源码版本 | 阅读、输入与过程回查相接,辅助区域分工 | Agent 对话工作台与设置 | 灰白圆角皮肤、照抄会话业务 |
先匹配内容、行为、期望气质及项目约束。已有有效语言时沿用,不因种子重新改版。
产品与宣传、原生与 Web、不同年代分别核对;需要更多细节时回到具体对象与来源,
不只根据名称生成。以下提炼名称不宣称是品牌的官方流派名。
Apple:内容、功能层与连续操作
为何选。 当前以WWDC26 修订
和 OS 27 设计资源为主,WWDC25 说明只解释
体系起源;HIG Materials
区分内容与控制/导航层。对象是平台界面,不从 Apple 产品广告推导日常操作。
神。 内容是用户来使用的对象,工具帮助行动而不遮蔽对象;几何、层级和变化让
人理解所在位置、正在操作的对象及结果来源。跨尺寸与状态仍保持这些关系,才能形成
完整感,不能简化为白色、留白或玻璃。
形怎样承载神。 新体系协调嵌套曲率、边距与比例,而非所有圆角同值;保留光学
偏移,触屏胶囊与密集桌面的圆角矩形按用途分工。提醒与引导中的较强字重、左对齐
加强阅读结构;展开的操作与触发来源相接,布局和分组建立层级。这些具体关系见
体系说明。
Liquid Glass 给导航与控制一个可区分的功能层;材质指导
限制它进入内容层并要求克制。材质演讲
将运动、环境适应与可读性一起设计。单个 CSS 模糊背景不具备这套组合行为。
怎样生长。 在内容页划清阅读面、导航与临时操作,先制作触发、展开、返回之间
的关系,再协调字级、形状与表面。Web 可用实色与较轻过渡承载原则,保留自身品牌。
圆角、透明度和运动不是任意组合的独立旋钮。
反例与边界。 正文也做玻璃、叠玻璃、全部动作同等着色,会破坏层级,官方已有
反例。变化若使人追不住操作对象,漂亮单帧也不成立。迁移后另检查真实内容、窄屏及
减少动态/透明度的表达;原生框架的保障不自动存在于 Web。
Linear:密集工作中的稳定与退让
为何选。 2024 重设计
和 2026 更新 说明结构及具体修订,
能分析功能增长怎样破坏一致性。研究工作区,不是营销首页。
神。 事项与推进关系可定位、可比较、可行动。保持丰富密度,同时让完成定位的
导航退让;同类动作不能随视图漂移。
形怎样承载神。 2026 更新分配工作内容与导航的视觉重量,收减多余图标、边界
及装饰,恢复头部动作的可预测位置。官方对照图中选中项仍明确,非活动项退让,图标
尺度与组间距同时变化;这是注意关系的修改,不是全页一起调灰。
见更新说明及前后图。
怎样生长。 在列表、详情与另一种实际视图中固定位置/视图/动作的职责,保留
必要属性与状态的扫读关系,再减少外围竞争。明暗、字体、强调色可变,任务主次与
定位不能丢。密度由真实操作决定。
反例与边界。 小字、弱化所有文字或低密度大卡片都不自然产生这种语言。官方
自定义主题与改版也反证某个灰紫色不是本质。边界变弱必须以归属仍清楚为前提;
学习引导与长文阅读不能机械套用高频工作区密度。
Material 3 Expressive:表达帮助看见关键动作
当前制作还须读2026 更新与现行案例:
scaffold、跨设备布局及文字系统高度等已更新。下面 2025 研究解释原则,不能单独代表
最新完整形式;旧发布时间的组件也可能仍是现行指导,不能为“最新”擅改历史日期。
为何选。 Google 官方研究
给出成功案例和失败反例。其报告支持特定案例,不能直接外推成本项目的效果。
神。 情绪表达与功能识别一起设计;色彩、尺寸、形状和分组帮助辨认重要对象
与动作,不给全部控件添加同等兴奋感。
形怎样承载神。 邮件案例把发送放在与输入相邻的位置,协调尺寸、色彩与容器。
实际案例图仍保留正文、工具和输入区的稳定分组;鲜明表达不要求每个元素都特殊。
怎样生长。 先确定关键动作,再让位置、尺度、轮廓和颜色共同支持它,辅助动作
可辨而退让。表达强度根据任务和品牌改变,不照抄案例配色或把所有按钮做成焦点。
反例与边界。 官方无序专辑图片方案虽被认为新颖,却损害播放列表识别;去掉
动作文字也伤害使用。保留熟悉结构与必要标签,金融和密集工作另作取舍,不能预设
所有用户都偏好强表达。本节案例与反例见官方研究。
Figma:作品主导,工具帮助制作
保留制作关系参考;现行完整工具/属性状态与连续制作效果尚未核实,不提供 UI3 完整外观规范。
为何选。 UI3 初始方案
与 反馈修订 留下漂亮方案失效的
记录,能判断服务价值为何要求改变形式。
神。 用户作品在中心,工具随制作对象组织;新人能理解,熟练者能连续操作。
清爽要与工具识别、可达和工作空间同时成立。
形怎样承载神。 画布、文件/图层导航与属性面板分工;输入背景、下拉边界、
图标与完整标签区分控制。悬浮侧栏曾挤占小屏画布、干扰工作,后来收回;标签也因
可访问性问题调整。见修订说明。
保住内在价值可以要求舍弃已发布形式。
品牌与工作区的区别。 品牌语言
用可选择、组合和变换的几何物件表达共同制作。它启发创作入口与叙事,不能推出属性
表单也应大色块和混合字体。活跃品牌与克制工作台服务不同角色。
怎样生长。 把工具与当前对象、反馈和作品空间连起来;控制区可换主题与轮廓,
不隐藏必要标签。宣传区借制作关系表达参与,工作区仍保持稳定定位。五色图形没有
制作关系,只是标识模仿。
反例与边界。 不为悬浮美感增加命中负担,不从海报推导工具密度;没有制作对象
的任务页也不用强造画布来接近 Figma。
DeepSeek Harness:对话阅读、输入与过程回查
以下为固定版本历史结构分析。当前远端变化见版本边界,
在主题、正常对话与过程回查复核前,不称现行完整语言。
对象与基础。 研究的是本地 deepseek-harness 的客户端,版本 639ed015397290b3745d163aafe02ffee4aa3f84,
不是 DeepSeek 模型生成网页的统一倾向。主题、React primitives 与对话布局共同实现
它的表达;CSS 明确引用上游 deepsuite 变量和设计平台值,不能归于 React 默认样式。
具体源码和证据层次见构建基础分析。
神。 从实现提炼:连续对话是阅读主轴,输入是持续可用的行动入口,过程与输出
保留回查关系;导航、设置、辅助工具各有职责,不与正文等权。这是对源码关系的解释,
不宣称代表设计团队全部哲学。
形怎样承载神。 系统与 CJK 字体承担阅读,品牌字另分角色;中性色面、文字和
边界有语义层级,强调与状态有专用色。输入、对话、队列等沿共同宽度轴线组织;
工具结果使用适合内容的阅读形式,结束过程可展开核查。设置页采用分区导航与信息行,
不将所有页面复制为聊天布局。
怎样生长。 对 Agent 工作台先建立阅读—输入—过程/成果的关系,再协调导航、
相关动作与设置。保留宿主的会话、草稿、权限与运行事实;参考项目有会话列表,不意味着
另一个产品必须新增会话业务。宽度、控件尺度和圆角按消费者改变,而非抄整份数值。
反例与边界。 仅抄灰白背景、圆角输入框和蓝色仍缺内容组织;只展示最终答案又
去掉必要过程与来源,也丢失回查关系。密集表格、长文出版或品牌营销需要自己的构图。
原生 macOS 材质不自动由 Web 复现,不能用阴影声称平台效果相同。
以上关系由公开源码提供结构参考,不证明当前画面或跨项目效果已经确认。
使用与继续提炼
从组织原则到可辨的表达
从组织原则到可辨表达时,Apple/Linear 可能退化成普通侧栏和表单,
Material 也可能只剩紫色与大圆角。以下是针对这些风险的制作线索,
不是官方 token,也不是通用界面的统一参数。其效果仍需实际试作。
- Apple 平台界面:先明确所借的平台与界面类别,再协调工具条、分段选择、侧栏
选中态、内容字级和控件曲率。控制区域可成为轻、紧凑且与内容区区分的表面;正文
保持稳定实底。不要用巨大的圆角外壳替代所有内部关系。需要层连续性时,让来源
展开与触发位置相接;Web 的浅色、轻影或透明控制面只能作为近似,不能宣称原生
材质复现。回到上文官方演讲中的完整场景核对,不只看单个按钮。
- Linear 工作区:位置/视图/动作形成紧凑、可预测的头部,比较用的资料属性
在主体中有稳定的行列关系;侧栏承担定位而非全部资料展示。详情或记录操作按
当前对象相接。用适度字级、低竞争导航和较少分隔共同建立密度,不只换灰紫色。
可依据官方头部与改版对照
核对关系。材料只有三项时保留真实空白,不虚构事项;这种样板不证明大密度表现。
- Material 3 Expressive:主动作的容器、尺寸、位置和形状共同形成焦点,辅助
分组可以采用不同但相关的轮廓与色阶。先检验焦点与稳定阅读是否同时成立,再
借熟悉结构上的局部形变或有因果的运动发展表达;不是所有区域同样放大圆角。
每处显著形态都要有职责,不能为了“像 Expressive”添加装饰按钮或破坏标题换行。
Figma 还原先确认真实制作对象,不能把只读参考铺成中心纸页、把实际编辑器塞到
边栏来模仿画布。DeepSeek 的持续输入与主轴要结合内容长度,少量摘录不必为固定
底部输入制造大段空白。编辑式手绘和温暖编辑风的识别组合见前文,不能仅据暖底色
把它们与 AgentParty 的等宽、方角、实体按压混为同一纸面风。
选一个主种子,说明任务为何匹配、保留什么核心关系、允许怎样改变形式,再制作
真实主体、辅助区域与相关状态。无需试完全部种子;已有方向不凑候选。混合时交代角色
如何衔接,例如工作列表与阅读说明共享状态语义而使用不同节奏。
检查形神是否相接:当前形式帮助谁理解什么、完成什么?换掉它会损害什么关系,
哪些形可以改变?只剩品牌相似度的,回到对象分析;也不只抄“内容优先”口号,必须
做成字级、几何、分组、状态与过渡的具体表达。
新增种子先说明对象选择,限定年代、平台与产品/品牌范围,核对官方意图和完整案例,
寻找修订或反例,再提出迁移条件。缺证据保留为候选,不为目录齐全补流派。独立试作
决定哪些关系有效,不能靠种子名字直接验收。
本轮证据范围
读取官方说明与 Apple 演讲文字;本机 Chrome headless 打开资料页,另实际查看 Linear
前后对照和 Material 邮件案例原图。整页截图有延迟加载的空图,不把空图当已看案例。
未登录工作区、运行原生 Apple 应用、观看全部视频或执行用户任务。案例支持局部分析,
迁移建议仍需试作,不能称全部语言都已验收。品牌资源仅研究引用,不复制为项目资产。
给新人的设计手册:从看见到做成
先把一页界面当成一件完整作品看。里面有人走动、有东西被使用、有文字被阅读,也
有变化发生。建筑、工业设计和平面设计提供了观察它的不同方式;最终都要回到具体
界面,不能让比喻代替制作。
这里的立场是:形式由多种关系共同形成,功能与美感都值得判断。材料配方已有来源
与样片,见表面与动效配方;本页是工作指导和教学
推演,不是设计史结论或效果已经证明的理论。
我喜欢用哲学追问一个选择的根据,但答案要能落到作品上。局部好看,放进整体是否
仍合适?统一之后,角色差异是否还清楚?功能已成立,美感还有哪些未完成?碰到
矛盾时比较具体方案的所得与所失,不先用“形式服从功能”或“审美是主观的”结束判断。
某种做法在一个情境成立,不证明它在另一个情境也该采用。
先安排相处方式
想象一个人进入页面。他要在哪里辨认方向,在哪里停下来阅读,在哪里作决定,做完
之后回到哪里?这些问题决定内容的邻接与尺度。需要反复比较的对象应容易相互参照,
修改结果应回到原对象,长期阅读应有连续的正文空间。
留白也是空间。它可以围合内容、让章节停顿、为操作留余地。先看内容形成什么形状,
再看空白怎样围绕它。把距离都放大,会像房间都很宽却没有可停留的地方;一味压紧,
又会让所有内容挤成同一种声音。
用真实标题、说明和动作摆出关系,暂时不靠投影与装饰补偿。主角没有明确位置时
先改编排;位置合适但表达平淡时,用字体与材料发展它,不强制推翻有效布局。
让表面说清使用方式
器物的把手、接缝与材料暗示怎样使用。界面的轮廓、表面高低、状态与反馈也参与
这种暗示。看卡片时,除了投影是否漂亮,也问它像静止内容、可选择对象,还是
正在被拿起的东西。决定了角色,再选阴影、描边和色面。
材料成组做:浅色浮层的投影与表面、暗色浮层的亮面与边缘,共同说明层次。字段、
内容面和外壳的圆角与留白要协调。每层再加框,可能让一个对象变成几个小盒子;
接缝可以成为表达,但应落在确实不同的职责之间。
颜色、质感与轮廓也能带来温度或性格。看它是否与作品相容,是否使表达更完整,
不要仅因删去后功能仍能运行,就认定该删除。同样,有名字、有参数也不证明值得保留。
让眼睛有路线
标题、正文、说明和动作组成一段阅读关系。先决定哪件事应先被认出,哪件事随后
解释它,再安排字重、字色、行长与停顿。字体家族保留,不等于字级必须保留;放大
标题也未必能解决主体缺失。
重复给人稳定感,变化标出角色。相同对象用共同阅读轴,标题与说明组成开头,章节
间留出不同于行间的停顿。安静仍应有主次反差,鲜明则让强调集中在真实内容上。
少量文字先形成完整内容块,再决定整块位置。整块居中不要求逐行居中;保留内部
左对齐,也可以让外形稳定、文字易读。实际看光学重量:图标盒子等大,笔画未必
等重;数学居中未必看起来居中。
控件像一件小器物,也有自己的组成。沿标签、当前值、箭头、边缘实际看一遍:文字
与箭头是否挤在一起,内外留白是否相配,字号与同排说明是否像同一套表达。使用
原生控件可以保留成熟交互,却不会自动带来完整视觉;在实际浏览器里看展开与焦点,
优先补足样式或复用已有实现,不因为外观欠缺就从头造一个下拉框。
例如一行有字段标签、短值选择框和跳转动作:先让值与箭头在框内相处,再把标签与框
的距离、文字基线和相邻动作一起调整。控件放大后,标签可能显得更弱,焦点外圈还
可能侵入标签留白;闭合态内部变好,不证明这一行已经协调。分别看内部与整组的
改前、改后画面,按最初症状判断收益,保留未解决的关系。它仍可以是原生 select,
也不要求所有行都做同高按钮;各角色应清楚,重量与间距需共同组成这一行。
把时间也设计完
展开要让人知道内容从哪里来,保存要让人知道改了什么,返回要让人重新找到位置。
先确定状态与动作的关系,再决定动画属性、距离、时间和曲线。短动作可以近乎即时,
较大变化可以给一点跟踪时间,尺度仍由用途决定。
过程和结果都看。一张展开终点可以漂亮,途中却把正文推来推去;成功反馈可以正确,
却出现在另一表单旁边。快速重开、取消与返回会揭露静态画面看不到的问题。减少
动态时也应知道发生了什么。
制作示范:把散落对象做成集合
设想页面展示几条连接,每条包含名称、模型、状态和编辑;展开后有字段、影响说明
和保存。这是教学情境,下面两种选择都可能成立。
用户反复比较模型时,可以试共同的身份—模型—动作轴,同行对象用重复节奏相连,
展开对象获得完整编辑面。每条连接有丰富、独立内容,需要分别辨认时,卡片可以
保留。决定来自对象关系,不来自“卡片过时”或“无框更高级”。
选连续列表后,先做真实文字与动作,让展开身份、字段、说明和保存属于同一对象。
再协调材料:静止行用轻分隔,编辑面用相容浅底,输入保留可辨边界,保存获得必要
强调。最后磨字形、空白、圆角和反馈,让局部沿共同关系完成。
回看代价:长名称是否让模型轴支离,窄屏是否该回到上下排列,无框动作是否太难
发现,编辑面是否过长,说明是否与操作相接。反例可以让你保留卡片或换组织。
桌面成立不等于窄屏也成立,参数相同不等于表现相同。
把窗口逐渐收窄,像看房间缩小后桌椅还能不能相处。几栏各自留下最小宽度,加起来
可能已经超过房间;外框没挤压,可能只是把最右边的操作推出视野。观察正文行长、
输入和动作实际能否容纳,再决定改列数或邻接关系。重排后也重新走一遍路线:原来
在栏内滚动的内容可能改为整页滚动,位置保存与返回不能只靠旧逻辑猜测。
读到一段话去记笔记,再回到那段话,是一个完整动作。只做“写笔记”入口,可能让
写完的人在长页里重新找原文。让人正常操作来检验往返;就近返回、并排或临时展开
都可试,按实际代价选择,不因“方便”就在每页再放一层悬浮控件。
用具体选择解释判断
新人可以先用普通话说明当前判断,不必填模板:
“同一个编辑对象被两层表面分开,身份看起来留在外面。我想让身份与字段共用一个
表面,保留周围条目的节奏。代价可能是打开后的灰面过大。做完要看对象归属是否
更直接,以及手机上其他对象和保存是否仍好找。”
这段话给出观察、制作决定与可推翻的预期。下一步去做,实际看画面。关系有改善,
再磨细节;关系没改善,回到选择本身。方向明确不必凑候选,无法判断才做有区分力
的对照。讲解让别人理解选择与代价,不替失败产物辩护。
交作品时保留实际画面和未满意部分。工具检查、操作观察、审美判断、参考还原与
用户接受各自有证据,互不代替;写出这份手册也不等于已证明新人或Agent制作更好。
交互结构:任务怎样经过空间与控件
用于识别或改进选型、页面组织、步骤、上下文与返回问题。风格种子约束表达,不能
替代控件的任务语义。先走一个完整活动,再判断卡点发生在哪个关系上;不以统一
radio、dialog 或更少点击为目标。
从动线定位症状,提出替代方案
观察进入 → 识别对象 → 获得必要信息 → 比较/决定 → 行动 → 结果 → 继续或返回。
无需为局部任务画完整流程图;把当前要做的动作和它依赖的上下文连起来即可。
看到重复跳转、隐藏选项、正文与输入来回滚动、改变选择却失去草稿、结果离开对象,
先指出用户被迫额外做什么,再比较现有结构与最小替代。
不能只报告“应该换 radio”或“应该用 dialog”。说明需要显露的差别、要保住的上下文、
选择时机与取消/返回,以及替代的代价;选择与宿主合同相符的表达,实际完成同一
活动复验。信息不足时核查选项规模、是否需搜索、是否必须同屏参考、是否独立长任务,
不拿缺事实当审美自由。局部方案不得改变合法选项或凭空新增产品能力。
选择控件按语义与比较负担决定
| 要完成什么 | 可用起点 | 反转条件或易借错之处 |
| 在固定互斥值中作单选,需要看见差别与说明 | radio group,选项与必要描述同时可见 | 选项很多/动态或需搜索时,展开全列表可能更难用 |
| 在较大值域定位一个值,空间有限且不需并排比较 | 原生 select;需搜索时用合适 combobox | 少量重要选项藏进弹出列表会增加查看与记忆负担;不是有三项就必禁select |
| 筛选同一内容或切换视图 | 明确当前值的筛选控件;内容视图可用tabs | 改数据字段不冒充导航,不能只为有选中皮肤就声明tab语义 |
| 选择多个独立项 | checkbox组 | 互斥项不使用多个checkbox或多个独立switch |
| 开关一个立即生效的独立状态 | switch或checkbox,标明生效时机 | 需提交的复杂配置不让switch暗示已经保存 |
| 选择带对象属性和状态的实体 | 可辨对象的选项列表或radio式选项 | 不能把不可用状态藏在dropdown里,也不能只显示标题丢掉比较信息 |
选择之后是否立即生效、只是编辑草稿、还是要最终提交,必须清楚;选中和焦点分别
可辨。字段标签、组名和描述有正确归属,使用已有组件或原生语义;样式不能覆盖
键盘选择、阅读顺序或不可用原因。
页面、局部展开、面板与 dialog
先问用户是否需要离开当前对象、是否要持续看底层材料、任务是否独立且长。
- 就地编辑/展开:与当前对象紧密、短而常用,完成后继续原工作;注意展开后
归属、空间与焦点,不把普通帮助内容做强制modal。
- 非模态面板:需要同时参考或持续调整底层对象。对象切换时核对面板与草稿
身份,不把旁边可见却无法操作的画面假装成持续对照。
- dialog:短、边界明确的临时子任务,结束后回到原对象;确需暂停底层操作时
才用模态。它省去重定位但带来中断、遮挡、键盘和取消成本。
- 独立页面:较长/多步骤/可独立定位或分享的任务,需足够阅读空间。保留进入
来源和返回语义,不让一个小字段修改丢掉整个比较现场。
小任务也可能因移动空间使用全屏dialog,外形全屏不等于独立导航页面;是否保住
任务身份、来源、草稿、取消与返回才是关键。不要把全部设置塞进modal,或层层弹窗
让人失去主任务。确认不等于操作完成,成功反馈仍取自真实结果。
采用模态时实际核对打开焦点、内部键盘范围、取消、关闭及合理的返回焦点;取消
不应悄悄提交。采用页面/面板时实际核对返回、切对象、长内容与草稿连续性。只看
截图不能证明这些关系,按当前改动触发的路径验证,不要求不相关全产品流程。
动作结束后的结果归属
沿真实动作看结果落在哪里,而不只核对提示文案。一个对象中有多个编辑活动时,
分别辨认本次改变的字段、仍未提交的草稿、反馈的视觉邻接及关闭后的焦点。
文案写对对象名称,不证明用户能分清哪次操作已完成;回执放在另一操作下方,
仍可能暗示那份草稿也已保存。优先把结果放回改变的事实或动作附近,采用现有
状态与组件表达,不为视觉归属新增通用投递或反馈协议。复验保留另一活动的草稿,
实际完成、取消并返回,确认结果位置和未保存含义同时成立。
把一次变化的所有表达作为一组复看:字段、预览、状态文字、按钮图形和下一动作。
取消后字段恢复而预览不恢复,或暂停动作的标签已变而图形仍表示播放,都是组内
关系未接好;静态对齐与单项断言发现不了。反馈文字也要在当前前景里实际读,模态
背板下的提示不能只凭DOM可见就验收。不要求每次穷举全产品,沿本次改变的事实与动作核对。
依据与边界
2026-10-04 读取现行正文:W3C radio
说明互斥单选及键盘/组标签;combobox
区分select-only、可编辑及建议选择;modal dialog
说明模态、焦点、关闭与返回。这些支撑实现语义,不决定每个产品的最佳载体。
GOV.UK radios与
select提供选择可见性和选项规模
的实践指导;NN/G modal 与 nonmodal
解释中断与底层材料参考的代价。它们不是本 skill 的性能实验,不给固定选项数量或
点击数作为统一阈值。上面的载体比较是据此形成的迁移方法,仍须当前任务实看实用。
用量测缩小疑点,用实际交互检验关系
工具是观察辅助,不是自动美化器。数值事实可以不看截图取得;Agent 仍要结合用途
决定是否受损、修哪里。没有候选问题不等于设计已精致,不能让量测替代本任务要求
的实际视觉复看。工具不预设设计系统、品牌、字体、统一间距或最佳控件尺寸。
开始量测
已有 Playwright 的项目里可用 scan-ui.mjs:
bun /path/to/ui-improvement/scripts/scan-ui.mjs \
--url http://127.0.0.1:3000 --widths 1440,950,390 \
--focus '#progress' --channel chrome --out /tmp/ui-facts.json
尺寸按真实布局的容纳边界选,不把示例三值当必选。--focus 可省;指定后会在独立
浏览器页改变焦点,可能触发应用事件,只用于已授权的预览。不要把表单输入、保存
或服务写入加入通用扫描。模块默认从当前项目解析 @playwright/test,也可通过
--playwright-module 指向已有模块;没有依赖时采用现有浏览器工具,不自动安装。
--out 将详细证据写入文件,终端只给覆盖、横向扩张与焦点候选摘要。先读摘要,再
按疑点定位器读取有关控件和组的数据,不把全页大 JSON 一次塞进模型上下文。
摘要的 paintNotMeasured 列出尚未量出绘制部件的控件地址;它是观察能力缺口,
不是缺陷或自动整改清单。评价这些组成时主动取原比例局部,不能因候选警报为空
就宣称箭头或菜单外观正常;样式化装饰也仍需看实际绘制。
若已经在状态页、有认证会话或需要更准确的等待条件,直接复用
probe-ui.mjs,避免重新打开首页丢失现场:
import { probeUI, checkpoint } from "/path/to/ui-improvement/scripts/probe-ui.mjs";
const facts = await page.evaluate(probeUI, { scope: "#settings" });
脚本读取当前 DOM、open Shadow root、计算样式和几何关系,不修改样式或自动修复。记录 viewport、
页面横向扩张、溢出节点、真实滚动容器、控件文字尺度与内边距、标签文字包围盒、
相关 flex/grid 子项以及当前焦点。输出定位器供同一 DOM 回查,不当跨重绘的持久身份。
跨 Shadow 的 address 是逐层 CSS 数组,可用 locate(page, address) 回查;scope 与
checkpoint 也接受这种明确地址。相同内部 ID 在多个组件出现时,不用不明确的裸 ID。
CLI 另采同源子 frame,逐个报告自身坐标;跨源 frame 保留 omitted,不自动扩大读取。
选中一个元素检查
inspect-ui.mjs 可打印该元素的 margin、padding、尺寸、
边框、字体与祖先关系,按需截取局部。它打开独立预览,适合快速复现;已有状态页
优先复用 inspect-element.mjs 的 inspectElement:
bun /path/to/ui-improvement/scripts/inspect-ui.mjs \
--url http://127.0.0.1:3000 --target '#progress' --channel chrome \
--focus yes --out /tmp/element.json --screenshot /tmp/element.png --padding 70
--width 换窄屏,--frame 在指定 iframe 内选对象,跨 Shadow 可传 JSON 地址数组。
截图 padding 是本次观察范围,仍可能不含完整标签;需要整组时选父区域。数值读取
不截图;截图、focus、trial 都按显式选项执行,可能改变滚动或触发应用事件。
import { inspectElement, locate } from "/path/to/ui-improvement/scripts/inspect-element.mjs";
const result = await inspectElement(locate(page, ["#widget", "#button"]), {
trial: true,
screenshot: { path: "/tmp/detail.png", padding: 30 },
});
elementFacts 是可序列化的单元素浏览器函数,也可用于现有 CLI 的 eval。已有
Playwright CLI 会话无需重开页面:snapshot 取得 ref,再 eval 读所选元素样式、
screenshot 截元素或整组。现行 agent-browser 的 get styles 同样能读所选元素。
当前机器实测的是已有 Playwright CLI;agent-browser 未安装,未声称两者都验证通过。
检查器还给出指定区域的 Range 文字片段、SVG fill BBox 与坐标映射、当前五点指针
命中、相关动画清单。命中异常是调查线索,再以普通点击或 click({trial:true})
核对动作准备;trial不提交点击,却可能滚动。透明遮挡、pointer-events:none 绘制、
合法角标和浮层不能因矩形相交自动删除。ARIA snapshot 按需通过 semantics:true
启用,来自 Playwright 的 DOM 语义计算,可能包含字段值,只读获授权的具体范围。
怎样读事实
- 页面横向扩张:核对超出视口的对象与容纳要求。横向表格可能合理,关键操作被
推出视野则值得修。先看列最小宽度、留白与重组时机,不先缩小全页字体。
- 局部溢出:区分明确 scroll 容器和 hidden/clip/visible;容器的 scrollWidth 超出
不等于内容丢失。继续核对所属祖先和必要入口,不自动给所有容器加 overflow:hidden。
- 控件内部:对照字号、内边距和框宽;原生 select 给出当前文字宽度估计及扣除
padding/border 后的宽度,箭头占用仍未知。剩余空间紧张是调查线索,不是箭头碰撞
的已确认事实。文本估计与标签 Range 包围盒含字体、空白影响,不是字形墨迹边界。
内部宽度估计使用未变换的 layout CSS 像素,不能与 transform 后的外框混算。
箭头位置未知时,局部图核对值与箭头、箭头与内缘的留白,而不是把外框 padding 当
箭头位置的证明。原生部件的绘制未必跟随 CSS padding;修后仍按真实画面核对。
默认装饰不合当前语言时,可在保留原生select行为的前提下接管装饰,或复用项目已有
控件;选择依据是当前内部关系,不能通用地禁用原生样式。
appearance 与背景位置/
大小能解释CSS装饰的布局,却不是图形墨迹的证明;替换后复看窄空间、最长当前值、
焦点及正常键盘选择,不靠加右padding宣称浏览器箭头已经移动。
- 整组关系:比较标签、控件和同行动作的尺度、间距、轴线,合法差异可以保留。
焦点时,outline 的包围范围进入标签文字空间会作为候选报告;检查圆角、真实轮廓
与邻接,不能用一个统一阈值自动判错。默认扫描没有聚焦,不声称检查过焦点态。
记录具体证据与理由后再修源码。修后在相同状态、尺寸和范围重新量测,比较最初的
受损关系和邻接代价。先改责任位置,工具不写 CSS,也不把修复某个样板的参数发布
为全产品规范。
从受损关系回查原因:元素本身、父容器的列宽/最小内容宽度、nowrap、固定高度与裁切
可能共同造成症状。必要时在隔离预览临时改一个可疑属性验证因果,再修源码的责任位置,
重新加载确认。不要把 computed CSS 整体复制成补丁,也不要只缩小溢出对象。
绘制部件缺失时,还查组合声明是否重置了主题提供的装饰。例如真实表单里,公共
Select 已用 appearance:none 接管箭头,应用的 background 覆写却把主题的
background-image 清掉。应追到这条覆盖并恢复组件主题,再看完整控件组;追加
另一套箭头会留下平行样式。源码修正后确认预览已重新构建,旧画面与新源码不能合成
一份“修后通过”的证据。
响应式问题围绕布局发生变化的宽度检查,并复看邻近宽度;两端正常不能证明中间都正常。
合法头像叠放、角标、开关滑块与局部滚动不因矩形相交或 scrollWidth 变大自动判错。
用正常操作探测接续
checkpoint(page, {fields, scrollers}) 只读取显式选择的字段、滚动容器、window
位置与当前焦点。字段值可能包含草稿,输出仅存授权现场,不把用户正文上传或提交。
它不自动推断哪个容器拥有阅读位置;先用 probe 的滚动信息与实际滚动核对。
const before = await checkpoint(page, { fields: ["#draft"], scrollers: ["#reading"] });
await page.getByRole("button", { name: "另一篇" }).click();
await page.getByRole("button", { name: "原篇" }).click();
const after = await checkpoint(page, { fields: ["#draft"], scrollers: ["#reading"] });
// 按产品合同核对草稿、对象身份及真正拥有滚动的位置;不是要求所有快照逐字相同。
操作用普通 click、键盘和真实入口。evaluate(el.click)、直接设业务状态、
selectOption 可以定位接线,却不能声称用户点击、菜单键盘或返回动线通过。
动作后先看当前工作区域中的可见后果,再读取有关 DOM 核对:文本存在、isVisible
为真或值已改变,不能证明提示处于当前前景、属于正在编辑的对象,或关联图形也已同步。
模态内的反馈尤其要看实际层次与邻接;背板下仍可辨的全局提示不等于完整的模态反馈。
必要时对反馈区域作带周边截图,命中数据只辅助解释层次,不把非交互文字的指针穿透
自动判错。改变一个状态时核对同事实的字段、预览、标签和图形,不只挑其中一个断言。
按已有权限在隔离样板做改值/保存实验;真实服务的提交不因使用这个工具自动获授权。
不要再建立动作 DSL、固定最低步数或全产品一律执行的测试循环。
观察能力的边界
工具覆盖 light DOM 与 open Shadow;报告截断、Shadow host 与 iframe 数量。子 frame
独立采样,内部可用不证明外层未裁切或遮挡,不能混加不同 frame 的坐标。closed
Shadow 数量未知。节点可布局不代表未遮挡或当前可见,transform 的
矩形包围盒也不是实际轮廓。原生选项弹层、闭合 Shadow DOM、遮挡、光学对齐、色彩
协调与动效过程不能由这里证明。图片依赖、字体替换和加载中的状态也会改变量测。
CLI 只等页面 load 与字体 ready;需其他稳定条件时复用模块,在应用自己的就绪点后
执行,不用固定 sleep 宣称所有动画已完成。
方法依据:Playwright CLI 的元素读取、
Shadow 定位、
动作准备检查、
Range 几何的定义、
SVG 几何接口。
具体配方:阴影、配色、边框与动效
2026-10-04 核对来源。关系依据来自公开设计系统;下面的 HEX、CSS 和时间是可试作
起点,不是品牌官方 token,也不是本产品默认主题。项目已有主题与组件时,先映射到
其语义角色,不直接散落硬编码。可打开 交互样片 比较。
样片只表达材料组合,不代替真实页面的构图、业务状态或浏览器行为验收。
阴影:接触层与扩散层一起配
来源:Geist Materials、
Atlassian Elevation。它们按层次配合
表面与阴影;暗色还靠表面明度区分层级。下列双层 CSS 是试作配方。
| 角色 | 可试作组合 | 判断与反例 |
| 平面内容 | 无阴影 + 1px柔和边框,或同组共用分隔线 | 留在页面中;不把每一行都做成悬浮块 |
| 轻抬起 | 0 1px 2px rgb(0 0 0 / .06), 0 6px 16px rgb(0 0 0 / .05) | 第一层贴住边缘,第二层扩散;配白色/较亮表面,适合少量需要抬起的对象 |
| 浮层 | 0 2px 6px rgb(0 0 0 / .08), 0 20px 48px rgb(0 0 0 / .14) | 配明确轮廓和独立表面;普通列表用它会变重 |
| 暗色浮层 | 较亮的表面 + 柔和亮边 + 深阴影 | 不只把浅色阴影加黑;注意背景、内容面、浮层的明度顺序 |
模态遮罩表达背景暂不可交互,阴影表达空间层次,两者不是同一机制。不要用内阴影
让普通文字面像输入框;确实要表达凹槽时,另核对其用途。卡片不是必须在 hover 时
上浮:只有可操作对象才考虑回应,静态内容抬起可能制造错误暗示。
配色:先把角色配齐,再选择色相
来源:Geist Colors区分背景、交互背景、边框、主次
文字等角色。下面是原创试作色组,不是该系统数值;局部颜色不能证明整体风格成立。
| 角色 | 冷静中性 | 温和纸面 | 暗色工具面 |
| 背景 | #f6f7f9 | #f6f3ed | #14161a |
| 内容面 | #ffffff | #fffdf8 | #1e2127 |
| 次级面 | #eef1f5 | #eee8dd | #282d35 |
| 细边框 | #dce1e8 | #ded6c8 | #424955 |
| 主文字 | #202630 | #302c27 | #eef1f5 |
| 次文字 | #596574 | #6b6256 | #adb7c5 |
| 强调文字/填充 | #2458b5 | #496346 | #a8c7ff |
| 强调浅底 | #e8effb | #e7eee1 | #243650 |
配法:大面积保持中性,色相集中在当前选中、相关链接或主动作,语义错误/警告另保留。
强调浅底配同色系较深文字,实色按钮配足够反差的文字;暗色强调填充通常需深色字,
不能照抄浅色的白字。灰边框只作轻分组;控件若靠边框辨认,应增强到实际可辨强度。
这些颜色可混成难看的组合:不把暖灰背景、冷灰面、不同饱和度的蓝随意拼在一起。
选定一套后调整相关角色;最终在实际相邻背景上核对文字、控件与焦点反差。
边框:实线、虚线与强调环各有语气
| 手法 | 起点 | 用途与反例 |
| 安静实线 | 1px solid var(--border),无阴影 | 稳定对象或分组;避免外卡、内卡、字段卡层层重复 |
| 虚线空位 | 1px dashed var(--border) + 中性浅底 + 明确动作 | 可试用于“添加到这里”的区域;必须真有添加动作,不能给已完成内容随机虚线 |
| 拖入反馈 | 拖入时增强边色/底色,并给出可接收状态 | 上传确实支持拖放才使用;不能只画一个假拖放框 |
| 重点侧线 | 一侧2–3px强调色 + 同色系浅底 | 注记或当前项的局部配方;不能仅靠侧线表达错误或选中 |
| 键盘焦点环 | outline: 2px solid var(--accent); outline-offset: 3px | 与 hover、选中分别设计;不是给全部静态卡片常驻亮环 |
虚线空位与侧线是研究试作建议,未找到能支持它们为普适规范的证据。
Carbon File uploader
提供拖放区域的行为语境,不用于宣称本配方数值或虚线是其规范。
浏览器原生 dashed 的段长由实现决定;需要特定虚线节奏时才另做 SVG/背景实现,
并核对圆角和缩放,不为装饰新增复杂组件。
圆角:轮廓配套,不是全部胶囊化
可试起点:字段6–8px、内容面12px、浮层16px;它们是样片尺度,不是全局标准。
内外嵌套时参考留白协调轮廓;内容面内边距很大却给小字段巨大圆角会像不同语言。
胶囊适合短标签或某些短动作,长输入、列表和大面板未必适合。
先复用项目现有轮廓族,必要时改变角色关系,而不是仅靠把圆角加大“变精致”。
动效:属性、距离、时间与曲线一起配
来源:Atlassian Motion按交互与过渡
区分时间,并按进入、退出、重排选择曲线;当前体系部分处于 Early Access。
下列配方是可调整的示例,非要求全部采用。
| 场景 | 具体配法 | 反例 |
| hover/press | 背景/边色120ms;按下可用100ms轻微缩放至.99 | 仅可交互对象;不让每条静态内容都移动 |
| 菜单/浮层进入 | opacity 0→1、translateY 6px→0,180ms cubic-bezier(.2,.8,.2,1) | 同一次出现只有一个主要运动,不让每个子项各飞一次 |
| 退出 | 淡出120ms,可减少位移 | 不为播完动画阻塞下一动作,快速重开不能闪回旧内容 |
| disclosure | 箭头旋转90°,140ms;内容必要时做短距离淡入 | 不用固定巨大max-height伪造任意高度;展开期间滚动和焦点仍应正确 |
| 保存反馈 | 成功后在原操作附近出现简短反馈,可180ms淡入 | 不预播成功;不能用短暂动画作为唯一回执或把整页弹跳 |
优先明列 transition 属性,例如 background-color 120ms, border-color 120ms,
不使用 transition: all 让宽度、位置与主题切换意外一起动。opacity 与 transform
适合局部试作,但性能仍取决于真实规模。滚动、取消、连续点击和主题切换要实际看,
截图只能证明某一帧。减少动态偏好
下关闭非必要位移与缩放,保留状态信息;不要全局抹掉项目已有必要反馈机制。
成组使用的起点
- 平面工具:中性底 + 实线分组 + 少量色相强调 + 快速颜色反馈;保留内容密度。
- 温和纸面:暖中性底 + 轻抬起阴影 + 柔和轮廓 + 克制动作;不把每个小块都做成纸卡。
- 暗色浮层:较亮表面 + 亮边辅助 + 双层深阴影 + 短距离进入;层次由表面一起完成。
- 等待添加:局部虚线空位 + 明确下一动作 + hover边色回应;如果只是一个普通按钮,
不必扩大成大面积占位框。
这些是材料配方。先核对要表达的角色,再与 视觉修辞 的组织手法
组合,带回真实页面复看;好看的独立卡片不证明整个页面已经有气质。
样片验证范围
本机普通 Web 预览,Chrome 实看1440与390宽度;三套配色、添加回应、反馈显示/清除、
disclosure及减少动态偏好通过,无横向溢出。主题改变会触发按钮短颜色过渡,截图在
有关动画完成后取稳定画面,不把中间灰色帧当最终配色。格式和本地引用检查通过。
未进行独立 Agent 采用试验、真实页面迁移或全键盘环路验收;不由样片宣布skill效果提升。
视觉修辞:可组合的构图与搭配手法
2026-10-04 核对官方公开资料。以下名称是研究归纳,不是品牌官方分类,也不是保证
好看的公式。设计语言种子确定整体气质;这里提供在该气质内组织真实内容的手法。
原始文档有图或运行示例,制作时看适用的示例,不能只根据手法名称套样式。
需要直接试作阴影、配色、边框与动画时,读表面与动效配方,
包含参数起点和交互样片;本页负责组织关系,两者按当前缺口配合。
从缺口选手法
| 画面缺口 | 可尝试的手法 | 预期改变 |
| 所有部分声音一样大 | 衬托、重点落笔 | 主体先被看见,辅助仍可读 |
| 内容像散落的组件 | 对偶、同域 | 重复关系形成轴线,同一对象有归属 |
| 整齐却呆板,或分隔太多 | 节奏、留白成组 | 有停顿但不断裂,不靠套框分组 |
| 少量文字被空地吞没 | 成块安放 | 内容形成完整形状,空白围绕它 |
| 读到最后不知如何结束 | 收束 | 解释、决定、操作与结果相接 |
选能解释当前缺口的手法,不必全部使用。用真实内容做局部试作,并带着上下文一起看;
先说明哪个关系预计改变,实际画面不支持时撤回。它们可以组合,但不要同时扩大每种
强调。下列边界与组合建议是研究推演,尚未证明在所有产品成立。
衬托:背景退让,主体保持清晰
原型:Linear 2026 改版
的侧栏与边界前后图;官方调整外围竞争,同时保留工作区的信息密度。
做法:让导航、元信息与当前工作内容有明确的重量差异。用现有主题的字色、表面与
间距共同表达角色;弱化外围时,主体无需一起变淡。看视线是否更早落到正在工作的对象。
反例:全页浅灰、小字、细线;当前状态和操作也看不清。错误或选中不能为了安静隐去。
搭配:与重点落笔或同域配合;不要让导航、摘要、卡片、按钮都抢同一个重心。
对偶:稳定的标签—值或身份—动作关系
原型:GOV.UK Summary list
用键、值和有关动作组织事实;Geist Description
展示标签与值的组合。
做法:让相同角色占据稳定阅读轴,值随内容生长;动作保持明确对象归属。桌面可以
横向对照,窄屏转为上下仍保留顺序。成对关系可用于身份/状态、标题/说明,不要求等宽。
反例:把无键值关系的任务硬塞进定义列表;短控件每行停在不同位置,空白没有形成
轴线;强制双列导致长值折得支离。不要复制示例固定宽度代替当前组合判断。
搭配:与节奏形成稳定列表;少量事实未必需要再套卡片。
节奏:重复建立预期,变化标出章节
原型:Atlassian Spacing
的相似性、邻近、节奏与光学调整示例。
做法:同类条目重复行结构和停顿;同组内部更近,换组有更大的停顿。改变节奏时
对应新的内容角色,保留共同轴线。图标与文字重量不同时允许光学调整。
反例:所有间距相同,使标题像普通一行;每张卡片独立设间距;为打破单调无理由
轮换大小。尺度表只提供材料,不能替代分组判断。
搭配:与留白成组配合,保持密度也能有呼吸。
留白成组:空白也参与勾勒对象
原型:同上 Spacing 的邻近分组与层级示例;Linear 改版的边界对照提供另一种
减少外部轮廓竞争的做法。
做法:让一组内容的内部距离小于它与下一组的距离;观察整块的外轮廓与停顿。
先看去掉某条线后归属是否仍清楚,再决定是否保留。留白不是越多越好。
反例:仅删除所有边框;密集多对象丢失归属;内容在窄屏被巨大空隙推到下面。
搭配:与对偶、节奏组合。需要独立对象边界时,卡片仍可以是正确选择。
同域:共同表面把身份与内容连成一个对象
原型:Geist Materials将填充、轮廓、圆角与
阴影作为层次角色配合。它提供表面关系,不能由此推论所有编辑器都该有灰底。
做法:同一对象的标题、内容、动作共用表面或明确连续的轮廓;不同层级才增加
新的表面。展开后身份仍属于正在编辑的对象,表面变化要解释其角色。
反例:每个字段都加卡片;同色的大摘要与编辑面竞争;浮层阴影带进普通列表。
搭配:与衬托让当前对象突出,仍核对暗色主题的分离与焦点。
重点落笔:局部强调由真实内容获得资格
原型:Atlassian Typography
区分正文、标题和指标,并限制强调;它们与字色、间距一起工作。
做法:选择用户现在需要辨认的真实对象或信息,集中字重、尺度或色面对比。
标题和说明形成组合,其他内容退让;不是每页都需要大标题、指标或彩色徽章。
反例:把无关数字放大;摘要、标题和保存同时成为视觉中心;小号浅色解释承担
关键决定。字形与图标重量一起看,不用随机字体或装饰图标制造精致感。
搭配:与衬托配合。重要信息前置还要评估手机上占用的空间是否值得。
成块安放:整体定位与内部对齐分开
原型:Carbon Empty states
展示不同空间里的内容块位置、内部对齐、可选图像与下一动作。
做法:少量内容先形成标题、解释和必要动作的完整块,再决定这一块在可用空间
中的位置。整体居中不要求每行文字居中;配图形状和空间尺度共同决定布局。
反例:一句话漂在画面中;每个空区域都放大插图和主按钮;用装饰填满空地。
搭配:与重点落笔及收束形成完整空态。错误、无数据、无结果必须按真实原因表达。
收束:让最后一笔结束当前决定
原型:GOV.UK Check answers
在最终提交前组织复核内容和修改入口。迁移到局部编辑的收尾是本研究的类比,
不是要求每个表单新增复核页。
做法:必要影响说明与提交动作相接,动作归属于被修改对象;结果仍能看出改了
什么。局部编辑不让配置来源或其他辅助内容插在决定与提交之间。
反例:保存之后才读到重要影响;为了漂亮把必要说明折叠;把所有动作都做主按钮。
搭配:与同域收束编辑对象。保存、撤销、返回及反馈须实际操作,不能只看初态。
从素材到表达
几种可试作的搭配句式
以下是从上述关系提炼的制作起点,不是来源网站的完整皮肤,也不要求每页采用。
| 句式 | 具体画面关系 | 适合与代价 |
| 安静索引 + 当前工作面 | 重复身份行共用阅读轴,元信息跟随身份;展开对象获得连续表面,动作在表面末端收束 | 多对象逐一处理;平面行可能削弱独立对象边界,须让入口可辨 |
| 标题—说明—事实轴 | 标题和短说明组成一个开头,事实用稳定标签/值关系接续,动作靠近有关事实 | 资料详情、复核与设置摘要;不适合逐段阅读正文,长值在窄屏须重排 |
| 成块的引导 | 标题、解释和一个必要下一动作组成紧凑左对齐块,整块安放于可用空间;有用图像围绕该块配合 | 空态或起步说明;多个区域重复此句式会争抢注意,不能造一个新主按钮填空 |
| 连续阅读 + 章节停顿 | 正文保持稳定行长和字级,标题以字重与组间停顿标出章节,回查材料沿固定轴安放 | 文献和长资料;不能把关键原文全部折叠换取短首屏 |
最后一项是排版与节奏原则的迁移推演,未在本轮单独实测。表中各项都应由当前内容
重新制作:先用少量必要层次形成形状,再调整具体字号、色面和尺度。不要求增设摘要、
边栏或插图;现有内容足够时,就用现有内容把关系做完整。
手法是生成候选的材料,不是评分清单。用“哪个对象、哪种关系、哪种变化、哪项代价”
解释选择;再看画面有没有形成期望效果。必要时组合相容手法,但保留单一主导关系。
实际试作仍用 构图与搭配试作 收束,不能靠修辞名恢复失败产物。