封面图加载中

Trae IDE入门教程

本文详细介绍了在 Trae 中配置 MCP 服务、安装 PPT-Master Skill 并使用 AI 模型自动生成 PPT 的完整流程，包括环境搭建、需求拆解、新闻搜索与内容审核，最终通过审查驱动的工作流产出可编辑的 PPTX 文件。
  • 本文作者
  • 文章发布日期 2026-04-25 01:30
  • 热度 4
  • 天气 雾 16°
  • 作者心情 有点愉快
  • 地点 奥林匹克森林公园
  • 本文共计
  • 预计阅读

前置

安装uv

官方脚本

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

右键开始图标，运行：终端管理员。

PixPin_2026-04-23_16-24-50-cUkW.png

输入命令即可。

按提示添加环境路径

$env:Path = "C:\Users\skyler\.local\bin;$env:Path"

最好重启一下电脑。

接入MCP

以MiniMax官方MCP为例。

需要替换：MINIMAX_API_KEY

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp", "-y"],
      "env": {
        "MINIMAX_API_KEY": "MINIMAX_API_KEY",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      }
    }
  }
}

在Trae中依次点击：设置->MCP->手动添加MCP->复制内容->确定

安装Skill

以PPT-Master的skill为例。

官方链接：https://github.com/hugohe3/ppt-master

原仓库安装方法

1、安装Python

2、下载安装包

3、安装项目依赖

pip install -r requirements.txt

在线风格预览：https://hugohe3.github.io/ppt-master

为了隔离环境，整理采用MiniConda的方式。（仅第一步不同）

这里直接进入第二步

下载安装包并解压至工作目录

右键开始图标，运行：终端管理员。

PixPin_2026-04-23_16-24-50-cUkW.png

新建Conda环境

输入命令

conda create -n ppt-master python=3.11 -y

激活环境

conda activate ppt-master

进入解压位置

复制路径：D:\WorkPlace\AI\PPTMaster

路径需要按需更改。

pushd D:\WorkPlace\AI\PPTMaster
 
pip install -r requirements.txt

等待安装结束。

如果需要文生图功能，则还需修改配置文件，这里略过。

cp .env.example .env    # 然后填入你的 API Key
 
IMAGE_BACKEND=gemini                        # 必填——必须显式指定
GEMINI_API_KEY=your-api-key
GEMINI_MODEL=gemini-3.1-flash-image-preview

打开工作区目录，需要把skill压缩成安装包

打开Trae，安装skill

依次点击：设置->规则和技能->项目->创建

点击上传框，选择之前那个压缩包，确认即可。

在Trae中切换Conda解释器

先随便找一个Python文件，点击右下角。

推荐路径：.trae\skills\ppt-master\scripts

选择对应解释器即可

至此完成前置准备。

项目实操

需求：搜索云控制、网络控制系统、物联网、云计算、大数据等相关的新闻和事件，要求发布时间近1年。至少收集5条，并从搜集的新闻事件中，总结和展望云控制和物联网相关技术的发展趋势，至少总结3条，并做成PPT，讲解5-6分钟。

步骤一：拆分需求

  1. 搜索云控制、网络控制系统、物联网、云计算、大数据等相关的新闻和事件，要求发布时间近1年。至少收集5条；

  2. 从搜集的新闻事件中，总结和展望云控制和物联网相关技术的发展趋势，至少总结3条；

  3. 做成讲解5-6分钟的PPT。

步骤二：分步执行

以下使用的模型均为：MiniMax-M2.7-Highspeed

提示词

先确定一下当前时间。调用MCP，搜索云控制、网络控制系统、物联网、云计算、大数据等相关的新闻和事件，要求发布时间近1年。至少收集5条。需要确保信息来源真实，汇总为带时间戳的MD文件并且附带URL链接，保存至 `d:\WorkPlace\AI\PPTMaster\temp`

完成MD文件制作

这里我们可以看见：总结了8条，而我们只需要5条

现在执行过滤

提示词

按照影响力大小分级，把汇总的信息仅保留6条。

按需更改内容

提示词

依照原URL链接，优化润色MD文件，我需要尽可能多的真实信息，现在的内容摘要太简短了，并且移除md文件中的影响评级相关内容。

续写发展趋势

提示词

续写原MD文件，从搜集的新闻事件中，总结和展望云控制和物联网相关技术的发展趋势，至少总结3条

重要操作：在人工审核MD文档内容后，需新开一个任务复查内容真实性。

最左侧

提示词

调用MCP，核实 `d:\WorkPlace\AI\PPTMaster\temp\云控制网络控制系统物联网云计算大数据新闻汇总_2026-04-24.md` ，需要确保信息及数据真实有效。

需要保持质疑的态度

提示词

完全修正。

最好人工再审查一遍

步骤三：制作PPT

注意：这里的Skill是个性化之后的，和原版略有差异，后续会详细介绍

新开一个任务

提示词

调用skill，结合 `d:\WorkPlace\AI\PPTMaster\temp\云控制网络控制系统物联网云计算大数据新闻汇总_2026-04-24.md` 帮我完成PPT的制作。

选择模板

按需选择即可

这里想体验一下原作者更新的模板。

先选择：使用其他模板

再补充，选择：anthropic

其实个人感觉ai_ops和Google风格好看一些

确认参数

按推荐即可

等待SVG图片生成

需要较长时间，这时候可以去做其他事了，完成后会有提示音。

人工审查

按提示选择。

提示：如果没有太大排版问题，就直接通过，手动微调PPT即可。

这时候有一个HTML可以预览（需安装插件：Live Server）

路径：projects\cloud_control_iot_news_summary_ppt169\review\preview_deck.html

找到该文件，右键选择用插件打开。

然后长这样

如果想省事可选择直接查看SVG图片，路径：projects\cloud_control_iot_news_summary_ppt169\svg_output

完成PPT制作

路径：projects\cloud_control_iot_news_summary_ppt169\exports

选择可以直接编辑PPT

如果发现PPT组件不可编辑，按下图操作

扩展

项目目录作用汇总

顶层目录

目录 / 文件

作用

.trae/

项目的核心工作流目录，真正的 ppt-master 规则、脚本、模板、参考资料都在这里。

projects/

实际 PPT 项目的工作区。每个子目录通常对应一个具体项目，保存源资料、生成的 SVG、审查结果和导出文件。

examples/

示例项目和案例库，用来参考成品效果、页面风格和项目结构。

docs/

项目文档目录，包含安装说明、FAQ、技术设计、项目介绍等。

exports/

仓库级导出目录，通常用于放最终导出的 PPT/PPTX 成品。当前仓库里基本为空。

temp/

临时材料目录，主要放执行日志、整改说明、排障记录和临时脚本。

.github/

GitHub 仓库配置目录，例如 issue 模板、CI 工作流等。

.trae/skills/ppt-master/ 结构

子目录 / 文件

作用

SKILL.md

整个 PPT 生成流程的总说明，是这个仓库最核心的工作流文档。

scripts/

各种自动化脚本，例如项目初始化、源文件转 Markdown、SVG 检查、预览、导出 PPTX。

references/

流程规范和参考资料，例如审查标准、画布规格、角色说明、交互检查点规则。

templates/

模板资源目录，包含布局模板、图表模板、图标库、审查模板等。

workflows/

独立工作流说明，例如某些专项流程。

.runtime/

运行时记录目录，保存命令回执、最近一次执行结果等机器可读信息。

projects/ 下单个项目的典型结构

子目录 / 文件

作用

sources/

原始资料归档区，例如 PDF、Markdown、网页抓取结果、转换后的文档。

images/

项目使用的图片资源。

design_spec.md

设计规格说明，定义页面结构、风格、配色、图片策略等。

svg_output/

初步生成的 SVG 页面。

svg_final/

经过后处理后的最终 SVG 页面。

notes/

演讲备注，通常包含 total.md 和拆分后的逐页备注。

review/

审查产物目录，包含审查状态、修复任务、确认文件、预览页等。

exports/

该项目自己的导出结果目录，保存最终生成的 PPTX 文件。

templates/

项目级模板目录，通常用于当前项目的局部模板或特殊资源。

根目录重要文件

文件

作用

README.md

项目英文总说明和快速开始。

README_CN.md

项目中文说明。

AGENTS.md

当前仓库对 AI 代理的执行约束。

.env / .env.example

环境变量配置文件，主要用于图片生成等外部能力。

requirements.txt

Python 依赖列表。

index.html / viewer.html

与项目展示、预览相关的静态页面。

一句话理解

这个仓库可以简单分成三层：

  • .trae/skills/ppt-master/：工作流引擎层

  • projects/：实际项目生产层

  • docs/、examples/：说明与展示层

新版本核心改动汇总

  1. 工作流升级为审查驱动

    • 主流程新增 SVG Review Gate，形成「生成 -> 审查 -> 批准 -> 导出」的闭环。

    • 阻塞点扩展为模板选择、八项确认、最终 SVG 审查 3 个关键关口。

    • 未通过审查或未获用户批准时，禁止进入导出。

  2. 新增完整的审查与返修体系

    • 新增 review_manager.py、revision_manager.py 及 references/svg-review/ 规范集。

    • 支持逐页 review、全案 verify、返修轮次跟踪、审批记录。

    • 审查结果统一落到 review/ 目录，形成可追踪、可恢复的流程闭环。

  3. 项目管理与命名规则更稳定

    • project_manager.py 增强，新增 apply-template、JSON/report 输出、review 初始化能力。

    • 项目目录命名改为稳定格式 projects/<project_name>_<format>，不再带日期。

    • 强制英文 slug、ASCII 安全文件名，减少 Windows 和多轮流程中的路径问题。

  4. 资源查找与质量检查能力增强

    • 新增 asset_lookup.py、icon_reference_checker.py、svg_layout_checker.py、svg_text_container_checker.py。

    • 图标使用从「人工猜测」升级为「精确校验 + 有限搜索 + 失败后及时切换 fallback」。

    • 页面质量检查覆盖布局、文本溢出、图标引用等关键问题。

  5. 预览与导出边界更清晰

    • 新增 preview_svg_deck.py，统一生成 review/preview_deck.html。

    • finalize_svg.py 新增 --review-preview，支持生成 review/preview_finalized/ 作为审查预览面。

    • 审查预览与最终导出分离，避免「预览正常/导出异常」或「预览不完整却要求用户批准」的问题。

  6. 运行稳定性和工程化程度明显提升

    • 图片生成新增 capability gate，不能再默认 AI 生图一定可用。

    • 强化 Windows/Trae 执行规范、UTF-8 输出、repo-root 调用方式。

    • 新增 .runtime/command_reports/ 和 scripts/tests/，提升可回执性、可测试性和 agent 连续执行稳定性。