article-writer-cn

# 微信格式化配置器 ## 📋 命令说明 `/format-config` 命令提供交互式界面,用于定制微信公众号 Markdown 格式化样式。 ### 命令用法 ```bash /format-config # 交互式配置样式 /format-config --reset # 重置为默认配置 /format-config --save-preset # 保存当前配置为预设 /format-config --load-preset # 加载已保存的预设 /format-config --help # 显示帮助信息 ``` 高级用户可以通过这个命令精细调整: - 主题(经典/优雅/简洁) - 主题色(11种预设或自定义) - 字号(14px-18px) - 字体(无衬线/衬线/等宽) - 各种开关选项 - 配置预设管理 ## 🎯 适用场景 ### 何时使用 - 需要频繁切换不同样式风格 - 想要可视化查看所有配置选项 - 不熟悉 JSON 配置文件格式 - 需要快速预览不同主题效果 ### 替代方案如果你只想**简单调整样式**,也可以: 1. **通过 AI 对话调整**(推荐) ``` "我想换成 grace 主题,主题色改为翡翠绿" ``` AI 会自动更新 `.content/config.json` 2. **直接编辑配置文件** ```bash vim .content/config.json ``` 修改 `formatting` 部分 ## 🚀 使用流程 ### 1. 启动配置器 ```bash /format-config ``` ### 2. 查看当前配置配置器会首先显示当前配置: ``` 📋 当前配置: 主题: default 主题色: 经典蓝 (稳重冷静) 字号: 16px 字体: -apple-system... 首行缩进: 否两端对齐: 否代码行号: 否链接转脚注: 是自动预览: 否 ``` ### 3. 交互式选择 **主题选择** ``` ? 选择主题 › ○ 经典 - 经典样式,适合大多数场景 ● 优雅 - 圆角阴影效果,适合设计/生活类文章 ○ 简洁 - 扁平化设计,适合技术/极简风文章 ``` **主题色选择** ``` ? 选择主题色 › ○ 经典蓝 (稳重冷静) ● 翡翠绿 (自然平衡) ○ 活力橘 (热情活力) ○ 柠檬黄 (明亮温暖) ○ 薰衣紫 (优雅神秘) ○ 天空蓝 (清爽自由) ○ 玫瑰金 (奢华现代) ○ 橄榄绿 (沉稳自然) ○ 石墨黑 (内敛极简) ○ 雾烟灰 (柔和低调) ○ 樱花粉 (浪漫甜美) ○ 自定义(输入十六进制) ``` **字号选择** ``` ? 选择字号 › ○ 14px (更小) ○ 15px (稍小) ● 16px (推荐) ○ 17px (稍大) ○ 18px (更大) ``` **字体选择** ``` ? 选择字体 › ● 无衬线 - 适合现代感强的文章 ○ 衬线 - 适合传统、正式的文章 ○ 等宽 - 适合技术类文章 ``` **开关选项** ``` ? 段落首行缩进? › no ? 文本两端对齐? › no ? 代码块显示行号? › no ? 链接转为脚注? › yes ? 自动打开浏览器预览? › no ``` ### 4. 确认并保存 ``` ✨ 新配置预览: 主题: grace 主题色: 翡翠绿 (自然平衡) 字号: 16px 字体: -apple-system... 首行缩进: 否两端对齐: 否代码行号: 否链接转脚注: 是自动预览: 否 ? 确认保存此配置? › yes ✓ 配置已保存到 .content/config.json ✓ 下次运行 /publish 时将使用新配置 ``` ## 📋 配置项说明 ### 主题 (theme) | 选项 | 说明 | 适用场景 | |------|------|----------| | **default**(经典) | 二级标题白字+主题色背景,三级标题左侧竖线 | 大多数文章类型 | | **grace**(优雅) | 圆角边框和阴影效果,优雅的视觉层次 | 设计/生活类文章 | | **simple**(简洁) | 扁平化设计,简洁的边框样式 | 技术/极简风文章 | ### 主题色 (primaryColor) 用于标题、加粗文字、链接等元素的颜色。提供 11 种预设: - 经典蓝 `#0F4C81` - 稳重冷静 - 翡翠绿 `#009874` - 自然平衡 - 活力橘 `#FA5151` - 热情活力 - 柠檬黄 `#FECE00` - 明亮温暖 - 薰衣紫 `#92617E` - 优雅神秘 - 天空蓝 `#55C9EA` - 清爽自由 - 玫瑰金 `#B76E79` - 奢华现代 - 橄榄绿 `#556B2F` - 沉稳自然 - 石墨黑 `#333333` - 内敛极简 - 雾烟灰 `#A9A9A9` - 柔和低调 - 樱花粉 `#FFB7C5` - 浪漫甜美或输入自定义十六进制颜色值(如 `#3f51b5`) ### 字号 (fontSize) 基础字体大小,影响正文和标题的相对大小: - `14px` - 更小 - `15px` - 稍小 - `16px` - 推荐(默认) - `17px` - 稍大 - `18px` - 更大 ### 字体 (fontFamily) - **无衬线** - 现代感强,适合大多数场景 - **衬线** - 传统正式,适合严肃内容 - **等宽** - 代码风格,适合技术文章 ### 开关选项 - **首行缩进** (`isUseIndent`) - 段落首行缩进 2 个字符 - **两端对齐** (`isUseJustify`) - 文本两端对齐 - **代码行号** (`isShowLineNumber`) - 代码块显示行号 - **链接转脚注** (`citeStatus`) - 将外部链接转为文末脚注 - **自动预览** (`autoPreview`) - 格式化后自动打开浏览器 ## 💡 使用技巧 ### 快速切换主题 ```bash # 运行配置器 /format-config # 只修改主题,其他保持默认 # 快速按 Enter 跳过不需要修改的选项 ``` ### 保存和使用配置预设(推荐) **场景**: 经常在技术文章和生活文章间切换 **步骤**: 1. 配置技术文章样式 ```bash /format-config # 选择 simple 主题, 蓝色, 16px等 ``` 2. 保存为预设 ```bash /format-config --save-preset > 为此预设命名: tech ✓ 已保存预设: tech ``` 3. 配置生活文章样式 ```bash /format-config # 选择 grace 主题, 玫瑰金, 16px等 ``` 4. 保存为另一个预设 ```bash /format-config --save-preset > 为此预设命名: life ✓ 已保存预设: life ``` 5. 快速切换 ```bash # 写技术文章时 /format-config --load-preset > 选择: tech # 写生活文章时 /format-config --load-preset > 选择: life ``` ### 手动备份配置(不推荐) 不推荐手动复制文件,请使用上面的预设功能。如果你确实需要手动备份: ```bash # 备份 cp .content/config.json .content/config-tech.json # 恢复 cp .content/config-tech.json .content/config.json ``` ### 预览效果配置完成后,可以立即预览: ```bash # 1. 运行 publish 命令 /publish wechat # 2. 打开生成的 HTML 文件 open workspaces/wechat/articles/项目名/publish/wechat.html ``` ## 🎯 高级功能 ### 重置为默认配置如果配置混乱,可以一键重置: ```bash /format-config --reset 🔄 重置微信格式化配置 ⚠️ 将恢复为默认配置: 主题: default 主题色: 靛蓝色字号: 16px ... ? 确认重置为默认配置? no ``` ### 配置预设管理 #### 保存预设将当前配置保存为预设,方便后续快速切换: ```bash /format-config --save-preset 💾 保存配置预设 📋 当前配置: 主题: grace 主题色: 玫瑰金 (奢华现代) ... ? 为此预设命名(如 tech, life, design): my-preset ✓ 已保存预设: my-preset ✓ 文件位置: .content/config-my-preset.json ``` **预设命名规则**: - 只能包含字母、数字、下划线和连字符 - ✅ 正确: `tech`, `life-style`, `design_2024` - ❌ 错误: `我的预设`, `tech!`, `life style` #### 加载预设从已保存的预设中快速加载配置: ```bash /format-config --load-preset 📂 加载配置预设找到 3 个预设: ? 选择要加载的预设: ○ tech ○ life ○ design ○ 取消 > 选择: tech 预设配置: 主题: simple 主题色: 经典蓝 (稳重冷静) ... ? 确认加载此预设? yes ✓ 已加载预设配置 ✓ 下次运行 /publish 时将使用此配置 ``` #### 预设文件管理预设文件保存在 `.content/` 目录: ```bash .content/ ├── config.json # 当前使用的配置 ├── config-tech.json # "tech" 预设 ├── config-life.json # "life" 预设 └── config-design.json # "design" 预设 ``` 可以手动删除不需要的预设: ```bash rm .content/config-old-preset.json ``` ## 🔧 故障排查 ### 配置器无法启动 **症状**: 运行 `/format-config` 报错"未找到 .content/config.json" **原因**: 不在项目根目录 **解决方案**: ```bash # 切换到项目根目录 cd workspaces/wechat/articles/你的文章名 # 确认 .content/ 目录存在 ls -la .content/ ``` ### 自定义颜色无效 **症状**: 输入颜色后提示"无效的颜色格式" **原因**: 颜色格式不正确 **解决方案**: 使用标准十六进制格式 `#RRGGBB` - ✅ 正确: `#3f51b5` - ❌ 错误: `3f51b5`(缺少 #) - ❌ 错误: `#3f5`(不足 6 位) ### 配置未生效 **症状**: 修改配置后,运行 `/publish` 样式没变 **原因**: 可能修改了错误的配置文件,或缓存问题 **解决方案**: ```bash # 1. 确认配置文件位置 cat .content/config.json | grep formatting # 2. 删除旧的输出文件 rm -rf publish/wechat.html # 3. 重新运行 publish /publish wechat ``` ## 📚 相关文档 - [微信格式化功能文档](../docs/wechat-formatting.md) - [配置文件说明](../docs/wechat-formatting.md#配置说明) - [主题对比](../docs/wechat-formatting.md#主题对比) ## 🎯 下一步配置完成后: 1. 运行 `/publish wechat` 生成格式化的 HTML 2. 在浏览器中预览效果 3. 复制内容粘贴到微信公众号编辑器 4. 发布! **提示**: 这是高级功能,日常使用推荐直接通过 AI 对话调整样式。