[Phase L5-1] 항목별 전용 핫키 기능 구현

HotkeyAssignment 모델 추가 (AppSettings.Models.cs):
- Hotkey, Target, Label, Type 필드 (app/url/folder/command)
- AppSettings.CustomHotkeys (List<HotkeyAssignment>) 추가

InputListener.cs 확장 (Core/):
- _customHotkeys 목록 (스레드 안전 lock)
- UpdateCustomHotkeys() 메서드 — 설정 저장 후 즉시 갱신
- CustomHotkeyTriggered 이벤트 (CustomHotkeyEventArgs: Target, Type)
- WH_KEYBOARD_LL 콜백에 전용 핫키 감지 분기 추가

HotkeyHandler.cs 신규 생성 (Handlers/, 140줄):
- prefix="hotkey" — 등록 목록 표시 / 설정 열기
- ExecuteHotkeyTarget() — app/url/folder/command 타입별 실행

App.xaml.cs + App.Settings.cs:
- HotkeyHandler 등록 (Phase L5 주석)
- OnCustomHotkeyTriggered 이벤트 핸들러 연결
- 설정 저장 시 UpdateCustomHotkeys() 호출

SettingsViewModel 3파일 업데이트:
- HotkeyRowModel (Properties.cs): Hotkey/Target/Label/Type + TypeSymbol
- CustomHotkeys ObservableCollection + New* 필드 (Properties.cs)
- AddCustomHotkey() / RemoveCustomHotkey() 메서드 (Methods.cs)
  - HotkeyParser 형식 검증, 중복 핫키 방지
- Load/Save에 CustomHotkeys 매핑 (SettingsViewModel.cs, Methods.cs)

SettingsWindow.xaml + .xaml.cs:
- "전용 핫키" 탭 신규 추가 (배치 명령 탭 다음)
  - 안내 배너, 입력 폼 (핫키 레코더 + 표시이름 + 타입 + 대상)
  - 핫키 목록 (배지 + 타입아이콘 + 이름/경로 + 삭제 버튼)
- HotkeyRecord_Click: 클릭 후 키 입력 → 자동 핫키 감지 (PreviewKeyDown)
- AddHotkey_Click, RemoveHotkey_Click, BrowseHotkeyTarget_Click 핸들러

docs/LAUNCHER_ROADMAP.md:
- L5-1  완료 표시, 구현 내용 업데이트

빌드: 경고 0, 오류 0

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-04 12:12:32 +09:00
parent e103a3a65a
commit c12e863e3a
13 changed files with 635 additions and 1 deletions

View File

@@ -0,0 +1,155 @@
using AxCopilot.Core;
using AxCopilot.SDK;
using AxCopilot.Services;
using AxCopilot.Themes;
namespace AxCopilot.Handlers;
/// <summary>
/// L5-1: 전용 핫키 관리 핸들러.
/// 예: hotkey → 등록된 전용 핫키 목록 표시
/// hotkey 1doc → 라벨 또는 대상에 "1doc" 포함 항목 필터
/// Enter 시 해당 핫키 항목의 대상을 실행합니다.
/// </summary>
public class HotkeyHandler : IActionHandler
{
private readonly SettingsService? _settings;
public HotkeyHandler(SettingsService? settings = null)
{
_settings = settings;
}
public string? Prefix => "hotkey";
public PluginMetadata Metadata => new(
"HotkeyManager",
"전용 핫키 목록 관리",
"1.0",
"AX");
public Task<IEnumerable<LauncherItem>> GetItemsAsync(string query, CancellationToken ct)
{
var items = new List<LauncherItem>();
var hotkeys = _settings?.Settings.CustomHotkeys ?? new List<Models.HotkeyAssignment>();
if (hotkeys.Count == 0)
{
items.Add(new LauncherItem(
"등록된 전용 핫키 없음",
"설정 → 전용 핫키 탭에서 항목별 글로벌 단축키를 등록하세요",
null,
"__open_settings__",
Symbol: "\uE713"));
return Task.FromResult<IEnumerable<LauncherItem>>(items);
}
var filter = query.Trim().ToLowerInvariant();
foreach (var h in hotkeys)
{
if (!string.IsNullOrEmpty(filter) &&
!h.Label.Contains(filter, StringComparison.OrdinalIgnoreCase) &&
!h.Hotkey.Contains(filter, StringComparison.OrdinalIgnoreCase) &&
!h.Target.Contains(filter, StringComparison.OrdinalIgnoreCase))
continue;
var typeSymbol = h.Type switch
{
"url" => Symbols.Globe,
"folder" => Symbols.Folder,
"command" => "\uE756",
_ => Symbols.App
};
var label = string.IsNullOrWhiteSpace(h.Label)
? System.IO.Path.GetFileNameWithoutExtension(h.Target)
: h.Label;
items.Add(new LauncherItem(
$"[{h.Hotkey}] {label}",
h.Target,
null,
h,
Symbol: typeSymbol));
}
// 설정 단축키 안내 항목
items.Add(new LauncherItem(
"전용 핫키 설정 열기",
"설정 → 전용 핫키 탭에서 핫키를 추가하거나 제거합니다",
null,
"__open_settings__",
Symbol: "\uE713"));
return Task.FromResult<IEnumerable<LauncherItem>>(items);
}
public Task ExecuteAsync(LauncherItem item, CancellationToken ct)
{
if (item.Data is string s && s == "__open_settings__")
{
System.Windows.Application.Current.Dispatcher.Invoke(() =>
{
var app = System.Windows.Application.Current as AxCopilot.App;
app?.OpenSettingsFromChat();
});
return Task.CompletedTask;
}
if (item.Data is Models.HotkeyAssignment ha)
{
ExecuteHotkeyTarget(ha.Target, ha.Type);
}
return Task.CompletedTask;
}
/// <summary>전용 핫키 대상을 타입에 따라 실행합니다.</summary>
internal static void ExecuteHotkeyTarget(string target, string type)
{
try
{
switch (type)
{
case "url":
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo
{
FileName = target,
UseShellExecute = true
});
break;
case "folder":
System.Diagnostics.Process.Start("explorer.exe", target);
break;
case "command":
var parts = target.Split(' ', 2, StringSplitOptions.RemoveEmptyEntries);
var cmdFile = parts[0];
var cmdArgs = parts.Length > 1 ? parts[1] : "";
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo
{
FileName = cmdFile,
Arguments = cmdArgs,
UseShellExecute = true
});
break;
default: // app
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo
{
FileName = target,
UseShellExecute = true
});
break;
}
Services.LogService.Info($"전용 핫키 실행: {target} ({type})");
}
catch (Exception ex)
{
Services.LogService.Error($"전용 핫키 실행 오류: {target} — {ex.Message}");
}
}
}