baoyu-post-to-wechat

baoyu-post-to-wechat skill 概覽

baoyu-post-to-wechat 能做什麼

baoyu-post-to-wechat 是一個用於微信公眾號發佈的 publishing skill，可處理兩種不同工作：長文文章發佈與圖文發佈。它支援 Markdown、HTML 與純文字輸入，並可透過 WeChat API 或 Chrome CDP 瀏覽器流程進行發佈。對多數使用者來說，真正的價值不只是抽象地「發文到 WeChat」，而是把草稿內容整理成 WeChat 真正能接受的格式，減少後續手動清理與修正。

誰適合安裝 baoyu-post-to-wechat

這個 skill 很適合已經用 Markdown 起草內容、且需要可重複執行的 WeChat 發佈流程的作者、營運人員，以及 AI 輔助內容工作流。若你需要以 frontmatter 擷取標題／作者／摘要、處理圖片、使用瀏覽器自動化，或在純 API 發佈不夠用時保留備援路徑，它尤其實用。反過來說，如果你只是偶爾在微信編輯器裡手動發一次文，一般 prompt 往往更簡單。

為什麼這個 baoyu-post-to-wechat skill 和一般 prompt 不一樣

baoyu-post-to-wechat skill 內含可直接執行的腳本，不只是操作說明。實務上的差異點包括：

• 透過 scripts/md-to-wechat.ts 進行 Markdown 轉 WeChat HTML
• 以 scripts/wechat-article.ts 與 scripts/wechat-browser.ts 區分文章與圖文流程
• 同時提供 API 與瀏覽器式發佈選項
• 預設會把一般外部連結轉成文末引用，這點非常貼近 WeChat 的實際排版限制
• 透過 scripts/check-permissions.ts 檢查 Chrome profile 與權限狀態

採用前最需要確認的事

是否適合安裝，關鍵在於環境是否相容。這個 skill 預期你可使用 bun 或 npx -y bun，本機有受支援的 Chrome/Chromium/Edge，並且具備足夠的本地瀏覽器存取權限，才能進行基於 CDP 的自動化。如果你的工作流程無法使用本機瀏覽器 profile，或完全不能做瀏覽器自動化，建議先看清楚這項限制，再投入設定時間。

如何使用 baoyu-post-to-wechat skill

安裝 baoyu-post-to-wechat 時，先看哪些檔案

進行 baoyu-post-to-wechat install 時，請先從 skills/baoyu-post-to-wechat 開始，依序閱讀：

• SKILL.md
• references/article-posting.md
• references/image-text-posting.md
• references/config/first-time-setup.md
• scripts/check-permissions.ts

這個 repo 預期 ${BUN_X} 會在已安裝 bun 時解析為 bun，否則使用 npx -y bun。在真正嘗試發佈任何內容之前，先執行環境檢查腳本，確認 Chrome 偵測、profile 隔離，以及 clipboard／browser 相依是否正常。

baoyu-post-to-wechat 的實際使用方式

實務上有三個主要入口：

• 透過瀏覽器發文章：scripts/wechat-article.ts
• 透過 API 發文章：scripts/wechat-api.ts
• 發佈 Social Media 用圖文：scripts/wechat-browser.ts

常見的文章指令：
bun ./scripts/wechat-article.ts --markdown article.md --theme grace

常見的圖文指令：
bun ./scripts/wechat-browser.ts --markdown source.md --images ./images/ --submit

如果你手上已經有渲染好的 HTML：
bun ./scripts/wechat-article.ts --html content.html --title "Title"

需要指定特定 Chrome profile 時，使用 --profile <dir>；如果你更重視內文中保留外部連結，而不是轉為引用格式，則使用 --no-cite。

什麼樣的輸入最能發揮 baoyu-post-to-wechat 效果

最穩定的 baoyu-post-to-wechat usage，通常是從一份結構乾淨、包含 frontmatter 的 Markdown 檔案開始：

---
title: Practical WeChat Publishing Workflow
author: Your Name
summary: A concise summary used for article metadata.
---

接著，正文請維持單一 H1、清楚的段落標題、有效的本地圖片路徑，以及你可以接受被轉換的最終連結格式。輸入品質越好，通常代表：

• 標題擷取錯誤更少
• 摘要生成更穩定
• 圖片替換與上傳處理更乾淨
• 在微信編輯器中需要手動修的地方更少

一個偏弱的要求是：「post this to WeChat。」
更好的說法則是：「Use baoyu-post-to-wechat to publish drafts/q2-update.md as an article, keep WeChat-friendly citations enabled, apply grace theme, set author to Team Ops, and use Chrome profile ./tmp/wechat-profile.」

能降低猜測成本的 baoyu-post-to-wechat 工作流程建議

一份可靠的 baoyu-post-to-wechat guide 建議如下：

1. 先用 scripts/check-permissions.ts 驗證環境
2. 先決定要走 article 還是 image-text 流程
3. 準備好含 frontmatter 與本地圖片的 Markdown
4. 如果主要風險在格式，先用 scripts/md-to-wechat.ts 測試轉換結果
5. 再選擇瀏覽器或 API 路徑進行發佈
6. 在 WeChat 內確認草稿／輸出後，再做最終發送

如果中途出問題，先檢查 scripts/cdp.ts、scripts/wechat-agent-browser.ts 與 scripts/wechat-extend-config.ts，再決定是否修改內容。這幾個檔案分別說明了如何尋找 Chrome、如何控制瀏覽器，以及本地設定如何覆寫預設值。

baoyu-post-to-wechat skill 常見問題

baoyu-post-to-wechat 適合新手嗎？

適合，但前提是你願意執行腳本，也能整理 Markdown。若你想要的是純聊天、零本地設定的體驗，它就不是最理想的選擇。它的操作價值主要來自可重複執行與流程穩定，而不是「對新手最省事」。

什麼情況下該用它，而不是一般 AI prompt？

當真正困難的部分在於執行層面時，就該用 baoyu-post-to-wechat：例如 Markdown 轉換、圖片處理、符合 WeChat 限制，以及盡量減少手動瀏覽器操作的發佈流程。如果你只是需要幫忙寫文案、標題或摘要，一般 prompt 就足夠。

baoyu-post-to-wechat 在 Social Media 工作中的主要邊界是什麼？

它專注的是微信公眾號發佈，不是通用型的多平台社群排程工具。如果你需要一套流程同時處理 X、LinkedIn、Instagram 與 WeChat，單靠這個 skill 會太窄。它最適合放在較大的內容產線中，擔任 WeChat 專用的發佈步驟。

什麼情況下 baoyu-post-to-wechat 不適合你？

如果你的環境禁止本地瀏覽器自動化、無法安裝相容於 bun 的工具鏈，或團隊本來就已經有穩定的 CMS-to-WeChat 整合，就可以跳過它。若只是偶爾手動發文、格式也很簡單，使用這個 skill 也會顯得太重。

如何改進 baoyu-post-to-wechat skill 的使用效果

先把 baoyu-post-to-wechat 的來源素材整理好

想提升 baoyu-post-to-wechat 輸出品質，最快的方法其實是先把輸入整理好：

• 把 title、author、summary 放進 frontmatter
• 保持一個清楚的 H1
• 使用可正常存取的本地圖片路徑
• 移除失效連結或追蹤參數過重的外部連結
• 及早決定要使用引用轉換，還是 --no-cite

這樣可以明顯減少下游編修，也能讓 Markdown-to-WeChat 的轉換結果更可預期。

避開最常見的 baoyu-post-to-wechat 失敗模式

常見問題多半出在操作面，而不是概念本身：

• 找不到 Chrome，或瀏覽器路徑錯誤
• 使用個人 Chrome profile 導致 profile 衝突
• Markdown 結構太弱，導致標題／摘要擷取不如預期
• 圖片路徑有問題
• 誤以為 article 與 image-text 模式行為完全相同

先做權限檢查、把 profile 隔離開來，並在批次使用前先拿一份小樣本文件測試，通常能避開大多數問題。

改善 prompt 與交接指示

如果想讓 baoyu-post-to-wechat guide 的執行品質更高，請在指示中明確寫出：

• 發佈模式：article 或 image-text
• 來源檔案路徑
• 要不要覆寫 title，或 frontmatter 是否為唯一依據
• 是直接 submit，還是只做 preview／draft
• theme 選擇
• citation 行為
• profile 路徑

好的指示應該具體到讓 agent 不需要猜，就能直接選對腳本。

第一次輸出後要怎麼迭代

第一次跑完之後，若要改善結果，優先做法應該是回頭調整來源 Markdown 再重跑，而不是在 WeChat 裡把所有問題都手動補掉。請先確認問題究竟來自內容結構、metadata、圖片擺放，還是瀏覽器環境。對大多數團隊來說，長期來看，提升 baoyu-post-to-wechat skill 效果最值得做的事，是建立一份可重用的 Markdown 範本，以及一套已驗證可用的本地 profile 設定。