AI 技能人工智能【免费下载链接】codex-ppt-skillGPT-Image-2 PPT Generator Skill for Creating Image-Based PowerPoint Presentations in Codex and Other Skill-Compatible Agents项目地址https://gitcode.com/gh_mirrors/co/codex-ppt-skill点击查看免费下载本篇技术指南围绕开源仓库 codex-ppt-skill 的官方安装文档docs/ko/installation.md展开系统讲解如何将codex-ppt这一图片化 PPT 生成 Skill安装到 Codex、OpenClaw、Claude Code、Hermes Agent 等兼容 Agent 中并完成生图后端内置工具或 API/CLI 回退的配置与验证。读完本文你将掌握从一句话安装、命令行安装、软链接本地开发到 API key / base URL / 生图模型配置、第三方中转 API 对接与升级维护的完整实操路径并理解底层共享运行时skills/codex-ppt/scripts/codex_ppt_runtime.py与回退脚本skills/codex-ppt/scripts/image_gen.py的配置读取逻辑。安装前先理解codex-ppt 是什么、装到哪里codex-ppt是一个遵循 Skill 生态规范的技能包其行为契约定义在 skills/codex-ppt/SKILL.md 中它把文章、报告、论文、笔记或大纲转换为整页 16:9 图片构成、视觉统一的 PPTX 演示文稿。Skill 的元数据frontmatter声明了它面向的运行时要求需要python3可执行文件主要环境变量为OPENAI_API_KEY仅 CLI 回退时需要非强制可选环境变量包括OPENAI_BASE_URLAPI 基础地址、CODEX_PPT_IMAGE_MODEL生图模型默认gpt-image-2.5-flare与CODEX_PPT_HOME运行时主目录覆盖。也就是说安装的本质是把skills/codex-ppt这个目录放到某个 Agent 的 skills 目录下让 Agent 在启动时能发现并加载该 Skill。安装本身不包含 API key 配置——密钥等运行时数据全部存放在安装目录之外的~/.codex-ppt-skill/.env中这正是更新安全、不丢配置设计的根基。一句话安装把安装交给 Codex 自己官方文档推荐的最简路径是把下面这句话直接发给 Codex让它替你完成安装不需要手敲命令请帮我安装这个 codex-ppt skill链接是ningzimu/codex-ppt-skill 仓库地址Agent 收到后会自行判断目标 Agent 类型并执行对应的安装命令。此方式适合不熟悉命令行、或希望让 Agent 顺带完成依赖检查与目录初始化bootstrap的用户。Codex 手动安装命令行、zip 与软链接三种方式方式一npx skills 命令安装推荐在命令行执行以下命令将codex-pptskill 安装到 Codex 的全局 skills 目录npx -y skillslatest add ningzimu/codex-ppt-skill \ --skill codex-ppt \ --agent codex \ --global参数说明npx -y skillslatest临时调用最新版skills命令行工具-y跳过确认add ningzimu/codex-ppt-skill指定要安装的仓库--skill codex-ppt只安装仓库中skills/codex-ppt这一个技能仓库本身就是 skill 包此参数避免误装其他内容--agent codex目标 Agent 类型决定写入哪个 skills 目录--global安装到全局 skills 目录而非某个项目局部目录。安装完成后重启 Codex新 skill 才会被加载生效。方式二Releases zip 手动解压官方文档还提供了离线安装路径从仓库的 Releases 发布页下载codex-ppt-skill-v*.zip其中*为版本号如0.6.0解压后把其中的codex-ppt文件夹放到~/.codex/skills/codex-ppt然后重启 Codex 即可。每个版本的变更记录可在仓库根目录的 CHANGELOG.md 中查看其标题即对应版本号如0.6.0条目记录了默认生图模型切换为 GPT Image 2.5 Flare、支持 Sunburst 与xhigh/max质量等变更。方式三软链接本地开发调试如果你要基于本仓库做二次开发官方文档建议用符号链接把 skill 目录挂到 Codex 的 skills 目录实现改完即生效的实时调试mkdir -p ~/.codex/skills ln -s /path/to/codex-ppt-skill/skills/codex-ppt ~/.codex/skills/codex-ppt把/path/to/codex-ppt-skill换成你克隆仓库的实际路径。注意软链接方式下对仓库的修改会直接影响 Agent 加载的 skill适合开发迭代生产使用建议采用前两种方式以获得版本化、可回溯的安装。OpenClaw 安装skill install 与 allowlistOpenClaw 使用自己的 skill 管理命令openclaw skills install codex-ppt如果你的 OpenClaw 配置启用了 skill allowlist白名单机制还需要把codex-ppt显式加入允许列表否则即使安装成功Agent 也不会加载它。这与 skills/codex-ppt/SKILL.md frontmatter 中声明的openclaw.requires.bins: python3要求一致OpenClaw 运行时需要机器上存在python3才能运行本 skill 的 Python 脚本。Claude Code / Hermes Agent 安装同一命令不同 agent 参数本 skill 是跨 Agent 的npx skills安装命令完全一致只需替换--agent参数Claude Codenpx -y skillslatest add ningzimu/codex-ppt-skill \ --skill codex-ppt \ --agent claude-code \ --globalHermes Agentnpx -y skillslatest add ningzimu/codex-ppt-skill \ --skill codex-ppt \ --agent hermes-agent \ --global两个 Agent 的常见目标目录分别是~/.claude/skills/codex-ppt与~/.hermes/skills/codex-ppt。本地开发时同样可以用软链接替代复制做法与 Codex 一节相同。安装后同样需要重启对应 Agent。更新 skill为什么更新是安全的官方文档推荐直接把下面这句话发给你的 Agent让它替你更新请帮我更新 codex-ppt skill 到最新版本仓库是ningzimu/codex-ppt-skill手动更新的两种方式与安装完全对称重新执行上面对应 Agent 的安装命令最新版本会覆盖已安装的 skill从 Releases 下载最新codex-ppt-skill-v*.zip解压后替换原来的codex-ppt目录。更新完成后重启 Agent 生效。官方文档特别强调更新是安全的原因在于所有用户数据都不在 skill 安装目录内API key 等运行时配置保存在~/.codex-ppt-skill/.env个人风格库保存在~/.codex-ppt-skill/references/可在CODEX_PPT_HOME环境变量覆盖位置见 skills/codex-ppt/docs/style-library.md 与 SKILL.md 中${CODEX_PPT_HOME:-~/.codex-ppt-skill}的约定。因此无论更新还是重装这些文件都不会丢失。这与源码实现一致codex_ppt_runtime.py 中DEFAULT_RUNTIME_HOME ~/.codex-ppt-skill_runtime_home()读取CODEX_PPT_HOME环境变量作为覆盖所有配置、venv、缓存和日志都落在这个独立目录与 skill 本体物理隔离。生图模型配置内置工具优先API/CLI 回退兜底安装完成后要让 skill 真正出图需要一个当前环境可用的生图后端要么是 Agent 内置的生图工具要么是兼容的图片 API。官方文档明确指出 skill 不固定依赖某个模型。决策规则在 skills/codex-ppt/docs/backend-selection.md回退运行时的详细用法在 skills/codex-ppt/docs/cli-api-fallback.md。默认模型与关键参数API/CLI 回退默认使用gpt-image-2.5-flare可通过--model gpt-image-2.5-sunburst切换这两个 2.5 模型支持xhigh/max质量以及透明 PNG/WebP 输出默认输出仍为 2K 16:92560x1440与medium质量旧模型如gpt-image-1、gpt-image-2保留其原有参数限制尺寸只能是1024x1024、1536x1024、1024x1536或auto且gpt-image-2不支持透明背景见 image_gen.py 中_validate_size与_validate_model_specific_options的实现第三方服务需自行确认其支持的模型与参数。上述校验逻辑全部落在 skills/codex-ppt/scripts/image_gen.py模型名必须包含gpt-image-前缀_validate_modelxhigh/max质量仅限 2.5 系列_validate_quality透明背景要求输出格式为 PNG 或 WebP_validate_transparency。这正是文档中旧模型保留原参数限制的代码级证据。内置工具与回退的选择顺序官方文档要求 AI先检查内置工具是否可调用再生成样张验证文字与视觉质量。注意两点事实边界内置工具的实际模型与参数由环境如 ChatGPT 订阅、Codex 运行方式决定不能仅凭 ChatGPT 会员身份或成功出图来证明已使用 2.5 模型只有明确选择了 API/CLI 回退后才需要按报错配置 API key、base URL 与服务商支持的模型名。换句话说如果你走内置工具路径不需要也不应该手动配置gpt-image-2.5-flare只有回退 CLI 报缺少配置 / 认证失败 / 模型不存在时才进入配置环节。配置细节见 skills/codex-ppt/docs/image-model-configuration.md。三个配置项的含义源码级回退 CLI 自动加载~/.codex-ppt-skill/.env中的三个字段ENV_FIELDS见 image_gen.py 的_load_runtime_env配置项必填说明OPENAI_API_KEY必填真实调用时官方或第三方服务 API keyOPENAI_BASE_URL可选不填则使用官方https://api.openai.com/v1填写则为第三方 provider 的 base URLCODEX_PPT_IMAGE_MODEL可选默认gpt-image-2.5-flare可换gpt-image-2.5-sunburst或服务商支持的模型名配置命令由共享运行时提供skills/codex-ppt/scripts/codex_ppt_runtime.py 的config子命令官方 OpenAI 示例python3 {skill_root}/scripts/codex_ppt_runtime.py config \ --api-key your-api-key \ --model gpt-image-2.5-flareOpenAI 兼容服务示例python3 {skill_root}/scripts/codex_ppt_runtime.py config \ --api-key your-provider-api-key \ --base-url https://xxxx.example.com/v1 \ --model gpt-image-2.5-flare上面第二条命令产生的实际效果等同于手写如下.envOPENAI_API_KEYyour-provider-api-key OPENAI_BASE_URLhttps://xxxx.example.com/v1 CODEX_PPT_IMAGE_MODELgpt-image-2.5-flare运行时配置文件写入~/.codex-ppt-skill/.env创建时权限设为0600仅当前用户可读写见_write_env_file中的path.chmod(stat.S_IRUSR | stat.S_IWUSR)并且由 Codex、Claude Code、OpenClaw、Hermes Agent 等所有本地 Agent 共享——这正是装一次、处处可用的设计。两个覆盖规则也值得记住进程环境变量优先于.env命令行--model仅对当次命令覆盖CODEX_PPT_IMAGE_MODEL。第三方 API 注意事项base URL 最容易踩坑本 skill 内置了一个适配OpenAI 官方生图方式的脚本skills/codex-ppt/scripts/image_providers/openai_compatible.py。如果你用的是第三方gpt-image-2.5-flare中转 API向 AI 提供以下三样信息即可中转站的 base URL如果服务商示例是https://xxx/v1/images/generations则 base URL 填https://xxx/v1如果服务商直接给了https://xxx/v1不要再追加一层否则会拼成.../v1/v1导致 404官方 OpenAI 用户无需填OPENAI_BASE_URL默认就是https://api.openai.com/v1。中转站的 API key中转站的具体gpt-image-2.5-flare模型名有些中转站会改名为自定义字符串。为什么 base URL 要停在 /v1因为回退 CLI 通过 OpenAI SDK 调用client.images.generate(...)SDK 会自动把/v1/images/generations或/v1/images/edits追加到 base URL 之后image-model-configuration.md 明确要求不要把OPENAI_BASE_URL设为/images/generations等终端路径openai_compatible.py 的OpenAI(api_key..., base_url...)即按此约定构造客户端。将上述信息提供给 AI 后即可尝试生图如果跑不通说明你的中转站有自定义生图方案、与 OpenAI 生图接口不完全兼容此时应把中转站官方的生图使用文档发给 AI让它学习并适配生图脚本。值得补充的是仓库还内置了 AtlasCloud 适配器skills/codex-ppt/scripts/image_providers/atlascloud.py由 factory.py 根据 base URL 是否包含atlascloud.ai自动选择。AtlasCloud 模式下--model填基础模型名如openai/gpt-image-2CLI 内部会按文生图 / 编辑操作自动拼接模型路由atlascloud_model_for_operation且该适配器仅支持 PNG/JPEG 输出、不透传background参数——因此通过 AtlasCloud 通道不能承诺原生透明背景。共享运行时与故障排查bootstrap 与 doctor回退脚本依赖共享 Python 虚拟环境~/.codex-ppt-skill/.venv依赖清单见 skills/codex-ppt/requirements.txtpython-pptx1.0.2、Pillow10.0.0、openai2.0.0、filelock3.16.0。如果该环境缺失或依赖损坏先执行初始化python3 {skill_root}/scripts/codex_ppt_runtime.py bootstrap其中{skill_root}指包含SKILL.md的目录即skills/codex-ppt。bootstrap会创建 venv、安装 requirements可用--upgrade升级依赖。这是 skill 内部的自举步骤一般由 Agent 自动执行无需用户手动操作详见 skills/codex-ppt/docs/cli-api-fallback.md。排查回退 API 访问问题时可运行诊断命令python3 {skill_root}/scripts/codex_ppt_runtime.py doctor --check-apidoctor会依次检查venv Python 与依赖导入是否正常import openai, PIL, pptx、.env是否存在、三个配置项是否就位API key 会打码显示如sk-a...abcd、模型名是否包含gpt-image-并在--check-api时探测/models端点连通性若检测到 AtlasCloud base URL 则跳过该探测因为其接口结构不同。这套诊断正是按报错配置 API key、base URL、模型名这一官方流程的落地工具。常见问题小结装完不生效重启 Agent——skill 只在启动时加载内置工具可用还要配 key 吗不需要。只有选择 API/CLI 回退且 CLI 报配置错误时才配置中转站报.../v1/v1base URL 填到/v1为止不要包含/images/generations更新会丢配置吗不会.env与个人风格库都在~/.codex-ppt-skill/位于 skill 安装目录之外2.5 模型与透明背景默认gpt-image-2.5-flare可用--model gpt-image-2.5-sunburst切换xhigh/max质量与透明 PNG/WebP 仅 2.5 系列支持旧模型保留原参数限制。至此从一句话装好到API 回退配置就绪再到第三方中转对接与升级维护codex-ppt-skill 的完整安装与配置链路已全部打通剩余的生图尺寸、编辑命令与 4K 输出细节可继续查阅 skills/codex-ppt/docs/cli-api-fallback.md 与 skills/codex-ppt/docs/image-model-configuration.md 深入实践。赞分享AI 技能人工智能【免费下载链接】codex-ppt-skillGPT-Image-2 PPT Generator Skill for Creating Image-Based PowerPoint Presentations in Codex and Other Skill-Compatible Agents项目地址https://gitcode.com/gh_mirrors/co/codex-ppt-skill点击查看免费下载相关推荐ex-skill 安装部署指南从 Claude Code 到 OpenClaw 的完整落地教程ex skill 安装部署指南从 Claude Code 到 OpenClaw 的完整落地教程 本文是 ex skill 仓库的安装与部署实战指南覆盖 Cl人工智能AI 技能AI 应用交互助手OpenClaw Plugin Bundles 完整指南安装与映射 Agent Plugins、Codex、Claude、Cursor 生态插件OpenClaw Plugin Bundles 完整指南安装与映射 Agent Plugins、Codex、Claude、Cursor 生态插件 OpenClAI 应用AI Agent交互助手后端即时通讯网关Codex-X Provider管理完整指南第三方API添加、检测与切换Codex X Provider管理完整指南第三方API添加、检测与切换 Codex X 是一款面向 OpenAI Codex 桌面端 / CLI 的可视化桌面应用开发者工具AI 应用上一篇3分钟免费搞定NCM转MP3ncmdump零配置教程下一篇Playnite 游戏库管理器用 70 份预置模拟器配置整合五大启动器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考