
PPT Master 如何用 live preview 可视化编辑已生成页面并让 AI 应用标注【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-masterPPT Master 生成并导出一份 deck 之后你常只想改一句话术、挪一个位置、换一个颜色而不是重跑整个生成流程。live preview 浏览器编辑器就是干这件事的一方面可以直接修改元素并写回项目的svg_output/另一方面可以选中元素写一句指令让 AI 改写那块区域并重新导出 PPTX。前提是已按快速入门装好 Python 3.10 与依赖。如果只是想直接改元素生成过程中自动启动的预览Generate 主流程 Step 6 以--live启动并持续运行到导出完成已经可用如果要走完整的“让 AI 应用标注”路径则project_path/exports/中必须已存在至少一个*.pptx——这是阶段文档给标注应用流程设的硬性门槛。本文中project_path是 Agent 报告的活动项目精确路径完整仓库 clone 通常位于工作目录/projects/生成的项目名/。命令中的skills/ppt-master/是 skill 目录前缀skill-only 安装时把它换成SKILL.md与requirements.txt所在的安装目录。两条编辑路径直接改还是写注解给 AI编辑器右栏把两类操作分开对应两种改动量级live-preview 阶段文档Direct edit不需要 AI确定性的调整——措辞、颜色、坐标、属性。选中元素改右栏控件预览立即更新在点击Apply changes之前什么都不写盘。Annotate交给 AI需要 AI 判断或重新排版的变化。选中元素写指令可选 move / resize / replace image / copy / relayout 这类快捷类型Add annotationApply changes然后回到聊天说apply my annotations。阶段文档还列出不必进编辑器的情况服务已在运行——直接给出 URL 即可“把第 3 页标题改成 X”这类一句话精确修改——在聊天里直接改 SVG整体重新生成——走主流程Step 7 从未执行——先完成主流程。启动或重新打开预览服务如果生成时自动启动的预览还在运行不要重新启动。只有在没有任何预览服务在跑时才自己启动——典型场景是导出后重开一个新会话或此前点过Exit previewsvg_editor 脚本文档python3 skills/ppt-master/scripts/svg_editor/server.py project_path --daemon这是 plain 模式不带--live——--live保留给 Generate 主流程 Step 6 的强制自启生成期间第一张 SVG 之前启动并运行到 Step 7。两种模式的差别在空闲超时plain 900 秒--live7200 秒可用--timeout seconds覆盖0表示禁用。这条命令的副作用是启动一个后台 Flask 进程。启动器会在后台拉起 server 并等待GET /api/health把 pid 与 port 记入project_path/live_preview/lock.json在可能时打开浏览器就地编辑project_path/svg_output/。URL 从哪里读以启动输出或live_preview/lock.json里的实际地址为准不要写死端口。不带--port时从6060起取第一个空闲端口--port N严格绑定端口不可用则启动失败。注意文档间对偏好端口的表述不一致快速入门说生成期间的预览优先http://localhost:5050被占用时取下一个空闲端口而svg_editor 脚本文档与 Generate Step 6 都写编辑器从6060起取第一个空闲端口并要求“绝不要假设 6060”。两份文档一致的一点是以启动器报告的 URL 为准。远程 Linux 主机上加--no-browser并手动转发端口设P为启动输出或lock.json中的端口VS Code / Cursor Remote-SSH 在PORTS面板转发PTermius 建一条 Local 规则且 Binding 与 Destination 均为127.0.0.1:P普通 SSH 用ssh -L P:127.0.0.1:P userhost然后打开http://localhost:P。在编辑器里直接修改页面元素编辑器打开后用首/上一页/下一页/末页按钮或←/→/Home/End翻页焦点在注解输入框时方向键不做翻页。编辑面细节见svg_editor.md选择左键选中最顶层元素元素重叠时右键列出指针下所有可选中元素自顶向下悬停高亮、点击选中Esc或点击外部关闭。单元素完整 inspector——几何、安全的文本内容、选中文本节点或其后代文本的计算文本样式、原始属性id、UIclass、事件处理器、href 等受保护字段除外。分组g走组级面板用Alt/Option 点击或Select parent group选中。多选批量编辑器只作用于顶层对象——共享 x/y 加fill/stroke/opacity只有当所选对象全是text/tspan时才出现文本样式字段。移动对已选中的元素按下拖拽选择仍是单独的点击所以背景不会被误拖指针位移按每个元素的 CTM 映射任何视口缩放或分组变换下移动都跟手。在空白画布上拖拽是橡皮筋选择。微调方向键移动 1pxShift 方向键移动 10px未选中任何对象时方向键才是翻页。所有改动先以“staged”状态存在服务器内存里预览即时刷新。CtrlZ或Undo丢弃当前页最后一步 staged 直接编辑按页 LIFO仅限本会话对同一元素同一组字段的连续编辑会合并成一步并保留编辑前的原始值。Apply changes才真正把 staged 直接编辑与注解标记写盘服务保持运行。有未应用改动时关闭标签页浏览器会弹“离开站点”确认。两点背景行为值得知道浏览器预览会自行内联use>python3 skills/ppt-master/scripts/check_annotations.py project_path脚本扫描project_path/svg_output/中带data-edit-targettrue的元素。有命中时输出以Found 数量 annotations in 文件数 files:开头随后逐文件、逐条编号列出元素标签与 idtext元素的内容预览前 50 字符以→开头的注解文本——直接把它当作待办清单。没有命中时打印[OK] No annotations found.AI 告知后停止。解析失败的幻灯片不会被静默当作“无注解”stderr 打印[ERROR] Failed to parse SVG ...且退出码为 1。这条命令是只读扫描你也可以自己随时运行确认注解是否已全部应用。2. 逐条应用。对每条注解按注解文本修改project_path/svg_output/file中的目标元素从该元素上移除data-edit-target与data-edit-annotation向project_path/live_preview/annotations.jsonl追加一条annotation_appliedJSONL 记录字段ts、file、element_id、原始注解文本。3. 重新导出 PPTX。编辑器自身从不运行导出管线——刷新 PPTX 是聊天步骤。AI 回到Generate 主流程执行 Step 7.2 与 Step 7.3python3 skills/ppt-master/scripts/finalize_svg.py project_path python3 skills/ppt-master/scripts/svg_to_pptx.py project_pathStep 7.2 的成功判据是svg_final/中每页一份自包含预览缺失不阻塞 7.3。Step 7.3 在 Speaker Notes 启用时按上面命令导出禁用时加--no-notes。成功判据命令退出 0产出exports/project_name_timestamp.pptx且validation/project_name_timestamp.report.json为passed或passed-with-warnings。Step 7.1total_md_split.py只在演讲者备注发生变化时才重跑。4. 回到浏览器。预览服务仍在运行若浏览器显示的是旧页面刷新或重新选择该页。还有注解就回到第 1 步循环说“done”或“stop preview”收尾。停止预览服务与已知边界停止浏览器里的Exit preview是唯一能停掉 Flask 的界面操作也可以在聊天里要求停止、等空闲超时、外部结束进程或命令行python3 skills/ppt-master/scripts/svg_editor/server.py project_path --shutdown每项目单实例live_preview/lock.json是项目内消费者的发现源包括visual_review.py第二次启动会复用运行中的实例除非显式要求了不同的--port N——那种不匹配会失败需要先用--shutdown。pid 已死的陈旧锁会被覆盖。生成期间不应用注解生成过程中 AI 不读取、不应用已提交的注解那个窗口在 Step 7导出完成后才打开。文字溢出或元素重叠快速入门的排查表给出“重跑那一页或用实时预览修”细节在FAQ。【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考