核心用法
fastfish-format 是一款面向内容创作者的多渠道排版工具，专注解决公众号、小红书等平台的格式规范化需求。用户通过 system.run 调用本地 CLI 脚本 ffformat_cli.py，配合 --json 参数执行命令，无需 MCP 协议。
主要能力矩阵：
| 功能 | 命令 | 场景 |
|------|------|------|
| 公众号格式规范化 | `normalize-wechat` | 自动处理标题层级、段落间距、引用格式等微信生态规范 |
| 小红书文案格式化 | `normalize-xhs` | 优化Emoji分布、分段节奏、标签位置等社区风格 |
| Markdown 渲染美化 | `render` | 将 Markdown 转为 HTML，支持30+预设样式 |
| 样式列表查询 | `styles` | 浏览 business、literary、mweb-*、phycat-* 等风格 |
| 配图流程指引 | `workflows` | 输出 baoyu-skills 配图规范（需额外配置图像API） |
执行模式：本地 Python 脚本调用，依赖 fastfish-format 仓库克隆与 pip 安装。支持 release tag 版本固定，推荐在隔离环境中运行。
显著优点
- 平台适配精准：针对微信公众号、小红书的排版规范做了深度优化，非通用转换工具
- 样式生态丰富：30套预设样式覆盖商务、文艺、极简、可爱等多场景，支持热切换
- 本地化执行：通过
system.run直接调用，无网络依赖（除配图API外），响应速度快 - 安全设计：文档明确阻断式安全规则，禁止凭证暴露、限制可执行脚本白名单
- 扩展性强：可选 HTTP API 模式（8900端口），便于集成到自动化工作流
潜在缺点与局限性
- 供应链风险：需从 GitHub clone 并执行 pip install，若仓库被篡改存在代码执行风险
- 安装门槛较高：需用户手动完成 Python 环境、依赖安装、路径配置，非开箱即用
- 配图能力外置：实际生图依赖 baoyu-skills 及图像API（OpenAI/Google/阿里），需额外配置凭证
- 平台覆盖有限：目前仅聚焦公众号+小红书，抖音、B站、知乎等平台未支持
- 无实时预览：CLI 模式无可视化界面，需导出后手动查看效果
适合人群
- 新媒体运营：需要批量处理多平台文案格式的内容团队
- 自媒体创作者：个人博主追求一键美化、减少手动调格式时间
- 技术写作者：习惯 Markdown 写作，需转换为公众号/小红书发布格式的开发者
- 自动化需求者：希望通过 API 集成到 CI/CD 或内容发布管道的技术团队
常规风险
- 供应链攻击：第三方仓库可能被投毒，务必使用 release tag 固定版本、隔离环境运行
- 凭证泄露：配图功能需配置 OPENAI_API_KEY 等，存在误提交到版本库的风险
- 路径依赖：
{baseDir}替换失败时需手动处理绝对路径，增加配置复杂度 - 功能边界：不包含实际发布功能，格式化后仍需手动粘贴到对应平台