Work & Log — 기능 안내

VS Code에서 개발 활동(타이핑/마우스)을 측정해 작업 시간으로 집계하고, 필요 시 API로 전송하는 확장입니다. 상태바와 트리 뷰로 진행 상황을 확인하고, 실시간/자동/수동 전송을 모두 지원합니다.

주요 기능

• 실시간 활동 추적:
  • 타이핑/마우스 선택 이벤트를 관찰하여 활동 시간을 누적합니다.
  • 이벤트 간 경과를 임계값으로 상한 처리해 비정상 긴 간격이 과대 집계되지 않도록 합니다.
• 유휴구간 감지:
  • 마지막 이벤트 이후 경과가 idleThresholdSec을 초과하면 활동이 끊어진 것으로 판단합니다.
  • 이 시점에서 세그먼트를 분리해 전송 기간의 정확도를 높입니다.
• 전송 모드:
  • 실시간 전송: 주기(sendIntervalSec)마다 구간 스냅샷을 전송(버퍼 모드 비활성 시).
  • 자동 합계 전송: N분(autoSendTotalIntervalMin)마다 현재 합산 시간만 간소 전송.
  • 수동 즉시 전송: 명령 팔레트로 즉시 전송(버퍼 모드에서는 파일 기반 합산 전송).
• 버퍼 모드:
  • 원시 이벤트를 메모리에 모았다가 임계치 도달 시 NDJSON 파일로 플러시합니다.
  • 네트워크가 불안정하거나 실시간 전송을 원치 않을 때 유용합니다.
• UI:
  • 상태바: “Work&Log: ON • 123s” 형태로 표시, 숫자만 초록색 강조, 상세 툴팁 제공.
  • 트리 뷰: 상태, Task ID, 타이핑/마우스 누적, 유휴구간, 최근 전송 결과를 계층적으로 표시. 각 항목 툴팁 제공.
  • 설정 폼(Webview): Task ID, API 경로 등 주요 값을 폼으로 수정.
• 보안/프라이버시:
  • 비식별화 모드(anonymize)로 프로젝트/파일명 등 민감 정보 전송을 차단할 수 있습니다.
• 안내/오류 처리:
  • 전송 성공/실패, 설정 미완료, 업데이트 등 주요 이벤트는 토스트로 안내합니다.

사용 방법

• 설치: VS Code Marketplace에서 “Work & Log” 설치.
• 기본 흐름:
  1. 설정에서 Task ID를 입력합니다.
  2. 상태바/트리 뷰로 누적 시간을 확인합니다.
  3. 필요 시 “총 작업시간 전송” 또는 “즉시 전송” 명령을 실행합니다.
• 명령(명령 팔레트에서 검색):
  • Work & Log: 추적 켜기/끄기
  • Work & Log: 즉시 전송
  • Work & Log: 총 작업시간 전송
  • Work & Log: Task ID 설정
  • Work & Log: 설정 열기
  • Work & Log: API 설정 및 전송

주요 설정 항목

• worklog.taskEye.taskId: 전송 대상 작업 식별자.
• worklog.sendIntervalSec: 실시간 전송 주기(초).
• worklog.autoSendTotalIntervalMin: 합계 자동 전송 주기(분).
• worklog.idleThresholdSec: 유휴 판단 임계값(초).
• worklog.bufferedMode: 버퍼 모드 사용.
• worklog.enableMouseTracking: 마우스 선택 이벤트 집계 활성화.
• worklog.enableStatusBar: 상태바 표시 활성화.

유휴구간이란?

• 마지막 사용자 이벤트 이후 경과가 idleThresholdSec을 초과해 활동이 끊겼다고 판단되는 지점입니다.
• 이때 세그먼트를 분리하고, 경계 이전/이후의 활동을 분리 계산하여 과대 집계를 방지합니다.

업데이트/배포(요약)

• 마켓에 새 버전이 발행되면 VS Code 기본 설정으로 자동 업데이트됩니다.
• 첫 활성화 시 이전/현재 버전을 비교해 “업데이트됨” 알림을 표시합니다.

변경 내역

0.1.22

• 세컨더리 사이드바로 뷰 컨테이너 이동(viewsContainers.secondary → worklogSecondary).
• Explorer 백업 뷰 추가(설정 기반 노출): worklog.showExplorerBackup 기본 false일 때 숨김, 켜면 Explorer 아래 Work & Log 표시.
• 경고창 모달 전환: 매시간/점심(11:45)/퇴근(17:50) 알림을 모달로 표시하고 “빠른 전송” 액션 제공.
• 일일 알림 1회 보장: 점심/퇴근 알림은 하루에 한 번만 노출.

0.1.21

• 상태바 툴팁 문구 단순화: 빠른 전송 범위 안내만 표기(30분/1시간/2시간/3시간 구간).
• 테스트 경고(worklog.showWarningNow) 문구를 실제 알림 문구(점심/퇴근)로 일관화.

0.1.20

• 빠른 전송(worklog.quickSend) 추가: 상태바 클릭 시 30/60/120/180분 버킷 중 선택 → 전송.
• 랜덤 전송 시간 적용: 선택 버킷별로 아래 범위에서 무작위 초 전송
  • 30분: 25~30분 미만, 1시간: 50~60분 미만, 2시간: 110~120분 미만, 3시간: 170~180분 미만
• 전송 가드 강화: durationSeconds <= 0인 경우 전송하지 않음(sendSegment/sendDurationOnly/스케줄러/즉시전송 모두 반영).
• 커맨드 정리: 중복 등록 제거, 포커스 커맨드 예외 처리 보강.
• 매니페스트 정리: Activity Bar 아이콘 스키마 수정 및 컨테이너/뷰 매핑 일치.

작성: codex (모델: GPT-5)