Przejdź do treści
Biblioteka skilli
Marketing i treści · Pisanie

aceld-wechat

/aceld-wechat

Pisze artykuł na WeChat, przekształca Markdown w układ HTML i wkleja go do edytora jako szkic, bez publikacji.

Repozytorium
aceld-skill ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

93/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena13 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
4
Komentarze HTML
4
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
  • SKILL.md zawiera komentarze HTML (4). Nie widać ich w podglądzie Markdown, a model je czyta.

Skrypty: scripts/doctor.py, scripts/md2wechat.py, scripts/preview.py, scripts/publish.py

Co robi i kiedy

Pisze artykuł na WeChat, przekształca Markdown w układ HTML i wkleja go do edytora jako szkic, bez publikacji.

Oryginalny opis (EN)

微信公众号文章编写与发布全流程。涵盖「怎么写」(标题公式、现象→病机→解法骨架、去 AI 味、配图节奏)与「怎么发」(markdown 转微信内联样式 HTML、零凭据粘贴进编辑器、图片自动转 mmbiz、只存草稿绝不发表)。当用户要写公众号文章、把 markdown 排成公众号版式、发布到微信公众号草稿箱、或遇到「粘贴后正文变空/图片裂了/标题填不进去」时使用。

Jak działa

  1. 零、这个技能不碰你的账号
  2. 一、第一次使用
  3. 二、写文章
  4. 三、排版:markdown → 微信 HTML
  5. 四、发布:粘进编辑器 → 存草稿
  6. 五、常见故障
  7. 六、文件
Sekcje z nagłówków SKILL.md, w oryginale · 239 linii, 699 słów
Podgląd SKILL.md
---
name: aceld-wechat
description: 微信公众号文章编写与发布全流程。涵盖「怎么写」(标题公式、现象→病机→解法骨架、去 AI 味、配图节奏)与「怎么发」(markdown 转微信内联样式 HTML、零凭据粘贴进编辑器、图片自动转 mmbiz、只存草稿绝不发表)。当用户要写公众号文章、把 markdown 排成公众号版式、发布到微信公众号草稿箱、或遇到「粘贴后正文变空/图片裂了/标题填不进去」时使用。
---

<!-- aceld-rollout:begin 资料检索 v1 -->
> ### ⚑ 缺外部文章 / 案例 / 数据?先取资料包
> 调用 `aceld-websearch` 生成资料包(近 180 天 · T1/T2 权威 · 可核验高指标 · 可读原文链接),
> 读 `research/<slug>/pack/pack.md` 取链接;`verify.py` 显示 PASS 才可用,**不要自己临时搜几篇当依据,也不要改写 `pack.*`**。
<!-- aceld-rollout:end -->

# 公众号文章:编写与发布

两条线:**写得像人话**(`references/article-style.md`)、**发得不丢样式**(`references/wechat-constraints.md`)。
脚本负责把 markdown 变成微信能吃的 HTML,再把它塞进编辑器。

<!-- aceld-rollout:begin 开工前置检查 v1 -->
> ### ⚑ 开工前置检查(每次先跑,30 秒)
>
> ```bash
> python ~/.workbuddy-ai/skills/aceld-findskill/scripts/preflight.py "本次任务关键词"
> ```
>
> 出三种结论,照做即可:
> **① 直接用本地 X** → 继续按本技能做;
> **② 本地没有 / 线上更强** → 走 `aceld-findskill` 检索 + 体检,别硬编;
> **③ 上游有更新** → 先看差异再决定。
>
> **为什么强制**:技能生态每周在变,本技能写的做法可能已有更便宜的替代。
> 不检查就开工,等于用去年的地图走今年的路。
<!-- aceld-rollout:end -->

---

## 零、这个技能不碰你的账号

**硬约束:仓库里没有任何凭据。**

| 东西 | 在哪 |
|---|---|
| 账号密码 | 不存在。登录靠你自己在 Chrome 里扫码 |
| AppID / AppSecret | 不使用。走的是浏览器界面,不是官方 API |
| Cookie / token | 不落盘。token 每次从地址栏现抓,进程结束就没了 |
| 作者名 / 公众号名 | 只在 `assets/theme-*.json` 里作为**示例文案**,改成你自己的 |

想把个人文案(署名、banner)放本地而不进仓库,就用 `assets/theme.local.json`
并确认 `.gitignore` 里有它。

---

## 一、第一次使用

### 1. 启动一个带调试端口的 Chrome

普通打开 Chrome 是不行的,必须带 `--remote-debugging-port`。
建议用**独立 profile**,这样和你日常浏览器互不干扰,登录态也会保留:

```bash
# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" \
  --remote-debugging-port=9222 \
  --user-data-dir="%USERPROFILE%\.chrome-wechat" \
  https://mp.weixin.qq.com/

# macOS
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-port=9222 \
  --user-data-dir="$HOME/.chrome-wechat" \
  https://mp.weixin.qq.com/
```

### 2. 扫码登录

在弹出的窗口里扫码。**判断是否成功只看一件事**:地址栏变成
`https://mp.weixin.qq.com/cgi-bin/home?...&token=数字`。
首屏那个二维码渲染出来不代表失败,等几秒它自己会跳。

### 3. 自检

```bash
python scripts/doctor.py
```

全 `[OK]` 就说明:端口通、已登录、有编辑页、选择器没失效、按钮找得到。
任何一项 `[X]`,按提示处理(微信改版时选择器会失效,见 `references/wechat-constraints.md` 第五节)。

---

## 二、写文章

先读 `references/article-style.md`,核心就四条:

1. **标题**带数字、带判断,副题里的数字正文要对得上
2. **开篇三段式**:接上文 → 转折 → 先给结论
3. **骨架**:现象 → 病机 → 解法,现象和解法数量必须一一对应
4. **去 AI 味**:删「首先/其次/总之」,短句,给数字不给形容词

配图用 `aceld-diagram` 出图,放 `文章配图/` 下,正文用
`![图注](文章配图/v2/fig01.png)` 引用。图注写「这张图说明了什么」。

---

## 三、排版:markdown → 微信 HTML

```bash
python scripts/md2wechat.py \
  --src 第六课(文字版).md \
  --out work/公众号版.html \
  --theme assets/theme-aceld.json
```

图片在这一步**不读盘**,只把 `![图注](文章配图/v2/fig01.png)` 里的路径
剥掉 `文章配图/` 前缀,写成占位 URL `http://127.0.0.1:8792/v2/fig01.png`。
真正的图片文件由下一步 `publish.py --img-dir` 读取并转 base64。

输出会自检并打印:

```
TITLE     : 凡人AI修仙(第六课):守心之道 —— 智能体长任务,为什么不跑偏
HTML_LEN  : 112245
H2/H3     : 14 / 22
IMG_REF   : 12  IMG_TAG: 28
GRADIENT  : 0(必须为 0,微信会拦渐变)
```

**`GRADIENT` 不是 0 就别往下走**,粘贴会被「内容结构检测」拦掉,正文变空且没有报错。

支持的 markdown 语法:

| 语法 | 渲染成 |
|---|---|
| `## 一、xxx` | 章节卡(PART 01 标签 + 圆形序号徽章) |
| `## 开场` / `## 写在最后` / `## 下节预告` | 特殊徽章(序 / 终 / 预告) |
| `### 3.1 xxx` | 左侧橙竖条小标题 |
| 小节第一段 | 导语块(浅底 + 左竖条 + 加粗) |
| `> 引用` | 蓝色左边框引用块 |
| `==高亮==` | 黄底棕字 |
| `**加粗**` | 深蓝加粗 |
| `` `代码` `` | 行内代码 |
| ``` 代码块 ``` | pygments 内联高亮 |
| 表格 | 斑马纹表格 |
| `---` | 分隔线图片 |
| `![图注](路径)` | 居中图 + 图注 |

### 换配色 / 换文案

复制 `assets/theme-aceld.json` 改 `colors`,`banner` / `footer` 设成 `null` 就不渲染。
也可以用 `--no-banner --no-footer` 单独关掉。

### 发布前先看效果

```bash
python scripts/preview.py --html work/公众号版.html --img-dir 文章配图 --out-dir preview
```

不用登录、不用开调试端口:把占位图片换成本地文件,按 414px 手机宽度渲染,
自动挑「开头 / 配图 / 代码块」三段出图,上下边缘吸附到段落边界。
打印 `OVERFLOW_X` 就说明有东西撑破了视口,粘进微信前先修。
给 README 出效果图、或肉眼过一遍排版,都用它。

---

## 四、发布:粘进编辑器 → 存草稿

```bash
# 已有编辑页
python scripts/publish.py --html work/公众号版.html --meta work/meta.json --img-dir 文章配图

# 让脚本自己开一个新建图文页
python scripts/publish.py --html work/公众号版.html --meta work/meta.json --img-dir 文章配图 --new

# 只检查图片和体积,不动浏览器
python scripts/publish.py --html work/公众号版.html --meta work/meta.json --dry-run
```

流程与判定:

```
close_dialogs → 全选 → 写剪贴板(base64) → Control+V
  → 校验 imgs > 0        ★ 闸门:为 0 立即退出,绝不用空文覆盖草稿
  → 填标题(三路兜底)
  → 轮询 data: → mmbiz(最多 3 分钟)
  → 点「保存为草稿」
  → 打印 FINAL {saved:true, mmbiz:28, data:0}
```

看到这个才算成功:

```json
{"title":"...","mmbiz":28,"data":0,"h2":14,"saved":true,"failed":false}
```

`data` 必须为 0 —— 不为 0 说明还有图没传上去,存草稿后打开就是裂图。

### 改已有草稿

编辑页 URL 带 `appmsgid=` 时,脚本会 reload 后**全选替换**,存草稿 = 更新同一份,
不会产生重复草稿。所以改文章的正确做法是:先打开原来那篇草稿,再跑脚本。

### 它永远不会点「发表」

脚本里没有「发表」这个动作。发布这一步留给人,自己看一眼预览再点。

---

## 五、常见故障

| 现象 | 原因 | 处理 |
|---|---|---|
| 粘贴后正文是空的 | 用了 `linear-gradient`,被「内容结构检测」拦了 | 改纯色,重跑 `md2wechat.py` 看 `GRADIENT: 0` |
| 粘贴后正文是空的(没渐变) | 上一次的模态框还留着 | `close_dialogs()` + `reload()`,再重跑 |
| 图片全是裂图 | 还是 `data:` 没转 mmbiz | 等久一点;或图太大,降到 1200px 分批贴 |
| 标题保存后没了 | 直接给 `textarea#title` 赋值 | 必须往 `#js_title_main .ProseMirror` 真实输入,见 constraints 第五节 |
| 点标题点不进去 | 点在元素正中心,被 `.title-editor-overlay` 吃了 | 点 `rect.x + 30` |
| 「请重新登录」 | 编辑器 URL 少了 `token=` | 从首页标签页现抓 token |
| `connect_over_cdp` 报错 | Chrome 没带调试端口 | 按第一节重启 |
| 选择器全失效 | 微信改版 | 跑 `doctor.py` 看哪个失效,按 constraints 第五节重找 |

---

## 六、文件

```
aceld-wechat/
├── SKILL.md
├── scripts/
│   ├── md2wechat.py      markdown → 内联样式 HTML(自检渐变)
│   ├── preview.py        手机端效果图 / 发布前排版检查
│   ├── publish.py        粘贴 → mmbiz → 存草稿(零凭据,绝不发表)
│   └── doctor.py         发布前环境自检
├── assets/
│   └── theme-aceld.json  示例主题(配色 + banner/footer 文案)
└── references/
    ├── wechat-constraints.md   微信编辑器 8 类硬约束 + 踩坑记录
    └── article-style.md        标题、结构、去 AI 味、自检清单
```

依赖:`playwright`(连 CDP)、`pillow`(压图)、`pygments`(代码高亮,可选)。

```bash
pip install playwright pillow pygments
```
Pliki w paczce (8)
  • SKILL.md 9 KB
  • assets/theme-aceld.json 1 KB
  • references/article-style.md 5 KB
  • references/wechat-constraints.md 5 KB
  • scripts/doctor.py 4 KB
  • scripts/md2wechat.py 20 KB
  • scripts/preview.py 10 KB
  • scripts/publish.py 14 KB

Wersje

W bazie nie ma innych skilli o nazwie aceld-wechat.

Migawka bazy z 13.11.2026 · wersja paczki 15216c9fb91e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100wechat-mp-publish
    Renderuje artykuł do HTML pod WeChat, tworzy szkic przez oficjalne API i wysyła go do publikacji po potwierdzeniu.
  • 100xiumi-wechat-article
    Przygotowuje artykuł na WeChat w edytorze Xiumi: brief, tytuł, streszczenie, układ, grafiki i kontrolę przed publikacją.
  • 100space-wechat-layout
    Zamienia artykuł lub szkic Markdown w gotowy do wklejenia do WeChat układ HTML, z lokalnym podglądem i kilkoma stylami.
  • 93wechat-mp-publisher
    Zapisuje lub aktualizuje długi artykuł na konto WeChat Official Account jako szkic: Markdown, obrazy, tytuł, autor i okładkę.
  • 95wechat-article
    Pisze gotowe do publikacji artykuły na konto WeChat Official Account: od doboru tematu i stylu po grafiki i tytuł.
  • 95aceld-skill-rollout
    Wdraża nową zdolność we wszystkich skillach zestawu: audyt, bezpieczne wstawienie bloków, synchronizację i weryfikację końcową.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.