Trace

작업 분할 및 세그먼테이션

Trace는 600ms 간격으로 클립보드와 foreground 창을 감시하여 이벤트 스트림을 생성합니다. 이벤트는 FNV-1a 서명과 BGRA 해시로 중복 제거되고 프라이버시 필터링 후 지속 저장됩니다. 사용이 없는 조용한 기간 동안 클러스터링 알고리즘이 스트림을 작업 단위로 분할하며, 각 세그먼트는 제목, 신뢰도, 관련된 앱과 창, 클립보드 항목을 포함한 작업 후보 카드가 됩니다. 사용자는 이 후보를 승인, 병합 또는 무시할 수 있습니다.

작업 허브 기능

작업 카드는 중앙 허브 역할을 하며, 가이드 편집기를 통해 제목 수정, 최근 사용 앱 그리드에서 앱 선택, 클립보드 자료 선택기가 제공됩니다. 각 작업은 생성 시점의 foreground 창을 기억하며, ‘앱 열기’ 액션으로 해당 창 또는 앱의 최신 창로 이동하거나 앱이 없을 경우 실행할 수 있습니다. 사용자는 선반 아이템이나 전송 스테이션의 파일을 작업 카드에 드래그하여 리소스를 명시적으로 바인딩할 수 있으며, 바인딩된 리소스는 OLE을 통해 다른 앱으로 드래그아웃하거나 클립보드 스택 최상단으로 복사할 수 있습니다. 작업 상태는 RUNNING, WAITING, PAUSED, COMPLETED, ARCHIVED 중 하나로 관리되며 모든 전환은 사용자 또는 시스템 출처와 함께 기록됩니다.

선반 위의 노트 기능

작업 선반에는 실시간 렌더링 CodeMirror 기반 마크다운 편집기가 내장되어 있습니다. 제목, 인용구, 작업 목록, 링크가 입력 시 즉시 렌더링되며, Obsidian 스타일의 숨김 마커와 실제 작동하는 체크박스를 지원합니다. 단일 노트 모드(기본 활성화)와 읽기 전용 모드 간 전환이 가능하며, 노트는 디스크에 지속 저장되어 재시작 후에도 현재 노트와 캐럿 위치가 복원됩니다. 중요한 작업은 두 단계 확인 절차를 거칩니다.

파일 전송 스테이션

파일은 클립보드 스택이 아닌 별도의 전송 스테이션에 경로 참조로 저장됩니다. OS 수준의 SetWinEventHook을 사용하는 유틸리티 프로세스가 파일 드래그를 감지하며, 드래그 중에는 컴팩트한 인디케이터만 표시되고 커서가 접근할 때만 선반이 확장됩니다. 파일 드래그아웃에는 복사(원본 유지)와 이동(드래그 시작 시 스테이션에 원본ステージ, 드롭 시 완료) 두 가지 모드가 있으며, 취소 시 파일은 스테이션에 안전하게 유지됩니다. 텍스트나 이미지 드래그인 시 실제 파일로 변환(UTF-8 BOM 텍스트)되어 스테이션에入ります. 파일이 외부에서 이동되거나 삭제되면 스테이션 항목에 배너가 표시되고 파일이 돌아오면 자동으로 복구됩니다.

선반 기본 기능

선반은 화면 가장자리에 3px 히스테리시스 존과 120ms 머무름으로 열리며, 마우스를 멀리하면 유예 기간 후 닫힙니다. collapsed 상태에서는 100% 클릭스루이므로 데스크톱 사용에 영향을 주지 않습니다. 사용자는 왼쪽 또는 오른쪽 모니터 가장자리를 선택할 수 있으며 이 선택은 재부팅 후에도 유지됩니다. 선반은 일반 텍스트, 리치 HTML, URL, 원시 이미지, 멀티 파일 선택을 지원하며 중복 복사는 SHA-256 콘텐츠 해시로 제거됩니다. 멀티 파일 또는 이미지 복사는 스택(최대 10개)으로 그룹화되며 확장/분할/병합 및 단일 파일 및 컬렉션용 프리뷰 플라이아웃을 제공합니다. 네이티브 OLE 드래그아웃을 통해 텍스트는 임시 UTF-8 파일, 이미지와 파일 스택은 실제 파일로 드래그아웃되며, 파일 드래그인은 전송 스테이션으로 들어갑니다. Alt+Tab을 누르고 있으면 시스템 창 목록 대신 검색 가능한 창 전환기가 나타나며, 같은 앱의 창은 한 행으로 그룹화될 수 있습니다. 노트 편집기 또는 고정된 스위처 검색이 포커스를 받을 때 외부 휠 스크롤, 외부 복사, 5초 유휴, 잠금/일시정지 시 선반이 자동으로 축소되도록 설정할 수 있습니다. 선반은 31개 언어 UI와 Graphite, Cobalt, Verdigris, Amber, Violet 5가지 액센트 테마를 지원합니다.

다운로드·설치 방법

Trace는 GitHub 릴리스에서 직접 설치하는 것을 권장합니다. 최신 버전의 Trace-Setup-*.exe 파일을 GitHub 릴리스 페이지에서 다운로드하여 실행하면 됩니다. 추가로 다음 방법들도 제공됩니다:

• npm: npm install -g --allow-scripts=@acidevv/trace @acidevv/trace 또는 한 번 실행을 원한다면 npx --yes @acidevv/trace
• Scoop (자체 버킷): scoop bucket add trace https://github.com/PaRr0tBoY/Trace 후 scoop install trace
• Scoop (Extras 버킷): scoop install trace (PR #18532 대기 중)
• winget: winget install PaRr0tBoY.Trace (PR #417780 대기 중)
• Chocolatey: choco install trace (chocolatey.org에서 심사 대기 중)

npm 패키지는 부트스트랩 역할만 하며, postinstall 과정에서 GitHub 릴리스에서 최신 설치 프로그램을 다운로드하고 SHA-512로 검증한 후 silenzily (/S) 실행합니다. 패키지 내부에 바이너리는 포함되지 않습니다.

기본 사용법

설치 후 Trace를 실행하면 화면 가장자리에 선반이 나타납니다. 마우스를 선반 가장자리에 120ms 이상 머무르면 선반이 열리고, 멀어지면 유예 기간 후 닫힙니다. 선반이 열려 있을 때:

• 클립보드에 텍스트나 이미지를 복사하면 선반의 클립보드 스택에 쌓입니다.
• 파일을 선반으로 드래그하면 전송 스테이션에 경로 참조로 저장됩니다.
• 조용한 기간이 감지되면 선반에 작업 후보 카드가 나타나며, 이를 클릭하여 가이드 편집기에서 제목 수정, 관련 앱 선택, 클립보드 자료 연결 등을 수행할 수 있습니다.
• 작업 카드에서 ‘앱 열기’를 클릭하면 해당 작업과 연결된 창 또는 앱으로 이동합니다.
• 선반의 노트 편집기 아이콘을 클릭하면 마크다운 편집기가 열려 작업과 관련된 메모를 작성할 수 있습니다.
• 전송 스테이션 아이콘을 클릭하면 파일 목록을 확인하고, 파일을 드래그아웃하거나 다른 작업에 바인딩할 수 있습니다.

첫 실행 시 Node.js 18+가 필요하며, npm postinstall 스크립트가 차단된 경우 npm approve-scripts electron esbuild koffi better-sqlite3 node-llama-cpp 명령을 실행한 후 재시도해야 합니다.

지원 환경·시스템 요구사항

Trace는 Windows 10 및 Windows 11에서만 실행됩니다. 이는 Win32 OLE 드래그 및 네이티브 클립보드 형식 접근을 위해 Electron이 필요하기 때문이며, macOS 또는 Linux 포트는 계획되어 있지 않습니다. 설치를 위해서는 Node.js 버전 18 이상이 필요하며, npm 11 이상에서는 기본적으로 postinstall 스크립트가 차단되므로 이 경우 수동으로 스크립트 승인이 필요합니다.

최신 버전·업데이트

현재 버전은 v2026.8.15이며, 이 버전에서 Notes, 전송 스테이션, 스마트 축소, 작업 리소스 모델 네 가지 주요 도메인이 추가되었습니다. 또한 파이프라인 리팩터링(ADR-0005)이 적용되어 제안 파이프라인이 end-to-end로 재구성되었으며, 메모리 시스템이 에피소드→엔티티→사실 그래프 구조로 개선되었습니다. 자동 업데이트는 GitHub 릴리스를 기준으로 이루어지며, 설정에서 토글할 수 있습니다 (기본값: 켬). Microsoft Store 버전은 스토어를 통한 업데이트만 지원합니다.

제한 사항·확인 사항

Trace는 Windows 10/11 전용 소프트웨어로, 다른 운영 체제에서는 실행할 수 없습니다. 또한 최신 버전을 사용하기 위해서는 정기적인 업데이트 확인이 필요하며, 자동 업데이트가 비활성화된 경우 수동으로 GitHub 릴리스에서 설치 프로그램을 다운로드해야 합니다. AI 기능은 별도의 제공자 체인을 설정해야만 작동하며, 기본적으로 비활성화되어 있습니다.

FAQ

• Trace는 무료인가요?
  네, Trace는 Apache-2.0 라이선스로 배포되는 오픈소스 소프트웨어입니다.
• 맥이나 리눅스에서 사용할 수 있나요?
  아니요, Trace는 Windows 10/11 전용이며, 다른 운영 체제 포트는 현재 계획되어 있지 않습니다.
• 인터넷 연결이 필요한가요?
  핵심 기능은 오프라인에서 작동하지만, 자동 업데이트 확인 및 AI 제공자 사용을 위해서는 인터넷 연결이 필요합니다.
• 설치 후 바로 사용할 수 있나요?
  네, 설치 후 실행하면 바로 선반이 나타나며 복사 및 드래그 동작을 통해 작업을 기록하기 시작합니다.
• 작업은 어디에 저장되나요?
  작업 및 관련 데이터는 로컬 디스크에 SQLite 및 JSON 형식으로 저장되며, 클라우드 동기화 기능은 제공되지 않습니다.