EditHere 项目保存与导出:.edithere 与反馈 JSON 一文看懂,新手也能选对导出方式
EditHere 项目保存与导出:.edithere 与反馈 JSON 一文看懂,新手也能选对导出方式
EditHere 是一款截图批注工具:截图、写下意见、直接拖动组件,把「改哪里、怎么改」一次交给 AI。用它工作时,你会接触到两种文件——用来保存进度的 .edithere 项目文件,和用来交给 AI 的反馈 JSON。这篇指南带你一文看懂两者各存了什么、怎么保存、怎么选导出方式。
.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 字段,记录最终目标矩形和位移量——比"往左挪一点"精确得多:
图片的三种交付模式
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。
两种文件怎么选?一张对照表
.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/ 目录,操作全貌见 使用指南 · 保存与导出。



