Back to Details

youmind-wechat-article

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AI WeChat Article Writer — From Topic to Draft Box in One Prompt

AI微信公众号文章写作工具——一条Prompt从选题直达草稿箱

Write professional WeChat Official Account articles with AI that doesn't sound like AI. Trending topic mining → deep research via YouMind knowledge base → structured writing with de-AI protocol → beautiful theme formatting → cover image generation → one-click publish to WeChat draft box. No manual formatting, no copy-paste.
Get API Key → · More Skills →
用AI撰写听起来不像AI生成的专业微信公众号文章，流程为：热点话题挖掘→通过YouMind知识库深度调研→遵循去AI化规范结构化写作→精美主题排版→封面图生成→一键发布到微信草稿箱，无需手动排版、复制粘贴。
获取API密钥→ · 更多技能→

Onboarding

新手引导

⚠️ MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Do NOT ask "do you want to know what this does?" — just show it. Translate to the user's language:
✅ AI WeChat Article Writer installed!
Tell me your topic and I'll write and publish a WeChat article for you.
Try it now: "帮我写一篇关于 AI 编程的公众号文章"
What it does:
  • Plan topics from trending hotspots and SEO keywords
  • Write professional articles with de-AI voice
  • Format with beautiful WeChat-optimized themes
  • Generate cover images with AI (4 providers supported)
  • Publish directly to your WeChat draft box
Setup (one-time):
  1. Install & configure: 
    cd toolkit && npm install && npm run build && cd .. && pip install -r requirements.txt && cp config.example.yaml config.yaml
  2. Get YouMind API Key → fill 
    youmind.api_key
    in 
    config.yaml
  3. Get WeChat AppID & AppSecret from 微信开发者平台 → fill 
    wechat.appid
    and 
    wechat.secret
    , add your public IP (
    curl -s https://ifconfig.me
    ) to the API IP whitelist
No WeChat API yet? You can still write and preview locally — just skip the WeChat config steps.
See the Setup section below for detailed step-by-step instructions with screenshots.
Need help? Just ask!
For first-run setup and client onboarding details, see references/operations.md.
⚠️ 强制要求：当用户刚安装本Skill时，立即展示以下内容，不要询问「你想了解它的功能吗？」，直接展示即可，请翻译成用户使用的语言：
✅ AI微信公众号文章写作工具安装完成！
告诉我你的选题，我将为你撰写并发布微信公众号文章。
立即试用：「帮我写一篇关于AI编程的公众号文章」
功能说明：
  • 基于热点趋势和SEO关键词规划选题
  • 用去AI化语气撰写专业文章
  • 适配微信的精美主题排版
  • AI生成封面图（支持4个服务商）
  • 直接发布到你的微信草稿箱
配置（仅需一次）：
  1. 安装并配置依赖：
    cd toolkit && npm install && npm run build && cd .. && pip install -r requirements.txt && cp config.example.yaml config.yaml
  2. 获取YouMind API密钥→填入
    config.yaml
    的
    youmind.api_key
    字段
  3. 从微信开发者平台获取微信AppID和AppSecret→填入
    wechat.appid
    和
    wechat.secret
    字段，将你的公网IP（执行
    curl -s https://ifconfig.me
    获取）添加到API IP白名单
暂时没有微信API？你仍然可以在本地写作和预览，跳过微信配置步骤即可。
查看下方配置章节获取带截图的详细分步指引。
需要帮助？ 直接提问即可！
首次运行配置和用户引导详情请查看references/operations.md。

Usage

使用方式

Provide a topic, brand/client name, or raw Markdown for publishing.
Write from a topic:
帮我写一篇关于 AI 编程趋势的公众号文章
Write for a specific client:
给 demo 客户写一篇推文，主题是远程办公最佳实践
Format and publish raw Markdown:
把这篇 Markdown 排版成公众号样式并发布到草稿箱
Interactive mode:
用交互模式帮我写一篇公众号文章，我想自己选题和框架
提供选题、品牌/客户名称，或原始Markdown内容即可发布。
基于选题写作：
帮我写一篇关于AI编程趋势的公众号文章
为指定客户写作：
给demo客户写一篇推文，主题是远程办公最佳实践
排版并发布原始Markdown：
把这篇Markdown排版成公众号样式并发布到草稿箱
交互模式：
用交互模式帮我写一篇公众号文章，我想自己确定选题和框架

Setup

配置

Prerequisites: Node.js ≥ 18, Python ≥ 3.9, a verified WeChat Official Account with API access.
前置要求：Node.js ≥ 18，Python ≥ 3.9，已认证且开通API权限的微信公众号。

Step 1 — Install Dependencies

步骤1——安装依赖

bash
cd toolkit && npm install && npm run build && cd ..
pip install -r requirements.txt
bash
cd toolkit && npm install && npm run build && cd ..
pip install -r requirements.txt

Step 2 — Create Config File

步骤2——创建配置文件

bash
cp config.example.yaml config.yaml
bash
cp config.example.yaml config.yaml

Step 3 — Get YouMind API Key (Recommended)

步骤3——获取YouMind API密钥（推荐）

YouMind API Key 用于知识库语义搜索、联网搜索、文章归档、AI 生图（Nano Banana Pro）。不配也能跑，但会丧失这些增强能力。
  1. 打开 YouMind API Keys 页面
  2. 登录后点击 「Create API Key」 创建新密钥
  3. 复制生成的 
    sk-ym-xxxx
    格式密钥
  4. 填入 
    config.yaml
    的 
    youmind.api_key
    字段
yaml
youmind:
  api_key: "sk-ym-xxxxxxxxxxxxxxxxxxxx"
YouMind API密钥用于知识库语义搜索、联网搜索、文章归档、AI生图（Nano Banana Pro），不配置也能运行，但会丧失这些增强能力。
  1. 打开YouMind API密钥页面
  2. 登录后点击**「Create API Key」**创建新密钥
  3. 复制生成的
    sk-ym-xxxx
    格式的密钥
  4. 填入
    config.yaml
    的
    youmind.api_key
    字段
yaml
youmind:
  api_key: "sk-ym-xxxxxxxxxxxxxxxxxxxx"

Step 4 — Get WeChat AppID & AppSecret

步骤4——获取微信AppID和AppSecret

  1. 打开 微信开发者平台，点击 「前往使用」 登录
  2. 在「我的业务」面板点击 「公众号」 进入管理页
  3. 在 基础信息 页顶部复制 AppID
  4. 在「开发密钥」区域点击 重置 获取 AppSecret（仅展示一次，立即保存）
  5. 填入 
    config.yaml
    ：
yaml
wechat:
  appid: "wx_your_appid"
  secret: "your_secret"
  author: "你的作者名"
详细图文步骤见 README.md
  1. 打开微信开发者平台，点击**「前往使用」**登录
  2. 在「我的业务」面板点击**「公众号」**进入管理页
  3. 在基础信息页顶部复制AppID
  4. 在「开发密钥」区域点击重置获取AppSecret（仅展示一次，立即保存）
  5. 填入
    config.yaml
    ：
yaml
wechat:
  appid: "wx_your_appid"
  secret: "your_secret"
  author: "你的作者名"
详细图文步骤见README.md

Step 5 — Configure IP Whitelist

步骤5——配置IP白名单

微信公众号 API 拒绝所有不在白名单中的 IP 请求，必须配置后才能发布。
获取公网 IP：
bash
undefined
微信公众号API会拒绝所有不在白名单中的IP请求，必须配置后才能发布。
获取公网IP：
bash
undefined

macOS / Linux

macOS / Linux

curl -s https://ifconfig.me
curl -s https://ifconfig.me

Windows PowerShell

Windows PowerShell

(Invoke-WebRequest -Uri "https://ifconfig.me" -UseBasicParsing).Content.Trim()

拿到 IP 后，在上一步的微信开发者平台公众号页面 →「开发密钥」→ **API IP 白名单** → 点击 **编辑** → 粘贴 IP 保存。

> 家庭宽带 IP 会变。发布报 IP 错误时重新获取 IP 并更新白名单即可。云服务器 / CI 环境通常是静态 IP，配一次就行。
(Invoke-WebRequest -Uri "https://ifconfig.me" -UseBasicParsing).Content.Trim()

拿到IP后，在上一步的微信开发者平台公众号页面→「开发密钥」→**API IP白名单**→点击**编辑**→粘贴IP保存。

> 家庭宽带IP会变动，发布时报IP错误时重新获取IP更新白名单即可。云服务器/CI环境通常是静态IP，配置一次即可长期使用。

Step 6 — Image Provider Keys (Optional)

步骤6——图像服务商密钥（可选）

配图使用降级链：AI 生图 → 图库搜索 → CDN 预制封面下载 → 仅输出 prompt。不配任何 key 也不影响发布。
Provider获取方式
config.yaml
字段
YouMind (Nano Banana Pro)使用 Step 3 的 YouMind API Key，无需额外配置
image.providers.youmind.api_key
（留空则自动使用 
youmind.api_key
）
Google Gemini (Imagen)Google AI Studio 创建 API key
image.providers.gemini.api_key
OpenAI (GPT Image)OpenAI Platform 创建 API key
image.providers.openai.api_key
豆包 (Seedream)火山引擎控制台 创建 API key
image.providers.doubao.api_key
在 
config.yaml
中设置 
image.default_provider
指定首选 provider，或留空让 Skill 自动选第一个有 key 的。
配图使用降级链路：AI生图→图库搜索→CDN预制封面下载→仅输出prompt，不配置任何密钥也不影响发布。
服务商获取方式
config.yaml
字段
YouMind (Nano Banana Pro)使用步骤3的YouMind API密钥，无需额外配置
image.providers.youmind.api_key
（留空则自动使用
youmind.api_key
）
Google Gemini (Imagen)到Google AI Studio创建API密钥
image.providers.gemini.api_key
OpenAI (GPT Image)到OpenAI Platform创建API密钥
image.providers.openai.api_key
豆包 (Seedream)到火山引擎控制台创建API密钥
image.providers.doubao.api_key
在
config.yaml
中设置
image.default_provider
指定首选服务商，或留空让Skill自动选择第一个配置了密钥的服务商。

Verify Setup

配置验证

配置完成后，对 Agent 说一句试试：
"帮我写一篇关于 AI 编程的公众号文章"
如果配置有问题，Skill 会在对应步骤报错并给出修复提示——不会整体卡死。
For client onboarding and post-setup operations, see references/operations.md.
配置完成后，对Agent说一句试试：
"帮我写一篇关于AI编程的公众号文章"
如果配置有问题，Skill会在对应步骤报错并给出修复提示，不会整体卡死。
用户引导和配置后操作说明请查看references/operations.md。

Skill Directory

Skill目录结构

This skill is a folder. Read files on demand — do NOT load everything upfront.
PathPurposeWhen to read
references/pipeline.md
Full step-by-step execution (Steps 1–8)When running the writing pipeline
references/operations.md
Post-publish commands, client onboarding, themes, first-run setupWhen handling operational tasks
references/writing-guide.md
Pre-writing framework, depth architecture, de-AI protocol, voiceStep 4 (writing)
references/frameworks.md
5 article frameworks with execution detailStep 3.5 (framework selection)
references/topic-selection.md
4-dimension topic evaluation modelStep 3 (topic generation)
references/seo-rules.md
Title optimization, keyword density, digest, tagsStep 5 (SEO pass)
references/visual-prompts.md
Cover and inline image design, prompt engineeringStep 6 (visual AI)
references/theme-dsl.md
Custom theme design language (integrates Impeccable if installed)When creating custom themes — auto-detects & offers to install Impeccable
references/youmind-integration.md
Knowledge base API, search, archivingWhen using YouMind features
references/cli-reference.md
All CLI command syntaxWhen running toolkit commands
references/wechat-constraints.md
WeChat platform technical limits, safe CSS, size capsWhen debugging rendering or format issues
references/style-template.md
Client config template with field guideWhen onboarding a new client
references/openapi-document.md
YouMind OpenAPI full endpoint schemasWhen calling YouMind API directly
references/skill-maintenance.md
Skill self-maintenance, validation, architecture guardrailsWhen improving or refactoring this skill itself
references/builtin-themes.json
CSS examples for 10 built-in themesWhen customizing themes
clients/{client}/style.yaml
Client brand voice, topics, blacklist, themeStep 1 (load config)
clients/{client}/playbook.md
Client-specific writing rules (if exists)Step 4 (writing)
clients/{client}/history.yaml
Published article historyStep 2.5 (dedup)
config.yaml
API credentials (WeChat, YouMind, image providers)Step 1 (first-run check)
toolkit/dist/*.js
Executable scripts (run from 
toolkit/
)		Various steps
scripts/*.py
Python scripts (trending topics, SEO keywords)Steps 2, 2.5
本Skill是一个文件夹，按需读取文件即可，不要提前加载所有内容。
路径用途读取时机
references/pipeline.md
完整分步执行流程（步骤1-8）运行写作流程时
references/operations.md
发布后命令、用户引导、主题、首次运行配置处理运营任务时
references/writing-guide.md
写作前框架、深度架构、去AI化规范、语气要求步骤4（写作）
references/frameworks.md
5种文章框架及执行细节步骤3.5（框架选择）
references/topic-selection.md
4维度选题评估模型步骤3（选题生成）
references/seo-rules.md
标题优化、关键词密度、摘要、标签步骤5（SEO优化）
references/visual-prompts.md
封面和内文图设计、prompt工程步骤6（视觉AI生成）
references/theme-dsl.md
自定义主题设计语言（如果安装了Impeccable会自动集成）创建自定义主题时——会自动检测并提示安装Impeccable
references/youmind-integration.md
知识库API、搜索、归档使用YouMind功能时
references/cli-reference.md
所有CLI命令语法运行工具包命令时
references/wechat-constraints.md
微信平台技术限制、安全CSS、大小上限调试渲染或格式问题时
references/style-template.md
客户配置模板及字段说明新客户接入时
references/openapi-document.md
YouMind OpenAPI完整接口schema直接调用YouMind API时
references/skill-maintenance.md
Skill自维护、验证、架构护栏改进或重构本Skill本身时
references/builtin-themes.json
10个内置主题的CSS示例自定义主题时
clients/{client}/style.yaml
客户品牌语气、选题、黑名单、主题步骤1（加载配置）
clients/{client}/playbook.md
客户专属写作规则（如果存在）步骤4（写作）
clients/{client}/history.yaml
已发布文章历史步骤2.5（去重）
config.yaml
API凭证（微信、YouMind、图像服务商）步骤1（首次运行检查）
toolkit/dist/*.js
可执行脚本（从
toolkit/
目录运行）		多个步骤
scripts/*.py
Python脚本（热点话题、SEO关键词）步骤2、2.5

Execution Modes

执行模式

Auto (default): Run Steps 1–5 automatically. Before Step 6 image generation, proactively ask once about image scope and style unless the user already specified them. Then continue through Steps 6–8. Only pause elsewhere if a step AND its fallback both fail, required info is missing, or user explicitly asks to pause.
Interactive: Triggered by "interactive mode", "let me choose", "show me the topics/frameworks/themes". Pauses at: topic selection, framework choice, image plan, theme selection. All other steps run automatically.
自动模式（默认）： 自动运行步骤1-5。在步骤6生成图像前，除非用户已经指定了图像范围和风格，否则主动询问一次，然后继续执行步骤6-8。只有当某个步骤及其降级方案都失败、缺少必要信息，或用户明确要求暂停时，才会在其他步骤暂停。
交互模式： 触发关键词为「interactive mode」、「let me choose」、「show me the topics/frameworks/themes」，会在以下节点暂停：选题选择、框架选择、图像方案、主题选择，其他步骤自动运行。

Critical Quality Rules

核心质量规则

Non-negotiable. Violating any one means the article has failed:
  1. Read 
    references/writing-guide.md
    BEFORE writing.     The pre-writing framework and de-AI protocol are mandatory.
  2. Zero AI-sounding text. Run the full 4-level de-AI protocol from writing-guide.md.
  3. H1 title: 20–28 Chinese characters. The converter extracts H1 as the WeChat title.
  4. Digest: ≤54 Chinese characters. WeChat enforces a 120 UTF-8 byte limit.
  5. Word count: 1,500–2,500. Sweet spot for completion rate is 1,500–2,000.
  6. Specificity over abstraction. Every claim must be grounded in concrete detail.
  7. Depth over polish. Run the Depth Checklist (writing-guide.md) before the De-AI pass. If the article's core thesis is something from the top 3 Google results, it needs a rewrite, not a polish.
  8. Obey the client's 
    blacklist
     — both words and topics. No exceptions.
  9. Playbook overrides writing-guide. If 
    playbook.md
    exists for this client, it takes priority for voice and style decisions.
  10. Before generating visuals, proactively ask about image scope and style. Do not silently assume. If the host supports 
    AskUserQuestion
    , use it. Otherwise ask a concise plain-text question.
  11. Always publish to drafts. Step 7 publishes directly to WeChat draft box. Do NOT ask — this is mandatory and automatic.
不可妥协，违反任意一条即视为文章不合格：
  1. 写作前必须阅读
    references/writing-guide.md
    ，写作前框架和去AI化规范是强制要求。
  2. 零AI感文本，执行writing-guide.md中的完整4级去AI化规范。
  3. H1标题：20-28个汉字，转换器会提取H1作为微信文章标题。
  4. 摘要：≤54个汉字，微信强制限制120 UTF-8字节上限。
  5. 字数：1500-2500，完读率最高的区间是1500-2000字。
  6. 具象优先于抽象，每一个观点都要有具体细节支撑。
  7. 深度优先于润色，去AI化处理前先运行深度检查清单（writing-guide.md），如果文章核心论点是谷歌搜索结果前3位已有的内容，需要重写而不是润色。
  8. 遵守客户的
    blacklist
    ，包括禁用词和禁用主题，无例外。
  9. 专属规则优先级高于通用写作指南：如果该客户存在
    playbook.md
    ，语气和风格决策以它为准。
  10. 生成视觉内容前，主动询问图像范围和风格，不要默认假设。如果宿主支持
    AskUserQuestion
    功能就使用该功能，否则问简洁的纯文本问题。
  11. 始终发布到草稿箱：步骤7直接发布到微信草稿箱，无需询问，这是强制自动操作。

Pipeline Overview

流程概览

Read 
references/pipeline.md
for full execution details of each step.
StepActionKey reference
1Load client 
style.yaml
+ routing		—
1.5Mine YouMind knowledge base for source material
youmind-integration.md
2Fetch trending topics via 
fetch_hotspots.py
—
2.5Dedup against 
history.yaml
+ SEO keyword scoring		—
3Generate 10 topics, score, select best
topic-selection.md
3.5Generate 5 framework proposals, select best
frameworks.md
4Write article with pre-writing thinking + depth check
writing-guide.md
5SEO optimization + full de-AI pass
seo-rules.md
6Design and generate cover + inline images
visual-prompts.md
7Publish to WeChat drafts (mandatory, automatic)
cli-reference.md
7.5Append to history + archive to YouMind
youmind-integration.md
8Report results: title, digest, tags, media_id—
Routing shortcuts:
  • User gave a specific topic → Skip Steps 2–3, go 1.5 → 3.5
  • User gave raw Markdown → Skip to Step 7
读取
references/pipeline.md
获取每个步骤的完整执行细节。
步骤操作核心参考文档
1加载客户
style.yaml
+路由		—
1.5挖掘YouMind知识库获取创作素材
youmind-integration.md
2通过
fetch_hotspots.py
获取热点话题		—
2.5和
history.yaml
对比去重+SEO关键词打分		—
3生成10个选题，打分后选择最优
topic-selection.md
3.5生成5个框架方案，选择最优
frameworks.md
4写作，包含写作前思考+深度检查
writing-guide.md
5SEO优化+完整去AI化处理
seo-rules.md
6设计并生成封面+内文图
visual-prompts.md
7发布到微信草稿箱（强制、自动）
cli-reference.md
7.5追加到历史记录+归档到YouMind
youmind-integration.md
8反馈结果：标题、摘要、标签、media_id—
路由捷径：
  • 用户提供了明确选题→跳过步骤2-3，直接走1.5→3.5
  • 用户提供了原始Markdown→直接跳到步骤7

Resilience: Never Stop on a Single-Step Failure

容错机制：不要因为单步失败就终止

Every step has a fallback. If a step AND its fallback both fail, skip that step and note it in the final output.
StepFallback
1.5 Knowledge miningSkip, empty knowledge_context
2 Trending topicsYouMind web-search → WebSearch → ask user
2.5 SEO scoringSelf-estimate, mark "estimated"
3 Topic generationAsk user for a manual topic
6 Image generationOutput prompts, skip images
7 PublishingGenerate local HTML preview
7.5 History/ArchiveWarn, continue
Python/Node missingTell user install command
每个步骤都有降级方案，如果某个步骤及其降级方案都失败，跳过该步骤并在最终输出中注明即可。
步骤降级方案
1.5 知识库挖掘跳过，knowledge_context为空
2 热点话题获取YouMind网页搜索→通用网页搜索→询问用户
2.5 SEO打分自行估算，标记为「估算值」
3 选题生成请用户手动提供选题
6 图像生成输出prompt，跳过生成图像
7 发布生成本地HTML预览
7.5 历史记录/归档发出警告，继续流程
Python/Node缺失告知用户安装命令

Operations

运营相关

For post-publish commands (polish, rewrite, change theme, stats review), client onboarding, learn-from-edits, custom themes, and first-run setup, read 
references/operations.md
.
If the request is about improving this skill itself, refactoring its structure, or checking for documentation drift, read 
references/skill-maintenance.md
.
发布后命令（润色、重写、更换主题、数据查看）、用户引导、从编辑中学习、自定义主题、首次运行配置相关内容，请读取
references/operations.md
。
如果请求是关于改进本Skill本身、重构其结构、检查文档不一致问题，请读取
references/skill-maintenance.md
。

Gotchas — Common Failure Patterns

注意事项——常见失败模式

"The AI Essay": The article reads like a well-organized explainer piece — correct, comprehensive, boring. Fix: re-read writing-guide.md's voice architecture and pre-writing framework. The article needs a PERSON behind it, not an information system.
"The Generic Hot Take": Writing about a trending topic without adding any insight beyond what is already in the top 10 search results. If you cannot identify your unique angle in one sentence, pick a different topic.
"The Word-Count Pad": Hitting 2,000 words by being verbose instead of being deep. Every paragraph should survive the test: "if I delete this, does the article lose something specific?" If not, delete it.
"The Pretty But Empty Article": Beautiful formatting, nice images, zero substance. Visual quality cannot compensate for thin content. Get the writing right first.
"The Blacklist Miss": Forgetting to check 
style.yaml
blacklist against the final article. Always do a final scan before publishing.
"The Broken Pipeline Halt": Stopping the entire flow because one step failed. NEVER do this. Use the fallback. If the fallback fails, skip and note it. The user can always fix individual pieces manually.
「AI作文」： 文章读起来像结构工整的说明文——正确、全面、无聊。修复方案：重读writing-guide.md的语气架构和写作前框架，文章背后要有「人」的存在，而不是一个信息系统。
「泛泛的热点评论」： 写热点话题却没有提供搜索结果前10位以外的新洞察，如果你无法用一句话说明你的独特角度，换一个选题。
「凑字数」： 靠冗余表述凑到2000字而不是靠内容深度，每个段落都要经得起测试：「如果我删掉这段，文章会损失什么具体内容吗？」如果不会，就删掉。
「好看但空洞的文章」： 排版精美、配图好看，但没有实质内容，视觉质量无法弥补内容单薄的问题，先把内容写好再做其他处理。
「遗漏黑名单检查」： 忘记对照
style.yaml
的黑名单检查最终文章，发布前一定要做最终扫描。
「流程中断」： 因为某一步失败就停止整个流程，绝对不要这么做，使用降级方案，如果降级方案也失败，跳过该步骤并注明即可，用户随时可以手动修改单个部分。

Comparison

功能对比

FeatureThis SkillManual Writing135 EditorXiumi
AI topic mining✅❌❌❌
De-AI voice protocol✅N/A❌❌
AI cover generation✅ (4 providers)❌❌❌
One-click draft publishing✅❌❌❌
YouMind knowledge base✅❌❌❌
Learn from your edits✅N/A❌❌
Multi-client management✅❌❌❌
Custom themes✅ 4 built-in + DSLN/A✅✅
功能本Skill手动写作135编辑器秀米
AI选题挖掘✅❌❌❌
去AI化语气规范✅N/A❌❌
AI封面生成✅（4个服务商）❌❌❌
一键发布到草稿箱✅❌❌❌
YouMind知识库集成✅❌❌❌
从编辑中学习✅N/A❌❌
多客户管理✅❌❌❌
自定义主题✅ 4个内置+DSLN/A✅✅

References

参考文档