微信扫一扫将 Markdown 文件转换为符合微信公众号规范的 HTML 文件，并可一键推送到公众号草稿箱。支持推送到稀土掘金草稿箱（图片自动上传 + MD5 缓存）。
✨ 功能特性
- 📰 两种转换模式：文章模式（默认，长文叙事，配色可配置）和新闻模式（板块化日报，需明确指定
--news） - 🎨 微信样式兼容：所有 CSS 内联，使用
<section>替代<div>，规避微信渲染限制 - 📤 草稿箱推送：转换后直接上传到微信公众号草稿箱，手动修改原创等信息后，即可发布
- 🪶 掘金草稿箱推送：Markdown 原文直接推送掘金，自动上传本地图片到掘金 CDN（ImageX 5 步流程 + AWS SigV4 签名），基于 MD5 缓存复用已上传图片
- 🖼️ 图片自动上传：自动解析 Markdown 中的本地图片引用，上传到微信永久素材库并替换为 CDN URL
- 💾 素材智能缓存：图片 + 封面图基于文件内容 MD5 缓存到 config.yaml，同一张图片不会重复上传
- 📝 Frontmatter 支持：可在 Markdown 文件顶部声明标题和摘要
- 🔧 多平台兼容：同时支持 WorkBuddy、Claude Code、OpenCode、Codex CLI
📦 安装
本 Skill 遵循通用的 SKILL.md + scripts/ 结构，可安装到多个主流 AI 编程工具中。
注意：各工具的 skill 目录名（
mukun-md-push-wechat）即仓库中的SKILL.md文件夹名。
通用方式，用自然语言安装（适用于任何 AI 智能体）
无需安装，直接在对话中把以下内容发给任意 AI 智能体：
请读取并安装这个 Skill：
https://raw.githubusercontent.com/MuKunZiAI/mukun_md_push/main/SKILL.md
AI 会自动获取 SKILL.md 中的指令并按步骤执行，无需提前配置任何环境。适用于 WorkBuddy、Claude Code、OpenCode、Cursor、Gemini CLI 等所有支持联网读取的智能体。
也可以用命令行方式安装
WorkBuddy
# 用户级安装（所有项目可用）
git clone https://github.com/MuKunZiAI/mukun_md_push.git ~/.workbuddy/skills/mukun-md-push-wechat
# 项目级安装（仅当前项目可用）
git clone https://github.com/MuKunZiAI/mukun_md_push.git .workbuddy/skills/mukun-md-push-wechat
安装后在对话中直接描述需求即可自动触发（如"把这篇md转成微信html"）。
Claude Code
# 用户级安装（所有项目可用）
git clone https://github.com/MuKunZiAI/mukun_md_push.git ~/.claude/skills/mukun-md-push-wechat
# 项目级安装（团队共享，提交到版本控制）
git clone https://github.com/MuKunZiAI/mukun_md_push.git .claude/skills/mukun-md-push-wechat
安装后通过 /mukun-md-push-wechat 手动触发，或由 Claude 根据描述自动加载。
OpenCode
OpenCode 支持两种安装方式：
方式一：Plugin 模式（推荐，支持自动更新）
在 opencode.json（全局或项目级别）中添加插件配置：
{
"plugin": ["mukun-md-push-wechat@git+https://github.com/MuKunZiAI/mukun_md_push.git"]
}
保存后重启 OpenCode，插件会自动安装并注册所有 skills。通过 use skill tool to load mukun-md-push-wechat 调用。
方式二：npm 手动安装
适用于 OpenCode 插件管理器无法自动安装的环境（如部分 Windows 版本）：
npm install mukun-md-push-wechat@git+https://github.com/MuKunZiAI/mukun_md_push.git --prefix "$HOME/.config/opencode"
然后在 opencode.json 中指向本地包：
{
"plugin": ["~/.config/opencode/node_modules/mukun-md-push-wechat"]
}
方式三：手动 clone（传统方式）
# 用户级安装
git clone https://github.com/MuKunZiAI/mukun_md_push.git ~/.opencode/skills/mukun-md-push-wechat
# 项目级安装
git clone https://github.com/MuKunZiAI/mukun_md_push.git .opencode/skills/mukun-md-push-wechat
安装后输入 /init 重新扫描加载，然后通过 @mukun-md-push-wechat 或自然语言触发。
Plugin 模式下，插件会自动将仓库根目录注册为 skills 搜索路径，并注入
CODEBUDDY_SKILL_DIR环境变量，确保 SKILL.md 中的脚本路径在 OpenCode 环境下也能正确解析。
OpenAI Codex CLI/APP
Codex CLI 使用 AGENTS.md 作为项目级指令文件，Skills 放在 ~/.codex/skills/ 目录下：
# 将 SKILL.md 复制到 Codex skills 目录
mkdir -p ~/.codex/skills/mukun-md-push-wechat
curl -o ~/.codex/skills/mukun-md-push-wechat/SKILL.md \
https://raw.githubusercontent.com/MuKunZiAI/mukun_md_push/main/SKILL.md
# 如果需要脚本（转换 HTML 和推送功能依赖 Python 脚本）
git clone https://github.com/MuKunZiAI/mukun_md_push.git /tmp/mukun_md_push
cp -r /tmp/mukun_md_push/scripts ~/.codex/skills/mukun-md-push-wechat/
rm -rf /tmp/mukun_md_push
Codex 的 Skills 是独立
.md文件格式（Description / Input / Steps），而本 Skill 使用SKILL.md+scripts/结构。上述安装方式让 Codex 读取到 SKILL.md 中的指令内容，同时脚本可用于手动调用。
⚙️ 配置文件
安装 Skill 后，需要在~/.md_push_wechat/config.yaml配置微信公众号appid和secret：
wechat:
appid: 微信公众号的 AppID
secret: 对应的 AppSecret
具体获取方式参考说明：how_to_config_wechat
💡 使用示例
安装 Skill 后，直接用自然语言告诉 AI 智能体即可：
新闻模式
<p align="center"> <img src="assets/news.JPG" alt="新闻模式" width="480" /> </p>"帮我把这篇 AI 周报转成新闻模式的微信公众号 HTML"
文章模式（默认）
"把这篇文章转成微信公众号 HTML"
白底灰字 + 棕橘胶囊标题，适合技术实践与深度文章：
<p align="center"> <img src="assets/article_default.JPG" alt="文章模式-默认" width="480" /> </p>文章模式（泛黄怀旧）
"用泛黄怀旧风格把这篇文章转成微信公众号 HTML"
古卷泛黄底色 + 深棕胶囊标题，适合历史文化类叙事长文：
<p align="center"> <img src="assets/article_nostalgic.JPG" alt="文章模式-泛黄怀旧" width="480" /> </p>文章模式（科技蓝紫）
"用科技蓝紫风格把这篇文章转成微信公众号 HTML"
白底 + 蓝紫胶囊标题 + 深蓝封面，适合 AI 科技、技术前沿文章：
<p align="center"> <img src="assets/article_modern.JPG" alt="文章模式-科技蓝紫" width="480" /> </p>文章模式（青绿引号）
"用青绿引号风格把这篇文章转成微信公众号 HTML"
米白底 + 大 Q 引号包裹标题 + 青绿下划线，适合文艺随笔、杂志专栏：
<p align="center"> <img src="assets/article_journal.JPG" alt="文章模式-青绿引号" width="480" /> </p>文章模式（角标绿条）
"用角标绿条风格把这篇文章转成微信公众号 HTML"
白底 + 黄色编号角标 + 绿色标签块标题，适合清单拆解、运营资讯：
<p align="center"> <img src="assets/article_growth.JPG" alt="文章模式-角标绿条" width="480" /> </p>文章模式（中轴蓝卡）
"用中轴蓝卡风格把这篇文章转成微信公众号 HTML"
冷灰底 + 中轴蓝色编号卡标题 + 两侧横线，适合产品文档、技术手册：
<p align="center"> <img src="assets/article_blueprint.JPG" alt="文章模式-中轴蓝卡" width="480" /> </p>文章模式（紫绿清韵）
"用紫绿清韵风格把这篇文章转成微信公众号 HTML"
白底 + 紫色胶囊框 H2（紫底紫字紫左边）+ 翠绿 H3 + 正文 2em 首行缩进，紫绿双色清雅韵味，适合深度技术随笔、研究笔记、思辨长文。预览效果见 examples/scholar/article_scholar_example.html。
完整示例 Markdown 源文件及生成的 HTML 参见 examples/ 目录，7 种预设配色配置文件参见 references/ 目录。
📝 支持的 Markdown 格式
两种模式支持的 Markdown 语法不完全相同，按场景设计：
新闻模式（md2news_html.py）
新闻模式采用「板块 → 条目」解析模型：## H2 定义板块，### H3 定义条目，---/*** 作为分隔线。
| 语法 | 写法 | 说明 |
|------|------|------|
| H1 主标题 | # 标题内容 | 文件唯一，第一个 # 行即标题 |
| 引用块 | > 日期 · 概述信息 | 解析为文章的日期/摘要区，支持 YYYY-MM-DD 日期提取 |
| H2 板块标题 | ## 行业动态 | 将新闻按板块分组，板块名称默认可映射到配色（如「行业动态」→ 金色） |
| H3 条目标题 | ### 某条新闻标题 | 每条新闻的标题，解析为独立卡片 |
| 分隔线 | --- 或 *** | 分隔不同板块或条目 |
| 表格 | \| 列1 \| 列2 \| | 紧跟 ### 条目下方的表格，自动解析为条目附属表格；内容含「⭐」的单元格高亮数字 |
| 粗体 | **加粗文字** | 内联加粗 |
| 链接 | [文字](url) | 内联超链接 |
| 行内代码 | `code` | 行内代码样式 |
| 行内图片 |  | 行内图片（智能跳过 <code> 标签内的图片引用） |
| 来源标注 | 来源：链接或说明 | 行首以可配置前缀（默认 来源： / 来源:）开头，识别为来源信息 |
| 页脚声明 | *声明文字* | 以 * 包裹的行尾声明文字（如「以上内容由 AI 整理」） |
结构约定：
# 2026-05-26 AI 行业周报
> 2026-05-26 · 本周 AI 行业主要动态概览
## 行业动态
### 某公司发布新产品
产品描述文字，**重点加粗**。[详情链接](https://example.com)。
来源：某某科技
### 行业报告发布
| 类别 | 详情 |
|------|------|
| 行业 | 报告内容 |
| 工具 | 工具内容 |
---
## 模型发布
### GPT-5 正式公布
新的模型在基准测试中表现出色。
*以上内容由 AI 整理，仅供参考*
文章模式（md2article_html.py）
文章模式采用「顺序段块」解析模型：逐行解析，按 Markdown 语法分类为不同类型的内容块。
| 语法 | 写法 | 说明 |
|------|------|------|
| H1 主标题 | # 标题内容 | 文件唯一，第一个 # 行即标题 |
| H2 章节标题 | ## 章节名 | 渲染为居中底色标签样式（背景色 = accent） |
| H3 子标题 | ### 子标题 | 渲染为粗体加黑副标题 |
| 引用块 | > 引用文字 | 支持连续多行（连续的 > 行合并为一个引用块），渲染为灰底 + 左侧强调色竖线样式 |
| 围栏代码块 | ``` ... ``` | 多行代码块，渲染为浅灰底 + 等宽字体（Menlo / Monaco） |
| 分隔线 | ---、*** 或 * * * | 独立行的分隔线，渲染为段落间的空白分隔 |
| 独立行图片 |  | 独占一行的图片，渲染为居中块级元素 |
| 表格 | \| 列1 \| 列2 \| | 标准 Markdown 表格，自动跳过对齐行，斑马纹交替背景 |
| 粗体 | **加粗文字** | 内联加粗 |
| 链接 | [文字](url) | 内联超链接 |
| 行内代码 | `code` | 行内代码样式（灰底 + 强调色文字） |
| 行内图片 |  | 段落内的图片（智能跳过 <code> 标签内的图片引用） |
结构约定：
# 技术实践：使用 Calcite 实现 SQL 行级权限控制
## 背景
> 引用说明：数据安全是数据平台的核心需求之一...
数据平台的权限控制通常涉及多个维度，其中行级权限是最复杂的。
### 技术选型
Apache Calcite 是一个开源的 SQL 解析与优化框架...
| 维度 | Calcite | 原生 JDBC |
|------|---------|-----------|
| SQL 解析 | 完整 AST | 不支持 |
| 权限注入 | 灵活 | 需自行实现 |
---
## 具体实现
### SQL 解析流程
```java
SqlParser parser = SqlParser.create(sql);
SqlNode node = parser.parseQuery();
```
上述代码完成 SQL 的初始解析。
模式差异速查
| 功能 | 新闻模式 | 文章模式 |
|------|:---:|:---:|
| # H1 标题 | ✅ | ✅ |
| > 引用块 | ✅（日期/摘要） | ✅（支持多行合并） |
| ## H2 标题 | ✅（板块切分） | ✅（章节标题） |
| ### H3 标题 | ✅（条目切分） | ✅（子标题） |
| --- / *** 分隔线 | ✅（板块/条目分隔） | ✅（段落分隔） |
| [链接](url) | ✅ 内联 | ✅ 内联 |
| **粗体** | ✅ 内联 | ✅ 内联 |
| `行内代码` | ✅ 内联 | ✅ 内联 |
|  | ✅ 内联 | ✅ 内联 + 独立行 |
| \| 表格 \| | ✅（条目附属） | ✅（斑马纹） |
| ``` 代码块 ``` | ❌ | ✅ |
| 来源： 标注 | ✅（行首前缀匹配） | ❌（作为普通段落） |
| *页脚* 声明 | ✅ | ❌ |
| 结构化板块模型 | ✅（H2 → H3 层级） | ❌ |
| 顺序段块模型 | ❌ | ✅ |
选择建议：AI 日报、行业动态等板块化内容 → 新闻模式；技术实践、深度文章等线性叙述 → 文章模式。
🎨 样式配置参考
通过 ~/.md_push_wechat/config.yaml（或 --config 参数）自定义样式。只有两种模式节点：style.news 和 style.article。
| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| bg | #f5f0e1 | 页面背景色（米黄报纸底色） |
| card | #faf7f0 | 卡片/板块底色 |
| dark | #3c2415 | 深色文字 |
| heading | #3c2415 | 标题颜色 |
| accent | #b8860b | 强调色（板块名称标签） |
| rule | #c9b99a | 分隔线颜色 |
| muted | #a08c6a | 次要文字 |
| caption | #a89880 | 脚注/报尾文字 |
| hero_bg | #2c1810 | 封面标题区底色 |
| table_bg | #f0ead8 | 表头底色 |
| title_font_size | 22px | 文章主标题 |
| text_font_size | 15px | 正文文字 |
| h2_font_size | 18px | H2 板块标题 |
| card_font_size | 15px | 板块内文字 |
| cover_label | AI WEEKLY REVIEW | 封面副标题 |
| section_colors | 见默认值 | 板块名→颜色映射（map） |
| summary_colors | 见默认值 | 总结表格类别→颜色映射（map） |
| summary_sections | ["总结"] | 触发总结表格渲染的关键词列表 |
| source_label | "来源：" | 来源标注的显示前缀 |
| source_prefixes | ["来源：", "来源:"] | Markdown 中来源行的检测前缀列表 |
| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| bg | #ffffff | 页面背景色 |
| text | rgb(85,85,85) | 正文文字颜色 |
| accent | rgb(198,110,73) | 强调色（封面底色） |
| hero_bg | rgb(198,110,73) | 封面标题区底色 |
| hero_title_color | #ffffff | 封面标题文字颜色 |
| bold | rgb(51,51,51) | 加粗文字颜色 |
| rule | #ddd | 分隔线颜色 |
| caption | #888 | 脚注/次要文字 |
| title_font_size | 22px | 文章主标题 |
| text_font_size | 16px | 正文文字 |
| h2_font_size | 18px | H2 标题 |
| h2_style | pill | H2 样式：pill / quote_line / badge_block / center_card / framed_pill |
| h2_badge_bg | #f7b731 | badge_block 编号徽章背景色 |
| h2_badge_text | #ffffff | badge_block 编号徽章文字色 |
| h2_index_bg | accent | center_card 编号卡背景色 |
| h2_index_text | #ffffff | center_card 编号卡文字色 |
| h2_frame_bg | #f8f0fb | framed_pill 胶囊背景色 |
| h2_frame_border | accent | framed_pill 左边框颜色 |
| h2_frame_border_width | 5px | framed_pill 左边框宽度 |
| h2_frame_radius | 4px | framed_pill 圆角半径 |
| h3_color | #333 | H3 子标题文字颜色 |
| h4_color | #555 | H4 小标题文字颜色 |
| p_indent | 0 | 正文段落首行缩进（如 2em 启用学术体缩进） |
| hero_style | default | 封面样式：default（色块卡片）/ minimal（极简左对齐大标题） |
| font_family | 系统中文字体栈 | 页面字体栈 |
| content_bg | transparent | 正文区背景色 |
| cover_label | AI 实践观察 | 封面副标题（minimal 模式下若为空则不显示） |
| footer | "" | 底部署名（空字符串不显示） |
| ending_lines | 5 行默认尾栏 | 文末尾栏，[] 关闭，支持 HTML 标签 |
🎨 预设样式速查（自然语言 → 配置文件）
文章模式内置 7 种预设样式，通过 AI 智能体（WorkBuddy/Claude Code 等）用自然语言描述即可自动匹配。也可直接通过 --config 传入 references/ 下的配置文件。
| 预设 | 配置文件 | 视觉特征 | 自然语言触发词 |
|------|---------|---------|--------------|
| 默认 | 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"、"灰底"、"冷灰"、"产品文档" |
| 紫绿清韵 | references/article_scholar.yaml | 白底 + 紫色胶囊框 H2（紫底紫字紫左边） + 翠绿 H3 + 首行缩进 | "清韵"、"紫绿"、"紫绿清韵"、"紫胶囊"、"紫框"、"双色对比"、"技术博客"、"深度技术"、"研究笔记"、"思辨"、"学术"、"码上菩提" |
# 直接用 --config 引用预设
python3 scripts/md2wechat_html.py --config references/article_nostalgic.yaml story.md
python3 scripts/push_daily.py --config references/article_modern.yaml story.md
python3 scripts/md2wechat_html.py --config references/article_journal.yaml story.md
🔧 如何新增自定义配置
内置的 7 种预设样式不能满足需求时，有两种方式新增自定义配置：
方式一：修改全局配置文件（影响所有未指定 --config 的文章模式推送）
直接编辑 ~/.md_push_wechat/config.yaml，在 style: 下增加或修改 article: 段：
# ~/.md_push_wechat/config.yaml
wechat:
appid: "wx..."
secret: "..."
style:
article:
bg: "#f8f9fa"
accent: "rgb(0,150,136)"
hero_bg: "rgb(0,150,136)"
cover_label: "我的专栏"
方式二：创建独立配置文件（推荐，可版本管理、可分享）
- 从
references/目录复制一个预设配置文件（如article_default.yaml） - 修改其中的颜色、字体、封面标签等字段
- 通过
--config参数指定该文件：
# 转换 HTML
python3 scripts/md2wechat_html.py --config /path/to/my_style.yaml my_article.md
# 转换 + 推送
python3 scripts/push_daily.py --config /path/to/my_style.yaml my_article.md --digest "..."
最简自定义示例（只覆盖你想改的字段，其余用代码默认值）：
# my_style.yaml
style:
article:
bg: "#f0f4f8"
accent: "rgb(22,138,173)"
hero_bg: "rgb(22,138,173)"
cover_label: "技术随笔"
可覆盖字段见上方「文章模式 style.article 配置项参考」表格。所有颜色支持 HEX (#rrggbb) 或 rgb(r,g,b) 格式。
提示：如果有多个系列文章需要不同配色，建议用方式二（独立配置文件），推送时分别指定
--config。
🚀 使用方式
仅转换 HTML
# 文章模式（默认）
python3 scripts/md2wechat_html.py story.md
# 新闻模式
python3 scripts/md2wechat_html.py --news article.md
# 使用自定义配色配置
python3 scripts/md2wechat_html.py --config /path/to/my_theme.yaml story.md
# 或直接调用独立脚本
python3 scripts/md2news_html.py article.md
python3 scripts/md2article_html.py --config /path/to/my_theme.yaml story.md
转换 + 推送草稿箱
推送前需要配置 ~/.md_push_wechat/config.yaml：
wechat:
appid: your_appid
secret: your_secret
图片自动上传与缓存
脚本在推送时会自动处理 Markdown 中的本地图片引用（）：
- 从 Markdown 中解析所有
图片引用 - 解析到本地文件（支持相对路径、绝对路径、alt 描述模糊匹配）
- 计算文件内容的 MD5 hash，先在
config.yaml的image_cache.content中查找缓存 - 命中缓存 → 直接复用微信 CDN URL，无需重新上传
- 未命中 → 通过微信永久素材接口
cgi-bin/material/add_material上传，获取 CDN URL 后写入缓存
封面图同理，基于文件内容 MD5 缓存到 image_cache.cover 段，同一张封面图无论路径如何变化都会被识别并永久复用。
缓存结构（自动写入 config.yaml，无需手动维护）：
image_cache:
cover:
<md5_hash>: "<media_id>"
content:
<md5_hash>: "<CDN URL>"
关键优势：同一张图片无论放在哪个目录、叫什么文件名，只要文件内容相同，MD5 hash 就相同，永远不会被重复上传。彻底避免多次推送时图片重复上传导致微信公众号永久素材库被打爆的问题。
# 文章模式推送（默认）
python3 scripts/push_daily.py story.md
# 新闻模式推送
python3 scripts/push_daily.py --news article.md
# 自定义标题、封面图、摘要
python3 scripts/push_daily.py story.md --title "自定义标题" --cover ./封面图.png --digest "自定义摘要"
推送草稿箱（稀土掘金）
推送前需在 ~/.md_push_wechat/config.yaml 中配置掘金 Cookie：
juejin:
cookie: "your_juejin_cookie" # 必填，登录 juejin.cn → F12 → Cookies
category_id: "6809637773935378440" # 可选默认分类
tag_ids: "7467857238494019610" # 可选默认标签
图片上传到掘金 CDN
推送时自动扫描 Markdown 中的本地图片引用，通过掘金 ImageX 服务上传。完整 5 步流程：
| 步骤 | 接口 | 说明 |
|------|------|------|
| 1. gen_token | GET /imagex/v2/gen_token | 获取 STS 临时凭证（AccessKeyId/SecretAccessKey/SessionToken） |
| 2. ApplyImageUpload | GET imagex.bytedanceapi.com/?Action=ApplyImageUpload | 获取上传地址，需要 AWS SigV4 签名 |
| 3. 上传二进制 | POST tos-d-x-lf.douyin.com/{store_uri} | 上传文件，带 Content-CRC32 校验 |
| 4. CommitImageUpload | POST ?Action=CommitImageUpload&SessionKey=xxx | 确认上传，SigV4 签名 |
| 5. get_img_url | GET /imagex/v2/get_img_url | 获取 CDN URL（https://p1-juejin.byteimg.com/...） |
图片基于文件内容 MD5 缓存到 config.yaml 的 image_cache.juejin 段，同一张图永久复用：
image_cache:
juejin:
<file_hash>: "<CDN URL>"
# 新建草稿
python3 scripts/push_juejin.py story.md --title "文章标题" --digest "50-100字摘要"
# 更新已有草稿
python3 scripts/push_juejin.py story.md --update DRAFT_ID
# 查询可用标签
python3 scripts/push_juejin.py --query-tags "AI"
# 指定分类和标签
python3 scripts/push_juejin.py story.md --title "标题" --digest "摘要" \
--category "后端" --tags "6809640445233070098,6809640408797167623"
掘金分类 ID 速查：
| 分类 | ID | 分类 | ID |
|------|----|------|----|
| 后端 | 6809637769959178254 | 前端 | 6809637767543259144 |
| AI | 6809637773935378440 | 开发工具 | 6809637771511070734 |
| Android | 6809635626879549454 | iOS | 6809635626661445640 |
📁 目录结构
mukun_md_push/
├── package.json # NPM 包定义（OpenCode/Codex 插件安装）
├── SKILL.md # Skill 定义文件（各工具通用入口）
├── .opencode/
│ └── plugins/
│ └── mukun-md-push-wechat.js # OpenCode 插件入口
├── scripts/
│ ├── md2wechat_html.py # 统一入口（模式路由 + 参数解析）
│ ├── md2news_html.py # 新闻模式转换器
│ ├── md2article_html.py # 文章模式转换器
│ └── push_daily.py # 转换 + 推送草稿箱脚本
├── references/ # 文章模式 7 种预设样式（自然语言 → 配置文件）
│ ├── article_default.yaml # 默认（白底灰字 + 棕橘胶囊标题）
│ ├── article_nostalgic.yaml # 泛黄怀旧（古卷泛黄 + 深棕胶囊标题）
│ ├── article_modern.yaml # 科技蓝紫（白底 + 蓝紫胶囊标题）
│ ├── article_journal.yaml # 青绿引号（米白底 + 大 Q 引号线标题）
│ ├── article_growth.yaml # 角标绿条（白底 + 黄角标 + 绿标签块）
│ ├── article_blueprint.yaml # 中轴蓝卡（冷灰底 + 中轴蓝色编号卡）
│ └── article_scholar.yaml # 紫绿清韵（白底 + 紫色胶囊框 H2 + 翠绿 H3 + 首行缩进）
├── examples/
│ ├── config_example.yaml # 完整配置示例（news + article 所有可配置项）
│ ├── default/ # 默认配色示例（源文件 + 生成 HTML）
│ │ ├── news_example.md # 新闻模式源文件
│ │ ├── news_example.html # 新闻模式 HTML（生成，默认报纸配色）
│ │ ├── article_example.md # 文章模式源文件（AI 技术实践）
│ │ ├── article_example.html # 文章模式 HTML（生成，默认配色）
│ ├── nostalgic/ # 泛黄怀旧配色方案
│ │ ├── config_nostalgic.yaml
│ │ ├── article_nostalgic_example.md # 文章模式源文件（成语典故）
│ │ └── article_nostalgic_example.html # 文章模式 HTML（生成，怀旧配色）
│ ├── modern/ # 科技蓝紫配色方案
│ │ ├── config_modern.yaml
│ │ └── article_modern_example.html # 文章模式 HTML（生成，蓝紫配色）
│ ├── journal/ # 青绿引号配色方案
│ │ └── article_journal_example.html # 文章模式 HTML（生成，青绿配色）
│ ├── growth/ # 角标绿条配色方案
│ │ └── article_growth_example.html # 文章模式 HTML（生成，角标配色）
│ ├── blueprint/ # 中轴蓝卡配色方案
│ │ └── article_blueprint_example.html # 文章模式 HTML（生成，蓝卡配色）
│ └── scholar/ # 紫绿学术配色方案
│ └── article_scholar_example.html # 文章模式 HTML（生成，学术配色）
├── LICENSE
└── README.md
📱 扫码关注公众号“木昆子记录AI”
<p align="center"> <img width="240" height="240" alt="木昆子记录AI 公众号二维码" src="https://github.com/user-attachments/assets/de2382e2-ca65-4294-aa64-16b61bbdc5a5" style="border-radius:12px;box-shadow:0 2px 8px rgba(0,0,0,0.12)" /><br/><br/> <sub>专注分享 AI 落地工程化经验和 AI 产品及工具使用心得</sub> </p>📋 修改说明
2026-06-09
- 新增「紫绿清韵」预设样式：第 7 种文章模式预设，致敬「码上菩提」公众号的双色技术博客风格。H2 用浅紫底 + 紫文字 + 紫色 5px 左粗边 + 4px 圆角胶囊框；H3 用翠绿加粗（
#2e7d32）；正文 15px + 首行缩进 2em；封面采用极简模式（白底黑色大标题，左对齐，无装饰）。配置文件references/article_scholar.yaml，触发词：清韵 / 紫绿 / 紫绿清韵 / 紫胶囊 / 紫色胶囊 / 紫框 / 双色 / 双色对比 / 技术博客 / 深度技术 / 研究笔记 / 思辨 / 学术 / 学者 / 码上菩提 - 文章模式脚本能力扩展（新增 4 项可配置维度，老 6 个预设默认行为不变）：
h2_style: framed_pill— 第 5 种 H2 样式：背景色 + 主色文字 + 主色左粗边 + 圆角胶囊。配套h2_frame_bg/h2_frame_border/h2_frame_border_width/h2_frame_radius四项细节配置p_indent— 正文段落首行缩进（默认0；填2em启用学术体首行缩进）hero_style— 封面布局：default（色块卡片，原行为）/minimal（极简左对齐大标题，无顶条无 label）
- 清理脚本中重复定义的
render_h2函数：原文件中存在两个相同函数定义（同名后定义覆盖前定义），现合并为单一函数并新增framed_pill分支 - SKILL.md 注册触发词：在预设表格、匹配规则中加入「紫绿清韵」对应分支
- README 同步更新：示例卡片、预设速查表（6 种 → 7 种）、配置项表格、目录结构
2026-06-06
- 修复微信公众号过滤
<body>行内样式：微信会过滤<body>标签上的style属性（包括background），导致泛黄报纸风格等自定义背景色失效。将background:__BG__从<body>移到新包裹的<section>上，正文区域同步添加content_bg字段支持 nostalgic主题新增content_bg字段：值为"#f6f1e7"，确保正文区域泛黄底色完整- 新闻模式解析增强：支持
**加粗标题** 描述文字作为条目开头（日报格式），无需###前缀即可识别为新闻条目 - 新闻模式来源日期去重：
render_item()新增检测来源文本是否已含YYYY-MM-DD日期，若已含则不再追加全局 meta 日期，避免渲染为来源：xxx | 2026-06-06 | 2026-06-06重复日期 - 文章模式 / 新闻模式均默认去除标题块：
no_title默认值改为True，新增--no-title（默认开启）/--with-title参数，--with-title可恢复显示封面标题区 - 修复
push_daily.py未传递--config参数给子进程：重构main()参数解析逻辑，统一消费全部已知参数（--config、--no-title、--with-title、--news、--article、--update、--title、--cover、--digest、--media-id），避免参数遗漏或重复消费 - 修复
md2wechat_html.py未透传--no-title/--with-title：新增pass_through列表，将标题块开关正确传递给md2article_html.py/md2news_html.py
2026-06-04
- 新增 3 种文章模式预设样式：在原有 3 种（默认/泛黄怀旧/科技蓝紫）基础上新增清爽专栏、内容增长、蓝图科技，预设总数从 3 种扩展为 6 种。每个预设对应
references/下独立的 YAML 配置文件 - 后三种预设重命名为具象描述型名称：
- 清爽专栏 → 青绿引号（颜色锚点"青绿" + 视觉锚点"大 Q 引号包裹标题"）
- 内容增长 → 角标绿条（两个视觉锚点"黄色数字角标" + "绿色标签块"）
- 蓝图科技 → 中轴蓝卡（结构锚点"居中蓝色编号卡" + "两侧横线"）
- 视觉特征描述更新：六种预设的描述均改为对应视觉锚点，让用户听名字就能在脑海中浮现画面
- 自然语言触发词全面优化：消除关键词冲突与歧义
- "绿" 同时命中两种 → 拆分为"青绿"（青绿引号）和"角标绿条""绿底封面"（角标绿条）
- "科技"被蓝图和科技蓝紫共享 → 蓝图改用"产品文档""技术手册"；科技蓝紫保留"科技""技术"
- "编号"/"编号卡" 同时命中两种 → 拆分为"角标编号"（角标绿条）和"中轴编号""编号卡"（中轴蓝卡）
- "深色"误导（科技蓝紫是白底不是深色模式）→ 改为"深蓝封面"
- "报纸"误导（怀旧不是报纸风格，报纸风格在新闻模式）→ 移除，新增"古卷""暖黄"
- "炫酷""quote""复盘""普通"等太泛或英文依赖过高的词 → 移除，改用更精准的中文描述
- 每类新增底色系触发词（白底/黄底/暖黄/灰底/冷灰/蓝灰底），提升匹配精准度
- SKILL.md、README.md 预设表格和匹配规则同步更新：预设数量从"3 种"修正为"6 种"，新增
references/article_journal.yaml的命令示例 - 6 个 YAML 配置文件注释更新：注释中的样式名称、视觉描述、适用场景、触发词全部同步为最新版本
- 示例 HTML 全部重新生成：
examples/下 4 个原有示例 HTML（default 文章/新闻、modern、nostalgic）用最新脚本和配置重新生成，确保截图与实际效果一致
2026-05-30
- 掘金图片上传完整重写：从 HAR 文件逆向掘金编辑器图片粘贴行为，完整还原 ImageX 5 步上传流程（gen_token → ApplyImageUpload → 上传二进制 → CommitImageUpload → get_img_url）
- AWS SigV4 签名实现：新增
_sigv4_auth/_sigv4_sign签名函数，修复 ImageX API 的InvalidAuthorization错误。参数排序使用sorted()确保 AWS 要求的字母顺序，避免urllib.parse.urlencode(dict)顺序不稳定的问题 - ServiceId 修正：从
k3u1fbpfcp改为73owjymdk6（HAR 逆向确认的正确服务 ID） - 图片 MD5 缓存（掘金）：参照微信图片缓存模式，新增
image_cache.juejin段。基于文件内容 MD5 缓存 CDN URL，同一张图永久复用，避免重复上传 - mark_content 图片引用修复：上传后替换为完整 CDN URL（
https://p1-juejin.byteimg.com/...）而非 store_uri，确保草稿中图片正常显示 - gen_token 接口升级：API 版本从 v1 升级为 v2，新增
aid/uuid/client参数，Cookie 必传 - 草稿 API 字段补全：新增
is_gfw、is_english、is_original、pics字段，匹配掘金编辑器实际请求格式 - 文档更新：README 新增掘金推送章节（ImageX 上传流程、缓存机制、分类速查、使用示例），目录结构加入
push_juejin.py
2026-05-28
- 代码块编辑模式支持行号、高亮：将代码区域的样式改为微信编辑器的代码块样式，微信文章会自行渲染
- 代码块编辑模式兼容性全面修复：微信编辑器编辑模式会 normalize 空白字符并 strip CSS 属性，导致代码块的换行、横向滚动、缩进三项全部失效。修复方案分三层：
- 换行：不再依赖
\n（会被 normalize），每行独立<code style="display:block">块级元素，换行由 DOM 结构天然保证 - 横向滚动：
section[overflow:auto]提供滚动容器，code[white-space:nowrap]阻止长行折行（编辑模式下white-space:pre会被 strip，nowrap不受影响） - 缩进：
white-space:nowrap会折叠行首空白 → 将前导空格转为 、制表符转为 4× （HTML 实体不被微信编辑器折叠），既保留缩进视觉效果又不影响滚动
- 换行：不再依赖
- 列表编辑模式多余空行修复：
_render_list_block()生成的 HTML 中<li>元素间包含\n，微信编辑器将其解释为新的空列表项，产生带项目符号的多余空行。改为紧凑拼接（''.join(items_html)），去除所有元素间换行 - 文章模式列表解析增强：
parse_article()引入list_stack缩进追踪，支持嵌套列表（无限层级）、任务列表（- [ ]/- [x]）、混合标记符（-/*/+）；generate_html()新增_render_list_block()递归渲染；修复不同类型兄弟列表（ol/ul/task）的错误嵌套
2026-05-27
- 默认模式切换：从新闻模式（
--news）改为文章模式（--article）作为默认。md2wechat_html.py中mode = "article"，push_daily.py中article_mode = True，新增--news参数用于显式指定新闻模式。SKILL.md 中新增默认模式决策规则：仅当用户明确说"新闻模式"或上文在讨论新闻日报时才使用--news - 文章模式新增列表解析：
md2article_html.py的parse_article()新增有序列表（1. 2. 3. ...正则^(\d+)\.\s+(.+)$）和无序列表（- * +正则^[\-\*\+]\s+(.+)$）的检测与解析，连续同类型列表项自动合并为一个 block。generate_html()新增<ol>和<ul>渲染分支，列表项支持内联粗体、代码等格式 - 代码块横向滚动修复：
render_code_block()中行分隔从<br>改为\n，使white-space: pre正确生效；CSS 新增word-break: normal、overflow-wrap: normal、-webkit-overflow-scrolling: touch防御属性，确保长行代码不换行、出现横向滚动条
2026-05-26
- README 新增「支持的 Markdown 格式」章节：分别列举新闻模式（12 种语法 + 结构约定示例）和文章模式（12 种语法 + 结构约定示例），附带两种模式的差异速查表和选择建议
- 新增
references/预设样式目录：文章模式 3 种预设样式（默认/泛黄怀旧/科技蓝紫）独立为 YAML 配置文件，SKILL.md 中加入自然语言 → 样式映射规则，用户说"怀旧风格""科技蓝紫"等即可自动匹配。也可直接--config references/article_nostalgic.yaml使用 - 移除 20000 字符拆分限制：删除了
push_daily.py中的MAX_CONTENT_LENGTH、split_html_content、_push_multi_drafts、_truncate_title等函数，以及md2article_html.py/md2news_html.py中的字符限制警告。现在任意长度的内容都可以一次性推送，不再自动拆分 - 图片素材自动上传与 MD5 缓存：推送时自动解析 Markdown 中的本地图片引用，通过微信永久素材接口
cgi-bin/material/add_material上传。基于文件内容 MD5 hash 缓存到config.yaml的image_cache.content段，同一张图片仅首次上传，后续直接复用 CDN URL - 封面图 MD5 缓存：封面图 media_id 同样基于文件内容 MD5 缓存到
config.yaml的image_cache.cover段，同一张封面图永久复用 - 旧缓存自动迁移：首次运行时自动将旧的
image_asset_map.json和cover_media_id.txt迁移到config.yaml的新缓存格式 - 修复
--update参数顺序 bug：--update放在输入文件之前会误将文件名当作 media_id。统一约定input.md --update顺序，文档中所有示例已更新 - 新闻模式中文标题配置化：
来源：标签从代码硬编码改为从style.news.source_label读取（默认 "来源："），Markdown 来源行检测前缀改为从source_prefixes列表读取（默认 ["来源：", "来源:"]） - HTML 模板清理：移除新闻模式模板中的中文 HTML 注释
2026-05-25
- 模式重构：三模式简化为两模式 + 文件重命名
md2news_html.py：新闻模式（原 daily），独立脚本，板块化内容 + 报纸配色，通过style.news配置md2article_html.py：文章模式（原 essay + ai 合并），统一长文渲染，默认 AI 风格配色（白底灰字），通过style.article配置可切换为泛黄怀旧等任意风格md2wechat_html.py：统一入口（wrapper），负责模式路由和配置参数解析，--news/--article标志，默认为--news- 模板文件全部重命名：
daily_example.*→news_example.*，ai_article_example.*→article_example.*，essay_example.*→article_nostalgic_example.*
- push_daily.py 同步更新：使用
--article标志，封面图处理合并为统一的文章模式逻辑 - 配置结构调整：
style.ai/style.essay统一为style.article，example 配置文件同步更新 - 配置解析器增强：新增
ending_lines: []空列表支持，用于关闭文章模式尾栏 - 示例全部重新生成：所有 HTML 预览文件用新脚本重新生成（daily→news 模式，essay/ai→article 模式+对应配色）
- 新增
examples/config_example.yaml：完整配置示例，覆盖 news/article 两种模式下所有可配置项及默认值 - README 新增样式配置参考章节：折叠式展开两个模式的完整配置项表格，方便查阅
- README/SKILL.md/package.json：全部更新为两模式描述
2026-05-24
- 日报分类颜色可配置：
SECTION_COLORS从硬编码改为从config.yaml的daily.section_colors读取。用板块名: 颜色值的 map 格式配置，配置后完整覆盖默认值，未匹配的板块名用accent兜底。使得「科技前沿」、「金融动态」等任意自定义板块名都能有独立配色 - 总结表格类别颜色可配置：
render_summary_table()中 "行业/工具/模型/研究" 四个硬编码类别标签颜色改为从daily.summary_colors读取，支持完全自定义 - 总结板块判断可配置：之前固定判断板块名包含「总结」才渲染为总结表格，改为从
daily.summary_sections读取关键词列表（默认["总结"]）。包含列表中任意关键词即触发总结渲染，支持「汇总」、「本期总结」等不同写法 - YAML 解析器扩展：
load_style_config()新增支持三级嵌套 map（section_colors/summary_colors）和列表（summary_sections），支持含中文的 key（板块名） - 底部结尾文字全部可配置：
- daily 模式：封面副标题（默认
"AI WEEKLY REVIEW"）改为daily.cover_label可配置 - ai 模式：尾栏固定文字（—End—、三连、关注+星标、支持感谢、版权声明）改为
ai.ending_lines列表可配置，每项渲染为一个段落，支持内嵌 HTML 标签 - essay 模式：
footer（底部署名）与cover_label（封面副标题）已可通过essay.footer/essay.cover_label配置（均含默认值）
- daily 模式：封面副标题（默认
- 推送摘要改为 AI 自动生成：之前推送草稿箱时，若未手动指定
--digest则直接截取正文前 120 字符，产生不完整无意义的截断。改为在 SKILL.md 中指示 AI agent 先读取文章内容、自动生成 120 字以内的精炼摘要再通过--digest传入。frontmatter 中已有digest时仍优先使用手动值
2026-05-23
- CSS 内联优化：将
text-indent、font-size、color、line-height等可继承属性提升到父级<body>/<section>，减少重复声明。日报模式节省 10.4%，AI 模式节省 4.5%，长文模式节省 6.2% - 超长文章自动拆分：HTML 超过 20000 字符时按段落边界自动拆分为多篇，合并到同一个草稿推送，标题自动追加（上/中/下）后缀，智能截断保留后缀（
_truncate_title()） - 样式配置外部化：
md2wechat_html.py新增load_style_config()从~/.md_push_wechat/config.yaml读取style节点覆盖内置默认值，支持 daily/ai/essay 三种模式独立配色，纯字符串解析 YAML 不引入额外依赖 --config参数：md2wechat_html.py支持通过--config <path>指定任意配色配置文件- 修复代码块缩进丢失：
parse_essay()收集代码块行时改用raw（保留行首空格），修复 YAML、文件树等缩进代码渲染后缩进丢失的问题 - 修复 YAML 值解析：引号内的
#颜色码不再被误判为注释，load_style_config()正确读取自定义config_path参数 - 示例按配色方案分目录：
examples/下新增default/、nostalgic/（泛黄怀旧）、modern/（科技蓝紫）三个子目录，各含配置文件和示例 HTML
📄 License
MIT