sunbigfly · HxZou · Jul 28, 2026
diff --git a/dist/awesome-linuxdo-reader.build.json b/dist/awesome-linuxdo-reader.build.json
@@ -2,18 +2,18 @@
   "schemaVersion": 1,
   "source": {
     "path": "work/main.js",
-    "bytes": 1817184,
-    "sha256": "4068430857320cc01f6466b46b3544a72b5f889a9eae24cff60fa772d6c2ffac"
+    "bytes": 1880144,
+    "sha256": "d54147448ed6c2105c86d4454af4c58fd093394e1dc91fcd05e5a32664ecfa9b"
   },
   "metadata": {
-    "bytes": 2810,
-    "sha256": "40e714a6105f6803b6fad8a2f7e68ae4c7dff952d4b718ac3d0c0cdd10c27cfa"
+    "bytes": 2859,
+    "sha256": "d10e067d36c84712b9151877ba81c186250e212a2a671a0792dba175ceb531fe"
   },
   "artifact": {
     "path": "dist/awesome-linuxdo-reader.user.js",
-    "bytes": 963590,
-    "gzipBytes": 324687,
-    "sha256": "d66868fec40828ae46aa5fa076a3ffa9548e44bc12c0b7bced2d8f0b1e0a6d19"
+    "bytes": 974395,
+    "gzipBytes": 327816,
+    "sha256": "3bdc2133c7246819505756d99bb12d34ae6b96504babbfe278aa30581ea3052f"
   },
   "compiler": {
     "name": "esbuild",

diff --git a/dist/awesome-linuxdo-reader.user.js b/dist/awesome-linuxdo-reader.user.js
diff --git a/docs/guide/thread-context.md b/docs/guide/thread-context.md
@@ -1,8 +1,8 @@
 ---
 title: 二级回复、完整讨论与上下文
-description: 理解父回复预览、二级回复分页、完整讨论窗口、楼层收纳和已解决答案。
-feature_ids: ["READ-003", "READ-008", "READ-012", "READ-015"]
-source_anchors: ["SUB_REPLY_PAGE_SIZE", "loadReaderQuotedPost", "focusLiveNestedReply", "openDescendantRepliesWindow", "captureReaderAnchorState", "syncHiddenReplyRun", "renderSolvedAnswerCard"]
+description: 理解父回复预览、有界树状楼中楼、完整讨论窗口、楼层收纳和已解决答案。
+feature_ids: ["READ-003", "READ-008", "READ-012", "READ-015", "SET-018"]
+source_anchors: ["SUB_REPLY_PAGE_SIZE", "inlineReplyTreeMaxDepth", "loadReaderQuotedPost", "focusLiveNestedReply", "openDescendantRepliesWindow", "captureReaderAnchorState", "syncHiddenReplyRun", "renderSolvedAnswerCard"]
 since: 0.1.2
 version: 0.1.16
 status: current
@@ -12,7 +12,7 @@ screenshots: ["/screenshots/guide-18-thread-context.png", "/screenshots/guide-20
 
 # 二级回复、完整讨论与上下文
 
-LINUX DO 的回复既有正式楼层号，也可能属于某个父楼层的直属讨论。阅读器同时保留这两种关系。
+LINUX DO 的回复既有正式楼层号，也可能属于某个父楼层的直属或更深层讨论。阅读器同时保留这两种关系，并可在主信息流内按设置展示有界树状嵌套。
 
 ## 父回复预览
 
@@ -25,18 +25,24 @@ LINUX DO 的回复既有正式楼层号，也可能属于某个父楼层的直
 
 ![父楼层、直属回复、关系线和正式楼层同时保留](/screenshots/guide-18-thread-context.png)
 
-<p class="image-caption">父楼层下方的缩进区域表示直属讨论；点击引用或父回复提示查看来源，点击楼层号跳到它在主信息流中的正式位置。</p>
+<p class="image-caption">父楼层下方的缩进区域表示直属讨论；开启树状评论后，更深回复可继续嵌套在对应父回复下。点击引用或父回复提示查看来源，点击楼层号跳到它在主信息流中的正式位置。</p>
 
-## 父回复下的二级回复
+## 父回复下的楼中楼
 
-当前版本默认先在父回复下预览 2 条直接回复；不存在更深层分支时最多显示 5 条。父楼层接近屏幕后才加载首批内容，后续数据继续服从共享请求调度。
+父楼层接近屏幕后才加载首批直属回复，后续数据继续服从共享请求调度。
 
-“设置 → 帖子与回复 → 二级回复显示位置”控制三个关联行为：
+未启用树状评论时，行为与此前一致：默认先在父回复下预览少量直接回复；分支较短时最多显示约 5 条，较长或含后续分支时配合「完整讨论」入口。启用树状评论后，主信息流可在直属回复下继续嵌套展示更深层回复，深度由设置限制。
 
-- **在父回复下展开二级回复**：直接显示父回复收到的回复。
-- **启用“完整讨论”视图**：分支较长或包含后续回复时显示“查看完整讨论”。
+“设置 → 帖子与回复 → 二级回复显示位置”控制这些关联行为：
+
+- **在父回复下展开二级回复**：直接显示父回复收到的回复。关闭时树状评论不可用，主信息流按单层直属处理。
+- **启用树状评论**：在二级回复下继续嵌套展示更深层回复。仅当「在父回复下展开二级回复」开启时可用。
+- **树状嵌套层数**：2–5 层可选（默认 3）。从主楼下的直属回复起算；超出深度的分支仍可通过「完整讨论」阅读。
+- **启用“完整讨论”视图**：分支较长、含后续回复或超出内联深度时显示「查看完整讨论」。
 - **从楼层列表隐藏二级回复**：把二级回复固定收纳到对应父楼层，避免正文列表重复。
 
+更深一层默认折叠，需要时再展开，以控制 DOM 体积。接口返回的直属回复为空时，阅读器会去掉误标的「展开 N 条回复」入口，而不是留下空壳。
+
 楼层列表中的连续二级回复会折叠为一条细分隔标记。展开标记可查看参与者头像，点击头像会直接打开该回复所属的完整讨论。如果折叠段正好位于主题末尾，阅读器会同时移除其后的空高度占位，避免尾部出现无法解释的大块空白。
 
 ## 完整讨论窗口
@@ -46,7 +52,7 @@ LINUX DO 的回复既有正式楼层号，也可能属于某个父楼层的直
 1. 按真实父子关系加载当前回复的全部后续分支，不只显示直属回复。
 2. 点击分支按钮可把某条回复设为新的讨论根，并显示从根到目标的关系路径；标题栏左侧按钮和 `Esc` 会先逐级返回上一个分支，回到入口层后才关闭窗口。
 3. 窗口记录大小、位置、各分支阅读位置和已经打开过的分支；再次进入时优先恢复。
-4. 从消息、历史、时间轴、队列或隐藏头像跳到二级回复时，阅读器会先打开对应讨论，再定位并高亮目标。
+4. 从消息、历史、时间轴、队列或隐藏头像跳到二级或更深层回复时，阅读器会优先进入对应讨论或沿主信息流树路径展开，再定位并高亮目标。
 5. 实时收到的新回复会合并到已打开的分支；点赞、回应、Boost、回复和父回复预览仍可使用。
 6. 按 `Esc` 先关闭预览或返回上一层分支，再关闭完整讨论，不会直接退出整个阅读器。
 
@@ -60,7 +66,7 @@ LINUX DO 的回复既有正式楼层号，也可能属于某个父楼层的直
 
 ![展开后的楼中楼、关系线、回应和回复入口](/screenshots/guide-20-community-actions.png)
 
-<p class="image-caption">截图展示二级回复中的原生互动入口；完整讨论窗口、精确位置恢复和隐藏回复标记以当前脚本实际界面为准。</p>
+<p class="image-caption">截图展示楼中楼中的原生互动入口；树状嵌套、完整讨论窗口、精确位置恢复和隐藏回复标记以当前脚本实际界面为准。</p>
 
 ## 引用内容
 

diff --git a/docs/public/feature-catalog.json b/docs/public/feature-catalog.json
@@ -168,12 +168,12 @@
     "feature_id": "READ-003",
     "title": "楼中楼分页",
     "category": "阅读与导航",
-    "description": "在父楼层下按需加载直属回复，提供分页与展开策略，并在回复或编辑后刷新和聚焦对应分支。",
-    "source_anchor": "SUB_REPLY_PAGE_SIZE",
+    "description": "在父楼层下按需加载直属回复，支持有界树状嵌套、分页与展开策略，并在回复或编辑后刷新和聚焦对应分支。",
+    "source_anchor": "inlineReplyTreeMaxDepth",
     "since": "0.1.2",
     "version": "0.1.16",
     "status": "current",
-    "last_verified": "2026-07-25",
+    "last_verified": "2026-07-28",
     "screenshots": [
       "assets/screenshots/guide-18-thread-context.png"
     ],
@@ -1377,8 +1377,8 @@
     "feature_id": "SET-018",
     "title": "二级回复展示策略",
     "category": "其他设置",
-    "description": "控制父回复下展开、完整讨论窗口和主楼层列表中的二级回复收纳；主题末尾的连续收纳段会移除无内容的底部占位。",
-    "source_anchor": "expandNestedRepliesByDefault",
+    "description": "控制父回复下展开、树状评论开关与 2–5 层嵌套深度、完整讨论窗口和主楼层列表中的二级回复收纳；主题末尾的连续收纳段会移除无内容的底部占位。",
+    "source_anchor": "inlineReplyTreeMaxDepth",
     "since": "0.1.2",
     "version": "0.1.16",
     "status": "current",

diff --git a/docs/settings/motion-and-other.md b/docs/settings/motion-and-other.md
@@ -2,7 +2,7 @@
 title: 动画、阅读与互动
 description: 配置跳转提示、加载动画、历史导航、退出方式、主帖操作列、完整讨论和 Boost 复制。
 feature_ids: ["READ-007", "READ-014", "ACTION-006", "SET-010", "SET-011", "SET-016", "SET-017", "SET-018", "SET-019"]
-source_anchors: ["historyEdgeTriggerPercent", "JUMP_HIGHLIGHT_SETTING_FIELDS", "BOOST_COPY_SETTING_ROWS", "jumpHighlightPrefsPatch", "READER_LOADING_ANIMATION_KEYS", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "confirmNativeComposerClose", "expandNestedRepliesByDefault", "boostCopyMode"]
+source_anchors: ["historyEdgeTriggerPercent", "JUMP_HIGHLIGHT_SETTING_FIELDS", "BOOST_COPY_SETTING_ROWS", "jumpHighlightPrefsPatch", "READER_LOADING_ANIMATION_KEYS", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "confirmNativeComposerClose", "expandNestedRepliesByDefault", "inlineReplyTreeMaxDepth", "boostCopyMode"]
 since: 0.1.2
 version: 0.1.16
 status: current
@@ -54,11 +54,13 @@ screenshots: ["/screenshots/guide-08-motion-settings.png", "/screenshots/guide-1
 
 ![父楼层下的二级回复和正式楼层展示](/screenshots/guide-18-thread-context.png)
 
-- 在父回复下展开二级回复：展示直接回复。
+- 在父回复下展开二级回复：展示直接回复；关闭时树状评论不可用。
+- 启用树状评论：在二级下继续嵌套更深层回复（需先开启上一开关）。
+- 树状嵌套层数：2–5 层可选，默认 3；超出部分仍可走完整讨论。
 - 启用“完整讨论”视图：递归阅读更深分支并记住窗口位置。
 - 从楼层列表隐藏二级回复：收纳为参与者头像标记，跳转仍可定位。
 
-完整讨论建立在父回复下展开之上；关闭前者时设置中心会同步处理关联开关，避免保留不可达配置。
+完整讨论与树状评论都建立在父回复下展开之上；关闭前者时设置中心会同步处理关联开关，树状入口禁用，避免保留不可达配置。
 
 ## Boost 复制
 

diff --git a/docs/settings/other.md b/docs/settings/other.md
@@ -2,7 +2,7 @@
 title: 阅读、帖子与适用站点
 description: 配置队列入口、历史、退出、主帖操作列、完整讨论、Boost 复制和其他 Discourse 站点。
 feature_ids: ["CORE-006", "CORE-007", "READ-007", "READ-015", "ACTION-006", "ACTION-014", "SET-016", "SET-017", "SET-018", "SET-019", "SET-021"]
-source_anchors: ["CUSTOM_DISCOURSE_SITES_KEY", "readerQueueAlwaysVisibleWhenEmpty", "historyEdgeTriggerPercent", "doubleEscapeToCloseReader", "confirmNativeComposerClose", "syncTopicActionRail", "aggregateDescendantReplies", "openDescendantRepliesWindow", "BOOST_COPY_SETTING_ROWS", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "expandNestedRepliesByDefault", "boostCopyMode"]
+source_anchors: ["CUSTOM_DISCOURSE_SITES_KEY", "readerQueueAlwaysVisibleWhenEmpty", "historyEdgeTriggerPercent", "doubleEscapeToCloseReader", "confirmNativeComposerClose", "syncTopicActionRail", "aggregateDescendantReplies", "openDescendantRepliesWindow", "BOOST_COPY_SETTING_ROWS", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "expandNestedRepliesByDefault", "inlineReplyTreeMaxDepth", "boostCopyMode"]
 since: 0.1.2
 version: 0.1.16
 status: current
@@ -65,11 +65,13 @@ screenshots: ["/screenshots/guide-12-other-features.png", "/screenshots/guide-18
 
 | 设置 | 结果 |
 | --- | --- |
-| 在父回复下展开二级回复 | 直接显示父回复收到的回复 |
+| 在父回复下展开二级回复 | 直接显示父回复收到的回复；关闭时树状评论不可用 |
+| 启用树状评论 | 在二级回复下继续嵌套展示更深层回复；仅当上一开关开启时可用 |
+| 树状嵌套层数 | 2–5 层（默认 3）；仅启用树状评论后显示，超出深度仍可走完整讨论 |
 | 启用“完整讨论”视图 | 长分支提供独立的可拖动、可缩放讨论窗口 |
 | 从楼层列表隐藏二级回复 | 将正式楼层收纳为参与者头像标记，跳转仍可定位 |
 
-完整讨论视图建立在父回复下展开之上。关闭父回复下展开时，设置中心会同步关闭完整讨论；关闭完整讨论时仍可保留普通直属回复分页。
+完整讨论与树状评论都建立在「在父回复下展开二级回复」之上。关闭父回复下展开时，设置中心会同步关闭完整讨论，树状开关禁用且主信息流按单层直属处理；关闭完整讨论时仍可保留普通直属回复与已开启的树状嵌套。
 
 ## Boost 复制
 

diff --git a/docs/settings/reference.md b/docs/settings/reference.md
@@ -2,7 +2,7 @@
 title: 完整设置参考
 description: 汇总全部设置项、范围、默认值、生效时机和数据影响。
 feature_ids: ["SET-012", "SET-013", "SET-014", "SET-015", "SET-016", "SET-017", "SET-018", "SET-019", "SET-020", "SET-021"]
-source_anchors: ["PERFORMANCE_SETTING_GROUPS", "streamOverscanViewports", "nestedPrefetchViewports", "requestMaxConcurrent", "SETTINGS_NAV_GROUPS", "saveAllSettingsDrafts", "readerQueueAlwaysVisibleWhenEmpty", "doubleEscapeToCloseReader", "confirmNativeComposerClose", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "aggregateDescendantReplies", "boostCopyMode"]
+source_anchors: ["PERFORMANCE_SETTING_GROUPS", "streamOverscanViewports", "nestedPrefetchViewports", "requestMaxConcurrent", "SETTINGS_NAV_GROUPS", "saveAllSettingsDrafts", "readerQueueAlwaysVisibleWhenEmpty", "doubleEscapeToCloseReader", "confirmNativeComposerClose", "ldp-history-buttons-always-visible", "openTopicsAtFirstPost", "aggregateDescendantReplies", "inlineReplyTreeMaxDepth", "boostCopyMode"]
 since: 0.1.2
 version: 0.1.16
 status: current
@@ -101,6 +101,8 @@ screenshots: ["/screenshots/guide-02-settings-overview.png", "/screenshots/guide
 | 始终显示主帖操作列 | 开/关 | 开 |
 | 锁定操作列位置 | 开/关 | 关 |
 | 父楼层下展开二级回复 | 开/关 | 开 |
+| 启用树状评论 | 开/关（依赖上一开关） | 开 |
+| 树状嵌套层数 | 2–5 | 3 |
 | 启用“完整讨论”视图 | 开/关 | 开 |
 | 从楼层列表隐藏二级回复 | 开/关 | 开 |
 | Boost 末尾内容 | 数字递增/固定文字 | 数字递增 |