editppt CLI命令大全image-to-editable-ppt-skill如何用确定性状态机管理PPT重建全流程【免费下载链接】image-to-editable-ppt-skillCodex skill for converting slide images, PDFs, and image-based PPTX files into editable PowerPoint decks.项目地址: https://gitcode.com/gh_mirrors/im/image-to-editable-ppt-skillimage-to-editable-ppt-skill 是一个把幻灯片图片、PDF 和图片版 PPT 转成可编辑 PowerPoint 的 Codex skill它的核心执行引擎是editpptCLI——一组围绕确定性状态机设计的命令负责输入归一化、页面分派、逐页重建、校验记录和最终组装的完整 PPT 重建流程。这篇文章带你梳理 editppt 的全部命令组看懂每个状态如何流转即使你不写代码也能理解整个 PPT 重建过程。为什么 PPT 重建需要确定性状态机把一张图片幻灯片变回可编辑 PPT是一个长流程OCR 文字测量、页面分派、多页并行重建、素材切分、校验、组装。这种任务交给 AI 自主执行时最容易出两类问题状态丢失中断后不知道做到哪一步只能从头再来流程失控AI 可能跳过校验、手写状态文件、用近似素材糊弄过关。image-to-editable-ppt-skill 的解法是所有关键状态只通过editppt命令推进状态落盘为 JSON 文件任何一步都能恢复。这就是它的确定性状态机设计。每页 PPT 在状态机里有四个强制状态见 deck_run_state.py状态含义由哪个命令写入pending待分派准备开始editppt prepare/editppt run resetdispatched已被某个 worker 认领视为活跃租约editppt run dispatchrecorded产物校验通过结果已记录哈希editppt run recordaccepted/complete最终 deck 组装并校验通过editppt run finalize页面状态记录在page_jobs.json整体任务状态记录在run_state.json含状态变更历史字段契约见 manifest-schema.md。规则很简单谁都不能手写这些 JSON只能靠命令推进状态。editppt 命令族全景完整的命令树收录在 cli-helper.md共 5 个命令组命令组职责典型命令环境管理初始化、体检、写第三方 API 配置setup/doctor/config任务准备归一化输入、生成逐页任务和文字测量prepare状态机编排查询下一步、分派、记录、重置、收尾run next/dispatch/record/reset/finalize页面构建测量文字、构建单页 PPTX、生成对比图、校验page hints/build/contact-sheet/validate图片与公式生图、修图、素材切分、LaTeX 渲染image generate/edit/import/process-sheet、formula render-latex命令入口实现位于 main.py安装检查流程editppt --help→setup→doctor同样在 cli-helper.md 中有说明。状态机四步PPT 重建主流程以下命令按 SKILL.md 的 Workflow 顺序构成主干每个阶段对应状态机的一次跃迁。第一步editppt prepare —— 归一化输入建立任务目录editppt prepare input.pdf这一个命令会完成大量准备工作创建独立任务目录把图片/PDF/图片版 PPT 归一化为逐页的pages/page_NNN/source.png生成deck_manifest.json、page_jobs.json、notes_manifest.json并顺手为每页跑一次文字测量文字框坐标、实测字号、字号分组让后续重建按测量值还原文字而不是靠目测。第二步editppt run next dispatch —— 查询下一步并分派页面这是状态机的方向盘editppt run next run --json它会读取当前状态返回明确的阶段指令stagerebuild_page_locally只有一页时主 agent 用--local认领后本地重建stagedispatch_pages多页任务按并发槽位默认 6 页并行分派给 page workerstagewait等待进行中的 worker不能因为慢就重置dispatched是活跃租约stagefinalize全部页面已记录可以收尾。分派动作本身用editppt run dispatch记录真实 spawn 一个 worker 或本地认领之后才执行。并发槽位和可分派页面的判定逻辑在 deck_run_state.py 中全部是确定性的集合运算没有随机性。第三步editppt run record —— 校验产物记录结果editppt run record run --page page_001 --agent-id worker-idrecord 不是点完即过它会先校验page.pptx是否与manifest.json一致、定位对象是否带源图像素坐标、validation.json顶层是否passed: true。失败的页面永远不会被记录必须让页面负责人局部修复后重新 record。这一步保证了最终 deck 里的每一页都是验证过的可编辑页而不是看起来差不多的一张图。第四步editppt run finalize —— 组装最终 PPTXeditppt run finalize runfinalize 按页顺序读取所有已记录的manifest.json重建最终.pptx复制页面备注并执行 deck 级校验页数一致性、媒体引用完整性、素材哈希匹配、备注哈希匹配以及整页背景图 文字贴图这类伪可编辑模式的拦截。产出final/{origin}_edited.pptx和final/validation.json。如果某页 worker 真正失败或丢失用editppt run reset --confirm-lost把该页退回pending重新分派调试状态则用只读的editppt run status。完整阶段策略参见 workflow.md。页面级与素材命令worker 的工具箱页面 worker 在自己的pages/page_NNN/目录里干活全部用 CLI 完成不写一次性脚本editppt page hints对单页source.png检测文字行输出text_hints.json框坐标 字号和标注图配置 OCR Token 后内容更准。整批重跑用editppt run hints。editppt page build从manifest.json确定性构建单页page.pptx和preview.png。editppt page contact-sheet生成源图 vs 预览对比图方便肉眼核对。editppt page validate用与 record 相同的 manifest 契约检查提前在页面内修掉问题。editppt image generate / editCLI 兜底生图/修图自动先选 Codex OAuth再选配置的 OpenAI 兼容 API。editppt image import / process-sheet记录选定图片的来源与哈希把 chroma-key 素材板去背景并切分成独立图标。editppt formula render-latex把 agent 转写的 LaTeX 渲染成公式图片资产并生成 manifest 片段。页面决策背景怎么处理、前景图标怎么分、何时用原生表格的唯一权威来源是 page-decision-tree.mdCLI 只负责执行不负责决策。转换效果对比下面是真实页面的原图 → 可编辑 PPT对比可以看到文字、形状和图标在转换后变成可单独编辑的对象更完整的转换示例与项目边界说明见 README.md 的转换效果示例一节。新手上手建议先跑单页试水转换很耗 token建议第一次只用一张图片走完整流程确认效果再上多页任务参见 quickstart.md。用editppt command --help查参数需要完整参数面时先读帮助不要凭记忆拼参数。环境体检用setup和doctor检查 Python 依赖、配置文件和图片后端可用性第三方 API 配置写入用户级~/.editppt/config.yaml不要把 key 写进项目目录。状态文件只读不写发现状态异常时正确姿势是editppt run status排查 reset回退而不是手改 JSON——这正是确定性状态机的价值所在。在 Codex 中建议使用完全访问权限否则长流程会被审批请求频繁打断延伸阅读命令手册与语法示例cli-helper.md状态机执行规则Entry Contract / WorkflowSKILL.mdJSON 字段契约manifest-schema.md页面决策规范page-decision-tree.md标准工作流说明workflow.md一句话总结editppt把图片转可编辑 PPT这件长流程、易中断的事拆成了 prepare → next/dispatch → record → finalize 四步确定性状态机。理解这张状态图你就理解了整个 image-to-editable-ppt-skill 的运转方式。【免费下载链接】image-to-editable-ppt-skillCodex skill for converting slide images, PDFs, and image-based PPTX files into editable PowerPoint decks.项目地址: https://gitcode.com/gh_mirrors/im/image-to-editable-ppt-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 editppt CLI命令大全：image-to-editable-ppt-skill如何用确定性状态机管理PPT重建全流程
editppt CLI命令大全image-to-editable-ppt-skill如何用确定性状态机管理PPT重建全流程【免费下载链接】image-to-editable-ppt-skillCodex skill for converting slide images, PDFs, and image-based PPTX files into editable PowerPoint decks.项目地址: https://gitcode.com/gh_mirrors/im/image-to-editable-ppt-skillimage-to-editable-ppt-skill 是一个把幻灯片图片、PDF 和图片版 PPT 转成可编辑 PowerPoint 的 Codex skill它的核心执行引擎是editpptCLI——一组围绕确定性状态机设计的命令负责输入归一化、页面分派、逐页重建、校验记录和最终组装的完整 PPT 重建流程。这篇文章带你梳理 editppt 的全部命令组看懂每个状态如何流转即使你不写代码也能理解整个 PPT 重建过程。为什么 PPT 重建需要确定性状态机把一张图片幻灯片变回可编辑 PPT是一个长流程OCR 文字测量、页面分派、多页并行重建、素材切分、校验、组装。这种任务交给 AI 自主执行时最容易出两类问题状态丢失中断后不知道做到哪一步只能从头再来流程失控AI 可能跳过校验、手写状态文件、用近似素材糊弄过关。image-to-editable-ppt-skill 的解法是所有关键状态只通过editppt命令推进状态落盘为 JSON 文件任何一步都能恢复。这就是它的确定性状态机设计。每页 PPT 在状态机里有四个强制状态见 deck_run_state.py状态含义由哪个命令写入pending待分派准备开始editppt prepare/editppt run resetdispatched已被某个 worker 认领视为活跃租约editppt run dispatchrecorded产物校验通过结果已记录哈希editppt run recordaccepted/complete最终 deck 组装并校验通过editppt run finalize页面状态记录在page_jobs.json整体任务状态记录在run_state.json含状态变更历史字段契约见 manifest-schema.md。规则很简单谁都不能手写这些 JSON只能靠命令推进状态。editppt 命令族全景完整的命令树收录在 cli-helper.md共 5 个命令组命令组职责典型命令环境管理初始化、体检、写第三方 API 配置setup/doctor/config任务准备归一化输入、生成逐页任务和文字测量prepare状态机编排查询下一步、分派、记录、重置、收尾run next/dispatch/record/reset/finalize页面构建测量文字、构建单页 PPTX、生成对比图、校验page hints/build/contact-sheet/validate图片与公式生图、修图、素材切分、LaTeX 渲染image generate/edit/import/process-sheet、formula render-latex命令入口实现位于 main.py安装检查流程editppt --help→setup→doctor同样在 cli-helper.md 中有说明。状态机四步PPT 重建主流程以下命令按 SKILL.md 的 Workflow 顺序构成主干每个阶段对应状态机的一次跃迁。第一步editppt prepare —— 归一化输入建立任务目录editppt prepare input.pdf这一个命令会完成大量准备工作创建独立任务目录把图片/PDF/图片版 PPT 归一化为逐页的pages/page_NNN/source.png生成deck_manifest.json、page_jobs.json、notes_manifest.json并顺手为每页跑一次文字测量文字框坐标、实测字号、字号分组让后续重建按测量值还原文字而不是靠目测。第二步editppt run next dispatch —— 查询下一步并分派页面这是状态机的方向盘editppt run next run --json它会读取当前状态返回明确的阶段指令stagerebuild_page_locally只有一页时主 agent 用--local认领后本地重建stagedispatch_pages多页任务按并发槽位默认 6 页并行分派给 page workerstagewait等待进行中的 worker不能因为慢就重置dispatched是活跃租约stagefinalize全部页面已记录可以收尾。分派动作本身用editppt run dispatch记录真实 spawn 一个 worker 或本地认领之后才执行。并发槽位和可分派页面的判定逻辑在 deck_run_state.py 中全部是确定性的集合运算没有随机性。第三步editppt run record —— 校验产物记录结果editppt run record run --page page_001 --agent-id worker-idrecord 不是点完即过它会先校验page.pptx是否与manifest.json一致、定位对象是否带源图像素坐标、validation.json顶层是否passed: true。失败的页面永远不会被记录必须让页面负责人局部修复后重新 record。这一步保证了最终 deck 里的每一页都是验证过的可编辑页而不是看起来差不多的一张图。第四步editppt run finalize —— 组装最终 PPTXeditppt run finalize runfinalize 按页顺序读取所有已记录的manifest.json重建最终.pptx复制页面备注并执行 deck 级校验页数一致性、媒体引用完整性、素材哈希匹配、备注哈希匹配以及整页背景图 文字贴图这类伪可编辑模式的拦截。产出final/{origin}_edited.pptx和final/validation.json。如果某页 worker 真正失败或丢失用editppt run reset --confirm-lost把该页退回pending重新分派调试状态则用只读的editppt run status。完整阶段策略参见 workflow.md。页面级与素材命令worker 的工具箱页面 worker 在自己的pages/page_NNN/目录里干活全部用 CLI 完成不写一次性脚本editppt page hints对单页source.png检测文字行输出text_hints.json框坐标 字号和标注图配置 OCR Token 后内容更准。整批重跑用editppt run hints。editppt page build从manifest.json确定性构建单页page.pptx和preview.png。editppt page contact-sheet生成源图 vs 预览对比图方便肉眼核对。editppt page validate用与 record 相同的 manifest 契约检查提前在页面内修掉问题。editppt image generate / editCLI 兜底生图/修图自动先选 Codex OAuth再选配置的 OpenAI 兼容 API。editppt image import / process-sheet记录选定图片的来源与哈希把 chroma-key 素材板去背景并切分成独立图标。editppt formula render-latex把 agent 转写的 LaTeX 渲染成公式图片资产并生成 manifest 片段。页面决策背景怎么处理、前景图标怎么分、何时用原生表格的唯一权威来源是 page-decision-tree.mdCLI 只负责执行不负责决策。转换效果对比下面是真实页面的原图 → 可编辑 PPT对比可以看到文字、形状和图标在转换后变成可单独编辑的对象更完整的转换示例与项目边界说明见 README.md 的转换效果示例一节。新手上手建议先跑单页试水转换很耗 token建议第一次只用一张图片走完整流程确认效果再上多页任务参见 quickstart.md。用editppt command --help查参数需要完整参数面时先读帮助不要凭记忆拼参数。环境体检用setup和doctor检查 Python 依赖、配置文件和图片后端可用性第三方 API 配置写入用户级~/.editppt/config.yaml不要把 key 写进项目目录。状态文件只读不写发现状态异常时正确姿势是editppt run status排查 reset回退而不是手改 JSON——这正是确定性状态机的价值所在。在 Codex 中建议使用完全访问权限否则长流程会被审批请求频繁打断延伸阅读命令手册与语法示例cli-helper.md状态机执行规则Entry Contract / WorkflowSKILL.mdJSON 字段契约manifest-schema.md页面决策规范page-decision-tree.md标准工作流说明workflow.md一句话总结editppt把图片转可编辑 PPT这件长流程、易中断的事拆成了 prepare → next/dispatch → record → finalize 四步确定性状态机。理解这张状态图你就理解了整个 image-to-editable-ppt-skill 的运转方式。【免费下载链接】image-to-editable-ppt-skillCodex skill for converting slide images, PDFs, and image-based PPTX files into editable PowerPoint decks.项目地址: https://gitcode.com/gh_mirrors/im/image-to-editable-ppt-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考