[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
This commit is contained in:
2026-04-04 11:49:07 +09:00
parent e088a73925
commit e103a3a65a
7 changed files with 156 additions and 22 deletions

View File

@@ -485,6 +485,7 @@ td {
<tbody> <tbody>
<tr><td><span class="kbd">F1</span></td><td>도움말 창 열기</td><td><code>help</code> 입력과 동일</td></tr> <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">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">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">Delete</span></td><td>최근 실행 목록에서 항목 제거</td><td>확인 다이얼로그 후 실행</td></tr>
<tr><td><span class="kbd">Ctrl + ,</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> <tbody>
<tr> <tr>
<td><span class="sym">=</span></td> <td><span class="sym">=</span></td>
<td>계산기 · 단위 변환 · 수식 계산</td> <td>계산기 · 단위 변환 · 수식 계산 · 날짜 계산</td>
<td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></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>
<tr> <tr>
<td><span class="sym">$</span></td> <td><span class="sym">$</span></td>
@@ -739,6 +740,37 @@ td {
<span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다. <span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다.
</div> </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 모델 호환성 --> <!-- AI 모델 호환성 -->
<!-- ══════════════════════════════════════════════════════════ --> <!-- ══════════════════════════════════════════════════════════ -->
@@ -931,6 +963,24 @@ Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래
</div> </div>
</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 --> <!-- v1.7.2 -->
<div class="version-entry" style="border-left:3px solid #22C55E; background:linear-gradient(90deg,#22C55E10,transparent);"> <div class="version-entry" style="border-left:3px solid #22C55E; background:linear-gradient(90deg,#22C55E10,transparent);">
<div class="version-meta"> <div class="version-meta">

View File

@@ -485,6 +485,7 @@ td {
<tbody> <tbody>
<tr><td><span class="kbd">F1</span></td><td>도움말 창 열기</td><td><code>help</code> 입력과 동일</td></tr> <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">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">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">Delete</span></td><td>최근 실행 목록에서 항목 제거</td><td>확인 다이얼로그 후 실행</td></tr>
<tr><td><span class="kbd">Ctrl + ,</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> <tbody>
<tr> <tr>
<td><span class="sym">=</span></td> <td><span class="sym">=</span></td>
<td>계산기 · 단위 변환 · 수식 계산</td> <td>계산기 · 단위 변환 · 수식 계산 · 날짜 계산</td>
<td><span class="kbd">= 1920*1080</span> → 결과 2073600<br><span class="tip">결과를 Enter하면 클립보드에 복사</span></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>
<tr> <tr>
<td><span class="sym">$</span></td> <td><span class="sym">$</span></td>
@@ -739,6 +740,37 @@ td {
<span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다. <span class="kw">info disk</span>에서 드라이브 항목을 Enter하면 탐색기로 바로 열립니다.
</div> </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 모델 호환성 --> <!-- AI 모델 호환성 -->
<!-- ══════════════════════════════════════════════════════════ --> <!-- ══════════════════════════════════════════════════════════ -->
@@ -902,21 +934,5 @@ Ollama의 모든 모델이 도구 사용을 지원하지는 않습니다. 아래
</div> </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>

Binary file not shown.

Binary file not shown.

View File

@@ -181,6 +181,19 @@ public static class L10n
"cap 모드에서 Shift+Enter로 지연 캡처(3/5/10초)를 할 수 있습니다.", "cap 모드에서 Shift+Enter로 지연 캡처(3/5/10초)를 할 수 있습니다.",
"cap region 으로 원하는 영역만 정확하게 캡처할 수 있습니다.", "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 = private static readonly string[] _enPlaceholders =

View File

@@ -47,9 +47,13 @@ public partial class HelpDetailWindow
"입력창 커서가 맨 앞(또는 입력이 없을 때)이면 첫 항목으로, 맨 끝이면 마지막 항목으로 선택이 이동합니다.", "입력창 커서가 맨 앞(또는 입력이 없을 때)이면 첫 항목으로, 맨 끝이면 마지막 항목으로 선택이 이동합니다.",
"\uE74A", "#0078D4")); "\uE74A", "#0078D4"));
items.Add(MakeShortcut("AX Commander 탐색", "→ (오른쪽 화살표)", items.Add(MakeShortcut("AX Commander 탐색", "→ (오른쪽 화살표)",
"액션 모드 진입", "액션 모드 진입 / 파일 탐색기 폴더 진입",
"파일·앱 항목을 선택한 상태에서 → 를 누르면 경로 복사, 탐색기 열기, 관리자 실행, 터미널, 속성, 이름 변경, 삭제 메뉴가 나타납니다.", "파일·앱 항목: 경로 복사, 탐색기 열기, 관리자 실행 등 액션 메뉴. 파일 탐색기 모드(C:\\... 입력)에서 폴더 항목 선택 시: 해당 폴더로 바로 진입.",
"\uE76C", "#44546A")); "\uE76C", "#44546A"));
items.Add(MakeShortcut("AX Commander 탐색", "← (왼쪽 화살표)",
"파일 탐색기 상위 폴더 이동",
"C:\\, D:\\ 등 경로를 입력한 파일 탐색기 모드에서 커서가 입력 끝에 있을 때 ← 를 누르면 상위 폴더로 이동합니다.",
"\uE76B", "#0078D4"));
items.Add(MakeShortcut("AX Commander 탐색", "Tab", items.Add(MakeShortcut("AX Commander 탐색", "Tab",
"선택 항목 제목으로 자동완성", "선택 항목 제목으로 자동완성",
"현재 선택된 항목의 이름을 입력창에 채웁니다. 이후 계속 타이핑하거나 Enter로 실행합니다.", "현재 선택된 항목의 이름을 입력창에 채웁니다. 이후 계속 타이핑하거나 Enter로 실행합니다.",
@@ -60,6 +64,10 @@ public partial class HelpDetailWindow
"\uE8C1", "#B7791F")); "\uE8C1", "#B7791F"));
// ── 런처 기능 단축키 ───────────────────────────────────────────────── // ── 런처 기능 단축키 ─────────────────────────────────────────────────
items.Add(MakeShortcut("런처 기능", "F3",
"파일 빠른 미리보기 창 열기/닫기 (QuickLook)",
"선택된 파일의 미리보기 창을 토글합니다. 이미지·텍스트·코드(줄번호+색상)·PDF(텍스트 추출)·Word·Excel 미리보기를 지원합니다. 다시 F3을 누르면 창이 닫힙니다.",
"\uE8A4", "#6B2C91"));
items.Add(MakeShortcut("런처 기능", "F1", items.Add(MakeShortcut("런처 기능", "F1",
"도움말 창 열기", "도움말 창 열기",
"이 화면을 직접 엽니다. 'help' 를 입력하는 것과 동일합니다.", "이 화면을 직접 엽니다. 'help' 를 입력하는 것과 동일합니다.",

View File

@@ -130,6 +130,53 @@ public partial class HelpDetailWindow : Window
ColorBrush = ParseColor("#4B5EFC") 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() new()
{ {