微信公众号排版器 WeChat Formatter

一个面向中文公众号写作者的本地排版工作台。它把带图片的 .docx 文稿拆成可编辑的结构化内容，再把润色、排版、预览、复制这几步放进同一套界面里，让你能更稳地把 Word 稿件整理成适合微信公众号后台粘贴的 HTML。

适合谁用

这个项目主要面向以下场景：

• 需要把 Word 稿件快速转成公众号排版的编辑、运营、作者
• 希望把“大模型润色”和“人工校对”结合起来的人
• 想保留图片位置、段落顺序、斜体、上标、下标等文稿细节的人

现在能做什么

• 解析 .docx，提取段落、图片、部分公式文本与结构信息
• 保留斜体、粗体、上标、下标等常见内联格式
• 将图片和正文拆开，方便分别处理
• 生成“文本润色提示词”和“排版提示词”
• 支持用户将大模型返回结果粘贴回工作台，再继续校对
• 渲染出公众号风格的 HTML 预览，并一键复制到剪贴板
• 提供标题条、卡片、分隔线、强调块、图注等常见样式

工作流程

1. 上传带图片的 Word 文档
2. 检查右侧提取出的文稿结构与图片素材
3. 输入文本修改需求，生成提示词并发给大模型
4. 粘贴大模型返回的修改结果，人工确认差异
5. 输入排版需求，生成 JSON 提示词并发给大模型
6. 粘贴排版 JSON，检查样式、颜色、分组与预览效果
7. 复制最终 HTML 到公众号后台

界面特点

• 左侧固定流程栏，适合长文连续处理
• 中间聚焦“当前步骤”，减少跳转成本
• 右侧同时保留“文稿结构”和“微信预览”
• 支持在文稿结构中直接微调文本，并自动带入下一步排版
• 支持图片是否加边框、标题颜色、正文颜色、批量统一外观等设置

技术栈

• 前端：Next.js 15、React 19、TypeScript
• 后端：FastAPI、Pydantic 2、python-docx
• 渲染：服务端生成公众号可用的内联 HTML
• 运行方式：本地前后端双进程

本地快速启动

先准备 Python 3.14 和 Node.js。

python3.14 -m venv wechat_formatter_venv
source wechat_formatter_venv/bin/activate
pip install -r backend/requirements.txt

cd frontend
npm install

回到项目根目录后，你可以直接双击：

Launch WeChat Formatter.command

它会自动：

1. 清理旧的前后端会话
2. 重新构建前端
3. 启动 FastAPI 后端
4. 启动 Next.js 前端
5. 自动打开本地页面

默认访问地址：

http://127.0.0.1:3000/

手动启动

终端 1：

source wechat_formatter_venv/bin/activate
uvicorn app.main:app --app-dir backend --reload --port 8000

终端 2：

cd frontend
npm run dev

目录结构

backend/              FastAPI 服务、Word 解析、渲染逻辑
frontend/             Next.js 前端界面
docs/assets/          README 展示素材
Launch WeChat Formatter.command
README.md

当前定位

这是一个本地优先（local-first） 的生产力工具原型，不是“自动替你写完”的黑盒产品。它更强调：

• 用户可控
• 结果可校对
• 样式可调整
• 复制到公众号前可预览

路线图

• 更完整的公式识别与渲染
• 浏览器端 .docx 解析，减少后端依赖
• 更丰富的主题模板与色板
• 更稳定的 GitHub Pages 纯前端版本
• 可选的大模型 API 直连接口

开源说明

当前仓库公开的是排版器本体与本地运行方式，不包含临时公网分享脚本作为主要发布内容。项目更适合作为本地工具、二次开发基础，或内容工作流原型。

致谢

如果你正在做中文内容编辑、公众号运营、课程讲义整理、实验室图文发布，欢迎直接拿它改成更贴合你工作流的版本。