CMM Publishing
cmm-publishing é a camada de publicação e roteamento de rascunhos na fábrica de conteúdo CMM.
Ela consome content_package, visual_package opcional e video_package opcional, e então produz um publish_package com suporte a plataforma, metadados, mapeamento de ativos, gates de aprovação e rota de execução. Após confirmação explícita, um backend aprovado pode criar um rascunho ou um estado de revisão no navegador.
Limite
Use esta habilidade para:
- Montar um
publish_package. - Decidir se o destino deve ser
draft_box,browser_review,schedule_plan,manual_uploadouunsupported. - Preparar metadados da plataforma, mapeamento de ativos e saída de checklist.
- Executar pré-verificação de backend antes da execução na plataforma.
- Escolher um fallback mais seguro quando o backend preferido estiver indisponível.
- Selecionar apenas fluxos de trabalho de WeChat, X, Weibo, Xiaohongshu ou agendamento social como backends de execução aprovados.
- Registrar lacunas de publicação para plataformas ainda não suportadas.
Não use esta habilidade para:
- Escrever o rascunho de conteúdo.
- Gerar imagens ou renderizar vídeos.
- Clicar em
Publicar,Postar,发布ou qualquer ação de envio visível externamente por padrão.
Limite de Publicação
Esta habilidade monta um publish_package e prepara instruções de rascunho / upload manual. Caminhos de publicação integrados: API de caixa de rascunho do WeChat (scripts/wechat_draft.py), fallback de rascunho no navegador WeChat (scripts/wechat_browser_draft.mjs), X (scripts/x_publish.mjs), Weibo (scripts/weibo_publish.mjs) e Douyin (scripts/douyin_publish.py). Caminhos de navegador padronizam para somente preenchimento: o assistente preenche o conteúdo e para antes da publicação pública final, e o usuário clica em publicar por conta própria no navegador (o assistente não clica automaticamente, mesmo com confirmação — veja Regras de Confirmação).
A publicação automática ao vivo para plataformas ainda não integradas (ex.: preenchimento ao vivo do Xiaohongshu) permanece um plugin opcional, nunca roteado por padrão. Se uma lacuna específica de plataforma aparecer, registre-a em platform_gaps e atualize os contratos ou documentos do CMM.
Entrada
Entrada preferida:
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
Leia references/publish-package-contract.md para os campos exatos de saída. Leia references/publishing-method.md para matriz de suporte, metadados, regras de aprovação, pré-verificação de backend e comportamento de fallback. Leia references/wechat-quality-gate.md antes da criação de rascunho do WeChat; use templates/wechat-layout-package-template.md para o handoff de layout do WeChat.
Fluxo de Trabalho
- Validar pacotes disponíveis.
- Resolver plataforma alvo.
- Escolher modo de destino:
draft_box: API ou rascunho de plataforma quando suportado.browser_review: navegador abre com conteúdo preenchido, usuário revisa manualmente.schedule_plan: saída apenas de planejamento/calendário.unsupported: lacuna de plataforma registrada.
- Construir
publish_package. - Adicionar metadados, checklist, lacunas de plataforma e requisitos de aprovação.
- Executar pré-verificação para o backend selecionado antes da execução na plataforma:
- dependências de tempo de execução
- credenciais ou estado logado
- restrições de API/IP allowlist quando detectáveis
- ativos de capa/imagem/vídeo necessários
- lacunas de capacidade do backend
- Se a pré-verificação falhar, escolha um fallback documentado ou defina
publish_status: blockedcom um item concreto emplatform_gaps. Quando tanto "reparar backend preferido" quanto "backend de fallback" forem plausíveis, não alterne automaticamente. Reporte o motivo, se algum rascunho/ativo foi criado, apresente as opções de decisão e aguarde o usuário escolher. - Peça confirmação explícita antes de invocar qualquer habilidade de plataforma, a menos que o usuário já tenha solicitado preparação de rascunho/navegador/manual na mesma interação. Para saídas de formato longo do WeChat vindas da CMM Content Factory, o gate de pré-visualização local tem precedência sobre a intenção de rascunho na mesma interação: não invoque o backend de caixa de rascunho do WeChat até que o usuário tenha visto e confirmado a pré-visualização renderizada e então confirmado a criação da caixa de rascunho.
- Roteie para um backend aprovado somente após confirmação ou intenção de rascunho na mesma interação, onde nenhum gate de pré-visualização mais restritivo se aplica.
- Pare antes de qualquer postagem pública final, a menos que o usuário confirme explicitamente a ação de publicação final na mesma interação.
Roteamento
A saída padrão é um pacote de publicação + instruções de rascunho / upload manual. X, Weibo, Douyin e rascunho do WeChat são integrados (revisão antes da publicação por padrão). A coluna da direita marca plataformas cuja publicação ao vivo ainda precisa do plugin de publicação ao vivo opcional; sem o runtime relevante, siga o caminho de upload manual.
| Plataforma | Destino CMM (padrão) | Publicação ao vivo (integrado / plugin opcional) |
|---|---|---|
| WeChat Official Account | draft_box via scripts/wechat_draft.py integrado; fallback de navegador via scripts/wechat_browser_draft.mjs quando API/IP allowlist bloqueia | — (caminhos de rascunho/preenchimento são integrados) |
| X / Twitter | integrado publicação no navegador via scripts/x_publish.mjs (CDP bruto, inicia Chrome nativo, login persistente, revisão antes da publicação padrão); veja references/x-publish.md. Cai para upload manual. | — (integrado) |
integrado publicação no navegador via scripts/weibo_publish.mjs (CDP bruto, inicia Chrome nativo, login persistente, revisão antes da publicação padrão); veja references/weibo-publish.md. Cai para upload manual. | — (integrado) | |
| Xiaohongshu / Rednote nota de imagem | pacote de publicação + upload manual | plugin de publicação no navegador opcional |
| Xiaohongshu / Rednote nota de vídeo | pacote de publicação + upload manual | plugin de publicação no navegador opcional |
| Calendário multiplataforma | schedule_plan (apenas planejamento) | plugin de agendador opcional |
| Douyin | integrado publicação no navegador via sau (scripts/douyin_publish.py, padrão --review-before-publish); veja references/douyin-publish.md. Cai para manual_upload se sau indisponível. | — (integrado) |
| Bilibili | manual_upload ou unsupported | nenhum até ser verificado |
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: {}
Regras de Confirmação
- Construir
publish_packagenão requer confirmação. - Se o usuário pedir explicitamente por um rascunho de plataforma, caixa de rascunho, revisão no navegador ou pacote de upload manual na interação atual, defina
approval_status: target_intent_recordedaté que qualquer gate de pré-visualização upstream mais restritivo seja satisfeito. Após confirmação de pré-visualização e confirmação explícita de caixa de rascunho/navegador, definaapproval_status: approved_for_drafte permita a preparação do rascunho. - Invocar uma habilidade de navegador/API/plataforma requer confirmação explícita, a menos que a solicitação atual do usuário já peça claramente por preparação de rascunho/navegador/manual e nenhum gate de pré-visualização mais restritivo se aplique.
- Somente preenchimento por padrão — o usuário clica no botão de publicação final por conta própria. Para toda plataforma conduzida por navegador, o assistente preenche o rascunho/compositor/backend do criador, para no botão de publicação e entrega o navegador aberto de volta ao usuário para publicar. O assistente não clica no botão de publicação final por padrão, mesmo quando o usuário confirma — o clique de publicação é uma ação do usuário no navegador. (Justificativa: um envio assíncrono / re-renderização no momento da publicação corrompeu postagens antes, ex.: texto do corpo removido ao clicar.) O assistente preenche, então tira screenshot ou relata o estado para o usuário revisar e publicar.
--auto-publish/--submite qualquer chave de clique automático são usados apenas quando o usuário, na interação atual, pedir explicitamente por publicação automática; caso contrário, sempre pare no botão de publicação.- Nunca use
--submitou clique em botões de publicação final por padrão. - Se uma habilidade legada roteada tiver uma regra de confirmação mais restritiva, siga a regra mais restritiva.
Gate de Prontidão
| Gate | Requisito |
|---|---|
content_ready | Rascunho existe e não está bloqueado. |
asset_ready | Capa/imagens/vídeo necessários estão presentes ou a lacuna é explícita. |
metadata_ready | Título, resumo, tags, capa e notas de conta/plataforma estão preparados onde relevante. |
approval_ready | Criação de rascunho e aprovações de publicação final estão separadas. |
platform_supported | Rota da plataforma é suportada, manual ou explicitamente não suportada. |
Notas da Plataforma
- Preferir comportamento de caixa de rascunho.
- Capas são necessárias para muitos fluxos de artigo.
- API/IP allowlist ou login no navegador podem ser necessários.
- Pré-verificar credenciais da API e IP allowlist antes de fazer trabalho completo de rascunho via API, quando possível.
- Se a API falhar com erros de IP allowlist ou permissão de token, cair para a rota de navegador integrada (
scripts/wechat_browser_draft.mjs) quando os requisitos de Chrome/login passarem. - A criação de rascunho no navegador pode não definir a imagem de capa através de todos os backends. Se o backend selecionado não puder confirmar a inserção da capa, registre um
asset_gape inclua o caminho da capa emchecklist.
X
- Integrado publicar via
scripts/x_publish.mjs(nativo do CMM, CDP bruto, zero dependências npm — usa WebSocket integrado do Node ≥21). Inicia Chrome nativo com um perfil persistente (~/.cmm/chrome-x); a primeira execução solicita um login único no x.com (navegador comum, então Google/X SSO não é bloqueado), reutilizado depois. Nenhuma credencial armazenada.--cdp URLpode anexar a um Chrome com porta de debug já em execução. - O texto é injetado via CDP
Input.insertText(entrada real de teclado: escreve o Draft.js EditorState do X para que sobreviva a re-renderizações;execCommand('insertText')apenas tocava no DOM e era limpo na publicação — vejareferences/x-publish.md). Precisa da aba na frente + um clique real para focar. Mídia via CDPDOM.setFileInputFiles. - Somente preenchimento: preenche o compositor, para no botão de Postar; o usuário clica em Postar por conta própria no navegador (
--auto-publishapenas em solicitação explícita na mesma interação). - Veja
references/x-publish.md. Cai paramanual_uploadse Chrome/porta de debug/login estiver indisponível.
- Integrado publicar via
scripts/weibo_publish.mjs(nativo do CMM, CDP bruto, zero dependências npm). Inicia Chrome nativo com um perfil persistente (~/.cmm/chrome-weibo); primeira execução solicita um login único no weibo.com. Nenhuma credencial armazenada. - Preenche o
<textarea>do compositor inicial via CDPInput.insertText; imagens/vídeos (≤18 no total) via CDPDOM.setFileInputFiles. - Somente preenchimento: preenche o compositor, para no botão de Enviar; o usuário clica em Enviar por conta própria no navegador (
--auto-publishapenas em solicitação explícita na mesma interação). - Veja
references/weibo-publish.md. Cai paramanual_uploadse Chrome/porta de debug/login estiver indisponível.
Xiaohongshu / Rednote
Pré-verificação (obrigatório antes de publicar)
| Item | Limite |
|---|---|
| Título | ≤ 20 caracteres |
| Corpo (após remover linha de hashtag final) | ≤ 950 caracteres (limite da plataforma 1000, margem de segurança) |
| Quantidade de imagens | 1–9 |
| Formato das imagens | jpg / png / webp, cada ≤ 32MB |
Fluxo de publicação (nota de imagem, verificado funcional)
Passo 1 — Navegue diretamente para a página de upload de imagem
https://creator.xiaohongshu.com/publish/publish?from=menu&target=image
Não clique no menu suspenso "Publicar nota", use o URL diretamente.
Passo 2 — Verifique a conta
Use get_page_text ou javascript_tool para ler o nome da conta no canto superior direito da página. Confirme que é a conta alvo antes de continuar. Se a conta estiver errada, peça ao usuário para trocar primeiro, não continue preenchendo conteúdo.
Passo 3 — Faça upload das imagens
Limitação atual: a ferramenta de extensão do Chrome file_upload só permite fazer upload de caminhos já compartilhados na sessão; o diretório local Documents não está no escopo.
Ação atual: notifique o usuário para arrastar manualmente as imagens do Finder (abra o diretório de imagens com open) para a área de upload, em ordem (capa primeiro).
Solução pendente: no aplicativo de desktop Claude, adicione ~/.cmm/uploads/ às pastas conectadas; o pipeline de geração de imagem pode copiar automaticamente (cp) para esse diretório, permitindo upload totalmente automático.
Passo 4 — Preencha o título
Use find para localizar o input de título (placeholder: "填写标题会有更多赞哦"), use computer.type ou form_input para preencher.
Passo 5 — Preencha o corpo
A área de corpo é um div contenteditable. Use javascript_tool para injetar:
const div = document.querySelectorAll('[contenteditable="true"]')[0];
div.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, bodyText);
Hashtags são escritas diretamente no final do corpo (formato #hashtag), o Xiaohongshu as analisa automaticamente.
Após a injeção, use javascript_tool para ler o contador de caracteres da página (X/1000) e confirmar que a contagem está correta.
Passo 6 — Pare antes do botão de publicar
Após preencher todo o conteúdo, pare. Não clique em "Publicar". Informe ao usuário que o conteúdo está pronto e que ele deve revisar e clicar em publicar por conta própria.
Registro de limitação da plataforma
- Nenhum script de publicação integrado, não suporta API de caixa de rascunho.
- Limitação de caminho de upload de imagem (veja Passo 3) é uma lacuna atualmente conhecida, registre em
platform_gaps. - Publicação pública final deve ser confirmada pelo usuário de forma síncrona, não clique em seu lugar.
Douyin (integrado) e Bilibili
- Não finja que a publicação pública final está completa sem confirmação.
- Douyin: publicação no navegador integrada via
sau(vejareferences/douyin-publish.md,scripts/douyin_publish.py). Gates de pré-verificação: conta selecionada, login/cookie válido, vídeo/imagem + título/tags preparados. Padrão--review-before-publish(preenche e para no botão de publicação; o usuário clica em publicar por conta própria no navegador aberto — não clique automaticamente mesmo com confirmação). Sesauestiver indisponível, caia paramanual_uploadcom um pacote completo. - Mantenha conteúdo/ativos gerados prontos para upload manual mesmo quando o login não estiver pronto.
- Para Bilibili, produza
target: manual_uploadquando um pacote manual completo puder ser preparado; caso contrário, produzatarget: unsupported. - Inclua um item
platform_gapsexplicando login ausente, conta ausente, backend não suportado ou requisitos de upload manual.
Condições de Parada
Pare e pergunte antes de:
- Chamar APIs de plataforma.
- Abrir automação de navegador para plataformas logadas.
- Fazer upload de imagens ou vídeos.
- Clicar em qualquer botão final de publicar/postar.
- Agendar postagens externas.