PPT Library
本地优先的 PPTX 资产库 CLI：把历史 PPT 按页入库，支持搜索、审查、复用、组装与战绩追踪，供 Agent 稳定调用。
本地 CLI + Agent Skill（skills/ppt-library）。数据默认存于 ~/.ppt-library/，Playground 未接入；完整使用说明见 docs/skill-ppt-library-使用说明.md。
效果预览
示例为本站按该 Skill 风格渲染的演示效果,点击或按方向键可翻页
能力说明
页级搜索
抽取每页文本、截图与向量，关键词 + 语义检索
版本治理
同项目多版本归入 deck family，默认展示代表版本
Deck 理解
补充项目、客户、行业、场景、章节结构与摘要
自动组装
根据 brief 选页，生成审查清单与 PPTX 草稿
使用说明
方式一:本地安装使用
依赖环境
- Python 3.12+
- uv 或 pip（源码安装）
- 可选: LibreOffice（页截图）、LM Studio/Ollama（embedding）、PaddleOCR MCP
安装步骤
- 克隆: git clone https://github.com/MainQuestAI/PPT-Library.git && cd PPT-Library
- 安装: uv sync --extra test --extra lint（推荐加 --extra paddleocr）
- 验证: uv run ppt-lib --help 或 uv tool install . 后执行 ppt-lib --version
- 安装 Agent Skill: rsync -a skills/ppt-library/ ~/.codex/skills/ppt-library/（Claude: ~/.claude/skills/）
- 初始化: ppt-lib setup --quick → sources manifest → init --manifest → scan --dry-run → scan --apply → index --from-sources
Prompt 示例
Use the ppt-library skill. 先在 /tmp 做 smoke test 确认 CLI 可用；再帮我把 /absolute/path/to/ppt-folder 建库，搜索「技术架构」相关页面，输出 JSON 并检查 _errors。
方式二:本站在线使用
受 License 限制(Apache-2.0),该 Skill 暂不提供在线生成,请按方式一在本地使用。
适用场景
从历史 PPT 找可复用页面售前方案减重复造页Agent 检索组装而非翻文件夹多版本 PPT 治理
常见问题
和 PPT Deck Pro Max 什么关系?
PPT Library 是资产检索层（找历史可复用页）；PPT Deck Pro Max 是叙事规划层（新 Deck 怎么讲对）。二者常串联使用。
Agent 调用要注意什么?
命令带 --output json；路径用绝对路径；建库前必须 sources scan --dry-run 确认范围；检查 stdout JSON 的 _errors。
数据存在哪?
默认 ~/.ppt-library/（SQLite、截图、HTML 预览）。客户 PPT 与索引均留在本机。