MemSlides 快速开始教程:一条命令生成你的第一套 PPT,附新手常见坑点清单
【免费下载链接】MemslidesA hierarchical memory framework for personalized presentation agents. Try it at memslides.com.项目地址https://gitcode.com/gh_mirrors/me/Memslides点击查看免费下载MemSlides 是一个带分层记忆的 AI PPT 生成框架hierarchical memory framework for personalized presentation agents。本教程带你 5 分钟完成安装用一条命令生成第一套 PPT并提前避开新手最常踩的 API Key、中文字体、Playwright 依赖等坑点让你快速跑通生成—修改—导出的完整流程。一、MemSlides 是什么会记住你的 PPT 智能体和一次性转换不同MemSlides 把做 PPT 当作一个有状态、可多轮修改的过程核心由三层记忆驱动用户画像记忆Long-term Memory跨任务记住你的主题、版式、模板偏好按演示意图intent自动注入新任务工作记忆Working Memory在当前套件的多次修改轮次中保持临时偏好和会话约束不丢失工具记忆Tool Memory沉淀可复用的工具链执行经验避免同类编辑反复失败局部化修订Slide-local Revision收到反馈后只改受影响的幻灯片区域而不是整副 deck 重写。项目入口与说明可参考 README.md完整安装文档见 docs/INSTALL.md。二、安装前准备环境要求一览依赖版本/说明Python3.11见 environment.ymlNode.js20PPTX 导出运行时使用系统工具LibreOffice、Poppler、CJK 中文字体Linux 用 apt 安装浏览器内核Playwright Chromium ffmpeg⚠️ Windows 用户请单独安装 LibreOffice 和 Poppler并保证命令行工具在PATH中详见 docs/INSTALL.md。克隆仓库git clone https://gitcode.com/gh_mirrors/me/Memslides cd Memslides三、5 步安装从克隆到可用第 1 步安装系统依赖Linuxsudo apt-get update sudo apt-get install -y libreoffice fontconfig fonts-noto-cjk poppler-utils第 2 步创建 conda 环境conda env create -f environment.yml conda activate memslides第 3 步以可编辑模式安装 Python 包pip install -e .[research]第 4 步安装 Playwright 浏览器内核python -m playwright install chromium ffmpeg第 5 步验证安装python -m memslides.experiment --help能打印出run / resume / report / personas等子命令即安装成功。四、一条命令生成你的第一套 PPT4.1 最小验证跑内置 smoke 套件python -m memslides.experiment run smoke_minimal \ --output-base .memslides/experiments \ --parallel 1内置套件 smoke_minimal.yml 会生成一页纯标题幻灯片并禁用联网检索与生图是验证生成 → 渲染 → PPTX 导出全链路最快的方式。套件用法详见 use.md。4.2 自由生成一条命令出 PPTpython -m memslides generate \ --instruction Create a one-slide project summary \ --num-pages 1 --language zh核心命令解析位于 src/memslides/main.py还支持通过--input传入 JSON 请求体、--workspace指定工作区。4.3 多轮局部修改只改你说的那一页python -m memslides revise --workspace .memslides/session --feedback Tighten the titlerevise会把反馈投影到最小的受影响区域只做局部补丁修订实现逻辑在 src/memslides/main.py。4.4 把自己的 PPTX 变成可复用模板python -m memslides template induct --template-file template.pptx生成结果统一落在.memslides/目录下运行结束后可用汇总命令查看python -m memslides.experiment report .memslides/experiments/smoke_minimal五、配置要点API Key 怎么放才安全真实生成需要模型与服务的凭据。MemSlides 的公开配置是 memslides.yaml其中的占位符会在加载时从环境变量展开支持三种配置方式按推荐顺序环境变量如MEMSLIDES_DESIGN_BASE_URL、MEMSLIDES_DESIGN_MODEL、MEMSLIDES_DESIGN_API_KEY本地.env文件放在仓库根目录不要提交私有 YAML通过--config参数或MEMSLIDES_CONFIG_FILE环境变量指定。 安全提醒不要提交.env、.memslides/、生成的工作区和私有配置文件官方安全说明见 README.md。六、新手常见坑点清单 ✅#现象原因与解决1报missing-api-key相关错误未配置模型凭据。检查 memslides.yaml 中各 Agent 的api_key用环境变量或.env注入2导出的 PPT 中文乱码/豆腐块缺少 CJK 字体执行sudo apt-get install -y fonts-noto-cjk3PDF/PPTX 导出失败未安装 LibreOffice 或 Poppler参考 docs/INSTALL.md 补齐系统依赖4启动时报浏览器相关错误漏了python -m playwright install chromium ffmpeg5Python/Node 版本不符环境要求 Python 3.11 Node 20用 environment.yml 锁定的 conda 环境最稳6smoke 套件没体现记忆效果smoke_minimal默认memory_enabled: false属最小验证套件测记忆需自定义 suite YAML 打开开关7第一次导出 PPTX 很慢首次会自动安装 Node 依赖到缓存离线环境可预装 presentation_export 的依赖并设置MEMSLIDES_PPTX_EXPORT_NODE_MODULES8Docker 跑完状态消失容器内状态在/app/.cache/memslides需挂卷持久化见 docker/README.md9并行跑挂掉新手先用--parallel 1串行跑通再调大七、可选用 Docker 最快跑通免本机装依赖如果不想在本机装 LibreOffice 等一整套依赖Docker 镜像已包含 Python、Node、Playwright、LibreOffice 与导出运行时docker compose build docker compose run --rm memslides python -m memslides.experiment run smoke_minimal \ --output-base /app/.cache/memslides/experiments \ --parallel 1需要私有 YAML 配置时叠加 private override 文件运行docker compose -f docker-compose.yml -f docker-compose.private.yml run --rm memslides \ python -m memslides.experiment run smoke_minimal \ --output-base /app/.cache/memslides/experiments --parallel 1Compose 会把实验状态和产物保存在./.memslides完整说明见 docker/README.md。写在最后按照装依赖 → conda 环境 → 安装 Playwright → 跑 smoke 套件 →generate出 PPT这条路径MemSlides 从克隆到生成第一套 PPT 只需要几条命令。遇到报错时对照第六节的坑点清单逐一排查绝大多数新手问题API Key、中文字体、浏览器内核都能快速定位。跑通之后再试试revise多轮局部修改感受只改你说的那一页的差异化体验。赞分享【免费下载链接】MemslidesA hierarchical memory framework for personalized presentation agents. Try it at memslides.com.项目地址https://gitcode.com/gh_mirrors/me/Memslides点击查看免费下载相关推荐如何快速上手GNM5分钟安装并生成你的第一个3D人脸网格附新手避坑清单如何快速上手GNM5分钟安装并生成你的第一个3D人脸网格附新手避坑清单 GNM Generative aNthropometric Model是一个开MDX Deck快速上手3步从零搭建你的第一个Markdown幻灯片附完整命令清单MDX Deck快速上手3步从零搭建你的第一个Markdown幻灯片附完整命令清单 MDX Deck 是一款基于 React 和 MDX 的演示文稿框架开发工具前端Idea2Paper快速上手教程5步跑通第一次AI论文Story生成含常见坑Idea2Paper快速上手教程5步跑通第一次AI论文Story生成含常见坑 Idea2Paper 是一个端到端的研究智能体框架能把一个粗略的研究想法创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考