Issues

• eslint 把 any 定为 warning，而 pre-commit 钩子把 staged 文件的 warning 当 error —— 两处配置各自都对，合起来矛盾

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#51 · Filter by author SongshGeo opened on Sep 10, 2026

• 测试结构：npm run test:e2e 从不被执行，而无测试的恰是仓库自己认定最脆弱的那几个模块

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#50 · Filter by author SongshGeo opened on Sep 10, 2026
  1

• 站点 URL 没有单一来源：19 处手写 /${lang}/… 散在 14 个文件，React 侧还有一份从未执行的兜底实现

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#49 · Filter by author SongshGeo opened on Sep 10, 2026
  1

• src/utils/ 里 1,373 行 .js 不受类型检查，而 .js/.ts 的分界线已经名存实亡（并带来一条未声明的 Node ≥22.18 依赖）

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#48 · Filter by author SongshGeo opened on Sep 10, 2026
  2

• 路由层缺少「本地化条目」这层深模块：同一段装配在五个详情页 + 三处列表映射里各写一遍

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#47 · Filter by author SongshGeo opened on Sep 10, 2026
  1

• src/utils/ 是杂物抽屉：四类互不相关的职责挤在一个命名空间，含 387 行只有 scripts 用的构建工具

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#46 · Filter by author SongshGeo opened on Sep 10, 2026
  1

• src/content/ 的六个软链是 content.config.ts 自己证明不需要的：为它们付出了 320 行、两处 ignore 和第五份目录映射

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#45 · Filter by author SongshGeo opened on Sep 10, 2026
  1

• migrate-bundles 的 dry-run 不显示 source_sha 补写

  bug
  SongshGeoLab/Team-Guidebook-Frontend#44 · Filter by author SongshGeo opened on Aug 15, 2026

• about 页面重复扫描 translations 集合

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#43 · Filter by author SongshGeo opened on Aug 15, 2026

• i18n 收口留下的重复与死代码：OVERLAY_META、sidecar 目录、isFallback、resolveLocalized

  tech-debt
  SongshGeoLab/Team-Guidebook-Frontend#42 · Filter by author SongshGeo opened on Aug 15, 2026
  1

• 三个词条 fixture 仍是「中文基准文件里写英文正文」

  bug
  SongshGeoLab/Team-Guidebook-Frontend#41 · Filter by author SongshGeo opened on Aug 15, 2026

• entrySlug 未实现 bundle 的 /README 兜底剥离

  bug
  SongshGeoLab/Team-Guidebook-Frontend#40 · Filter by author SongshGeo opened on Aug 15, 2026

• bundle 文件夹名与 id 一致性检查漏掉 sidecar 和无 id 条目

  bug
  SongshGeoLab/Team-Guidebook-Frontend#39 · Filter by author SongshGeo opened on Aug 15, 2026

• check:content 的 _en 弃用扫描有盲区：library、site.md 与嵌套字段

  bugtech-debt
  SongshGeoLab/Team-Guidebook-Frontend#38 · Filter by author SongshGeo opened on Aug 15, 2026

• docs(FRONTEND_GUIDELINES): §1.1 与 §4.3 仍在描述已被取代的 i18n 机制

  documentationtech-debt
  SongshGeoLab/Team-Guidebook-Frontend#37 · Filter by author SongshGeo opened on Aug 15, 2026

• Brief repaint on every navigation, because each page load discards and rebuilds the backdrop

  SongshGeoLab/Team-Guidebook-Frontend#36 · Filter by author SongshGeo opened on Aug 15, 2026

• Ripple shader renders the backdrop ~13% darker than the static image, so the handover is a visible step

  SongshGeoLab/Team-Guidebook-Frontend#34 · Filter by author SongshGeo opened on Aug 15, 2026

• Black flash on every navigation: the WebGL canvas paints opaque black over the static backdrop while its texture loads

  SongshGeoLab/Team-Guidebook-Frontend#33 · Filter by author SongshGeo opened on Aug 15, 2026
  1

• [P4] i18n 字典未收编组件层：两个残留 TEXT 字典与 22 处内联三元

  enhancementtech-debt
  SongshGeoLab/Team-Guidebook-Frontend#32 · Filter by author SongshGeo opened on Aug 14, 2026

• [P3] 自定义 loader 在 dev 下无法热更新：改内容仍需重启服务

  enhancement
  SongshGeoLab/Team-Guidebook-Frontend#31 · Filter by author SongshGeo opened on Aug 14, 2026

• [P0] 内容仓库已重组并引入 content.manifest.yaml 契约，前端需按其重写路径映射与发布语义

  bug
  SongshGeoLab/Team-Guidebook-Frontend#30 · Filter by author SongshGeo opened on Aug 14, 2026