在 Word 里改内容不难，改完之后把目录、页码、页眉页脚重新对齐却往往更费事。一份文档只要经历几轮增删、章节顺序调整，或者从别的模板迁移过来，原来的目录条目、页码和页眉里的章节名就很容易跟正文对不上——目录点进去翻错页，页码从某一节开始接不上，页眉还挂着上一版的章节标题。手工逐项核对既耗时又容易漏项，文档越长越难保证一致。

对比传统SDK API处理

本文介绍如何使用 Spire.Agent.Office Word AI 能力完成文档结构重建，覆盖从目录到页码、页眉页脚的两类典型问题：先让 AI 扫描标题层级与分节信息、按正文实际标题重新生成目录，再刷新页码并更新页眉页脚中的动态字段，使目录、页码、页眉页脚与正文保持一致。

• 目录结构重建
• 页码与页眉页脚刷新

有关产品安装和 SpireToken 配置，请参考 在 .NET 项目中集成 Spire.Agent.Office。以下示例默认已安装 Spire.Agent.Office 并完成 SpireToken 配置。

目录结构重建

目录对不上，多半是正文改过之后目录没跟着更新，或者原先的目录本就是手工敲的静态文字。结构重建的核心思路是：加载已有文档，让 AI 扫描正文的各级标题、判断层级关系并核对分节位置，按正文实际标题重新生成一份带页码的目录域，让目录条目、层级与正文一一对应，同时只调整标题样式、不动正文内容。

using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Doc;

// 待重建结构的文档
string inputPath = "E:\\Input\\XX项目实施方案.docx";
// 保存路径
string savePath = "E:\\Output\\XX项目实施方案-结构重建.docx";
// SpireToken Key
string key = "**********************";
// 自然语言指令
string instruction =
    "请重建当前文档的目录结构：" +
    "1. 扫描正文标题，识别各级标题的层级关系，统一标题样式（一级标题用标题1，二级标题用标题2，依次类推）；" +
    "2. 检查分节符位置，确保章节划分与标题层级一致；" +
    "3. 删除原有目录，在正文前重新生成目录域，目录包含各级标题并显示对应页码，与正文实际标题、层级完全一致；" +
    "4. 只调整标题样式与目录，正文内容保持原样。" +
    "最终保存输出DOCX格式";

// 调用Word文档处理函数
AIResult result = ExecuteDemoWord(instruction, inputPath, savePath, key, null);

// 执行Word文档AI处理
static AIResult ExecuteDemoWord(string instruction, string inputPath, string savePath, string key, string[] attachmentPaths)
{
    // 创建AIOptions选项配置对象
    AIOptions options = new AIOptions();
    // 设置SpireToken Key
    options.SpireToken = key;

    // 使用Document对象处理Word文档
    using (Document doc = new Document())
    {
        // 加载待重建结构的文档
        if (!string.IsNullOrEmpty(inputPath) && File.Exists(inputPath))
        {
            doc.LoadFromFile(inputPath);
        }
        // 创建AI文档处理器
        AIDocumentProcessor processor = doc.AI(options);

        // 执行AI指令
        return processor.ExecuteInstruction(doc, instruction, savePath, attachmentPaths);
    }
}

重建后的目录

重建后的目录条目、层级与正文标题一一对应。对结构改动较大的文档，直接重生成目录比手工增删目录项更省事，也更不容易漏改。

页码与页眉页脚刷新

目录重建后，页码与页眉页脚也需要跟着对齐。页码错位通常出在分节设置上，页眉里的章节名或总页数显示的是字段的旧值。这一步的核心思路是：让 AI 刷新全文页码并按分节设置起始值与续排方式，同时更新页眉页脚中的动态字段（如章节名、总页数、日期），使这些字段的取值与正文当前内容一致。

using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Doc;

// 待刷新页码的文档（可接上一节重建后的文档）
string inputPath = "E:\\Input\\XX项目实施方案-结构重建.docx";
// 保存路径
string savePath = "E:\\Output\\XX项目实施方案-定稿.docx";
// SpireToken Key
string key = "**********************";
// 自然语言指令
string instruction =
    "请刷新当前文档的页码并更新页眉页脚中的动态字段：" +
    "1. 重新计算并刷新全文页码，正文页码从第1页起连续编号；" +
    "2. 按分节设置页码，封面与目录不编页码，正文单独起页并重新起始；" +
    "3. 更新页眉中的章节名（取值自对应级别标题）与总页数等动态字段，使其与正文当前内容一致；" +
    "4. 页脚页码统一为“第 X 页 共 Y 页”格式。" +
    "只更新上述结构信息，不修改正文内容，最终保存输出DOCX格式";

// 调用Word文档处理函数
AIResult result = ExecuteDemoWord(instruction, inputPath, savePath, key, null);

// 执行Word文档AI处理
static AIResult ExecuteDemoWord(string instruction, string inputPath, string savePath, string key, string[] attachmentPaths)
{
    // 创建AIOptions选项配置对象
    AIOptions options = new AIOptions();
    // 设置SpireToken Key
    options.SpireToken = key;

    // 使用Document对象处理Word文档
    using (Document doc = new Document())
    {
        // 加载待刷新的文档
        if (!string.IsNullOrEmpty(inputPath) && File.Exists(inputPath))
        {
            doc.LoadFromFile(inputPath);
        }
        // 创建AI文档处理器
        AIDocumentProcessor processor = doc.AI(options);

        // 执行AI指令
        return processor.ExecuteInstruction(doc, instruction, savePath, attachmentPaths);
    }
}

刷新页码与页眉页脚后的文档

刷新后，正文页码连续、分节起始正确，页眉中的章节名与总页数同正文保持一致。对成批处理的文档，可用同一套指令统一页码规则与页眉页脚格式，省去逐份打开、逐项核对的时间。

常见问题

重建后目录仍显示旧条目或出现多余项

原因：原文档的目录是静态文字而非目录域，或标题样式不统一，导致识别出的层级出现偏差。

解决：在指令中明确要求“删除原有目录后按正文标题重新生成目录域”，并说明标题的识别依据（按样式名或大纲级别），减少误判。

页码从某一节开始对不上或重复

原因：分节符的页码起始值与续排方式与需求不符，手工设置时容易遗漏某一节。

解决：在指令中逐条写明各节的页码要求，如“封面与目录不编页码、正文从第1页起、各节连续编号”，由 AI 按节统一设置。

页眉里的章节名或总页数没有变化

原因：章节名与总页数多为 STYLEREF、NUMPAGES 等动态字段，未刷新时仍显示缓存值。

解决：要求“更新页眉页脚中所有动态字段的取值”，并说明字段来源，如章节名取自对应级别标题，总页数取全文页数。

结构重建时正文格式被一并改动

原因：未限定操作范围，AI 在统一标题样式时顺带调整了正文的字体与段落格式。

解决：在指令中明确“只调整标题样式与目录、页码、页眉页脚等结构信息，保持正文字体与段落格式不变”。

获取SpireToken Key

• 联系 该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。或访问 https://www.e-iceblue.com/TemLicense.html获得试用/商业 API 密钥

在代码中配置：

AIOptions options = new AIOptions();options.SpireToken = key;