update

.workbuddy/memory/MEMORY.md

@@ -28,6 +28,11 @@
 - **正确做法**：用 `w-full`（强制 100% 父容器，常配 `max-w-[xxx]`），或 `w-full mx-auto`（保留大屏居中）。
 - 适用范围：所有 Layout 内的页内根容器（包括 showsroot / blogs / about 等），**避免 `m-auto` 单独使用**。
 
+## Astro frontmatter 与 `<script>` 作用域隔离（通用坑）
+- **frontmatter 里的 `import` / 变量，在 `<script>`（客户端打包脚本）里拿不到**。两者是分别打包的：frontmatter 是服务端渲染期，`<script>` 是独立客户端 bundle。脚本里直接用 frontmatter 引的 `ROUTES` / `clientHref` 等，esbuild 不报错（当全局变量），但 **TS 语言服务报 `ts(2304) 找不到名称`**，运行时更是 `ReferenceError`。
+- **正确做法**：脚本里要用什么，就在该 `<script>` 顶部重新 `import`。例：`import { clientHref, ROUTES } from "@/lib/routes"`。
+- 排查方法：在 `<script>` 块里 `import` 行 grep，确认用到的标识符都已在脚本作用域内 import。本仓库曾在 RunwayLooks.astro、pages/shows.astro、pages/cn/shows.astro 三处脚本用了 `clientHref`/`ROUTES` 却只在 frontmatter import，统一补 import 修复（2026-08-24）。
+
 ## i18n 脚本内翻译陷阱（2026-08-23 踩坑）
 - **Astro 对「打包型 `<script>`（module）不做 `{...}` 模板插值**。若在前端 `<script>` 里写 `slot.innerHTML = \`...{t('Hi')}...\``，构建后 `t('Hi')` 会原样留存在打包 JS 中 → 运行时 `t is not defined` 报错、脚本中断。
 - **正确做法**：在 frontmatter 用 `const hiLabel = t('Hi')` 预翻译，再用 `<script define:vars={{ hiLabel, logoutLabel }}>` 把字符串注入脚本，脚本内用 `${hiLabel}` 引用。define:vars 会把 `const hiLabel="..."` 注入到该 page 的脚本作用域（en 得英文、cn 得中文）。