核心用法
aws-wechat-article-formatting 是一款专为微信公众号内容创作者设计的本地排版工具，解决 Markdown 文稿无法直接粘贴到微信编辑器的痛点。用户只需执行一行 Python 命令，即可将 Markdown 转换为微信后台兼容的 inline-style HTML，实现「写完即排、排完即贴」的高效工作流。
典型使用场景：
- 独立作者撰写技术/商业/文化类长文后快速美化
- 排版岗位批量处理多篇文章，切换品牌视觉风格
- 自媒体团队建立统一的排版规范与主题资产
操作入口：
python scripts/format.py article.md --theme grace -o article.html
支持 4 套内置主题（default 经典蓝、grace 优雅紫、modern 暖橙、simple 极简黑），覆盖科技、美学、创业、学术等多元场景；同时开放自定义主题目录 ~/.aws-article/presets/formatting/，允许团队沉淀品牌资产。
显著优点
1. 零依赖纯本地：无需网络、无需 API Key、无需微信登录，敏感内容不上云
2. 微信原生兼容：所有样式 inline 化，复制粘贴后零走样；自动跳过 h1 标题避免与后台标题重复
3. 灵活可配置：主题、主色、字号均可命令行覆盖，支持 article.yaml 级联配置
4. 模块化设计：作为 9 件套工作流的一环，可独立运行也可无缝接入「写作-审稿-排版-配图-发布」全流程
潜在缺点与局限性
- 功能边界清晰：仅负责「排版」单一环节，如需配图插入、原创检测、多平台分发需调用同套件其他 skill
- 主题定制需技术门槛：自定义 YAML 主题需理解样式结构与微信 CSS 限制
- Windows 兼容性未明示：脚本依赖
python3，Windows 用户需自行配置环境 - 无实时预览：需生成 HTML 后手动粘贴到微信后台查看效果，无法「边改边看」
适合人群
- 高频产出公众号长文的独立作者与专栏作家
- 负责多账号矩阵运营的内容编辑与排版专员
- 追求品牌视觉一致性的自媒体团队与MCN 机构
- 对数据安全敏感、拒绝 SaaS 订阅的隐私优先型用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 主题配置错误 | 自定义 YAML 语法错误导致转换失败 | 内置主题兜底，命令行 `--list-themes` 可验证 |
| 路径依赖混淆 | 跨 skill 引用时 `baseDir` 解析错误 | 严格遵循「仓库根执行」规范，使用绝对路径 |
| 微信编辑器更新 | 微信后台 HTML 解析规则变化导致样式失效 | 关注套件更新，内置主题随官方适配迭代 |
| 本地环境污染 | `~/.aws-article/presets/` 被意外修改 | 版本控制备份，自定义主题纳入 Git 管理 |
---
套件定位：本 skill 是 aws-wechat-article-* 公众号工作流的「排版引擎」，建议与 aws-wechat-article-main（入口 orchestrator）配套使用，亦可独立部署满足轻量排版需求。