Skip to content

RELEASE.md

Latest commit

 

History

History
164 lines (122 loc) · 9.04 KB

RELEASE.md

File metadata and controls

164 lines (122 loc) · 9.04 KB

릴리즈 가이드 — WhereMyTokens

배포 흐름 요약

버전 bump → 빌드 → ZIP + 인스톨러 생성 → 커밋 → 푸시 → GitHub Release

1. 앱 종료

빌드 전 WhereMyTokens가 실행 중이면 release/win-unpacked/ 내 DLL이 잠겨 빌드 실패.

Get-Process -Name 'WhereMyTokens','electron' -ErrorAction SilentlyContinue | Stop-Process -Force

2. 버전 bump

package.json의 "version" 수정:

v1.0.x  — 버그 수정 / UX 개선 / 문서
v1.x.0  — 신기능 추가

릴리즈 파일명 규칙

반드시 아래 형식 유지:

종류 파일명 비고
포터블 ZIP WhereMyTokens-v{VERSION}-win-x64.zip 버전 포함 — 로컬 보관 구분용
NSIS 인스톨러 WhereMyTokens-Setup.exe 버전 생략 — 릴리즈 태그가 버전 보장
  • ZIP: portable, unpacked 등 임의 접미사 금지
  • 인스톨러: electron-builder 기본 생성 파일명(WhereMyTokens Setup {VERSION}.exe)을 WhereMyTokens-Setup.exe로 rename 후 업로드
  • 모든 README / RELEASE.md 이력의 파일명도 동일 형식 사용

3. 빌드

npm run build

오류 없이 완료되면 dist/ 아래 컴파일 결과물 생성.

NSIS 인스톨러 빌드 (Developer Mode 필요)

Windows 설정 → 개인 정보 및 보안 → 개발자용 → 개발자 모드 ON 상태에서:

npm run dist

성공하면 release/ 아래 .exe 인스톨러와 portable .exe 생성.

빌드 후 인스톨러 파일명 변환:

# electron-builder 기본 → 배포 파일명으로 rename
$ver = (Get-Content package.json | ConvertFrom-Json).version
Rename-Item "release\WhereMyTokens Setup $ver.exe" "release\WhereMyTokens-Setup.exe"

Developer Mode 없이 포터블 ZIP만 배포

npm run dist가 winCodeSign symlink 오류로 실패하면, 패키징(win-unpacked)만 완료된 상태에서:

Compress-Archive -Path 'release\win-unpacked\*' `
  -DestinationPath "release\WhereMyTokens-vX.Y.Z-win-x64.zip" -Force

원인: electron-builder의 winCodeSign 패키지가 macOS 심볼릭 링크를 포함하는데, Windows는 Developer Mode 또는 관리자 권한 없이 심볼릭 링크 생성을 차단함.

4. 커밋 & 푸시

git add package.json
git commit -m "chore: 버전 vX.Y.Z — 변경 요약"
git push origin main

5. GitHub Release 생성

gh release create vX.Y.Z \
  "release/WhereMyTokens-vX.Y.Z-win-x64.zip" \
  "release/WhereMyTokens-Setup.exe" \
  --title "WhereMyTokens vX.Y.Z" \
  --notes "## What's New
..."

릴리즈 노트 항목:

  • ### New Features — 신기능
  • ### Improvements — 개선
  • ### Fixes — 버그 수정
  • ## Install — 설치 방법 (항상 포함)

6. 릴리즈 이력 업데이트 (이 파일)

아래 이력에 항목 추가.

릴리즈 이력

버전 날짜 주요 변경
v1.16.1 2026-05-27 Fix budgeted usage ledger completion markers so truncated or failed full-history imports keep background warmup running and stale provider-specific markers do not freeze historical totals
v1.16.0 2026-05-26 Add the persistent usage ledger, instant startup snapshots, Trend history card, hardened ledger privacy/migration behavior, and rebuild warnings for repairable ledger states
v1.15.3 2026-05-25 Route refresh work through a scheduler, coalesce overlapping scans, keep hidden automatic scans budgeted, and preserve manual full refresh as the explicit full-scan path
v1.15.2 2026-05-21 Include archived Codex logs and Claude agent logs in all-time usage, and show all-time session counts from full usage history
v1.15.1 2026-05-21 Keep hotkey popups responsive without losing full-session history, promote watcher catch-up after popup show, and keep tray helper windows out of the taskbar
v1.15.0 2026-05-14 Add a Settings toggle for compact-widget waiting animations, default waiting motion to off to reduce visual interruption, and keep syncing states animated
v1.14.0 2026-05-11 Add Claude OAuth refresh recovery, credential-aware API cache invalidation, safer refresh write/cooldown handling, clearer Claude refresh/login states, and floating widget hide/shortcut recovery
v1.13.2 2026-05-08 Fix Codex weekly limit display by keeping 5-hour and weekly API windows independent, honoring remaining-percent values, and invalidating stale Codex usage cache
v1.13.1 2026-05-07 Add a main-header toggle for the floating Quota Pace widget, fix widget toolbar icon clicks being captured as drag gestures, and document the new control across README/Help
v1.13.0 2026-05-07 Add resilient Codex live usage syncing, provider-specific Quota Pace health chips, safer polling/backoff, and updated multilingual docs for fallback/privacy behavior
v1.12.0 2026-05-06 Add floating Quota Pace widget, main layout customization, elapsed-time usage bars, refreshed README screenshots, and hardened widget/settings/provider synchronization
v1.11.6 2026-04-27 Add installer language selection for English, Korean, Japanese, Simplified Chinese, and Spanish while keeping the EULA in English
v1.11.5 2026-04-26 Stabilize long-running popup session retention, stop scoped refresh growth from changed files, and add gated crash/memory diagnostics
v1.11.4 2026-04-25 Stabilize popup sessions around recent + active work, reduce hidden tray refresh/watch cost, and add main-process perf diagnostics
v1.11.3 2026-04-24 Lower idle background refresh cost, restyle header metadata, clarify Code Output scope, and split GPT-5.4 / GPT-5.5 model colors
v1.11.2 2026-04-24 Release checklist now audits README/Help coverage; README and in-app Help document Partial History startup sync and header status states
v1.11.1 2026-04-24 Streaming JSONL summary cache, startup partial-history sync, Claude API reset diagnostics, and cleaner dashboard loading states
v1.11.0 2026-04-23 Code Output growth chart, stable repo-scoped git stats refresh, faster dashboard splash
v1.10.2 2026-04-23 Align Code Output all-time stats with local branches, distinguish GPT-5.4 Mini colors, document top model usage scope
v1.10.1 2026-04-22 Fix Codex repo discovery for Code Output, share session metadata parsing, add bounded cache and regression tests
v1.10.0 2026-04-22 Claude + Codex tracking, Codex usage accounting, scoped stats, session UX/performance improvements
v1.9.2 2026-04-20 NSIS installer added to release, session tracking accuracy and stability improvements
v1.9.1 2026-04-17 Fix 7d heatmap hover tooltip, README overhaul with screenshot grid, add zh-CN and es translations
v1.9.0 2026-04-17 Teal theme refresh (purple→teal), Auto/Light/Dark system theme, incremental JSONL caching, CSS custom properties, idle 6h+ auto-hide, Activity Breakdown color redesign, Rhythm peak detail stats, Settings/Alerts dark theme fix
v1.8.0 2026-04-17 Header today/all toggle (cost, calls, sessions, cache %, savings, In/Out/Cache tokens), Code Output $/100 lines replacing ROI labels, Rhythm tab cost-based with 30-day data, Plan Usage card cleanup
v1.7.3 2026-04-16 fix: Code Output 이중 집계 — Windows 경로 대소문자 정규화, cross-file dedup 결정적 처리, 워크트리 삭제 시 빈 stats 덮어쓰기 방지
v1.7.2 2026-04-16 fix: git stats 워크트리 삭제 후 소실 — 영속 캐시로 누락 repo 복원, fresh 수집 신선도 우선
v1.7.1 2026-04-16 Code Output: $/commit → Claude ROI ($/1K lines), 효율 레이블(Excellent/Good/Normal/Low/Exploring), all 탭 서브텍스트 +Nk lines로 개선
v1.7.0 2026-04-15 Activity Breakdown 패널 (세션별 카테고리별 output 토큰 분석, 10개 카테고리), 종료 시 crash 수정, 레이아웃 폴리쉬
v1.6.0 2026-04-14 Code Output all-time에 모든 Claude 프로젝트 자동 포함 (~/.claude/projects/ 기반), today 통계 브랜치별 중복제거, git stats 영속 폴백
v1.5.1 2026-04-14 Code Output 중복 집계 수정 (worktree dedup, 본인 커밋만 필터링), 세션 패널 워크트리 프로젝트 그루핑 수정
v1.5.0 2026-04-14 대시보드 리디자인 — 다크 테마 기본, 2단계 세션 그루핑, Code Output, Rhythm 탭, 스크롤바 커스텀, 타임존 배지, 설정 정리, 데모 영상
v1.4.1 2026-04-07 신규 JSONL 파일 생성 시 usage 즉시 갱신, 헤더 토큰/비용 표시 간결화
v1.4.0 2026-04-06 Help 리디자인, Noto Sans 폰트 번들, Help JA 지원, tok 캐시 포함 통일
v1.3.0 2026-04-05 Extra Usage 예산 카드 (월 한도/사용량/% 표시)
v1.2.0 2026-04-05 항상 위젯 모드, 헤더 윈도우 컨트롤, 하단 refresh 탭, API 캐시, 히트맵 자정 정렬
v1.1.0 2026-04-05 5개월 캘린더 히트맵, 스플래시 스크린, API 단절 UX 개선
v1.0.1 2026-04-05 Sonnet 비용 숨김, API 에러 툴팁, 대시 표시
v1.0.0 2026-04-05 최초 릴리즈