ClawHub

Mukun Md Push Wechat

Other

将 Markdown 文件转换为符合微信公众号规范的 HTML 文件，并可进一步推送到微信公众号草稿箱。支持日报模式（默认）、长文/历史故事模式（--essay）、AI 文章模式（--ai）。支持推送 Markdown 到稀土掘金草稿箱。当用户提到"md转微信html""推送公众号""转换微信公众号格式""推送到掘金""掘金草稿"等意图时触发此技能。

Install

openclaw skills install mukun-md-push-wechat

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

核心能力

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

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

场景决策

用户意图执行方式脚本命令
「把这篇md转成微信html」「md转微信格式」「生成微信html」仅转换 HTML${CODEBUDDY_SKILL_DIR}/scripts/md2wechat_html.py
「推送/发布到公众号」「先转换再推送到公众号」转换 + 推送草稿箱${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py
「推送到掘金」「掘金草稿」「发到掘金」推送掘金草稿箱${CODEBUDDY_SKILL_DIR}/scripts/push_juejin.py

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

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

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

模式速查：

模式标志独立脚本适用场景
文章模式--article（默认）md2article_html.py技术实践、成语典故、长文叙事（配色通过 config.yaml 控制）
新闻模式--newsmd2news_html.pyAI 周报、行业动态汇总（板块化日报，需用户明确指定）

文章模式预设样式

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

预设配置文件视觉特征自然语言触发词（含任一即匹配）
默认references/article_default.yaml白底灰字 + 棕橘胶囊标题默认、默认样式、白色、白底、常规、简洁、干净、基础
泛黄怀旧references/article_nostalgic.yaml古卷泛黄底色 + 深棕胶囊标题怀旧、泛黄、古风、古卷、黄底、暖黄、米黄底、历史、典籍、复古
科技蓝紫references/article_modern.yaml白底 + 蓝紫胶囊标题 + 深蓝封面科技、蓝紫、科技蓝紫、蓝紫渐变、AI、技术、现代、前沿、潮流、深蓝封面
青绿引号references/article_journal.yaml米白底 + 青绿引号线 H2（大 Q + 引号包裹标题）青绿、青绿引号、引号标题、引号线、文艺、杂志、专栏、清爽、雅致、小清新
角标绿条references/article_growth.yaml白底 + 黄色编号角标 + 绿色标签块 H2角标、角标绿条、角标编号、编号角标、badge、清单、步骤、运营、资讯、拆解、模块化、绿底封面
中轴蓝卡references/article_blueprint.yaml冷灰底 + 中轴蓝色编号卡 H2（居中编号 + 两侧横线）中轴、中轴蓝卡、中轴编号、编号卡、center、灰底、冷灰、蓝灰底、蓝色、产品文档、技术手册、结构化、规范、正式

匹配规则：

  • 用户提及"默认样式"/"白色"/"白底"/"常规"/"简洁"/"干净"/"基础" → 使用 ${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 <input.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 <input.md> [--title TITLE] [--cover COVER] [--digest DIGEST] [--media-id MEDIA_ID]
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py --essay <input.md> [--title TITLE] [--cover COVER] [--digest DIGEST] [--media-id MEDIA_ID]
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_daily.py --ai <input.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 <input.md> [--title TITLE] [--digest DIGEST] [--category ID] [--tags IDS]

# 更新已有草稿
python3 ${CODEBUDDY_SKILL_DIR}/scripts/push_juejin.py <input.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

参数

参数说明
--title文章标题（覆盖 frontmatter）
--digest摘要（50-100字，掘金硬性要求）
--category分类 ID 或名称（如 "AI"、"后端"，自动转换）
--tags标签 ID，逗号分隔（如 "6809640445233070098,6809640408797167623"）
--cover封面图 URL（必须是掘金 CDN 地址）
--update DRAFT_ID更新已有草稿
--query-tags KEYWORD查询可用标签

分类 ID 速查表

分类名称category_id
后端6809637769959178254
前端6809637767543259144
Android6809635626879549454
iOS6809635626661445640
AI / 人工智能6809637773935378440
开发工具6809637771511070734
代码人生6809637776263217160
阅读6809637772874219534

运行 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 步流程：

步骤接口说明
1. gen_tokenGET /imagex/v2/gen_token获取 STS 临时凭证（ServiceId=73owjymdk6）
2. ApplyImageUploadGET imagex.bytedanceapi.com/?Action=ApplyImageUpload获取上传地址，需要 AWS SigV4 签名
3. 上传二进制POST tos-d-x-lf.douyin.com/{store_uri}实际上传文件，带 Content-CRC32 校验
4. CommitImageUploadPOST ?Action=CommitImageUpload&SessionKey=xxx确认上传，SigV4 签名
5. get_img_urlGET /imagex/v2/get_img_url获取 CDN URL（https://p1-juejin.byteimg.com/...）

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 统一写到 <body style> 一次，全文继承，各 <p>/<h2>/<h3> 不再重复（text-indent 是可继承属性）
  • color / font-size / line-height 提升到最近父级 <section>，子元素只保留差异化覆盖
  • <td> 的 color 从 <body> 继承，不在每个 td 重复
  • 空格规范：style 属性内一律去掉冒号/分号后的空格，进一步节省

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

模式优化前优化后节省
日报9,324 字符8,352 字符972 字符 (10.4%)
AI文章9,527 字符9,101 字符426 字符 (4.5%)
长文3,366 字符3,156 字符210 字符 (6.2%)

前置检查

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