Portfolio Assets and Content Cards

Edit the 12 built-in chapters, add interactive custom chapters, and compose text, media, and links cards with bilingual content.

The Living Index 默认提供 12 个内置章节。它们的 TypeScript 数据是模板默认值，Content Studio 把你的个人内容作为 version 1 JSON 覆盖保存。

The Living Index starts with 12 built-in chapters. Their TypeScript data is the template default; Content Studio saves your personal content as version-one JSON overrides.

Default built-in chapters / 默认内置章节

ID	Object
music	Gramophone and records / 留声机与唱片
fitness	Training equipment / 健身器材
reading	Bookshelf / 书架
research	Research desk / 研究桌
making	Workbench / 原型工作台
photography	Camera / 相机
ritual	Tea table / 茶桌
growth	Plant / 植物
about	Mirror / 镜子
travel	Postcard wall / 明信片墙
contact	Telephone / 电话
future	Door / 门

这些章节可以停用、重新激活或只替换视觉。停用不会删除代码定义、内容、placement 或 replacement 配置。

You can disable, reactivate, or visually replace these chapters. Disabling does not delete the code definition, content, placement, or replacement configuration.

Edit through Content Studio / 通过 Studio 编辑

1. Open local /?studio=1.
2. Select Digital assets.
3. Choose Chinese or English.
4. Select a built-in or interactive custom asset.
5. Edit overview fields, metrics, and cards.
6. Click Save to project.

共享的 scene transform 与 behavior 不随语言切换。互动内容存放在对应语言容器中。

Shared scene transforms and behavior do not change with locale. Interactive content lives in the matching language container.

Chapter fields / 章节字段

Field	Purpose
objectLabel	Short room/index label
sectionTitle	Detail-page heading
trait	Defining statement
teaser	Short preview
intro	Main chapter introduction
status	Current state
lastUpdated	Displayed update label
metrics	Up to 12 value/label pairs
entries	Up to 24 content cards
note	Closing note

Content cards / 内容卡片

Every built-in chapter and interactive custom asset uses the same card model:

interface PortfolioEntry {
  id?: string;
  kind?: "text" | "media" | "links";
  width?: "standard" | "wide" | "full";
  eyebrow: string;
  title: string;
  body: string;
  meta: string;
  imageSrc?: string;
  imageAlt?: string;
  links?: Array<{
    label: string;
    url: string;
  }>;
}

Text

适合项目说明、经历、观点和短篇叙述。

Best for project notes, experience, ideas, and short narratives.

Media

在文字旁显示 Studio 上传的图片与 alt。

Adds a Studio-uploaded image and alt text to the editorial copy.

Links

每张卡最多包含四个 http、https 或 mailto 按钮。

Includes up to four http, https, or mailto buttons.

width controls layout emphasis:

• standard: normal grid card;
• wide: wider editorial card;
• full: full-row feature.

Mirror / About

The about chapter uses:

• intro as the personal bio;
• one shared portrait source;
• localized portrait alt text;
• up to 12 social links.

Supported social platforms include GitHub, LinkedIn, Instagram, X, YouTube, Bilibili, Weibo, Website, and Email. The page renders the corresponding icon automatically.

镜子页自动排版简介、个人照片和带平台 Logo 的链接按钮。

Camera / Photography

Photography entries use stable IDs shared between Chinese and English. The ID connects:

localized entry
  ↕ same id
media.photography.sources[id]
  ↕
media.photography.spotlightId

Every photo remains in the gallery. Clicking one opens an instant-photo dialog with its description. Spotlight places one photo first and gives it a larger visual plus dedicated copy column.

所有照片都会保留在画廊。Spotlight 只是突出其中一张，而不是替代其他照片。

Interactive custom assets / 自定义交互资产

An interactive custom asset stores localized content in:

scene.customAssets[].content.zh
scene.customAssets[].content.en

It receives a semantic-index entry, deep link, detail page, hover/click interaction, and derived camera focus. Decorative assets intentionally receive none of these.

Interactive 自定义资产会获得索引、深链接、详情页和键盘路径；decorative 资产不会。

Direct TypeScript editing / 直接编辑 TypeScript

Use app/portfolio-data.ts and app/portfolio-data-en.ts when you are changing reusable framework defaults. Use Content Studio for personal overrides.

修改框架模板默认值时编辑 TypeScript；个人内容优先使用 Content Studio。

JSON export/import does not contain uploaded image or GLB binaries. Import locally, restore referenced files, then use Save to project so the generated scene snapshot stays synchronized.

JSON 导入/导出不包含图片或 GLB。迁移后必须在本地再次保存，保持生成场景源码同步。