教师和企业培训师长期面对同一类需求把已经打磨过的 Word 讲义或 Excel 数据表翻译成可在讲台上放映的 PPT并附带演讲者备注。手工操作的链路通常是复制 Word 章节标题到每张幻灯片 → 粘贴正文 → 删减冗余 → 套版式 → 写备注 → 调字号配色。整个过程高度重复且依赖人工对齐章节与版面最容易出错的环节是漏写备注和章节顺序错乱——往往直到讲台上才发现忘了一句过渡语。福昕 Office 助手fuxin-office Skill针对 PPT 场景提供了演示助编能力基于 MCP 协议直连本机福昕 Office 客户端可由 Agent 一句话在真实 PPT 文件里完成大纲抽取、每页内容生成、演讲者备注补全与版式套用。整个过程文档不出本机127.0.0.1 回环无需手动操作 PowerPoint。技术原理福昕 Office 助手的演示助编能力由 MCP Serverfuxin-office-mcp提供。该服务以 HTTP 长连接方式监听在本地端口默认 58688接收来自 Agent 的 JSON-RPC 请求执行后返回结构化数据或操作结果。Agent 调用链如下用户自然语言 → Agent 解析意图 → MCP JSON-RPC 请求 → fuxin-office-mcp → 福昕 Office COM 互操作 → 返回结果 → Agent 格式化输出关键技术点MCP 使用 HTTP POST 请求体传输 JSONSSE 模式支持流式响应如已抽取大纲第 12 页备注写入完成便于长任务可见可控端口号由 MCPServerPort.ini 配置文件决定。PPT 生成链路内部又分四步第一步是大纲抽取把 Word 文档按标题 1/标题 2/标题 3识别为三层结构第二步是内容生成Skill 按目标页数切分正文要点并对每页附图表建议柱状、折线、饼图视数据特征而定第三步是备注补全调用大模型基于原文段落生成演讲者备注包含讲解要点、案例提示与过渡句第四步是版式套用按 template_id 加载模板文件统一全册配色、字号、页眉页脚。代码与配置示例MCP 配置以 WorkBuddy 为例在 WorkBuddy 连接器后台「自定义连接器 → 配置MCP」中粘贴以下 JSON保存并启用开关{mcpServers: {fuxin-office-mcp: {url: http://127.0.0.1:58688/mcp,type: http}}}若连接失败先检查福昕 Office 客户端是否在运行再确认端口是否匹配见排障节。Agent 指令示例基于讲义生成 PPT用户向 Agent 说「帮我把这份培训讲义生成 12 页汇报 PPT每页附演讲者备注套公司内训配色。」Agent 发送给 Skill 的请求结构简化版 JSON{jsonrpc: 2.0,method: ppt_generate_from_doc,params: {source_file: C:\\Train\\Q4培训讲义.docx,outline_style: Heading1-3,target_pages: 12,include_speaker_notes: true,speaker_notes_tone: 口语化,template_id: 公司内训版式,output_file: C:\\Train\\Q4培训汇报.pptx}}Skill 端依次完成四件事按 Word 标题样式抽取大纲 → 按目标页数切分正文要点并生成每页内容 → 为每页写入演讲者备注 → 套用指定版式并落盘到 output_file。引用 Excel 数据生成图表如果要在生成的 PPT 中嵌入真实图表柱状/折线/饼图可附加 chart_source{method: ppt_generate_from_doc,params: {source_file: C:\\Train\\Q4培训讲义.docx,target_pages: 12,chart_source: {file: C:\\Train\\销售明细.xlsx,sheet: Sheet1,columns: [月份, 销售额],chart_type: line},include_speaker_notes: true}}端口不一致排障若 MCP 连接报错首先检查端口配置type C:\ProgramData\Foxit Software\Fuxin Office\MCP\MCPServerPort.ini输出示例[Server]ListenPort58689若端口为 58689将 MCP 配置中的 URL 从 58688 改为 58689重新保存并启用连接器。# 确认端口监听状态PowerShellnetstat -ano | Select-String 58688|58689踩坑与排障坑 1Word 章节样式未正确应用。 Skill 默认按标题 1/标题 2/标题 3样式抽取大纲若讲义里章节标题用的是手动加粗或自定义段落大纲识别会失败。建议在源文档里先选中所有章节标题应用 Word 的标题 1/标题 2样式再下达指令。坑 2目标页数与大纲深度不匹配。 若讲义里只有 6 个一级标题但你要求生成 20 页Skill 会自动拆分二级标题填空仍能成稿但若讲义只有 3 个一级标题却要求 12 页每页正文会被过度稀释。建议让目标页数与大纲深度基本一致否则追加每页不要超过 6 行要点。坑 3演讲者备注风格不对。 默认备注偏书面表达可追加 speaker_notes_tone 参数口语化讲稿式逐字稿调整。也可以事后再追加指令把所有备注改成口语化讲稿每段不超过两句Skill 会全量重写备注。坑 4版式 ID 名称不匹配。 template_id 字段如果传了不存在的版式名Skill 会回退到默认版式并提示版式未匹配已使用默认。建议先调用 ppt_list_templates 接口列出所有可用版式再传值。坑 5图表部分已自动生成但位置错。 数据列引入了 Excel 中文件名或列名时必须与表头一字不差含空格与全角半角。建议先用 excel_list_sheets 和 excel_read_headers 接口确认列名再传 chart_source.columns。本文演示了如何通过福昕 Office 助手 Skill 用一条自然语言指令完成讲义到汇报 PPT 的全流程生成。核心价值在于将传统需要手动复制大纲→铺页→写备注→套版式的多步操作压缩为一次 Agent 对话整个 PPT 生成过程在本地完成不上传云端满足企业培训资料的合规要求。安装与配置版本要求Windows 系统、福昕 Office 客户端 11.0.10620.36863 及以上、操作时保持客户端运行。安装指令推荐在 Agent 对话框输入请根据 https://skillhub.cn/install/skillhub.md安装 org-sd52yaru/fuxin-office。也可以在腾讯 Skillhub、WorkBuddy、Clawhub、GitHub 搜福昕 Office 助手或官网产品详情页福昕 Office Skill面板安装找客服拿 fuxin-office.zip 离线包不解压拖入对话框输入帮我安装福昕 Office 助手 Skill。MCP 连接器配置以 WorkBuddy 为例{mcpServers: {fuxin-office-mcp: {url: http://127.0.0.1:58688/mcp,type: http}}}端口不一致排错用记事本打开 C:\ProgramData\Foxit Software\Fuxin Office\MCP\MCPServerPort.ini查看 ListenPort 实际值如 58689把 url 端口替换后重新启用连接器。值得特别注意的是MCP 协议的 HTTP 长连接设计在长任务场景下有独特的稳定性优势。生成 30 页以上 PPT 时SSE 流持续把已生成 N/30 页第 12 页备注写入完成等进度事件回推给 Agent避免无响应黑盒也方便培训负责人实时调整页数或备注口吻。