跳转至

ISSUE-0093:两个独立窗口入口不可达

现象

src/entrypoints/results/(App.tsx + index.html + main.tsx + style.css) 仍在 WXT 的入口列表里、会被打包进扩展产物,但用户没有任何途径打开它。

settings 独立窗口同理,断点在上一环。

证据

① results 窗口:openWindow('results') 零调用

$ grep -rn "openWindow('results')" src/ | grep -vc 'open-windows.ts'
0

定义在 src/utils/open-windows.ts:19-24,全仓库除定义处外没有任何调用点。

🔴 这条链路早就有人发现了,只是没归档: src/sections/content-search/index.tsx:142 的注释原文写着 「唯一发送方在 src/sections/page-results/index.tsx:105 整段已注释」。 也就是说注释掉发送方的那次改动,没有连带处理下游的入口与页面。

② settings 窗口:消息有 handler 无 sender

src/entrypoints/background/index.ts:224   if (type === 'open-page-settings') {
src/entrypoints/background/index.ts:225     await openWindow('settings');

openWindow('settings') 有真实调用,但触发它的 open-page-settings 消息 全仓库只命中这个 handler 自己,没有任何发送方。

为什么现在才发现

不是靠扫描器,是读代码的副产品:为盘点「产品功能矩阵」需要列出用户视角的功能面, 逐个核对入口时撞见的。

现有的 9 个 scanner 都是模式匹配(MV3 陷阱、React 生命周期、空 async、协议孤儿…), scan:protocol-orphan 最接近,但它扫的是消息协议的定义/使用配对, 这两处恰好都「配对完整」——results 是「定义了函数没人调」, settings 是「有 handler 没 sender」,都不落在它的判据里。

影响

  • 打包体积:多一个入口 + 一个 React 页面
  • 认知负担:读代码的人会以为这是活功能
  • 若为它写产品文档,就是为死代码承诺用户行为

严重度低(不影响任何现有功能),但属于「声称即实存」的反向形态: 代码在,功能不在。

处置(待定,本 issue 先只归档不动手)

三选一,需要先确认历史意图: 1. 确认废弃 → 删:移除 entrypoints/results/、page-results/、 openWindow 的 results 分支、open-page-settings handler 2. 本该有入口 → 补:如果当初是想给用户一个独立结果窗口,把发送方接回来 3. 留作未来功能 → 标注:在 open-windows.ts 写明「入口暂缺,见 ISSUE-0093」

🔴 订正(2026-08-31):本 issue 原先的「不建议直接删」理由建立在一处证据误读上

原文写的是:「page-results/index.tsx:105 那段被注释的发送方说明这是有意为之的中间态, 删之前要搞清当初为什么注释掉。」

实测推翻(src/sections/content-search/index.tsx:141-144 原文):

// v0.10.49 ISSUE-0033 Bug K FIX:删 'clear-search-data' 孤儿 listener
//   唯一发送方在 src/sections/page-results/index.tsx:105 整段已注释
//   websiteMessager 同名 schema 也 0 调用 → listener 永远不触发

⇒ page-results/index.tsx:103-107 那段注释的是 onClear 回调里的 clear-search-data 消息发送,说明的是那一个消息类型被弃用 (v0.10.49 修 ISSUE-0033 Bug K 时连带删掉了接收端的孤儿 listener)。 它与「results 窗口该不该存在」无关。 本 issue 把一个关于另一条消息链路的注释, 当成了「results 窗口是有意保留的中间态」的证据 —— 这个推论不成立。

但结论不因此反转:openWindow('results') 当初为什么建、想给谁用, git log --follow src/sections/page-results/index.tsx 只有一条提交 (57248f6 初次提交 v0.10.26,squash 形态)⇒ 考古到此为止,代码里查不出意图。

⇒ 因此处置仍需 Tony 确认历史意图,但理由换成「squash 提交导致意图不可考」, 不再是「那段注释表明有意保留」。在他确认前,方案 3(标注)是零风险默认动作。

📌 这条订正本身是个教训:一处注释提到了某个文件的某一行, 不等于那处注释在讲那个文件的用途。引用他人注释作证据时,要读它在讲哪件事。

回归判据

若选择方案 1(删):

grep -rn "openWindow('results')\|open-page-settings\|PageResultsView" src/ | wc -l   # 期望 0
ls src/entrypoints/results 2>/dev/null | wc -l                                       # 期望 0