AgileShot

深色模式

更新日志 ​

本页记录 AgileShot 已正式发布的版本。安装 v0.3.0 及以上即可享受应用内全自动更新，最新版始终可在下载页获取。

v1.3.0 · 2026-08-11 — 授权状态一眼可见，交互细节全面打磨 ​

这一版把「点了没反应」「框自己跳」这类别扭感逐个揪出来修掉：通知弹窗不再压住下面的按钮、 悬停自动框选在你手不动时绝不改变、历史面板每个动作都给明确反馈。同时设置窗口右上角加了 授权徽标，试用还剩几天一眼可见，点一下就能买。

✨ 新增 ​

  • 设置页授权徽标 — 设置窗口右上角显示当前授权状态（试用剩余 / 授权剩余 / 永久授权）， 点击直接打开购买弹窗。试用期不足 7 天转红提醒；已永久授权的只回一句致谢，不再推销。

⚡ 优化 ​

  • 悬停自动框选更稳 — 鼠标停着不动时，选区不会再因为后台元素识别返回而自己跳变： 你看到哪个框，单击拿到的就是哪个框。
  • 自动框不再多带阴影 — 识别到的候选一律裁进窗口真实可视边界，选区不再多出一圈 能透出桌面的半透明边。
  • 界面图标统一为矢量图标 — 收藏角标、问 AI 菜单、快捷键速查标题等不再用系统 emoji 字体渲染，任何机器上大小和配色都一致。

🐛 修复 ​

  • 通知弹窗不再挡住下方窗口的按钮 — 纯提示通知改为鼠标穿透。此前它固定压在屏幕右下角， 显示的几秒内底下窗口那片区域点击、悬停、光标全部失效。
  • 历史记录交互 — 复制按钮现在明确提示成功 / 失败 / 未选中（此前全静默）；收藏后按钮 变为「取消收藏」；在详情预览图上按住不再误拖整个窗口。
  • 关闭按钮悬停消失 — 快捷键速查、发现新版本两个窗口的关闭按钮，悬停时会变成看不见的 白色（标题栏样式表污染了子控件）。

v1.2.0 · 2026-08-05 — AI 操作看得见、你一动手它就让路 ​

这一版解决的是「AI 在我电脑上点来点去，我却不知道它在干嘛」——现在每一步都画在目标控件上； 你一碰鼠标键盘它就自动停下，停手再自己接着干。同时修掉一个会让人吃亏的安全问题： 弹窗遮罩下面的东西，以前 AI 是能「点中」的。

✨ 新增 ​

  • AI 操作可视提示：AI 自动操作时，在目标控件上实时画出高亮框和「这一步在干嘛」 （点击 / 输入 / 滚动 + 目标名），成功变绿、被拒变红，一眼看得出发生了什么。 纯坐标操作没有元素矩形，会降级成只显示标签。 输入类内容自动打码，只显示字数 —— 密码不会因为这个提示上屏。可在 设置 · MCP 关掉。
  • 你一动手，AI 就让路：检测到你正在用鼠标键盘时，AI 的自动操作立即暂停并显示提示， 你停手后自动恢复，不需要重新授权。与 Ctrl+Alt+Esc 急停是互补的两档 —— 那个是硬停（要回设置页重新授权），这个自己会恢复。让路窗口时长可配（默认 2.5 秒）。

🐛 修复 ​

  • 点击穿透遮罩：弹窗（模态遮罩、抽屉、浮层）下面的按钮和链接，以前会被直接「点中」 并回报成功 —— 表现为你让 AI 点「取消」，它却打开了下层你看不见的东西。 现在点击前会做落点命中测试，被遮挡就拒绝并点名遮挡者。
  • 关弹窗认不出「明白」类按钮：补齐了「明白 / 我知道了 / 知道了」等中文说法， 且改为优先关最上层弹窗（此前弹窗叠弹窗时会去关下面那个）。
  • 网页首次枚举只看得到浏览器外壳：浏览器的无障碍树是懒构建的，首次查询拿不到网页内容， 现在会主动唤醒并重扫。

⚡ 优化 ​

  • 界面稳定检测快约 40%（静态界面 649ms → 385ms），AI 每一步的等待都更短。
  • 操作提示开销降到原来的 1/5（约 9ms → 1.9ms）：元素信息一次取齐，不再分三次跨进程问。

v1.1.0 · 2026-08-01 — 安装包瘦身回 15 MB、AI 可直接浏览截图历史 ​

这一版把「按需」和「看得见」两件事做扎实：91 MB 的本地识别引擎不再压在每个人的安装包里， AI 客户端能直接翻你的截图历史，打开目录时也不用再自己找刚截的那张。

✨ 新增 ​

  • 本地文字识别引擎改为「按需下载」：安装包从 86 MB 回到 15 MB。首次要用识字功能时， 在 设置 · 截图 · 文字识别 里点一次「下载引擎」，之后永久离线可用，也不需要 API Key。 引擎逐文件校验 SHA256，中途失败可断点续传；也支持从官方手动下载后指定目录。 （macOS 用系统自带的 Apple Vision，无需下载。）
  • AI 客户端可直接浏览截图历史：新增 MCP 资源通道，Claude Code / Cursor 等能直接看到最近的 截图（按时间倒序），不必再绕两次工具调用。资源读取与截图工具走同一道权限门控 —— 关掉「允许 AI 截图」后同样读不走。
  • 「文字识别」设置卡片：可选识别引擎（自动 / 仅本地 / 仅 AI），并写明了作用范围 —— 拖选复制文字固定用本地引擎（不联网、不耗 AI 额度）。

⚡ 优化 ​

  • 打开目录时自动选中最新的那张图：托盘「打开保存目录」、截图提示、历史面板「定位文件」 都会直接高亮目标文件，不用在上千张图里翻找。
  • 历史面板的「定位文件」此前只是打开所在目录、并不选中，与菜单名承诺的「定位」不符，现已修正。

🐛 修复 ​

  • 升级后版本号仍显示旧版：v1.0.0 装完仍自报 0.12.0 —— 打包时复用了陈旧的构建缓存， 而当时整条流程没有任何一步报错。现已加双重校验，并补上 Windows 版本资源， 右键程序 → 属性 → 详细信息 即可看到版本号。
  • AI 截图不再在图片目录无限堆积：保留最近 200 张，更旧的自动清理；只清理程序自己生成的 文件，且仍被历史引用的绝不删除。
  • 识别引擎设置对 MCP 的 OCR 工具真正生效：此前四个 OCR 工具硬编码走本地引擎，没装引擎的 用户即便配好了 AI Key 也一律报「本地 OCR 引擎未安装」。
  • 带参数启动（--settings）在已有实例运行时不再误弹截图取景框。
  • 删除历史记录时，程序内部持有的那份全尺寸副本会被一并回收（此前容量自动裁剪会静默泄漏磁盘）。
  • 外部 AI 客户端截的图会进历史面板并回传 id，「截图 → 标注 / 钉图」链路不再断裂。
  • 截图统一按逻辑像素返回，高 DPI 屏上 AI 读到的坐标不再整体偏移。

v1.0.0 · 2026-07-28 — AI 桌面操作走向可用：元素优先、后台隔离、规则可注入 ​

首个 1.0 版本。把「让 AI 操作桌面」从能跑通推进到可靠可用：不再靠猜像素坐标， 能在完全不打扰你的隔离桌面里干活，并且能把正确用法直接写进 AI 的记忆。

✨ 新增 ​

  • 🖥️ 后台隔离模式 — AI 可在一个独立的隐藏桌面里启动并操作软件：看界面 / 枚举元素 / 点击 / 填值 / 滚动 / 识字 / 按键闭环，全程不碰你的鼠标、键盘和焦点。已在 Win32（字符映射表）、WinUI（Win11 记事本）、Chromium（Chrome 网页表单）三类程序上实测通过。托盘会显示「后台模式运行中」，你随时可以不依赖 AI 亲手停掉。
  • 📝 「AI 使用规则」一键写入 — 把 AgileShot 的正确用法写进 Claude Code 的 CLAUDE.md / Codex 的 AGENTS.md，让接进来的 AI 真正会用。写入前可与现有文件左右对照，只替换托管标记内部、不动你自己攒的规则，并自动备份。
  • 🐧 Linux 构建产物（x86_64，自包含 tar.gz，未签名）；macOS 为 Developer ID 签名 + 公证版本。

⚡ 优化 ​

  • 🎯 能用元素就绝不猜坐标 — 点击 / 滚动 / 输入优先走界面元素（UI Automation），成功与否是确定的且不移动鼠标；元素够不着时（Electron / Canvas / 自绘 / 网页）用文字识别（OCR）定位，浏览器网页表单也能填。
  • 🖱️ 坐标兜底会把鼠标放回原处 — AI 借用光标后自动还原；若你中途动了鼠标，则不与你争抢指针。
  • 🔍 截图帧新鲜度自评 — 遇到疑似丢帧会明确提示，不再把丢帧误当成「界面是空的」。

🐛 修复 ​

  • 修复本地 OCR 只有第一次能用（超时后引擎未回收导致后续全部失败）。
  • 修复高 DPI 屏上点击坐标整体偏移 — 元素列表曾输出物理像素，在缩放显示器上会脱靶。
  • 修复截图偶发纯白 / 半截帧被当作正常图返回。
  • 修复近黑帧要白等 660ms 才走兜底的延迟。

v0.12.0 · 2026-07-19 — MCP 桌面操作 + 更新流程叙事 + 授权提示 + 全面 UI 精致化 ​

✨ 新增 ​

  • 🖱️ MCP computer-use（23 个 AI 桌面操作工具） — 把「绕遮挡截图 / UIA 元素级枚举与键鼠 / OCR / 窗口激活」等能力以受控方式暴露给外部 AI 客户端（Claude Code / Cursor 等），全程本地门控 + 审计、凭据不外泄，让 AI 能看屏幕、点按钮、填输入。
  • 🔄 版本徽标「当前版 → 新版」箭头叙事 — 设置右上角版本徽标一体化呈现「当前版本 → 新版本」升级流程（可更新 / 下载中 / 待重启各态清晰）；点「重启更新」前先弹窗展示更新内容并二次确认，不再直接静默安装。
  • 🔑 授权过期首页提示 — AI 功能授权过期时，设置「通用」页顶部醒目提示（AI 类功能已停用、基础功能不受影响）+ 一键「去授权」；随授权状态实时显隐，不必进授权页才发现。

⚡ 优化 ​

  • 🎨 全面 UI 精致化 — 设置页取消 / 应用 / 确定按钮三级视觉层次重做，下拉框弹出列表圆角项 + 项间距，全应用界面文字去除冗余加粗，更清爽统一；沿用暖炭灰 + 品牌橙设计语言。
  • 🚀 消除截图 / 贴图卡顿 — PNG 编码异步化 + 写库节流，冷启动还原钉图与 MCP 自检移出主线程，操作更跟手。
  • 🍎 macOS 版签名 + 公证 — 加入 Developer ID 代码签名 + 公证，用户双击即开，不再需要「右键 → 打开」绕 Gatekeeper；Windows 主程序 + MCP sidecar + 安装包均已签名。

v0.11.0 · 2026-07-06 — 屏幕批注 + 二维码识别 + macOS(beta) ​

✨ 新增 ​

  • 🎨 屏幕批注（ZoomIt / Epic Pen 式演示批注） — 全局热键（默认 Ctrl+F7）在桌面上直接用画笔 / 荧光笔 / 直线 / 箭头 / 矩形 / 椭圆 / 文字标注，讲解演示利器。配一条独立浮动工具条（选工具 / 颜色 / 粗细 / 撤销 / 清屏，可拖动）；默认「指针」态鼠标穿透、桌面照常用，选绘制工具才接管画布。文字可再次点选修改、滚轮或 ± 调字号。
  • 🔳 二维码 / 条码无感识别 — 钉图或截图里检测到二维码 / 条码时，角落自动浮出小徽标（ZXing 本地解码，免联网 / 免 Key）；点击直接打开链接或复制内容，多码弹菜单逐项选，无码则不打扰。
  • 🍎 macOS 版（beta · 实验性） — 首次提供 Apple Silicon（arm64）DMG。截图 / 钉图 / 标注 / 录屏 / 本地 OCR（Apple Vision）/ 全局热键 / AI 元素自动化等已移植并通过 CI 编译 + 打包验证，但尚未经充分真机测试，个别功能可能异常。首用需在「系统设置 → 隐私与安全性」授予屏幕录制 / 辅助功能权限；DMG 未签名，首启请右键 → 打开绕过 Gatekeeper。欢迎反馈问题。

🐛 修复 ​

  • 🔌 以管理员身份运行后 MCP 全部工具误报 [need_gui] — 提权后主实例的 MCP 桥命名管道默认拒绝低权限 sidecar 访问，导致外部 AI 客户端每次调用都被误判「主程序未运行」；已放开管道 DACL（WorldAccessOption），MCP 恢复可用。
  • 🤖 AI 聊天模型留空导致部分第三方 provider 报 400 — 模型为空时自动回退到预设首个模型。

v0.10.0 · 2026-06-30 — 竖屏截图修复 + 可配置全局热键 ​

✨ 新增 ​

  • ⌨️ 快捷键速查升级为可配置的全局热键 — 可在设置里自定义截图 / 录制等全局快捷键，不再是固定速查表。

🐛 修复 ​

  • 🖥️ 竖屏（旋转显示器）截图被截成横屏 — 旋转屏抓图此前未按显示器朝向旋回，导致竖屏被截成横向；现已按屏幕旋转校正（竖屏正常出竖图，DPI 缩放也随之修正）。

v0.9.1 · 2026-06-25 — 图片查看器恒深 + 录制 / 单实例修复 ​

🐛 修复 ​

  • 🎨 图片查看器不再跟随主题 — 亮色模式下查看器整体变白的问题已修，恢复一致的深色看图界面。
  • 🎬 修复录制控制条可能被录进画面、全屏录制时控制条留在屏内可见。
  • 🪟 修复提权后单实例失效导致的重复多开（双击图片多开）。

⚡ 优化 ​

  • 🎚️ 圈选美化工具栏按钮 / 滑块宽度对齐，展开收起不再跳动。

v0.9.0 · 2026-06-20 — 无感选字 + 本地 OCR 提速 + GIF 不限时长 ​

✨ 新增 ​

  • 🔤 截图 / 钉图「无感选字」 — 鼠标拖选图上文字即自动本地识别并复制（本地 OCR，免 API Key、免联网）；支持行内只选一部分、选中高亮保留；右键可选「本地识别 / AI 识别」。
  • 🎬 GIF 录制不限时长 + 多段剪辑 / 预览播放 / 选区拖动重做剪辑；复制文字提示显示内容预览（带字数 + 一行内容）。

⚡ 优化 ​

  • 🚀 本地 OCR 改常驻引擎（模型只加载一次），识别更快；多张钉图 / 连续识别并发，不再互报「已有任务进行中」。
  • 🎨 亮 / 暗主题统一（图片查看器跟随、画面区恒深）；钉图首次识别时显示「识别文字中…」指示器。

🐛 修复 ​

  • 🩹 滚动长截图三连修（接缝避开文字 + 收尾补帧防尾部丢失 / 重复）。
  • 🩹 选字「过短无法选」；托盘 / 帮助里「录屏 (GIF · 30 秒)」去掉已废除的 30 秒限制。

v0.8.2 · 2026-06-18 — 修复安装后无法启动 / MCP 不可用 ​

🐛 修复 ​

  • 🩹 修复部分电脑安装后启动报「找不到 libcrypto-1_1-x64.dll」无法运行 — 安装包此前漏带了 OpenSSL 运行库（主程序 license 验签直接依赖），干净电脑一启动就崩；现已随包携带
  • 🔌 修复安装版缺少 MCP 后台组件导致 MCP 接入不可用 — 同一打包缺陷把 MCP sidecar 也漏在包外，装好的版本接入 AI 客户端连不上；现已随包携带

v0.8.1 · 2026-06-18 — MCP 接入可靠性修复 ​

🐛 修复 ​

  • 🧩 接入 MCP 前先校验后台组件是否真实存在 — agileshot-mcp 缺失（安装漏带 / 被杀软删）时直接提示重装，不再写出「看似已接入、实则连不上」的配置（此前会写一条指向不存在组件的接入项，客户端连接必失败，用户却以为已接入）
  • ✅ MCP 接入状态检测更准 — 组件文件缺失时正确显示「需重新接入」，避免误标「已接入 ✓」

v0.8.0 · 2026-06-16 — MCP 独立后台进程重构 + 单实例稳定性 ​

🔧 重构 ​

  • 🧩 MCP 服务拆为独立后台进程 agileshot-mcp — 协议层下沉为静态层，MCP 与主界面解耦；默认不再自动拉起主界面，按需启动，运行更稳定、更省资源

✨ 新增 ​

  • 🔌 设置·MCP 新增「GUI 未运行时自动拉起」开关 — 需要时一键允许 MCP 在主程序未运行时自动唤起界面；对已失效（客户端被删）的接入残留提供一键清理提示

🐛 修复 ​

  • 🪟 单实例兜底 — 多开 / 抢锁失败时不再多冒出一个窗口；抢锁失败者转发退出而非误当主实例
  • 🔗 修复 MCP 桥接「持单实例锁却没建桥」导致的偶发无响应

v0.7.0 · 2026-06-14 — 全新暖炭灰 + 品牌橙界面 ​

🎨 界面焕新 ​

  • 🟧 全面视觉改造 — 编辑器、贴图窗、滚动截图 HUD、录屏指示器，以及设置 / 关于 / 更新 / 速查 / AI 对话等对话框，统一到「暖炭灰 + 品牌橙」设计语言，告别冷灰杂色，更精致耐看
  • ✨ 截图工具栏悬停高亮更明显 — 鼠标扫过工具即有清晰的中性灰高亮反馈，与「已选中工具」的品牌橙泾渭分明
  • 🔤 设置窗中文字体恢复清晰 — 关闭半透明背景恢复 ClearType 渲染，小字不再发虚（圆角交给 Win11 DWM 原生渲染）
  • 🗂️ 设置页表单卡片化重构（通用 / 截图 / 钉图 / 隐私），结构更清晰

🐛 修复 ​

  • 🖼️ 修复用「打开方式 / 双击」看图反而弹出截图框 — 开启「始终以管理员身份启动」时，提权重启丢失了图片路径参数，导致转发命令回落成区域截图；现在「看图」不再触发提权，直接打开查看器
  • 🔒 修复单实例抢锁竞态（抢锁失败者误当第二主实例）、MCP 桥接「持锁无桥」导致的偶发无响应

✨ 新增 ​

  • 🔌 MCP 一键接入更多客户端 — 支持 Codex / Cline / Zed / OpenCode，按各客户端配置格式分派

v0.6.0 · 2026-06-09 — 卡顿优化 + AI 标注引线气泡 ​

✨ 新增 ​

  • 💬 AI 智能标注新增「引线气泡」(callout) 形状 — AI 按场景判断每个元素用矩形框还是引线气泡：小图标 / 精确位置改用气泡 + 引线指向，比硬框更清晰；复用手动 Callout 工具渲染，视觉口径与手动标注一致

⚡ 性能优化 ​

  • 🚀 截图按「确定」更跟手 — 保存 / 历史落盘 / PNG 编码 / SHA256 全部移到后台线程，主线程只留复制剪贴板 + 弹缩略图；大图（4K / 跨屏）确定瞬间主线程阻塞从 100~300ms 降到约 10ms
  • 🖼️ 历史面板打开更快 — 缩略图改异步解码（QtConcurrent + QPixmapCache），首次打开不再逐张同步解码卡顿

v0.5.0 · 2026-06-05 — AI 鼠键自动化 + 多屏高 DPI 根治 ​

✨ 新增 ​

  • 🤖 AI 鼠键自动化大幅增强 — 支持文字输入、启动程序 / 激活已有实例；坐标点击新增 origin:active_window 锚点（多屏下不再点错屏）
  • 🔌 MCP 转发架构 McpBridge — --mcp-server 独立进程的钉图 / 历史 / 授权状态转发到主实例，修跨进程状态失效
  • 💬 AI 对话体验 — 新增「复制全部对话」、矢量图标精修；AI 配置档可跨应用分享 / 粘贴导入；模型预设更新至 Claude Opus 4.8
  • 📌 F7 渐进式钉图扩展至六级，历史钉图按 DPR 还原

🐛 修复 ​

  • 🖥️ 多屏混合 DPI 根治 — 窗口物理像素→逻辑像素换算改用 GetDpiForWindow，根治高 DPI 下坐标点击全偏、副屏坐标偏移 + 截图全黑
  • 🖌️ 模糊 / 马赛克工具改为画笔笔触 — 由「矩形圈选一次性糊整块」改为沿鼠标轨迹涂抹，可用工具栏「线粗」调节笔触大小（对标 Snipaste / PixPin 打码刷）
  • ⚙️ 修复开机自启动失效（共享 config 致 Run 项卡死）、生产版托盘误显开发角标、F7 钉图回原位被「消费一次」

v0.4.0 · 2026-06-02 — 集成图片查看器 ​

✨ 新增 ​

  • 🖼️ 双模式图片查看器 — 双击图片 / 文件关联 / 历史记录打开，「查看」「编辑」一窗切换
  • 🔍 看图操作 — 缩放（−/+/适应/1:1/滚轮锚点/双击）、平移、左右两侧悬浮上一张 / 下一张
  • 🎞️ 缩略图胶片条 — 底部一排缩略图，当前张橙色高亮，点选跳转（后台解码不卡）
  • ⬅️➡️ 同目录 / 历史列表导航 — ←/→/Home/End 翻图
  • 🛠️ 看改一体 — 一键进编辑态复用 11 个标注工具 + 撤销栈 + AI（OCR / 翻译 / 问图）
  • 🪟 所有无边框弹窗统一 Win11 原生圆角（历史 / 查看器 / 设置 / 关于）

🐛 修复 ​

  • 桌面快捷方式无图标（exe 嵌入图标资源）
  • 多屏拖动查看器错乱（显式居中到光标屏 + 跨屏 reflow）
  • 历史单击卡顿（详情预览改按尺寸解码，不再全分辨率解码大图）

🔄 变更 ​

  • 历史记录「钉」改名「收藏」，与「钉图＝贴桌面」区分
  • 历史点图打开查看器后不再自动关闭面板；查看器钉图后不再关闭（由用户手动关）

v0.3.0 · 2026-05-31 — 应用内自动更新 ​

✨ 新增 ​

  • 🔄 应用内自动更新 — 发现新版本后后台静默下载安装包到临时目录，下载完成弹 Toast 提示
  • 🔔 托盘「检查更新」动态文字 — 随更新状态机切换：检查更新 / 正在检查更新… / 下载更新中 X% / 重启更新 ✓ / 正在安装…
  • ⚡ 一键重启更新 — 下载就绪后托盘点「重启更新」→ NSIS 静默安装（自动关旧实例）+ 装完自动拉起新版本
  • ☁️ 更新端点接入 Cloudflare R2 公开桶

💡 安装 v0.3.0 即可享受后续版本的全自动更新（更早版本仅能检测、需跳浏览器手动下载）。

早期版本 ​

版本日期说明
v0.2.02026-05-30首个公开版本（仅 Windows）— 一次性交付 24 项对标 PixPin / Snipaste 招牌体验 + AI / MCP 独占能力
v0.1.02026-05-17内部 Demo — 全局热键截图 / 覆盖层选区 / 11 标注工具 / 钉图 / 托盘 / 多屏高 DPI 框架打通

路线图 ​

版本状态重点
v1.0✅ 已发布AI 桌面操作走向可用（元素优先 / 后台隔离 / 规则可注入）；三平台均有产物
后续⏳ 计划macOS / Linux 真机功能验证与打磨（当前两者仅保证构建与签名，功能未在真机充分验证）
后续⏳ 计划崩溃上报（Sentry）+ 插件市场 + 图床上传
后续⏳ 计划更多 AI 工具链

最后更新:

让 AI 看到你的屏幕 · 让标注更有温度

© 2026 AgileShot