From af0b7ef9891624c9cfbda15e0647cff0b71ee409 Mon Sep 17 00:00:00 2001
From: LaoWang <257199637@qq.com>
Date: Tue, 9 Jun 2026 16:12:05 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20update=20CODEBASE.md=20=E2=80=94=20fix?=
 =?UTF-8?q?=20index.html=20architecture,=20add=20OpenResty=20cache=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CODEBASE.md | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/CODEBASE.md b/CODEBASE.md
index f86db60..cd2a6bd 100644
--- a/CODEBASE.md
+++ b/CODEBASE.md
@@ -136,8 +136,8 @@
 
 ## ⚠️ 已知问题 & 注意事项
 
-### 1. `index.html` vs `index_template.html` 双胞胎
-两个文件内容几乎相同。`index_template.html` 是早期版本，被 `extract_data.py` 引用但路径硬编码为 `/app/working/workspaces/default/llm_library.html`。**实际服务的是 `index.html`。** 如果改前端 HTML 结构，只需改 `index.html`。
+### 1. `index.html` vs `index_template.html` （2026-06-09 已修复）
+**已修复：** `index.html` 原来包含 286 行内联 JS，导致 `app.js` 的修改完全不生效。已改为 `<script src="/app.js?v=20260609"></script>`，HTML 和 JS 完全分离。`index_template.html` 保持为早期模板（也引用外部 script），用于备用。
 
 ### 2. MyMemory 免费翻译 vs pdf2zh
 `GET /api/translate/{arxiv_id}` 用的是 MyMemory 免费 API（质量一般），而真正的翻译是通过 `POST /api/translate/{paper_id}` 触发 pdf2zh + DeepSeek（生成中文 PDF）。两者是不同的翻译通道，不要混淆。
@@ -151,7 +151,12 @@
 ### 5. 搜索实现（2026-06-09 已修复）
 搜索已在 2026-06-09 升级为**实时下拉结果面板**。输入 ≥2 字符后，200ms debounce 后调用 `/api/papers?q=`，在下拉面板中显示匹配论文（标题高亮、模块/领域、年份、标签）。卡片同步绿框高亮。点击结果项跳转到对应模块弹窗。点外部或 Escape 关闭。
 
-### 6. 数据一致性
+### 6. OpenResty 缓存问题
+宿主机 Nginx/OpenResty（1Panel 管理，容器名 `1Panel-openresty-mHac`）可能缓存静态文件响应。已通过 FastAPI 中间件添加 `Cache-Control: no-cache, no-store, must-revalidate` 头来阻止。如果仍有缓存问题，运行：
+```bash
+docker restart 1Panel-openresty-mHac
+```
+另外，`app.js` 和 `style.css` 的引用使用了版本号查询参数（`?v=20260609`），修改后递增版本号即可绕过所有缓存。
 `papers.json` 是唯一数据源。新增论文通过 API 写操作 → 自动更新 JSON → 前端下次请求时自动获取最新数据。**不要手动编辑 production 上的 papers.json 绕过 API**，可能导致并发写入问题。
 
 ---