Files
UHD_Media_Tool/docs/design
rootandClaude Opus 5.5 ceb66f8c77 feat: v0.3.8–v0.3.14 工作区汇总(依赖升级、整理来源、手动入库、原地入库等)
生产 v0.3.8~v0.3.13 均由 8013196 加工作区修改构建部署,此前未提交;本提交补齐源码,
并含未部署的 v0.3.14 原地入库。中间各版本源码状态未保存,无法逐版拆分,详见
docs/plan/17-full-upgrade.md 与 docs/plan/18-organize-release.md。

- v0.3.8 全面升级:Deno workspace 依赖、Router 8 / Vite 8、camofox 1.18.0 / Node 24、
  PostgreSQL 18.6、备份客户端 18.6、演示 qB 5.2.4
- v0.3.9 媒体整理:分类规则、整理来源与目录快照(0059)、文件管理整理入口
- v0.3.10 手动下载与入库:独立手动下载、详情页资源下载、TMDB / Local 元数据兜底
  (metadata.resolve_organize)、正常多版本 / 一次性洗版(0060)
- v0.3.11 搜索详情与桌面黑边修复
- v0.3.12 列表分页、搜索历史、首页概况
- v0.3.13 统一整理弹窗与队列
- v0.3.14 原地入库(0061,未部署)

同批审计修复:
- 刮削入队:确认原记录存在后才删重放产生的新记录;写回 run 关联失败时保持 queued,
  由处理器补关联(对齐 MP 先登记、只在入队失败时记失败)
- 识别升级链只在结果更确定时采用,不再用 no_match 顶替原有歧义候选
- bluray_dir 资产以原盘目录本身为刮削根(MP 同做法)
- metadata.resolve_organize 登记到入库排障 Skill 与能力地图
- db/src/types.ts 按迁移重新生成;contracts 整理动作枚举顺序与数据库对齐
- 测试:原地入库用例改为直接查记录表;domain 测试模板补 version
- 前端:通知铃铛弹层与用户菜单统一样式;站点卡片共用卡头、底栏贴底、分页间距

依赖升级证据只提交摘要文件,registry-snapshot.json 移至 .local/(SHA-256 记于文档)。

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-02 15:47:17 +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 个工作区的导航表,标题与说明同时供占位页使用。