XStats/README.ko.md

XStats

시스템 상태와 일상 도구를 Mac 메뉴 막대에 모으세요.

CPU, 메모리, 네트워크, 온도를 한눈에 보고, 세부 화면에서 추이와 앱 사용량을 확인하세요. AI 사용량, 달력, 팬 제어, 정리 도구는 필요할 때 켤 수 있습니다.

최신 버전 다운로드 · 미리보기 · 주요 기능 · 설치 · 변경 기록(중국어)

简体中文 · English · 日本語 · 한국어

미리보기

메인 창에서 시스템 상태를 모아 볼 수 있으며, 취향에 따라 라이트와 다크 모드를 선택할 수 있습니다.

주요 기능

XStats는 Swift, AppKit, SwiftUI로 만든 무료 오픈소스 네이티브 앱입니다. XStats 계정 등록이 필요 없으며, 표시할 정보와 사용할 도구를 직접 선택할 수 있습니다.

원하는 메뉴 막대 표시 방식

• 개별 표시: 자주 확인하는 지표마다 메뉴 막대 항목을 표시합니다.
• 통합 표시: 여러 수치를 한 그룹에 모으고 펼쳐서 상태 개요를 확인합니다.
• 아이콘만: XStats 아이콘 하나만 남기고 펼쳐서 선택한 항목을 확인합니다.

표시할 항목, 순서, 스타일을 바꿀 수 있습니다. 지표에 따라 텍스트, 아이콘, 링, 진행 막대, 기록 그래프를 선택하고, 필요 없는 항목은 끌 수 있습니다.

시스템 모니터링과 세부 정보

모듈	확인할 수 있는 정보
CPU	사용자 / 시스템 / 유휴 사용률, 코어별 부하 링, 코어 그룹 사용률, 평균 부하, 읽을 수 있는 주파수와 온도. macOS 열 상태가 높으면 경고 표시
GPU	그래픽 사용률, 코어 수 등 하드웨어 정보, 읽을 수 있는 온도와 소비 전력
메모리	메모리 압력, 앱 및 압축 메모리, 캐시, 스왑 공간, 스왑 인 / 아웃 속도
디스크	용량, 읽기/쓰기 속도, 앱별 I/O 순위, 읽을 수 있는 SMART 상태 정보
네트워크	업로드/다운로드 속도, 네트워크 인터페이스와 연결 개요
배터리와 Bluetooth	배터리 잔량, 전원, 건강 상태, 충전 사이클 수. 지원되는 Bluetooth 기기의 잔량은 배터리가 없는 Mac에서도 메뉴 막대에 표시 가능
온도와 팬	온도 센서 그룹, 팬 회전수, 읽을 수 있는 소비 전력
디스플레이	모델, 해상도, 스케일링 해상도, 주사율. 지원되는 외부 디스플레이의 밝기, 대비, 음량 조절

코어 유형은 시스템이 보고한 정보를 따릅니다. 실제 슈퍼 / 성능 / 효율 코어를 그룹으로 표시하며, 기종에 따라 두 그룹이나 세 그룹으로 고정하지 않습니다. ‘이 Mac’에서 모델, OS 버전, 가동 시간도 확인할 수 있습니다.

외부 디스플레이 제어에는 모니터, 케이블, 연결 방식의 DDC/CI 지원이 필요합니다. 각 제어 항목을 따로 감지하며, 지원되지 않거나 일시적으로 읽을 수 없으면 상태를 표시합니다. 지원되는 항목에만 슬라이더를 제공합니다.

AI 사용량과 구독 한도

메뉴 막대에서 Codex / Claude Code 사용량을 확인하고, 펼쳐서 통계와 한도 세부 정보를 볼 수 있습니다.

• 토큰 통계: 오늘은 시간별, 최근 7일 / 30일은 일별로 표시합니다. 메인 창에서는 연간 활동 히트맵도 제공합니다.
• 구독 한도: 사용 / 남은 비율을 전환하고 초기화 시각을 확인합니다. 소스가 제공하는 요금제, 유효기간, 사용 가능한 한도 초기화 횟수 등의 정보도 표시합니다.
• 추정 비용: 모델의 공개 API 기본 단가로 계산하며 미국 달러 / 중국 위안 표시를 지원합니다. 구간별 추가 요금은 포함하지 않으며 구독 청구액을 의미하지 않습니다.
• 표시 설정: 갱신 간격과 중국어 万 / 亿 또는 K / M / B 숫자 단위를 선택할 수 있습니다.

AI 사용량은 기본적으로 꺼져 있습니다. 로컬 통계는 Codex / Claude Code 세션 로그를 읽으며, 구독 한도 조회에는 해당 CLI 로그인이 필요합니다. Sub2API를 예비 소스로 직접 설정할 수도 있습니다.

필요할 때 켜는 일상 도구

• 팬 제어: 동작 상태를 확인하고, 지원되는 기기에서 자동 / 수동 제어를 전환합니다.
• 잠자기 방지: 시스템이나 화면을 깨어 있게 유지하며, 설정하면 덮개를 닫은 상태에서도 동작할 수 있습니다.
• 정리와 앱 제거: 캐시, 프로젝트 빌드 산출물, 앱 관련 파일을 제거합니다. 실행 전에 미리 보고 확인하며, 휴지통으로 옮길 수도 있습니다.
• 시작 항목 관리: 로그인 항목과 백그라운드 시작 항목을 확인하고 관리합니다.
• 네트워크 진단: 속도 테스트, DNS 조회, 외부 연결 경로 검사, 공인 IP 위치 및 순도 확인, 연결 탐색을 필요할 때 실행합니다.
• 메뉴 막대 달력: 음력, 중국 공휴일과 대체 근무일, 역서를 표시합니다. 권한을 허용하면 캘린더 일정과 미리 알림도 확인할 수 있습니다.
• 뽀모도로와 눈 휴식: 집중 및 휴식 타이머, 여러 디스플레이의 휴식 화면을 제공하며 일시 정지, 건너뛰기, 미니 HUD 축소가 가능합니다.
• 프로세스 관리: 켜면 모든 프로세스 표시, 검색, 정렬, 앱별 그룹화, 종료를 지원합니다.

정리, 프로세스, 달력, 뽀모도로, AI 사용량은 기본적으로 꺼져 있으며 필요할 때 켤 수 있습니다. 팬 제어와 덮개를 닫은 상태의 잠자기 방지 같은 권한이 필요한 작업에는 앱에서 보조 도구를 설치하고 권한을 허용해야 합니다.

다른 도구 스크린샷 보기

데스크톱 위젯과 언어

위젯에는 시스템 개요, 뽀모도로, AI 한도, 달력과 월 달력, ‘내일 출근?’, IP 순도, 공인 IP가 있습니다.

인터페이스는 9개 언어를 지원합니다: 简体中文, 繁體中文, English, 日本語, 한국어, Deutsch, Español, Français, العربية.

설치

Apple Silicon Mac과 macOS 14 이상이 필요합니다.

Homebrew:

brew tap ysicing/tap
brew trust ysicing/tap
brew install --cask xstats

업데이트는 brew upgrade --cask xstats로 할 수 있습니다.

직접 다운로드: GitHub Releases에서 DMG를 받은 뒤, 열어서 XStats를 ‘응용 프로그램’으로 드래그하고 실행하세요.

앱이 업데이트를 확인하며, 새 버전의 다운로드와 설치 여부는 사용자가 선택합니다. 소스 빌드 방법은 개발 안내(중국어)를 참고하세요.

데이터와 개인정보

모니터링 데이터, 로컬 기록, AI 토큰 통계는 기기에서 처리하며 XStats 업데이트 서비스에 업로드하지 않습니다. 다음 기능은 외부 서비스에 연결하며, 끄거나 필요할 때 사용할 수 있습니다.

• 업데이트 확인: 현재 버전과 설치 ID의 해시를 보내 업데이트 정보를 가져옵니다.
• AI 한도 조회: 로컬 CLI 로그인으로 제공자에 조회하며, 예비 소스를 설정하면 지정한 서버에 연결합니다.
• 비용 추정: 공개 모델 단가와 참고 환율을 필요할 때 가져오며, 세션 로그나 토큰 통계는 보내지 않습니다.
• 네트워크 진단: 공인 IP, 위치, 속도 테스트, DNS, 연결 탐색, 글로벌 프로브는 해당 서비스에 연결합니다. 글로벌 프로브의 대상과 결과는 다른 사람이 조회할 수 있습니다.

자세한 내용은 개인정보 처리방침(영어)과 서비스 약관(영어)을 확인하세요.

빌드와 기여

Xcode 26+, Go 1.25+, Go Task, XcodeGen이 필요합니다. 주요 명령:

task test
task build BUMP=0 INSTALL=0

Issue와 Pull Request를 환영합니다. 환경 설정과 릴리스 과정은 DEVELOPMENT.md(중국어), 모듈 경계와 구현 제약은 ARCHITECTURE.md(영어)을 참고하세요.

변경 기록

최신 변경 사항은 CHANGELOG.md(중국어)를 확인하세요.

감사와 라이선스

XStats는 OpenStats를 기반으로 개발되었습니다. 원 프로젝트와 ThirdPartyNotices.md에 명시한 다른 오픈 소스 프로젝트에 감사드립니다. XStats는 Apple 및 본문에 언급한 회사와 관계없는 독립적인 서드파티 앱입니다.

XStats의 새 코드와 수정 부분에는 AGPL-3.0-or-later가 적용됩니다. LICENSE와 LICENSING.md(중국어)를 확인하세요. 기존 OpenStats 코드는 MIT 라이선스를 유지합니다.