Markdown 转微信公众号 HTML 并推送草稿箱

核心能力

将 Markdown 文件转换为符合微信公众号规范的 HTML 文件，支持三级标题、正文、粗体、链接、行内代码、代码块、引用块、表格等常用格式。所有 CSS 内联到 style 属性，确保微信渲染兼容。

支持进一步将转换后的 HTML 推送到微信公众号草稿箱。

场景决策

决策原则：技能 2（推送公众号）已包含技能 1（转换），技能 3（推送掘金）独立使用 mark_content，无需同时调用。

默认模式：用户未明确指定时，使用文章模式（--article）。仅在以下情况使用新闻模式（--news）：

• 用户明确说"新闻模式""用新闻模式""--news"
• 上文对话已在讨论新闻日报、周报等内容
• Markdown 内容明显为板块化日报格式（含多个独立新闻板块）

模式速查：

文章模式预设样式

文章模式内置 6 种预设样式，用户用自然语言描述即可自动匹配。每个预设对应 references/ 目录下一个独立的 YAML 配置文件，既可被 SKILL.md 用自然语言匹配，也可直接通过 --config 传入脚本使用。

匹配规则：

• 用户提及"默认样式"/"白色"/"白底"/"常规"/"简洁"/"干净"/"基础" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_default.yaml
• 用户提及"怀旧"/"泛黄"/"古风"/"古卷"/"黄底"/"暖黄"/"米黄底"/"历史"/"典籍"/"复古" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_nostalgic.yaml
• 用户提及"科技"/"蓝紫"/"科技蓝紫"/"蓝紫渐变"/"AI"/"技术"/"现代"/"前沿"/"潮流"/"深蓝封面" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_modern.yaml
• 用户提及"青绿"/"青绿引号"/"引号标题"/"引号线"/"文艺"/"杂志"/"专栏"/"清爽"/"雅致"/"小清新" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_journal.yaml
• 用户提及"角标"/"角标绿条"/"角标编号"/"编号角标"/"badge"/"清单"/"步骤"/"运营"/"资讯"/"拆解"/"模块化"/"绿底封面" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_growth.yaml
• 用户提及"中轴"/"中轴蓝卡"/"中轴编号"/"编号卡"/"center"/"灰底"/"冷灰"/"蓝灰底"/"蓝色"/"产品文档"/"技术手册"/"结构化"/"规范"/"正式" → 使用 ${CODEBUDDY_SKILL_DIR}/references/article_blueprint.yaml
• 用户未提及任何风格关键词 → 默认使用 references/article_default.yaml

技能 1：Markdown → 微信 HTML

调用脚本：

python3 ${CODEBUDDY_SKILL_DIR}/scripts/md2wechat_html.py \x3Cinput.md> [output.html]

三种转换模式：

• 日报模式（默认）：一条消息对应一条新闻，分四大板块，报纸风格配色
• 长文/历史故事模式（--essay）：泛黄报纸风格背景，适合成语典故、历史故事类长文
• AI 文章模式（--ai）：白底灰字 + 棕色标签二级标题 + 固定尾栏，适合 AI 实践类文章

示例：

# 日报模式
python3 ${CODEBUDDY_SKILL_DIR}/scripts/md2wechat_html.py article.md article_wechat.html

# 长文模式
python3 ${CODEBUDDY_SKILL_DIR}/scripts/md2wechat_html.py --essay story.md story_wechat.html

# AI文章模式
python3 ${CODEBUDDY_SKILL_DIR}/scripts/md2wechat_html.py --ai ai_article.md ai_wechat.html

输出 HTML 文件保存在当前工作目录。若未指定 output.html，则根据模式自动生成文件名后缀（_wechat.html、_essay_wechat.html、_ai_wechat.html）。

技能 2：转换 + 推送草稿箱

调用脚本：

python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py \x3Cinput.md> [--title TITLE] [--cover COVER] [--digest DIGEST] [--media-id MEDIA_ID]
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py --essay \x3Cinput.md> [--title TITLE] [--cover COVER] [--digest DIGEST] [--media-id MEDIA_ID]
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py --ai \x3Cinput.md> [--title TITLE] [--cover COVER] [--digest DIGEST] [--media-id MEDIA_ID]

支持 Markdown frontmatter 提取标题和摘要：

---
title: 文章标题
digest: 手动摘要（80字以内）
---

完整工作流

必须严格按以下步骤执行：

1. 读取 Markdown 文件内容（用 Read 工具）
2. 提取 frontmatter：检查文件顶部是否有 --- 包裹的 YAML 区段，提取 title 和 digest 字段
3. 生成摘要（重要！）：如果 frontmatter 中没有 digest 字段，则必须根据文章正文内容自动生成一条 120 个字符以内的中文摘要，通过 --digest 参数传入脚本。摘要要求：
   • 简洁精炼，概括文章核心内容
   • 严格控制在 120 个字符以内（含标点）
   • 不要使用 markdown 格式或 HTML 标签
   • 不要以「本文」「这篇文章」开头
4. 调用 push_daily.py：将生成的摘要通过 --digest 参数传入（若 frontmatter 已有 digest 则使用 frontmatter 中的值）
5. 脚本自动执行：Markdown → HTML → 上传封面图 → 推送草稿箱

注意：摘要生成是必选步骤，不可跳过。不要让脚本自动截取 120 字符——那会产生不完整的无意义截断。

自动拆分：当 HTML 内容超过 20000 字符限制时，脚本会自动按 H2 标题拆分为多篇合并推送（同一图文消息内，读者上滑查看），标题自动添加（上）（中）（下）后缀。拆分后非首篇的摘要由脚本自动生成，无需手动处理。

技能 3：推送掘金草稿箱

调用脚本：

# 新建草稿
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_juejin.py \x3Cinput.md> [--title TITLE] [--digest DIGEST] [--category ID] [--tags IDS]

# 更新已有草稿
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_juejin.py \x3Cinput.md> --update DRAFT_ID [--title TITLE] [--digest DIGEST]

# 查询标签
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_juejin.py --query-tags KEYWORD

支持 Markdown frontmatter 提取元数据：

---
title: 文章标题
digest: 摘要（50-100字）
category_id: "6809637773935378440"
tag_ids: "6809640408797167623,6809640445233070098"
cover_image: https://p1-juejin.byteimg.com/xxxxx
---

工作流

1. 读取 ~/.md_push_wechat/config.yaml 获取 juejin.cookie 和默认分类/标签
2. 解析 Markdown frontmatter 提取标题、摘要、分类、标签
3. 扫描正文中的本地图片引用，尝试上传到掘金图床（通过 ImageX/gen_token）
4. 替换 mark_content 中的本地图片为掘金 CDN URL
5. 调用掘金创建/更新草稿 API

参数

分类 ID 速查表

运行 python push_juejin.py --query-categories 可在线获取最新分类列表。 |

前置条件

• 配置文件 ~/.md_push_wechat/config.yaml 必须包含 juejin.cookie
• Cookie 获取方式：登录 juejin.cn → F12 → Application → Cookies → 复制完整 Cookie 字符串
• Cookie 有效期约 30 天，过期需重新获取

图片上传

脚本会尝试将 Markdown 中的本地图片上传到掘金图床，完整 ImageX 5 步流程：

MD5 缓存：上传后的 CDN URL 基于文件内容 MD5 缓存到 config.yaml 的 image_cache.juejin 段，同一张图片（即使路径不同）永久复用，无需重复上传。

关键实现细节：

• AWS SigV4 签名使用 hmac + hashlib.sha256 手动实现，参数排序确保 AWS 要求的字母顺序
• 文件上传使用 POST + Content-CRC32 校验（非 PUT）
• mark_content 中的本地路径替换为完整 CDN URL（http(s):// 开头），非 store_uri

注意：图片上传功能为尽力而为模式。如上传失败，脚本会跳过该图片并保留原引用。

微信公众号草稿接口有 20000 字符限制。脚本采用以下 CSS 继承策略压缩输出体积：

• text-indent:0 统一写到 \x3Cbody style> 一次，全文继承，各 \x3Cp>/\x3Ch2>/\x3Ch3> 不再重复（text-indent 是可继承属性）
• color / font-size / line-height 提升到最近父级 \x3Csection>，子元素只保留差异化覆盖
• \x3Ctd> 的 color 从 \x3Cbody> 继承，不在每个 td 重复
• 空格规范：style 属性内一律去掉冒号/分号后的空格，进一步节省

实测节省效果（示例文件）：

前置检查

• 技能 1：无前置依赖
• 技能 2（推送草稿箱）：执行前必须确认配置文件 ~/.md_push_wechat/config.yaml 存在。若不存在，立即中断，提示用户创建配置文件并填写 appid 和 secret，不得尝试从其他目录查找或自动创建。