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

[SongshGeo]

每个详情路由都要自己把「这个条目在这个语言下长什么样」重新拼一遍。拼法一样，
拼的人是七个不同的文件。

详情页：同一段前言抄了五遍

people/[slug].astro、projects/[slug].astro、research/[slug].astro、
resources/[slug].astro、publications/[slug].astro 的 getStaticPaths() 开头
都是同一段：

const entries = await getCollection('X', ({ data }) => data.publish !== false);
const { translations, forLocale } = await relationSources();

return LOCALES.flatMap((lang) => {
  const overlays = translationIndex(translations, COLLECTION_VAULT_PATHS.X, lang);
  const relations = forLocale(lang);
  ...

frontmatter 里也是同一段：

const lang = Astro.params.lang as Lang;
const { Content } = await render(overlay ?? entry);
const isFallback = lang !== 'zh' && !overlay;
const data = localizedData(entry.data, overlay?.data, lang);

为了写出这十行，每个页面要 import 六个名字：entrySlug、translationIndex、
localizedData、isMachineTranslated、COLLECTION_VAULT_PATHS、relationSources
（再加 coverFor / personAssets）。六个浅接口拼出一个答案，而这个答案对五个
路由是同一个。

（#42 §3 记的 isFallback 抄了七遍，是这个问题的一个切面。这里说的是整段装配。）

列表页：view model 映射也各写各的

更糟的是列表页对同一个概念用了不同的helper：

• people/index.astro 用 translationIndex + localizedData，映射出 11 个字段的 Person
• projects/index.astro 用 localizedIndex，映射出 4 个字段的 Person
• index.astro（首页）又映射一次 Project

三处都在算 entrySlug(p)、personAssets(data, slug).avatar、
normalizeRole(data.role)、detailUrl。三处都可能少算一个字段——
src/components/react/types.ts 的注释就记着这么一次：「restating is how
Project.summary came to exist here, be rendered by HomePage, and be supplied
by nothing.」

建议

缺的是一层深模块：给它一个 collection 和一个 lang，还回来一个可以直接渲染的
条目。接口小，实现里吃掉 overlay 配对、字段合并、fallback 判定、slug、封面、
URL：

// src/content-layer/localizedEntries.ts
interface LocalizedEntry<T> {
  entry: T;            // 用于 render()
  data: MergedData;    // overlay 覆盖后的 frontmatter
  slug: string;
  href: string;
  cover?: string;
  overlay?: Entry;     // TranslationNotice 自己判断 fallback，不再由页面算
}

// 详情页
const entries = await localizedEntries('research', lang);
// 列表页
const cards = await localizedEntries('people', lang);

判断标准：拆完之后，五个 [slug].astro 的 getStaticPaths 应该只剩「取集合、
配 relations、组 props」，六个 util import 变成一个；三处 view model 映射变成
一处。

依赖顺序：这件事建议排在 src/utils/ 拆分（另一个 issue）之后做，新模块直接
落在 src/content-layer/。

[SongshGeo]

已实现（尚未提交，工作区待审）。

新增 src/domain/localizedPages.ts：

localizedPages("research")  // -> Array<LocalizedPage & { relations }>
// LocalizedPage: { lang, entry, source, overlay, data, slug, href, cover, avatar,
//                  isFallback, isMachineTranslated }

source 是要交给 render() 的那个 entry（有 overlay 用 overlay，没有用基准note），所以路由再也不写 overlay ?? entry。

四个详情页（people / projects / research / resources）重写后：

	之前	之后
import 个数	11–12	6–7
getStaticPaths 前言	10 行 × 4	1 行 × 4
isFallback 手算	每页一次	0
entrySlug / coverFor / personAssets 调用	散在页面里	全在模块内

举例，research/[slug].astro 的开头从

const themes = await getCollection("research", ({ data }) => data.publish !== false);
const { translations, forLocale } = await relationSources();
return LOCALES.flatMap((lang) => {
  const overlays = translationIndex(translations, COLLECTION_VAULT_PATHS.research, lang);
  const relations = forLocale(lang);
  return themes.map((theme) => { ... entrySlug(theme) ... });
});

变成

return (await localizedPages("research")).map(({ lang, slug, relations, ...page }) => { ... });

publications 和 library 故意没有并进来。 论文页要配对两个 entry（sidecar + .bib 记录）并按 citation key 路由，library 按 vault 路径路由。硬塞进来意味着多两个参数、而六个调用方里有四个传 undefined——接口变宽却什么也没换来。这个决定写在模块的文档注释里。我最初写了一个 resolveLocalizedPage 想给 publications 用，发现用不上，已删除而不是留成有注释的死代码。

顺带做掉的（属于 #42）：

• Person.detailUrl / Project.detailUrl / LibraryItem.detailUrl 从可选改成必填，忘了给就 astro check 报错，而不是渲染一个没有 href 的 <a>。Publication.detailUrl 保持可选——没有 sidecar 的论文确实无处可去。
• ProjectsPage 声明 people?: Person[] 但只用 id 和 name，页面于是喂了个 4 字段对象（因为 Person 其余字段全可选，类型系统看不出来）。改成 Array<Pick<Person, "id" | "name">>。
• people/index.astro 里 lang === "zh" ? "zh-CN" : "en-US" 改用 formatDate.localeOf(lang)——那张 BCP 47 表本来就有一份。

验证：全流水线绿；构建出的 46 页的 1051 个链接与全部可见文本与基线完全一致。