怎麼讓名單被讀到

工作人員名單的公開格式　·　v0.1　·　任何人都可以用，不用問我

先講一件事：名單不是作品

「客戶不讓我發片」跟「不能登名單」是兩件事。名單需要的只有片名、客戶、年月、誰做了什麼—— 影片本身可以不公開、可以沒有連結。作品未公開的那一筆，就標成未公開；別人要核對，靠同一個案子上其他人的確認。

所以覆蓋率的天花板不是「有多少片能公開」，是有多少人願意把名單寫成機器讀得到的樣子。下面四層，成本由低到高，做到哪一層都有用。

四層做法

第 0 層

影片說明欄照格式寫

Vimeo、YouTube、IG 貼文的說明欄，一行一個職務。零成本、現在就能做，也是目前這個資料庫唯一的來源。

成本：每支片兩分鐘

第 1 層

自己網站放「看得見的純文字」

作品頁把名單當正文寫出來。不要只放在圖片裡、不要只放 PDF、不要塞在 hover 提示裡—— 那些爬蟲跟 AI 都讀不到。看得見的純文字是所有機器的最大公約數。

成本：改一次版型

第 2 層

同一頁埋 JSON-LD

schema.org 的 VideoObject 加 Role。搜尋引擎吃這個，也讓「攝影指導」這種中文職務有明確結構，不用靠猜。下面的產生器會幫你產好。

成本：貼一段 script

第 3 層

網站根目錄放 `credits.json`

一個檔案列完你所有作品的名單，放在 你的網域/credits.json。任何人的爬蟲一次抓完，不用解析網頁。你只要維護這一個檔。

成本：設定一次，之後只更新一個檔

產生器

把名單貼進來，三種格式一起產好。格式隨便寫——一行一個職務就行，中英文、全形半形、用斜線或直線分隔都認得（跟名冊用的是同一張 141 條職務對照表）。

片名

客戶

製作公司

年月

影片網址　沒公開就留空，會標成「作品未公開」

工作人員名單

credits.json 欄位

欄位	必填	說明
`version`	是	固定 `1`
`studio.name`	是	你的名字或公司名
`studio.base`	—	據點城市。有寫才進得了地區分類
`studio.url`	—	官網
`works[].title`	是	片名
`works[].date`	是	`YYYY-MM` 或 `YYYY-MM-DD`。排序與「近三年」都靠它
`works[].client`	—	客戶。主題判定會用到
`works[].url`	—	作品連結。留空＝作品未公開，名單照收
`works[].public`	—	`false` 表示影片不公開。預設 `true`
`works[].credits[].role`	是	職務。中英文都行，會正規化
`works[].credits[].name`	是	姓名
`works[].credits[].ig`	—	Instagram 帳號，不含 @

欄位只會增加不會改名。多寫的欄位不會被丟掉，讀不懂的會原樣保留。

順便讓 AI 讀得到：`llms.txt`

放在網站根目錄，告訴 AI 爬蟲你的乾淨資料在哪。內容就這麼短：

# 錄人影像 Pezós

> 高雄的影像製作公司。作品的完整工作人員名單以機器可讀格式公開。

## 工作人員名單
- [credits.json](https://你的網域/credits.json)：全部作品的名單，JSON

## 作品
- [作品集](https://你的網域/works)：每頁都有可見的純文字名單與 JSON-LD

這不是規範標準，是這兩年大家自己長出來的慣例。成本兩分鐘，做了沒壞處。

怎麼讓這個名冊收到你

兩條路，選一條就好：

什麼都不用做——只要說明欄有名單，被搜到就會進來。
給我一個 credits.json 的網址——之後你更新那個檔，這邊就會跟著更新，不需要再通知我，也不需要我來爬你。

你的 credits.json 網址

你是誰　公司名或你的名字

登記之後你更新自己那個檔，這邊就會跟著更新，不需要再通知我，也不需要我來爬你。

要下架、要改、要匿名，都可以，不需要理由。你的資料，最後一句話是你的。
聯絡：alignediosapp@gmail.com

授權

這個格式：CC0——公眾領域，拿去用不用問我，不用標示出處，也可以拿去蓋你自己的資料庫。
資料：CC BY——可自由複製、重製、商用，標示來源即可。
程式：MIT。

會這樣訂，是因為一個名冊如果只能有一個，它遲早會變成收租的。格式公開、資料可帶走、可以有第二個第三個——它才會是公共財，不是誰的平台。