Project-LemonLime · ZnPdCo · Apr 26, 2026 · May 7, 2026 · May 7, 2026 · May 7, 2026
diff --git a/.github/workflows/windows-qt6.yml b/.github/workflows/windows-qt6.yml
@@ -82,8 +82,7 @@ jobs:
             -GNinja \
             -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
             -DLEMON_BUILD_INFO="Build for Windows" \
-            -DLEMON_BUILD_EXTRA_INFO="Build on Windows x64" \
-            -DENABLE_XLS_EXPORT=ON
+            -DLEMON_BUILD_EXTRA_INFO="Build on Windows x64"
           cmake --build . --parallel $(nproc)
       - name: Deploy Qt for tests
         shell: pwsh

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -19,8 +19,6 @@ option(EMBED_TRANSLATIONS "Embed translations" ON)
 LEMONLOG(EMBED_TRANSLATIONS)
 option(EMBED_DOCS "Embed documents" ON)
 LEMONLOG(EMBED_DOCS)
-option(ENABLE_XLS_EXPORT "XLS Result Export Support (Windows Only)" OFF)
-LEMONLOG(ENABLE_XLS_EXPORT)
 option(BUILD_DEB "Build deb format package" OFF)
 LEMONLOG(BUILD_DEB)
 option(BUILD_RPM "Build rpm format package" OFF)
@@ -287,12 +285,6 @@ endif()
 
 target_include_directories(lemon PUBLIC ${CMAKE_SOURCE_DIR}/src)
 
-if(WIN32 AND ENABLE_XLS_EXPORT)
-    find_package(${LEMON_QT_LIBNAME} COMPONENTS AxContainer REQUIRED)
-    list(APPEND LEMON_QT_LIBS ${LEMON_QT_LIBNAME}::AxContainer)
-    add_definitions(-DENABLE_XLS_EXPORT)
-endif()
-
 target_precompile_headers(lemon PUBLIC ${CMAKE_SOURCE_DIR}/src/pch.h)
 
 target_link_libraries(lemon PRIVATE ${LEMON_QT_LIBS} lemon-core lemon-base SingleApplication::SingleApplication spdlog::spdlog)

diff --git a/resource.qrc b/resource.qrc
@@ -7,6 +7,9 @@
         <file>makespec/VERSIONSUFFIX</file>
         <file>assets/lemon-lime.ico</file>
     </qresource>
+    <qresource prefix="/export">
+        <file alias="export_template.html">src/component/exportutil/export_template.html</file>
+    </qresource>
     <qresource prefix="/icon">
         <file alias="icon.png">assets/icons/lemon-lime.png</file>
         <file alias="code-function.svg">assets/pics/code-function.svg</file>

diff --git a/src/component/exportutil/README.md b/src/component/exportutil/README.md
@@ -0,0 +1,151 @@
+# ExportUtil 导出模块
+
+本模块负责将比赛成绩导出为 HTML 或 CSV 格式。
+
+HTML 导出采用 **JSON + 模板** 方案：C++ 端通过 `buildExportJson()` 构建包含全部比赛数据的 JSON 对象，然后将其嵌入 `export_template.html` 中的 `%%DATA%%` 占位符，由浏览器端 JavaScript 完成页面渲染。这种方式将数据构造与页面展示解耦，C++ 代码只需关注 JSON 结构，无需拼接 HTML 字符串。
+
+以下是 JSON 数据的结构说明。
+
+### 顶级字段
+
+| 字段名        | 类型       | 说明             | 举例                                  |
+| ------------- | ---------- | ---------------- | ------------------------------------- |
+| `name`        | `string`   | 比赛名称         | `"contest"`                           |
+| `version`     | `string`   | LemonLime 版本   | `"Lemonlime Version 0.3.6.1:7545e02"` |
+| `task_names`  | `string[]` | 题目名称数组     | `["plus", "minus"]`                   |
+| `i18n`        | `object`   | i18n 字典        | 见下节                                |
+| `contestants` | `object[]` | 选手成绩数据数组 | 见下节                                |
+
+### i18n
+
+| 字段名        | 举例                                                      |
+| ------------- | --------------------------------------------------------- |
+| `rank_list`   | `"排名表"`                                                |
+| `hint`        | `"点击名字或单题分数跳转到详细信息。使用 LemonLime 评测"`       |
+| `rank`        | `"排名"`                                                  |
+| `name`        | `"名称"`                                                  |
+| `total`       | `"总分"`                                                  |
+| `contestant`  | `"选手"`                                                  |
+| `task`        | `"试题"`                                                  |
+| `source_file` | `"源程序："`                                              |
+| `no_source`   | `"未找到选手程序"`                                         |
+| `testcase`    | `"测试点"`                                                |
+| `input`       | `"输入文件"`                                              |
+| `result`      | `"测试结果"`                                              |
+| `time`        | `"运行用时"`                                              |
+| `memory`      | `"内存消耗"`                                              |
+| `score`           | `"得分"`                                                  |
+| `return_to_top`   | `"返回顶部"`                                              |
+
+---
+
+### contestants 数组内对象
+
+| 字段名         | 类型       | 说明                 | 举例            |
+| -------------- | ---------- | -------------------- | --------------- |
+| `name`         | `string`   | 选手姓名             | `"Alice"`       |
+| `rank`         | `number`   | 选手排名             | `1`             |
+| `total_score`  | `number`   | 选手总分             | `200`           |
+| `total_bg`     | `string`   | 总分单元格背景 (HSL) | `"0, 70%, 90%"` |
+| `total_border` | `string`   | 总分单元格边框 (HSL) | `"0, 70%, 50%"` |
+| `tasks`        | `object[]` | 题目结果数组         | 见下节          |
+
+---
+
+### tasks 数组内对象
+
+| 字段名    | 类型       | 说明               | 举例              |
+| --------- | ---------- | ------------------ | ----------------- |
+| `score`   | `number`   | 该题单项得分       | `100`             |
+| `bg`      | `string`   | 该题得分背景 (HSL) | `"120, 30%, 60%"` |
+| `file`    | `string`   | 选手程序文件名（可选，若无该字段则表示找不到选手程序）     | `"plus.cpp"`      |
+| `details` | `object[]` | 测试点详情数组     | 见下节            |
+
+---
+
+### details 数组内对象
+
+| 字段名       | 类型     | 说明                                                 | 举例                           |
+| ------------ | -------- | ---------------------------------------------------- | ------------------------------ |
+| `label`      | `string` | 测试点编号或子任务信息，允许使用 `<br>`              | `"#2<br/>子任务依赖情况:Pure"` |
+| `row_span`   | `number` | 合并单元格行数（0 表示该行被合并，1 表示该行不合并） | `1`                            |
+| `input`      | `string` | 该测试点输入文件名                                   | `"plus2.in"`                   |
+| `result`     | `string` | 评测状态结果文字                                     | `"评测通过"`                   |
+| `time`       | `string` | 运行耗时字符串                                       | `"0.005 s"`                    |
+| `memory`     | `string` | 内存占用字符串                                       | `"5.34 MB"`                    |
+| `score`      | `number` | 该项得分                                             | `20`                           |
+| `full_score` | `number` | 该项满分                                             | `20`                           |
+| `bg`      | `string`   | 状态背景 (RGB) | `"rgb(192, 255, 192)"` |
+| `info` | `string` | 测评信息（可选） | `在第四行，读取到 123456，但期望 789123` |
+
+---
+
+### 示例 JSON
+
+以下 JSON 可用于调试模板渲染：
+
+```json
+{
+    "name": "example contest",
+    "version": "Lemonlime Version 0.3.6.1:7545e02",
+    "i18n": {
+        "rank_list": "排名表",
+        "hint": "点击名字或单题分数跳转到详细信息。使用 LemonLime 评测",
+        "rank": "排名",
+        "name": "名称",
+        "total": "总分",
+        "contestant": "选手",
+        "task": "试题",
+        "source_file": "源程序：",
+        "no_source": "未找到选手程序",
+        "testcase": "测试点",
+        "input": "输入文件",
+        "result": "测试结果",
+        "time": "运行用时",
+        "memory": "内存消耗",
+        "score": "得分"
+    },
+    "task_names": ["plus", "minus"],
+    "contestants": [
+        {
+            "name": "Alice",
+            "rank": 1,
+            "total_score": 150,
+            "total_bg": "120, 30%, 90%",
+            "total_border": "120, 30%, 50%",
+            "tasks": [
+                {
+                    "score": 100,
+                    "bg": "120, 30%, 70%",
+                    "file": "plus.cpp",
+                    "details": [
+                        { "label": "#1", "row_span": 1, "input": "plus1.in", "result": "评测通过", "time": "0.001 s", "memory": "1.2 MB", "score": 50, "full_score": 50, "bg": "rgb(192, 255, 192)" },
+                        { "label": "#2", "row_span": 1, "input": "plus2.in", "result": "评测通过", "time": "0.002 s", "memory": "1.2 MB", "score": 50, "full_score": 50, "bg": "rgb(192, 255, 192)" }
+                    ]
+                },
+                {
+                    "score": 50,
+                    "bg": "120,28.9006%,82.3499%",
+                    "file": "minus.cpp",
+                    "details": [
+                        { "label": "#1", "row_span": 1, "input": "minus1.in", "result": "评测通过", "time": "0.001 s", "memory": "1.2 MB", "score": 50, "full_score": 50, "bg": "rgb(192, 255, 192)" },
+                        { "label": "#2<br>子任务依赖情况:Pure", "row_span": 2, "input": "minus2.in", "result": "答案错误", "time": "0.001 s", "memory": "2.0 MB", "score": 0, "full_score": 50, "bg": "rgb(255, 192, 192)", "info": "在第四行，读取到 123456，但期望 789123" },
+                        { "label": "", "row_span": 0, "input": "minus3.in", "result": "运行错误", "time": "0.001 s", "memory": "2.0 MB", "score": 0, "full_score": 50, "bg": "rgb(255, 192, 192)" }
+                    ]
+                }
+            ]
+        },
+        {
+            "name": "Bob",
+            "rank": 2,
+            "total_score": 0,
+            "total_bg": "0, 0%, 90%",
+            "total_border": "0, 0%, 70%",
+            "tasks": [
+                { "score": 0, "bg": "0, 0%, 90%" },
+                { "score": 0, "bg": "0, 0%, 90%" }
+            ]
+        }
+    ]
+}
+```