baoyu-post-to-wechat

仓库: jimliu/baoyu-skills
安装量: 12.6K
排名: #163

安装

npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-post-to-wechat
Post to WeChat Official Account
Language
Match user's language
Respond in the same language the user uses. If user writes in Chinese, respond in Chinese. If user writes in English, respond in English.
Script Directory
Agent Execution
Determine this SKILL.md directory as {baseDir} , then use {baseDir}/scripts/.ts . Resolve ${BUN_X} runtime: if bun installed → bun ; if npx available → npx -y bun ; else suggest installing bun. Script Purpose scripts/wechat-browser.ts Image-text posts (图文) scripts/wechat-article.ts Article posting via browser (文章) scripts/wechat-api.ts Article posting via API (文章) scripts/md-to-wechat.ts Markdown → WeChat-ready HTML with image placeholders scripts/check-permissions.ts Verify environment & permissions Preferences (EXTEND.md) Check EXTEND.md existence (priority order):

macOS, Linux, WSL, Git Bash

test -f .baoyu-skills/baoyu-post-to-wechat/EXTEND.md && echo "project" test -f " ${XDG_CONFIG_HOME :- $HOME / .config} /baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "xdg" test -f " $HOME /.baoyu-skills/baoyu-post-to-wechat/EXTEND.md" && echo "user"

PowerShell (Windows)

if
(
Test-Path
.
baoyu-skills/baoyu-post-to-wechat/EXTEND
.
md
)
{
"project"
}
$xdg
=
if
(
$env
:XDG_CONFIG_HOME
)
{
$env
:XDG_CONFIG_HOME
}
else
{
"
$HOME
/.config"
}
if
(
Test-Path
"
$xdg
/baoyu-skills/baoyu-post-to-wechat/EXTEND.md"
)
{
"xdg"
}
if
(
Test-Path
"
$HOME
/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md"
)
{
"user"
}
┌────────────────────────────────────────────────────────┬───────────────────┐
│ Path │ Location │
├────────────────────────────────────────────────────────┼───────────────────┤
│ .baoyu-skills/baoyu-post-to-wechat/EXTEND.md │ Project directory │
├────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md │ User home │
└────────────────────────────────────────────────────────┴───────────────────┘
┌───────────┬───────────────────────────────────────────────────────────────────────────┐
│ Result │ Action │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Found │ Read, parse, apply settings │
├───────────┼───────────────────────────────────────────────────────────────────────────┤
│ Not found │ Run first-time setup (
references/config/first-time-setup.md
) → Save → Continue │
└───────────┴───────────────────────────────────────────────────────────────────────────┘
EXTEND.md Supports
Default theme | Default color | Default publishing method (api/browser) | Default author | Default open-comment switch | Default fans-only-comment switch | Chrome profile path
First-time setup:
references/config/first-time-setup.md
Minimum supported keys
(case-insensitive, accept
1/0
or
true/false
):
Key
Default
Mapping
default_author
empty
Fallback for
author
when CLI/frontmatter not provided
need_open_comment
1
articles[].need_open_comment
in
draft/add
request
only_fans_can_comment
0
articles[].only_fans_can_comment
in
draft/add
request
Recommended EXTEND.md example
:
default_theme: default
default_color: blue
default_publish_method: api
default_author: 宝玉
need_open_comment: 1
only_fans_can_comment: 0
chrome_profile_path: /path/to/chrome/profile
Theme options
default, grace, simple, modern
Color presets
blue, green, vermilion, yellow, purple, sky, rose, olive, black, gray, pink, red, orange (or hex value) Value priority : CLI arguments Frontmatter EXTEND.md (account-level → global-level) Skill defaults Multi-Account Support EXTEND.md supports managing multiple WeChat Official Accounts. When accounts: block is present, each account can have its own credentials, Chrome profile, and default settings. Compatibility rules : Condition Mode Behavior No accounts block Single-account Current behavior, unchanged accounts with 1 entry Single-account Auto-select, no prompt accounts with 2+ entries Multi-account Prompt to select before publishing accounts with default: true Multi-account Pre-select default, user can switch Multi-account EXTEND.md example : default_theme: default default_color: blue accounts: - name: 宝玉的技术分享 alias: baoyu default: true default_publish_method: api default_author: 宝玉 need_open_comment: 1 only_fans_can_comment: 0 app_id: your_wechat_app_id app_secret: your_wechat_app_secret - name: AI工具集 alias: ai-tools default_publish_method: browser default_author: AI工具集 need_open_comment: 1 only_fans_can_comment: 0 Per-account keys (can be set per-account or globally as fallback): default_publish_method , default_author , need_open_comment , only_fans_can_comment , app_id , app_secret , chrome_profile_path Global-only keys (always shared across accounts): default_theme , default_color Account Selection (Step 0.5) Insert between Step 0 and Step 1 in the Article Posting Workflow: if no accounts block: → single-account mode (current behavior) elif accounts.length == 1: → auto-select the only account elif --account CLI arg: → select matching account elif one account has default: true: → pre-select, show: "Using account: (--account to switch)" else: → prompt user: "Multiple WeChat accounts configured: 1) () 2) () Select account [1-N]:" Credential Resolution (API Method) For a selected account with alias {alias} : app_id / app_secret inline in EXTEND.md account block Env var WECHAT_{ALIAS}APP_ID / WECHATAPP_SECRET (alias uppercased, hyphens → underscores) .baoyu-skills/.env with prefixed key WECHAT_APP_ID ~/.baoyu-skills/.env with prefixed key Fallback to unprefixed WECHAT_APP_ID / WECHAT_APP_SECRET .env multi-account example :

Account: baoyu

WECHAT_BAOYU_APP_ID

your_wechat_app_id WECHAT_BAOYU_APP_SECRET = your_wechat_app_secret

Account: ai-tools

WECHAT_AI_TOOLS_APP_ID

your_ai_tools_wechat_app_id
WECHAT_AI_TOOLS_APP_SECRET
=
your_ai_tools_wechat_app_secret
Chrome Profile (Browser Method)
Each account uses an isolated Chrome profile for independent login sessions:
Source
Path
Account
chrome_profile_path
in EXTEND.md
Use as-is
Auto-generated from alias
{shared_profile_parent}/wechat-{alias}/
Single-account fallback
Shared default profile (current behavior)
CLI
--account
Argument
All publishing scripts accept
--account
:
${BUN_X}
{
baseDir
}
/scripts/wechat-api.ts
<
file
>
--theme
default
--account
ai-tools
${BUN_X}
{
baseDir
}
/scripts/wechat-article.ts
--markdown
<
file
>
--theme
default
--account
baoyu
${BUN_X}
{
baseDir
}
/scripts/wechat-browser.ts
--markdown
<
file
>
--images
./photos/
--account
baoyu
Pre-flight Check (Optional)
Before first use, suggest running the environment check. User can skip if they prefer.
${BUN_X}
{
baseDir
}
/scripts/check-permissions.ts
Checks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, API credentials, Chrome conflicts.
If any check fails
, provide fix guidance per item:
Check
Fix
Chrome
Install Chrome or set
WECHAT_BROWSER_CHROME_PATH
env var
Profile dir
Shared profile at
baoyu-skills/chrome-profile
(see CLAUDE.md Chrome Profile section)
Bun runtime
brew install oven-sh/bun/bun
(macOS) or
npm install -g bun
Accessibility (macOS)
System Settings → Privacy & Security → Accessibility → enable terminal app
Clipboard copy
Ensure Swift/AppKit available (macOS Xcode CLI tools:
xcode-select --install
)
Paste keystroke (macOS)
Same as Accessibility fix above
Paste keystroke (Linux)
Install
xdotool
(X11) or
ydotool
(Wayland)
API credentials
Follow guided setup in Step 2, or manually set in
.baoyu-skills/.env
Image-Text Posting (图文)
For short posts with multiple images (up to 9):
${BUN_X}
{
baseDir
}
/scripts/wechat-browser.ts
--markdown
article.md
--images
./images/
${BUN_X}
{
baseDir
}
/scripts/wechat-browser.ts
--title
"标题"
--content
"内容"
--image
img.png
--submit
See
references/image-text-posting.md
for details.
Article Posting Workflow (文章)
Copy this checklist and check off items as you complete them:
Publishing Progress:
- [ ] Step 0: Load preferences (EXTEND.md)
- [ ] Step 0.5: Resolve account (multi-account only)
- [ ] Step 1: Determine input type
- [ ] Step 2: Select method and configure credentials
- [ ] Step 3: Resolve theme/color and validate metadata
- [ ] Step 4: Publish to WeChat
- [ ] Step 5: Report completion
Step 0: Load Preferences
Check and load EXTEND.md settings (see Preferences section above).
CRITICAL
If not found, complete first-time setup BEFORE any other steps or questions. Resolve and store these defaults for later steps: default_theme (default default ) default_color (omit if not set — theme default applies) default_author need_open_comment (default 1 ) only_fans_can_comment (default 0 ) Step 1: Determine Input Type Input Type Detection Action HTML file Path ends with .html , file exists Skip to Step 3 Markdown file Path ends with .md , file exists Continue to Step 2 Plain text Not a file path, or file doesn't exist Save to markdown, continue to Step 2 Plain Text Handling : Generate slug from content (first 2-4 meaningful words, kebab-case) Create directory and save file: mkdir -p " $( pwd ) /post-to-wechat/ $( date +%Y-%m-%d ) "

Save content to: post-to-wechat/yyyy-MM-dd/[slug].md

Continue processing as markdown file Slug Examples : "Understanding AI Models" → understanding-ai-models "人工智能的未来" → ai-future (translate to English for slug) Step 2: Select Publishing Method and Configure Ask publishing method (unless specified in EXTEND.md or CLI): Method Speed Requirements api (Recommended) Fast API credentials browser Slow Chrome, login session If API Selected - Check Credentials :

macOS, Linux, WSL, Git Bash

test -f .baoyu-skills/.env && grep -q "WECHAT_APP_ID" .baoyu-skills/.env && echo "project" test -f " $HOME /.baoyu-skills/.env" && grep -q "WECHAT_APP_ID" " $HOME /.baoyu-skills/.env" && echo "user"

PowerShell (Windows)

if
(
(
Test-Path
.
baoyu-skills/
.
env
)
-and
(
Select-String
-
Quiet
-
Pattern
"WECHAT_APP_ID"
.
baoyu-skills/
.
env
)
)
{
"project"
}
if
(
(
Test-Path
"
$HOME
/.baoyu-skills/.env"
)
-and
(
Select-String
-
Quiet
-
Pattern
"WECHAT_APP_ID"
"
$HOME
/.baoyu-skills/.env"
)
)
{
"user"
}
If Credentials Missing - Guide Setup
:
WeChat API credentials not found.
To obtain credentials:
1. Visit https://mp.weixin.qq.com
2. Go to: 开发 → 基本配置
3. Copy AppID and AppSecret
Where to save?
A) Project-level: .baoyu-skills/.env (this project only)
B) User-level: ~/.baoyu-skills/.env (all projects)
After location choice, prompt for values and write to
.env
:
WECHAT_APP_ID=
WECHAT_APP_SECRET=
Step 3: Resolve Theme/Color and Validate Metadata
Resolve theme
(first match wins, do NOT ask user if resolved):
CLI
--theme
argument
EXTEND.md
default_theme
(loaded in Step 0)
Fallback:
default
Resolve color
(first match wins):
CLI
--color
argument
EXTEND.md
default_color
(loaded in Step 0)
Omit if not set (theme default applies)
Validate metadata
from frontmatter (markdown) or HTML meta tags (HTML input):
Field
If Missing
Title
Prompt: "Enter title, or press Enter to auto-generate from content"
Summary
Prompt: "Enter summary, or press Enter to auto-generate (recommended for SEO)"
Author
Use fallback chain: CLI
--author
→ frontmatter
author
→ EXTEND.md
default_author
Auto-Generation Logic
:
Title
First H1/H2 heading, or first sentence
Summary
First paragraph, truncated to 120 characters
Cover Image Check
(required for API
article_type=news
):
Use CLI
--cover
if provided.
Else use frontmatter (
coverImage
,
featureImage
,
cover
,
image
).
Else check article directory default path:
imgs/cover.png
.
Else fallback to first inline content image.
If still missing, stop and request a cover image before publishing.
Step 4: Publish to WeChat
CRITICAL
Publishing scripts handle markdown conversion internally. Do NOT pre-convert markdown to HTML — pass the original markdown file directly. This ensures the API method renders images as
tags (for API upload) while the browser method uses placeholders (for paste-and-replace workflow).
Markdown citation default
:
For markdown input, ordinary external links are converted to bottom citations by default.
Use
--no-cite
only if the user explicitly wants to keep ordinary external links inline.
Existing HTML input is left as-is; no extra citation conversion is applied.
API method
(accepts
.md
or
.html
):
${BUN_X}
{
baseDir
}
/scripts/wechat-api.ts
<
file
>
--theme
<
theme
>
[
--color
<
color
>
]
[
--title
<
title
>
]
[
--summary
<
summary
>
]
[
--author
<
author
>
]
[
--cover
<
cover_path
>
]
[
--no-cite
]
CRITICAL
Always include --theme parameter. Never omit it, even if using default . Only include --color if explicitly set by user or EXTEND.md. draft/add payload rules : Use endpoint: POST https://api.weixin.qq.com/cgi-bin/draft/add?access_token=ACCESS_TOKEN article_type : news (default) or newspic For news , include thumb_media_id (cover is required) Always resolve and send: need_open_comment (default 1 ) only_fans_can_comment (default 0 ) author resolution: CLI --author → frontmatter author → EXTEND.md default_author If script parameters do not expose the two comment fields, still ensure final API request body includes resolved values. Browser method (accepts --markdown or --html ): ${BUN_X} { baseDir } /scripts/wechat-article.ts --markdown < markdown_file

--theme < theme

[ --color < color

] [ --no-cite ] ${BUN_X} { baseDir } /scripts/wechat-article.ts --html < html_file

Step 5: Completion Report For API method , include draft management link: WeChat Publishing Complete! Input: [type] - [path] Method: API Theme: [theme name] [color if set] Article: • Title: [title] • Summary: [summary] • Images: [N] inline images • Comments: [open/closed], [fans-only/all users] Result: ✓ Draft saved to WeChat Official Account • media_id: [media_id] Next Steps: → Manage drafts: https://mp.weixin.qq.com (登录后进入「内容管理」→「草稿箱」) Files created: [• post-to-wechat/yyyy-MM-dd/slug.md (if plain text)] [• slug.html (converted)] For Browser method : WeChat Publishing Complete! Input: [type] - [path] Method: Browser Theme: [theme name] [color if set] Article: • Title: [title] • Summary: [summary] • Images: [N] inline images Result: ✓ Draft saved to WeChat Official Account Files created: [• post-to-wechat/yyyy-MM-dd/slug.md (if plain text)] [• slug.html (converted)] Detailed References Topic Reference Image-text parameters, auto-compression references/image-text-posting.md Article themes, image handling references/article-posting.md Feature Comparison Feature Image-Text Article (API) Article (Browser) Plain text input ✗ ✓ ✓ HTML input ✗ ✓ ✓ Markdown input Title/content ✓ ✓ Multiple images ✓ (up to 9) ✓ (inline) ✓ (inline) Themes ✗ ✓ ✓ Auto-generate metadata ✗ ✓ ✓ Default cover fallback ( imgs/cover.png ) ✗ ✓ ✗ Comment control ( need_open_comment , only_fans_can_comment ) ✗ ✓ ✗ Requires Chrome ✓ ✗ ✓ Requires API credentials ✗ ✓ ✗ Speed Medium Fast Slow Prerequisites For API method : WeChat Official Account API credentials Guided setup in Step 2, or manually set in .baoyu-skills/.env For Browser method : Google Chrome First run: log in to WeChat Official Account (session preserved) Config File Locations (priority order): Environment variables /.baoyu-skills/.env ~/.baoyu-skills/.env Troubleshooting Issue Solution Missing API credentials Follow guided setup in Step 2 Access token error Check if API credentials are valid and not expired Not logged in (browser) First run opens browser - scan QR to log in Chrome not found Set WECHAT_BROWSER_CHROME_PATH env var Title/summary missing Use auto-generation or provide manually No cover image Add frontmatter cover or place imgs/cover.png in article directory Wrong comment defaults Check EXTEND.md keys need_open_comment and only_fans_can_comment Paste fails Check system clipboard permissions Extension Support Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

← 返回排行榜