网页提速方法，人工经验写成脚本需求时怎样描述例外情况
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /1eac25031e64.html
📄
网页提速方法，人工经验写成脚本需求时怎样描述例外情况
把人工提速经验转成脚本，最容易漏掉的不是主流程，而是例外分支。做法是：先拿一个真实页面，把人工判断写成“条件—动作—不可照搬的边界”三段式，再让脚本对每个例外输出可核对的标记，而不是直接跳过或强行套用。下面以一份常见的“图片与阻塞资源处理清单”为例，演示如何把经验转成可执行需求。
先固定一个样本，把人工操作拆成可观察信号
选一个你已经手工优化过的页面，不看结论，只看你当时做了什么判断。假设这个页面有若干张图片，其中一张是首屏主图，其余是列表缩略图。人工经验往往是“主图优先、缩略图延后”，但这句话对脚本无效，因为脚本不知道哪张是主图。
把它改写成可观察信号：图片在首屏可视区域内、宽高比接近页面主视觉、出现在标题之后正文之前。这三个条件同时成立时，才执行“优先加载并预留尺寸”的动作。信号必须是脚本能从页面结构或已有标注里读到的，不能依赖“我觉得重要”这类判断。
这一步的实际动作是：为样本页面的每张图片生成一行记录，包含位置、尺寸、是否在首屏。结果会直接影响下一步——如果记录里出现两张图片都满足条件，说明你的判断本身就有例外，需要先解决歧义，而不是继续写脚本。
例外情况要写成“条件不成立时怎么办”
主流程只覆盖多数情况，例外才是脚本稳定运行的关键。对上面每个条件，都要写明不成立时的动作，而不是留空。常见写法有三种，选择取决于该例外会不会影响页面可用性。
- 跳过并标记：条件不满足就不处理，但在输出里留下标记，供人工复核。适合影响小、数量多的例外。
- 降级处理：不满足优先条件时，改用保守方案，例如只预留尺寸、不改变加载顺序。适合不能出错但可以慢一点的情况。
- 中止并报错：例外会导致页面结构异常时，停止该页处理并输出原因。适合少数高风险页面。
假设脚本遇到一张没有宽高属性的图片，它既可能破坏布局，也可能只是列表里的装饰图。此时选“降级处理”更合适：保留原样，只记录“缺少尺寸信息”。这个动作的结果是，后续你可以按标记数量决定是否统一补尺寸，而不是让脚本替你做判断。
把不能照搬的边界写进需求，而不是写进注释
人工经验里最危险的部分，是那些“上次这样做有效”的隐含前提。脚本需求必须显式写出边界，否则换个页面就会误伤。边界通常来自三类差异：页面类型、资源来源、以及数据采集方式。
以资源来源为例，同域名下的脚本和第三方脚本，处理方式可能完全不同。人工优化时你可能会直接调整加载顺序，但脚本不能假设第三方资源允许被延后。需求里应写明：仅处理同域名资源；遇到跨域资源时只记录，不修改。这样脚本在规模化运行时，不会因为个别页面的第三方资源而整体失败。
另一个边界是数据采集差异。如果你用不同工具或不同时间点采集页面数据，同一页面的结果可能不一致。需求里要注明以哪一次采集为基准，以及两次采集差异超过什么范围时需要人工确认。这不是为了追求精确，而是避免脚本把采集波动当成真实变化。
用一个短例子验证例外分支是否可执行
假设你手上有三张图片：一张首屏主图、一张首屏缩略图、一张页脚图标。按前面的条件，只有主图满足优先处理。缩略图虽然也在首屏，但宽高比不符合主视觉条件，应进入“跳过并标记”。页脚图标不在首屏，直接跳过，不标记。
脚本运行后，输出应包含：主图已预留尺寸并调整加载顺序；缩略图标记为“首屏但非主视觉”；页脚图标无记录。此时你检查标记数量，如果缩略图标记过多，说明条件里的宽高比阈值可能过严，需要回到样本重新观察，而不是直接放宽阈值。
这个动作的结果决定了下一步：标记数量在可接受范围内，就可以把脚本应用到同类页面；标记数量异常，说明例外描述还不完整，应先补充条件，再扩大范围。整个过程不承诺固定见效时间，因为一次改动前后的比较还要考虑季节、搜索需求变化和采集差异。
规模化前，先确认例外是否有共同解释
当脚本在多个页面运行后，例外可能集中在某一类页面上。这时不要急着为每个例外单独写规则，而要先找共同解释。例如，所有标记都出现在列表页，而详情页没有，那问题可能出在列表页的图片结构，而不是脚本本身。
判断方法很简单：把例外按页面类型分组，看是否某一组占比明显偏高。如果是，回到需求里补充该类页面的处理条件；如果不是，说明例外是分散的个别情况，保留标记并人工抽样即可。这样处理的结果是，脚本需求始终对应可解释的边界，而不是不断堆积补丁。
最后检查一遍你的需求文档：每个例外是否都有明确的条件、动作和输出标记；每个不能照搬的边界是否写在了需求正文里；样本验证是否覆盖了至少一个不满足条件的对象。做到这三点，人工经验才算真正转成了可执行的脚本需求。
