Md2wechat

1---2name: md2wechat3description: Convert Markdown to WeChat Official Account HTML. Use this whenever the user wants WeChat article conversion, draft upload, image generation for articles, cover or infographic generation, image-post creation, writer-style drafting, AI trace removal, or needs to inspect supported providers, themes, and prompt templates before running the workflow.4---5 6# MD to WeChat7 8Use `md2wechat` when the user wants to:9 10- convert Markdown into WeChat Official Account HTML11- inspect resolved article metadata, readiness, and publish risks before conversion12- generate a local preview artifact or upload article drafts13- inspect live capabilities, providers, themes, and prompts14- generate covers, infographics, or other article images15- create image posts16- write in creator styles or remove AI writing traces17 18## Intent Routing19 20Choose the command family before doing any publish action:21 22- Use `convert` / `inspect` / `preview` when the user wants a standard WeChat article draft (`news`), HTML conversion, article metadata, article preview, or a draft that needs `--cover`.23- Use `create_image_post` when the user says `小绿书`, `图文笔记`, `图片消息`, `newspic`, `多图帖子`, or asks to publish an image-first post rather than an article HTML draft.24- Do not route `小绿书` / `图文笔记` requests to `convert --draft` just because the user also has a Markdown article. A Markdown file can still be the image source for `create_image_post -m article.md`.25- Treat `convert --draft` and `create_image_post` as different publish targets, not interchangeable command variants.26 27## Defaults And Config28 29- Assume `md2wechat` is already available on `PATH`.30- Draft upload and publish-related actions require `WECHAT_APPID` and `WECHAT_SECRET`.31- Image generation may require extra provider config in `~/.config/md2wechat/config.yaml`.32- `convert` defaults to `api` mode unless the user explicitly asks for `--mode ai`.33- Check config in this order:34  1. `~/.config/md2wechat/config.yaml`35  2. environment variables such as `MD2WECHAT_BASE_URL`36  3. project-local `md2wechat.yaml`, `md2wechat.yml`, or `md2wechat.json`37- If the user asks to switch API domain, change `api.md2wechat_base_url` or `MD2WECHAT_BASE_URL`.38- Treat live CLI discovery output as the source of truth. Do not guess provider names, theme names, or prompt names from repository files alone.39 40## Discovery First41 42Run these before selecting a provider, theme, or prompt:43 44```bash45md2wechat version --json46md2wechat capabilities --json47md2wechat providers list --json48md2wechat themes list --json49md2wechat prompts list --json50md2wechat prompts list --kind image --json51md2wechat prompts list --kind image --archetype cover --json52```53 54Inspect a specific resource before using it:55 56```bash57md2wechat providers show openrouter --json58md2wechat providers show volcengine --json59md2wechat themes show autumn-warm --json60md2wechat prompts show cover-default --kind image --json61md2wechat prompts show cover-hero --kind image --archetype cover --tag hero --json62md2wechat prompts show infographic-victorian-engraving-banner --kind image --archetype infographic --tag victorian --json63md2wechat prompts render cover-default --kind image --var article_title='Example' --json64```65 66When choosing image presets, prefer the prompt metadata returned by `prompts show --json`, especially `primary_use_case`, `compatible_use_cases`, `recommended_aspect_ratios`, and `default_aspect_ratio`.67When choosing an image model, prefer `providers show <name> --json` and read `supported_models` before hard-coding `--model`.68 69## Core Commands70 71Configuration:72 73- `md2wechat config init`74- `md2wechat config show --format json`75- `md2wechat config validate`76 77Conversion:78 79- `md2wechat inspect article.md`80- `md2wechat preview article.md`81- `md2wechat convert article.md --preview`82- `md2wechat convert article.md -o output.html`83- `md2wechat convert article.md --draft --cover cover.jpg`84- `md2wechat convert article.md --mode ai --theme autumn-warm --preview`85- `md2wechat convert article.md --title "新标题" --author "作者名" --digest "摘要"`86 87Image handling:88 89- `md2wechat upload_image photo.jpg`90- `md2wechat download_and_upload https://example.com/image.jpg`91- `md2wechat generate_image "A cute cat sitting on a windowsill"`92- `md2wechat generate_image --preset cover-hero --article article.md --size 2560x1440`93- `md2wechat generate_cover --article article.md`94- `md2wechat generate_infographic --article article.md --preset infographic-comparison`95- `md2wechat generate_infographic --article article.md --preset infographic-dark-ticket-cn --aspect 21:9`96- `md2wechat generate_infographic --article article.md --preset infographic-handdrawn-sketchnote`97 98Drafts and image posts:99 100- `md2wechat create_draft draft.json`101- `md2wechat test-draft article.html cover.jpg`102- `md2wechat create_image_post --help`103- `md2wechat create_image_post -t "Weekend Trip" --images photo1.jpg,photo2.jpg`104- `md2wechat create_image_post -t "Travel Diary" -m article.md`105- `echo "Daily check-in" | md2wechat create_image_post -t "Daily" --images pic.jpg`106- `md2wechat create_image_post -t "Test" --images a.jpg,b.jpg --dry-run`107 108Writing and humanizing:109 110- `md2wechat write --list`111- `md2wechat write --style dan-koe`112- `md2wechat write --style dan-koe --input-type fragment article.md`113- `md2wechat write --style dan-koe --cover-only`114- `md2wechat write --style dan-koe --cover`115- `md2wechat write --style dan-koe --humanize --humanize-intensity aggressive`116- `md2wechat humanize article.md`117- `md2wechat humanize article.md --intensity aggressive`118- `md2wechat humanize article.md --show-changes`119- `md2wechat humanize article.md -o output.md`120 121## Article Metadata Rules122 123For `convert`, metadata resolution is:124 125- Title: `--title` -> `frontmatter.title` -> first Markdown heading -> `未命名文章`126- Author: `--author` -> `frontmatter.author`127- Digest: `--digest` -> `frontmatter.digest` -> `frontmatter.summary` -> `frontmatter.description`128 129Limits enforced by the CLI:130 131- `--title`: max 32 characters132- `--author`: max 16 characters133- `--digest`: max 128 characters134 135Draft behavior:136 137- If digest is still empty when creating a draft, the draft layer generates one from article HTML content with a 120-character fallback.138- Creating a draft requires either `--cover` or `--cover-media-id`.139- `--cover` is a local image path contract for article drafts. `--cover-media-id` is for an existing WeChat permanent cover asset. Do not assume a WeChat URL or `mmbiz.qpic.cn` URL can be reused as `thumb_media_id`.140- `inspect` is the source-of-truth command for resolved metadata, readiness, and checks.141- `preview` v1 writes a standalone local HTML preview file. It does not start a workbench, write back to Markdown, upload images, or create drafts.142- `convert --preview` is still the convert-path preview flag; it is not the same thing as the standalone `preview` command.143- `preview --mode ai` is degraded confirmation only; it must not be treated as final AI-generated layout.144- `--title` / `--author` / `--digest` affect draft metadata, not necessarily visible body HTML.145- Markdown images are only uploaded/replaced during `--upload` or `--draft`, not during plain `convert --preview`.146 147## Agent Rules148 149- Start with discovery commands before committing to a provider, theme, or prompt.150- Route by publish target first: article draft => `convert`; image post / 小绿书 / newspic => `create_image_post`.151- Prefer the confirm-first flow for article work: `inspect` -> `preview` -> `convert` / `--draft`.152- If the user says `小绿书`, `图文笔记`, `图片消息`, `newspic`, or asks for a multi-image post, prefer `create_image_post` even when the source content lives in Markdown.153- Prefer `generate_cover` or `generate_infographic` over a raw `generate_image "prompt"` call when a bundled preset fits the task.154- Validate config before any draft, publish, or image-post action.155- If draft creation returns `45004`, check digest/summary/description before assuming the body content is too long.156- If the user asks for AI conversion or style writing, be explicit that the CLI may return an AI request or prompt rather than final HTML or prose unless the workflow completes the external model step.157- Do not perform draft creation, publishing, or remote image generation unless the user asked for it.158 159## Safety And Transparency160 161- Reads local Markdown files and local images.162- May download remote images when asked.163- May call external image-generation services when configured.164- May upload HTML, images, drafts, and image posts to WeChat when the user explicitly requests those actions.