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
25.9 KB
Raw Blame
import { create } from "zustand"
import type { WikiProject, FileNode } from "@/types/wiki"
import { DEFAULT_SOURCE_WATCH_CONFIG } from "@/lib/source-watch-config"
import {
  buildProjectPathIndexFromTree,
  createEmptyProjectPathIndex,
  type ProjectPathIndex,
} from "@/lib/wiki-page-resolver"
import { DEFAULT_GRAPH_FILTERS, type GraphFilterState } from "@/lib/graph-filters"
import type { OutputLanguage } from "@/lib/output-language-options"

/**
 * Wire protocol used when `provider === "custom"`. Other providers have a
 * fixed protocol (openai → OpenAI chat; anthropic → Anthropic messages;
 * etc.), so this field is ignored for them. `undefined` defaults to
 * `chat_completions` for backward compatibility with pre-0.3.7 configs.
 */
export type CustomApiMode = "chat_completions" | "anthropic_messages"
export type AzureModelFamily = "auto" | "gpt5"
export type ReasoningMode = "auto" | "off" | "low" | "medium" | "high" | "max" | "custom"

export interface ReasoningConfig {
  mode: ReasoningMode
  budgetTokens?: number
}

interface LlmConfig {
  provider: "openai" | "anthropic" | "google" | "azure" | "ollama" | "custom" | "minimax" | "claude-code" | "codex-cli"
  apiKey: string
  model: string
  ollamaUrl: string
  customEndpoint: string
  azureApiVersion?: string
  azureModelFamily?: AzureModelFamily
  maxContextSize: number // max context window in characters
  apiMode?: CustomApiMode
  reasoning?: ReasoningConfig
  /**
   * Reasoning for ingest's structured calls (analysis, page generation,
   * captioning, dedup), kept separate from `reasoning` because the two want
   * opposite things: chat benefits from thinking, whereas ingest asks for
   * structured output thousands of times and a model that spends its budget on
   * chain-of-thought can end the stream with empty `content` — a lost page.
   * Defaults to "off", which is what ingest hardcoded before this was settable.
   */
  ingestReasoning?: ReasoningConfig
  /**
   * Local CLI providers only. When true, LLM Wiki asks Claude/Codex CLI
   * to ignore user-level rules/config/MCP/tool state where the CLI exposes
   * such controls. Default false preserves existing advanced-user setups.
   */
  localCliIsolation?: boolean
  /** Codex CLI provider only. Overall subprocess timeout in minutes. */
  codexCliTimeoutMinutes?: number
  /** HTTP LLM request backstop. Defaults to 30 minutes for legacy configs. */
  requestTimeoutMinutes?: number
  /** Defaults to true. HTTP providers use a non-streaming wire when false. */
  streamingEnabled?: boolean
  /** Optional headers added to every HTTP request for this provider preset. */
  customHeaders?: Record<string, string>
  /** Optional provider-specific fields merged into custom OpenAI-compatible request bodies. */
  extraRequestBody?: Record<string, unknown>
}

export type SearchProvider =
  | "tavily"
  | "serpapi"
  | "searxng"
  | "ollama"
  | "brave"
  | "bocha"
  | "firecrawl"
  | "none"
export type DeepResearchSource = "web" | "anytxt" | "both"
export type SerpApiEngine =
  | "google"
  | "google_news"
  | "google_scholar"
  | "google_patents"
  | "bing"
  | "duckduckgo"
  | "google_images"
  | "google_videos"
  | "youtube"
  | string
export type SearXngCategory =
  | "general"
  | "news"
  | "science"
  | "it"
  | "images"
  | "videos"
  | "files"
  | "map"
  | "music"
  | "social media"
  | string

export interface SearchProviderOverride {
  apiKey?: string
  baseUrl?: string
  serpApiEngine?: SerpApiEngine
  searXngUrl?: string
  searXngCategories?: SearXngCategory[]
  ollamaUrl?: string
}

export type SearchProviderConfigs = Partial<Record<Exclude<SearchProvider, "none">, SearchProviderOverride>>

export interface AnyTxtConfig {
  enabled?: boolean
  endpoint?: string
  filterDir?: string
  filterExt?: string
  limit?: number
}

interface SearchApiConfig {
  provider: SearchProvider
  apiKey: string
  serpApiEngine?: SerpApiEngine
  searXngUrl?: string
  searXngCategories?: SearXngCategory[]
  ollamaUrl?: string
  providerConfigs?: SearchProviderConfigs
  deepResearchSource?: DeepResearchSource
  anyTxt?: AnyTxtConfig
}

interface EmbeddingConfig {
  enabled: boolean
  endpoint: string // e.g. "http://127.0.0.1:1234/v1/embeddings"
  apiKey: string
  model: string // e.g. "text-embedding-qwen3-embedding-0.6b"
  /** Optional Gemini native `output_dimensionality` value. Ignored by OpenAI-compatible endpoints. */
  outputDimensionality?: number
  /**
   * Chunking knobs (Phase 1 RAG). Undefined values fall back to the
   * chunker's built-in defaults in `src/lib/text-chunker.ts`:
   *   targetChars   1000
   *   maxChars      1500
   *   minChars      200
   *   overlapChars  200
   *
   * Users on small-context endpoints (e.g. llama.cpp with n_ctx=512,
   * Ollama `mxbai-embed-large`) should lower `maxChunkChars` to avoid
   * per-request rejections; fetchEmbedding also auto-halves on
   * "too long" server errors as a second line of defence.
   */
  maxChunkChars?: number
  overlapChunkChars?: number
  /** Maximum embedding HTTP requests in flight. Defaults to 1 for compatibility. */
  concurrency?: number
  /** Texts per OpenAI-compatible embedding request. Defaults to 1. */
  batchSize?: number
  /**
   * Extra HTTP headers to send with every embedding request, e.g.
   *   { "X-Model-Provider-Id": "siliconflow" }
   * for gateways like mify that route by header. Reserved names
   * (Authorization, Content-Type, Host, Content-Length, x-goog-api-key)
   * are ignored — they're managed by the embedding client itself.
   */
  extraHeaders?: Record<string, string>
}

/**
 * Image-captioning settings (Phase 4 of the multimodal-images plan).
 *
 * Decoupled from `llmConfig` because vision-capable endpoints are
 * usually NOT the same model the user picks for analysis/generation:
 * - the analysis stage often goes to a strong text-only model (Claude
 *   Sonnet, DeepSeek, etc.) that doesn't speak vision at all;
 * - captioning is happy with a small local VL model (Qwen2.5-VL-7B,
 *   LLaVA-1.6) that costs near-zero per call.
 *
 * `enabled` is the master gate. When false the caption pipeline is
 * skipped entirely — `read_file`'s extracted images still appear
 * inline (with empty alt text) and the safety-net `## Embedded
 * Images` section still gets written, but we never touch the LLM.
 *
 * `useMainLlm`: when true (the default for first-time users we
 * onboard), captioning calls go through the same `llmConfig`
 * everything else uses. When false, the dedicated fields below are
 * sent through the same provider machinery — same `streamChat`,
 * same `getProviderConfig`, no duplicate code.
 *
 * `concurrency` bounds parallel caption requests during ingest.
 * 30-image PDFs with sequential captioning at ~10s/image (a Qwen3
 * thinking model on consumer GPU) take 5 minutes. At concurrency=4
 * that drops to ~75s. Higher values are available for hosted or
 * multi-GPU endpoints that can sustain broader parallelism.
 */
/**
 * Global outbound HTTP proxy. When `enabled` and `url` is a valid
 * http(s) URL, the Rust setup hook reads this on app launch and
 * sets HTTP_PROXY / HTTPS_PROXY / NO_PROXY env vars before the
 * reqwest client used by tauri-plugin-http is constructed. Changes
 * apply on app restart only.
 */
interface ProxyConfig {
  enabled: boolean
  url: string
  bypassLocal: boolean
  acceptInvalidCerts?: boolean
}

interface ScheduledImportConfig {
  enabled: boolean
  path: string // 监控目录的相对路径(相对于项目根目录),空字符串表示使用默认的 "raw"
  interval: number // 扫描间隔(分钟)
  lastScan: number | null // 上次扫描时间戳
}

/**
 * Local HTTP API server config. Read by the Rust `api_server` module on
 * every request via `load_app_state` (5s cache). The Rust side is the
 * source of truth at request time; this struct is the persisted form
 * the UI edits.
 *
 *   - `enabled` gates all non-/health endpoints. Default `true` so an
 *     env-token-only setup keeps working after the toggle is added.
 *   - `allowUnauthenticated` lets local agents call the API without a
 *     token. It is explicit and default-off.
 *   - `allowLanAccess` binds the API and clip server to 0.0.0.0 on
 *     app startup so trusted LAN devices can reach them. Default-off.
 *   - `mcpEnabled` allows the optional MCP stdio server to use this
 *     API. It is separate from the HTTP API kill-switch so users can
 *     expose scripts while keeping MCP disabled.
 *   - `token` is the bearer secret. Empty + auth required =
 *     every non-/health request returns 401. The env var
 *     `LLM_WIKI_API_TOKEN` overrides this field at the backend.
 */
interface ApiConfig {
  enabled: boolean
  allowUnauthenticated: boolean
  allowLanAccess: boolean
  mcpEnabled: boolean
  token: string
}

export type CloseBehavior = "ask" | "minimize" | "exit"

export type GraphColorMode = "type" | "community"

export interface GraphUiState {
  colorMode: GraphColorMode
  filters: GraphFilterState
  nodeScale: number
  graphSpacingDraft: number
}

export function createDefaultGraphUiState(): GraphUiState {
  return {
    colorMode: "type",
    filters: {
      ...DEFAULT_GRAPH_FILTERS,
      hiddenTypes: new Set(),
      hiddenNodeIds: new Set(),
    },
    nodeScale: 1,
    graphSpacingDraft: 1,
  }
}

export interface GeneralConfig {
  autostart: boolean
  closeBehavior: CloseBehavior
}

interface SourceWatchConfig {
  enabled: boolean
  autoIngest: boolean
  /** Keep extractor output in raw/parsed in addition to the internal cache. */
  persistExtractedMarkdown: boolean
  /** Maximum number of source text extraction jobs allowed at once. */
  parsingConcurrency: number
  /** Maximum number of ingest tasks allowed to prepare concurrently. */
  ingestConcurrency: number
  includeExtensions: string[]
  excludeExtensions: string[]
  excludeDirs: string[]
  excludeGlobs: string[]
  maxFileSizeMb: number
}

export type MineruModelVersion = "pipeline" | "vlm"
export type MineruLocalBackend =
  | "pipeline"
  | "vlm-engine"
  | "hybrid-engine"
  | "vlm-http-client"
  | "hybrid-http-client"
export type MineruParseMethod = "auto" | "txt" | "ocr"
export type MineruEffort = "medium" | "high"

export interface MineruConfig {
  enabled: boolean
  /** Parsing backend: MinerU cloud API (default) or a self-hosted local service. */
  backend?: "cloud" | "local"
  /** Base URL of a compatible self-hosted MinerU HTTP wrapper. */
  localEndpoint?: string
  /** Optional Bearer token used only for the self-hosted MinerU service. */
  localToken?: string
  localBackend?: MineruLocalBackend
  localEffort?: MineruEffort
  localParseMethod?: MineruParseMethod
  localLanguage?: string
  localFormulaEnabled?: boolean
  localTableEnabled?: boolean
  localImageAnalysis?: boolean
  localServerUrl?: string
  token: string
  modelVersion: MineruModelVersion
}

interface MultimodalConfig {
  enabled: boolean
  /** Reuse `llmConfig` for caption calls. When true, the fields
   *  below are ignored. */
  useMainLlm: boolean
  provider: LlmConfig["provider"]
  apiKey: string
  model: string
  ollamaUrl: string
  customEndpoint: string
  azureApiVersion?: string
  azureModelFamily?: AzureModelFamily
  apiMode?: CustomApiMode
  /** Max parallel caption requests during ingest. >=1. */
  concurrency: number
}

/**
 * Per-preset saved fields. Each entry survives turning the preset off
 * and coming back — users don't have to re-enter an API key when they
 * briefly switch to a different provider.
 */
export interface ProviderOverride {
  apiKey?: string
  model?: string
  baseUrl?: string           // customEndpoint for custom presets, ollamaUrl for ollama
  azureApiVersion?: string
  azureModelFamily?: AzureModelFamily
  apiMode?: CustomApiMode
  maxContextSize?: number
  reasoning?: ReasoningConfig
  /** Reasoning used by structured ingest calls; defaults to off. */
  ingestReasoning?: ReasoningConfig
  localCliIsolation?: boolean
  codexCliTimeoutMinutes?: number
  requestTimeoutMinutes?: number
  streamingEnabled?: boolean
  customHeaders?: Record<string, string>
  extraRequestBody?: Record<string, unknown>
}

export type ProviderConfigs = Record<string, ProviderOverride>

export interface CustomLlmPreset {
  id: string
  label: string
}

export interface TaskModelRoutingConfig {
  /** Null keeps chat on the globally active provider preset. */
  chatPresetId: string | null
  /** Null keeps ingest on the globally active provider preset. */
  ingestPresetId: string | null
}

export interface ProjectLlmOverride {
  enabled: boolean
  presetId: string | null
  /** Empty uses the selected preset/global provider model. */
  model: string
  /**
   * Resolved provider metadata for native/API callers. The API key is
   * deliberately omitted: Rust merges the current credential from
   * providerConfigs[presetId], so rotating a key never requires rewriting
   * every project override and credentials are not duplicated per project.
   */
  profile?: Omit<LlmConfig, "apiKey" | "customHeaders">
}

export interface ExternalPreview {
  title: string
  path: string
  source: string
  url: string
  snippet: string
}

interface WikiState {
  project: WikiProject | null
  fileTree: FileNode[]
  /**
   * Lightweight lookup index derived from `fileTree`. Production code must
   * update fileTree through `setFileTree` so this stays in sync; direct
   * `useWikiStore.setState({ fileTree })` is only for tests that also reset or
   * do not read path resolution.
   */
  projectPathIndex: ProjectPathIndex
  selectedFile: string | null
  fileContent: string
  previewContentPath: string | null
  externalPreview: ExternalPreview | null
  /**
   * View that handed control to the full-width wiki preview. Closing the
   * preview must return there instead of leaving an empty wiki surface.
   * This is transient navigation state and must not be persisted.
   */
  previewReturnView: Exclude<WikiState["activeView"], "wiki"> | null
  previewBackStack: string[]
  previewForwardStack: string[]
  /**
   * One-shot scroll target for the markdown preview. When the user
   * clicks an image in search results and chooses "jump to source",
   * we set this to the image URL alongside `selectedFile`. The
   * markdown preview consumes it on its next render — finds the
   * `<img data-mdsrc="..."/>` whose attribute matches and scrolls
   * it into view, then clears this back to null so a stale target
   * doesn't fire on the NEXT page open.
   *
   * Match by raw URL (the literal `src` from the markdown) rather
   * than the resolved `convertFileSrc` URL — same image referenced
   * across two pages with different URL conventions (one absolute,
   * one wiki-relative) still works.
   */
  pendingScrollImageSrc: string | null
  activeView: "chat" | "wiki" | "sources" | "search" | "graph" | "lint" | "review" | "skills" | "settings"
  llmConfig: LlmConfig
  /** Persisted global/default config, kept separate while a project override is effective. */
  globalLlmConfig: LlmConfig
  /** Per-provider-preset stored overrides (API key, model, endpoint, …). */
  providerConfigs: ProviderConfigs
  customLlmPresets: CustomLlmPreset[]
  /** Which preset is currently active. `null` = no LLM configured. */
  activePresetId: string | null
  taskModelRouting: TaskModelRoutingConfig
  projectLlmOverride: ProjectLlmOverride
  searchApiConfig: SearchApiConfig
  embeddingConfig: EmbeddingConfig
  multimodalConfig: MultimodalConfig
  outputLanguage: OutputLanguage
  proxyConfig: ProxyConfig
  scheduledImportConfig: ScheduledImportConfig
  sourceWatchConfig: SourceWatchConfig
  sourceWatchAllProjects: boolean
  mineruConfig: MineruConfig
  apiConfig: ApiConfig
  generalConfig: GeneralConfig
  graphUiState: GraphUiState
  dataVersion: number

  setProject: (project: WikiProject | null) => void
  setFileTree: (tree: FileNode[], options?: { syncPathIndex?: boolean }) => void
  setProjectPathIndexFromTree: (tree: FileNode[]) => void
  setSelectedFile: (path: string | null) => void
  setFileContent: (content: string) => void
  openPathInPreview: (path: string) => void
  openFileInPreview: (path: string, content: string) => void
  closePreview: () => void
  navigatePreviewBack: () => void
  navigatePreviewForward: () => void
  setExternalPreview: (preview: ExternalPreview | null) => void
  setPendingScrollImageSrc: (src: string | null) => void
  setActiveView: (view: WikiState["activeView"]) => void
  setLlmConfig: (config: LlmConfig) => void
  setGlobalLlmConfig: (config: LlmConfig) => void
  setProviderConfigs: (configs: ProviderConfigs) => void
  setCustomLlmPresets: (presets: CustomLlmPreset[]) => void
  setActivePresetId: (id: string | null) => void
  setTaskModelRouting: (config: TaskModelRoutingConfig) => void
  setProjectLlmOverride: (config: ProjectLlmOverride) => void
  setSearchApiConfig: (config: SearchApiConfig) => void
  setEmbeddingConfig: (config: EmbeddingConfig) => void
  setMultimodalConfig: (config: MultimodalConfig) => void
  setOutputLanguage: (lang: OutputLanguage) => void
  setProxyConfig: (config: ProxyConfig) => void
  setScheduledImportConfig: (config: ScheduledImportConfig) => void
  setSourceWatchConfig: (config: SourceWatchConfig) => void
  setSourceWatchAllProjects: (enabled: boolean) => void
  setMineruConfig: (config: MineruConfig) => void
  setApiConfig: (config: ApiConfig) => void
  setGeneralConfig: (config: GeneralConfig) => void
  setGraphUiState: (state: GraphUiState | ((current: GraphUiState) => GraphUiState)) => void
  resetGraphUiState: () => void
  bumpDataVersion: () => void
}

export const useWikiStore = create<WikiState>((set) => ({
  project: null,
  fileTree: [],
  projectPathIndex: createEmptyProjectPathIndex(),
  selectedFile: null,
  fileContent: "",
  previewContentPath: null,
  externalPreview: null,
  previewReturnView: null,
  previewBackStack: [],
  previewForwardStack: [],
  pendingScrollImageSrc: null,
  activeView: "wiki",
  llmConfig: {
    provider: "openai",
    apiKey: "",
    maxContextSize: 204800,
    model: "",
    ollamaUrl: "http://localhost:11434",
    customEndpoint: "",
    azureApiVersion: "2024-10-21",
    reasoning: { mode: "auto" },
    localCliIsolation: false,
  },
  globalLlmConfig: {
    provider: "openai",
    apiKey: "",
    maxContextSize: 204800,
    model: "",
    ollamaUrl: "http://localhost:11434",
    customEndpoint: "",
    azureApiVersion: "2024-10-21",
    reasoning: { mode: "auto" },
    localCliIsolation: false,
  },
  providerConfigs: {},
  customLlmPresets: [],
  activePresetId: null,
  taskModelRouting: {
    chatPresetId: null,
    ingestPresetId: null,
  },
  projectLlmOverride: {
    enabled: false,
    presetId: null,
    model: "",
    profile: undefined,
  },

  dataVersion: 0,

  setProject: (project) => set({ project }),
  setFileTree: (fileTree, options) => {
    if (options?.syncPathIndex === false) {
      set({ fileTree })
      return
    }
    set({ fileTree, projectPathIndex: buildProjectPathIndexFromTree(fileTree) })
  },
  setProjectPathIndexFromTree: (tree) =>
    set({ projectPathIndex: buildProjectPathIndexFromTree(tree) }),
  setSelectedFile: (selectedFile) =>
    set((state) => ({
      selectedFile,
      previewContentPath: null,
      externalPreview: null,
      previewBackStack: selectedFile && state.selectedFile && !state.externalPreview && selectedFile !== state.selectedFile
        ? [...state.previewBackStack, state.selectedFile].slice(-50)
        : selectedFile ? state.previewBackStack : [],
      previewForwardStack: selectedFile && selectedFile !== state.selectedFile
        ? []
        : selectedFile ? state.previewForwardStack : [],
    })),
  setFileContent: (fileContent) => set({ fileContent }),
  openPathInPreview: (selectedFile) =>
    set((state) => ({
      selectedFile,
      previewContentPath: null,
      externalPreview: null,
      activeView: "wiki",
      previewReturnView:
        state.activeView === "wiki" ? state.previewReturnView : state.activeView,
      previewBackStack: state.selectedFile && !state.externalPreview && state.selectedFile !== selectedFile
        ? [...state.previewBackStack, state.selectedFile].slice(-50)
        : state.previewBackStack,
      previewForwardStack: state.selectedFile !== selectedFile ? [] : state.previewForwardStack,
    })),
  openFileInPreview: (selectedFile, fileContent) =>
    set((state) => ({
      selectedFile,
      fileContent,
      previewContentPath: selectedFile,
      externalPreview: null,
      activeView: "wiki",
      previewReturnView:
        state.activeView === "wiki" ? state.previewReturnView : state.activeView,
      previewBackStack: state.selectedFile && !state.externalPreview && state.selectedFile !== selectedFile
        ? [...state.previewBackStack, state.selectedFile].slice(-50)
        : state.previewBackStack,
      previewForwardStack: state.selectedFile !== selectedFile ? [] : state.previewForwardStack,
    })),
  closePreview: () =>
    set((state) => ({
      selectedFile: null,
      fileContent: "",
      previewContentPath: null,
      externalPreview: null,
      activeView: state.previewReturnView ?? "wiki",
      previewReturnView: null,
      previewBackStack: [],
      previewForwardStack: [],
    })),
  navigatePreviewBack: () =>
    set((state) => {
      const previous = state.previewBackStack[state.previewBackStack.length - 1]
      if (!previous || !state.selectedFile) return state
      return {
        selectedFile: previous,
        fileContent: "",
        previewContentPath: null,
        externalPreview: null,
        previewBackStack: state.previewBackStack.slice(0, -1),
        previewForwardStack: [...state.previewForwardStack, state.selectedFile].slice(-50),
      }
    }),
  navigatePreviewForward: () =>
    set((state) => {
      const next = state.previewForwardStack[state.previewForwardStack.length - 1]
      if (!next || !state.selectedFile) return state
      return {
        selectedFile: next,
        fileContent: "",
        previewContentPath: null,
        externalPreview: null,
        previewBackStack: [...state.previewBackStack, state.selectedFile].slice(-50),
        previewForwardStack: state.previewForwardStack.slice(0, -1),
      }
    }),
  setExternalPreview: (externalPreview) => set({ externalPreview }),
  setPendingScrollImageSrc: (pendingScrollImageSrc) => set({ pendingScrollImageSrc }),
  setActiveView: (activeView) => set({ activeView, previewReturnView: null }),
  searchApiConfig: {
    provider: "none",
    apiKey: "",
    serpApiEngine: "google",
    searXngUrl: "",
    searXngCategories: ["general"],
    providerConfigs: {},
    deepResearchSource: "web",
    anyTxt: {
      enabled: false,
      endpoint: "http://127.0.0.1:9920",
      filterDir: "",
      filterExt: "*",
      limit: 20,
    },
  },

  embeddingConfig: {
    enabled: false,
    endpoint: "",
    apiKey: "",
    model: "",
  },

  multimodalConfig: {
    // Off by default — captioning is a non-trivial token spend
    // (one VLM call per extracted image), and silently turning it
    // on for every user the first time they import a PDF would be
    // a budget surprise. Users who want it flip the toggle in
    // Settings → Image captioning.
    enabled: false,
    useMainLlm: true,
    provider: "custom",
    apiKey: "",
    model: "",
    ollamaUrl: "http://localhost:11434",
    customEndpoint: "",
    azureApiVersion: "2024-10-21",
    apiMode: "chat_completions",
    concurrency: 4,
  },

  outputLanguage: "auto",

  proxyConfig: {
    enabled: false,
    url: "",
    bypassLocal: true,
    acceptInvalidCerts: false,
  },

  scheduledImportConfig: {
    enabled: false,
    path: "",
    interval: 60,
    lastScan: null,
  },

  sourceWatchConfig: DEFAULT_SOURCE_WATCH_CONFIG,
  sourceWatchAllProjects: false,
  mineruConfig: {
    enabled: false,
    backend: "cloud",
    localEndpoint: "http://127.0.0.1:8000",
    localBackend: "hybrid-engine",
    localEffort: "medium",
    localParseMethod: "auto",
    localLanguage: "ch",
    localFormulaEnabled: true,
    localTableEnabled: true,
    localImageAnalysis: true,
    localServerUrl: "",
    token: "",
    modelVersion: "vlm",
  },

  // Default `enabled: true` preserves the pre-toggle behavior: anyone
  // who already had `LLM_WIKI_API_TOKEN` set or `apiConfig.token`
  // hand-edited keeps their working API. New users land in
  // "enabled + no token = 401 on every endpoint" — fail-closed by
  // virtue of the token being empty.
  apiConfig: {
    enabled: true,
    allowUnauthenticated: false,
    allowLanAccess: false,
    mcpEnabled: false,
    token: "",
  },

  generalConfig: {
    autostart: false,
    closeBehavior: "minimize",
  },

  graphUiState: createDefaultGraphUiState(),

  setLlmConfig: (llmConfig) => set({ llmConfig }),
  setGlobalLlmConfig: (globalLlmConfig) => set({ globalLlmConfig }),
  setProviderConfigs: (providerConfigs) => set({ providerConfigs }),
  setCustomLlmPresets: (customLlmPresets) => set({ customLlmPresets }),
  setActivePresetId: (activePresetId) => set({ activePresetId }),
  setTaskModelRouting: (taskModelRouting) => set({ taskModelRouting }),
  setProjectLlmOverride: (projectLlmOverride) => set({ projectLlmOverride }),
  setSearchApiConfig: (searchApiConfig) => set({ searchApiConfig }),
  setEmbeddingConfig: (embeddingConfig) => set({ embeddingConfig }),
  setMultimodalConfig: (multimodalConfig) => set({ multimodalConfig }),
  setOutputLanguage: (outputLanguage) => set({ outputLanguage }),
  setProxyConfig: (proxyConfig) => set({ proxyConfig }),
  setScheduledImportConfig: (scheduledImportConfig) => set({ scheduledImportConfig }),
  setSourceWatchConfig: (sourceWatchConfig) => set({ sourceWatchConfig }),
  setSourceWatchAllProjects: (sourceWatchAllProjects) => set({ sourceWatchAllProjects }),
  setMineruConfig: (mineruConfig) => set({ mineruConfig }),
  setApiConfig: (apiConfig) => set({ apiConfig }),
  setGeneralConfig: (generalConfig) => set({ generalConfig }),
  setGraphUiState: (graphUiState) =>
    set((state) => ({
      graphUiState: typeof graphUiState === "function"
        ? graphUiState(state.graphUiState)
        : graphUiState,
    })),
  resetGraphUiState: () => set({ graphUiState: createDefaultGraphUiState() }),
  bumpDataVersion: () => set((state) => ({ dataVersion: state.dataVersion + 1 })),
}))

export type { WikiState, LlmConfig, SearchApiConfig, EmbeddingConfig, MultimodalConfig, OutputLanguage, ProxyConfig, ScheduledImportConfig, SourceWatchConfig, ApiConfig }