核心用法
aws-wechat-article-formatting 是一款面向微信公众号编辑场景的纯本地排版工具，核心功能是将 Markdown 文稿转换为可直接粘贴至微信后台的 HTML 代码。用户通过触发词（如「排版」「美化」「转 HTML」等）唤起技能后，执行 Python 脚本 format.py 完成转换，全程无需网络连接或任何 API 凭证。
工作流程
1. 配置检查：首次使用需按文档完成环境检测（Python3 依赖）
2. 主题确定：通过命令行 --theme 参数、article.yaml 配置或智能体对话选择主题
3. 转换执行：python scripts/format.py article.md -o article.html
4. 输出 HTML：生成 inline 样式、微信兼容的 HTML 文件
功能特性
- 4 种内置主题：default（经典蓝）、grace（优雅紫）、modern（暖橙）、simple（极简黑），覆盖科技、文化、自媒体、学术等场景
- 自定义扩展：支持
--color、--font-size参数微调，或创建.aws-article/presets/formatting/<名>.yaml完全自定义主题 - 嵌入元素支持：解析
{embed:...}占位符，支持公众号名片、小程序、往期文章链接 - 智能处理：自动跳过 Markdown 一级标题（避免与后台标题重复）、提取图注、可选追加
closing.md
显著优点
- 零依赖安全：纯本地执行，无网络请求、无凭证管理，从根本上杜绝数据泄露风险
- 所见即所得：inline CSS 确保微信编辑器 100% 还原预览效果
- 灵活可扩展：主题系统采用 YAML 配置，非技术用户也能快速定制品牌风格
- 套件协同：作为
aws-wechat-article-*9 个 skill 的排版环节，可与写作、审校、配图、发布等环节无缝串联
潜在缺点与局限性
- 功能单一专注：仅解决「排版」环节，如需完整工作流需配合
aws-wechat-article-main使用 - 无实时预览：需生成 HTML 后粘贴至微信后台查看最终效果，本地无可视化界面
- 主题定制门槛：完全自定义主题需理解 YAML 结构与微信 CSS 特性，对纯内容创作者有一定学习成本
- 嵌入配置分散：名片/小程序配置在全局
config.yaml，往期链接在单篇article.yaml，管理稍复杂
适合人群
- 公众号运营者：需高频排版、追求效率与视觉一致性的编辑者
- 独立作者：技术背景内容创作者，偏好 Markdown 写作 workflow
- 排版岗位：企业新媒体团队中负责多账号、多风格切换的专职排版人员
- 技术博客迁移者：已有大量 Markdown 内容，希望快速迁移至公众号平台
常规风险
- 配置遗漏风险：未执行「配置检查」直接运行可能导致脚本失败，建议首次严格按文档操作
- 主题覆盖预期：命令行
--theme优先级最高，可能意外覆盖用户期望的默认配置 - HTML 粘贴兼容性：虽 inline CSS 兼容性佳，但微信后台更新可能导致极少数样式异常，建议发布前预览
- 文件路径依赖：脚本执行需正确指定
{baseDir}和文章路径，目录结构变动时需同步调整命令