diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css new file mode 100644 index 0000000..9d25f31 --- /dev/null +++ b/docs/_static/css/custom.css @@ -0,0 +1,10 @@ +/* ============================================ + FLAGOS DOCUMENTATION - SHARED CUSTOM CSS + For sphinx_book_theme sub-projects + ============================================ */ + +/* Adjust sphinx-book-theme navbar logo size */ +.sidebar-primary-item .logo__image { + max-height: 45px !important; + width: auto !important; +} \ No newline at end of file diff --git a/docs/requirements.txt b/docs/requirements.txt index d2d2bee..11c220c 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -1,3 +1,4 @@ +sphinx==8.2.3 myst-parser sphinx-multiproject==1.0.0 sphinx-rtd-theme @@ -12,6 +13,4 @@ sphinx-pyscript sphinx-tippy>=0.4.3 sphinx-togglebutton sphinx-tabs==3.4.7 -sphinx-prompt==1.10.2 -sphinx-tippy>=0.4.3 -sphinx-togglebutton \ No newline at end of file +sphinx-prompt==1.10.2 \ No newline at end of file diff --git a/docs/source/conf.py b/docs/source/conf.py index d784a2e..f89c795 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -66,16 +66,20 @@ locale_dirs = ["locale/"] gettext_compact = False # Generate separate POT file for each source file +# Detect the actual build language from Read the Docs environment variable +# Falls back to the language config variable for local builds +CURRENT_LANGUAGE = os.getenv("READTHEDOCS_LANGUAGE", language) + # -- HTML output ------------------------------------------------------------- html_theme = "sphinx_book_theme" html_static_path = ["../_static"] -html_css_files = [] +html_css_files = ["css/custom.css"] html_js_files = [] -# Logo and favicon configuration based on language -# Read the Docs builds each language separately with -D language=zh_CN -if language == "zh_CN": +# Logo and favicon configuration based on build language +# Read the Docs sets READTHEDOCS_LANGUAGE environment variable during builds +if CURRENT_LANGUAGE == "zh_CN": html_logo = "../_static/images/logos/zh-logo.svg" html_theme_options = { "home_page_in_toc": True, @@ -89,7 +93,7 @@ }, } else: - # Default to English + # Default to English configuration for all other languages html_logo = "../_static/images/logos/en-logo.svg" html_theme_options = { "home_page_in_toc": True, diff --git a/docs/source/getting-started/index.md b/docs/source/getting-started/index.md index ef38b14..8dd8235 100644 --- a/docs/source/getting-started/index.md +++ b/docs/source/getting-started/index.md @@ -87,7 +87,7 @@ Test with a single {term}`Operator` to verify everything works: python scripts/generate_kernel_and_verify.py \ --op-name aten::add \ --single-test \ - --server-type openai \ + --server-type openai \s --model-name gpt-4o \ --max-rounds 3 ``` diff --git a/docs/source/index.md b/docs/source/index.md index 819164f..463ed1f 100644 --- a/docs/source/index.md +++ b/docs/source/index.md @@ -43,7 +43,7 @@ Evaluate LLMs on generating Triton kernels with Pass@K metric. [Learn more »](operation-guide/llm-track/index) ::: -:::{grid-item-card} {octicon}`hub;1.5em;sd-mr-1` Agent Track +:::{grid-item-card} {octicon}`hubot;1.5em;sd-mr-1` Agent Track :link: operation-guide/agent-track/index :link-type: doc @@ -156,3 +156,63 @@ development/extending.md faq/index.md glossary/index.md ``` + +```{toctree} +:caption: 🔬 Features +:maxdepth: 2 +:hidden: + +features/index.md +features/multi-source.md +features/multi-chip.md +features/anti-hack.md +features/metrics.md +``` + +```{toctree} +:caption: 📖 Operation Guide +:maxdepth: 3 +:hidden: + +operation-guide/index.md +operation-guide/llm-track/index.md +operation-guide/llm-track/commands.md +operation-guide/llm-track/parameters.md +operation-guide/llm-track/examples.md +operation-guide/agent-track/index.md +operation-guide/agent-track/setup.md +operation-guide/agent-track/methods.md +operation-guide/agent-track/commands.md +operation-guide/agent-track/cost-analysis.md +``` + +```{toctree} +:caption: 📑 Reference +:maxdepth: 2 +:hidden: + +reference/index.md +reference/datasets.md +reference/operators.md +reference/hardware.md +``` + +```{toctree} +:caption: 🔧 Development +:maxdepth: 2 +:hidden: + +development/index.md +development/contributing.md +development/custom-operators.md +development/extending.md +``` + +```{toctree} +:caption: ❓ FAQ & Glossary +:maxdepth: 2 +:hidden: + +faq/index.md +glossary/index.md +``` \ No newline at end of file diff --git a/docs/source/locale/zh_CN/LC_MESSAGES/getting-started/index.po b/docs/source/locale/zh_CN/LC_MESSAGES/getting-started/index.po index b7c00ba..dcfe7f6 100644 --- a/docs/source/locale/zh_CN/LC_MESSAGES/getting-started/index.po +++ b/docs/source/locale/zh_CN/LC_MESSAGES/getting-started/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: KernelGenBench Documentation \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-06-15 18:12+0800\n" +"POT-Creation-Date: 2026-06-17 11:11+0800\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: zh_CN\n" @@ -150,7 +150,7 @@ msgstr "描述" #: ../../source/getting-started/index.md #, python-brace-format -msgid "{term}`KernelGenBench`" +msgid "`{term}`KernelGenBench``" msgstr "{term}`KernelGenBench`" #: ../../source/getting-started/index.md @@ -164,7 +164,7 @@ msgstr "完整集合（{term}`ATen` + {term}`vLLM` + {term}`cuBLAS`）" #: ../../source/getting-started/index.md #, python-brace-format -msgid "{term}`KernelGenBench-aten`" +msgid "`{term}`KernelGenBench-aten``" msgstr "{term}`KernelGenBench-aten`" #: ../../source/getting-started/index.md @@ -178,7 +178,7 @@ msgstr "仅 {term}`ATen` 算子" #: ../../source/getting-started/index.md #, python-brace-format -msgid "{term}`KernelGenBench-vllm`" +msgid "`{term}`KernelGenBench-vllm``" msgstr "{term}`KernelGenBench-vllm`" #: ../../source/getting-started/index.md @@ -192,7 +192,7 @@ msgstr "仅 {term}`vLLM` 算子（仅限 NVIDIA）" #: ../../source/getting-started/index.md #, python-brace-format -msgid "{term}`KernelGenBench-cublas`" +msgid "`{term}`KernelGenBench-cublas``" msgstr "{term}`KernelGenBench-cublas`" #: ../../source/getting-started/index.md diff --git a/docs/source/locale/zh_CN/LC_MESSAGES/glossary/index.po b/docs/source/locale/zh_CN/LC_MESSAGES/glossary/index.po index d39b3c3..d6e4168 100644 --- a/docs/source/locale/zh_CN/LC_MESSAGES/glossary/index.po +++ b/docs/source/locale/zh_CN/LC_MESSAGES/glossary/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: KernelGenBench Documentation \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-06-15 18:12+0800\n" +"POT-Creation-Date: 2026-06-17 11:11+0800\n" "PO-Revision-Date: 2026-06-15 18:15+0800\n" "Last-Translator: FlagOS Community\n" "Language: zh_CN\n" @@ -29,159 +29,227 @@ msgid "" "KernelGenBench documentation." msgstr "本节定义了 KernelGenBench 文档中使用的技术术语。" -#: ../../source/glossary/index.md:5 -#, python-brace-format +#: ../../source/glossary/index.md:6 +msgid "Agent" +msgstr "Agent" + +#: ../../source/glossary/index.md:7 msgid "" -"{.glossary} Agent : A coding agent that autonomously generates, executes," -" and iterates on code based on feedback. In KernelGenBench, agents like " -"Claude Code and OpenCode can debug and optimize kernels through " -"execution-driven reinforcement." +"A coding agent that autonomously generates, executes, and iterates on " +"code based on feedback. In KernelGenBench, agents like Claude Code and " +"OpenCode can debug and optimize kernels through execution-driven " +"reinforcement." msgstr "" -"**Agent（智能体）**：一种能够根据反馈自主生成、执行和迭代代码的编程智能体。在 KernelGenBench 中，Claude Code 和 OpenCode 等智能体可以通过执行驱动的强化学习来调试和优化内核。" +"**Agent（智能体）**：一种能够根据反馈自主生成、执行和迭代代码的编程智能体。在 KernelGenBench 中，Claude Code " +"和 OpenCode 等智能体可以通过执行驱动的强化学习来调试和优化内核。" + +#: ../../source/glossary/index.md ../../source/glossary/index.md:10 +msgid "ATen" +msgstr "ATen" -#: ../../source/glossary/index.md:9 -#, python-brace-format +#: ../../source/glossary/index.md:11 msgid "" -"{.glossary} ATen : PyTorch's native tensor library, providing fundamental" -" operations for deep learning. KernelGenBench includes 110 ATen operators" -" derived from real model training traces." -msgstr "**ATen**：PyTorch 的原生张量库，为深度学习提供基础运算。KernelGenBench 包含 110 个从真实模型训练轨迹中提取的 ATen 算子。" +"PyTorch's native tensor library, providing fundamental operations for " +"deep learning. KernelGenBench includes 110 ATen operators derived from " +"real model training traces." +msgstr "" +"**ATen**：PyTorch 的原生张量库，为深度学习提供基础运算。KernelGenBench 包含 110 个从真实模型训练轨迹中提取的 " +"ATen 算子。" -#: ../../source/glossary/index.md:13 -#, python-brace-format +#: ../../source/glossary/index.md ../../source/glossary/index.md:14 +msgid "CUDA" +msgstr "CUDA" + +#: ../../source/glossary/index.md:15 msgid "" -"{.glossary} CUDA : NVIDIA's proprietary parallel computing platform and " -"programming model for GPU acceleration. CUDA is deeply tied to NVIDIA " -"hardware architecture." +"NVIDIA's proprietary parallel computing platform and programming model " +"for GPU acceleration. CUDA is deeply tied to NVIDIA hardware " +"architecture." msgstr "**CUDA**：NVIDIA 的专有并行计算平台和 GPU 加速编程模型。CUDA 与 NVIDIA 硬件架构深度绑定。" -#: ../../source/glossary/index.md:17 -#, python-brace-format +#: ../../source/glossary/index.md:18 +msgid "cuBLAS" +msgstr "cuBLAS" + +#: ../../source/glossary/index.md:19 msgid "" -"{.glossary} cuBLAS : NVIDIA's closed-source Basic Linear Algebra " -"Subprograms library, highly optimized for NVIDIA GPUs. KernelGenBench " -"includes 50 cuBLAS operators representing extreme performance challenges." +"NVIDIA's closed-source Basic Linear Algebra Subprograms library, highly " +"optimized for NVIDIA GPUs. KernelGenBench includes 50 cuBLAS operators " +"representing extreme performance challenges." msgstr "" -"**cuBLAS**：NVIDIA 的闭源基础线性代数子程序库，针对 NVIDIA GPU 进行了高度优化。KernelGenBench 包含 50 个 cuBLAS 算子，代表了极端的性能挑战。" +"**cuBLAS**：NVIDIA 的闭源基础线性代数子程序库，针对 NVIDIA GPU 进行了高度优化。KernelGenBench 包含 " +"50 个 cuBLAS 算子，代表了极端的性能挑战。" + +#: ../../source/glossary/index.md ../../source/glossary/index.md:22 +msgid "GEMM" +msgstr "GEMM" -#: ../../source/glossary/index.md:21 -#, python-brace-format +#: ../../source/glossary/index.md:23 msgid "" -"{.glossary} GEMM : General Matrix Multiplication, a fundamental linear " -"algebra operation. cuBLAS includes numerous GEMM variants across " -"different precisions and batching modes." +"General Matrix Multiplication, a fundamental linear algebra operation. " +"cuBLAS includes numerous GEMM variants across different precisions and " +"batching modes." msgstr "**GEMM**：通用矩阵乘法，一种基础的线性代数运算。cuBLAS 包含众多不同精度和批处理模式的 GEMM 变体。" -#: ../../source/glossary/index.md:25 -#, python-brace-format +#: ../../source/glossary/index.md:26 +msgid "Kernel" +msgstr "Kernel" + +#: ../../source/glossary/index.md:27 msgid "" -"{.glossary} Kernel : A function that executes on a GPU, written in CUDA " -"or Triton. Kernels directly determine computational performance and must " -"be optimized for specific hardware." +"A function that executes on a GPU, written in CUDA or Triton. Kernels " +"directly determine computational performance and must be optimized for " +"specific hardware." msgstr "**Kernel（内核）**：在 GPU 上执行的函数，用 CUDA 或 Triton 编写。内核直接决定计算性能，必须针对特定硬件进行优化。" -#: ../../source/glossary/index.md:29 -#, python-brace-format +#: ../../source/glossary/index.md:30 +msgid "KernelGenBench" +msgstr "KernelGenBench" + +#: ../../source/glossary/index.md:31 msgid "" -"{.glossary} KernelGenBench : A comprehensive benchmark framework for " -"evaluating LLM and agent-based Triton kernel generation across multiple " -"hardware platforms. Part of the FlagOS ecosystem." -msgstr "**KernelGenBench**：一个全面的基准框架，用于评估跨多个硬件平台的 LLM 和基于智能体的 Triton 内核生成。FlagOS 生态系统的一部分。" +"A comprehensive benchmark framework for evaluating LLM and agent-based " +"Triton kernel generation across multiple hardware platforms. Part of the " +"FlagOS ecosystem." +msgstr "" +"**KernelGenBench**：一个全面的基准框架，用于评估跨多个硬件平台的 LLM 和基于智能体的 Triton 内核生成。FlagOS " +"生态系统的一部分。" -#: ../../source/glossary/index.md:33 -#, python-brace-format +#: ../../source/glossary/index.md:34 +msgid "KernelGenBench-aten" +msgstr "KernelGenBench-aten" + +#: ../../source/glossary/index.md:35 msgid "" -"{.glossary} KernelGenBench-aten : A dataset subset containing 110 PyTorch" -" ATen operators, used for cross-platform evaluation on all supported " -"hardware." +"A dataset subset containing 110 PyTorch ATen operators, used for cross-" +"platform evaluation on all supported hardware." msgstr "**KernelGenBench-aten**：包含 110 个 PyTorch ATen 算子的数据集子集，用于所有支持硬件的跨平台评估。" -#: ../../source/glossary/index.md:37 -#, python-brace-format +#: ../../source/glossary/index.md:38 +msgid "KernelGenBench-cublas" +msgstr "KernelGenBench-cublas" + +#: ../../source/glossary/index.md:39 msgid "" -"{.glossary} KernelGenBench-cublas : A dataset subset containing 50 cuBLAS" -" operators, available only on NVIDIA platforms due to library " -"dependencies." +"A dataset subset containing 50 cuBLAS operators, available only on NVIDIA" +" platforms due to library dependencies." msgstr "**KernelGenBench-cublas**：包含 50 个 cuBLAS 算子的数据集子集，由于库依赖关系，仅在 NVIDIA 平台上可用。" -#: ../../source/glossary/index.md:41 -#, python-brace-format +#: ../../source/glossary/index.md:42 +msgid "KernelGenBench-MS" +msgstr "KernelGenBench-MS" + +#: ../../source/glossary/index.md:43 msgid "" -"{.glossary} KernelGenBench-MS : The Multi-Source sub-benchmark evaluating" -" 210 operators from three sources (ATen, vLLM, cuBLAS) on NVIDIA " -"hardware." -msgstr "**KernelGenBench-MS**：多源子基准，在 NVIDIA 硬件上评估来自三个来源（ATen、vLLM、cuBLAS）的 210 个算子。" +"The Multi-Source sub-benchmark evaluating 210 operators from three " +"sources (ATen, vLLM, cuBLAS) on NVIDIA hardware." +msgstr "" +"**KernelGenBench-MS**：多源子基准，在 NVIDIA 硬件上评估来自三个来源（ATen、vLLM、cuBLAS）的 210 " +"个算子。" + +#: ../../source/glossary/index.md:46 +msgid "KernelGenBench-MC" +msgstr "KernelGenBench-MC" -#: ../../source/glossary/index.md:45 -#, python-brace-format +#: ../../source/glossary/index.md:47 msgid "" -"{.glossary} KernelGenBench-MC : The Multi-Chip sub-benchmark evaluating " -"110 ATen operators across six hardware platforms to measure performance " -"portability." +"The Multi-Chip sub-benchmark evaluating 110 ATen operators across six " +"hardware platforms to measure performance portability." msgstr "**KernelGenBench-MC**：多芯片子基准，在六个硬件平台上评估 110 个 ATen 算子，以衡量性能可移植性。" -#: ../../source/glossary/index.md:49 -#, python-brace-format +#: ../../source/glossary/index.md:50 +msgid "KernelGenBench-vllm" +msgstr "KernelGenBench-vllm" + +#: ../../source/glossary/index.md:51 msgid "" -"{.glossary} KernelGenBench-vllm : A dataset subset containing 50 vLLM " -"operators, available only on NVIDIA platforms." +"A dataset subset containing 50 vLLM operators, available only on NVIDIA " +"platforms." msgstr "**KernelGenBench-vllm**：包含 50 个 vLLM 算子的数据集子集，仅在 NVIDIA 平台上可用。" -#: ../../source/glossary/index.md:53 -#, python-brace-format +#: ../../source/glossary/index.md ../../source/glossary/index.md:54 +msgid "LLM" +msgstr "LLM" + +#: ../../source/glossary/index.md:55 msgid "" -"{.glossary} LLM : Large Language Model, an AI model trained on vast " -"amounts of text data. In KernelGenBench, LLMs are evaluated on their " -"ability to generate GPU kernels." -msgstr "**LLM（大语言模型）**：一种在海量文本数据上训练的 AI 模型。在 KernelGenBench 中，LLM 的 GPU 内核生成能力受到评估。" +"Large Language Model, an AI model trained on vast amounts of text data. " +"In KernelGenBench, LLMs are evaluated on their ability to generate GPU " +"kernels." +msgstr "" +"**LLM（大语言模型）**：一种在海量文本数据上训练的 AI 模型。在 KernelGenBench 中，LLM 的 GPU " +"内核生成能力受到评估。" + +#: ../../source/glossary/index.md:58 +msgid "Operator" +msgstr "Operator" -#: ../../source/glossary/index.md:57 -#, python-brace-format +#: ../../source/glossary/index.md:59 msgid "" -"{.glossary} Operator : A reusable computational unit in deep learning " -"frameworks. Operators define \"what\" to compute (e.g., `torch.add`), " -"while kernels define \"how\" to execute on hardware." -msgstr "**Operator（算子）**：深度学习框架中的可复用计算单元。算子定义"计算什么"（如 `torch.add`），而内核定义"如何在硬件上执行"。" +"A reusable computational unit in deep learning frameworks. Operators " +"define \"what\" to compute (e.g., `torch.add`), while kernels define " +"\"how\" to execute on hardware." +msgstr "" +"**Operator（算子）**：深度学习框架中的可复用计算单元。算子定义\"计算什么\"（如 " +"`torch.add`），而内核定义\"如何在硬件上执行\"。" + +#: ../../source/glossary/index.md:62 +msgid "Pass@K" +msgstr "Pass@K" -#: ../../source/glossary/index.md:61 -#, python-brace-format +#: ../../source/glossary/index.md:63 msgid "" -"{.glossary} Pass@K : An evaluation metric measuring whether at least one " -"correct solution exists among K generated samples. Pass@1 tests single-" -"generation capability; Pass@5 allows multiple attempts." +"An evaluation metric measuring whether at least one correct solution " +"exists among K generated samples. Pass@1 tests single-generation " +"capability; Pass@5 allows multiple attempts." msgstr "**Pass@K**：一种评估指标，衡量 K 个生成样本中是否至少存在一个正确解。Pass@1 测试单次生成能力；Pass@5 允许多次尝试。" -#: ../../source/glossary/index.md:65 -#, python-brace-format +#: ../../source/glossary/index.md:66 +msgid "PagedAttention" +msgstr "PagedAttention" + +#: ../../source/glossary/index.md:67 msgid "" -"{.glossary} PagedAttention : A memory-efficient attention mechanism used " -"in vLLM for LLM inference. Part of the vLLM operator subset in " -"KernelGenBench." -msgstr "**PagedAttention**：vLLM 中用于 LLM 推理的高效内存注意力机制。KernelGenBench 中 vLLM 算子子集的一部分。" +"A memory-efficient attention mechanism used in vLLM for LLM inference. " +"Part of the vLLM operator subset in KernelGenBench." +msgstr "" +"**PagedAttention**：vLLM 中用于 LLM 推理的高效内存注意力机制。KernelGenBench 中 vLLM " +"算子子集的一部分。" -#: ../../source/glossary/index.md:69 -#, python-brace-format +#: ../../source/glossary/index.md:70 +msgid "Speedup" +msgstr "Speedup" + +#: ../../source/glossary/index.md:71 msgid "" -"{.glossary} Speedup : Performance improvement ratio of generated kernel " -"versus baseline implementation. Calculated as geometric mean across test " -"cases and operators." +"Performance improvement ratio of generated kernel versus baseline " +"implementation. Calculated as geometric mean across test cases and " +"operators." msgstr "**Speedup（加速比）**：生成内核相对于基准实现的性能提升比率。通过测试用例和算子的几何平均值计算。" -#: ../../source/glossary/index.md:73 -#, python-brace-format +#: ../../source/glossary/index.md:74 +msgid "Triton" +msgstr "Triton" + +#: ../../source/glossary/index.md:75 msgid "" -"{.glossary} Triton : An open-source programming language for GPU kernels " -"that abstracts low-level details while maintaining high performance. " -"Triton code is portable across different GPU architectures." +"An open-source programming language for GPU kernels that abstracts low-" +"level details while maintaining high performance. Triton code is portable" +" across different GPU architectures." msgstr "**Triton**：一种用于 GPU 内核的开源编程语言，在保持高性能的同时抽象底层细节。Triton 代码可在不同 GPU 架构间移植。" -#: ../../source/glossary/index.md:77 -#, python-brace-format +#: ../../source/glossary/index.md:78 +msgid "vLLM" +msgstr "vLLM" + +#: ../../source/glossary/index.md:79 msgid "" -"{.glossary} vLLM : A high-throughput LLM inference engine with custom " -"CUDA kernels. KernelGenBench includes 50 vLLM operators representing " -"production inference workloads." -msgstr "**vLLM**：一个带有自定义 CUDA 内核的高吞吐量 LLM 推理引擎。KernelGenBench 包含 50 个代表生产推理工作负载的 vLLM 算子。" +"A high-throughput LLM inference engine with custom CUDA kernels. " +"KernelGenBench includes 50 vLLM operators representing production " +"inference workloads." +msgstr "" +"**vLLM**：一个带有自定义 CUDA 内核的高吞吐量 LLM 推理引擎。KernelGenBench 包含 50 个代表生产推理工作负载的 " +"vLLM 算子。" #: ../../source/glossary/index.md:83 msgid "Acronyms" @@ -203,10 +271,6 @@ msgstr "AST" msgid "Abstract Syntax Tree" msgstr "抽象语法树" -#: ../../source/glossary/index.md -msgid "ATen" -msgstr "ATen" - #: ../../source/glossary/index.md msgid "A Tensor Library" msgstr "张量库" @@ -219,10 +283,6 @@ msgstr "BLAS" msgid "Basic Linear Algebra Subprograms" msgstr "基础线性代数子程序" -#: ../../source/glossary/index.md -msgid "CUDA" -msgstr "CUDA" - #: ../../source/glossary/index.md msgid "Compute Unified Device Architecture" msgstr "统一计算设备架构" @@ -235,10 +295,6 @@ msgstr "DCU" msgid "Data Center Accelerator" msgstr "数据中心加速器" -#: ../../source/glossary/index.md -msgid "GEMM" -msgstr "GEMM" - #: ../../source/glossary/index.md msgid "General Matrix Multiplication" msgstr "通用矩阵乘法" @@ -251,10 +307,6 @@ msgstr "GPU" msgid "Graphics Processing Unit" msgstr "图形处理器" -#: ../../source/glossary/index.md -msgid "LLM" -msgstr "LLM" - #: ../../source/glossary/index.md msgid "Large Language Model" msgstr "大语言模型" @@ -346,3 +398,4 @@ msgstr "沐曦" #: ../../source/glossary/index.md msgid "GPU accelerators" msgstr "GPU 加速器" + diff --git a/docs/source/locale/zh_CN/LC_MESSAGES/index.po b/docs/source/locale/zh_CN/LC_MESSAGES/index.po index c8ae50f..02dba88 100644 --- a/docs/source/locale/zh_CN/LC_MESSAGES/index.po +++ b/docs/source/locale/zh_CN/LC_MESSAGES/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: KernelGenBench Documentation \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-06-15 18:12+0800\n" +"POT-Creation-Date: 2026-06-17 11:14+0800\n" "PO-Revision-Date: 2026-06-15 10:45+0800\n" "Last-Translator: FlagOS Community\n" "Language: zh_CN\n" @@ -52,7 +52,6 @@ msgid "KernelGenBench Documentation" msgstr "KernelGenBench 文档" #: ../../source/index.md:3 -#, python-brace-format msgid "" "A benchmark framework for evaluating LLM and agent-based Triton kernel " "generation across multiple hardware platforms." @@ -62,182 +61,154 @@ msgstr "一个用于评估 LLM 和智能体驱动的 Triton 内核生成的基 msgid "Getting Started" msgstr "快速开始" -#: ../../source/index.md:13 -#, python-brace-format -msgid "::::{grid} 1 2 2 3 :gutter: 1 1 1 2" -msgstr "::::{grid} 1 2 2 3 :gutter: 1 1 1 2" - -#: ../../source/index.md:16 -#, python-brace-format +#: ../../source/index.md:17 msgid "" -":::{grid-item-card} {octicon}`browser;1.5em;sd-mr-1` Overview :link: " -"overview/index :link-type: doc" +" Overview" msgstr "" -":::{grid-item-card} {octicon}`browser;1.5em;sd-mr-1` 概述 :link: " -"overview/index :link-type: doc" -#: ../../source/index.md:20 +#: ../../source/index.md:21 msgid "Learn what KernelGenBench is, why it matters, and what it can do for you." msgstr "了解 KernelGenBench 是什么、为什么重要，以及它能为您做什么。" -#: ../../source/index.md:23 -msgid "[Learn more »](overview/index) :::" -msgstr "[了解更多 »](overview/index) :::" +#: ../../source/index.md:24 +msgid "[Learn more »](overview/index)" +msgstr "[了解更多 »](overview/index)" -#: ../../source/index.md:26 -#, python-brace-format +#: ../../source/index.md:27 msgid "" -":::{grid-item-card} {octicon}`beaker;1.5em;sd-mr-1` Features :link: " -"features/index :link-type: doc" +" Features" msgstr "" -":::{grid-item-card} {octicon}`beaker;1.5em;sd-mr-1` 功能 :link: " -"features/index :link-type: doc" -#: ../../source/index.md:30 +#: ../../source/index.md:31 msgid "" "Explore multi-source operators, multi-chip support, anti-hack validation," " and evaluation metrics." msgstr "探索多源算子、多芯片支持、防作弊验证和评估指标。" -#: ../../source/index.md:33 -msgid "[Learn more »](features/index) :::" -msgstr "[了解更多 »](features/index) :::" +#: ../../source/index.md:34 +msgid "[Learn more »](features/index)" +msgstr "[了解更多 »](features/index)" -#: ../../source/index.md:36 -#, python-brace-format +#: ../../source/index.md:37 msgid "" -":::{grid-item-card} {octicon}`rocket;1.5em;sd-mr-1` LLM Track :link: " -"operation-guide/llm-track/index :link-type: doc" +" LLM Track" msgstr "" -":::{grid-item-card} {octicon}`rocket;1.5em;sd-mr-1` LLM 赛道 :link: " -"operation-guide/llm-track/index :link-type: doc" -#: ../../source/index.md:40 +#: ../../source/index.md:41 msgid "Evaluate LLMs on generating Triton kernels with Pass@K metric." msgstr "使用 Pass@K 指标评估 LLM 生成 Triton 内核的能力。" -#: ../../source/index.md:43 -msgid "[Learn more »](operation-guide/llm-track/index) :::" -msgstr "[了解更多 »](operation-guide/llm-track/index) :::" +#: ../../source/index.md:44 +msgid "[Learn more »](operation-guide/llm-track/index)" +msgstr "[了解更多 »](operation-guide/llm-track/index)" -#: ../../source/index.md:46 -#, python-brace-format +#: ../../source/index.md:47 msgid "" -":::{grid-item-card} {octicon}`hub;1.5em;sd-mr-1` Agent Track :link: " -"operation-guide/agent-track/index :link-type: doc" +" Agent Track" msgstr "" -":::{grid-item-card} {octicon}`hub;1.5em;sd-mr-1` 智能体赛道 :link: " -"operation-guide/agent-track/index :link-type: doc" -#: ../../source/index.md:50 +#: ../../source/index.md:51 msgid "" "Evaluate coding agents that iteratively generate, verify, and optimize " "kernels." msgstr "评估能够迭代生成、验证和优化内核的编程智能体。" -#: ../../source/index.md:53 -msgid "[Learn more »](operation-guide/agent-track/index) :::" -msgstr "[了解更多 »](operation-guide/agent-track/index) :::" +#: ../../source/index.md:54 +msgid "[Learn more »](operation-guide/agent-track/index)" +msgstr "[了解更多 »](operation-guide/agent-track/index)" -#: ../../source/index.md:56 -#, python-brace-format +#: ../../source/index.md:57 msgid "" -":::{grid-item-card} {octicon}`book;1.5em;sd-mr-1` Reference :link: " -"reference/index :link-type: doc" +" " +"Reference" msgstr "" -":::{grid-item-card} {octicon}`book;1.5em;sd-mr-1` 参考 :link: " -"reference/index :link-type: doc" -#: ../../source/index.md:60 +#: ../../source/index.md:61 msgid "Datasets, operators, hardware platforms, and technical specifications." msgstr "数据集、算子、硬件平台和技术规格。" -#: ../../source/index.md:63 -msgid "[Learn more »](reference/index) :::" -msgstr "[了解更多 »](reference/index) :::" +#: ../../source/index.md:64 +msgid "[Learn more »](reference/index)" +msgstr "[了解更多 »](reference/index)" -#: ../../source/index.md:66 -#, python-brace-format +#: ../../source/index.md:67 msgid "" -":::{grid-item-card} {octicon}`tools;1.5em;sd-mr-1` Development :link: " -"development/index :link-type: doc" +" Development" msgstr "" -":::{grid-item-card} {octicon}`tools;1.5em;sd-mr-1` 开发 :link: " -"development/index :link-type: doc" -#: ../../source/index.md:70 +#: ../../source/index.md:71 msgid "Contributing guides, custom operators, and extending the framework." msgstr "贡献指南、自定义算子和框架扩展。" -#: ../../source/index.md:73 -msgid "[Learn more »](development/index) :::" -msgstr "[了解更多 »](development/index) :::" - -#: ../../source/index.md:76 -msgid "::::" -msgstr "::::" - -#~ msgid "Contents" -#~ msgstr "目录" - -#~ msgid "Quick Links" -#~ msgstr "快速链接" - -#~ msgid "Resource" -#~ msgstr "资源" - -#~ msgid "Description" -#~ msgstr "描述" - -#~ msgid "[Getting Started](getting-started/index.md)" -#~ msgstr "[快速开始](getting-started/index.md)" - -#~ msgid "Install and run your first benchmark" -#~ msgstr "安装并运行你的第一个基准测试" - -#~ msgid "{term}`Pass@K` evaluation" -#~ msgstr "{term}`Pass@K` 评估" - -#~ msgid "{term}`Agent`-based evaluation" -#~ msgstr "基于 {term}`Agent` 的评估" - -#~ msgid "[FAQ](faq/index.md)" -#~ msgstr "[常见问题](faq/index.md)" - -#~ msgid "Common questions" -#~ msgstr "常见问题" - -#~ msgid "[Glossary](glossary/index.md)" -#~ msgstr "[术语表](glossary/index.md)" - -#~ msgid "Technical terminology" -#~ msgstr "技术术语" - -#~ msgid "About" -#~ msgstr "关于" - -#~ msgid "" -#~ "{term}`KernelGenBench` is a component of " -#~ "[FlagOS](https://flagos.io/) — a unified, " -#~ "open-source AI system software stack." -#~ msgstr "" -#~ "{term}`KernelGenBench` 是 [FlagOS](https://flagos.io/) " -#~ "的一个组件——一个统一的开源 AI 系统软件栈。" - -#~ msgid "**210 operators** across {term}`ATen`, {term}`vLLM`, and {term}`cuBLAS`" -#~ msgstr "**210 个算子**，涵盖 {term}`ATen`、{term}`vLLM` 和 {term}`cuBLAS`" - -#~ msgid "**6 hardware platforms** (NVIDIA, Ascend, MUSA, Hygon, Iluvatar, MetaX)" -#~ msgstr "**6 个硬件平台**（NVIDIA、昇腾、MUSA、海光、天数智芯、沐曦）" - -#~ msgid "**Two evaluation tracks**: LLM Track and {term}`Agent` Track" -#~ msgstr "**两条评估路径**：LLM 路径和 {term}`Agent` 路径" - -#~ msgid "" -#~ "**Automatic verification**: accuracy testing " -#~ "with tolerance-based comparison" -#~ msgstr "**自动化验证**：基于容差比较的精度测试" - -#~ msgid "Citation" -#~ msgstr "引用" +#: ../../source/index.md:74 +msgid "[Learn more »](development/index)" +msgstr "[了解更多 »](development/index)"