"微信公众号草稿上传" — 技能

技能详情（站内镜像，无评论）

将本地 Markdown 文章上传到微信公众号草稿箱。当用户提到"上传文章到公众号"、"发布到微信公众号"、"推送到公众号草稿"等场景时应使用本技能。本技能通过调用微信公众平台 API，自动完成 Markdown 转 HTML、封面图生成/上传、创建草稿等全流程操作。

通信与消息

作者：Sean zheng @cnspica

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.0.0

统计：⭐ 0 · 35 · 0当前安装量· 0历史安装量

⭐ 0

安装量（当前） 0

🛡 VirusTotal：Pending · OpenClaw ：可疑

Package：cnspica/wechat-mp-draft-cnspica

安全扫描（ClawHub）

VirusTotal：Pending
OpenClaw ：可疑

OpenClaw 评估

The skill mostly does what it says (convert Markdown and call the WeChat MP APIs), but the bundle includes hard-coded AppID/AppSecret and a test runner that executes the upload with those credentials—an unexpected secret in the repo that warrants caution.

目的

The code (markdown → HTML, cover generation, upload to WeChat material API, create draft) matches the skill description. However, the repository contains a test runner (scripts/run_upload.py) that hard-codes AppID, AppSecret and an absolute path to a Markdown file — these embedded credentials are not required by the SKILL.md usage examples and are unexpected.

说明范围

SKILL.md instructs only running scripts/upload_draft.py with CLI-supplied AppID/AppSecret and local file paths (appropriate). The included scripts read local Markdown and cover image files (expected). The presence of scripts/run_upload.py that overrides sys.argv and execs upload_draft.py means a user or automated tooling could accidentally run an upload using embedded credentials — this expands the effective scope if someone runs that file.

安装机制

No install spec is provided (instruction-only style). The skill's code uses only standard Python libraries and optionally Pillow; there is no downloaded archive or third-party installer in the manifest.

证书

The skill does not request environment variables, and the runtime behavior expects AppID/AppSecret provided as CLI args (proportional). However, scripts/run_upload.py contains hard-coded credentials (AppID and AppSecret) and an absolute local path — embedding credentials in shipped code is a secret-leak risk and disproportionate to the stated purpose.

持久

The skill does not request persistent/automatic inclusion (always:false) and does not modify other skills or system configuration. It only writes local files (HTML drafts) as part of normal operation.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「"微信公众号草稿上传"」。简介：将本地 Markdown 文章上传到微信公众号草稿箱。当用户提到"上传文章到公众号"、"发布到微信公众号"、"推送到公众号草稿"等场景时应使用本技能。本技能通…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/cnspica/wechat-mp-draft-cnspica/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: wechat-mp-draft
description: 将本地 Markdown 文章上传到微信公众号草稿箱。当用户提到"上传文章到公众号"、"发布到微信公众号"、"推送到公众号草稿"等场景时应使用本技能。本技能通过调用微信公众平台 API，自动完成 Markdown 转 HTML、封面图生成/上传、创建草稿等全流程操作。
---

# 微信公众号草稿上传技能

## 技能概述

本技能将本地 Markdown 文件自动转换为微信公众号格式的 HTML，上传封面图素材，并通过微信公众平台 API 创建草稿，最终文章出现在公众号后台「草稿箱」中等待发布。

## 使用前提

在执行前，向用户确认以下信息：

1. **AppID** 和 **AppSecret**（公众平台后台 → 开发 → 基本配置）
2. **Markdown 文件路径**（本地绝对路径）
3. **封面图路径**（可选；不提供则自动生成绿色渐变占位图）
4. **作者名称**（可选）
5. **文章摘要**（可选，不填则自动截取正文前 100 字）

> ⚠️ **IP 白名单**：若运行环境 IP 未加入白名单，API 会返回 40164 错误。提示用户在公众平台 → 开发 → 基本配置 → IP白名单中添加当前出口 IP。

## 执行流程

### Step 1：检查 Python 环境

```bash
python --version
```

若 Python 不可用，提示用户安装 Python 3.7+。

可选安装 Pillow（用于生成高质量封面图）：
```bash
pip install Pillow
```
不安装 Pillow 也可运行（会自动下载免费占位图）。

### Step 2：运行上传脚本

脚本位于本技能的 `scripts/upload_draft.py`。

**基础用法（自动生成封面）：**
```bash
python scripts/upload_draft.py 
  --appid "YOUR_APPID" 
  --secret "YOUR_APPSECRET" 
  --md "C:/path/to/article.md" 
  --author "作者名"
```

**指定封面图：**
```bash
python scripts/upload_draft.py 
  --appid "YOUR_APPID" 
  --secret "YOUR_APPSECRET" 
  --md "C:/path/to/article.md" 
  --cover "C:/path/to/cover.jpg" 
  --author "作者名" 
  --digest "文章摘要，最多120字"
```

**参数说明：**

| 参数 | 必填 | 说明 |
|------|------|------|
| `--appid` | ✅ | 公众号 AppID |
| `--secret` | ✅ | 公众号 AppSecret |
| `--md` | ✅ | Markdown 文件绝对路径 |
| `--cover` | ❌ | 封面图路径（JPG/PNG），不填则自动生成 |
| `--author` | ❌ | 文章作者 |
| `--digest` | ❌ | 摘要（最多120字），不填则截取正文 |

### Step 3：验证结果

脚本成功输出示例：
```
✅ 获取 access_token 成功（有效期 7200 秒）
✅ 封面图上传成功，media_id = xxx
✅ 草稿创建成功！草稿 media_id = yyy
🎉 完成！文章《智慧养老正式进入AI时代》已成功上传至草稿箱。
```

告知用户登录 [微信公众平台](https://mp.weixin.qq.com/) → **内容** → **草稿箱** 查看文章。

## 常见问题处理

| 错误 | 原因 | 解决 |
|------|------|------|
| `40001` access_token 无效 | AppID/AppSecret 错误 | 重新确认凭证 |
| `40164` IP 不合法 | 当前 IP 不在白名单 | 在公众平台添加 IP |
| `40007` media_id 无效 | 封面图上传失败 | 检查图片格式和大小（≤10MB） |
| 封面图下载失败 | 无网络或 Pillow 未装 | 手动提供一张 JPG/PNG 封面图 |

## 参考资料

详细 API 规范见 `references/wechat_api.md`。