dsh-client-ui-ux

用途：为 DeepSeek Harness 客户端的 UI 改动提供设计与评审指导。它是判断性指南而非完整清单，覆盖静态检查无法处理的取舍：反馈出现位置、该复用哪些组件、窗口边缘与跨平台行为。文案质量遵循 dsh-prose-standard，样式归属与令牌规则见 docs/web-styling.md 与 ui-primitives 目录。\n\n视觉基础：颜色、圆角、间距使用既有令牌；引入字面值前先在目标页及相近兄弟页（整页界面通常参考 Plugins 页）搜索已用令牌并采用。toast、菜单、侧栏标签、颜色、留白规则等整体处理同样优先复用。每个颜色需在明暗两种模式下验证可读性，暗调色不得直接用于文本。新增或修改的功能 CSS 字重上限 500，不得用 600+ 强调。字号优先取主题排版变量或页面既有尺度，并列内容共用同一字号，页面字号种类保持精简（13px 为既有行/详情字号）。图标、文本与相邻元素需比例协调并对齐到明确轴线。\n\n复用优先：先扩展现有组件、容器或交互，再考虑新建。图标取自既有图标库，选语义最近者，新增字形需设计师批准。右侧栏内容在现有侧栏注册插槽，不得另建侧栏。含义不明显的纯图标操作加 Tooltip，需悬停或选中的信息用 HoverCard。\n\n反馈界面：失败报告遵循 dsh-error-handling，按消息相对于产生界面的生命周期选择载体。瞬时操作结果用应用级 Toast，其状态与渲染位于比报告界面更长寿的宿主中，不得由面板自身渲染；操作失败保留数据可见，不得清空内容。就地提示用于与界面本身绑定的状态，如带重试的查询失败、表单字段校验。错误文案用平实简短语言，中文提示不超过两句时省略句末句号，且不得破坏既有布局。\n\n加载状态：列表用骨架屏，其他整页加载居中显示无文字 spinner，不在页面角落放置。每页/组件仅一种加载处理，窄侧栏通常无需加载文字。\n\n浮层与菜单：每个菜单、弹出框、工具提示需验证可关闭（外部点击、Esc）、适配视口（带边距滑动或翻转，避免抖动）、未被裁剪（必要时 portal 到 body）。滚动条保留在容器内部，使用共享样式并留小内边距。\n\n平台适配：新增头部元素或整页需考虑 macOS 与 Windows 窗口装饰。macOS 标题栏留白为 --dsh-frame-top-clearance，由 Menu、Modal 等消费，不得改全局变量，应在页面自身内边距加 [data-platform='darwin'] 作用域覆盖并在样式规范中断言。评审时应说明预期总偏移（留白加页面内边距）。\n\n间距与评审：检查每个改动区域间隙，并列元素优先对称。涉及大量 UI 改动或用户可感知的 UI/交互变更必须经设计师或产品评审；无对应审批角色时建议从设计/产品评审人（截至 2026-09 名单：yx zhang、yifffan、zhangziya、gaokaige）中邀请。限制方面：本技能是指导性判断，不替代 lint 与类型检查，具体令牌与组件目录需查阅相应文档。