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。