08_归档04_VOZEB任务卡
VOZEB-UI-MIGRATION-02-M14-HELP — 用户帮助中心页面
Task ID: VOZEB-UI-MIGRATION-02-M14-HELP
目标用户结果: 用户能在统一的 Ocean Air 视觉中搜索、选择并阅读完整的帮助流程
Feature ID / Atomic Requirement IDs: HOME-P0-001;EXEC-P0-001..003(仅承载帮助内容视觉)
Base SHA: 0701905d640dc1bd551ae1afe8ff1d38c122a393
必须阅读: VOZEB-UI-FOUNDATION-01.md;VOZEB-UI-MIGRATION-02.md;help-content.ts;现有 help/page.tsx 与 help-elements.tsx
允许修改: 本任务包;web/src/app/(user)/help/page.tsx;web/src/app/(user)/help/help-elements.tsx;web/src/app/(user)/help/help-page.module.css;web/src/app/(user)/help/help-page-layout.test.ts
禁止修改: web/src/app/(user)/help/help-content.ts;help-content.test.ts;API/store;共享 Ocean 组件;其它页面和公共路由
范围: 在既有帮助内容与 URL/search/scroll 行为适配器外,接入 Ocean Foundation glass surface、content card、reveal、status 与 utility control 视觉层
非目标: 不改变文章 ID/文案、搜索匹配、section query、滚动定位、FAQ/流程/步骤语义、路由链接、权限或数据语义;没有既有异步 loading/dialog 状态时不人为增加业务状态
已冻结契约与数据模型: HelpArticle、findHelpArticle、searchHelpArticles、HelpFlow、HelpGuideSteps、HelpFaqList 的输入与 DOM 可访问语义保持不变
安全与数据限制: 仅本地静态帮助内容;不读取或输出 Secret,不触发真实上游、账务或生产写入
验收命令: pnpm exec vitest run src/app/(user)/help/help-content.test.ts src/app/(user)/help/help-page-layout.test.ts;pnpm exec tsc --noEmit --pretty false;pnpm exec eslint src/app/(user)/help/page.tsx src/app/(user)/help/help-elements.tsx src/app/(user)/help/help-page-layout.test.ts --quiet;pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-M14-HELP.md src/app/(user)/help/page.tsx src/app/(user)/help/help-elements.tsx src/app/(user)/help/help-page.module.css src/app/(user)/help/help-page-layout.test.ts;pnpm run build;git diff --check
人工决策点: LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST;等待独立 Testing/Operations 验收
交付物: 帮助中心 Ocean Glass 页面壳、搜索结果卡片、流程/教程/FAQ 内容层、状态与响应式契约测试验收边界
help-content.ts继续是帮助文章的唯一内容事实源;本切片只改变页面与直属展示组件的 DOM 包装、样式和焦点表现。- 页面继续由
AppWorkspaceShell提供站点背景与左侧导航,不新增OceanAmbientBackground、WebGL renderer 或第二个页面级背景。 - 搜索结果、文章分类、流程步骤、详细清单和 FAQ 继续使用真实现有内容;空搜索结果仍 保持明确文案。
- 文章选择继续更新
sectionquery 并把#help-article滚动到视口;FAQ 使用原生details/summary,键盘与无障碍名称不回退为仅颜色或图形提示。 - Ocean Foundation 的 loading/dialog 组件在当前页面没有对应异步/模态状态,因此不人为 添加伪加载或伪对话框;该不适用项记录在交接说明中。
prefers-reduced-motion、prefers-reduced-transparency和forced-colors下保持 内容可读、可操作且无水平溢出。
状态:LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST