ManuWeave 怎么用?让 AI 帮你排论文和公文格式:安装、调用与 286 套模板
投稿前最耗时间的往往不是写,而是改格式:这家期刊要两栏、那家要单栏,参考文献样式不一样,图表标题位置也不一样。写公文更是细节多,红头、层级、附件分页、页码,错一处就得返工。
让 AI 直接改 Word 又让人不放心:公式变成图片、表格错位、图表丢失,改完还不知道哪里动过。ManuWeave 想解决的就是这件事:把「排版」做成一个 Skill,让 Agent 调用本地工具去改文档里的原生对象,改完逐项检查,并留下报告。

这是一篇好物分享:ManuWeave 由开源作者 jiassia 创作(MIT 协议),鹊桥只是把它整理、收集过来,写成一份中文上手指南,并非鹊桥自己的作品。我们在 Windows 上亲手装过、跑过一遍,觉得对经常要排论文、公文格式的人确实省事,所以推荐给大家。项目的版权、更新和问题反馈都以原作者的 GitHub 主页为准,文中涉及的期刊与公文格式规则,也请以项目文档和官方要求为准。
它解决哪些痛点#
| 常见痛点 | ManuWeave 的做法 |
|---|---|
| 每个期刊、出版方格式都不一样,手工调样式反复返工 | 内置 286 套模板,按 Profile ID 套用;每套规则带官方来源链接、版本和定位信息 |
| AI 直接改 Word,容易丢公式、图表、脚注、引用 | 直接改原生对象,保留公式、图片、合并单元格、脚注、域和引用;不会把全文转成 Markdown 再重建 |
| AI 说「排好了」,其实没人检查 | 内容保持、样式、字体、实际分页分别检查;没做的检查会标成 UNVERIFIED,不会默认通过 |
| 担心 AI 顺手改内容、编内容 | 默认只排版;补全实质内容需要你授权并有原文依据;公文的机关、文号、签发人、日期只用原稿或你确认的信息,不生成印章 |
| 公文格式细节多(GB/T 9704—2012) | 有独立的 official 命令流程,处理标题、层级、署名日期、附件分页、版头红线、末页版记和奇偶页码 |
| 不想再配一套 AI 接口 | 排版工具在本地运行,不需要额外配置 AI API |
功能一览#
| 功能 | 说明 |
|---|---|
| 学术稿件排版 | 支持 Word 原稿和原生 LaTeX 工程,整理标题、摘要、正文、公式、图表和参考文献 |
| 按参考文档排版 | 给一份参考 Word,学习它的实际版式(learn-style),再套到你的稿件上 |
| 内置期刊与出版方模板 | 共 286 项,见下表 |
| 缺失结构检查 | 找出缺目录、图表缺标题等问题;能安全自动补的自动补,需要内容依据的先列出来 |
| 公文排版 | 中文公文 DOCX,支持正文整理和单一机关完整通用格式 |
| 渲染检查与验收 | 调用本机 Word、LibreOffice 或 TeX 渲染,检查实际页面,再确认交付 |
| 内容补全 | 结构可自动补;实质文字必须有授权和原文依据,并保留草稿来源 |
内置模板构成(共 286 项)
| 类别 | 数量 | 例子 |
|---|---|---|
| 期刊模板 | 16 | 计算机应用研究、食品科学、统计与决策、Nature Communications、PLOS ONE |
| 出版方模板 | 57 | ACM、Elsevier、IEEE、Oxford University Press、AIP、APS、Springer |
| ACM 期刊 | 41 | ACM Transactions 系列等 |
| IEEE 期刊 | 52 | IEEE Transactions 系列、IEEE Internet of Things Journal 等 |
| 中文期刊 | 10 | 中文核心类期刊 |
| Elsevier / Wiley | 5 / 16 | 各刊投稿模板 |
| 更多期刊 | 80 | 其他期刊 |
| 通用模板 | 9 | 不指定期刊时使用 |
完整的 Profile ID 清单在项目的 README_ZH.md。比如「计算机应用研究」对应 cn-aroc-official-word,「PLOS ONE」对应 int-plos-one-research-word。
怎么安装#
先说前提:需要 Python 3.11 及以上;渲染检查要用到本机已有的 Word、LibreOffice 或 TeX。工具不会自动帮你安装字体或系统软件。
方式一:让 Agent 帮你装(推荐)#
把下面这段提示词粘给 Codex、Claude Code 等支持 Skill 的 Agent,它会下载项目、创建独立虚拟环境、安装依赖并运行自检:
安装并使用 https://github.com/jiassia/manuweave 的 ManuWeave,采用 main 分支。
先识别当前宿主的个人 Skill 目录,例如 ~/.codex/skills/manuweave
或 ~/.claude/skills/manuweave。通过 Git clone 或下载 ZIP 安装到新目录。
如已安装,先检查并复用,保留本地修改,不直接覆盖。
读取 SKILL.md,只按任务需要加载 static 片段。
使用 Python 3.11 及以上版本,为本 Skill 创建独立 .venv,
通过该环境的 Python 安装 requirements.txt,
再用同一环境运行 scripts/manuweave.py doctor。
使用本机已有的 Word、LibreOffice 和 TeX,不自动安装字体或系统工具。
无须额外配置 AI API。
准备完成后,提示提供原稿,以及参考模板、目标期刊或公文格式要求。
方式二:手动安装#
Windows(PowerShell):
git clone https://github.com/jiassia/manuweave.git $HOME\.codex\skills\manuweave
cd $HOME\.codex\skills\manuweave
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe scripts/manuweave.py doctor
macOS / Linux:
git clone https://github.com/jiassia/manuweave.git ~/.codex/skills/manuweave
cd ~/.codex/skills/manuweave
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python scripts/manuweave.py doctor
用 Claude Code 时,把目录换成 ~/.claude/skills/manuweave。必须复制整个项目文件夹,不能只拿一个 SKILL.md,否则它引用的脚本和模板会找不到。装好后新开一轮对话,或刷新技能列表。
在一个路径里带中文字符的目录下执行 python -m venv,我们的机器上报 ensurepip ... exit status 106,换成纯英文路径后正常。如果你的 Windows 用户名或目录有中文,可以把虚拟环境建在英文路径(例如 C:\mw-venv),之后用那个环境的 Python 去运行 scripts/manuweave.py;脚本本身放在中文路径下我们验证过可以运行。
自检结果怎么看#
doctor 会输出 Python 版本、依赖是否齐全,以及本机有哪些渲染器(Word、LibreOffice、latexmk、xelatex 等)。依赖全部为 true 就能排版;渲染器缺失不影响排版,但页面检查会标成未验证。装好前先看清楚这一项,免得以为「全部通过」。
工具默认保留原稿、把结果写到新的输出目录,但第一次用,还是先拿一份副本和一份不重要的稿件跑一遍。
怎么调用#
在 Agent 里用自然语言调用#
装好后,直接点名这个 Skill,再说清楚三件事:原稿是哪份、按什么格式、要交付什么。不同客户端的点名符号可能是 $ 或 @,以输入框弹出的列表为准。
按参考文档排版
使用 ManuWeave,按 B.docx 的版式整理 A.docx,保留公式和图表,
检查缺失结构,交付可编辑文档和检查报告。
按指定期刊模板排版
使用 ManuWeave,把 draft.docx 按 cn-aroc-official-word 模板整理,
输出到新目录,不要改原稿,不要补写任何实质内容。
公文排版
使用 ManuWeave,将通知原稿按党政机关公文通用格式排版,
沿用原稿中的机关、文号和日期,保留表格与图片,
交付可编辑 Word、核对 PDF 和检查报告。
信息清楚时,Agent 会连续执行;缺少必要字段,或某段文字的角色有歧义时,它会集中向你确认。
直接用命令行#
Agent 背后调用的就是项目里的命令行,你也可以手动跑,便于复查。最小的一条(Windows,用上面装好的虚拟环境):
.\.venv\Scripts\python.exe scripts/manuweave.py run draft.docx --preset cn-aroc-official-word --output out-aroc
常用子命令:
| 命令 | 作用 |
|---|---|
doctor | 检查 Python、依赖和本机渲染器 |
presets | 查看、导出或验证内置模板 |
inspect | 识别稿件里的标题、摘要、公式、图表等结构 |
plan / apply | 先生成格式方案,再应用;角色识别有误时,可用 plan --roles 带上修正后的角色表 |
run | 一步完成识别、方案和应用 |
audit / render | 检查结果、渲染页面 |
accept | 逐页看过之后确认验收 |
official | 公文专用命令族:official inspect、official run、official accept |
公文最小示例(official.json 里写 {"scope":"body","direction":"down","mode":"standard"}):
.\.venv\Scripts\python.exe scripts/manuweave.py official inspect draft.docx --request official.json
.\.venv\Scripts\python.exe scripts/manuweave.py official run draft.docx --request official.json --output official-result --renderer word
完整字段、单位模板和验收流程见项目的 公文使用说明。

我们实测了什么#
为了确认不是纸上谈兵,我们造了一份很小的中文稿(标题、作者行、摘要、关键词、两个章节、一张表、一条参考文献),用 cn-aroc-official-word(计算机应用研究)模板跑了一次 run。看到的真实结果:
- 输出齐全:生成了
editable.docx(可编辑结果)、audit.json(检查报告)、missing.json(缺失项)、roles.json(角色识别)、plan.json、state.json等文件。 - 内容和样式检查通过:
content与style都是PASS;表格数量改前改后都是 1,没有丢对象。标题的字体、字号、对齐都和模板规则逐项比对,并附上了官方模板的来源链接和定位。 - 缺失项判断合理:它提示「有标题但没有目录」(可自动插入原生目录域)和「表格可能缺标题」(需要人工确认,不会自己编)。
- 角色识别不是 100% 准:我们的作者行(「张三 李四」)被识别成了正文。这正是项目文档里强调「自动角色只是建议,作者、单位、双语块要人工核对」的原因;识别不对时,用
plan --roles修正后再apply。 - 页面渲染这一步失败了:本机 Word 导出 PDF 时报了 COM 错误,工具把状态标成
FAIL、视觉检查UNVERIFIED,没有假装通过。这是我们电脑上的环境问题,不是工具的缺陷;但它也说明,拿到结果后一定要看audit.json的状态,而不是只看文件有没有生成。
把 missing.json 和 audit.json 当成「待办清单」:前者告诉你稿件还缺什么,后者告诉你哪些检查真的做过、哪些没做。交稿前这两份都清零,比肉眼翻一遍 Word 可靠。
用得放心的几条建议#
- 先备份,再让它输出到新目录。 不要让任何工具覆盖唯一的原稿。
- 先看角色识别(
roles.json)。 作者、单位、中英文摘要这几块最容易判错。 - 只授权排版,不授权补内容。 想让它补摘要、补引言,要明确说,并提供依据;公文的机关名称、文号、签发人和日期必须来自原稿或你的确认。
- 逐页看渲染结果。 文件生成、测试通过都不等于版面没问题;没有渲染器时,页面检查不会算通过。
- 投稿前再核对一次期刊官网。 内置规则来自官方模板,但期刊要求会更新,最终以投稿系统和官网说明为准。
常见问题#
必须装 Word 吗?#
排版本身不依赖 Word,但渲染检查需要本机有 Word、LibreOffice(Word 稿件)或 TeX 工具链(LaTeX 工程)。没有就只能得到「未验证」的页面状态。
会不会把我的稿件发给别人?#
排版工具在本地运行,不另外调用 AI 接口。但 Agent 本身要读取稿件内容来识别角色、判断歧义,这部分会发给你正在使用的模型服务。涉密或未公开的稿件,请按你所用模型服务的数据政策决定能不能用。
支持哪些 Agent?#
项目说明适用于 Codex、Claude Code 等支持 Skill 的宿主。把项目放进对应的个人 Skill 目录即可,具体目录以客户端为准。
公文所有格式都能排吗?#
目前支持中文公文 DOCX 的正文整理和单一机关完整通用格式。复杂的联合行文、信函、命令、纪要等特定格式,项目文档说明需要另行补充规则。
和我们站上的其他 Skill 文章是什么关系?#
通用的 Skill 概念、目录结构和安装方式见 Codex Skills 怎么用。如果你想用鹊桥的 Key 驱动 Codex 或 Claude Code 来跑这个 Skill,可以先看 CC Switch 一键配置 Claude Code 和 Codex 和 Codex config.toml 怎么配置。Skill 的排版部分在本地完成,Agent 对话部分按你选用的模型计费。