1实现原理 · 为什么它能做到
它是一条分阶段流水线：分析内容→（强制）确认→生成大纲→生成提示词→出图→合并 PPTX/PDF；阶段产物全部落盘，可按 --outline-only/--prompts-only/--images-only 断点续跑。
skills/canghe-slide-deck/SKILL.md
Input → Preferences → Analyze → [Check Existing?] → Confirm (1-2 rounds) → Outline → [Review Outline?] → Prompts → [Review Prompts?] → Images → Merge → Complete
注：这里在做什么：用一条流程串起九步清单，阶段之间没有隐藏状态，全靠磁盘文件（outline.md/prompts//PNG/pptx/pdf）衔接。
风格系统 = 16 个预设 × 4 个维度（texture/mood/typography/density）自由组合，每个预设映射到一组维度取值。
skills/canghe-slide-deck/SKILL.md
| `blueprint` (Default) | grid + cool + technical + balanced | Architecture, system design |
注：这里在做什么：先给一张预设表（默认 blueprint），再由维度文件描述可组合的取值空间，供自定义风格使用。
内容信号命中关键词表就自动选型，未命中回退 blueprint。
skills/canghe-slide-deck/SKILL.md
| tutorial, learn, education, guide, beginner | `sketch-notes` |
注：这里在做什么：把『教程类内容→sketch-notes』这类启发式写成表格，降低用户选择成本。
按篇幅推荐页数：<1000 词 5-10 页 … >5000 词 20-30 页（并建议拆分）。
skills/canghe-slide-deck/SKILL.md
| > 5000 words | 20-30 (consider splitting) |
注：这里在做什么：内容长度→目标页数的启发式表，是确认环节的默认建议值。
Step 2 是硬门禁：风格、受众、页数、大纲评审、提示词评审五项确认均不可跳过。
skills/canghe-slide-deck/SKILL.md
**Step 2 confirmation required** - do not skip (style, audience, slides, outline review, prompt review)
注：这里在做什么：在 Notes 里再次强调确认不可跳过，作为流程的强制关卡。
偏好从 EXTEND.md 加载，先查项目级再查用户级（$HOME）。
skills/canghe-slide-deck/SKILL.md
# Check project-level first
注：这里在做什么：用 Bash test -f 探测 EXTEND.md，命中则读取并输出偏好摘要，未命中走首次设置或默认值。
产物目录结构固定：源文件、outline.md、prompts/、NN-slide-*.png、pptx、pdf。
skills/canghe-slide-deck/SKILL.md
slide-deck/{topic-slug}/
注：这里在做什么：规定 slide-deck/<topic-slug>/ 下的文件布局，便于断点续跑与分享。
合并由两个本地脚本承担：npx -y bun 调用 merge-to-pptx.ts / merge-to-pdf.ts。
skills/canghe-slide-deck/SKILL.md
npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
注：这里在做什么：把图片页拼成 PPTX/PDF 的可执行部分只有这两个脚本，纯本地库调用。
出图不在本仓实现，而是让 agent『选择可用的图像生成 skill』按同一 session ID 顺序生成。
skills/canghe-slide-deck/SKILL.md
1. Select available image generation skill
注：这里在做什么：跨 skill 委派出图；用户内容组装的提示词因此会送入运行时选定的图像生成服务。
改图纪律：先改提示词文件，再 --regenerate 指定页。
skills/canghe-slide-deck/SKILL.md
**IMPORTANT**: When updating slides, ALWAYS update the prompt file (`prompts/NN-slide-{slug}.md`) FIRST before regenerating.
注：这里在做什么：保证变更可追溯可复现，禁止在已生成位图上直接贴字修补。
2核心能力
01从内容/主题生成整套幻灯片图（含封面与封底）
0216 种预设风格（blueprint/chalkboard/corporate/…/watercolor）
034 维度自定义组合（texture/mood/typography/density）
04按内容信号自动选型
05按篇幅推荐页数
06两轮交互确认（Round 1 必答，Round 2 仅自定义维度时）
07本地合并成 PPTX / PDF
08指定页重生成与增删改工作流
09多语言输出（按用户偏好/内容语言）
3外部依赖
| 类型 | 依赖 |
|---|---|
| api | 运行时图像生成后端（由 agent 选择『可用的图像生成 skill』完成出图，用户内容/提示词由此出网） |
| cli | bun / npx -y bun（运行合并脚本） |
4风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 素材出网（判橙主因）：每页提示词由用户文章内容组装，Step 7 交由运行时选定的图像生成服务生成，敏感素材请先确认后端与额度策略。
- 出图后端不确定：本 fork 未点名具体图像后端，端点由运行时环境决定，行为随宿主变化，难以在 skill 层审计。
- 提示词通道可能混入生成指令：prompts 文件同时作为图像后端提示词（本 bundle 未展开 base-prompt.md，无法核对其结尾指令，属待核面）。
- 文字类错误只能整页重生成：出图模型的排版/文字不可靠，且策略禁止事后贴字修补，正式商务演示需谨慎。
- 成本与失败模式：每页一次外部生成调用，20-30 页即同量级调用；失败需按提示词重试。
风险提醒：橙色，评估后使用。本 skill 的核心用途是『把用户内容变成幻灯片图』，出图环节交由运行时选定的图像生成服务完成（Step 7『Select available image generation skill』），即把用户素材/提示词送入外部生成后端——对照站内 ai-image-generation 与上游同型 baoyu-slide-deck 的判法落橙。自身脚本面很小：只有两个本地合并脚本（merge-to-pptx.ts / merge-to-pdf.ts）与本地写盘，无网络、无凭证读取、无逆向/冒充/安全降级/任意代码执行，故不升红。与上游 baoyu-slide-deck 的差别：本 fork 未点名具体生成后端（无 Codex imagegen / Cursor GenerateImage 等字样），端点由运行时决定，但『内容出网到生成服务』这一性质不变。
5第二遍独立确认
- [ok] 自身脚本无网络、无环境变量、无 spawn — skills/canghe-slide-deck/scripts/ 只有 merge-to-pdf.ts 与 merge-to-pptx.ts；bundle 风险扫描『網路請求：無命中』『憑證/環境變數』仅命中 ${SKILL_DIR} 与 $HOME 路径。
- [ok] 出图是跨 skill 委派而非本仓实现 — Step 7『1. Select available image generation skill』；本仓无任何图像生成脚本或端点声明。档位按『把用户素材送外部生成后端』落 orange。
- [ok] 确认门禁措辞与位置 — Notes 与 Step 2 均标注 ⚠️ REQUIRED；Notes 重复『Step 2 confirmation required - do not skip』。
- [ok] 合并脚本行为 — 风险扫描『寫盤/產生檔案』命中 merge-to-pdf.ts 的 Bun.write 与 merge-to-pptx.ts 的 pptx.writeFile，均为本地输出。
- [ok] 风格/维度数量与文件结构 — §1 清单列出 16 个 references/styles/*.md、5 个 references/dimensions/*.md（含 presets.md），与 SKILL.md 表格一致。
- [ok] 未展开文件的处理 — bundle 只展开 12 个最相关文件；base-prompt.md、design-guidelines.md 等未展开，故未对其内容下结论，仅按 §1 清单列为内部资产。
- [ok] 档位复核 — 自身脚本面绿蓝级，但核心用途将用户内容送入运行时图像生成服务 → 按站内『生成後端類』先例判 orange；无 red 触发项（无逆向/冒充/绕过/安全降级/任意代码执行）。
- [ok] 元数据与 commit — skill.commit 与 audit.skill_commit = dd0bf355955b4c82b764740b4183c86a72ba0e0c；license=MIT（仓库根 LICENSE），installs=null。
6结论
适合：适合把长文/主题快速变成统一风格、可分享图册的内容创作者与做技术/商业简报的人：需要成套风格、需要本地留档与可复现提示词、接受图像生成服务的外部调用。
不适合：不适合禁止素材出网或有严格数据合规要求的环境；不适合需要可编辑原生 PPT（这里是图片页，文字不可改）；不适合期望精确排版/精确文字的正式商务演示；也不适合运行时没有可用图像生成 skill 的环境。
安装 agent 直装可复制
① 本站镜像 更新 2026-10-10
方式 A · 人下载镜像包下载 canghe-slide-deck.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent5efda196172fff6e…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库freestylefly / freestylefly/canghe-skills
原始 GitHubfreestylefly/canghe-skills ↗
本 skill commit
dd0bf35595许可MIT（仓库根 LICENSE）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。