| name | wechat-theme-extractor-cn |
| description | 当用户需要从微信公众号文章提取视觉样式，并生成 markdown-wechat-converter 主题时使用。 |
微信文章主题提取器
Overview
从微信公众号文章中提取正文样式，生成可用于 markdown-wechat-converter 的主题配置，并在目标工具文件中自动落盘。流程会从文章中分析字体、颜色、间距和区块样式，把新主题写入 markdown-to-wechat.html，并支持写入后的预览。
何时使用
当用户有以下需求时使用本技能：
- 提供微信公众号文章链接，要求提取排版和样式
- 希望基于现有微信文章生成新的主题配置
- 需要把主题自动写入
markdown-to-wechat.html
- 需要在写入完成后直接打开目标 HTML 预览
不要使用
以下场景不应使用本技能：
- 非微信公众号文章链接
- 用户只要提取纯文本内容，不需要分析主题样式
- 目标项目中不存在
markdown-wechat-converter 或对应 HTML 配置文件
使用说明
- 先运行
scripts/extract.py，只负责抓取文章 HTML、提取标题和 js_content。
- 读取生成的
.extracted_content.html，由 AI 自行分析颜色、字号、间距、标题层级、引用块、分隔元素等样式特征。
- 基于分析结果生成适配
markdown-wechat-converter 的主题配置。
- 在当前工作区内定位并修改
markdown-to-wechat.html，将新主题追加到已有主题配置中，避免破坏现有结构。
- 修改后再次检查目标文件，确认主题配置已成功写入。
- 如果写入成功，使用系统浏览器打开
markdown-to-wechat.html 进行预览。
执行流程
用户提供链接
-> 运行提取脚本
-> 生成 .extracted_content.html
-> AI 分析样式
-> 生成主题配置
-> 写入 markdown-to-wechat.html
-> 校验写入结果
-> 打开 HTML 预览
运行脚本
python3 scripts/extract.py "https://mp.weixin.qq.com/s/xxxxx"
脚本职责边界
Python 脚本只做以下事情：
- 获取微信文章 HTML
- 提取文章标题
- 提取
js_content 正文片段
- 保存为
.extracted_content.html
以下工作由 AI 完成：
- 样式特征分析
- 主题结构生成
- 写入目标工具配置
- 写入结果校验
- 预览打开
写入 markdown-to-wechat.html 规则
更新 markdown-to-wechat.html 时，必须遵守以下规则：
-
先定位真实主题配置区域。
- 先搜索主题相关的对象、数组、映射或
const 定义，再决定修改位置。
- 不要假设固定变量名，必须以文件现有结构为准。
-
保持原有代码风格。
- 延续文件当前的缩进、引号风格、逗号风格和对象结构。
- 不要顺手重排或格式化无关代码。
-
优先追加或定点更新。
- 如果主题名不存在，在现有主题集合中追加新条目。
- 如果同名主题已存在，只更新该主题条目，不重复插入。
-
限制修改范围。
- 只修改主题定义区域，以及让主题可被选择所必须的最小注册代码。
- 除非文件结构强制要求，否则不要改动渲染逻辑、事件处理或其他 UI 代码。
-
写入后必须复检。
- 重新读取修改后的片段，确认主题键名、显示名和核心样式字段都已存在。
- 如果无法安全定位主题区块，停止自动写入并明确说明需要人工确认目标结构。
示例主题片段
生成主题时，优先产出与目标文件现有结构一致的对象。下面是一个可参考的最小示例：
{
id: "wechat-clean-blue",
name: "微信清爽蓝",
styles: {
body: {
fontFamily: "\"PingFang SC\", \"Helvetica Neue\", sans-serif",
fontSize: "16px",
color: "#2b2b2b",
lineHeight: "1.75",
backgroundColor: "#ffffff"
},
h1: {
fontSize: "24px",
fontWeight: "700",
textAlign: "center",
color: "#1f3a5f"
},
h2: {
fontSize: "20px",
fontWeight: "700",
color: "#1f3a5f",
borderBottom: "2px solid #9ec1ff"
},
blockquote: {
color: "#4a5568",
backgroundColor: "#f7fbff",
borderLeft: "4px solid #7fb3ff",
padding: "12px 16px"
}
}
}
实际写入时：
- 字段名必须以
markdown-to-wechat.html 现有主题结构为准
- 如果目标文件使用数组项、映射值或嵌套注册格式，应按原结构改写此示例
- 至少包含主题标识、显示名和核心排版样式
输出文件
scripts/.extracted_content.html：提取出的正文 HTML，首部包含标题和原始 URL 注释
校验清单
- 能成功抓取文章 HTML
.extracted_content.html 已生成且内容非空- 已提取到标题和
js_content
- 新主题已写入
markdown-to-wechat.html
markdown-to-wechat.html 打开后可正常预览
