CMM Publishing
cmm-publishing est la couche de publication et d’acheminement des brouillons dans l’usine à contenu CMM.
Elle consomme content_package, visual_package et video_package (optionnels), puis produit un publish_package comprenant la compatibilité des plateformes, les métadonnées, le mappage des ressources, les points d’approbation et l’itinéraire d’exécution. Après confirmation explicite, un backend approuvé peut créer un brouillon ou un état de révision dans le navigateur.
Périmètre
Utilisez cette compétence pour :
- Assembler un
publish_package. - Décider si la cible doit être
draft_box,browser_review,schedule_plan,manual_uploadouunsupported. - Préparer les métadonnées de la plateforme, le mappage des ressources et la sortie de la checklist.
- Exécuter une pré-vérification du backend avant l’exécution sur la plateforme.
- Choisir un repli plus sûr lorsque le backend préféré n’est pas disponible.
- Sélectionner des workflows pour WeChat, X, Weibo, Xiaohongshu ou la planification sociale uniquement comme backends d’exécution approuvés.
- Enregistrer les lacunes de publication pour les plateformes non encore prises en charge.
N’utilisez pas cette compétence pour :
- Rédiger le brouillon du contenu.
- Générer des images ou produire des vidéos.
- Cliquer sur « Publier », « Poster », « 发布 » ou toute action de soumission visible de l’extérieur par défaut.
Périmètre de publication
Cette compétence assemble un publish_package et prépare des instructions de brouillon / téléversement manuel. Chemins de publication intégrés : API de la boîte à brouillons WeChat (scripts/wechat_draft.py), repli via le navigateur WeChat (scripts/wechat_browser_draft.mjs), X (scripts/x_publish.mjs), Weibo (scripts/weibo_publish.mjs) et Douyin (scripts/douyin_publish.py). Les chemins navigateur par défaut sont en mode remplissage uniquement : l’assistant remplit le contenu et s’arrête avant la publication finale publique, et l’utilisateur clique lui-même sur publier dans le navigateur (l’assistant ne clique pas automatiquement, même après confirmation — voir Règles de confirmation).
La publication automatique en direct vers des plateformes non encore intégrées (ex. remplissage en direct Xiaohongshu) reste un plugin optionnel, jamais acheminé par défaut. Si une lacune spécifique à une plateforme apparaît, enregistrez-la dans platform_gaps et mettez à jour les contrats ou la documentation CMM.
Entrée
Entrée préférée :
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
Consultez references/publish-package-contract.md pour les champs de sortie exacts. Consultez references/publishing-method.md pour la matrice de support, les métadonnées, les règles d’approbation, la pré-vérification du backend et le comportement de repli. Consultez references/wechat-quality-gate.md avant la création d’un brouillon WeChat ; utilisez templates/wechat-layout-package-template.md pour la transmission de la mise en page WeChat.
Workflow
- Validez les packages disponibles.
- Résolvez la plateforme cible.
- Choisissez le mode cible :
draft_box: API ou brouillon de plateforme lorsque pris en charge.browser_review: ouverture du navigateur avec le contenu rempli, l’utilisateur relit manuellement.schedule_plan: planification / sortie de calendrier uniquement.unsupported: lacune de plateforme enregistrée.
- Construisez le
publish_package. - Ajoutez les métadonnées, la checklist, les lacunes de plateforme et les exigences d’approbation.
- Exécutez la pré-vérification du backend sélectionné avant l’exécution sur la plateforme :
- dépendances d’exécution
- informations d’identification ou état connecté
- contraintes de liste d’autorisation API/IP (si détectables)
- ressources de couverture/image/vidéo requises
- lacunes de capacités du backend
- Si la pré-vérification échoue, choisissez un repli documenté ou définissez
publish_status: blockedavec un élément concret dansplatform_gaps. Lorsque « réparer le backend préféré » et « backend de repli » sont tous deux plausibles, ne basculez pas automatiquement. Signalez la raison, si des brouillons / ressources ont été créés, présentez les options de décision et attendez que l’utilisateur choisisse. - Demandez une confirmation explicite avant d’invoquer toute compétence de plateforme, sauf si l’utilisateur a déjà demandé la préparation d’un brouillon/manuel/navigateur dans le même tour. Pour les sorties longues WeChat provenant de CMM Content Factory, la passerelle de prévisualisation locale prime sur l’intention de brouillon du même tour : n’invoquez pas le backend de boîte à brouillons WeChat tant que l’utilisateur n’a pas vu et confirmé l’aperçu rendu, puis confirmé la création du brouillon.
- Acheminez vers un backend approuvé uniquement après confirmation ou intention de brouillon du même tour lorsqu’aucune passerelle de prévisualisation plus stricte ne s’applique.
- Arrêtez-vous avant toute publication finale publique, sauf si l’utilisateur confirme explicitement l’action de publication finale dans le même tour.
Acheminement
La sortie par défaut est un package de publication + instructions de brouillon / téléversement manuel. X, Weibo, Douyin et le brouillon WeChat sont intégrés (relecture avant publication par défaut). La colonne de droite indique les plateformes dont la publication en direct nécessite encore le plugin optionnel de publication en direct ; sans l’exécution correspondante, suivez le chemin de téléversement manuel.
| Plateforme | Cible CMM (par défaut) | Publication en direct (intégrée / plugin optionnel) |
|---|---|---|
| Compte officiel WeChat | draft_box via scripts/wechat_draft.py intégré ; repli navigateur via scripts/wechat_browser_draft.mjs lorsque la liste d’autorisation API/IP le bloque | — (chemins de brouillon/remplissage intégrés) |
| X / Twitter | Intégrée publication navigateur via scripts/x_publish.mjs (CDP brut, lance Chrome natif, connexion persistante, relecture avant publication par défaut) ; voir references/x-publish.md. Repli vers téléversement manuel. | — (intégrée) |
Intégrée publication navigateur via scripts/weibo_publish.mjs (CDP brut, lance Chrome natif, connexion persistante, relecture avant publication par défaut) ; voir references/weibo-publish.md. Repli vers téléversement manuel. | — (intégrée) | |
| Xiaohongshu / Rednote note image | package de publication + téléversement manuel | plugin navigateur optionnel pour publication |
| Xiaohongshu / Rednote note vidéo | package de publication + téléversement manuel | plugin navigateur optionnel pour publication |
| Calendrier multi-plateforme | schedule_plan (planification uniquement) | plugin planificateur optionnel |
| Douyin | Intégrée publication navigateur via sau (scripts/douyin_publish.py, par défaut --review-before-publish) ; voir references/douyin-publish.md. Repli vers manual_upload si sau indisponible. | — (intégrée) |
| Bilibili | manual_upload ou unsupported | aucun jusqu’à vérification |
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: {}
Règles de confirmation
- La construction du
publish_packagene nécessite pas de confirmation. - Si l’utilisateur demande explicitement un brouillon de plateforme, une boîte à brouillons, une révision navigateur ou un package de téléversement manuel dans le tour en cours, définissez
approval_status: target_intent_recordedjusqu’à ce qu’une éventuelle passerelle de prévisualisation plus stricte en amont soit satisfaite. Après confirmation de la prévisualisation et confirmation explicite du brouillon/de la boîte à brouillons, définissezapproval_status: approved_for_draftet autorisez la préparation du brouillon. - L’invocation d’une compétence navigateur/API/plateforme nécessite une confirmation explicite, sauf si la demande actuelle de l’utilisateur demande clairement une préparation de brouillon/navigateur/manuel et qu’aucune passerelle de prévisualisation plus stricte ne s’applique.
- Remplissage uniquement par défaut — l’utilisateur clique lui-même sur le bouton de publication final. Pour chaque plateforme pilotée par navigateur, l’assistant remplit le brouillon/éditeur/système de création, s’arrête au bouton de publication et rend le navigateur ouvert à l’utilisateur pour qu’il publie. L’assistant ne clique pas sur le bouton de publication final par défaut, même lorsque l’utilisateur confirme — le clic de publication est l’action de l’utilisateur dans le navigateur. (Justification : une soumission asynchrone / un re-rendu au moment de la publication a déjà corrompu des articles, par exemple du texte supprimé au clic.) L’assistant remplit, puis prend une capture d’écran ou signale l’état pour que l’utilisateur relise et publie.
--auto-publish/--submitet tout interrupteur de clic automatique sont utilisés uniquement lorsque l’utilisateur, dans le tour en cours, demande explicitement une publication automatique ; sinon, arrêtez-vous toujours au bouton de publication.- N’utilisez jamais
--submitet ne cliquez jamais sur les boutons de publication finaux par défaut. - Si une compétence héritée acheminée a une règle de confirmation plus stricte, suivez la règle la plus stricte.
Passerelle de préparation
| Passerelle | Exigence |
|---|---|
content_ready | Le brouillon existe et n’est pas bloqué. |
asset_ready | La couverture/images/vidéo requises sont présentes ou l’écart est explicite. |
metadata_ready | Le titre, le résumé, les tags, la couverture et les notes de compte/plateforme sont préparés le cas échéant. |
approval_ready | Les approbations de création du brouillon et de publication finale sont séparées. |
platform_supported | Le chemin de la plateforme est pris en charge, manuel, ou explicitement non pris en charge. |
Notes sur les plateformes
- Privilégiez le comportement de boîte à brouillons.
- Les couvertures sont requises pour de nombreux flux d’articles.
- La liste d’autorisation API/IP ou la connexion navigateur peuvent être nécessaires.
- Pré-vérifiez les informations d’identification API et la liste d’autorisation IP avant d’effectuer un travail complet de brouillon API si possible.
- Si l’API échoue avec des erreurs de liste d’autorisation IP ou de permission de jeton, repliez-vous sur le chemin navigateur intégré (
scripts/wechat_browser_draft.mjs) lorsque les exigences Chrome/connexion sont satisfaites. - La création d’un brouillon navigateur peut ne pas définir l’image de couverture via tous les backends. Si le backend sélectionné ne peut pas confirmer l’insertion de la couverture, enregistrez un
asset_gapet incluez le chemin de la couverture danschecklist.
X
- Intégrée publication via
scripts/x_publish.mjs(natif CMM, CDP brut, zéro dépendance npm — utilise le WebSocket intégré de Node ≥21). Lance Chrome natif avec un profil persistant (~/.cmm/chrome-x) ; la première exécution invite à une connexion unique à x.com (navigateur standard, donc Google/X SSO n’est pas bloqué), réutilisée par la suite. Aucune information d’identification stockée.--cdp URLpeut s’attacher à un Chrome déjà en cours d’exécution sur un port de débogage. - Le texte est injecté via CDP
Input.insertText(saisie clavier réelle : écrit dans Draft.js EditorState de X pour survivre au re-rendu ;execCommand('insertText')ne touchait que le DOM et était effacé lors de la publication — voirreferences/x-publish.md). Nécessite l’onglet au premier plan + un clic réel pour le focus. Média via CDPDOM.setFileInputFiles. - Remplissage uniquement : remplir le compositeur, s’arrêter au bouton Poster ; l’utilisateur clique lui-même sur Poster dans le navigateur (
--auto-publishuniquement sur demande explicite du même tour). - Voir
references/x-publish.md. Repliez-vous versmanual_uploadsi Chrome/port de débogage/connexion est indisponible.
- Intégrée publication via
scripts/weibo_publish.mjs(natif CMM, CDP brut, zéro dépendance npm). Lance Chrome natif avec un profil persistant (~/.cmm/chrome-weibo) ; première exécution invite à une connexion unique à weibo.com. Aucune information d’identification stockée. - Remplit le
<textarea>du compositeur d’accueil via CDPInput.insertText; images/vidéos (≤18 au total) via CDPDOM.setFileInputFiles. - Remplissage uniquement : remplir le compositeur, s’arrêter au bouton Envoyer ; l’utilisateur clique lui-même sur Envoyer dans le navigateur (
--auto-publishuniquement sur demande explicite du même tour). - Voir
references/weibo-publish.md. Repliez-vous versmanual_uploadsi Chrome/port de débogage/connexion est indisponible.
Xiaohongshu / Rednote
Vérifications préalables (obligatoires avant publication)
| Élément | Limite |
|---|---|
| Titre | ≤ 20 caractères |
| Corps (sans ligne de hashtags en fin) | ≤ 950 caractères (limite plateforme 1000, marge de sécurité) |
| Nombre d’images | 1–9 |
| Format des images | jpg / png / webp, chaque ≤ 32 Mo |
Processus de publication (notes image, validé)
Étape 1 — Naviguez directement vers la page de téléversement d’images texte
https://creator.xiaohongshu.com/publish/publish?from=menu&target=image
Ne cliquez pas via le menu déroulant « Publier une note », utilisez directement l’URL.
Étape 2 — Vérifiez le compte
Utilisez get_page_text ou javascript_tool pour lire le nom du compte dans le coin supérieur droit de la page, confirmez qu’il s’agit du compte cible avant de continuer. Si le compte est incorrect, demandez à l’utilisateur de changer et ne remplissez pas le contenu.
Étape 3 — Téléversez les images
Limitation actuelle : l’outil file_upload de l’extension Chrome ne permet de téléverser que des chemins déjà partagés par la session ; le répertoire local Documents n’est pas inclus.
Action actuelle : informez l’utilisateur de faire glisser manuellement les images depuis le Finder (ouvrez le répertoire d’images à l’avance avec open) dans la zone de téléversement, dans l’ordre (couverture en premier).
Solution en attente : ajoutez ~/.cmm/uploads/ aux dossiers connectés dans l’application de bureau Claude, la pipeline de génération d’images copiera (cp) automatiquement dans ce répertoire, permettant un téléversement entièrement automatique.
Étape 4 — Remplissez le titre
Utilisez find pour localiser l’input du titre (placeholder : "填写标题会有更多赞哦"), utilisez computer.type ou form_input pour le remplir.
Étape 5 — Remplissez le corps
La zone de corps est un div contenteditable, injectez via javascript_tool :
const div = document.querySelectorAll('[contenteditable="true"]')[0];
div.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, bodyText);
Les hashtags sont écrits directement à la fin du corps (format #sujet), Xiaohongshu les analysera automatiquement.
Après injection, utilisez javascript_tool pour lire le compteur de caractères (X/1000) et confirmer le nombre correct.
Étape 6 — Arrêtez-vous avant le bouton de publication
Après avoir rempli tout le contenu, arrêtez-vous, ne cliquez pas sur « Publier ». Informez l’utilisateur que le contenu est prêt, c’est à lui de confirmer et de cliquer sur publier.
Enregistrement des limitations de la plateforme
- Aucun script de publication intégré, l’API draft box n’est pas prise en charge.
- La limitation du chemin de téléversement des images (voir Étape 3) est une lacune actuellement connue, enregistrée dans
platform_gaps. - La publication finale publique doit être confirmée en même temps par l’utilisateur, ne cliquez pas à sa place.
Douyin (intégré) et Bilibili
- Ne prétendez pas que la publication finale publique est terminée sans confirmation.
- Douyin : publication navigateur intégrée via
sau(voirreferences/douyin-publish.md,scripts/douyin_publish.py). Passerelles de pré-vérification : compte sélectionné, connexion/cookie valide, vidéo/image + titre/tags préparés. Par défaut--review-before-publish(remplir puis s’arrêter au bouton de publication ; l’utilisateur clique lui-même sur publier dans le navigateur ouvert — ne cliquez pas automatiquement même après confirmation). Sisauest indisponible, repliez-vous versmanual_uploadavec un package complet. - Gardez le contenu et les ressources générés prêts pour le téléversement manuel même si la connexion n’est pas prête.
- Pour Bilibili, produisez
target: manual_uploadlorsqu’un package manuel complet peut être préparé ; sinon, produiseztarget: unsupported. - Incluez un élément
platform_gapsexpliquant la connexion manquante, le compte manquant, le backend non pris en charge ou les exigences de téléversement manuel.
Conditions d’arrêt
Arrêtez-vous et demandez avant :
- D’appeler les API de plateforme.
- D’ouvrir l’automatisation du navigateur pour les plateformes connectées.
- De téléverser des images ou des vidéos.
- De cliquer sur un bouton final de publication/envoi.
- De planifier des publications externes.