用途：在保留原页面设计的前提下，完成卡片链接修改、显示异常排查，并完成修改后的验收。
本文来自一次实际维护操作的脱敏整理。主题、插件与后台入口因站点而异，案例中的修复结果不能直接套用于其他网站。
1. 开始前：确认范围并备份
- 读取任务原文及客户核对图，建立“卡片名称—目标地址—数量”映射表；缺失地址标为待确认，不自行推断。
- 确认只改链接还是同时获准修复显示异常；保留原文字、图片、图标、间距、布局与打开方式。
- 通过已授权渠道登录后台；凭据只用于登录，不写入说明、截图或执行日志。
- 定位真正渲染卡片的内容源。案例位于主题首页内容构建器的自由内容区域，不能仅凭页面名称判断编辑入口。
- 保存原始 HTML、相关主题设置和插件启用状态；记录修改前桌面与手机显示，区分既存异常与本次新增问题。
建议目录
[归档根目录]/[项目代号]/[日期]-网站维护/
- 01-原始资料：需求与原图，保持原件不动。
- 02-修改前备份：HTML、主题设置、插件状态。
- 03-修改文件：最终 HTML、链接映射。
- 04-验收记录：测试结果、异常处理与回退方法。
2. 修改链接：保持结构，确保整卡可点击
- 优先使用主题或组件自带的整卡链接设置。
- 需要编辑 HTML 时，先检查卡片内是否已有链接、按钮或其他交互；避免嵌套链接和覆盖其他控件。
- 案例采用卡片相对定位、卡片内链接绝对定位覆盖的方式，保留原文字、图片与类名，并给链接设置明确的可访问名称。
- 覆盖链接仅适用于没有其他独立交互的卡片。确认键盘可聚焦、焦点可见、Enter 可打开；不要只验证鼠标。
- 对照映射表逐项检查 href，沿用站内打开方式；不要无依据新增另开窗口。
- 保存后重新打开后台内容核对，再查看公开页面。注意编辑器自动生成的空段落可能改变间距。
3. 显示异常：一次只调整一个变量
滚动区域空白，但内容已存在
检查滚动动画容器的透明度与脚本执行。案例中关闭主题 JavaScript 压缩后，动画透明度恢复到可见状态。此结果是该环境的观察，不代表所有空白均由压缩导致。
卡片边框、内边距或列布局丢失
检查样式文件加载及计算样式。案例中关闭主题 CSS 优化后恢复原布局；其他设置保持原值。修改后需复核手机布局，并关注关闭优化对加载速度的影响。
公开页面出现 open_basedir 路径警告
先定位警告所属插件与受限路径，确认插件是否承担必要业务。案例中停用文件管理插件、保留安装文件后，警告消失。停用属于临时隔离，未证明插件内部路径问题已根治；不要通过扩大服务器目录权限来掩盖问题。
共同要求
每次调整前记录原值，保存后刷新公开页并核对效果；无效则恢复，再继续排查。重新开启相关优化或插件可能使异常复现，不能把重新开启当作无风险回退。
4. 验收：内容、交互与可见效果分别检查
- 全量核对卡片数量、名称与链接映射，检查嵌套链接。
- 核对整卡覆盖范围，点击文字、图标及卡片空白区域。
- 桌面端核对列数、卡片尺寸、内边距、相邻间距及 hover 表现。
- 手机视口核对换行、宽度、触摸点击与目标落点；案例使用 390×844，其他项目按实际设备补测。
- 每类目标页面至少实际打开一次；抽样点击不能替代全量 href 核对。
- 用键盘检查 Tab 焦点和 Enter 激活。
- 滚动进入动画区域，确认最终可见；检查公开页警告与控制台明显错误。
- 后台保存结果、公开页面及归档文件均已回读。
判断原则：HTTP 成功、DOM 存在或脚本通过，不等于页面肉眼可见；自动检查与可见结果冲突时，继续排查，不标记通过。
