EditHere 安全与隐私设计:本地优先、不上传画面与本地诊断日志

原创2026-11-01 18:36:131,633 阅读

EditHere 安全与隐私设计:本地优先、不上传画面与本地诊断日志

EditHere 是一款本地优先的截图与 AI 反馈标注工具:截图、元素识别、文字识别(OCR)和编辑全部在你的电脑上完成,程序本身不上传你的任何画面。本文带你逐条看懂 EditHere 的隐私设计,以及它的本地诊断日志如何做到「只记错误、不记内容」。

先问一句:截图工具会带走你的什么?

截图、标注工具天然会接触最敏感的数据——屏幕上的代码、聊天窗口、内部报表。判断一个工具是否可靠,可以问三个问题:

  1. 处理发生在本机还是服务器?
  2. 生成的文件(图片、批注)由谁决定发送?
  3. 日志里记录了什么?

EditHere 对这三个问题的答案分别是:本机、由你、只记运行状态。下面逐条展开。

本地优先:截图、OCR 与元素识别全程不联网

文字识别(OCR)使用系统自带引擎

框选区域即可识别文字,结果逐行列出并可复制。这一功能使用的是系统内置识别能力:

  • Windows:调用系统自带的 Windows OCR 引擎,通过内置 PowerShell 桥接(ocrbridge.ps1 + ocr.cpp)
  • macOS:直接调用 Vision 框架(ocr_mac.mm)
  • Linux:调用本机已安装的 Tesseract

不联网、不上传、不新增第三方依赖,图片不会被发到任何服务器。

EditHere 本地OCR文字识别:框选区域后逐行列出识别结果,全程本机完成,不上传画面

智能选块是本地图像分析

「悬停即识别界面元素」的功能结合系统公开的元素边界与本地图像分析寻找候选区域,属于启发式候选而非语义识别,同样不需要网络参与。

EditHere 截图标注工具:悬停选块、圈画意见,截图与元素识别均在本地完成

不内置模型:反馈是否外发,由你亲手决定

EditHere 本身不调用任何模型,它只负责把「改哪里、怎么改」整理成一份结构化 JSON 反馈(格式定义见 schema/,说明见 docs/FEEDBACK.md)。

EditHere 批注反馈:点、框、全局意见与布局拖动,导出结构化 JSON 交给任意 AI 工具

  • 手动:复制 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。

登录后查看全文
EditHere