ONESHIM Rust 데스크톱 클라이언트
AI 기반 자율 사무 업무 지원 에이전트의 Rust 네이티브 데스크톱 클라이언트입니다.
최신 버전
v0.3.0 - macOS, Windows, Linux 지원 | gRPC 클라이언트 추가 | GitHub Releases
사용자 가이드
실제 사용 흐름과 화면을 보려면 고객 여정 가이드 를 참조하세요.
Git Submodule
client-rust/는 pseudotop/oneshim-client 퍼블릭 레포의 git submodule입니다.
클론 시 git clone --recurse-submodules 또는 git submodule update --init을 실행하세요.
주요 기능
| 기능 | 설명 |
|---|---|
| 실시간 컨텍스트 모니터링 | 활성 창, 시스템 리소스, 사용자 활동 추적 |
| Edge 이미지 처리 | 스크린샷 캡처, 변경 감지, 썸네일, OCR |
| Edge Intelligence | 로컬 집중도 분석, 작업 세션 추적, 스마트 제안 생성 |
| 로컬 웹 대시보드 | 브라우저에서 실시간 모니터링 및 설정 |
| gRPC + REST 통신 | gRPC 우선, REST fallback 지원 |
| 실시간 제안 수신 | 서버에서 스트리밍되는 제안을 실시간으로 수신 및 피드백 |
| 자율 UI 자동화 | OCR/LLM 기반 UI 요소 탐색, 정책 기반 안전 실행 |
| OS 네이티브 샌드박스 | 운영체제별 격리 환경에서 자동화 실행 |
| 워크플로우 프리셋 | 내장 프리셋 + 사용자 정의 워크플로우 자동화 |
| 시스템 트레이 | 백그라운드 실행 및 빠른 접근 |
| 자동 업데이트 | GitHub Releases 기반 자동 업데이트 |
| 다국어 지원 | 한국어/영어 자동 감지 (i18n) |
| 크로스 플랫폼 | macOS, Windows, Linux 지원 |
아키텍처 개요
모듈화된 Cargo workspace로 구성되며, Hexagonal Architecture (Ports & Adapters) 패턴을 따릅니다.
각 모듈은 독립적으로 테스트 가능하며, 코어 인터페이스를 통해 느슨하게 결합됩니다.
모듈 상세 문서
| 모듈 | 역할 | 문서 |
|---|---|---|
| Core | 도메인 모델, 포트 인터페이스, 공통 설정 | 상세 |
| Network | gRPC/HTTP/SSE 통신, 인증, AI 서비스 연동 | 상세 |
| Vision | 이미지 캡처, 변경 감지, OCR, 프라이버시 보호 | 상세 |
| Monitor | 시스템 메트릭, 활성 창, 유휴 감지, 입력 활동 | 상세 |
| Storage | 로컬 데이터 저장, 보존 정책, Edge Intelligence | 상세 |
| Suggestion | 제안 큐, 피드백, 이력 관리 | 상세 |
| UI | 시스템 트레이, 알림, 테마, 자동화 토글 | 상세 |
| Web | 로컬 웹 대시보드, REST API, E2E 테스트 | 상세 |
| Automation | 정책 기반 실행, 감사 로깅, OS 샌드박스, 프리셋 | 상세 |
| App | DI 와이어링, 스케줄러, 자동 업데이트 | 상세 |
빠른 시작
요구 사항
- Rust 1.75 이상
- macOS 10.15+ / Windows 10+ / Linux (X11/Wayland)
빌드 및 실행
# 개발 빌드
cargo build -p oneshim-app
# 릴리즈 빌드
cargo build --release -p oneshim-app
# 환경 변수 설정 후 실행
export ONESHIM_EMAIL="your@email.com"
export ONESHIM_PASSWORD="your-password"
cargo run -p oneshim-app
테스트
# 전체 테스트
cargo test --workspace
# 린트
cargo clippy --workspace
# 포맷 검사
cargo fmt --check
설치
바이너리 다운로드
Releases 페이지에서 플랫폼에 맞는 바이너리를 다운로드하세요.
| 플랫폼 | 파일 |
|---|---|
| macOS Universal | oneshim-macos-universal.tar.gz |
| macOS Apple Silicon | oneshim-macos-arm64.tar.gz |
| macOS Intel | oneshim-macos-x64.tar.gz |
| Windows x64 | oneshim-windows-x64.zip |
| Linux x64 | oneshim-linux-x64.tar.gz |
설정
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
ONESHIM_EMAIL | 로그인 이메일 | (필수) |
ONESHIM_PASSWORD | 로그인 비밀번호 | (필수) |
RUST_LOG | 로그 레벨 | info |
설정 파일
~/.config/oneshim/config.toml (Linux/macOS) 또는 %APPDATA%\oneshim\config.toml (Windows)에서 서버 연결, 모니터링 주기, 저장소 보존 정책, 이미지 처리 설정, 자동 업데이트 등을 구성할 수 있습니다.
데이터 흐름
자동화 실행 흐름
관련 문서: