섬 Daozai란
섬은 Windows 10/11 x64용 데스크톱 동반자입니다. Rust와 egui로 제작되었으며 Electron에 의존하지 않습니다. 기본적으로 화면 상단에 붙어 있다가 접히면 작은 노치 형태로 표시되고, 마우스를 가까이 가져가면 펼쳐지며 마우스가 멀어지면 다시 접힙니다.
섬은 데스크톱 공간을 계속 차지하지 않고 필요할 때 정보가 나타나도록 설계되었습니다. 음악, 가사, 이메일 인증 코드, 일정, 할 일, 집중, 수분 섭취 기록, 임시 파일과 AI 사용량 등 데스크톱 작업을 한곳에서 처리할 수 있습니다.
핵심 기능 개요
- 데스크톱 동반자: 눈 깜빡임, 낮잠, 물 마시기 등의 상호작용을 지원하며 미니멀 모드로 전환할 수도 있습니다.
- 음악 및 가사: Windows 미디어 세션을 읽어 재생, 곡 변경과 재생 위치를 제어하고 한 줄 가사를 표시합니다.
- 집중 및 수분 섭취: 집중／휴식 타이머를 사용하고 수분 섭취량을 기록하며 목표와 알림 시간을 설정할 수 있습니다. 빠른 기록과 실행 취소도 지원합니다.
- 파일 선반: 파일을 임시로 모으고 원본 파일을 열거나 위치를 찾을 수 있으며, 파일을 다른 앱으로 끌어 놓을 수도 있습니다. 선반에서 제거해도 원본 파일은 삭제되지 않습니다.
- 할 일: 작업을 추가, 편집 및 완료하고 선택적으로 날짜와 시간 알림을 설정할 수 있습니다.
- 메일: 여러 이메일 계정을 연결하고 인증 코드의 출처를 식별하며, 클릭해 인증 코드를 복사하고 본문을 읽거나 기본 브라우저에서 링크를 열 수 있습니다.
- 일정: 월간 캘린더와 당일 일정을 확인하고 업무 캘린더와 이메일 초대를 통합합니다. 종일, 여러 날, 반복 일정과 단일 일정의 수정 또는 취소를 지원합니다.
- AI 사용량: Codex, Claude, Kimi, Grok Bot 및 Gemini를 지원합니다. 여러 계정을 관리하고 초기화 시간을 확인하며 상시 표시 원형과 색상을 사용자 지정할 수 있습니다.
- 시스템 상태: 전원, 배터리, 네트워크, 볼륨, Caps Lock, 입력 언어와 Bluetooth 기기 상태를 표시합니다.
섬 설치
설치 버전 사용
- 최신 Releases 페이지를 엽니다.
- 해당 버전의
Daozai-Setup-v0.6.50-x64.exe설치 프로그램을 다운로드합니다. 정확한 파일 이름은 버전에 따라 달라질 수 있습니다. - 설치 프로그램을 두 번 클릭하고 설치 위치를 선택한 다음, 필요에 따라 바탕 화면 바로 가기와 시작 시 자동 실행 여부를 결정합니다.
- “한 번에 설치”를 클릭한 뒤 바탕 화면 바로 가기나 시작 메뉴에서 “섬”을 실행합니다.
- 트레이 메뉴의 설정을 열고 필요에 따라 음악, 메일, 일정, AI 사용량 또는 기타 기능을 활성화합니다.
최초 설치 시 바탕 화면 바로 가기는 기본적으로 선택되어 있으며 시작 시 자동 실행은 기본적으로 꺼져 있습니다. 설치 프로그램의 압축을 풀 필요는 없습니다.
무설치 압축 패키지 사용
설치 프로그램을 사용하지 않으려면 Daozai-v0.6.50-windows-x64.zip과 같은 무설치 버전을 다운로드한 뒤 전체 압축을 풀고 그 안의 daozai.exe를 실행하면 됩니다. 무설치 버전을 사용하더라도 프로그램은 기본적으로 현재 사용자의 데이터 디렉터리에 앱 데이터를 저장합니다.
시스템 요구 사항 및 다운로드 검증
섬은 현재 Windows 10/11 x64용 빌드 패키지를 제공하며 OpenGL을 지원하는 그래픽 드라이버가 필요합니다. macOS, Linux 또는 ARM64용 빌드 패키지는 제공하지 않습니다. Windows 10, 그래픽 카드 종류와 다중 모니터 조합에 따라 호환성 차이가 발생할 수 있습니다.
Release 페이지에는 SHA256SUMS.txt가 포함되어 있습니다. PowerShell에서 다음 명령으로 다운로드 파일의 SHA-256 값을 계산할 수 있습니다.
Get-FileHash -Algorithm SHA256 .\Daozai-Setup-v0.6.50-x64.exe현재 프로그램에는 상용 코드 서명이 적용되지 않아 Windows에서 알 수 없는 게시자 경고가 표시될 수 있습니다. 실행하기 전에 저장소 출처와 파일 체크섬을 확인하세요.
첫 사용: 상단 패널에서 시작하기
실행 후 섬은 일반적으로 화면 상단에 접힌 상태로 표시됩니다. 마우스를 상단 영역으로 이동하면 패널이 펼쳐지고, 마우스가 멀어지면 다시 접힙니다. 해당 기능을 활성화하면 필요한 정보가 상단에 표시됩니다.
집중 및 수분 섭취 목표 설정
- 설정 또는 상단 패널에서 집중 기능을 엽니다.
- 집중 시간을 시작하고 집중 단계와 휴식 단계 사이를 전환합니다.
- 수분 섭취 패널을 열고 오늘의 수분 섭취 목표와 알림 시간을 설정합니다.
- 빠른 작업으로 수분 섭취량을 기록합니다. 잘못 기록했다면 실행 취소 기능을 사용할 수 있습니다.
할 일 관리
- 할 일 패널을 열고 작업을 추가합니다.
- 알림이 필요하면 작업의 날짜와 시간을 선택합니다.
- 작업을 완료한 후 해당 항목을 선택합니다.
- 편집 메뉴에서 작업 내용이나 알림 설정을 수정합니다.
파일 선반 사용
파일을 선반으로 끌어 놓으면 나중에 처리할 항목을 임시로 한곳에 모아둘 수 있습니다. 파일을 열거나 원본 파일의 위치를 찾거나, 선반에서 다른 앱으로 파일을 끌어 놓을 수 있습니다. 선반 기록을 제거해도 디스크의 원본 파일은 삭제되지 않으므로 파일 백업이 아닌 임시 수집 용도로 적합합니다.
음악 제어 및 가사 확인
음악 기능을 활성화하면 섬이 Windows 미디어 세션을 읽습니다. 상단 패널에서 재생, 일시 정지, 곡 변경과 재생 위치를 제어할 수 있으며, 지원되는 경우 한 줄 가사도 확인할 수 있습니다. 데스크톱 동반자는 마이크를 들고 음악에 맞춰 상호작용 효과를 보여 주기도 합니다.
메일, 캘린더 및 AI 서비스 연결
메일 설정
섬은 QQ, 163, 126, Tencent 기업 메일, iCloud 및 Gmail 등의 메일 서비스를 지원하며 IMAP을 사용해 메일을 가져옵니다. 서비스 제공업체의 요구 사항에 따라 웹 로그인 비밀번호가 아닌 인증 코드나 앱 전용 비밀번호를 입력해야 할 수 있습니다.
- 설정에서 메일 연결 기능으로 이동합니다.
- 메일 서비스 제공업체를 선택하고 계정을 추가합니다.
- 서비스 제공업체의 요구 사항에 따라 이메일 주소, 서버 정보와 인증 코드 또는 앱 전용 비밀번호를 입력합니다.
- 저장한 후 섬이 받은 편지함을 읽을 때까지 기다립니다.
섬은 메일에 포함된 인증 코드의 출처를 식별하며, 인증 코드를 클릭해 복사할 수 있습니다. 본문을 읽고 기본 브라우저에서 메일의 링크를 열 수도 있습니다. 프로그램은 받은 편지함을 읽으며 스팸 메일 폴더는 읽지 않습니다.
업무 캘린더 설정
업무 캘린더는 CalDAV를 통해 연결됩니다. 현재 지원되는 서비스는 Feishu, DingTalk 및 WeCom입니다. 이러한 플랫폼의 데스크톱 앱을 설치했다고 해서 별도의 캘린더 계정 권한이 자동으로 부여되는 것은 아닙니다. 연결할 때는 플랫폼에서 제공하는 별도의 캘린더 계정과 비밀번호가 필요합니다.
공식 캘린더 초대는 자동으로 일정에 추가됩니다. 일반 메일 본문에 날짜가 포함되어 있어도 일정이 자동으로 생성되지는 않습니다. 업무 캘린더와 메일에 있는 동일한 일정은 UID와 시작 시간을 기준으로 중복을 제거하며, 출처 표시는 유지됩니다.
메일 일정이 표시되지 않도록 하려면 무시할 수 있으며, 이후 상세 정보에서 복원할 수도 있습니다. 일정 목록에서 마우스 휠을 사용하면 아래 목록만 스크롤되고 큰 카드는 현재 선택 항목을 유지합니다. 다른 일정을 클릭해야 상세 정보가 전환됩니다.
AI 사용량 확인
섬은 Codex, Claude, Kimi, Grok Bot 및 Gemini의 사용량 표시를 지원합니다. 접힌 상태에서는 원형 표시를 통해 사용량을 확인할 수 있고, 펼치면 계정과 초기화 시간을 확인할 수 있습니다. 여러 계정을 구성하고 상시 표시할 서비스를 선택하며 색상도 사용자 지정할 수 있습니다.
서비스마다 연결 방식, 계정 유형과 구독 이용 가능 여부가 다를 수 있습니다. 사용하기 전에 해당 서비스의 로컬 로그인 상태나 별도의 연결 방식을 통해 인증을 완료해야 합니다.
업데이트, 제거 및 데이터 보존
앱 내 업데이트
- “설정 → 정보”를 엽니다.
- “업데이트 확인”을 클릭합니다.
- 최신 정식 버전과 업데이트 내용을 확인합니다.
- 필요에 따라 “다운로드 및 설치”, “브라우저로 다운로드” 또는 “나중에”를 선택합니다.
앱 내 다운로드가 완료되고 검증을 통과하면 재시작하여 업데이트를 완료합니다. Releases 페이지에서 새 버전을 수동으로 다운로드해 다시 설치할 수도 있습니다. 업데이트해도 기존 설정과 기록은 삭제되지 않습니다.
앱 제거
Windows의 “설치된 앱”에서 섬을 제거할 수 있습니다. 프로젝트 설명에 따르면 제거해도 사용자 데이터는 보존됩니다.
로컬 데이터 확인
설정, 할 일, 수분 섭취 기록, 선반 경로와 연결 메타데이터는 %APPDATA%\Daozai에 저장됩니다. 메일과 캘린더 비밀번호는 Windows 자격 증명 관리자에 저장되며 Gemini 세션은 Windows DPAPI로 암호화됩니다.
기존 AI 클라이언트의 로그인 정보를 읽을 때 섬은 원래 클라이언트의 설정에 다시 기록하지 않습니다. 인증 코드, Cookie 또는 로그인 JSON을 Issue에 업로드하지 마세요. 메일, 캘린더 또는 가사 기능을 활성화하면 프로그램이 해당 서비스 제공업체의 API에 액세스하므로 완전한 오프라인 소프트웨어는 아닙니다.
소스 코드에서 빌드
개발에 참여하거나 직접 컴파일하려면 Rust stable, MSVC C++ 빌드 도구와 Windows SDK를 준비해야 합니다. 최신 stable Rust를 사용하고 Windows MSVC 툴체인을 선택하는 것이 좋습니다.
rustup default stable-x86_64-pc-windows-msvc
cargo build --locked --release --bin daozai
.\target\release\daozai.exe테스트 실행 및 패키징
cargo test --locked --all-targets --features record -- --test-threads=1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\package.ps1의존 프로세스 환경 변수의 데이터 디렉터리 테스트를 격리하려면 단일 스레드로 테스트하는 것이 좋습니다. 메모리가 적은 기기에서는 $env:CARGO_BUILD_JOBS = "1"을 설정할 수 있습니다. 패키징에는 NSIS 3가 필요하며, -NsisCompiler 매개변수로 makensis.exe를 지정할 수도 있습니다.
릴리스 스크립트는 프로그램 버전과 런타임 라이브러리 종속성을 확인하고 단일 파일 EXE 설치 프로그램, 경량 무설치 ZIP 및 SHA-256 체크섬 파일을 생성합니다. 프로젝트 구조, 인터페이스 미리 보기와 기여 방법은 개발 가이드에서 확인할 수 있습니다.
사용 시 주의 사항
- 기본 기능부터 시작하세요: 먼저 할 일, 집중 또는 음악 기능을 활성화한 뒤 필요에 따라 메일, 캘린더와 AI 서비스를 연결할 수 있습니다.
- 인증 정보를 안전하게 보관하세요: 메일 인증 코드, Cookie와 로그인 JSON을 Issue나 기타 공개된 장소에 게시해서는 안 됩니다.
- 서비스 이용 가능 여부를 확인하세요: 메일, 캘린더 플랫폼, AI 계정과 구독에 따라 연결 기능이 다를 수 있으며, 저장소의 지원 목록이 모든 계정의 동기화를 보장하지는 않습니다.
- 캘린더 출처에 유의하세요: 공식 캘린더 초대는 일정에 추가되지만 일반 메일 본문의 날짜는 자동으로 일정을 생성하지 않습니다.
- 선반과 삭제를 구분하세요: 파일 선반에서 항목을 제거하면 기록만 삭제되며 원본 파일은 삭제되지 않습니다.
- 업데이트 전에 검증 정보를 보관하세요: 새 버전을 다운로드할 때 Release 페이지와
SHA256SUMS.txt를 함께 사용해 파일 출처를 확인하는 것이 좋습니다.
정리
섬 Daozai는 데스크톱 동반자, 음악 가사, 집중 및 수분 섭취, 할 일, 파일 임시 보관, 메일, 일정과 AI 사용량을 화면 상단에 통합하고, 접힌 상태와 마우스 접근 시 펼쳐지는 방식을 통해 방해를 줄입니다. Windows 버전을 설치한 뒤 할 일과 집중 기능부터 시작해 메일, 캘린더와 AI 서비스를 단계적으로 연결할 수 있습니다. 사용자 지정이나 개발 참여가 필요하다면 Rust와 Windows 툴체인으로 소스 코드에서 빌드할 수도 있습니다.
사용을 시작하기 전에 최신 버전 페이지에서 프로그램을 다운로드하고 사용 가이드에서 자세한 사용 방법을 확인할 수 있습니다.