baoyu-post-to-weibo

發布到微博

透過真實 Chrome 瀏覽器（繞過反爬蟲偵測）將文字、圖片、影片及長篇文章發布到微博。

腳本目錄

重要：所有腳本都位於此技能的 scripts/ 子目錄中。

代理執行指示：

1. 找出此 SKILL.md 檔案所在的目錄路徑，設為 {baseDir}
2. 腳本路徑 = {baseDir}/scripts/<script-name>.ts
3. 將本文中所有的 {baseDir} 替換為實際路徑
4. 解析 ${BUN_X} 執行環境：若已安裝 bun → 使用 bun；若可使用 npx → 使用 npx -y bun；否則建議安裝 bun

腳本參考：

腳本	用途
scripts/weibo-post.ts	一般貼文（文字 + 圖片）
scripts/weibo-article.ts	頭條文章發布（Markdown）
scripts/copy-to-clipboard.ts	複製內容到剪貼簿
scripts/paste-from-clipboard.ts	傳送真實貼上按鍵

偏好設定（EXTEND.md）

依優先順序檢查 EXTEND.md，找到第一個即採用：

優先順序	路徑	範圍
1	.baoyu-skills/baoyu-post-to-weibo/EXTEND.md	專案
2	${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-weibo/EXTEND.md	XDG
3	$HOME/.baoyu-skills/baoyu-post-to-weibo/EXTEND.md	使用者家目錄

若找不到，則使用預設值。

EXTEND.md 支援：預設 Chrome 設定檔

前置需求

• Google Chrome 或 Chromium
• bun 執行環境
• 首次執行：手動登入微博（工作階段會儲存）

---

一般貼文

文字 + 圖片/影片（最多 18 個檔案）。發布在微博首頁。

${BUN_X} {baseDir}/scripts/weibo-post.ts "Hello Weibo!" --image ./photo.png
${BUN_X} {baseDir}/scripts/weibo-post.ts "Watch this" --video ./clip.mp4

參數：

參數	說明
<text>	貼文內容（位置參數）
--image <path>	圖片檔案（可重複）
--video <path>	影片檔案（可重複）
--profile <dir>	自訂 Chrome 設定檔

注意：腳本會開啟瀏覽器並填入內容，使用者需自行審閱並手動發布。

---

頭條文章

長篇 Markdown 文章，發布於 https://card.weibo.com/article/v3/editor。

${BUN_X} {baseDir}/scripts/weibo-article.ts article.md
${BUN_X} {baseDir}/scripts/weibo-article.ts article.md --cover ./cover.jpg

參數：

參數	說明
<markdown>	Markdown 檔案（位置參數）
--cover <path>	封面圖片
--title <text>	覆蓋標題（最多 32 字元，超過會截斷）
--summary <text>	覆蓋摘要（最多 44 字元，超過會自動重新產生）
--profile <dir>	自訂 Chrome 設定檔

Frontmatter：支援 YAML 前置元件的 title、summary、cover_image。

字元限制：

• 標題：最多 32 字元（超過會截斷並顯示警告）
• 摘要/導語：最多 44 字元（超過會從內容自動重新產生）

Markdown 轉 HTML：轉換 Markdown 為 HTML 時，請勿傳入任何 --theme 參數。使用預設主題（不帶主題參數）。

文章流程：

1. 開啟 https://card.weibo.com/article/v3/editor
2. 點擊「寫文章」按鈕，等待編輯器變為可編輯狀態
3. 填入標題（驗證 32 字元限制）
4. 填入摘要/導語（驗證 44 字元限制）
5. 透過貼上將 HTML 內容插入 ProseMirror 編輯器
6. 逐一取代圖片佔位符（複製圖片 → 選取佔位符 → 貼上）

發布前檢查：腳本會在插入所有圖片後自動驗證：

• 編輯器內容中是否還有剩餘的 WBIMGPH_ 佔位符
• 預期圖片數量與實際圖片數量是否相符

若檢查失敗（輸出中有警告），請在使用者發布前提醒具體問題。

---

貼文類型選擇

除非使用者明確指定貼文類型：

• Markdown 檔案（.md）→ 頭條文章
• 純文字 / 文字加圖片 → 一般貼文

疑難排解

Chrome 偵錯埠未就緒

若腳本因 Chrome debug port not ready 或 Unable to connect 失敗，請僅終止 CDP Chrome 實例（那些帶有 --remote-debugging-port 且使用 baoyu-skills 設定檔的），然後重試：

pkill -f "remote-debugging-port.*baoyu-skills/chrome-profile" 2>/dev/null; sleep 2

重要：絕對不要終止所有 Chrome 程序（pkill -f "Google Chrome"）。僅終止由 CDP 啟動且使用 baoyu-skills 設定檔目錄的 Chrome 實例。使用者可能還有其他一般 Chrome 視窗開啟。

注意：此操作應自動執行——遇到此錯誤時，請自動終止 CDP Chrome 實例並重試指令，無需詢問使用者。

備註

• 首次執行：需手動登入（工作階段會持續保留）
• 所有腳本僅將內容填入瀏覽器，使用者必須自行審閱並手動發布
• 跨平台：macOS、Linux、Windows

擴充支援

透過 EXTEND.md 進行自訂設定。請參閱偏好設定章節了解路徑及支援的選項。