EmDash to Buffer Plus
非官方插件，与 Buffer 无关联：把新条目分享到 Buffer，并按各网络调整格式，附带投递追踪和报告。
插件
EmDash to Buffer Plus
非官方插件，与 Buffer 无关联：把新条目分享到 Buffer，并按各网络调整格式，附带投递追踪和报告。
描述
这是一个非官方插件。它与 Buffer 无关联，也未获得 Buffer 的认可或支持。
把新条目分享到你的 Buffer 渠道，并按各网络调整格式，附带投递追踪、互动数据仪表板、编辑器面板和 MCP 工具。
- Buffer API 能发布到的每个网络。 文本会按各网络的字数限制调整，只会缩短描述部分，并且在 Buffer 支持的情况下，每条帖子都会附上条目的图片或链接卡片。
- 可追踪的投递。 每条帖子从你的站点到线上帖子的全过程都会被跟踪。失败的帖子会显示 Buffer 给出的原因并可重试；如果回应不确定，会先到 Buffer 中核对，再决定是否重新发送，因此不会重复发布。
- 报告。 7、30 或 90 天内已发送、排队和失败的帖子，曝光量和互动数据，热门条目，以及每个渠道一张表，按你所在时区的日期统计。缺失的数据会显示为缺失，绝不显示为零。
- 编辑器面板。 在条目首次发送之前，可以排除某个渠道，或为它撰写自定义文本。发送之后，可以查看每个渠道的状态以及线上帖子的链接。
- MCP 工具。 四个只读工具，根据已存储的数据作答。
只有在你安装插件之后首次发布的条目才会被分享，重新发布不会再次发送。
插件使用 Buffer API 和你个人的 API 密钥。
安装
你需要：带沙箱运行器的 EmDash 1.1.0 或更高版本；已连接渠道的 Buffer 账号；Buffer 账号 API 限额中留有余量（限额由所有密钥和已连接的助手共用：免费套餐每天 250 次请求、30 天 3,000 次，10 个渠道时插件每天约使用 40 到 50 次）；以及在站点上设置 EMDASH_ENCRYPTION_KEY，以便加密保存 API 密钥（npx emdash secrets generate 可生成）。
- 从注册表安装插件，并查看其权限：读取内容、读取架构、读取媒体，以及仅限
api.buffer.com的网络请求。 - 在 Buffer 中打开 Settings > API（
https://publish.buffer.com/settings/api），创建一个个人 API 密钥。 - 在 EmDash 中打开 Plugins，进入此插件的设置，将密钥粘贴到 Buffer API key。把 Time zone 设为你的 IANA 时区（默认为 Australia/Sydney）：报告会按该时区把每条帖子计入对应的日期。保存。
- 打开 Plugins > Buffer Plus，选择 Setup。
- 选择 Discover channels。
- 开启你想发布到的每个渠道，并选择发布时机（排队、下一个分享、立即分享或 Buffer 草稿）以及附带内容（图片、链接卡片或不附带）。Pinterest 还需要选择一个看板。
- 在 Collections 下，勾选要分享的集合，并为每个集合选择图片来源。
- 发布一个条目。它会立即发送到 Buffer；如果开启的渠道很多，则在一两分钟内发送。
每个集合都需要一个 URL Pattern（在 Content Types 下），这样条目才有公开链接。在 Cloudflare Workers 上，同步需要 EmDash 部署指南中的 Cron 触发器。
要使用 MCP 工具，请在 Plugins 下为插件开启 Agent 访问。更新后如果新增了工具或权限，请再次开启。
常见问题
它会分享我已有的帖子吗？ 不会。管理员可以在条目的编辑器面板中使用 Share now，手动分享较早的条目。重新发布不会再次发送条目。
为什么跳过了某个渠道？ 编辑器面板和 Buffer Plus 页面会说明原因：该网络需要条目所没有的图片、Instagram 无法接受图片的比例、渠道已断开连接或被锁定、没有选择 Pinterest 看板、即使去掉描述文本仍然过长，或者 Buffer 的 API 无法发布到那里（YouTube、WhatsApp、Start Page）。
帖子文本中可以使用哪些标签？ , （条目的 Description 或 SEO description，也写作 ）以及 。
为什么某项数据显示“None yet”？ Buffer 大约每天报告一次数据，而且只提供网络给出的数据。缺失不等于零。
曝光量包含在其他地方发布的帖子吗？ 包含。它涵盖所分享渠道上的每一条帖子，并分为直接在网络上发布的和通过 Buffer（包括此插件）发布的。已发送、排队和失败只统计此插件发布的帖子。
为什么只有 31 天的数据？ Buffer 按套餐限制数据可回溯的时间：免费套餐提供 31 天（这是 Buffer 自己的回答，文档中没有）。插件会从 Buffer 获知该限制，并显示套餐允许的范围。
一条帖子会发送两次吗？ 不会：在回应不确定之后，它会先到 Buffer 中查找该帖子，再决定是否重新发送。
它会发出多少次 Buffer 请求？ 10 个渠道时每天约 40 到 50 次，计入 Buffer 的每个账号限额，该限额与你的其他密钥和助手共用（免费套餐：每天 250 次，30 天 3,000 次）。当剩余额度低于 “Leave for other tools” 时，报告会暂停。
如果达到 Buffer 的限额会怎样？ 帖子不会丢失。它们会等待，并在限额恢复后自动发出。Buffer 另有按渠道的发帖限制，可能拒绝某条帖子：请选择 Retry the next day。
它适用于所有网络吗？ 它遵循 Buffer 文档中的规则，但尚未在每个网络上进行实际测试。如果发现问题，请反馈。
安全
请通过仓库的安全公告表单私下报告安全问题：https://github.com/shanelord01/emdash-to-buffer-plus/security/advisories/new
插件可以做什么
- 读取内容、架构和媒体，以找到已发布条目的链接和图片。它从不更改你的内容。
- 仅向
api.buffer.com发出请求。它会把每条帖子的文本、链接、图片地址和替代文本发送给 Buffer。
它如何处理你的 Buffer 密钥
- 密钥以加密设置的形式保存（使用
EMDASH_ENCRYPTION_KEY的 AES-GCM）。没有该密钥时，EmDash 会拒绝保存，而不是以明文存储。 - 保存后，密钥不会再在后台显示，也不会写入日志。
- Buffer 密钥代表你的整个 Buffer 账号。如果你认为它已泄露，请在 Buffer 的 Settings > API 下创建一个新密钥，并粘贴到插件的设置中。
图片
图片由 Buffer 自行获取。只有当图片地址是 https 且位于你站点自己的主机上，或是来自外部媒体提供商的绝对 https 地址时，插件才会传递该地址。IP 地址、localhost 和私有名称都会被拒绝。
谁可以做什么
查看 Buffer Plus 页面、仪表板卡片、编辑器面板和 MCP 工具需要编辑者角色。发现渠道、保存设置、Retry 和 Send again 需要管理员角色。
更新日志
0.1.6，2026 年 10 月 9 日
- Instagram 只接受 4:5（竖版）到 1.91:1（横版）的比例，而且 Buffer 无法裁剪。如果已知图片超出该范围，现在会提前跳过 Instagram 并说明原因，而不是在 Buffer 处失败。其他网络不受影响，尺寸未知的图片仍照常发送。
- 编辑器面板会在首次分享前给出警告。发布了不同比例的图片后，Send again 会重新检查并发送。
- 只有在 Buffer 处理完某条帖子之后才会提供 Send again，排队期间绝不提供。
- 图表会标明每条线及其颜色，并且每条线外观各不相同：每个渠道一种颜色，Direct 为实线，Buffer 为虚线，Not split 为点线。此前，四个未拆分的渠道会把粉色和橙色各画两次。
- 互动率显示一位小数，Setup 视图中的日期与后台其他部分保持一致。
- 没有新的权限、设置或 MCP 工具变更。
0.1.5，2026 年 10 月 9 日
- 现在按你的本地日期统计。0.1.4 按 UTC 日期统计每条帖子，所以在悉尼，上午 10 点或 11 点前的帖子会显示为前一天，范围也在 UTC 午夜切换。新增设置 Time zone（默认为 Australia/Sydney），用于设定图表、范围和时间所用的时区。
- 更新后，首次同步会丢弃按 UTC 日期存储的每日数据，并从 Buffer 重新读取，范围取决于你的套餐允许的最早日期（免费套餐为 31 天）。在此之前，数据图表为空。
- 注册表列表上新增横幅。
- 没有新的权限。MCP 工具现在按你的时区描述日期，因此更新后 EmDash 会关闭 Agent 访问。请在 Plugins 下重新开启。
完整历史：CHANGELOG.md。