Skip to content

LLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。

TypeScript

fix: polish interface zoom persistence

nash_su19fabce95101
diff --git a/src/App.tsx b/src/App.tsx
index 272f6ad6..7114388b 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -7,6 +7,7 @@ import { useWikiStore } from "@/stores/wiki-store"
import { useReviewStore } from "@/stores/review-store"
import { useLintStore } from "@/stores/lint-store"
import { useChatStore } from "@/stores/chat-store"
+import { BASE_FONT_SIZE_PX, useZoomStore } from "@/stores/zoom-store"
import { listDirectory, openProject } from "@/commands/fs"
import { getLastProject, getRecentProjects, saveLastProject, loadLlmConfig, loadLanguage, loadSearchApiConfig, loadEmbeddingConfig, loadMineruConfig, loadMultimodalConfig, loadOutputLanguage, loadProviderConfigs, loadActivePresetId, loadProxyConfig, loadScheduledImportConfig, saveScheduledImportConfig, loadSourceWatchConfig, loadApiConfig, loadGeneralConfig, loadZoomLevel } from "@/lib/project-store"
import { loadReviewItems, loadLintItems, loadChatHistory } from "@/lib/persist"
@@ -17,12 +18,17 @@ import { WelcomeScreen } from "@/components/project/welcome-screen"
import { CreateProjectDialog } from "@/components/project/create-project-dialog"
import type { WikiProject } from "@/types/wiki"
+function applyDocumentZoom(level: number) {
+ document.documentElement.style.fontSize = `${BASE_FONT_SIZE_PX * level}px`
+}
+
function App() {
const project = useWikiStore((s) => s.project)
const setProject = useWikiStore((s) => s.setProject)
const setFileTree = useWikiStore((s) => s.setFileTree)
const setSelectedFile = useWikiStore((s) => s.setSelectedFile)
const setActiveView = useWikiStore((s) => s.setActiveView)
+ const zoomLevel = useZoomStore((s) => s.level)
const [showCreateDialog, setShowCreateDialog] = useState(false)
const [loading, setLoading] = useState(true)
@@ -32,6 +38,13 @@ function App() {
startClipWatcher()
}, [])
+ useEffect(() => {
+ // Apply interface zoom globally, including welcome/settings screens. We
+ // scale the rem base instead of using transform: scale() so layout and
+ // pointer coordinates remain native; fixed-pixel panels keep their caps.
+ applyDocumentZoom(zoomLevel)
+ }, [zoomLevel])
+
// Dev-only helper for visually testing the update-banner UX.
// Open dev tools and run:
// __llmwiki_testUpdateBanner()
@@ -179,6 +192,10 @@ function App() {
useEffect(() => {
async function init() {
try {
+ const savedZoom = await loadZoomLevel()
+ applyDocumentZoom(savedZoom)
+ useZoomStore.getState().setLevel(savedZoom)
+
const savedConfig = await loadLlmConfig()
if (savedConfig) {
useWikiStore.getState().setLlmConfig(savedConfig)
@@ -271,11 +288,6 @@ function App() {
if (savedLang) {
await i18n.changeLanguage(savedLang)
}
- const savedZoom = await loadZoomLevel()
- if (savedZoom !== 1) {
- const { useZoomStore } = await import("@/stores/zoom-store")
- useZoomStore.getState().setLevel(savedZoom)
- }
const lastProject = await getLastProject()
if (lastProject) {
try {
diff --git a/src/components/layout/app-layout.tsx b/src/components/layout/app-layout.tsx
index 1d1c8533..9a2870ba 100644
--- a/src/components/layout/app-layout.tsx
+++ b/src/components/layout/app-layout.tsx
@@ -1,6 +1,5 @@
import { useCallback, useEffect, useRef, useState } from "react"
import { useWikiStore } from "@/stores/wiki-store"
-import { useZoomStore } from "@/stores/zoom-store"
import { listDirectory } from "@/commands/fs"
import { normalizePath } from "@/lib/path-utils"
import { IconSidebar } from "./icon-sidebar"
@@ -91,18 +90,6 @@ export function AppLayout({ onSwitchProject }: AppLayoutProps) {
const isSettings = activeView === "settings"
const hasRightPanel = !isSettings && !!(selectedFile || researchPanelOpen)
- // Zoom — adjust root font-size so all rem units scale proportionally.
- // Using `transform: scale()` would also zoom visually, but it doesn't
- // change actual layout dimensions, causing mouse coordinates to drift
- // during sidebar drag-resize and container alignment issues. Changing
- // the rem base avoids those problems because every layout unit expands
- // natively — Tailwind uses rem for spacing, typography, and sizing, so
- // the whole UI scales correctly.
- const zoomLevel = useZoomStore((s) => s.level)
- useEffect(() => {
- document.documentElement.style.fontSize = `${16 * zoomLevel}px`
- }, [zoomLevel])
-
return (
// Outer column layout: full-width update banner on top (when an
// update is available AND not dismissed for this version), the
diff --git a/src/components/settings/sections/interface-section.tsx b/src/components/settings/sections/interface-section.tsx
index 0bb5838d..3ea18551 100644
--- a/src/components/settings/sections/interface-section.tsx
+++ b/src/components/settings/sections/interface-section.tsx
@@ -4,6 +4,7 @@ import { Plus, Minus } from "lucide-react"
import type { SettingsDraft, DraftSetter } from "../settings-types"
import type { AppTheme } from "@/lib/theme"
import { useState, useEffect } from "react"
+import { MAX_ZOOM_LEVEL, MIN_ZOOM_LEVEL, ZOOM_STEP, clampZoomLevel, roundZoomLevel } from "@/stores/zoom-store"
interface Props {
draft: SettingsDraft
@@ -22,14 +23,6 @@ const THEMES = [
{ value: "system" as const, labelKey: "settings.sections.interface.themeSystem" },
]
-const MIN_ZOOM = 0.5
-const MAX_ZOOM = 3
-const STEP = 0.05
-
-function clampZoom(v: number): number {
- return Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, v))
-}
-
export function InterfaceSection({ draft, setDraft, onThemeChange }: Props) {
const { t } = useTranslation()
const level = draft.zoomLevel
@@ -41,14 +34,14 @@ export function InterfaceSection({ draft, setDraft, onThemeChange }: Props) {
}, [level])
const handleZoom = (next: number) => {
- setDraft("zoomLevel", clampZoom(next))
+ setDraft("zoomLevel", clampZoomLevel(roundZoomLevel(next)))
}
const commitInput = () => {
const raw = inputText.replace(/[^0-9.]/g, "")
const parsed = parseFloat(raw)
if (!isNaN(parsed) && parsed > 0) {
- setDraft("zoomLevel", clampZoom(parsed / 100))
+ setDraft("zoomLevel", clampZoomLevel(parsed / 100))
} else {
// Reset to current draft value
setInputText(String(Math.round(level * 100)))
@@ -122,10 +115,10 @@ export function InterfaceSection({ draft, setDraft, onThemeChange }: Props) {
<Label>{t("settings.sections.interface.zoom")}</Label>
<div className="flex items-center gap-1">
<button
- onClick={() => handleZoom(level - STEP)}
- disabled={level <= MIN_ZOOM}
+ onClick={() => handleZoom(level - ZOOM_STEP)}
+ disabled={level <= MIN_ZOOM_LEVEL}
className="flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-accent-foreground disabled:opacity-30 disabled:pointer-events-none transition-colors"
- aria-label="Zoom out"
+ aria-label={t("settings.sections.interface.zoomOut")}
>
<Minus className="size-3.5" />
</button>
@@ -146,14 +139,17 @@ export function InterfaceSection({ draft, setDraft, onThemeChange }: Props) {
</div>
<button
- onClick={() => handleZoom(level + STEP)}
- disabled={level >= MAX_ZOOM}
+ onClick={() => handleZoom(level + ZOOM_STEP)}
+ disabled={level >= MAX_ZOOM_LEVEL}
className="flex size-7 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-accent-foreground disabled:opacity-30 disabled:pointer-events-none transition-colors"
- aria-label="Zoom in"
+ aria-label={t("settings.sections.interface.zoomIn")}
>
<Plus className="size-3.5" />
</button>
</div>
+ <p className="text-xs text-muted-foreground">
+ {t("settings.sections.interface.zoomHint")}
+ </p>
</div>
</div>
)
diff --git a/src/components/settings/settings-view.tsx b/src/components/settings/settings-view.tsx
index 10358478..f7290c54 100644
--- a/src/components/settings/settings-view.tsx
+++ b/src/components/settings/settings-view.tsx
@@ -333,6 +333,8 @@ export function SettingsView() {
loadApiConfig,
saveGeneralConfig,
loadGeneralConfig,
+ saveZoomLevel,
+ loadZoomLevel,
} = await import("@/lib/project-store")
const newLlm = {
@@ -505,7 +507,6 @@ export function SettingsView() {
}
// Apply zoom level
- const { saveZoomLevel } = await import("@/lib/project-store")
useZoomStore.getState().setLevel(draft.zoomLevel)
await saveZoomLevel(draft.zoomLevel)
@@ -528,6 +529,7 @@ export function SettingsView() {
persistedMineru,
persistedApi,
persistedGeneral,
+ persistedZoom,
] = await Promise.allSettled([
loadLlmConfig(),
loadEmbeddingConfig(),
@@ -539,6 +541,7 @@ export function SettingsView() {
loadMineruConfig(),
loadApiConfig(),
loadGeneralConfig(),
+ loadZoomLevel(),
] as const)
setLlmConfig(resultValue(persistedLlm, null) ?? llmConfig)
setEmbeddingConfig(resultValue(persistedEmbedding, null) ?? embeddingConfig)
@@ -551,6 +554,7 @@ export function SettingsView() {
setMineruConfig(resultValue(persistedMineru, null) ?? mineruConfig)
setApiConfig(resultValue(persistedApi, null) ?? apiConfig)
setGeneralConfig(resultValue(persistedGeneral, generalConfig))
+ useZoomStore.getState().setLevel(resultValue(persistedZoom, useZoomStore.getState().level))
} catch (reloadErr) {
console.warn("[settings] failed to reload persisted settings after save failure:", reloadErr)
}
diff --git a/src/i18n/en.json b/src/i18n/en.json
index 1db6561c..77e4cebf 100644
--- a/src/i18n/en.json
+++ b/src/i18n/en.json
@@ -539,7 +539,10 @@
"themeLight": "Light",
"themeDark": "Dark",
"themeSystem": "System",
- "zoom": "Zoom"
+ "zoom": "Interface zoom",
+ "zoomHint": "Scales text and rem-based spacing across the app. Some fixed pixel panels keep their practical size limits.",
+ "zoomIn": "Zoom in",
+ "zoomOut": "Zoom out"
},
"maintenance": {
"title": "Maintenance",
diff --git a/src/i18n/zh.json b/src/i18n/zh.json
index a1812866..898ef5f8 100644
--- a/src/i18n/zh.json
+++ b/src/i18n/zh.json
@@ -539,7 +539,10 @@
"themeLight": "浅色",
"themeDark": "深色",
"themeSystem": "跟随系统",
- "zoom": "缩放"
+ "zoom": "界面缩放",
+ "zoomHint": "缩放应用内文字和基于 rem 的间距。少数固定像素面板会保留实际尺寸限制。",
+ "zoomIn": "放大",
+ "zoomOut": "缩小"
},
"maintenance": {
"title": "维护",
diff --git a/src/lib/project-store.test.ts b/src/lib/project-store.test.ts
index b8a1e2c2..0ca83011 100644
--- a/src/lib/project-store.test.ts
+++ b/src/lib/project-store.test.ts
@@ -26,3 +26,26 @@ describe("project-store MinerU config normalization", () => {
})
})
})
+
+describe("project-store zoom normalization", () => {
+ it("preserves valid zoom values", () => {
+ expect(__projectStoreTest.normalizeZoomLevel(0.5)).toBe(0.5)
+ expect(__projectStoreTest.normalizeZoomLevel(1.25)).toBe(1.25)
+ expect(__projectStoreTest.normalizeZoomLevel(3)).toBe(3)
+ })
+
+ it("clamps finite out-of-range values", () => {
+ expect(__projectStoreTest.normalizeZoomLevel(-2)).toBe(0.5)
+ expect(__projectStoreTest.normalizeZoomLevel(0)).toBe(0.5)
+ expect(__projectStoreTest.normalizeZoomLevel(0.49)).toBe(0.5)
+ expect(__projectStoreTest.normalizeZoomLevel(3.01)).toBe(3)
+ })
+
+ it("falls back to 100% for malformed values", () => {
+ expect(__projectStoreTest.normalizeZoomLevel(undefined)).toBe(1)
+ expect(__projectStoreTest.normalizeZoomLevel(null)).toBe(1)
+ expect(__projectStoreTest.normalizeZoomLevel(Number.NaN)).toBe(1)
+ expect(__projectStoreTest.normalizeZoomLevel(Number.POSITIVE_INFINITY)).toBe(1)
+ expect(__projectStoreTest.normalizeZoomLevel("150")).toBe(1)
+ })
+})
diff --git a/src/lib/project-store.ts b/src/lib/project-store.ts
index e158704b..45e16e27 100644
--- a/src/lib/project-store.ts
+++ b/src/lib/project-store.ts
@@ -3,6 +3,7 @@ import type { WikiProject } from "@/types/wiki"
import type { ApiConfig, GeneralConfig, LlmConfig, SearchApiConfig, EmbeddingConfig, MineruConfig, MultimodalConfig, OutputLanguage, ProviderConfigs, ProxyConfig, ScheduledImportConfig, SourceWatchConfig } from "@/stores/wiki-store"
import { normalizeSourceWatchConfig } from "@/lib/source-watch-config"
import { normalizePath } from "@/lib/path-utils"
+import { DEFAULT_ZOOM_LEVEL, clampZoomLevel } from "@/stores/zoom-store"
const STORE_NAME = "app-state.json"
const RECENT_PROJECTS_KEY = "recentProjects"
@@ -120,8 +121,15 @@ function normalizeMineruConfig(config: MineruConfig): MineruConfig {
}
}
+function normalizeZoomLevel(level: unknown): number {
+ return typeof level === "number" && Number.isFinite(level)
+ ? clampZoomLevel(level)
+ : DEFAULT_ZOOM_LEVEL
+}
+
export const __projectStoreTest = {
normalizeMineruConfig,
+ normalizeZoomLevel,
}
export async function saveMineruConfig(config: MineruConfig): Promise<void> {
@@ -385,12 +393,12 @@ const ZOOM_LEVEL_KEY = "zoomLevel"
export async function saveZoomLevel(level: number): Promise<void> {
const store = await getStore()
- await store.set(ZOOM_LEVEL_KEY, level)
+ await store.set(ZOOM_LEVEL_KEY, normalizeZoomLevel(level))
await store.save()
}
export async function loadZoomLevel(): Promise<number> {
const store = await getStore()
const level = await store.get<number>(ZOOM_LEVEL_KEY)
- return typeof level === "number" && level >= 0.5 && level <= 3 ? level : 1
+ return normalizeZoomLevel(level)
}
diff --git a/src/stores/zoom-store.ts b/src/stores/zoom-store.ts
index 14ccc89a..8a82f781 100644
--- a/src/stores/zoom-store.ts
+++ b/src/stores/zoom-store.ts
@@ -6,14 +6,24 @@ export interface ZoomState {
setLevel: (level: number) => void
}
+export const DEFAULT_ZOOM_LEVEL = 1
+export const MIN_ZOOM_LEVEL = 0.5
+export const MAX_ZOOM_LEVEL = 3
+export const ZOOM_STEP = 0.05
+export const BASE_FONT_SIZE_PX = 16
+
/**
- * Clamp the zoom level between 0.5 (50%) and 3 (300%).
+ * Clamp the zoom level between the configured minimum and maximum.
*/
-function clamp(v: number): number {
- return Math.min(3, Math.max(0.5, v))
+export function clampZoomLevel(v: number): number {
+ return Math.min(MAX_ZOOM_LEVEL, Math.max(MIN_ZOOM_LEVEL, v))
+}
+
+export function roundZoomLevel(v: number): number {
+ return Math.round(v * 100) / 100
}
export const useZoomStore = create<ZoomState>((set) => ({
- level: 1,
- setLevel: (level: number) => set({ level: clamp(level) }),
+ level: DEFAULT_ZOOM_LEVEL,
+ setLevel: (level: number) => set({ level: clampZoomLevel(level) }),
}))