baoyu-post-to-wechat

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

baoyu-post-to-wechat (Community Edition)

baoyu-post-to-wechat (社区版)

Community edition posts directly to WeChat Official Account API from local machine.

社区版可直接从本地设备调用微信公众号API发布内容。

Runtime

运行环境

Entry script:
```
scripts/wechat-api.ts
```
Run command:

bash

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts <file> [options]

入口脚本:
```
scripts/wechat-api.ts
```
运行命令:

bash

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts <file> [options]

Credentials

凭证配置

Put credentials in shared

.agents/skills/.env

dotenv

WECHAT_APP_ID=...
WECHAT_APP_SECRET=...

Resolution order:

Process env
```
.agents/skills/.env
```

将凭证存入共享的

.agents/skills/.env

文件:

dotenv

WECHAT_APP_ID=...
WECHAT_APP_SECRET=...

读取优先级顺序:

进程环境变量
```
.agents/skills/.env
```
文件

Scope

适用范围

This skill only targets draft box saving (

draft/add

), not mass-send.

本工具仅支持保存到草稿箱(

draft/add

接口)，不支持群发功能。

Publishing Rules

发布规则

Cover image uses permanent material API (
```
material/add_material
```
, type=image), obtains
```
thumb_media_id
```
.
Inline images in article HTML use
```
media/uploadimg
```
, obtains public
```
url
```
.
Save draft through
```
draft/add
```
with article payload.

need_open_comment=1

only_fans_can_comment=0

by default.

封面图调用永久素材API(
```
material/add_material
```
, type=image)，获取
```
thumb_media_id
```
。
文章HTML中的内嵌图片调用
```
media/uploadimg
```
接口，获取公开可访问的
```
url
```
。
携带文章请求参数通过
```
draft/add
```
接口保存草稿。
默认配置为
```
need_open_comment=1
```
(开启评论)、
```
only_fans_can_comment=0
```
(非仅粉丝可评论)。

Official API Mapping

官方API映射

draft/add

(

article_type=news

```
thumb_media_id
```
must be a permanent
```
media_id
```
.
```
content
```
image URLs must come from
```
media/uploadimg
```
.

```
material/add_material?type=image
```
: cover and other permanent image assets.
```
media/uploadimg
```
: inline images for article HTML content.

```
draft/add
```
(
```
article_type=news
```
):
- ```
thumb_media_id
```
  必须是永久有效的
```
media_id
```
  。
- ```
content
```
  字段中的图片URL必须来自
```
media/uploadimg
```
  接口的返回值。
```
material/add_material?type=image
```
: 用于上传封面图和其他永久图片素材。
```
media/uploadimg
```
: 用于上传文章HTML内容中的内嵌图片。

Recommended Operation Order

Input

输入格式

```
.md
```
or
```
.html
```
If input is markdown, script converts markdown first, then uploads inline images and publishes.

支持
```
.md
```
或
```
.html
```
格式文件
如果输入为Markdown格式，脚本会先完成格式转换，再上传内嵌图片并发布。

Examples

使用示例

bash

undefined

bash

undefined

Basic markdown draft publish

基础Markdown草稿发布

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts article.md

Explicit cover and metadata

显式指定封面和元数据

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts article.md
--cover Assets/Cover-Images/my-topic/cover.jpg
--title "标题"
--author "作者"
--summary "摘要"

HTML input

HTML输入格式

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts article.html --cover Assets/cover.jpg

undefined

bun .agents/skills/baoyu-post-to-wechat/scripts/wechat-api.ts article.html --cover Assets/cover.jpg

undefined

Notes

注意事项

WeChat requires inline article images to come from
```
uploadimg
```
URLs.
Cover and inline image APIs are different and both are required for stable draft publishing.

微信要求文章内嵌图片的URL必须来自
```
uploadimg
```
接口的返回值。
封面图和内嵌图片使用的API不同，二者都需正确调用才能保证草稿发布稳定。

baoyu-post-to-wechat

Original

Translation

baoyu-post-to-wechat (Community Edition)

baoyu-post-to-wechat (社区版)

Runtime

运行环境

Credentials

凭证配置

Scope

适用范围

Publishing Rules

发布规则

Official API Mapping

官方API映射

Recommended Operation Order

推荐操作流程

Input

输入格式

Examples

使用示例

Basic markdown draft publish

基础Markdown草稿发布

Explicit cover and metadata

显式指定封面和元数据

HTML input

HTML输入格式

Notes

注意事项