Bilingual Support: Chinese and English in One Homepage

Switch The Living Index between Chinese and English using the lang query param or the UI toggle. Language preference is saved to localStorage and URL.

The Living Index 原生支持中英文双语界面。你可以通过页面右上角的语言切换按钮或 URL 查询参数在两种语言之间随时切换，语言偏好会保存到本地存储，刷新页面或分享链接后都能自动恢复。

The Living Index natively supports both Chinese and English. You can switch between the two languages at any time using the language toggle button in the top-right corner of every page, or via a URL query parameter. Your language preference is saved to local storage and automatically restored on refresh or when someone opens a shared link.

---

默认语言与切换方式 / Default Language and How to Switch

默认语言为中文（zh-CN）。首次访问时无需任何操作，页面直接以中文显示。

The default language is Chinese (zh-CN). On first visit, no action is needed — the page displays in Chinese immediately.

1. 使用界面按钮 / Use the UI Toggle

   每个页面右上角都有一个 中 / EN 切换按钮，包括首屏、房间 HUD、内容索引、帮助页和每个资产详情页。点击即可在中英文之间切换。

   Every page — including the splash screen, room HUD, content index, help page, and every asset detail page — has a 中 / EN toggle button in the top-right corner. Click it to switch between Chinese and English.

2. 使用 URL 参数 / Use a URL Parameter

   在 URL 中加入 ?lang=zh 或 ?lang=en 可直接指定语言。URL 中的 lang 参数优先级最高，会覆盖本地存储中保存的上次选择。

   Add ?lang=zh or ?lang=en to any URL to specify the language directly. The lang parameter in the URL takes the highest priority and overrides any previously saved preference in local storage.

3. 语言自动保存 / Language Is Saved Automatically

   每次切换语言，新的选择都会自动写入 localStorage。刷新页面或关闭后重新打开，语言偏好都会自动恢复。

   Every time you switch languages, the new choice is automatically written to localStorage. Refreshing the page or closing and reopening it will restore your preference automatically.

---

语言优先级规则 / Language Priority Rules

当多个来源同时存在时，语言按以下优先级决定：

When multiple sources are present simultaneously, the language is determined in this order:

优先级 / Priority	来源 / Source	说明 / Notes
1（最高）/ 1 (Highest)	URL lang 参数 / URL lang param	?lang=en 或 ?lang=zh
2	localStorage 上次选择 / Last saved choice	无 URL 参数时读取 / Read when no URL param
3（默认）/ 3 (Default)	中文 / Chinese	首次访问或存储为空时 / On first visit or empty storage

---

常用 URL 格式 / Common URL Patterns

使用以下 URL 格式打开指定语言，或同时指定语言和内容章节：

Use the following URL formats to open a specific language, or combine language and section in one link:

/?lang=zh
/?lang=en
/?lang=zh&section=music
/?lang=en&section=reading
/?lang=zh&section=about
/?lang=en&section=future

为国际受众分享链接时，始终在 URL 中包含语言参数。/ Always include the language parameter when sharing links with international audiences.

例如，将 /?lang=en&section=music 分享给英语受众，可以确保他们一打开链接就看到英文版本，而无需手动切换语言。

For example, sharing /?lang=en&section=music with an English-speaking audience ensures they see the English version immediately upon opening the link, without needing to manually switch languages.

---

切换语言不会丢失当前状态 / Switching Language Preserves Your Current State

切换语言是一个轻量操作，不会重建 Three.js 渲染器，也不会丢失当前打开的内容章节。

Switching language is a lightweight operation that does not rebuild the Three.js renderer and does not lose your currently open content chapter.

渲染器保持运行 / Renderer Stays Running

3D 房间在语言切换时继续运行，相机位置、场景状态和当前动画全部保留。

The 3D room keeps running during a language switch. Camera position, scene state, and current animations are all preserved.

章节状态保留 / Section State Preserved

如果你在音乐章节时切换语言，内容面板会直接更新为对应语言的文案，不会关闭再重新打开。

If you switch languages while the music chapter is open, the content panel updates to the translated text directly — it does not close and reopen.

相同资产 ID / Same Asset IDs

12 件资产的几何位置、相机焦点和资产 ID 在两种语言中完全一致，深链接在两种语言下都有效。

All 12 assets share identical geometry positions, camera focus points, and asset IDs across both languages. Deep links work in both languages.

独立字体排版 / Separate Typography

英文版使用独立的字体顺序、标题比例和长单词换行规则，中英文各自获得最佳阅读体验。

The English version uses its own font order, heading proportions, and long-word line-breaking rules so both languages get an optimal reading experience.

---

Authoring model / 内容存储模型

内置模板默认值位于 app/portfolio-data.ts 和 app/portfolio-data-en.ts。个人化覆盖写入 public/content/site-content.json：

Built-in defaults live in app/portfolio-data.ts and app/portfolio-data-en.ts. Personal overrides live in public/content/site-content.json:

• profile.zh / profile.en：个人资料文案 / profile copy
• assets.zh / assets.en：内置章节覆盖 / built-in chapter overrides
• scene.customAssets[].content.zh/en：自定义交互资产内容 / custom interactive content
• media、socialLinks 与 scene：共享容器 / shared containers

图片路径、摄影 entry ID、社交平台与 URL、scene transform 和 behavior 在两种语言间共享。Alt、可选社交标签和内容文字按语言编辑。

Image paths, photography entry IDs, social platform and URL, scene transforms, and behavior are shared. Alt text, optional social labels, and editorial copy are localized.

中英文 profile.timezone 应保持同一个真实时区，否则切换语言会同时改变房间光照。

Keep Chinese and English profile.timezone values aligned to the same real timezone. Otherwise switching language also changes room lighting.

---

服务端与客户端行为 / Server-Side and Client-Side Behavior

阶段 / Phase	行为 / Behavior
服务端首屏 / Server first render	使用双语 metadata 渲染，确保社交分享和 SEO 的基本覆盖 / Renders with bilingual metadata for baseline social sharing and SEO coverage
客户端水合 / Client hydration	根据 URL lang 参数或 localStorage 更新页面 lang 属性、标题与描述 / Updates page lang attribute, title, and description based on URL param or localStorage
语言切换 / Language switch	仅更新文案层，Three.js 场景和当前章节状态不受影响 / Updates only the text layer; Three.js scene and current section state are unaffected