[P1][前端整改] 修复研选按钮与选校流程断点,完善移动端、状态恢复及UI信息层级 #1

Open
opened 2026-11-14 22:38:20 +08:00 by abaishu0730 · 0 comments
Owner

问题与目标

现行离线 UI 已具备选专业、院校筛选、方向查询、详情、收藏和对比,但存在“按钮已显示、操作链路未连接”的情况。典型例子是首页点击“查看详情”仍留在首页;桌面左侧七个页面按钮没有绑定切换事件;手机列表提示继续下滑,却无法追加第81所及后续院校。状态恢复和数据加载失败处理也有断点。

本工单作为一次完整整改的跟踪入口:先修复可复现的功能问题,再优化信息层级和视觉;已验证问题与待评审设计建议分别管理。 不将既有静态概念图视为已实现产品,也不预设新增AI、登录、后端或完整志愿表。

版本、环境与证据范围

  • 核查日期:2026-11-14。
  • 现行入口:docs/择校UI/index.html;website/ 是另一条早期原型,不属于本工单实测实现。
  • 核查时入口文件 Git blob:98957612e08ff7655e62e93f68a1af6af1f73d32,已与远端main核对一致。源码行号均以此文件版本为准,后续重构时按函数/选择器定位。
  • 运行材料:main HTML及两个主数据文件,图片/细分片来自仓库轻量交付包。轻量包中的HTML较旧,已使用main文件替换审查副本;截图不用于评价原始大图清晰度。
  • 浏览器:本机Chrome无头模式;桌面1440×1000,手机主视口390×844,四校对比补查320/375宽度。真实手机、全部244个专业与数据库全量准确性未在本轮验证。
  • 专业样本:0856材料与化工、0854电子信息、1051临床医学。
  • 39项流程检查:17项符合预期、17项发现断点、4项部分实现/语义不完整、1项手机访问受阻。检查项并非按钮数,不能据此计算项目完成率。 未观察到页面JavaScript异常,但无异常不等于功能已经打通。
  • 用例与原始结果:证据包内audit-flow.cjs、按钮与流程实测.json;三个流程图均提供PNG、SVG、可编辑Mermaid源,另附无需联网的HTML总览。

源码基线:main提交 6553ca256de9 中的现行入口。

优先级与范围

  • P1:主要操作被阻断、筛选/导航状态错误,或加载故障被表达为招生事实。
  • P2:局部入口、文案、布局或阅读体验问题。
  • 下文F01–F15为已观察问题/现状;U01–U08为优化提案,不代表视觉稿已获批准。F14尤其需要统一交互约定,不宜直接理解为缺失功能。

一、已验证问题:复现、原因与验收

F01 · P1 · 桌面左侧七个页面按钮未绑定切页事件

复现:桌面进入#view=home&major=0856,依次点击左侧“院校库、对比、院校详情、搜索、按方向看、我的”;在院校库点击“每日一校”。

实际:页面不切换。七个按钮只有data-v和首次选中样式设置,没有切换回调。

定位:index.html第257–263、1047行;对照正常工作的.tabbar [data-t]事件。证据SIDE-*。

建议:统一页面切换入口,使侧栏与底部导航共享路由行为、选中状态和历史处理;不要仅补按钮颜色。

  • 七个按钮分别切到正确页面;重复点击当前页不破坏状态。
  • 页面切换后侧栏和底部导航选中状态一致;未选专业时保留明确的专业选择流程。

F02 · P1 · 首页“查看详情”未进入详情

复现:打开#view=home&major=0856&no=176,点击底部“查看详情”。

实际:仍为每日一校。[data-go]回调只有在list/search/cmp/dir/mine时才设置view='detail',遗漏home。详情本身存在,列表等页面能够进入。

定位:第563、899–903行;用例C02。

建议:将“进入详情”和“更换首页学校”作为不同动作处理;修详情不能连带把“换一所”改成跳转。

  • 首页按钮进入当前学校详情,校名、专业、数据口径保持一致。
  • “换一所”仍留在首页;从首页进详情后有可靠的返回路径。

F03 · P2 · “同城相似院校 → 查看更多”没有动作

复现:首页选择华东理工大学,点击“同城相似院校”右侧“查看更多”。

实际:无href、点击回调或动作属性,状态和页面不变。

定位:第499、561行;用例C03。另注意当前sim()同时接受同城市或同省份,标题与结果范围未必一致。

  • “查看更多”进入有对应地区条件的院校集合,并可返回。
  • 展示标签与实际范围一致:同城就只含同城,含同省则明确命名。
  • 如果本轮不提供该功能,移除可点击样式和箭头,避免继续呈现无响应入口。

F04 · P2 · “报考要点”右侧箭头未连接动作

复现:首页点击“报考要点”标题右侧箭头。

实际:无回调或链接。这里只确认交互暗示未闭合,不预设必须新增“报考要点详情页”。

定位:第556行;用例C04。

  • 接入有明确内容的展开/详情,或将标题改为纯信息展示并移除箭头。
  • 静态年份、统计数量等元信息不应再使用会误导用户的交互样式。

F05 · P1 · 超出前14个方向码后,没有单独选择入口

复现:选择1051,进入方向页,点击“另有13个方向码”。

实际:只有前14个码生成data-dir按钮;“另有N个方向码”只是普通chip,无展开/选择回调。通过“全部方向码”仍可看到相关数据,因此不是数据完全丢失,而是单独筛选路径缺失。

定位:第711、927行;用例C18。

建议:提供全部方向码选择器、可检索列表或真正的展开入口;数量多时不依靠无提示的横向长条。

  • 当前专业每个实际存在的方向码均可单独选择,包含第15个之后的码。
  • 方向码总数、选中状态、列表结果一致;切专业后不保留不适用的旧方向。

F06 · P1 · 手机院校搜索没有可见入口

复现:390×844打开院校库;寻找输入学校名/城市/院校代码的位置。

实际:#q只在左侧.panel中,≤560px时整个面板隐藏,院校库无可见输入框。搜索视图仍提示到左侧搜索,手机无法完成对应操作。桌面输入搜索功能正常。

定位:第234–239、255、637–649、1049行;用例C13/C19。

  • 手机有可发现、可触达的搜索框或搜索入口;学校名、城市、院校代码均按页面承诺生效。
  • 支持清空关键词、无结果提示和返回结果;手机不出现“到左侧输入”的指引。
  • 手机可查看/修改目标专业,搜索结果明确对应哪个专业。

F07 · P1 · 手机底部导航位于长页面末尾

复现:390×844进入院校库,保持页面顶部。

实际:导航回调正常,但导航顶部位置约y=7144,必须滑完整个首批列表才看到。方向页、首页也受内容高度影响;不是底部导航按钮无事件。

建议:统一应用视口与滚动容器,可用固定/粘性导航或固定壳体;正文必须为导航与设备安全区预留空间。

  • 五个主导航在手机主要页面可持续触达,正文不被遮挡。
  • 320/375/390宽度下无横向溢出;短页/长页、软键盘出现和安全区均检查。

F08 · P1 · 手机列表“继续下滑加载”停在80所

复现:390×844打开#view=list&major=0856,滑到整页最底。

实际:仍为80项,提示“已显示80/907所,继续下滑加载”;手机实际滚动的是window,监听却绑定screen.onscroll。

定位:第239、940–943行;用例C20。方向页共享这一监听结构,本轮手机追加实测样本为院校库。

建议:统一滚动来源,或改为明确的“加载更多”入口;不要只改提示文本。首批80不是产品允许访问的总量上限。

  • 手机可从80继续到160,并一直访问到当前筛选结果末尾;最后一批正确停止。
  • 小于80、恰好80、超过80和空结果均检查,不重复、不漏项。
  • 院校库与方向页分别验证;结果数以当前筛选集合为准。

F09 · P2 · 桌面追加列表后跳回顶部

复现:桌面院校库把screen内部列表滚到接近底部,触发追加。

实际:shown从80增到160,但render()设置el.scrollTop=0,阅读位置丢失。

定位:第895、940–943行;用例C21。

  • 追加数据保留已读位置和当前焦点,新增内容接在后面。
  • 收藏/加入对比等局部动作不无故把长列表送回顶部;真正改变筛选时再按约定重置位置。

F10 · P1 · 状态保存与刷新恢复不一致

复现A:院校库启用“仅开设本专业”,刷新;B:方向页启用“按校合并”,刷新;C:城市选杭州后刷新;D:桌面搜索华东理工后刷新。

实际:A/B虽然写入localStorage,applyHash()在缺少om/merge时仍覆盖为false;city、kw未由syncUrl()写入URL,C/D刷新丢失。手工带覆盖参数的链接与正常操作产生的链接也可能表现不一致。

定位:第930、938、1000–1007、1022–1034行;用例C22–C25。

建议:明确“URL显式参数、持久化偏好、默认值”的恢复优先级;区分缺参和明确关闭,状态序列化/解析成对维护。现有README写merge/city等参数时也应与实现核对。

  • 专业、目标分、关键词、省市、标签、排序、本专业开关、合并开关有明确保存与分享规则。
  • 正常操作产生的URL在刷新和新标签页打开后恢复其承诺的状态;localStorage偏好不被缺参静默覆盖。
  • 清空条件后不被URL中的旧参数恢复;切专业时清理不适用状态。

F11 · P1 · 详情无法按应用访问顺序返回

复现:在院校库筛选、滚动、点击学校详情,再使用浏览器返回。

实际:切页使用history.replaceState(),没有新增列表→详情历史项;返回落到更早页面,而不是刚才列表。详情也没有明确的独立返回列表按钮。

定位:第1007行及详情渲染;用例C26。

建议:页面级跳转合理使用pushState;连续输入或轻量筛选更新可以replaceState,避免每输入一个字都产生历史项。补齐详情返回入口。

  • 列表/搜索/方向/收藏/对比进入详情,返回恢复正确来源及其条件和阅读位置。
  • 浏览器前进、返回与界面返回一致;直接打开详情深链时提供合理退路。

F12 · P1 · 数据分片加载失败被误表述为“没有招生专业”

复现:打开0856华东理工详情时,在浏览器中阻断方向/0856.js请求。该测试是故障注入,不代表院校实际缺少专业。

实际:onerror将结果写成空对象,页面显示“官方2027目录里该校未单列0856专业”;没有错误提示或重试。空结果还被缓存,本次会话后续不会自动重新请求。

定位:第314–328、446–450行;用例C27。

建议:明确idle/loading/success/empty/error状态;真正无源数据与请求失败区分。分数分布等允许缺文件的资源应有清单或明确的预期缺失约定,不能把所有404都当网络故障或招生事实。

  • 断网/文件读取失败时显示加载失败与重试,不输出“官方目录没有”结论。
  • 重试会发起实际请求并在恢复后更新内容,不能因缓存{}永久跳过。
  • 真正未覆盖、源侧缺失、加载中、加载失败四种状态分别验证;适用于方向、专业明细、分数分布。

F13 · P2 · “加入志愿”实际仅为收藏

复现:首页/详情点“加入志愿”,进入我的。

实际:只切换fav并保存到localStorage;可在我的看到收藏,未生成志愿表或报考方案。

定位:第563、815、949–951行;用例C07/C08。

  • 当前范围内统一改为“收藏/已收藏/取消收藏”等准确动作名,心形与文字入口行为一致。
  • “加入对比”有独立清晰文案及反馈;收藏和对比不会互相混淆。
  • 若未来建设志愿表,另行定义数据、方向粒度及流程,不以现有收藏冒充。

F14 · P2 · 相似院校点击与详情入口约定不统一

复现:首页点击“同城相似院校”中的一张卡片。

实际:替换首页当前学校,仍留在每日一校。该动作确实已实现,不按完全无响应统计;是否保留要由产品约定决定。

  • 明确卡片是“进入详情”还是“切换首页预览”;建议点学校进入详情,将“换一所”保留为独立动作。
  • 卡片、列表、搜索、收藏中的同类学校入口遵循一致约定,避免靠页面来源猜测。

F15 · P2 · 手机四校对比列未统一滚动

复现:加入四所学校,在320/375/390宽度打开对比;左右滚动表头。

实际:图片/校名表头单独横滚,数据行各自压缩,列对应不稳。390宽表头可视324、内容348;320宽为254/348。对比加入/移除/清空的业务动作可用。

定位:第159–165、767–774行;上一轮布局实测及本轮C14动作复核。

建议:整张表共用一套列宽与横向滚动,必要时固定指标名列;手机可提供两校优先视图,但不能静默隐藏已选择院校。

  • 同一学校的名称、照片和全部指标始终纵向对齐;四所数据都能访问。
  • 行名、年份、单位、缺值可辨识,不用颜色单独传达比较结果。
  • 对比超过4所、移除、清空、首校详情等现有行为保持可用。

二、产品与视觉优化提案(待评审,不与功能缺陷混算)

参考仓库第四轮A/B/C概念方案,以及Anthropic公开的前端设计指南。参考其信息层级、主题适配和截图自检方法,不把某个模型名称或Claude产品配色当作验收标准;不要求复刻其界面。

U01 · 主入口围绕选校任务,减少首页绕路

建议以A“院校候选与筛选”为主入口:当前专业、目标分、地区等条件可见且可修改,条件变化直接更新结果;“每日一校”作为次要发现内容。C“方向与科目”作为专业探索入口,B“目标分与分档”作为辅助分析。

  • 先用真实样本内容形成低保真布局,评审后再改成品;不默认现有概念图中的功能已具备数据支撑。
  • 首屏能看到目标条件和候选学校,不被大品牌区、口号和重复提交按钮占满。

U02 · 院校卡片突出与当前专业有关的比较依据

建议主信息为校名/城市、当前专业、2026复试线、2027拟招、与目标分的差值;院校代码及审计细节进详情。列表使用小图,发现页再使用大校园图。默认仅显示当前专业开设院校可作为候选方案,但保留主动查看全部单位的入口,并说明覆盖范围。

  • 年份、人数/分数单位和区间含义保留,不能为版式整齐省略。
  • 对每条结论能够定位到当前专业和相应数据;不硬填源侧缺失字段。

U03 · 分数差优先于“冲稳保”,避免把粗略分档画成录取把握

当前目标分高于往年最高方向线2分即可标“稳”,可能被理解为录取概率。建议主表达改为“高于2026复试线区间上限2分”等可核对差值;冲稳保作为辅助且说明规则。300/500分制继续明确分开。

  • 不出现未经验证的录取概率、保录暗示或把达到复试线写成可录取。
  • 不同年份、方向线/专业线、专项计划区间和缺值保持可辨识。
  • 没有可比数据时不强行分档;300分制不套用500分目标分。

U04 · 比较向专业/方向粒度深化,先核实数据再设计

学校级对比之外,建议让用户核对具体方向的考试科目、学制、学费。不同院系、不同卷子不能用一组“代表值”冒充完全一致;精确到该粒度的数据覆盖和结构需后续确认。

  • 若数据不足,明确展示范围/缺失或只保留学校概览,不生成无依据的方向结论。
  • “相对更优”只用于有明确比较规则的字段,城市、层次、低分等不被自动包装为普遍优势。

U05 · 收敛视觉层级,优先保证中文和数据可读

保留当前深绿品牌基础,减少地图线条、分子背景、渐变、大标题、多色标签同时抢注意力。颜色、字号、间距、图标和按钮状态形成一致规则,避免每个模块都套相同卡片。

  • 正文建议以14–16px区间起稿,次要信息避免大量9–11px浅灰文字;关键说明可正常阅读。
  • 数字使用稳定对齐方式;绿色/红色之外有文字或符号解释;键盘焦点、对比度与减少动效偏好纳入检查。
  • 不把预览用固定9:41等模拟系统状态栏带进真实网页。

U06 · 桌面与手机分别利用空间

桌面1440宽仍是390宽手机框加300宽控制面板,右侧大量空白。建议桌面提供筛选区+结果区,详情或对比使用合理宽度;手机保证单列、搜索和常驻导航。

  • 320/375/390及桌面1440宽度分别验收,不用等比例放大手机框替代桌面设计。
  • 手机优先还是桌面为主要选校场景仍待产品确认;不阻断F01–F12的缺陷修复。

U07 · 让持续几天的选校过程可以接着做

先完成F09–F11的恢复能力,再考虑保存筛选方案、收藏方向、备注等新功能。收藏当前是学校粒度,不能未经设计就声称已能管理专业方向意向。

  • 这部分先记录为后续需求,不把新增备注/方案作为本轮基础修复的隐性前置条件。
  • 若开发,明确本地存储、迁移/清除行为与实际保存粒度,并提供相应提示。

U08 · 反馈、空态和错误态形成闭环

收藏/对比/修改条件应有一致反馈;无结果要显示当前条件和调整方向;按钮文案描述实际动作。动效用于解释展开、加入、反馈,不添加大量与任务无关的入场效果。

  • 正常、加载、空结果、失败、上限/不可用状态都有明确表现。
  • “报考要点”箭头、“查看更多”等交互暗示要么有对应操作,要么取消暗示。

三、实施与验收顺序

  1. 批次A:恢复主流程——F01–F05、F13–F14;处理路由、首页详情与更多入口,明确动作语义。
  2. 批次B:手机与列表——F06–F09、F15;统一滚动容器、搜索、常驻导航、追加加载与对比布局。
  3. 批次C:状态和错误恢复——F10–F12;URL/偏好/历史一致,加载失败可重试且不误报招生事实。
  4. 批次D:产品与视觉——先评审U01–U08,确认目标设备和数据支持范围,再实施选定方案。

每批提交可独立审查的改动及对应验证,避免把已验证缺陷与未经确认的新功能混成一次大重写。修复过程中保留现有能用的专业切换、收藏、对比和方向展开。

四、回归检查矩阵

维度 最低检查内容
首次/再次打开 无专业、已保存专业、带专业的链接;专业搜索与选择
专业样本 0856、0854、1051;补一个300分制专业及缺数据场景
路由与入口 侧栏7按钮、底栏5入口、首页详情、相似学校、搜索/收藏/方向/对比到详情与返回
列表 空、少于80、80、超过80、多批次到底;筛选/排序/收藏/对比不破坏阅读位置
状态 专业、目标分、关键词、省市、标签、排序、开关、合并;刷新/新标签/前进后退;清空条件
对比 0/1/2/4所、尝试第5所、移除/清空/详情,320/375/390列对应
数据加载 正常、加载中、预期未覆盖、真实空数据、网络/文件失败、重试成功
外观与可达性 浅色/深色、键盘焦点、触控目标、减少动效、长中文校名、无照片、缺值
设备 320/375/390手机视口、1440桌面;至少补一次真实手机或相应WebView检查
  • 对F01–F15逐项提供修复结果或明确的产品裁决;未做项保留为未完成,不能仅凭页面无JS异常关闭工单。
  • 核查脚本中的已知断点转为预期通过,补充变更后的边界检查;脚本硬编码的本机路径在执行环境中适配。
  • 提供修后主流程、手机列表、四校对比截图;更新流程图颜色,使图和实现一致。
  • 若只改UI,不要求顺带重建事实层;若触及数据、导出口径或表结构,执行仓库AGENTS规定的相应数据审计。
  • 更新现行UI的README、hash参数、交接文档;不得把旧包、旧原型或概念图当成修后交付。

五、附件与现状流程图

附件见下方上传区:三张流程图、现行UI实测拼图,以及完整核查证据ZIP。ZIP内含详细报告、39项结果JSON、复核脚本、三张图的PNG/SVG/Mermaid、离线HTML总览。所有红色节点表示当前未打通,不表示已经修复;黄色表示部分实现或访问受限;绿色表示对应检查路径可用。

用户操作主流程

用户操作主流程

按钮断点与列表加载

按钮断点与列表加载

状态保存与数据加载

状态保存与数据加载

现行UI实测拼图

现行UI实测拼图

## 问题与目标 现行离线 UI 已具备选专业、院校筛选、方向查询、详情、收藏和对比,但存在“按钮已显示、操作链路未连接”的情况。典型例子是首页点击“查看详情”仍留在首页;桌面左侧七个页面按钮没有绑定切换事件;手机列表提示继续下滑,却无法追加第81所及后续院校。状态恢复和数据加载失败处理也有断点。 本工单作为一次完整整改的跟踪入口:**先修复可复现的功能问题,再优化信息层级和视觉;已验证问题与待评审设计建议分别管理。** 不将既有静态概念图视为已实现产品,也不预设新增AI、登录、后端或完整志愿表。 ## 版本、环境与证据范围 - 核查日期:2026-11-14。 - 现行入口:`docs/择校UI/index.html`;`website/` 是另一条早期原型,不属于本工单实测实现。 - 核查时入口文件 Git blob:`98957612e08ff7655e62e93f68a1af6af1f73d32`,已与远端main核对一致。源码行号均以此文件版本为准,后续重构时按函数/选择器定位。 - 运行材料:main HTML及两个主数据文件,图片/细分片来自仓库轻量交付包。轻量包中的HTML较旧,已使用main文件替换审查副本;截图不用于评价原始大图清晰度。 - 浏览器:本机Chrome无头模式;桌面1440×1000,手机主视口390×844,四校对比补查320/375宽度。真实手机、全部244个专业与数据库全量准确性未在本轮验证。 - 专业样本:0856材料与化工、0854电子信息、1051临床医学。 - 39项流程检查:17项符合预期、17项发现断点、4项部分实现/语义不完整、1项手机访问受阻。**检查项并非按钮数,不能据此计算项目完成率。** 未观察到页面JavaScript异常,但无异常不等于功能已经打通。 - 用例与原始结果:证据包内`audit-flow.cjs`、`按钮与流程实测.json`;三个流程图均提供PNG、SVG、可编辑Mermaid源,另附无需联网的HTML总览。 源码基线:[main提交 6553ca256de9 中的现行入口](https://git.simgreek.com/simgreek/yanxuan/src/commit/6553ca256de926f203db3c3af85bdc08e52d0cde/docs/%E6%8B%A9%E6%A0%A1UI/index.html)。 ## 优先级与范围 - **P1**:主要操作被阻断、筛选/导航状态错误,或加载故障被表达为招生事实。 - **P2**:局部入口、文案、布局或阅读体验问题。 - 下文F01–F15为已观察问题/现状;U01–U08为优化提案,不代表视觉稿已获批准。F14尤其需要统一交互约定,不宜直接理解为缺失功能。 ## 一、已验证问题:复现、原因与验收 ### F01 · P1 · 桌面左侧七个页面按钮未绑定切页事件 **复现**:桌面进入`#view=home&major=0856`,依次点击左侧“院校库、对比、院校详情、搜索、按方向看、我的”;在院校库点击“每日一校”。 **实际**:页面不切换。七个按钮只有`data-v`和首次选中样式设置,没有切换回调。 **定位**:`index.html`第257–263、1047行;对照正常工作的`.tabbar [data-t]`事件。证据`SIDE-*`。 **建议**:统一页面切换入口,使侧栏与底部导航共享路由行为、选中状态和历史处理;不要仅补按钮颜色。 - [ ] 七个按钮分别切到正确页面;重复点击当前页不破坏状态。 - [ ] 页面切换后侧栏和底部导航选中状态一致;未选专业时保留明确的专业选择流程。 ### F02 · P1 · 首页“查看详情”未进入详情 **复现**:打开`#view=home&major=0856&no=176`,点击底部“查看详情”。 **实际**:仍为每日一校。`[data-go]`回调只有在list/search/cmp/dir/mine时才设置`view='detail'`,遗漏home。详情本身存在,列表等页面能够进入。 **定位**:第563、899–903行;用例C02。 **建议**:将“进入详情”和“更换首页学校”作为不同动作处理;修详情不能连带把“换一所”改成跳转。 - [ ] 首页按钮进入当前学校详情,校名、专业、数据口径保持一致。 - [ ] “换一所”仍留在首页;从首页进详情后有可靠的返回路径。 ### F03 · P2 · “同城相似院校 → 查看更多”没有动作 **复现**:首页选择华东理工大学,点击“同城相似院校”右侧“查看更多”。 **实际**:无href、点击回调或动作属性,状态和页面不变。 **定位**:第499、561行;用例C03。另注意当前`sim()`同时接受同城市或同省份,标题与结果范围未必一致。 - [ ] “查看更多”进入有对应地区条件的院校集合,并可返回。 - [ ] 展示标签与实际范围一致:同城就只含同城,含同省则明确命名。 - [ ] 如果本轮不提供该功能,移除可点击样式和箭头,避免继续呈现无响应入口。 ### F04 · P2 · “报考要点”右侧箭头未连接动作 **复现**:首页点击“报考要点”标题右侧箭头。 **实际**:无回调或链接。这里只确认交互暗示未闭合,不预设必须新增“报考要点详情页”。 **定位**:第556行;用例C04。 - [ ] 接入有明确内容的展开/详情,或将标题改为纯信息展示并移除箭头。 - [ ] 静态年份、统计数量等元信息不应再使用会误导用户的交互样式。 ### F05 · P1 · 超出前14个方向码后,没有单独选择入口 **复现**:选择1051,进入方向页,点击“另有13个方向码”。 **实际**:只有前14个码生成`data-dir`按钮;“另有N个方向码”只是普通chip,无展开/选择回调。通过“全部方向码”仍可看到相关数据,因此不是数据完全丢失,而是单独筛选路径缺失。 **定位**:第711、927行;用例C18。 **建议**:提供全部方向码选择器、可检索列表或真正的展开入口;数量多时不依靠无提示的横向长条。 - [ ] 当前专业每个实际存在的方向码均可单独选择,包含第15个之后的码。 - [ ] 方向码总数、选中状态、列表结果一致;切专业后不保留不适用的旧方向。 ### F06 · P1 · 手机院校搜索没有可见入口 **复现**:390×844打开院校库;寻找输入学校名/城市/院校代码的位置。 **实际**:`#q`只在左侧`.panel`中,≤560px时整个面板隐藏,院校库无可见输入框。搜索视图仍提示到左侧搜索,手机无法完成对应操作。桌面输入搜索功能正常。 **定位**:第234–239、255、637–649、1049行;用例C13/C19。 - [ ] 手机有可发现、可触达的搜索框或搜索入口;学校名、城市、院校代码均按页面承诺生效。 - [ ] 支持清空关键词、无结果提示和返回结果;手机不出现“到左侧输入”的指引。 - [ ] 手机可查看/修改目标专业,搜索结果明确对应哪个专业。 ### F07 · P1 · 手机底部导航位于长页面末尾 **复现**:390×844进入院校库,保持页面顶部。 **实际**:导航回调正常,但导航顶部位置约y=7144,必须滑完整个首批列表才看到。方向页、首页也受内容高度影响;不是底部导航按钮无事件。 **建议**:统一应用视口与滚动容器,可用固定/粘性导航或固定壳体;正文必须为导航与设备安全区预留空间。 - [ ] 五个主导航在手机主要页面可持续触达,正文不被遮挡。 - [ ] 320/375/390宽度下无横向溢出;短页/长页、软键盘出现和安全区均检查。 ### F08 · P1 · 手机列表“继续下滑加载”停在80所 **复现**:390×844打开`#view=list&major=0856`,滑到整页最底。 **实际**:仍为80项,提示“已显示80/907所,继续下滑加载”;手机实际滚动的是window,监听却绑定`screen.onscroll`。 **定位**:第239、940–943行;用例C20。方向页共享这一监听结构,本轮手机追加实测样本为院校库。 **建议**:统一滚动来源,或改为明确的“加载更多”入口;不要只改提示文本。首批80不是产品允许访问的总量上限。 - [ ] 手机可从80继续到160,并一直访问到当前筛选结果末尾;最后一批正确停止。 - [ ] 小于80、恰好80、超过80和空结果均检查,不重复、不漏项。 - [ ] 院校库与方向页分别验证;结果数以当前筛选集合为准。 ### F09 · P2 · 桌面追加列表后跳回顶部 **复现**:桌面院校库把screen内部列表滚到接近底部,触发追加。 **实际**:shown从80增到160,但`render()`设置`el.scrollTop=0`,阅读位置丢失。 **定位**:第895、940–943行;用例C21。 - [ ] 追加数据保留已读位置和当前焦点,新增内容接在后面。 - [ ] 收藏/加入对比等局部动作不无故把长列表送回顶部;真正改变筛选时再按约定重置位置。 ### F10 · P1 · 状态保存与刷新恢复不一致 **复现A**:院校库启用“仅开设本专业”,刷新;**B**:方向页启用“按校合并”,刷新;**C**:城市选杭州后刷新;**D**:桌面搜索华东理工后刷新。 **实际**:A/B虽然写入localStorage,`applyHash()`在缺少om/merge时仍覆盖为false;city、kw未由`syncUrl()`写入URL,C/D刷新丢失。手工带覆盖参数的链接与正常操作产生的链接也可能表现不一致。 **定位**:第930、938、1000–1007、1022–1034行;用例C22–C25。 **建议**:明确“URL显式参数、持久化偏好、默认值”的恢复优先级;区分缺参和明确关闭,状态序列化/解析成对维护。现有README写`merge`/`city`等参数时也应与实现核对。 - [ ] 专业、目标分、关键词、省市、标签、排序、本专业开关、合并开关有明确保存与分享规则。 - [ ] 正常操作产生的URL在刷新和新标签页打开后恢复其承诺的状态;localStorage偏好不被缺参静默覆盖。 - [ ] 清空条件后不被URL中的旧参数恢复;切专业时清理不适用状态。 ### F11 · P1 · 详情无法按应用访问顺序返回 **复现**:在院校库筛选、滚动、点击学校详情,再使用浏览器返回。 **实际**:切页使用`history.replaceState()`,没有新增列表→详情历史项;返回落到更早页面,而不是刚才列表。详情也没有明确的独立返回列表按钮。 **定位**:第1007行及详情渲染;用例C26。 **建议**:页面级跳转合理使用pushState;连续输入或轻量筛选更新可以replaceState,避免每输入一个字都产生历史项。补齐详情返回入口。 - [ ] 列表/搜索/方向/收藏/对比进入详情,返回恢复正确来源及其条件和阅读位置。 - [ ] 浏览器前进、返回与界面返回一致;直接打开详情深链时提供合理退路。 ### F12 · P1 · 数据分片加载失败被误表述为“没有招生专业” **复现**:打开0856华东理工详情时,在浏览器中阻断`方向/0856.js`请求。该测试是故障注入,不代表院校实际缺少专业。 **实际**:`onerror`将结果写成空对象,页面显示“官方2027目录里该校未单列0856专业”;没有错误提示或重试。空结果还被缓存,本次会话后续不会自动重新请求。 **定位**:第314–328、446–450行;用例C27。 **建议**:明确idle/loading/success/empty/error状态;真正无源数据与请求失败区分。分数分布等允许缺文件的资源应有清单或明确的预期缺失约定,不能把所有404都当网络故障或招生事实。 - [ ] 断网/文件读取失败时显示加载失败与重试,不输出“官方目录没有”结论。 - [ ] 重试会发起实际请求并在恢复后更新内容,不能因缓存{}永久跳过。 - [ ] 真正未覆盖、源侧缺失、加载中、加载失败四种状态分别验证;适用于方向、专业明细、分数分布。 ### F13 · P2 · “加入志愿”实际仅为收藏 **复现**:首页/详情点“加入志愿”,进入我的。 **实际**:只切换`fav`并保存到localStorage;可在我的看到收藏,未生成志愿表或报考方案。 **定位**:第563、815、949–951行;用例C07/C08。 - [ ] 当前范围内统一改为“收藏/已收藏/取消收藏”等准确动作名,心形与文字入口行为一致。 - [ ] “加入对比”有独立清晰文案及反馈;收藏和对比不会互相混淆。 - [ ] 若未来建设志愿表,另行定义数据、方向粒度及流程,不以现有收藏冒充。 ### F14 · P2 · 相似院校点击与详情入口约定不统一 **复现**:首页点击“同城相似院校”中的一张卡片。 **实际**:替换首页当前学校,仍留在每日一校。该动作确实已实现,不按完全无响应统计;是否保留要由产品约定决定。 - [ ] 明确卡片是“进入详情”还是“切换首页预览”;建议点学校进入详情,将“换一所”保留为独立动作。 - [ ] 卡片、列表、搜索、收藏中的同类学校入口遵循一致约定,避免靠页面来源猜测。 ### F15 · P2 · 手机四校对比列未统一滚动 **复现**:加入四所学校,在320/375/390宽度打开对比;左右滚动表头。 **实际**:图片/校名表头单独横滚,数据行各自压缩,列对应不稳。390宽表头可视324、内容348;320宽为254/348。对比加入/移除/清空的业务动作可用。 **定位**:第159–165、767–774行;上一轮布局实测及本轮C14动作复核。 **建议**:整张表共用一套列宽与横向滚动,必要时固定指标名列;手机可提供两校优先视图,但不能静默隐藏已选择院校。 - [ ] 同一学校的名称、照片和全部指标始终纵向对齐;四所数据都能访问。 - [ ] 行名、年份、单位、缺值可辨识,不用颜色单独传达比较结果。 - [ ] 对比超过4所、移除、清空、首校详情等现有行为保持可用。 ## 二、产品与视觉优化提案(待评审,不与功能缺陷混算) 参考仓库第四轮A/B/C概念方案,以及Anthropic公开的[前端设计指南](https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md)。参考其信息层级、主题适配和截图自检方法,不把某个模型名称或Claude产品配色当作验收标准;不要求复刻其界面。 ### U01 · 主入口围绕选校任务,减少首页绕路 建议以A“院校候选与筛选”为主入口:当前专业、目标分、地区等条件可见且可修改,条件变化直接更新结果;“每日一校”作为次要发现内容。C“方向与科目”作为专业探索入口,B“目标分与分档”作为辅助分析。 - [ ] 先用真实样本内容形成低保真布局,评审后再改成品;不默认现有概念图中的功能已具备数据支撑。 - [ ] 首屏能看到目标条件和候选学校,不被大品牌区、口号和重复提交按钮占满。 ### U02 · 院校卡片突出与当前专业有关的比较依据 建议主信息为校名/城市、当前专业、2026复试线、2027拟招、与目标分的差值;院校代码及审计细节进详情。列表使用小图,发现页再使用大校园图。默认仅显示当前专业开设院校可作为候选方案,但保留主动查看全部单位的入口,并说明覆盖范围。 - [ ] 年份、人数/分数单位和区间含义保留,不能为版式整齐省略。 - [ ] 对每条结论能够定位到当前专业和相应数据;不硬填源侧缺失字段。 ### U03 · 分数差优先于“冲稳保”,避免把粗略分档画成录取把握 当前目标分高于往年最高方向线2分即可标“稳”,可能被理解为录取概率。建议主表达改为“高于2026复试线区间上限2分”等可核对差值;冲稳保作为辅助且说明规则。300/500分制继续明确分开。 - [ ] 不出现未经验证的录取概率、保录暗示或把达到复试线写成可录取。 - [ ] 不同年份、方向线/专业线、专项计划区间和缺值保持可辨识。 - [ ] 没有可比数据时不强行分档;300分制不套用500分目标分。 ### U04 · 比较向专业/方向粒度深化,先核实数据再设计 学校级对比之外,建议让用户核对具体方向的考试科目、学制、学费。不同院系、不同卷子不能用一组“代表值”冒充完全一致;精确到该粒度的数据覆盖和结构需后续确认。 - [ ] 若数据不足,明确展示范围/缺失或只保留学校概览,不生成无依据的方向结论。 - [ ] “相对更优”只用于有明确比较规则的字段,城市、层次、低分等不被自动包装为普遍优势。 ### U05 · 收敛视觉层级,优先保证中文和数据可读 保留当前深绿品牌基础,减少地图线条、分子背景、渐变、大标题、多色标签同时抢注意力。颜色、字号、间距、图标和按钮状态形成一致规则,避免每个模块都套相同卡片。 - [ ] 正文建议以14–16px区间起稿,次要信息避免大量9–11px浅灰文字;关键说明可正常阅读。 - [ ] 数字使用稳定对齐方式;绿色/红色之外有文字或符号解释;键盘焦点、对比度与减少动效偏好纳入检查。 - [ ] 不把预览用固定9:41等模拟系统状态栏带进真实网页。 ### U06 · 桌面与手机分别利用空间 桌面1440宽仍是390宽手机框加300宽控制面板,右侧大量空白。建议桌面提供筛选区+结果区,详情或对比使用合理宽度;手机保证单列、搜索和常驻导航。 - [ ] 320/375/390及桌面1440宽度分别验收,不用等比例放大手机框替代桌面设计。 - [ ] 手机优先还是桌面为主要选校场景仍待产品确认;不阻断F01–F12的缺陷修复。 ### U07 · 让持续几天的选校过程可以接着做 先完成F09–F11的恢复能力,再考虑保存筛选方案、收藏方向、备注等新功能。收藏当前是学校粒度,不能未经设计就声称已能管理专业方向意向。 - [ ] 这部分先记录为后续需求,不把新增备注/方案作为本轮基础修复的隐性前置条件。 - [ ] 若开发,明确本地存储、迁移/清除行为与实际保存粒度,并提供相应提示。 ### U08 · 反馈、空态和错误态形成闭环 收藏/对比/修改条件应有一致反馈;无结果要显示当前条件和调整方向;按钮文案描述实际动作。动效用于解释展开、加入、反馈,不添加大量与任务无关的入场效果。 - [ ] 正常、加载、空结果、失败、上限/不可用状态都有明确表现。 - [ ] “报考要点”箭头、“查看更多”等交互暗示要么有对应操作,要么取消暗示。 ## 三、实施与验收顺序 1. **批次A:恢复主流程**——F01–F05、F13–F14;处理路由、首页详情与更多入口,明确动作语义。 2. **批次B:手机与列表**——F06–F09、F15;统一滚动容器、搜索、常驻导航、追加加载与对比布局。 3. **批次C:状态和错误恢复**——F10–F12;URL/偏好/历史一致,加载失败可重试且不误报招生事实。 4. **批次D:产品与视觉**——先评审U01–U08,确认目标设备和数据支持范围,再实施选定方案。 每批提交可独立审查的改动及对应验证,避免把已验证缺陷与未经确认的新功能混成一次大重写。修复过程中保留现有能用的专业切换、收藏、对比和方向展开。 ## 四、回归检查矩阵 | 维度 | 最低检查内容 | |---|---| | 首次/再次打开 | 无专业、已保存专业、带专业的链接;专业搜索与选择 | | 专业样本 | 0856、0854、1051;补一个300分制专业及缺数据场景 | | 路由与入口 | 侧栏7按钮、底栏5入口、首页详情、相似学校、搜索/收藏/方向/对比到详情与返回 | | 列表 | 空、少于80、80、超过80、多批次到底;筛选/排序/收藏/对比不破坏阅读位置 | | 状态 | 专业、目标分、关键词、省市、标签、排序、开关、合并;刷新/新标签/前进后退;清空条件 | | 对比 | 0/1/2/4所、尝试第5所、移除/清空/详情,320/375/390列对应 | | 数据加载 | 正常、加载中、预期未覆盖、真实空数据、网络/文件失败、重试成功 | | 外观与可达性 | 浅色/深色、键盘焦点、触控目标、减少动效、长中文校名、无照片、缺值 | | 设备 | 320/375/390手机视口、1440桌面;至少补一次真实手机或相应WebView检查 | - [ ] 对F01–F15逐项提供修复结果或明确的产品裁决;未做项保留为未完成,不能仅凭页面无JS异常关闭工单。 - [ ] 核查脚本中的已知断点转为预期通过,补充变更后的边界检查;脚本硬编码的本机路径在执行环境中适配。 - [ ] 提供修后主流程、手机列表、四校对比截图;更新流程图颜色,使图和实现一致。 - [ ] 若只改UI,不要求顺带重建事实层;若触及数据、导出口径或表结构,执行仓库AGENTS规定的相应数据审计。 - [ ] 更新现行UI的README、hash参数、交接文档;不得把旧包、旧原型或概念图当成修后交付。 ## 五、附件与现状流程图 附件见下方上传区:三张流程图、现行UI实测拼图,以及完整核查证据ZIP。ZIP内含详细报告、39项结果JSON、复核脚本、三张图的PNG/SVG/Mermaid、离线HTML总览。所有红色节点表示当前未打通,不表示已经修复;黄色表示部分实现或访问受限;绿色表示对应检查路径可用。 ### 用户操作主流程 ![用户操作主流程](https://git.simgreek.com/attachments/5b72e0f3-e048-4cf6-b834-8a4cecf978a5) ### 按钮断点与列表加载 ![按钮断点与列表加载](https://git.simgreek.com/attachments/e3b645f6-562f-4f1f-a916-2909bbcb6fee) ### 状态保存与数据加载 ![状态保存与数据加载](https://git.simgreek.com/attachments/84d58087-0b38-449b-adb2-0589129fcf53) ### 现行UI实测拼图 ![现行UI实测拼图](https://git.simgreek.com/attachments/07e8ddbe-e4b1-47f2-9770-44f257b66fdd) - [完整核查证据包(HTML、报告、Mermaid、SVG、PNG、JSON、复核脚本)](https://git.simgreek.com/attachments/27e7a486-8e00-4cd3-b7df-419e58f46fd7)
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: simgreek/yanxuan#1