08_归档04_VOZEB任务卡
VOZEB UI Migration 02 · M40 Admin help center
状态:LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST
任务边界
Task ID:M40-ADMIN-HELPBase SHA:af90409e5273499eb9d0326c1aac80c1236579a8(codex/vozeb-retail-next-migration)- 目标用户结果:管理员帮助中心在桌面与 390px 窄屏下使用统一 Ocean Air / Liquid Glass 内层材质,阅读、搜索和跳转保持清晰。
- 允许修改:
web/src/components/admin/admin-help-section.tsx、web/src/components/admin/admin-help-section.module.css、本文档及帮助中心定向测试。 - 非目标:API、管理员权限、路由、文章内容、搜索/选择回调、后台导航、生成文件、账务和其它页面。
实现说明
- 旧 cyan/zinc/white utility palette 替换为 Ocean Air 与 Liquid Glass token;正文、标题和说明使用中性 text / muted / quiet token,主题色仅保留给语义图标、焦点环和状态提示。
- 帮助中心根节点登记
data-ocean-component="admin-help-section";搜索结果、目录项、文章头部和相关页面目标使用单层低对比边框、连续圆角、轻量 blur 与克制阴影,不叠加左上角假高光或多重外框。 - 保留文章搜索、延迟查询、目录/移动端选择、
scrollIntoView、内部 section 回调、Next Link 跳转、空态和全部文章语义。 - 提供
prefers-reduced-motion、prefers-reduced-transparency、forced-colors与不支持backdrop-filter时的可读不透明回退;窄屏下目录改为既有移动选择器,不引入额外滚动容器。
验收证据
- 定向静态契约测试:
admin-help-section.test.ts与既有admin-help-content.test.ts。 - TypeScript、ESLint、Prettier、生产构建与
git diff --check:以本候选提交交接结果为准。
本切片未执行真实管理员写入、权限变更或正式 Testing/Operations 验收;候选状态不提升为 Gate 通过。