[Phase L4 문서] 헬프·가이드·팁 문구 L4 신기능 반영

HelpDetailWindow.xaml.cs (+47줄): - 런처 탐색 카테고리 신설: 인라인 파일 탐색기, F3 QuickLook, 검색 히스토리, 고급 필터, 단위 변환 5항목 추가 HelpDetailWindow.Shortcuts.cs (+12줄): - → 단축키: 파일 탐색기 폴더 진입 기능 추가 설명 - ← 단축키 신규: 파일 탐색기 상위 폴더 이동 - F3 단축키 신규: QuickLook 미리보기 토글 L10n.cs (+13줄): - Phase L4 신기능 홍보 팁 12종 추가 (파일탐색기, F3, 검색히스토리, 필터문법, 단위변환) 개발자가이드.htm: - 단축키 테이블에 F3 QuickLook 행 추가 - = 예약어에 단위 변환 자동 제안·날짜 계산 예시 추가 - 팁 섹션에 4개 박스 추가: 인라인 파일탐색기, 고급 검색 필터, 검색 히스토리, F3 QuickLook - 버전 이력 v1.7.3 추가 (L4 전 기능 기록) 사용가이드.htm: 개발자 가이드에서 버전 이력 제거 후 재생성 가이드 암호화: guide_dev.enc, guide_user.enc 재암호화 완료 빌드: 경고 0, 오류 0
2026-04-04 11:49:07 +09:00
parent e088a73925
commit e103a3a65a
7 changed files with 156 additions and 22 deletions
--- a/src/AxCopilot/Assets/AX
+++ b/src/AxCopilot/Assets/AX
@@ -485,6 +485,7 @@ td {
 <tbody>
 <tr><td><span class="kbd">F1</span></td><td>도움말 창 열기</td><td><code>help</code> 입력과 동일</td></tr>
 <tr><td><span class="kbd">F2</span></td><td>선택 파일 이름 변경 모드</td><td></td></tr>
+<tr><td><span class="kbd">F3</span></td><td>파일 빠른 미리보기 창 열기/닫기</td><td>이미지·텍스트·코드·PDF·Word·Excel 지원</td></tr>
 <tr><td><span class="kbd">F5</span></td><td>파일 인덱스 즉시 재구축</td><td>새 파일 추가 후 사용</td></tr>
 <tr><td><span class="kbd">Delete</span></td><td>최근 실행 목록에서 항목 제거</td><td>확인 다이얼로그 후 실행</td></tr>
 <tr><td><span class="kbd">Ctrl + ,</span></td><td>설정 창 열기</td><td></td></tr>
@@ -536,8 +537,8 @@ td {
 <tbody>
 <tr>
    <td><span class="sym">=</span></td>
-    <td>계산기 · 단위 변환 · 수식 계산</td>
-    <td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></td>
+    <td>계산기 · 단위 변환 · 수식 계산 · 날짜 계산</td>
+    <td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="kbd">= 20km</span> → miles/m/ft 자동 제안<br><span class="kbd">= 100°F</span> → °C/K 변환<br><span class="kbd">= today+30d</span> → 날짜 계산<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></td>
 </tr>
 <tr>
    <td><span class="sym">$</span></td>
@@ -739,6 +740,37 @@ td {
 <span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다.
 </div>

+<div class="tip-box" style="margin-bottom:12px;">
+<strong>📁 인라인 파일 탐색기 (신기능)</strong><br>
+드라이브 경로(<span class="kbd">C:\</span>, <span class="kbd">D:\</span>) 또는 홈 경로(<span class="kbd">~\</span>)를 입력하면 런처 안에서 바로 파일 탐색기가 열립니다.
+<span class="kbd">→</span>로 하위 폴더 진입, <span class="kbd">←</span>로 상위 폴더 이동, <span class="kbd">Enter</span>로 파일 열기 또는 탐색기에서 폴더 열기.
+부분 경로를 입력하면 마지막 세그먼트로 파일명을 필터링합니다 (예: <span class="kbd">C:\Users\홍길동\Doc</span>).
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>🔍 고급 검색 필터 문법 (신기능)</strong><br>
+일반 검색어와 함께 필터 토큰을 입력하면 결과를 정밀하게 좁힐 수 있습니다:<br>
+<span class="kbd">ext:.pdf</span> 확장자 / <span class="kbd">ext:.docx,.xlsx</span> 다중 확장자<br>
+<span class="kbd">size:&gt;10mb</span> / <span class="kbd">size:&lt;500kb</span> 파일 크기<br>
+<span class="kbd">modified:today</span> / <span class="kbd">modified:week</span> / <span class="kbd">modified:month</span> 수정 날짜<br>
+<span class="kbd">type:file</span> / <span class="kbd">type:folder</span> / <span class="kbd">type:app</span> 항목 유형<br>
+<span class="kbd">in:Documents</span> 경로 포함 텍스트<br>
+예시: <span class="kbd">보고서 ext:.pdf size:&gt;1mb modified:week</span>
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>⏱ 검색 히스토리 (신기능)</strong><br>
+입력창이 비어있을 때 <span class="kbd">↑</span> / <span class="kbd">↓</span> 키를 누르면 이전에 입력했던 검색어를 불러옵니다.
+최근 50개가 로컬에 저장되며 앱 재시작 후에도 유지됩니다.
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>🔬 파일 빠른 미리보기 (F3 QuickLook 강화)</strong><br>
+파일을 선택하고 <span class="kbd">F3</span>을 누르면 별도 창에서 파일 내용을 미리볼 수 있습니다.
+지원 형식: 이미지(PNG/JPG 등), 텍스트/코드(줄번호+14개 언어 색상), PDF(텍스트 추출), Word·Excel(OpenXml 텍스트 추출).
+다시 <span class="kbd">F3</span>을 누르거나 미리보기 창을 닫으면 됩니다.
+</div>
+
 <!-- ══════════════════════════════════════════════════════════ -->
 <!-- AI 모델 호환성                                               -->
 <!-- ══════════════════════════════════════════════════════════ -->
@@ -931,6 +963,24 @@ Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래
    </div>
 </div>

+<!-- v1.7.3 -->
+<div class="version-entry" style="border-left:3px solid #4B5EFC; background:linear-gradient(90deg,#4B5EFC10,transparent);">
+    <div class="version-meta">
+        <div class="version-badge" style="background:#4B5EFC; color:#fff;">v1.7.3</div>
+    </div>
+    <div class="version-changes">
+        <ul>
+            <li><strong>인라인 파일 탐색기</strong> — 경로(C:\, D:\, ~\)를 입력하면 런처 안에서 폴더 탐색. → 키 진입 / ← 키 상위 이동</li>
+            <li><strong>F3 QuickLook 강화</strong> — PDF 텍스트 추출, Word·Excel 미리보기, 코드 14개 언어 색상+줄번호</li>
+            <li><strong>고급 검색 필터 문법</strong> — ext:.pdf / size:&gt;1mb / modified:week / type:folder / in:경로 인라인 필터</li>
+            <li><strong>검색 히스토리</strong> — ↑/↓ 키로 이전 검색어 탐색. 50개 FIFO 로컬 저장</li>
+            <li><strong>계산기 단위 변환 확장</strong> — =20km 자동 제안, =today+30d 날짜 계산, 온도·속도·데이터 크기 지원</li>
+            <li><strong>독 바 위젯 확장</strong> — 날씨(wttr.in 캐시), 캘린더, 배터리 상태 표시 추가</li>
+            <li><strong>빠른 액션 바</strong> — 런처 상단에 자주 실행하는 항목을 빠른 칩으로 표시</li>
+        </ul>
+    </div>
+</div>
+
 <!-- v1.7.2 -->
 <div class="version-entry" style="border-left:3px solid #22C55E; background:linear-gradient(90deg,#22C55E10,transparent);">
    <div class="version-meta">
--- a/src/AxCopilot/Assets/AX
+++ b/src/AxCopilot/Assets/AX
@@ -485,6 +485,7 @@ td {
 <tbody>
 <tr><td><span class="kbd">F1</span></td><td>도움말 창 열기</td><td><code>help</code> 입력과 동일</td></tr>
 <tr><td><span class="kbd">F2</span></td><td>선택 파일 이름 변경 모드</td><td></td></tr>
+<tr><td><span class="kbd">F3</span></td><td>파일 빠른 미리보기 창 열기/닫기</td><td>이미지·텍스트·코드·PDF·Word·Excel 지원</td></tr>
 <tr><td><span class="kbd">F5</span></td><td>파일 인덱스 즉시 재구축</td><td>새 파일 추가 후 사용</td></tr>
 <tr><td><span class="kbd">Delete</span></td><td>최근 실행 목록에서 항목 제거</td><td>확인 다이얼로그 후 실행</td></tr>
 <tr><td><span class="kbd">Ctrl + ,</span></td><td>설정 창 열기</td><td></td></tr>
@@ -536,8 +537,8 @@ td {
 <tbody>
 <tr>
    <td><span class="sym">=</span></td>
-    <td>계산기 · 단위 변환 · 수식 계산</td>
-    <td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></td>
+    <td>계산기 · 단위 변환 · 수식 계산 · 날짜 계산</td>
+    <td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="kbd">= 20km</span> → miles/m/ft 자동 제안<br><span class="kbd">= 100°F</span> → °C/K 변환<br><span class="kbd">= today+30d</span> → 날짜 계산<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></td>
 </tr>
 <tr>
    <td><span class="sym">$</span></td>
@@ -739,6 +740,37 @@ td {
 <span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다.
 </div>

+<div class="tip-box" style="margin-bottom:12px;">
+<strong>📁 인라인 파일 탐색기 (신기능)</strong><br>
+드라이브 경로(<span class="kbd">C:\</span>, <span class="kbd">D:\</span>) 또는 홈 경로(<span class="kbd">~\</span>)를 입력하면 런처 안에서 바로 파일 탐색기가 열립니다.
+<span class="kbd">→</span>로 하위 폴더 진입, <span class="kbd">←</span>로 상위 폴더 이동, <span class="kbd">Enter</span>로 파일 열기 또는 탐색기에서 폴더 열기.
+부분 경로를 입력하면 마지막 세그먼트로 파일명을 필터링합니다 (예: <span class="kbd">C:\Users\홍길동\Doc</span>).
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>🔍 고급 검색 필터 문법 (신기능)</strong><br>
+일반 검색어와 함께 필터 토큰을 입력하면 결과를 정밀하게 좁힐 수 있습니다:<br>
+<span class="kbd">ext:.pdf</span> 확장자 / <span class="kbd">ext:.docx,.xlsx</span> 다중 확장자<br>
+<span class="kbd">size:&gt;10mb</span> / <span class="kbd">size:&lt;500kb</span> 파일 크기<br>
+<span class="kbd">modified:today</span> / <span class="kbd">modified:week</span> / <span class="kbd">modified:month</span> 수정 날짜<br>
+<span class="kbd">type:file</span> / <span class="kbd">type:folder</span> / <span class="kbd">type:app</span> 항목 유형<br>
+<span class="kbd">in:Documents</span> 경로 포함 텍스트<br>
+예시: <span class="kbd">보고서 ext:.pdf size:&gt;1mb modified:week</span>
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>⏱ 검색 히스토리 (신기능)</strong><br>
+입력창이 비어있을 때 <span class="kbd">↑</span> / <span class="kbd">↓</span> 키를 누르면 이전에 입력했던 검색어를 불러옵니다.
+최근 50개가 로컬에 저장되며 앱 재시작 후에도 유지됩니다.
+</div>
+
+<div class="tip-box" style="margin-bottom:12px;">
+<strong>🔬 파일 빠른 미리보기 (F3 QuickLook 강화)</strong><br>
+파일을 선택하고 <span class="kbd">F3</span>을 누르면 별도 창에서 파일 내용을 미리볼 수 있습니다.
+지원 형식: 이미지(PNG/JPG 등), 텍스트/코드(줄번호+14개 언어 색상), PDF(텍스트 추출), Word·Excel(OpenXml 텍스트 추출).
+다시 <span class="kbd">F3</span>을 누르거나 미리보기 창을 닫으면 됩니다.
+</div>
+
 <!-- ══════════════════════════════════════════════════════════ -->
 <!-- AI 모델 호환성                                               -->
 <!-- ══════════════════════════════════════════════════════════ -->
@@ -902,21 +934,5 @@ Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래
 </div>

 <!-- ══════════════════════════════════════════════════════════ -->
-<!-- 푸터                                                        -->
-<!-- ══════════════════════════════════════════════════════════ -->
-
-

 <!-- ══════════════════════════════════════════════════════════ -->
-<!-- 푸터                                                        -->
-<!-- ══════════════════════════════════════════════════════════ -->
-<div class="post-footer">
-    <strong>AX Copilot</strong> — Windows 전용 시맨틱 런처<br>
-    단축키와 예약어는 업데이트마다 추가될 수 있습니다.<br>
-    런처 내에서 <span style="background:#333;padding:0 6px;border-radius:4px;font-family:monospace;font-size:12px;">help</span> 입력 또는
-    <kbd style="background:#333;padding:0 6px;border-radius:4px;font-family:monospace;font-size:12px;">F1</kbd>을 눌러 항상 최신 목록을 확인하세요.
-</div>
-
-</div><!-- /.wrap -->
-</body>
-</html>
--- a/src/AxCopilot/Assets/guide_dev.enc
+++ b/src/AxCopilot/Assets/guide_dev.enc
--- a/src/AxCopilot/Assets/guide_user.enc
+++ b/src/AxCopilot/Assets/guide_user.enc
--- a/src/AxCopilot/Services/L10n.cs
+++ b/src/AxCopilot/Services/L10n.cs
@@ -181,6 +181,19 @@ public static class L10n
        "cap 모드에서 Shift+Enter로 지연 캡처(3/5/10초)를 할 수 있습니다.",
        "cap region 으로 원하는 영역만 정확하게 캡처할 수 있습니다.",
        "지연 캡처로 메뉴가 열린 상태도 캡처할 수 있습니다.",
+        // ── Phase L4 신기능 안내 (12종) ──
+        "C:\\ 또는 D:\\ 를 입력하면 바로 인라인 파일 탐색기가 열립니다!",
+        "파일 탐색 중 → 키로 폴더 진입, ← 키로 상위 폴더로 돌아갑니다.",
+        "F3 키로 선택한 파일을 바로 미리볼 수 있습니다. PDF·코드·Office 모두 지원!",
+        "F3 미리보기에서 코드 파일은 언어별 색상 강조와 줄 번호를 표시합니다.",
+        "F3 미리보기에서 Word·Excel 파일의 텍스트 내용도 확인할 수 있습니다.",
+        "입력이 없을 때 ↑/↓ 키로 이전 검색어를 불러올 수 있습니다.",
+        "ext:.pdf 를 입력하면 PDF 파일만 검색할 수 있습니다.",
+        "size:>10mb 필터로 대용량 파일만 골라서 찾아보세요.",
+        "modified:week 으로 최근 일주일 내 수정된 파일만 검색할 수 있습니다.",
+        "= 20km 처럼 입력하면 킬로미터를 자동으로 변환 제안해 드립니다!",
+        "= 100°F 를 입력하면 섭씨·켈빈으로 자동 변환됩니다.",
+        "= today+30d 로 30일 후 날짜를 바로 계산할 수 있습니다.",
    ];

    private static readonly string[] _enPlaceholders =
--- a/src/AxCopilot/Views/HelpDetailWindow.Shortcuts.cs
+++ b/src/AxCopilot/Views/HelpDetailWindow.Shortcuts.cs
@@ -47,9 +47,13 @@ public partial class HelpDetailWindow
            "입력창 커서가 맨 앞(또는 입력이 없을 때)이면 첫 항목으로, 맨 끝이면 마지막 항목으로 선택이 이동합니다.",
            "\uE74A", "#0078D4"));
        items.Add(MakeShortcut("AX Commander 탐색", "→ (오른쪽 화살표)",
-            "액션 모드 진입",
-            "파일·앱 항목을 선택한 상태에서 → 를 누르면 경로 복사, 탐색기 열기, 관리자 실행, 터미널, 속성, 이름 변경, 삭제 메뉴가 나타납니다.",
+            "액션 모드 진입 / 파일 탐색기 폴더 진입",
+            "파일·앱 항목: 경로 복사, 탐색기 열기, 관리자 실행 등 액션 메뉴. 파일 탐색기 모드(C:\\... 입력)에서 폴더 항목 선택 시: 해당 폴더로 바로 진입.",
            "\uE76C", "#44546A"));
+        items.Add(MakeShortcut("AX Commander 탐색", "← (왼쪽 화살표)",
+            "파일 탐색기 상위 폴더 이동",
+            "C:\\, D:\\ 등 경로를 입력한 파일 탐색기 모드에서 커서가 입력 끝에 있을 때 ← 를 누르면 상위 폴더로 이동합니다.",
+            "\uE76B", "#0078D4"));
        items.Add(MakeShortcut("AX Commander 탐색", "Tab",
            "선택 항목 제목으로 자동완성",
            "현재 선택된 항목의 이름을 입력창에 채웁니다. 이후 계속 타이핑하거나 Enter로 실행합니다.",
@@ -60,6 +64,10 @@ public partial class HelpDetailWindow
            "\uE8C1", "#B7791F"));

        // ── 런처 기능 단축키 ─────────────────────────────────────────────────
+        items.Add(MakeShortcut("런처 기능", "F3",
+            "파일 빠른 미리보기 창 열기/닫기 (QuickLook)",
+            "선택된 파일의 미리보기 창을 토글합니다. 이미지·텍스트·코드(줄번호+색상)·PDF(텍스트 추출)·Word·Excel 미리보기를 지원합니다. 다시 F3을 누르면 창이 닫힙니다.",
+            "\uE8A4", "#6B2C91"));
        items.Add(MakeShortcut("런처 기능", "F1",
            "도움말 창 열기",
            "이 화면을 직접 엽니다. 'help' 를 입력하는 것과 동일합니다.",
--- a/src/AxCopilot/Views/HelpDetailWindow.xaml.cs
+++ b/src/AxCopilot/Views/HelpDetailWindow.xaml.cs
@@ -130,6 +130,53 @@ public partial class HelpDetailWindow : Window
                ColorBrush = ParseColor("#4B5EFC")
            },

+            // ── 런처 탐색 ───────────────────────────────────────────────
+            new()
+            {
+                Category = "런처 탐색", Command = "C:\\ · D:\\ · ~\\",
+                Title = "인라인 파일 탐색기",
+                Description = "드라이브 경로(C:\\, D:\\)나 홈 경로(~\\)를 입력하면 런처 안에서 바로 파일 탐색기가 열립니다. → 키로 하위 폴더 진입, ← 키로 상위 폴더 이동, Enter로 파일 실행 또는 탐색기 열기.",
+                Example = "C:\\\nD:\\프로젝트\\",
+                Symbol = "\uEC50",
+                ColorBrush = ParseColor("#0078D4")
+            },
+            new()
+            {
+                Category = "런처 탐색", Command = "F3",
+                Title = "파일 빠른 미리보기 (QuickLook)",
+                Description = "파일을 선택한 상태에서 F3을 누르면 미리보기 창이 열립니다. 이미지·텍스트·PDF(텍스트 추출)·Word·Excel·코드 파일(줄 번호 + 언어별 색상)을 지원합니다. 다시 F3을 누르면 닫힙니다.",
+                Example = "파일 선택 후 F3",
+                Symbol = "\uE8A4",
+                ColorBrush = ParseColor("#6B2C91")
+            },
+            new()
+            {
+                Category = "런처 탐색", Command = "↑ / ↓ (입력 없을 때)",
+                Title = "검색 히스토리 탐색",
+                Description = "입력창이 비어있거나 검색 결과가 없을 때 ↑/↓ 키를 누르면 이전에 입력했던 검색어를 불러옵니다. 최대 50개 기록이 앱 재시작 후에도 유지됩니다.",
+                Example = "입력 없는 상태에서 ↑ 키",
+                Symbol = "\uE74A",
+                ColorBrush = ParseColor("#0078D4")
+            },
+            new()
+            {
+                Category = "런처 탐색", Command = "ext: · size: · modified: · type: · in:",
+                Title = "고급 검색 필터 문법",
+                Description = "검색어 뒤에 필터를 추가하면 결과를 세밀하게 좁힐 수 있습니다.\n• ext:.pdf,.docx — 확장자 필터\n• size:>10mb / size:<500kb — 파일 크기\n• modified:today / week / month — 수정 날짜\n• type:file / folder / app — 항목 유형\n• in:Documents — 경로에 포함된 텍스트",
+                Example = "보고서 ext:.pdf size:>1mb\nmodified:week ext:.cs",
+                Symbol = "\uE16E",
+                ColorBrush = ParseColor("#059669")
+            },
+            new()
+            {
+                Category = "런처 탐색", Command = "= 20km · = 100°F · = today+30d",
+                Title = "단위 변환 자동 제안 · 날짜 계산",
+                Description = "= 뒤에 숫자+단위를 입력하면 주요 단위로 자동 변환 제안을 보여줍니다. 온도(°C/°F/K), 길이(km/miles/ft), 무게(kg/lb), 속도, 데이터 크기 지원. today+30d / today-2w 로 날짜 계산도 가능합니다.",
+                Example = "= 20km\n= 100°F\n= today+14d",
+                Symbol = "\uE8EF",
+                ColorBrush = ParseColor("#D97706")
+            },
+
            // ── 업무 보조 ───────────────────────────────────────────────
            new()
            {