使用文档
从查一个词，到让 AI 把页面改对。按顺序读一遍大约十分钟。
快速开始
插件使用
悬停识别
- 按 Alt + Shift + T 或点插件按钮开启识别模式，按 Esc 退出。
- 鼠标悬停的元素会高亮，浮层显示标准术语名（中英）、一句话定义、所在区块和布局，开发模式下还会显示 React / Vue 组件名。
- 识别模式下点击元素会锁定浮层，不会触发页面原来的点击行为。浮层里可以「查看详情」或「复制给 AI」。
- 本地识别不调用 AI、不消耗额度。认不出时可以点「AI 识别」，这一步会上传该元素的截图和 HTML 片段，并消耗额度。
整页分析和侧边栏
- 在插件面板点「分析整页」，插件会截取整页截图，并采集精简后的 DOM 结构一起提交。
- 分析结果在侧边栏显示，也可以跳到网页端查看完整报告、做效果预览和 Agent 升级。
启用范围
插件默认只在 localhost 和 127.0.0.1 上启用。测试环境、预览部署地址等其他网址，可以在插件里手动启用。
网页分析
- 上传截图：支持 PNG、JPEG、WebP，单张不超过 15MB。可以点击选择、拖进上传区，或者直接粘贴剪贴板里的截图。建议截桌面宽度的整页。
- 公网网址：服务器会打开这个网址并截图后分析。需要登录才能看的页面、内网地址都截不到。
- 本地页面：localhost、局域网地址上的页面，服务器访问不到你的电脑，请用插件分析，或者自己截图上传。
分析一般在 30 秒内完成。页面会显示当前进度，完成后自动出结果。
推荐怎么读
结果页左边是截图，截图上的编号框对应识别出的区块，有问题的区块用醒目颜色标出。点编号框会定位到右边对应的说明。
区域判断
每个区域都会给出结论：不用改、有问题 或 未识别。已经合适的区域会明确写「不用改」，不会为了推荐而推荐。每个区域还列出当前布局和组件、内容特征（信息密度、用途、条目数量等），以及识别依据。
推荐卡片
- 当前 → 推荐：现在用的是什么，建议换成什么。点名称可以跳到术语页。
- 严重程度：「建议修改」表示明显用错了，「可以优化」表示换了会更好。
- 理由：标注「引自术语库」的内容是术语的适用场景、不适用场景或常见坏用法原文，不是模型自己编的。
- 规则编号：每条推荐都来自一条人工编写的规则，例如 R001。模型只负责识别页面结构和内容特征，推荐由规则决定。
- 备选和不推荐：主推荐之外还可以考虑的方案，以及明确不合适的用法。
对每条推荐选择「采纳」或「忽略」。采纳的推荐会用于 Agent 升级和生成给 AI 的指令。
效果预览
在推荐卡片上点「效果预览」，会用页面里的真实文案生成该区域改造前后的灰度线框，左右并排对比，窄屏可以切换查看。线框只表达结构，不代表最终视觉效果。
Agent 升级
- 复刻：Agent 根据截图和 DOM，用单文件 HTML 复刻原页面，保留结构、文案和主要配色，不追求像素级一致。
- 应用推荐：把你采纳的推荐应用到复刻页上，只改动涉及的区块，其他区块保持原样。
- 追加修改：用自然语言继续提要求，例如「表格列太多，把备注列去掉」。每次修改保存为一个新版本，可以随时设回之前的版本。
- 导出：下载当前版本的 HTML，或者复制给 AI 的改造指令。
Agent 生成的是独立的 HTML 预览，不会改动你的项目代码。生成的页面只在沙箱里显示，不运行脚本、不加载外部资源。
复制给 AI 的指令
在分析结果或 Agent 升级页选择目标工具（通用、Cursor、Claude Code）、框架和组件库，会生成一段可以直接粘贴的指令，内容包括：
- 改哪个区域，从什么改成什么；
- 为什么改，附术语库原文依据；
- 目标结构和具体要求，来自术语的「怎么跟 AI 说」；
- 选了组件库时，提示可以用哪个组件；
- 保留原有数据、文案、接口调用和视觉风格。
指令由模板拼接，不经过模型，措辞来自术语库和规则原文。没有采纳任何推荐时，会用全部推荐生成。
自定义 API Key
在 账户页 可以添加自己的模型服务。只支持 OpenAI 兼容接口（/chat/completions）。使用自己的 Key 时不消耗平台额度。
- 视觉模型：需要能看图片，用于整页分析、悬停 AI 识别和 Agent 复刻。
- 代码模型：用于效果预览、Agent 应用推荐和追加修改，选代码能力强的模型。
- 两个模型可以来自同一个 Key，也可以分别配置两个 Key。保存后点「测试」，会检查连通性和是否支持图片。
- 在「使用设置」里分别选择视觉任务和代码任务用哪个 Key，选「使用平台额度」则走平台模型。
常见服务商的 Base URL 示例（模型名以服务商文档为准）：
| 服务商 | Base URL | 说明 |
|---|---|---|
| 通义千问（阿里云百炼） | https://dashscope.aliyuncs.com/compatible-mode/v1 | 有视觉模型和代码模型 |
| 智谱 | https://open.bigmodel.cn/api/paas/v4 | 有视觉模型和代码模型 |
| 火山方舟（豆包） | https://ark.cn-beijing.volces.com/api/v3 | 模型名通常填推理接入点 ID |
| Kimi（月之暗面） | https://api.moonshot.cn/v1 | 有支持图片的模型 |
| DeepSeek | https://api.deepseek.com | 不支持图片，只能当代码模型 |
Key 加密保存，界面只显示掩码，不会回传明文。你可以随时编辑或删除。