使用者與角色

設定

讓家裡的每個人都有自己的帳號，只給他們需要的權限。擁有者和管理員在 Settings > Users and roles（設定 > 使用者與角色）中操作。

邀請某個人

對方開啟連結後，選擇一個不重複的名稱，並設定符合目前最低要求的密碼。之後就會登入。

如果是有年齡限制的孩子，請看兒童帳號。

角色	意思
擁有者	第一個帳號。什麼都能做。在這個畫面上沒有人能變更或關閉它
管理員	在自己的權限範圍內管理成員和媒體庫
成員	通常是請求作品，並查看自己的請求

權限	允許的事	新管理員	新成員
Request titles（請求作品）	提出請求	是	是
Requests approved without waiting（請求不用等待就核准）	請求會略過核准	是	否
Approve or turn down requests（核准或拒絕請求）	決定其他人的請求	是	否
Run the Library（管理媒體庫）	搜尋、整理和管理媒體庫的工作	是	否
Change settings（變更設定）	開啟並變更一般設定	否	否

誰可以授予什麼：

開啟 Settings > Users and roles，選擇那個人。
變更角色或權限。新角色會在你儲存前先勾選它的預設權限。
選用：為電影、影集和音樂設定每週請求額度，每項 0 到 1000。留空會使用 Settings > Request rules（設定 > 請求規則）的預設值；0 代表沒有限制。可以核准請求的人沒有額度限制。
按下 Save（儲存）。

Turn off（停用）會讓這個人在所有地方登出、移除他的 API 金鑰，並封鎖登入，直到你重新開啟。帳號會保留。

這些變更需要用密碼登入。如果你是透過區域網路捷徑進來的，請先用密碼登入。

每個人要為自己的帳號設定。

要建立新的備用代碼，或關閉兩步驟驗證，請輸入目前的 App 代碼，或沒用過的備用代碼。新的代碼會取代舊的。

擁有者在 Settings > Sign-in and security（設定 > 登入與安全性）底下開啟這項。沒有兩步驟驗證的管理員，在設定完成之前只能開啟 My account。成員不受影響。

任何人都可以在 My account > Profile picture（我的帳號 > 大頭貼）設定：JPEG、PNG 或 WebP，最大 5 MB。HolyArrs 會裁切中間的正方形，縮成 256 x 256 像素。按 Remove（移除）會回到彩色的姓名縮寫。

症狀： 邀請連結無法使用。 原因： 它已被使用、已過期或已被收回，或是建立它的人已經不是有效的擁有者或管理員。 解決方式： 建立新的。Invite links（邀請連結）清單會顯示每個連結的狀態；擁有者可以收回任何尚未使用的連結，管理員只能收回自己的。

症狀： 管理員無法勾選某個權限。 原因： 管理員只能授予自己擁有的權限。 解決方式： 請擁有者處理。

症狀： 有人弄丟了驗證器和備用代碼。 原因： 沒有可用來登入的代碼了。 解決方式： 擁有者可以重設管理員或成員的兩步驟驗證；管理員可以重設成員的。那個人會在所有地方登出，用密碼登入後再重新設定。擁有者本人請看忘記密碼；reset-owner 也會關閉擁有者的兩步驟驗證。

大頭貼 API

路由	作用
`PUT /api/v1/account/avatar`	圖片放在 body。回應 `{"avatar": "<address>"}`。超過 5 MB 回應 413，不是 JPEG、PNG 或 WebP 時回應 415
`DELETE /api/v1/account/avatar`	移除你的大頭貼
`GET /api/v1/users/{id}/avatar`	某個人的大頭貼，沒有的話回應 404

GET /api/v1/auth/me 和 GET /api/v1/users 會包含 avatar，沒有的話是 null。變更需要一般的 CSRF header；API 金鑰需要寫入範圍。