連接 Mastodon

在您自己的 Mastodon 伺服器上建立一個應用程式，複製一組權杖貼上就好 —— 大約兩分鐘，沒有任何東西要申請。

Mastodon 是最好連的平台。沒有開發者應用程式要註冊，也沒有審核要通過：一切都在您原本就在用的那台 Mastodon 伺服器上完成，就在一個多數人從沒打開過的設定頁面裡。任何相容 Mastodon 的伺服器都適用同一套步驟 —— Mastodon 本身，還有 Pleroma 和 GoToSocial。

您貼上的內容會被加密，而且只留在您自己的 Mac 上。又因為這個應用程式屬於您、放在您自己的伺服器上，它的發文額度也完全屬於您 —— 絕不會和其他 Social Quack 使用者共用配額。

1. 打開伺服器上的 Development 頁面

用瀏覽器登入您的 Mastodon 伺服器。您的伺服器就是帳號代號裡第二個 @ 後面那一段 —— 如果您是 @[email protected]，伺服器就是 mastodon.social。

接著前往 Preferences → Development → New application（偏好設定 → 開發 → 新增應用程式）。

2. 建立應用程式

名字隨您高興 —— 那只是您自己設定頁面裡的一個標籤而已。取「Social Quack」就很好。

勾選這三個 scope（scope 就是您授予的權限）：

Scope	讓 Social Quack 能做什麼
`read`	檢查權杖，並讀出它屬於哪個帳號，好讓頻道上顯示正確的名稱、帳號代號和大頭貼。
`write:statuses`	發布您的貼文，以及串成串文的那些回覆。
`write:media`	上傳您附加在貼文上的圖片。

儲存這個應用程式。

3. 複製存取權杖

打開剛剛建立的應用程式，複製標示為 Your access token（您的存取權杖）的那個值。

請把它當成密碼看待 —— 任何拿到它的人都能以您的身分發文。您需要的就只有它；沒有東西要貼回 Mastodon，沒有網址要註冊，也不必等任何人核准。

在 Social Quack 裡打開 Channels（頻道），在 Add a channel（新增頻道）底下找到 Mastodon，點 Connect（連接）。會出現兩個欄位：

欄位	該填什麼
Instance URL	您伺服器的完整網址，含 `https://` —— 例如 `https://mastodon.social`。結尾多一條斜線也沒關係，Social Quack 會自動整理掉。
Access token	剛剛複製的那組權杖。輸入時會像密碼一樣以遮罩顯示。

點 Connect。Social Quack 會立刻拿權杖去跟您的伺服器核對，接著帳號就會帶著顯示名稱、大頭貼和完整的 @you@your-server 帳號代號出現在頻道清單裡。整個設定就這樣。

5. 發文時會是什麼樣子


長度	每則 500 個字元。
串文	支援。每一段都以回覆前一段的形式發出，讀起來就是真正的串文。
圖片	最多 4 張，附在串文的第一則上 —— 後面幾段以純文字發出。您在 Social Quack 裡寫的替代文字會跟著圖片一起送出。
影片和大型 GIF	您的伺服器得先處理完才能附加，所以 Social Quack 會等 —— 最長約兩分鐘。若時間用完伺服器還在處理，整則貼文就會失敗、落到 Queue 裡的 Failed（失敗），而不是把檔案丟下逕自發出 —— 請重新排程，或改附較短或較小的版本。
可見範圍	貼文以公開形式發出。

Social Quack 會在送出前先把貼文標記為 publishing（發布中），所以排程器絕不可能把同一則貼文發兩次。

如果出了狀況

您看到的訊息	代表什麼	該怎麼辦
一點 Connect 權杖就被拒絕	通常是沒勾 `read` scope，或權杖只複製到一半	到 Preferences → Development 重建一個應用程式，三個 scope 全勾，再一次把 Your access token 完整複製下來
連接失敗，而您只填了 `mastodon.social`	Instance URL 需要完整網址	請填成 `https://mastodon.social` —— 前面要有 `https://`
帳號連得好好的，貼文卻發不出去	這個應用程式少了 `write:statuses`	重建一個三個 scope 都勾好的應用程式，再貼上新的權杖
`Mastodon media upload failed: …`	圖片上傳不了 —— 最常見的是沒勾 `write:media`，或您的伺服器拒收這個檔案	先檢查 scope；如果沒問題，換一張小一點或重新匯出過的圖片試試
`Mastodon media status check failed: …`	您的伺服器處理到一半就停了	再試一次，或改附小一點的影片或 GIF
含影片或大型 GIF 的貼文失敗並顯示 `422`	兩分鐘等待用完時，您的伺服器還在處理這個檔案	重新排程這則貼文，或改附較短或較小的版本
`Mastodon did not return a status id`	伺服器收下了貼文，卻什麼都沒回覆	重試這則貼文；如果一直如此，多半是您的伺服器狀況不好 —— 去看看它的狀態頁
某天突然就發不出去了	這個應用程式在您的伺服器上被撤銷或刪除了	建一個新的、複製新權杖，用同一個伺服器網址再連一次 —— 同一台伺服器上的同一個帳號會就地更新，不會重複新增
您附了超過 4 張圖片	只有前 4 張會送出	把多的移除。圖片一律放在串文的第一段，絕不會放到後面幾段，所以想多發幾張照片，請再排一則貼文

還是卡住？寫信到 [email protected]。