EditHere 安全与隐私设计:本地优先、不上传画面与本地诊断日志
EditHere 安全与隐私设计:本地优先、不上传画面与本地诊断日志
EditHere 是一款本地优先的截图与 AI 反馈标注工具:截图、元素识别、文字识别(OCR)和编辑全部在你的电脑上完成,程序本身不上传你的任何画面。本文带你逐条看懂 EditHere 的隐私设计,以及它的本地诊断日志如何做到「只记错误、不记内容」。
先问一句:截图工具会带走你的什么?
截图、标注工具天然会接触最敏感的数据——屏幕上的代码、聊天窗口、内部报表。判断一个工具是否可靠,可以问三个问题:
- 处理发生在本机还是服务器?
- 生成的文件(图片、批注)由谁决定发送?
- 日志里记录了什么?
EditHere 对这三个问题的答案分别是:本机、由你、只记运行状态。下面逐条展开。
本地优先:截图、OCR 与元素识别全程不联网
文字识别(OCR)使用系统自带引擎
框选区域即可识别文字,结果逐行列出并可复制。这一功能使用的是系统内置识别能力:
- Windows:调用系统自带的 Windows OCR 引擎,通过内置 PowerShell 桥接(ocrbridge.ps1 + ocr.cpp)
- macOS:直接调用 Vision 框架(ocr_mac.mm)
- Linux:调用本机已安装的 Tesseract
不联网、不上传、不新增第三方依赖,图片不会被发到任何服务器。
智能选块是本地图像分析
「悬停即识别界面元素」的功能结合系统公开的元素边界与本地图像分析寻找候选区域,属于启发式候选而非语义识别,同样不需要网络参与。
不内置模型:反馈是否外发,由你亲手决定
EditHere 本身不调用任何模型,它只负责把「改哪里、怎么改」整理成一份结构化 JSON 反馈(格式定义见 schema/,说明见 docs/FEEDBACK.md)。
- 手动:复制 JSON 或 JSON+图片,粘贴给任意 AI——发不发、发给谁,由你决定。
- 自动:配合
edithere-cli与本地 AI 工具(Codex、Claude Code 等)时,程序只在本机通过 QLocalServer 的本地回环通道与 AI 工具通信,AI 读取的是你点击「完成并返回 AI」后确认的反馈;取消或超时不会把未提交的编辑当成修改要求。
也就是说,EditHere 不替你把画面交给任何云端,它只是把画面上的意图整理清楚。
本地诊断日志:只记错误,不记画面
当程序出问题(截图异常、窗口闪烁等),开发需要信息定位。EditHere 用一套独立的诊断日志模块(diagnostics.cpp、diagnostics.h)解决这个问题,并且刻意做了隐私约束:
| 记录的内容 | 不记录的内容 |
|---|---|
| 程序版本、系统与 Qt 运行环境 | 截图、视频、图片像素 |
| 截图尺寸、操作状态、错误码 | 批注文字、反馈正文 |
| 日志写入失败等自身状态 | 项目文件内容 |
几个关键细节(均可在 diagnostics.cpp 中核对):
- 脱敏:日志字符串会替换用户主目录为
<home>,URL 去掉查询参数与凭证,Bearer、password、token、cookie等值统一替换为[redacted]。 - 有界存储:每个日志文件默认上限 1 MiB,最多保留 10 个文件,自动轮换清理,不占用磁盘。
- 永不自动上传:日志仅保存在本机;你在「设置 → 诊断日志」(diagnosticspage.cpp)里点「导出诊断日志…」,才会在本机生成一份文本报告,是否随反馈发出仍由你决定。
- 导出报告时还会对旧日志二次过滤,并在报告头注明「本模块不采集截图或项目内容」。
对应的自动化测试见 diagnostics_test.cpp,覆盖脱敏、轮换与导出等场景;更完整的背景见 docs/REGRESSIONS.md 中「状态冲突排查与诊断日志」一节。
仅有的联网行为:版本更新检查
EditHere 默认在启动后异步检查一次更新(可在设置中关闭「启动时检查更新」)。检查过程(updatechecker.cpp)只请求发行版元数据——版本号与下载链接,不上传图片、批注、日志或任何个人设置。手动检查更新时行为相同。除此之外,程序没有其它网络请求;网页版预览服务(web/README.md)也只监听本机地址,不上传素材。
小结:把数据留在自己手里
- ✅ 截图、元素识别、OCR、编辑:本机完成,不联网
- ✅ 反馈 JSON 是否外发:由你或你接入的 AI 工具决定
- ✅ AI 接入走本机回环通道,确认后才交付反馈
- ✅ 诊断日志:只记运行状态,不记画面与批注,本地保存、手动导出
- ✅ 唯一联网行为:只查版本号的更新检查,且可关闭
对需要经常截图敏感界面的开发者来说,「本地优先 + 不上传画面」正是 EditHere 把隐私设计放在第一位的原因。更多使用说明见 docs/USER-GUIDE.md,构建与依赖说明见 docs/DEVELOPMENT.md。


