<b>AX Commander</b>

개발 문서

Windows 전용 시맨틱 런처 & 워크스페이스 매니저

사내 전용 프로그램 개발 원칙

AX Commander는 사내 전용 프로그램입니다. 아래 원칙을 반드시 준수하여 개발하세요.

외부 연결 금지

허용: 로컬 파일 시스템 접근, Windows API (P/Invoke), 사내 인트라넷 URL, 로컬 프로세스 실행

아키텍처 개요

핵심 컴포넌트

프리픽스 핸들러 치트시트

설정 스키마 (settings.json)

경로: %APPDATA%\AxCommander\settings.json

테마 시스템

내장 테마 목록

테마 ResourceKey 목록 (14개)

새 테마 추가 절차

• 1. Themes/MyTheme.xaml 작성 (위 14개 키 모두 정의)
• 2. AxCommander.csproj에 <Resource Include="Themes/MyTheme.xaml"/> 추가
• 3. LauncherWindow.xaml.cs → GetEffectiveThemeName() switch에 케이스 추가
• 4. SettingsViewModel.ThemeCards 목록에 ThemeCardModel 항목 추가

보안 고려사항

단위 테스트

v1.6 3차 전체 점검 수정

빌드 오류 3건, 컴파일 경고 1건, 런타임 버그 6건, 보안 이슈 2건을 수정하였습니다.

컴파일 오류 수정

런타임 버그 수정

보안 수정

빌드 및 배포

빌드 명령

# 개발 실행

dotnet run --project src/AxCommander

# Release 단일 파일 빌드 (self-contained)

dotnet publish src/AxCommander -c Release -r win-x64 --self-contained

# 단위 테스트

dotnet test src/AxCommander.Tests

데이터 경로

요구 사항

• OS: Windows 10 20H2 이상 (Windows 11 권장)
• .NET 8.0 Runtime (Self-contained 빌드 시 불필요)

플러그인 개발

DLL 플러그인

AxCommander.SDK를 참조하여 IActionHandler 인터페이스를 구현합니다.

using AxCommander.SDK;

public class MyHandler : IActionHandler

{

public string? Prefix => "?"; // 트리거 프리픽스

public PluginMetadata Metadata => new("MyPlugin", "설명", "1.0");

public async Task<IEnumerable<LauncherItem>> GetItemsAsync(string query, CancellationToken ct)

{

return [ new LauncherItem("제목", "부제목", null, myData, Symbol: "\uE721") ];

}

public Task ExecuteAsync(LauncherItem item, CancellationToken ct)

{

return Task.CompletedTask;

}

}

JSON 스킬 (코드 없이 HTTP API 연동)

경로: %APPDATA%\AxCommander\skills\*.skill.json

{

"id": "my-api",

"name": "API 연동",

"prefix": "?",

"request": {

"method": "GET",

"url": "https://intranet.example.com/api?q={{INPUT}}"

},

"response": {

"resultsPath": "items",

"titleField": "name",

"subtitleField": "description",

"actionUrl": "url"

},

"cache": 30

}

AX Commander · .NET 8.0 · WPF · MIT License

Converted from: AX_Commander_개발문서.docx