用途
aws-wechat-article-formatting 用于微信公众号排版:把 Markdown 文稿转换为微信后台可直接粘贴的 HTML,实现一键排版、多主题、多字号、段落样式切换,所见即所得。目标用户是公众号编辑、独立作者、排版岗。该 skill 属于 aws-wechat-article-* 一条龙套件(共 9 个 slug,入口为 aws-wechat-article-main)。跨 skill 的相对引用依赖同一 skills/ 目录,建议一并安装全套。源码地址为 https://github.com/aiworkskills/wechat-article-skills。
主要能力
- 纯本地 Markdown → HTML 转换,零网络、零凭证。
- 模版(骨架:标题装饰、导语、金句卡、图片处理、分隔、文末)× 配色(一组主色/次色,派生色自动重算)。
- 内置模版:亲和(默认)、资讯、书卷、杂志;每套带若干配色。
- 另有活力、手账、硬朗、技术四套模版不随 skill 内置,在 aiworkskills.cn 选好模版和配色后随 .aws 预设包下发到 .aws-article/presets/formatting/,网站上选的配色会烘进 YAML 顶层 variables。
- 从标准 markdown 识别结构:加粗做重点色或荧光底、
- **标签**:说明做视觉提、- [ ]/- [x]换三态图标、带出处引号排成金句卡、普通引用补大引号、图片加四角标与图注(限显式 title)、---装饰分隔、##标题装饰。 - 只认形态,不推断语义。有序列表仅表示枚举,不会渲染成“第一步 第二步”。
- 支持通过命令行指定模版、配色、主色、字号,并支持预览与导出主题。
使用方式
在仓库根执行(路径按实际本篇目录调整):
不传 --theme:读本篇 default_format_preset,否则 亲和
{python} {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md -o drafts/YYYYMMDD-slug/article.html
显式指定模版 / 配色(覆盖配置)
{python} {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md --theme 资讯 --scheme 绛红 -o drafts/YYYYMMDD-slug/article.html
自定义主色 / 字号
{python} {baseDir}/scripts/format.py article.md --color '#C0392B' {python} {baseDir}/scripts/format.py article.md --font-size 15px
查看模版与配色:
{python} {baseDir}/scripts/format.py --list-themes
预览对照页(每栏 375px,与真机同宽):
{python} {baseDir}/scripts/format.py --preview 亲和 -o preview.html # 该模版的每套配色并列 {python} {baseDir}/scripts/format.py --preview -o preview.html # 所有模版的默认色并列
主要选项包括:--theme(模版,省略则按本篇配置 → 内置 亲和)、--scheme(配色)、--color(自定义主色 hex)、--font-size(正文字号,默认 16px)、-o(输出路径)、--list-themes、--preview、--export-theme、--no-preformat。
工作流分四步:第0步配置检查(任何操作前先按首次引导·检测顺序执行,通过后才继续,或用户明确书面确认本次不检查);第1步确定模版与配色(--theme 显式指定最优先,不传则读本篇 article.yaml 的 default_format_preset,再无则内置默认 亲和);第2步转换;第3步核对输出。
适用场景
- 教程、职场、面向新手的解释性长文适合亲和新手类模版;快讯、评测、行业观察适合资讯;人文、读书、历史、深度长文适合书卷;品牌故事、人物访谈、生活方式适合杂志。
- 严肃议题、极简冷硬的品牌不适合亲和;抒情散文、碎片化短段不适合资讯;工程文档、数据密集的评测不适合书卷;没有配图的稿子、信息型短文不适合杂志。
- 写作侧只产出标准 markdown,识别结构交由排版层,避免写手掌握私有语法。
能力边界与限制
- 本 skill 为纯本地转换,零网络、零凭证。
- 凭证:无。网络:无。
- 文件读(仓库内):.aws-article/config.yaml、本篇 article.yaml、article.md、可选 closing.md、.aws-article/presets/formatting/<名>.yaml。
- 文件读(仓库外):~/.aws-article/presets/formatting/(跨项目共享的自定义主题;只读预设文件,不读凭证)。
- 文件写:本篇 article.html。
- shell:仅 {python} {baseDir}/scripts/format.py。
- 单独安装可直接使用:format.py 零依赖、纯本地,无跨 skill 脚本调用。文档里指向 ../aws-wechat-article-main/references/*.md 的链接在套件未装齐时会断,但排版功能本身可用。
- 图片图注只认显式写的 title;没写 title 就不出图注。是否出图注还受合并配置的 caption_style 控制(有图注全出、无图注全不出、关键图有则只有信息位的图出)。
- 正文不含文章标题(article.md 的首个 # 被跳过,标题在后台单独填)。
- 配图标记还是 placeholder 时保留为 <img>,等 images skill 替换,终审前必须全部换成真实路径。
- 文末 {embed:…} 的合并规则中,占位符与配置对不上会直接失败。
- 模版、配色、字号、主色的更多细节以 --list-themes、--preview 输出与 references/branches.md 为准。
(产品价格、收费方式、平台支持范围等信息暂未提供。)