Files
UHD_Media_Tool/docs/design
rootandClaude Opus 5.5 caf5a1f2f4 feat(web): 作品详情头图改为剧照铺顶渐隐到页面底色(方案 A)
- MediaHero 去掉深色圆角卡片:剧照铺在内容区顶部,上下与右缘渐隐成透明;左侧文字区压近乎不透明的页面底色、右侧露出剧照,窄屏改为自上而下压底色;文字用常规前景色,日夜同一结构;没有背景图时不渲染剧照层
- 新增材质参数 --mat-hero-*(浅 / 深两套)与 .media-hero-backdrop
- 「正常」/ Emby / 库存等徽标并进「连载中」所在的事实行
- 操作按钮(订阅 / 搜索资源 / 查看订阅 / 合并作品 / 插槽入口如补字幕 / 命名覆盖)移进头图区外链行下方,库作品页与 TMDB 详情页一致
- 订阅改为主色实心(Button variant="solid",.pill-solid / --mat-pill-solid-*),作为头图区唯一主操作;设计文档记为例外
- 简介折叠:去掉省略号 + 单独一行「展开」的重复,改为最后一行行尾渐隐、「展开」压在渐隐处;按实际排版测量是否需要折叠
- 补 MediaHero / ClampText 渲染测试

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Cxwgnn2pbzQ7rXv3rq7fei
2026-10-07 01:44:32 +08:00
..
2026-10-06 18:23:24 +08:00

设计系统

控制台(apps/web)沿用 /opt/uhd_web 的设计系统:token 定义在 app.css,shadcn 组件在 apps/web/app/components/ui/,控制台共享件在 apps/web/app/components/console/。

文档 内容
design-tokens.md 颜色 token 分层、命名与使用规则,字号/圆角/时长/缓动阶梯
interface-materials.md 材质:pg-chrome 贴边、pg-slab 内容卡、pg-float 悬浮层
ui-controls.md 按钮、选中态、状态反馈、动效与圆角角色

硬规则

  1. 新增语义先加 token 再用。 需要新的颜色、字号、圆角、时长或缓动时,先在 app.css 定义语义 token(日夜两套值都给),跑 deno task gen:tokens,再在组件里引用。
  2. 禁止原色与十六进制。 组件里不写 #xxxxxx、text-[#..]、bg-red-500 这类 Tailwind 调色板色、white/10 之类的黑白透明度,也不写 text-[13px]、duration-300、ease-[cubic..]、裸 rounded。状态只用 success / warning / destructive,并且配文字,不只靠颜色。
  3. 材质按层级只有三种,不在玻璃上叠玻璃:已在卡片里的空态用 <EmptyState plain>。
  4. 确需例外(第三方库的颜色参数等),在该行或上一行写 token-allow: 原因。

以上规则由 deno task check:tokens(apps/web/scripts/check-design-tokens.sh + 生成物校验)在 deno task ci 中守住。

控制台共享件

  • PageHeader:页面标题 + 一句说明 + 右侧操作区。
  • EmptyState:空态/建设中占位;plain 用于卡片内部。
  • StatusBadge:success | warning | destructive | neutral 四种语气,必须带文字。
  • nav.ts:12 个工作区的导航表,标题与说明同时供占位页使用。