用途:讓 OpenCode agent 具備產出文件、下載影音與語音朗讀的能力,三段彼此獨立,任一段失敗不影響其他兩段。
A 段文件處理:git clone https://github.com/mathruffian-dot/ai-agent-ep03.git 後 cd ai-agent-ep03,以 uv 建立 .venv 並依 requirements-core.txt 安裝 python-docx、openpyxl、python-pptx、pypdf、PyMuPDF、reportlab、Pillow、matplotlib、qrcode[pil]、markitdown[pdf,docx,pptx,xlsx] 共 10 項標配。Windows 可執行 powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\install_windows.ps1";macOS/Linux/WSL 以 uv venv --python 3.12 .venv 與 uv pip install 手動安裝。驗證執行 verify_core.py,看到 CORE_OK: 10/10 且 exit code 為 0 才算成功。需 Python ≥ 3.11,建議 3.12。
B 段影音工具:Windows 用 winget install --id yt-dlp.yt-dlp -e;macOS 用 brew install yt-dlp;Linux 可 sudo apt install -y ffmpeg 加 uv tool install yt-dlp。安裝後需重開終端機讓 PATH 生效。以 yt-dlp --version; ffmpeg -version; deno --version 驗證。使用 --print 時必須加 --no-simulate,否則不會真正下載。
C 段語音:以 uv tool install edge-tts 安裝,使用 zh-TW-YunJheNeural、zh-TW-HsiaoChenNeural、zh-TW-HsiaoYuNeural 等台灣中文聲音。以 edge-tts --list-voices 查看可用聲音,播放建議使用行內播放器如 PowerShell MediaPlayer、afplay、mpv。此段需網路連線,屬非官方管道。
限制:禁止全域 pip install,A 段一律裝進 .venv,C 段用 uv tool install;選配套件與其他系統工具預設不裝,需使用者明確點名。Windows、WSL、Docker 等環境的 Python 套件不能共用。A 段細部安裝腳本以 https://github.com/mathruffian-dot/ai-agent-ep03 為準,預設分支為 master。