feat: 변환 안정성과 작업 흐름 개선
This commit is contained in:
parent
4c942cf00b
commit
24221361b2
160 changed files with 64218 additions and 796 deletions
39
README.md
39
README.md
|
|
@ -1,6 +1,6 @@
|
|||
# Everything2Everything
|
||||
|
||||
Windows 우클릭 한 방에 **모든 것을 모든 것으로** 양방향 변환. 이미지 ↔ 이미지, 이미지 ↔ PDF, 문서 ↔ PDF/이미지, HTML → PDF/이미지를 통합 매트릭스로 처리합니다.
|
||||
Windows용 파일 변환 프로그램. 이미지·문서·PDF·HTML·영상/오디오·표 데이터를 하나의 대기열에서 처리합니다. 지원 경로와 설치된 도구에 따라 사용 가능한 출력 형식이 달라집니다.
|
||||
|
||||
> 이 프로젝트는 단방향 *EverythingToJpeg* 에서 양방향 *Everything2Everything* 으로 피보팅된 결과물입니다.
|
||||
|
||||
|
|
@ -21,7 +21,21 @@ Windows 우클릭 한 방에 **모든 것을 모든 것으로** 양방향 변환
|
|||
| **DocxProvider** | DOCX · DOC | **PDF** + 이미지 7종 |
|
||||
| **HwpxProvider** | HWP · HWPX | **PDF** + 이미지 7종 |
|
||||
|
||||
총 200+ 변환 쌍 지원. 알파 채널은 출력 포맷이 지원할 때 자동 보존, 미지원이면 흰색(또는 설정된 배경색)으로 평탄화합니다.
|
||||
추가 Provider는 다음과 같습니다. 정확한 직접 변환 쌍은 각 Provider의 `SupportedConversions`가 기준이며, 그래프가 중간 형식을 거친 경로도 합성합니다.
|
||||
|
||||
| Provider | 범위 / 조건 |
|
||||
|---|---|
|
||||
| FfmpegProvider | 영상·오디오 변환과 오디오 추출. FFmpeg 필요 |
|
||||
| DataProvider | CSV·JSON·XLSX 평면 표 변환. 서식·수식 보존 편집기 아님 |
|
||||
| DocumentProvider | 문서 ↔ HTML/Markdown/TXT 및 텍스트 → DOCX. LibreOffice 필요 |
|
||||
| MarkdownProvider | HTML·Markdown·TXT 변환. 내장 엔진 |
|
||||
| VectorProvider | SVG → PNG/PDF 및 이미지 경유 변환 |
|
||||
| OcrProvider | 이미지/PDF → TXT. Windows OCR 언어팩 필요 |
|
||||
| PdfToolProvider | PDF 재압축. 서명·XFA·PDF/A 보존을 보장하지 않음 |
|
||||
| ImageOptimProvider | 같은 이미지 형식 재압축 |
|
||||
| LlmProvider | 텍스트 요약·번역·교정. 외부 AI 서비스 또는 설정된 Codex CLI 필요 |
|
||||
|
||||
알파 채널이 없는 출력은 배경색으로 평탄화됩니다. 형식 전환은 페이지·애니메이션·메타데이터·색상·문서 배치를 바꿀 수 있습니다. WebP 무손실과 메타데이터 보존 옵션을 별도로 확인하세요. 외부 AI 기능은 텍스트가 외부 서비스로 전송됩니다.
|
||||
|
||||
## 빠른 시작
|
||||
|
||||
|
|
@ -65,13 +79,15 @@ dotnet publish src\Everything2Everything.App\Everything2Everything.App.csproj `
|
|||
| `.docx` → PDF · JPEG · PNG · WebP · AVIF · TIFF · BMP · 변환… |
|
||||
| `.html` → PDF · JPEG · PNG · WebP · AVIF · TIFF · BMP · 변환… |
|
||||
|
||||
"변환…" 항목은 메인 창을 띄워 사이드바에서 출력 형식 ComboBox로 직접 선택할 수 있습니다.
|
||||
"변환…" 항목은 메인 창을 띄워 사이드바에서 출력 형식로 직접 선택할 수 있습니다.
|
||||
|
||||
#### 메인 창
|
||||
파일을 드래그 & 드롭하거나 Ctrl+O. 사이드바의 **TARGET FORMAT** ComboBox는 **큐의 모든 파일이 변환 가능한 출력의 교집합**만 보여줍니다 (이종 입력을 섞으면 자동 필터링).
|
||||
파일을 드래그 & 드롭하거나 **파일 추가**(Ctrl+O)를 사용합니다. **폴더 추가**는 선택한 폴더의 파일만 가져오며 하위 폴더는 포함하지 않습니다. 사이드바의 **출력 형식** 선택창는 **큐의 모든 파일이 변환 가능한 출력의 교집합**만 보여줍니다 (이종 입력을 섞으면 자동 필터링).
|
||||
|
||||
**단일 파일로 결합** 체크박스 — 출력이 PDF/TIFF/GIF이고 큐가 2개 이상의 이미지일 때 활성화. 큐의 모든 이미지를 단일 다중 페이지 파일로 결합합니다 (예: 스크린샷 5장 → 1개 PDF).
|
||||
|
||||
이력에서 결과 열기·오류 복사·원본 다시 추가와 **실패 다시 추가**를 사용할 수 있습니다. **내 프리셋**에서 옵션을 저장·적용하거나 가져오기/내보내기 합니다. 탐색기 메뉴는 화면의 등록/해제 버튼 또는 CLI로 관리합니다.
|
||||
|
||||
#### CLI
|
||||
|
||||
```powershell
|
||||
|
|
@ -131,9 +147,12 @@ dotnet publish src\Everything2Everything.App\Everything2Everything.App.csproj `
|
|||
| 키 | 동작 |
|
||||
|---|---|
|
||||
| Ctrl+O | 파일 추가 |
|
||||
| Ctrl+Enter | Process Queue (변환 시작) |
|
||||
| Esc | 창 닫기 |
|
||||
| Ctrl+Enter | 변환 시작 |
|
||||
| Ctrl+A | 대기열 선택 |
|
||||
| Delete | 선택 항목을 대기열에서 제거 (원본 유지) |
|
||||
| Esc | 처리 중에는 취소, 대기 중에는 창 닫기 |
|
||||
| F5 | 통계 새로고침 |
|
||||
| F1 | 도움말 및 프로그램 정보 |
|
||||
|
||||
## 두 가지 사용 방식
|
||||
|
||||
|
|
@ -166,14 +185,14 @@ Everything2Everything/
|
|||
│ └── Everything2EverythingBootstrap.cs
|
||||
└── Everything2Everything.App/ — WPF + CLI 통합 진입점
|
||||
├── App.xaml(.cs)
|
||||
├── Cli/CliRouter.cs — verb: to / quick / dialog / register / diagnose
|
||||
├── Cli/CliRouter.cs — verb: to / quick / dialog / register / unregister / diagnose
|
||||
├── Shell/ContextMenuRegistrar.cs — HKCU 카스케이드 등록
|
||||
└── Views/ — Fluent UI 화면
|
||||
```
|
||||
|
||||
## Provider 확장
|
||||
|
||||
새 변환 쌍을 추가하려면 `IConverterProvider`를 구현하고 `Everything2EverythingBootstrap.CreateDefault()`에 등록합니다. `ProviderCapability.SupportedConversions`에 (입력ext, 출력ext) 쌍 리스트를 정의하면 `ProviderRegistry`가 매트릭스 인덱스에 자동 편입하며, 컨텍스트 메뉴 카스케이드 + 메인 창 ComboBox에 자동 반영됩니다.
|
||||
새 변환 쌍을 추가하려면 `IConverterProvider`를 구현합니다. `ServiceCollectionExtensions`의 어셈블리 스캔으로 자동 등록됩니다. `ProviderCapability.SupportedConversions`에 (입력ext, 출력ext) 쌍 리스트를 정의하면 `ProviderRegistry`가 매트릭스 인덱스에 자동 편입하며, 컨텍스트 메뉴 카스케이드 + 메인 창 ComboBox에 자동 반영됩니다.
|
||||
|
||||
```csharp
|
||||
// 매트릭스 헬퍼 — 모든 입력 × 모든 출력 카르테시안 곱
|
||||
|
|
@ -185,3 +204,7 @@ SupportedConversions: ProviderCapability.PairsFromMatrix(
|
|||
## 라이선스
|
||||
|
||||
MIT.
|
||||
|
||||
## 현재 기능과 검증 범위
|
||||
|
||||
[현재 기능·제약](docs/current-features.md), [조사 및 개선 작업장](docs/research/2026-11-04/TASKS.md), [완결성 감사](docs/research/2026-11-04/agent-completeness.md)를 참고하세요. 지원 형식 선언과 실제 외부 도구 설치 여부는 별개입니다. 릴리즈는 전체 테스트·서명·패키징·업로드 검증을 통과해야 합니다.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue