EditHere 项目保存与导出:.edithere 与反馈 JSON 一文看懂,新手也能选对导出方式

原创2026-11-01 22:27:541,339 阅读

EditHere 项目保存与导出:.edithere 与反馈 JSON 一文看懂,新手也能选对导出方式

EditHere 是一款截图批注工具:截图、写下意见、直接拖动组件,把「改哪里、怎么改」一次交给 AI。用它工作时,你会接触到两种文件——用来保存进度的 .edithere 项目文件,和用来交给 AI 的反馈 JSON。这篇指南带你一文看懂两者各存了什么、怎么保存、怎么选导出方式。

EditHere 完整工作流:AI 发起截图标注,你圈出位置写下意见,完成后反馈交还 AI

.edithere 项目:随时接着改的"存档"

.edithere 是 EditHere 的项目文件,相当于游戏的"存档"——它把你的工作现场完整保留下来,随时重新打开继续编辑。

一张游戏界面截图(修改前状态):左上角玩家面板、右侧小地图,可作为 .edithere 项目内嵌原图的示例

里面装了什么?

保存项目(Ctrl + S)会生成一个 .edithere 文件,它始终内嵌原图与切块缓存,包含四大块信息:

内容 说明
原图 截图本体直接嵌入文件,单文件即可完整打开,不依赖外部图片
批注 每条点、框、全局意见,含编号、文字、坐标
布局切块 组件被拖动前的原始位置与大小,保证还原
编辑状态 当前进行到一半的修改,重新打开直接恢复

当前格式版本为 3.0.0(schemaVersion: "3.0.0"),对应的结构定义见 project-v3.schema.json。

怎么保存、怎么重新打开?

  • 保存项目:按 Ctrl + S,选择位置即生成 .edithere 文件。
  • 重新打开:直接把 .edithere 文件拖进 EditHere 即可,原图、批注、布局一次性恢复。
  • 文件关联:Windows 上在新程序里保存一次项目,系统就会登记 .edithere 打开方式,之后双击文件直接打开(关联逻辑见 projectfiles.cpp)。
  • 关闭批注窗口时若有未保存的修改,程序会询问「是否先保存项目」。

💡 一句话记忆:.edithere 是给"你自己"的存档。

反馈 JSON:交给 AI 的"修改说明书"

如果说 .edithere 是存档,那反馈 JSON 就是交给 AI 的修改说明书。它不包含你的原始截图,只记录"意见 + 坐标 + 变化",体积小、AI 能直接执行。

面向对象的结构

打开 查看 JSON(Ctrl + E)即可预览。新版图片反馈采用 feedback-minimal-4 格式,核心是一个 objects 数组——每个对象用 kind 区分三类:

kind 对应操作 关键字段
point 点批注:精确指向某个像素 point: {x, y}
region 框批注:圈出某个范围 source(原图或调整后画面的矩形)
global 全局意见:针对整个画面 无空间字段

每个对象都带 annotations 数组,{number, text} 的编号与界面上看到的批注编号一一对应。

移动会被精确记录

当你用"大爆炸"把组件拖到新的位置,JSON 会为该组件增加 movement 字段,记录最终目标矩形和位移量——比"往左挪一点"精确得多:

同一游戏界面(大爆炸调整后的状态):HUD 面板位置发生变化,可示意 movement 记录的布局调整结果

图片的三种交付模式

image 字段描述原图如何交付,有三种模式(定义见 feedbackexport.h 中的 ImageExportMode):

模式 行为 适用场景
file(默认) JSON 与配套原图 PNG 一起交付 手动交接的默认方式
embedded 原图以 Base64 写入 image.dataUrl 需要单文件交付时
none 只带尺寸与校验值,不携带原图 接收方已有原图,如程序化调用

在 查看 JSON 窗口勾选"原图嵌入 JSON"即切换为 embedded。完整字段说明见 USER-GUIDE.md,格式定义见 feedback-minimal-v4.schema.json。

视频项目:JSON 带时间戳

视频标注的 .edithere 项目引用源视频地址(不内嵌整段视频),只保存已实际批注的帧截图。导出的 JSON 使用 video-feedback-1 容器:每帧在 feedback 里复用上面的图片结构,根对象再附上 timestampMs 与 frameId 索引。格式定义见 video-feedback-v1.schema.json,操作细节见 VIDEO-ANNOTATION.md。

视频标注:在两个时间点暂停批注,导出带时间戳的 JSON 反馈

两种文件怎么选?一张对照表

.edithere 项目 反馈 JSON
给谁用 给你自己 给 AI 或下游程序
存什么 原图 + 批注 + 布局 + 编辑状态(无损全量) 仅意见、坐标与变化(精简)
文件体积 较大(内嵌原图) 较小(默认不含原图)
能否继续编辑 能,重新打开接着改 可作为新输入导入再编辑
怎么得到 Ctrl + S Ctrl + E 后复制或保存
格式版本 3.0.0 feedback-minimal-4

实用建议:

  • 📌 还要继续改 → 先 Ctrl + S 存 .edithere;
  • 🤖 要交给 AI → 用 Ctrl + E 复制/保存 JSON,或直接点「完成并返回 AI」;
  • 🎬 视频走查 → 保存项目留底 + 导出 video-feedback-1 给 AI。

版本兼容:旧文件还能打开吗?

新程序遵循"新读旧"原则:可读取 1.0.0 / 1.1.0 / 2.0.0 旧项目、无版本反馈、v2 / v3 图片反馈与旧的并行数组格式;但旧程序不保证认识 v4 的 kind、movement、children 等新字段。版本决策细节见 FEEDBACK.md。

常见问题 FAQ

Q:关闭时忘了保存,修改还在吗? 不在。关闭窗口前会弹「是否先保存项目」;若勾选了「不再提醒,可在设置中修改」则会直接放弃。想恢复询问,去 设置 → 默认行为 勾回「关闭批注窗口时询问是否保存」。

Q:反馈 JSON 里为什么有时找不到原图? 因为默认是 file 模式——JSON 和 PNG 是一对文件,要一起拷贝。需要单文件交付就勾选「原图嵌入 JSON」改用 embedded 模式。

Q:.edithere 可以发给别人接着改吗? 可以。它内嵌原图,对方用新版 EditHere 打开即可看到完整的批注与布局状态。

Q:底部工具栏的复制按钮有什么区别? 「复制 JSON 内容」只复制 JSON 文本(默认不带原图);「复制 JSON 与图片」会把 JSON 和配套原图一起放进临时目录作为文件复制;「复制带批注图片」则复制一张画好编号和文字的图片,方便直接粘贴进聊天窗口。

格式与字段的完整定义可查阅 schema/ 目录,操作全貌见 使用指南 · 保存与导出。

登录后查看全文
EditHere