<h2>适用范围</h2><p>本文面向使用梦幻西游手游时空客户端的桌面自动化开发者,重点讨论可观察状态、截图证据和动作复核。内容来自当前项目的窗口选择、视觉识别、任务执行和日志记录方式,不把一次命中当成最终结论。</p><p>排错时先记录采集时间、窗口句柄、客户区矩形、截图来源、模板版本和动作结果。这样复盘时可以区分采集错误、识别错误、坐标错误和状态错误,而不是只看到最后一次点击。</p><p>窗口位置变化、Windows DPI 缩放、多开排列和遮挡都会改变像素结果。识别区域与点击位置应从当前窗口矩形计算,避免把桌面绝对坐标写成固定常量。</p><p>每一次动作都要有前置条件和后置验证。前置条件不满足时回到观察状态,后置验证失败时重新采集并记录证据,不在旧坐标上连续点击。</p><p>真实截图发布前先隐藏账号、QQ、卡密、IP、用户名、消息和其他隐私。若图片用于原理示意,正文仍然要用文字表达关键步骤。</p><p>可通过<a href="/guide.html">使用说明</a>了解基础流程,也可以在<a href="/articles/">文章频道</a>中对照窗口、任务和视觉识别记录。</p><h2>为什么要留证据</h2><p>截图不是越多越好,而是要能回答某次判断依据是什么。对短暂弹窗、窗口切换和点击后复核,保存动作前、动作后和异常时的关键帧即可。</p><h2>命名与关联</h2><p>文件名应包含日期、窗口标识、事件和阶段,例如 capture_window2_menu_after。日志保存相对事件编号,正文和报表只引用不含隐私的文件名,避免把账号或聊天内容写入路径。</p><h2>采集前做遮挡检查</h2><p>发布或交接前查看截图中的标题栏、通知区域、地址栏和聊天区域,隐藏账号、QQ、卡密、IP、用户名、消息及其他隐私。截图用于原理示意时优先裁掉无关区域。</p><h2>保留周期</h2><p>按事件级别设置留存周期:正常成功只保留摘要和少量关键帧,识别失败保留完整链路,发布验收保留能复核资源和页面的证据。清理时保留日志索引,不让磁盘被重复截图占满。</p><h2>从证据回到修复</h2><p>复盘时先按时间排序,再对照采集、判断、动作和结果四段链路。只有当证据指向具体环节,才调整阈值、区域或重试;不要因为一次失败就扩大所有搜索范围。</p><figure><img src="/assets/articles/2026-08-18/screenshot_retention_policy_flow.png" alt="截图证据留存流程示意图"><figcaption>截图证据留存的抽象流程示意,关键步骤同时以文字说明。</figcaption></figure><h2>发布前自检</h2><p>检查标题、摘要、正文结构、meta title、meta description、canonical、封面 alt、正文图注和站内链接;确认 slug 未重复,正文中的产品名称统一为梦幻西游手游时空客户端,且没有把图片当作文字内容。</p><h2>实施时的复核顺序</h2><p>执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。执行前确认状态。执行后复核结果。异常时记录证据。</p>