「引言金句或核心洞察一句话。」
—— 出处
「核心观点一句话。」
✅ 适合场景：具体说明
❌ 不适合：具体说明
` 标题格式：`一、项目名称
`
六段式允许章节标题，与编号盘点格式并列，agent 根据文章内容类型自行选择。
### 七、格式规范速查
| 元素 | 规范 |
|------|------|
| 项目数量 | 3-8 个，太多则流水账，3 个以下撑不起篇幅 |
| 单项目字数 | 200-400 字，不要展开太多细节 |
| 元信息表 | 必须有，放在文末或每个项目简介后 |
| 适合/不适合 | 每项目必写，划清边界才有参考价值 |
| 配图 | 每个项目至少一张截图 or GIF，mmbiz URL 必须嵌入 HTML |
| 数据来源 | 结尾注明：`📌 数据来源：GitHub Trending，YYYY-MM-DD` |
| Star 号召 | 结尾加 `如果你觉得这几个项目有意思，欢迎 Star 支持开源 🧬` |
## 工作流
```
获取文章内容（用户粘贴 / mmx vision） → 生成封面图 → 准备内容图 → 上传封面（thumb） → 上传内容图（mmbiz） → 写文章（含 mxbiz URL） → 创建草稿 → 完成
```
### 获取微信文章内容
> ⚠️ **重要更新（2026-05-17）**：9Router 两个实例均已下线，Anspire API (`api.anspire.cn`) DNS 从服务器环境不可达。Bocha Search API (`open.bocha.cn/api/v1/search`) 是当前最有希望的 Web 搜索备选，需用户提供 API Key。详见 `references/wechat-fetch-fallbacks.md`。
## 获取微信文章内容 / FlowUs 内容提取
> 📌 **FlowUs 数据库记录处理（2026-05-20 新增）**：当 FlowUs 页面是数据库记录类型（`parent.type == "database_id"`）时，内容 URL 存储在 `properties['网址链接']['url']`，而不是 `content[]` block 中。详见 `references/flowus-database-record.md`。
>
> ⚠️ **微信文章链接失效处理**：从 FlowUs 数据库记录提取的微信文章 URL（如 `mp.weixin.qq.com/s?...`），在无登录 cookie 的环境下访问会返回"未知错误"。**不要尝试用 curl/浏览器抓取**，直接请用户提供文章正文。
**当前可用方案（按可靠性排序）：**
1. **用户复制粘贴**（最可靠）：请用户打开微信文章 → 全选 → 复制正文 → 粘贴。不需要格式，纯文字即可
2. **mmx vision describe**：用户截图发给你 → AI 分析截图内容 → 作为写作参考
3. **Bocha Web Search API**（需要用户提供 key）：调用 `POST https://open.bocha.cn/api/v1/search`，可搜索到微信文章的标题/摘要/引用内容。格式：`{"query": "site:mp.weixin.qq.com <关键词>", "count": 10, "summary": true}`，Header：`Authorization: Bearer `
4. **自己重写**（信息不完整）：根据标题/主题从 GitHub/官网/其他信息源重建内容
**已知无效方案（不要再试）：**
- 9Router fetch-combo / jina/fetch — 两个实例均返回 404
- Anspire Search — `api.anspire.cn` DNS 从服务器环境不可达（浏览器可访问 www.anspire.cn 但 API 域名无法解析）
- 搜狗微信搜索 — 超时不可用
- Scrapling StealthyFetcher / Browserbase CDP — WeChat 滑块验证码无法绕过
- Google Cache / Wayback Machine — 无缓存
> ⚠️ **微信滑块验证码是最后一层墙**：微信「混元AI」反爬系统在服务端直接拦截所有自动化请求，无需任何人机交互即可判断并返回验证页。**不要浪费时间尝试新工具**。
**⚠️ WeChat URL / Social Media Post 项目识别陷阱（republish 场景）**：
当用户提供微信文章链接或社交媒体帖子引用项目时，不要假设帖子/链接中的名字就是真实 GitHub 用户名。**必须先用 GitHub 搜索交叉验证**：
```
# 错误假设：帖子里的名字 = GitHub 用户名
# 例：用户说「Berry Xia 针对 AI API 中转站...」
# → 误以为 GitHub 用户是 berryxia → GET /repos/berryxia/api-relay-audit → 404
# → 实际 repo 在 toby-bridges/api-relay-audit（Stars 469，@li9292）
#
# 例2：https://mp.weixin.qq.com/s/6SkupSxgM9618Y-O7ZJUbA
# → 误以为是 CodeGraph（上一个项目）
# → 实际是 academic-research-skills
# 正确做法：用 GitHub Search API 搜索项目关键词
curl -s "https://api.github.com/search/repositories?q=api-relay-audit+OR+relay+audit" \
-H "Accept: application/vnd.github.v3+json"
# 从结果中取 Stars 最高、描述最相关的匹配项
# ⚠️ 不要直接拼 /repos/{handle}/{repo} —— 这个会 404
# 必须先搜索，确认真实 owner 和 repo 名
```
**陷阱的本质**：社交媒体分享者（@berryxia）和 GitHub 仓库 owner（toby-bridges）经常不是同一个人。帖子作者可能是项目使用者/宣传者而非作者，或转发了真正的 repo 链接。
**处理流程**：
1. 从帖子提取项目关键词（如「api-relay-audit」）
2. GitHub Search API 搜索关键词
3. 取 Stars 最高的匹配项
4. 以搜索结果的 `full_name` 和 `owner` 为准写入文章（作者署名用 repo 实际 owner）
工作流：
1. 用 `mmx search` 搜索微信文章标题
2. 从搜索摘要中识别真实项目（很多微信文章标题不直接提 GitHub 地址）
3. 用 GitHub API 查真实项目的 stars / description / README
4. 以真实项目信息为准写文章，不要用上一个项目的上下文
**republish 场景的正确处理：** 用户粘贴已有公众号文章内容后，需要用自己的话重写核心观点（避免抄袭），按流式叙事格式重组文章结构。
**获取内容后的处理：**
- 纯文字内容 → 按 format-guide.md 转换为公众号文章
- 如果用户粘贴的是已发布公众号文章 → 了解核心观点和结构 → 用自己的话重写（避免抄袭）
**复扒发布 Fallback（重要经验）**：
当用户说「重新发布」「用 zhiliGitHub 重新写作并发布」但原始内容源不可达（FlowUs 搜不到 / API 报错 / 链接 404）时，按 `references/republish-fallback-workflow.md` 的标准流程处理：
1. 先查 `/root/` 本地缓存文件（标准命名：`article_{slug}.md`、`{slug}-article.txt`）
2. 本地有 → 读取内容重建 HTML
3. 本地无 → 尝试原始来源（GitHub API / 用户粘贴 / mmx vision）
4. 详见 `references/republish-fallback-workflow.md`
## 标准发布流程（重要经验）
### 完整顺序（必须按此顺序执行）
> 🚫 **图片 Gate 规则（已硬编码到 publish_zhili.py）**：
> HTML 正文中必须包含 `mmbiz` 图片 URL，否则脚本拒绝发布并报错退出。
> 这意味着：**必须在写 HTML 之前准备好图片，图片必须在 HTML 里可见才能发布**。
**第一步：准备图片**
1. 📝 标题 + 🏷️ 分类 + 🏷️ 原创
2. 🖼️ **封面图**（AI生成或项目README图）→ 上传 `material/add_material?type=image` → 获取 `media_id`（**不是 thumb_media_id**）
3. 📷 **内容图**（项目截图）→ 上传 `media/uploadimg` → 获取 `mmbiz URL`（公网URL）
**第二步：下载项目素材（发布前必须完成，不可跳过）**
项目截图/GIF 是文章的重要组成部分，**必须在写文章之前下载并上传**：
1. 用 GitHub API 查项目目录：`GET /repos/{owner}/{repo}/contents/` — 找 `screenshot`、`demo`、`assets` 等图片文件
2. 下载到 `/tmp/`：用 `?raw=1` 或 base64 解码 GitHub API 响应
3. 上传到微信永久素材：`upload_article_image()` → 获得 mmbiz URL
4. **记录每个 mmbiz URL 对应的插入位置**（如「section 二项目banner用」）
5. 写 HTML 时在对应位置嵌入 `
`
**常见项目素材路径（优先查这些目录）**：
```
README.md 同级的 .png/.gif/.jpg
assets/ 目录
docs/images/ 目录
screenshots/ 目录
/demo.gif 或 /demo.mp4
```
> ⚠️ 如果项目完全没有图片（只有 shields.io 徽章和文字），则：
> 1. 用 GitHub OG 图代替：`https://opengraph.githubassets.com/1/{owner}/{repo}`
> 2. 或 AI 生成一张技术示意图
> 3. 在 HTML 中明确标注「项目暂无截图，用 OG 图代替」
>
> **无项目素材时的备选方案：Python PIL 绘制信息结构图作为文章配图**
>
> 适用场景：概念解析类文章（如工作流、思维模型）而非项目介绍帖，无需真实项目截图。
> 方法：用 Python + Pillow 绘制包含图标、色块、标注的工作流示意图（见下方模板），保存为 PNG → 转 JPEG → `curl uploadimg` 上传。
>
> ```python
> # 核心模板：横向三阶段工作流 + 顶部标注 + 底部总结
> from PIL import Image, ImageDraw
> W, H = 900, 400
> img = Image.new('RGB', (W, H), (255, 255, 255))
> d = ImageDraw.Draw(img)
> # 背景网格：for y in range(0, H, 30): d.line([(0,y),(W,y)], fill=(245,245,250), width=1)
> # 三个圆角矩形：d.rounded_rectangle([x1,y1,x2,y2], radius=12, fill=颜色)
> # 箭头：d.polygon([(x,y1),(x+w,y2),(x,y2),(x,y1)], fill=颜色) # 三角箭头
> # 底部总结框：d.rounded_rectangle([x1,y1,x2,y2], radius=10, fill=(255,245,220))
> img.save('/tmp/diagram.png', 'PNG', quality=95)
> ```
>
> **完整示例（prototype→rewind→summarize三阶段图）**：
> 见 `references/pil-workflow-diagram-example.py` — 可直接复制修改颜色和文案。
**第三步：写文章**
- HTML 中直接嵌入内容图的 mmbiz URL
- `
`
- ⚠️ 如果用了带 `id="screenshot"` 的占位图（如 `
`），**替换时必须替换整个 attribute 字符串** `src="..." id="screenshot"`，不能只替换 `src` 值，否则会残留重复 style 属性或孤立的 id 属性。正确做法：`html = html.replace('src="placeholder" id="screenshot"', f'src="{mmbiz_url}" style="width:100%;border-radius:6px;"')`
**第四步：同步创建草稿**
- 封面用 `material/add_material?type=thumb` 返回的 `media_id`，传给 `draft/add` 的 `thumb_media_id` 字段
- 一次性传入：标题 + 作者 + 摘要 + 正文HTML + thumb_media_id
- 调用 `/cgi-bin/draft/add` → 获取草稿 `media_id`
> ⚠️ **已踩坑（2026-05-17 验证）**：`media/upload?type=thumb` 返回的 `thumb_media_id` 不兼容 `draft/add`，报 `40007 invalid media_id`。必须用 `material/add_material?type=thumb`，取其返回的 `media_id` 字段作为 `thumb_media_id`。
>
> ⚠️ **补充验证（2026-05-19）**：`material/add_material?type=thumb` 确实可用，zhilicomments 测试完全成功，返回的 `media_id` 直接用于 `draft/add` 正常。部分旧版代码示例中混用 `media/upload` 接口（`40007` 错误的来源），请统一使用 `material/add_material` 接口。
```
下载项目图 → 上传到微信获取mmbiz → 写HTML（嵌入mmbiz） → 图片Gate检查 → 创建草稿
```
---
## 凭证配置
在 `references/config.md` 中配置：
| 字段 | 说明 | 获取方式 |
|------|------|----------|
| `APPID` | 公众号 AppID | 微信公众平台 → 设置 → 基本配置 |
| `APPSECRET` | 公众号 AppSecret | 同上页面 |
| `CATEGORY_ID` | 分类 ID | 发布一次后从返回的 media_id 反推 |
| `SENSENOVA_KEY` | Sensenova API Key | 存储在 `TOOLS.md`，脚本自动读取（封面图首选） |
| `MINIMAX_API_KEY` | MiniMax API Key | platform.minimaxi.com 获取（封面图备选） |
> ⚠️ 凭证信息仅存储在 `references/config.md`，绝不输出到对话中。
## 封面图生成
### 封面图生成
> ⚠️ **9Router 路径不可用于 MiniMax 图片生成**：`POST /v1/images/generations` via 9Router 需要 OpenAI key server-side（`No active credentials for provider: openai`）。MiniMax 图片生成必须走**直接 API**。
### 方式一：MiniMax 直接 API（推荐）
MiniMax 图片生成走 `api.minimaxi.com/v1/image_generation`，需要从 `/root/.openclaw/openclaw.json` 读取 key：
```python
import json, re, ssl, urllib.request
with open('/root/.openclaw/openclaw.json') as f:
raw = f.read()
m = re.search(r'"minimax"\s*:\s*\{.*?"apiKey"\s*:\s*"([^"]+)"', raw, re.DOTALL)
api_key = m.group(1)
url = "https://api.minimaxi.com/v1/image_generation"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"model": "image-01",
"prompt": "封面图描述，浅色背景+强对比",
"aspect_ratio": "1:1",
"response_format": "url",
}
req = urllib.request.Request(url, data=json.dumps(payload).encode("utf-8"), headers=headers, method="POST")
ctx = ssl.create_default_context()
ctx.check_hostname = False; ctx.verify_mode = ssl.CERT_NONE
resp = urllib.request.urlopen(req, timeout=120, context=ctx)
data = json.loads(resp.read())
img_url = data["data"]["image_urls"][0]
# 下载并裁剪为 900x900
urllib.request.urlretrieve(img_url, "/tmp/cover_raw.jpg")
from PIL import Image
img = Image.open("/tmp/cover_raw.jpg")
w, h = img.size
cropped = img.crop(((w-900)//2, (h-900)//2, (w-900)//2+900, (h-900)//2+900))
cropped.save("/tmp/cover_900.jpg", "JPEG", quality=90)
```
> ⚠️ **MiniMax API Key 实际位置尚待验证**：`/root/.openclaw/openclaw.json` 中的 `minimax` provider 配置段**不含 apiKey 字段**（仅有模型别名和 endpoint 配置）。历史上该 key 可能存储在 `~/.hermes/.env` 的 `MINIMAX_API_KEY` 或 TOOLS.md 中。
>
> **当前验证可行的备选方案**：当 MiniMax 直连失败时，用 PIL 纯代码生成封面图（完全离线）。如必须用 MiniMax API，请先通过以下命令确认 key 位置：
> ```bash
> grep -r "minimax" /root/.openclaw/ /root/.hermes/ 2>/dev/null | grep -i "key\|api"
> ```
### 方式二：Sensenova（备用）
Sensenova key 从 TOOLS.md 读取（路径在 skill 配置中）。API 端点：`https://token.sensenova.cn/v1/images/generations`，model：`sensenova-u1-fast`。成功率不稳定，优先用 MiniMax 直接 API。
### 方式三：PIL 纯代码生成（无 API 依赖）
当 AI 图片生成 API 不可用时（如 9Router 图片模型返回 401、MiniMax 直连 404），用 Python + Pillow 生成技术信息图风格封面，**完全离线、零外部依赖**：
```python
from PIL import Image, ImageDraw, ImageFont
import math
W, H = 900, 383 # 信息结构图比例
img = Image.new('RGB', (W, H), (255, 255, 255))
d = ImageDraw.Draw(img)
# 颜色常量
C = {
'hub': (255, 185, 0), # 金色中心
'wechat': (0, 182, 84),
'youtube': (255, 45, 45),
'web': (0, 120, 212),
'podcast': (142, 36, 170),
'ppt': (250, 100, 0),
'mindmap': (0, 150, 136),
}
# 中心 hub（发光效果）
hx, hy, HR = 450, 191, 48
for i in range(6):
r = HR + 18 - i*3
d.ellipse([hx-r, hy-r, hx+r, hy+r], fill=C['hub'])
d.ellipse([hx-HR, hy-HR, hx+HR, hy+HR], fill=C['hub'])
d.text((hx, hy), 'qiaomu', fill=(255,255,255), font=hub_font, anchor='mm')
# 输入节点（左）
for (cx, cy, icon, label, color) in inputs:
R = 38
d.ellipse([cx-R, cy-R, cx+R, cy+R], fill=color)
d.ellipse([cx-R+4, cy-R+4, cx+R-4, cy+R-4], outline=(255,255,255), width=2)
# 输出节点（右）
for (cx, cy, icon, label, color) in outputs:
R = 34
d.ellipse([cx-R, cy-R, cx+R, cy+R], fill=color)
d.ellipse([cx-R+3, cy-R+3, cx+R-3, cy+R-3], fill=(255,255,255))
# 连接线（带箭头）
def draw_arrow(d, x1, y1, x2, y2, color):
d.line([(x1, y1), (x2, y2)], fill=color, width=2)
draw_arrow(d, 162, 191, hx-HR-4, hy, (180, 190, 210)) # 输入→hub
draw_arrow(d, hx+HR+4, hy, 740, 191, (180, 190, 210)) # hub→输出
img.save('/tmp/cover.png', 'PNG', quality=95)
```
**常用尺寸**：
- 信息结构图封面（横向）：900×383
- 标准方图封面：900×900
**高对比配色板**（适合技术产品封面）：
```python
C = {
'hub': (255, 185, 0), # 金色（品牌色）
'blue': (0, 120, 212), # 输入蓝
'red': (255, 45, 45), # YouTube红
'green': (0, 182, 84), # WeChat绿
'purple': (142, 36, 170), # Podcast紫
'orange': (250, 100, 0), # PPT橙
'teal': (0, 150, 136), # 思维导图青
'line': (180, 190, 210), # 连接线灰
}
```
**上传封面到微信（mmbiz）**：
```python
import urllib.request, json, ssl, os
# APPID 可公开；APPSECRET 必须从本地 secrets 加载，绝不能进 GitHub
APPID = 'wx38a91c353554588a'
# 真实 APPSECRET 在 `~/.openclaw/secrets/zhili-credentials.md`（不进 GitHub）
# 脚本 `load_config()` 会自动从该文件回退加载
APPSECRET = '***REDACTED*** # 见本地 secrets 文件'
# 1. 获取 access_token
req = urllib.request.urlopen(
f'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}',
timeout=10
)
access_token = json.loads(req.read())['access_token']
# 2. 上传封面（type=image，返回 media_id + url）
boundary = '----PythonFormBoundary123'
file_path = '/tmp/cover.png'
with open(file_path, 'rb') as f:
file_data = f.read()
body = (
f'--{boundary}\r\n'
f'Content-Disposition: form-data; name="media"; filename="cover.png"\r\n'
f'Content-Type: image/png\r\n\r\n'
).encode() + file_data + f'\r\n--{boundary}--\r\n'.encode()
upload_url = f'https://api.weixin.qq.com/cgi-bin/material/add_material?access_token={access_token}&type=image'
req = urllib.request.Request(upload_url, data=body, method='POST')
req.add_header('Content-Type', f'multipart/form-data; boundary={boundary}')
ctx = ssl.create_default_context(); ctx.check_hostname = False; ctx.verify_mode = ssl.CERT_NONE
with urllib.request.urlopen(req, timeout=15, context=ctx) as resp:
result = json.loads(resp.read())
print('mmbiz URL:', result['url']) # 用于 img src
print('media_id:', result['media_id']) # 用于 draft.add thumb_media_id
```
### 方式四：跳过封面图
⚠️ `--skip-cover` 会创建无封面草稿，后台体验差。**推荐改用预生成封面图方案**（见下方）。
### 方式四：预生成封面图 + 创建草稿（推荐）
封面图和草稿分两次执行（封面图可复用）：
```bash
# ① 先生成封面图（保存到 /tmp/cover-thumb.jpg）
python3 skills/creative/zhili-publish/scripts/publish_zhili.py --cover-only --cover-prompt "AI封面描述"
# ② 创建草稿（用 --cover-path 指定预生成封面）
python3 skills/creative/zhili-publish/scripts/publish_zhili.py \
"文章标题" \
"作者（≤2个中文字）" \
"摘要" \
"$(cat /tmp/article.html)" \
--cover-path /tmp/cover-thumb.jpg
```
> ⚠️ **重要**：`--title`、`--author` 等命名参数**只能配合 `--cover-prompt`（自动生成封面）**使用，不支持与 `--cover-path` 混用。必须用**位置参数**顺序传入。
> ⚠️ **标题长度警告**：脚本会提示「标题较长（XX字符），建议≤10个中文字」，这只是警告，实测超过 20 个中文字（~60 字节限制）才会真正报错（45003）。
### 封面图规格
- **生成尺寸**：1024×1024（MiniMax 限制）
- **上传尺寸**：裁剪为 900×900（中心裁剪，JPEG，85% 质量）
- **格式**：JPG/JPEG
- **用途**：永久素材，media_id 存入草稿
### 格式指南不是写作范本（重要警示）
`references/format-guide.md` 描述的是**格式元素清单**（标题公式、数据卡片、列表格式等），**不包含写作风格、语气、行文节奏、结构数量**。如果用户说「学习某篇文章的风格」，必须：
1. 用 `9Router /v1/web/fetch` + `fetch-combo` 抓取那篇文章的**正文全文**（不只是标题）
2. 分析那篇文章的**实际章节结构**（几段？每段主题？长短？节奏？）
3. 对照格式清单补齐结构元素
4. **同时学习那篇文章的写作风格**：语气（亲切/犀利/冷静）、句式长度、段落节奏、收尾方式
**Telegraf 风格是典型 7 段式**（非 format-guide 默认的 6 段）：
**排版风格：章节标题 + 流式正文（与 zhiliComments 共用同一套渲染规范）**
> 章节标题用 ``；引用来源标注等也用 ``。
**format-guide 是格式清单，不是行文模板**——具体写几段、每段多长，要跟着参考文章的实际结构走，不能套用死板的六段式。
### 封面图 Prompt 技巧
**核心原则：浅色背景 + 强对比 + 高辨识度**
微信卡片封面在浅色列表页展示，浅色背景 + 强对比色能让主体更突出、在封面序列中更抓眼。
> 📌 **增强版格式规范（2026-05-20 更新）**：完整增强版 HTML 视觉规范见 `references/format-guide-enhanced.md`。升级内容：
> - 标题字阶增大：h1=26px / h2=20px / h3=17px
> - 四种高亮体系：关键词墨蓝、背景淡黄、砖红数字、引用块
> - Pull Quote：20px 大字独立观点引用
> - 信息卡片：GitHub 元信息 + 适合/不适合场景标签
> - 装饰分隔线：`· · ·` 居中 ornament
> - 辅助色：砖红 `#c9553d`、森绿 `#2d6a4f`、暖灰 `#7c6f64`
> - Figure Caption：配图下方 13px 斜体图注
>
> 写新文章时**优先使用**增强版格式，已发布的旧文章不受影响。
| 文章类型 | Prompt 方向 | 示例 |
|----------|-------------|------|
| AI 工具 | **浅底科技感** + 工具图标 | A clean light-themed tech illustration with a glowing robot brain icon, vibrant blue and orange accents on a white background, minimal, modern style... |
| 教程类 | **浅色示意** + 操作界面 | A bright minimalist illustration of a terminal with colorful code on a clean light background, friendly and approachable... |
| 人物 IP | **浅色背景** + 有记忆点的形象 | Portrait illustration on a soft light gradient background, a developer at a futuristic desk, warm colors with sharp contrast... |
| 数据分析 | **白底图表** + 数字感 | Clean white background data visualization with vibrant glowing charts and sharp contrast, professional dashboard aesthetic... |
**通用 Prompt 模板（可叠加到任意类型）：**
```
on a clean white/light gray background, high contrast, vibrant accent colors (blue, orange, purple), minimalist modern style, flat design, no dark backgrounds
```
### ⚠️ CSS margin 规范（防止微信叠加空行的关键）
**所有 block 元素只能设 `margin-bottom`，不能用 `margin-top`**：
```html
正文内容
正文内容
引用来源
```
### ⚠️ HTML 格式规范（zhiliGitHub 强制标准）
发布任何文章到「直隶按察使」时，必须严格遵守以下 CSS 规格：
### 🎨 样式规范：样式A（已固化，2026-05-30 确认）
> 样式A是当前唯一标准，所有新文章必须使用此样式。
**样式A特征（4套历史样式中用户选定）**：
| 属性 | 值 | 说明 |
|------|-----|------|
| 背景色 | `#f5f4ed`（暖羊皮纸） | 全部文章统一 |
| 正文字体 | `Georgia,'Noto Serif SC',serif` | 英文衬线+中文衬线 |
| H2标题 | `border-left:4px solid #00d4aa;padding-left:12px;font-size:20px;font-weight:bold;color:#1B365D` | **左边框是样式A的标志性特征**，不许省略 |
| H3标题 | `font-size:17px;font-weight:bold;color:#1f1d18` | 无边框，左对齐 |
| 正文p | `font-size:16px;line-height:1.85;color:#2c2c2c;margin:0 0 14px 0` | 行高1.85 |
| 强调色1 | `#1B365D`（墨蓝） | 关键词/链接/数据卡片背景 |
| 强调色2 | `#c9553d`（砖红） | 红色高亮/重点/警示 |
| 辅助色 | `#2d6a4f`（森绿） | 适合场景标签 |
| 辅助色 | `#7c6f64`（暖灰） | 次要文字/不适合标签 |
| 代码块 | `background:#1e1e1e;color:#e8e8e8;font-size:14px` | 深色背景+浅色文字 |
| 分隔线 | `text-align:center;color:#c9553d;letter-spacing:6px;` 内容 `· · ·` | 砖红色装饰 |
**历史样式参考（4套，均已归档）**：
| 样式 | 背景 | H2风格 | 强调色 | 代码块 |
|------|------|--------|--------|--------|
| **A（现行标准）** | `#f5f4ed` | `border-left:4px solid #00d4aa` | `#c9553d` 红 | `#1e1e1e` 深色 |
| B（极简无衬线） | `#f5f4ed` | `font-size:18px bold` | `#e63946` 红 | `#1e1e1e` 深色 |
| C（温暖米色） | `#f0efe8` | `border-left:4px solid #1B365D` | `#c9553d` 红 | `#1e1e1e` 深色 |
| D（暗色封面） | `#0d1828` 深蓝 | 渐变/卡片布局 | 彩色标签 | 深色主题 |
**⚠️ CSS 规范权威来源**：
| 文件 | 用途 | 说明 |
|------|------|------|
| `references/streambert-reference.html` | **样式A标准参考** | 已实测正确的HTML输出，H2有左边框，是样式A的准确实现 |
| `references/article-template.html` | 模板起点 | 结构完整但H2无左边框，**需自行添加** `border-left:4px solid #00d4aa` |
**正确流程（每次写 HTML 前必须执行）**：
1. `skill_view("zhiligithub", "references/streambert-reference.html")` — 读取样式A的H2左边框实现
2. 从 `article-template.html` 复制结构作为起点，**然后将所有 H2 改为 streambert-reference 的样式**（添加 `border-left:4px solid #00d4aa;padding-left:12px`）
3. 生成完毕后，对照 streambert-reference.html 的 CSS 值逐项验证
4. **严禁省略 H2 的左边框**——这是样式A的标志性特征
> ⚠️ **本节 CSS 规范来源**：整合自 `streambert-reference.html`（已实测正确的 HTML 输出）和用户确认的样式A特征（2026-05-30）。核心签名：#f5f4ed 暖羊皮纸 + #00d4aa 青色 h2 左边框 + #c9553d 砖红色强调 + Georgia 衬线体。
| 属性 | 值 | 说明 |
|------|-----|------|
| 画布背景 | `#f5f4ed`（暖羊皮纸） | 用户明确要求纯白时改为 `#ffffff`；次级背景 `#efeee5` |
| 主文字色 | `#1f1d18`（近黑暖灰） | **不用纯黑** `#000` |
| 次文字色 | `#6b665b` | 用于元信息、引用来源等次要文字 |
| 唯一强调色 | `#1B365D`（墨蓝） | 所有 accent（链接、tag 描边、重点数字、引用左 rule）**只能用这一个色**，严禁多色 |
| 正文字号 | `font-size:16px` | — |
| 大标题 h2 | `font-size:18px;font-weight:bold;color:#1f1d18;` | — |
| 行高 | 正文 `1.6`；标题 `1.1–1.3` | — |
> ⚠️ 2026-05-18 用户明确要求：所有文字格式左对齐。这不是可选的样式偏好，是强制要求。
**⚠️⚠️ CSS 规范必须从 `references/streambert-reference.html` 读取，不得凭记忆 ⚠️⚠️**
本 skill 的 CSS 规范**唯一权威来源**是 `references/streambert-reference.html`（已实测正确的 HTML 输出）。**以下值是已知的错误记忆值，不要使用**：
| 元素 | ❌ 错误记忆值 | ✅ 正确值（来自 streambert-reference.html） |
|------|-------------|-------------------------------------------|
| h2 | 无边框纯文本 | `border-left:4px solid #00d4aa;padding-left:12px` |
| p | `margin:0 0 16px 0` | `margin:0 0 14px 0;line-height:1.85` |
| blockquote | `border-left:3px solid #1B365D` | `border-left:3px solid #c9553d;background:#efeee5;border-radius:0 4px 4px 0` |
| body 背景 | 未指定 | `#f5f4ed` |
| body 字体 | Charter/Noto Serif | Georgia,'Times New Roman',serif |
| p 颜色 | `#1f1d18` | `#2c2c2c` |
| h2 颜色 | `#1f1d18` | `#1B365D` |
| footer 颜色 | `#6b665b` | `#7c6f64` |
**正确流程（每次写 HTML 前必须执行）**：
1. `skill_view("zhiligithub", "references/streambert-reference.html")` — 读取实际 HTML 输出
2. 提取 CSS 值，写入 HTML
3. 生成完毕后，对照第 1 步的检查清单逐项验证
4. **严禁凭记忆生成 CSS**——历史已证明记忆值 100% 错误
> ⚠️ **本节 CSS 规范来源**：整合自 `streambert-reference.html`（已实测正确的 HTML 输出）。核心签名：#f5f4ed 暖羊皮纸 + #00d4aa 青色 h2 左边框 + #c9553d 砖红色强调 + Georgia 衬线体。
**字体（一种语言一种衬线，不混用）：**
- 中文：`Noto Serif SC`（fallback：`宋体`、`SimSun`）
- 英文：`Georgia,'Times New Roman',serif`
**代码块（深色背景 + 浅色文字）：**
- 背景：`#1e1e1e`；文字: `#e8e8e8`；等宽字体
- 字号：14px；行高 1.5
**tag 样式（项目标签）：**
- 用实色方块背景：`background:#c9553d;color:#fff;padding:2px 10px;border-radius:3px`
**细节要求：**
- 分隔符：`text-align:center;color:#c9553d;font-size:18px;letter-spacing:6px;` 内容 `· · ·`
- 图片：`width:100%;max-width:680px;border-radius:4px;margin:16px 0;`
- 引言块（重要段落高亮）：`border-left:4px solid #1B365D;padding:14px 18px;background:#f0efe8`
- 引用块（外部引用）：`border-left:3px solid #c9553d;background:#efeee5;border-radius:0 4px 4px 0`
> ⚠️ 2026-05-18 用户明确要求：所有文字格式左对齐。这不是可选的样式偏好，是强制要求。
**⚠️ 代码块换行必须用 `
`，不能用真实换行符**
### ⚠️ 代码块换行必须用 `
`，不能用真实换行符
```html
git clone https://github.com/nexu-io/html-anything<br>cd html-anything<br>pnpm install<br>pnpm dev
git clone https://...
cd html-anything
pnpm install
pnpm dev
```
### ⚠️ execute_code sandbox 无法读取 config.md 凭证
`execute_code` 的 Python sandbox 与文件系统隔离，**看不到** `references/config.md` 中的 APPSECRET。遇到需要调用微信 API 的 Python 脚本时：
```bash
# ✅ 正确：写脚本到 /tmp，用 terminal python3 执行（能读取 config.md）
python3 /tmp/publish_article.py
# ❌ 错误：用 execute_code 内联包含 APPSECRET 的代码（sandbox 看不到 config.md）
```
**凭证必须从 terminal 中读取 config.md 后内联进脚本**，或用 `scripts/publish_zhili.py`（它已内置 `load_config()`）。
### ⚠️ 标题安全长度
微信限制标题 **≤60字节**（UTF-8 中文 = 3字节/字）：
- **安全范围**：≤50 字节（约 16 个中文字）
- 超过 60 字节会报 `errcode: 45003`（`title size out of limit`）
- 建议中文标题 ≤20 个字，英文 ≤50 字符
### ⚠️ cleanup_html.py 清理盲区
`cleanup_html.py` 只能移除**整行都是空白**的行。无法清除嵌在 HTML 标签**内部**的换行符：
```html
这是段落内容
```
**预防胜于清理**：生成阶段就不要在块内部写换行（inline 单行块 + `''.join()`）。
### 验证命令
```bash
# 统计纯空行数量（应为 0）
grep -c '^$' /tmp/article_draft.html
# 验证 JSON payload 不含意外换行（发布前最后一道检查）
python3 -c "
import json
with open('/tmp/article_draft.html') as f:
html = f.read()
payload = {'content': html}
data = json.dumps(payload, ensure_ascii=False)
newlines = data.count('\\n')
print(f'JSON payload 换行符数量: {newlines} (应为 0)')
"
```
### ⚠️ 内容写作 → HTML 转换规则（format-guide 与草稿 HTML 的区别）
format-guide.md 中的 `**标题**` 和 `### 子标题` 是**内容写作阶段**的格式指引（用 Markdown 语法组织内容）。微信编辑器不会将 Markdown 转换为 HTML，**必须由 agent 在生成 HTML 时主动转换**：
| 内容写法（format-guide） | HTML 转换结果 | |
|--------------------------|---------------|---|
| `**粗体文字**` | `粗体文字` |
| `**一、项目名称**`（章节标题） | `一、项目名称
` |
| `**小节标题**`（bold p 标签内） | `小节标题
` — **不要嵌套 ``** |
| `### 子标题` | `子标题
` — **去掉 `###` 前缀** |
| `• **概念名**：描述`（列表项） | `概念名：描述 ` — **不要手动加 `•`** |
**⚠️ 双重加粗陷阱**：`**文字**
` 会产生 `**文字**`（冗余）。正确做法是 p bold 标签内直接放纯文本。
**生成后必查**：
```bash
# 检查是否还有未转换的 ** 和 ###
grep -n '\*\*\|###' /tmp/article.html
# 应返回空
```
### 诊断工具：mmx CLI 图片分析（排查草稿截图）
`mmx vision describe` 是诊断微信草稿格式问题的首选工具（比内置 `vision_analyze` 更可靠）。
完整排版问题诊断参考：`references/wechat-draft-debug.md`（含有序列表渲染异常、多余空行、Markdown 残留、双重加粗、thumb_media_id invalid 等常见问题的根因和解决方案）。
```bash
# 安装 mmx CLI（全局）
npm install -g mmx-cli
# 登录（API key 从 ~/.hermes/.env 读取 MINIMAX_API_KEY）
bash -c 'source ~/.hermes/.env && mmx auth login --api-key "$MINIMAX_API_KEY"'
# 分析微信草稿截图
mmx vision describe "/path/to/screenshot.jpg" --prompt "分析这张微信公众号草稿截图，找出所有多余的空行、空白段落或格式问题。精确描述具体位置。" --output json
```
- 正文：`font-size:16px; line-height:1.6; margin:0 0 16px 0; padding:0 8px`
- 标题 h2：`font-size:18px; font-weight:bold`
- 小标题 h3：`font-size:17px; font-weight:bold`
- 代码块：深色背景 `#1e1e1e`，白色等宽字体
- 内联代码：`background:#f6f8fa; border-radius:3px; padding:1px 4px`
- 重点词红色高亮：`color:#e63946`
- 链接：`...`
- 图片：`width:100%;border-radius:6px`
### ⚠️ 中文乱码问题（\uXXXX 字面量 vs 正常中文）
**现象**：微信草稿箱前端正文显示 `AI Agent \u7ba1\u7406\u5f00\u6e90\u65b0\u683c\u5c38` 而非正常中文。
**根因**：`json.dumps()` 默认 `ensure_ascii=True`，将所有非 ASCII 字符转为 `\uXXXX` 转义序列，WeChat 预览渲染器将其作为字面量直接显示。
**正确修复**：`json.dumps(payload, ensure_ascii=False).encode("utf-8")`，`Content-Type: application/json`（不带 `charset=utf-8`）。
- `ensure_ascii=False` → 直接输出 UTF-8 原文，WeChat 自己推断编码
- 禁止在 Content-Type 里加 `charset=utf-8`（会导致 JSON 处理管线无法解码）
- 脚本位置：`/root/.hermes/skills/openclaw-imports/zhiligithub/scripts/publish_zhili.py` 第 443 行、第 564 行
**错误修复**（不要用）：
- `ensure_ascii=True`（默认）→ 中文变 `\uXXXX` 字面量
- `ensure_ascii=False` + `charset=utf-8` → WeChat JSON 管线无法解码
**验证**：前端草稿箱标题+正文都正常显示中文 = 修复正确。
## 脚本使用
### 标准发布（无封面图）
```bash
python3 skills/creative/zhili-publish/scripts/publish_zhili.py "" "<author>" "<digest>" "<html_content>"
```
⚠️ **字段长度限制（超限会报 45003 错误，必须严格执行）**：
- 标题：**≤60字节**（UTF-8 中文 = 3字节/字，所以约 ≤20 个中文字；60字节约 8~10 个中文字安全）
- 作者：**≤2个中文字**（超出必报 `author size out of limit`）
- 摘要：建议≤50字
**常见报错**：
- `errcode: 45003` = 标题超长，必须缩短后重试
- `errcode: 0` + `media_id` = 成功
**实测结论（大段 HTML 的两种可行传参方式）：**
```python
# ✅ 方式一：Python API（推荐，sandbox 可见 config.md）
import sys
sys.path.insert(0, '/root/.hermes/skills/openclaw-imports/zhiligithub/scripts')
import publish_zhili as pz
token = pz.get_access_token(appid, appsecret)
thumb_media_id = pz.upload_thumb_material(token, '/tmp/cover.jpg')
with open('/tmp/article.html', encoding='utf-8') as f:
content = f.read()
result = pz.create_draft(token, title, author, digest, content, thumb_media_id)
# ✅ 方式二：CLI + bash 命令替换（实测可用）
# 原理：$(python3 -c ...) 在 shell 层展开为 HTML 文本，作为第4个位置参数传入
python3 /root/.hermes/skills/openclaw-imports/zhiligithub/scripts/publish_zhili.py \
"文章标题" \
"作者（≤2个中文字）" \
"摘要" \
"$(python3 -c \"import sys; sys.stdout.write(open('/tmp/article.html', encoding='utf-8').read())\")"
```
**用户明确指示：不要清空草稿箱。** 草稿箱可以同时存在多篇，直接上传封面 + 创建新草稿即可，不需要先删除旧草稿。
### ⚠️ 标题字节限制（实测值，2026-05-27 更新）
| 类型 | 安全字节 | 典型报错 |
|------|----------|----------|
| 长文标题 | **≤22字节**（约7-8个中文字） | `errcode: 45003 title size out of limit` |
| 短评标题 | **≤20字节**（约6-7个中文字） | 同上 |
| 作者 | **≤2个中文字** | `author size out of limit` |
| digest | **≤54字节** | `digest size out of limit` |
**实测换算**：UTF-8 中文 = 3字节/字。标题 `macOS最强终端cmux` = 21字节 ✅，`39K星开源项目` = 22字节 ✅，`开源数字生命浪潮：他把Neuro-sama装进浏览器` = 61字节 → 45003 ❌。
**策略**：先写短标题（18-22字节）测试通过后，再逐步加长。不要一步到位写长标题。
```
### 自动生成封面图发布
```bash
python3 skills/creative/zhili-publish/scripts/publish_zhili.py \
--title "文章标题" \
--author "作者" \
--digest "摘要" \
--content "<html内容>" \
--cover-prompt "AI 封面图描述"
```
### 仅生成封面图（不上传）
```bash
python3 skills/creative/zhili-publish/scripts/publish_zhili.py --cover-only --cover-prompt "描述"
```
脚本自动完成：
1. **封面图生成**：调用 MiniMax image-01，1024×1024
2. **裁剪**：Pillow 中心裁剪为 900×900 JPEG
3. **上传**：微信永久素材 API（type=thumb）
4. **创建草稿**：含原创标志、封面 media_id
## ⚠️ format-guide 是格式清单，不是写作范本
`references/format-guide.md` 描述的是**格式元素清单**（标题公式、数据卡片、列表格式等），但**不包含写作风格、语气、行文节奏**。如果用户要求「按某篇文章的风格重写」，必须：
1. 先获取那篇文章的**正文内容**（不只是格式）
2. 对照格式清单补齐结构元素
3. **同时学习那篇文章的写作风格**：语气（亲切/犀利/冷静）、句式长度、段落节奏、收尾方式
**无法获取文章内容时的处理：**
- ⚠️ **微信文章有「混元AI」滑块验证码墙**：直接 curl / 浏览器 / Browserbase CDP 均无法绕过，会卡在"环境异常 → 去验证 → 滑块拼图"页面。这是微信的主动反爬，无法自动化突破。
- 备选：搜狗微信搜索（部分可查，但本次 session 测试超时不可用）
- **唯一可行方案：请用户把文章内容复制粘贴过来**（纯文字即可，不需要格式）
## ⚠️ 已发布草稿的自我检查清单（发布前必查）
- [ ] **先查格式指南**，对照清单补齐所有结构元素
- [ ] **再对标参考文章**，学习写作风格（不是只抄格式）
- [ ] 正文（二、项目介绍）中至少一张项目截图
- [ ] `**` Markdown 语法全部转为 HTML `<strong>`，无残留
- [ ] block 元素之间无换行符
- [ ] 代码块用 `<br>` 换行，不用真实换行符
- [ ] 所有间距只设 `margin-bottom`，不用 `margin-top`
- [ ] `grep -n '^$'` 确认 0 个空行
⚠️ **关键发现**：微信公众平台会过滤 `<style>` 标签和 CSS 类选择器，所有样式必须在 HTML 元素上直接用 `style="..."` 内联，否则格式全部失效。
### 正确的 HTML 结构（全部内联样式）
```html
<div style="max-width:678px;margin:0 auto;padding:0 8px;font-size:16px;line-height:1.6;color:#333;text-align:left;">
<!-- 正文用内联 style，不使用 class，全部左对齐 -->
<h2 style="font-size:18px;font-weight:bold;margin:24px 0 16px 0;padding-top:8px;text-align:left;">标题</h2>
<p style="margin:0 0 16px 0;line-height:1.6;text-align:left;">正文内容</p>
<pre style="background:#1e1e1e;border-radius:6px;padding:14px 16px;margin:16px 0;overflow-x:auto;"><code style="font-family:'Consolas','Monaco','Courier New',monospace;color:#e8e8e8;font-size:14px;line-height:1.5;">代码内容</code></pre>
<strong style="color:#e63946;">重点强调</strong>
</div>
```
**⚠️ 代码块关键规则：**
- `<code>` 必须设置 `color:#e8e8e8`（浅灰白），否则微信渲染时文字与深色背景融为一体看不见
- 必须设置等宽字体：`font-family:'Consolas','Monaco',monospace`
- 字号 14px，行高 1.5
- 禁止裸 `<code>` 没有外层 `<pre>` 包裹
### 文章模板文件（样式A起点）
⚠️ 写新文章时，**必须**从 `article-template.html` 复制结构作为起点，**但 CSS 样式必须参照 `streambert-reference.html`**。
| 文件 | 角色 |
|------|------|
| `references/article-template.html` | 结构模板（H2 无左边框，需自行添加） |
| `references/streambert-reference.html` | **CSS 样式权威**（H2 有 #00d4aa 左边框） |
关键步骤：从 article-template.html 复制后，必须将所有 H2 的 `style="font-size:20px;color:#1B365D;..."` 加上 `border-left:4px solid #00d4aa;padding-left:12px`。
### ⚠️ 写文章前必读：流式叙事格式对照（先读再写，不要写完再查）
⚠️ **本 session 教训**：写完文章后再查格式清单 = 被用户打回重写。正确做法是**写之前**就读一遍，写完立刻对照。
- `references/enforcement-gate.md` — 发布前强制图片检查 Gate 机制（check_article_images 函数 + 拦截逻辑）
- `references/project-screenshot-workflow.md` — 配图强制工作流：Step1下载→Step2上传→Step3记录位置→Step4写HTML嵌URL→Step5发布。核心原则：先拿mmbiz URL，后写HTML，不要倒过来。
- `references/format-guide-enhanced.md`（增强版流式叙事格式规范）
| 规范元素 | 格式要求 |
|----------|----------|
| 标题 | 数字 + 感叹 + 核心洞察 + 开源背景，如「8.9k stars！AI Agent 终于会自我进化了？中国团队开源的这个项目让我看到了智能体的未来！」 |
| 数据卡片 | `**GitHub**: url \| **Stars**: Xk \| **License**: XXX \| **Language**: XXX`（同行排列） |
| 核心概念列表 | `• **概念名（加粗）**：一句话定义 + 举例说明`，用 `•` 不要用 `<ul>` |
| 引擎职责列表 | `1. 2. 3. 4. 5.` 编号，每条 `**职责名**：描述` |
| 工作流图示 | `[步骤1] → [步骤2] → [步骤3]`，放在代码块中 |
| 实战案例 | `• **第N次尝试（状态）**：动作 + 结果`，含失败→介入→成功→创新弧线 |
| 技术亮点 | `**1. 标题**：解释文字`（编号列表，不是纯段落） |
| 收尾金句 | 有洞察力的判断句，用类比或行业判断收尾 |
| Star 号召 | `如果你觉得这个XXX有意思，欢迎 Star 支持开源 🧬` |
| 数据来源 | `📌 数据来源：GitHub Trending，YYYY-MM-DD | 项目：xxx` |
**⚠️ 高频踩坑：`**` Markdown 粗体残留（两种形态）**
生成 HTML 时，内容中的 `**文字**` 会被 agent 误写成 HTML 字符串 `**文字**` 而不是 `<strong>文字</strong>`。
**形态一（块级，容易发现）**：`**一、章节标题**` 写成 `<strong>**一、章节标题**</strong>` → grep 能查到
**形态二（行内，难发现）**：`这是段落内容**加粗**也是正文` 写成 `<p>这是段落内容**加粗**也是正文</p>` → grep 查不到，因为 `**` 不在行首
写完 HTML 后必查两步：
```bash
# 查块级残留
grep -n '\\*\\*' /tmp/article.html # 应返回空
# 查行内残留（检查 content 属性中是否有未被 <strong> 包裹的 **）
python3 -c "
import re
with open('/tmp/article.html') as f:
html = f.read()
# 找所有 ** 出现位置及上下文
for m in re.finditer(r'.{20}\*{2}.{20}', html):
print(f'行内残留: ...{m.group()}...')
"
# 应返回空
```
**预防方法**：写 HTML 时用 Python 列表 + `''.join(blocks)` 拼接，不要在块内写任何 `**`。
### ⚠️ 格式合规必须在写文章之前检查，不是写完之后
**核心教训（本session深刻教训）**：格式检查必须在**提笔之前**做，不是在写完之后才检查。正确顺序：
```
获取项目信息（GitHub API + README）
↓
格式合规预检（对照下方清单确认格式要素齐全）
↓
开始写 HTML
↓
写完后验证 Markdown 残留（`**` 和 `###`）
↓
空行检查
↓
发布
```
**格式预检清单（下笔前必读）：**
- [ ] 标题公式：数字 + 感叹 + 核心洞察（参考格式指南）
- [ ] 数据卡片：GitHub · Stars · Language · License 同行
- [ ] 核心概念列表：5项 `• **概念名**：定义+举例
- [ ] 工作流图示：`[步骤1] → [步骤2] → [步骤3]`
- [ ] 实战案例：三次尝试弧线（失败→介入→成功→创新）
- [ ] 技术亮点：编号列表 `1. 2. 3. 4. 5.`
- [ ] 收尾金句 + Star号召 + 数据来源
### 格式检查清单（发布前必查）
- [ ] **写之前已读** `references/format-guide.md` 并对照六段式结构
- [ ] 从 `references/article-template.html` 模板开始写文章
- [ ] HTML 中无 `**`（Markdown bold 残留），`grep -n '\*\*' /tmp/article.html` 返回空
- [ ] 不使用 `<style>` 标签，全部样式内联
- [ ] 正文包裹容器：`style="max-width:678px;margin:0 auto;padding:0 8px;font-size:16px;line-height:1.6;"`
- [ ] 发布前必须执行空行清理（见下方「强制清理流程」，这一步不可跳过）
- [ ] **生成脚本检查**：确认脚本使用 `''.join(blocks)` 拼接 block，不使用 `'\n\n'.join()` 或多行字符串块
- [ ] block 元素（h2/h3/p/ul/ol/div/pre/blockquote）之间不能有换行，微信会识别为段落加间距——全部写成一行，无换行符
- [ ] 正文字号 16px，标题 h2 18px，h3 17px
- [ ] 行高 1.6，段间距 16px
- [ ] 列表禁止用 `<ul><li>` 和 `<ol><li>`（微信对两者都有渲染 bug），改用 `•` 符号 + `<p style="text-indent:-16px;padding-left:16px;">` 或 `①②③` + `<p>` 段落
- [ ] 所有间距只使用 `margin-bottom`，不使用 `margin-top` 或 `padding-top`
- [ ] block 元素之间无任何换行符
- [ ] 重点强调用 `<strong style="color:#e63946;">`
- [ ] 链接：`style="color:#1a73e8;"`
- [ ] **代码块 `<code>` 必须设置 `color:#e8e8e8` + 等宽字体**，不能用默认颜色（深色背景+默认黑色文字会看不见）
- [ ] **正文（二、项目介绍）中至少插入一张项目截图**（mmbiz URL 必须嵌入 HTML，脚本 Gate 会强制检查，无图则拒绝发布）
### ✍️ stop-slop 文风诊断（写完必查，适用于所有 AI 写作场景）
> stop-slop 是一套 AI 文风去除术，源于 CrewAI 社区的 `hardikpandya/stop-slop` 项目（7k+ Stars）。核心思路：AI 写东西有套路，套路让人读起来像机器，这套检查表专门治这个。
>
> **对中文写作来说框架通用，词条需要本地化重建。**
#### 中文 stop-slop 废话填充词自检表
**出现3个以上，这篇文章就已经有 AI 味了。**
| # | 中文废话 | 替换建议 |
|---|---------|---------|
| 1 | 值得注意的是 | 直接删，后面直接说观点 |
| 2 | 实际上、其实 | 直接删，事实不需要铺垫 |
| 3 | 那么、那么就 | 很多是噪音，可删 |
| 4 | 大家/我们都知道 | 谁？直接说 |
| 5 | 从某种意义上来说 | 要说就说清楚 |
| 6 | 归根结底 | 直接说结论 |
| 7 | 不得不承认 | 直接删 |
| 8 | 想必、应该（猜测语气） | 不确定就别用 |
| 9 | 毫无疑问 | 直接删，显得心虚 |
| 10 | 必须承认 | 直接删 |
| 11 | 我想说的是 | 删，直接开口就说 |
| 12 | 相信大家都知道 | 谁？不点名就说 |
#### 句式结构检查（5条）
- [ ] 没有「首先、其次、最后、总之」套路（三板斧）
- [ ] 没有「一方面、另一方面」平衡结构（假辩证）
- [ ] 没有「随着…的发展」宏大叙事开头
- [ ] 没有无主语句（「已被广泛认可」「这一观点受到关注」）
- [ ] 没有因果废话（「因为 X，所以 X，这说明」）
#### 中文 AI 黑话池（用一次扣一分）
```
突破瓶颈 → 解决
赋能 → 帮助
持续迭代 → 更新
深度赋能 → 提高
构建生态 → 攒人
引领变革 → 搅局
核心价值 → 好处
解决方案 → 方法
颠覆性创新 → 新的做法
助力 → 帮助
落地 → 实施
闭环 → 做完
矩阵 → 组合
```
#### 快速 12 问（综合判断）
综合判断：超过4个「有问题」→ 打回修改。
| # | 问题 |
|---|------|
| 1 | 有废话填充词吗？ |
| 2 | 有破折号吗？（中文破折号可保留，忽略这条） |
| 3 | 有「它是…」「这是…」开头吗？ |
| 4 | 有模糊词吗？（想必、应该、可能） |
| 5 | 能用一个字说清楚用了两个字吗？ |
| 6 | 有AI黑话吗？（颠覆、创新、引领、赋能） |
| 7 | 句长有变化吗？（连续10句一样长=呆板） |
| 8 | 读出来顺口吗？（不顺口就要改） |
| 9 | 案例具体吗？（张三李四王五，要具体到人） |
| 10 | 读起来像机器吗？ |
| 11 | 你真的想表达这个吗？ |
| 12 | 有没有「只有卡兹克才会写出来的角度」？ |
#### stop-slop 评分（可选，不强制）
| 维度 | 满分 | 说明 |
|------|------|------|
| 直接性 | 10/10 | 没有废话填充词，直接进入 |
| 节奏感 | 10/10 | 句长有变化，一句话独立成段 |
| 信任感 | 10/10 | 不吹不黑，承认局限 |
| 真实感 | 10/10 | 体感记忆，不是知识描述 |
| 密度 | 10/10 | 信息量大，没有废话段落 |
| **总分** | **50/50** | **35分以下必须重写** |
### ⚠️ HTML 拼接技术规范（防止多余空行的根本方法）
**问题根因**：用 Python 字符串列表 + `'\n\n'.join()` 或 `'\n'.join()` 拼接 HTML，会在每个 block 之间插入换行符，导致 JSON payload 的 `content` 字段携带 `\n`，微信渲染时将连续换行识别为段落分隔符，产生多余空白段落（视觉上表现为间隔点和空白行）。
**清理脚本的局限性**：`cleanup_html.py` 只能移除「纯空行」（整行都是空白），无法移除嵌在多行 HTML 块内部的新行。例如下面这段 HTML：
```html
<p style="margin:0 0 16px 0;">
这是第一段内容
</p>
<p style="margin:0 0 16px 0;">
这是第二段内容
</p>
```
`cleanup_html.py` 只能去掉 `}\n\n<p` 之间的空行，但块内部的 `\n 这是第一段内容\n` 依然存在。
**正确做法**：生成 HTML 时每个 block 完全写成一行，用 `''.join(blocks)` 直接拼接（零分隔符）。
```python
# ✅ 正确：每个块完全内联一行，块之间零分隔符
blocks = [
'<p style="margin:0 0 16px 0;font-size:16px;line-height:1.8;color:#333;">第一段内容</p>',
'<p style="margin:0 0 16px 0;font-size:16px;line-height:1.8;color:#333;">第二段内容</p>',
'<h2 style="margin:24px 0 12px 0;font-size:20px;font-weight:bold;color:#111;">二、项目名是什么？</h2>',
'<img src="..." style="width:100%;border-radius:6px;margin:16px 0;" />',
]
html_content = ''.join(blocks) # ← 无任何分隔符，所有间距通过 style 属性控制
# ❌ 错误1：'\n\n'.join() —— JSON payload 携带 \n，微信渲染产生多余段落
html_content = '\n\n'.join(blocks)
# ❌ 错误2：多行字符串块 —— 块内部换行无法被 cleanup 移除
blocks = [
'<p style="margin:0 0 16px 0;font-size:16px;">\n 第一段内容\n</p>', # ← 块内部有换行
'<p style="margin:0 0 16px 0;font-size:16px;">\n 第二段内容\n</p>',
]
html_content = '\n\n'.join(blocks) # ← 双重错误
# ❌ 错误3：字符串列表 + '\n\n' 拼接后再写成多行
html = (
'<p style="...">第一段</p>'
+ '\n\n'
+ '<p style="...">第二段</p>'
)
```
**所有间距通过 CSS `style` 属性的 `margin`/`padding` 控制**，不要依赖源码换行来产生间距。
**验证**：生成后用 `grep -n '^$' article.html` 检查是否有纯空行（应为 0）。如有，再用 `cleanup_html.py` 处理。
### ⚠️ 强制空行清理流程（预防为主，清理为辅）
**核心原则**：空行问题要预防在生成阶段，不要依赖清理作为主要手段。生成脚本必须遵守「inline 单行块 + `''.join()`」规范。
**生成后验证（必须执行）**：
```bash
# 检查是否有纯空行（应为 0）
grep -n '^$' /tmp/article_draft.html
# 如果有，执行清理（自动备份 .bak）
python3 scripts/cleanup_html.py /tmp/article_draft.html
# 再次验证
grep -n '^$' /tmp/article_draft.html # 应仍为 0
python3 scripts/cleanup_html.py --check /tmp/article_draft.html # 应返回 [OK] 0 空行
```
**验证通过标准**：0 个纯空行（`grep -n '^$'` 返回空，或 `--check` 返回 `[OK] ... 0 空行，干净`）
**重要**：`cleanup_html.py` 只能移除整行都是空白的行，无法移除 HTML 块内部的新行。如果生成阶段用了多行字符串块（错误写法），清理后依然会有新行残留，这时必须修复生成脚本重新生成。
## 发送图片到飞书
调用 `send_message` 时必须用**完整 target ID**（飞书 OC ID），不能用裸平台名：
```
# ✅ 正确
target="feishu:oc_034bc08420a2daed53561bfceba5b3bf"
# ❌ 错误（会报 invalid receive_id）
target="feishu"
```
先查 ID：`send_message(action='list')` → 返回 `feishu:o
…(truncated)
`；引用来源标注等也用 ``。
**format-guide 是格式清单，不是行文模板**——具体写几段、每段多长，要跟着参考文章的实际结构走，不能套用死板的六段式。
### 封面图 Prompt 技巧
**核心原则：浅色背景 + 强对比 + 高辨识度**
微信卡片封面在浅色列表页展示，浅色背景 + 强对比色能让主体更突出、在封面序列中更抓眼。
> 📌 **增强版格式规范（2026-05-20 更新）**：完整增强版 HTML 视觉规范见 `references/format-guide-enhanced.md`。升级内容：
> - 标题字阶增大：h1=26px / h2=20px / h3=17px
> - 四种高亮体系：关键词墨蓝、背景淡黄、砖红数字、引用块
> - Pull Quote：20px 大字独立观点引用
> - 信息卡片：GitHub 元信息 + 适合/不适合场景标签
> - 装饰分隔线：`· · ·` 居中 ornament
> - 辅助色：砖红 `#c9553d`、森绿 `#2d6a4f`、暖灰 `#7c6f64`
> - Figure Caption：配图下方 13px 斜体图注
>
> 写新文章时**优先使用**增强版格式，已发布的旧文章不受影响。
| 文章类型 | Prompt 方向 | 示例 |
|----------|-------------|------|
| AI 工具 | **浅底科技感** + 工具图标 | A clean light-themed tech illustration with a glowing robot brain icon, vibrant blue and orange accents on a white background, minimal, modern style... |
| 教程类 | **浅色示意** + 操作界面 | A bright minimalist illustration of a terminal with colorful code on a clean light background, friendly and approachable... |
| 人物 IP | **浅色背景** + 有记忆点的形象 | Portrait illustration on a soft light gradient background, a developer at a futuristic desk, warm colors with sharp contrast... |
| 数据分析 | **白底图表** + 数字感 | Clean white background data visualization with vibrant glowing charts and sharp contrast, professional dashboard aesthetic... |
**通用 Prompt 模板（可叠加到任意类型）：**
```
on a clean white/light gray background, high contrast, vibrant accent colors (blue, orange, purple), minimalist modern style, flat design, no dark backgrounds
```
### ⚠️ CSS margin 规范（防止微信叠加空行的关键）
**所有 block 元素只能设 `margin-bottom`，不能用 `margin-top`**：
```html
正文内容
正文内容
引用来源
`，不能用真实换行符** ### ⚠️ 代码块换行必须用 `
`，不能用真实换行符 ```html
git clone https://github.com/nexu-io/html-anything<br>cd html-anything<br>pnpm install<br>pnpm devgit clone https://...
cd html-anything
pnpm install
pnpm dev这是段落内容
``` **预防胜于清理**：生成阶段就不要在块内部写换行（inline 单行块 + `''.join()`）。 ### 验证命令 ```bash # 统计纯空行数量（应为 0） grep -c '^$' /tmp/article_draft.html # 验证 JSON payload 不含意外换行（发布前最后一道检查） python3 -c " import json with open('/tmp/article_draft.html') as f: html = f.read() payload = {'content': html} data = json.dumps(payload, ensure_ascii=False) newlines = data.count('\\n') print(f'JSON payload 换行符数量: {newlines} (应为 0)') " ``` ### ⚠️ 内容写作 → HTML 转换规则（format-guide 与草稿 HTML 的区别） format-guide.md 中的 `**标题**` 和 `### 子标题` 是**内容写作阶段**的格式指引（用 Markdown 语法组织内容）。微信编辑器不会将 Markdown 转换为 HTML，**必须由 agent 在生成 HTML 时主动转换**： | 内容写法（format-guide） | HTML 转换结果 | | |--------------------------|---------------|---| | `**粗体文字**` | `粗体文字` | | `**一、项目名称**`（章节标题） | `一、项目名称
` | | `**小节标题**`（bold p 标签内） | `小节标题
` — **不要嵌套 ``** | | `### 子标题` | `子标题
` — **去掉 `###` 前缀** | | `• **概念名**：描述`（列表项） | `**文字**
` 会产生 `**文字**`（冗余）。正确做法是 p bold 标签内直接放纯文本。 **生成后必查**： ```bash # 检查是否还有未转换的 ** 和 ### grep -n '\*\*\|###' /tmp/article.html # 应返回空 ``` ### 诊断工具：mmx CLI 图片分析（排查草稿截图） `mmx vision describe` 是诊断微信草稿格式问题的首选工具（比内置 `vision_analyze` 更可靠）。 完整排版问题诊断参考：`references/wechat-draft-debug.md`（含有序列表渲染异常、多余空行、Markdown 残留、双重加粗、thumb_media_id invalid 等常见问题的根因和解决方案）。 ```bash # 安装 mmx CLI（全局） npm install -g mmx-cli # 登录（API key 从 ~/.hermes/.env 读取 MINIMAX_API_KEY） bash -c 'source ~/.hermes/.env && mmx auth login --api-key "$MINIMAX_API_KEY"' # 分析微信草稿截图 mmx vision describe "/path/to/screenshot.jpg" --prompt "分析这张微信公众号草稿截图，找出所有多余的空行、空白段落或格式问题。精确描述具体位置。" --output json ``` - 正文：`font-size:16px; line-height:1.6; margin:0 0 16px 0; padding:0 8px` - 标题 h2：`font-size:18px; font-weight:bold` - 小标题 h3：`font-size:17px; font-weight:bold` - 代码块：深色背景 `#1e1e1e`，白色等宽字体 - 内联代码：`background:#f6f8fa; border-radius:3px; padding:1px 4px` - 重点词红色高亮：`color:#e63946` - 链接：`...` - 图片：`width:100%;border-radius:6px` ### ⚠️ 中文乱码问题（\uXXXX 字面量 vs 正常中文） **现象**：微信草稿箱前端正文显示 `AI Agent \u7ba1\u7406\u5f00\u6e90\u65b0\u683c\u5c38` 而非正常中文。 **根因**：`json.dumps()` 默认 `ensure_ascii=True`，将所有非 ASCII 字符转为 `\uXXXX` 转义序列，WeChat 预览渲染器将其作为字面量直接显示。 **正确修复**：`json.dumps(payload, ensure_ascii=False).encode("utf-8")`，`Content-Type: application/json`（不带 `charset=utf-8`）。 - `ensure_ascii=False` → 直接输出 UTF-8 原文，WeChat 自己推断编码 - 禁止在 Content-Type 里加 `charset=utf-8`（会导致 JSON 处理管线无法解码） - 脚本位置：`/root/.hermes/skills/openclaw-imports/zhiligithub/scripts/publish_zhili.py` 第 443 行、第 564 行 **错误修复**（不要用）： - `ensure_ascii=True`（默认）→ 中文变 `\uXXXX` 字面量 - `ensure_ascii=False` + `charset=utf-8` → WeChat JSON 管线无法解码 **验证**：前端草稿箱标题+正文都正常显示中文 = 修复正确。 ## 脚本使用 ### 标准发布（无封面图） ```bash python3 skills/creative/zhili-publish/scripts/publish_zhili.py "