企业官网建设流程全解析

给PPT装上AI大脑：SlideSCI AI助手深度解析，从API配置到Agent自动改稿

【免费下载链接】SlideSCIPPT插件，支持素材库、AI助手、一键添加图片标题，复制粘贴位置、一键图片对齐、一键插入Markdown（加粗、超链接等行内样式、代码块、LaTeX等块级样式）、便捷导出图片！项目地址: https://gitcode.com/Achuan-2/SlideSCI

SlideSCI 是一款面向科研与办公场景的 PPT 插件，其AI 助手功能支持接入任意 OpenAI 兼容的 API，让大模型直接操作你当前的幻灯片——改文字颜色、加形状、新建页面、批量替换，全程像聊天一样自然。本文将带你完成API 配置、看懂Agent 自动改稿的完整链路，并解析核心源码位置。

一、AI 助手能帮你做什么？

打开 PPT 后，在 SlideSCI 选项卡的「AI 助手」按钮（入口定义见 Ribbon1.Designer.cs，点击逻辑见 Ribbon1.cs）即可唤出聊天侧边栏，面板的创建与切换逻辑在 ThisAddIn.cs。

它内置四类常用指令，开箱即用：

• 🎨 把选中的文字或文本框改为指定颜色
• 📐 添加矩形、圆角矩形、圆形等形状
• 📄 新增一页空白幻灯片
• 🔁 幻灯片内文字查找替换

二、AI助手API配置：三步接入任意大模型

点击侧边栏的 ⚙️ 按钮打开「AI 助手设置」，只需填4 个字段：

几个贴心设计：

• 预设管理：内置 APIMart、Kimi、DeepSeek、OpenAI 四套预设，可新增/删除，一键切换，不用反复粘贴配置（预设逻辑见 AISidebarControl.cs）。
• 本地持久化：配置自动保存到%APPDATA%\SlideSCI\ai_config.json，重启 PPT 不丢失，路径初始化见 AISidebarControl.cs。
• 恢复默认提示词：改坏了提示词？点一下「恢复默认提示词」即可还原。

💡 提示：发送消息前若未配置 API Key，插件会自动弹窗并帮你打开设置面板（见 AISidebarControl.cs），不会让你在聊天框里干等报错。

三、Agent 自动改稿：它为什么能"动手"而不只是"动口"？

普通 AI 只能回文字，SlideSCI 的 AI 助手是一个真正的Agent：它通过工具调用（Function Calling）编写并执行代码来直接操作 PPT。整个链路在 AISidebarControl.cs 的RunAgentLoopAsync中实现：

1. 下发工具定义：向模型声明一个execute_csharp_code工具——"把 C# 代码放进Run(PowerPoint.Application)方法体中执行"。
2. 模型生成代码：你输入"把标题改成深蓝色"，模型返回一段可操作的 C# 代码。
3. 本地即时编译执行：CSharpExecutor.cs 在内存中编译这段代码，动态引用 PowerPoint Interop 程序集后调用Run方法，直接作用于当前演示文稿。
4. 结果回填对话：执行成功/失败的报错信息作为tool消息回传给模型，让它自行修正——这就是"自动改稿"的闭环。

两个关键机制值得注意：

• 循环上限 5 次：Agent 最多迭代 5 轮（maxIterations = 5），防止模型无限自我纠错刷爆 API 额度。
• 随时可停止：生成过程中「发送」按钮会变成红色的「停止」，点击即取消请求（见 AISidebarControl.cs），长任务不焦虑。

四、系统提示词定制：给 AI 一个"设计审美大脑"

默认的系统提示词已经内置了一套相当完整的PPT 设计规范，这也是 AI 改稿效果专业的秘密：

• 🎯60-30-10 配色黄金比例：禁止刺眼纯红纯蓝，给出极简科技蓝、商务炭黑、人文学术三套主题色板
• 📏字号梯度：大标题 36-44pt、卡片标题 20-24pt、正文 14-18pt，自动开启自动换行
• 🧮动态网格定位：禁止写死坐标，要求按幻灯片实际尺寸做百分比计算，保证不同比例 PPT 不错版
• 🃏卡片化排版：浅色无轮廓容器 + 留白 30%-40%，拒绝文字堆砌

如果你只想让 AI 做"严谨的文字替换员"而非"设计师"，可以直接精简这段提示词；反之也可以加入自己的排版规范，让每次改稿都符合团队模板。

五、上手小建议

1. 先挑一个内置预设填 Key 试水，再按需新建自己的预设
2. 指令越具体越好：「把第 3 页标题改成 36pt 深蓝色粗体」比「改好看点」命中率高得多
3. 执行结果在气泡里全程可见——AI 请求执行的代码和报错都会展示，出问题一眼定位
4. 该功能自 v1.7 版本加入（2026.06.05），详见 CHANGELOG.md，请确保插件版本足够新

六、AI 功能核心源码导航

想深入二次开发，重点看这几个文件：

• 聊天界面、Agent 主循环、设置面板：SlideSCI/components/AISidebarControl.cs
• 动态编译执行 C# 代码：SlideSCI/components/CSharpExecutor.cs
• 侧边栏任务面板挂载：SlideSCI/ThisAddIn.cs
• 按钮入口定义：SlideSCI/Ribbon1.cs

从 API 配置到 Agent 执行闭环，SlideSCI 让 PPT 第一次拥有了"听得懂人话、还会自己动手"的 AI 大脑。填好 Key，开始让大模型替你改稿吧！✨

【免费下载链接】SlideSCIPPT插件，支持素材库、AI助手、一键添加图片标题，复制粘贴位置、一键图片对齐、一键插入Markdown（加粗、超链接等行内样式、代码块、LaTeX等块级样式）、便捷导出图片！项目地址: https://gitcode.com/Achuan-2/SlideSCI