From ed1bb4c38a9e44bc82a23c86aeabf1204de2ae0f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=B2=88=E6=B0=B8=E4=BD=B3?= <shenyongjia@student.edu.cn>
Date: Sun, 28 Sep 2025 23:40:12 +0800
Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E7=BD=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/README.md      | 72 +++++++++++++++++++++++++++++++++++++++++++++-
 doc/README_root.md | 70 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 141 insertions(+), 1 deletion(-)

diff --git a/doc/README.md b/doc/README.md
index 8779b8c..a8a8321 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -180,4 +180,74 @@ src/
 
 ## 作者
 
-软件2301班 - 沈永佳
\ No newline at end of file
+软件2301班 - 沈永佳
+
+## 客户机部署步骤（详细）
+
+本节说明如何在客户机（以 Windows 为主）部署并运行本程序。
+
+### 一、系统要求
+- 操作系统：Windows 10/11（64 位）
+- 磁盘空间：至少 100 MB（用于保存试卷与历史）
+- 运行权限：对安装目录具有读写权限（建议在用户目录或桌面下）
+
+### 二、部署包内容
+将以下文件放在同一目录（建议目录名如 `MathExamGenerator/`）：
+- `math_exam_generator.exe`（主程序）
+- `libgcc_s_seh-1.dll`（运行时依赖）
+- `libstdc++-6.dll`（运行时依赖）
+- `libwinpthread-1.dll`（运行时依赖）
+
+以上三个 DLL 为 MinGW/GCC 运行时依赖，必须与可执行文件位于同一目录。
+
+### 三、Windows 客户机部署步骤
+1. 在客户机上创建目录，例如：`C:\\Users\\<用户名>\\Desktop\\MathExamGenerator`。
+2. 将部署包中的 1 个可执行文件与 3 个 DLL 一并复制到该目录。
+3. 首次运行方式：
+   - 双击 `math_exam_generator.exe`，或
+   - 在 PowerShell 中进入目录并执行：`./math_exam_generator.exe`
+4. 程序将打开控制台提示登录与生成试卷（见“运行与使用”）。
+
+### 四、运行与使用
+- 登录账号（预置示例，可用于验证部署是否成功）：
+  - 小学：`张三1`、`张三2`、`张三3`（密码均为 `123`）
+  - 初中：`李四1`、`李四2`、`李四3`（密码均为 `123`）
+  - 高中：`王五1`、`王五2`、`王五3`（密码均为 `123`）
+- 登录成功后，程序会提示：
+  - 输入生成题目数量（范围 `10`–`30`），如输入 `20`。
+  - 支持指令切换难度：输入 `切换为小学`、`切换为初中`、`切换为高中`。
+  - 输入 `-1` 退出当前登录用户并返回登录界面。
+  - 按 `Ctrl+C` 可中断当前交互并安全返回主流程。
+
+### 五、试卷保存位置与历史
+- 程序会在当前工作目录下自动创建：`paper/<用户名>/`。
+- 每次生成的试卷文件命名格式：`YYYY-MM-DD-HH-MM-SS.txt`（时间戳）。
+- 同目录下会维护 `/.history.txt`，用于避免重复题目。
+
+### 六、升级与卸载
+- 升级：
+  - 用新版本的 `math_exam_generator.exe` 直接替换旧文件（保持目录结构与 DLL 不变）。
+  - 建议保留 `paper/` 目录以延续历史记录。
+- 卸载：
+  - 删除安装目录（例如 `MathExamGenerator/`）。
+  - 如不再需要历史与试卷，可一并删除 `paper/` 目录。
+
+### 七、常见问题（FAQ）
+- 运行时报错“缺少 DLL”或“找不到入口”：
+  - 请确认 `libgcc_s_seh-1.dll`、`libstdc++-6.dll`、`libwinpthread-1.dll` 与可执行文件在同一目录。
+- 中文显示异常或乱码：
+  - 建议在 Windows Terminal/PowerShell 中运行，程序已内置中文本地化处理；如仍异常，请尝试切换终端字体或编码。
+- 无法生成试卷或提示无权限：
+  - 确认安装目录对当前用户有写权限；避免使用受限制的系统目录（如 `C:\\Program Files`）。
+- 题目数量提示不在范围：
+  - 请输入 `10`–`30` 的整数；否则程序会提示重新输入。
+
+### 八、Linux / macOS 编译与部署（可选）
+- 在具备 `g++` 的环境下编译：
+  ```bash
+  cd src
+  make
+  # 或
+  g++ -std=c++17 -Wall -Wextra -O2 -o math_exam_generator main.cc app.cc auth.cc exam.cc login.cc utils.cc
+  ```
+- 将生成的可执行文件 `math_exam_generator` 放置到目标目录并运行：`./math_exam_generator`
diff --git a/doc/README_root.md b/doc/README_root.md
index 97e4cb4..46ddfbb 100644
--- a/doc/README_root.md
+++ b/doc/README_root.md
@@ -4,6 +4,76 @@
 
 这是一个基于 C++ 开发的中小学数学卷子自动生成程序，支持小学、初中、高中三种难度，能够自动生成符合学段要求的数学题目，并为每位教师账号按时间戳保存试卷文件。
 
+## 客户机部署步骤（详细）
+
+本节说明如何在客户机（以 Windows 为主）部署并运行本程序。
+
+### 一、系统要求
+- 操作系统：Windows 10/11（64 位）
+- 磁盘空间：至少 100 MB（用于保存试卷与历史）
+- 运行权限：对安装目录具有读写权限（建议在用户目录或桌面下）
+
+### 二、部署包内容
+将以下文件放在同一目录（建议目录名如 `MathExamGenerator/`）：
+- `math_exam_generator.exe`（主程序）
+- `libgcc_s_seh-1.dll`（运行时依赖）
+- `libstdc++-6.dll`（运行时依赖）
+- `libwinpthread-1.dll`（运行时依赖）
+
+以上三个 DLL 为 MinGW/GCC 运行时依赖，必须与可执行文件位于同一目录。
+
+### 三、Windows 客户机部署步骤
+1. 在客户机上创建目录，例如：`C:\Users\<用户名>\Desktop\MathExamGenerator`。
+2. 将部署包中的 1 个可执行文件与 3 个 DLL 一并复制到该目录。
+3. 首次运行方式：
+   - 双击 `math_exam_generator.exe`，或
+   - 在 PowerShell 中进入目录并执行：`./math_exam_generator.exe`
+4. 程序将打开控制台提示登录与生成试卷（见“运行与使用”）。
+
+### 四、运行与使用
+- 登录账号（预置示例，可用于验证部署是否成功）：
+  - 小学：`张三1`、`张三2`、`张三3`（密码均为 `123`）
+  - 初中：`李四1`、`李四2`、`李四3`（密码均为 `123`）
+  - 高中：`王五1`、`王五2`、`王五3`（密码均为 `123`）
+- 登录成功后，程序会提示：
+  - 输入生成题目数量（范围 `10`–`30`），如输入 `20`。
+  - 支持指令切换难度：输入 `切换为小学`、`切换为初中`、`切换为高中`。
+  - 输入 `-1` 退出当前登录用户并返回登录界面。
+  - 按 `Ctrl+C` 可中断当前交互并安全返回主流程。
+
+### 五、试卷保存位置与历史
+- 程序会在当前工作目录下自动创建：`paper/<用户名>/`。
+- 每次生成的试卷文件命名格式：`YYYY-MM-DD-HH-MM-SS.txt`（时间戳）。
+- 同目录下会维护 `/.history.txt`，用于避免重复题目。
+
+### 六、升级与卸载
+- 升级：
+  - 用新版本的 `math_exam_generator.exe` 直接替换旧文件（保持目录结构与 DLL 不变）。
+  - 建议保留 `paper/` 目录以延续历史记录。
+- 卸载：
+  - 删除安装目录（例如 `MathExamGenerator/`）。
+  - 如不再需要历史与试卷，可一并删除 `paper/` 目录。
+
+### 七、常见问题（FAQ）
+- 运行时报错“缺少 DLL”或“找不到入口”：
+  - 请确认 `libgcc_s_seh-1.dll`、`libstdc++-6.dll`、`libwinpthread-1.dll` 与可执行文件在同一目录。
+- 中文显示异常或乱码：
+  - 建议在 Windows Terminal/PowerShell 中运行，程序已内置中文本地化处理；如仍异常，请尝试切换终端字体或编码。
+- 无法生成试卷或提示无权限：
+  - 确认安装目录对当前用户有写权限；避免使用受限制的系统目录（如 `C:\Program Files`）。
+- 题目数量提示不在范围：
+  - 请输入 `10`–`30` 的整数；否则程序会提示重新输入。
+
+### 八、Linux / macOS 编译与部署（可选）
+- 在具备 `g++` 的环境下编译：
+  ```bash
+  cd src
+  make
+  # 或
+  g++ -std=c++17 -Wall -Wextra -O2 -o math_exam_generator main.cc app.cc auth.cc exam.cc login.cc utils.cc
+  ```
+- 将生成的可执行文件 `math_exam_generator` 放置到目标目录并运行：`./math_exam_generator`
+
 ## 快速开始
 
 - 进入 `src` 目录
-- 
2.34.1