Inginnng/EditHere

EditHere — 截图、写下意见、直接调整布局，把修改意图一次交给 AI。

它是什么

EditHere（“改这里” — change here 的中文）是一款桌面工具，可将模糊的 UI 反馈转化为精确的 AI 视觉指令。无需输入“将按钮向左移动一点”，您可以圈选按钮、拖动它或在正确的帧暂停视频——EditHere 会将所有内容打包成一个 AI 可以执行的结构化文件。

它在 Windows、macOS 和 Linux 上本地运行，并且本身从不调用 AI 模型。它只准备反馈；任何 AI 工具（Codex、Claude Code 等）都可以使用它。

它解决的问题

当您要求 AI 更改界面时，用文字描述位置和程度既缓慢又容易出错。EditHere 消除了猜测：

位置 — 您点击确切位置，而不是描述它。
程度 — 您拖动/调整元素大小；EditHere 记录真实的之前/之后坐标。
多次编辑 — 每条评论都编号并与屏幕位置匹配。
视频/动画问题 — 在确切帧暂停、评论，导出包含时间戳和该帧的图像。

工作原理

捕获 — 按下全局热键（Alt + Shift + 2）或让 AI 启动。悬停可识别界面元素；滚轮缩放选区；您也可以手动拖动一个框。
评论 — 使用点、框、全局注释或“Explode”模式（见下文）。直接在图像上写下您的想法。
导出 — 一键生成 JSON 文件。它包含原始图像、每个带坐标的注释以及任何元素移动。
移交给 AI — 手动将 JSON 复制到任何聊天机器人中，或者（使用捆绑的 edithere-cli 和技能）AI 调用 edithere-cli annotate，等待，并在您点击 “完成并返回 AI” 时读取反馈。取消或超时不会提交未提交的编辑。

主要功能（来自 README）

智能截图 — 悬停捕获 UI 元素、手动框选、带像素坐标和颜色读数（RGB/HEX/HSV/HSL）的放大镜、固定宽高比（1:1、4:3、16:9、9:16、自定义）以及最近 20 次捕获的历史记录。
OCR（文本识别） — 所选区域逐行读取；单击一行会在图像上高亮显示。使用操作系统自带的引擎（Windows OCR / macOS Vision）— 离线，无上传，无新依赖。
长截图 — 选择滚动区域，工具会滚动并拼接一张长图，并带有实时缩略图。重复的固定标题只保留一次。
注释 — 点、框或全屏评论，每个都编号并映射到图像。一键导出 JSON。
“Explode”模式 — 将屏幕拆分为可移动组件。您可以拖动、缩放或输入精确坐标；每次移动都会成为记录之前/之后区域的注释。原始位置留空，以便 AI 知道必须有东西填充它。
视频注释 — 在任何帧暂停、评论，然后跳到另一个时间点。导出的 JSON 包含时间戳和帧捕获。
项目保存 — .edithere 文件存储原始图像、注释和编辑状态，因此您可以稍后重新打开并继续。
输入 — PNG / JPEG / WebP / BMP 图像和 MP4 / MOV / WebM 视频，可通过截图、打开对话框、拖放或粘贴。
本地优先 — 截图、元素检测、OCR 和编辑都在您的机器上完成。更新检查仅联系 GitHub/Gitee 获取版本信息（可以关闭）。

JSON 示例（来自 README）

导出的反馈如下所示（已裁剪）：

{
  "image": "data:image/png;base64,…",                     // 原始图像（可选）
  "annotationSpace": "result",
  "objects": [
    { "source": {"x1":1002,"y1":156,"x2":1464,"y2":384},
      "movements": [],
      "annotations": ["让转化率下降更突出，红色标签"] },
    { "source": {"x1":1760,"y1":50,"x2":1960,"y2":110},
      "movements": [{"to": {"x1":640,"y1":40,"x2":840,"y2":100}}],
      "annotations": ["将导出按钮移到标题旁边"] },
    { "source": null, "movements": [], "annotations": ["整体增加更多空白"] }
  ]
}

平台与安装

Windows 10 1809+ — 官方支持。安装程序 EXE（无需管理员权限）或便携式 ZIP。尚未代码签名；提供校验和。
macOS 14+ — 预览阶段，尚未公证。通用 DMG。
Linux x86_64 — 预览，针对 Ubuntu 24.04。AppImage。
README 还包含让 AI 工具（Codex、Claude Code）为您完成整个安装的提示。

许可证 — 重要

PolyForm Noncommercial 1.0.0 — 免费用于个人、教育、研究、慈善或政府用途（允许修改和重新分发，需附带许可证文本）。商业用途需要作者书面许可（联系 inginnng@163.com）。名称和徽标不在许可证范围内。

文档与联系

文档涵盖用户指南、CLI/代理集成、AI 辅助安装、视频注释格式、Linux 说明、构建/开发和变更日志。通过 GitHub issues 或 QQ 群 1018416966 提供反馈。

以上所有信息均直接取自项目 README；未添加或虚构任何功能。