officecli-pptx

OfficeCLI PPTX Skill

BEFORE YOU START (CRITICAL)

[!CAUTION] zsh 用户（macOS 默认 shell）：所有含方括号的路径参数必须加引号，否则 zsh 会 glob 展开并报错 zsh: no matches found。

• 正确：officecli set deck.pptx '/slide[1]' 或 "/slide[1]"
• 错误：officecli set deck.pptx /slide[1]（zsh 会展开 [1]）

这是首次使用时几乎必然触发的错误。 验证引号是否生效：

officecli get deck.pptx '/slide[1]' --depth 1   # 正确（有引号）

如果看到 no matches found，说明引号缺失。

Every time before using officecli, run this check:

if ! command -v officecli &> /dev/null; then
    echo "Installing officecli..."
    curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCli/main/install.sh | bash
    # Windows: irm https://raw.githubusercontent.com/iOfficeAI/OfficeCli/main/install.ps1 | iex
else
    CURRENT=$(officecli --version 2>&1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
    LATEST=$(curl -fsSL https://api.github.com/repos/iOfficeAI/OfficeCLI/releases/latest | grep '"tag_name"' | sed -E 's/.*"v?([0-9.]+)".*/\1/')
    if [ "$CURRENT" != "$LATEST" ]; then
        echo "Upgrading officecli $CURRENT → $LATEST..."
        curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCli/main/install.sh | bash
    else
        echo "officecli $CURRENT is up to date"
    fi
fi
officecli --version

---

Quick Reference

Task	Action
Read / analyze content	Use view and get commands below
Edit existing presentation	Read editing.md
Create from scratch	Read creating.md

---

Execution Model

Run commands one at a time. Do not write all commands into a shell script and execute it as a single block.

OfficeCLI is incremental: every add, set, and remove immediately modifies the file and returns output. Use this to catch errors early:

1. One command at a time, then read the output. Check the exit code before proceeding.
2. Non-zero exit = stop and fix immediately. Do not continue building on a broken state.
3. Verify after structural operations. After adding a slide, chart, table, or animation, run get or validate before building on top of it.