1. 为什么出版社的 dotx 模板套到旧稿上总是“半生效”

你手里有一份写好的 docx，出版社或公司品牌部丢过来一个 dotx 模板，要求“按这个格式改一遍”。双击模板确实能生成一个空白新文档，样式栏里也躺着“标题1”“正文”“图注”这些名字，可一旦把它附加到原稿上，问题就来了：有的段落变了，有的没变；标题字体对了，但编号乱了；页眉页脚还是旧的。这不是你操作错了，而是 Word 的样式映射机制在“偷懒”。

核心检索词先摆清楚：dotx 是 Word 的模板文件格式，它本身不存正文，只存样式集、页面设置、页眉页脚、主题字体和颜色。docx 是普通文档，里面既有内容也有样式。所谓“套模板”，本质是把 dotx 里的样式定义覆盖到 docx 的样式表上，再让文档里的段落重新指向这些样式。问题在于，原稿里的段落可能用的是“正文”“普通”“无间隔”这类默认样式，也可能被手动改过字体（直接格式），这些都不会因为附加模板而自动对齐。

我试过最典型的一种情况：原稿标题用的是“标题 1”，模板里也有“标题 1”，但模板的“标题 1”是基于“标题”样式派生的，而原稿的“标题 1”是直接格式。附加模板并勾选“自动更新文档样式”后，Word 只会更新样式定义，不会清除直接格式，所以标题看起来还是老样子。另一个坑是样式名不一致：模板里叫“正文文本”，原稿里叫“正文”，Word 不会自动合并，只会新增一个样式，段落依然挂在旧样式上。

所以正确的思路不是“附加一下就完事”，而是三步：先拆解模板样式与目标文档的映射关系，再执行样式替换与批量处理，最后用对比检查验证标题、正文、页眉页脚是否全部对齐。这套流程手工能做，但文档一多就崩，这时候用 TaoToken 把重复的样式映射和检查逻辑写成可复用的配置，会省掉大量来回。

适合谁看：经常处理投稿排版的研究生、出版社编辑、企业品牌文档岗，以及需要把几十份旧 docx 统一到新 VI 模板的运营同学。下面按可跟做的步骤展开，每一步都有可复制的配置和命令。

2. 用 TaoToken 把样式映射写成可复用配置的前置准备

在动手改文档之前，先把“映射关系”这件事从脑子里搬到文件里。手工套模板最大的问题是不可复现：这次改好了，下次换一批文档又得重新判断哪个段落该用哪个样式。TaoToken 在这里的角色不是替你点 Word 按钮，而是帮你把样式名对照、批量替换规则、检查清单固化成一份可复制的配置，再配合脚本或 Word 的域代码去执行。

先明确要准备的东西。第一，模板文件，假设叫press-template.dotx，放在D:\work\template\下。第二，待处理的 docx 目录，假设是D:\work\manuscripts\，里面有paper-01.docx到paper-20.docx。第三，一份样式映射表，这是核心。你可以先用 Word 打开模板，在“开始”选项卡的样式库里点右下角小箭头，查看每个样式的“修改”对话框，记下样式名和它基于哪个样式。常见映射如下：

这张表就是你的“映射关系”。接下来用 TaoToken 的模型对话能力，把这张表转成一段可执行的 Word 样式替换说明，或者转成 Python 脚本的配置。访问模型对话入口：https://taotoken.net/api 配合 deep link 里的模型对话页面，把映射表贴进去，让它输出一段settings.json风格的配置。比如：

{ "template": "D:/work/template/press-template.dotx", "source_dir": "D:/work/manuscripts", "style_map": { "标题 1": "标题 1", "标题 2": "标题 2", "正文": "正文文本", "题注": "图注" }, "clear_direct_format": true, "sync_header_footer": true }

这段 JSON 不是 Word 直接读的，而是给你自己或脚本用的“单一事实来源”。它的价值在于：下次换模板，只改style_map，不用重新判断。TaoToken 的接入文档在 https://taotoken.net/api 的 doc 路径下，里面有 Base URL、Key、Model ID 三件套的说明。如果你打算用脚本批量跑，建议把 Key 放在环境变量里，不要写进 JSON。

前置准备还包括开启 Word 的“开发工具”选项卡。路径是：文件 → 选项 → 自定义功能区 → 右侧勾选“开发工具”。没有它，后面“文档模板 → 附加”这一步找不到入口。另外，处理前务必复制一份原稿目录，批量操作不可逆，直接格式一旦清除，手工恢复很痛苦。

3. 可复制的 dotx 附加与样式替换配置

这一节给两套可复制方案：一套是纯 Word 手工操作，适合只改几份；一套是脚本批量，适合几十份。两套都基于上一节的映射配置。

先说手工方案，步骤要精确到勾选项。打开一份原稿paper-01.docx，依次点击“开发工具”→“文档模板”→在“模板和加载项”对话框里点“选用”→选择press-template.dotx→勾选“自动更新文档样式”→确定。注意，这里勾选后 Word 会把模板样式定义合并进来，但不会自动把段落挂到新样式上。接下来在“开始”选项卡样式库里找到模板带来的样式，比如“正文文本”，右键“修改”，确认它基于“正文”且字体字号正确。然后全选正文段落，点击“正文文本”样式。标题同理。

如果原稿段落用的是“正文”而模板叫“正文文本”，Word 不会自动替换。这时用“查找和替换”的“格式”功能：Ctrl+H → 查找内容留空 → 更多 → 格式 → 样式 → 选“正文”→ 替换为 → 格式 → 样式 → 选“正文文本”→ 全部替换。这一步能把样式引用批量换掉，但不会清除直接格式。清除直接格式用 Ctrl+A 后按 Ctrl+空格（清除字符格式）和 Ctrl+Q（清除段落格式），注意这会连加粗、斜体一起清掉，所以要在样式替换之后做。

脚本方案用 Python 的python-docx库，它不能直接读 dotx 的样式定义，但可以读模板 docx 的样式。所以先把 dotx 另存为press-template.docx，再用脚本把样式复制过去。核心代码片段：

from docx import Document import os template = Document("D:/work/template/press-template.docx") style_map = {"正文": "正文文本", "题注": "图注"} for fname in os.listdir("D:/work/manuscripts"): if not fname.endswith(".docx"): continue doc = Document(os.path.join("D:/work/manuscripts", fname)) for para in doc.paragraphs: old = para.style.name if old in style_map: para.style = doc.styles[style_map[old]] doc.save(os.path.join("D:/work/manuscripts", fname))

这段代码只处理段落样式，页眉页脚需要单独处理。页眉页脚同步的配置在settings.json里用sync_header_footer: true标记，脚本里通过section.header和section.footer复制模板内容。注意，python-docx对页眉页脚的支持有限，复杂页眉建议手工或用 Word 的“链接到前一节”功能。

如果你用 Cline MCP 或 Codex 这类工具做批量，配置里必须写全三件套：Base URL 用https://taotoken.net/api，Key 从 API Keys 页面拿，Model ID 按文档里列出的填。Cline MCP 的配置文件通常是cline_mcp_settings.json，Codex 的 auth.json 里放 Key。这三件套缺一个，脚本调模型做样式判断时就会报 401。

4. 验证请求与成功结果：标题、正文、页眉页脚对齐检查

改完之后不能靠肉眼扫一遍，要有可复现的检查。最直接的方法是用 Word 的“样式检查器”：在“开始”选项卡点样式库右下角箭头 → 底部“样式检查器”→ 点一个段落，看它“段落样式”和“字符样式”分别是什么。如果段落样式显示“正文文本”，字符样式显示“默认段落字体”，说明没有直接格式残留。如果字符样式里出现“加粗”“字体:宋体”这类，说明还有直接格式，需要再清一次。

批量检查用脚本输出一份对照表。下面这段代码遍历文档，打印每个段落的样式名和是否有直接格式：

from docx import Document doc = Document("D:/work/manuscripts/paper-01.docx") for i, para in enumerate(doc.paragraphs): direct = para.paragraph_format has_direct = any([ direct.first_line_indent, direct.space_before, direct.space_after, direct.line_spacing ]) print(i, para.style.name, "直接格式" if has_direct else "干净", para.text[:20])

成功的结果应该满足：所有标题段落的样式名与模板一致，正文段落统一为“正文文本”，图注为“图注”，且“直接格式”列全部为“干净”。页眉页脚检查用 Word 的“页眉和页脚工具”：双击页眉区域，看是否显示模板里的页眉文字和横线。如果显示的是旧页眉，检查“链接到前一节”是否被勾选，取消勾选后再附加模板。

验证请求这一步，如果你用 TaoToken 的模型对话做样式判断，可以发一条请求让模型对比两份文档的样式列表。请求体里带上 Base URLhttps://taotoken.net/api、Key 和 Model ID，返回的 choices 里会列出差异。常见报错reading choices通常是因为返回体不是标准 OpenAI 格式，检查 Model ID 是否填错。local proxy failed一般是本地网络配置问题，不是 Key 的问题。

实测下来，最稳的验证方式是“三看”：一看样式库是否与模板一致，二看段落样式检查器是否干净，三看页眉页脚是否同步。三看都过，才算对齐。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

批量处理时最容易卡在接入环节，而不是 Word 本身。下面按真实报错对照排查。

401 报错：Key 无效或没带上。检查settings.json或环境变量里的 Key 是否与 API Keys 页面一致。注意 Key 有有效期，重新生成后旧 Key 立即失效。如果用的是 Cline MCP，检查cline_mcp_settings.json里apiKey字段有没有拼错。Codex 的 auth.json 里 Key 字段名是OPENAI_API_KEY，填错也会 401。

local proxy failed：这个报错通常出现在本地脚本调 API 时，系统代理设置干扰了请求。解决方法是把 Base URL 写成完整的https://taotoken.net/api，不要走系统代理。如果你在脚本里用了requests，加proxies={"http": None, "https": None}。注意，这里不涉及任何网络工具，只是让请求直连。

reading choices：返回体解析失败。标准返回是{"choices": [{"message": {"content": "..."}}]}，如果你的代码直接取response["choices"][0]["text"]，就会报这个错。改成取message.content。另外，Model ID 填错也可能返回非标准结构，对照接入文档里的模型列表核对。

OAuth：如果你用 Claude Code 或类似工具接入，OAuth 流程走不通时，检查回调地址是否与文档一致。Claude Code 的接入配置里，Base URL 用https://taotoken.net/api，Key 用 API Keys 页面的，Model ID 按文档填。三件套齐全后，OAuth 一般能过。如果还报错，看是不是把 Base URL 写成了带 UTM 的官网地址，API 地址不带 UTM。

还有一个 Word 侧的坑：附加模板后样式没出现。原因是模板的样式被“限制编辑”保护了。解决：审阅 → 限制编辑 → 停止保护。另一个坑是页眉页脚没同步，原因是文档有多个节，只改了第一节。解决：逐节检查“链接到前一节”，或全选后统一设置。

6. 把样式对齐流程固化下来：从单次改稿到批量复用

单次改稿靠手工能过，但出版社投稿、企业 VI 更新这类场景是反复发生的。把上一节的映射配置和检查脚本存成一个目录，下次换模板只改style_map和模板路径。我的做法是建一个doc-format-kit目录，里面放settings.json、apply_styles.py、check_styles.py和模板文件夹。每次新任务复制一份，改配置，跑脚本，看检查输出。

如果你需要长期做这类批量文档处理，或者想把样式判断交给模型自动完成，可以用 Coding Plan 把脚本和模型调用串起来。入口在 deep link 的 coding-plan 路径下。模型对话适合单次验证样式差异，API Keys 和接入文档适合把流程写进脚本。文档里对 Base URL、Key、Model ID 的说明足够你配好 Cline MCP 或 Codex。

最后给一个实用技巧：处理前用git init把原稿目录纳入版本管理，每次批量操作前 commit 一次。改坏了直接git checkout .回滚，比手工恢复快得多。样式对齐这件事，本质是“映射关系 + 批量执行 + 可复现检查”，把这三样固化成配置，比记住 Word 菜单在哪有用得多。