Replace two-level lists with bold section headers in changelog files

Agent-Logs-Url: https://github.com/HMCL-dev/HMCL-docs/sessions/85dd9646-e48a-449e-90ed-93535a3be5dd

Co-authored-by: Glavo <20694662+Glavo@users.noreply.github.com>

.drone.yml

@@ -7,22 +7,20 @@ clone:
 
 steps:
 - name: build
-  image: jekyll/jekyll:4.2.2
+  image: ruby:3.4
   environment:
     JEKYLL_ENV: production
+    BUNDLE_PATH: vendor/bundle
   commands:
-    - touch Gemfile.lock
-    - chmod a+w Gemfile.lock
-    - chown -R jekyll:jekyll /drone
-    - gem sources --add https://mirrors.cloud.tencent.com/rubygems/ --remove https://rubygems.org/
     - bundle config mirror.https://rubygems.org https://mirrors.cloud.tencent.com/rubygems
-    - bundle install
+    - bundle install --verbose
     - bundle exec jekyll build --trace --verbose
-    - bash scripts/copy_index_json.sh
   volumes:
   - name: dist
     path: /drone/src/_site
-  - name: cache
+  - name: vendor
+    path: /drone/src/vendor
+  - name: jekyll-cache
     path: /drone/src/.jekyll-cache
   when:
     branch: [main]
@@ -31,6 +29,9 @@ volumes:
 - name: dist
   host:
     path: /home/ubuntu/docs.hmcl.net/www
-- name: cache
+- name: vendor
   host:
-    path: /home/ubuntu/docs.hmcl.net/cache
+    path: /home/ubuntu/docs.hmcl.net/cache/vendor
+- name: jekyll-cache
+  host:
+    path: /home/ubuntu/docs.hmcl.net/cache/jekyll-cache

.github/workflows/pr-preview.yml

@@ -0,0 +1,414 @@
+name: PR Preview
+on:
+  schedule:
+    - cron: 0 0 */6 * *
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [labeled, synchronize, closed]
+concurrency:
+  group: pr-preview
+  cancel-in-progress: false
+env:
+  JEKYLL_ENV: production
+  ENABLE_WEBP_AUTO_CONVERSION: "true"
+  GITHUB_PR_NUMBER: ${{ github.event_name == 'issue_comment' && github.event.issue.number || github.event.pull_request.number }}
+jobs:
+  cache-refresh:
+    if: ${{ !github.event.repository.fork && github.event_name == 'schedule' && github.event.schedule == '0 0 */6 * *' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cache Refresh
+        uses: actions/cache/restore@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+          restore-keys: pages-
+  preview-remove:
+    if:
+      ${{
+        !github.event.repository.fork && (
+          ( github.event_name == 'pull_request_target' && (
+              github.event.action == 'closed' || (
+                github.event.action == 'labeled' &&
+                github.event.label.name == 'preview/remove'
+              )
+            )
+          ) || (
+            github.event_name == 'issue_comment' &&
+            github.event.issue.pull_request &&
+            github.event.comment.body == '/preview remove' &&
+            contains('OWNER,MEMBER', github.event.comment.author_association)
+          )
+        )
+      }}
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: write
+    steps:
+      - id: restore-pages
+        name: Restore Pages
+        uses: actions/cache/restore@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+          restore-keys: pages-
+      - name: Prepare Pages
+        run: |
+          mkdir -p /home/runner/gh-pages/data/{files,refs}
+          rm -rf /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+          grep -rlw 'PR${{ env.GITHUB_PR_NUMBER }}' /home/runner/gh-pages/data/refs | xargs -r sed -i '/\<PR${{ env.GITHUB_PR_NUMBER }}\>/d'
+          for ref in /home/runner/gh-pages/data/refs/*; do
+            if [ ! -s "$ref" ]; then
+              base=$(basename "$ref")
+              rm -f "/home/runner/gh-pages/data/files/$base"
+              rm -f "$ref"
+            fi
+          done
+          echo "[$(date)] Remove Preview PR${{ env.GITHUB_PR_NUMBER }}" > /home/runner/gh-pages/index.html
+      - name: Save Pages
+        uses: actions/cache/save@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+      - if: ${{ github.event_name == 'issue_comment' }}
+        id: comment-message
+        name: Comment Message (issue_comment)
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: context.payload.comment.id,
+              issue_number: context.issue.number,
+              body: "[Preview] Preview has been removed."
+            });
+      - if: ${{ (github.event_name == 'pull_request_target' && github.event.action != 'closed') || steps.comment-message.outcome == 'failure' }}
+        name: Comment Message
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: "[Preview] Preview has been removed."
+            });
+      - if: ${{ steps.restore-pages.outputs.cache-matched-key }}
+        name: Remove History Cache
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteActionsCacheByKey({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              key: "${{ steps.restore-pages.outputs.cache-matched-key }}"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/remove') || contains(github.event.issue.labels.*.name, 'preview/remove') }}
+        name: Remove Label (preview/remove)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/remove"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/watch') || contains(github.event.issue.labels.*.name, 'preview/watch') }}
+        name: Remove Label (preview/watch)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/watch"
+            });
+  preview-create-init:
+    if:
+      ${{
+        !github.event.repository.fork && (
+          ( github.event_name == 'pull_request_target' && (
+              ( github.event.action == 'labeled' && contains(fromJSON('["preview/create", "preview/watch"]'), github.event.label.name) ) ||
+              ( github.event.action == 'synchronize' && contains(github.event.pull_request.labels.*.name, 'preview/watch') )
+            )
+          ) || (
+            github.event_name == 'issue_comment' &&
+            github.event.issue.pull_request &&
+            contains(fromJSON('["/preview create", "/preview watch"]'), github.event.comment.body) &&
+            contains('OWNER,MEMBER', github.event.comment.author_association)
+          )
+        )
+      }}
+    runs-on: ubuntu-latest
+    permissions:
+      checks: write
+      pull-requests: write
+    outputs:
+      sha: ${{ steps.init.outputs.sha }}
+      domain: ${{ steps.init.outputs.domain }}
+      pathname: ${{ steps.init.outputs.pathname }}
+      repository: ${{ steps.init.outputs.repository }}
+      check-id: ${{ steps.init.outputs.check-id }}
+    steps:
+      - id: init
+        name: Init
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const { owner, repo } = context.repo;
+            const pages = (await octokit.rest.repos.getPages({ owner, repo })).data;
+            const domain = pages.cname || `${owner.toLowerCase()}.github.io`;
+            core.setOutput('domain', domain);
+            core.setOutput('pathname', (pages.cname || repo.toLowerCase() === domain) ? '' : `/${repo}`);
+            const pr = context.payload.pull_request || (await github.rest.pulls.get({
+              owner, repo,
+              pull_number: context.issue.number
+            })).data;
+            core.setOutput('sha', pr.head.sha);
+            core.setOutput('repository', pr.head.repo.full_name);
+            const { data: check } = await github.rest.checks.create({
+              owner, repo,
+              name: "Create preview",
+              head_sha: pr.head.sha,
+              status: "in_progress",
+              started_at: new Date().toISOString(),
+              details_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${{ github.run_id }}`,
+              output: {
+                title: "Create preview by command",
+                summary: "Preview is being created..."
+              }
+            });
+            core.setOutput('check-id', check.id);
+      - if: ${{ github.event_name == 'issue_comment' && github.event.comment.body == '/preview watch' }}
+        name: Add Label (preview/watch)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ["preview/watch"]
+            });
+  preview-create-build:
+    needs: preview-create-init
+    runs-on: ubuntu-latest
+    env:
+      PREVIEW_WATCH:
+        ${{
+          contains(github.event.pull_request.labels.*.name, 'preview/watch') ||
+          contains(github.event.issue.labels.*.name, 'preview/watch') || (
+            github.event_name == 'issue_comment' &&
+            github.event.comment.body == '/preview watch'
+          )
+        }}
+    outputs:
+      artifact-id: ${{ steps.upload-site.outputs.artifact-id }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - name: Merge PR
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git fetch https://github.com/${{ needs.preview-create-init.outputs.repository }} ${{ needs.preview-create-init.outputs.sha }}
+          git merge --squash ${{ needs.preview-create-init.outputs.sha }} --no-edit
+          git commit -m "Merge #${{ env.GITHUB_PR_NUMBER }} for preview build"
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: ${{ env.PREVIEW_WATCH }}
+          cache-version: PR-${{ env.GITHUB_PR_NUMBER }}
+      - name: Jekyll Build
+        run: |
+          echo "url: https://${{ needs.preview-create-init.outputs.domain }}" > _action.yml
+          echo "baseurl: ${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
+          echo "source: ${{ github.workspace }}" >> _action.yml
+          echo "destination: /home/runner/site" >> _action.yml
+          echo "preview:" >> _action.yml
+          echo "  pr-number: ${{ env.GITHUB_PR_NUMBER }}" >> _action.yml
+          ${{ env.PREVIEW_WATCH }} || bundle install --jobs 4
+          bundle exec jekyll build --trace --config _config.yml,_action.yml
+      - id: upload-site
+        name: Upload Site
+        uses: actions/upload-artifact@v4
+        with:
+          name: site
+          path: /home/runner/site
+  preview-create-deploy:
+    needs: [preview-create-init, preview-create-build]
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+    permissions:
+      actions: write
+      pages: write
+      id-token: write
+      contents: write
+    steps:
+      - id: restore-pages
+        name: Restore Pages
+        uses: actions/cache/restore@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+          restore-keys: pages-
+      - name: Merge Site Before
+        run: |
+          mkdir -p /home/runner/gh-pages/data/{files,refs}
+          rm -rf /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+          grep -rlw 'PR${{ env.GITHUB_PR_NUMBER }}' /home/runner/gh-pages/data/refs | xargs -r sed -i '/\<PR${{ env.GITHUB_PR_NUMBER }}\>/d'
+      - name: Merge Site
+        uses: actions/download-artifact@v5
+        with:
+          name: site
+          path: /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }}
+      - name: Merge Site After
+        run: |
+          find /home/runner/gh-pages/PR${{ env.GITHUB_PR_NUMBER }} -type f | while read file; do
+            hash=$(sha256sum "$file" | cut -d' ' -f1)
+            size=$(stat -c%s "$file")
+            key="${hash}-${size}"
+            target="/home/runner/gh-pages/data/files/$key"
+            if [ ! -f "$target" ]; then
+              mv "$file" "$target"
+            else
+              rm -f "$file"
+            fi
+            ln -s "$(realpath --relative-to="$(dirname "$file")" "$target")" "$file"
+            echo "PR${{ env.GITHUB_PR_NUMBER }}" >> "/home/runner/gh-pages/data/refs/$key"
+          done
+          for ref in /home/runner/gh-pages/data/refs/*; do
+            if [ ! -s "$ref" ]; then
+              base=$(basename "$ref")
+              rm -f "/home/runner/gh-pages/data/files/$base"
+              rm -f "$ref"
+            fi
+          done
+          echo "[$(date)] Preview PR${{ env.GITHUB_PR_NUMBER }}" > /home/runner/gh-pages/index.html
+      - id: upload-pages
+        name: Upload Pages
+        uses: actions/upload-pages-artifact@v4
+        with:
+          name: github-pages
+          path: /home/runner/gh-pages
+      - name: Deploy Pages
+        uses: actions/deploy-pages@v4
+        with:
+          artifact_name: github-pages
+      - name: Save Pages
+        uses: actions/cache/save@v4
+        with:
+          key: pages-${{ github.run_id }}
+          path: /home/runner/gh-pages
+      - if: ${{ steps.restore-pages.outputs.cache-matched-key }}
+        name: Remove History Cache
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteActionsCacheByKey({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              key: "${{ steps.restore-pages.outputs.cache-matched-key }}"
+            });
+      - if: ${{ steps.upload-pages.outputs.artifact_id }}
+        name: Remove Pages Artifact
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteArtifact({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              artifact_id: "${{ steps.upload-pages.outputs.artifact_id }}",
+            });
+      - if: ${{ needs.preview-create-build.outputs.artifact-id }}
+        name: Remove Temp Artifact
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.actions.deleteArtifact({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              artifact_id: "${{ needs.preview-create-build.outputs.artifact-id }}"
+            });
+  preview-create-finally:
+    if: ${{ always() && needs.preview-create-init.result == 'success' }}
+    needs: [preview-create-init, preview-create-deploy]
+    runs-on: ubuntu-latest
+    permissions:
+      checks: write
+      pull-requests: write
+    steps:
+      - if: ${{ github.event_name == 'issue_comment' }}
+        id: comment-message
+        name: Comment Message (issue_comment)
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: context.payload.comment.id,
+              issue_number: context.issue.number,
+              body: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+            });
+      - if: ${{ steps.comment-message.outcome == 'failure' }}
+        name: Comment Message
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+            });
+      - if: ${{ contains(github.event.pull_request.labels.*.name, 'preview/create') || contains(github.event.issue.labels.*.name, 'preview/create') }}
+        name: Remove Label (preview/create)
+        continue-on-error: true
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.issues.removeLabel({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              name: "preview/create"
+            });
+      - name: Check Over
+        env:
+          PREVIEW_URL: https://${{ needs.preview-create-init.outputs.domain }}${{ needs.preview-create-init.outputs.pathname }}/PR${{ env.GITHUB_PR_NUMBER }}
+        uses: actions/github-script@v8
+        with:
+          script: |
+            github.rest.checks.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              check_run_id: ${{ needs.preview-create-init.outputs.check-id }},
+              status: "completed",
+              conclusion: "${{ needs.preview-create-deploy.result == 'success' && 'success' || 'failure' }}",
+              completed_at: new Date().toISOString(),
+              details_url: `https://github.com/${context.repo.owner}/${context.repo.repo}/runs/${{ github.run_id }}`,
+              output: {
+                title: "Create preview ${{ needs.preview-create-deploy.result == 'success' && 'success' || 'failure' }}",
+                summary: "${{ needs.preview-create-deploy.result == 'success' && format('[Preview] {0}', env.PREVIEW_URL) || '[Preview] Failed, see logs for more information.' }}"
+              }
+            });

Gemfile

@@ -1,4 +1,4 @@
-source "https://gems.ruby-china.com"
+source "https://rubygems.org"
 # Hello! This is where you manage which Jekyll version is used to run.
 # When you want to use a different version, change it below, save the
 # file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
@@ -7,32 +7,29 @@ source "https://gems.ruby-china.com"
 #
 # This will help ensure the proper Jekyll version is running.
 # Happy Jekylling!
-gem "jekyll", "~> 4.2.2"
+gem "jekyll", "4.4.1"
-# This is the default theme for new Jekyll sites. You may change this to anything you like.
+gem "minimal-mistakes-jekyll", "4.28.0"
-gem "minimal-mistakes-jekyll"
-gem "logger", "1.4.2"
 
 group :jekyll_plugins do
-  gem "jekyll-paginate"
+  gem "jekyll-paginate", "1.1.0"
-  gem "jekyll-sitemap"
+  gem "jekyll-sitemap", "1.4.0"
-  gem "jekyll-gist"
+  gem "jekyll-gist", "1.5.0"
-  gem "jekyll-feed"
+  gem "jekyll-feed", "0.17.0"
-  gem "jemoji"
+  gem "jekyll-include-cache", "0.2.1"
-  gem "jekyll-include-cache"
+  gem "jekyll-redirect-from", "0.16.0"
-  gem "jekyll-algolia"
-  gem "jekyll-remote-theme"
-  gem "jekyll-archives"
-  gem "jekyll-seo-tag"
 end
 
 # Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
 # and associated library.
-platforms :mingw, :x64_mingw, :mswin, :jruby do
+platforms :windows, :jruby do
-  gem "tzinfo"
+  gem "tzinfo", "2.0.6"
-  gem "tzinfo-data"
+  gem "tzinfo-data", "1.2025.2"
 end
 
 # Performance-booster for watching directories on Windows
-gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
+gem "wdm", "0.2.0", :platforms => [:windows]
 
-gem "webrick", "~> 1.7"
+gem "http_parser.rb", "0.8.0", :platforms => [:jruby]
+
+# plugin dependencies
+gem "webp-ffi", "0.4.0" if ENV["ENABLE_WEBP_AUTO_CONVERSION"] == "true" || ENV["DRONE"] == "true"

README.md

@@ -1,4 +1,7 @@
 # HMCL-docs
+
+[![Build Status](https://drone.hmcl.net/api/badges/huanghongxun/HMCL-docs/status.svg)](https://drone.hmcl.net/huanghongxun/HMCL-docs)
+
 Hello Minecraft! Launcher 帮助文档仓库
 
 您可以通过对本仓库提交 Pull Request 的方式来为 HMCL 帮助文档贡献自己的力量！
@@ -17,11 +20,12 @@ Hello Minecraft! Launcher 帮助文档仓库
 请注意，你在使用 Typora 时，请在 文件->偏好设置->图像 中，将 `插入图片时...` 选项修改为复制到指定路径为 `/assets/img/docs/${filename}` 目录
 
 ## 贡献
+
 本仓库组织方式为一篇文章放在一个目录中。如果你要提交 PR，请不要将 md 文件直接放在根目录下。
 
 每篇文章结构如下：
 ```
-_<category>/<article>.md
+_<collection>/<article>.md
 
 assets
  * img
@@ -32,9 +36,9 @@ assets
        * ...
 ```
 
-其中，`<category>` 表示分类，如 `multiplayer` 表示多人游戏、`modpack` 表示整合包，`<article>` 表示你的文章的英文名（尖括号表示占位符，请替换为文章名称，不要直接提交 '`<article>`'），请仅使用英文字母、数字、中划线、下划线字符，不要使用空格、中文字符。请确保 md 文件名和文件夹名一致。具体可以参考已有文章目录格式。
+其中，`<collection>` 表示集合，如 `multiplayer` 表示多人游戏、`modpack` 表示整合包，`<article>` 表示你的文章的英文唯一标识（尖括号表示占位符，不要直接提交 `<article>`，请确保其唯一且简短）请仅使用英文字母、数字、中划线、下划线字符作为唯一标识，不要使用空格、英文句点、中文字符。请确保资源文件夹名和 md 文件名一致，具体可以参考已有文章目录格式。
 
-每篇文章由 Markdown 编写的 `<article>.md` 文件及附带图片组成。文章的图片请放置到 `/assets/img/docs/<article>` 目录中。
+每篇文章由 Markdown 编写的 `<article>.md` 文件及附带图片组成（文章的图片请放置到 `/assets/img/docs/<article>` 目录中）在 Markdown 文件中请确保包含 [Front Matter](https://jekyllrb.com/docs/front-matter/) 其中应提供文章的一些元数据（如标题 `title` 更新日期 `date` 等）在 `_config.yml` 的 `defaults` 中配置有默认值的可以不指定。
 
 ### 添加新文章
 
@@ -49,3 +53,57 @@ assets
 ### 更新索引
 
 在添加或修改文章后，请更新索引文件 `index.json`，以便 HMCL 展示你新添加的文件。
+
+### 本地部署
+
+项目是基于 Jekyll 实现的静态网站，使用 Minimal Mistakes 主题。
+
+如果您想更深入的参与项目文档的维护，可参阅以下内容。
+
+#### 前置条件
+
+- `Ruby` 版本大于等于 `3.1` （项目构建版本 `3.4`）
+
+#### 安装 bundle
+
+> 环境中已安装 `bundle` 可跳过本节
+
+```shell
+gem install bundler
+```
+
+#### 下载源码
+
+> 以 `git` 为例，您也可以通过 `github` 下载源码压缩包或其它方式下载源码。
+
+```shell
+# 克隆项目到本地
+git clone https://github.com/HMCL-dev/HMCL-docs.git
+# 进入项目根目录
+cd HMCL-docs
+```
+
+#### 安装依赖
+
+```shell
+# 配置镜像（请自行根据网络环境决定是否需要使用镜像，此处以腾讯云镜像为例）
+bundle config mirror.https://rubygems.org https://mirrors.cloud.tencent.com/rubygems
+# 配置项目依赖安装路径
+bundle config path vendor/bundle
+# 安装项目依赖
+bundle install
+```
+
+#### 启动本地开发服务器
+
+```shell
+bundle exec jekyll serve
+```
+
+#### 本地构建产物
+
+> 根据需要配置环境变量，配置 `JEKYLL_ENV=production` 表示生产环境构建。
+
+```shell
+bundle exec jekyll build
+```

_changelog/dev.md

@@ -1,17 +1,13 @@
 ---
+layout: changelog
+channel: dev
 title: 开发版更新日志
 date: 2021-08-22 23:18:02 +0800
-categories: 更新日志
-note: Changelogs are written in Chinese.
-hits: true
-toc: true
 ---
 
-{% assign changelogs = site.changelogs | where_exp: "item", "item.relative_path contains 'dev/'" | reverse %}
+<!--{% comment %}-->
-{% for item in changelogs %}
+> [!NOTE]
-  {% assign path = item.relative_path |  split: '.' | first | split: '/' %}
+> <!--{% endcomment %}-->
-  {% assign end = path | size %}
+> Changelogs are written in Chinese.
-  {% assign version = path | slice: 2, end | join: '.' %}
+<!----{{ '>' }}
-  <h1 id="{% if forloop.index == 1 %}nowchange{% else %}HMCL-{{ version }}{% endif %}">HMCL {{ version }}</h1>
+{: .notice--info }
-  <div>{{ item.content | markdownify }}</div>
-{% endfor %}

_changelog/stable.md

@@ -1,17 +1,13 @@
 ---
+layout: changelog
+channel: stable
 title: 稳定版更新日志
 date: 2021-08-22 23:18:02 +0800
-categories: 更新日志
-note: Changelogs are written in Chinese.
-hits: true
-toc: true
 ---
 
-{% assign changelogs = site.changelogs | where_exp: "item", "item.relative_path contains 'stable/'" | reverse %}
+<!--{% comment %}-->
-{% for item in changelogs %}
+> [!NOTE]
-  {% assign path = item.relative_path |  split: '.' | first | split: '/' %}
+> <!--{% endcomment %}-->
-  {% assign end = path | size %}
+> Changelogs are written in Chinese.
-  {% assign version = path | slice: 2, end | join: '.' %}
+<!----{{ '>' }}
-  <h1 id="{% if forloop.index == 1 %}nowchange{% else %}HMCL-{{ version }}{% endif %}">HMCL {{ version }}</h1>
+{: .notice--info }
-  <div>{{ item.content | markdownify }}</div>
-{% endfor %}

_changelogs/dev/3.10/3.10.0.315.md

@@ -0,0 +1,22 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1149333068052430851)
+
+- GP-4932: 在主页右键点击账户按钮时弹出快速切换账户菜单 (by zimzaza4)
+- GP-5011: 在 `JFXCustomColorPickerDialog` 中使用 HEX 作为默认 Tab (by Glavo)
+- GP-5019: 使用子标题注解“提前预览 HMCL 版本”选项 (by neveler)
+- GP-5019: 使用子标题显示“重启后生效”提示 (by neveler)
+- GP-4927: 在 macOS 平台上导出启动脚本时支持导出 `.command` 文件 (by WhatDamon)
+- GP-4872: 添加快速进入世界功能 (by mineDiamond)
+- GP-5008: 优化反馈页面 (by Glavo)
+- GP-5035: 在所有平台上将 `:` 视为文件名中的非法字符 (by 辞庐)
+- GP-5016: 在刷新 `ModListPage` 时不滚动到顶部 (by OrzMiku)
+- GP-5032: 优化 `InputDialogPane` (by mineDiamond)
+- GP-4897: 导出整合包时隐藏系统资源文件 (by Calboot)
+
+错误修复:
+
+- GP-5018: 修复 `subtitle` 颜色丢失的问题 (by neveler)
+- GP-5020: 修复 `GameCrashWindow` 中 `feedbackTextFlow` 样式错误的问题 (by Glavo)
+- GP-5040: 修复陶瓦联机页面部分文本在深色模式下颜色异常的问题 (by Glavo)

_changelogs/dev/3.10/3.10.0.317.md

@@ -0,0 +1,47 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1154036684319358993)
+
+- GP-4289: 在添加游戏目录页面选择目录时自动填写名称 (by Dime，辞庐，Glavo)
+- GP-4794: 优化微软登录页面 (by 辞庐，3gf8jv4dv)
+- GP-4882: 取消 `FXUtils#onClicked` 的连点限制 (by 辞庐)
+- GP-5043: 修复导出整合包界面以及 NBT 文件查看界面样式 (by Calboot)
+- GP-5046: 禁用游戏日志窗口的平滑滚动效果 (by Glavo)
+- GP-5052: 优化列表的平滑滚动效果 (by Glavo)
+- GP-5054: 优化账户选择弹窗在列表为空时的表现 (by mineDiamond)
+- GP-5056: 优化列表性能 (by Glavo)
+- GP-5057: 更新“没有游戏实例”标签的颜色 (by Glavo)
+- GP-5060: 优化非主窗口中对话框的效果 (by 辞庐)
+- GP-5062: 更新 NBT 标签图标 (by mineDiamond)
+- GP-5076: 优化不透明度滑块显示效果 (by neveler)
+- GP-5077: 优化设置页面的内边距 (by neveler)
+- GP-5079: 为不同类型的对话框指定相应的默认标题 (by neveler)
+- GP-5082: 更新关于页面的版权年份至 2026 (by 辞庐)
+- GP-5086: 更新安装游戏时选择加载器版本后的返回动画方向 (by 辞庐)
+- GP-5087: 更新启动按钮分隔符颜色 (by neveler)
+- GP-5088: 切换实例菜单仅在菜单高度大于最大高度时显示垂直滚动条 (by neveler)
+- GP-5101: 在进度指示器中添加圆角 (by 辞庐)
+- GP-5102: 优化文本输入框右键菜单的样式 (by Glavo)
+- GP-5107: 优化 `OptionToggleButton` (by 辞庐)
+- GP-5108: 优化打包日志逻辑 (by 辞庐)
+- GP-5114: 优化部分页面显示效果 (by neveler)
+- GP-5119: 安装 Modrinth 整合包时下载图标 (by Glavo)
+- GP-5129: 优化校验输入框内容的方式 (by 辞庐)
+- GP-5131: 修复缓存目录设置进入时默认未勾选的问题 (by 辞庐)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5034: 修复下载光影时对话框的标题文字错误的问题 (by Wulian233)
+- GP-5064: 修复弹出菜单在 HiDPI 显示器上播放动画过程中内容 Y 轴方向缩放异常的问题 (by Glavo)
+- GP-5080: 修复外置登录对话框在部分情况下未正确验证用户名的问题 (by Glavo)
+- GP-5081: 修复无法读取部分模组信息的问题 (by Glavo)
+- GP-5091: 修复未正确处理部分特殊版本号的问题 (by mineDiamond)
+- GP-5110: 修复无法解析新版本 NeoForge 版本号的问题 (by 辞庐)
+- GP-5111: 修复复制游戏实例相关问题 (by 辞庐)
+- GP-5112: 修复添加实例目录页面有一个空 Tooltip 的问题 (by 辞庐)
+- GP-5117: 修复离线换肤对话框中提示栏和按钮重叠的问题 (by NoClassDefFoundError)
+- GP-5118: 修复部分平台弹出菜单无法通过点击侧边栏收起的问题 (by 辞庐)
+- GP-5125: 修复未正确归类 NeoForge alpha 版本的问题 (by 辞庐)
+- GP-5128: 修复使用 BMCLAPI 下载源时选择 `Liteloader` 版本时可能报错的问题 (by Wulian233)

_changelogs/dev/3.10/3.10.0.318.md

@@ -0,0 +1,37 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1156648660083146756)
+
+- GP-4823: 优化世界管理界面和世界信息界面 (by mineDiamond, 3gf8jv4dv)
+- GP-4832: 支持更新部分模组 (by ZZZank)
+- GP-4929: 将陶瓦联机更新至 0.4.1 (by Burning_TNT)
+- GP-5026: 限制访问 Modrinth/CurseForge 时的并发数 (by Burning_TNT)
+- GP-5133: 修复第三方构建下禁用账户刷新的 tooltip 展示不支持的超链接标签的问题 (by Wulian233, 3gf8jv4dv)
+- GP-5137: 允许重命名实例时使用原名 (by mineDiamond)
+- GP-5143, GP-5168: 优化对获取账号信息时发生 SSL 异常的处理 (by Xirren, 3gf8jv4dv)
+- GP-5146: 使用 kala-compress 读取模组元数据 (by Glavo)
+- GP-5150: 调整平滑滚动的截止速度 (by Glavo)
+- GP-5159: 更新“检查模组更新”按钮的文本 (by 3gf8jv4dv)
+- GP-5160: 优化下载页面中来自 Modrinth 的内容标签显示 (by ENC_Euphony)
+- GP-5174: 优化实例列表的性能 (by Glavo)
+- GP-5180: 在资源包下载页面中隐藏不必要的标签 (by Glavo)
+- GP-5182: 支持重置日志字体 (by 辞庐)
+- GP-5186: 优化弹出菜单的显示 (by 辞庐)
+- GP-5188: 仅在左键点击时触发 `JFXRippler` 的波纹 (by Glavo)
+
+错误修复:
+
+- GP-5124: 修复离线换肤界面部分字体下产生额外空行的问题 (by NoClassDefFoundError)
+- GP-5144: 修复 `FetchTask` 未捕获部分异常的问题 (by Glavo)
+- GP-5148, GP-5151: 修复无法安装文件名包含特殊字符的整合包的问题 (by Glavo)
+- GP-5153: 修复窗口重新获取焦点时 `JFXRadioButton` 显示阴影的问题 (by Glavo)
+- GP-5162: 修复数据包管理页面在加载大量数据包时卡顿的问题 (by mineDiamond)
+- GP-5178: 修复窗口重新获取焦点时 `JFXButton` 意外地显示阴影的问题 (by Glavo)
+- GP-5179: 修复窗口重新获取焦点时 `JFXCheckBox` 意外地显示阴影的问题 (by Glavo)
+- GP-5166: 修复未下载陶瓦联机时打开陶瓦联机页面抛出异常的问题 (by Glavo)
+- GP-5167: 修复游戏设置中 Java 路径过长时可能与 Java 版本号标签冲突的问题 (by ENC_Euphony)
+- GP-5170: 修复无法安装部分带有 NeoForge 的 Modrinth 整合包的问题 (by 3gf8jv4dv)
+- GP-5183: 修复重置字体后未遵循 `hmcl.font.override`/`HMCL_FONT` 设置的问题 (by 辞庐, Glavo)
+- GP-5184: 修复游戏安装页面中卡片未显示波纹的问题 (by 辞庐)
+- GP-5197: 修复使用默认窗口大小时进入高级版本设置会向下滚动一段距离的问题 (by 辞庐)

_changelogs/dev/3.10/3.10.0.319.md

@@ -0,0 +1,15 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1158117702119718933)
+
+- GP-5208: 惰性初始化 `JFXRippler` 属性 (by Glavo)
+- GP-5211: 优化下载页面图标缓存功能 (by Glavo)
+- GP-5221: 更新 `ToolbarListPageSkin` 以使用 `JFXListView` 展示节点 (by Glavo)
+- GP-5223: 重构 `JavaManagementPage` 以使用 `ListCell` 展示元素 (by Glavo)
+- GP-5224: 重构 `WorldListPage` 以使用 `ListCell` 展示元素 (by Glavo)
+
+错误修复:
+
+- GP-5203: 修复实例列表不显示实例名的问题 (by Xirren)
+- GP-5220: 修复 CurseForge 源无法搜索到内容的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.321.md

@@ -0,0 +1,29 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1160728024302223363)
+
+- GP-4792: 优化 Fabric API / Quilt API 安装提示 (by 辞庐, 3gf8jv4dv)
+- GP-5029: 优化检查模组更新功能 (by Burning_TNT)
+- GP-5090: 支持自动安装 Legacy Fabric (by 辞庐)
+- GP-5172: 支持通过拖动标题栏退出最大化 (by neveler)
+- GP-5196: 使用 Forge/Quilt 加载器时模组管理页面应当扫描子文件夹 (by Wulian233)
+- GP-5198: 将世界管理界面“生成启动脚本”按钮折叠到二级菜单 (by Glavo)
+- GP-5239: 下载页面图标尚未加载时应当将图像更新为空白 (by Glavo)
+- GP-5250: Modrinth 默认不获取更新日志 (by Calboot)
+- GP-5251: 修复自动安装界面卡片上按钮无法点击的问题 (by 神奇的赵二 (OrzMiku))
+- GP-5259: 提早非法路径检查 (by 辞庐)
+- GP-5269: 支持右键点击侧边栏弹出切换实例菜单 (by Glavo)
+- GP-5273: 优化游戏代理参数设置 (by Glavo)
+- GP-5274: 对 Java 26 默认启用压缩对象头 (by Glavo)
+- GP-5276: 重构 `SchematicsPage` 以使用 `ListCell` 展示元素 (by Glavo)
+
+错误修复:
+
+- GP-5195: 修复导出 Modrinth 整合包时勾选“包含启动器”选项时导出的整合包不是 ZIP 格式的问题 (by 辞庐)
+- GP-5243: 修复实例列表中包含名称超长的实例时出现水平滚动条的问题 (by OrzMiku)
+- GP-5257: 修复本地安装 Cleanroom 完成后会删除安装器的问题 (by 辞庐)
+- GP-5261: 修复下载页面选择游戏版本对话框包含 `_unobfuscated` 版本的问题 (by Glavo)
+- GP-5262: 修复使用 GIF 背景时调整背景不透明度导致启动器崩溃的问题 (by Glavo)
+- GP-5265: 修复未正确为游戏设置 `java.net.useSystemProxies` JVM 参数的问题 (by Xirren)
+- GP-5267: 修复部分场景中解压空 ZIP 文件失败的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.322.md

@@ -0,0 +1,23 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1162588466738888708)
+
+- GP-4733: 导出日志时允许重名文件 (by Glavo)
+- GP-5245: 修复主页公告阴影被裁切的问题 (by 辞庐)
+- GP-5270: 在陶瓦联机页面添加切换账号菜单 (by Glavo)
+- GP-5279: 更新下载页面条目样式 (by Glavo)
+- GP-5283, GP-5319: 优化深色模式支持 (by Glavo)
+- GP-5292: 更新文本输入框的右键菜单样式 (by 辞庐)
+- GP-5296: 扫描模组子目录时忽略 `.connector` 文件夹 (by 辞庐)
+- GP-5304: 取消游戏下载页面中高版本游戏对 Windows 7 的不兼容提示 (by 辞庐)
+
+错误修复:
+
+- GP-5284: 修复部分列表页面出现横向滚动条的问题 (by Glavo)
+- GP-5299: 修复添加认证服务器对话框非 CJK 语言下宽度异常的问题 (by 辞庐)
+- GP-5300: 修复下载页面模组简介只会显示一行的问题 (by 辞庐)
+- GP-5305: 修复返回页面时可能卡进空白页面的问题 (by 辞庐)
+- GP-5308: 修复 `JFXTabPane` 指示器偏移的问题 (by 辞庐)
+- GP-5310: 修复点击实例列表条目的中央区域无法触发涟漪效果的问题 (by 辞庐)
+- GP-5328: 修复弹出菜单在 RTL 布局下弹出位置错误的问题 (by 辞庐)

_changelogs/dev/3.11/3.11.0.323.md

@@ -0,0 +1,24 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1164826007218159625)
+
+- GP-5390: 将 TwelveMonkeys 更新至 3.13.0 (by Glavo)
+- GP-5391: 将 XZ for Java 更新至 1.11 (by Glavo)
+- GP-5392: 将 Gradle Shadow 插件更新至 9.3.1 (by Glavo)
+- GP-5385: 优化 `ComponentList` (by Glavo)
+- GP-4975: 调整渲染器名称 (by Chen Meng)
+- GP-5337: 使用 `LineSelectButton` 代替 `JFXComboBox` (by Glavo)
+- GP-5215: 优化世界管理与世界信息页面 (by mineDiamond, 3gf8jv4dv, Glavo)
+- GP-5272: 启动时检查 Jar 路径是否包含 `!` (by 辞庐)
+- GP-5317: 在 Linux 平台使用 dbus-send 检测深色模式设置 (by Glavo)
+- GP-5364: 在 NBT 查看器页面启用平滑滚动 (by Glavo)
+
+错误修复:
+
+- GP-5333: 修复启动服务端自动更新整合包时会下载并启用已禁用的模组的问题 (by Luo Chen)
+- GP-5374: 修复不透明度数值标签可能被折叠的问题 (by NoClassDefFoundError)
+- GP-5375: 修复部分列表点击后无法通过 esc 返回的问题 (by NoClassDefFoundError)
+- GP-5379: 修复版本设置页面滚动条总是显示的问题 (by Dime)
+- GP-5388: 修复导出的 PowerShell 脚本中路径可能无效的问题 (by Xirren)
+

_changelogs/dev/3.11/3.11.0.325.md

@@ -0,0 +1,34 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1167033744946626616)
+
+- GP-5395, GP-5408, GP-5416, GP-5446: 统一列表卡片样式 (by Glavo)
+- GP-5422: 优化日志窗口无日志行的背景色 (by 辞庐)
+- GP-5405: 统一加载指示器大小 (by 辞庐)
+- GP-5406: 统一实例管理页面子页面刷新时的样式 (by 辞庐)
+- GP-5426: 导出运行栈时附加 `-e` 和 `-l` 参数 (by 辞庐)
+- GP-5456: 优化工具栏按钮图标 (by Glavo)
+- GP-5465, GP-5474: 优化下载页面条目中标签的展示方式 (by Glavo)
+- GP-5481: 优化设置页面检查更新设置项的样式 (by Glavo)
+- GP-5467: 自动展开 NBT 查看器中部分子标签 (by Calboot)
+- GP-5417: 更新文言文 README (by GIGN)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5012: 修复 Modrinth 模组依赖已经被删除的条目时无法加载版本列表的问题 (by Burning_TNT)
+- GP-5432: 修复部分页面弹出菜单会被重复触发的问题 (by Glavo)
+- GP-5398: 修复文本输入框右键菜单中图标风格与其他图标不一致的问题 (by 辞庐)
+- GP-5411: 修复离线账户换肤对话框中对 Custom Skin API 地址的校验未生效的问题 (by 辞庐)
+- GP-5413: 修复 1.5.2 等版本 Legacy Fabric 无法安装的问题 (by 辞庐)
+- GP-5414: 修复 Legacy Fabric API 可以和 Forge 同时安装的问题 (by 辞庐)
+- GP-5423: 修复安装游戏时选择版本后返回已选择的版本会被清除的问题 (by 辞庐)
+- GP-5433: 修复部分环境中进入下载页面时启动器崩溃的问题 (by Glavo)
+- GP-5434: 修复日志级别选择按钮背景颜色溢出的问题 (by 辞庐)
+- GP-5442: 修复无法为 Minecraft 1.12.2 安装 Forge 和 Cleanroom 的问题 (by Glavo)
+- GP-5449: 修复 SVG 图标对齐错误的问题 (by Glavo)
+- GP-5461: 修复世界管理页面中快速启动按钮出现在不支持的版本的问题 (by mineDiamond)
+- GP-5477: 修复部分页面意外的显示滚动条的问题 (by Glavo)
+- GP-5479: 修复无法正确识别 Minecraft 2.0 实例版本号的问题 (by Glavo)
+- GP-5480: 修复无法归一化版本号 "1.16.2 Pre-release 1" 的问题 (by Glavo)

_changelogs/dev/3.11/3.11.0.326.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1167774223102378020)
+
+- GP-5504: 更新陶瓦联机至 0.4.2 (by Glavo)
+- GP-5462: 未安装实例时点击主页“开始游戏”按钮不选择不支持当前平台的版本 (by 辞庐, Glavo)
+
+错误修复:
+
+- GP-5369: 修复在 ZIP 文件中遇到重名目录条目时读取失败的问题 (by NoClassDefFoundError)
+- GP-5507: 修复陶瓦联机页面“导出联机日志”按钮内边距异常的问题 (by Glavo)

_changelogs/dev/3.12/3.12.0.327.md

@@ -0,0 +1,17 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1169623275237539841)
+
+- GP-5330, GP-5531, GP-5538: 更新微软账户登录流程 (by 辞庐, Glavo)
+- GP-5368: 阻止在颜色选择器中输入非法颜色信息 (by Damon Lu)
+- GP-5527: 增加弹窗图标内容间距 (by 辞庐)
+- GP-5524: 将指向 MCEdit 的链接替换为 Minecraft Wiki 的教程页面 (by 3gf8jv4dv)
+- GP-5394: 使 Java 下载页面可以同时下载多个 Java (by NoClassDefFoundError)
+
+错误修复:
+
+- GP-5508: 修复部分请求头中 Accept-Language 字段包含 Java 版本的问题 (by Glavo)
+- GP-5520: 修复下载游戏版本列表点击左侧图标无法触发水波纹效果及光标没有变成手型的问题 (by 辞庐)
+- GP-5522: 修复安装卡片部分区域点击无法触发水波纹效果的问题 (by 辞庐)
+- GP-5543: Fix #5525: 修复 Task 进度异常的问题 (by Glavo)

_changelogs/dev/3.12/3.12.0.328.md

@@ -0,0 +1,28 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1171870118637994018)
+
+- GP-5242: 支持在实例列表搜索实例 (by 辞庐)
+- GP-5514: 为“渲染器”添加描述 (by Damon Lu)
+- GP-5521: 优化下载页面条目水波纹样式 (by 辞庐)
+- GP-5539: 解析 Yggdrasil 服务器地址时遵循服务器重定向 (by Glavo)
+- GP-5552: 支持新版本世界指定资源包位置 (by mineDiamond)
+- GP-5583: 支持在 FreeBSD x86-64、Linux Arm64、Linux RISC-V64 平台上启动 Minecraft 26.1-snapshot-8 或更高版本 (by Glavo)
+- GP-5585: 修复下载源失效时刷新版本列表不会回退到备用下载源的问题 (by Glavo)
+- GP-5586: 优化无法补全 JavaFX 时的报错信息 (by Glavo)
+- GP-5546, GP-5559, GP-5560, GP-5564, GP-5565, GP-5569, GP-5570, GP-5574: 优化部分控件样式 (by Glavo)
+
+错误修复:
+
+- GP-5430: 修复启动游戏补全文件时任务没有正确归类的问题 (by 辞庐)
+- GP-5532: 修复高分屏下新建账户 Tab 文字模糊的问题 (by 辞庐)
+- GP-5536: 修复更新整合包后模组加载器版本号不会及时更新的问题 (by 小宇)
+- GP-5549: 修复微软登录报错的超链接显示 (by Xirren)
+- GP-5550: 修复安装整合包时任务弹窗可能空白的问题 (by 辞庐)
+- GP-5556: 修复通过 CurseForge/Modrinth 安装整合包时可以返回到整合包类型选择页面的问题 (by 辞庐)
+- GP-5558: 修复光影下载搜索栏中错误地显示“支持中英文搜索”提示的问题 (by 辞庐)
+- GP-5575: 修复无法使用授权代码流登录微软账户的问题 (by 辞庐)
+- GP-5581: 修复日志窗口 Ctrl+C 复制日志时在主窗口显示提示的问题 (by 辞庐)
+- GP-5584: 修复打开登录微软对话框时加载指示器一闪而过的问题 (by 辞庐)
+- GP-5600: 修复部分对话框中取消按钮行为异常的问题 (by 辞庐)

_changelogs/dev/3.12/3.12.0.330.md

@@ -0,0 +1,25 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1175547967863521301)
+
+- GP-5030: 重新启用 MCIM 加速 (by Glavo)
+- GP-5359: 修复语言为文言时下载游戏的选择模组加载器页面的版本号未本地化的问题 (by Wulian233)
+- GP-5458, GP-5463: 下载界面简介不滚动 (by Calboot)
+- GP-5554: 向图标添加圆角 (by Dime)
+- GP-5603: 下载任务在重试前添加等待延迟 (by Glavo)
+- GP-5610: 优化设备代码流登录流程 (by Glavo)
+- GP-5622: 更新 Copyright 年份 (by 3gf8jv4dv)
+- GP-5624: 更新对 Linux LoongArch64 平台的支持 (by Glavo)
+- GP-5638: 切换实例隔离设置后自动刷新其他子页面 (by 辞庐)
+- GP-5652: 在世界管理页面中不展示 zip 格式的世界 (by Wulian233)
+- GP-5655: 添加对 1.21.11-rc3_unobfuscated 的支持 (by TNTyep520, Glavo)
+- GP-5623: 优化软件文案，修订翻译 (by 3gf8jv4dv)
+
+错误修复:
+
+- GP-5605: 修复选择角色弹窗未适配深色模式 (by 辞庐)
+- GP-5607: 修复账号列表复制按钮未正确应用样式的问题 (by 辞庐)
+- GP-5617: 修复 `JFXSpinner` 样式失效的问题 (by 辞庐)
+- GP-5613: 修复本地安装整合包时出现错误的问题 (by 辞庐)
+- GP-5633: 修复 `message.question` 未本地化的问题 (by 辞庐)

_changelogs/dev/3.12/3.12.0.331.md

@@ -0,0 +1,31 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1177774504686911489)
+
+- GP-5731: 将 Gradle 更新至 9.4.0 (by 辞庐)
+- GP-5717: 将 JetBrains Java Annotations 更新至 26.1.0 (by Glavo)
+- GP-5675: 支持解析 Minecraft 26.1-snapshot-6 新版本存档数据 (by mineDiamond)
+- GP-5690: 优化 `FileSelector` 按钮样式 (by 辞庐)
+- GP-5697: 将 BAT 脚本命令长度限制增加至 32767 (by 辞庐)
+- GP-5698: 优化安装实例时自动补全模组加载器名称 (by 辞庐)
+- GP-5707: 优化 `LineSelectButton` 弹出菜单配色 (by 辞庐)
+- GP-5716: 向滚动条添加圆角 (by Calboot)
+- GP-5739: 移除下载页面超链接多余 Tooltip (by 辞庐)
+- GP-5760: 优化 `JFXToggleButton` 配色 (by Glavo)
+- GP-5636: 支持使用键盘方向键调整 `LineSelectButton` 值 (by 辞庐)
+- GP-5759: 为主页启动按钮添加冷却时间 (by Glavo)
+- GP-5714: 更新阿拉伯语翻译 (by Hommam-Prom)
+- GP-5737: 更新运行路径中包含非法字符 `=` 时的提示 (by 辞庐)
+
+错误修复:
+
+- GP-5659: 修复导出游戏运行栈按钮对低版本 Java 未显示不兼容提示的问题 (by 辞庐)
+- GP-5662: 修复无法为使用 Java 11 启动的游戏导出游戏运行栈的问题 (by 辞庐)
+- GP-5669: 修复无法导入部分 Modrinth 整合包的问题 (by 辞庐)
+- GP-5691: 修复整合包安装界面文件名重复的提示显示不全的问题 (by 辞庐)
+- GP-5692: 修复整合包安装页面游戏实例名选项显示为文件名的问题 (by 辞庐)
+- GP-5693: 修复 `SpinnerPane` 会裁切元素的问题 (by 辞庐)
+- GP-5705: 修复取消模组更新检查时会弹窗操作失败的问题 (by 辞庐)
+- GP-5706: 修复 `LineComponent` 副标题样式未正确应用的问题 (by 辞庐)
+- GP-5710: 修复导出 Modrinth 整合包时不要求填写作者的问题 (by MovTery)

_changelogs/dev/3.12/3.12.0.332.md

@@ -0,0 +1,18 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1179999138825109529)
+
+- GP-5773: 更新模组数据 (by Glavo)
+- GP-4706: 添加"关闭启动时的更新弹窗"选项 (by An5w1r, Glavo)
+- GP-5620: 更新关于页面的许可证信息 (by 3gf8jv4dv)
+- GP-5769: 当背景自定义路径是文件夹时随机在文件夹中选取图片作为背景 (by 辞庐)
+- GP-5664: 优化删除垃圾桶图标 (by 辞庐)
+- GP-5663: 调整导出游戏运行栈加载指示器大小 (by 辞庐)
+
+错误修复:
+
+- GP-5728: 修复“从互联网下载整合包”选项对话框可能会意外被关闭的问题 (by Glavo)
+- GP-5765: 修复 `26.1-pre-1` 版本号无法归一化的问题 (by mineDiamond)
+- GP-5772: 修复显示器 125% 缩放时弹出菜单内容模糊的问题 (by 辞庐)
+- GP-5776: 修复颜色选择器中“自定义颜色”对话框初始值不会与当前颜色同步的问题 (by Damon Lu)

_changelogs/dev/3.13/3.13.0.333.md

@@ -0,0 +1,21 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1181885655980965928)
+
+- GP-5313: 支持从 CurseForge 下载光影 (by 辞庐)
+- GP-5631: 重启 HMCL 时继承所有 JVM 参数 (by 辞庐, Glavo)
+- GP-5787: 添加 Gitee Issue 模板配置 (by Zkitefly)
+- GP-5791: 支持愚人节模式 (by Glavo)
+- GP-5798: 使用 MCIM 作为回退下载源 (by Glavo)
+- GP-5800: 更新进度条样式 (by Glavo)
+- GP-5801: 更新 GitHub Actions (by Glavo)
+- GP-5803: 更新 `JFXSpinner` 默认样式 (by Glavo)
+- GP-5804: 优化 `JFXSpinner` 动画生成逻辑 (by Glavo)
+- GP-5805: 平滑进度条 (by Glavo)
+
+错误修复:
+
+- GP-4876: 修复 macOS 平台上空闲内存识别错误的问题 (by Damon Lu, Glavo)
+- GP-5782: 修复对高版本 Cleanroom 选择的 Java 版本错误的问题 (by 辞庐, Glavo)
+- GP-5810: 修复无法归一化 26.1 发布候选版本号的问题 (by mineDiamond)

_changelogs/dev/3.13/3.13.0.335.md

@@ -0,0 +1,22 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1183364580749869077)
+
+- GP-5660: 在游戏进程结束后禁用“结束游戏进程”与“导出游戏运行栈”按钮 (by 辞庐, Glavo)
+- GP-5667: 使用 HelloNBT 替代 OpenNBT (by Glavo)
+- GP-5694: 为游戏崩溃界面导出和启动器日志导出添加加载指示器 (by 辞庐, Glavo)
+- GP-5702: 优化 tag 展示逻辑 (by 辞庐)
+- GP-5786: 安装 CurseForge 整合包时下载图标 (by Calboot)
+- GP-5802, GP-5837: 当 CurseForge API Key 缺失时隐藏下载源切换选项 (by Glavo)
+- GP-5829: 更新内存状态栏 (by Glavo)
+- GP-5830: 禁止在颜色选择器中调整颜色透明度 (by neveler)
+- GP-5832, GP-5836: 为对话框添加圆角 (by neveler)
+- GP-5813: 将游戏设置中“不适用于当前系统的选项”提示移动到副标题 (by Damon Lu)
+- GP-5833: 优化对 26.1 正式版/预发布版/候选版的支持 (by Glavo)
+- GP-5841: 将 Java 下载页面默认 Java 版本更新至 Java 25 (by Glavo)
+- GP-5845: 更新文言文翻译 (by Glavo)
+
+错误修复:
+
+- GP-5839: 修复文本框导致 GPU 占用率异常高的问题 (by Glavo)

_changelogs/dev/3.13/3.13.0.336.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1185155375901442055)
+
+- GP-5854: 将 twelvemonkeys 更新至 3.13.1 (by Glavo)
+- GP-5855: 将 HelloNBT 更新至 0.3.0 (by Glavo)
+- GP-5601: 下载页面折叠快照 Minecraft 版本 (by 辞庐, Glavo)
+- GP-5703: 更新更新渠道选择选项 (by 辞庐, 3gf8jv4dv, Glavo)
+- GP-5851: 优化读取 JAR/ZIP 文件时的性能 (by Glavo)
+- GP-5860: 更新种子地图、要塞地图、下届要塞地图和末地城地图链接以支持 26.1 (by neveler)
+- GP-5870: 优化 Minecraft 26.1 性能 (by Glavo, 3gf8jv4dv) ([BV1mPXSBEEBx](https://www.bilibili.com/video/BV1mPXSBEEBx))

_changelogs/dev/3.13/3.13.0.337.md

@@ -0,0 +1,21 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188172826709852165)
+
+- GP-5882: 将 lwjgl-unsafe-agent 更新至 2.0 (by Glavo)
+- GP-5883: 将 XZ for Java 更新至 1.12 (by Glavo)
+- GP-5316: 更新 AMD 显卡信息数据 (by 辞庐, Glavo)
+- GP-5484: 支持加载 SVG 图片 (by Glavo)
+- GP-5518: 在 Wine 环境中启动时发出警告 (by Damon Lu)
+- GP-5738: 为在临时目录中启动 HMCL 时弹出的提示对话框添加 5 秒倒计时 (by 辞庐)
+- GP-5775: 为自定义颜色选择对话框添加确认和取消按钮 (by mineDiamond, Glavo)
+- GP-5781: 支持设置模组/整合包/光影/资源包/世界默认下载源 (by Calboot, Glavo, 3gf8jv4dv)
+- GP-5861: 优化“关于”页面组件间距 (by neveler)
+- GP-5892: 优化对 26w14a 愚人节版本的支持，更新模组下载页游戏版本列表至 26.1.1 (by Glavo)
+- 优化软件文案，修订翻译 (by 3gf8jv4dv, 辞庐, Xirren)
+
+错误修复:
+
+- GP-5301: 修复清理游戏资源/库操作在 JavaFX 线程运行的问题 (by 辞庐)
+- GP-5877: 修复对话框动画过程中内容模糊的问题 (by 辞庐)

_changelogs/dev/3.13/3.13.0.338.md

@@ -0,0 +1,26 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188173041413128193)
+
+- GP-4716: 优化 Java 搜索 (by Glavo)
+- GP-5859: 优化 Java 下载 (by Glavo)
+- GP-5730: 支持通过版本 JSON 安装实例 (by 辞庐, Glavo)
+- GP-5917, GP-5905: 优化组合框样式 (by Wulian233, 辞庐, Glavo)
+- GP-5872: 优化下载页面依赖项展示 (by 辞庐)
+- GP-5923: 优化原理图管理和世界界面中部分输入框的校验方式 (by 辞庐)
+- GP-5924: 优化 Java 下载弹窗旋转指示器样式 (by 辞庐)
+- GP-5925: 优化添加认证服务器 HTTP 警告颜色 (by 辞庐)
+
+错误修复:
+
+- GP-5609: 修复阴影无法完整覆盖部分控件的问题 (by 辞庐)
+- GP-5688: 修复预览皮肤时 Alex 模型皮肤手臂后侧有一列侧面的异常像素的问题 (by 辞庐)
+- GP-5879: 修复安装模组时未检查是否已存在的问题 (by 辞庐)
+- GP-5888: 修复模组管理页面对于 1.20.1+NeoForge 实例会将部分 Forge 模组识别为 `MixinExtras` 的问题 (by Calboot)
+- GP-5899: 修复下载游戏内容时出现空游戏版本条目的问题 (by Calboot)
+- GP-5910: 修复无法为 Minecraft 26.1.1 从官方源安装 NeoForge 的问题 (by Glavo, Burning_TNT)
+- GP-5911: 修复多次打开微软登录弹窗后报错的问题 (by Glavo)
+- GP-5914: 修复深色模式下导入整合包界面箭头颜色错误的问题 (by Calboot)
+- GP-5915: 修复长按标题栏中部分按钮时可以拖动窗口的问题 (by 辞庐)
+- GP-5922: 修复安装整合包部分任务未正确归类的问题 (by 辞庐)

_changelogs/dev/3.13/3.13.0.339.md

@@ -0,0 +1,6 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1188905221714083844)
+
+- GP-5928: 支持在 FreeBSD x86-64、Linux Arm64、Linux LoongArch64 和 Linux RISC-V64 平台上启动 Minecraft 26.2-snapshot-1+ (by Glavo)

_changelogs/dev/3.13/3.13.0.340.md

@@ -0,0 +1,12 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1190023991956340740)
+
+- GP-5930: 增强对 Vulkan 的支持 (by Glavo, 3gf8jv4dv)
+- GP-5931: 支持将新格式快照版本号翻译为文言 (by Glavo)
+- GP-5934: 更新游戏内容下载页游戏版本列表至 26.1.2 (by Glavo)
+
+错误修复:
+
+- GP-5935: 修复日志窗口可能意外的显示横向滚动条的问题 (by Glavo)

_changelogs/dev/3.14/3.14.0.341.md

@@ -0,0 +1,14 @@
+---
+---
+
+[详细版本介绍 (Bilibili)](https://www.bilibili.com/opus/1192630259688669201)
+
+- GP-5940: 支持更多 Vulkan 渲染器 (by Glavo) [BV1Nhd5B9ENc](https://bilibili.com/video/BV1Nhd5B9ENc)
+- GP-5945: 增大自动安装界面加载器名称版本号间距 (by 辞庐)
+- GP-5949: 上传微软账户皮肤时校验大小 (by 辞庐)
+- GP-5944: 优化菜单分隔符颜色 (by 辞庐,Glavo)
+- GP-5946: 隐藏 CurseForge 源中游戏内容的不重要标签 (by 辞庐)
+
+错误修复:
+
+- GP-5943: 修复模组名字过长时下载页面布局异常的问题 (by 辞庐)

_changelogs/dev/3.2/3.2.120.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复打开版本管理时的崩溃

_changelogs/dev/3.2/3.2.124.md

@@ -0,0 +1,5 @@
+---
+---
+
+- 修复无法正版登录的问题
+- 修复 mods 不是文件夹时无法安装模组的问题

_changelogs/dev/3.2/3.2.127.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 禁止用户同时安装 Forge 1.13.2 和 OptiFine

_changelogs/dev/3.2/3.2.147.md

@@ -0,0 +1,5 @@
+---
+---
+
+- 修复正版登录失败的问题
+- 修复无法正常显示错误信息的问题

_changelogs/dev/3.3/3.3.154.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复 3.3.153 导致的启动失败问题

_changelogs/dev/3.3/3.3.155.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复 3.3.154 导致的启动失败问题

_changelogs/dev/3.3/3.3.165.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复无法自动更新的问题

_changelogs/dev/3.3/3.3.175.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复部分情况误修改 options.txt 的问题

_changelogs/dev/3.3/3.3.177.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复下载失败导致游戏无法启动的问题

_changelogs/dev/3.3/3.3.181.md

@@ -0,0 +1,5 @@
+---
+---
+
+- 微软登录页添加加载进度条
+- 修复整合包导出页无法点击下一步的问题

_changelogs/dev/3.3/3.3.196.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复进入 Mod 下载页面时崩溃的问题

_changelogs/dev/3.3/3.3.200.md

@@ -0,0 +1,4 @@
+---
+---
+
+- 修复微软登录超时后崩溃的问题