你把一页网页发给别人,对方可能不会说"标题层级不合理"。他只会说:手机上右边看不见;表单报错了,不知道该改哪;刚填好的内容,怎么全没了?
这些话才是设计工作真正的起点。给页面换一种颜色,很容易;让人顺利完成一件事,要更具体地想一想。
这次试的 Impeccable ,是一套给 AI 编程助手使用的设计工具。上游把它叫作助手的"设计词汇":你可以指出一个区域,请它审查、适配屏幕、讲清说明、补齐错误状态。它另有一个无需模型密钥的规则检测器,负责找线索。真正修改页面的仍是 Agent,不是检测器。
我们准备了两个原创中文练习:活动目录和表单错误恢复。一起看看两个不同的问题怎样走到可用的结果。
第一件事:先让人找到想参加的活动
"周末动手会"有三场虚构练习:写作、网页、数据。改前电脑上能看到卡片,切到390px的浏览器模拟视口,980px固定宽度把右侧内容挤出了屏幕。

需要改变的是阅读与点击的安排:内容随屏幕排布,手机上往下读;标题和正文有清楚的层级;链接能从背景中分辨出来。原来的活动文案、筛选脚本和详情链接都保留。
改完之后,我们没有只拍一张好看的图。点"网页"只剩网页练习,换"写作"和"数据"也各剩一场;点"全部"恢复三场,详情能跳到对应准备事项。Tab键走到控件时能看到焦点。在这个模拟视口中,页面不再横向溢出。
规则检测在这里帮忙定位低对比、标题等问题。目录的源文件与实际网页分别检测,改前各14项、改后各0项;两个14的组成不同,不能当作逐项相同的报告。中间一次标题字号调整得还不够,仍收到层级提示,修改后才复查通过。
0项只是这次固定规则没有命中,不代表审美满分或完整无障碍合规。能筛选、能看详情,也必须亲手点过才知道。
第二件事:填错一个数字,不该重填整张表
再看一个独立表单。用虚构称呼"纸飞机",选择"网页练习",人数填5。改前只弹出"提交失败,请检查",而前面填写的称呼、主题都被清空。
这不是缺少动画,而是页面没有帮助读者恢复。我们按 clarify(把文字说明写清楚)和 harden(补齐错误、边界状态)的指导,由 Agent 改写了页面:
- 输入框上方一直保留标签,不靠输入后就消失的占位文字。
- 提交前就说明人数须为1---4的整数;报错时给出"例如2"这样的纠正办法。
- 其他输入保留,错误放在对应字段附近,焦点移到第一处错误。
- 成功后给出本页确认,允许返回修改和重新练习。

实际操作中,人数5只触发人数范围提示,称呼与主题仍在;改成2后生成确认。返回修改,把人数改成3、备注换成新的问题,结果也随之更新。重新练习则清空输入与旧确认文字。

我们还试了空提交、1字称呼、小数人数1.5;停止服务再启动后,换称呼与主题重新生成。这些操作都在本机浏览器内完成,没有服务端、数据库或真实预约,也不要填真实姓名、联系方式。
这里有一个值得保留的"不全绿":表单的源文件与实际网页检测各有1条米色色调提示。两版表单保持相同配色,把对照聚焦在错误恢复;本期没有处理这条外观提示,也没有关规则凑0。原目录的14→0,不能外推成所有页面都清零。
在自己电脑上动手
中文练习与文档:gitee.com/lushengjie/...
这里交付的是原创样例与中文入口,不是上游技能或引擎镜像。完整下载中文仓库后,需要 Python 3.9+、Node.js 18.19+、npm 和可访问官方npm的网络;检测实际网页还需要Chrome或Edge。固定npm CLI4.8.0、引擎0.1.18。真正让助手改页面仍需自己的Agent。
先在仓库根目录打开本机预览:
bash
python3 run.py --serve --port 18774
Windows可用:
powershell
py -3 run.py --serve --port 18774
目录两版在 http://127.0.0.1:18774/before/ 与 /after/;表单两版在 /form-before/ 与 /form-after/。终端仍会打印原目录地址,试表单请手动改路径。只监听本机,结束按 Ctrl+C;端口占用时换明确空闲的端口。
你可以先走两条短流程:目录里选择网页、查看准备事项、恢复全部;表单里填"纸飞机/网页练习/5",看错误后改成2,核对确认内容,再返回修改。成功标志是页面行为与输入对应,不只是服务启动了。
预览模式不自动扫描。另开终端检查表单:
bash
node node_modules/impeccable/cli/bin/cli.js detect --json site/form-after/index.html
node node_modules/impeccable/cli/bin/cli.js detect --json http://127.0.0.1:18774/form-after/
本次各1条配色提示,退出2;官方退出2表示有发现,退出1才是扫描失败。目录的一键检测则是macOS/Linux的 bash start.sh,Windows x64的 start.cmd,结果在 .runtime/results/summary.json,结束自动停服务。
若实际网页检测报 Failed to launch the browser process,先核对Chrome/Edge安装和宿主执行权限,保留错误信息;不要借用已登录浏览器资料或关闭安全保护来绕过。只有源文件检测通过时,就只记源文件通过。
本期只实测macOS Apple Silicon。Linux、Mac Intel、Windows x64目前是官方路线与启动说明,未在相应系统实跑;没有Windows ARM64原生包验证,不承诺x64仿真可用。390px图片为Edge视口模拟,不是真机,也没验证移动键盘或屏幕阅读器。本机设计技能指导4.6.0与锁定检测器4.8.0分别记录。
如果你已经有一页"能跑"的网页,可以从一个小任务开始:找活动、填表、返回修改。把具体卡点告诉自己的助手,再用相应设计技能改一个区域,回到页面重新走完。是否好用,最终要落在这个动作上。
AI辅助编写、改版与配图,已实际核对。上游Apache-2.0,原创练习MIT,无官方合作。