QQ 群 538642822 进入控制台
文档/技术分享/ManuWeave 怎么用?让 AI 帮你排论文和公文格式:安装、调用与 286 套模板

ManuWeave 怎么用?让 AI 帮你排论文和公文格式:安装、调用与 286 套模板

投稿前最耗时间的往往不是写,而是改格式:这家期刊要两栏、那家要单栏,参考文献样式不一样,图表标题位置也不一样。写公文更是细节多,红头、层级、附件分页、页码,错一处就得返工。

让 AI 直接改 Word 又让人不放心:公式变成图片、表格错位、图表丢失,改完还不知道哪里动过。ManuWeave 想解决的就是这件事:把「排版」做成一个 Skill,让 Agent 调用本地工具去改文档里的原生对象,改完逐项检查,并留下报告。

ManuWeave 的作用:把格式杂乱的稿件整理成符合模板的版面
ManuWeave 的作用:把格式杂乱的稿件整理成符合模板的版面
关于本文

这是一篇好物分享:ManuWeave 由开源作者 jiassia 创作(MIT 协议),鹊桥只是把它整理、收集过来,写成一份中文上手指南,并非鹊桥自己的作品。我们在 Windows 上亲手装过、跑过一遍,觉得对经常要排论文、公文格式的人确实省事,所以推荐给大家。项目的版权、更新和问题反馈都以原作者的 GitHub 主页为准,文中涉及的期刊与公文格式规则,也请以项目文档和官方要求为准。

它解决哪些痛点#

常见痛点ManuWeave 的做法
每个期刊、出版方格式都不一样,手工调样式反复返工内置 286 套模板,按 Profile ID 套用;每套规则带官方来源链接、版本和定位信息
AI 直接改 Word,容易丢公式、图表、脚注、引用直接改原生对象,保留公式、图片、合并单元格、脚注、域和引用;不会把全文转成 Markdown 再重建
AI 说「排好了」,其实没人检查内容保持、样式、字体、实际分页分别检查;没做的检查会标成 UNVERIFIED,不会默认通过
担心 AI 顺手改内容、编内容默认只排版;补全实质内容需要你授权并有原文依据;公文的机关、文号、签发人、日期只用原稿或你确认的信息,不生成印章
公文格式细节多(GB/T 9704—2012)有独立的 official 命令流程,处理标题、层级、署名日期、附件分页、版头红线、末页版记和奇偶页码
不想再配一套 AI 接口排版工具在本地运行,不需要额外配置 AI API

功能一览#

ManuWeave 一次排版的流程:给出原稿、识别结构、生成方案、应用格式、渲染检查、确认交付
ManuWeave 一次排版的流程:给出原稿、识别结构、生成方案、应用格式、渲染检查、确认交付
功能说明
学术稿件排版支持 Word 原稿和原生 LaTeX 工程,整理标题、摘要、正文、公式、图表和参考文献
按参考文档排版给一份参考 Word,学习它的实际版式(learn-style),再套到你的稿件上
内置期刊与出版方模板共 286 项,见下表
缺失结构检查找出缺目录、图表缺标题等问题;能安全自动补的自动补,需要内容依据的先列出来
公文排版中文公文 DOCX,支持正文整理和单一机关完整通用格式
渲染检查与验收调用本机 Word、LibreOffice 或 TeX 渲染,检查实际页面,再确认交付
内容补全结构可自动补;实质文字必须有授权和原文依据,并保留草稿来源

内置模板构成(共 286 项)

类别数量例子
期刊模板16计算机应用研究、食品科学、统计与决策、Nature Communications、PLOS ONE
出版方模板57ACM、Elsevier、IEEE、Oxford University Press、AIP、APS、Springer
ACM 期刊41ACM Transactions 系列等
IEEE 期刊52IEEE Transactions 系列、IEEE Internet of Things Journal 等
中文期刊10中文核心类期刊
Elsevier / Wiley5 / 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 可靠。

用得放心的几条建议#

  1. 先备份,再让它输出到新目录。 不要让任何工具覆盖唯一的原稿。
  2. 先看角色识别(roles.json)。 作者、单位、中英文摘要这几块最容易判错。
  3. 只授权排版,不授权补内容。 想让它补摘要、补引言,要明确说,并提供依据;公文的机关名称、文号、签发人和日期必须来自原稿或你的确认。
  4. 逐页看渲染结果。 文件生成、测试通过都不等于版面没问题;没有渲染器时,页面检查不会算通过。
  5. 投稿前再核对一次期刊官网。 内置规则来自官方模板,但期刊要求会更新,最终以投稿系统和官网说明为准。

常见问题#

必须装 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 对话部分按你选用的模型计费。

参考资料#

相关阅读:Codex Skills 怎么用?安装、启用、创建自己的技能

鹊桥 AI 使用文档 · 管理员联系 2557237738 · QQ 群 538642822
官方域名:5202828.xyz / cdn.5202828.xyz / queqiaoai.top。请勿使用 api.queqiaoai.cc 等仿冒站点登录或充值。
鹊桥 AI 官方域名核验 · 5202828.xyz · 订阅