docs(installation): 补充 skill 更新方法说明 (#85)

- 安装与配置页新增「更新 skill」小节:一句话让 agent 更新、
  重跑安装命令覆盖、Releases zip 替换三种方式,更新后重启生效
- FAQ 新增「如何更新 skill 到最新版本」条目
- README / README_en 安装节新增「更新」小节
- 说明 API 配置与个人风格库在安装目录之外,更新不会丢失
This commit is contained in:
ningzimu
2026-07-14 10:50:12 +08:00
committed by GitHub
parent cc76a06a80
commit c54ccdff86
5 changed files with 37 additions and 1 deletions
+1 -1
View File
@@ -16,7 +16,7 @@ Codex PPT 是一个面向 Codex 的 PPT 生成 skill也可在 Claude Code、O
- [快速开始](quickstart.md):第一次使用时的最短路径、示例命令和产物说明。
- [设计理念](design.md):为什么采用图片式 PPT、阶段确认和双 skill 分工的设计。
- [安装与配置](installation.md)Codex、OpenClaw、Claude Code、Hermes Agent 的安装方式,以及 API/CLI fallback 配置。
- [安装与配置](installation.md)Codex、OpenClaw、Claude Code、Hermes Agent 的安装与更新方式,以及 API/CLI fallback 配置。
- [标准工作流](workflow.md):从大纲确认、风格确认、后端确认、样张确认到整套生成和组装的完整流程。
- [风格与个人风格库](styles.md)12 种内置风格预览、仿照参考材料复刻风格,以及把满意的风格保存到个人风格库长期复用。
- [常见问题](faq.md)可编辑性、API key、样张、素材插入、单页修改等高频问题。
+4
View File
@@ -18,6 +18,10 @@
需要注意的是,不同 agent 的图片生成能力和工具接口不一样。如果不是在 Codex 中使用,通常需要配置 `gpt-image-2` 或第三方 OpenAI 兼容格式的生图 API。具体配置方式可以参考[安装与配置](installation.md),并在使用过程中让 AI 根据当前环境引导完成。
## Q如何更新 skill 到最新版本?
重新执行一遍安装命令即可覆盖为最新版本,或者直接让 agent 帮你更新,然后重启 agent 生效。API key 配置和个人风格库都存放在 skill 安装目录之外,更新不会丢失。具体命令参见[安装与配置](installation.md)。
## Q为什么第一张样张不错后面的页面又变差或风格不一样
这通常说明“样张风格”没有被稳定传递到后续页面,或者后续页面在生成时换了提示词、换了后端、换了子智能体执行方式。
+12
View File
@@ -60,6 +60,18 @@ npx -y skills@latest add ningzimu/codex-ppt-skill \
常见目标目录Claude Code 使用 `~/.claude/skills/codex-ppt`Hermes Agent 使用 `~/.hermes/skills/codex-ppt`。本地开发时同样可以用软链接替代复制。
## 更新 skill
推荐直接把下面这句话发给你的 agent让它帮你更新
```text
请帮我更新 codex-ppt skill 到最新版本仓库是https://github.com/ningzimu/codex-ppt-skill
```
手动更新时,重新执行上面对应 agent 的安装命令即可,会用最新版本覆盖已安装的 skill也可以从 [GitHub Releases](https://github.com/ningzimu/codex-ppt-skill/releases) 下载最新的 `codex-ppt-skill-v*.zip`,解压后替换原来的 `codex-ppt` 目录。更新完成后重启 agent 生效。
更新是安全的API key 等运行时配置保存在 `~/.codex-ppt-skill/.env`,个人风格库保存在 `~/.codex-ppt-skill/references/`,都在 skill 安装目录之外,更新或重装不会丢失。每个版本的变更内容可以查看 [Releases 页面](https://github.com/ningzimu/codex-ppt-skill/releases)或仓库的 `CHANGELOG.md`
## 生图模型配置
如果你没有 `gpt-image-2` 模型的使用权限,就无法使用该 skill。该 skill 强依赖 `gpt-image-2` 生图模型。