微信公众号发文助手

概述

WeChat Service Publisher

Core Rules

• Default to draft only. Never publish or call freepublish/submit unless the user explicitly confirms publishing in the current turn.
• Before publishing, state the title, target account, draft id, cover file, and ask for a clear confirmation such as “确认发布”.
• Before uploading this skill to SkillHub or submitting a SkillHub review, state the slug, version, changelog, and changed files, then ask for explicit user confirmation. Do not click upload or run skillhub publish until the user confirms.
• Do not store AppSecret in skill files, workspace files, logs, or records. Use WECHAT_APPID and WECHAT_APPSECRET environment variables only for the command invocation.
• Do not add content_source_url and do not append “原文链接” to the article unless the user explicitly asks.
• Mark AI-generated content only when required by the current task or platform field. If the user explicitly says the body should not show “创作来源：内容由AI生成” or account tagline text, do not add those visible lines to the article body.
• When calling WeChat JSON APIs, send UTF-8 JSON with ensure_ascii=False and Content-Type: application/json; charset=utf-8. Do not use clients that serialize Chinese into literal uXXXX sequences for the draft/update payload; WeChat may store those escapes as visible mojibake in the draft.
• For service-account covers, prefer one 2.35:1 conversation-cover master image with a left 1:1 safe crop area:
  • Full 2.35:1 image: service-account conversation cover.
  • Left 1:1 crop: service-account list thumbnail.
  • The left 1:1 safe crop must be visually clean: no blue vertical line, no hard divider, no frame, no box edge, and no right-side card/badge/text spill.
  • Put all right-side cards and supporting visuals after a dark buffer outside the left 1:1 crop; use a soft dark gradient only, not a visible separator.
  • Use WeChat crop fields: pic_crop_235_1 = "0_0_1_1" and pic_crop_1_1 = "0_0_0.4255_1" when the 1:1 safe area is the left square of a 2.35:1 master.
• Use image2 for covers and body posters when visual generation is requested. Do not substitute other generators or simple local text cards unless the user explicitly overrides this requirement. If the image contains Chinese, inspect/crop-preview before using it.
• For images with exact Chinese titles, image2 may omit or alter words. Inspect the generated image. If the title is wrong, regenerate once; if still wrong, keep the visual and correct the title with local image editing before upload.
• Treat “标的/企业图谱” images as industry-research maps, not recommendations. Use wording such as “代表性企业/研究对象/场景” and avoid “推荐买入/股票推荐/建议买入”. Do not put “原文提到的” in target-company posters or final body copy; use cleaner wording such as “文章涉及” or omit the qualifier.
• For industry articles, always add a standalone “产业标的梳理” section. List companies/vendors/institutions mentioned in the source by industry-chain segment, prioritize A-share/H-share/China ADR/domestic supply-chain names, include each name’s segment and source-mentioned progress/watch point, and list overseas leaders under competitive landscape when relevant.
• When creating a “标的企业版” poster, it must show the article title, industry-chain segments, and representative company names by segment. It cannot be a view-only poster; company names must be visible.
• If the body poster already contains a full “产业链全景图/产业链流程图”, the “标的企业版/企业图谱” poster must not repeat that full chain-flow content. Focus the target-company poster on segment-to-company mapping, company names, watch points, and compact comparison metrics instead.
• Reject generated posters with obvious Chinese typos, ghosted/overlapping old text, label residue, or text blocks that cover bottom judgments/flow charts. Regenerate or locally repair before upload.
• After every draft update, call draft/get and verify: no literal uXXXX escapes, expected section text is present, newly uploaded images appear as img tags (WeChat may rewrite src to data-src), and removed body labels are absent.

Workflow

1. Read or extract the source article from the provided URL or public body.
2. Produce a Chinese layered industry-research summary, not a generic reading summary:
   • Core观点
   • 关键论据
   • 重要数据/案例
   • 产业链/技术脉络
   • 产业标的梳理
   • 读者启发/研究提示
3. Create or reuse visual assets:
   • Body poster: image2 vertical infographic when needed.
   • 标的企业版 poster: image2 infographic when the article contains company/vendor/institution names; must group company names by chain segment, and must avoid repeating the full产业链全景流程 if the body poster already covers it.
   • Cover: image2 2.35:1 master with left 1:1 safe title area, keeping the list crop free of separator lines and right-side content spill.
   • Export and inspect a 1:1 crop preview before using cover.
4. Build WeChat HTML:
   • Use a polished guide card, styled second-level headings, image blocks with short research-context captions, and custom numbered cards for “读者启发/研究提示” to avoid empty native list-number rendering.
   • Include account label or AI creation label only when not forbidden by the user’s latest instruction.
   • Do not include original-source link by default.
5. Save to draft box with scripts/wechat_article.py --draft-only ....
6. Read back the draft and verify text/image integrity before telling the user it is ready.
7. If the user asks to publish, first ask for confirmation. Only after confirmation run scripts/wechat_article.py --publish-confirmed ....

Script

Use scripts/wechat_article.py for deterministic API work.

Typical draft command:

WECHAT_APPID="..." WECHAT_APPSECRET="..." 
python /Users/sch/.codex/skills/wechat-service-publisher/scripts/wechat_article.py 
  --workspace /Users/sch/Documents/服务号发文 
  --title "一图看懂通信芯片：四大分类及细分方向" 
  --digest "按无线、有线、光通信、网络通信四条主线，梳理通信芯片细分方向、关键场景与产业链流程。" 
  --markdown drafts/一图看懂通信芯片_服务号草稿.md 
  --body-image assets/一图看懂通信芯片_正文图.jpg 
  --cover assets/一图看懂通信芯片_左无框1比1右分类_会话封面.jpg 
  --draft-only

Publishing command, only after explicit user confirmation:

WECHAT_APPID="..." WECHAT_APPSECRET="..." 
python /Users/sch/.codex/skills/wechat-service-publisher/scripts/wechat_article.py 
  --workspace /Users/sch/Documents/服务号发文 
  --draft-media-id "<draft_media_id>" 
  --publish-confirmed

References

• Read references/wechat_rules.md when updating the workflow, cover rules, body layout, image/title requirements, or deciding API fields.