tomevault-io Kuaifa — Markdown to WeChat, One Command
Kuaifa (快发) is a CLI tool that publishes Markdown articles to WeChat Official Accounts. It handles image uploading and draft creation — the user just writes Markdown and runs one command.
Official website: https://www.kuaifa.art（备案中可访问 https://api.kuaifa.art）
Version Check
On first use in a session, check the CLI version and compare with latest:
kuaifa --version
npm view kuaifa version
If an update is available, mention it once: npm update -g kuaifa
If users report issues, also remind them to update the skill: cd ~/.claude/skills/kuaifa && git pull origin main
Setup
Before any operation, check if kuaifa is installed and configured: kuaifa config list
If unconfigured or not installed, read references/setup.md and walk the user through the full setup process.
Workflows
Generate NEW Article + Publish
When user asks you to WRITE/GENERATE a new article, you must fetch the template's writing prompt first — it contains structure, tone, and formatting rules that make the article work with the template's design.
Fetch template prompt:
- If user specifies a template →
kuaifa template prompt <template-id> - If not →
kuaifa template prompt（reads user's remote default template automatically） - Read the output carefully and follow all its guidelines when writing.
- If user specifies a template →
Write article following the prompt guidelines.
Publish:
- If template was specified:
kuaifa publish article.md --title "文章标题" --cover cover.jpg --template <template-id> - If using default:
kuaifa publish article.md --title "文章标题" --cover cover.jpg
- If template was specified:
When to skip the template prompt: User has an existing/finished article, or explicitly says to write without template style.
Publish EXISTING Article
Already-written article — just publish directly, no template prompt needed:
kuaifa publish article.md --title "文章标题" --cover cover.jpg --template mint
Publish Image Message (newspic)
For image-focused content (photo collections, image notes, galleries):
kuaifa publish-newspic --title "今日AI资讯" --images img1.jpg img2.jpg img3.jpg --caption "精选内容"
Use this for image-primary content, NOT text articles with embedded images.
Core Commands
kuaifa publish <file>
Publishes a Markdown file to WeChat as a draft (default) or sends it immediately.
| Parameter | Required | Default | Description |
|---|---|---|---|
<file> |
Yes | — | Markdown 文件路径 |
--title <title> |
No | 文件名 | 文章标题 |
--cover <path|url> |
Yes | — | 封面图片，本地路径或 URL |
--author <name> |
No | config default-author |
作者名 |
--digest <text> |
No | "" |
文章摘要 |
--template <id> |
No | remote default_preset or default_template_id |
模板 ID 或预设名称/slug |
--source-url <url> |
No | "" |
"阅读原文"链接 |
--recommend |
No | false |
插入往期推荐 |
--draft |
No | default | 发布到草稿箱 |
--send |
No | — | 直接群发（发送后无法撤回） |
Global option: --account <name> — 放在 kuaifa 之后、子命令之前，临时使用指定的 profile。
Always default to --draft unless the user explicitly asks to send immediately.
kuaifa publish-newspic
Publishes image-focused content to WeChat.
| Parameter | Required | Default | Description |
|---|---|---|---|
--title <title> |
Yes | — | 图片消息标题 |
--images <paths...> |
Yes | — | 图片路径或 URL 列表（至少1张） |
--caption <text> |
No | "" |
图片描述文字 |
--draft |
No | default | 发布到草稿箱 |
--send |
No | — | 直接群发 |
Template Management
kuaifa template list # 列出系统模板和用户预设
kuaifa template prompt <template-id> # 获取模板的写作 Prompt
Use template prompt when you need to generate new content matching a template's style — see "Generate NEW Article" workflow above.
Configuration & Troubleshooting
For configuration details (config keys, multi-account profiles, remote settings), read references/config.md.
For troubleshooting common errors and image handling details, read references/troubleshooting.md.
Source: shirenchuang/kuaifa — distributed by TomeVault.