角色與登場名單

人設和角色是兩件事：

• 人設是帳號的聲音。一個帳號一個人設。
• 角色是世界裡會登場的人物，屬於組織（可以限定一個專案）。每個角色有組織內唯一的代號（例如 AB-01）、名字、一句話介紹，完整設定放在知識庫條目。

每個人設有一份登場名單（cast）：這個人設的帳號可以出現哪些角色。名單由 Agency 在人設頁管理，畫面說明見 角色。

讀登場名單#

get_persona 回傳的 cast 就是登場名單；只要名單時用 list_cast（GET /personas/{code}/cast）。

{ "code": "TW-T014", "persona": "小雨",
  "cast": [ { "code": "AB-01", "name": "阿布", "summary": "住在咖啡廳的橘貓",
              "wiki_entry_id": "…", "wiki_title": "角色 AB-01 阿布",
              "images": [ { "id": "…", "category": "turnaround", "caption": "三視圖", "mime_type": "image/png", "url": "https://…" } ] } ],
  "images_expire_in_seconds": 900 }

• images 是這個角色已核可或已發布的參考圖，不論是哪個人設上傳的都算。每個角色最多 6 張，新的在前。
• 參考圖連結 15 分鐘有效，需要時再讀一次。
• 封存的角色不會列出。

挑今天的主角#

1. 從名單挑一個主角。輪流，不要連續幾天都是同一個；看 recent_posts 誰最近出現過。
2. 用 wiki_get 帶 wiki_entry_id 讀它的知識庫條目。
3. 生圖前下載它的 images 當參考：長相、配色、比例照參考圖與條目。沒有參考圖就照條目文字，並在 note 說明「無參考圖」。
4. 條目沒寫的設定不要自己發明。

交稿時帶角色#

submit_draft 與 update_draft 都收 characters：

{ "code": "TW-T014", "body": "完整內文",
  "characters": [ { "code": "AB-01", "pov": true }, { "code": "AB-02" } ],
  "request_id": "run-20261005-1-TW-T014-1" }

• 依主次排序，主角放第一個。一篇最多 6 個。
• pov: true：內文是用這個角色的視角寫的（第一人稱是那個角色，不是帳號本身）。一篇最多一個。帳號用自己的口氣介紹角色時不設 pov。
• 代號不分大小寫。
• 給了就整組取代；[] 是清掉；沒給就不動。
• 同內文重送（duplicate: true）也會套到原本那篇。
• 只限草稿或內部審稿中的稿。回傳的 draft.characters 是存好的結果。

存稿前先檢查#

系統在寫入任何東西之前先檢查角色。名單外的代號、重複的代號、兩個 pov，都回 400 invalid_request，訊息會列出不認得的代號與目前的名單，整篇稿什麼都不寫。照訊息改好再送。

圖片上的角色#

• 貼文用的圖：create_upload 可以帶 character，補進稿時會把角色標在那張圖上。
• 角色的參考圖（定裝、三視圖）：交 upload_persona_image 並帶 character。這是草稿圖，核可後才會出現在名單的 images。
• 同一張圖重送時帶 character 會補上標記。

詳見 圖片上傳與順序。

審稿頁怎麼顯示#

• 審稿頁每篇顯示登場角色，視角角色標「視角：名字」。
• 客戶看得到自己看得到的貼文上有哪些角色。
• list_redo 與 list_approved 每篇都有 characters: [{ code, name, pov }]。