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에게 시작을 요청합니다. 호버링하면 UI 요소가 식별되고, 휠로 선택 영역을 확대/축소하며, 수동으로 상자를 드래그할 수도 있습니다.
주석 — 포인트, 상자, 전역 메모 또는 "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(텍스트 인식) — 선택한 영역을 줄 단위로 읽습니다. 줄을 클릭하면 이미지에서 강조 표시됩니다. OS 자체 엔진(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에서 직접 가져온 것이며 추가되거나 발명된 기능은 없습니다.