让AI改网页:窄屏适配与填错恢复

你把一页网页发给别人,对方可能不会说"标题层级不合理"。他只会说:手机上右边看不见;表单报错了,不知道该改哪;刚填好的内容,怎么全没了?

这些话才是设计工作真正的起点。给页面换一种颜色,很容易;让人顺利完成一件事,要更具体地想一想。

这次试的 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,不能外推成所有页面都清零。

在自己电脑上动手

上游:github.com/pbakaus/imp...

中文练习与文档: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,无官方合作。

相关推荐
不是万能的豆学长4 小时前
开源项目 public-apis 登顶 GitHub 趋势榜
开源·github
小弥儿5 小时前
38K星的开源项目 t3code:给 Claude Code 和 Codex 装一个手机遥控器
学习·智能手机·开源·github
分布式存储与RustFS5 小时前
可观测性数据落进对象存储:Proscia 案例拆解与 ClickHouse 自托管配置
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
SL_staff5 小时前
制造订单交付闭环实践:用跨部门计划模板解决缺料-停机-返工三角死循环
java·开源·产品
日日大王学编程6 小时前
deerflow-memory-design-blog
python·langchain·开源
miofly6 小时前
MIT 团队用 GPT-6 Astra 改写小模型权重,跳过梯度训练提升指令遵循能力
开源·github
AI日报派送佬6 小时前
2026年11月02日 AI 行业日报|商汤开源 Loop-9B、Pika 发布 H3 Flex 音视频模型、Meta× 傅利叶推出人形机器人 Max
人工智能·微软·开源·音视频·openai·1024程序员节·ai日报
miofly7 小时前
GitHub 今日推荐|agent-desktop:通过无障碍树让 AI 代理直接操作桌面应用
rust·开源·github
小杨互联网7 小时前
开源表格数据与文本处理 CLI 离线镜像合集
开源·数据处理·cli·离线镜像