FluentCleaner 딥다이브
— "CCleaner는 변질됐다": 15년치 winapp2.ini 커뮤니티 청소 규칙을 재사용하는 .NET 10 · WinUI 3 오픈소스 청소기

1프로젝트 한줄 요약

이 저장소가 대체 무엇인가.

FluentCleaner(제작자 Belim, GitHub 조직 builtbybel)는 윈도우의 불필요한 임시파일·캐시·로그를 지워 디스크를 비우는 청소 도구다. 겉보기엔 흔한 "CCleaner류" 유틸리티지만, 핵심은 두 가지다. 첫째, UI를 마이크로소프트의 최신 WinUI 3로 짜서 윈도우 11의 Mica·Fluent 디자인을 그대로 입었고, 둘째, 청소 규칙을 스스로 만들지 않고 커뮤니티 표준인 winapp2.ini를 재사용한다는 점이다.

코드 기준 버전은 26.06.04(2026년 6월의 4번째 빌드)로, 날짜 기반 버전(YY.MM.build)을 쓴다. 라이선스는 관대한 MIT이고, 저장소는 2026년 4월 13일 생성돼 아직 3개월도 안 된 신생 프로젝트인데도 별점이 약 2.7k에 이른다. 실행 파일 이름은 FCleaner.exe이며, 설치 없이 바로 실행되는 언패키지드(unpackaged) 방식이다.

2왜 주목받는가

트렌딩 이유와, 흔한 "시스템 청소기"와의 결정적 차이.

① "CCleaner는 죽었다"는 서사 — 향수 + 저항

README는 사실상 CCleaner를 향한 성토문이다. 한때 모두가 쓰던 CCleaner가 VPN 끼워팔기·가짜 "레지스트리 마법"·광고로 bloatware(군더더기 소프트웨어)로 변질됐다는 것. FluentCleaner는 그 빈자리를 노린 "안티-CCleaner"를 표방한다. 텔레메트리 없음, 업셀 없음, 오픈소스. 이 감정적 서사가 r/windows·해커뉴스에서 강하게 먹혔다.

② 정직한 엔지니어링을 '기능'으로 내세운다

가장 인상적인 부분. README에는 "옵티마이저 미신(Optimizer Myths)" 섹션이 있어, 다른 청소기들이 파는 기능을 왜 일부러 안 넣었는지를 설명한다. 보안 삭제(secure delete)는 SSD의 TRIM 때문에 무의미하고, 레지스트리 청소는 효과는 위약(placebo) 수준인데 위험만 크다는 것. "기능을 빼는 이유를 당당히 문서화"하는 이 투명함이 개발자 커뮤니티의 신뢰를 샀다.

③ 진짜 최신 스택 — 요즘 나온 청소기가 2009년처럼 안 생겼다

대부분의 윈도우 청소기가 낡은 Win32 룩앤필에 머물러 있는 사이, FluentCleaner는 .NET 10 + WinUI 3 + Windows App SDK 2.0.1이라는 2026년 최신 조합으로 네이티브 Mica/Acrylic 배경, Fluent 컨트롤을 그대로 쓴다. 심지어 x64와 ARM64를 모두 네이티브 지원한다. "청소기도 예쁠 수 있다"를 증명한 셈이다.

④ 15년 커뮤니티 자산에 무임승차 — 똑똑한 재사용

winapp2.ini는 2010년대 초부터 커뮤니티(MoscaDotTo/Winapp2)가 CCleaner용으로 쌓아 온 청소 규칙 사전이다. FluentCleaner는 이걸 파싱해 3,721개 항목을 즉시 지원한다 — 크롬·파이어폭스·오피스·수천 개 앱을 손으로 코딩할 필요가 없다. 특히 CCleaner 7이 winapp2.ini 지원을 끊어버린 지금, FluentCleaner는 그 유산의 새 안식처가 됐다는 점에서 더욱 화제였다.

⑤ 스크립트가 아니라 살아 움직이는 제품

생긴 지 11주밖에 안 됐지만 릴리스가 쉴 새 없이 나온다. 전역 예외 목록(Global Exclusions)·설정 내보내기/가져오기·포터블 모드·무인 청소(/AUTO)가 몇 주 새 차례로 추가됐고, 8개 언어 현지화가 커뮤니티 PR로 들어온다. 자매 앱 FluentTweaker까지 출시돼 하나의 생태계를 이룬다. Renovate 봇이 의존성을 자동 관리하고 GitHub Actions로 x64/arm64를 자동 빌드하는 등, 1인 개발치고 운영이 탄탄하다.

3기술 스택 전체 지도

무엇으로 만들어졌나 — 계층별로. (FluentCleaner.csproj에서 실제 확인)

언어 & 빌드 시스템

NuGet 의존성 (딱 3개 — 매우 가볍다)

주목할 점: 의존성이 단 3개다. SQLite도, Entity Framework도, 무거운 서드파티 프레임워크도 없다. "다중 데이터베이스"라는 표현 때문에 DB 엔진을 떠올리기 쉽지만 여기엔 SQL이 전혀 없다(→ 4장에서 상술). 설정 저장조차 System.Text.Json 파일 하나(%AppData%\FluentCleaner\settings.json)로 끝낸다. 플랫폼 API를 직접 쓰는 미니멀한 취향이 드러난다.

패키징 & 실행 방식

도구 & CI

GitHub Actions build.yml이 x64/arm64 매트릭스로 windows-latest에서 dotnet build -c Release를 돌리고, codeql.yml이 코드 보안을 스캔한다. Renovate 봇이 NuGet·Actions 의존성을 자동으로 갱신·머지(패치 버전은 자동)한다. 릴리스는 미리 빌드된 FCleaner.exe와 선택적 확장팩 Custom.zip을 함께 배포한다.

4아키텍처 심화 분석

"청소 버튼"을 누르면 안에서 무슨 일이 벌어지는가.

전체 그림 — 규칙 파일에서 삭제까지

모든 것은 winapp2.ini 형식의 규칙에서 출발한다. 규칙 하나가 CleanerEntry 객체로 파싱되고, "이 앱이 깔려 있나?"를 판단한 뒤, 경로의 변수·와일드카드를 실제 경로로 펼치고, 2단계(분석 → 삭제)로 안전하게 지운다. 이 앱이 지우는 대상은 딱 두 가지 — 파일과 레지스트리 키/값뿐이다. 조각모음도, 보안 삭제도 없다.

1단계 — INI 파싱 (Winapp2Parser)

82줄짜리 작은 파서가 winapp2 형식을 읽는다. 이 형식은 번호가 붙는 다중 키(FileKey1, FileKey2…, RegKey1…, ExcludeKey1…)와 감지 규칙(Detect, DetectFile, SpecialDetect)을 갖는다. 실제 규칙 한 덩어리는 이렇게 생겼다:

; winapp2.ini 규칙 예시 — "구글 크롬 캐시"
[Google Chrome Cache *]
LangSecRef=3021
Detect=HKCU\Software\Google\Chrome     # 이 레지스트리 키가 있으면 크롬 설치됨
Default=False
FileKey1=%LocalAppData%\Google\Chrome\User Data\*\Cache|*.*|RECURSE
FileKey2=%LocalAppData%\Google\Chrome\User Data\*\Code Cache|*.*|RECURSE

파서는 한 항목에 "감지 방법"과 "지울 대상"이 둘 다 있을 때만 유효한 규칙으로 인정한다. 사소하지만 중요한 디테일: WinUI의 TextBox는 줄바꿈을 \r만으로 저장할 때가 있어, 파서는 \r과 \n 양쪽으로 잘라 준다.

2단계 — 설치 감지 (DetectionService)

"이 앱이 설치돼 있나?"를 확인해, 없는 앱의 청소 규칙은 목록에서 숨긴다. 판단 방법은 세 가지 — 레지스트리 키 존재, 파일/폴더 존재, 그리고 SpecialDetect 단축코드(DET_CHROME, DET_FIREFOX, DET_EDGE, DET_OPERA, DET_WINSTORE 등)다. 여러 조건 중 하나만 맞아도(OR) 해당 규칙을 보여준다.

3단계 — 경로 확장 (PathExpander)

129줄짜리 이 서비스가 규칙 속 추상 경로를 진짜 경로로 바꾼다. 두 가지 일을 한다:

# (1) winapp2 전용 환경변수 치환
%LocalAppData%   →  C:\Users\나\AppData\Local
%ProgramFiles%   →  C:\Program Files   (없으면 자동으로 (x86) 재시도)
%SystemDrive%    →  C:

# (2) 경로 안의 와일드카드(* ?)를 재귀적으로 실제 폴더로 펼침
%LocalAppData%\Google\Chrome\User Data\*\Cache
   →  ...\User Data\Default\Cache
   →  ...\User Data\Profile 1\Cache      # 프로필마다 실제로 펼쳐짐

맨 끝 드라이브 루트(C: vs C:\) 처리 같은 함정까지 코드에 주석으로 남아 있어, "경로 다루기가 왜 어려운가"를 배우기 좋다.

4단계 — 2단계 삭제 (CleaningService, 349줄)

이 앱에서 가장 중요한 안전장치. 청소를 "분석"과 "삭제" 두 국면으로 확실히 분리한다.

규칙마다 예외(ExcludeKey: FILE|·PATH|·REG|)를 둘 수 있고, 여기에 더해 26.06.01에서 전역 예외(Global Exclusions) — 모든 DB에 걸쳐 특정 경로를 절대 안 지우는 화이트리스트 — 가 추가됐다.

5디렉토리 구조 해부

파일들이 어디에 어떻게 놓였나 — 교과서적 MVVM.

꼭 알아둘 핵심 파일

디렉토리만 봐도 설계 의도가 보인다. 엔진(Services)과 화면(Views)이 철저히 분리돼 있어, 새 프론트엔드(예: 터미널)를 붙일 때 청소 로직을 건드리지 않는다.

6학습 포인트 (기술별)

이 코드베이스에서 무엇을 훔쳐 배울 수 있나.

① 현대 WinUI 3 데스크톱 앱의 뼈대

NavigationView로 페이지를 전환하는 셸, TitleBar 커스터마이징, Mica/Acrylic 배경(MicaBackdrop/DesktopAcrylicBackdrop) 적용, 그리고 MSIX 없이 그냥 .exe로 배포하는 언패키지드 + self-contained 구성까지. "요즘 윈도우 앱은 이렇게 만든다"의 표준 템플릿을 통째로 얻는다.

② MVVM 소스 제너레이터 — 보일러플레이트 없는 데이터 바인딩

CommunityToolkit.Mvvm의 백미. 옛날엔 INotifyPropertyChanged를 손으로 구현하느라 프로퍼티마다 수십 줄을 썼는데, 이제는 애트리뷰트 한 줄이면 컴파일 타임에 자동 생성된다:

// 이 한 줄이…
[ObservableProperty]
public partial bool IsBusy { get; set; }

// …컴파일 타임에 "값이 바뀌면 UI에 알림" 코드로 자동 확장된다.
// 명령도 마찬가지:
[RelayCommand(CanExecute = nameof(CanClean))]
private async Task CleanAsync() { ... }   // → CleanCommand 자동 생성

C# partial 프로퍼티 + 소스 제너레이터가 어떻게 결합하는지 보는 최고의 실전 예제다.

③ 2단계 비동기 파이프라인 — 안전한 파괴적 작업

"파일을 지운다"처럼 되돌릴 수 없는 작업을 분석(읽기)과 실행(쓰기)으로 분리하고, IProgress<T>로 진행률을 보고하며, CancellationToken으로 중간 취소를 처리하고, Task.Run으로 무거운 I/O를 백그라운드로 밀어낸다. Progress<T>가 UI 동기화 컨텍스트를 자동으로 잡아 주는 덕에 백그라운드에서 진행률만 UI로 안전하게 흘려보내는 깔끔한 패턴을 배운다.

④ 직접 만든 INI 파서 + 와일드카드 경로 확장

정규식 라이브러리에 기대지 않고 도메인 특화 형식(winapp2)을 직접 파싱한다. 번호가 붙는 다중 키, 다중 감지 조건, 예외 규칙을 다루고, 경로 안의 */?를 재귀적으로 실제 폴더로 펼치는 로직은 "실무에서 마주치는 파싱/경로 처리"의 축소판이다. 순환(정션) 방지까지 들어 있다.

⑤ P/Invoke — 관리 코드에서 Win32 API 직접 호출

파일이 잠겨 있는지 알아내려고 CreateFileW에 DELETE 권한을 요청해 보는 트릭, 메모리 용량을 읽는 GetPhysicallyInstalledSystemMemory 호출 등. .NET에서 네이티브 API가 필요할 때 어떻게 다리를 놓는지(SafeFileHandle 포함)를 실물로 본다.

⑥ 하나의 코어, 세 개의 프론트엔드

같은 CleaningService/DetectionService를 (a) GUI 페이지, (b) 앱 내 터미널(CliViewModel), (c) 무인모드(SilentRunner)가 공유한다. "비즈니스 로직을 UI에서 떼어 놓으면 재사용이 얼마나 쉬워지는가"의 교과서. 특히 /AUTO 무인모드는 SilentRunner가 창 없이 저장된 선택을 청소하고 로그를 남긴 뒤 선택적으로 종료까지 하는데, Task Scheduler에 걸어 두면 자동 청소가 된다.

7하드웨어/시스템 요구사항

돌리려면 / 빌드하려면 무엇이 필요한가.

8직접 해볼 수 있는 실습 과제

읽기만 하면 안 남는다 — 난이도별로 손을 움직여 보자.

9관련 기술 심화 학습 로드맵

이 레포를 온전히 읽으려면 — 5주 코스.

10핵심 키워드 사전

문서에 나온 용어를 한 번에.

11참고 링크

더 깊이 파고들 곳.