docs: 彻底更新和优化文档系统

- 更新VitePress配置:添加API参考、基准测试、贡献指南导航
- 新增API参考页面:Go库、Rust包、C++实现
- 新增基准测试结果页面和运行指南
- 新增参与贡献指南页面(双语)
- 更新快速开始指南反映新的Go cmd/结构
- 更新项目结构文档
- 完善搜索配置的英文本地化
- 更新暗色模式样式和CSS变量
- 增强特性卡片悬停效果和滚动条样式

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

Author: LessUp

docs/.vitepress/config.mts

@@ -5,39 +5,65 @@ const sharedSidebar = {
   '/en/': [
     {
       text: 'Overview',
-      items: [{ text: 'Home', link: '/en/' }],
+      items: [
+        { text: 'Home', link: '/en/' },
+        { text: 'Quick Start', link: '/en/guide/getting-started' },
+        { text: 'Algorithms', link: '/en/guide/algorithms' },
+      ],
     },
     {
-      text: 'Guide',
+      text: 'API Reference',
       items: [
-        { text: 'Getting Started', link: '/en/guide/getting-started' },
-        { text: 'Algorithms', link: '/en/guide/algorithms' },
+        { text: 'Go Library', link: '/en/api/go' },
+        { text: 'Rust Crate', link: '/en/api/rust' },
+        { text: 'C++ Header', link: '/en/api/cpp' },
+      ],
+    },
+    {
+      text: 'Benchmarks',
+      items: [
+        { text: 'Performance Results', link: '/en/benchmarks/results' },
+        { text: 'How to Run', link: '/en/benchmarks/how-to-run' },
       ],
     },
     {
       text: 'Reference',
       items: [
         { text: 'Project Structure', link: '/en/guide/project-structure' },
+        { text: 'Contributing', link: '/en/guide/contributing' },
         { text: 'Specs (SSOT)', link: 'https://github.com/LessUp/encoding/tree/master/specs' },
       ],
     },
   ],
   '/zh/': [
     {
       text: '概览',
-      items: [{ text: '首页', link: '/zh/' }],
-    },
-    {
-      text: '指南',
       items: [
+        { text: '首页', link: '/zh/' },
         { text: '快速开始', link: '/zh/guide/getting-started' },
         { text: '算法详解', link: '/zh/guide/algorithms' },
       ],
     },
+    {
+      text: 'API 参考',
+      items: [
+        { text: 'Go 库', link: '/zh/api/go' },
+        { text: 'Rust 包', link: '/zh/api/rust' },
+        { text: 'C++ 头文件', link: '/zh/api/cpp' },
+      ],
+    },
+    {
+      text: '基准测试',
+      items: [
+        { text: '性能结果', link: '/zh/benchmarks/results' },
+        { text: '如何运行', link: '/zh/benchmarks/how-to-run' },
+      ],
+    },
     {
       text: '参考',
       items: [
         { text: '项目结构', link: '/zh/guide/project-structure' },
+        { text: '参与贡献', link: '/zh/guide/contributing' },
         { text: '规范文档 (SSOT)', link: 'https://github.com/LessUp/encoding/tree/master/specs' },
       ],
     },
@@ -49,7 +75,9 @@ const sharedNav = (lang: string) => [
   { text: lang === 'zh' ? '概览' : 'Overview', link: lang === 'zh' ? '/zh/' : '/en/' },
   { text: lang === 'zh' ? '快速开始' : 'Get Started', link: lang === 'zh' ? '/zh/guide/getting-started' : '/en/guide/getting-started' },
   { text: lang === 'zh' ? '算法' : 'Algorithms', link: lang === 'zh' ? '/zh/guide/algorithms' : '/en/guide/algorithms' },
-  { text: lang === 'zh' ? '参考' : 'Reference', link: lang === 'zh' ? '/zh/guide/project-structure' : '/en/guide/project-structure' },
+  { text: lang === 'zh' ? 'API' : 'API', link: lang === 'zh' ? '/zh/api/go' : '/en/api/go' },
+  { text: lang === 'zh' ? '性能' : 'Benchmarks', link: lang === 'zh' ? '/zh/benchmarks/results' : '/en/benchmarks/results' },
+  { text: lang === 'zh' ? '贡献' : 'Contributing', link: lang === 'zh' ? '/zh/guide/contributing' : '/en/guide/contributing' },
   { text: 'Changelog', link: 'https://github.com/LessUp/encoding/blob/master/CHANGELOG.md' },
 ]
 
@@ -72,7 +100,7 @@ export default defineConfig({
     ['meta', { property: 'og:title', content: 'Encoding | Compression Algorithms Collection' }],
     ['meta', { property: 'og:description', content: 'Classic compression algorithms in C++, Go, and Rust for learning, comparison and cross-language verification' }],
     ['meta', { property: 'og:url', content: 'https://lessup.github.io/encoding/' }],
-    ['meta', { name: 'twitter:card', content: 'summary' }],
+    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
     ['meta', { name: 'twitter:title', content: 'Encoding | Compression Algorithms Collection' }],
     ['meta', { name: 'twitter:description', content: 'Classic compression algorithms in C++, Go, and Rust for learning, comparison and cross-language verification' }],
     ['link', { rel: 'icon', type: 'image/svg+xml', href: '/encoding/logo.svg' }],
@@ -159,11 +187,28 @@ export default defineConfig({
       { icon: 'github', link: 'https://github.com/LessUp/encoding' },
     ],
 
-    // Search (shared)
+    // Search (localized)
     search: {
       provider: 'local',
       options: {
         locales: {
+          root: {
+            translations: {
+              button: {
+                buttonText: 'Search',
+                buttonAriaLabel: 'Search docs',
+              },
+              modal: {
+                noResultsText: 'No results found',
+                resetButtonTitle: 'Reset search',
+                footer: {
+                  selectText: 'select',
+                  navigateText: 'navigate',
+                  closeText: 'close',
+                },
+              },
+            },
+          },
           zh: {
             translations: {
               button: {

docs/.vitepress/theme/styles/custom.css

@@ -1 +1,60 @@
 /* Custom styles */
+
+/* Algorithm comparison table - highlight compression ratios */
+.vp-doc table td:last-child {
+  font-variant-numeric: tabular-nums;
+}
+
+/* Code block improvements */
+.vp-doc .line-numbers-mode {
+  border-radius: 8px;
+}
+
+/* Improve dark mode contrast for code blocks */
+.dark .vp-doc div[class*='language-'] {
+  border: 1px solid var(--vp-c-border);
+}
+
+/* Hero image sizing */
+.VPHero .image-container {
+  width: 200px;
+  height: 200px;
+}
+
+.VPHero .image-bg {
+  width: 200px;
+  height: 200px;
+}
+
+/* Feature card hover effect */
+.VPFeature {
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+}
+
+.VPFeature:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+}
+
+.dark .VPFeature:hover {
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+}
+
+/* Scrollbar styling */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--vp-c-divider);
+  border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--vp-c-text-3);
+}

docs/.vitepress/theme/styles/vars.css

@@ -1 +1,23 @@
 /* Custom CSS variables for VitePress theme */
+
+:root {
+  --vp-c-brand: #3b82f6;
+  --vp-c-brand-light: #60a5fa;
+  --vp-c-brand-lighter: #93c5fd;
+  --vp-c-brand-dark: #2563eb;
+  --vp-c-brand-darker: #1d4ed8;
+  --vp-c-brand-1: #3b82f6;
+  --vp-c-brand-2: #2563eb;
+  --vp-c-brand-3: #1d4ed8;
+}
+
+.dark {
+  --vp-c-brand: #60a5fa;
+  --vp-c-brand-light: #93c5fd;
+  --vp-c-brand-lighter: #bfdbfe;
+  --vp-c-brand-dark: #3b82f6;
+  --vp-c-brand-darker: #2563eb;
+  --vp-c-brand-1: #60a5fa;
+  --vp-c-brand-2: #3b82f6;
+  --vp-c-brand-3: #2563eb;
+}

docs/en/api/cpp.md

@@ -0,0 +1,106 @@
+# C++ Implementation Reference
+
+All C++ implementations are single-file, zero-dependency programs using C++17.
+
+## Compilation
+
+```bash
+g++ -std=c++17 -O2 -Wall -Wextra -o <binary> main.cpp
+```
+
+### Recommended Flags
+
+| Flag | Purpose |
+|------|---------|
+| `-std=c++17` | Enable C++17 features |
+| `-O2` | Optimization level |
+| `-Wall -Wextra` | Warnings |
+| `-fsanitize=address` | AddressSanitizer (debug builds) |
+| `-fsanitize=undefined` | UBSan (debug builds) |
+
+## Huffman (`algorithms/huffman/cpp/main.cpp`)
+
+### Usage
+
+```bash
+./huffman_cpp encode input.bin output.huf
+./huffman_cpp decode output.huf decoded.bin
+```
+
+### Internal Structure
+
+- `BitWriter` / `BitReader` — bit-level I/O classes
+- `Node` — Huffman tree node with custom deleter
+- `compress_file()` / `decompress_file()` — main encode/decode functions
+
+### File Format
+
+| Offset | Size | Field |
+|--------|------|-------|
+| 0 | 4B | Magic: `HFMN` |
+| 4 | 4B | Frequency table size (always 257) |
+| 8 | 1028B | Frequency table (257 × uint32 LE) |
+| 1036+ | Variable | Encoded bit stream |
+
+---
+
+## Arithmetic (`algorithms/arithmetic/cpp/main.cpp`)
+
+### Usage
+
+```bash
+./arithmetic_cpp encode input.bin output.aenc
+./arithmetic_cpp decode output.aenc decoded.bin
+```
+
+### Key Classes
+
+- `ArithmeticEncoder` — state machine with `low`, `high`, `pendingBits`
+- `ArithmeticDecoder` — decoder with `code` initialization
+
+---
+
+## Range Coder (`algorithms/range/cpp/main.cpp`)
+
+### Usage
+
+```bash
+./rangecoder_cpp encode input.bin output.rcnc
+./rangecoder_cpp decode output.rcnc decoded.bin
+```
+
+### File Format
+
+| Offset | Size | Field |
+|--------|------|-------|
+| 0 | 4B | Magic: `RCNC` |
+| 4 | 4B | Frequency table size |
+| 8 | Variable | Frequency table |
+| ... | Variable | Byte stream (renormalized intervals) |
+
+---
+
+## RLE (`algorithms/rle/cpp/main.cpp`)
+
+### Usage
+
+```bash
+./rle_cpp encode input.bin output.rle
+./rle_cpp decode output.rle decoded.bin
+```
+
+### File Format
+
+Repeated `(count: uint32 LE, value: byte)` pairs.
+
+---
+
+## Common Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| Single file | Each algorithm in one `main.cpp` |
+| Zero dependencies | Only standard library |
+| `#include <...>` | Standard library only |
+| Error handling | `fprintf(stderr, ...)` + `exit(1)` |
+| Memory management | `std::unique_ptr` with custom deleters |