EditHere 0.9.9

本次更新新增 Linux x86_64 预览实现，统一批注图片的展示比例，并改进 Windows 更新流程与设置保留。

Linux 预览（x86_64）

• 新增 Linux 实现：X11 / Wayland 截图与全局快捷键、XDG 开机启动、AT-SPI 元素识别、Tesseract 文字识别，以及命令行工具、AppImage 打包与 Linux 持续集成。
• 复用 Qt、桌面 Portal、AT-SPI、Tesseract 与 linuxdeploy，不额外引入运行时依赖。
• 本版 Linux 为预览：目标环境为 Ubuntu 24.04 x86_64，其他发行版与 ARM64 尚未验证。
• Wayland 下截图先由系统完成授权与选区，再由应用审阅；系统不提供原始桌面坐标，因此不与桌面原生元素关联，交互与 Windows 不完全一致。
• 桌面不支持全局快捷键 Portal 时，可在系统快捷键中绑定 AppImage 完整路径与 --capture；无托盘宿主时保留编辑窗口入口，关闭窗口即退出。
• 文字识别使用本机已安装的 Tesseract，不联网、不上传，需自行安装引擎与语言包。
• 提供 AppImage、配套命令行脚本与 SHA-256 校验文件；更新通过发布页手动下载。

批注图片比例

• 复制与导出的批注图片采用统一图片展示宽度：相同宽高比、相同相对位置的批注，其编号、文字与侧栏比例保持一致，不再随原图分辨率变化；不同宽高比保留各自比例。
• 项目原图与批注坐标保持原有精度与位置。

Windows 更新

• 安装版与免安装版共用 NSIS 更新流程。
• 更新前确认未保存的编辑；取消更新或安装器启动失败时保留当前程序。
• 下载使用独立临时目录与原子写入，强制校验 SHA-256，并补充超时、写入失败与启动失败处理。
• 安装先准备完整的新目录再切换，切换失败时恢复原有目录并保留备份。
• 检查更新时命令行工具无响应则改用公开接口；安装前的进程检查限定在目标目录内。
• macOS 与缺少兼容更新包的版本通过发布页手动下载。

设置

• 保存设置不再重置截图的圆角、阴影与边框。
• 升级保留开机启动设置与 PATH 选择。

反馈渠道

• 新增反馈用 QQ 群 1018416966，入口位于「关于与更新」页面与项目主页；加群时请说明来自 GitHub。

Full Changelog: v0.9.8...v0.9.9

EditHere 0.9.8

本次更新修复命令行工具无法连接桌面程序的问题，并修正随包交付的 AI 与命令行文档、配套 skill 和 JSON schema。

反馈格式说明

• 点批注为零面积区域：指向某一点的修改意见在反馈 JSON 中表示为 x1 与 x2 相等、y1 与 y2 相等的零面积区域；AI 与命令行文档、配套 skill 写明按点处理，不当作没有位置的意见丢弃。
• 写明 schema 目录的对应关系：当前精简反馈为 feedback-minimal.schema.json，feedback-v1 / v1.1 / v2 描述的是早期项目文档，feedback-v0.7.schema.json 是可继续导入的旧反馈格式。
• 连接器说明与安装配置文档指向当前反馈格式。

项目与反馈 schema

• 接受"手动切分"区域的原始范围：这类区域在创建时记录成员的原始位置，之后移除成员也不会移动；schema 此前要求该字段为空，按它校验程序自己导出的项目会被判为非法。
• 完整项目与精简反馈的导出都纳入 schema 校验。

修复

• 修复命令行工具连不上正在运行的桌面程序的问题：命令行此前按自己的程序名推算通信端点，与桌面程序使用的名字不同，status 一直显示未运行，open、capture、annotate 报超时。附带效果是从 0.9.6、0.9.7 升级后，桌面程序不必重启，新命令行即可连上当前运行的实例。
• 修复关闭截图窗口时，仍在进行的元素探测可能让程序崩溃的问题。
• 修复批注窗口底部工具条里带文字的按钮文字被截断的问题。
• 修复公开 schema 比程序更严、拒绝程序自己导出的项目文件的问题。

Full Changelog: v0.9.7...v0.9.8

EditHere 0.9.7

批注与组件调整

• 移动在发生时即成为批注：组件调整中挪动一个组件，批注列表同时出现对应的一条，编号与画面上的箭头一致，位置按发生顺序排列，之后补写文字不改变它。
• 移动批注可以没有文字，未写文字时同样计入批注条数与导出结果，点开即可补写。
• 组件移回原位后，没有文字的移动批注一并移除；已写过文字的批注保留。

反馈导出

• 复制 JSON 文件：把反馈 JSON 写入临时文件并复制该文件，包含完整原图，适用于可以直接发送文件的 Agent。
• 复制 JSON 内容：复制反馈 JSON 文本，包含完整原图，适用于只能粘贴文字的 Agent。
• 「查看 JSON」窗口同时提供上述两项，并保留「保存 JSON 与图片」。
• 批注窗口与工具栏新增**「无法使用？」**，列出发送文件被截断、仅支持对话等情形的处理办法。

截图与窗口

• 默认截图快捷键改为 Alt + Shift + 2；已有设置保持不变，可在设置中修改。
• 截图后恢复此前的窗口：取消、复制或保存截图后，把前台交还给截图前正在使用的窗口。
• 托盘入口仍然先关闭自身菜单与系统弹层，再采集画面。

修复

• 修复移动批注总是排在批注列表末尾的问题：移动批注在发生时建立，可与文字批注交错排列。
• 修复快捷键截图后原窗口失去前台的问题。

Full Changelog: v0.9.6...v0.9.7

EditHere 0.9.6

截图流程：选区确认与工具条

• 松开鼠标后进入选区确认：截图完成后先固定选区，工具条出现在选区旁；批注、复制、贴图、识别、取色等操作均由工具条入口，回车直接进入批注。
• 工具条包含批注、文字识别、贴图、保存图片、复制图像，以及尺寸、比例、历史与「更多」。
• 选区右侧样式列提供圆角、阴影 / 边框、重置：圆角与阴影通过滑块调整，效果在选区上实时预览；勾选「每次截图都设置」可将当前样式保存为默认值。
• 选区支持后续调整：区域内拖动为移动，拖角为缩放，区域外拖动为重新框选；方向键移动鼠标指针（放大镜同步跟随，用于像素级对齐），按住 Shift / Ctrl 调整对应方向的边。
• 支持锁定 1:1、4:3、3:2、16:9、9:16 等比例（含自定义，如 21:9），也支持直接输入精确宽高。
• 取色：按 C 进入，放大镜跟随指针实时读取颜色，支持 RGB / HEX / HSV / HSL 四种格式，Shift 循环切换；按 C 或 Ctrl+C 复制颜色值，Esc 退出。
• 文字识别：识别结果逐行列出，单击某行高亮其在图中的位置；支持复制全部或仅复制选中行，也支持切换语言重新识别。使用系统内置识别能力，不联网、不上传。
• 贴图（置顶）：贴图落在原截图所在位置而非屏幕居中；支持拖动、滚轮缩放、按 0 适应屏幕；右键菜单首项为批注，Ctrl+C 复制，双击或 Esc 关闭，支持同时置顶多张。
• 置顶图激活状态指示：当前操作的置顶图阴影为蓝色，点击其他窗口后转为灰色；关闭阴影时不显示任何颜色。
• 圆角、边框与阴影：三者在选区上所见即所得，复制、保存、贴图、识别输出均为包含上述效果的成品图。阴影默认开启，由「强度」滑块控制（0–100），颜色采用界面强调色。
• 最近 20 张截图与 10 个选区跨会话保留，按 H 可从历史记录中直接打开。

置顶图片：边缘缩放、旋转与透明度

• 边缘拖拽缩放：指针移至图片边缘或四角时显示对应缩放光标，拖拽即可调整尺寸；缩放过程中图片实时跟随，后续滚轮缩放从当前尺寸继续。
• 右键菜单新增：旋转（左 / 右 90°、水平翻转、垂直翻转）、透明度（100% / 75% / 50% / 25% / 10%）、阴影（随时开关）。
• 置顶图片的边缘由阴影标示，不额外描线：关闭阴影后图片不带任何边框，与同色桌面背景融为一体；可拖动的边缘仍然存在，仅不显示。

空批注窗口与关闭确认

• 托盘菜单新增「新建批注（空窗口）」：打开一个不含图片的批注窗口，无需先截图。窗口中央提示「可直接拖入或粘贴图片」，下方为「导入图片或项目」按钮：把图片拖进窗口、按 Ctrl + V 粘贴，或点击按钮从文件里选择，三种方式都能开始批注。
• 托盘菜单精简为：截图、新建批注（空窗口）、打开图片或项目；移除「恢复批注窗口」与「粘贴图片」两项。
• 关闭批注窗口的保存确认新增「不再提醒，可在设置中修改」：勾选后关闭窗口时直接放弃未保存修改，不再弹窗；可在设置 → 默认中通过「关闭批注窗口时询问是否保存」重新启用。

修复

• 修复截图时整屏发虚：高分屏下整屏画面不再经压缩后重新放大，清晰度与屏幕一致。
• 阴影仅在置顶图片上绘制：截图窗口不再绘制阴影。
• 放大镜与取色常驻：选区确认后，指针位于选区内时放大镜与颜色读数持续显示，四种颜色格式随时可读，无需先按 C。
• 放大镜放大屏幕所见内容（含识别框与暗化区域）；面板更紧凑、倍率更高，并自动避让工具条与样式列。
• 修复方向键失灵或偏移、方向键微调时选中区域缩小、滚轮选定的大区域在鼠标移动后回退为小区域等问题。
• 置顶图片不再绘制边框：边缘一律由阴影标示，不再在阴影外侧多出一圈实线。
• 修复缺少界面字体的电脑上数字显示为异常符号的问题：界面字体改为在运行时从系统已安装字体中解析，候选字体均缺失时交给系统默认字体，不再按名称直接指定。
• 修复进入截图模式后的卡顿：移除鼠标移动时的重复计算，大选区拖动性能显著提升。

完整变更记录：v0.9.4...v0.9.6

EditHere 0.9.5

0.9.5

界面语言：简体中文与英文，切换即时生效

• 新增「界面语言」设置：跟随系统 / 简体中文 / English，在「设置 → 外观」里选。中文系统默认是简体中文，其余默认是英文。
• 切换是实时的：改完立刻生效，编辑器、托盘菜单、设置窗口的文案马上跟着变，不需要重启；取消会回到打开设置时的语言。
• 「大爆炸」在英文界面里统一叫 Explode，与文档和快捷键说明里的叫法一致。
• 系统的文件对话框、消息框按钮、颜色选择器也一起跟随界面语言。此前中文界面下它们一直是英文，现在修好了。
• 英文界面的文案按整句翻译，不再是"前半句 + 后半句"拼出来的，所以不会出现多余或缺失的空格、读不通的句子。
• 切换语言不会影响导出给 AI 的 JSON：「色块区域」「整个图片」这类标签的值始终是中文，AI 拿到的字段不会随你的界面语言变化。

Full Changelog: v0.9.4...v0.9.5

EditHere 0.9.4

0.9.4 安装时不再要求手动退出 EditHere

• 安装或卸载时若 EditHere 正在运行，安装程序不再只弹一句提示然后中止：它会先请运行中的实例自己退出（未保存的批注仍走应用自身的"保存/放弃/取消"提示，窗口会自动浮到前台），随后轮询等待进程消失再继续写入文件。
• 等待有超时兜底：交互式安装先自动等 10 秒，仍无法退出才提示，并允许点「重试」继续等最多 60 秒；静默安装最多等 90 秒且不弹窗。窗口已被关闭但程序仍驻留托盘时，提示文案会明确说明这一点。
• 新增 EditHere.exe --quit：复用已有的单实例本地 socket，请运行中的实例走正常退出流程并报告结果（0 已退出、2 仍在运行）。该指令自 0.9.4 起提供，安装器只对 0.9.4 及以上版本所在的安装目录发起请求，避免旧版本把未知参数当作普通启动而触发截图。
• 修复静默安装（应用内「立即更新」）的竞态：应用在拉起安装器之后才退出，安装器可能先一步判定"程序正在运行"而静默中止，表现为程序关掉了、更新却没装上。

Full Changelog: v0.9.3...v0.9.4

EditHere 0.9.3

0.9.3 修复安装器编码 + 许可改为 MIT

修复安装器脚本编码导致的安装失败

• 修复安装/卸载时报"意外的标记 'Check'""Try 语句缺少自己的 Catch 或 Finally 块"而中断的问题：integrate.ps1 此前以不带 BOM 的 UTF-8 保存，Windows PowerShell 5.1 会按系统 ANSI 代码页解码，中文字符串吞掉闭合引号后整段脚本解析错位。现在脚本以带 BOM 的 UTF-8 保存，同批修正 package-windows.ps1。
• 该错误发生在解析阶段，安装器不会对注册表或环境变量产生任何改动；0.9.2 的 Windows 安装包受此影响，请改用 0.9.3 的安装包。

许可改为 MIT

• 原创代码与图标的许可由 PolyForm Noncommercial 1.0.0 改为 MIT License：在保留版权声明与许可文本的前提下，可免费使用、修改、分发、再许可和出售，包括用于商业目的与闭源集成。
• 0.9.2 及更早的已发布版本仍按其随附的 PolyForm Noncommercial 1.0.0 执行，不受本次变更追溯影响。
• COMMERCIAL-LICENSE.md 由"商业授权"改写为"商业合作与支持"：MIT 之下使用软件不再需要任何付费或授权，该文件只描述可选的优先支持、定制开发、联合开发与品牌合作。
• MCP 连接器与 Trae 插件的 license 字段同步改为 MIT。

Full Changelog: v0.9.2...v0.9.3

EditHere 0.9.2

0.9.2 修复免安装版自动更新

• 修复免安装版"立即更新"后版本不变的问题：便携 ZIP 此前把整个文件夹压进压缩包，更新脚本解压时新文件落入嵌套子目录，没有真正替换程序文件。现在压缩包内容平铺，解压后直接覆盖应用目录，Windows 手动"全部解压缩"仍会得到同名文件夹。
• 修复重复检查更新时报"校验失败：安装包已损坏或不完整"的问题：下载前先清理上次残留的更新包，避免新数据追加在旧文件之后导致校验失败。

Full Changelog: v0.9.1...v0.9.2

EditHere 0.9.1

0.9.1 发布链路修复

• 修复自动发布流程：适配 aqtinstall 的 MinGW 工具分类改名、CI 打安装包前自动安装 NSIS、修正安装脚本中无效的 LogicLib 条件宏。应用功能与 0.9.0 相同。
• 发行附件补充免安装版 ZIP 的 SHA256 校验文件，免安装版的"检查更新 → 立即更新"现在可以完成完整性校验并自动重启。

Full Changelog: v0.9.0...v0.9.1

EditHere 0.9.0

0.9.0 自动更新与大爆炸交互修复

• 修复大爆炸模式选中并移动一个块后其他块的引导线消失的问题。现在选中一个块时，其余块的蓝色引导框始终可见。
• 修复点击系统托盘图标截图时状态栏被截入的问题。截图前先发送 Escape 关闭托盘弹出面板，等待时间缩短回 200ms。
• 修复大爆炸模式嵌套块移动后不独立的问题。块被移出父组后立即脱离父组，父组移动时不再带动已移出的子块。
• 大爆炸模式支持 Ctrl+点击 多选：可同时选中多个块一起拖动或变换，选中框与控制点按多选区域绘制。
• 无文字标注的移动操作也会在标注栏生成"移动卡片"并编号展示，点击即可补充文字说明。
• 反馈 JSON 改为面向对象格式：每个对象统一记录 source、movements 与 annotations，AI 可直接关联同一对象的标注与移动；旧格式仍可导入。
• 新增可配置反馈 JSON 临时文件保存位置。在设置 → 默认行为中可自定义目录，留空时使用默认缓存目录。
• 新增应用内自动更新。检查更新后发现新版本时，点击"立即更新"自动下载安装包，校验 SHA256 后静默安装并重启。安装器版使用 NSIS 静默安装，免安装版使用 ZIP 解压覆盖，两种方式均支持自动重启。
• 修复 Windows 上窗口最大化时点击"全屏"按钮不生效的问题。
• 保存文件失败时提示具体的系统错误原因和目标路径，便于定位权限或占用问题。

Full Changelog: v0.8.22...v0.9.0