# 公众号草稿自动推送 · 操作文档（通用版）

> **这份文档怎么用**：整份复制，发给你的 AI 助手（WorkBuddy / CodeBuddy 等能读写文件、能执行命令的 AI），再加一句「按这份文档帮我配置」。
>
> 文档里所有命令、脚本、报错都是实测过的，照着走就能跑通。
> 版本：2026-11-02　实测环境：个人主体、未认证订阅号。

---

## 第 0 节 · 给 AI 的开场指令

> 把下面这段和整份文档一起发给 AI。

```
你现在帮我做一件事：把我的公众号文章，通过官方接口自动推进草稿箱。

请先完整读一遍我发你的这份文档，然后严格按这个节奏跟我配合：

1. 先别写代码。用三句话告诉我：这套东西能做什么、不能做什么、我大概要花多久。
2. 然后把「第 2 节」的准备清单发给我，逐项问我拿到了哪些、缺哪些。
3. 缺的我去补，补一个你确认一个。不要跳步，不要假设我已经有了。
4. 七样齐了再开始装环境、建脚本。
5. 每一步做完，用一句话告诉我「现在是什么状态」，再进下一步。
6. 到了「第 7 节」的决策点，必须主动问我要不要开定时任务，不要自己替我决定。
7. 中途报错，先查「第 8 节」的错误码对照表，不要瞎猜、不要反复重试同一条命令。
8. 任何时候，不要替我点「发表」。

我的情况：
- 操作系统：______（Windows / macOS / Linux）
- 有没有云服务器：______（有 / 没有 / 不知道）
- 公众号主体：______（个人 / 公司，是否已认证）
```

---

## 第 1 节 · 这套东西能做到什么

一句话：**AI 帮你把「排版 + 传图 + 写摘要 + 配封面 + 存草稿」全干完，最后那一下「发表」你自己点。**

| 能力 | 个人主体未认证订阅号 | 已认证的企业号 |
|---|---|---|
| 拿接口凭证 | ✅ | ✅ |
| 上传封面、正文配图 | ✅ | ✅ |
| **新建草稿** | ✅ | ✅ |
| 删除草稿、列草稿 | ✅ | ✅ |
| **自动发布** | ❌ 返回 `48001` | ✅ |
| 群发推送给粉丝 | ❌ | ✅ |

**为什么个人号不能自动发布**：微信 2025 年 7 月起，回收了个人主体账号的发布接口权限。这不是技术问题，是平台规则，任何工具都绕不过去。

| 你的号 | 能到什么程度 | 代价 |
|---|---|---|
| 个人主体（未认证） | 全自动到草稿箱，手动点发表 | 0 元 |
| 企业主体 + 微信认证 | 全自动写完发出去 | 300 元/年认证费 |

**时间成本**：第一次配置 20~40 分钟。之后每篇 30 秒。

---

## 第 2 节 · 开工前，先凑齐这七样

| # | 要准备什么 | 怎么拿 | 缺了会怎样 |
|---|---|---|---|
| 1 | 一个公众号（订阅号即可） | 已有 | 没号什么都做不了 |
| 2 | **AppID** | 后台 → 设置与开发 → 基本配置 | 接口认不出你是谁 |
| 3 | **AppSecret**（开发者密码） | 同一页，点「重置」生成 | 拿不到通行证 |
| 4 | **公众号登录密码** | 你自己设的。忘了要邮箱重置 | 生成密钥那一步过不去 ← **最常卡在这** |
| 5 | **公众号绑定的邮箱** | 后台 → 设置与开发 → 账号设置 | 密码忘了就没救了 |
| 6 | **一个 IP 固定的电脑或服务器** | 见第 4 节 | 接口报 `40164` |
| 7 | 你的文稿素材 | 自己攒的，几篇都行 | 没东西可发 |

### 第 4、5 样单独说一句

绝大多数人平时都是**扫码登录**公众号，根本没设过密码。

而重置 AppSecret 时，微信会强制要求「账号密码验证」——这是死规定，绕不过去。

所以先确认：你还记得公众号的登录密码吗？

- **记得** → 直接往下走
- **不记得** → 先做这一步：退出登录 → 登录页点「忘记密码」→ 用绑定邮箱重置 → 重新登录

先把这个弄好，再开始配置。不然一定会卡在生成密钥那一步，白折腾。

---

## 第 3 节 · 拿到 AppID 和 AppSecret

### 3.1 AppID

路径：**公众号后台 → 设置与开发 → 基本配置**

页面上「开发者ID(AppID)」那一行，一长串 `wx` 开头的，复制下来。

AppID 不是秘密，不敏感，但它决定了你调用的是哪个号，别复制错。

### 3.2 AppSecret（开发者密码）

同一页，「开发者密码(AppSecret)」那一行：

- 如果显示的是 `****` 加一个「重置」按钮 → **说明还没生成过，点「重置」**
- 如果已经生成过但你没保存 → 也只能「重置」，因为**微信永远只显示一次**

### 🔴 重置流程分三步，必须走完

```
第 1 步  身份确认 —— 用管理员微信扫码
第 2 步  密码验证 —— 输入公众号登录密码
第 3 步  查看开发者密码 —— 新密钥完整显示一次
```

**关键细节（很多人栽在这）**：新密钥在第 3 步一显示，它就已经生效了；但**旧密钥要等整个流程提交完成才作废**。

如果看到密码就关窗口，会出现一个很诡异的状态：**新旧两个密钥同时都能用**。你以为已经重置了，其实没有。

所以：**扫完码、输完密码、看到密钥之后，别急着关窗口，确认流程自己走完。**

### 🔴 拿到后立刻做两件事

1. **存进密码管理器**（手机备忘录也行）。关掉页面就再也看不到了，只能重新重置。
2. **不要截图发到任何地方**。包括群、朋友圈、视频素材。真泄露了就再重置一次，流程一样。

> 想验证「重置有没有真的生效」，让 AI 按第 8 节末尾的「密钥有效性三连测」跑一遍。

---

## 第 4 节 · IP 白名单（最容易卡住的一步）

### 4.1 为什么要有这一步

微信的接口不是拿着密钥就能调，它还要确认**是谁在调**。

只有白名单里登记过的 IP，才能换到 `access_token`。不在名单里，直接报：

```
errcode: 40164  invalid ip 1.2.3.4, not in whitelist
```

### 4.2 你的机器 IP 会不会变

| 你的情况 | 能不能跑 | 代价 |
|---|---|---|
| **有云服务器**（最省事） | ✅ 长期稳定 | 一年百来块，或者复用你已有的服务器 |
| **只有自己的电脑** | ✅ 能用 | 宽带 IP 一变就要回后台改白名单，**每次都要扫码 + 输密码** |
| 家里路由器重启、换网络、出差 | ⚠️ IP 大概率变了 | 同上，改一次白名单 |

> **重要**：服务器不用为了这件事专门买。如果你已经有跑网站、跑其他项目的云服务器，直接用就行——这套脚本零依赖、跑完就退出，占不到 1MB 内存。

### 4.3 怎么加白名单

1. 先查你机器的**公网 IP**：浏览器搜「我的 IP」，或者问 AI 帮你查
2. 后台 → **设置与开发 → 基本配置 → IP白名单 → 修改**
3. 一行一个 IP，填进去，保存
4. **会弹二维码 + 要密码**，跟重置密钥一样的两道验证

⚠️ 白名单是**公众号后台自己的设置**，跟你云服务器的安全组、防火墙是两回事，别搞混。

### 4.4 白名单里已有的 IP 要不要留着

不用留。只放你**实际跑脚本的那一台**就行。

旧 IP 留着是隐患：宽带 IP 会被运营商回收再分配给别人，而那个人不需要做任何事，就已经「在白名单里」了。

---

## 第 5 节 · 装脚本（零依赖，不用装任何包）

### 5.1 目录结构

在你电脑或服务器上建一个目录，比如 `wxpub/`：

```
wxpub/
├── wxpub.py          ← 主脚本（下面第 5.2 节的完整代码）
├── .env              ← 存 AppID 和 AppSecret（权限 600）
├── .token_cache.json ← 自动生成，存 token，别删别外传
└── articles/         ← 每篇文章一个文件夹或一组文件
    ├── 001.json
    ├── 001-body.html
    └── 001-cover.png
```

### 5.2 完整脚本

> 让 AI 把下面的代码**原样**保存成 `wxpub.py`。不要「优化」，不要改结构。
> 纯标准库，Python 3.6 以上就能跑，**不需要 pip install 任何东西**。

```python
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
公众号草稿推送（单文件版，零第三方依赖，Python 3.6+）

用法：
    python wxpub.py test                    # 只测密钥和白名单
    python wxpub.py push articles/001.json  # 推一篇进草稿箱
    python wxpub.py list                    # 列出草稿箱

凭据：读同目录 .env，文件里两行
    WX_APPID=wx................
    WX_APPSECRET=................
"""

import json
import mimetypes
import os
import re
import sys
import time
import urllib.parse
import urllib.request
import uuid

API = "https://api.weixin.qq.com"
HERE = os.path.dirname(os.path.abspath(__file__))
ENV_FILE = os.path.join(HERE, ".env")
CACHE = os.path.join(HERE, ".token_cache.json")

ERR_HINT = {
    40164: "调用方 IP 不在公众号后台白名单里。去「设置与开发 → 基本配置 → IP白名单」加上当前公网 IP。",
    40013: "AppID 无效，检查有没有复制完整。",
    40125: "AppSecret 无效或已被重置。回后台重新生成一个。",
    40001: "access_token 无效。通常是对应的 AppSecret 错了，或 token 被别处刷新顶掉了。",
    45009: "接口调用次数超限（每天 2000 次）。",
    48001: "这个账号没有该接口权限。个人主体订阅号常见。",
    45110: "接口被微信回收。个人主体账号的发布/群发接口 2025 年 7 月起已回收。",
    40007: "media_id 无效，封面图可能没上传成功。",
    40009: "图片尺寸或大小不符合要求（封面建议 900x383，且小于 10MB）。",
    53404: "草稿箱满了（上限 100 篇），先去后台清理。",
}


def load_env():
    if not os.path.exists(ENV_FILE):
        return
    with open(ENV_FILE, "r", encoding="utf-8") as f:
        for line in f:
            line = line.strip()
            if not line or line.startswith("#") or "=" not in line:
                continue
            k, v = line.split("=", 1)
            os.environ.setdefault(k.strip(), v.strip().strip('"').strip("'"))


def die(msg, code=1):
    sys.stderr.write("\n[失败] %s\n" % msg)
    sys.exit(code)


def ok(msg):
    sys.stdout.write("[OK] %s\n" % msg)


def info(msg):
    sys.stdout.write("     %s\n" % msg)


def check(j, what):
    if isinstance(j, dict) and j.get("errcode"):
        c = j["errcode"]
        hint = ERR_HINT.get(c, "")
        die("%s 失败：errcode=%s errmsg=%s%s"
            % (what, c, j.get("errmsg", ""), ("\n       原因：" + hint) if hint else ""))
    return j


def http_get_json(url, timeout=30):
    req = urllib.request.Request(url, headers={"User-Agent": "wxpub/1.0"})
    with urllib.request.urlopen(req, timeout=timeout) as r:
        return json.loads(r.read().decode("utf-8"))


def http_post_json(url, payload, timeout=60):
    data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
    req = urllib.request.Request(url, data=data, headers={
        "Content-Type": "application/json; charset=utf-8",
        "User-Agent": "wxpub/1.0"})
    with urllib.request.urlopen(req, timeout=timeout) as r:
        return json.loads(r.read().decode("utf-8"))


def http_post_file(url, path, timeout=180):
    boundary = "----WXBoundary" + uuid.uuid4().hex
    name = os.path.basename(path)
    ctype = mimetypes.guess_type(name)[0] or "application/octet-stream"
    with open(path, "rb") as f:
        blob = f.read()
    head = ("--%s\r\n"
            'Content-Disposition: form-data; name="media"; filename="%s"\r\n'
            "Content-Type: %s\r\n\r\n" % (boundary, name, ctype)).encode("utf-8")
    tail = ("\r\n--%s--\r\n" % boundary).encode("utf-8")
    req = urllib.request.Request(url, data=head + blob + tail, headers={
        "Content-Type": "multipart/form-data; boundary=" + boundary,
        "User-Agent": "wxpub/1.0"})
    with urllib.request.urlopen(req, timeout=timeout) as r:
        return json.loads(r.read().decode("utf-8"))


def get_token(force=False):
    load_env()
    appid = os.environ.get("WX_APPID", "").strip()
    secret = os.environ.get("WX_APPSECRET", "").strip()
    if not appid or not secret:
        die("缺少 WX_APPID / WX_APPSECRET。\n"
            "       在同一目录建 .env 文件，写两行：\n"
            "       WX_APPID=wx................\n"
            "       WX_APPSECRET=................")
    tag = secret[:8]
    now = int(time.time())
    if not force and os.path.exists(CACHE):
        try:
            with open(CACHE, "r") as f:
                c = json.load(f)
            # 同时比对 appid 和密钥前缀，换过密钥就不会误用旧 token
            if c.get("appid") == appid and c.get("sk") == tag \
                    and int(c.get("expire_at", 0)) - 300 > now:
                info("access_token 用缓存（还剩 %d 秒）" % (int(c["expire_at"]) - now))
                return c["access_token"]
        except Exception:
            pass
    q = urllib.parse.urlencode({"grant_type": "client_credential",
                                "appid": appid, "secret": secret})
    j = check(http_get_json(API + "/cgi-bin/token?" + q), "获取 access_token")
    tok = j.get("access_token")
    if not tok:
        die("返回里没有 access_token：%s" % j)
    try:
        with open(CACHE, "w") as f:
            json.dump({"appid": appid, "sk": tag, "access_token": tok,
                       "expire_at": now + int(j.get("expires_in", 7200))}, f)
        os.chmod(CACHE, 0o600)
    except Exception:
        pass
    ok("access_token 已获取（有效期 %s 秒）" % j.get("expires_in"))
    return tok


def upload_inline_images(tok, html, base_dir):
    """正文里的本地图片先传到微信，换成 mmbiz 地址，否则发出去是裂图。"""

    def repl(m):
        src = m.group(1)
        if src.startswith("http"):
            return m.group(0)
        p = src if os.path.isabs(src) else os.path.join(base_dir, src)
        if not os.path.exists(p):
            info("正文图片找不到，已跳过：%s" % src)
            return m.group(0)
        r = check(http_post_file(
            API + "/cgi-bin/media/uploadimg?access_token=" + tok, p), "上传正文图片")
        url = r.get("url", "")
        ok("正文图片已上传：%s" % url[:60])
        return m.group(0).replace(src, url)

    return re.sub(r'<img[^>]+src="([^"]+)"', repl, html)


def upload_cover(tok, path):
    r = check(http_post_file(
        API + "/cgi-bin/material/add_material?access_token=%s&type=image" % tok, path),
        "上传封面")
    mid = r.get("media_id")
    if not mid:
        die("封面图上传后没拿到 media_id：%s" % r)
    ok("封面 media_id = %s" % mid)
    return mid


def cmd_test(force=False):
    tok = get_token(force=force)
    j = check(http_get_json(
        API + "/cgi-bin/account/getaccountbasicinfo?access_token=" + tok), "读取账号信息")
    ok("接口通了，账号信息：")
    for k in ("nick_name", "user_name", "principal_name"):
        if j.get(k):
            info("%-14s %s" % (k + ":", j[k]))
    info("verify_type:   %s  (-1=未认证, 0=已认证)" % j.get("verify_type"))


def cmd_list():
    tok = get_token()
    j = check(http_post_json(
        API + "/cgi-bin/draft/batchget?access_token=" + tok,
        {"offset": 0, "count": 20, "no_content": 1}), "读取草稿列表")
    print("草稿箱共 %s 篇\n" % j.get("total_count"))
    for it in j.get("item", []):
        n = ((it.get("content") or {}).get("news_item") or [{}])[0]
        print("  %-46s %s" % (n.get("title", "")[:46], it.get("media_id")))


def cmd_push(article_path):
    with open(article_path, "r", encoding="utf-8") as f:
        art = json.load(f)
    base = os.path.dirname(os.path.abspath(article_path))

    for k in ("title", "body", "thumb"):
        if not art.get(k):
            die("文章配置缺字段：%s" % k)
    if len(art["title"]) > 64:
        die("标题 %d 字，超过微信 64 字上限" % len(art["title"]))

    body_path = art["body"] if os.path.isabs(art["body"]) else os.path.join(base, art["body"])
    thumb_path = art["thumb"] if os.path.isabs(art["thumb"]) else os.path.join(base, art["thumb"])
    for p in (body_path, thumb_path):
        if not os.path.exists(p):
            die("文件不存在：%s" % p)

    with open(body_path, "r", encoding="utf-8") as f:
        html = f.read()

    digest = (art.get("digest") or "").strip()
    if not digest:
        digest = re.sub(r"\s+", " ", re.sub(r"<[^>]+>", "", html)).strip()[:120]

    ok("标题：%s（%d 字）" % (art["title"], len(art["title"])))
    info("摘要：%s" % digest[:60])
    info("正文：%d 字节" % len(html.encode("utf-8")))
    info("封面：%s（%.0f KB）"
         % (os.path.basename(thumb_path), os.path.getsize(thumb_path) / 1024.0))

    tok = get_token()
    html = upload_inline_images(tok, html, base)
    mid = upload_cover(tok, thumb_path)

    payload = {"articles": [{
        "title": art["title"],
        "author": art.get("author", ""),
        "digest": digest,
        "content": html,
        "content_source_url": art.get("source_url", ""),
        "thumb_media_id": mid,
        "need_open_comment": 1,
        "only_fans_can_comment": 0,
    }]}
    j = check(http_post_json(
        API + "/cgi-bin/draft/add?access_token=" + tok, payload), "新建草稿")

    print("")
    ok("已进草稿箱")
    info("media_id: %s" % j.get("media_id"))
    print("")
    print("下一步：手机微信 → 订阅号消息 → 右上角 → 草稿箱 → 预览 → 手动点发表")


def main():
    if len(sys.argv) < 2:
        print(__doc__)
        return
    cmd = sys.argv[1]
    if cmd == "test":
        cmd_test("--refresh" in sys.argv)
    elif cmd == "push":
        if len(sys.argv) < 3:
            die("用法：python wxpub.py push articles/001.json")
        cmd_push(sys.argv[2])
    elif cmd == "list":
        cmd_list()
    else:
        print(__doc__)


if __name__ == "__main__":
    main()
```

### 5.3 填凭据

在 `wxpub/` 目录下建一个 `.env` 文件，写两行：

```
WX_APPID=你的AppID
WX_APPSECRET=你的AppSecret
```

然后把它权限收紧（Linux / macOS）：

```bash
chmod 600 .env
```

> Windows 上这条命令可以跳过，但**别把 `.env` 放进任何同步网盘、也别提交到 Git**。

### 5.4 验证

```bash
# 1. 先看语法有没有问题
python wxpub.py

# 2. 测密钥和白名单
python wxpub.py test --refresh
```

成功长这样：

```
[OK] access_token 已获取（有效期 7200 秒）
[OK] 接口通了，账号信息：
     nick_name:      你的公众号名字
     principal_name: 你的主体名称
     verify_type:    -1  (-1=未认证, 0=已认证)
```

看到这个，说明**密钥对、白名单通、接口能用**，最难的部分过去了。

> ⚠️ 一定要加 `--refresh`。不加的话它可能直接读缓存，你换了密钥也测不出来，会误以为一切正常。

---

## 第 6 节 · 把第一篇推进草稿箱

### 6.1 三件东西

每篇文章准备三样：

| 文件 | 是什么 | 要求 |
|---|---|---|
| `001-body.html` | 正文 HTML | 只用内联样式，见 6.2 |
| `001-cover.png` | 封面图 | 建议 900×383，小于 10MB |
| `001.json` | 配置 | 见 6.4 |

### 6.2 正文 HTML 铁律（不遵守，排版会全乱）

微信的编辑器会**清洗**它不认识的东西。所以：

| ✅ 可以 | ❌ 会被删掉 |
|---|---|
| 内联 `style="..."` | `<style>` 标签 |
| `<p>` `<section>` `<strong>` `<img>` | `class` 属性 |
| 普通 inline CSS | JavaScript、`<script>` |

**正确的写法**：

```html
<section style="font-size:16px;line-height:1.85;color:#3f3f3f;">

  <p style="margin:0 0 22px;">这里是正文第一段，每段之间留 22px 空隙。</p>

  <p style="margin:0 0 10px;font-size:17px;font-weight:bold;
            border-left:3px solid #4a9ee0;padding-left:10px;">小标题这样写</p>

  <p style="margin:0 0 22px;">小标题下面的正文。</p>

</section>
```

几个实测好用的细节：

- 正文用 `16px`，行高 `1.85`，颜色 `#3f3f3f`——手机上看着不累
- 小标题用「左侧一条竖线 + 加粗」，微信不容易清洗掉，层次也清楚
- 段落之间统一留 `22px`，别一行行手敲 `<br>`
- **提示词、代码、命令**这类要给读者抄的内容，单独做成浅底卡片（`background:#F4F8FC` + 左边框），别混在正文里

### 6.3 封面图

- 尺寸 **900×383**（2.35:1），小于 **10MB**，jpg 或 png
- 顺序：先传封面图，拿到 `media_id`，才能建草稿——**缺封面存不了**
- 让 AI 帮你生成也行：给它标题和一句副标题，让它做一张深色底、大字、留白干净的图

### 6.4 文章配置 JSON

`articles/001.json`：

```json
{
  "title": "标题，64 字以内",
  "author": "作者名，短一点",
  "digest": "摘要，120 字以内。留空会自动截取正文开头",
  "body": "001-body.html",
  "thumb": "001-cover.png"
}
```

### 6.5 推送并回查

```bash
python wxpub.py push articles/001.json
```

成功会打印 `media_id`。然后：

```bash
python wxpub.py list
```

能看到刚推的那篇，就说明真的进箱了。

> **一定要回查**。有两次我们以为成功了，其实是排版被清洗、或者标题截断，肉眼在后台列表里根本看不出来。

---

## 第 7 节 · 决策点：要不要开定时任务（AI 必须问）

### 🔴 AI 在这里必须停下来，用下面这段话问用户

```
基础链路已经通了，你的第一篇草稿在后台。

现在有两个可选的自动化，要不要开，你自己定：

A. 每天固定时间，自动生成一篇草稿推进草稿箱。
   你只管审核和点发表。安全，推荐。

B. 连最后那一下「发表」也自动点掉。
   技术上能做，但有三件事你必须先知道：
   ① 公众号后台几天不操作就要重新扫码，定时任务半夜跑起来遇到登录失效，
      会卡在那里，你可能以为发出去了其实没发；
   ② 发表不可撤回，订阅号一天只有一次群发额度，点错了改不回来；
   ③ 平台对异常操作有风控，可能出现验证码或限制。

你要 A、要 B、两个都要，还是都不要？
```

### 7.1 定时任务 A：每天自动进草稿箱

**前提**：素材提前准备好，存在一个固定目录。

```
素材目录/
├── 未使用/
│   ├── 001-标题.md
│   ├── 002-标题.md
│   └── ...
├── 已使用/
└── 日志.txt
```

**给 AI 的定时任务提示词（直接抄）**：

```
每天早上 8:00，做这几件事：

1. 扫描「未使用」目录，按文件名排序，取第一篇。
2. 按《公众号草稿自动推送操作文档》第 6 节的排版规范，把它整理成正文 HTML：
   - 只保留内联样式，不要 style 标签、不要 class
   - 口语稿要做断句、加标点、去「啊、那么、这个、就是说」这类填充词
   - 不新增原文没有的观点、数据、例子
   - 加小标题分段，但不改变原意
3. 生成封面图，900×383。
4. 写对应的 json 配置，推送到公众号草稿箱。
5. 成功后，把素材文件移到「已使用」目录。
6. 失败就把错误码和原因追加到「日志.txt」，不要重试超过 2 次。
7. 全部做完，用一句话告诉我：今天推了哪一篇，成功还是失败。

注意：不要尝试自动发表。只到草稿为止。
```

**节奏建议**：

- 一天一篇就够。一天多篇，草稿箱很快堆到 100 篇上限，会报 `53404`
- 建议「素材准备好一周的量，剩下交给定时任务」，别一次性塞 39 篇然后不管
- 周末可以不排，留着人工挑重点

### 7.2 定时任务 B：到点自动点发表（进阶，先想清楚）

**技术上怎么做**：定时任务 → 启动浏览器 → 进公众号后台草稿箱 → 找到目标那篇 → 点「发表」。

**前提条件**（缺一个就白搭）：

1. 浏览器控制能力已开启，并且装了对应浏览器的扩展
2. **登录态必须保持**——用固定的浏览器用户目录，别用无痕窗口
3. 后台要关掉「异地登录提醒」以外的干扰弹窗

**🔴 三个必须接受的风险**：

| 风险 | 具体表现 | 后果 |
|---|---|---|
| 登录态过期 | 后台几天不操作要重新扫码 | 任务卡住，你以为发了其实没发 |
| 点错不可逆 | 草稿箱里有好几篇，按钮位置相近 | 发错文章，且无法撤回 |
| 平台风控 | 自动化操作特征明显 | 账号出现验证码或功能限制 |

**如果还是要开，必须加这三道保险**：

1. **发布前二次确认**：任务里先列出「今天要发的是哪一篇」，把标题发给你，你回「确认」才继续
2. **限定条件**：只发当天新建的草稿，且标题必须包含你约定的关键词，对不上就不发
3. **失败必告警**：任何一步失败，立刻给你发消息，绝不静默失败

**我的建议**：A 开，B 先别开。

一天点一次按钮，十秒钟的事。省这十秒，赌的是「发错一篇不可撤回」——不值。

真要做到全自动发布，正规解法是企业主体 + 微信认证（300 元/年），那才是名正言顺的自动发布。

---

## 第 8 节 · 报错对照表

| 错误码 | 意思 | 怎么办 |
|---|---|---|
| `40164` | IP 不在白名单 | 查当前公网 IP，加进后台白名单（要扫码 + 密码） |
| `40125` | AppSecret 无效 | 密钥错了或已被重置，重新生成 |
| `40013` | AppID 无效 | 复制不完整，重新复制 |
| `40001` | access_token 无效 | 通常是密钥错，或 token 被别的工具顶掉了 |
| `48001` | 无此接口权限 | 个人号没有发布权限，正常现象，只能手动点 |
| `45110` | 接口被回收 | 2025 年 7 月起的政策，个人主体号的发布/群发 |
| `45009` | 调用次数超限 | 每天 2000 次，等明天 |
| `40007` | media_id 无效 | 封面没传成功，重传 |
| `40009` | 图片不合规 | 封面改 900×383，压到 10MB 以内 |
| `53404` | 草稿箱满了 | 上限 100 篇，去后台删一些 |

### 高频坑（按踩到的概率排序）

1. **密码忘了** → 重置密钥卡在第 2 步。先走邮箱重置密码。
2. **IP 变了** → 昨天还能跑今天报 `40164`。重查 IP，重加白名单。
3. **token 被顶掉** → 如果你同时用第三方排版工具（秀米、135 等）绑了这个号，它会刷新 token，把你的顶下去，报 `40001`。**别同时用**。
4. **排版被清洗** → 用了 `<style>` 标签或 class。改成内联样式。
5. **重复推送** → `draft/add` 是「新增」不是「覆盖」。同一篇改完重推，草稿箱会多一份，记得先删旧的。

### 密钥有效性三连测（换密钥 / 怀疑泄露时跑）

不要只测新密钥能不能用，要测**旧的死没死**。让 AI 跑这三条：

```
1. 用一个故意写错的假密钥取 token  → 必须返回 40125（这是对照组，证明接口真的在校验）
2. 用新密钥取 token                → 必须成功
3. 用旧密钥取 token                → 必须返回 40125。如果还能成功，说明旧密钥没死，泄露没堵住
```

少了第 1 条对照，结论就不可信——很可能接口只是返回了缓存，看着「都能用」，其实是假象。

---

## 第 9 节 · 红线

1. **AppSecret 只放服务器，不进代码、不进截图、不进聊天记录。** 用完就删临时文件。
2. **不要用自动化去点「发表」。** 除非你已经想清楚第 7.2 节的三条风险，并且加了二次确认。
3. **不要让 AI 替你决定发什么。** 素材是你的，观点是你的，AI 只做整理和排版。
4. **排版前先看一遍原文。** AI 改口播稿时最容易犯的错是编号错位（把「第二个阶段」写成「第三个」），读者一眼能看出来。
5. **不要为了省事伪造内容。** 案例、数据、客户名，一个字都不能编。

---

## 附：跑通之后，你手上有什么

- 一条稳定的内容管道：素材 → 排版 → 封面 → 草稿箱，全程 30 秒
- 一个可以复用的排版模板：以后每篇都长一样，读者认得出来
- 一个能交给 AI 的活：41 篇存货，一周就能全部排完

**最后那句还是得说**：发出去之前，自己看一遍。AI 排版很稳，但它不知道哪句话不该说。
