Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { DEFAULT_FONT_SIZES } from './generated/appearance-tokens';
/**
* Desktop appearance preferences shared by main, preload and renderer.
*
* The persisted file contains only user overrides; callers normally consume
* the effective snapshot returned by main.
*/
export interface AppearanceOverrides {
uiFamily?: string;
codeFamily?: string;
uiSize?: number;
codeSize?: number;
terminalFamily?: string;
terminalSize?: number;
windowZoom?: number;
wallpaperId?: WallpaperId;
wallpaperOverlay?: number;
/** null removes the explicit visibility override. */
wallpaperVisibility?: number | null;
/** Blur radius in CSS pixels; null removes the override (default: off). */
wallpaperBlur?: number | null;
wallpaperMotion?: WallpaperMotion;
}
export type WallpaperMotion = 'static' | 'dynamic';
export const WALLPAPER_DOWNLOAD_PROGRESS_CHANNEL =
'appearance-settings:wallpaper-download-progress';
/** Local Desktop transfer telemetry; never persisted or sent through device-link. */
export interface WallpaperDownloadProgress {
wallpaperId: WallpaperId;
kind: 'image' | 'video';
loaded: number;
total: number;
}
export interface AppearanceSettings {
uiFamily: string;
codeFamily: string;
uiSize: number;
codeSize: number;
terminalFamily: string;
terminalSize: number;
windowZoom: number;
wallpaperId: WallpaperId;
wallpaperOverlay: number;
/** Absent for legacy/default preferences; derive visibility from the theme's old veil. */
wallpaperVisibility?: number | null;
wallpaperBlur?: number | null;
wallpaperMotion: WallpaperMotion;
/** Read-only, host-owned media reference; never accepted by set-patch. */
customWallpaperUrl?: string;
}
/** Keep the terminal's existing platform fallbacks independent of code fonts. */
export const DEFAULT_TERMINAL_FONT_FAMILY =
'"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace';
export const DEFAULT_APPEARANCE_SETTINGS: AppearanceSettings = {
uiFamily: '',
codeFamily: '',
uiSize: DEFAULT_FONT_SIZES.uiSize,
codeSize: DEFAULT_FONT_SIZES.codeSize,
terminalFamily: '',
terminalSize: 13,
windowZoom: 1,
wallpaperId: 'none',
wallpaperOverlay: 0.2,
wallpaperMotion: 'static',
customWallpaperUrl: '',
};
export const APPEARANCE_LIMITS = {
uiSize: { min: 12, max: 24 },
codeSize: { min: 10, max: 24 },
terminalSize: { min: 10, max: 24 },
windowZoom: { min: 0.5, max: 3, step: 0.1 },
wallpaperOverlay: { min: 0, max: 1, step: 0.05 },
wallpaperVisibility: { min: 0, max: 1, step: 0.01 },
wallpaperBlur: { min: 0, max: 20, step: 1 },
} as const;
/** Current picker order; saved selections also accept the hidden compatibility IDs below. */
export const SELECTABLE_WALLPAPER_IDS = [
'none',
'cindy-whisper',
'cindy-night-glance',
'cindy-scarlet-stroll',
'cindy-neon',
'cindy-prism',
'night-launch',
'silent-orbits',
'dune-dawn',
'planet-dawn',
'indigo-folds',
'dune-sphere',
'ocean-clouds',
'rose-quartz',
'custom',
] as const;
/** Removed from the picker; saved selections keep working until the user switches away. */
export const RETIRED_WALLPAPER_IDS = ['cindy-window', 'cindy-studio', 'cindy-dream'] as const;
export const WALLPAPER_IDS = [...SELECTABLE_WALLPAPER_IDS, ...RETIRED_WALLPAPER_IDS] as const;
export type WallpaperId = (typeof WALLPAPER_IDS)[number];
export function normalizeCustomWallpaperUrl(value: unknown): string {
return typeof value === 'string' &&
/^cindy-media:\/\/client-wallpaper\/[0-9a-f]{64}\.(webp|mp4)$/.test(value)
? value
: '';
}
export function isCustomWallpaperVideo(value: unknown): boolean {
return normalizeCustomWallpaperUrl(value).endsWith('.mp4');
}
/** Keep existing 0–60% preferences visually unchanged; extend to a fully opaque veil. */
export function getWallpaperVeil(overlay: number, isDark: boolean): number {
const strength = clampAppearanceWallpaperOverlay(overlay);
const base = isDark ? 65 : 55;
if (strength <= 0.6) return base + strength * 40;
const previousMax = base + 24;
return previousMax + ((strength - 0.6) / 0.4) * (100 - previousMax);
}
export function clampAppearanceWallpaperVisibility(value: number): number {
return Number.isFinite(value) ? roundDecimal(Math.min(1, Math.max(0, value)), 2) : 0;
}
export function clampAppearanceWallpaperBlur(value: number): number {
return clampInteger(
value,
APPEARANCE_LIMITS.wallpaperBlur.min,
APPEARANCE_LIMITS.wallpaperBlur.max,
0,
);
}
/** Old settings retain their exact Light/Dark appearance until explicitly adjusted. */
export function getWallpaperVisibility(
settings: Pick<AppearanceSettings, 'wallpaperOverlay' | 'wallpaperVisibility'>,
isDark: boolean,
): number {
return typeof settings.wallpaperVisibility === 'number' &&
Number.isFinite(settings.wallpaperVisibility)
? clampAppearanceWallpaperVisibility(settings.wallpaperVisibility)
: (100 - getWallpaperVeil(settings.wallpaperOverlay, isDark)) / 100;
}
export function clampAppearanceWallpaperOverlay(
value: number,
fallback = DEFAULT_APPEARANCE_SETTINGS.wallpaperOverlay,
): number {
if (!Number.isFinite(value)) return fallback;
const stepped =
Math.round(value / APPEARANCE_LIMITS.wallpaperOverlay.step) *
APPEARANCE_LIMITS.wallpaperOverlay.step;
return roundDecimal(
Math.min(
APPEARANCE_LIMITS.wallpaperOverlay.max,
Math.max(APPEARANCE_LIMITS.wallpaperOverlay.min, stepped),
),
2,
);
}
export function clampAppearanceUiSize(
value: number,
fallback = DEFAULT_APPEARANCE_SETTINGS.uiSize,
): number {
return clampInteger(value, APPEARANCE_LIMITS.uiSize.min, APPEARANCE_LIMITS.uiSize.max, fallback);
}
export function clampAppearanceCodeSize(
value: number,
fallback = DEFAULT_APPEARANCE_SETTINGS.codeSize,
): number {
return clampInteger(
value,
APPEARANCE_LIMITS.codeSize.min,
APPEARANCE_LIMITS.codeSize.max,
fallback,
);
}
export function clampAppearanceTerminalSize(
value: number,
fallback = DEFAULT_APPEARANCE_SETTINGS.terminalSize,
): number {
return clampInteger(
value,
APPEARANCE_LIMITS.terminalSize.min,
APPEARANCE_LIMITS.terminalSize.max,
fallback,
);
}
export function clampAppearanceWindowZoom(
value: number,
fallback = DEFAULT_APPEARANCE_SETTINGS.windowZoom,
): number {
if (!Number.isFinite(value)) return fallback;
const stepped =
Math.round(value / APPEARANCE_LIMITS.windowZoom.step) * APPEARANCE_LIMITS.windowZoom.step;
return roundDecimal(
Math.min(APPEARANCE_LIMITS.windowZoom.max, Math.max(APPEARANCE_LIMITS.windowZoom.min, stepped)),
2,
);
}
export function normalizeAppearanceSettings(raw: unknown): AppearanceSettings {
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
return { ...DEFAULT_APPEARANCE_SETTINGS };
}
const value = raw as Record<string, unknown>;
return {
uiFamily: normalizeFamily(value.uiFamily),
codeFamily: normalizeFamily(value.codeFamily),
terminalFamily: normalizeFamily(value.terminalFamily),
uiSize:
typeof value.uiSize === 'number'
? clampAppearanceUiSize(value.uiSize)
: DEFAULT_APPEARANCE_SETTINGS.uiSize,
codeSize:
typeof value.codeSize === 'number'
? clampAppearanceCodeSize(value.codeSize)
: DEFAULT_APPEARANCE_SETTINGS.codeSize,
terminalSize:
typeof value.terminalSize === 'number'
? clampAppearanceTerminalSize(value.terminalSize)
: DEFAULT_APPEARANCE_SETTINGS.terminalSize,
windowZoom:
typeof value.windowZoom === 'number'
? clampAppearanceWindowZoom(value.windowZoom)
: DEFAULT_APPEARANCE_SETTINGS.windowZoom,
wallpaperId: normalizeWallpaperId(value.wallpaperId),
wallpaperOverlay:
typeof value.wallpaperOverlay === 'number'
? clampAppearanceWallpaperOverlay(value.wallpaperOverlay)
: DEFAULT_APPEARANCE_SETTINGS.wallpaperOverlay,
wallpaperMotion: value.wallpaperMotion === 'dynamic' ? 'dynamic' : 'static',
...(typeof value.wallpaperBlur === 'number' && Number.isFinite(value.wallpaperBlur)
? { wallpaperBlur: clampAppearanceWallpaperBlur(value.wallpaperBlur) }
: {}),
...(typeof value.wallpaperVisibility === 'number' && Number.isFinite(value.wallpaperVisibility)
? { wallpaperVisibility: clampAppearanceWallpaperVisibility(value.wallpaperVisibility) }
: {}),
customWallpaperUrl: normalizeCustomWallpaperUrl(value.customWallpaperUrl),
};
}
function normalizeWallpaperId(value: unknown): WallpaperId {
return typeof value === 'string' && (WALLPAPER_IDS as readonly string[]).includes(value)
? (value as WallpaperId)
: (DEFAULT_APPEARANCE_SETTINGS.wallpaperId as WallpaperId);
}
function normalizeFamily(value: unknown): string {
return typeof value === 'string' ? value.trim().slice(0, 256) : '';
}
function clampInteger(value: number, min: number, max: number, fallback: number): number {
if (!Number.isFinite(value)) return fallback;
return Math.min(max, Math.max(min, Math.round(value)));
}
function roundDecimal(value: number, places: number): number {
const factor = 10 ** places;
return Math.round(value * factor) / factor;
}