Skip to content
Python
14.3 KB
Raw Blame
import {
  Bug,
  ChevronDown,
  ChevronRight,
  CirclePause,
  CirclePlay,
  Maximize2,
  Minimize2,
  RefreshCw,
  Search,
  X,
} from "lucide-react";
import {
  useCallback,
  useEffect,
  useMemo,
  useRef,
  useState,
  useSyncExternalStore,
} from "react";
import {
  type DiagnosticLogLevel,
  getDiagnosticLogLevel,
  setDiagnosticLogLevel,
} from "./api";
import type {
  DebugLogEntry,
  DebugLogLevel,
  DebugLogSnapshot,
} from "./debug-log-types";
import { useGuiLanguage } from "./gui-language";
import { ModelUsageView } from "./ModelUsageView";
import {
  rendererDebugLogs,
  subscribeRendererDebugLogs,
} from "./renderer-debug-log";
import "./debug-log-panel.css";

const LEVELS: Array<{ value: DebugLogLevel | "all"; label: string }> = [
  { value: "all", label: "全部" },
  { value: "debug", label: "Debug" },
  { value: "info", label: "Info" },
  { value: "warn", label: "Warn" },
  { value: "error", label: "Error" },
];
const SERVICE_LABELS: Record<DebugLogEntry["service"], string> = {
  renderer: "Renderer",
  desktop: "Desktop",
  runtime: "Runtime",
  core: "Core",
  "host-bridge": "Host Bridge",
  cli: "CLI",
};

export function DebugLogPanel() {
  const { t, tnPlain, locale } = useGuiLanguage();
  const supported = typeof window.oneMemory?.getDebugLogs === "function";
  const [open, setOpen] = useState(false);
  const [fullscreen, setFullscreen] = useState(false);
  const [tab, setTab] = useState<"logs" | "usage">("logs");
  const [live, setLive] = useState(true);
  const [usageRefreshToken, setUsageRefreshToken] = useState(0);
  const [query, setQuery] = useState("");
  const [level, setLevel] = useState<DebugLogLevel | "all">("all");
  const [captureLevel, setCaptureLevel] = useState<DiagnosticLogLevel>("info");
  const [capturePending, setCapturePending] = useState(false);
  const [service, setService] = useState<DebugLogEntry["service"] | "all">(
    "all",
  );
  const [snapshot, setSnapshot] = useState<DebugLogSnapshot | null>(null);
  const [readState, setReadState] = useState<"idle" | "loading" | "error">(
    "idle",
  );
  const snapshotRef = useRef<DebugLogSnapshot | null>(null);
  const [expanded, setExpanded] = useState<Set<string>>(() => new Set());
  const listRef = useRef<HTMLDivElement>(null);
  const followLatestRef = useRef(true);
  const rendererEntries = useSyncExternalStore(
    subscribeRendererDebugLogs,
    rendererDebugLogs,
    rendererDebugLogs,
  );

  const refresh = useCallback(async () => {
    const read = window.oneMemory?.getDebugLogs;
    if (!read) return;
    setReadState((state) => (snapshotRef.current === null ? "loading" : state));
    try {
      const next = await read();
      snapshotRef.current = next;
      setSnapshot(next);
      setReadState("idle");
    } catch {
      setReadState("error");
    }
  }, []);

  useEffect(() => {
    if (!open || !supported || tab !== "logs") return;
    void refresh();
    void getDiagnosticLogLevel()
      .then(setCaptureLevel)
      .catch(() => undefined);
    if (!live) return;
    const timer = window.setInterval(() => void refresh(), 1_000);
    return () => window.clearInterval(timer);
  }, [live, open, refresh, supported, tab]);

  useEffect(() => {
    if (!open) return;
    const onKeyDown = (event: KeyboardEvent) => {
      if (event.key !== "Escape" || !fullscreen) return;
      event.preventDefault();
      setFullscreen(false);
    };
    window.addEventListener("keydown", onKeyDown);
    return () => window.removeEventListener("keydown", onKeyDown);
  }, [fullscreen, open]);

  const entries = useMemo(() => {
    const byId = new Map<string, DebugLogEntry>();
    for (const entry of snapshot?.entries ?? []) byId.set(entry.id, entry);
    for (const entry of rendererEntries) byId.set(entry.id, entry);
    return [...byId.values()].sort((left, right) =>
      left.timestamp === right.timestamp
        ? left.id.localeCompare(right.id)
        : left.timestamp.localeCompare(right.timestamp),
    );
  }, [rendererEntries, snapshot]);

  const filtered = useMemo(() => {
    const needle = query.trim().toLocaleLowerCase();
    return entries.filter((entry) => {
      if (level !== "all" && entry.level !== level) return false;
      if (service !== "all" && entry.service !== service) return false;
      return !needle || searchableEntry(entry).includes(needle);
    });
  }, [entries, level, query, service]);

  useEffect(() => {
    if (filtered.length === 0) return;
    if (
      !open ||
      tab !== "logs" ||
      !live ||
      !followLatestRef.current ||
      !listRef.current
    )
      return;
    listRef.current.scrollTop = listRef.current.scrollHeight;
  }, [filtered.length, live, open, tab]);

  const handleListScroll = () => {
    const list = listRef.current;
    if (!list) return;
    followLatestRef.current =
      list.scrollHeight - list.scrollTop - list.clientHeight <= 24;
  };

  const toggleExpanded = (id: string) => {
    setExpanded((current) => {
      const next = new Set(current);
      if (next.has(id)) next.delete(id);
      else next.add(id);
      return next;
    });
  };

  if (!supported) return null;
  return (
    <div className={`debug-log-root${open ? " is-open" : ""}`}>
      {open ? (
        <aside
          className={`debug-log-panel${fullscreen ? " is-fullscreen" : ""}`}
          aria-label={t("debugTitle")}
        >
          <header className="debug-log-header">
            <div>
              <strong>{t("debugDiagnostics")}</strong>
              <span>
                {tab === "logs"
                  ? tnPlain("debugCount", entries.length)
                  : t("debugUsageSubtitle")}
              </span>
            </div>
            <div className="debug-log-header-actions">
              <button
                type="button"
                className="debug-icon-button"
                title={live ? t("debugPause") : t("debugResume")}
                aria-label={live ? t("debugPause") : t("debugResume")}
                onClick={() => setLive((value) => !value)}
              >
                {live ? <CirclePause size={17} /> : <CirclePlay size={17} />}
              </button>
              <button
                type="button"
                className="debug-icon-button"
                title={t("debugRefresh")}
                aria-label={t("debugRefresh")}
                onClick={() => {
                  if (tab === "logs") void refresh();
                  else setUsageRefreshToken((value) => value + 1);
                }}
              >
                <RefreshCw
                  size={17}
                  className={readState === "loading" ? "spin" : ""}
                />
              </button>
              <button
                type="button"
                className="debug-icon-button"
                title={t(
                  fullscreen ? "debugExitFullscreen" : "debugFullscreen",
                )}
                aria-label={t(
                  fullscreen
                    ? "debugExitFullscreenLabel"
                    : "debugFullscreenLabel",
                )}
                onClick={() => setFullscreen((value) => !value)}
              >
                {fullscreen ? <Minimize2 size={17} /> : <Maximize2 size={17} />}
              </button>
              <button
                type="button"
                className="debug-icon-button"
                title={t("debugClose")}
                aria-label={t("debugClose")}
                onClick={() => {
                  setFullscreen(false);
                  setOpen(false);
                }}
              >
                <X size={18} />
              </button>
            </div>
          </header>
          <div
            className="debug-panel-tabs"
            role="tablist"
            aria-label={t("debugTabs")}
          >
            <button
              type="button"
              role="tab"
              aria-selected={tab === "logs"}
              onClick={() => setTab("logs")}
            >
              {t("debugLogsTab")}
            </button>
            <button
              type="button"
              role="tab"
              aria-selected={tab === "usage"}
              onClick={() => setTab("usage")}
            >
              {t("debugUsageTab")}
            </button>
          </div>
          {tab === "logs" ? (
            <div className="debug-log-content">
              <div className="debug-log-toolbar">
                <label className="debug-search">
                  <Search size={15} aria-hidden="true" />
                  <input
                    type="search"
                    value={query}
                    onChange={(event) => setQuery(event.target.value)}
                    placeholder={t("debugSearchPlaceholder")}
                    aria-label={t("debugSearch")}
                  />
                </label>
                <select
                  aria-label={t("debugSource")}
                  value={service}
                  onChange={(event) =>
                    setService(event.target.value as typeof service)
                  }
                >
                  <option value="all">{t("debugAllSources")}</option>
                  {Object.entries(SERVICE_LABELS).map(([value, label]) => (
                    <option key={value} value={value}>
                      {label}
                    </option>
                  ))}
                </select>
                <label className="debug-capture-level">
                  <span>{t("debugCapture")}</span>
                  <select
                    aria-label={t("debugCapture")}
                    value={captureLevel}
                    disabled={capturePending}
                    onChange={(event) => {
                      const next = event.target.value as DiagnosticLogLevel;
                      setCapturePending(true);
                      void setDiagnosticLogLevel(next)
                        .then(setCaptureLevel)
                        .then(() => refresh())
                        .catch(() => setReadState("error"))
                        .finally(() => setCapturePending(false));
                    }}
                  >
                    <option value="error">Error</option>
                    <option value="warning">Warning</option>
                    <option value="info">Info</option>
                    <option value="debug">Debug</option>
                  </select>
                </label>
              </div>
              <fieldset className="debug-levels">
                <legend>{t("debugDisplay")}</legend>
                {LEVELS.map((option) => (
                  <button
                    type="button"
                    key={option.value}
                    aria-pressed={level === option.value}
                    onClick={() => setLevel(option.value)}
                  >
                    {option.value === "all" ? t("debugAll") : option.label}
                  </button>
                ))}
              </fieldset>
              <div className="debug-log-status" aria-live="polite">
                <span>{tnPlain("debugMatches", filtered.length)}</span>
                <span>{live ? t("debugLive") : t("debugPaused")}</span>
                {snapshot?.truncated ? (
                  <span>{t("debugTruncated")}</span>
                ) : null}
                {readState === "error" ? (
                  <span className="debug-read-error">
                    {t("debugReadError")}
                  </span>
                ) : null}
              </div>
              <div
                className="debug-log-list"
                ref={listRef}
                onScroll={handleListScroll}
              >
                {filtered.length ? (
                  filtered.map((entry) => {
                    const isExpanded = expanded.has(entry.id);
                    return (
                      <article
                        className={`debug-log-row level-${entry.level}`}
                        key={entry.id}
                      >
                        <button
                          type="button"
                          className="debug-log-summary"
                          onClick={() => toggleExpanded(entry.id)}
                          aria-expanded={isExpanded}
                        >
                          {isExpanded ? (
                            <ChevronDown size={14} />
                          ) : (
                            <ChevronRight size={14} />
                          )}
                          <time>{logTime(entry.timestamp, locale)}</time>
                          <span className="debug-log-level">{entry.level}</span>
                          <span className="debug-log-service">
                            {SERVICE_LABELS[entry.service]}
                          </span>
                          <span className="debug-log-event">
                            {entry.message ||
                              `${entry.component} · ${entry.event}`}
                          </span>
                          <span className="debug-log-outcome">
                            {entry.outcome}
                          </span>
                        </button>
                        {isExpanded ? (
                          <pre>{JSON.stringify(entry, null, 2)}</pre>
                        ) : null}
                      </article>
                    );
                  })
                ) : (
                  <p className="debug-log-empty">
                    {readState === "loading"
                      ? t("debugLoading")
                      : t("debugEmpty")}
                  </p>
                )}
              </div>
            </div>
          ) : (
            <ModelUsageView live={live} refreshToken={usageRefreshToken} />
          )}
        </aside>
      ) : null}
      <button
        type="button"
        className="debug-fab"
        aria-label={open ? t("debugOpened") : t("debugOpen")}
        title={t("debugOpen")}
        onClick={() => setOpen(true)}
      >
        <Bug size={20} aria-hidden="true" />
        {entries.some((entry) => entry.level === "error") ? (
          <span className="debug-error-dot" aria-hidden="true" />
        ) : null}
      </button>
    </div>
  );
}

function searchableEntry(entry: DebugLogEntry): string {
  return JSON.stringify(entry).toLocaleLowerCase();
}

function logTime(timestamp: string, locale: string): string {
  const date = new Date(timestamp);
  return Number.isNaN(date.getTime())
    ? timestamp
    : date.toLocaleTimeString(locale, { hour12: false });
}