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
13.0 KB
Raw Blame
import { useEffect, useState, useCallback } from "react"
import { Download, RefreshCw, CheckCircle2, Sparkles } from "lucide-react"
import { useTranslation } from "react-i18next"
import { openUrl } from "@tauri-apps/plugin-opener"
import { apiServerStatus, clipServerStatus } from "@/commands/fs"
import { Button } from "@/components/ui/button"
import { API_SERVER_HEALTH_URL, API_SERVER_PORT } from "@/lib/api-server-constants"
import { useUpdateStore, hasAvailableUpdate } from "@/stores/update-store"
import { checkForUpdates, toLatestReleaseUrl } from "@/lib/update-check"
import { saveUpdateCheckState } from "@/lib/project-store"
import { useAppDialog } from "@/stores/app-dialog-store"

interface ApiHealth {
  enabled?: boolean
  authConfigured?: boolean
  allowUnauthenticated?: boolean
}

export function AboutSection() {
  const { t } = useTranslation()
  const [clipStatus, setClipStatus] = useState<string>("...")
  const [apiStatus, setApiStatus] = useState<string>("...")
  const [apiHealth, setApiHealth] = useState<ApiHealth | null>(null)
  const updateStore = useUpdateStore()

  useEffect(() => {
    let alive = true
    clipServerStatus()
      .then((s) => {
        if (alive) setClipStatus(s)
      })
      .catch(() => {
        if (alive) setClipStatus("unknown")
      })
    apiServerStatus()
      .then((s) => {
        if (alive) setApiStatus(s)
      })
      .catch(() => {
        if (alive) setApiStatus("unknown")
      })
    fetch(API_SERVER_HEALTH_URL)
      .then((res) => res.json() as Promise<ApiHealth>)
      .then((value) => {
        if (alive) setApiHealth(value)
      })
      .catch(() => {
        if (alive) setApiHealth(null)
      })
    return () => {
      alive = false
    }
  }, [])

  const handleCheckNow = useCallback(async () => {
    useUpdateStore.getState().setChecking(true)
    const result = await checkForUpdates({
      currentVersion: __APP_VERSION__,
      repo: "nashsu/llm_wiki",
    })
    const now = Date.now()
    useUpdateStore.getState().setResult(result, now)
    // On a manual check, wipe any prior "dismissed" memo so that if
    // the user re-clicks they see the banner again for the same
    // version — a manual check implies "I want to see this now".
    useUpdateStore.getState().setDismissed(null)
    await saveUpdateCheckState({
      enabled: useUpdateStore.getState().enabled,
      lastCheckedAt: now,
      dismissedVersion: null,
    })
  }, [])

  const handleDismiss = useCallback(async () => {
    const result = useUpdateStore.getState().lastResult
    if (result?.kind !== "available") return
    useUpdateStore.getState().setDismissed(result.remote)
    await saveUpdateCheckState({
      enabled: useUpdateStore.getState().enabled,
      lastCheckedAt: useUpdateStore.getState().lastCheckedAt ?? Date.now(),
      dismissedVersion: result.remote,
    })
  }, [])

  const handleToggleAutoCheck = useCallback(async () => {
    const next = !useUpdateStore.getState().enabled
    useUpdateStore.getState().setEnabled(next)
    await saveUpdateCheckState({
      enabled: next,
      lastCheckedAt: useUpdateStore.getState().lastCheckedAt,
      dismissedVersion: useUpdateStore.getState().dismissedVersion,
    })
  }, [])

  const apiStatusDisplay = (() => {
    if (apiStatus === "running" && apiHealth?.enabled === false) {
      return t("settings.sections.about.apiDisabled")
    }
    if (apiStatus === "running" && apiHealth?.allowUnauthenticated) {
      return t("settings.sections.about.apiOpen")
    }
    if (apiStatus === "running" && apiHealth?.authConfigured === false) {
      return t("settings.sections.about.apiNoToken")
    }
    return apiStatus
  })()
  const rows: Array<{ label: string; value: string; mono?: boolean }> = [
    { label: t("settings.sections.about.version"), value: `v${__APP_VERSION__}`, mono: true },
    { label: t("settings.sections.about.clipServer"), value: `${clipStatus}  @  127.0.0.1:19827`, mono: true },
    { label: t("settings.sections.about.apiServer"), value: `${apiStatusDisplay}  @  127.0.0.1:${API_SERVER_PORT}`, mono: true },
  ]

  // About panel = user-initiated navigation. They came here on
  // purpose (often guided by the gear / About red dot) and expect
  // to see WHY the dot is there. So this surface ignores the
  // user's "dismiss" preference — that preference only suppresses
  // the unrequested TOP banner. Within Settings, an available
  // update is always shown in detail.
  const showAvailable = hasAvailableUpdate(updateStore)
  const lastCheckFailed = updateStore.lastResult?.kind === "error"
  const lastCheckedLabel = updateStore.lastCheckedAt
    ? lastCheckFailed
      // Failed checks are overwhelmingly "GitHub unreachable from the
      // user's network" (common in mainland China). Not actionable,
      // so don't display a colored warning — keep the status in the
      // same muted timestamp line and move on.
      ? `${formatRelative(updateStore.lastCheckedAt, t)} · ${t("settings.sections.about.unreachable")}`
      : formatRelative(updateStore.lastCheckedAt, t)
    : t("settings.sections.about.lastCheckedNever")

  return (
    <div className="space-y-6">
      <div>
        <h2 className="text-xl font-semibold">{t("settings.sections.about.title")}</h2>
        <p className="mt-1 text-sm text-muted-foreground">
          {t("settings.sections.about.description")}
        </p>
      </div>

      <div className="rounded-md border divide-y">
        {rows.map((r) => (
          <div key={r.label} className="flex items-center justify-between px-4 py-2.5">
            <span className="text-sm text-muted-foreground">{r.label}</span>
            <span className={`text-sm ${r.mono ? "font-mono" : ""}`}>{r.value}</span>
          </div>
        ))}
      </div>

      {/* ── Update check card ──────────────────────────────────── */}
      <div className="space-y-3 rounded-md border p-4">
        <div className="flex items-center justify-between gap-3">
          <div className="min-w-0">
            <div className="text-sm font-medium">{t("settings.sections.about.updateCheck")}</div>
            <div className="mt-0.5 text-xs text-muted-foreground">
              {t("settings.sections.about.lastChecked")}: {lastCheckedLabel}
            </div>
          </div>
          <Button
            variant="outline"
            size="sm"
            onClick={handleCheckNow}
            disabled={updateStore.checking}
            className="shrink-0 gap-1.5"
          >
            <RefreshCw
              className={`h-3.5 w-3.5 ${updateStore.checking ? "animate-spin" : ""}`}
            />
            {updateStore.checking
              ? t("settings.sections.about.checking")
              : t("settings.sections.about.checkNow")}
          </Button>
        </div>

        {showAvailable && updateStore.lastResult?.kind === "available" && (
          <UpdateAvailableBanner
            remote={updateStore.lastResult.remote}
            releaseUrl={updateStore.lastResult.release.html_url}
            releaseName={updateStore.lastResult.release.name}
            releaseBody={updateStore.lastResult.release.body}
            onDismiss={handleDismiss}
          />
        )}

        {!showAvailable && updateStore.lastResult?.kind === "up-to-date" && (
          <div className="flex items-center gap-2 rounded border border-emerald-500/30 bg-emerald-500/5 px-3 py-2 text-sm text-emerald-700 dark:text-emerald-400">
            <CheckCircle2 className="h-4 w-4 shrink-0" />
            {t("settings.sections.about.upToDate", { version: updateStore.lastResult.local })}
          </div>
        )}

        {/* error state intentionally has no banner — see the timestamp
            line above for the muted "couldn't reach GitHub" hint. GitHub
            is regularly unreachable from certain networks (notably
            mainland China) and a colored warning would misleadingly
            look like a bug in the app. */}

        <label className="flex items-center gap-2 text-xs text-muted-foreground">
          <input
            type="checkbox"
            checked={updateStore.enabled}
            onChange={handleToggleAutoCheck}
            className="h-3.5 w-3.5"
          />
          {t("settings.sections.about.autoCheck")}
        </label>
      </div>

      <div className="rounded-md border p-4 text-sm">
        <div className="font-medium">LLM Wiki</div>
        <p className="mt-1 text-xs text-muted-foreground">
          {t("settings.sections.about.appDescription")}
          {" "}
          {/*
           * Tauri 2's webview doesn't honor `target="_blank"` for
           * external URLs by default — clicking would either do
           * nothing or replace the in-app webview with the github
           * page (terrible UX). Route through the opener plugin
           * via onClick + preventDefault so it always lands in the
           * system browser.
           */}
          <a
            className="cursor-pointer underline underline-offset-2 hover:text-primary"
            href="https://github.com/nashsu/llm_wiki"
            onClick={(e) => {
              e.preventDefault()
              void openUrl("https://github.com/nashsu/llm_wiki").catch((err) => {
                console.error("[about] openUrl failed:", err)
              })
            }}
          >
            github.com/nashsu/llm_wiki
          </a>
        </p>
      </div>
    </div>
  )
}

interface UpdateAvailableBannerProps {
  remote: string
  releaseUrl: string
  releaseName: string
  releaseBody: string
  onDismiss: () => void
}

function UpdateAvailableBanner({
  remote,
  releaseUrl,
  releaseName,
  releaseBody,
  onDismiss,
}: UpdateAvailableBannerProps) {
  const { t } = useTranslation()
  const appDialog = useAppDialog()
  // Use `/releases/latest` (canonical GitHub redirect to the newest
  // release) rather than the tag-specific URL from the release
  // payload. Same rationale as in the top banner — see
  // `toLatestReleaseUrl` for details.
  const targetUrl = toLatestReleaseUrl(releaseUrl)
  const handleOpen = async () => {
    // Tauri 2's webview does NOT auto-delegate `window.open()` to the
    // system browser — `tauri-plugin-opener` is the official way to
    // launch the user's default browser. The Rust plugin is
    // registered in `src-tauri/src/lib.rs` and `opener:default`
    // permission is granted in capabilities/default.json.
    //
    // Fail-soft: if the plugin call rejects (e.g. URL blocked by a
    // future capability tightening), fall back to copying the URL
    // to the clipboard so the user can paste it into a browser
    // manually instead of seeing a silently broken button.
    try {
      await openUrl(targetUrl)
    } catch (err) {
      console.error("[update-banner] openUrl failed:", err)
      try {
        await navigator.clipboard.writeText(targetUrl)
        await appDialog.alert({
          message: `Could not open browser. URL copied to clipboard:\n${targetUrl}`,
        })
      } catch {
        await appDialog.alert({ message: `Could not open browser. Visit:\n${targetUrl}` })
      }
    }
  }

  const preview = releaseBody.slice(0, 400)
  const truncated = releaseBody.length > preview.length

  return (
    <div className="rounded border border-primary/40 bg-primary/5 p-3">
      <div className="flex items-center gap-2 text-sm font-medium text-primary">
        <Sparkles className="h-4 w-4 shrink-0" />
        {t("settings.sections.about.updateAvailable", { version: remote.replace(/^v/, "") })}
      </div>
      {releaseName && releaseName !== `v${remote.replace(/^v/, "")}` && (
        <div className="mt-1 text-xs text-muted-foreground">{releaseName}</div>
      )}
      {preview.trim().length > 0 && (
        <pre className="mt-2 max-h-40 overflow-auto whitespace-pre-wrap break-words rounded bg-background/60 px-2 py-1.5 text-[11px] leading-relaxed text-foreground/80">
          {preview}
          {truncated && " …"}
        </pre>
      )}
      <div className="mt-3 flex items-center gap-2">
        <Button size="sm" onClick={handleOpen} className="gap-1.5">
          <Download className="h-3.5 w-3.5" />
          {t("settings.sections.about.openDownload")}
        </Button>
        <Button size="sm" variant="ghost" onClick={onDismiss}>
          {t("settings.sections.about.later")}
        </Button>
      </div>
    </div>
  )
}

/** Translated relative-time formatter. Signature accepts a `t` passed
 *  in from the caller so the function stays pure and unit-testable. */
function formatRelative(timestamp: number, t: (key: string, opts?: Record<string, unknown>) => string): string {
  const delta = Date.now() - timestamp
  if (delta < 0) return t("time.justNow", { defaultValue: "just now" })
  const mins = Math.floor(delta / 60_000)
  if (mins < 1) return t("time.justNow", { defaultValue: "just now" })
  if (mins < 60) return t("time.minutesAgo", { count: mins, defaultValue: `${mins} min ago` })
  const hours = Math.floor(mins / 60)
  if (hours < 24) return t("time.hoursAgo", { count: hours, defaultValue: `${hours} h ago` })
  const days = Math.floor(hours / 24)
  return t("time.daysAgo", { count: days, defaultValue: `${days} d ago` })
}