pptx-notes-editor

Polar Sponsor
爱发电 赞助
.NET 9.0

用于AI代理的PowerPoint演讲稿编辑器。适用场景:①修改PPT演讲稿,②导出为Markdown,③以新风格重写演讲稿

PPTX 注解编辑器.

功能概述

PPTX 注解编辑器.是一项面向实际任务的技能,主要用于Workflow 决定树.;Unpack PPTX;

核心要点

  • File 结构 :. 确认幻灯片对注解映射. 重要:注解的编号 SlideN.xml 并不一定与 PPT 页面麻木对应。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。

使用与执行

该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;

结果检查与注意事项

若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

PPTX 笔记编辑器

工作流决策树

用户请求
├── 修改笔记 → 1,2,3,4,5,6
├── 仅导出为 MD → 1,2 → 7
├── 仅打包现有内容 → 5(可选:验证 → 6)
└── 仅解包并查看 → 1

1. 解包 PPTX

# 解包至指定目录
mkdir -p pptx-unpacked && unzip your-presentation.pptx -d pptx-unpacked

文件结构:

pptx-unpacked/
├── ppt/
│   ├── slides/              # 幻灯片
│   │   ├── slide1.xml
│   │   ├── slide2.xml
│   │   └── _rels/          # 幻灯片关系文件
│   │       ├── slide1.xml.rels
│   │       └── slide2.xml.rels
│   ├── notesSlides/        # 备注文件
│   │   ├── notesSlide1.xml
│   │   └── notesSlide2.xml
│   └── _rels/
│       └── presentation.xml.rels
└── [Content_Types].xml

2. 确认幻灯片与备注的映射关系

重要提示:notesSlideN.xml 的编号 不一定 对应 PPT 页面编号!您必须通过关系文件(.rels)确认映射关系。

方法 1:检查精确映射(推荐)

# 检查第 N 张幻灯片对应哪个备注文件
cat pptx-unpacked/ppt/slides/_rels/slideN.xml.rels | grep -i "notesSlide"

# 示例输出:
# 
# 表示 slideN.xml 对应 notesSlide2.xml

方法 2:快速查看全部映射关系

# 列出所有幻灯片与备注文件的对应关系
for f in pptx-unpacked/ppt/slides/_rels/slide*.xml.rels; do
  slide=$(basename "$f" .xml.rels)
  notes=$(grep -o 'notesSlide[0-9]*.xml' "$f" | head -1)
  if [ -n "$notes" ]; then
    echo "$slide -> $notes"
  fi
done

边界情况

  • 幻灯片无备注:grep 无输出,说明该幻灯片未关联任何备注
  • 备注文件存在但无对应幻灯片:可能为孤立的备注文件,可忽略

3. 读取备注内容

XML 命名空间参考

PPTX XML 使用如下命名空间前缀:

  • a: — DrawingML 命名空间(用于文本、形状等)
  • p: — PresentationML 命名空间(用于幻灯片结构)
  • r: — Relationships 命名空间

备注文本位于 标签内。

方法 1:逐页读取

# 列出所有备注文件
ls pptx-unpacked/ppt/notesSlides/

# 使用任意文本阅读工具打开单个备注文件
# 备注文本位于  标签中

方法 2:批量提取全部备注文本

# 提取所有备注文件中的文本(macOS 兼容)
grep -oh '[^<]*' pptx-unpacked/ppt/notesSlides/*.xml | sed 's/([^<]*)/\1/g' | head -50

方法 3:按文件提取单页备注

# 提取 notesSlide2.xml 中全部文本(macOS 兼容)
grep -oh '[^<]*' pptx-unpacked/ppt/notesSlides/notesSlide2.xml | sed 's/([^<]*)/\1/g'

处理 XML 转义字符

备注文本中可能出现以下转义序列:

  • < → <
  • > → >
  • & → &
  • " → "

使用 sed 解码:

sed 's//>/g; s/&/&/g; s/"/"/g'

4. 重写为叙事风格

叙事风格指南

  • 以“开端—发展—转折点—结尾”结构讲述一个完整故事
  • 使用自然、口语化的过渡语言
  • 辅以具体示例与实际场景
  • 建立与听众的情感连接与共鸣

重要注意事项

  • 修改前必须确认:生成备注草稿后,须向用户展示并获得明确确认,方可执行任何 XML 修改操作。未经用户确认,严禁修改任何备注内容
  • 若原始 PPT 备注为枯燥的项目符号列表,需完全重写为叙事风格
  • 若原始备注已为叙事风格,可进行润色与优化
  • 切勿假设“保留原有风格”——应根据目标演示文稿的实际语境确定风格

修改流程

步骤 0:请用户选择页面范围与备注风格

开始前,请向用户提供以下选项:

页面范围选择:

  • 全部页面
  • 仅无备注的页面
  • 仅有备注的页面
  • 自定义范围(用户输入,例如 “1-5,8,10-12”)

备注风格选择:

  • 叙事风格(讲故事、口语化,具备开端/发展/高潮/结尾)
  • 简洁要点式(提炼关键信息,简明有力)
  • 逐字讲稿式(可直接朗读的完整口语脚本)
  • 自定义风格(用户描述期望风格)

语言选择(可选):

  • 保持原文语言
  • 中文
  • 英文

步骤 1:通读整份 PPT 内容(构建全局上下文)

在逐页修改前,必须通读全部幻灯片以构建全局上下文:

# 批量提取所有幻灯片文本摘要(macOS 兼容)
for f in pptx-unpacked/ppt/slides/slide*.xml; do
  slide=$(basename "$f" .xml)
  echo "=== $slide ==="
  grep -oh '[^<]*' "$f" | sed 's/([^<]*)/\1/g'
  echo ""
done

通读后,向用户呈现全局概览:

[PPT 全局概览]
总计:X 页,主题:xxx  
第 1 页:开场 — xxx  
第 2 页:背景 — xxx  
第 3 页:核心论点 — xxx  
...  
第 X 页:总结 — xxx  

叙事脉络:xxx → xxx → xxx

通读目的:

  • 理解整体叙事脉络与逻辑结构
  • 明确每页功能定位(铺垫、核心论点、案例研究、转折点、总结等)
  • 避免备注内容重复或逻辑断层
  • 为后续逐页设计提供上下文支撑

步骤 2+:逐页修改

  1. 依据所选页面范围,逐页读取幻灯片内容摘要(从 slideN.xml 中提取关键文本)
  2. 读取当前备注(来自对应 notesSlide),结合步骤 1 构建的全局上下文,理解该页在整体中的角色
  3. 以如下格式向用户同时展示:
--- 第 N 页 ---
[幻灯片内容]
标题:xxx  
要点:aaa, bbb, ccc  
图表:[如有,简要描述]

[当前备注]
(显示全部现有备注;如为空则标注 “None”)
  1. 按用户选定风格生成备注草稿,并向用户展示
  2. 必须等待用户明确确认后,方可修改 XML 中的 文本。未经用户确认,严禁执行任何修改
  3. 获得用户对当前页的确认后,再进入下一页

XML 修改注意事项

  • 修改时需严格匹配完整字符串
  • XML 中的换行符可能被渲染为字面量 n
  • 建议先搜索文件内容,确认待替换字符串的确切形式



旧文本  →  新文本

示例:


这是旧的备注内容


这是新的备注内容

处理多段落备注

若备注含多个段落,则会出现多个 标签:


  第一段


  第二段

需分别修改每个 标签。

批量操作指南

如需在多处统一修改相似内容,请按以下步骤操作:

  1. 搜索文件内容,确认所有需修改位置
  2. 逐一修改每一处
  3. 每次修改后均需验证结果

5. 打包 PPTX

cd pptx-unpacked && zip -r ../pptx-packed.pptx . -x "*.py" -x "*.txt" -x "*.json" -x ".DS_Store"

6. 验证修改结果

# 解包新生成的文件,验证 XML 结构是否正确
mkdir -p /tmp/verify && unzip -o pptx-packed.pptx -d /tmp/verify

# 检查修改内容是否已生效
grep "新文本" /tmp/verify/ppt/notesSlides/*.xml

# 验证 XML 格式是否合规(无解析错误)
# 若已安装 xmllint:
# xmllint --noout /tmp/verify/ppt/notesSlides/*.xml 2>&1 && echo "XML 格式正确"

7. 导出为 MD

提取幻灯片标题

# 提取幻灯片标题(macOS 兼容)
# 标题通常位于第一个  标签中
grep -oh '[^<]*' pptx-unpacked/ppt/slides/slideN.xml | sed 's/([^<]*)/\1/g' | head -1

导出格式

将全部页面备注整理为单个 Markdown 文件:

# 演示文稿名称 — 演讲者备注

## 第 1 页:标题
备注内容...

## 第 2 页:标题
备注内容...

基于实际映射关系的正确导出脚本

#!/bin/bash
# 按幻灯片实际顺序导出备注(macOS 兼容)

output="notes-export.md"
echo "# PPT 演讲者备注导出" > "$output"
echo "" >> "$output"

slide_num=0
for slide_rels in pptx-unpacked/ppt/slides/_rels/slide*.xml.rels; do
  slide_num=$((slide_num + 1))

  # 获取该幻灯片对应的备注文件(macOS 兼容)
  notes_file=$(grep -o 'notesSlide[^"]*.xml' "$slide_rels" | head -1)

  if [ -n "$notes_file" ] && [ -f "pptx-unpacked/ppt/notesSlides/$notes_file" ]; then
    # 获取幻灯片标题(首个 )
    slide_file="pptx-unpacked/ppt/slides/slide${slide_num}.xml"
    title=""
    if [ -f "$slide_file" ]; then
      title=$(grep -oh '[^<]*' "$slide_file" | sed 's/([^<]*)/\1/g' | head -1)
    fi

    echo "## 第 ${slide_num} 页${title:+: $title}" >> "$output"
    echo "" >> "$output"

    # 提取备注文本
    grep -oh '[^<]*' "pptx-unpacked/ppt/notesSlides/$notes_file" | 
      sed 's/([^<]*)/\1/g' | 
      sed 's//>/g; s/&/&/g; s/"/"/g' >> "$output"

    echo "" >> "$output"
    echo "---" >> "$output"
    echo "" >> "$output"
  fi
done

echo "导出完成:$output"

附录:故障排查

问题:修改后 PPT 无法打开

  • 原因:XML 结构损坏(如标签未闭合、特殊字符未转义)
  • 解决方案:修改 XML 时,务必确保完整的 ... 结构不被破坏

问题:修改后的文本未生效

  • 原因:修改了错误的 notesSlide 文件
  • 解决方案:重新确认 slideN.xml 与 notesSlide 的映射关系

问题:文本中出现特殊字符

  • 原因:字符 & < > " 在 XML 中需转义
  • 解决方案:修改时确保这些字符被正确转义为 & < > "

完整示例

# 1. 解包
mkdir -p pptx-unpacked && unzip demo.pptx -d pptx-unpacked

# 2. 确认映射(查找第 5 页对应的备注文件)
cat pptx-unpacked/ppt/slides/_rels/slide5.xml.rels | grep -i "notesSlide"
# 输出:Target="../notesSlides/notesSlide3.xml"

# 3. 读取第 5 页备注(对应 notesSlide3.xml,macOS 兼容)
grep -oh '[^<]*' pptx-unpacked/ppt/notesSlides/notesSlide3.xml | sed 's/([^<]*)/\1/g'

# 4. 修改备注(编辑 XML 文件)
# 将 notesSlide3.xml 中的 旧内容 替换为 新内容

# 5. 打包
cd pptx-unpacked && zip -r ../demo-new.pptx . -x "*.py" -x ".DS_Store"
cd ..

# 6. 验证
mkdir -p /tmp/verify && unzip -o demo-new.pptx -d /tmp/verify
grep "新文本" /tmp/verify/ppt/notesSlides/notesSlide3.xml

# 7. 导出 MD(使用上方脚本)

复用检查清单

  • 将 PPTX 解包至 pptx-unpacked 目录
  • 确认幻灯片与备注的映射关系
  • 明确修改范围(全部/部分页面)
  • 确认叙事风格要求
  • 在用户确认前提下逐页修改
  • 修改完成后打包 PPTX
  • 验证修改是否生效
  • 如有需要,导出为 MD

相关专题

更多
PPT批量修改调整尺寸教程合集
PPT批量修改调整尺寸教程合集

本专题整合了PPT批量修改图片尺寸教程合集,阅读专题下面的文章了解更多详细内容。

2026.04.03

378

14

PPT批量插入图片方法合集
PPT批量插入图片方法合集

本专题整合了PPT批量插入图片相关技巧,阅读专题下面的文章了解更多详细步骤。

2026.04.03

164

12

PPT自动播放设置合集
PPT自动播放设置合集

本专题整合了PPT自动播放相关教程内容合集,阅读专题下面的文章了解更多详细内容。

2026.04.01

139

23

ppt一键生成相关合集
ppt一键生成相关合集

本专题整合了ppt一键生成相关教程汇总,阅读专题下面的的文章了解更多详细内容。

2026.01.15

654

45

PPT交互图表教程大全
PPT交互图表教程大全

本专题整合了PPT交互图表相关教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.12

273

10

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

2026.01.07

314

19

word转换成ppt教程大全
word转换成ppt教程大全

本专题整合了word转换成ppt教程,阅读专题下面的文章了解更多详细操作。

2025.12.25

511

16

PPT怎么一次性插入多张图片
PPT怎么一次性插入多张图片

在 PPT 中一次性插入多张图片,可先打开 PPT,定位到要插入图片的幻灯片,点击 “插入” 选项卡中的 “图片”。在弹出的文件选择窗口中,按住 Ctrl 键(Windows 系统)或 Command 键(Mac 系统),逐一选择所需图片,然后点击 “插入” 按钮即可。

2025.04.28

149801

9

ppt成品免费获取网站
ppt成品免费获取网站

本专题推荐了多个提供免费 PPT 模板的网站,包括 SlideModel、PowerPoint Templates、Presentation Magazine、Free-Powerpoint-Templates 和 Canva。这些网站提供种类繁多的模板,涵盖各种主题、风格和设计。

2025.03.10

15139

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GenerateAPI使用指南
GenerateAPI使用指南

共0课时 | 0人学习

天工智能体:免费AI神器!
天工智能体:免费AI神器!

共0课时 | 174人学习

天工AI帮助手册
天工AI帮助手册

共0课时 | 0人学习