公众号图文发布器（wechat-article-publisher）
把"好看但公众号不认"的内容，转成"公众号认且依旧好看"的内容。核心认知：
公众号编辑器只接受内联 style + 实色背景 + 静态布局，会丢弃 <style> 类样式、
linear-gradient 背景、box-shadow、transform、display:flex 等。本技能用脚本
一次性完成转换、美化、检查。
> ## ⚠️ 排在第一位的坑（务必先读，90% "没样式" 都栽在这）
> 公众号新版编辑器底层是 ProseMirror，白名单里根本没有 <div>。
> 一旦内容用 <div style="background:...;border-radius:...;box-shadow:..."> 包着卡片 / 封面 /
> 金句框，整个 div 连同它的背景、圆角、边框、阴影会被整段吞掉，只剩光秃秃的文字 →
> 表面看就是"整篇没 CSS"。这比"渐变被吃"更隐蔽，是粘贴后样式全失的头号元凶。
> 解法：所有块级容器一律用 <section> 而不是 <div>（秀米 / 135 导出的代码全是 section）。
> 本技能转换器已自动把所有 <div> rename 成 <section>，无需手动处理；
> 但你手写或让 AI 写 HTML 时也请直接用 <section>，别留 <div> 等转换器擦屁股。
> ## 💡 关键认知：你的自定义 class 也会被内联（旧版最大坑已修）
> 旧版转换器只内联主题 CSS，把你文章 <head> 里自己写的 <style> 整段丢弃——
> 结果 .fact-box / .golden / .limit-box 这些自定义 class 全部没样式，粘进公众号「样式全丢」。
> 新版已修复：转换器会抽取文章自带的 <style>，与主题合并后确定性内联每一个 class
> （含后代选择器 .fact-box b、复合 .a.b、:hover/@media 自动跳过）。
> 所以你写 HTML 时放心用 class 排版，不用再手写一堆 style="..."；转换器会自动拍平。
> 回归测试见 scripts/test_inline.py（改 skill 前跑一遍，防退化）。
何时使用
- 用户有 HTML / Markdown 文章，要发公众号，但吐槽"复制粘贴样式没了"。
- 用户要"排版美化""套模板""检查标题/违规词"。
- 用户提供的是 Word 文档、网页链接、或 AI 生成稿，需要走完整发布流程。
- 用户要发腾讯新闻 / 小红书 / 知乎 / 头条等其他平台，抱怨"只有一键复制、效果差""只能手机发没网页"——用图片版（见下）。
> ## 📱 其他平台（腾讯新闻等）：图片版才是万能解
> 公众号还能靠"内联样式粘贴"救一救；但腾讯新闻、小红书这类平台的编辑器更封闭，
> 常常只有"一键复制"、且会过滤几乎所有 CSS，卡片/背景/圆角全崩。
> 真正 100% 保真的办法：把排版好的 HTML 渲染成图片，当图片上传。 图片是所有平台的
> 最大公约数，编辑器再简陋也认。用 scripts/html_to_image.py 生成：
> - <名>_长图.png —— 整篇一张，存手机相册直接上传；
> - <名>_分段_NN.png —— 按高度切多张，适合手机逐张上传/九宫格。
>
> 认知纠偏：腾讯新闻有电脑网页版——腾讯新闻创作服务平台 https://shizi.qq.com，
> PC 端支持工具栏 + 文档导入整篇文章，比手机"一键复制"强得多（纯文字/简单排版走它，
> 精美卡片走图片版）。别再以为"腾讯新闻只能手机发"。
>
> 调用命令（先确保装了 playwright：pip install playwright）：
> bash
> # 默认方式：让 playwright 自带 Chromium 渲染
> python scripts/html_to_image.py 文章_wechat.html --outdir . --width 750 --split 1200
>
> # 复用本机已装 Chrome，跳过 Chromium 下载（推荐，省一次大体积下载）
> python scripts/html_to_image.py 文章_wechat.html --outdir . --width 750 --split 1200 \
> --chrome "C:/Program Files/Google/Chrome/Application/chrome.exe"
>
> 参数：--width 750（手机 2 倍图）、--split 1200（按高度切多张，0=只出长图）、--scale 2.0（清晰度）、--chrome 指定系统浏览器路径。
完整四环节流程
环节 1 · 内容获取（Content Acquisition）
把原始内容归一为干净的 HTML 片段，下游脚本才好处理。
- HTML 文件：直接用 wechat_convert.py 处理（见环节 2）。
- Markdown 文件：wechat_convert.py 已内置 .md 识别，直接把 .md 当输入即可
（用 markdown 库转 HTML，含表格/代码块/换行）。
- Word 文档（.docx）：先调用 docx 技能把 docx 导出为 HTML，再进入环节 2。
- 网页链接：用 WebFetch 抓取正文，或 Bash 里 curl 取 HTML 后交给转换器。
- AI 生成稿：直接让模型产出 HTML 片段（要求内联样式、实色背景、不用渐变/flex），
存成 .html 后进环节 2。
环节 2 · 格式转换（Convert to WeChat-safe HTML）
运行转换器，把任意 HTML/MD 变成公众号能认的版本：
PY="C:\ProgramData\WorkBuddy\users\1805ac3b\.workbuddy\binaries\python\envs\default\Scripts\python.exe"
SKILL="C:\ProgramData\WorkBuddy\users\1805ac3b\.workbuddy\skills\wechat-article-publisher"
$PY "$SKILL/scripts/wechat_convert.py" 输入.html --theme fresh --title "标题" --outdir 输出目录
# 也支持 .md：wechat_convert.py 文章.md --theme news
转换器自动完成：
1. 内联 CSS：用自研确定性内联器（scripts/wechat_convert.py 里的 inline_rules）把
「主题 + 你文章自带 <style>」的全部 class 拍平为内联样式。关键点：你手写 / AI 生成的
HTML 里自定义 class（如 .golden .fact-box .limit-box）也会自动内联，无需再手动写
style="..."——这正是旧版「粘贴后样式全丢」的根因修复（旧版只内联主题、丢弃了用户 <style>）。
2. sanitize 兼容化：渐变背景→实色；box-shadow/transform/flex 等丢弃；
只保留公众号白名单属性（详见 references/wechat_css_support.md）。
3. 图片本地化：本地图自动转 base64 内嵌（外链图保留并加 max-width:100%）。
4. 套主题 + 包裹容器，产出两份文件（必须同时生成，缺一不可）：
- <名>_preview.html —— 带「📋 复制全文」按钮的 375px 移动端预览页。
页面上方一键复制（自动把带内联样式的富文本送进剪贴板），下方即为公众号内真实效果，所见即所得。
- <名>_wechat.html —— 纯内容版，浏览器打开后 Ctrl+A 全选 → Ctrl+C 复制，粘进公众号编辑器同样有效。
> 两个文件用途互补：preview 主打"一键复制 + 实时预览"，wechat 是兜底"手动全选复制"。
> 两者都保留兼容化后的内联样式，严禁只生成其中一个。
可用主题：fresh（紫蓝，默认）/ minimal（极简黑白）/ news（红头资讯）/
warm（暖橙）/ none（不套主题，仅做兼容转换）。
环节 3 · 排版美化（Beautify）
美化靠"套主题"在环节 2 一步完成。若用户对默认样式不满意：
- 换主题：--theme news 等重跑。
- 微调：主题 CSS 在 assets/templates/*.css，改里面 h2/blockquote/table 等
选择器即可（改完重跑转换器）。组件类 .callout（信息框）、.note（提示框）可直接
在 HTML 里用 <section class="callout">…</section>（注意：用 section，别用 div，见上方"排在第一位的坑"）。
- 想加封面图/分隔/文末引导，直接在 HTML 里用 <img>/<hr>/<section> 写内联样式，
转换器会保留并兼容化。
环节 4 · 发布前诊断 + 改进建议（Pre-publish Diagnosis）
$PY "$SKILL/scripts/check_publish.py" --title "文章标题" --html <名>_wechat.html --report <名>_report.html
不止"查违规"，更给"怎么写更好"的可操作建议，覆盖六个维度：
1. 标题：评分(0-100) + 短板分析 + 2-3 个爆款向改写示例（如"别再踩坑！…的真相"）。
2. 内容爆款度：综合分 + 七项细分（开头 hook / 金句密度 / 段落节奏 / 互动引导 / CTA / 小标题结构 / 干货密度），每项给改进点。
3. 创意差异化：套路化程度 + 痛点命中，提示如何"反常识/具体场景"切入。
4. 审美排版：callout 视觉锚点 / 配图 / 分隔线密度，建议如何加视觉节奏。
5. 传播力·转发收藏驱动力：五大驱动力——社交货币 / 情绪共鸣 / 认知增量 / 身份认同 / 可复用资产，逐一给提升建议（一篇好文值得转藏，远不止"解决痛点"）。
6. 违规敏感词扫描：四类（绝对化 / 诱导分享关注 / 夸大承诺 / 医疗金融红线），词库 assets/sensitive_words.json。
加 --report 会额外生成 <名>_report.html 可视化诊断报告（分数条 + 改进清单），
在浏览器打开即可边看边改。标题技巧见 references/title_tips.md。
粘贴到公众号的正确姿势（务必告诉用户）
- 用浏览器打开
_wechat.html（不要从代码编辑器/记事本复制，那样只带纯文本）。 Ctrl/Cmd+A全选 →Ctrl/Cmd+C。- 切到公众号编辑器
Ctrl/Cmd+V粘贴。 - 嫌麻烦可装「壹伴 / 新媒体管家 / 公众号助手」浏览器插件，用「导入 HTML」直接灌代码。
参考与资源
references/wechat_css_support.md—— 公众号 CSS 支持/不支持完整对照，人工排查用。references/title_tips.md—— 标题长度、钩子、避坑经验。assets/templates/*.css—— 4 套排版主题，可改。assets/sensitive_words.json—— 违规敏感词库，可按账号领域增删。scripts/wechat_convert.py—— 转换+美化+预览主脚本。scripts/check_publish.py—— 标题评估+敏感词扫描脚本。tests/run_regression.py—— 回归测试（见下「稳定性保障」）。
稳定性保障（重要 · 改这个 skill 前必读）
本 skill 早期「不稳定」的根因已根治，改代码时严禁回退：
-
清洗 100% 在 Python 完成，浏览器里的 JS 不做任何转换。
wechat_convert.py的build_preview()预览页「复制全文」按钮，只是把#copy-target
里已由 Python 洗干净的 HTML 写进剪贴板——不在 JS 里再跑 sanitize / 正则 / 转义。
❌ 不要把渐变转换、div→section、剥宽度等逻辑写回<script>：
那段 JS 嵌在 Python f-string 里，\'会被 f-string 吞掉反斜杠 → JS 语法崩 →
copyContent is not defined→ 用户点「复制全文」毫无反应（这是早期最频繁的故障）。
✅ 正确做法：任何兼容化都在wechat_convert.py的 Python 管道做，
预览 JS 保持「只复制、不转换」的最小形态（无正则、无单引号转义）。 -
出厂质检（硬门禁）：
validate_wechat(html)在写文件前断言
0 <div> / 0 渐变 / 0 固定 max-width / 0 UI 铬层(.bar/.tip/#phone/#copied/button) / 0 <script> / 0 <style> / 0 <!DOCTYPE> / 0 <html><head><body>。
任一不过 → 打印具体问题并sys.exit(1)。不要删这门禁去「掩盖」质检失败。 -
回归样例：
tests/fixtures/*.source.html是历史出过问题的源文件
（工具栏泄漏、内容太窄 375px、复制没反应）。每次改完跑：
bash python tests/run_regression.py
它做三层校验：① 转换退出码必须 0（质检门禁）；
② 提取生成预览里的<script>用node --check验语法（卡住「复制没反应」类故障）；
③ 模拟点复制，提取#copy-target内容断言无<div>/渐变/工具栏文字/UI 铬层。
全绿才算改完。依赖：转换用beautifulsoup4 lxml markdown，语法检查用node。 -
硬卡口（git pre-commit + safe_edit.py）—— 让「改完跑回归」从软约定变物理强制。
上面 1/2/3 是「记得做」的约定；这条是「不做就提交不了」的强制：
- 手动验证：python safe_edit.py（等价python tests/run_regression.py，但更顺手）。
- 一键装强制：python safe_edit.py --install-hook
会在 skill 目录git init并写入.git/hooks/pre-commit，
以后任何git commit都会自动跑回归，不过则exit 1阻止提交。
agent 想绕过也绕不过——它只要 commit 交付，hook 就拦。
- 分发恢复：发出去的 zip 不含.git，拿到 skill 的人
运行python safe_edit.py --install-hook即可在本机恢复硬卡口。
- 这样三层保险：1 SKILL.md 约定（加载即读）2 MEMORY.md 常驻（boot 必读）
3 git pre-commit 物理强制（commit 不过回归就 block）。
