[Feature] 模组等的更新日志以及 `HTMLRenderer` 的完善 by Calboot · Pull Request #4828 · HMCL-dev/HMCL

Calboot · 2025-11-19T14:58:36Z

添加了下载模组、数据包等以及更新模组时显示更新日志的功能
Resolves #4685

具体变化：

以下载模组为例，在原来仅用作展示模组依赖项的页面中同时展示该版本更新日志并可跳转到版本发布界面
检查模组更新之后的表格中在最右侧添加“更新日志”列，点击单元格即可打开更新日志并可跳转到版本发布界面
添加打开链接页面的“复制”按钮
HTMLRenderer 的优化与完善，以及对 Markdown 的支持（引入了新依赖）

TODO：

~~依赖 #5463~~

可能不准确不地道，需要熟悉这些语言的人验证

Calboot · 2025-11-21T13:27:58Z

~~需要能读懂日语、俄语、乌克兰语、西班牙语的人来审核一下语言文件~~

我把那些语言的删了，以后再加吧

# Conflicts: # HMCL/src/main/resources/assets/lang/I18N.properties # HMCL/src/main/resources/assets/lang/I18N_es.properties # HMCL/src/main/resources/assets/lang/I18N_ja.properties # HMCL/src/main/resources/assets/lang/I18N_lzh.properties # HMCL/src/main/resources/assets/lang/I18N_ru.properties # HMCL/src/main/resources/assets/lang/I18N_uk.properties # HMCL/src/main/resources/assets/lang/I18N_zh.properties # HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModUpdatesPage.java

Calboot · 2025-12-13T12:34:06Z

现在对 Markdown 里面的裸超链接还没有进行支持，是否应该支持？

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

Glavo · 2026-03-12T13:20:28Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

+
+            Button changelogButton = new JFXButton(i18n("mods.changelog"));
+            changelogButton.getStyleClass().add("dialog-accept");
+            loadChangelog(version, selfPage.repository, changelogButton);


为什么要在 HMCL 里渲染这个更新日志？我没有看出必要性。我认为点击按钮后在浏览器里查看就可以了，不需要在 HMCL 内解析渲染它。

为什么要在 HMCL 里渲染这个更新日志？我没有看出必要性。我认为点击按钮后在浏览器里查看就可以了，不需要在 HMCL 内解析渲染它。

说实话，如果你一开始就是这么想的话，就应该早一点，在去年 11 月 PR 提交后的一段时间里就提出，而不是在 PR 滞留数月，甚至分配给 Copilot 审核的几周后，又给出这个结论。

这个 PR 一开始的目标就是「在 HMCL 内展示 (即渲染) 更新日志」。在今年的一月我还抽时间看了十几个模组、资源包等的实际渲染情况。你可以看中间的对话记录 (默认应该是折叠的)。

如果你之前能够早点提出这个意见，那或许这个 PR 就此结案，不会白白花时间完善之后又滞留数月、不知道命运如何；或者早期沟通后你改变主意，然后 PR 等到今年差不多也顺利合并了。

为什么要在 HMCL 里渲染这个更新日志？我没有看出必要性。我认为点击按钮后在浏览器里查看就可以了，不需要在 HMCL 内解析渲染它。

为什么这么在意“必要性”？给用户更方便的体验不是很好吗

为什么这么在意“必要性”？给用户更方便的体验不是很好吗

关键我也不觉得在 HMCL 里显示这个会更方便。我认为这个是低频操作，本身对用户体验的影响不大，而且浏览器窗口通常更大，看这些日志类内容本身就更舒服。

关键我也不觉得在 HMCL 里显示这个会更方便。我认为这个是低频操作，本身对用户体验的影响不大，而且浏览器窗口通常更大，看这些日志类内容本身就更舒服。

浏览器里打开的话确实看着舒服，但是现在国内访问 Modrinth 和 CF 都会卡好半天才加载好，体验远不如 HMCL 几乎瞬间渲染完成。更何况看更新日志注重的是内容，能快速而清晰地看到更新内容是远比打开浏览器方便的。

至于“低频操作”，好像真的无所谓吧。能满足少数人（比如我自己）的需求而不会影响大部队的使用体验，为什么不是好事呢？

2026-03-30.21.38.50.mov

2026-03-30.21.39.26.mov

对比：上面是打开modrinth官方页面查看更新日志的速度，下面是hmcl里加载并渲染更新日志的速度。

个人认为这足以证明这个功能是比打开浏览器看方便的。

更何况这里还是浏览器已经打开的状态。就以现在各大浏览器的臃肿程度来说，启动还得用加个一两秒时间。

# Conflicts: # HMCLCore/build.gradle.kts

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java # HMCL/src/main/resources/assets/css/root.css

3gf8jv4dv · 2026-04-01T17:55:55Z

我不太理解这个 PR 不合并的点在哪。

而且，目前已经有一些启动器，可以展示更新日志，如 XMCL——它使用 Electron，所以对于它而言是「顺手的事」。
HMCL 能实现这个功能的话，也可以吸引青睐此项的用户。

此外我同意 Calboot 说的，

能满足少数人（比如我自己）的需求而不会影响大部队的使用体验

何乐而不为呢？

Glavo · 2026-04-03T10:43:08Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 917d7d9586

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

HMCLCore/src/main/java/org/jackhuang/hmcl/mod/modrinth/ModrinthRemoteModRepository.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModUpdatesPage.java

# Conflicts: # HMCL/src/main/resources/assets/about/deps.json

Glavo · 2026-04-03T14:48:46Z

/gemini review

gemini-code-assist

Code Review

This pull request introduces a comprehensive system for displaying mod changelogs and external URLs within the launcher. It adds Markdown-to-HTML conversion using the CommonMark library, enhances the HTMLRenderer to support tables, lists, and code blocks, and integrates these features into the mod download and update pages. Key improvements include a new changelog cache, confirmation dialogs for opening external links, and updated repository interfaces to fetch changelog data from CurseForge and Modrinth. Feedback highlights the need for proper equals/hashCode implementations in the Version class to ensure cache hits, fixing style inheritance in the HTML renderer, and improving the rendering of inline code and table content.

HMCLCore/src/main/java/org/jackhuang/hmcl/mod/RemoteMod.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/HTMLRenderer.java

This reverts commit b62d8e3.

HMCLCore/src/main/java/org/jackhuang/hmcl/util/StringUtils.java

Glavo · 2026-04-05T13:33:29Z

HMCLCore/src/main/java/org/jackhuang/hmcl/util/StringUtils.java

+            AutolinkExtension.create(), InsExtension.create(), StrikethroughExtension.create(), TablesExtension.create()
+    )).build();
+
+    public static String convertToHtml(String md) {


有必要把 Markdown 转成 HTML 再渲染吗？直接写 Markdown 的渲染器更合适吧？

两个标记语言写两套完全不同的渲染器感觉没啥好处吧

Glavo · 2026-04-05T13:39:44Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/HTMLRenderer.java

        }
    }

+    public static HTMLRenderer openHyperlinkInBrowser() {


我从这个命名中看不出它会返回一个 HTMLRenderer 实例。

我认为不应该提供这样的方法，还是显式 new 更能体现出每次调用方法都返回了一个新的 HTMLRenderer 实例。

Glavo · 2026-04-05T13:42:46Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/FXUtils.java

+        openUriInBrowser(uri.toString());
+    }
+
+    public static void openUriInBrowser(String uri) {


这些东西应该放在 Controllers 里，而不是 FXUtils 里。

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

Glavo · 2026-04-05T13:56:38Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java


            if (downloadButton == null) {
-                this.setActions(saveAsButton, cancelButton);
+                this.setActions(versionPageBtn, changelogButton, saveAsButton, cancelButton);


考虑把这些链接样式的按钮拆分到单独一行上，不要和 downloadButton、saveAsButton 还有 cancelButton 在一行里抢地方了。

Glavo · 2026-04-05T13:58:26Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

+
+            JFXHyperlink changelogButton = new JFXHyperlink(i18n("mods.changelog"));
+            changelogButton.setDisable(true);
+            loadChangelog(version, selfPage.repository, changelogButton);


在点击按钮后再触发加载更合适？大部分时候用户不需要查看更新日志，我认为没有必要为此发起网络请求，给服务器造成没有必要的开销。

Glavo · 2026-04-05T14:08:08Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/HTMLRenderer.java

        applyStyle(textNode);
-        children.add(textNode);
+        if (code) {
+            var codeFlow = new TextFlow(textNode);


有必要给所有 <code> 标签生成子 TextFlow 吗？

有的很长的不用textflow就没办法换行了，而需不需要换行并不是很容易判断的事

Glavo · 2026-04-05T14:09:43Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/HTMLRenderer.java

+
+            String style = node.attr("style");
+            if (StringUtils.isNotBlank(style)) {
+                styleBuilder.append(StringUtils.addSuffix(


不应该这么简单地处理 CSS 样式，我们可能需要实现更完整的 CSS 解析。

Calboot added 5 commits November 19, 2025 20:00

下载模组时展示更新日志

73b01ce

添加模组更新界面的更新日志

cffd3e0

代码格式

5a39c98

Merge branch 'HMCL-dev:main' into mod-changelog

3d514fe

中文支持&界面优化

5b3a705

Calboot marked this pull request as ready for review November 21, 2025 10:06

Calboot marked this pull request as draft November 21, 2025 10:31

多语言支持

404548d

可能不准确不地道，需要熟悉这些语言的人验证

Calboot marked this pull request as ready for review November 21, 2025 10:44

Calboot changed the title ~~添加模组、资源包、光影包、世界、整合包的更新日志~~ feat: 模组、资源包、光影包、世界、整合包的更新日志 Nov 22, 2025

Calboot added 2 commits November 23, 2025 11:37

update

d351523

Merge branch 'HMCL-dev:main' into mod-changelog

8fed3b7

Calboot changed the title ~~feat: 模组、资源包、光影包、世界、整合包的更新日志~~ [Feature]: 模组、资源包、光影包、世界、整合包的更新日志 Nov 25, 2025

Calboot changed the title ~~[Feature]: 模组、资源包、光影包、世界、整合包的更新日志~~ [Feature] 模组、资源包、光影包、世界、整合包的更新日志 Nov 25, 2025

Merge remote-tracking branch 'upstream/main' into mod-changelog

36c6661

Calboot force-pushed the mod-changelog branch from cfa9377 to 36c6661 Compare November 30, 2025 10:22

Calboot added 4 commits November 30, 2025 18:27

update

cb3fc84

update

998c6d1

update

c9c7ea5

Calboot force-pushed the mod-changelog branch from 552a13d to c9c7ea5 Compare December 12, 2025 14:24

Calboot added 4 commits December 12, 2025 22:24

Merge remote-tracking branch 'upstream/main' into mod-changelog

f501b79

Merge remote-tracking branch 'upstream/main' into mod-changelog

71b0aae

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/ModUpdatesPage.java

update

0973c76

HTML support & changelog cache

50a2aeb

Calboot marked this pull request as draft December 13, 2025 06:43

Markdown

e3f05fb

Calboot marked this pull request as ready for review December 13, 2025 07:03

Calboot added 4 commits February 20, 2026 11:57

update

9dbe318

Merge branch 'main' into mod-changelog

d136794

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java

优化UI

9e79b06

Merge branch 'main' into mod-changelog

72a5252

Glavo reviewed Mar 12, 2026

View reviewed changes

Calboot added 7 commits March 13, 2026 16:50

Merge branch 'main' into mod-changelog

91f041c

update

8bab4a9

Merge branch 'main' into mod-changelog

af5105b

Merge branch 'main' into mod-changelog

32d5acd

# Conflicts: # HMCLCore/build.gradle.kts

Merge remote-tracking branch 'upstream/main' into mod-changelog

1006714

# Conflicts: # HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/DownloadPage.java # HMCL/src/main/resources/assets/css/root.css

Merge remote-tracking branch 'upstream/main' into mod-changelog

56a47d0

update

917d7d9

chatgpt-codex-connector bot reviewed Apr 3, 2026

View reviewed changes

Calboot added 2 commits April 3, 2026 21:33

apply suggestions

33a5fea

Merge remote-tracking branch 'upstream/main' into mod-changelog

5bd6339

# Conflicts: # HMCL/src/main/resources/assets/about/deps.json

gemini-code-assist bot reviewed Apr 3, 2026

View reviewed changes

3gf8jv4dv mentioned this pull request Apr 3, 2026

feat: 添加自定义标题栏设置 #5653

Closed

Calboot added 4 commits April 4, 2026 17:49

update code block

e5c49c8

fix html detector

cdb2a6c

enhance table

3e1fbe2

Merge remote-tracking branch 'upstream/main' into mod-changelog

fe51c99

3gf8jv4dv mentioned this pull request Apr 5, 2026

HTMLRenderer 支持嵌套列表 #5912

Open

Calboot added 3 commits April 5, 2026 14:10

update css

b62d8e3

Revert "update css"

571ab99

This reverts commit b62d8e3.

update css

96e07cf

Glavo reviewed Apr 5, 2026

View reviewed changes

remove optional & cache

f156e88

Conversation

Calboot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Calboot commented Nov 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Calboot commented Dec 13, 2025

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Calboot Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

3gf8jv4dv commented Apr 1, 2026

Uh oh!

Glavo commented Apr 3, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Glavo commented Apr 3, 2026

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Calboot commented Nov 19, 2025 •

edited

Loading

Calboot commented Nov 21, 2025 •

edited

Loading

Calboot Mar 30, 2026 •

edited

Loading