style: format the repository with prettier

These files were already out of step with the project's Prettier config before this branch of work; running `pnpm format` finally swept them up. No semantic changes. Kept separate from the functional commits so the reformatting does not bury them in diff noise.
2026-09-25 15:37:59 +08:00
1 parent 6800f7251d
commit 861852961f
@@ -10,22 +10,22 @@ author:

 ## 调料投放时机

-| 调料类型         | 放调料时机    | 适用菜品           | 作用                  |
-|--------------|----------|----------------|---------------------|
-| **盐**        | 最后放      | 菜叶子            | 防止菜叶变软出水，保证口感干爽脆嫩   |
-|              | 中间放      | 土豆丝、豆角、蒜苔等     | 更好入味                |
-| **味精、生抽、蚝油** | 偏后放      | 各类需要增鲜提香的菜品    | 增鲜提香，避免高温破坏鲜味和香味    |
-| **料酒**       | 和食材一起放   | 需要去腥的食材        | 焯水时去腥效果更好           |
-|              | 锅温最高的时候放 | 需要炒菜去腥的食材      | 炒菜时高温促进酒气挥发，炝锅去腥效果好 |
-| **醋**        | 提前放      | 酸辣土豆丝、酸辣大白菜    | 使土豆丝变脆更入味           |
-|              | 出锅前锅边醋   | 辣椒炒肉等需要猛火爆炒类菜品 | 大火炝锅增香              |
-| **老抽**       | 炒半熟后放    | 需要上色的菜品        | 达到最佳上色效果            |
+| 调料类型             | 放调料时机       | 适用菜品                     | 作用                                   |
+| -------------------- | ---------------- | ---------------------------- | -------------------------------------- |
+| **盐**               | 最后放           | 菜叶子                       | 防止菜叶变软出水，保证口感干爽脆嫩     |
+|                      | 中间放           | 土豆丝、豆角、蒜苔等         | 更好入味                               |
+| **味精、生抽、蚝油** | 偏后放           | 各类需要增鲜提香的菜品       | 增鲜提香，避免高温破坏鲜味和香味       |
+| **料酒**             | 和食材一起放     | 需要去腥的食材               | 焯水时去腥效果更好                     |
+|                      | 锅温最高的时候放 | 需要炒菜去腥的食材           | 炒菜时高温促进酒气挥发，炝锅去腥效果好 |
+| **醋**               | 提前放           | 酸辣土豆丝、酸辣大白菜       | 使土豆丝变脆更入味                     |
+|                      | 出锅前锅边醋     | 辣椒炒肉等需要猛火爆炒类菜品 | 大火炝锅增香                           |
+| **老抽**             | 炒半熟后放       | 需要上色的菜品               | 达到最佳上色效果                       |

 ## 快速参考

-| 调料              | 投放时机           | 作用                     | 示例                     |
-|-----------------|----------------|------------------------|------------------------|
-| **盐**           | 出锅前 10 - 15 秒放 | 避免提前放盐导致菜叶出水、变软，保持脆嫩口感 | 炒生菜、菠菜时，关火前撒盐翻炒均匀      |
-| **蒜末 / 姜末**     | 热油后先放          | 爆香提味，激发香味              | 油热后下蒜末炝锅，再放青菜翻炒        |
-| **生抽 / 蚝油**（可选） | 盐之后放           | 增鲜提味，少量即可，避免盖过蔬菜原味     | 炒上海青时，加盐后滴 1 - 2 滴生抽翻炒 |
-| **食用油**         | 热锅热油           | 油热后快速炒，锁住水分            | 大火快炒时，油稍多一点，油温要高       |
+| 调料                    | 投放时机            | 作用                                         | 示例                                  |
+| ----------------------- | ------------------- | -------------------------------------------- | ------------------------------------- |
+| **盐**                  | 出锅前 10 - 15 秒放 | 避免提前放盐导致菜叶出水、变软，保持脆嫩口感 | 炒生菜、菠菜时，关火前撒盐翻炒均匀    |
+| **蒜末 / 姜末**         | 热油后先放          | 爆香提味，激发香味                           | 油热后下蒜末炝锅，再放青菜翻炒        |
+| **生抽 / 蚝油**（可选） | 盐之后放            | 增鲜提味，少量即可，避免盖过蔬菜原味         | 炒上海青时，加盐后滴 1 - 2 滴生抽翻炒 |
+| **食用油**              | 热锅热油            | 油热后快速炒，锁住水分                       | 大火快炒时，油稍多一点，油温要高      |
@@ -17,13 +17,13 @@ author:
 ```javascript
 function processResponse(response) {
  if (response.status === 200 && response.data) {
-    return { success: true, data: response.data };
+    return { success: true, data: response.data }
  } else if (response.status === 404) {
-    return { success: false, error: 'Not found' };
+    return { success: false, error: "Not found" }
  } else if (response.status >= 500) {
-    return { success: false, error: 'Server error' };
+    return { success: false, error: "Server error" }
  } else {
-    return { success: false, error: 'Unknown error' };
+    return { success: false, error: "Unknown error" }
  }
 }
 ```
@@ -17,17 +17,17 @@ author:

 ## 场景速查表

-| 场景       | ❌ 别用（听起来……）                                                  | ✅ 改用（听起来……）                                              | 为什么有效                                         |
-|----------|--------------------------------------------------------------|----------------------------------------------------------|-----------------------------------------------|
-| 回复晚了     | **Sorry for the delay**<br/>（抱歉回复晚了）                         | **Thanks for your patience**<br/>（感谢你的耐心等待）              | 前者在道歉，后者在感谢——从「我做错了」转变为「你太好了」，既表达了歉意又让对方感到被尊重 |
-| 约时间      | **What works best for you?**<br/>（你什么时候方便？）                  | **Could you do …?**<br/>（你可以在某某时间吗？）                     | 前者把决定权完全推给对方，后者主动给出选项，减少来回沟通的成本               |
-| 帮助了别人之后  | **No problem / No worries**<br/>（没问题 / 别担心）                  | **Always happy to help**<br/>（乐于效劳）                      | 前者暗示这件事"本来可能是个问题"，后者传递出你乐在其中、下次还愿意帮           |
-| 提出建议     | **I think maybe we should …**<br/>（我觉得也许我们应该……）              | **It'd be best if we …**<br/>（最好是……）                     | 前者透着犹豫和不自信，后者直接给出判断——像有经验的人在做决策               |
-| 文字沟通费劲   | **_花 30 分钟反复修改一封邮件_**                                        | **It'd be easier to discuss in person**<br/>（当面/电话聊会更轻松） | 意识到沟通渠道本身就是问题，果断切换方式反而是效率最高的选择                |
-| 确认对方是否理解 | **Hopefully that makes sense?**<br/>（希望我说清楚了？）               | **Let me know if you have questions**<br/>（有问题随时问我）      | 前者在怀疑自己的表达能力，后者把责任合理地分担给对方，姿态更稳               |
-| 催进度      | **Just wanted to check in**<br/>（只是想确认一下）                    | **When can I expect an update?**<br/>（我什么时候可以收到更新？）      | 前者显得小心翼翼不敢打扰，后者直接问时间节点——清楚、礼貌、专业              |
-| 犯了小错     | **Ahh sorry my bad totally missed that**<br/>（啊啊抱歉我的错，完全漏掉了） | **Thanks for letting me know**<br/>（感谢提醒）                | 前者过度道歉反而让对方尴尬，后者承认了问题但把焦点放在了"解决"上             |
-| 需要早退     | **Could I possibly leave early?**<br/>（我能提前走吗？）              | **I will need to leave at …**<br/>（我需要在某某时间离开）           | 前者在请求批准，后者在陈述安排——你是专业人士，不需要为合理需求道歉            |
+| 场景             | ❌ 别用（听起来……）                                                         | ✅ 改用（听起来……）                                                 | 为什么有效                                                                               |
+| ---------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| 回复晚了         | **Sorry for the delay**<br/>（抱歉回复晚了）                                | **Thanks for your patience**<br/>（感谢你的耐心等待）               | 前者在道歉，后者在感谢——从「我做错了」转变为「你太好了」，既表达了歉意又让对方感到被尊重 |
+| 约时间           | **What works best for you?**<br/>（你什么时候方便？）                       | **Could you do …?**<br/>（你可以在某某时间吗？）                    | 前者把决定权完全推给对方，后者主动给出选项，减少来回沟通的成本                           |
+| 帮助了别人之后   | **No problem / No worries**<br/>（没问题 / 别担心）                         | **Always happy to help**<br/>（乐于效劳）                           | 前者暗示这件事"本来可能是个问题"，后者传递出你乐在其中、下次还愿意帮                     |
+| 提出建议         | **I think maybe we should …**<br/>（我觉得也许我们应该……）                  | **It'd be best if we …**<br/>（最好是……）                           | 前者透着犹豫和不自信，后者直接给出判断——像有经验的人在做决策                             |
+| 文字沟通费劲     | **_花 30 分钟反复修改一封邮件_**                                            | **It'd be easier to discuss in person**<br/>（当面/电话聊会更轻松） | 意识到沟通渠道本身就是问题，果断切换方式反而是效率最高的选择                             |
+| 确认对方是否理解 | **Hopefully that makes sense?**<br/>（希望我说清楚了？）                    | **Let me know if you have questions**<br/>（有问题随时问我）        | 前者在怀疑自己的表达能力，后者把责任合理地分担给对方，姿态更稳                           |
+| 催进度           | **Just wanted to check in**<br/>（只是想确认一下）                          | **When can I expect an update?**<br/>（我什么时候可以收到更新？）   | 前者显得小心翼翼不敢打扰，后者直接问时间节点——清楚、礼貌、专业                           |
+| 犯了小错         | **Ahh sorry my bad totally missed that**<br/>（啊啊抱歉我的错，完全漏掉了） | **Thanks for letting me know**<br/>（感谢提醒）                     | 前者过度道歉反而让对方尴尬，后者承认了问题但把焦点放在了"解决"上                         |
+| 需要早退         | **Could I possibly leave early?**<br/>（我能提前走吗？）                    | **I will need to leave at …**<br/>（我需要在某某时间离开）          | 前者在请求批准，后者在陈述安排——你是专业人士，不需要为合理需求道歉                       |

 ## 核心原则

@@ -21,6 +21,6 @@ tags:

 于是对于 PowerNap 这个功能来说，我们只能从命令行下手，首先使用 **`pmset -g`** 命令查看当前状态，找到 **`powernap`** 的值，如果不是 0 ，说明是启用的状态，使用命令 **`sudo pmset -a powernap 0`** 关掉它。

-同时，还有另外一个 **`tcpkeepalive`** ，这个默认应该也不是 0 ，也要关掉，它决定了你的 rmbp 在休眠时是否要保持 tcp 连接。 **`sudo pmset -a tcpkeepalive 0`** ，执行这条命令会导致终端提示：***Warning: This option disables TCP Keep Alive mechanism when system is sleeping. This will result in some critical features like 'Find My Mac' not to function properly.***
+同时，还有另外一个 **`tcpkeepalive`** ，这个默认应该也不是 0 ，也要关掉，它决定了你的 rmbp 在休眠时是否要保持 tcp 连接。 **`sudo pmset -a tcpkeepalive 0`** ，执行这条命令会导致终端提示：**_Warning: This option disables TCP Keep Alive mechanism when system is sleeping. This will result in some critical features like 'Find My Mac' not to function properly._**

 大概是说关了的话某些功能会受到限制，其实就是系统功能不能休眠时联网了，我相信真有人偷了你 Mac，它也连不上网的。
@@ -11,20 +11,20 @@ author:
 ---

 | 中文字号 | 英文字号（磅）/pt | 毫米/mm | 像素/px |
-|------|------------|-------|-------|
-| 初号   | 42         | 14.82 | 56    |
-| 小初   | 36         | 12.7  | 48    |
-| 一号   | 26         | 9.17  | 34.7  |
-| 小一   | 24         | 8.47  | 32    |
-| 二号   | 22         | 7.76  | 29.3  |
-| 小二   | 18         | 6.35  | 24    |
-| 三号   | 16         | 5.64  | 21.3  |
-| 小三   | 15         | 5.29  | 20    |
-| 四号   | 14         | 4.94  | 18.7  |
-| 小四   | 12         | 4.23  | 16    |
-| 五号   | 10.5       | 3.7   | 14    |
-| 小五   | 9          | 3.18  | 12    |
-| 六号   | 7.5        | 2.56  | 10    |
-| 小六   | 6.5        | 2.29  | 8.7   |
-| 七号   | 5.5        | 1.94  | 7.3   |
-| 八号   | 5          | 1.76  | 6.7   |
+| -------- | ----------------- | ------- | ------- |
+| 初号     | 42                | 14.82   | 56      |
+| 小初     | 36                | 12.7    | 48      |
+| 一号     | 26                | 9.17    | 34.7    |
+| 小一     | 24                | 8.47    | 32      |
+| 二号     | 22                | 7.76    | 29.3    |
+| 小二     | 18                | 6.35    | 24      |
+| 三号     | 16                | 5.64    | 21.3    |
+| 小三     | 15                | 5.29    | 20      |
+| 四号     | 14                | 4.94    | 18.7    |
+| 小四     | 12                | 4.23    | 16      |
+| 五号     | 10.5              | 3.7     | 14      |
+| 小五     | 9                 | 3.18    | 12      |
+| 六号     | 7.5               | 2.56    | 10      |
+| 小六     | 6.5               | 2.29    | 8.7     |
+| 七号     | 5.5               | 1.94    | 7.3     |
+| 八号     | 5                 | 1.76    | 6.7     |
@@ -68,7 +68,7 @@ createRoot(document.getElementById("root")!).render(
 <StyleProvider>
  <ConfigProvider>
    <App>
-      <RouterProvider/>
+      <RouterProvider />
    </App>
  </ConfigProvider>
 </StyleProvider>
@@ -14,7 +14,7 @@ GitLab 在代码中通过 `SWITCHER_MINIMUM_TRANSLATION_LEVEL` 变量将翻译

 可以前往 `/path/to/gitlab/embedded/service/gitlab-rails/app/helpers/preferred_language_switcher_helper.rb` 中将代码修改如下：

-```diff title="/path/to/gitlab/embedded/service/gitlab-rails/app/helpers/preferred_language_switcher_helper.rb" 
+```diff title="/path/to/gitlab/embedded/service/gitlab-rails/app/helpers/preferred_language_switcher_helper.rb"
 - SWITCHER_MINIMUM_TRANSLATION_LEVEL = 90
 + SWITCHER_MINIMUM_TRANSLATION_LEVEL = 80
 ```
@@ -99,11 +99,11 @@ N+1 问题是指 JPA 先执行 1 条查询获取父实体，再为每条父实

 **修复方案：**

-| 方式                        | 适用场景                 |
-|---------------------------|----------------------|
-| `@EntityGraph`            | 声明式，适合为特定实体定制抓取计划    |
-| `@Query` 中使用 `JOIN FETCH` | 按查询精细控制              |
-| `@BatchSize`              | 将 N+1 降低为 N/k+1，批量加载 |
+| 方式                         | 适用场景                           |
+| ---------------------------- | ---------------------------------- |
+| `@EntityGraph`               | 声明式，适合为特定实体定制抓取计划 |
+| `@Query` 中使用 `JOIN FETCH` | 按查询精细控制                     |
+| `@BatchSize`                 | 将 N+1 降低为 N/k+1，批量加载      |

 ```java
 // 方式一：EntityGraph
@@ -139,6 +139,7 @@ post.setAuthor(userRepository.getReferenceById(userId));
   @Query("SELECT new com.example.UserDto(u.id, u.name) FROM User u WHERE u.id = :id")
   UserDto findUserDtoById(@Param("id") long id);
   ```
+
 3. **在 Service 方法上使用 `@Transactional(readOnly = true)`** — 使 Session 在整个方法作用域内保持打开。

 ### 什么时候该用 `@Transactional(readOnly = true)`？
@@ -270,7 +271,7 @@ public class Product {

 ### 如何选择

-| 场景                                   | 注解               |
-|----------------------------------------|--------------------|
-| 平铺字段固定的嵌套对象（如地址、配置）   | `@JsonUnwrapped`   |
-| 平铺 key 不固定的动态键值对             | `@JsonAnyGetter`   |
+| 场景                                   | 注解             |
+| -------------------------------------- | ---------------- |
+| 平铺字段固定的嵌套对象（如地址、配置） | `@JsonUnwrapped` |
+| 平铺 key 不固定的动态键值对            | `@JsonAnyGetter` |
@@ -119,7 +119,7 @@ author:
  - 数据操作约定:
    - 对于简单数据库操作，使用 JPA。
    - 对于复杂数据库操作，使用 MyBatis。
-    - 当进行分页查询时，页码应从 0 开始（*兼容 Spring Data JPA*）。
+    - 当进行分页查询时，页码应从 0 开始（_兼容 Spring Data JPA_）。
  - **数据操作方法命名约定**:
    - 对于**查询数据列表**：方法**必须**以 `selectListBy` 开头，紧随其后是筛选条件（例如，`selectListByUserId`、`selectListByDepartmentIdAndStatus`）。这些方法也必须包含一个 `PageRequest` 参数用于分页。
    - 对于查询**单个数据记录**：方法**必须**以 `selectOne` 开头（例如，`selectOneById`、`selectOneByUsername`）。
@@ -5,8 +5,8 @@ tags:
  - json
  - database
 author:
-   name: Zihlu Wang
-   email: real@zihluwang.me
+  name: Zihlu Wang
+  email: real@zihluwang.me
 ---

 MySQL (自 5.7 版本开始) **不直接支持名为 `jsonb` 的数据类型**。`jsonb` 是 PostgreSQL 数据库特有的数据类型，它以二进制格式存储 JSON 数据，并对其进行预解析，以便在查询时更快地访问和操作。
@@ -25,11 +25,11 @@ https://gravatar.com/avatar/<hash>
 ### Node.js

 ```js
-import { createHash } from "node:crypto";
+import { createHash } from "node:crypto"

-const email = "user@example.com".trim().toLowerCase();
-const hash = createHash("sha256").update(email).digest("hex");
-const url = `https://gravatar.com/avatar/${hash}`;
+const email = "user@example.com".trim().toLowerCase()
+const hash = createHash("sha256").update(email).digest("hex")
+const url = `https://gravatar.com/avatar/${hash}`
 ```

 ### Python
@@ -52,11 +52,11 @@ echo -n "user@example.com" | tr '[:upper:]' '[:lower:]' | sha256sum | cut -d ' '

 `/avatar/` 端点接受以下查询参数来定制结果：

-| 参数  | 描述                     | 示例             |
-|-----|------------------------|----------------|
-| `s` | 图片尺寸（像素，默认 80）         | `?s=200`       |
-| `d` | 未找到 Gravatar 时的默认图片    | `?d=identicon` |
-| `r` | 内容分级（`g`、`pg`、`r`、`x`） | `?r=g`         |
+| 参数 | 描述                            | 示例           |
+| ---- | ------------------------------- | -------------- |
+| `s`  | 图片尺寸（像素，默认 80）       | `?s=200`       |
+| `d`  | 未找到 Gravatar 时的默认图片    | `?d=identicon` |
+| `r`  | 内容分级（`g`、`pg`、`r`、`x`） | `?r=g`         |

 ### 默认图片选项（`d`）

@@ -76,8 +76,7 @@ echo -n "user@example.com" | tr '[:upper:]' '[:lower:]' | sha256sum | cut -d ' '
  src="https://gravatar.com/avatar/a3b4c5d6e7f8?s=160&d=robohash&r=g"
  alt="用户头像"
  width="160"
-  height="160"
-/>
+  height="160" />
 ```

 始终传入 `d` 参数以避免未设置 Gravatar 的用户出现裂图。`identicon` 和 `robohash` 是常用的选择，因为它们能为每个哈希值生成唯一且易于辨识的图片。