转换工具使用说明

把 insurance-guide/articles/ 下的 HTML 文章，一键转换成：
- 公众号 HTML（带蓝色样式，浏览器打开后复制粘贴到公众号编辑器，格式全保留）
- 知乎 Markdown（原生格式，知乎编辑器直接支持粘贴）

🚀 快速使用

convert_single.py · 单篇通用版（推荐）

适用于 insurance-guide/articles/ 下任意单篇 HTML 文章。

用法：

python insurance-guide/operations/tools/convert_single.py <源HTML路径> <输出文件主名>

示例：

# 转换分红险智商税那篇
python insurance-guide/operations/tools/convert_single.py "insurance-guide/articles/cpa-01-dividend-trap.html" "港险分红险智商税CPA拆解"

# 转换分红实现率那篇
python insurance-guide/operations/tools/convert_single.py "insurance-guide/articles/cpa-02-fulfillment-ratio.html" "港险分红实现率拆解"

# 转换美元 vs 人民币
python insurance-guide/operations/tools/convert_single.py "insurance-guide/articles/cpa-03-usd-vs-rmb.html" "美元保单vs人民币保单"

输出（生成在项目根目录）：
- 公众号_<主名>.html
- 知乎_<主名>.md

建议工作流：生成后，把这两个文件移入 operations/published/wechat/ 和 operations/published/zhihu/ 归档。

gen_cover.py · 公众号/知乎封面图生成器

用 Python PIL（无外部依赖）一键生成 3 种尺寸的封面图：
- 公众号头图 900×500（接近 2.35:1 标准）
- 知乎封面 1280×720（16:9）
- 方形版 800×800（朋友圈 / 小红书 / 备用）

用法：在脚本内编辑 \SPEC_CPA02_WECHAT\ 字典里的字段（标题、副标题、编号、配色等），然后运行：

\ash
python insurance-guide/operations/tools/gen_cover.py
\
输出到：
- \operations/published/wechat/covers/- \operations/published/zhihu/covers/- \operations/published/promotional/covers/
字段说明：

字段	用途
umber_str\	大水印数字（如 02）
\ ag_label\	金色标签文字（如 CPA 旗舰研报）
\ itle_accent\	标题第一行（金色）
\ itle_main\	标题第二行（白色）
\subtitle\	副标题
\pills\	底部小标签数组
\color_a\ / \color_b\	背景渐变两端 RGB

复制粘贴流程：右键图片另存为，上传到公众号/知乎/小红书的封面图位置即可。

convert_v2.py · 双版本专用版

适用于源 HTML 里同时包含【A】公众号版 + 【B】知乎版的文章（如 v22-persona.html）。

python insurance-guide/operations/tools/convert_v2.py

（这个脚本目前是硬编码处理 v22-persona.html，如需扩展可参考它的逻辑）

🎨 公众号 HTML 样式说明

生成的 HTML 包含以下样式块（在公众号编辑器粘贴后会保留）：

元素	样式
h1 主标题	居中 + 蓝色下边框
h2 章节	蓝色左侧竖条 + 主色调
h3 小节	深蓝粗体
加粗	自动标蓝（视觉重点）
> 引用块	浅灰背景 + 蓝左边框
表格	蓝表头 + 斑马纹
列表	标准缩进
分割线	虚线柔和样式
⚠️ 警告块	黄色 callout
💡 关键洞察	蓝色 callout
公式块	等宽字体 + 虚线框

📋 复制粘贴流程

公众号

浏览器双击 公众号_*.html
页面上 Ctrl + A 全选
Ctrl + C 复制
打开 mp.weixin.qq.com → 新建图文
编辑器里 Ctrl + V 粘贴 → 所有样式保留 ✅

知乎

用编辑器（Cursor / VSCode）打开 知乎_*.md
Ctrl + A 全选 → Ctrl + C 复制
打开知乎 → 写文章 → 直接 Ctrl + V 粘贴
知乎会自动识别 Markdown 语法 → 标题、加粗、列表、引用、表格全部正确转换 ✅

⚠️ 常见问题

Q: 公众号粘贴后字体变了？
A: 公众号会用自己默认字体覆盖，这是正常的。加粗、标题、引用块、列表等结构性样式都会保留，颜色、对齐方式也保留。

Q: 表格在公众号显示不全？
A: 公众号编辑器对表格宽度有限制，如果列数太多可能需要手动调整。建议把宽表格拆成"上下两段"或转成图片。

Q: 知乎粘贴后没识别 Markdown？
A: 确认是在"写文章"（不是"写回答"），知乎专栏文章对 Markdown 支持更完整。

Q: 我想自己改样式？
A: 编辑 convert_single.py 顶部的 WECHAT_CSS 变量，那是公众号 HTML 用的所有 CSS。

🔄 批量转换示例

如果你想一次转换多篇：

# Bash / Git Bash
for f in insurance-guide/articles/cpa-*.html; do
    name=$(basename "$f" .html)
    python insurance-guide/operations/tools/convert_single.py "$f" "$name"
done

# PowerShell
Get-ChildItem insurance-guide/articles/cpa-*.html | ForEach-Object {
    $name = $_.BaseName
    python insurance-guide/operations/tools/convert_single.py $_.FullName $name
}