release: prepare v0.1.12

Author: linhay

.github/workflows/release.yml

@@ -200,12 +200,8 @@ jobs:
         if: runner.os == 'macOS'
         run: |
           mkdir -p dist/release
-          create-dmg \
-            --volname "GetTokens" \
-            --window-size 660 400 \
-            --icon-size 100 \
-            "dist/release/${{ matrix.asset-name }}" \
-            "build/bin/GetTokens.app"
+          chmod +x scripts/package-macos-dmg.sh
+          scripts/package-macos-dmg.sh "dist/release/${{ matrix.asset-name }}" "build/bin/GetTokens.app"
 
       - name: Sign and notarize macOS DMG
         if: runner.os == 'macOS'

app.go

@@ -258,6 +258,10 @@ type LocalProjectedUsageResponse struct {
 	Details          []LocalProjectedUsageDetail `json:"details"`
 }
 
+type LocalProjectedUsageSettings struct {
+	RefreshIntervalMinutes int `json:"refreshIntervalMinutes"`
+}
+
 func NewApp() *App {
 	return &App{
 		core: wailsapp.New(Version, ReleaseLabel, GitHubRepo),
@@ -401,6 +405,14 @@ func (a *App) GetCodexLocalUsage() (*LocalProjectedUsageResponse, error) {
 	return mapLocalProjectedUsageResponse(result), nil
 }
 
+func (a *App) RefreshCodexLocalUsage() (*LocalProjectedUsageResponse, error) {
+	result, err := a.core.RefreshCodexLocalUsage()
+	if err != nil {
+		return nil, err
+	}
+	return mapLocalProjectedUsageResponse(result), nil
+}
+
 func (a *App) RebuildCodexLocalUsage() (*LocalProjectedUsageResponse, error) {
 	result, err := a.core.RebuildCodexLocalUsage()
 	if err != nil {
@@ -409,6 +421,28 @@ func (a *App) RebuildCodexLocalUsage() (*LocalProjectedUsageResponse, error) {
 	return mapLocalProjectedUsageResponse(result), nil
 }
 
+func (a *App) GetLocalProjectedUsageSettings() (*LocalProjectedUsageSettings, error) {
+	result, err := a.core.GetLocalProjectedUsageSettings()
+	if err != nil {
+		return nil, err
+	}
+	return &LocalProjectedUsageSettings{
+		RefreshIntervalMinutes: result.RefreshIntervalMinutes,
+	}, nil
+}
+
+func (a *App) UpdateLocalProjectedUsageSettings(input LocalProjectedUsageSettings) (*LocalProjectedUsageSettings, error) {
+	result, err := a.core.UpdateLocalProjectedUsageSettings(wailsapp.LocalProjectedUsageSettings{
+		RefreshIntervalMinutes: input.RefreshIntervalMinutes,
+	})
+	if err != nil {
+		return nil, err
+	}
+	return &LocalProjectedUsageSettings{
+		RefreshIntervalMinutes: result.RefreshIntervalMinutes,
+	}, nil
+}
+
 func (a *App) StartCodexOAuth() (*OAuthStartResult, error) {
 	result, err := a.core.StartCodexOAuth()
 	if err != nil {

frontend/package.json

@@ -8,7 +8,7 @@
     "build": "vite build",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
-    "test:unit": "node --test src/utils/version.test.mjs src/utils/pagePersistence.test.mjs src/features/settings/settingsRelease.test.mjs src/features/accounts/tests/accountConfig.test.mjs src/features/accounts/tests/accountFilters.test.mjs src/features/accounts/tests/accountSelectors.test.mjs src/features/accounts/tests/accountSelection.test.mjs src/features/accounts/tests/accountTransfer.test.mjs src/features/accounts/tests/accountPresentation.test.mjs src/features/accounts/tests/accountOAuth.test.mjs src/features/accounts/tests/accountCardInteractions.test.mjs src/features/accounts/tests/accountHealthMeta.test.mjs src/features/accounts/tests/accountRotation.test.mjs src/features/accounts/tests/accountUsage.test.mjs src/features/accounts/tests/usageDesk.test.mjs src/features/accounts/tests/openAICompatible.test.mjs src/components/biz/accountDetailClipboard.test.mjs"
+    "test:unit": "node --test src/utils/version.test.mjs src/utils/pagePersistence.test.mjs src/features/settings/settingsRelease.test.mjs src/features/settings/settingsLocalUsage.test.mjs src/features/accounts/tests/accountConfig.test.mjs src/features/accounts/tests/accountFilters.test.mjs src/features/accounts/tests/accountSelectors.test.mjs src/features/accounts/tests/accountSelection.test.mjs src/features/accounts/tests/accountTransfer.test.mjs src/features/accounts/tests/accountPresentation.test.mjs src/features/accounts/tests/accountOAuth.test.mjs src/features/accounts/tests/accountCardInteractions.test.mjs src/features/accounts/tests/accountHealthMeta.test.mjs src/features/accounts/tests/accountRotation.test.mjs src/features/accounts/tests/accountUsage.test.mjs src/features/accounts/tests/usageDesk.test.mjs src/features/accounts/tests/openAICompatible.test.mjs src/components/biz/accountDetailClipboard.test.mjs"
   },
   "dependencies": {
     "lucide-react": "^1.11.0",

frontend/src/features/accounts/components/UsageDeskWorkspace.tsx

@@ -94,6 +94,7 @@ export interface UsageDeskProjectedStats {
 
 export type UsageDeskChartUnit = 'count' | 'tokens';
 export type UsageDeskRangeOption = 'TODAY' | '7D' | '14D' | '30D' | '全部';
+export type UsageDeskResolution = '1M' | '5M' | '15M' | '30M' | '60M';
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -114,16 +115,22 @@ function buildDayKey(date: Date) {
   return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
 }
 
-function buildMinuteKey(date: Date) {
-  return `${buildDayKey(date)} ${pad2(date.getHours())}:${pad2(date.getMinutes())}`;
+function buildMinuteKey(date: Date, resolution: UsageDeskResolution = '1M') {
+  const mins = date.getMinutes();
+  const resValue = parseInt(resolution);
+  const roundedMins = Math.floor(mins / resValue) * resValue;
+  return `${buildDayKey(date)} ${pad2(date.getHours())}:${pad2(roundedMins)}`;
 }
 
 function buildDayLabel(dayKey: string) {
   return dayKey.slice(5);
 }
 
-function buildMinuteLabel(date: Date) {
-  return `${pad2(date.getHours())}:${pad2(date.getMinutes())}`;
+function buildMinuteLabel(date: Date, resolution: UsageDeskResolution = '1M') {
+  const mins = date.getMinutes();
+  const resValue = parseInt(resolution);
+  const roundedMins = Math.floor(mins / resValue) * resValue;
+  return `${pad2(date.getHours())}:${pad2(roundedMins)}`;
 }
 
 export function formatUsageDeskChartValue(value: number, unit: UsageDeskChartUnit): string {
@@ -196,6 +203,14 @@ export function resolveUsageDeskLinkedRowKey(
   ].join('|');
 }
 
+export function buildUsageDeskChartPointStyle(x: number, y: number) {
+  return {
+    left: `${x}px`,
+    top: `${y}px`,
+    transform: 'translate(-50%, -50%)',
+  };
+}
+
 function formatUsageDeskCompactNumber(value: number): string {
   const normalized = Math.round(value * 10) / 10;
   if (Number.isInteger(normalized)) {
@@ -242,6 +257,7 @@ export function collectUsageDeskObservedDetails(usageData: unknown): UsageDeskOb
 export function buildUsageDeskObservedSnapshot(
   usageData: unknown,
   selectedDayKey?: string | null,
+  resolution: UsageDeskResolution = '1M',
 ): UsageDeskObservedSnapshot {
   const details = collectUsageDeskObservedDetails(usageData);
   if (details.length === 0) {
@@ -304,10 +320,10 @@ export function buildUsageDeskObservedSnapshot(
     const date = parseTimestamp(detail.timestamp);
     if (!date || buildDayKey(date) !== resolvedDayKey) return;
 
-    const minuteKey = buildMinuteKey(date);
+    const minuteKey = buildMinuteKey(date, resolution);
     const minutePoint = minuteMap.get(minuteKey) ?? {
       minuteKey,
-      label: buildMinuteLabel(date),
+      label: buildMinuteLabel(date, resolution),
       success: 0,
       failure: 0,
     };
@@ -320,7 +336,7 @@ export function buildUsageDeskObservedSnapshot(
     minuteMap.set(minuteKey, minutePoint);
 
     const minuteRow = minuteRowMap.get(minuteKey) ?? {
-      timeLabel: buildMinuteLabel(date),
+      timeLabel: buildMinuteLabel(date, resolution),
       provider: detail.provider,
       success: 0,
       failure: 0,
@@ -343,7 +359,7 @@ export function buildUsageDeskObservedSnapshot(
   const minuteRows = Array.from(minuteRowMap.entries())
     .sort((a, b) => b[0].localeCompare(a[0]))
     .map(([, row]) => {
-      if (row.requests === 1) {
+      if (row.requests === 1 && resolution === '1M') {
         return {
           timeLabel: row.timeLabel,
           provider: row.provider,
@@ -406,6 +422,7 @@ export function collectUsageDeskProjectedDetails(payload: unknown): UsageDeskPro
 export function buildUsageDeskProjectedSnapshot(
   payload: unknown,
   selectedDayKey?: string | null,
+  resolution: UsageDeskResolution = '1M',
 ): UsageDeskProjectedSnapshot {
   const details = collectUsageDeskProjectedDetails(payload);
   if (details.length === 0) {
@@ -473,10 +490,10 @@ export function buildUsageDeskProjectedSnapshot(
     const date = parseTimestamp(detail.timestamp);
     if (!date || buildDayKey(date) !== resolvedDayKey) return;
 
-    const minuteKey = buildMinuteKey(date);
+    const minuteKey = buildMinuteKey(date, resolution);
     const point = minuteMap.get(minuteKey) ?? {
       minuteKey,
-      label: buildMinuteLabel(date),
+      label: buildMinuteLabel(date, resolution),
       requests: 0,
       totalTokens: 0,
     };
@@ -486,7 +503,7 @@ export function buildUsageDeskProjectedSnapshot(
     minuteMap.set(minuteKey, point);
 
     const minuteRow = minuteRowMap.get(minuteKey) ?? {
-      timeLabel: buildMinuteLabel(date),
+      timeLabel: buildMinuteLabel(date, resolution),
       provider: detail.provider,
       totalTokens: 0,
       requests: 0,

frontend/src/features/accounts/model/usageDesk.ts

@@ -2,6 +2,7 @@ import test from 'node:test';
 import assert from 'node:assert/strict';
 
 import {
+  buildUsageDeskChartPointStyle,
   buildUsageDeskObservedSnapshot,
   buildUsageDeskProjectedSnapshot,
   collectUsageDeskObservedDetails,
@@ -13,6 +14,14 @@ import {
   resolveUsageDeskRangeDrilldownDayKey,
 } from '../model/usageDesk.ts';
 
+test('buildUsageDeskChartPointStyle keeps hit area centered on the plotted coordinate', () => {
+  assert.deepEqual(buildUsageDeskChartPointStyle(128, 96), {
+    left: '128px',
+    top: '96px',
+    transform: 'translate(-50%, -50%)',
+  });
+});
+
 test('collectUsageDeskObservedDetails keeps provider and model from nested usage payload', () => {
   const details = collectUsageDeskObservedDetails({
     apis: {

frontend/src/features/accounts/tests/usageDesk.test.mjs

@@ -1,11 +1,22 @@
-import { useState } from 'react';
-import { ApplyUpdate, CheckUpdate } from '../../../wailsjs/go/main/App';
+import { useEffect, useState } from 'react';
+import {
+  ApplyUpdate,
+  CheckUpdate,
+  GetLocalProjectedUsageSettings,
+  UpdateLocalProjectedUsageSettings,
+} from '../../../wailsjs/go/main/App';
 import { BrowserOpenURL, Quit } from '../../../wailsjs/runtime/runtime';
 import SegmentedControl from '../../components/ui/SegmentedControl';
 import { useDebug } from '../../context/DebugContext';
 import { useI18n } from '../../context/I18nContext';
 import { useTheme } from '../../context/ThemeContext';
 import { mapCheckedRelease } from './settingsRelease';
+import {
+  localProjectedUsageRefreshIntervalOptions,
+  parseLocalProjectedUsageRefreshIntervalMinutes,
+  resolveLocalProjectedUsageRefreshIntervalID,
+  type LocalProjectedUsageRefreshIntervalID,
+} from './settingsLocalUsage';
 import { toErrorMessage } from '../../utils/error';
 import { formatAppVersion } from '../../utils/version';
 import type { LocaleCode, ReleaseInfo, SegmentedOption, ThemeMode } from '../../types';
@@ -45,9 +56,44 @@ export default function SettingsFeature({
   const [isCheckingUpdate, setIsCheckingUpdate] = useState(false);
   const [isApplyingUpdate, setIsApplyingUpdate] = useState(false);
   const [isOpeningRelease, setIsOpeningRelease] = useState(false);
+  const [localUsageInterval, setLocalUsageInterval] = useState<LocalProjectedUsageRefreshIntervalID>('15');
+  const [localUsageMessage, setLocalUsageMessage] = useState('');
+  const [isLoadingLocalUsageSettings, setIsLoadingLocalUsageSettings] = useState(true);
+  const [isSavingLocalUsageSettings, setIsSavingLocalUsageSettings] = useState(false);
   const currentVersionLabel = formatAppVersion(version);
   const latestReleaseLabel = availableRelease ? formatAppVersion(availableRelease.version) : '—';
 
+  useEffect(() => {
+    let mounted = true;
+
+    async function loadLocalUsageSettings() {
+      setIsLoadingLocalUsageSettings(true);
+      setLocalUsageMessage('');
+      try {
+        const settings = await trackRequest<any>(
+          'GetLocalProjectedUsageSettings',
+          { args: [] },
+          () => GetLocalProjectedUsageSettings(),
+        );
+        if (!mounted) return;
+        setLocalUsageInterval(resolveLocalProjectedUsageRefreshIntervalID(settings?.refreshIntervalMinutes ?? 15));
+      } catch (error) {
+        if (!mounted) return;
+        setLocalUsageMessage(`${t('settings.local_usage_refresh_failed')}: ${toErrorMessage(error)}`);
+      } finally {
+        if (mounted) {
+          setIsLoadingLocalUsageSettings(false);
+        }
+      }
+    }
+
+    void loadLocalUsageSettings();
+
+    return () => {
+      mounted = false;
+    };
+  }, [t, trackRequest]);
+
   async function handleCheckUpdate() {
     setIsCheckingUpdate(true);
     setUpdateMessage('');
@@ -109,6 +155,28 @@ export default function SettingsFeature({
     setIsOpeningRelease(false);
   }
 
+  async function handleLocalUsageIntervalChange(value: LocalProjectedUsageRefreshIntervalID) {
+    setLocalUsageInterval(value);
+    setIsSavingLocalUsageSettings(true);
+    setLocalUsageMessage('');
+    try {
+      const settings = await trackRequest<any>(
+        'UpdateLocalProjectedUsageSettings',
+        { refreshIntervalMinutes: parseLocalProjectedUsageRefreshIntervalMinutes(value) },
+        () =>
+          UpdateLocalProjectedUsageSettings({
+            refreshIntervalMinutes: parseLocalProjectedUsageRefreshIntervalMinutes(value),
+          }),
+      );
+      setLocalUsageInterval(resolveLocalProjectedUsageRefreshIntervalID(settings?.refreshIntervalMinutes ?? 15));
+      setLocalUsageMessage(t('settings.local_usage_refresh_saved'));
+    } catch (error) {
+      setLocalUsageMessage(`${t('settings.local_usage_refresh_failed')}: ${toErrorMessage(error)}`);
+    } finally {
+      setIsSavingLocalUsageSettings(false);
+    }
+  }
+
   return (
     <div className="h-full w-full overflow-auto p-12" data-collaboration-id="PAGE_SETTINGS">
       <div className="mx-auto max-w-6xl space-y-6 pb-10">
@@ -263,6 +331,47 @@ export default function SettingsFeature({
               </div>
             </div>
           </section>
+
+          <section className="space-y-3">
+            <div className="flex items-center gap-2">
+              <span className="bg-[var(--border-color)] px-1.5 py-0.5 font-mono text-[8px] font-black uppercase text-[var(--bg-main)]">
+                03
+              </span>
+              <h3 className="text-xs font-black uppercase italic tracking-tighter text-[var(--text-primary)]">
+                {t('settings.local_usage_refresh')}
+              </h3>
+            </div>
+
+            <div className="card-swiss !p-0 divide-y-2 divide-[var(--border-color)]">
+              <div className="space-y-3 p-5">
+                <div className="flex items-center justify-between">
+                  <label className="text-[9px] font-black uppercase italic tracking-widest text-[var(--text-muted)]">
+                    {t('settings.local_usage_refresh_interval')}
+                  </label>
+                  <span className="font-mono text-[8px] font-bold italic opacity-30 text-[var(--text-muted)]">
+                    LOCAL_PROJECTED_USAGE
+                  </span>
+                </div>
+                <SegmentedControl
+                  options={localProjectedUsageRefreshIntervalOptions}
+                  value={localUsageInterval}
+                  onChange={(value) => void handleLocalUsageIntervalChange(value)}
+                />
+                <div className="text-[9px] font-bold uppercase leading-5 tracking-widest text-[var(--text-muted)]">
+                  {isLoadingLocalUsageSettings
+                    ? t('settings.local_usage_refresh_loading')
+                    : isSavingLocalUsageSettings
+                      ? t('settings.local_usage_refresh_saving')
+                      : t('settings.local_usage_refresh_hint')}
+                </div>
+                {localUsageMessage ? (
+                  <div className="border border-dashed border-[var(--border-color)] bg-[var(--bg-main)] px-3 py-2 text-[9px] font-bold uppercase leading-5 tracking-widest text-[var(--text-primary)]">
+                    {localUsageMessage}
+                  </div>
+                ) : null}
+              </div>
+            </div>
+          </section>
         </div>
       </div>
     </div>

frontend/src/features/settings/SettingsFeature.tsx

@@ -0,0 +1,26 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import {
+  localProjectedUsageRefreshIntervalOptions,
+  parseLocalProjectedUsageRefreshIntervalMinutes,
+  resolveLocalProjectedUsageRefreshIntervalID,
+} from './settingsLocalUsage.ts';
+
+test('resolveLocalProjectedUsageRefreshIntervalID falls back to 15 minutes', () => {
+  assert.equal(resolveLocalProjectedUsageRefreshIntervalID(5), '5');
+  assert.equal(resolveLocalProjectedUsageRefreshIntervalID(30), '30');
+  assert.equal(resolveLocalProjectedUsageRefreshIntervalID(7), '15');
+});
+
+test('parseLocalProjectedUsageRefreshIntervalMinutes converts segmented value to minutes', () => {
+  assert.equal(parseLocalProjectedUsageRefreshIntervalMinutes('5'), 5);
+  assert.equal(parseLocalProjectedUsageRefreshIntervalMinutes('60'), 60);
+});
+
+test('localProjectedUsageRefreshIntervalOptions keep expected order', () => {
+  assert.deepEqual(
+    localProjectedUsageRefreshIntervalOptions.map((option) => option.id),
+    ['5', '15', '30', '60'],
+  );
+});