> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acondawayuno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Links: Share Direct Links to Portfolio Chapters

> Every chapter in The Living Index has a shareable URL. Use section and lang query params to link directly to any portfolio chapter in Chinese or English.

每个当前启用的交互章节都有可分享 URL。`section` 可以指向启用的内置 ID，也可以指向 interactive 自定义资产的 `custom-*` ID。

Every currently enabled interactive chapter has a shareable URL. `section` may target an enabled built-in ID or an interactive custom asset's `custom-*` ID.

***

## URL 格式 / URL Format

深链接使用查询参数，不使用独立的页面路径。这让所有当前启用的交互章节都可以从同一个单页入口直接访问，刷新或分享后仍能恢复状态。

Deep links use query parameters, not separate page paths. This lets every currently enabled interactive chapter use the same single-page entry point, with state restored on refresh or when a shared link is opened.

```text theme={null}
/?section=<assetId>
/?lang=en&section=<assetId>
/?lang=zh&section=<assetId>
```

***

## 完整章节 ID 列表 / Complete List of Section IDs

以下是 12 个默认内置章节 ID：

These are the 12 default built-in section IDs:

| 章节 ID / Section ID | 房间资产 / Room Asset                            | 代表特质 / Trait                                      |
| ------------------ | -------------------------------------------- | ------------------------------------------------- |
| `music`            | 留声机与唱片 / Gramophone & Records                | 情绪感知、音乐创造 / Emotional awareness, music creation   |
| `fitness`          | 哑铃、壶铃与瑜伽垫 / Dumbbells, Kettlebell & Yoga Mat | 自律、身体意识 / Discipline, body awareness              |
| `reading`          | 书架与边注书籍 / Bookshelf & Annotated Books        | 阅读、吸收、观点形成 / Reading, synthesis, perspective      |
| `research`         | 研究桌与电脑 / Research Desk & Computer            | 研究能力、问题解决 / Research, problem-solving             |
| `making`           | 原型工作台 / Prototype Workbench                  | 动手能力、迭代意识 / Hands-on making, iteration            |
| `photography`      | 相机 / Camera                                  | 观察力、审美取向 / Observation, aesthetic sensibility     |
| `ritual`           | 茶桌与茶具 / Tea Table & Tea Set                  | 仪式感、生活质地 / Ritual, texture of daily life          |
| `growth`           | 植物 / Plant                                   | 耐心、照料、长期主义 / Patience, care, long-term thinking   |
| `about`            | 镜子 / Mirror                                  | 自我认识、价值观 / Self-knowledge, values                 |
| `travel`           | 明信片墙 / Postcard Wall                         | 记忆、归属、感恩 / Memory, belonging, gratitude           |
| `contact`          | 老式电话 / Vintage Phone                         | 开放性、沟通边界 / Openness, communication                |
| `future`           | 尚未开启的门 / Unopened Door                       | 方向、愿望、未完成 / Direction, aspiration, the unfinished |

<Note>
  `scene.disabledCoreAssets` 中的内置 ID 暂时不是有效入口；重新激活后恢复。Interactive 自定义资产使用自己的 `custom-*` ID。Decorative 自定义资产没有详情页或深链接。

  A built-in ID in `scene.disabledCoreAssets` is temporarily unavailable and returns when reactivated. Interactive custom assets use their own `custom-*` IDs. Decorative custom assets have no detail page or deep link.
</Note>

***

## 示例 URL / Example URLs

```text theme={null}
/?section=music
/?lang=en&section=music
/?lang=zh&section=about
/?section=future
/?lang=en&section=reading
/?lang=zh&section=contact
```

***

## 浏览器行为 / Browser Behavior

<CardGroup cols={2}>
  <Card title="刷新恢复 / Refresh Restores" icon="rotate">
    在章节页面刷新浏览器，页面会自动重新打开同一章节，不会回到空房间。

    Refreshing the browser while a chapter is open automatically reopens the same chapter — it does not fall back to an empty room.
  </Card>

  <Card title="返回键返回房间 / Back Button Returns to Room" icon="arrow-left">
    打开章节后，浏览器返回键会关闭内容面板并返回 3D 房间，行为与普通网页导航一致。

    After opening a chapter, the browser back button closes the content panel and returns to the 3D room, behaving like standard web navigation.
  </Card>

  <Card title="Esc 关闭章节 / Esc Closes Chapter" icon="xmark">
    按键盘 `Esc` 键可随时关闭当前打开的章节面板，等同于点击面板右上角的关闭按钮。

    Press `Esc` at any time to close the currently open chapter panel. This is equivalent to clicking the close button in the panel's top-right corner.
  </Card>

  <Card title="链接可分享 / Links Are Shareable" icon="share-nodes">
    你可以直接复制浏览器地址栏中的 URL 分享给他人。接收方打开链接后会直接进入指定章节，无需从房间手动点击进入。

    Copy the URL from your browser's address bar and share it directly. Recipients will open directly to the specified chapter without needing to navigate through the room.
  </Card>
</CardGroup>

***

## 如何使用深链接 / How to Use Deep Links

<Steps>
  <Step title="打开任意章节 / Open Any Chapter">
    在 3D 房间中点击任意资产，内容面板打开后，浏览器地址栏的 URL 会自动更新，加入对应的 `?section=<id>` 参数。

    Click any asset in the 3D room. Once the content panel opens, the browser address bar automatically updates to include the corresponding `?section=<id>` parameter.
  </Step>

  <Step title="复制 URL / Copy the URL">
    直接从地址栏复制 URL。如果需要同时指定语言，可以手动在 URL 中加入 `&lang=en` 或 `&lang=zh`。

    Copy the URL directly from the address bar. If you want to specify a language, manually add `&lang=en` or `&lang=zh` to the URL.
  </Step>

  <Step title="分享链接 / Share the Link">
    将链接粘贴到邮件、消息或任意平台。接收方点击链接后会直接看到指定章节的完整内容。

    Paste the link into an email, message, or any platform. Recipients who click the link will see the specified chapter's full content immediately.
  </Step>
</Steps>

***

## 为什么使用查询参数而非独立路径 / Why Query Parameters Instead of Separate Paths

深链接使用查询参数（`/?section=music`）而非独立页面路径（`/music`），这一设计有以下优势：

Deep links use query parameters (`/?section=music`) rather than separate page paths (`/music`). This design choice has several advantages:

* **无需逐章节配置路由 / No per-chapter routes** — 所有启用的交互章节通过同一入口访问，服务端无需为每个 ID 维护独立路由。/ Every enabled interactive chapter is reached from one entry point, with no server-side route per ID.
* **刷新即可恢复状态 / Refresh restores state** — 不依赖复杂的浏览器历史 API 状态管理。/ Works without complex History API state management.
* **语言参数可直接拼接 / Language parameter composes directly** — 语言与章节可同时指定，例如 `/?lang=en&section=music`。/ Both language and section can be specified in one URL, e.g. `/?lang=en&section=music`.
* **渲染器只初始化一次 / Renderer initializes only once** — 单页入口确保 3D 场景无论打开哪个章节都无需重建。/ The 3D scene is built once regardless of which chapter is opened.

<Tip>
  **面向国际受众分享时，始终在链接中包含语言参数。/ Always include the language parameter when sharing with international audiences.**

  例如，将以下链接分享给英语受众，可以确保他们直接看到英文版的音乐章节，无需手动切换语言：

  For example, share the following link with an English-speaking audience to ensure they land directly on the English version of the music chapter, without needing to manually switch languages:

  ```text theme={null}
  /?lang=en&section=music
  ```

  对于中文受众，使用：

  For Chinese-speaking audiences, use:

  ```text theme={null}
  /?lang=zh&section=music
  ```
</Tip>