前置条件：你刚刚执行完 子模块更新 操作，且 TortoiseGit 提示更新成功。
目的：在正式提交（Commit）之前，快速审查主题作者（Aditya）到底更新了哪些功能或修复了哪些 Bug，防止升级导致博客样式崩坏。

🏆 招式一：提交窗口“隔空透视” (最推荐)

适用场景：日常快速升级，只想知道“大概更新了什么内容”。无需离开当前界面，效率最高。

操作步骤：

  1. 发起提交：在博客根目录，右键 -> Git 提交 (Commit)。
  2. 定位变更：在下方的“变更列表”中，找到 themes/PaperMod 这一行（状态为 Modified）。
  3. 透视日志：
    • 右键点击 该行文件。
    • 选择 显示日志 (Show Log)。

🔮 你会看到什么？

小乌龟会弹出一个独立的日志窗口，只显示从“你原来的版本”到“现在的最新版”之间的所有 Commit 记录。

  • ✅ feat: add social icons (新增了功能)
  • ✅ fix: mobile menu bug (修复了 Bug)
  • ✅ chore: update hugo version (杂项维护)

🔍 招式二：深入文件夹“代码比对” (硬核)

适用场景：你发现招式一里有 fix: css 这种模糊的描述，你想知道具体改了哪行代码（怕覆盖掉你的 Custom CSS）。

操作步骤：

  1. 进入腹地：双击进入 themes/PaperMod 文件夹。
  2. 查看历史：右键空白处 -> TortoiseGit -> 显示日志 (Show Log)。
  3. 版本对比：
    • 在日志列表中，找到最上面的 粗体行（当前最新版）。
    • 按住 Ctrl 键，向下找到 上一条粗体行 或者你记忆中上次更新日期的那一行（通常是 HEAD 指针的上一个位置）。
    • 选中这两行，右键 -> 比较版本 (Compare revisions)。

🔮 你会看到什么？

一个详细的文件列表。

  • 双击 列表中的 assets/css/core.css，你会看到左右分栏的代码对比（Diff）。
  • 左边是旧代码，右边是新代码，变动一目了然。

🌐 招式三：GitHub “上帝视角” (最直观)

适用场景：版本跨度很大，或者想看渲染好的 Markdown 说明文档，浏览器阅读体验最好。

操作步骤：

  1. 获取哈希 (Hash)：
    • 在招式一的“提交窗口”里，点击 themes/PaperMod，下方的文本框会显示：
    • Submodule pointer changed from a1b2c3d to e5f6g7h
    • 复制这两个 7 位的代码：Old_Hash 和 New_Hash。
  2. 拼接链接：
    • 在浏览器地址栏输入：
    • https://github.com/adityatelange/hugo-PaperMod/compare/旧Hash...新Hash
    • (注意中间是三个点 ...)

🔮 你会看到什么？

GitHub 官方生成的对比页面。不仅代码高亮漂亮，而且如果有图片变动也能直接预览。

💡 PM 的风控建议 (Risk Control)

在点击“提交”按钮前，重点关注以下关键词：

  1. assets/css/...：如果 CSS 变动大，升级后务必强制刷新浏览器，检查你的 custom.css 是否被意外覆盖或失效（比如类名变了）。
  2. layouts/partials/...：如果你曾经 覆盖(Override) 过某个模板（比如 post_meta.html），要检查官方是否更新了这个文件。如果官方更新了，你可能需要手动把新特性合并到你的自定义文件中。
  3. config.yml / hugo.toml：如果示例配置文件变了，说明可能有了新的配置开关，可以去抄作业。

总结：先看一眼，再 Commit。这就叫“心中有数，升级不慌”。 🛡️