Peach: Local-first video metadata scraper and media manager.
BoardUI 适配
无图头像与浮卡子页
2026-10-27 复核:无图头像的圆盘、首字母和默认人像按同一组件检查。背景使用主文字色 10% 混入承载面的中性色,不能直接取与行背景相同的 background-primary-default 或 background-tertiary-default;前景使用 text-primary,不套用禁用色、三级文字色或整体透明度。24px 头像复用 Avatar sm 的 12/16、600 字阶,默认人像图形为 16px;照片、首字母和缺省图标保持相同外框。此处取代下文历史参考中无图头像的「次文字色首字」采用项。
正常、悬停和选中行中的无图头像都需检查深浅主题:首字母与头像底色至少 4.5:1,承载身份含义的人像图形至少 3:1;圆盘也应能从承载面辨认。规则依据 WCAG 文字对比度 与非文字对比度。尺寸相同、使用了语义 token 或背景有色差均不能代替前景对比度核对。复用源组件时须同时带入 Peach 的暗色适配,不只复制组件结构和上游默认值。
表格默认采用 Body Medium 14/20、500,状态文字采用 Body Regular 14/20、400;单元格内边距为 10px 12px。只有明确选择紧凑档才使用完整的 Body 2 字阶 13/18,不能拼出 13/20 等混合档。小型浮卡的标题为 Title 2 Medium 20/26,正文 14/20,辅助说明 12/16;正文内边距 20px,分组间距 16px,图文和操作组间距 8px。字阶包含字号、行高和字重,不能只核字号。表头与「待加入」等正常状态均需可读,不能按禁用文字处理;用户脚本的表头使用主文字色,状态使用次文字色,历史取证中的三级文字色不直接套入暗色小浮卡。
同一浮卡内的设置、批量选择属于子页:标题左侧返回,恢复进入前的主界面状态与焦点;关闭整个浮卡的 × 只留在主界面。返回设置不保存草稿,返回批量选择停止后续提交,已提交任务继续处理。原生 Escape 与返回保持相同语义。
设置分组与页签选中层
侧栏底部按明暗、配色、设置排列,展开时横排、收起时竖排,视觉顺序与键盘焦点顺序一致。
设置弹层的外观选项、光晕配色、自定义颜色与导航顺序各有独立卡片。设置行保留 BoardUI 的左侧 12px 内缩、右侧通栏分隔线;配置页的相邻行组由共享样式补齐边界。
JAV 与索引页、顶部管理导航、关注管理、复核分类、配置分区和搜索补全类别共享上游 PillTabList 的选中层,同时保留 Peach 的路由、tab 语义和方向键。React Aria 的装饰层通过 Portal 挂在集合宿主内,普通按钮直接使用同一组件。减少动态效果时关闭选中层过渡。当前源码、适配差异、实时几何与注册表核对结果见设置与页签取证。
任务问题列表默认收起,展开后使用与 CodeBlock 同色的限高容器及共享覆盖式滚动条。来源列表的单条错误保留原位文本展开;详情动作用常规字重。光晕颜色行使用中性行状悬停面,色板复用同一份覆盖式滚动条。
框内分组标题保留上下留白;框外标题的紧凑间距仅用于独立卡片布局。颜色行的悬停与展开反馈面横向铺满卡片、纵向覆盖相邻分隔线,内容与分隔线仍从左侧 12px 起算。边框保持占位,状态切换不改变行高。关注来源与 JAV 订阅源的暂停状态使用 Chip 的 gray 变体,主文字色随主题切换;创作者卡片末行的反馈面使用 8px 底部圆角,与外框 16px 圆角及 8px 留白保持同心。
设置弹层的玻璃导航投影裁在左栏内。右栏标题的阴影只在正文滚过顶部留白后显示,回到顶部、切换分区或重新打开时收起;减少动态效果时立即切换。
目录浏览
2026-10-17 取得公开 Tree View、Breadcrumb 与 Direction 注册表源码。三个条目的 SHA-256 与逐文件校验登记在 frontend/src/react/boardui/ORIGIN.md 和 UPSTREAM.sha256;原始 JSON 保存在本次工作树 build/boardui-registry/。来源为 MIT,无新增运行依赖。
Tree View 直接使用上游的目录图标、层级线、32px 紧凑行、键盘导航及受控展开;Breadcrumb 使用上游的祖先按钮与当前项。Peach 保留首页顶部人物与厂牌、玻璃筛选、排序、卡片和详情,在正文左侧放置 224px 目录栏;1100px 以下收为按需打开的目录弹层。面包屑、子文件夹入口及用途设置位于作品区上方。用途表单使用已有 Select、Input、Checkbox、ModalFrame 与共用确认框;移除确认期间卸载用途弹层,取消后恢复表单,避免两套焦点管理重叠。目录浏览采用最近一层明确规则及来源撤回,范围见目录浏览。
官方组件文档与注册表源码已取得;官方实时浏览器示例打开超时,交互视觉实测未取得。Peach 的桌面和手机行为使用临时合成馆藏验收。
目录栏吸顶边界按筛选浮层的实际高度与顶部位置计算,并随窗口和筛选内容变化更新;树内滚动高度保留筛选栏与底部间距。密集模式的 Mix 与作品卡共用顶部 7px 叠层留白,封面下沿对齐。
文件夹模式使用上游 IconButton,在右侧排序控件组中适配关注页的 30px 透明按钮和玻璃选中面;Remix 图标保留填充路径。卡片与列表使用共用分段控件,当前浏览器保留所选显示方式。列表由 TanStack Table 驱动现有 BoardUI Table,复用 DataTableFrame、排序与分页控件,行间使用直线;选择接入馆藏现有批量栏。默认每页 20 部,服务端对完整筛选结果排序分页,跨页保留选择。实现依据 TanStack 服务端分页 与 排序,2026-10-17 核对。
窄屏的首页、资料页与关注页筛选栏按整行横滚;作品与关注卡片按实际文字和标签定高,空标签区不占行。Note 按容器宽度排列正文和操作,补全提示使用两层结构:说明及带右箭头的详情链接、下一行补全按钮。玻璃材质沿用既有实现。
筛选栏按钮统一为 viewglide 分段控件的 30px 高度,纯图标键为 30×30px。收藏入口、换一批与探索页资料更新复用同一个 BoardUI IconButton 包装件,采用蓝色动作表面、16px 图标与相同的悬停和忙态。
任务记录、诊断与关注概览
数据表、订阅源和别名表共享工具栏分组:标题与计数同组,列设置、排序与业务动作整组换行。列设置的两枚按钮、排序框与方向键各自保持成组。分页范围与分页操作分组排列,操作组在独占一行仍放不下时继续换行;页码可在中间列折行,上一页与下一页保持同行。作品列表与关注卡片复用相同的分组原则,全选与收起保持成组。
批量操作浮窗通过 ResizeObserver 测量高度,页面滚动区按浮窗高度、底部间距与控件间隔预留空间;浮窗换行后,底部分页与下拉仍可滚到可点击的位置,关闭浮窗后释放预留空间。
任务中心的一轮任务使用独立卡面,失败时卡框使用错误色,结束原因保留正文色。运行进度、后继任务明细、例行任务折叠、历史分页和轮询共用现有数据状态。
本机可控任务复用刮削的三档速度控件,支持低占用、标准、全速;运行中调档作用于当前任务和后继。设置的「媒体库与入库 → 后台任务」保存新任务默认档位。正在进行、本次未执行、最近完成、任务明细和云下载复用完整分页栏,提供每页 10、20、50、100 条选择,默认 20 条;历史与云下载按服务端页码读取,轮询刷新当前页。详情摘要整行可点击,正文和完整标题沿用共用高度过渡,复制成功通过通知栈反馈。
JAV 新作、想要清单和人工复核使用同一完整分页栏。每页数量变化回到第一页,筛选后的总数决定页数;新作默认每页 24 部,并在标准选项中保留 24 部这一档,地址中的 size 同步请求与查询缓存。
系统诊断首先呈现 warning、failed 与 unknown 检查,正常与未配置项保留在「其他检查」折叠区。库健康清单与来源会话各自保留。恢复按钮点明媒体库、网络与访问、维护与更新或任务中心,并使用诊断报告提供的目标。
追更与订阅源检查的问题详情保留本轮来源名称、站点和失败原因,并提供来源管理入口。旧记录只在任务号匹配时读取完成检查点补齐详情;未取得明细时明确说明。媒体修复只为本次跟踪完成的任务发送回执,成功使用短暂通知,缺少工具的提示可以关闭。
关注管理的六项概览使用填充卡,关注列表使用外层填充卡、创作者卡与底部汇总条。标题与读数组合排列,操作区按实际可用宽度整组换行;操作区独占一行仍放不下时,内部控件继续换行,骨架复用同一布局。来源勾选、展开、检查、排序、分页、表格视图与批量操作沿用共用组件。添加关注时,输入法合成期间不请求建议或发起查找;查找失败保留输入和原因,可直接重试。字体、颜色与控件均复用 BoardUI token。
这些页面按 设计准则 核对独立对象、输入与真实状态反馈。桌面和手机使用实际构建产物验收;布局与交互证据归档位于 <私有验证记录>。
收藏窗口与组件目录
2026-10-14 安装官方技能 2026.10.8,取得公开注册表的实际源码。avatar JSON SHA-256 为 614f2a384e2d44c0a15df8e3fc42c1648ccd7101f1c8be98911087641ab28aec,源码逐字复制并由 UPSTREAM.sha256 核验。settings-modal JSON SHA-256 为 620866f68751335b9cbd7f5812850ed8f5e3ede04f88c3acb3e8a5fb36e9ecfe。收藏窗口采用 Peach 设置弹层的 274px 分类栏、614px 面板高度、共用关闭控件和独立滚动正文;React Aria 提供外壳与焦点管理,手机分类栏横滚。
收藏读取实体图、厂牌标识、代表作头像和已绑定在线来源的本地代理,候选耗尽时显示对象图标。入口是 32px 中性星形按钮,位于筛选条读数旁;弹层导航复用液态玻璃、ViewGlide 与覆盖式滚动条,入口本身没有滑动玻璃。实体分类与保存的筛选各有独立页签,已标记和稍后看位于导航底部。窄屏分类与正文分别滚动。
同次核对 tabs(7b89651220b86041aa0db74cf6be6b9b77de24045344bd7fc9627e62f1d98857)、carousel(5a8506c353b8ace96bf51171168cf1617ca775c45e22362de07dba990e79a1a9)与 tree-view(72b06e3187ae7738bd1eabd46bc15ebe1d2d49be768e44306b266d91206eeb9c)。收藏使用类型筛选,已有媒体轮播包含视频、缩略图与圆点;不引入页面 Tabs、树形层级或替换媒体轮播。以上组件均免费,没有 Pro 消费者;官方 Pro 源码未取得。原始 JSON 与生产封面响应证据保存在 <私有验证记录>。
这份文档登记 Peach 界面对齐 BoardUI 的做法:每个控件取了上游哪份公开证据(注册表 SHA-256、取证日期),Peach 照抄了什么、主动偏离了什么、为什么。代码注释写「登记在 docs/BOARD_UI.md」的,证据都在这里。拿不到的证据写「未取得」,不拿猜测顶替。
空状态操作入口
页面没有数据时,要告诉用户下一步去哪,而不是只写一句「暂无」。
空状态复用 emptyStateHtml,操作位于说明下方、居中排列,窄屏可换行。关注列表与关注更新的空状态提供「添加关注」主按钮;馆藏、标签和实体索引中的关注入口也直达 /follow-manage?tab=add。关注管理区域写入地址栏,刷新与返回可恢复对应区域。馆藏有「添加内容」主按钮时,关注入口为次按钮。
统计空状态提供对应入口:内容标签和标签来源前往数据管理补全资料,观看记录前往馆藏,存储来源前往配置添加媒体目录。统计分区操作使用次按钮。
关注来源行保持勾选、名称、来源状态、检查时间和操作同一行;卡片宽度不超过 600px 时省略年份,不超过 460px 时省略时分,完整时间保留在可聚焦时间字段的说明中。创作者标题中的全选与收起保持同一行;全选使用 Lucide 1.40.0 的 check-check 双勾图标,卡片不超过 460px 时只显示图标,操作名称随全选状态同步。列表骨架复用正式的区域属性、工具栏、批量操作与创作者卡片,每条来源使用相同五列布局。
空状态巡检覆盖馆藏与实体索引、关注更新与管理、统计、口味、播放列表、任务中心、高清目标、重复文件、复核、垃圾文件和回收站。筛选无结果保留现有筛选恢复入口;播放列表、手动别名、口味采集与复核抽帧的动作已在相邻表单或工具栏提供。任务记录、高清目标、无重复文件、无复核候选、垃圾文件与回收站为空属于正常状态,不要求用户启动任务或制造内容。来源搜索、详情推荐和图表中的局部空结果保留说明。
创作者别名与扫描操作
这一节讲关注管理页的别名表、关注列表分页与扫描按钮各取了哪份上游证据。
创作者别名区域依次提供「手动添加别名」、待合并与已保存列表。查找关注来源先问 F95zone,登录后读命中线程首楼名片上的其他平台手柄,再拿手柄去其余来源查;勾选登记带手柄的结果时,手柄直接存为检索词的别名,不进待合并。关注设置中的「首次采集历史范围」默认最近 30 天,可选 7 天、90 天或不限时间;按发布时间排除较早内容,无日期条目仍保留;范围内不足 30 条时补入范围外最近的条目,首页不够就往前翻页(最多 5 页),边界随之挪到收下的最早一条。每个新来源首次采集时固定边界,重试和自动更新沿用;已有来源不追溯处理,手动历史分页先补回首页被跳过的内容,再向前翻页。列表统计包含全部已导入的未看条目。
2026-09-13 核对 Table 和 Data Table。实时表格使用 role="grid",单元格为 14px、内边距 10px 12px;页面 CSS 部署标识为 dpl_QqDLotDUMyvoaXmnBoPEK5tSk8mc。官方 https://www.boardui.com/r/table.json 的 SHA-256 为 fc12a8f2f4012d9e983e0b9bbb10f9fe3288d74046566d2623d60e7056c50d88。
2026-09-20 再次读取 Data Table 的实时 DOM 与计算样式:可排序列头使用 24px 实心向下三角,升序时旋转 180 度;紧凑行高 45px;选中行使用 background-secondary-default,未选行透明;浅色与暗色的行分隔线都保持可见。关注表格采用同一组状态,React listbox 则登记到本站现有的覆盖式滚动条,不另画一套滚动条。
创作者别名复用现有 Table 与关注列表共用的 Data Table 外框,待合并按选择、规范创作者、平台别名、依据和操作分列,已保存别名独立成表;规范创作者列复用关注来源的作者头像。两个名字列各占 18%,依据使用剩余宽度;每行可勾选,表头支持全选与半选,右上角提供带数量的「合并所选」和「全部合并」。支持逐条合并、手动添加和移除。批量合并先列出归属关系,失败时保留未完成项供重试。Peach 这两张表用逐字复制进 frontend/src/react/boardui/ 的 table 条目(建在 React Aria 上)配既有别名 API;待合并与已保存都只有几行,排序与分页用不上,不接 @tanstack/react-table。
2026-09-13 实测 Table 分页:上一页/下一页位于两端,页码居中,按钮高 32px、圆角 8px、14px 字号,前后按钮内边距 6px 8px,分页区域间距 8px。点击下一页后当前页变为 2;官方 /r/pagination.json 的 SHA-256 为 cbbb09ecb86b3f93d4c923f02d272a7086db624ab69eaf5768f036b7458435f8。Peach 复用既有 pagination.ts 与 Board 样式,保留 Lucide 箭头和中文标签,手机页码独占第二排。
关注列表默认视图按完整创作者组分页,表格按排序后的来源分页;每页 10、20、50、100,默认 20,数量偏好保存在本机。排序、版式与数量切换回到第一页,页码写入地址,越界页落到末页。默认视图支持全部展开/收起;选择跨页、跨视图保留,全选本页只影响本页来源。底部批量操作复用人工复核的 selectiondock、计数和取消选择模式,提供检查、启用、暂停、删除;批量请求使用全部已选来源。滚动表格建立局部定位边界,避免隐藏表头文本撑出手机页面。加载骨架按已选版式预留卡片或表格结构。
扫描与采集复用 Split Button 外观和共享菜单定位。ProcessingActions 的扫描入口默认「扫描并补全资料」,菜单包括同名主动作、补全资料与预览、只扫描、只生成本地预览、只采集在线资料;缺图入口默认「补全资料与预览」,下拉提供两种分项。图标使用现有 Remix Icon 的 RiDatabase2Line、RiHardDrive2Line、RiGlobalLine,分别指资料、本地磁盘和外部来源,无新增依赖。
新入库范围在「扫描与采集」卡片内使用独立任务行:标题、BoardUI Chip 数量、范围说明与处理按钮同组,与概述之间用分隔线区分。待处理数量大于零时使用蓝色状态标记,零部时保持中性并说明下一步。桌面操作靠右,手机操作独占一行;运行中保留数量,处理入口等待当前任务结束。
隔离内存样例已验证全部合并、来源筛选、手动添加与菜单键盘焦点。1280px 桌面和 390×844 手机页面无横向溢出;待合并表格在自身区域横向滚动,已保存表格与添加表单在手机换行。
窄屏筛选框滚动
760px 及以下,首页与实体资料页的共享筛选框向下滚时随页面离开顶部,向上滚时恢复吸顶。方向累计 8px 才切换,使用现有 --board-motion 过渡顶部约束,文档占位保持不变;减少动态效果时即时切换。页面顶端、键盘焦点、输入与展开菜单保持筛选可见,桌面维持吸顶。原生 sticky 与滚动事件足够覆盖此交互,不新增依赖;浏览器视觉验收未取得。
窄屏搜索玻璃动效
2026-09-11 核对 liquid-gooey spring.ts,MIT,源码 SHA-256 9dc0d5e9dd269000d95743572320039404982803d1b2da9977e717b5956d5481。
形变证据来自同一 revision 的 LiquidItem.tsx:morph.shape 将尺寸变化描述为弹性形变、过冲和软胶回落;observer.ts(SHA-256 5e44c076e50ceb707572cd7b4e083f835a5d454cc21fb405f5c7dd3ff3ef4865)分别驱动位置、尺寸和圆角。形变验收要看轮廓本身在变,裁切与透明度做不出这个效果,不算证据。
Peach 使用现有 313ms 玻璃弹簧(stiffness 1700、damping 46、mass 1),从图标真实矩形变为搜索框,轮廓中途鼓起、回落,反向操作从当前可见矩形接续。关键帧限制在视口内,玻璃全程可见,文字不横向缩放。尺寸动画只作用于绝对定位的搜索层,建议面板在动画结束后显示;起止同高 36px、共用顶栏中心线。右侧按钮依次为搜索、沉浸、多选。
未新增依赖;上游未作为完整搜索组件复刻。上游搜索交互与浏览器实测未取得:这次取证不走浏览器通道,只读了源码。
数据整理子页
这一节讲复核、高清目标、重复文件、垃圾文件、回收站五个子页参考了哪些 Board 模板,各采用到什么程度。
2026-09-09 使用内置浏览器读取组件目录及 Dashboard 侧栏的八个模板。线上 CSS 资源版本为
dpl_3cjHNDgN6SsY8bTxSfXGACCCc8Zp,样式资源为 0pj0_xn8e6w4j.css、
0i-yg_o67~u3a.css、0z54_bq~~57b~.css。
| 当前参考 | 实际观察与采用范围 |
|---|---|
/components |
检查 Foundations、Base、Blocks、Charts、Templates 完整目录;目录覆盖不等于逐组件全部状态验收 |
/components/segmented-control |
单选滑块、方向键移动、Space 选择;适合短的局部视图选择 |
/components/tabs |
下划线面板切换与 PillTab 局部筛选区分;Peach 复核十类采用纵向分类,保留面板关联和键盘操作 |
/components/data-table |
结果数、筛选、逐行操作、部分选择状态、分页分层;复用 Peach 已有选择与分页逻辑 |
/components/stat-cards |
紧凑统计与底部比较栏两种结构;子页只有当前任务读数,不引入无实际数据的趋势 |
/templates/dashboard |
面包屑、标题动作、统计与结果工具行;radio 轨道 padding 4px、radius 10px |
/templates/marketing |
分类筛选与结果表独立;采用局部筛选结构 |
/templates/calendar |
月份导航与日期网格;五个子页不采用日历 |
/templates/finance |
汇总指标与交易结果表分层;采用结果标题与操作区归属 |
/templates/medical-profile |
主体信息、指标与提醒分区;复核保留主体、证据、动作分区 |
/templates/ai-chat |
项目侧栏与 Code、Changes、Browser 局部切换;不把局部切换当第二层页面导航 |
/templates/ai-image-generation |
Gallery、Styles 与图像网格;采用预览优先的卡片结构 |
/templates/ai-profile |
身份概要与指标卡;不引入与文件整理无关的数据面板 |
模板已逐页读取实时 DOM。 Pro 模板只作为公开外观和信息层级参考。实现使用逐字复制的 BoardUI 源码、共享 HTML 控件及 Board token,无新增依赖。
作用范围是 /review、/quality-goals、/duplicates、/junk-files、/trash。
数据管理入口保持卡片导航。复核分类在桌面纵向排列,窄屏自动换行;分组、候选、批量动作和分页沿用既有实现。
重复组提供文件预览及尺寸、时长、位置比较;高清版、垃圾文件和回收站共用预览卡片的版式。
Peach 使用 Board 的视觉与组件语义,保留 Vite、FastAPI 和现有媒体行为。Board 的公开实现依赖 React Aria,按 ADR-0031 以 React 子树逐字复制进 frontend/src/react/boardui/;尚未迁移的遗留页由共享 HTML 控件与原生键盘行为承担适配。
控件对应
下表是 Peach 现有控件与 Board 控件的一一对应,找「这个控件该照哪份上游」时先查这里。
| Peach / Geist 语义 | Board 对应 | 实施方式 |
|---|---|---|
| Toggle,布尔开关 | Switch | 42×24 轨道、18px 滑块、内嵌标记;保留 checkbox 与 switch 语义 |
| Switch,互斥分段 | Segmented Control | 单选 radio,轨道内选中背景;方向键沿用原生行为 |
| Button / Icon Button | Button / Icon Button | 主动作蓝色,危险操作沿用危险色;纯图标按钮清除默认内边距 |
| Input / Input 前后缀 | Input adornment | 单位在框内尾部,分隔背景;独立数字输入保持可访问名称 |
| 数值范围说明 | Invalid + HintText | 合法范围验证;错误时显示锚定字段的小提示,修正后消失 |
| Select | Select | 保留已实现的列表键盘、焦点与菜单定位,使用 Board 尺寸与表面 |
| Checkbox / Radio | Checkbox / Radio | 保留原生状态与选择范围;共享颜色与焦点 |
| Tabs / 页面导航 | Tabs | 管理导航下划线,配置与设置按内容分区 |
| Fieldset | 卡片正文与操作区组合 | 标题在框内,操作区用相邻色阶,不增加框中框 |
| Modal | Settings Modal / Dialog | 设置左侧分区、右侧标题及独立滚动;业务确认保留后果和错误恢复 |
| Toast | Notification 的面 + Sonner 的栈 | 短暂操作回执,对照见下文 |
| Note / Banner | 字段反馈 / Announcement | 数据错误与恢复动作留在发生位置 |
| Tooltip | Tooltip | 保留含义与键盘焦点可见性 |
| Table | Table / Data Table | 保留选择、排序、批处理和实际数据 |
| Tag / Badge | Chip / Badge | 标签与状态语义分开,保留可操作范围 |
| Sidebar / Drawer | Sidebar 的收起与展开 | 一个按钮控制同一导航,移动端使用遮罩 |
| 指标带 | Stat Cards | 图标、主读数、色阶底栏;保留统计视图切换,无历史对比时不显示涨跌 |
| 口味排名 / 维度 | Bar List / Radar Chart | 独立 SVG 与排名条,至少三个有效维度才绘制雷达 |
| 来源数量分布 | Radial Chart | 独立分布环,与来源明细共用当前查询结果 |
| Spinner / Skeleton / Progress | 原有等价反馈 | 不虚构进度,保持业务请求时机 |
| Scroller / Collapse | 溢出滚动 / 展开分组 | 保留键盘、溢出和展开行为 |
| 视频播放器、照片灯箱、沉浸队列 | 无直接替代 | 保留专用交互,仅统一外围卡片与控件 |
设计边界
改界面时始终成立的约束:
web/board.css是盖在web/css/上的视觉层,随页面一起加载,没有开关。两份要一起读: 尺寸、颜色和布局的底稿在web/css/,board.css 只做覆盖,选择器权重必须压得过底稿。- 「增加对比度」关闭透明与折射;系统降低透明度偏好也使用实色。折射只作用于导航背景,不扭曲文字。
- 设置标题与控件在桌面同排,手机宽度不足时换行。单位与数值属于同一输入框;可关闭的功能显示开关,关闭时隐藏数值。
- 设置页的保存键统一叫「保存配置」,回执「已保存配置」;保存、检查、添加、刷新这类操作键用 BoardUI
Button的primary(缺省值,蓝底白字)。secondary只给面板触发键与「取消」,不可逆操作用danger(frontend/test/settings-buttons.test.ts)。 - 数值非法时不保存;关闭搜索记录后不读取或记入搜索记录,关闭相关推荐后不请求该模块。
- Board 免费源码以官网声明的 MIT 条款使用;Pro 图表与模板不取用收费源码。项目自有图表不宣称来自 Pro,也不承诺 Pro 更新权益。
- Remix Icon 固定为 4.9.1,按包内 Remix Icon License v1.0 登记;官网所写的 Apache 2.0 不代替实际包许可证。保留已确认图标,候选由
<私有验证记录>审查。
参考证据
2026-09-08 读取官方公开注册表,原始文件在 <私有验证记录>。
| 来源 | SHA-256 |
|---|---|
| https://www.boardui.com/r/input.json | ac1e66c9ed15f9db2750dd528bc894c856ac84e79f72ff4acb96f14b1ab9c249 |
| https://www.boardui.com/r/switch.json | 3412c1910b2fa7f5d17404bf50bd2503e9ca097cf9d741366379cf18e09ebeb6 |
| https://www.boardui.com/r/segmented-control.json | 62300be25310fef31962ddc237818739a2efd0d0143dd0832f3d1a2166c28e38 |
| https://www.boardui.com/r/button.json | 89cc2c176d1d94d481bbfc6e34f233ccf109c10d319533cc7c1e98923b6e7d69 |
Input 的上游错误信息位于字段下方,并通过 errorMessage 关联;锚定的小提示是用户指定的 Peach 差异。设置布局来自公开 settings-modal.json:871×614、274px 导航、32px 内容边距、24px 外圆角。每组设置坐在一张灰卡上(16px 圆角、左内边距 12px),设置弹层的开关行与配置页同一种卡;卡里再分块(媒体目录、CloudDrive 分档)用白底加分隔线色描边,不和外面的卡同色。原始设置参考保存在同目录下 boardui-full/settings-reference.json。
排版、动画与进度
这一节先写全站字阶、动效与进度口径,再按日期登记各页控件的逐项对照。
正文 14/20、次要文字 13/18、说明 12/16,标题按 24/34、20/26、18/26 分层;手机可编辑输入 16px、40px 控件,避免输入缩放。输入焦点环占用的外侧空间计入索引标题行留白。
桌面侧栏宽 60/260px,按钮与导航共用同一容器;宽度与标签透明/模糊使用 300ms cubic-bezier(.4,0,.2,1)。设置面板使用 300ms cubic-bezier(.32,.72,0,1),缩放 .85→1、模糊 4→0;手机抽屉沿水平方向滑入。设置标题下方为 40px 渐隐,滚动后以 200ms 显示。保留分组内行分隔,不给每张统计卡套线。播放器拖拽、时间进度、沉浸切片等没有 Board 等价物,维持媒体语义;系统减少动态效果时关闭装饰动画。
Agent Progress 的公开演示使用定时步骤。Peach 的作业由服务端状态推进,采用自有圆形数量进度,不把计时当作完成,也不把逐作品循环的阶段假装成整批已完成步骤。共核对 9 类入口:
| 入口 | 进度口径 |
|---|---|
| 扫描与采集 | 当前阶段文字 + 已处理视频数 |
| 链接检测 | 已检查 / 总数 |
| 失效链接清理 | 共享后台作业数量进度 |
| 资源扫描 | 已完成来源 / 总来源 |
| 资源清理 | 共享后台作业数量进度 |
| 关注更新 | 已完成来源 / 总来源 |
| 口味采集 | 共享后台作业数量进度 |
| 添加关注 | 共享后台作业数量进度 |
| 版本更新 | 已有下载、校验与安装阶段;由版本分支负责 |
Charts 已核对 Stat Cards、Bar List、Radar、Radial、Contributions、Heatmap 和 Sankey 的公开行为。馆藏统计使用当前快照;浏览历史按去重后的真实访问时间生成星期/小时热图与每日活跃格,支持 7、30、90、365 天和全部时间。last_played 不充当完整播放事件序列。创作者流向使用来源网站与创作者线索的实际关联计数;非互斥口味标签不进入漏斗或流向图。
Slider、Notification、Tooltip、Carousel、Checkbox、Chip、Dropdown、Link Button、Button Group 已取得官方公开注册表,文件位于验收目录的 board-reference。范围控件保留原生键盘操作,Checkbox 支持部分选中,通知悬停与聚焦暂停计时,图片查看复用 Swiper 的缩放及键盘导航。排名默认展示五项,通过底部渐隐和按钮展开当前排名数据。
Radial Chart Card、Bar List Card、Heatmap 与 Sankey 的 Pro 源码未取得;当前为依据公开文档实现的 Peach 适配,不是安装 Pro 组件。环形图连接媒体库及网盘计数,支持加载、聚焦与选中反馈;Sankey 使用 d3-sankey 的成熟布局计算,保留来源颜色、流线聚焦与数值联动。
补充公开参考文件 SHA-256:
| 注册表 | SHA-256 |
|---|---|
| sidebar.json | b3fb5a01f2b334062a0645b71a6c55eec6874da90842270259ff0b1cdc67e42b |
| auth-card.json | cf4159a700769519867f150acbfafd6f3345b9990fd5b6b76c7609407f413cf2 |
| settings-modal.json | eb01742ca56daa473f042244176cd697fc20010ab18f680e3a3a8012d69f6c5b |
| typography.json | 5b7eca25350829755eb15cb474ab009fd1f8b929e62d54182f648b4f2e97bf8e |
| stat-cards.json | 3a140eeb9ab4ebc327e0e585f6cd6e4331be3e68694e72ec6aab80fd5adf705c |
关注列表的表格视图(2026-09-08)
共享数据表的主要名称列默认承接剩余宽度;馆藏、关注来源、JAV 订阅、创作者别名、文件已丢失的记录、链接检查与诊断清单共用这套列宽偏好。手动调整后保存像素宽度,重置列宽恢复自适应,列显示独立保存。名称、路径、地址与结果正文以单元格可用宽度折行或省略;路径与地址随列宽重算中间省略,完整原文保留在提示和无障碍名称中。文件已丢失的记录根据有无替代文件给操作列分配默认宽度;窄屏在表格内横向滚动。
取证来源是 https://www.boardui.com/components/data-table 的实时 DOM 与样式表:_next/static/chunks/0n0ugaibgw__p.css(SHA-256 a856db5e9e1a58b2e32b7bfa6d7f1cab69dd09e4bd7ac22fc455dd10b525cf27)里的 .bui-table 规则,以及公开注册表 r/table.json(fc12a8f2f4012d9e983e0b9bbb10f9fe3288d74046566d2623d60e7056c50d88)和 r/data-table.json(613299eca0f448460a546f7959feab8dab19fbfd6e18670f7216ff304a1e3574)。
2026-09-16 重取这三份:r/table.json 与 r/pagination.json 逐字节未变,r/data-table.json 已是 7bb73a6cd099b9b16390e5fe00f8ba2d55b5ef96c1e8f90a056168cd2e3235e6(24531 字节),上游自己改过。Peach 复制进树的是 table 条目,data-table 只读不抄(原因见 frontend/src/react/boardui/ORIGIN.md),所以这次漂移不影响已复制文件的哈希。
| 上游实测 | Peach 表格视图 |
|---|---|
th/td 内边距 --spacing×3 / ×2.5,实测 10px 12px;vertical-align:middle |
同值 |
字阶 text-body-medium,实测 14/20、500;表头 --color-text-tertiary,正文 --color-text-primary |
同值;Board 层用同名 token,旧版层用 --muted/--ink |
表格摆在 --color-background-primary-default 面上;表头 --color-background-secondary-default 底,上下各一条 --color-separator-border |
同值。外框不用作者卡那块 --ground:Board 层把它定成 secondary,与表头同色 |
tbody tr 只有一条下边线,悬停不换底(实测 rgba(0,0,0,0)) |
同值 |
行焦点 data-focus-visible 内嵌 2px 焦点环 |
未采用:Peach 的行不可聚焦,焦点落在格子里的控件上 |
bui-table-sm 紧凑档(10px 6px、text-body-2-medium)与表尾 Normal/Compact 分段器 |
不采用:视图开关本身就是密度选择 |
| 表头首格全选复选框,带 indeterminate | 不采用:全选连着批量动作留在列表上方的选择栏,避免两个全选框 |
| 分页底部 Previous/Next | 采用:表格按排序后的来源分页,页数与页码规则见「创作者别名与扫描操作」 |
可排序表头带 ChevronSortDown 字形 |
同一枚 ChevronSortDown;可排序的表头接入工具栏已有的排序 |
表格 min-w-[1000px],外层 overflow-x-auto |
min-width:760px,外层横向滚动,窄屏不折叠列 |
选中行的样式上游页面没有暴露出来(复选框选中后 tr 无 data-selected):Peach 给选中行铺一层蓝色 8% 的底,不描蓝线。表格外面多一层 .ftableframe 管边线与圆角,.ftablewrap 只管横向滚动:两端按滚动位置渐隐说明「那边还有」,鼠标停在表格上时竖向滚轮转成横向,与复核页标签条同一份接线;边线留在外层,才不会跟内容一起淡掉。表头五列都能点,维度与工具栏下拉是同一份并集:作者、上次检查按作者分组比,来源、站点、状态按单条来源比。
关注列表的框、来源行与勾选框(2026-09-08)
取证来源是公开注册表 r/checkbox.json 与 r/checkbox-card.json(checkbox-glyph.tsx、checkbox-card.tsx),以及站点样式表 0n0ugaibgw__p.css(SHA-256 a856db5e9e1a58b2e32b7bfa6d7f1cab69dd09e4bd7ac22fc455dd10b525cf27)里的 check-draw、--shadow-checkbox-selected、--shadow-xs 与 token 定义。
| 上游 | Peach |
|---|---|
CheckboxCard:10px 圆角、1px border-button-default、pl 16 / pr 20 / py 12,悬停 background-primary-hover 150ms,整卡可点 |
关注列表的每条来源行;勾选框在左(Peach 的行右边是检查、移除两枚动作键);选中行沿用焦点环色的边,上游只亮勾选框 |
Checkbox 16px、4px 圆角;未选 border-checkbox-default(亮 neutral-300、暗 neutral-700)+ shadow-xs;悬停边线到 neutral-400/500,底不变 |
.ui-pcheck 同值;旧版层的悬停换底被 Board 层压掉 |
选中 blue-500→600 渐变 + inset 0 2px 0 0 #ffffff40, inset 0 0 0 1px accent-500;悬停渐变提到 400→500 |
同值,渐变取 --board-blue |
勾 2px 圆头,pathLength=1,check-draw 200ms cubic-bezier(.65,0,.35,1) 从零画出;减少动态效果时直接显示 |
勾是雪碧图的 check,无法写 pathLength,按路径实长 23 写 dasharray;其余同值 |
| 页面上卡片摆在 primary 面上 | 关注列表整段是一只 --ground 卡(与「添加关注」同一只),作者卡是 primary 面,来源行才是 CheckboxCard;这样悬停的 primary-hover 才不与底同色 |
| Segmented Control 暗色:轨道 neutral-925、滑块 neutral-800 | Peach 暗色页面本身更深,轨道留 tertiary(#262626),滑块提主文字色 14%;这一组取代上文「分段滑块的暗色」那条「未取得」 |
Avatar avatar-neutral-background:亮 neutral-300、暗 background-primary-default |
首页两排与身份头像继续用主文字色 10% 混底:暗色里上游值与卡片底同色,头像会看不出边界 |
媒体库图标选择器同批:格子与触发钮同一枚 20px、2 描边的字形,装在同一个 20px 盒子里居中;候选 42 枚一行七枚,题材、身份、场景、媒介各一组;网盘库不另选时显示来源站标(服务端 media_libraries.libraries 本就把单一来源的库落到该来源),本地路径没有可识别的来源,写作「默认」并显示磁盘。
下拉菜单的开合动效(2026-09-08)
取证来源是公开注册表 r/dropdown.json(SHA-256 e91198d2f1eb131570a0aab53685a4c2c724365d17aecbc5d2113e561152b0b6)里的 components/base/dropdown/menu-styles.ts:MENU_POPOVER_SURFACE 写着 transition duration-150 ease-out,data-[entering] 与 data-[exiting] 都是 opacity-0 scale-95 blur-[2px],缩放原点按 data-[placement]:bottom 用 origin-top-left、top 用 origin-bottom-left、left/right 用 origin-right/origin-left。同一份配方由 Select 与 Dropdown 共用。
| 上游 | Peach |
|---|---|
| 150ms ease-out,透明度、scale .95、2px 模糊一起进出 | 同值,board-menu-in/board-menu-out 两组关键帧 |
| React Aria 在 entering/exiting 期间挂 data 属性 | 进场由 CSS 按 :not([hidden]) 起;退场加 leaving,dismissMenu 等 animationend 再 hidden |
| 原点按 placement | wireAnchoredMenu 写 data-placement(bottom/top/right);侧栏添加页面的 listbox 向上开,原点固定在下沿 |
| 只有 Dropdown 与 Select 两种面板 | 全站的下拉都走同一份:锚定菜单、Select、上下文卡、媒体库菜单、搜索建议、播放器右键菜单、侧栏添加页面、标签选择器 |
未取得:shadow-dropdown 与 --color-border-button-default 的具体值 |
面板的边框、投影沿用 Board 层已有的写法 |
旧版 Geist 层不加动画;系统减少动态效果时由全局规则关掉,dismissMenu 读到 animation-name:none 就直接藏。
Toast、Note 与 Notification 的对照(2026-09-08)
取证来源是公开注册表 r/notification.json(SHA-256 92d9e93d7c89f5cdfd79b5f05c14f3663f5aa9fd7bb6bf68729aa0b6e6bb714e)里的 components/base/notification/notification.tsx:卡片 p-4 pr-11、rounded-2xl、border-border-button-default、bg-background-primary-default、shadow-dropdown;40px 圆形状态图标;标题 text-body-medium、说明 text-body-regular text-text-secondary;关闭键 top-3 right-3;3px 蓝色倒计时条;退场 opacity 0 / y 8 / scale .96 / blur 3px,180ms ease-out;进场只在传了 introDelay 时才有;视口栈 min(400px,100vw-24px)、间距 12px,位置变化走 spring。
| Peach 现有 | 处理 | 依据 |
|---|---|---|
| Toast(操作回执、撤销) | 栈用 Sonner(frontend/src/react/toaster.tsx):进退场、堆叠、悬停展开、滑动关闭与悬停暂停计时照它;面、线、阴影取上面这份 Notification 的量纲,圆角用浮层那一档,不画状态圆和倒计时条 |
用户指定 Sonner;回执的面和菜单、教程卡是同一种浮层 |
| Toast 的正文与动作 | 单段正文,最多一个「撤销」,用 Sonner 的动作键;撤销结果按同一个 id 写回同一条 | Peach 的回执只有一句话 |
| Toast 的位置 | 右下角;安装教程卡在屏幕上时,栈的底边抬到卡上沿之上 | 两块都停在右下角,回执不压在教程上 |
| 成功态的颜色 | 勾用主色 | notification-success-* token 的值未取得 |
| Note(字段、任务面板旁的持久反馈:读取失败、任务状态、完成汇总、权限过宽) | 保留,不切 | Notification 是浮在视口角上、会自动消失的栈;这些要留在发生位置,失败还得带重试入口 |
| Banner(页面级问题与恢复动作) | 保留,不切 | 上游注册表里没有 Announcement 的对应源码,未取得 |
| Tooltip | 保留 | 已有 Board Tooltip 的对应 |
口味、复核、首页与详情控件的对齐(2026-09-08)
新增取证:公开注册表 r/tabs.json(SHA-256 feab9789b17008436597b51e52b90de5cff6180924f2a7c8bef14a2136d3a240,含 tabs.tsx 与 pill-tab.tsx)、r/avatar.json(614f2a384e2d44c0a15df8e3fc42c1648ccd7101f1c8be98911087641ab28aec)、r/chip.json(d2b0dd38146325acada58fbc241d13fcd633bb5407ce1ef457e752023fe282de),与已登记的 segmented-control.json、sidebar.json 一起保存在 <私有验证记录>。avatar-group、bar-list-card、radar-chart-card 在注册表返回 404,未取得。
| 位置 | 上游 | Peach |
|---|---|---|
| 口味维度、复核分类的标签条 | Tabs:1px 基线、2px 蓝线随选中项 transform/width 各 200ms 滑动;选项 px 10 / py 8、Body 1,选中蓝字 Medium;计数徽标 Caption Medium、px 4 / py 1、4px 圆角 |
复核页的 .reviewtabs 接进同一份 wireBoardTabs;两处按上游字号与间距重排,计数徽标沿用上游两态 |
| 口味页「浏览器记录/Peach 内部」 | Segmented Control:tertiary 轨道 p 4 / r 10、选项 px 10 / py 4 / r 6、滑块 200ms | .insightswitch 接进 wireBoardSegments,原生 radio 不变 |
| 排序行的版式切换 | 同上,高度 36px | 压到 30px 与同一行的排序键、换批键齐平:主动保留的差异 |
| 分段滑块的暗色 | segmented-control-selected 暗色值未取得 |
主文字色 14% 混进轨道色;暗色里轨道与 primary 同值,滑块必须比轨道亮一档 |
| 排名条、雷达图 | 上游 Pro 图表源码未取得 | React 版直接显示终值,没有入场动画:整块由 island 异步挂载,挂上的那一刻已经在视口里,从零长一遍变成页面读完之后才开始动 |
| 排名行悬停与展开键 | PillTab 悬停 background-primary-hover 200ms |
悬停改为主文字色 6% 薄底 + 200ms:暗色 primary-hover 太跳、亮色看不见;展开键同一层 |
| 三个面板标题(口味总结、浏览器画像、数据源) | Heading 20/26 | 同一档,React 版用 text-title-2-medium;内边距统一 20(卡面走 cardClass() 的 p-5,三档内边距收成一档) |
| 复核「跳过」 | Chip blue:亮 200/800、暗 950@60%/300 | 采用;error/primary 不变 |
| 交集条上已生效的筛选 | Chip subtle + neutral:px-1.5 py-1、Body 1 Medium、tertiary 底配次文字色,不描边 |
主动偏离:全站标签以详情面板那颗为基底统一,所以这一颗也走 --tag-radius(这套里是 8px)+ 一圈 --line + 28px 移除键,只有填充取 --picked 说明它已生效。上游 Chip 只标状态,Peach 的每一颗都要能就地撤掉,同一个词还要在卡片、详情面板、筛选条上认得出是同一样东西 |
| 侧栏名单的展开键 | 无对应(上游侧栏不截断名单) | 取排名卡那枚展开药丸的身量;再按一下收的是整组,不是把名单退回另一个断点 |
| 侧栏收起键 | 36px、rounded-2lg、foreground-icon-secondary,收起时与品牌相隔 10px |
采用,图标沿用 Peach 的 panel-left |
| 详情页门挡 | 无对应 | 铺满播放器格不留黑;播放器格只圆左上角(右贴侧栏、下接「接着看」),窄屏与影院模式圆上面两角 |
| 没有图的身份头像 | Avatar neutral 的暗色默认背景与 primary 面相同 | 采用范围与前景对比度见「无图头像与浮卡子页」,不能仅复用上游默认背景 |
| 首页女优与厂牌两排 | 无 Avatar Group;PillTab gray + Avatar sm(24px) | 见 2026-09-09 那一节:女优竖排人像格、厂牌 40px 灰 Pill |
| 管理页标题 | 无对应 | 只在 812px 窄列页面居中,别处与面包屑同一左边线 |
| 沉浸模式 | 无对应 | 随机流在入口筛掉脱盘来源的片子 |
排名列表、复核悬浮框、批量条与侧栏切换器(2026-09-08)
取证来源是 boardui.com 的实时 DOM:/components/bar-list-card 与首页侧栏(aside 260px / 收起 60px)。r/bar-list-card.json 与 r/sidebar.json 之外的注册表条目未取得。
| 位置 | 上游 | Peach |
|---|---|---|
| 排名行 | 行 36px、圆角 8、无悬停类;填充条 absolute inset-y-0 left-0 圆角 8,chart-6 14% 透明,只对宽度和颜色做 500ms 过渡 |
行与填充条圆角 8,填充 15%(工具类档位),去掉行悬停底(悬停底与填充条两层叠一起会显得脏);行高保留 44 容两行字;填充条用 preserveAspectRatio="none" 的 SVG 铺满整行,宽度写在 rect 上,不走内联样式,也没有过渡 |
| 「Show N more」 | 40×20 药丸,居中贴底 4px,border-button-default 描边、primary 底、xs 阴影,14px 箭头,悬停 primary-hover 150ms;被折起的行直接不渲染,没有渐隐 |
同尺寸同色;保留 48px 渐隐是主动差异;点按展开键时列表高度走共用 Collapse 的 .2s ease-in-out(主动差异,上游没有高度动画;先快后慢的曲线在头一帧就把视口里那截长完,展开看不出动画),过渡只在点按那一下挂上,切维度标签引起的高度变化直接到位,不跟着抖;收起时展开键逐帧钉在指针下,卡片多在页底,变短引起的视口回退朝一个方向完成,不先上移再回滚 |
| 数据源卡的删除键 | 站上图标键 size-9 rounded-2lg text-foreground-icon-secondary,只过渡颜色 |
36px、圆角 10、透明底,悬停主文字色 6% 薄底加 --drop 文字,transform:none |
| 指标卡悬停 | 无对应 | --surface 与 --ground 在亮色里同为白,改主文字色 6% 混底 |
| 管理页标题 | 无对应 | 标题、面包屑、导语不看布局类,一律对齐 1120(复核、高清版、重复文件这些子页没有布局类),复核页容器同宽 |
| 主按钮 | Button 36px、Body Medium | .primary 也进 36px / 圆角 10 / Body Medium 的盒子;复核底部工具条整条压 --control-h,主按钮跟着 |
| 灰卡上的控件 | secondary 底上放 primary 白底控件 | 配置页下拉、输入、图标触发键与关注页添加框都白底 |
| 通知状态圆 | Notification 用 lucide 图标 | 警告态换 circle-alert(自绘 i-alert 在 20px 下只剩一个点);Note 与上下留 12px |
| 复核页悬浮 | 无对应 | 标签条留在原地,工具条自己悬浮;分组条贴在它下面时两条合成一个平底玻璃框(上 20 0 0 / 下 0 0 20 20,同一块 --glass-fill,中间只靠 20px 间隔分开);两条都向外扩 16px 再垫回,控件与卡片同一左边 |
| 详情页关闭键 | 参照 YouTube:播放器上的键亮色下也是黑底 | 60% 黑底白字,悬停 20% 白晕;亮色下用白底的话,白晕看不出悬停 |
| 数据管理骨架 | 无对应 | 扫描卡的「采集来源」「扫描并补全资料」从骨架起就都在位,内容换入只是变成可点 |
| 批量条 | 无对应 | 隐藏批量键时要防 Board 的 inline-flex 压过 [hidden],否则从垃圾页回首页会多出三个键;「移入回收站」用 error 按钮同一条红色渐变,首页与垃圾页文案统一 |
| 媒体库菜单 | 侧向弹出的菜单贴在侧栏右缘外 8px | 收起时触发钮只有 32px,菜单从侧栏右缘起算,不压到侧栏上 |
| 视频网格 | bar-list-card 之外无对应 | 去掉网格外面那一圈框,卡片直接摆在页面上 |
| 社媒标记 | 无对应 | Instagram 与 X 同一只墨色圆盘,字形取 Phosphor instagram-logo |
| 侧栏切换器 | 32px 圆头像 + 名字 + 双向箭头,gap-2,悬停在按钮外 6/5px 处描 2px 圆环;收起键只有 20px 高的图标、无底 |
数据库标识放进 32px tertiary 圆盘,悬停与展开态同一圈线;收起键展开时 20×20 靠右,收起时 36×20 在标识上方,相隔 10px,头部 62px 与上游同高 |
首页两排、关注批量条、复核分页与数据管理页(2026-09-09)
取证来源:公开注册表 r/pagination.json(pagination.tsx)、r/stat-cards.json(stat-cards.tsx 的 PlainStatCard)、r/avatar.json(avatar.tsx),以及 /templates/dashboard 与 /templates/finance 的实时 DOM。这三份 JSON 只读了正文,SHA-256 未取得。模板左侧可切换的其它视图(calendar、medical-profile、ai-chat、ai-image-generation、ai-profile)是日历、档案、对话与生图页,与 Peach 现有页面无对应,未采用。
| 位置 | 上游 | Peach |
|---|---|---|
| 首页女优一排 | Avatar 只到 lg 36px,没有竖排人像格 | 竖排格:48px 圆头像在上(取上游 size-12 那一级)、名字 Caption 在下,格宽 76、圆角 12、不描边;悬停 primary-hover,选中 tertiary 底 |
| 首页厂牌一排 | PillTab gray | 40px 灰 Pill 放大一档:28px 圆标识在左、名字在右、圆角 12。标签那一排是 30px 描边药丸,厂牌靠身量、圆标识和无边框跟它分开 |
| 关注页批量条 | 无对应 | 批量条只有保存、跳过这类按行动作;勾选靠每行行首的「全选/全不选」 |
| 复核队列分页 | Pagination:nav 两端对齐 gap-2;Previous/Next 是 32px 次级小键(圆角 8、内边距 6/8、带箭头);页码 size-8 rounded-lg Body Medium,当前页 border-button 描边 + primary 底 + xs 阴影并标 aria-current="page",其余次文字色、悬停 secondary-hover;两侧折成「…」各留一个邻页;一页时不渲染;没有过渡 |
尺寸与颜色照抄;分页做在前端,一页 20 张,限制一次渲染的卡片数量;箭头用雪碧图的 chevron-left/right,文案「上一页/下一页」;分组与筛选按整条队列算、卡片只画本页;换分类/分组/筛选回第 1 页 |
| 数据管理页 | dashboard/finance 模板:顶上一排 plain stat card(132px、圆角 16、secondary 底、p 16;32px 图标格 + 20px 字形;标签 Body Medium 次文字色;读数 title-1-medium 24/34;grid-cols-2 lg:grid-cols-4 gap-4),下面是图表卡与数据表 |
五张读数卡一行(1120 内),窄了折两列、再折一列;整张卡是入口按钮,悬停抬主文字色 6% 底(上游卡不可点);读数下一行 Caption 是同一份 payload 的分项;扫描与采集、媒体修复各占一整行,左说明右按钮;资源同步的结果读数同一副卡片,来源一行、待永久删除/空文件夹/缓存一行,各自等分 |
复核卡的候选、未收录 genre 与骨架(2026-09-11)
Radio card 沿用 2026-09-08 取得的 r/checkbox-card.json(checkbox-card.tsx),未新取证据:
上游只有 CheckboxCard 一件,Radio 版是同一只卡换控件类型。
| 位置 | 上游 | Peach |
|---|---|---|
| 元数据候选 | CheckboxCard:整卡可点、10px 圆角、1px border-button-default、悬停 primary-hover,选中沿用焦点环色的边 |
一组候选是 role="radiogroup",每张卡整块可点、圆点在右;卡内上半是这条来源给的值、下半是证据行,证据沉一档底色并加一道 border-top,因为两段一个颜色时看不出哪句是值、哪句是佐证 |
| 候选卡标题 | 无对应 | 卡上先写它在问哪个字段(梓怡 · 女优),来源与取证说明留在下面;标题只写主语的话,末尾省略号一截,看不出这条候选要替换什么 |
| 未收录 genre | 无对应 | 候选卡下挂一块 --surface 的收录区:原文在左、中文标签输入在中、「收录」与「不是内容」在右。它定的是「这个词以后算什么」,和候选卡的「这条记录写什么」不是一件事,所以不混进候选列 |
| 玻璃框的边 | 无对应 | 工具条与分组条各描一圈 inset 的 --glass-rim/--glass-low,接缝那条边不描(上面不画底边、下面不画顶边),两条合起来仍是一圈。暗色下这块玻璃的底和页面一样黑,没有这一圈就只剩一块黑方块 |
| 复核骨架 | Skeleton 只是占位形状 | 骨架直接用最终容器的类名(.review-workspace、.reviewcontrols、.reviewbulktoolbar、.reviewlist),分栏、列宽、卡高全由复核页自己那套规则给;renderInitialSurfaceLoading() 先写 data-surface 才画,否则深链冷启动会先按默认版式铺一遍再跳。分类名是静态文案直接显示,只有计数和三件工具条控件是占位 |
| 骨架里的悬浮框 | 无对应 | 骨架没有分组条可接,工具条自己封口:四角都圆、四边都描,也不吸顶,因为 updateReviewSticky 要等数据到货才有东西可量 |
复核卡片现行组合(2026-10-27)
资料字段使用独立的 BoardUI Select,不要求先按字段分组。来源依据为中性 secondary Button 与 CollapseRegion,不使用带悬停下划线的 LinkButton。文本差异使用 mark,并复用黄色背景及文字语义 token;共同文字保持原样,来源选择与写入值不受高亮影响。
复核候选已改用官方 RadioCard 与 RadioGroup,替代前述基于 CheckboxCard 的早期组合。源码摘要、复用与差异见复核卡片取证。外层使用管理页填充卡,字段徽章保持中性;当前值、来源选择及可展开依据共用一个正文滚动区。底部复用 Fieldset 操作带,忽略为中性文字键,通过保留蓝色主动作。来源依据的展开独立于单选和资料提交。
艺人/厂牌资料页与关注页(2026-09-12)
证据在 <私有验证记录>:tabs.json(SHA-256
feab9789b17008436597b51e52b90de5cff6180924f2a7c8bef14a2136d3a240,13612 B)、avatar.json
(614f2a38…b28aec)、chip.json(d2b0dd38…e282de)、badge.json(264755bb…9aec6)。
card、page-header、profile-card 三个注册表条目 404,未取得:资料卡的形沿用 2026-09-08
取得的关注管理页那只 .fsec,不另补猜测。
| 位置 | 上游 | Peach |
|---|---|---|
| 资料卡 | 未取得(card/profile-card 404);卡形沿用 .fsec:secondary 底、18px 圆角、不描边、卡脚 --board-card-foot |
React 岛 entity-hero(frontend/src/react/entity-hero/):头像按身份列的行数定尺寸(外链与看片那一行都在是 160px,其余 120px),旁边身份三行:名字 Title 3(24/32、500)、别名·视频数·事务所、外链排成 36px/10px 圆角的 secondary Button;同台艺人收进卡脚 [data-entity-foot] 那条带,它是这个人的附注,不是正文;事务所的名册是正文,走 Tabs 里那一档。窄屏卡不变,只有卡里正文那一格改成单列居中、头像 96px,外链那一排横滑不换行 |
| 视频/照片/艺人切换 | tabs.tsx 是页面级导航的形;这一组留在筛选浮层上,不取 Tabs |
浮层最左端的一组媒体圆键(mediaViewButtonsHtml,aria-pressed),选中那枚由圆玻璃 viewglide-round 滑过去标出,跟四枚观看状态各一块玻璃;隔一道竖杠再是观看状态、再一道才是标签。boardTabsHtml() 的下划线 Tabs 只给索引页切地址用 |
| 资料页筛选条 | 无对应 | React 岛 entity-filter:媒体圆键、四枚观看状态、标签三段由粗到细,aria-label「媒体与标签」;照片、名册视图下观看状态、标签与交集条收起、竖杠隐去,圆键留着 |
| 资料页照片档 | 无对应;按作品分段是用户对照预览选定的(ADR-0068 修订) | 有本地图片或有番号样张就出照片键,键上数的是两者之和。墙在 React 岛 entity-body 里。样张按发行日从新到旧一部一段:段头 [data-photo-group] 一行写番号(--fs-md、主文字色、等宽)、标题(过长省略)、右端「来源 样张 · 发行日 · 张数」,下面是这部自己的 [data-photo-wall];各段之后是本地图片墙,有样张时带「本地图片 · N 张」段头;读数「照片 · N 张 · 样张 M 张 · K 部作品」,只有样张时省掉第一段,也不出换一批。翻页只数本地图片。样张格取不到时只摘 <img>,格子留 --sunk 空底,瀑布流里按 3:2 撑住;灯箱详情写「来源 · 第 n / N 张 · 尺寸」(ADR-0068) |
| 资料页在线档 | 无对应;用户要求沿用关注页 | 创作者绑定关注作者时提供「在线」视图,本地没有作品时默认打开在线内容。视频、图片切换与关注状态、来源、标签、排序复用关注页;正文复用 FollowCard 与照片墙。地址记录 media=online,页内筛选、分页和滚动在关闭详情后保留(ADR-0096) |
| 关注页 | 无对应(上游没有更新流页) | 对齐首页,不另起一套;头像排、题材圆标取景、筛选浮层与排序见下方「关注页」小节 |
| 两页骨架 | Skeleton 只是占位形状 | 都把 .board-filter-frame 外框和上下两排的 data-filter-row 写全,否则等的那几秒钟是两块各带圆角的浮层;资料页骨架用 .entityprofile/.ui-entityidentity 的真实类名,筛选条那排用 data-skeleton-tier="pill" 铺药丸 |
| 外链图标 | avatar.tsx 只有圆形;站标那一档无对应 |
资料卡外链按钮里的站点圆标与社媒标记 [data-link-icon] 不垫底色,收成 --badge-radius 的圆角方框,跟 20px 的图标位同形;外链一律 target="_blank" rel="noreferrer" |
艺人/厂牌/事务所索引(/performers、/studios、/agencies、/creators) |
索引网格无对应;卡形取 stat-card(secondary 底、16px 圆角、p16 收成 p12)、名字 Body Medium 14/20 500、计数 Caption |
.icell 是一张卡,悬停抬 6% 主文字色;大图版式头像 10px 圆角、文字左对齐;「载入更多」是 36px/10px 圆角的 secondary Button。厂牌与事务所是两条地址,页头下那排 boardTabsHtml() 的下划线 Tabs(data-index-kind,带对象图标)切页,不是筛选。/performers 另有本地/在线一档(data-performer-scope,跟标签页共用 INDEX_SCOPES 与 scopeTabsHtml()):在线那档读 /api/follow/authors,一个人的几个来源按别名归成一行、计数与关注页的读数同一个口径(按条目数,不是发布组)。建过档的点开去创作者资料页,还没建档的去 /follow?author=,和本地创作者同名、等用户确认的读数带「待确认」,点开去那位的资料页(ADR-0096);地址带 ?scope=online,深链进来直接落在那一档 |
标签页(/tags) |
字母表无对应;分组卡取 stat-card 形,行取 bar-list 的 36px/8px |
本地/在线是页面级的 Tabs(data-tag-scope);换档只重画 #indexBody,页头、搜索框和那块浮层是同步就有的东西,跟着一起铺骨架等于把已经在屏幕上的控件抹掉再画一遍。类型药丸、读数、按首字跳转、标签云/字母表切换收进首页那块玻璃浮层 tagFilterFrameHtml():上排 .tagcategories 药丸带类型色点,下排读数+.alphajump+iconSwitchHtml;浮层住在 #indexFilters 里,那个父级只有浮层那么高,sticky 会被卡死,display:contents 让它退出盒树。字母表 .ui-alphagroup 每个首字一张卡,字头旁挂 .ui-board-tab-count 徽标,scroll-margin-top 给吸顶浮层让位 |
关注页
关注页在上游没有对应的更新流页,整体对齐首页,不另起一套。
头像两排:
- 顶上两排对着首页那两排:作者行
.followauthors对女优,是 48px 头像加名字的.av;题材行.followworks对厂牌,是 28px 圆标加名字的.brandpill。两排跟首页共用 board.css 里同一份规则,骨架也各铺各的档(data-skeleton-tier取av与brandpill)。 - 题材收来源记成 copyright 的作品和记成 character 的人物。同一系列的各代归成一枚(
_WORK_SERIES前缀加_WORK_ALIASES别名),人物末尾的消歧括号只影响显示。 - 发行商、平台、节庆和占位词按
_NON_WORK_TAGS加公司后缀形态_COMPANY_TAG_RE剔掉;被记成 character 的种族与占位词按_NON_CHARACTER_TAGS剔掉。显示名按词提首字母(_work_label),来源自己写了大小写的词原样留。 - 作者、题材、标签三排的取样一律走
followRandomOrder,按本次访问的种子随机取,进一次换一批,与首页那两排同理:按条数取前 24 的话,八十来个题材里永远只露出同样那二十几个。
题材圆标选图(/work-icon?work=):
- 服务端拿题材身份在账本里按「带
3d、评分高」排出五个候选,顺着取第一张脸够大的封面。取的是站点高清那层:250px 缩略图里一张脸只剩十几像素,检不出来。 - 「脸够大」是
_usable_face的两条线,两条都过才停,否则看下一张:- 占比
_WORK_ICON_FACE_SHARE(FACE_PX_IN_STORE ÷ ICON_SIDE,脸框宽占画面长边 6.6%)要求圆标中有足够大的人脸。仅有 YuNet 检测结果不能排除远景误检,低占比候选继续尝试下一张。 - 像素
FACE_PX_IN_STORE(34px)限制放大能力:页面按脸放大时不许上采样,源图里的人脸像素数决定可用尺寸。低分辨率缩略图即使占比合格,也可能不满足这条要求。
- 占比
- 本库几张都不够时,接着去站点问一趟(
work_icon_search_urls):用sort:score要最热的 8 张接在本库那几张后面继续找,先只要带3d的,那个标签下一张都没有再问一次不限形式的。库里一个题材常常只有一两条、未必有正脸,站上同一标签下有成千上万帖。 - 标签写法取已有 rule34xxx 来源条目中最常用的原词。规范化后的题材名称不一定能用于站点检索。
- 出网是惰性的:本库挑得出脸就一个字节都不出网。取不到凭据、站点报错或网络不通,一律当作没有候选,圆标退回首字母,不返回 500。
- 都走完还没有够格的,按「没有头」处理:退回第一张取得到的图,不写人脸记录,页面按样式表的默认取景摆整张封面。这类题材多半真的给不出正脸(顶着头发的背影、非人形的主角、站上只有远景);与其把最大的一块皮肤放大成认不出的圆,不如摆一张全身,至少认得出是哪部作品。
存盘与取景:
- 核对图床主机后,按
trim_letterbox裁掉源图自己留的黑边。判据是这一行的平均亮度和最亮像素都低:只看平均会把夜景的整片暗部当黑边,只看最大值又会被一颗噪点挡住。裁完剩不到四成,就当判据认错了东西,不裁。 - 图按
icon_side算出的边长存在本机,页面递不进地址;挑不出时退回首字母。 - 存盘边长按「页面放大到头要多少像素」定,不按圆标那 28px 定,因为缩到 256px 时脸框只剩 19~30px,正好卡住。每一枚各算各的:脸在画面里占得越小,存盘边长越大(
FACE_PX_IN_STORE=28px 的圆 × 双倍屏 × 脸最多占六成)。下限是ICON_SIDE(512px);远景全身图按这条要两千像素,MAX_ICON_SIDE(1024px)在那里刹住:再小的脸就认了放不大,一枚圆标不值两百 KB。 - 取景由服务端写在图旁的
.face.json,facet 行第五位带回页面,走头像那套facePos落成object-position,再由frontend/src/card-art/face-frame.ts按脸框放大。 - 28px 的圆上,比例那一档(32%)只给得出 9px 的脸,改由
MIN_FACE_PX这条像素下限接管;48px 的作者头像上它算出来低于 32%,仍走比例。 - 脸心离画面边缘近时,把它拉到框心的位移会让图露白,于是被夹回边上,所以「摆正」本身也算放大的理由(
centred),再由FACE_CEILING(脸框占框 60%,整颗头刚好填满)刹住。检不出脸的退到样式表里的50% 25%。
筛选浮层、排序与图片墙:
- 筛选条与读数收进同一块
FilterGlassRows浮层。 - 上排最左是视频/图片两枚媒体圆键,跟资料页那一组同形,圆玻璃是
GLIDE_ROWS.media(资料页那一组在entity-filter岛里,同一条[data-view-glide="round"]材质)。隔一道竖杠是四枚状态(全部、未看、已保存、已忽略,不挂计数),与首页四枚视图同一个控件,共用那块滑动玻璃(GLIDE_ROWS.views多认.followviews)。来源图标与标签在右半截横滚,来源类型只在选中时上色。 - 下排读数照首页写「N 项更新 · 显示 M」,右端是换一批与排序键那一组:换一批(切到
sort=rand&seed=,整批按种子打散,种子写进地址),然后是更新时间/热度/时长三档排序。换一批等数据时也画首页那段描边忙态(读数行挂aria-busy)。 - 图片墙上多一枚 30px 见方的「仅显示图片」图标开关,字形是 Lucide
captions-off,不跟媒体那一档的图片字形撞。开着时垫筛选条那块滑动玻璃(GLIDE_ROWS.imagesonly),跟旁边的版式分段器同一块料、同一副尺寸:浮层上的分段器轨道不留内边距,选项 30px 见方、8px 圆角。 - 排序归服务端(
/api/follow?sort=&dir=&seed=):分页在服务端,浏览器只拿到当前这几页。FollowStore.group()结尾无条件按newest_at倒序,所以条目层和发布组层都要按同一把尺再排一次(_sorted_items与_sorted_groups)。 - 生效的筛选摊在浮层正下方,用首页那条交集筛选条(
Combo组件:[data-entity-combo]容器加[data-combo-chip]芯片加「全部清除」)。放上方会把吸顶玻璃和两排头像一起推下去;放下方只推列表,而列表本来就要重画。 - 换排序、点作者头像这类只换内容的操作只重画列表:
.followlist换成pageSkeletonHtml的卡片骨架,浮层、两排头像和交集条留在原地。 - 页头右端「管理关注」是次级按钮;「检查更新」在它右边,是这一屏唯一的主按钮(没有来源时不出,蓝色归空态里的「添加关注」)。底部「加载更多」旁不重复读数。
- 图片墙每张
<img>带width/height,图落地前就按固有比例占位,列不随加载重排。尺寸是条目上的字段(清单内的图各带一对),三条来路同权、只补空缺:来源接口给的(fanbox imageMap、rule34.xxx dapi)、回填脚本问文件头得到的、界面加载完回写的(data-learn-dims→POST /api/follow/image-dims)。两层都没有的卡片按 1:1 占位,不硬猜。
首次设置 Auth Card
首启、登录与错误三页(frontend/src/react/pages/)的控件全部是 BoardUI 组件,外框是
pages/auth-card.tsx;登录页与错误页不带引言。
Auth Card 是注册表里没有的组合:页面底色 background-full 上居中一张
background-secondary-default 卡,一条 separator-border,24px 圆角,最宽 560px,内边距 32px,
窄屏收到 20px。卡头是 40px 站标、title-2 标题和一句次级文字的引言。分层同配置页的设置区:
卡里的输入框与分段轨道是 tertiary,文件夹行与次级按钮是 primary,深浅两色下都比卡面亮一档;
暗色 primary 与 tertiary 同为 neutral-800,文件夹行里的输入框靠 base.css 那条静止态边线立住。
按钮全用 BoardUI Button/IconButton 的 medium:选择文件夹与移除为纯图标 secondary(36×36、
图标 20px),添加媒体库为带前置图标的 secondary,完成设置为 primary(高 36px、圆角 10px)。
路径行的输入框与图标按钮同为 36px 高,不再单独放大。忙态与防重复走 busyProps,与配置页同一套。
访问密码是 BoardUI Switch medium(42×24px 轨道、18px 滑块),关闭时两格密码不渲染。
「监听地址」是两段式单选(SegmentedRadioGroup,保留 role="radiogroup"),局域网在左。
媒体库、访问密码、高级设置、完成设置后四组之间是 24px 留白加一条 separator-border 横线,
第一组紧跟卡头不画线;浏览器历史记录是「完成设置后」里的子组,同样以横线分隔。一级分组标题
用 body-semibold、主文字色;字段标签用 BoardUI Label;说明用 body-2-regular、次级文字色,
整表一句与提交失败用 ErrorText(同一字号的 text-error-primary、role="alert");字段错误
替换框下的提示,包在 role="alert" 里由 aria-describedby 挂在框上,页面上只有一份,框体随
aria-invalid 转 danger 色。
安装后教程
首次设置表单只负责收集配置。提交成功后,普通入口带 ?onboarding=1 进入首页;选择历史
导入时先去口味页,但同一浏览器会保留待办标记。教程采用 BoardUI
NotificationViewport 的右下角固定位置、400px 宽度、16px 卡片圆角、边框与下拉阴影;内部采用
Announcement 的图标标题动作结构和 RareUI Task List 的 24px 圆形状态位、完成划线淡出与完成项
后移。专用状态接口汇总馆藏、采集来源凭证、浏览器历史、关注来源、对应关注凭证和复核队列,
不允许手动勾选;每项可单独跳过,并提供短时撤销。浮窗可折叠为只保留标题、完成进度和展开键;
在 Peach 的每个页面持续显示,全部任务完成或跳过后自动消失,不要求额外确认;
切换页面时保留现有浮窗并静默刷新任务状态,状态未变化时不重建卡片;
任务链接与「跳过」各自拥有独立悬停区;链接悬停时即时切换背景并隐藏上下两条内收直线分隔,
不做跨行淡变,分隔线使用暗色主题下仍可辨识的按钮边框色,右侧箭头使用次级文字色。固定 revision、SHA 与差异见
安装后教程取证。
取证方法:上游 primary 有悬停态,只是挂在伪元素上(2026-09-12 取到规则原文)。下面三种读法都读不到它,盲点是同一个:
- 读
className看不到:悬停不是 Tailwind 的hover:类,写在样式表里。 - 真鼠标悬停读 computed 也看不到:读的是元素自己的
background-image,变的是::before的opacity,getComputedStyle(el)不传第二个参数就取不到那一层。 - 注册表
/r/button.json的 primary 那一行确实只有bg-button-primary text-text-white shadow-xs,因为三档全长在.bg-button-primary这个类里。
所以取证结论涉及「某个状态没有样式」时,两个伪元素都要显式读一遍再下判断。
.bg-button-primary 的规则原文(2026-09-12 实测):类自身 isolation:isolate 加
background-image:var(--gradient-button-primary-default);::before 是 inset:0、
z-index:-1、pointer-events:none、border-radius:inherit,铺
var(--gradient-button-primary-hover)、opacity:0、transition:opacity var(--button-transition-ms) ease
(该 token 为 .15s),:hover:not(:disabled):not([aria-disabled=true])::before 把它抬到 1;
:active 换成 var(--gradient-button-primary-active) 并把那层压回 0;:disabled 换
--gradient-button-primary-disabled 且 ::before{display:none}。三档渐变都是 180deg 两停点,
按色阶排 default accent-500→600、hover 400→500、active 600→700,实测像素
400=#3392ff、500=#2b7fff、600=#155dfc、700=#1447e6。其余 computed:height:36px、
padding:8px、border:0px、border-radius:10px、box-shadow:rgba(0,0,0,.05) 0 1px 2px、
color:#fff、font:500 14px/20px Inter。
Peach 照抄这一副面,包括 ::before 的交叉淡入和 border:0。补一圈透明边会在
box-sizing:border-box 下把内容盒压掉 2px,而 background-origin 是 padding-box,渐变被压到
34px 再延展回 36px,色标就跟上游错开一像素。三档 token 是 --board-blue、--board-blue-hover、
--board-blue-active,连同规则只在 web/board.css 一处;入口三页的主按钮是页面包里的
BoardUI Button,读 BoardUI 自己的渐变 token。
Peach 在这一档上的主动差异有两项:padding 取 8px 12px 而不是上游的四边 8px,中文字比
拉丁字宽,四边等距时两侧字贴着边;上游 active 那一下的 0.98 缩放(transform .42s)没有跟,
按下换渐变已经读得出来。
Checkbox 动效取证(2026-09-10):项目保存的 board-reference/checkbox.json 中
checkbox-glyph.tsx 使用 16px SVG、pathLength=1 与 animate-check-draw。
实时 /components/checkbox CSS 确认为 200ms cubic-bezier(.65,0,.35,1),
stroke-dashoffset 从 1px 到 0;减少动态效果时立即显示完整勾线。
150ms 只负责背景、边框和阴影过渡,不能用它代替描线动画。
setup 使用同一勾线形状、蓝色渐变及这两组状态规则。
2026-09-10 使用内置浏览器核对 /components/auth-card,复用已登记的
boardui-auth-card.json:集中式标题、Logo、表单与底部主按钮,24px 圆角、
24/32px 内边距和轻阴影。Peach 的媒体来源表单采用 560px 上限;保留目录增删、
来源选择、可选密码、高级设置、扫描及历史导入。390px 下单列,无横向溢出。
核对用的是独立只读预览:不提交真实配置、不启动扫描。
验证记录
侧栏、媒体库、配色字阶与窄屏布局已核对的结果,以及对应的测试覆盖。
侧栏采用 AI chat 公开变体的分组标题、展开叶项与尾部计数;分组箭头位于右侧,标题高 36px,展开复用共享 Collapse。媒体库入口适配公开 DashboardUserMenu:265px 面板、16px 圆角、10px 内边距,桌面右侧 8px、手机下方展开,150ms ease-out 淡入、缩放 .95 与 2px 模糊。独立按钮控制侧栏展开;媒体库图标打开选择面板,展开面板时入口显示轮廓。首页使用 20px 槽位的 Peach logo,按透明边距校准可见轮廓及文字起点,收起态按钮为 36px 正方形。媒体库与导航图标统一 20px、1.7px 线宽,无图标底色。设置固定在底部,与明暗开关并排;收起时明暗开关只显示目标主题图标。主题动画参考公开 https://www.boardui.com/r/theme-toggle.json:200ms 滑块与 820ms 柔边扩散,缓动 cubic-bezier(.16,1,.3,1),减少动态效果时直接切换。
媒体库使用 [media.libraries] 为声明路径命名,同名路径归为一库;[media.library_icons] 保存可选图标,自动模式按来源显示本地磁盘或本机提供的网盘图标。库选择限定作品列表与筛选项;来源 ID、挂载映射和 ledger 路径保留其业务含义。统计、口味和维护任务按整个部署汇总。预览只读,不保存真实配置。
颜色按 Board Color 的文字、背景、边框和交互角色映射;字阶按 Typography 使用正文 14/20、紧凑 13/18、说明 12/16、标题 20/26 与页面标题 32/44。本机打包 Inter Variable。统计、口味、关注管理和配置使用对应结构的骨架;其它页面复用实体、海报与网格骨架的 Board 样式。关注的默认视图与表格视图共享作者分组、排序和多选;默认视图作者卡内行高 64px 并支持作者收起,表格视图一行一条来源、表头可排序;批量删除使用数量明确的确认框,选择与启用状态独立;最近观看标题单行中间省略并链接视频详情。
详情使用并列观看进度卡与独立动作按钮;Esc 先退出详情、再收起侧栏。首页与实体页排序保持横向滚动,换批按钮沿用动画 SVG,采用中性 Board 按钮。
桌面与 390×844 两档都不允许页面横向溢出,覆盖设置、首页、详情、统计、口味、数据管理、
关注管理、配置、复核、标签与事务所索引。390×844 下输入 16px,设置数值控件 40px 高;
侧栏收起后容器与内容均为 60px,横向滚动轨道隐藏;手机展开按钮在抽屉内部,抽屉距顶部 12px。
设置关闭图标中心偏差为 0;纯图标控件不覆盖工具栏的业务显隐。
增加对比度时导航 backdrop-filter 为 none,这个状态要能退出。
tests/ 与 frontend/test/ 覆盖非法值不保存、关闭恢复、异步读取值恢复、图表数值、
库名与图标提交、分组展开记忆、页面骨架、排名展开与流向聚焦、图标草稿取消、分段切换,
以及演示状态不请求任务接口。
控件与状态预览
分段切换、勾选卡、图标弹层、玻璃与进度反馈这些共用控件的证据与状态规则。
2026-09-08 通过严格证书校验取得公开 checkbox-card.json、date-picker.json 与
segmented-control.json,保存于本机 <私有验证记录>。
分段切换复用原生 radio,选中底板按实际位置与尺寸作 200ms 位移,设置主题保留系统选项。
Checkbox Card 的整卡选择与独立操作按钮分离;暂停使用黄色 Chip。媒体库图标弹层采用
DatePicker 的内面板、候选草稿及取消/应用结构,候选不包含网盘品牌图标。
统计圆环直接显示终值,只有高亮那一段的浓淡走过渡;没有入场动画,
理由同排名条与雷达图那一行。
资源同步先只读检查失效记录、空文件夹与缓存,有候选才显示实底红的「清理失效条目」;永久删除走共享确认框的危险档,部分没处理时报警告档 Toast。
筛选栏通过「换一批」切到随机并更新种子;默认随机仍在浏览设置中选择。亮色玻璃用淡蓝灰与暖色光斑形成色差,光斑半径为画布的 32%/38%。媒体库选择弹层复用玻璃材质与现有菜单开合。窄屏设置导航与正文之间保留 16px 间距;这些样式的浏览器视觉验收未取得。
内部正文导航复用 LinkButton,右箭头沿用本地共享图标;无底色、无描边、4px 图文间距、20px 图标、hover 下划线。来源为 https://www.boardui.com/components/link-button 的公开注册表 https://www.boardui.com/r/link-button.json ,2026-09-11 取得,SHA-256 05eb37b3cf1334c153e0702de05fe4989e4359c9c74d5ba55cc552a58e4629bd。保留 Peach 的蓝色令牌,不新增依赖。外链保持外链图标和蓝色文字;Note 统一带淡背景、图文垂直居中。封面采集反馈列出本机与候选尺寸或实际失败原因,不以网络推测代替来源结果。
搜索玻璃使用原生 blur(22px),保留底色、光晕与描边。主题扩散快照期间,各玻璃表面以当前主题实底承接光晕,结束或跳过动画后恢复实时背景采样;媒体库顶层弹窗使用同一规则。离开页面后清理已移除面板的 SVG 滤镜和尺寸监听。浏览器视觉验收未取得。
已知总量的任务只显示一套进度与处理数量,未知总量才显示加载圆点。扫描、关注检查、链接检查和资源扫描共用这一规则。
骨架的显示门槛同时约束容器、后代与伪元素;隐藏阶段不单独绘制微光。筛选骨架复用就绪控件的尺寸、间距、图标与当前选项,等待接管时使用 inert,数据操作按钮保留原生禁用状态。
媒体库入口与侧栏按钮在主包加载前按保存的状态就位;组件接管时复用这些原生节点。
复核卡片在接近视口时初始化滚动条,屏幕外卡片暂缓布局;819 条记录的页面滚动至 2400px 时只初始化 6 张卡片。
关注列表右侧工具栏按检查全部、视图、排序、展开状态排列,展开状态仅在默认视图显示。表格视图每行行首一枚勾选框,默认视图的「全选本页」位于列表上方,跨页选择保留。全选使用叠勾,取消使用空心叠勾;复核分组与本页选择沿用这套状态图标。复核分组按钮在吸顶时靠右,类型与标题保留间距。 采集来源明确未收录资料或封面时保留中性记录,不计失败或自动重试集合;超时、网络和读取错误保留错误反馈。采集明细使用共享 Collapse,资源链接使用正常文字色。