tuzi-post-to-wechat

仓库: tuziapi/tuzi-skills
安装量: 51
排名: #14560

安装

npx skills add https://github.com/tuziapi/tuzi-skills --skill tuzi-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 SKILL_DIR , then use ${SKILL_DIR}/scripts/.ts . 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) Use Bash to check EXTEND.md existence (priority order):

Check project-level first

test -f .tuzi-skills/tuzi-post-to-wechat/EXTEND.md && echo "project"

Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)

test
-f
"
$HOME
/.tuzi-skills/tuzi-post-to-wechat/EXTEND.md"
&&
echo
"user"
┌────────────────────────────────────────────────────────┬───────────────────┐
│ Path │ Location │
├────────────────────────────────────────────────────────┼───────────────────┤
│ .tuzi-skills/tuzi-post-to-wechat/EXTEND.md │ Project directory │
├────────────────────────────────────────────────────────┼───────────────────┤
│ $HOME/.tuzi-skills/tuzi-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
Skill defaults
Pre-flight Check (Optional)
Before first use, suggest running the environment check. User can skip if they prefer.
npx
-y
bun
${SKILL_DIR}
/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
Ensure
~/.local/share/wechat-browser-profile
is writable
Bun runtime
curl -fsSL https://bun.sh/install | bash
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
.tuzi-skills/.env
Image-Text Posting (图文)
For short posts with multiple images (up to 9):
npx
-y
bun
${SKILL_DIR}
/scripts/wechat-browser.ts
--markdown
article.md
--images
./images/
npx
-y
bun
${SKILL_DIR}
/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 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 :

Check project-level

test -f .tuzi-skills/.env && grep -q "WECHAT_APP_ID" .tuzi-skills/.env && echo "project"

Check user-level

test
-f
"
$HOME
/.tuzi-skills/.env"
&&
grep
-q
"WECHAT_APP_ID"
"
$HOME
/.tuzi-skills/.env"
&&
echo
"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: .tuzi-skills/.env (this project only)
B) User-level: ~/.tuzi-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).
API method
(accepts
.md
or
.html
):
npx
-y
bun
${SKILL_DIR}
/scripts/wechat-api.ts
<
file
>
--theme
<
theme
>
[
--color
<
color
>
]
[
--title
<
title
>
]
[
--summary
<
summary
>
]
[
--author
<
author
>
]
[
--cover
<
cover_path
>
]
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 ): npx -y bun ${SKILL_DIR} /scripts/wechat-article.ts --markdown < markdown_file

--theme < theme

[ --color < color

] npx -y bun ${SKILL_DIR} /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 .tuzi-skills/.env For Browser method : Google Chrome First run: log in to WeChat Official Account (session preserved) Config File Locations (priority order): Environment variables /.tuzi-skills/.env ~/.tuzi-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.

← 返回排行榜