周五上线前，用编码代理修好结账页的键盘操作

结账页里，鼠标能点不代表人人能用

假设团队周五要上线一个结账页。鼠标点击一切正常，但只用键盘时，优惠码按钮无法选中，地址输入框没有明确名称，付款失败后也不知道哪里出了错。这些都是前端无障碍问题：界面看得见，却不一定能被不同使用方式的人顺利操作。

无障碍不只是服务屏幕阅读器用户。暂时无法使用鼠标的人、需要放大页面的人，也会受益。对初次尝试的团队，先修好一个完整流程，比一次性扫描整个网站更容易验证效果。

编码代理是能动手改项目的助手

普通聊天助手通常给出建议，编码代理则可以在授权范围内读取项目文件、修改组件、执行测试，再根据结果继续调整。它不是单独的模型，而是模型与文件访问、终端等工具组成的工作方式。

例如，你让它检查结账表单，它可能找到输入框组件，补上标签关联，修改错误提示，再运行现有测试。但“能修改代码”不等于“理解所有用户体验”。它也可能误删样式、添加多余属性，或把测试通过误认为修复完成。

把第一项任务限定在优惠码和地址表单

不要只说“让网站符合无障碍标准”。给代理一个范围、一个可观察的问题，以及明确的验收条件：

“检查结账页的优惠码按钮和地址表单。先列出问题与修改计划，等我确认再动手。保留现有视觉设计，不新增依赖。修复后运行已有测试，说明仍需人工检查的内容。”

• 提供页面入口、组件路径和复现步骤，减少代理猜测。
• 要求优先采用原生按钮、输入框和标签，不用可点击的普通容器模拟按钮。
• 要求输入错误既有文字说明，也与对应字段建立程序化关联，不能只改变边框颜色。
• 限制修改范围，不顺带重构状态管理或升级整个组件库。

动手前创建分支，确保工作区没有混杂的未提交修改。不要让代理读取生产密钥，也不要为了修复页面而开放无关目录或部署权限。

按钮、焦点与错误提示要一起检查

修复按钮时，要确认它能通过键盘触发；表单内不负责提交的按钮，还应明确按钮类型，避免意外提交。修复标签时，占位文字不能代替持续可见的字段名称。

如果地址编辑放在弹窗里，还要检查打开后的焦点位置、关闭后是否回到触发按钮，以及键盘焦点是否会跑到弹窗背后。不要让代理随意增加正数的焦点顺序属性，试图掩盖页面结构问题。

ARIA 属性可以补充语义，但不是越多越好。原生元素已经表达的信息通常不必重复声明；错误使用反而可能让辅助技术读出矛盾内容。

自动检测通过后，再走一遍真实付款路径

让代理运行项目已有的检查；如果需要引入无障碍检测工具，先确认依赖变更。自动检测能发现部分标签、语义和对比度问题，却无法证明整个结账体验可用。

• 只用 Tab、Shift＋Tab、回车和空格完成操作，观察焦点是否清晰、顺序是否合理。
• 提交空表单，确认错误容易找到，填写内容不会丢失。
• 放大页面，检查文字和按钮是否重叠、重要内容是否被遮挡。
• 用屏幕阅读器检查字段名称、错误关联和付款状态更新。

最后审阅代码差异，确认修复没有破坏原有交互，并把已经复现的问题加入回归测试。涉及关键付款流程时，尽可能邀请有辅助技术使用经验的人参与验证。

让模型接入服务于小步修复

如果团队通过 Claude Code、Codex 或 Gemini CLI 使用编码代理，可以考虑 RelayVano：它提供按量付费的模型中转，也支持兼容 OpenAI 的 SDK，API 基础地址为 https://api.relayvano.com；具体接入参数应按工具文档配置。注册 RelayVano 后，可以先用一个小范围任务试跑，观察修改质量和费用。

接入服务解决的是模型访问，不会自动赋予代理可靠的无障碍判断。第一次实践的目标很具体：让原本无法用键盘完成的结账步骤真正可用，并留下可重复的验证方法。