2026spring_middle_lab

Author: 1-rambo

.vitepress/config.mts

@@ -14,8 +14,7 @@ export default defineConfig({
       },
       {
         text: '大作业文档',
-        // link: 'https://pku-software.github.io/project-doc/'
-        link: ''
+        link: 'https://pku-software.github.io/project-doc/'
       }
     ],
 
@@ -32,33 +31,33 @@ export default defineConfig({
                 text: '如何找到问题的答案',
                 link: '/26spring/before_ask/how_to_find_answers'
               },
-              // {
-              //   text: '写大作业时遇到了问题',
-              //   link: 'https://pku-software.github.io/project-doc/preface/facing-problem.html'
-              // }
+              {
+                text: '写大作业时遇到了问题',
+                link: 'https://pku-software.github.io/project-doc/preface/facing-problem.html'
+              }
             ]
           },
           { text: '环境配置', link: 'https://pku-software.github.io/CppEnvSetup/' },
-          // { text: '中作业', 
-          //   items: [
-          //     {
-          //       text: '中作业文档',
-          //       link: '/25spring/middle_homework/document'
-          //     },
-          //     {
-          //       text: 'Web API 文档',
-          //       link: '/25spring/middle_homework/api'
-          //     },
-          //     {
-          //       text: 'Git 基础',
-          //       link: '/25spring/middle_homework/git'
-          //     },
-          //     {
-          //       text: '常见问题',
-          //       link: '/25spring/middle_homework/faq'
-          //     }
-          //   ]  
-          // },
+          { text: '中作业', 
+            items: [
+              {
+                text: '中作业文档',
+                link: '/26spring/middle_homework/document'
+              },
+              {
+                text: 'Web API 文档',
+                link: '/26spring/middle_homework/api'
+              },
+              {
+                text: 'Git 基础',
+                link: '/26spring/middle_homework/git'
+              },
+              {
+                text: '常见问题',
+                link: '/26spring/middle_homework/faq'
+              }
+            ]  
+          },
           // {
           //   text: "知识相关问题",
           //   items: [
@@ -78,10 +77,10 @@ export default defineConfig({
         text: '上机作业参考答案',
         link: 'https://pku-software.github.io/homework-answer/'
       },
-      // {
-      //   text: '大作业文档',
-      //   link: 'https://pku-software.github.io/project-doc/'
-      // },
+      {
+        text: '大作业文档',
+        link: 'https://pku-software.github.io/project-doc/'
+      },
       {
         text: '谷雨同学的 C++ 教程',
         link: 'https://learn-cpp.guyutongxue.site/'

25spring/middle_homework/document.md

@@ -84,13 +84,13 @@ References:
 
 每个文献都具有一个 `id`，它在文章中使用 `[id]` 来进行引用。我们需要找到文章中所有的 `id`，并按照 `id` 顺序（以字符串顺序为准）在文末对文献进行排列。
 
-文献信息存储在JSON格式的文献合集。在文献合集中，所有的文献都保存在 `citations` 数组，数组中的每个对象代表了一个文献，并且具有字符串形式的 `id`。我们保证所有的 `id` 是无重复的。
+文献信息存储在 JSON 格式的文献合集。在文献合集中，所有的文献都保存在 `citations` 数组，数组中的每个对象代表了一个文献，并且具有字符串形式的 `id`, 正确的 `id` 应当仅包含数字和字母。我们保证所有的 `id` 是无重复的。
 
-我们要求处理的文献有三类（其中`[]`括起来的表示需要使用具体内容替换）：
+我们要求处理的文献有三类（其中 `[]` 括起来的表示需要使用具体内容替换）：
 
-+ 书籍，在文献合集中对象的字段 `type` 为 `"book"`，只具有`ISBN`号，需要程序从网络上查询合适的额外信息，最终的输出格式为 `[id] book: [作者], [书籍标题], [出版社], [出版年份]`。
-+ 网页，在文献合集中对象的字段 `type` 为 `"webpage"`，只具有网址，同样需要程序从网络上查询，最终的输出格式为 `[id] webpage: [网页标题]. Available at [网址]`。
-+ 文章在文献合集中对象的字段 `type` 为 `"article"`，对象的内容包含了它的全部信息，最终的输出格式为 `[id] article: [作者], [文章标题], [期刊名], [发表年份], [卷号], [期号]`。
++ 书籍，在文献合集中对象的字段 `type` 为 `"book"`，只具有 `ISBN` 号，需要程序从网络上查询合适的额外信息，最终的输出格式为 `[id] book: [作者], [书籍标题], [出版社], [出版年份]`，例如 `[1] book: Randal E. Bryant, David R. O'Hallaron, Computer Systems, Addison-Wesley, 2015`。
++ 网页，在文献合集中对象的字段 `type` 为 `"webpage"`，只具有网址，同样需要程序从网络上查询，最终的输出格式为 `[id] webpage: [网页标题]. Available at [网址]`，例如 `[2] webpage: PyTorch. Available at https://pytorch.org`。
++ 文章在文献合集中对象的字段 `type` 为 `"article"`，对象的内容包含了它的全部信息，最终的输出格式为 `[id] article: [作者], [文章标题], [期刊名], [发表年份], [卷号], [期号]`，例如 `[3] article: Marshall Kirk McKusick, William N. Joy, Samuel J. Leffler, Robert S. Fabry, A Fast File System for UNIX, ACM Transactions on Computer Systems, 1984, 2, 3`。
 
 对于网络进行查询的接口如何使用请详见[附录](#HTTP)。我们期望你补充的内容包括：
 
@@ -99,23 +99,23 @@ References:
 + `Citation` 类及其子类，用于表示文献的信息，请考虑如何尽量避免代码冗余。
 + 从网络获取信息的函数（写在对应的子类中）。请注意异常处理。
 
-同时，我们在 `utils.hpp` 中为大家提供了工具函数`encodeUriComponent` ，其作用见[附录HTTP部分](#HTTP)。<del>本来还提供了`readFromFile` 将文件内容完全读取到一个 `std::string` 中并返回，但是家铭助教把这几行代码给删掉了，让大家练习下怎么读文件。</del>
+同时，我们在 `utils.hpp` 中为大家提供了工具函数 `encodeUriComponent` ，其作用见[附录HTTP部分](#HTTP)。<del>本来还提供了 `readFromFile` 将文件内容完全读取到一个 `std::string` 中并返回，但是助教把这几行代码给删掉了，让大家练习下怎么读文件。</del>
 
 最终，假设编译得到的可执行程序为`docman`，我们期望你的程序通过命令行进行处理：
 
 ```shell
 ./docman OPTIONS input_file
 ```
 
-其中`input_file`为输入的文章路径（如果仅为一个`-`，则文章会从标准输入读入），`OPTIONS`则由若干个选项组成，每个选项则有以下可能：
+其中 `input_file` 为输入的文章路径（如果仅为一个`-`，则文章会从标准输入读入），`OPTIONS`则由若干个选项组成，每个选项则有以下可能，且顺序不定：
 
 + `-c citation_path`，表示文献合集的路径，**必须填写**。
 + `-o output_path`，表示增加引用列表后的文章的输出路径。这个选项如果没有指定，则输出到标准输出。
 
-如果选项出现冲突、出现未知选项、错误选项等，程序不应该读取任何输入，并 `std::exit(1)`。对于用户任何不合法的输入，例如不合法的文献合集、引用 id 未出现在合集中、合集对象字段不正确等，我们不会读取你输出了什么，但是也需要 `std::exit(1)`；同时如果输出到文件，则只有当输入完全正确时才创建输出文件。请保证程序的**健壮性**，助教会想出各种奇怪的 case 作为输入。我们唯一保证的是：
+如果选项出现冲突、出现未知选项、错误选项等，程序不应该读取任何输入，并 `std::exit(1)`。对于用户任何不合法的输入，例如不合法的文献合集、引用 id 未出现在合集中、id 包含非数字字母的字符、合集对象字段不正确等，我们不会读取你输出了什么，但是也需要 `std::exit(1)`；同时如果输出到文件，则只有当输入完全正确时才创建输出文件。请保证程序的**健壮性**，助教会想出各种奇怪的 case 作为输入。我们保证的是：
 
-+ 用户输入的文献合集一定是一个合法JSON文件，不必担心`parse`出错；
-+ 文章中的`[`和`]`只可能出现在文献的引用中，不会出现在正常的行文里。因此不成对的括号也是需要`std::exit(1)`的。
++ 用户输入的文献合集一定是一个合法 JSON 文件，不必担心 `parse` 出错；
++ 文章中的 `[` 和 `]` 只可能出现在文献的引用中，不会出现在正常的行文里。因此文章中如果出现不成对的括号，属于异常情况，是需要 `std::exit(1) `的。
 
 > 这种错误处理的方式是一种非常简化的方式，因为我们还没有讲异常等手段。在大作业中我们不再使用这种方式。
 
@@ -125,8 +125,8 @@ References:
 2. 请注意异常处理，确保用户输入符合要求，提升程序的健壮性。
 3. 请注意代码的可读性，合理使用注释，提高代码的可维护性。
 4. 注意代码的模块化，合理划分函数，提高代码的复用性。
-5. 可以修改 `CMakeLists.txt`，使工程符合你的需要，包括并不限于增加依赖库、增加其他 target 等，但要保持可执行文件名称为 `docman` 不变，不修改默认二进制输出位置（对于编译文件夹是 `build` 的情况，二进制将位于 `build/docman`。这个[视频](https://www.bilibili.com/video/BV1Pg4y1U7XM?t=3072.7)介绍了 `CMake` 的使用，供参考。
-6. 使用 Git 等版本控制工具管理代码。**特别注意，对于本次作业（以及之后的大作业），不要把你的代码仓库设置为public的，这相当于在考场上把你的答案给每个人看一遍，助教会进行严肃处理**。
+5. 可以修改 `CMakeLists.txt`，使工程符合你的需要，包括并不限于增加依赖库（如命令行参数解析库）、增加其他 target 等，但要保持可执行文件名称为 `docman` 不变，不修改默认二进制输出位置（对于编译文件夹是 `build` 的情况，二进制将位于 `build/docman`。这个[视频](https://www.bilibili.com/video/BV1Pg4y1U7XM?t=3072.7)介绍了 `CMake` 的使用，供参考。
+6. 使用 Git 等版本控制工具管理代码。**特别注意，对于本次作业（以及之后的大作业），不要把你的代码仓库设置为 public 的，这相当于在考场上把你的答案给每个人看一遍，助教会进行严肃处理**。
 
 ## 附录
 
@@ -160,7 +160,7 @@ JSON（JavaScript Object Notation），是 JavaScript 生成其对象时采用
 }
 ```
 
-在 C++ 标准库中没有 JSON 解析库，但是我们可以使用第三方库 [nlohmann/json](https://github.com/nlohmann/json) 来进行解析。这个库的一大特点就是非常符合直觉，一学就会，性能也还行。例如：
+在 C++ 标准库中没有 JSON 解析库，但是我们可以使用第三方库 [nlohmann/json](https://github.com/nlohmann/json) 来进行解析。这个库的一大特点就是非常符合直觉，一学就会，性能也还不错。例如：
 
 ```c++
 #include <fstream>
@@ -199,13 +199,13 @@ std::ofstream outFile{ "out.json" };
 outFile << data; // 输出格式为 json
 ```
 
-当然，你可以用如 `data["Never"].is_null()`、`is_boolean()`、`is_number()`、`is_object()`、`is_array()`、`is_string()` 来直接检查字段的类型，`data.contains("Never")` 来检查字段是否存在，这对于检查文献合集是否合法非常重要。
+当然，你可以用如 `data["Never"].is_null()`、`is_boolean()`、`is_number_integer()`、`is_object()`、`is_array()`、`is_string()` 来直接检查字段的类型，`data.contains("Never")` 来检查字段是否存在，这对于检查文献合集是否合法非常重要。
 
 ### <span id="HTTP">Web API</span>
 
 在日常使用浏览器观看视频或阅读文章时，你是否好奇过为何能轻松访问千里之外的服务器资源？这背后正是计算机网络的核心功能。具体来说，网络通过物理介质（如光纤、电缆、无线信号）连接全球设备，并借助路由交换技术，确保数据能够跨越不同地理位置的节点，最终准确送达目标机器。全球最大的互联网络称为"因特网"（Internet），其中每台设备都通过路由器分配的IP地址进行唯一标识。
 
-不过，可以注意到我们在访问网站时通常不会输入 IP 地址，而是输入一个形如 `baidu.com` 的形式（即域名）。实际上，这个字符串会先经由附近的 DNS 服务器进行解析，解析为 IP 地址，再访问这个 IP 地址。事实上，域名后面通常还会跟着 `/AA/BB`，构成一整个URL，例如我们的课程通知网页形如 `pku-software.github.io/25spring/notices.html`；这时 `/AA/BB` 则由服务器端进行解析，来确定客户端在请求什么服务。
+不过，可以注意到我们在访问网站时通常不会输入 IP 地址，而是输入一个形如 `baidu.com` 的形式（即域名）。实际上，这个字符串会先经由附近的 DNS 服务器进行解析，解析为 IP 地址，再访问这个 IP 地址。事实上，域名后面通常还会跟着 `/AA/BB`，构成一整个URL，例如我们的课程通知网页形如 `pku-software.github.io/26spring/notices.html`；这时 `/AA/BB` 则由服务器端进行解析，来确定客户端在请求什么服务。
 
 然而，到此为止事实上只是各个机器可以互相发送接收数据；为了让机器互相知道发送的数据如何解读，就需要各方共同遵守一个规定，这个规定就称为“协议”（Protocol）。HTTP（HyperText Transfer Protocol，超文本传输协议）就是这样一种协议。不过，我们不需要你去手写如何将你的数据组装为 HTTP 数据或者反之，而是可以直接使用 C++ 的一个[HTTP 库](https://github.com/yhirose/cpp-httplib)来进行：
 
@@ -216,10 +216,10 @@ httplib::Client client{ "http://<IP 地址或者域名>" }; // 与该 IP 地址
 // 在我们的utils.hpp直接定义了 API_ENDPOINT 常量，可以直接client{ API_ENDPOINT }.
 ```
 
-> 特别地，为了减少库依赖，我们这里使用的不是 `https:`；`https:` 会对数据进行加解密，是安全的（这个 `s` 就是 safe 的意思）。除了我们提供的域名，如果一个网页使用 `http://`，那么就要十分小心了，因为所有的信息都会明文传输。因为这个作业使用的 API 不会涉及到敏感信息，所以你无须担忧这个作业中使用 `http://` 的安全性。
+> 特别地，为了减少库依赖，我们这里使用的不是 `https:`；`https:` 会对数据进行加解密，是安全的（这个 `s` 就是 safe 的意思）。除了我们提供的域名，如果一个网页使用 `http://`，那么就要十分小心了，因为所有的信息都会明文传输。因为本作业使用的 API 不会涉及到敏感信息，所以你无须担忧本作业中使用 `http://` 的安全性。
 <!-- 如果你在校内，那么我们的域名在将信息中转到校外之前会帮你把服务转为 `https`，此时信息仅在校园网内部进行明文传输。 -->
 
-HTTP 内规定了客户端对服务器的几种操作，最重要的两种就是 `GET` 和 `POST`，它们没有特别本质的区别，但是约定俗成地，前者在 URL 中携带参数（例如百度搜索东西就是 `baidu.com/s?wd=关键字`，这里 `?` 后面就是参数），并表示一些读取操作；后者在报文内携带参数，从而不会在网址本身中保存状态。
+HTTP 内规定了客户端对服务器的几种操作，最重要的两种就是 `GET` 和 `POST`，它们没有特别本质的区别，但是约定俗成地，`GET` 在 URL 中携带参数时使用（例如百度搜索东西就是 `baidu.com/s?wd=关键字`，这里 `?` 后面就是参数），并表示一些读取操作；而 `POST` 在报文内携带参数，从而不会在网址本身中保存状态。
 
 我们在 `http://docman.zhuof.wang` 提供了 API 查询接口，方便大家查询信息。我们统一使用 `GET` 方法即可，如下：
 
@@ -243,7 +243,7 @@ if (result && result->status == httplib::OK_200) {
 
 > 另一种常见的状态码是 `404`，即未找到相关资源。
 
-事实上返回的数据可能会是 HTML 等格式来供浏览器进行解析，但为了同学们的编码方便，我们将返回的报文格式设置为了 JSON 格式。大家将 `result->body` 视作一个内部为 JSON 的字符串即可，详细文档参见 [Web API 文档](./api)。
+事实上返回的数据可能会是 HTML 等格式来供浏览器进行解析，但为了同学们的编码方便，我们将返回的报文格式设置为了 JSON 格式。大家将 `result->body` 视作一个格式为 JSON 的字符串即可，可以利用 JSON 解析的方式进行操作，详细文档参见 [Web API 文档](./api)。
 
 ### <span id="git">Git</span>
 
@@ -308,6 +308,6 @@ git config --global --unset https.proxy
 
    ![submit 3](assets/submit-3.png)
 
-   点击最后的 Generate，会弹出一个文本框，妥善保存其中的 `github_pat_...` 这串内容。这就是我们用于访问你的仓库的**用户令牌**。
+   点击最后的 Generate，会弹出一个文本框，妥善保存其中的 `github_pat_...` 这串内容，这就是我们用于访问你的仓库的**用户令牌**。
 
 将你的 **GitHub 用户名**、**GitHub 仓库名**和刚刚生成的**用户令牌**提交到教学网 <ins>*课程作业-中作业*</ins> 处。

25spring/middle_homework/faq.md

@@ -10,7 +10,7 @@ cmake -B build
 cmake --build build  
 ```
 
-**Q2**: Windows 下编译不过，报错中有 “找不到 read 符号”等相似字眼
+**Q2**: Windows 下编译不过，报错中有 “找不到 read 符号” 等相似字眼
 
 **A2**: `CMakeLists.txt` 中需要有如下的语句，在 Windows 下链接到系统网络库 `ws2_32`
 ```cmake
@@ -124,4 +124,4 @@ if (!file.is_open()) {
 **A1**: 
 
 - 确保能看到文件后缀名：如果你使用 Windows 系统，你需要确保文件资源管理器设置为显示文件扩展名。打开文件资源管理器，选择“查看”标签页，然后勾选“文件扩展名”选项。如果你使用 Mac，你可以在 Finder 中选择“Finder”菜单，点击“偏好设置”，然后在“高级”标签中勾选“显示所有文件扩展名”。
-- 创建JSON文件：创建一个 txt 文件，写入 JSON 内容，然后将后缀名改成 json。当然如果你可以在保存的时候选择需要创建的后缀名，直接保存为 json 格式即可。
+- 创建 JSON 文件：创建一个 txt 文件，写入 JSON 内容，然后将后缀名改成 json。当然如果你可以在保存的时候选择需要创建的后缀名，直接保存为 json 格式即可。