连接 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 会等 —— 最多约两分钟。如果等到时间用完服务器还没忙完，整条帖子就会失败，以 Failed（失败）留在 Queue（队列）里，而不是丢下文件把内容发出去 —— 重新排期，或者换一个更短、更小的版本。
可见性	帖子以公开方式发出。

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]。