科研 Skill

PPT 阅读器

ppt-reader

读取本地 PPT 文本、表格和备注

官方收录发布者 speedclaw-local-research-skills安全审核通过v0.1.0更新于 2026-07-30

Skill 说明

读取和分析本地 PowerPoint PPTX/POTX 演示文稿,提取幻灯片文本、表格和演讲者备注;在 office 渲染工具可用时可生成页面图像用于视觉检查 | 输入:.pptx / .potx 文件 | 输出:Markdown 文本、表格、备注和可选页面渲染图

SKILL.md

PPT Reader

Use this skill for presentation-reading requests. A PPTX/POTX is an OOXML ZIP package.

Default text workflow

Use MarkItDown by default. It is a Python package, so install it automatically when it is missing; do not ask the user to install it manually.

Resolve PYTHON in this order: $CODAR_PYTHON, then python3, then python. Keep the package in this skill's private .venv, never in the user's system Python:

PYTHON="${CODAR_PYTHON:-python3}"
if [ ! -x "$SKILL_DIR/.venv/bin/markitdown" ]; then
  "$PYTHON" -m venv "$SKILL_DIR/.venv"
  "$SKILL_DIR/.venv/bin/python" -m pip install --disable-pip-version-check "markitdown[pptx]"
fi
"$SKILL_DIR/.venv/bin/markitdown" presentation.pptx

Use the extracted Markdown to answer questions, and retain slide-number markers when they are present. If the MarkItDown download or conversion fails, continue with the bundled standard-library fallback instead of failing the request:

"${CODAR_PYTHON:-python3}" "$SKILL_DIR/scripts/read_pptx.py" presentation.pptx

The fallback extracts ordered slide text, table cells, and speaker notes without non-standard Python packages. It does not understand pictures, charts, SmartArt, or visual layout.

Visual workflow

Check first:

command -v soffice
command -v pdftoppm

Only if both commands exist, render for visual inspection:

soffice --headless --convert-to pdf --outdir ./pptx-render presentation.pptx
pdftoppm -png -r 144 ./pptx-render/presentation.pdf ./pptx-render/slide

If either command is absent, clearly state that text was extracted but visual inspection was skipped. Do not require LibreOffice or Poppler for ordinary text questions.

Limits

  • .ppt is the legacy binary format; ask for a .pptx export.
  • Do not claim that a chart, screenshot, or diagram says something based only on text extraction. Render slides first when visual evidence matters.

常见问题

PPT 阅读器能做什么?

读取和分析本地 PowerPoint PPTX/POTX 演示文稿,提取幻灯片文本、表格和演讲者备注;在 office 渲染工具可用时可生成页面图像用于视觉检查 | 输入:.pptx / .potx 文件 | 输出:Markdown 文本、表格、备注和可选页面渲染图。

如何安装PPT 阅读器?

在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「PPT 阅读器」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。

PPT 阅读器需要哪些权限?

该科研 Skill声明需要:本地文件。安装前会再次列出,由你确认后才会生效。

PPT 阅读器经过官方审核吗?

是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。