现行离线 UI 已具备选专业、院校筛选、方向查询、详情、收藏和对比,但存在“按钮已显示、操作链路未连接”的情况。典型例子是首页点击“查看详情”仍留在首页;桌面左侧七个页面按钮没有绑定切换事件;手机列表提示继续下滑,却无法追加第81所及后续院校。状态恢复和数据加载失败处理也有断点。
本工单作为一次完整整改的跟踪入口:先修复可复现的功能问题,再优化信息层级和视觉;已验证问题与待评审设计建议分别管理。 不将既有静态概念图视为已实现产品,也不预设新增AI、登录、后端或完整志愿表。
docs/择校UI/index.html
website/
98957612e08ff7655e62e93f68a1af6af1f73d32
audit-flow.cjs
按钮与流程实测.json
源码基线:main提交 6553ca256de9 中的现行入口。
复现:桌面进入#view=home&major=0856,依次点击左侧“院校库、对比、院校详情、搜索、按方向看、我的”;在院校库点击“每日一校”。
#view=home&major=0856
实际:页面不切换。七个按钮只有data-v和首次选中样式设置,没有切换回调。
data-v
定位:index.html第257–263、1047行;对照正常工作的.tabbar [data-t]事件。证据SIDE-*。
index.html
.tabbar [data-t]
SIDE-*
建议:统一页面切换入口,使侧栏与底部导航共享路由行为、选中状态和历史处理;不要仅补按钮颜色。
复现:打开#view=home&major=0856&no=176,点击底部“查看详情”。
#view=home&major=0856&no=176
实际:仍为每日一校。[data-go]回调只有在list/search/cmp/dir/mine时才设置view='detail',遗漏home。详情本身存在,列表等页面能够进入。
[data-go]
view='detail'
定位:第563、899–903行;用例C02。
建议:将“进入详情”和“更换首页学校”作为不同动作处理;修详情不能连带把“换一所”改成跳转。
复现:首页选择华东理工大学,点击“同城相似院校”右侧“查看更多”。
实际:无href、点击回调或动作属性,状态和页面不变。
定位:第499、561行;用例C03。另注意当前sim()同时接受同城市或同省份,标题与结果范围未必一致。
sim()
复现:首页点击“报考要点”标题右侧箭头。
实际:无回调或链接。这里只确认交互暗示未闭合,不预设必须新增“报考要点详情页”。
定位:第556行;用例C04。
复现:选择1051,进入方向页,点击“另有13个方向码”。
实际:只有前14个码生成data-dir按钮;“另有N个方向码”只是普通chip,无展开/选择回调。通过“全部方向码”仍可看到相关数据,因此不是数据完全丢失,而是单独筛选路径缺失。
data-dir
定位:第711、927行;用例C18。
建议:提供全部方向码选择器、可检索列表或真正的展开入口;数量多时不依靠无提示的横向长条。
复现:390×844打开院校库;寻找输入学校名/城市/院校代码的位置。
实际:#q只在左侧.panel中,≤560px时整个面板隐藏,院校库无可见输入框。搜索视图仍提示到左侧搜索,手机无法完成对应操作。桌面输入搜索功能正常。
#q
.panel
定位:第234–239、255、637–649、1049行;用例C13/C19。
复现:390×844进入院校库,保持页面顶部。
实际:导航回调正常,但导航顶部位置约y=7144,必须滑完整个首批列表才看到。方向页、首页也受内容高度影响;不是底部导航按钮无事件。
建议:统一应用视口与滚动容器,可用固定/粘性导航或固定壳体;正文必须为导航与设备安全区预留空间。
复现:390×844打开#view=list&major=0856,滑到整页最底。
#view=list&major=0856
实际:仍为80项,提示“已显示80/907所,继续下滑加载”;手机实际滚动的是window,监听却绑定screen.onscroll。
screen.onscroll
定位:第239、940–943行;用例C20。方向页共享这一监听结构,本轮手机追加实测样本为院校库。
建议:统一滚动来源,或改为明确的“加载更多”入口;不要只改提示文本。首批80不是产品允许访问的总量上限。
复现:桌面院校库把screen内部列表滚到接近底部,触发追加。
实际:shown从80增到160,但render()设置el.scrollTop=0,阅读位置丢失。
render()
el.scrollTop=0
定位:第895、940–943行;用例C21。
复现A:院校库启用“仅开设本专业”,刷新;B:方向页启用“按校合并”,刷新;C:城市选杭州后刷新;D:桌面搜索华东理工后刷新。
实际:A/B虽然写入localStorage,applyHash()在缺少om/merge时仍覆盖为false;city、kw未由syncUrl()写入URL,C/D刷新丢失。手工带覆盖参数的链接与正常操作产生的链接也可能表现不一致。
applyHash()
syncUrl()
定位:第930、938、1000–1007、1022–1034行;用例C22–C25。
建议:明确“URL显式参数、持久化偏好、默认值”的恢复优先级;区分缺参和明确关闭,状态序列化/解析成对维护。现有README写merge/city等参数时也应与实现核对。
merge
city
复现:在院校库筛选、滚动、点击学校详情,再使用浏览器返回。
实际:切页使用history.replaceState(),没有新增列表→详情历史项;返回落到更早页面,而不是刚才列表。详情也没有明确的独立返回列表按钮。
history.replaceState()
定位:第1007行及详情渲染;用例C26。
建议:页面级跳转合理使用pushState;连续输入或轻量筛选更新可以replaceState,避免每输入一个字都产生历史项。补齐详情返回入口。
复现:打开0856华东理工详情时,在浏览器中阻断方向/0856.js请求。该测试是故障注入,不代表院校实际缺少专业。
方向/0856.js
实际:onerror将结果写成空对象,页面显示“官方2027目录里该校未单列0856专业”;没有错误提示或重试。空结果还被缓存,本次会话后续不会自动重新请求。
onerror
定位:第314–328、446–450行;用例C27。
建议:明确idle/loading/success/empty/error状态;真正无源数据与请求失败区分。分数分布等允许缺文件的资源应有清单或明确的预期缺失约定,不能把所有404都当网络故障或招生事实。
复现:首页/详情点“加入志愿”,进入我的。
实际:只切换fav并保存到localStorage;可在我的看到收藏,未生成志愿表或报考方案。
fav
定位:第563、815、949–951行;用例C07/C08。
复现:首页点击“同城相似院校”中的一张卡片。
实际:替换首页当前学校,仍留在每日一校。该动作确实已实现,不按完全无响应统计;是否保留要由产品约定决定。
复现:加入四所学校,在320/375/390宽度打开对比;左右滚动表头。
实际:图片/校名表头单独横滚,数据行各自压缩,列对应不稳。390宽表头可视324、内容348;320宽为254/348。对比加入/移除/清空的业务动作可用。
定位:第159–165、767–774行;上一轮布局实测及本轮C14动作复核。
建议:整张表共用一套列宽与横向滚动,必要时固定指标名列;手机可提供两校优先视图,但不能静默隐藏已选择院校。
参考仓库第四轮A/B/C概念方案,以及Anthropic公开的前端设计指南。参考其信息层级、主题适配和截图自检方法,不把某个模型名称或Claude产品配色当作验收标准;不要求复刻其界面。
建议以A“院校候选与筛选”为主入口:当前专业、目标分、地区等条件可见且可修改,条件变化直接更新结果;“每日一校”作为次要发现内容。C“方向与科目”作为专业探索入口,B“目标分与分档”作为辅助分析。
建议主信息为校名/城市、当前专业、2026复试线、2027拟招、与目标分的差值;院校代码及审计细节进详情。列表使用小图,发现页再使用大校园图。默认仅显示当前专业开设院校可作为候选方案,但保留主动查看全部单位的入口,并说明覆盖范围。
当前目标分高于往年最高方向线2分即可标“稳”,可能被理解为录取概率。建议主表达改为“高于2026复试线区间上限2分”等可核对差值;冲稳保作为辅助且说明规则。300/500分制继续明确分开。
学校级对比之外,建议让用户核对具体方向的考试科目、学制、学费。不同院系、不同卷子不能用一组“代表值”冒充完全一致;精确到该粒度的数据覆盖和结构需后续确认。
保留当前深绿品牌基础,减少地图线条、分子背景、渐变、大标题、多色标签同时抢注意力。颜色、字号、间距、图标和按钮状态形成一致规则,避免每个模块都套相同卡片。
桌面1440宽仍是390宽手机框加300宽控制面板,右侧大量空白。建议桌面提供筛选区+结果区,详情或对比使用合理宽度;手机保证单列、搜索和常驻导航。
先完成F09–F11的恢复能力,再考虑保存筛选方案、收藏方向、备注等新功能。收藏当前是学校粒度,不能未经设计就声称已能管理专业方向意向。
收藏/对比/修改条件应有一致反馈;无结果要显示当前条件和调整方向;按钮文案描述实际动作。动效用于解释展开、加入、反馈,不添加大量与任务无关的入场效果。
每批提交可独立审查的改动及对应验证,避免把已验证缺陷与未经确认的新功能混成一次大重写。修复过程中保留现有能用的专业切换、收藏、对比和方向展开。
附件见下方上传区:三张流程图、现行UI实测拼图,以及完整核查证据ZIP。ZIP内含详细报告、39项结果JSON、复核脚本、三张图的PNG/SVG/Mermaid、离线HTML总览。所有红色节点表示当前未打通,不表示已经修复;黄色表示部分实现或访问受限;绿色表示对应检查路径可用。
No dependencies set.
The note is not visible to the blocked user.
问题与目标
现行离线 UI 已具备选专业、院校筛选、方向查询、详情、收藏和对比,但存在“按钮已显示、操作链路未连接”的情况。典型例子是首页点击“查看详情”仍留在首页;桌面左侧七个页面按钮没有绑定切换事件;手机列表提示继续下滑,却无法追加第81所及后续院校。状态恢复和数据加载失败处理也有断点。
本工单作为一次完整整改的跟踪入口:先修复可复现的功能问题,再优化信息层级和视觉;已验证问题与待评审设计建议分别管理。 不将既有静态概念图视为已实现产品,也不预设新增AI、登录、后端或完整志愿表。
版本、环境与证据范围
docs/择校UI/index.html;website/是另一条早期原型,不属于本工单实测实现。98957612e08ff7655e62e93f68a1af6af1f73d32,已与远端main核对一致。源码行号均以此文件版本为准,后续重构时按函数/选择器定位。audit-flow.cjs、按钮与流程实测.json;三个流程图均提供PNG、SVG、可编辑Mermaid源,另附无需联网的HTML总览。源码基线:main提交 6553ca256de9 中的现行入口。
优先级与范围
一、已验证问题:复现、原因与验收
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。
建议:提供全部方向码选择器、可检索列表或真正的展开入口;数量多时不依靠无提示的横向长条。
F06 · P1 · 手机院校搜索没有可见入口
复现:390×844打开院校库;寻找输入学校名/城市/院校代码的位置。
实际:
#q只在左侧.panel中,≤560px时整个面板隐藏,院校库无可见输入框。搜索视图仍提示到左侧搜索,手机无法完成对应操作。桌面输入搜索功能正常。定位:第234–239、255、637–649、1049行;用例C13/C19。
F07 · P1 · 手机底部导航位于长页面末尾
复现:390×844进入院校库,保持页面顶部。
实际:导航回调正常,但导航顶部位置约y=7144,必须滑完整个首批列表才看到。方向页、首页也受内容高度影响;不是底部导航按钮无事件。
建议:统一应用视口与滚动容器,可用固定/粘性导航或固定壳体;正文必须为导航与设备安全区预留空间。
F08 · P1 · 手机列表“继续下滑加载”停在80所
复现:390×844打开
#view=list&major=0856,滑到整页最底。实际:仍为80项,提示“已显示80/907所,继续下滑加载”;手机实际滚动的是window,监听却绑定
screen.onscroll。定位:第239、940–943行;用例C20。方向页共享这一监听结构,本轮手机追加实测样本为院校库。
建议:统一滚动来源,或改为明确的“加载更多”入口;不要只改提示文本。首批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等参数时也应与实现核对。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动作复核。
建议:整张表共用一套列宽与横向滚动,必要时固定指标名列;手机可提供两校优先视图,但不能静默隐藏已选择院校。
二、产品与视觉优化提案(待评审,不与功能缺陷混算)
参考仓库第四轮A/B/C概念方案,以及Anthropic公开的前端设计指南。参考其信息层级、主题适配和截图自检方法,不把某个模型名称或Claude产品配色当作验收标准;不要求复刻其界面。
U01 · 主入口围绕选校任务,减少首页绕路
建议以A“院校候选与筛选”为主入口:当前专业、目标分、地区等条件可见且可修改,条件变化直接更新结果;“每日一校”作为次要发现内容。C“方向与科目”作为专业探索入口,B“目标分与分档”作为辅助分析。
U02 · 院校卡片突出与当前专业有关的比较依据
建议主信息为校名/城市、当前专业、2026复试线、2027拟招、与目标分的差值;院校代码及审计细节进详情。列表使用小图,发现页再使用大校园图。默认仅显示当前专业开设院校可作为候选方案,但保留主动查看全部单位的入口,并说明覆盖范围。
U03 · 分数差优先于“冲稳保”,避免把粗略分档画成录取把握
当前目标分高于往年最高方向线2分即可标“稳”,可能被理解为录取概率。建议主表达改为“高于2026复试线区间上限2分”等可核对差值;冲稳保作为辅助且说明规则。300/500分制继续明确分开。
U04 · 比较向专业/方向粒度深化,先核实数据再设计
学校级对比之外,建议让用户核对具体方向的考试科目、学制、学费。不同院系、不同卷子不能用一组“代表值”冒充完全一致;精确到该粒度的数据覆盖和结构需后续确认。
U05 · 收敛视觉层级,优先保证中文和数据可读
保留当前深绿品牌基础,减少地图线条、分子背景、渐变、大标题、多色标签同时抢注意力。颜色、字号、间距、图标和按钮状态形成一致规则,避免每个模块都套相同卡片。
U06 · 桌面与手机分别利用空间
桌面1440宽仍是390宽手机框加300宽控制面板,右侧大量空白。建议桌面提供筛选区+结果区,详情或对比使用合理宽度;手机保证单列、搜索和常驻导航。
U07 · 让持续几天的选校过程可以接着做
先完成F09–F11的恢复能力,再考虑保存筛选方案、收藏方向、备注等新功能。收藏当前是学校粒度,不能未经设计就声称已能管理专业方向意向。
U08 · 反馈、空态和错误态形成闭环
收藏/对比/修改条件应有一致反馈;无结果要显示当前条件和调整方向;按钮文案描述实际动作。动效用于解释展开、加入、反馈,不添加大量与任务无关的入场效果。
三、实施与验收顺序
每批提交可独立审查的改动及对应验证,避免把已验证缺陷与未经确认的新功能混成一次大重写。修复过程中保留现有能用的专业切换、收藏、对比和方向展开。
四、回归检查矩阵
五、附件与现状流程图
附件见下方上传区:三张流程图、现行UI实测拼图,以及完整核查证据ZIP。ZIP内含详细报告、39项结果JSON、复核脚本、三张图的PNG/SVG/Mermaid、离线HTML总览。所有红色节点表示当前未打通,不表示已经修复;黄色表示部分实现或访问受限;绿色表示对应检查路径可用。
用户操作主流程
按钮断点与列表加载
状态保存与数据加载
现行UI实测拼图