From d14dd7e2db80724288e74dc5f7b2eecb1b9c5d93 Mon Sep 17 00:00:00 2001 From: toom1996 Date: Tue, 18 Aug 2026 20:33:56 +0800 Subject: [PATCH] update --- .workbuddy/memory/2026-08-16.md | 2 +- .workbuddy/memory/2026-08-18.md | 49 ++ package-lock.json | 19 +- src/components/Index.astro | 5 +- src/components/RunwayLooks.astro | 862 ++++++++++++++++++++++++++ src/components/pages/article.astro | 320 +++++----- src/lib/data.ts | 9 +- src/pages/article.astro | 21 +- src/pages/cn/article.astro | 21 +- src/pages/en/article.astro | 21 +- src/pages/en/runway-looks/[id].astro | 26 +- src/pages/en/runway-looks/index.astro | 2 +- src/pages/en/shows.astro | 5 +- 13 files changed, 1175 insertions(+), 187 deletions(-) create mode 100644 .workbuddy/memory/2026-08-18.md diff --git a/.workbuddy/memory/2026-08-16.md b/.workbuddy/memory/2026-08-16.md index e71d34f..f90e36e 100644 --- a/.workbuddy/memory/2026-08-16.md +++ b/.workbuddy/memory/2026-08-16.md @@ -1,7 +1,7 @@ # 2026-08-16 ## i18n 取语言方式重构 -- 项目 i18n 已配置（defaultLocale: 'en', locales: ['en','cn'], prefixDefaultLocale: false）。 +- 项目 i18n 已配置（defaultLocale: 'en', locales: ['en','cn']）。**注意：本文件撰写时误记 prefixDefaultLocale 为 false；当前 astro.config.mjs 实际为 `prefixDefaultLocale: true`（见 2026-08-18 记忆）。** - 将 `.astro` 页面里 `getLocaleFromUrl(Astro.url)` 改为 `Astro.currentLocale`（Astro 路由解析，更稳健），并补类型兜底 `(Astro.currentLocale as Locale) ?? DEFAULT_LOCALE`。 - 涉及文件：src/layouts/Layout.astro、src/pages/index.astro、src/pages/cn/index.astro。 - src/i18n/utils.ts 的 `getLocaleFromUrl` 纯函数保留（供 .ts 模块或解析任意 URL 使用）。 diff --git a/.workbuddy/memory/2026-08-18.md b/.workbuddy/memory/2026-08-18.md new file mode 100644 index 0000000..0b8223c --- /dev/null +++ b/.workbuddy/memory/2026-08-18.md @@ -0,0 +1,49 @@ +# 2026-08-18 + +## article 组件改为 SSR（按需服务端渲染） + +- 目标：`src/components/pages/article.astro` 由「浏览器 Alpine fetch 取数（CSR）」改为「服务端渲染 + 灯箱保留 Alpine」。 +- 组件改动：接收 `article: RawArticle | null` 作为 prop，服务端直出标题/品牌/日期/图片网格/正文段落（利于 SEO 与首屏，无 loading 骨架）；图片地址服务端补全绝对路径；灯箱仍是 Alpine 客户端交互，但图片数据由服务端以 `x-data={articleView(${JSON.stringify(images)})}` 注入。`locale` 控制文案（en/cn），`error` 控制服务端错误态（missing/failed）。 +- 页面改动：`pages/article.astro`、`pages/cn/article.astro`、`pages/en/article.astro` 三页均加 `export const prerender = false`，frontmatter 按 `Astro.url.searchParams.get('id')` 调 `fetchArticleById(id, API)` 取数后传给组件。`API = import.meta.env.API_SSR || PUBLIC_API_BASE || http://localhost:8090`。 +- `src/lib/data.ts`：`fetchArticleById(id, apiBase=API_BASE)` 增加 `apiBase` 参数（复用 brands 的 API_SSR 内部地址模式）；`RawArticle` 类型补 `created_at?: number`（组件引用了它）。 +- 验证：`npm run build` 通过（exit 0），article 不再生成静态 html，作为 3 个按需 chunk 进 `dist/server/`；dev 下 `/en/article?id=1`、`/cn/article?id=2` 返回 200，HTML 里可见服务端渲染的错误态文案「加载文章失败，请刷新或稍后再试」与 `articleView([])` 注入（后端离线时 article=null），证明 SSR 生效、不再是浏览器 fetch。 + +## 重要更正：astro.config.mjs 的 prefixDefaultLocale 实际为 true +- 08-16 记忆误记为 `false`；当前 `astro.config.mjs` 实为 `prefixDefaultLocale: true`（routing.prefixDefaultLocale）。 +- 因此**无前缀路由全部 404**：`/article`、`/shows`、`/articles` 都 404，只有 `/en/...`、`/cn/...` 可用。 +- 这导致既存的内部链接（`shows.astro`/`articles.astro`/`Index.astro` 里的 `/article?id=`）点过去是 404——属**既存全局 i18n 路由问题**，非本次 SSR 改动引入（这些无前缀路由在我改之前就 404）。 +- **部署缺口**：当前 `nginx.conf` 只做静态托管 + `/api` 反代；article 现在是按需 SSR 路由，线上需 Node 服务承接，nginx 必须把 `/en/article`、`/cn/article` 等 SSR 路由代理到 Node 服务，否则线上 404。 + +## 修复 swiper TS2307「找不到模块"swiper"或其相应的类型声明」 +- 现象：VS Code 报 `ts(2307)` 找不到模块 `swiper`，但 `package.json` 的 `dependencies` 里已声明 `swiper: "^11.2.10"`。 +- 根因：`node_modules/swiper` **根本不存在**——依赖写进了 package.json 却没真正 install 进 node_modules（疑似此前 `npm install` 未执行 / node_modules 被裁剪）。所以 TS 服务找不到模块与类型声明。 +- 修复：`npm install swiper@^11.2.10`（落盘后 `node_modules/swiper` 完整，版本 11.2.10；`exports` 映射正常：`.`→swiper.mjs/swiper.d.ts，`./modules`→types/modules/index.d.ts，`./css`→swiper.css，`./css/navigation`、`/free-mode`→对应 css）。Index.astro 的 5 行 import 全部可解析。 +- 提醒：若 VS Code 仍报红，执行「TypeScript: Restart TS Server」（Ctrl+Shift+P）或重开文件即可，因 TS 服务可能缓存了旧缺失状态。 + +## 修正：article 面包屑应复用现有 Breadcrumb 组件（非手写） +- **更正**：上一节「article 组件加面包屑」我手写了 `