prompt engineering

heliannuuthus · heliannuuthus · commit 3b78c83830e9 · 2025-08-27T21:24:31.000+08:00
diff --git a/blog/2025-08/prompt-engineering.mdx b/blog/2025-08/prompt-engineering.mdx
diff --git a/src/components/Downloader.tsx b/src/components/Downloader.tsx
@@ -1,4 +1,5 @@
 import { DownloadOutlined, EyeOutlined } from "@ant-design/icons";
+import { Paragraph, Text } from "@components/Typography";
 import { Button, Card, Drawer, Space, Tooltip, notification } from "antd";
 import { createStyles } from "antd-style";
 import { saveAs } from "file-saver";
@@ -8,8 +9,6 @@ import { isIPad13, isMobile, isTablet } from "react-device-detect";
 
 import { useBaseUrlUtils } from "@docusaurus/useBaseUrl";
 
-import { Paragraph, Text } from "@components/Typography";
-
 import CodeBlock from "@theme/CodeBlock";
 
 const useMobile = isMobile || isIPad13 || isTablet;
diff --git a/src/components/collapse/Collapse.tsx b/src/components/collapse/Collapse.tsx
@@ -1,7 +1,6 @@
-import { Collapse as AntdCollapse, CollapseProps } from "antd";
-
 import { ExpandIcon } from "@components/collapse";
 import { InlineMDXRender } from "@components/markdown/MDXRender";
+import { Collapse as AntdCollapse, CollapseProps } from "antd";
 
 const Collapse: React.FC<{
   label: React.ReactNode;
diff --git a/src/components/collapse/CollapseHeading.tsx b/src/components/collapse/CollapseHeading.tsx
@@ -1,9 +1,8 @@
+import { ExpandIcon } from "@components/collapse";
 import { Collapse as AntdCollapse } from "antd";
 import { createStyles } from "antd-style";
 import React from "react";
 
-import { ExpandIcon } from "@components/collapse";
-
 import Heading, { HeadingType } from "@theme/Heading";
 
 const useStyles = createStyles(({ css }) => ({
diff --git a/src/components/collapse/index.tsx b/src/components/collapse/index.tsx
@@ -1,8 +1,7 @@
 import Icon, { EyeInvisibleOutlined, EyeOutlined } from "@ant-design/icons";
-import { createStyles } from "antd-style";
-
 import { Collapse, Collapses } from "@components/collapse/Collapse";
 import CollapseHeading from "@components/collapse/CollapseHeading";
+import { createStyles } from "antd-style";
 
 // 图标动画样式
 const useIconStyles = createStyles(({ css }) => ({
diff --git a/src/components/comment/Tooltip.tsx b/src/components/comment/Tooltip.tsx
@@ -1,8 +1,7 @@
-import { Tooltip as AntdTooltip, TooltipProps } from "antd";
-import { createStyles } from "antd-style";
-
 import { useHtmlTheme } from "@components/ThemeProvider";
 import MDXRender from "@components/markdown/MDXRender";
+import { Tooltip as AntdTooltip, TooltipProps } from "antd";
+import { createStyles } from "antd-style";
 
 import MDXComponents from "@theme/MDXComponents";
 
diff --git a/src/components/markdown/MDXRender.tsx b/src/components/markdown/MDXRender.tsx
@@ -1,4 +1,10 @@
 // MDXRenderer.jsx
+import Tooltip from "@components/Tooltip";
+import { Comment } from "@components/Typography";
+import { CollapseHeading } from "@components/collapse";
+import CommentTooltip from "@components/comment/Tooltip";
+import Markmap from "@components/markdown/markmap";
+import TermPreview from "@components/terminology/TermPreview";
 import { evaluate } from "@mdx-js/mdx";
 import { MDXProvider } from "@mdx-js/react";
 import { createStyles } from "antd-style";
@@ -19,13 +25,6 @@ import remarkDirective from "remark-directive";
 import remarkMath from "remark-math";
 import remarkParse from "remark-parse";
 
-import Tooltip from "@components/Tooltip";
-import { Comment } from "@components/Typography";
-import { CollapseHeading } from "@components/collapse";
-import CommentTooltip from "@components/comment/Tooltip";
-import Markmap from "@components/markdown/markmap";
-import TermPreview from "@components/terminology/TermPreview";
-
 import TermAdmonition from "@theme/Admonition";
 import MDXComponents from "@theme/MDXComponents";
 import Mermaid from "@theme/Mermaid";
diff --git a/src/components/markdown/markmap/index.tsx b/src/components/markdown/markmap/index.tsx
@@ -4,7 +4,7 @@ import {
   MarkmapContext,
   createGObserver,
   createMarkmap,
-  reinitializePathObserver,
+  reinitializePathObserver
 } from "./context";
 
 export type { MarkmapProps as MarkmapViewProps } from "./View";
diff --git a/src/components/markdown/markmap/viewer/Content.tsx b/src/components/markdown/markmap/viewer/Content.tsx
@@ -1,9 +1,3 @@
-import "animate.css";
-import { Card, Tabs, TabsProps } from "antd";
-import { createStyles } from "antd-style";
-import * as d3 from "d3";
-import { useContext, useEffect, useRef, useState } from "react";
-
 import { Paragraph } from "@components/Typography";
 import {
   Markmap,
@@ -12,6 +6,11 @@ import {
   createMarkmap,
   reinitializePathObserver
 } from "@components/markdown/markmap";
+import "animate.css";
+import { Card, Tabs, TabsProps } from "antd";
+import { createStyles } from "antd-style";
+import * as d3 from "d3";
+import { useContext, useEffect, useRef, useState } from "react";
 
 import { FullscreenViewerHeader, ViewerHeader } from "./Header";
 
diff --git a/src/components/markdown/markmap/viewer/Header.tsx b/src/components/markdown/markmap/viewer/Header.tsx
@@ -9,6 +9,7 @@ import {
   ZoomInOutlined,
   ZoomOutOutlined
 } from "@ant-design/icons";
+import { MarkmapContext } from "@components/markdown/markmap";
 import { Button, Divider, Dropdown, Flex, Segmented, Space } from "antd";
 import { createStyles } from "antd-style";
 import useMessage from "antd/es/message/useMessage";
@@ -17,8 +18,6 @@ import { toBlob } from "html-to-image";
 import type { Options } from "html-to-image/lib/types";
 import { useCallback, useContext } from "react";
 
-import { MarkmapContext } from "@components/markdown/markmap";
-
 const globalOptions: Options = { skipFonts: true };
 
 export type ViewerHeaderActionType =
diff --git a/src/components/terminology/TermItem.tsx b/src/components/terminology/TermItem.tsx
@@ -1,15 +1,14 @@
 import { DownOutlined, UpOutlined } from "@ant-design/icons";
+import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
+import { Title } from "@components/Typography";
+import MDXRenderer from "@components/markdown/MDXRender";
 import { Button, List } from "antd";
 import { createStyles } from "antd-style";
 import { Author } from "heliannuuthus-docusaurus-authors";
 import { TermData } from "heliannuuthus-terminology-store";
 import React, { useEffect, useState } from "react";
 import { isIPad13, isMobile, isTablet } from "react-device-detect";
 
-import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
-import { Title } from "@components/Typography";
-import MDXRenderer from "@components/markdown/MDXRender";
-
 const useMobile = isMobile || isIPad13 || isTablet;
 
 // 将单个术语项封装成一个组件
diff --git a/src/components/terminology/TermPreview.tsx b/src/components/terminology/TermPreview.tsx
@@ -1,4 +1,7 @@
 import { BookFilled, EditOutlined } from "@ant-design/icons";
+import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
+import Tooltip from "@components/Tooltip";
+import MDXRender from "@components/markdown/MDXRender";
 import { Button, Card, Divider, Drawer, Space, Typography } from "antd";
 import { Author } from "heliannuuthus-docusaurus-authors";
 import { Terminology } from "heliannuuthus-docusaurus-terminology";
@@ -11,10 +14,6 @@ import { useBaseUrlUtils } from "@docusaurus/useBaseUrl";
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
 import { usePluginData } from "@docusaurus/useGlobalData";
 
-import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
-import Tooltip from "@components/Tooltip";
-import MDXRender from "@components/markdown/MDXRender";
-
 const { Text, Link, Title, Paragraph } = Typography;
 
 declare global {
diff --git a/src/components/terminology/Terminology.tsx b/src/components/terminology/Terminology.tsx
@@ -1,3 +1,4 @@
+import TermItem from "@components/terminology/TermItem";
 import { List } from "antd";
 import { Author } from "heliannuuthus-docusaurus-authors";
 import { TermData } from "heliannuuthus-terminology-store";
@@ -7,8 +8,6 @@ import { useLocation } from "@docusaurus/router";
 import { useBaseUrlUtils } from "@docusaurus/useBaseUrl";
 import { usePluginData } from "@docusaurus/useGlobalData";
 
-import TermItem from "@components/terminology/TermItem";
-
 const Terminology = () => {
   const { withBaseUrl } = useBaseUrlUtils();
   const location = useLocation();
diff --git a/src/pages/_declaration.tsx b/src/pages/_declaration.tsx
@@ -1,6 +1,5 @@
-import { Card, Col, Grid, Row } from "antd";
-
 import { Link, Paragraph, Text, Title } from "@components/Typography";
+import { Card, Col, Grid, Row } from "antd";
 
 const { useBreakpoint } = Grid;
 
diff --git a/src/pages/index.tsx b/src/pages/index.tsx
@@ -1,4 +1,5 @@
 import { Title } from "@components/Typography";
+
 import Annuus from "@site/src/pages/_annuus";
 import Declaration from "@site/src/pages/_declaration";
 
diff --git a/src/pages/learning-route/index.tsx b/src/pages/learning-route/index.tsx
@@ -3,11 +3,10 @@ import {
   ClockCircleTwoTone,
   CloseCircleTwoTone
 } from "@ant-design/icons";
-import { Checkbox } from "antd";
-
 import TimelineItem from "@components/Timeline";
 import { Text, Title } from "@components/Typography";
 import MDXRender from "@components/markdown/MDXRender";
+import { Checkbox } from "antd";
 
 import Layout from "@theme/Layout";
 
diff --git a/src/pages/terms/index.tsx b/src/pages/terms/index.tsx
@@ -1,5 +1,7 @@
 import { MenuOutlined, SettingOutlined } from "@ant-design/icons";
 import { EditOutlined } from "@ant-design/icons";
+import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
+import { Paragraph } from "@components/Typography";
 import { Button, Card, Col, Flex, Row } from "antd";
 import { createStyles } from "antd-style";
 import { Author } from "heliannuuthus-docusaurus-authors";
@@ -11,8 +13,6 @@ import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
 import { usePluginData } from "@docusaurus/useGlobalData";
 
 import { Terminology } from "@site/plugins/docusaurus-terminology/src";
-import { DrawerAvatars, PopoverAvatars } from "@components/Avatar";
-import { Paragraph } from "@components/Typography";
 
 import Layout from "@theme/Layout";
 
diff --git a/src/theme/Admonition/Icon/Note.tsx b/src/theme/Admonition/Icon/Note.tsx
@@ -1,6 +1,5 @@
-import React from "react";
-
 import { useHtmlTheme } from "@components/ThemeProvider";
+import React from "react";
 
 export default function NoteIcon() {
   const colorMode = useHtmlTheme();
diff --git a/src/theme/MDXComponents.js b/src/theme/MDXComponents.js
@@ -1,10 +1,9 @@
-import MDXComponents from "@theme-original/MDXComponents";
-
 import Tooltip from "@components/Tooltip";
 import { CollapseHeading } from "@components/collapse";
 import { Comment, CommentTooltip } from "@components/comment";
 import { MDXRender, Markmap } from "@components/markdown";
 import TermPreview from "@components/terminology/TermPreview";
+import MDXComponents from "@theme-original/MDXComponents";
 
 import TermAdmonition from "@theme/Admonition";
 
diff --git a/src/theme/NavbarItem/ComponentTypes.tsx b/src/theme/NavbarItem/ComponentTypes.tsx
@@ -1,8 +1,7 @@
 import { DownOutlined } from "@ant-design/icons";
-import { Dropdown, MenuProps, Space } from "antd";
-
 import Tooltip from "@components/Tooltip";
 import { Link, Text } from "@components/Typography";
+import { Dropdown, MenuProps, Space } from "antd";
 
 import type { LinkLikeNavbarItemProps } from "@theme/NavbarItem";
 import type { ComponentTypesObject } from "@theme/NavbarItem/ComponentTypes";
diff --git a/src/theme/Root.tsx b/src/theme/Root.tsx
@@ -1,5 +1,4 @@
 import "@ant-design/v5-patch-for-react-19";
-
 import ThemeProvider from "@components/ThemeProvider";
 
 export default function Root({ children }: { children: React.ReactNode }) {
diff --git a/src/utils/svg.ts b/src/utils/svg.ts
@@ -2,16 +2,21 @@ export interface PathCommand {
   type: string;
   params: number[];
 }
-export const getPathData = (pathData: string | SVGPathElement): PathCommand[] => {
-  if (!pathData || typeof pathData !== 'string') {
+export const getPathData = (
+  pathData: string | SVGPathElement
+): PathCommand[] => {
+  if (!pathData || typeof pathData !== "string") {
     pathData = (pathData as SVGPathElement).getAttribute("d") || "";
   }
   const commands: PathCommand[] = [];
 
   // 清理并标准化输入
-  const normalizedData = pathData.trim().replace(/,/g, ' ').replace(/\s+/g, ' ');
+  const normalizedData = pathData
+    .trim()
+    .replace(/,/g, " ")
+    .replace(/\s+/g, " ");
   const segments: string[] = [];
-  let currentNumber = '';
+  let currentNumber = "";
   let currentCommand: string | null = null;
 
   // 分割路径数据
@@ -20,15 +25,15 @@ export const getPathData = (pathData: string | SVGPathElement): PathCommand[] =>
     if (/^[MmLlHhVvCcSsQqTtAaZz]$/.test(char)) {
       if (currentNumber) {
         segments.push(currentNumber);
-        currentNumber = '';
+        currentNumber = "";
       }
       segments.push(char);
     } else if (/\d|-|\./.test(char)) {
       currentNumber += char;
-    } else if (char === ' ') {
+    } else if (char === " ") {
       if (currentNumber) {
         segments.push(currentNumber);
-        currentNumber = '';
+        currentNumber = "";
       }
     }
   }
@@ -49,4 +54,4 @@ export const getPathData = (pathData: string | SVGPathElement): PathCommand[] =>
     }
   }
   return commands;
-}
+};
