Track Third-Party Asset Credits and Licenses in Your Project

How to record third-party model, texture, and media licenses in ASSET_CREDITS.md to stay compliant before publishing The Living Index publicly.

每次你向 The Living Index 加入外部模型、纹理、音乐或图片，都需要在 ASSET_CREDITS.md 中登记一条对应记录。这不只是好习惯——在许多许可证下，这是你发布网站的前提条件。

Every time you add an external model, texture, music file, or image to The Living Index, add a corresponding entry to ASSET_CREDITS.md. This is not just good practice — under many licenses, it is a condition of publishing your site at all.

---

为什么需要记录授权 / Why Licensing Records Matter

The Living Index 在公开部署时，所有 GLB 文件都会通过网络传输到访客浏览器。这意味着”不得让终端用户提取原资产”的付费模型许可，未必天然适合公开 WebGL 页面。保持完整的授权记录可以帮助你：

When The Living Index is deployed publicly, all GLB files are transmitted to visitors’ browsers over the network. This means licences that say “end users may not extract the source asset” may not automatically permit public WebGL delivery. Keeping complete licensing records helps you:

• 明确哪些资产可以合法公开展示 / Know clearly which assets you can legally display publicly
• 在版权问题发生时提供证据 / Have evidence ready if a copyright question arises
• 给项目的合作者和审阅者一份清晰的参考 / Give collaborators and reviewers a clear reference
• 满足 CC-BY 等要求署名许可的条件 / Fulfil attribution requirements for licences like CC-BY

---

每条记录应包含的内容 / What to Record Per Asset

每条授权记录至少应包含以下字段：

Each licence record should include at minimum:

字段 / Field	说明 / Description
资产名称与描述 / Asset name and description	本地文件名及资产用途 / Local filename and what it is used for
来源 URL / Source URL	资产条目页的完整链接 / Full link to the asset listing page
许可类型 / License type	例如 CC0、CC-BY 4.0、Royalty-Free / e.g. CC0, CC-BY 4.0, Royalty-Free
作者/创作者姓名 / Author or creator name	原始创作者的署名信息 / Attribution for the original creator
任何使用限制 / Any usage restrictions	例如”仅限非商业用途”或”不得再分发” / e.g. “non-commercial only” or “no redistribution”
下载日期 / Download date	以便核对将来的许可变更 / So you can check for future licence changes
所做修改 / Modifications made	记录你在 Blender 或其他工具中做的改动 / Record any changes you made in Blender or another tool

---

推荐文件格式 / Recommended File Format

在项目根目录的 ASSET_CREDITS.md 中使用 Markdown 表格记录每一条外部资产：

In your project’s ASSET_CREDITS.md, use a Markdown table to record each external asset:

| 本地文件 | 资产名称 | 作者 | 原始链接 | 许可 | 下载日期 | 所做修改 |
|---|---|---|---|---|---|---|
| models/music/gramophone-v2.glb | Vintage Gramophone | Artist Name | https://example.com/gramophone | CC0 1.0 | 2025-07-23 | 调整比例，合并机身与喇叭网格 / Adjusted proportions, merged body and horn meshes |
| models/shared/wood-floor.jpg | Wood Floor PBR | ambientCG | https://ambientcg.com/wood-floor | CC0 1.0 | 2025-07-23 | 从 4K 缩减至 2K / Resized from 4K to 2K |

同时在本地保存：条目页的 PDF 截图、许可证文本、下载日期记录和（如有）发票或订单号。许可证页面会随时间变化；你需要的是下载时的那份。

Also save locally: a PDF screenshot of the listing page, the licence text, your download date record, and any invoice or order number if applicable. Licence pages change over time — you need the version that was in effect when you downloaded.

---

常见许可类型 / Common Licence Types

了解你使用的每种许可类型意味着什么：

Understand what each licence type means for your use case:

许可 / Licence	允许商用 / Commercial Use	需要署名 / Attribution Required	可再分发 / Can Redistribute	注意事项 / Notes
CC0 1.0	✅	否 / No	✅	公共领域，最无限制 / Public domain, fewest restrictions
CC-BY 4.0	✅	是 / Yes	✅	署名至少包含资产名、作者、原始链接、许可链接和是否修改 / Attribution must include asset name, author, original link, licence link, and whether modified
Royalty-Free	通常 ✅ / Usually ✅	视条款 / Varies	❌	可用于作品但通常禁止独立转售原文件 / Usable in a larger work but typically prohibits redistributing the source file separately
Editorial Only	❌	—	❌	不得用于商业主页或作品集 / Cannot be used in a commercial homepage or portfolio
Standard (Fab/Adobe)	✅	视条款 / Varies	❌	必须作为较大或修改过的作品发布，逐件核对附加条款 / Must be part of a larger or modified work; check per-asset additional terms

“免费下载”不等于”允许商用”。没有明确许可文本的资产一律不使用。CC0 解决版权及类似权利，但不自动清除商标、专利、肖像或实物设计权——带品牌 Logo 的器材、唱片封面、书封和相机外观仍需单独核查。

“Free to download” does not mean “free to use commercially.” Never use an asset without a clear licence text. CC0 resolves copyright and similar rights but does not automatically clear trademarks, patents, portrait rights, or product design rights — branded equipment, album art, book covers, and camera designs still need separate review.

---

推荐免费资产来源 / Recommended Free Asset Sources

以下来源的授权记录清晰，适合个人主页项目：

These sources have clear licensing well-suited to personal homepage projects:

来源 / Source	许可 / Licence	适合用途 / Best For
Poly Haven	CC0	写实家具、灯具、HDRI、PBR 材质 / Realistic furniture, fixtures, HDRIs, PBR materials
Kenney	CC0	轻量家具、模块化房间套件 / Lightweight furniture, modular room kits
Quaternius	CC0	风格统一的低多边形室内道具 / Stylized low-poly interior props
ambientCG	CC0	PBR 地板、墙面、布料、金属 / PBR floors, walls, fabric, metal

Sketchfab 和 CGTrader 上每件资产的许可由各自的创作者独立设定，同一平台内差异极大。始终点开具体资产的许可详情页逐件核查，不要以”平台名称”代替具体许可文本。避免选择带有 NC（非商业）、ND（禁止演绎）或 Editorial Only 标注的资产用于公开作品集。

On Sketchfab and CGTrader, each asset’s licence is set independently by its creator and varies widely within the same platform. Always click through to the individual asset’s licence detail page — never assume a platform-wide licence. Avoid assets labelled NC (non-commercial), ND (no derivatives), or Editorial Only for a public portfolio.

---

Content Studio file lifecycle / Content Studio 文件生命周期

图片与 GLB 使用不同的清理规则：

Images and GLBs use different cleanup rules:

Resource	After selection	After unlink/removal	At Save to project
Profile, photography, card image	Written immediately to public/uploads/*	Reference removed; file remains	JSON reference updates
New GLB	Staged in .content-studio-cache/models	Unshared staged file is discarded	Final references move to public/uploads/models
Previously published GLB	Already in public/uploads/models	Kept until save	Removed only if the previous saved scene referenced it and the next saved scene does not

Studio 的 GLB 清理是“上一份保存引用与下一份保存引用的差集”，不会扫描并删除任意 public 文件。因此不要把手工清空 public/uploads/models 当作常规操作。

Studio GLB cleanup uses the difference between previous and next saved references. It never sweeps arbitrary public files. Do not treat manual deletion of public/uploads/models as the normal workflow.

图片解除引用后可能留下孤儿文件。提交前运行：

Image unlinking can leave orphaned files. Before committing, run:

git status --short

只暂存本次实际使用的图片和最终模型。UUID 文件名不会替代 provenance；请在 ASSET_CREDITS.md 中记录 UUID、本地用途、作者、来源 URL、许可、下载日期和修改。

Stage only images and final models used by the change. A UUID filename does not replace provenance. Map the UUID to its purpose, creator, source URL, licence, download date, and modifications in ASSET_CREDITS.md.

当前仓库是否包含第三方模型必须以实际 tracked files 和 credits 为准。不要在文档中笼统声称“没有外部模型”。每个发布 GLB 都应有可核对的授权记录。

Determine whether the repository contains third-party models from actual tracked files and credits. Do not make a blanket claim that no external models exist. Every published GLB needs a verifiable licence record.

---

CC-BY 署名示例 / CC-BY Attribution Example

如果你使用了 CC-BY 许可的资产，在网站上（例如关于页面或页脚）提供完整署名：

If you use a CC-BY licensed asset, provide full attribution on your site (for example on an about page or footer):

"Gramophone Model" by Artist Name is licensed under CC-BY 4.0.
Original: https://example.com/gramophone
Modifications: Proportions adjusted in Blender.

CC-BY 署名至少需要包含：资产名称、作者姓名、原始链接、许可证链接，以及是否对原文件做出修改。

CC-BY attribution must include at minimum: the asset name, the author’s name, a link to the original, a link to the licence, and whether you modified the file.