本文由 FlintHub 开发文档归档发布。原始文档日期见标题前缀，来源：暂存20260913/thread_show旧摘要链路扫描报告.md。

thread/show 旧摘要链路扫描报告

扫描时间：2026-09-12

扫描范围：app/、cli/、update/

本报告阶段只做扫描，没有修改 ThreadController.php、thread/show.php、modern.css、thread.js、sw.js 或任何核心运行代码。

一、扫描结论

可以进入方案 B + 方案 A 的实施阶段。

当前运行代码中的旧摘要引用

旧摘要链路只存在于以下两个运行时文件：

1. app/Controllers/ThreadController.php
2. app/Views/thread/show.php

cli/ 中没有旧摘要变量引用。

app/Controllers/ApiController.php 不引用：

_threadExcerpt
_threadNeedsExpand
$threadExcerpt
$threadNeedsExpand
Content::excerpt()

Content::excerpt() 函数本身只在当前运行代码的 ThreadController::show() 中被调用。

因此可以：

• 保留 Content::excerpt() 函数本身；
• 删除 ThreadController::show() 中详情页摘要链路调用；
• 删除 thread/show.php 中摘要变量、摘要判断和 htmx 动态正文分支；
• 保留 /api/post/{id}/body 接口，但标记为 deprecated，暂不删除、不改接口权限逻辑。

二、旧变量逐项引用位置

1. _threadExcerpt

2. _threadNeedsExpand

3. $threadExcerpt

4. $threadNeedsExpand

5. thread/show.php 中相关动态分支

当前 update/168/app/Views/thread/show.php 是源文件的旧发布副本，仍包含同一旧链路；实施后需要同步更新。

三、Content::excerpt() 使用情况

当前运行代码

其它模块检查结果

在当前 app/ 全量搜索中，除 ThreadController::show() 外没有发现其它 Content::excerpt() 调用：

• 列表页：没有独立调用；列表摘要使用自己的数据/字段逻辑；
• 博客：没有独立调用；
• 搜索：没有独立调用；
• API：没有独立调用；
• CLI：没有调用。

结论：

Content::excerpt() 函数本身保留。
本次只删除 ThreadController::show() 的详情页调用。

update/ 中存在若干历史增量包副本，例如：

update/60/app/Controllers/ThreadController.php
update/66/app/Controllers/ThreadController.php
update/125/app/Controllers/ThreadController.php
update/135/app/Controllers/ThreadController.php
update/156/app/Controllers/ThreadController.php
update/160/app/Controllers/ThreadController.php
update/166/app/Controllers/ThreadController.php
update/167/app/Controllers/ThreadController.php

这些是历史发布包记录，不是当前运行代码。当前目标发布目录 update/168/ 需要在实施后同步为新版本。

四、/api/post/{id}/body 接口依赖检查

路由

实现

接口内部没有引用：

_threadExcerpt
_threadNeedsExpand
$threadExcerpt
$threadNeedsExpand
Content::excerpt()

结论：

• 接口不依赖详情页摘要变量；
• 接口保留不会影响新折叠逻辑；
• thread/show.php 删除旧 hx-get 后，当前页面不再调用接口；
• 本次不删除接口，因为它可能被外部客户端、旧缓存页面或未来其它页面使用；
• 仅把接口注释标记为 deprecated，说明详情页已经改为服务端全文直出 + Alpine 本地折叠。

五、reply_to_view 隐私逻辑边界

当前详情控制器在 ThreadController.php 约 248–254 行执行：

• reply_to_view 且用户未回复时，只替换主帖正文为锁定提示；
• 回复列表仍然正常展示；
• 锁定状态关闭旧摘要展开。

实施时必须保留这个逻辑，并改成：

• 未授权用户：继续输出锁定提示，不输出可展开全文；
• 已授权用户：输出完整正文，并允许 CSS 折叠 / Alpine 展开；
• 不能把服务端全文直出误用于绕过 reply_to_view 权限。

六、缓存层检查

PageCache

app/Helpers/PageCache.php 只缓存静态 HTML 列表页：

首页 / 版块列表游客缓存

其缓存内容是完整渲染后的 HTML 字符串，不序列化控制器 $data，没有针对：

_threadExcerpt
_threadNeedsExpand

的特殊处理。

ThreadController

ThreadController::show() 没有调用：

PageCache::serve()
PageCache::render()
serialize()

因此帖子详情页不会经过 PageCache，也没有缓存层序列化这两个变量的问题。

全量符号检查

在 app/、cli/、update/ 搜索两个下划线变量后：

• 当前运行代码引用仅为 ThreadController.php + thread/show.php；
• cli/ 无引用；
• update/ 旧历史包有引用，是历史副本，不是独立运行模块；
• update/168/ 有旧发布副本引用，实施后必须同步删除。

七、实施前确认清单

扫描结果满足方案 B 的前置条件：

• [x] Content::excerpt() 没有其它当前运行模块依赖；
• [x] /api/post/{id}/body 不依赖旧摘要变量；
• [x] thread/show.php 旧变量只有主帖摘要链路使用；
• [x] PageCache 不序列化旧变量；
• [x] reply_to_view 逻辑可独立保留；
• [x] 列表页摘要不受影响；
• [x] 可删除详情页 Content::excerpt() 调用及旧变量传参；
• [x] 可把 API 标记为 deprecated 而不删除；
• [x] 可继续按方案 A 增加 CSS + Alpine + htmx 局部翻页。

八、下一步允许的修改范围

用户指定的最终修改范围：

app/Controllers/ThreadController.php
app/Views/thread/show.php
assets/css/modern.css
assets/js/thread.js
sw.js
update/168/ 对应同步副本

不修改：

app/Core/
app/Models/
app/Helpers/
SplitDB/
其它插件
数据库结构

扫描报告完成。等待用户确认本报告后，才执行方案 B + 方案 A 的代码修改。