CMM Publishing
cmm-publishing 是 CMM 內容工廠的發佈與草稿路由層。
它接收 content_package、可選的 visual_package 與可選的 video_package,然後產出包含平台支援、中繼資料、資產映射、核准關卡與執行路線的 publish_package。獲得明確確認後,經核准的後端可以建立草稿或瀏覽器審閱狀態。
邊界
使用此技能於:
- 組裝
publish_package。 - 決定目標應為
draft_box、browser_review、schedule_plan、manual_upload或unsupported。 - 準備平台中繼資料、資產映射與核對清單輸出。
- 在平台執行前執行後端前序檢查。
- 當偏好的後端不可用時,選擇更安全的備援方案。
- 僅選擇 WeChat、X、Weibo、小紅書或社群排程工作流程作為已核准的執行後端。
- 記錄尚不支援平台的發佈間隙。
請勿使用此技能於:
- 撰寫內容草稿。
- 產生圖片或渲染影片。
- 預設情況下點擊「發佈」、「貼文」、「發布」或任何對外可見的提交動作。
發佈邊界
此技能組裝 publish_package 並準備草稿/手動上傳指示。內建發佈路徑:WeChat 草稿箱 API (scripts/wechat_draft.py)、WeChat 瀏覽器草稿備援 (scripts/wechat_browser_draft.mjs)、X (scripts/x_publish.mjs)、Weibo (scripts/weibo_publish.mjs) 與抖音 (scripts/douyin_publish.py)。瀏覽器路徑預設為僅填充:助手填充內容,並在最終公開發佈前停止,使用者在瀏覽器中自行點擊發佈(助手即使在確認後也不會自動點擊 — 請參閱確認規則)。
尚未內建(例如小紅書實時填充)的即時自動發佈,仍為選用外掛,預設情況下絕不路由至該路徑。如果出現特定平台間隙,請將其記錄在 platform_gaps 中,並更新 CMM 合約或文件。
輸入
建議的輸入格式:
content_package:
platform: ""
format: ""
title: ""
body_markdown: ""
summary: ""
sources_used: []
publish_notes: ""
status: draft
visual_package:
asset_paths: []
status: draft
video_package:
render_path: ""
cover_path: ""
publish_copy: ""
status: draft
請閱讀 references/publish-package-contract.md 以了解確切的輸出欄位。閱讀 references/publishing-method.md 以了解支援矩陣、中繼資料、核准規則、後端前序檢查與備援行為。在建立 WeChat 草稿前,請閱讀 references/wechat-quality-gate.md;使用 templates/wechat-layout-package-template.md 進行 WeChat 排版交接。
工作流程
- 驗證可用的套件。
- 解析目標平台。
- 選擇目標模式:
draft_box:在支援時使用 API 或平台草稿。browser_review:瀏覽器開啟並填入內容,使用者手動審閱。schedule_plan:僅產生排程/日曆輸出。unsupported:記錄平台間隙。
- 建構
publish_package。 - 加入中繼資料、核對清單、平台間隙與核准要求。
- 在平台執行前為選定的後端執行前序檢查:
- 執行時期依賴
- 憑證或登入狀態
- 可偵測的 API/IP 允許清單限制
- 必要的封面/圖片/影片資產
- 後端能力間隙
- 如果前序檢查失敗,請選擇已記錄的備援方案,或將
publish_status設為blocked,並附上具體的platform_gaps項目。 當「修復偏好後端」與「備援後端」兩者皆可行時,請勿自動切換。請回報原因、是否已建立任何草稿/資產、呈現決策選項,並等待使用者選擇。 - 除非使用者已在當前輪次中要求草稿/瀏覽器/手動準備,否則在調用任何平台技能前,要求明確確認。 對於來自 CMM 內容工廠的 WeChat 長文輸出,本地預覽關卡的優先級高於同輪次草稿意圖:在使用者檢視並確認渲染預覽,然後再確認草稿箱建立之前,請勿調用 WeChat 草稿箱後端。
- 僅在確認後,或當同輪次草稿意圖且無更嚴格的預覽關卡適用時,才路由至已核准的後端。
- 除非使用者在同一輪次中明確確認最終發佈動作,否則在任何最終公開貼文前停止。
路由
預設輸出為發佈套件 + 草稿/手動上傳指示。 X、Weibo、抖音與 WeChat 草稿為內建(預設為審閱後發佈)。右欄標註的平台仍需選用實時發佈外掛;若無相關執行環境,則遵循手動上傳路徑。
| 平台 | CMM 目標(預設) | 即時發佈(內建/選用外掛) |
|---|---|---|
| WeChat 公眾號 | draft_box 透過內建 scripts/wechat_draft.py;API/IP 允許清單阻擋時,瀏覽器備援透過 scripts/wechat_browser_draft.mjs | —(草稿/填充路徑為內建) |
| X / Twitter | 內建瀏覽器發佈透過 scripts/x_publish.mjs(原生 CDP,產生原生 Chrome,持久登入,預設審閱後發佈);請參閱 references/x-publish.md。備援為手動上傳。 | —(內建) |
內建瀏覽器發佈透過 scripts/weibo_publish.mjs(原生 CDP,產生原生 Chrome,持久登入,預設審閱後發佈);請參閱 references/weibo-publish.md。備援為手動上傳。 | —(內建) | |
| 小紅書 / Rednote 圖文筆記 | 發佈套件 + 手動上傳 | 選用瀏覽器發佈外掛 |
| 小紅書 / Rednote 影片筆記 | 發佈套件 + 手動上傳 | 選用瀏覽器發佈外掛 |
| 跨平台日曆 | schedule_plan(僅計畫) | 選用排程器外掛 |
| 抖音 | 內建瀏覽器發佈透過 sau (scripts/douyin_publish.py,預設 --review-before-publish);請參閱 references/douyin-publish.md。如果 sau 不可用,則備援至 manual_upload。 | —(內建) |
| Bilibili | manual_upload 或 unsupported | 驗證前無 |
publish_package
publish_package:
platform: ""
target: draft_box
title: ""
body_ref: ""
body_markdown: ""
asset_refs: []
video_ref: ""
metadata: {}
approval_status: pending
publish_status: not_started
route: ""
approval_gate:
draft_creation: pending
final_publish: required_same_turn
backend_preflight: []
fallback_history: []
readiness_gate: {}
checklist: []
platform_gaps: []
external_result: {}
確認規則
- 建構
publish_package不需要確認。 - 如果使用者在當前輪次中明確要求平台草稿、草稿箱、瀏覽器審閱或手動上傳套件,請將
approval_status設為target_intent_recorded,直到任何更嚴格的 upstream 預覽關卡滿足為止。在預覽確認及明確的草稿箱/瀏覽器確認後,將approval_status設為approved_for_draft,並允許草稿準備。 - 調用瀏覽器/API/平台技能需要明確確認,除非當前使用者請求已明確要求草稿/瀏覽器/手動準備,且無更嚴格的預覽關卡適用。
- 預設僅填充 — 使用者自行點擊最終發佈按鈕。 對於每個瀏覽器驅動的平台,助手填寫草稿/創作器/後端,停在發佈按鈕前,並將開啟的瀏覽器交還給使用者進行發佈。助手不會預設點擊最終發佈按鈕,即使使用者確認也一樣 — 發佈按鈕的點擊是使用者在瀏覽器中的動作。(理由:非同步提交/發佈時的重新渲染曾導致貼文內容損毀,例如在點擊時正文內容遺失。)助手填充,然後截圖或報告狀態,供使用者檢閱與發佈。
--auto-publish/--submit與任何自動點擊開關僅在使用者在當前輪次中明確要求自動發佈時使用;否則一律停在發佈按鈕前。- 預設情況下,請勿使用
--submit或點擊最終發佈按鈕。 - 如果路由到的舊版技能有更嚴格的確認規則,則遵循更嚴格的規則。
準備關卡
| 關卡 | 要求 |
|---|---|
content_ready | 草稿存在且未被阻擋。 |
asset_ready | 必需的封面/圖片/影片已存在,或間隙已明確。 |
metadata_ready | 標題、摘要、標籤、封面及帳號/平台備註已準備就緒(如相關)。 |
approval_ready | 草稿建立與最終發佈的核准已分開。 |
platform_supported | 平台路由已支援、為手動上傳或明確標示為不支援。 |
平台備註
- 偏好草稿箱行為。
- 許多文章流程需要封面圖。
- 可能需要 API/IP 允許清單或瀏覽器登入。
- 在進行完整的 API 草稿工作前,儘可能對 API 憑證與 IP 允許清單進行前序檢查。
- 如果 API 因 IP 允許清單或權杖權限錯誤而失敗,當 Chrome/登入要求通過時,備援至內建瀏覽器路由 (
scripts/wechat_browser_draft.mjs)。 - 瀏覽器草稿建立可能無法在所有後端設定封面圖。如果選定的後端無法確認封面插入,請記錄一個
asset_gap,並在checklist中包含封面路徑。
X
- 內建透過
scripts/x_publish.mjs發佈(CMM 原生,原生 CDP,零 npm 依賴 — 使用 Node ≥21 內建的 WebSocket)。產生原生 Chrome 並使用持久化設定檔 (~/.cmm/chrome-x);首次執行會提示一次性 x.com 登入(純瀏覽器,因此不會阻擋 Google/X SSO),之後重複使用。不儲存憑證。--cdp URL可以附加到已在偵錯埠上執行的 Chrome。 - 文字透過 CDP
Input.insertText注入(真實鍵盤輸入:寫入 X 的 Draft.js EditorState,使其在重新渲染後仍存活;execCommand('insertText')僅操作 DOM,發佈時會被清除 — 請參閱references/x-publish.md)。需要頁籤在前並有實際點擊以取得焦點。媒體透過 CDPDOM.setFileInputFiles處理。 - 僅填充:填充創作器,停在 Post 按鈕前;使用者自行在瀏覽器中點擊 Post(
--auto-publish僅在明確的同輪次請求時使用)。 - 請參閱
references/x-publish.md。如果 Chrome/偵錯埠/登入不可用,則備援至manual_upload。
- 內建透過
scripts/weibo_publish.mjs發佈(CMM 原生,原生 CDP,零 npm 依賴)。產生原生 Chrome 並使用持久化設定檔 (~/.cmm/chrome-weibo);首次執行提示一次性 weibo.com 登入。不儲存憑證。 - 透過 CDP
Input.insertText填充首頁創作器<textarea>;圖片/影片(總數 ≤ 18)透過 CDPDOM.setFileInputFiles處理。 - 僅填充:填充創作器,停在 Send 按鈕前;使用者自行在瀏覽器中點擊 Send(
--auto-publish僅在明確的同輪次請求時使用)。 - 請參閱
references/weibo-publish.md。如果 Chrome/偵錯埠/登入不可用,則備援至manual_upload。
小紅書 / Rednote
Preflight 檢查(發布前必做)
| 項目 | 限制 |
|---|---|
| 標題 | ≤ 20 字 |
| 正文(去掉末尾話題標籤行後) | ≤ 950 字(平台上限 1000,留安全邊距) |
| 圖片數量 | 1–9 張 |
| 圖片格式 | jpg / png / webp,單張 ≤ 32MB |
發布流程(圖文筆記,已驗證可用)
Step 1 — 直接導航到上傳圖文頁
https://creator.xiaohongshu.com/publish/publish?from=menu&target=image
不要通過「發布筆記」下拉菜單點擊,直接用 URL 跳轉。
Step 2 — 核對帳號
用 get_page_text 或 javascript_tool 讀頁面右上角帳號名,確認是目標帳號後再繼續。帳號不對讓用戶先切換,不要繼續填寫內容。
Step 3 — 上傳圖片
當前限制:Chrome 擴展 file_upload 工具只允許上傳會話已共享的路徑,本地 Documents 目錄不在範圍內。
現行操作:通知用戶從 Finder(提前 open 圖片目錄)手動將圖片拖入上傳區,按順序(封面在前)。
待解方案:在 Claude 桌面應用設置裡將 ~/.cmm/uploads/ 加入 connected folders,生圖流水線自動 cp 到該目錄後可全自動上傳。
Step 4 — 填寫標題
用 find 定位標題 input(placeholder: "填寫標題會有更多讚哦"),用 computer.type 或 form_input 填入。
Step 5 — 填寫正文
正文區是 contenteditable div,用 javascript_tool 注入:
const div = document.querySelectorAll('[contenteditable="true"]')[0];
div.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, bodyText);
話題標籤直接寫在正文末尾(#話題 格式),小紅書會自動解析。
注入完成後用 javascript_tool 讀取頁面字符計數器(X/1000)確認字數正確。
Step 6 — 停在發布按鈕前
所有內容填完後停止,不點「發布」。告知用戶內容已就緒,由用戶自行確認並點擊發布。
平台限制記錄
- 無內置發布腳本,不支援 API draft box。
- 圖片上傳路徑限制(見 Step 3)為當前已知 gap,記錄在
platform_gaps。 - Final public publish 必須用戶同步確認,不得代為點擊。
抖音(內建)與 Bilibili
- 未經確認,請勿假裝最終公開發佈已完成。
- 抖音:內建瀏覽器發佈 透過
sau(請參閱references/douyin-publish.md、scripts/douyin_publish.py)。前序檢查關卡:帳號已選擇、登入/cookie 有效、影片/圖片 + 標題/標籤已準備。預設--review-before-publish(填充後停在發佈按鈕前;使用者自行在開啟的瀏覽器中點擊發佈 — 即使確認後也不自動點擊)。如果sau不可用,則備援至manual_upload並附上完整套件。 - 即使登入尚未準備好,也請保持已產生的內容/資產可供手動上傳。
- 對於 Bilibili,當可以準備完整的手動套件時,輸出
target: manual_upload;否則輸出target: unsupported。 - 在
platform_gaps中包含一個項目,說明缺少登入、缺少帳號、不支援的後端或手動上傳要求。
停止條件
在以下情況前停止並詢問:
- 調用平台 API。
- 開啟瀏覽器自動化以操作需登入的平台。
- 上傳圖片或影片。
- 點擊任何最終的發佈/貼文按鈕。
- 排程外部貼文。