更新日志

记录每次更新的功能与改进

v1.6.0 2026.09.29

关联标注、Agent 接入能力、可靠性修复与界面质感打磨

  • ✨ 新增 图片模式支持关联两个元素：按住 Shift 依次选择两个元素，输入关系说明后可保存双目标标注，并在截图和结构化输出中保留双方定位。
  • ✨ 新增 Agent 接入更顺手：skill 改为一键安装（无需本地仓库），MCP 配置新增 Codex 分支。
  • ✨ 新增 新增本地 Agent 模式，可读取当前页标注、截图、创建标注和回写处理状态；当前需要本机 MarkIt 源码及支持 MCP 的 Agent。
  • 🔧 修复 修复扩展弹窗无法操作的问题（上一版本中弹窗里的站点开关、禁用列表都无法点击）。
  • 🔧 修复 同一页面开两个标签页标注时，不再互相覆盖：两边新加的标注都会保留下来。
  • 🔧 修复 页面里的嵌入内容（广告位、视频、第三方挂件）不再各自冒出一个 MarkIt 按钮；内容装在同源大框架里的页面也能正常出现工具栏。
  • 🔧 修复 暂停 MarkIt 后按快捷键不会再把网页卡住；重新启用后工具栏会自动回来，无需刷新页面。
  • 🔧 修复 单页应用切换路由后，标注不再停留在上一个页面的位置。
  • 🔧 修复 使用现代颜色写法的页面（如新版 Tailwind 的 oklch 配色）上，调整背景色不会再被改成白色。
  • 🔧 修复 截图不再把 MarkIt 自己的设置、帮助面板一起拍进去；复制出去的内容也不会夹带 HTML 代码。
  • 🔧 修复 图片标注尚未保存时，直接点「复制截图」也会把标注框、标题和描述带进图片；复制不会偷偷保存草稿，新安装默认保留已有标注。
  • ✨ 新增 设置中可查看标注占用和截图数量，并清理其他页面的历史截图；清理会保留标注文字与当前页面截图，且支持撤销。
  • ✨ 新增 带查询参数的文档页面可手动认领同路径的旧版标注；系统不会自动猜测，也不会移动其他路径或已绑定到其他文档的记录。
  • 🔧 修复 关联输入框空提交只在交互后报错；颜色与透明度输入的报错状态与视觉保持一致。
  • 🔧 修复 确认框支持点背景关闭，打开期间页面其余部分暂停交互，关闭后焦点回到原位。
  • 🔧 修复 设置面板按钮不再被宿主页面样式撑大，并整体收紧：选项 28px 高、色块与关闭按钮 24px。
  • 🔧 修复 工具栏垃圾桶改为"清空本页"：只清除当前页面的标注，其他页面的不受影响，误清支持撤销。
  • 🔧 修复 file:// 页面的权限提示只在真正缺权限时显示，已开启"允许访问文件网址"后不再误报。
  • 🔧 修复 样式调整预览不再弄脏页面自己的内联样式，关闭面板或取消后页面样式完整还原。
  • 🔧 修复 扩展更新后会明确提示刷新页面再标注，刷新前的新标注不再静默丢失。
  • 🔧 修复 元素定位更可靠：页面存在重复 id 时，不再把标注挂到第一个同名元素上。
  • ⚡ 优化 英文界面下复制与导出的任务书同样是英文；设置面板操作不再跳回顶部，滚动时高亮框与元素信息会跟随元素；鼠标在同一元素内移动时不再反复重建测量层。
  • ⚡ 优化 工具栏/表单/设置面板质感打磨：工具栏展开态改用圆角卡片，触发按钮加悬停缩放与键盘焦点环；标注表单输入统一字号行高与圆角；设置面板选项收紧到 28px 高、色块与关闭按钮 24px。
  • ⚡ 优化 滚动跟随更顺滑：滚动过程中只做轻量反馈，坐标重算留到滚动停稳后；提示 Toast 常驻可堆叠，每个都有明示关闭按钮。
  • ⚡ 优化 颜色选择器位置更聪明：支持的浏览器用声明式锚定，不支持的走原有钳位逻辑，行为一致。
v1.5.3 2026.09.19

中英双语 + 复制截图修复

  • ✨ 新增 界面与复制输出支持中英文切换，可在设置中选择语言。
  • 🔧 修复 修复图片模式「复制截图」失败的问题：压缩后的截图改为 PNG 写入剪贴板（Chrome 不支持写入 JPEG），复制后可直接粘贴到聊天窗口或文档。
  • 🔧 修复 文本模式复制后工具栏不再停在展开状态：面板复制、复制全部与浮层复制的收起行为保持一致。
v1.5.2 2026.09.18

定位与操作可靠性升级

  • ✨ 更新 模式名称统一为「文本模式 / 图片模式」，分别对应结构化页面反馈和截图标注。
  • ✨ 新增 结构化输出新增 XPath、稳定页面地址和元素恢复信息，页面刷新后更容易重新定位原元素。
  • 🔧 修复 标注按页面隔离，切换页面后不再加载其他页面的标注，并停止持久化整段原始 HTML。
  • 🔧 修复 复制、截图和导出只在操作成功后显示结果；失败时不再提前提示成功或写入已复制状态。
  • 🔧 修复 标注改由扩展自身存储保存：宿主页面的脚本读不到、也改不了标注内容，页面清理本地存储时标注不再跟着丢失。
  • 🔧 修复 同一站点不同页面的标注不再互相覆盖：在 A 页标注后到 B 页操作，A 页的标注会保留。
  • 🔧 修复 清空和导出改用应用内确认框，清空后仍可在提示中撤销；复制（文本与截图）直接执行，不再弹确认。
  • 📦 优化 复制与导出的内容不再包含 HTML 代码：目标元素只保留可读名称，定位交给 DOM 路径、XPath 与 CSS 选择器。
  • ✨ 新增 键盘可用：标注点与图片模式标签支持 Tab 聚焦、Enter / Space 打开，弹层焦点自动归位，取色弹窗的色板与色相、透明度滑块支持键盘操作。
  • 🔧 修复 页面识别保留有效查询参数：?id=1 与 ?id=2 不再共用同一份标注，跟踪参数与 token 类参数仍会被忽略。
  • 📦 优化 图片模式统一截取当前视口，并修正「整页截图」的表述；Markdown 导出可嵌入有效截图，纯文本复制不携带图片数据。
v1.5.1 2026.08.23

作者公众号入口 + 弹窗内标注修复

  • ✨ 新增 工具栏新增「公众号 @AI产品零度」入口，展开工具栏即可查看二维码与反馈交流说明。
  • 🔧 修复 修复标注面板在页面自带 alertdialog 弹窗中打开时按钮点不动的问题，面板现在挂载到正确的弹窗宿主。
v1.5.0 2026.07.28

品牌焕新 + 面板/输出全面加固

  • ✨ 更新 品牌焕新：名称更新为「圈选元素，自动生成 AI 修改指令」，突出 MarkIt 输出 Cursor、Claude Code 可直接执行的结构化指令，让「跟 AI 说清楚」的时间从十分钟降到几秒。
  • ✨ 新增 面板「复制不保存」：复制当前编辑中的标注后直接关闭面板，不新增、不渲染、不持久化，方便快速复用单条反馈。
  • 🔧 修复 修复标注工具栏与拖拽框被页面元素覆盖的问题，z-index 提升到浏览器上限（2147483647）。
  • 🔧 修复 修复面板内按钮被宿主页面 CSS 污染的问题：配置开关与按钮的尺寸、缩放、变换全部锁定，避免在样式复杂的页面上错位变形。
  • 🔧 修复 修复扩展更新后残留 UI 清理不彻底的问题，清理范围扩展至 toast、测量线、inspect 信息条等临时元素，并改用全量匹配防止重复注入。
  • 🔧 修复 修复元素 id 含特殊字符时 CSS 定位失效的问题，改用 CSS.escape() 转义。
  • 🔧 修复 修复事件在 iframe 内页面丢失的问题：标注相关事件监听从 document 提升到 window。
  • 🔧 修复 修复弹窗/抽屉识别不全：新增抽屉类面板识别，标注输出现在附带弹窗所在 DOM 路径，定位更准确。
  • 🔧 修复 修复禁用站点状态不一致的问题：不再兜底读取 localStorage，统一走 chrome.storage。
  • 📦 优化 输出格式重排：标准版改为「目标定位 / 已记录变更 / 处理要求 / 验收标准」，紧凑版改为多行结构化，直接贴合开发与 AI 指令消费场景。
  • 📦 优化 代码模块化重构：标注引擎、覆盖层、样式编辑器、工具栏、教程拆分为独立模块，配套 30+ 测试用例，稳定性显著提升。
v1.4.6 2026.07.08

事件隔离加固 + 面板定位修复

  • 🔧 修复 修复标注模式下页面下拉菜单、弹窗等组件被误触关闭的问题，所有标注相关事件（pointer、click、mouse、keyboard）改为 capture phase 执行。
  • 🔧 修复 修复标注面板自动聚焦会抢走页面已有输入框焦点的问题，现在会优先保留页面原有焦点状态。
  • 🔧 修复 修复在带 CSS transform 的容器中面板定位偏移的问题，新增视口偏移补偿计算。
  • 🔧 修复 修复快速切换标签页时 Service Worker 在控制台报 Unchecked runtime.lastError 的问题。
  • 📦 优化 焦点隔离扩展：新增对原生 focus/blur 事件的拦截，防止焦点移入 MarkIt UI 时触发页面监听器。
v1.4.5 2026.07.07

Chrome 商店评分引导

  • ✨ 新增 新增 Chrome 商店评分引导：用户完成第 3 次复制、导出或截图复制后展示评分提示。
  • 🔧 修复 修复工具栏展开时评分提示里的「去评分」按钮无法点击的问题。
  • 🔧 修复 修复无标注导出也会计入评分次数的问题，评分引导现在只统计成功完成的操作。
  • 📦 优化 优化「下次再说」行为：达到触发条件后会继续适度提示，直到用户评分或选择不再提示。
v1.4.2 2026.06.26

安全修复 + 颜色解析补全

  • 🔧 修复 修复 popup 禁用列表中 hostname 未转义直接注入 innerHTML 的 XSS 安全问题。
  • 🔧 修复 修复样式编辑器中 HSL 颜色值未转 RGB 导致输出错误颜色的问题，支持 hsl() / hsla() 完整解析。
  • 🔧 修复 修复输出模板引擎中 a 标签匹配正则过于严格，遗漏独立 a 标签的问题。
  • 🔧 修复 修复 #ffffff80 格式的 8 位 hex 颜色解析失败，新增 alpha 通道支持。
  • 🔧 修复 补上 changelog 页面缺失的移动端导航菜单按钮。
v1.4.1 2026.06.22

原型标注拖拽修复 + AI 助手输出优化

  • 🔧 修复 修复原型模式下拖动已保存标注标签后，偶发无法停止拖拽的问题。
  • 🔧 修复 优化标注标签拖拽释放逻辑，松开鼠标或触控取消时会正确保存位置、结束拖拽并释放指针捕获。
  • 📦 优化 优化「AI 助手」输出模板的说明与输出开头，强调目标元素、用户反馈、页面证据和验收标准。
  • 📦 优化 新手教程文案调整为更贴近页面反馈、Bug 反馈和验收意见整理场景。
v1.4.0 2026.06.19

智能输出模板引擎 + 事件隔离防御

  • ✨ 新增 智能输出模板引擎：支持 AI 助手 / Bug 报告 / PRD 验收三种模板，11 种意图规则自动识别（响应式溢出、间距过密过松、对齐错位、样式不一致、视觉对比弱、尺寸不当、文案修改、语气优化、交互缺陷、跳转异常、Bug 反馈），输出五层结构化任务包（目标定位 → 问题推断 → 修改建议 → 验收标准 → 证据链）
  • ✨ 新增 输出模板切换：设置面板和面板标题栏均可随时切换输出模板（AI / Bug / PRD），输出文本按模板差异化渲染，偏好持久化到 localStorage
  • 🔧 修复 事件边界隔离：16 种事件类型（pointer / mouse / click / focus / keyboard / input / composition / paste）在 7 个 MarkIt UI 根节点上 stopPropagation，防止标注面板、工具栏、弹窗等操作泄漏到宿主页面触发业务逻辑
  • 🔧 修复 焦点陷阱：focusin / focusout 在 window 捕获阶段拦截 MarkIt 元素焦点事件，避免宿主页面响应 MarkIt 内部焦点变化；Toast 通知增加独立事件隔离
  • 📦 优化 工具栏触发器 CSS 防御加固：关键属性加 !important 防御宿主 CSS 污染；display 切换为 grid + place-items:center 提升图标居中稳定性；新增 trigger-icon 独立样式类控制 SVG 尺寸；强制 box-sizing、appearance 等属性
  • 📦 优化 标注面板弹窗宿主自适应：检测 10+ 种弹窗选择器（role="dialog"、aria-modal、radix-dialog、ant-modal 等），面板自动 append 到正确的弹窗层
  • 📦 优化 输出逻辑重构：生成函数从手写三档 if-else 迁移到 task-output 模板引擎，按详略 × 模板类型组合渲染
  • 📦 优化 品牌标语升级：扩展名改为「网页标注与反馈，让 AI 看懂你的网页」；官网首页 mock 页面更新为 1.4.0 主题
v1.3.0 2026.06.17

标注面板升级 + 元素检查模式

  • ✨ 新增 元素检查模式（Hover Inspect）：激活后鼠标悬浮查看元素信息条，实时显示间距距离
  • ✨ 新增 间距测量：标注元素时自动采集 margin / padding / border / fontSize / lineHeight 等 CSS 指标
  • ✨ 新增 样式编辑器：可视化编辑 CSS 属性，支持按分组（排版 / 背景 / 边框等）展示属性名，全部走 i18n
  • ✨ 新增 文案编辑器：修改文本内容，输出包含新旧文本的 diff
  • ✨ 新增 差异弹窗输出：标注结果以弹窗展示，按标注类型（说明 / 样式 / 文案）分类型渲染，开发模式导出标签也已 i18n
  • ✨ 新增 右键菜单快捷标注：在任意元素上右键选择「用 MarkIt 标注此元素」，无需展开工具栏
  • ✨ 新增 特殊页面提示：访问 file:// 页面时图标显示「!」徽标并通知开启「允许访问文件网址」；PDF 页面提示标注功能不支持，截图功能可正常使用
  • 🔧 修复 测量叠加层定位：补偿页面滚动偏移，增加 border 层对齐
  • 🔧 修复 每次 pointermove 清除上一帧 inspect overlay，避免标签滞留
  • 🔧 修复 Annotation 类型补上缺失的 image 字段，修复 editTextArea 声明顺序
v1.2.2 2026.06.13

兼容性修复

  • 🔧 修复 部分网站上图标被挤压变形
  • 🔧 修复 弹窗标签页标题缺失
v1.2.1 2026.06.11

稳定性修复 + 教程体验优化

  • 🔧 修复 工具栏闪烁后无法激活：移除 MV3 下导致 service worker 终止时触发 UI 销毁重建循环的 runtime.connect 端口连接，改用惰性上下文失效检测
  • 🔧 修复 欢迎弹窗不居中：修正 tooltip 入场动画关键帧覆盖 transform 居中定位的问题
  • 🔧 修复 教程完成庆祝页文字不清：添加深色半透明背景和模糊效果，确保白色文字可读
  • 📦 优化 chrome.storage.local.get 调用添加 3 秒超时保护，防止回调不返回导致初始化挂起
  • 📦 优化 截图前检测扩展上下文有效性，失效时提示用户而非静默失败
v1.2.0 2026.06.09

交互式引导 + 体验优化

  • ✨ 新增 交互式引导教程：首次安装后自动在官网启动 5 步聚光灯引导（展开工具栏→了解模式→标注元素→编辑内容→复制导出），聚光灯遮罩阻断页面其他交互，仅允许操作当前步骤目标
  • ✨ 新增 帮助面板新增「不会用？点此学习」入口，支持随时重新唤起引导
  • 🔧 修复 同域名下切换页面标注数据泄漏，按页面路径隔离存储
  • 🔧 修复 innerHTML 渲染标注内容时的 XSS 转义防御
  • 🔧 修复 all_frames: true 导致多 iframe 工具栏状态分裂
  • 🔧 修复 扩展更新后旧 content script 不退出，同一页面出现多个工具栏实例
  • 🔧 修复 全局禁用/页面禁用后已渲染的标注残留不清除，且不监听 storage 变更立即响应
  • 🔧 修复 disableOnThisPage 禁用列表 localStorage 与 chrome.storage.local 存储不一致
  • 🔧 修复 原型模式截图后工具栏复制/截图按钮状态恢复边界情况
  • 🔧 修复 暂停 MarkIt 弹窗内图标深色主题下不可见
  • 📦 优化 清理 IntersectionObserver 无实用途逻辑及历史死代码
v1.1.0 2026.06.09

新增功能与优化

  • ✨ 新增 禁用入口：支持在网页禁用、全局禁用、隐藏直到下次访问
  • ✨ 新增 帮助文档入口：提供完整的使用指南和功能说明
  • ✨ 新增 原型模式支持上传图片，自动压缩，浏览器插件存储最多 5MB
  • 🔧 修复 修复了其他已知问题，提升稳定性
v1.0.0 2026.06.01

首次发布

  • ✨ 新增 开发模式：支持标注开发问题，生成包含 CSS 路径的结构化反馈
  • ✨ 新增 原型模式：支持原型评审，标注设计变更和交互问题
  • ✨ 新增 创建标注：单击元素快速标注，或拖拽框选多个元素
  • ✨ 新增 标注交互：点击查看详情、复制或删除，可拖拽重新定位
  • ✨ 新增 复制全部：一键复制所有标注的结构化文本
  • ✨ 新增 网页截图：原型模式下截取页面并下载
  • ✨ 新增 显示/隐藏：切换标注可见性，方便查看原始页面
  • ✨ 新增 清除全部：清除当前模式所有标注，需二次确认
  • ✨ 新增 设置：语言切换、颜色自定义、输出详细度、序号样式等
  • ✨ 新增 快捷键支持：⌘⇧M 切换工具栏，Esc 关闭弹窗