Harden docs highlighter and try-it guards

Author: DeliciousBuding

docs/API.md

@@ -650,7 +650,7 @@ curl -X POST http://localhost:8080/api/admin/accounts/at \
 
 - **`txt`** — 每行一个 Refresh Token:
 
-  ```
+  ```text
   rt_xxxxxx1
   rt_xxxxxx2
   rt_xxxxxx3
@@ -666,7 +666,7 @@ curl -X POST http://localhost:8080/api/admin/accounts/at \
   ```
 
 - **`at_txt`** — 每行一个 Access Token（AT-only 模式）:
-  ```
+  ```text
   eyJhbGciOiJSUzI1NiIs...token1
   eyJhbGciOiJSUzI1NiIs...token2
   ```
@@ -705,7 +705,7 @@ curl -X POST http://localhost:8080/api/admin/accounts/import \
 
 **响应:** SSE 流式进度
 
-```
+```text
 data: {"type":"progress","current":5,"total":10,"success":3,"duplicate":1,"failed":1}
 
 data: {"type":"complete","current":10,"total":10,"success":8,"duplicate":1,"failed":1}

frontend/src/hooks/useHighlighter.ts

@@ -15,15 +15,20 @@ function getHighlighter() {
       import("shiki/langs/json.mjs"),
       import("shiki/langs/shellscript.mjs"),
       import("shiki/langs/toml.mjs"),
-    ]).then(
-      ([core, engine, darkPlus, githubLight, json, shellscript, toml]) => {
-        return core.createHighlighterCore({
-          themes: [githubLight.default, darkPlus.default],
-          langs: [json.default, toml.default, shellscript.default],
-          engine: engine.createJavaScriptRegexEngine(),
-        });
-      },
-    );
+    ])
+      .then(
+        ([core, engine, darkPlus, githubLight, json, shellscript, toml]) => {
+          return core.createHighlighterCore({
+            themes: [githubLight.default, darkPlus.default],
+            langs: [json.default, toml.default, shellscript.default],
+            engine: engine.createJavaScriptRegexEngine(),
+          });
+        },
+      )
+      .catch((error) => {
+        highlighterPromise = null;
+        throw error;
+      });
   }
   return highlighterPromise;
 }
@@ -75,31 +80,42 @@ export function useHighlightedHtml(code: string, lang?: string) {
       };
     }
 
-    getHighlighter().then((hl) => {
-      if (cancelled) return;
-      try {
-        const result = hl.codeToHtml(code, {
-          lang: resolvedLang,
-          theme: isDark ? "dark-plus" : "github-light-default",
-        });
-        const cacheKey = `${isDark ? "dark" : "light"}:${resolvedLang}:${code}`;
-        const nextHtml = isDark ? result : tuneLightTheme(result);
-        if (htmlCache.size >= MAX_CACHE_SIZE) {
-          const firstKey = htmlCache.keys().next().value;
-          if (firstKey) htmlCache.delete(firstKey);
+    getHighlighter()
+      .then((hl) => {
+        if (cancelled) return;
+        try {
+          const result = hl.codeToHtml(code, {
+            lang: resolvedLang,
+            theme: isDark ? "dark-plus" : "github-light-default",
+          });
+          const cacheKey = `${isDark ? "dark" : "light"}:${resolvedLang}:${code}`;
+          const nextHtml = isDark ? result : tuneLightTheme(result);
+          if (htmlCache.size >= MAX_CACHE_SIZE) {
+            const firstKey = htmlCache.keys().next().value;
+            if (firstKey) htmlCache.delete(firstKey);
+          }
+          htmlCache.set(cacheKey, nextHtml);
+          setHtml(nextHtml);
+        } catch (error) {
+          console.warn("highlight failed", {
+            resolvedLang,
+            isDark,
+            codeLength: code.length,
+            error,
+          });
+          setHtml("");
         }
-        htmlCache.set(cacheKey, nextHtml);
-        setHtml(nextHtml);
-      } catch (error) {
+      })
+      .catch((error) => {
+        if (cancelled) return;
         console.warn("highlight failed", {
           resolvedLang,
           isDark,
           codeLength: code.length,
           error,
         });
         setHtml("");
-      }
-    });
+      });
 
     return () => {
       cancelled = true;

frontend/src/pages/docs/EndpointDoc.tsx

@@ -453,6 +453,22 @@ export const EndpointDoc = memo(function EndpointDoc({
   const activeBody =
     responseExamples.find((r) => r.code === activeStatus)?.body ?? "";
   const [tryOpen, setTryOpen] = useState(false);
+  const supportsJsonBody =
+    method === "GET" ||
+    method === "DELETE" ||
+    !defaultBody ||
+    (() => {
+      try {
+        JSON.parse(defaultBody);
+        return true;
+      } catch {
+        return false;
+      }
+    })();
+  const supportsTryIt =
+    !path.includes(":") &&
+    path !== "/api/admin/accounts/import" &&
+    supportsJsonBody;
 
   return (
     <Card id={id} className="mb-4 scroll-mt-20 py-0">
@@ -472,14 +488,15 @@ export const EndpointDoc = memo(function EndpointDoc({
           <Button
             size="sm"
             onClick={() => setTryOpen(true)}
+            disabled={!supportsTryIt}
             className="h-8 gap-1.5 bg-emerald-600 text-white shrink-0 hover:bg-emerald-600/90 dark:bg-emerald-500/90 dark:hover:bg-emerald-500"
           >
             <Play className="size-3.5" />
             {t("apiRef.tryIt.button")}
           </Button>
         </div>
 
-        {tryOpen && (
+        {supportsTryIt && tryOpen && (
           <TryItDialog
             open={tryOpen}
             onClose={() => setTryOpen(false)}